NAME

SET CHARACTER SPACING − create structure element to set the current character spacing attribute

SYNOPSIS

C Syntax

void
pset_char_space ( spacing )
Pfloatspacing;character spacing

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET CHARACTER SPACING creates a structure element containing a value for the current character spacing attribute, which controls how much space is inserted between characters in a text string. 

When the character spacing Aspect Source Flag (ASF) is set to INDIVIDUAL, this attribute applies to the following output primitives:

• TEXT

• TEXT 3

• ANNOTATION TEXT RELATIVE

• ANNOTATION TEXT RELATIVE 3

C Input Parameter

spacing
The character spacing, specified as a real fraction of the font’s nominal character height.

Execution

If the current edit mode is INSERT, then a SET CHARACTER SPACING element is inserted in the currently open structure after the element pointed to by the current element pointer.  If the edit mode is REPLACE, then the new SET CHARACTER SPACING element replaces the element pointed to by the element pointer.  In either case, the element pointer is updated to point to the new element. 

When the SET CHARACTER SPACING element is traversed, the current character spacing entry in the traversal state list is set to character spacing.  When the current character spacing ASF is set to INDIVIDUAL, the character spacing is applied to text strings in output primitives that follow in the structure network. 

The character spacing attribute specifies the amount of space to be inserted between the character bodies in the text primitives.  A positive value inserts additional space between characters, and a negative value causes the character bodies to overlap.  The default value is 0.0:  the character bodies are placed adjacent to one another, with no additional space beyond that in the font design.  (A character’s body is the rectangle that encloses the limits of the character.) 

When the character spacing ASF is set to BUNDLED, the character spacing will be taken from the workstation’s representation indicated by the current text index.  In this case, the spacing set with SET CHARACTER SPACING has no effect. 

ERRORS

005Ignoring function, function requires state (PHOP, ∗, STOP, ∗)

SEE ALSO

SET CHARACTER EXPANSION FACTOR (3P)
SET CHARACTER HEIGHT (3P)
SET INDIVIDUAL ASF (3P)
SET TEXT REPRESENTATION (3P)

September 02, 1992