text_orientation(3G)

NAME

text_orientation2d, inttext_orientation2d, text_orientation3d − specify text orientation.

SYNOPSIS

C Syntax:

void text_orientation2d ( fildes, up_x, up_y, base_x, base_y );
int fildes;
float up_x, up_y, base_x, base_y;

void inttext_orientation2d ( fildes, up_x, up_y, base_x, base_y );
int fildes, up_x, up_y, base_x, base_y;

void text_orientation3d ( fildes, up_x, up_y, up_z, base_x,
base_y, base_z );
int fildes;
float up_x, up_y, up_z, base_x, base_y, base_z;

FORTRAN77 Syntax:

subroutine text_orientation2d ( fildes, up_x, up_y, base_x, base_y )
integer*4 fildes
real up_x, up_y, base_x, base_y

subroutine inttext_orientation2d ( fildes, up_x, up_y,
base_x, base_y )
integer*4 fildes, up_x, up_y, base_x, base_y

subroutine text_orientation3d ( fildes, up_x, up_y,
up_z, base_x, base_y, base_z )
integer*4 fildes
real up_x, up_y, up_z, base_x, base_y, base_z

Pascal Syntax:

procedure text_orientation2d ( fildes:integer; up_x, up_y,
base_x, base_y:real );

procedure inttext_orientation2d ( fildes, up_x, up_y,
base_x, base_y:integer );

procedure text_orientation3d ( fildes:integer; up_x, up_y, up_z,
base_x, base_y, base_z:real );

DESCRIPTION

Input Parameters

fildes Integer file descriptor returned by gopen when an I/O path to a graphics device is opened.

up_x, up_y, up_z Coordinates of the up vector relative to (0.0, 0.0, 0.0). Vector is specified in VDC units.

base_x, base_y, base_z Coordinates of the base vector relative to (0.0, 0.0, 0.0). Vector is specified in VDC units.

Discussion

Text_orientation defines two vectors which, in turn, determine the orientation of subsequently drawn text characters. The up vector has the effect of slanting characters away from the vertical, and also defines the direction of line feed characters. The base vector defines the positioning of subsequent characters in a string when the text path is either left or right.

Integer operations are only available when using the INT_XFORM gopen mode. When in INT_XFORM mode, floating point operations are not available for that fildes. Floating point operations are the default, or can be specified with FLOAT_XFORM mode. For a list of integer operations, floating point operations and common operations see the starbase(3G) manual page.

DEFAULTS

Floating point:
up_x, up_y, up_z = (0.0, 1.0, 0.0)
base_x, base_y, base_z = (1.0, 0.0, 0.0)

Integer:
up_x, up_y, = (0, 1)
base_x, base_y = (1, 0)

Museum

Related Articles