TEXT_ALIGNMENT(3G)

NAME

text_alignment − set the alignment of text lines relative to the starting point of each line.

SYNOPSIS

C SYNTAX

void text_alignment(fildes,h_select,v_select,horizontal,
vertical);
int fildes,h_select,v_select;
float horizontal,vertical;

FORTRAN77 SYNTAX

        subroutine text_alignment(fildes,h_select,
        v_select,horizontal,vertical)
        integer*4 fildes,h_select,v_select
        real horizontal,vertical

PASCAL SYNTAX

procedure text_alignment(fildes,h_select,v_select:integer;
horizontal,vertical:real);

HP-UX COMPATIBILITY

Level: HP-UX/STANDARD

Origin: ANSI Computer Graphics Interface

DESCRIPTION

INPUT PARAMETERS

fildes
is an integer file descriptor returned by gopen when an I/O path to a graphics device is opened.
h_select
is an enumerated value in:

         TA_LEFT
         TA_CENTER
         TA_RIGHT
         TA_CONTINUOUS_HORIZONTAL
         TA_NORMAL_HORIZONTAL
v_select
is an enumerated value in:

         TA_TOP
         TA_CAP
         TA_HALF
         TA_BASE
         TA_BOTTOM
         TA_CONTINUOUS_VERTICAL
         TA_NORMAL_VERTICAL
horizontal
the fraction of the face of the text extent box which appears on the negative side of the up vector. This value is only used with TA_CONTINUOUS_HORZONTAL and can be any real value.
vertical
the fraction of the face of the text extent box which appears on the positive side of the base vector. This value is only used with TA_CONTINUOUS_VERTICAL and can be any real value.

DISCUSSION

Text_alignment specifies the position of the text rectangle relative to the point specified in the text2d or text3d functions. If the h_select and/or the v_select parameter(s) is continuous then the text rectangle position is specified by the horizontal and/or vertical parameter(s). The normal values are dependent on the character path at the time the text primitive is called:

     path    normal horizontal     normal vertical
     ----    -----------------     ---------------
     right    left                  baseline
     left     right                 baseline
     up       center                baseline
     down     center                top

TA_CENTER is equivalent to TA_CONTINUOUS_HORIZONTAL = 0.5.
TA_HALF is equivalent to TA_CONTINUOUS_VERTICAL = 0.5.

DEFAULTS

TA_NORMAL_HORIZONTAL and TA_NORMAL_VERTICAL.

Museum

Related Articles