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

GPLT - Set Linetype

GPLT (ltype)

Purpose

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

This structure element specifies an index into a workstation line type table that contains line types that the graPHIGS API uses to render all subsequent output primitives to which this attribute applies. At traversal time, the graPHIGS API uses the line type to render the output primitives when the line type aspect source flag is set to 2=INDIVIDUAL

The traversal default for line type is 1=SOLID_LINE

If the workstation does not support the specified line type, then the line type defaults to 1=SOLID_LINE

Parameters

ltype -- specified by user, fullword integer

Specifies an index into the workstation's line type table. The table size and specific entries supported are workstation dependent. Use the Inquire Polyline Facilities (GPQPLF) subroutine to determine the supported line types on your workstation. The size of the line type table is workstation dependent. The default line type table for supported entries is defined with the following line types: (1=SOLID_LINE, 2=DASHED, 3=DOTTED, 4=DASH_DOT, 5=LONG_DASH, 6=DOUBLE_DOT, 7=DASH_DOUBLE_DOT, 8-n=SOLID_LINE ) Use the Set Linetype Representation (GPLTR) subroutine to change any entry except for entry 1.

Error Codes

5
FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
63
LINETYPE VALUE < ONE

Related Subroutines

GPASF
Attribute Source Flag Setting
GPLNR
Set Linetype Rendering
GPQPLF
Inquire Polyline Facilities
GPQPLR
Inquire Predefined Polyline Representation
GPQXLR
Inquire Extended Polyline Representation
GPXPLR
Set Extended Polyline Representation

RCP code

201328641 (X'0C000801')


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