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

GPLLCD - Set Line-on-Line Color Direct

GPLLCD (color)

Purpose

Use GPLLCD to insert a Set Line-on-Line Color Direct structure element into the open structure following the element pointer, or to replace the element pointed at by the element pointer with a Set Line-on-Line Color Direct structure element, depending upon the current edit mode.

This structure element specifies the direct color values that the graPHIGS API uses when highlighting using the Set Frame Buffer Comparison (GPFBC) option 3=WRITE_WHEN_NOT_EQUAL

Depending upon the results of the Frame Buffer Comparison, this color overrides any color specified either by the attribute color for the primitive or in the primitive's definition.

This attribute sets the same traversal state as the Set Line-on-Line Color Index (GPLLCI) subroutine. The traversal default for the line-on-line color is the content of entry 1 of the rendering color table.

GPLLCD is identified as GSE 1011.

Note:

Not all GSEs are supported on all workstations. Use the List of Available GSEs (GPQGSE) subroutine to determine the GSEs which are supported by an open workstation. See also the workstation descriptors in The graPHIGS Programming Interface: Technical Reference

Parameters

color-- specified by user, 3 short floating-point numbers

Three color components of the current direct color model in the graPHIGS API state list (0.0<=component<=1.0)

Error Codes

5
FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
96
COLOR PARAMETER OUT OF RANGE FOR CURRENT COLOR MODEL

Related Subroutines

GPFBC
Set Frame Buffer Comparison
GPLLCI
Set Line-on-Line Color Index

RCP code

201343523 (X'0C004223')


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