character_width(3G)

NAME

character_width, dccharacter_width, intcharacter_width − specify character width

SYNOPSIS

C Syntax:

void character_width(fildes,width);
int fildes;
float width;

void dccharacter_width(fildes,dcwidth);
int fildes,dcwidth;

void intcharacter_width(fildes,width);
int fildes,width;

FORTRAN77 Syntax:

subroutine character_width(fildes,width)
integer*4 fildes
real width

subroutine dccharacter_width(fildes,dcwidth)
integer*4 fildes,dcwidth

subroutine intcharacter_width(fildes,width)
integer*4 fildes,width

Pascal Syntax:

procedure character_width(fildes:integer;width:real);

procedure dccharacter_width(fildes,dcwidth:integer);

procedure intcharacter_width(fildes,width:integer);

DESCRIPTION

Input Parameters

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

width Width of a text character measured in virtual device coordinates along the baseline.

dcwidth Width of a text character measured in device coordinates along the baseline.

Discussion

Character_width or intcharacter_width specify the width of subsequently drawn characters. The character_expansion_factor, character_width, and intcharacter_width procedures modify the width of a character. The procedure most recently executed defines the character width for subsequently drawn characters.

Character width values set by character_width or intcharacter_width are independent of character height values.

Beware:

If vdc_extent is changed, the character width is recomputed using the new VDC extent and the last character width set, or the default if no previous calls to character_width were made.

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

None, character width is defined by the default character expansion factor of 1.0.

Museum

Related Articles