GPLLCI - Set Line-on-Line Color Index

Purpose

Use GPLLCI to insert a Set Line-on-Line Color Index 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 Index structure element, depending upon the current edit mode.

This structure element specifies an entry in the workstation's rendering color table that contains the color 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 Direct (GPLLCD) subroutine. The traversal default for the line-on-line color is the content of entry 1 of the rendering color table.

If the specified index is not supported by the workstation then a default color index of 1 is used.

GPLLCI is identified as GSE 1012.

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