[ Previous | Next | Contents | Glossary | Home | Search ]
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')


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