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

GPXCR - Set Extended Color Representation

GPXCR (wsid, ctid, start, number, color)

Purpose

Use GPXCR to set the specified color values starting at the specified workstation's color table entry. The color values are interpreted according to the workstation's color model.

Only modifiable color tables may be changed. Use the Inquire Extended Color Representation (GPQXCR) subroutine to determine the characteristics of the workstation's color table.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

ctid -- specified by user, fullword integer

Color table identifier of a modifiable color table existing on the workstation (-1=DISPLAY_COLOR_TABLE, 0=RENDERING_COLOR_TABLE , > 0=IMAGE COLOR TABLES )

start -- specified by user, fullword integer

Start color index (>=0)

number -- specified by user, fullword integer

Number of entries to be set (>=1)

color -- specified by user, array of short floating-point numbers

The color table values to be set in the specified color table (0.0<=component<=1.0)

The array is assumed to be in row order such as RED1, GREEN1, BLUE1, RED2, GREEN2, BLUE2, etc....

Error Codes

25
SPECIFIED WORKSTATION DOES NOT EXIST
35
WORKSTATION HAS ONLY INPUT CAPABILITIES
49
COLOR INDEX EXCEEDS WORKSTATION TABLE CAPACITY
92
COLOR INDEX < ZERO
96
COLOR PARAMETER OUT OF RANGE FOR CURRENT COLOR MODEL
284
COLOR TABLE IDENTIFIER DOES NOT EXIST
289
SPECIFIED COLOR TABLE CANNOT BE MODIFIED
517
NUMBER OF INDEXES < ONE

Related Subroutines

GPCML
Set Color Model
GPQCHH
Inquire Color Table Characteristics
GPQCF
Inquire Color Facilities
GPQCID
Inquire List of Color Table Identifiers
GPQXCF
Inquire Extended Color Facilities
GPQXCR
Inquire Extended Color Representation

RCP code

201329417 (X'0C000B09')


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