INQUIRE CURRENT ELEMENT TYPE AND SIZE(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE CURRENT ELEMENT TYPE AND SIZE − inquire the type and size of the current element

SYNOPSIS

C Syntax

void
pinqcurelemtypesize ( error_ind, type, size )
Pint∗error_ind;OUT error indicator
Peltype∗type;OUT element type
Pint∗size;OUT element size

FORTRAN Syntax

SUBROUTINE pqcets ( ERRIND, ELTYPE, IL, RL, SL )
INTEGERERRINDOUT error indicator
INTEGERELTYPEOUT element type
INTEGERILOUT dimension of integer array
(this may be passed to PQCECO as ILL)
INTEGERRLOUT dimension of real array
(this may be passed to PQCECO as IRL)
INTEGERSLOUT dimension of character array
(this may be passed to PQCECO as ISL)

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

INQUIRE CURRENT ELEMENT TYPE AND SIZE determines the type and size of the current element.

C Output Parameters

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

typeReturns the type of the current element. For example, a polyline primitive element would be returned as PEL_POLYLINE, a character height attribute as PEL_CHARACTER_HEIGHT, a modelling transformation as PEL_LOCAL_MODELLING_TRANSFORMATION3, and so forth. The Peltype enumerated type is defined in phigs.h as follows:

typedef enum {
PEL_NIL,
PEL_POLYLINE3,
PEL_POLYLINE,
PEL_POLYMARKER3,
PEL_POLYMARKER,
PEL_TEXT3,
PEL_TEXT,
PEL_ANNOTATION_TEXT_RELATIVE3,
PEL_ANNOTATION_TEXT_RELATIVE,
PEL_FILL_AREA3,
PEL_FILL_AREA,
PEL_FILL_AREA_SET3,
PEL_FILL_AREA_SET,
PEL_CELL_ARRAY3,
PEL_CELL_ARRAY,
PEL_GDP3,
PEL_GDP,
PEL_POLYLINE_INDEX,
PEL_POLYMARKER_INDEX,
PEL_TEXT_INDEX,
PEL_INTERIOR_INDEX,
PEL_EDGE_INDEX,
PEL_LINETYPE,
PEL_LINEWIDTH_SCALE_FACTOR,
PEL_POLYLINE_COLOUR_INDEX,
PEL_MARKER_TYPE,
PEL_MARKER_SIZE_SCALE_FACTOR,
PEL_MARKER_COLOUR_INDEX,
PEL_TEXT_FONT,
PEL_TEXT_PRECISION,
PEL_CHARACTER_EXPANSION_FACTOR,
PEL_CHARACTER_SPACING,
PEL_TEXT_COLOUR_INDEX,
PEL_CHARACTER_HEIGHT,
PEL_CHARACTER_UP_VECTOR,
PEL_TEXT_PATH,
PEL_TEXT_ALIGNMENT,
PEL_ANNOTATION_TEXT_CHARACTER_HEIGHT,
PEL_ANNOTATION_TEXT_CHARACTER_UP_VECTOR,
PEL_ANNOTATION_TEXT_PATH,
PEL_ANNOTATION_TEXT_ALIGNMENT,
PEL_ANNOTATION_STYLE,
PEL_INTERIOR_STYLE,
PEL_INTERIOR_STYLE_INDEX,
PEL_INTERIOR_COLOUR_INDEX,
PEL_EDGE_FLAG,
PEL_EDGETYPE,
PEL_EDGEWIDTH_SCALE_FACTOR,
PEL_EDGE_COLOUR_INDEX,
PEL_PATTERN_SIZE,
PEL_PATTERN_REFERENCE_POINT_AND_VECTORS,
PEL_PATTERN_REFERENCE_POINT,
PEL_ADD_NAMES_TO_SET,
PEL_REMOVE_NAMES_FROM_SET,
PEL_INDIVIDUAL_ASF,
PEL_HLHSR_IDENTIFIER,
PEL_LOCAL_MODELLING_TRANSFORMATION3,
PEL_LOCAL_MODELLING_TRANSFORMATION,
PEL_GLOBAL_MODELLING_TRANSFORMATION3,
PEL_GLOBAL_MODELLING_TRANSFORMATION,
PEL_MODELLING_CLIPPING_VOLUME3,
PEL_MODELLING_CLIPPING_VOLUME,
PEL_MODELLING_CLIPPING_INDICATOR,
PEL_RESTORE_MODELLING_CLIPPING_VOLUME,
PEL_VIEW_INDEX,
PEL_EXECUTE_STRUCTURE,
PEL_LABEL,
PEL_APPLICATION_DATA,
PEL_GSE,
PEL_PICK_ID,
PEL_POLYLINE_SET3_DATA,†
PEL_FILL_AREA3_DATA,†
PEL_FILL_AREA_SET3_DATA,†
PEL_TRIANGLE_STRIP3_DATA,†
PEL_QUADRILATERAL_MESH3_DATA,†
PEL_POLYHEDRON3_DATA,†
PEL_NON_UNIFORM_B_SPLINE_CURVE,†
PEL_NON_UNIFORM_B_SPLINE_SURFACE,†
PEL_EXTENDED_CELL_ARRAY3,
PEL_TEXT_COLOUR,†
PEL_POLYMARKER_COLOUR,†
PEL_EDGE_COLOUR,†
PEL_POLYLINE_COLOUR,†
PEL_CURVE_APPROXIMATION_CRITERIA,†
PEL_POLYLINE_SHADING_METHOD,†
PEL_INTERIOR_COLOUR,†
PEL_BACK_INTERIOR_COLOUR,†
PEL_BACK_INTERIOR_STYLE,†
PEL_BACK_INTERIOR_STYLE_INDEX,†
PEL_AREA_PROPERTIES,†
PEL_BACK_AREA_PROPERTIES,†
PEL_INTERIOR_SHADING_METHOD,†
PEL_BACK_INTERIOR_SHADING_METHOD,†
PEL_INTERIOR_REFLECTANCE_EQUATION,†
PEL_BACK_INTERIOR_REFLECTANCE_EQUATION,†
PEL_SURFACE_APPROXIMATION_CRITERIA,†
PEL_TRIM_CURVE_APPROXIMATION_CRITERIA,†
PEL_FACE_DISTINGUISHING_MODE,†
PEL_FACE_CULLING_MODE,†
PEL_LIGHT_SOURCE_STATE,†
PEL_DEPTH_CUE_INDEX,†
PEL_COLOUR_MAPPING_INDEX,
PEL_RENDERING_COLOUR_MODEL,
PEL_NUM_EL_TYPES
} Peltype;

† This is a SunPHIGS Extension which is based on PHIGS+ and is not part of the PHIGS standard.

sizeReturns the size, in bytes, that the application will have to allocate in order to call INQUIRE CURRENT ELEMENT CONTENT to retrieve the contents of the current element. If the current element type is such that it is not necessary to allocate any dynamic memory to retrieve its contents, a value of zero is returned.

FORTRAN Output Parameters

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

ELTYPE
Returns the type of the current element. For example, a polyline primitive element would be returned as PEPL, a character height attribute as PECHH, a local modelling transformation as PELMT, and so forth. The FORTRAN definitions for element types are in phigs77.h. A mapping from the six-character FORTRAN definitions to the actual PHIGS element type names is given below. These definitions have been alphabetized for ease of use in this listing only.

ADD NAMES TO SETPEADS
ANNOTATION STYLEPEANST
ANNOTATION TEXT ALIGNMENTPEATAL
ANNOTATION TEXT CHARACTER HEIGHTPEATCH
ANNOTATION TEXT CHARACTER UP VECTORPEATCU
ANNOTATION TEXT PATHPEATP
ANNOTATION TEXT RELATIVEPEATR
ANNOTATION TEXT RELATIVE 3PEATR3
APPLICATION DATAPEAP
AREA PROPERTIES†PEAPR
BACK AREA PROPERTIES†PEBAPR
BACK INTERIOR COLOUR†PEBIC
BACK INTERIOR REFLECTANCE EQUATION†PEBIRE
BACK INTERIOR SHADING METHOD†PEBISM
BACK INTERIOR STYLE†PEBIS
BACK INTERIOR STYLE INDEX†PEBISI
CELL ARRAYPECA
CELL ARRAY 3PECA3
CHARACTER EXPANSION FACTORPECHXP
CHARACTER HEIGHTPECHH
CHARACTER SPACINGPECHSP
CHARACTER UP VECTORPECHUP
COLOUR MAPPING INDEX†PECMI
CURVE APPROXIMATION CRITERIA†PECAC
DEPTH CUE INDEX†PEDCIN
EDGE COLOUR†PEEDC
EDGE COLOUR INDEXPEEDCI
EDGE FLAGPEEDFG
EDGE INDEXPEEDI
EDGETYPEPEEDT
EDGEWIDTH SCALE FACTORPEEWSC
EXECUTE STRUCTUREPEEXST
EXTENDED CELL ARRAY 3†PEECA
FACE CULLING MODE†PEFCM
FACE DISTINGUISHING MODE†PEFDM
FILL AREAPEFA
FILL AREA 3PEFA3
FILL AREA 3 WITH DATA†PEFAD3
FILL AREA SETPEFAS
FILL AREA SET 3PEFAS3
FILL AREA SET 3 WITH DATA†PEFSD3
GDPPEGDP
GDP 3PEGDP3
GLOBAL MODELLING TRANSFORMATIONPEGMT
GLOBAL MODELLING TRANSFORMATION 3PEGMT3
GSEPEGSE
HLHSR IDENTIFIERPEHRID
INDIVIDUAL ASFPEIASF
INTERIOR COLOUR†PEIC
INTERIOR COLOUR INDEXPEICI
INTERIOR INDEXPEII
INTERIOR REFLECTANCE EQUATION†PEIRE
INTERIOR SHADING METHOD†PEISM
INTERIOR STYLEPEIS
INTERIOR STYLE INDEXPEISI
LABELPELB
LIGHT SOURCE STATE†PELSS
LINETYPEPELN
LINEWIDTH SCALE FACTORPELWSC
LOCAL MODELLING TRANSFORMATIONPELMT
LOCAL MODELLING TRANSFORMATION 3PELMT3
MARKER COLOUR INDEXPEPMCI
MARKER SIZE SCALE FACTORPEMKSC
MARKER TYPEPEMK
MODELLING CLIPPING INDICATORPEMCLI
MODELLING CLIPPING VOLUMEPEMCV
MODELLING CLIPPING VOLUME 3PEMCV3
NILPENIL
NON-UNIFORM B-SPLINE CURVE†PENBSC
NON-UNIFORM B-SPLINE SURFACE†PENBSS
PATTERN REFERENCE POINTPEPARF
PATTERN REFERENCE POINT AND VECTORSPEPRPV
PATTERN SIZEPEPA
PICK IDENTIFIERPEPKID
POLYHEDRON 3 WITH DATA†PEPHD3
POLYLINEPEPL
POLYLINE 3PEPL3
POLYLINE COLOUR†PEPLC
POLYLINE COLOUR INDEXPEPLCI
POLYLINE INDEXPEPLI
POLYLINE SET 3 WITH DATA†PEPSD3
POLYLINE SHADING METHOD†PEPLSM
POLYMARKERPEPM
POLYMARKER 3PEPM3
POLYMARKER COLOUR†PEPMC
POLYMARKER INDEXPEPMI
QUADRILATERAL MESH 3 WITH DATA†PEQMD3
REMOVE NAMES FROM SETPERES
RENDERING COLOUR MODEL†PERCM
RESTORE MODELLING CLIPPING VOLUMEPERMCL
SURFACE APPROXIMATION CRITERIA†PESAC
TEXTPETX
TEXT 3PETX3
TEXT ALIGNMENTPETXAL
TEXT COLOUR†PETXC
TEXT COLOUR INDEXPETXCI
TEXT FONTPETXFN
TEXT INDEXPETXI
TEXT PATHPETXP
TEXT PRECISIONPETXPR
TRIANGLE STRIP 3 WITH DATA†PETRSD
TRIMMING CURVE APPROXIMATION CRITERIA†PETCAC
VIEW INDEXPEVWI

† This is a SunPHIGS Extension which is based on PHIGS+ and is not part of the PHIGS standard.

ILReturns the dimension required for the integer array argument to INQUIRE CURRENT ELEMENT CONTENT in order to retrieve the current element contents.

RLReturns the dimension required for the real array argument to INQUIRE CURRENT ELEMENT CONTENT in order to retrieve the current element contents.

SLReturns the dimension required for the character array argument to INQUIRE CURRENT ELEMENT CONTENT in order to retrieve the current element contents.

ERRORS

005Ignoring function, function requires state (PHOP, ∗, STOP, ∗)

Museum