DoTextAlign(3D)

NAME
DoTextAlign - Create a text alignment primitive attribute object

SYNOPSIS
C:
DtObject DoTextAlign(halign, valign)
DtTextAlignHorizontal halign;
DtTextAlignVertical valign;

FORTRAN:
INTEGER*4 DOTA(HALIGN, VALIGN)
INTEGER*4 HALIGN
INTEGER*4 VALIGN

DESCRIPTION
DoTextAlign creates a text alignment primitive attribute object. The parameters specify the position of the text rectangle relative to the reference point specified in subsequently executed text primitive objects. The alignment depends on the value set by DoTextPath <DOTPA> to determine the direction new characters are placed relative to the current text position. See DoTextPath.

The parameter halign specifies the horizontal position of the text rectangle relative to the reference point. Possible values are:

DcTextHAlignLeft <DCTHAL>
    The left side of the text rectangle passes through the text position.

DcTextHAlignCenter <DCTHAC>
    The text position lies midway between the left and right sides of the text rectangle.

DcTextHAlignRight <DCTHAR>
    The right side of the text rectangle passes through the text position.

DcTextHAlignNormal <DCTHAN>
    The most natural alignment is achieved by selecting from the other alignment values based on the value of the current text path attribute.

The parameter valign specifies the vertical position of the text rectangle relative to the reference point. Possible values are:

DcTextVAlignTop <DCTVAT>
    The top of the text rectangle passes through the text position.

DcTextVAlignCap <DCTVAC>
    If the text path is DcTextPathLeft <DCTPL> or DcTextPathRight <DCTPR>, the text position lies on the capline of the whole string. If the text path is DcTextPathUp <DCTPU> or DcTextPathDown <DCTPD>, the text position lies on the capline of the topmost character.

DcTextVAlignHalf <DCTVAH>
    If the text path is DcTextPathLeft <DCTPL> or DcTextPathRight <DCTPR>, the text position lies on the halfline of the whole string. If the text path is DcTextPathUp <DCTPU> or DcTextPathDown <DCTPD>, the text position lies on a line halfway between the halflines of the top and bottom characters.

DcTextVAlignBase <DCTVAB>
    If the text path is DcTextPathLeft <DCTPL> or DcTextPathRight <DCTPR>, the text position lies on the baseline of the whole string. If the text path is DcTextPathUp <DCTPU> or DcTextPathDown <DCTPD>, the text position lies on the baseline of the bottom character in the string.

DcTextVAlignBottom <DCTVAM>
    The bottom of the text rectangle passes through the text position.

DcTextVAlignNormal <DCTVAN>
    The most natural alignment is achieved by selecting from the other alignment values based on the value of the current text path attribute.

DEFAULTS
The default DoTextAlign is (DcTextHAlignNormal <DCTHAN>, DcTextVAlignNormal <DCTVAN>).

SEE ALSO
DoAnnoText(3D), DoText(3D), DoTextExpFactor(3D), DoTextFont(3D), DoTextHeight(3D), DoTextPath(3D), DoTextPrecision(3D), DoTextSpace(3D), DoTextUpVector(3D)