graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPGTXC - Set Geometric Text Culling

GPGTXC (wsid, height, method)

Purpose

Use GPGTXC to set the geometric text culling height for the specified workstation.

When displaying geometric text, if the transformed height of the characters in Device Coordinates (DC) is less than the specified culling height, then the graPHIGS API replaces the text with an alternate representation if one was selected.

This subroutine is assigned escape identifier 1008.

Note:

This subroutine is an escape subroutine, and therefore, may not be available on all workstations. Use the Inquire List of Available Escape Subroutines (GPQES) subroutine to determine if this subroutine is supported by a specific workstation.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

height -- specified by user, floating-point number (DC)

Geometric text culling height (>=0.0)

method -- specified by user, fullword integer

Display method for displaying geometric text when the height of the characters is less than the specified culling height.

1=TEXT_DISPLAY

each stroke of each character is displayed (the default method)

2=BOX_DISPLAY

a polyline is drawn around the text extent rectangle using the text color.

3=NO_DISPLAY

the character text is not displayed.

Error Codes

25: SPECIFIED WORKSTATION DOES NOT EXIST
35: WORKSTATION HAS ONLY INPUT CAPABILITIES
105: GEOMETRIC TEXT CULLING DISPLAY METHOD IS INVALID
106: GEOMETRIC TEXT CULLING HEIGHT < ZERO

Related Subroutines

GPCHH: Set Character Height
GPTX2: Geometric Text 2

RCP code

201345542 (X'0C004A06')