NAME

DoAnnoText − Create an annotation text primitive object

SYNOPSIS

C:

DtObject DoAnnoText(position, string)
DtReal position[3];
DtPtr string;

FORTRAN:

INTEGER∗4 DOANNT(POSITN, STRING, N)
INTEGER∗4 N
REAL∗8 POSITN(3)
CHARACTER∗N STRING

DESCRIPTION

DoAnnoText creates an annotation text primitive object that defines a string of text.  This primitive object is rendered in a plane in frame space that is parallel to the XY-plane of the device space.  Because annotation text has no geometric size, its display size is unaffected by geometric transformations or projections. 

The textfont can be scaled using DoTextHeight <DOTH>.  Note that the scale factor is specified in frame coordinates. 

The parameter position is used to determine a three-dimensional point in frame coordinates to specify the position for the annotation text.  First, position is transformed into world coordinates using the current transformation matrix.  Then it is mapped into frame space using the current camera projection matrix.  This point is the reference point for determining a plane parallel to the XY-plane of device space, and the plane becomes the text plane for the annotation text.  The reference point, the plane, the DoTextAlign <DOTA>, DoTextPath <DOTPA>, and DoTextUpVector <DOTUV> attributes together determine the orientation of the text string. 

The parameter string is the actual text. 

FORTRAN SPECIFIC

FORTRAN, STRING is a string of N characters. 

SEE ALSO

DoText(3D), DoTextAlign(3D), DoTextExpFactor(3D), DoTextFont(3D), DoTextHeight(3D), DoTextPath(3D), DoTextPrecision(3D), DoTextSpace(3D), DoTextUpVector(3D)

September 02, 1992