Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Filev_ftext()
vst_color()
vst_font()
vst_effects()
vst_alignment()
vst_point()
vst_height()
v_justified()                                                           VDI

Syntax

VOID v_justified( handle, x, y, str, length, wflag, cflag)
WORD handle, x, y;
char *str;
WORD length, wflag, cflag;

Function      v_justified() outputs justified graphics text.

Opcode        11

Sub-Opcode    10

Availability  Supported by all drivers. This function composes one of the
              10 VDI GDP's (Generalized Drawing Primitives). Although all
              current drivers support all GDP's, their availability is
              not guaranteed and may vary. To check for a particular GDP
              refer to the table returned by v_opnvwk() or v_opnwk().

Parameters    handle specifies a valid workstation handle. x and y specify
              the starting coordinates at which to draw the
              NULL-terminated text string (see vst_alignment() ) pointed
              to by str. length specifies the pixel length of the area to
              justify on. wflag and cflag specify the type of
              justification to perform between words and characters
              respectively. A value of NOJUSTIFY (0) indicates no
              justification whereas a value of JUSTIFY (1) indicates to
              perform justification.

Binding       WORD i = 2;

              while(intin[i++] = (WORD)*str++);

              contrl[0] = 11;
              contrl[1] = 2;
              contrl[3] = --i;
              contrl[5] = 10;
              contrl[6] = handle;

              intin[0] = wflag;
              intin[1] = cflag;

              ptsin[0] = x;
              ptsin[1] = y;
              ptsin[2] = length;
              ptsin[3] = 0;

              vdi();

Comments      This call does not take into account remainder information
              from outline fonts.

See Also      v_ftext(), vst_color(), vst_font(), vst_effects(),
              vst_alignment(), vst_point(), vst_height()

Group         VDI Output