NEAREST - v14 NEAREST - v14
nearest {+|-} {<vector>} {,} {<item>} {,h}
{,<svar>} {,<pvar> {,<nvar>}} {,b{,a}}
{,TOL}
Function
Select a model item for manipulation. Once an item has been selected, the partition area is activated at the end of the model workspace, and the selected item moved to this area, thereby making it available for subsequent manipulation by other commands.
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 selected. If this parameter is omitted, selection by the interactive cursor device is assumed. |
|
|
|
|
item |
An indication of which model item type(s) should be selected. 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} Single line vector. p Pipework item. m Submodel. c Arc or Circle item. a Annotation item. d Dimension item. u Ufo item. n Point item. cl Construction Line item. x Exact Geometry item (Profile or Body) xp Profile item. xb Body item. $<file>Submodel with a specific name, or matching a wildcard specification. <i> Item with a specific type number. i should be in the range 1 to 18. |
If no indicator is given, m (submodel) is assumed.
|
h |
Highlight the selected item by flashing it. |
|
|
|
|
svar |
Record string information about the selected item in string variables. svar must be of the form s<i> or <s_array>[<i>]. |
|
|
|
|
pvar |
Record co-ordinate information about the selected item in attach points. pvar must be of the form p<i> or <p_array>[<i>]. |
|
|
|
|
nvar |
Record scalar information about the selected item in arithmetic variables. nvar must be of the form v<i> 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. |
|
TOL |
This primer used in the manner NEAREST <params>,TOL ensures the NEAREST command only gets items within the selection tolerance. Also, selections on annotations will be performed using as a reference a straight line across the middle of the text, for each line of the annotation. (Introduced 12.5.1)(14.1.0) |
Once an item has been selected, the partition area is activated at the end of the model workspace, and the selected item moved to this area, thereby making it available for subsequent manipulation by other commands. This may be overridden by prefixing command line parameters with + or -.
|
|
|
|
+ |
Once an item has been identified, it will be moved to the end of the model workspace without changing the current contents of the partition area, thereby acting as an INCLUDE rather than as a SELECT. |
|
|
|
|
- |
Once an item has been identified, it will be moved to a position in the model workspace before the partition area, thereby acting as an EXCLUDE rather than as a SELECT. |
Examples
nearest
nearest p25,$door*
nearest v, p10,v10
nearest l,p1
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 selected is the nearest to the selection point. This is in contrast to the SELECT command, which will only select an item if it is within a tolerance distance from the selection point.
The Yes/No indicator will be set by this command: Yes if an item is successfully, No if no item is selected.
Only indexed variables are allowed that is, Vi, Pi and Si.
Update 11.7 ACIS version: Modified to include selection of ACIS objects.
See also
SELVAR, VECTOR, YESNO, highlight, identify, exclude, include, partition, select, set(seltol,ssv)