Polygon

model.component(<ctag>).geom(<tag>).create(<ftag>,"Polygon");

model.component(<ctag>).geom(<tag>).feature(<ftag>).set(property,<value>);

model.component(<ctag>).geom(<tag>).feature(<ftag>).getType(property);

model.component(<ctag>).geom(<tag>).feature(<ftag>).setAttribute(attribute,<value>);

model.component(<ctag>).geom(<tag>).feature(<ftag>).getAttribute(attribute);

Use model.component(<ctag>).geom(<tag>).create(<ftag>,"Polygon") to create a polygon or a line segment. The following properties are available

Table 3-133: Valid Property/Value Pairs for Polygon
Property	Value	Default	Description
color	none \| custom \| integer between 1 and the number of colors in the current theme	none	The color of the selection, either given as an integer indicating a color in the color theme, or as a custom color in the customcolor property. Coloring is only available when selresult in active.
contributeto	String	none	Tag of cumulative selection to contribute to.
customcolor	RGB-triplet	Next available theme color	The color to use. Active when color is set to custom.
filename	String		If source is file, the file that contains the vertex coordinates.
selresult	on \| off	off	Create selections of all resulting objects.
selresultshow	all \| obj \| dom \| bnd \| edg \| pnt \| off	dom in 2D; edg in 3D	Show selections, if selresult is on, in physics, materials, and so on; in part instances; or in 3D from a plane geometry. obj is not available in a component’s geometry. dom, bnd, and edg are not available in all features.
source	table \| file \| vectors	vectors	Whether vertex coordinates are specified as vectors, a table, or read from a file.
table	double[][]		The vertex coordinates when source is table, size N*sdim.
type	solid \| open \| closed	solid (2D) open (3D)	Object type. solid is not available in 3D.
workplanesrc	this \| part-instance feature	this	Part-instance feature to take the work plane from (in 3D only).
workplane	xyplane \| work-plane feature	xyplane	Work-plane feature that defines the coordinate system (in 3D only). The default, xyplane, is the global Cartesian coordinate system.
x	double[]	{}	x-coordinates for vertices.
y	double[]	{}	y-coordinates for vertices.
z	double[]	{}	z-coordinates for vertices.

Table 3-133: Valid Property/Value Pairs for Polygon

none | custom | integer between 1 and the number of colors in the current theme

none

The color of the selection, either given as an integer indicating a color in the color theme, or as a custom color in the customcolor property. Coloring is only available when selresult in active.

contributeto

String

none

Tag of cumulative selection to contribute to.

customcolor

RGB-triplet

Next available theme color

The color to use. Active when color is set to custom.

filename

String

If source is file, the file that contains the vertex coordinates.

selresult

on | off

off

Create selections of all resulting objects.

selresultshow

all | obj | dom | bnd | edg | pnt | off

dom in 2D; edg in 3D

Show selections, if selresult is on, in physics, materials, and so on; in part instances; or in 3D from a plane geometry. obj is not available in a component’s geometry. dom, bnd, and edg are not available in all features.

source

table | file | vectors

vectors

Whether vertex coordinates are specified as vectors, a table, or read from a file.

table

double[][]

The vertex coordinates when source is table, size N*sdim.

type

solid | open | closed

solid (2D)

open (3D)

Object type. solid is not available in 3D.

workplanesrc

this | part-instance feature

this

Part-instance feature to take the work plane from (in 3D only).

workplane

xyplane | work-plane feature

xyplane

Work-plane feature that defines the coordinate system (in 3D only). The default, xyplane, is the global Cartesian coordinate system.

double[]

{}

x-coordinates for vertices.

double[]

{}

y-coordinates for vertices.

double[]

{}

z-coordinates for vertices.

If type is open or closed, a curve consisting of line segments is constructed. If type is solid, the solid enclosed by such a closed polygon is constructed. If type is closed or solid, but the first and last control points are different, an extra segment is added to close the curve.

Use model.component(<ctag>).geom(<tag>).feature(<ftag>).importToTable() to read data from the file defined by the filename property and store the data in the table property. The source property is also changed to table.

If source is file, the polygon is not automatically rebuilt when the data in the file changes. Use model.component(<ctag>).geom(<tag>).feature(<ftag>).importData() to rebuild the polygon after such a change.

For information about the selresult and contributeto properties, see Selections of Geometric Entities.

Additional properties are available with the Design Module, see Polygon.

The following attributes are available:

Table 3-134: Valid attributes
Name	Value	Default	Description
construction	on \| off	off	Designate the resulting objects as construction geometry.

Table 3-134: Valid attributes

on | off

Designate the resulting objects as construction geometry.

model.component(<ctag>).geom(<tag>).create(<ftag>,"line1") constructs an open polygon.

model.component(<ctag>).geom(<tag>).create(<ftag>,"poly1") constructs a closed polygon.

model.component(<ctag>).geom(<tag>).create(<ftag>,"line2") or model.component(<ctag>).geom(<tag>).create(<ftag>,"poly2") constructs a solid polygon.