NAME

DoText − Create a text primitive object

SYNOPSIS

C:

DtObject DoText(position, u, v, string)
DtPoint3 position;
DtVector3 u, v;
DtPtr string;

Fortran:

INTEGER∗4 DOTXT(POSITN, U, V, STRING, N)
REAL∗8 POSITN(3)
REAL∗8 U(3), V(3)
INTEGER∗4 N
CHARACTER∗N STRING

DESCRIPTION

DoText creates a text primitive object that defines a string of text to be rendered at a specified position and in a specified text plane. 

The parameter position specifies a point in space where the text will be based.  The parameters u and v are vectors that define two directions.  The geometric normal is computed using the right-hand rule such that, while the fingers of the right hand curl in the direction from v to the current origin to u, the thumb points in the direction of the normal.  This normal is used for shading and backface culling.  The parameter string is the actual text. 

FORTRAN SPECIFIC

The parameter STRING is string of N characters. 

SEE ALSO

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

September 29, 2021