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

GPCPR - Set Color Processing Representation

GPCPR (wsid, index, model, quant, data)

Purpose

Use GPCPR to set the given color processing values into the specified entry of the workstation's color processing table.

The color processing table is 0 based, however, you cannot change entry 0 of the table. Entry 0 supports a color rendering model (model) of 1=RGB_NORMAL , and a color quantization method (quant) of 1=WORKSTATION_DEPENDENT For information on color processing, see The graPHIGS Programming Interface: Understanding Concepts

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

index -- specified by user, fullword integer

Color processing mode table index (>=1)

model -- specified by user, fullword integer

Rendering color model (1=RGB_NORMAL, 2=RGB_B_ONLY )

quant -- specified by user, fullword integer

Color quantization method (1=WORKSTATION_DEPENDENT, 2=BITWISE )

data -- specified by user, 4 fullword integers

Color quantization parameters. The content of this parameter is dependent on the color quantization method.

If quant=1 (WORKSTATION_DEPENDENT )

The data parameter is ignored.

If quant=2 (BITWISE )

The data parameter requires the following format: 
         
       0 |R bit length| fullword integer
         
       4 |G bit length| fullword integer
         
       8 |B bit length| fullword integer
         
      12 |padding bits| fullword integer

Note: The least significant (right most) bits of the padding data are used.

Error Codes

25
SPECIFIED WORKSTATION DOES NOT EXIST
35
WORKSTATION HAS ONLY INPUT CAPABILITIES
265
COLOR PROCESSING INDEX < ZERO
266
COLOR PROCESSING INDEX EXCEEDS THE WORKSTATION TABLE CAPACITY
267
SPECIFIED RENDERING COLOR MODEL IS NOT SUPPORTED
268
SPECIFIED QUANTIZATION METHOD IS NOT SUPPORTED
269
ONE OF QUANTIZATION PARAMETERS IS INVALID
275
SPECIFIED ENTRY CANNOT BE CHANGED

Related Subroutines

GPCPI
Set Color Processing Index
GPQCPF
Inquire Color Processing Facilities
GPQCPR
Inquire Color Processing Representation
GPQCQM
Inquire Available Color Quantization Methods
GPQRCM
Inquire Available Rendering Color Models
GPXVR
Set Extended View Representation

RCP code

201329418 (X'0C000B0A')

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