Include

INCLUDE - v14

identify {<vector>} {,<item>} {,h}
{,<svar> | s_array[<i>] }
{,<pvar> | p_array[<i>] }
{,<nvar> | n_array[<i>] }
{,b{,a}}

Function

Select a model item and return information about it in program variables. The position of the selected item within the model workspace will remain unchanged by this command.

Parameters

vector	A vector phrase defining a selection point in 3-D space. The program will use this point to determine which model item is identified. If this parameter is omitted, selection by the interactive cursor device is assumed.

item	An indication of which model item type(s) should be identified. More than one type of item may be indicated by separating them with commas. The indicators are as follows:
	f Flat surface item. s Solid or Hollow object item. l{e} Lines item. v{f\|s\|u} Single line vector. P Pipework item. M Submodel. C Arc or Circle item. A Annotation item. d Dimension item. u{f} Ufo item. n Point item. cl Construction Line item. x Exact geometry item (Profile or Body) xp,xc Profile item. xb,xf Body item. $<file> with a specific submodel name, or matching a wildcard specification. <i> Item with a specific type number. i should be in the range 1 to 18. any Any model item, equivalent to f,s,v,p,m,c,a,d,u,n,cl,x,xp,xc,xb,xf". If no indicator is given, M (submodel) is assumed.

h	Highlight the identified item by flashing it.

<svar>\|s_array[<i>]	Record string information about the identified item in string variables, starting at <svar> or s_array[<i>].

<pvar>\|p_array[<i>]	Record co-ordinate information about the identified item in attach points, starting at attach point <pvar> or p_array[<i>].

<nvar>\|n_array[<i>]	Record scalar information about the identified item in arithmetic variables starting at variable <nvar> or n_array[<i>].

b	Record the selected item in the temporary stack buffer. If the character A is also used, then the item will be appended to the buffer.

Examples

identify v,p1,v1

identify m,s5

identify p50,a,s1,p10,v10

identify v,p_array[2],num_array[5]

Notes

Details of recorded variables may be found in another section called "Selection Variables".
When a search is made of the items in the model, the item identified is the nearest to the selection point within a given tolerance. This tolerance is generally the width of the current control cursor on the screen, 2.5% of the screen width, but maybe redefined by the SET SELTOL command. Any items outside this tolerance will be ignored. The Yes/No indicator will be set by this command: Yes if an item is successfully identified, No ifno item is identified. Only indexed variables are allowed that is Vi, Pi and Si.

EagleNurbs: Amended to include NURBS entities

The Yes/No indicator will be set by this command: Yes if an item is successfully included, No if no item is included.