/AN3D, Kywrd, KEY
Specifies 3-D annotation functions
If Kywrd = ANUM, the type of annotation
is defined, along with its location. The command format is /AN3D,ANUM,NUM,TYPE,XHOT,YHOT,ZHOT.
NUMUnique number assigned as each annotation is applied to a model. These numbers are applied sequentially, although when an annotation entity is deleted, its number is reassigned.
TYPEAnnotation internal type number (101 = text, 102 = line, 103 = point, 104 = area, 105 = arrow, 106 = symbol, 108 = bitmap).
XHOT, YHOT, ZHOTX, Y, Z coordinates for hot spot location.
If Kywrd = BITM, the annotation is
a bitmap. The command format is /AN3D,BITM,TYPE,X,Y,Z.
TYPEAn integer value between 1 and 99, indicating a texture or bitmap. Numbers 1 through 40 correspond to existing ANSYS textures (see /TXTRE). Numbers 51 through 99 correspond to textures defined using the File option of the /TXTRE command. You can use this capability to override the predefined logo, clamp and arrow files available from the GUI dialog box (numbers 51 through 57). Numbers 41 through 50 are reserved.
X, Y, ZX, Y, Z coordinates for the lower left corner of the bitmap.
If Kywrd = TEXT, an annotation text
string is created. The command format is /AN3D,TEXT,X,Y,Z,Text_String.
X, Y, ZX, Y, Z coordinate location for text string.
Text_StringText string to be applied as annotation.
If Kywrd = LINE, an annotation line
is created. The command format is /AN3D,LINE,X1,Y1,Z1,X2,Y2,Z2.
X1, Y1, Z1X, Y, Z coordinates for beginning of line.
X2, Y2, Z2X, Y, Z coordinates for end of line.
If Kywrd = POINT, a dot will be drawn
in space (this option is not available from the GUI). The command
format is /AN3D,POINT,X,Y,Z.
X, Y, ZX, Y, Z coordinates for point.
If Kywrd = AREA, a polygonal area
with n vertices will be drawn.
The command format is /AN3D,AREA,NVERT,Xn,Yn,Zn.
NVERTThe number of vertices (n) for the polygon. Your Polygon can have between 3 and 9 vertices.
Xn, Yn, ZnX, Y, Z coordinate location for vertex n.
If Kywrd = ARROW, an annotation arrow
is created. The command format is /AN3D,ARROW,SIZE,X1,Y1,Z1,X2,Y2,Z2.
SIZESymbol size multiplier (0.1 to 20.0, default = 1.0) for the head of the arrow.
X1, Y1, Z1X, Y, Z coordinates for the location of the tail.
X2, Y2, Z2X, Y, Z coordinate for the location of the tip.
If Kywrd = SYMBOL, an annotation
symbol is created. The command format is /AN3D,SYMBOL,TYPE,X,Y,Z,SIZE.
TYPEThe symbol type (1 = CAP, 2 = TEE, 3 = CIRCLE, 4 = TRIANGLE, 5 = STAR).
X, Y, ZX, Y, Z coordinate location for the symbol.
SIZE Size multiplier for the symbol (0.1 to 20.0, default = 1.0)
Because 3-D annotation is applied in relation to the XYZ coordinates of the anchor, you can transform your model, and the annotation will maintain the spatial relationship with the model. This works within reason, and there are instances where changing the perspective or the size of the model will change the apparent relationship between the annotation and the model.
The overall 3-D dimensions of your model are defined by a bounding box. If portions of your model's bounding box lie outside of the visible area of your graphics window (if you are zoomed in on a specific area of your model), it can affect the placement of your 3-D annotations. Zooming out will usually overcome this problem.
3-D annotation is valid for the Cartesian (CSYS,0) coordinate system only. If you want to annotate a model you created in another coordinate system, use 2-D annotation (note that 2-D annotations do not remain anchored for dynamic rotations or transformations).
When you apply user defined bitmaps, the size of the annotation can vary. Use the options menu of the 3-D annotation widget to adjust the size and placement of your bitmaps.
You cannot use the “!” and “$” characters in ANSYS text annotation.
The GUI generates this command during 3-D annotation operations and inserts the command into the log file (Jobname.LOG). You should NOT type this command directly during an ANSYS session (although the command can be included in an input file for batch input or for use with the /INPUT command).