GET (Object property values)

Getter methods to access physical object property values.

<get></get>

Note

Getter results are local. Meaning they are only accessible inside the active element.

Global variables. A result starting with '@' - are Global variables, and will be accessible throughtout the entire matrix.

Getter Attributes

	Description
type=	Select the Type (of object property) to get. Example: <get type="attribute" name=".smd" result="@my_result" /> Types are available: ALL Gets all object information. OBJECT Gets Object type. DCODE Gets Aperture Dcode number: 10-20000 SHAPE Gets Aperture shape APERTURE Gets Aperture description PACKAGE Gets component package name REFDES Gets component reference designator PARTNUMBER Gets component part number MPN Gets Manfacturing Part Number MPN1 Gets Alternate Part Number (MPN1) MPN2 Gets Alternate Part Number (MPN2) MPN3 Gets Alternate Part Number (MPN3) CPN Gets Customer Part Number (CPN) IPN Gets Internal Part Number (IPN) COMPONENT_ROTATE Gets component rotation (in 0.01 degrees accuracy) COMPONENT_MIRROR Gets component mirror (true or false) COMPONENT_HEIGHT Gets component height COMPONENT_SIDE Gets component side (top or bottom) COMPONENT_TYPE Gets component type COMPONENT_X Gets component x insert location COMPONENT_Y Gets component y insert location COMPONENT_TYPE Gets component type COMPONENT_VND Gets component Manufacturer (VND) COMPONENT_DSC Gets component Description (DSC) LAYER Gets layer name LAYER_NUMBER Gets layer number (0-10000) LAYER_TYPE Gets layer type LAYER_SUBTYPE Gets layer subtype LAYER_DESC Gets layer description PURPOSE Gets a purpose number (0-10000) COMPOSITE Gets the composite level TOOL Gets the NC tool description TOOL_NUMBER Gets the NC tool Number NET Gets the net WIDTH Gets object bounding-box width HEIGHT Gets object bounding-box height CENTER_PT Gets the object center (X, Y values) CENTER_X Calculates the object center (X value) CENTER_Y Gets the object center (Y value) INSERT_PT Gets the object reference point (X, Y value). X Gets the object reference point (X value). Objects without a reference point (i.e polygons) the center point will be returned Y Gets the object reference point (Y value). Objects without a reference point (i.e polygons) the center point will be returned ATTRIBUTE Gets the attribute value. Requires attribute "name" PROPERTY Gets the property value. Requires property "name" ATTRIBUTES Returns all object attributes. PROPERTIES Returns all object properties.
name=	Used for type="attribute" and type="property" Example: <get type="attribute" name=".smd" result="@my_result" />
result=	Assigns the string result to the variable. Returns an empty string if not available Note If empty or missing, results can be accessed from the intrinsic result variable: __<Get Property Type> Intrinsic variables always begin with two underscores __OBJECT, __SHAPE, __WIDTH, __* @note__index = Intrinsic index count within the ForEach loop @note__count = Total count of array within the ForEach loop <get type="object" result="@my_obj" />

Using Intrinsic result:

<get type="object" />
<MESSAGE>Pad #{{__index+1}}  RADIUS: {{__width/2.0}}  Center Pt: ({{__x}}, {{__y}}) </MESSAGE>

More Examples:

<get type="object" result="@my_result" />
<get type="attribute" name=".smd" />
<get type="refdes"  result="@myrefdes" />
<get type="attribute"  name=".comp_height" result="@height" />