INQUIRE PREDEFINED POLYMARKER REPRESENTATION(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE PREDEFINED POLYMARKER REPRESENTATION − inquire a predefined polymarker representation for a workstation type

SYNOPSIS

C Syntax

void
pinqpredmarkerrep ( type, index, error_ind, bundle )
Pwstypetype;workstation type
Pintindex;predefined index
Pint∗error_ind;OUT error indicator
Pmkbundl∗bundle;OUT predefined polymarker rep

FORTRAN Syntax

SUBROUTINE pqppmr ( WTYPE, PMI, ERRIND, MTYPE, MSZSF, COLI )
INTEGERWTYPEworkstation type
INTEGERPMIpredefined polymarker index
INTEGERERRINDOUT error indicator
INTEGERMTYPEOUT marker type
REALMSZSFOUT marker size scale factor
INTEGERCOLIOUT polymarker colour index

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

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

C Input Parameters

type
Type of workstation.

index
Entry to be returned from the workstation table of predefined polymarker representations.

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 Pmkbundl structure, in which the system returns the polymarker representation at index in the workstation table of predefined polymarker representations. Pmkbundl is defined in phigs.h as:

typedef struct {
Pinttype;/∗ marker type ∗/
Pfloatsize;/∗ marker size scale factor ∗/
Pintcolour;/∗ colour index ∗/
} Pmkbundl;

FORTRAN Input Parameters

WTYPE
Type of workstation.

PMI
Entry to be returned from the workstation table of predefined polymarker representations.

FORTRAN Output Parameters

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

MTYPE
The marker type at index PMI in the workstation table of predefined polymarker representations.

MSZSF
The marker size scale factor at index PMI in the workstation table of predefined polymarker representations.

COLIThe marker colour index at index PMI in the workstation table of predefined polymarker representations.

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

100Ignoring function, the bundle index value is less than one

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

Museum