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 display space.  Because annotation text has no geometric size, it is unaffected by geometric transformations, projections, lighting and shading. 

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

The parameter position determines a three-dimensional point in frame coordinates to specify the text plane for the annotation text.  First, position is transformed into world coordinates using the current transformation matrix attribute.  Then it is mapped into frame space using the current camera projection matrix attribute.  This point is the reference point for determining a plane parallel to the XY-plane of device space.  This 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

In 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 29, 2021