graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPLTR - Set Linetype Representation

GPLTR (wsid, ltype, number, list)

Purpose

Use GPLTR to set a one-dimensional pattern that defines a specific line type in the workstation's line type table.

The Set Linetype (GPLT) subroutine and the Set Edgetype (GPELT) subroutine specify a line type entry. This entry selects a line pattern that the graPHIGS API applies to subsequent lines, curves, and edges.

The pattern is defined by an array of integers which specify the length of each solid and void section. Each integer defines a multiple of the minimum size pattern section that your workstation can generate. The sections alternate between solid and void with the first section always being solid.

Line type table entry 1 cannot be changed. It always defines the solid line pattern.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

ltype -- specified by user, fullword integer

Line type (>=2)

number -- specified by user, fullword integer

Number of pattern sections. This parameter specifies the number of sections in the line pattern contained in list (even number>=2)

list -- specified by user, array of fullword unsigned integers

Line pattern sections. Each entry of this array defines a section of the line pattern. The entries of the array alternate between solid and void sections with the first entry being solid. The value of each entry defines the length of the section in multiples of the minimum section size supported by the workstation. The sum of the line pattern sections must be >=1.

Error Codes

25: SPECIFIED WORKSTATION DOES NOT EXIST
35: WORKSTATION HAS ONLY INPUT CAPABILITIES
62: NUMBER OF LINE PATTERN SECTIONS IS INVALID
63: LINETYPE VALUE < ONE
64: SPECIFIED LINETYPE NOT AVAILABLE ON WORKSTATION
274: THIS FUNCTION IS NOT SUPPORTED BY THE WORKSTATION
275: SPECIFIED ENTRY CANNOT BE CHANGED
277: DEFINITION DATA EXCEEDS THE WORKSTATION TABLE CAPACITY

Related Subroutines

GPELT: Set Edge Linetype
GPLNR: Set Linetype Rendering
GPLT: Set Linetype
GPQLTF: Inquire Linetype Facilities
GPQLTR: Inquire Linetype Representation

RCP code

201329423 (X'0C000B0F')