The select, nearest, identify, exclude and include commands permit graphic items to be identified and selected. Information about the selected item can be obtained by adding the names of variables as command line parameters.
The general form of the variable indication on the command line is
select {<cc>|<i>}{,<pvar>}{,<nvar>}{,<svar>}
where <cc> or <i> indicates which type of graphic item is to be selected. The subsequent parameters indicate into which program variables information is to be recorded, where
<pvar> must be in the form p<i> or p-range,
<nvar> must be in the form n<i> or n-range,
<svar> must be in the form s<i> or s-range.
The returned information will be assigned to a range of variables starting with the one specified on the command line.
The select command is used again as the example. For a full description of item selection please consult the relevant commands.
select v,pvar,nvar
will record the following information about a single line vector from within a lines item.
pvar values:
1. co-ordinates of the line start point
2. co-ordinates of the line finish point
3. co-ordinates of the nearer of Pi and Pi+1 to the select reference point (i.e. the nearest end)
4. co-ordinates of the farther of Pi and Pi+1 to the select reference point (i.e. the farthest end)
nvar values:
1. the fragment number of the item
2. the pen number of the line
3. the dash pattern of the line
4. the line length
5. the angle of the line in plan
svar values:
There is no text information available.
select l{e},pvar,nvar
or
select 3,pvar,nvar
will record the following information about all line vectors within a lines item.
pvar values:
1 to n. co-ordinates of all vectors within the item. If the character E is appended to L, then only the end co-ordinates of the first and last lines within the item will be recorded in pvar and next variable.
nvar values:
1. the fragment number of the item
2. the value n, giving the number of the last attach point recorded, which itself will now hold the end co-ordinates of the last line vector.
svar values:
There is no text information available.
select f,pvar,nvar
or
select 1,pvar,nvar
will record the following information about a selected flat surface item.
pvar values:
1 to n. co-ordinates of the polygon vertices
nvar values:
1. the fragment number of the item
2. the value n, giving the number of the last attach point recorded, which itself will now hold the co-ordinates of the last vertex of the polygon
3. the hatch pattern number of the item.
svar values:
There is no text information available.
select s,pvar,nvar
or
select 2,pvar,nvar
will record the following information about a selected solid or hollow object item.
pvar values:
1 to n. co-ordinates of vertices on the control face of the object
n+1. the co-ordinates of the first point at the end of the extrusion (on the opposite face to the control face)
nvar values:
1. the fragment number of the item
2. the value n, giving the number of the last attach point recorded, which itself will now hold the co-ordinates of the last vertex of the control face
3. the extrusion length of the solid
4. the hatch pattern number of the item
svar values:
There is no text information available.
select pvar,nvar,svar
or
select m,pvar,nvar,svar
or
select 10,pvar,nvar,svar
or
select $name,pvar,nvar,svar
will record the following information about a sub-model.
pvar values:
1. co-ordinates of the sub-model origin
2. co-ordinates of the lower extremities of the box totally enclosing the sub-model (untranslated)
3. co-ordinates of the upper extremities of the box totally enclosing the sub-model (untranslated)
nvar values:
1. the fragment number of the item
2. the pen number assigned to the sub-model
3. the dash pattern assigned to the sub-model
4. the X stretching factor
5. the Y stretching factor
6. the Z stretching factor
7. the plan angle of orientation
svar values:
1. the sub-model name. If the sub-model has an extension of .mod it will be omitted.
select c,pvar,nvar
or
select 11,pvar,nvar
will record the following information about an arc or circle.
pvar values:
1. the co-ordinates of the circle centre
2. the co-ordinates of the arc start point
3. the co-ordinates of the arc finish point
4. co-ordinates of the nearer of Pi and Pi+1 to the select reference point (i.e. the nearest end)
5. co-ordinates of the farther of Pi and Pi+1 to the select reference point (i.e. the farthest end)
6. co-ordinates of a point on the normal through the circle centre
nvar values:
1. the fragment number of the item
2. the pen number of the arc
3. the dash pattern of the arc
4. the angle subtended by the arc
5. the radius of the arc
svar values:
There is no text information available.
select a,pvar,nvar,svar
or
select 15,pvar,nvar,svar
will record the following information about an annotation.
pvar values:
1. the control point of the annotation
nvar values:
1. the fragment number of the item
2. the number of lines of annotation text
svar values:
1. first line of annotation text
2. second line of annotation text
3. . . .
select d,pvar,nvar,svar
or
select 16,pvar,nvar,svar
will record the following information about a graphic dimension line.
pvar values:
1. the co-ordinates of the line start
2. the co-ordinates of the line end
3. the control point of the annotation
nvar values:
1. the fragment number of the item
2. the number of lines of annotation text
svar values:
1. first line of annotation text
2. second line of annotation text
3. . . .
select p,pvar,nvar
select 4,pvar,nvar
select 5,pvar,nvar
select 6,pvar,nvar
select 7,pvar,nvar
select 8,pvar,nvar
select 9,pvar,nvar
will record the following information about pipe work items.
All Pipework
nvar values:
1. the fragment number of the item
2. the pipe type (value 4 through 9)
3. the pen number of the pipework item
Straight Pipe (type 4)
pvar values:
1. the co-ordinates of the pipe start point (on the pipe centreline)
2. the co-ordinates of the pipe finish point
nvar values:
4. the radius of the pipe
Reducer/Eccentric Reducer (type 5/6).
pvar values:
1. the co-ordinates of the reducer start point (on the pipe centreline)
2. the co-ordinates of the reducer finish point
nvar values:
4. the start radius
5. the finish radius
Dished End (type 7)
pvar values:
1. the co-ordinates of the dished end start point (on the pipe centreline)
2. the co-ordinates of the item finish point
nvar values:
4. the finish radius
5. the length along the centreline
Pipe Bend (type 8)
pvar values:
1. the co-ordinates of the bend start point (on the pipe centreline)
2. the co-ordinates of the bend cross point
3. the co-ordinates of the bend finish point
nvar values:
4. the radius of the pipe
5. the bend radius
Pipe Tee-Junction (type 9)
pvar values:
1. the co-ordinates at the intersection of point of the pipe centrelines
nvar values:
4. the radius of the main line pipe
5. the radius of the branch pipe
svar values:
There is no text information available.
select s,pvar,nvar
or
select 13,pvar,nvar
will record the following information about a selected irregular solid or hollow object item.
pvar values:
1 to n. co-ordinates of vertices on the control face of the object followed by those on the secondary face
nvar values:
1. the fragment number of the item
2. the value n, giving the number of the last attach point recorded, which itself will now hold the co-ordinates of the last vertex of the secondary face
3. the hatch pattern number of the item
svar values:
There is no text information available.
select u,pvar,nvar
or
select 14,pvar,nvar
will record the following information about a selected ufo object item.
pvar values:
1. the origin of the ufo
2. co-ordinates of the lower extremities of the box totally enclosing the ufo (untranslated)
3. co-ordinates of the upper extremities of the box totally enclosing the ufo (untranslated)
nvar values:
1. the fragment number of the item
2. the pen number of the item
3. the X scale factor
4. the Y scale factor
5. the Z scale factor
select uf,pvar,nvar {,p=file}
will record the following information about the selected face of an ufo object item.
pvar values:
1. origin of the ufo
2. co-ordinates of the lower extremities of the box totally enclosing the ufo (untranslated)
3. co-ordinates of the upper extremities of the box totally enclosing the ufo (untranslated)
4. normal to the selected face
nvar values:
1. the fragment number of the item
2. the pen number of the item
3. the dash type of the item
4. scale factor on X
5. scale factor on Y
6. scale factor on Z
7. plane angle of the orientation
8. nearest edge of the face
9. nearest vertex of the face
11. face label
12. face tag name
P=<file>p-file containing points of selected face
select vu,pvar,nvar
will record the following information about the selected edge of an ufo object item.
pvar values:
1. co-ordinates of the edge start point
2. co-ordinates of the edge finish point
3. co-ordinates of the nearer of Pi and Pi+1 to the select reference point (i.e. the nearest end)
4. co-ordinates of the farther of Pi and Pi+1 to the select reference point (i.e. the farthest end)
nvar values:
1. the fragment number of the item
2. the pen number of the item
3. the length of the selected edge
select n,pvar,nvar,svar
or
select 17,pvar,nvar,svar
will record the following information about the selected point item.
pvar values:
1. the position of the point
nvar values:
1. the fragment number of the item
2. the pen number of the item
svar values:
1. the character used to display the point
select cl,pvar,nvar
or
select 18,pvar,nvar
will record the following information about the selected construction line item.
pvar values:
1. a 3D point on the construction line
2. a second 3D point on the line
3. the unit vector along the line
nvar values:
1. the fragment number of the item
2. the pen number of the item
3. the dash pattern of the item
svar values:
There is no text information available.
select 19,pvar,nvar,svar
will record the following information about a graphic dimension line.
pvar values:
1. the control point of the annotation
2. the co-ordinates of the line start
3. the co-ordinates of the line end
nvar values:
1. the fragment number of the item
2. the number of lines of annotation text (1)
svar values:
1. annotation text
select xb,pvar,nvar
select 23,pvar,nvar
will record the following information about a selected Body item.
pvar values:
1. the origin of the body
2. co-ordinates of the lower extremities of the box totally enclosing the body (untranslated)
3. co-ordinates of the upper extremities of the box totally enclosing the body (untranslated)
nvar values:
1. the Fragment of the item
2. the pen number of the item
3. the dash pattern of the item
svar values:
There is no text information available.
select xf,pvar,nvar
Will record the following information about the selected face of a body item.
pvar values:
1. the origin of the body
2. co-ordinates of the lower extremities of the box totally enclosing the body (untranslated)
3. co-ordinates of the upper extremities of the box totally enclosing the body (untranslated)
nvar values:
1. the fragment number of the item
2. the pen number of the item
3. the dash pattern of the item
4. Scale factor on X
5. Scale factor on Y
6. Scale factor on Z
7. Plane angle of the orientation
8. Nearest edge of the face
9. Nearest vertex of the face
10. Face label
11. Face tag
svar values:
There is no text information available.
select xc,pvar,nvar
Will record the following information about the selected curve of a profile or body item.
pvar values:
1. co-ordinates of the curve start point
2. co-ordinates of the curve finish point
3 co-ordinates of the nearer of Pi and Pi+1 to the select reference point (i.e. the nearer end)
4. co-ordinates of the farther of P1 and Pi+1 to the select reference point (i.e. the farther end)
nvar values:
1. the fragment number of the item
2. the pen number of the item
3. the dash pattern of the item
4. Scale factor on X
5. Scale factor on Y
6. Scale factor on Z
7. Plane angle of the orientation
8. Nearest edge of the face
9. Nearest vertex of the face
10. Face label
11. Face tag
svar values:
There is no text information available.
select xc,pvar,nvar,svar
select 26,pvar,nvar,svar
Will record the following information about a selected Curve item.
pvar values:
1. the origin of the Curve
2. co-ordinates of the lower extremities of the box totally enclosing the Curve (untranslated)
3. co-ordinates of the upper extremities of the box totally enclosing the Curve (untranslated)
nvar values:
1. the fragment number of the item
2. the pen number of the item
3. the dash pattern of the item
svar values:
There is no text information available.
select xs,pvar,nvar,svar
select 24,pvar,nvar,svar
Will record the following information about a selected Shell item.
pvar values:
1. the origin of the Shell
2. co-ordinates of the lower extremities of the box totally enclosing the Shell (untranslated)
3. co-ordinates of the upper extremities of the box totally enclosing the Shell (untranslated)
nvar values:
1. the fragment number of the item
2. the pen number of the item
3. the dash pattern of the item
svar values:
There is no text information available.
select xf,pvar,nvar,svar
select 25,pvar,nvar,svar
Will record the following information about a selected Surface item.
pvar values:
1. the origin of the Surface
2. co-ordinates of the lower extremities of the box totally enclosing the Surface (untranslated)
3. co-ordinates of the upper extremities of the box totally enclosing the Surface (untranslated)
nvar values:
1. the fragment number of the item
2. the pen number of the item
3. the dash pattern of the item
svar values:
There is no text information available.
Notes
The following new Selection primers are available:
Select XB for Body entities
Select XBF for face/surface in a Body
Select XBE for edge/curve in a Body
Select XBL for wire/profile in a body
Select XS for Shell entities
Select XSF for face/surface in a Shell
Select XSE for edge/curve in a Shell
Select XSL for wire/profile in a shell
Select XF for Surface entities
Select XFE for edge/curve in a Surface
Select XFL for wire/profile in a surface
Select XC for Curve entities
Note that SELECT XBF, XBE, XBL, XSF, XSE, XSL, XFE and XFL extract the relevant
Surfaces or Curve from the selected item and place them under the Partition marker.