NAME

INQUIRE PREDEFINED COLOUR REPRESENTATION − inquire a predefined colour representation for a workstation type

SYNOPSIS

C Syntax

void
pinqpredcolourrep ( type, index, error_ind, bundle )
Pwstypetype;workstation type
Pintindex;predefined index
Pint∗error_ind;OUT error indicator
Pcobundl∗bundle;OUT predefined colour rep

FORTRAN Syntax

SUBROUTINE pqpcr ( WTYPE, PCI, ERRIND, C1, C2, C3 )
INTEGERWTYPEworkstation type
INTEGERPCIpredefined colour index
INTEGERERRINDOUT error indicator
REALC1, C2, C3OUT colour components

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE PREDEFINED COLOUR REPRESENTATION to determine the predefined colour representation for a specified workstation type at a given colour index. 

C Input Parameters

type
Type of workstation.

index
Entry in the workstation table of predefined colour representations to be returned.

C Output Parameters

error_ind
A pointer to the location to store the error number of any error detected by this function.

bundleA pointer to a Pcobundl structure in which the system returns the colour representation at index on the workstation table of predefined colour representations.  Pcobundl is defined in phigs.h as:

typedef struct {
Pfloatx;/∗ red, hue, etc., colour value ∗/
Pfloaty;/∗ green, saturation, lightness, etc., colour value ∗/
Pfloatz;/∗ blue, value, saturation, etc., colour value ∗/
} Pcobundl;

FORTRAN Input Parameters

WTYPE
Type of workstation.

PCI
Entry in the workstation table of predefined colour representations to be returned.

FORTRAN Output Parameters

ERRIND
The error number of any error detected by this function.

C1The first colour component of the colour representation at index PCI in the workstation table of predefined colour representations (red, hue, etc.). 

C2The second colour component of the colour representation at index PCI in the workstation table of predefined colour representations (green, saturation, lightness, etc.). 

C3The third colour component of the colour representation at index  PCI in the workstation table of predefined colour representations (blue, value, saturation, etc.). 

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

051Ignoring function, this information is not yet available for this workstation type; open a workstation of this type and use the specific workstation type

052Ignoring function, workstation type not recognized by the implementation

059Ignoring function, the specified workstation does not have output capability (i.e., the workstation category is neither OUTPUT, OUTIN, nor MO)

062Ignoring function, this information is not available for this MO workstation type

113Ignoring function, the colour index value is less than zero

102Ignoring function, the specified representation has not be predefined on this workstation

Sun Release 4.0  —  Last change: 10 July 1989