[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

SET CHARACTER EXPANSION FACTOR (PHOP,*,STOP,*)

Purpose

Use Set Character Expansion Factor to insert a Set Character Expansion Factor structure element into the open structure following the element pointer or replace the element pointed at by the element pointer with a Set Character Expansion Factor structure element, depending on the current edit mode.

At structure traversal time, this structure element specifies the character expansion factor that the graPHIGS API uses to render all subsequent text primitives when the character expansion aspect source flag value is set to INDIVIDUAL ( SET INDIVIDUAL ASF (PHOP,*,STOP,*)).

The value is a fraction of the width/height ratio that the font designer specified. A value of 1.0 reproduces the font designer's width/height ratio.

The traversal default value for character expansion factor is 1.0.

When the graPHIGS API encounters an element of this type, it uses the absolute value of the specified character expansion factor. If the workstation does not support a continuous range of character expansion factors, then the graPHIGS API uses the closest supported value.

Language Bindings

C

pset_char_expan (char_expan)

Input Parameters

Pfloat char_expan
Character expansion factor.

FORTRAN

PSCHXP (chxp)

Input Parameters

real chxp
Character expansion factor.

Errors

5
Function Requires State (PHOP,*,STOP,*)

Related Subroutines

  • Inquire Annotation Facilities

  • Inquire Predefined Text Representation

  • Inquire Text Facilities

  • Set Individual ASF

  • Set Text Precision


  • [ Previous | Next | Contents | Glossary | Home | Search ]