_setgtextvector

Description

Changes the orientation of font text output.

#include <graph.h>

struct _xycoord __far _setgtextvector( short x, short y );

x, y Integers specifying font rotation  

Remarks

The _setgtextvector function sets the current orientation for font text output to the vector specified by x and y. The current orientation is used in calls to the _outgtext function.

The values of x and y define the vector which determines the direction of rotation of font text on the screen. The text-rotation options are shown below:

(x, y) Text Orientation

(0, 0) Unchanged
(1, 0) Horizontal text (default)
(0, 1) Rotated 90 degrees counterclockwise
(–1, 0) Rotated 180 degrees
(0, –1) Rotated 270 degrees counterclockwise

If other values are input, only the sign of the input is used. For example, (–3, 0) is interpreted as (–1, 0).

Return Value

The _setgtextvector function returns the previous vector in a structure of _xycoord type. If you pass the _setgtextvector function the values (0, 0), the function returns the current vector values in the _xycoord structure.

Compatibility

Standards:None

16-Bit:DOS

32-Bit:None

See Also

_getfontinfo, _getgtextextent, _grstatus, _outgtext, _registerfonts, _setfont, _unregisterfonts

Example

See the example for _outgtext.