NAME

INQUIRE PREDEFINED POLYMARKER REPRESENTATION PLUS - inquire for predefined extended polymarker representation for specified workstation type

SYNOPSIS

C Syntax

void

pinq_pred_marker_rep_plus ( type, index, error_ind, bundle )

Pint                     type;         workstation type
Pint                     index;        predefined index
Pint                     * error_ind;  OUT error indicator
Pmarker_bundle_plus      * bundle;     OUT predefined polymarker rep

FORTRAN Syntax

SUBROUTINE pqpemr ( WKTYPE, INDEX, ERRIND, MTYPE, MSIZE, COLMOD, IMCOLR, MCOLR )

INTEGER      WKTYPE        workstation type
INTEGER      INDEX         predefined polymarker index
INTEGER      ERRIND        OUT error indicator
INTEGER      MTYPE         OUT polymarker type
REAL         MSIZE         OUT polymarker size scale factor
INTEGER      COLMOD        OUT colour model
INTEGER      IMCOLR        OUT indirect colour index
REAL         MCOLR(3)      OUT direct colour value

Required PHIGS Operating States

(PHOP, * ,* ,* )

DESCRIPTION

Purpose

INQUIRE PREDEFINED POLYMARKER REPRESENTATION PLUS returns the attribute values of a specified predefined entry in the extended polymarker bundle table of a workstation type's workstation description table. For a description of the contents of the bundle table entry and a description of the extended polymarker bundle table, see SET POLYMARKER REPRESENTATION PLUS.

This is a SunPHIGS Extension function based on PHIGS PLUS and is not part of the PHIGS standard.

C Input Parameters

type

The workstation type.

index

The index of the predefined entry to be returned.

C Output Parameters

error_ind

A pointer to the location to store the error number of any error that this function detects.

bundle

A pointer to a Pmarker_bundle_plus structure that returns the requested representation. Pmarker_bundle_plus is defined in phigs.h as:

typedef struct {

Pint     type; /* marker type * /
Pfloat    size;  /* marker size scale factor * /
Pgcolr   colr;  /* marker colour * /

} Pmarker_bundle_plus;

For a description of the contents of this structure, see SET POLYMARKER REPRESENTATION PLUS.

FORTRAN Input Parameters

WKTYPE

The workstation type.

INDEX

The index of the predefined entry to be returned.

FORTRAN Output Parameters

ERRIND

The error number of any error detected by this function.

MTYPE The polymarker type.

MSIZE The polymarker size scale factor.

COLMOD

The colour model. The predefined values are:

0   PINDIR   Indirect
1   PRGB     Red, Green, and Blue
2   PCIE     CIE Colour Model
3   PHSV     Hue, Saturation, and Value
4   PHLS     Hue, Lightness, and Saturation

IMCOLR

An integer containing the index into the workstation colour table for the polymarker colour. This value is not used if COLMOD is greater than zero.

MCOLR(3)

An array of reals containing the polymarker colour. This array is unused if COLMOD is equal to zero (PINDIR).

MCOLR(1) = Red, Hue, and so on

MCOLR(2) = Green, Saturation, Lightness, and so on

MCOLR(3) = Blue, Value, Saturation, and so on

Execution

If the inquired information is available, then the error indicator is returned as zero, and values are returned in the output parameters.

If the inquired information is not available, then the values returned in the output parameters are undefined, and the error indicator is set to one of the error numbers below to indicate the reason for nonavailability.

Since this is an inquiry function, ERROR HANDLING is not invoked when this function detects an error.

ERRORS

002

Ignoring function, function requires state (PHOP, * ,* ,* )

051

Ignoring function, this information unavailable for this workstation type

052

Ignoring function, workstation type not recognized by the implementation

062

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

100

Ignoring function, the bundle index value is less than one

102

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

SEE ALSO

SET POLYMARKER REPRESENTATION PLUS (3PP)

INQUIRE POLYMARKER REPRESENTATION PLUS (3PP)

INQUIRE PREDEFINED POLYMARKER REPRESENTATION (3P)