ISO/IEC 9593-4:1991/Amd 1:1994

INTERNATIONAL ISO/IEC
STANDARD
9593-4
First edition
1991-12-15
AMENDMENT 1
1994-05-O 1
Information technology - Computer graphics -
Programmer’s Hierarchical Interactive Graphics
System (PHIGS) language bindings -
Part 4:
C
AMENDMENT 1
Technologies de /‘information - lnfographie - Interfaces langage entre un
programme d’application et son support graphiqwe -
Partie 4: C
AMENDEMENT I
Reference number
lSO/IEC 9593-4:1991/Amd.l:1994(E)

ISO/IEC 9593-4: 199UAmd.l: 1994(E)
Contents
......................................................................................................................................................................
1 scope
.............................................................................................................................................
2 Normative references
........................................................................................................................
3 The C language binding of PHIGS
...............................................................................................................................................
3.1 Conformance
.............................................................................................................................
3.2 Functions versus macros
.........................................................................................................................................
3.3 Character strings
.....................................................................................................................................
3.4 Function identifiers
.................................................................................................................................................
3 5 Registration
.....................................................................................................................
3.6 Identifiers for graphical items
...............................................................................................................................................
3.7 Return values
.................................................................................................................................................
3.8 Header files
.................................................................................................................................
3.9 Memory management
Inquiry functions which return simple lists .
3.9.1
Inquiry functions which return complex data structures .
3.9.2
Meaning of the size of an element .
3.9.3
.........................................................................................................
3.10 Inquiries returning structure elements
.............................................................................................................................................
3.11 Error handling
...............................................................................................
3.11.1 Application defined error handlers
....................................................................................................................................
3.11.2 Error codes
C specific PHIGS errors .
3.11.3
.................................................................................................................
3.12 Storage of two-dimensional data
.......................................................................................................................
3.12.1 Storage of matrices
................................................................................................................
3.12.2 Storage of colour arrays
.................................................................................................................................
3.13 Data type descriptions
4 Tables .
..................................................................................... 7
4.1 Abbreviation policy for construction of identifiers
4.2 Table of abbreviations .
4.3 Function names .
4.3.1 List ordered alphabetically by bound name .
................................................................
4.3.2 List ordered alphabetically by PHIGS function name
...................................................................................................................................................
Type definitions
Macro definitions .
C PHIGS functions .
C PHIGS PLUS type definitions .
8.1 Mapping of PHIGS PLUS data types .
..........................................................................................................
82 Modifications to PHIGS data types
.......................................................................
813 Implementation dependent PHIGS PLUS type definitions
.................................................................... 33
8.4 Implementation independent PHIGS PLUS type definitions
0 ISO/IEC 1994
All rights reserved. Unless otherwise specified, no part of this publication may be
reproduced or utilized in any form or by any means, electronic or mechanical, including
photocopying and microfilm, without permission in writing from the publisher.
ISO/IEC Copyright Office l Case postale 56 l CH-1211 Geneve 20 l Switzerland
Printed in Switzerland
ii
ISO/IEC 9593-4: 199UAmd.l: 1994(E) o ISO/IEC
Foreword
IS0 (the International Organization for Standardization) and IEC (the Inter-
national Electrotechnical Commission) form the specialized system for
worldwide standardization. National bodies that are members of IS0 or IEC
participate in the development of International Standards through technical
committees established by the respective organization to deal with particular
fields of technical activity. IS0 and IEC technical committees collaborate in
fields of mutual interest. Other international organizations, governmental and
non-governmental, in liaison with IS0 and IEC, also take part in the work.
In the field of information technology, IS0 and IEC have established a joint
technical committee, ISO/IEC JTC 1. Draft International Standards adopted by
the joint technical committee are circulated to national bodies for voting. Publi-
cation as an International Standard requires approval by at least 75 % of the
national bodies casting a vote.
Amendment 1 to International Standard ISO/lEC 9593-4:1991 was prepared by
Joint Technical Committee ISO/IEC JTC 1, Information technology.
iv
o ISO/IEC ISO/IEC 9593-4: 199UAmd.l: 1994(E)
Introduction
Replace the current text with the following:
Part 1 of the Programmer’s Hierarchical Interactive Graphics System (PHIGS)
functional description is registered as ISO/IEC 9592-l: 1989. Part 1 is extended
by part 4, ISO/IEC 9592-4:1991 to incorporate the effects of lighting, shading
and other properties important for the display of surfaces and multidimensional
data. The purpose of this part of ISOJIEC 9593 is to define a standard binding
for the C computer programming language to the functionality defined in
ISOfIEC 9592-l: 1989 and ISO/IEC 9592-4: 1991.

This page intentionally left blank

ISO/IEC 9593-4: 199l/Amd.l: 1994(E)
0 ISO/IEC
Computer graphics -
Information technology -
Programmer’s Hierarchical Interactive Graphics System
(PHIGS) language bindings -
Part 4:
C
AMENDMENT 1
1 Scope
Replace the text with the following:
Part 1 of the Programmer’s Hierarchical Interactive Graphics System (PHIGS), ISO/IEC 9592-1, and part 4
(PHlGS PLUS), ISO/IEC 9592-4, specify a language independent nucleus of a graphics system. For integration
into a programming language, PHlGS and PHIGS PLUS are embedded in a language dependent layer obeying
the particular conventions of that language. This part of ISO/lEC 9593 specifies such a language dependent layer
for the C language.
o ISO/IEC
ISO/IEC 9593-4: 199UAmd.l: 1994(E)
2 Normative references
Add the following reference:
ISO/IEC 9592-4: 1992, Information processing systems - Computer graphics -Programmer’s Hierarchical
Interactive Graphics System (PHIGS) - Part 4: Plus Lumitke und Surfaces, PHIGS PLUS.

ISO/IEC 9593-4: 199UAmd.l: 1994(E)
0 ISO/IEC
3 The C language binding of PHIGS
Change rhe clause heading to The C Ianpage binding of PHIGS and PHIGS PLUS.
3.1 Conformance
Replace the last two paragraphs with the following text:
In order to conform, an implementation of the C binding of PHIGS shall implement those functions specified in
ISO/IFC 9592-l. The implementation shall make visible all of the declarations in the C binding specified in
clauses 5 to 7 in this part of ISO/IEC 9593.
In order to conform, an implementation of the C binding of PHIGS PLUS shall implement those functions spec-
ified in ISO/IEC 9592-l and also those functions specified in ISO/IEX 95924 The implementation shall make
visible all of the declarations in the C binding specified in clauses 5 to 10 in this part of ISO/IEC 9593.
Thus, for example, the syntax of the function names shall be precisely as specified in this part of ISO/IEC 9593
and the parameters shall be of the data types stated in this part of ISO/IEC 9593.
3.2 Functions versus macros
No changes.
3.3 Character strings
No changes.
3.4 Function identifiers
No changes.
3.5 Registration
No changes.
o ISO/IEC
ISO/IEC 9593-4: 199UAmd.l: 1994(E)
3.6 Identifiers for graphical items
No changes.
3.7 Return. values
No changes.
3.8 Header files
No changes.
3.9 Memory management
No changes.
3.9.1 Inquiry functions which return simple lists
No changes.
3.9.2 Inquiry functions which return complex data structures
No changes.
3.9.3 Meaning of the size of an element
No changes.
3.10 Inquiries returning structure elements
No changes.
ISO/IEC 9593-4: 199UAmd.l: 1994(E)
o ISO/IEC
3.11 Error handling
3.11.1 Application defined error handlers
No changes.
3.11.2 Error codes
No changes.
3.11.3 C specific PHIGS errors
Change the heading to C binding specific errors and add the following binding specific errors:
two or more vertices do not contain the
2207 Ignoring function,
same type of data
Is issued when an output primitive is created in which one or more of the vertices are
specified with a particular type of data, such as normals, and other vertices are specified
without the same type of data.
3.12 Storage of two-dimensional data
No changes.
3.12.1 Storage of matrices
No changes.
ISO/IEC 9593-4: 199UAmd.l: 1994(E) o ISO/IEC
3.12.2 Storage of colour arrays
Change the heading to be Storage of arrays and replace the text with the following:
The entriesof thePpat rep and PX array&&types (where x isoneof colrv,colrv ctrl_point,
ctrl_point3, data ctrl_poGt,edge flag,facet,float,vertex, and veGex3) shallbe
-
th
stored such that the (i, j ) element in the array is given by the following expression:
i+j *DX
i = O,., DX-1,
= O,., DY-1,
j
DX = the size x value of the array’s Pint size field, and
- -
DY = the size_y value of the array’s Pint size field.
-
3.13 Data type descriptions
Add the clause with the following text.
The Pedge flag array data type defines an edge visibility flag for each edge of the quadrilateral mesh. The
- -
edge visibility flags arearranged in aMXNa.rray of Pedge-f 1agDairs. For each (ij) Pedge-f lagsair,
the first element speechifies the edge flag for the edge between the i,j and i+l j vertices and the second element
speechifies the edge flag for the edge between the ij and iJ+I vertices. The first element of the (M,j) Pedge--
Pedge f lag_pair, where I < i 5 M, are not
f lagsair, where I Ij -
used.
ThePedge flag triplet list datatypeconsistsofalistof Pedge flag triplets; oneforeach
- - - - -
triangle in a triangle set. The first element of a Pedge f lag triplet specifies the edge flag between the
first and the second vertices of the triangle, the secondelemen&ecifies the edge flag between the second and
third vertices of the triangle. The third element specifies the edge flag between the third and first vertices of the
triangle.
The Px-set datatypes(wherexisoneof colrv,contour,edge-flag,float, vertex,andvertex3)
contain a list of Px-1 i s t s.
flag) containsalistof Px sets.
The Px set listdatatypes (where x isoneof contour and edge -
- - -
o ISO/IEC ISO/IEC 9593-4: 199UAmd.l: 1994(E)
4 Tables
4.1 Abbreviatiompolicy for constructiomof identifiers
No changes.
4.2 Table of abbreviations
Add alphabetically, to table I, the following abbreviations:
Table 1 - Abbreviations ordered alphabetically
Word or Phrase Abbreviation
I
activation
amb
ambient
approximation
attenuation atten
NULL
characteristics chars
coefficient CO&
concentration cone
constant const
compute camp
criteria crit
culling cull
deactivate deact
deactivation deact
deviation dev
.
diffuse dlff
.
directional dlr
disting
distinguishing
exponent
exp
geometric geom
homogeneous homo
isoparam
isoparametric
parametric
P=m
positional
pas
product
Prod
properties
props
quadrilateral quad
ISO/IEC 9593-4:199l/Amd.l: 1994(E) o ISO/IEC
Table 1 - Abbreviations ordered alphabetically
Word or Phrase Abbreviation
I
I
\ I
reflectance refl
1 rendering rend
shading shad
specular
spec
subdivision subd
triangle tri
triangular tri
trimming trim
with NULL
43 Function names
4.3.1 List ordered alphabetically by bound name
In table 2 change the column heading PHIGS Name to PHIGS and PHIGS PLUS Name and merge alphabeti-
cally by bound name, the following function names:
Table 2 - Function names ordered by bound name
C Name
PHIGS and PHIGS PLUS Name
pcell-array3plus CELL ARRAY 3 PLUS
pfill-area-set-data
FILL AREA SET WITH DATA
pfill-area-set3-data
FILL AREA SET 3 WITH DATA
pin%b-spline-surf-fats
INQUIRE B-SPLINE SURFACE FACILITIES
ping-colr-map-fats INQUIRE COLOUR MAPPING FACILITIES
pinq_colr-map-method-fats INQUIRE COLOUR MAPPING METHOD FACILITIES
pin=colr-map-rep
INQUIRE COLOUR MAPPING REPRESENTATION
pin%colr-map-st
INQUIRE COLOUR MAPPING STATE
ping-curve-fats
INQUIRE CURVE FACILITIES
pin=data-map-fats
INQUIRE DATA MAPPING FACILITIES
pin=data-map-rep
INQUIRE DATA MAPPING REPRESENTATION
ping-depth-cue-fats
INQUIRE DEPTH CUE FACILITIES
pin=depth-cue-rep INQUIRE DEPTH CUE REPRESENTATION
pin=direct-colr-model-fats
INQUIRE DIRECT COLOUR MODEL FACILITIES
ping-dyns-ws_plus
INQUIRE DYNAMICS OF WORKSTATION PLUS
ping-edge-rep_plus
INQUIRE EDGE REPRESENTATION PLUS
ping_int-facs_plus
INQUIRE INTERIOR FACILITIES PLUS
pin%int-rep_plus
INQUIRE INTERIOR REPRESENTATION PLUS
pinq-light-source-fats INQUIRE LIGHT SOURCE FACILITIES
pin=light-source-rep
INQUIRE LIGHT SOURCE REPRESENTATION
pinqJine_facs_plus
INQUIRE POLYLINE FACILITIES PLUS
pinq_line-rep_plus
INQUIRE POLYLINE REPRESENTATION PLUS
pinqJist_colr-map-inds
INQUIRE LIST OF COLOUR MAPPING INDICES

o ISO/IEC ISO/IEC 9593-4: 199UAmd.l: 1994(E)
Table 2 - Function names ordered by bound name
C Name PHIGS and PHIGS PLUS Name
pinq_list-data-map-inds
INQUIRE LIST OF DATA MAPPING INDICES
ping-list-depth-cue-inds
INQUIRE LIST OF DEPTH CUE INDICES
pinqJist_light-source-inds
INQUIRE LIST OF LIGHT SOURCE INDICES
ping_listparam-surf-inds
INQUIRE LIST OF PARAMETRIC SURFACE INDICES
ping-list-refl-inds
INQUIRE LIST OF REFLECTANCE INDICES
pin=marker-repplus INQUIRE POLYMARKER REPRESENTATION PLUS
pin-aram-surf-fats
INQUIRE PARAMETRIC SURFACE FACILITIES
pinq_param_surf-rep
INQUIRE PARAMETRIC SURFACE REPRESENTATION
pinuat_repJlus
INQUIRE PATTERN REPRESENTATION PLUS
pin-red-colr-map-rep
INQUIRE PREDEFINED COLOUR MAPPING REPRESENTATION
pinq_pred-data-map-rep
INQUIRE PREDEFINED DATA MAPPING REPRESENTATION
pin-red-depth-cue-rep
INQUIRE PREDEFINED DEPTH CUE REPRESENTATION
pin-red-edge-rep_plus
INQUIRE PREDEFINED EDGE REPRESENTATION PLUS
pin-red-int-repplus
INQUIRE PREDEFINED INTERIOR REPRESENTATION PLUS
pin-red-light-source-rep INQUIRE PREDEFINED LIGHT SOURCE REPRESENTATION
pin-red-line-rep_plus
INQUIRE PREDEFINED POLYLINE REPRESENTATION PLUS
pin-red-marker-repplus
INQUIRE PREDEFINED POLYMARKER REPRESENTATION PLUS
pinq_pred_param-surf-rep
INQUIRE PREDEFINED PARAMETRIC SURFACE REPRESENTATION
pinq_pred_pat-rep_plus
INQUIRE PREDEFINED PATTERN REPRESENTATION PLUS
pin-red-refl-rep
INQUIRE PREDEFINED REFLECTANCE REPRESENTATION
pinq_pred-text-rep_plus
INQUIRE PREDEFINED TEXT REPRESENTATION PLUS
pin%refl-fats
INQUIRE REFLECTANCE FACILITIES
pin=refl-rep
INQUIRE REFLECTANCE REPRESENTATION
ping-rend-colr-model-fats
INQUIRE RENDERING COLOUR MODEL FACILITIES
ping-text-repplus
INQUIRE TEXT REPRESENTATION PLUS
pinqJrim.-curve-fats
INQUIRE TRIMMING CURVE FACILITIES
pinq_ws-St-table-lengthslus
INQUIRE WORKSTATION STATE TABLE LENGTHS PLUS
pnon-uniform-b-spline-curve3 NON-UNIFORM B-SPLINE CURVE 3
pnon~uniform~b~spline~curve3~colr
NON-UNIFORM B-SPLINE CURVE 3 WITH COLOUR
pnon-uniform-b-spline-surf3
NON-UNIFORM B-SPLINE SURFACE 3
pnon_uniform_b_spline_surf3_data
NON-UNIFORM B-SPLINE SURFACE 3 WITH DATA
ppolyline-set3-colr
POLYLINE SET 3 WITH COLOUR
pquad-mesh-data
QUADRILATERAL MESH WITH DATA
pquad-mesh3-data
QUADRILATERAL MESH 3 WITH DATA
pset-back-data-map-ind
SET BACK DATA MAPPING INDEX
pset-back-data-map-method SET BACK DATA MAPPING METHOD
pset-back-int-colr
SET BACK INTERIOR COLOUR
pset-back-int-ind
SET BACK INTERIOR INDEX
pset-back-int-shad-method
SET BACK INTERIOR SHADING METHOD
pset-back-int-style
SET BACK INTERIOR STYLE
pset-back-int-style-ind
SET BACK INTERIOR STYLE INDEX
pset-back-refl-ind
SET BACK REFLECTANCE INDEX
pset-back-refl-model SET BACK REFLECTANCE MODEL
pset-back-refl_props SET BACK REFLECTANCE PROPERTIES
pset-colr-map-ind
SET COLOUR MAPPING INDEX
pset-colr-map-rep
SET COLOUR MAPPING REPRESENTATION
pset-curve-approx-crit
SET CURVE APPROXIMATION CRITERIA
ISO/IEC 959394:199l/Amd.l:1994(E) o ISO/IEC
Table 2 - Function names ordered by bound name
PHIGS and PHIGS PLUS Name
C Name
pset-data-map-ind SET DATA MAPPING INDEX
pset-data-map-method SET DATA MAPPING METHOD
pset-data-map-rep SET DATA MAPPING REPRESENTATION
pset-depth-cue-ind SET DEPTH CUE INDEX
pset-depth-cue-rep SET DEPTH CUE REPRESENTATION
pset-edge-colr SET EDGE COLOUR
pset-edge-repplus SET EDGE REPRESENTATION PLUS
pset-facet-cull-mode SET FACET CULLING MODE
pset-facet-disting-mode SET FACET DISTINGUISHING MODE
pset-int-colr SET INTERIOR COLOUR
pset-int-rep_plus SET INTERIOR REPRESENTATION PLUS
pset-int-shad-method SET INTERIOR SHADING METHOD
pset-light-source-rep SET LIGHT SOURCE REPRESENTATION
pset-light-source-St SET LIGHT SOURCE STATE
pset-line-colr SET POLYLINE COLOUR
pset-line-repplus SET POLYLINE REPRESENTATION PLUS
pset-line-shad-method SET POLYLINE SHADING METHOD
pset-marker-colr SET POLYMARKER COLOUR
pset-marker-repplus SET POLYMARKJZR REPRESENTATION PLUS
pset-of-fill-area-sets-data SET OF FILL AREA SETS WITH DATA
pset_of_fill_area_sets3_data SET OF FILL AREA SETS 3 WITH DATA
pset_param-surf-chars SET PARAMETRIC SURFACE CHARACTERISTICS
pset_param-surf-ind SET PARAMETRIC SURFACE INDEX
pset_param-surf-rep SET PARAMEZ’RIC SURFACE REPRESENTATION
pset_pat-rep_plus SET PA‘TTERN REPRESENTATION PLUS
pset-refl-ind SET REFLECTANCE INDEX
pset-refl-model SET REFLECTANCE MODEL
pset-reflprops SET REFLECTANCE PROPERTIES
pset-refl-rep SET REFLECTANCE REPRESENTATION
pset-rend-colr-model SET RENDERING COLOUR MODEL
pset-surf-approx-crit SET SURFACE APPROXIMATION CRITERIA
pset-text-colr SET TEXT COLOUR
pset-text-repplus SET TEXT REPRESENTATION PLUS
ptri-set-data TRIANGLE SET WITH DATA
ptri-set3-data TRIANGLE SET 3 WITH DATA
TRIANGLE STRIP WITH DATA
ptri-strip-data
ptri-strip3-data TRIANGLE STRIP 3 WITH DATA
4.3.2 List ordered alphabetically by PHIGS function name
In table 3 change the clause heading to List ordered alphabetically by PHIGS and PHIGS PLUS function
name, change the table caption to Table 3 - Function names ordered by PHIGS and PHIGS PLUS names,
ISO/IEC 9593-4: 199UAmd.l: 1994(E)
o ISO/IEC
change the column heading PHIGS Name to PHIGS and PHIGS PLUS Name and merge alphabetically by
function name the following function names:
Table 3 - Function names ordered by PHIGS and PHIGS PLUS function name
C Name
PHIGS and PHIGS PLUS Name
pcell_array3_plus
CELL ARRAY 3 PLUS
pfill-area-set-data
FILL AREA SET WITH DATA
pfill-area-set3-data
FILL AREA SET 3 WITH DATA
INQUIRE B-SPLINE SURFACE FACILITIES pin%b-spline-surf-fats
pinq_colr-map-fats
INQUIRE COLOUR MAPPING FACILITIES
INQUIRE COLOUR MAPPING METHOD FACILITIES ping-colr-map-method-fats
pinq_colr-map-rep
INQUIRE COLOUR MAPPING REPRESENTATION
ping-colr-map-st
INQUIRE COLOUR MAPPING STATE
ping-curve-fats
INQUIRE CURVE FACILITIES
ping-data-map-fats
INQUIRE DATA MAPPING FACILITIES
ping-data-map-rep
INQUIRE DATA MAPPING REPRESENTATION
ping-depth-cue-fats
INQUIRE DEPTH CUE FACILITIES
ping-depth-cue-rep
INQUIRE DEl?TH CUE REPRESENTATION
ping-direct-colr-model-fats
INQUIRE DIRECT COLOUR MODEL FACILITIES
pinq_dyns-ws_plus
INQUIRE DYNAMICS OF WORKSTATION PLUS
ping-edge-rep_plus
INQUIRE EDGE REPRESENTATION PLUS
INQUIRE INTERIOR FACILITIES PLUS pinq_int-facs_plus
pin%int-rep_plus
INQUIRE INTERIOR REPRESENTATION PLUS
ping-light-source-fats
INQUIRE LIGHT SOURCE FACILITIES
ping-light-source-rep
INQUIRE LIGHT SOURCE REPRESENTATION
INQUIRE LIST OF COLOUR MAPPING INDICES ping-list-colr-map-inds
ping-list-data-map-inds
INQUIRE LIST OF DATA MAPPING INDICES
pinqJist_depth-cue-inds
INQUIRE LIST OF DEPTH CUE INDICES
pinq_list-light-source-inds
INQUIRE LIST OF LIGHT SOURCE INDICES
pinq_listsaram_surf-inds
INQUIRE LIST OF PARAMETRIC SURFACE INDICES
pinqJist_refl-inds
INQUIRE LIST OF REFLECTANCE INDICES
pinqqaram-surf-fats
INQUIRE PARAMETRIC SURFACE FACILITIES
pinq_param-surf-rep
INQUIRE PARAMETRIC SURFACE REPRESENTATION
INQUIRE PATTERN REPRESENTATION PLUS pin-at-rep_plus
INQUIRE POLYLINE FACILITIES PLUS ping-line-facs_plus
pincyline-rep_plus
INQUIRE POLYLINE REPRESENTATION PLUS
ping-marker-rep_plus
INQUIRE POLYMARKER REPRESENTATION PLUS
ping_pred-colr-map-rep
INQUIRE PREDEFINED COLOUR MAPPING REPRESENTATION
pinq_pred-data-map-rep
INQUIRE PREDEFINED DATA MAPPING REPRESENTATION
pinured-depth-cue-rep
INQUIRE PREDEFINED DEPTH CUE REPRESENTATION
INQUIRE PREDEFINED EDGE REPRESENTATION PLUS pin-red-edge-repBlus
INQUIRE PREDEFINED INTERIOR REPRESENTATION PLUS pin-red-int-rep_plus
INQUIRE PREDEFINED LIGHT SOURCE REPRESENTATION pin-red-light-source-rep
pinured_param-surf-rep
INQUIRE PREDEFINED PARAMETRIC SURFACE REPRESENTATION
pinq_pred_pat-rep_plus
INQUIRE PREDEFINED PATTERN REPRESENTATION PLUS
INQUIRE PREDEFINED POLYLINE REPRESENTATION PLUS pin-red-line-repslus
INQUIRE PREDEFINED POLYMARKER REPRESENTATION PLUS pin-red-marker-rep>lus
INQUIRE PREDEFINED REFLECTANCE REPRESENTATION pin-red-refl-rep
pin-red-text-repslus
INQUIRE PREDEFINED TEXT REPRESENTATION PLUS
0 ISO/IEC
ISO/IEC 9593-4: 199UAmd.l: 1994(E)
Table 3 - Function names ordered by PHIGS and PHIGS PLUS function name
C Name
PHIGS and PHIGS PLUS Name
ping-refl-fats
INQUIRE REFLECTANCE FACILITIES
pin INQUIRE REFLECTANCE REPRESENTATION
pinq_rend-colr-model-fats
INQUIRE RENDERING COLOUR MODEL FACILITIES
pinqJext_rep~lus
INQUIRE TEXT REPRESENTATION PLUS
ping-trim-curve-fats
INQUIRE TRIMMING CURVE FACILITIES
pinq_ws-st-table-lengthslus
INQUIRE WORKSTATION STATE TABLE LENGTHS PLUS
pnon_uniform_b_spline_curve3
NON-UNIFORM B-SPLINE CURVE 3
pnon_uniform_b_spline_surf3
NON-UNIFORM B-SPLINE SURFACE 3
pnon-uniform-b-spline-surf3-data
NON-UNIFORM B-SPLINE SURFACE 3 WITH DATA
pnon_uniform_b_spline_curve3_colr
NON-UNIFORM B-SPLINE CURVE 3 WITH COLOUR
ppolyline-set3-colr
POLYLINE SET 3 WITH COLOUR
pq-uad-mesh-data
QUADRILATERAL MESH WITH DATA
pquad-mesh3-data
QUADRILATERAL MESH 3 WITH DATA
pset-back-data-map-ind
SET BACK DATA MAPPING INDEX
pset-back-data-map-method
SET BACK DATA MAPPING METHOD
pset-back-int-colr
SET BACK INTERIOR COLOUR
pset-back-int-ind
SET BACK INTERIOR INDEX
pset-back-int-shad-method
SET BACK INTERIOR SHADING METHOD
pset-back-int-style-ind
SET BACK INTERIOR STYLE INDEX
pset-back-int-style
SET BACK INTERIOR STYLE
pset-back-refl-ind
SET BACK REFLECTANCE INDEX
pset-back-refl-model
SET BACK REFLECTANCE MODEL
pset-back-reflprops
SET BACK REFLECTANCE PROPERTIES
pset-colr-map-ind
SET COLOUR MAPPING INDEX
pset-colr-map-rep
SET COLOUR MAPPING REPRESENTATION
pset-curve-approx-crit
SET CURVE APPROXIMATION CRITERIA
pset-data-map-ind
SET DATA MAPPING INDEX
pset-data-map-method
SET DATA MAPPING METHOD
SET DATA MAPPING REPRESENTATION pset-data-map-rep
SET DEPTH CUE INDEX pset-depth-cue-ind
SET DEPTH CUE REPRESENTATION pset-depth-cue-rep
SET EDGE COLOUR pset-edge-colr
pset-edge-rep_plus
SET EDGE REPRESENTATION PLUS
pset-facet-cull-mode
SET FACET CULLING MODE
pset-facet-disting-mode
SET FACET DISTINGUISHING MODE
pset-int-colr
SET INTERIOR COLOUR
SET INTERIOR REPRESENTATION PLUS pset-int-rep_plus
SET INTERIOR SHADING METHOD pset-int-shad-method
SET LIGHT SOURCE REPRESENTATION pset-light-source-rep
SET LIGHT SOURCE STATE pset-light-source-St
pset-of-fill-area-sets-data
SET OF FILL AREA SETS WITH DATA
pset_of_fill_area_sets3_data
SET OF FILL AREA SETS 3 WITH DATA
SET PARAMETRIC SURFACE CHARACTERISTICS pset_param-surf-chars
SET PARAMETRIC SURFACE INDEX pset_param-surf-ind
SET PARAMETRIC SURFACE REPRESENTATION pset_param-surf-rep
SET PATTERN REPRESENTATION PLUS pset_pat-repplus
SET POLYLINE COLOUR pset-line-colr

o ISO/IEC
ISO/IEC 9593-4: 199UAmd.l: 1994(E)
Table 3 - Function names ordered by PHIGS and PHIGS PLUS function name
PHIGS and PHIGS PLUS Name C Name
SET POLYLINE REPRESENTATION PLUS pset-line-rep_plus
SET POLYLINE SHADING METHOD pset-line-shad-method
SET POLYMARKER COLOUR pset-marker-colr
SET POLYMARKER REPRESENTATION PLUS pset-marker-rep_plus
SET REFLECTANCE INDEX pset-refl-ind
SET REFLECTANCE MODEL pset-refl-model
SET REFLECTANCE PROPERTIES pset-refl_props
SET REFLECTANCE REPRESENTATION pset-refl-rep
SET RENDERING COLOUR MODEL pset-rend-colr-model
SET SURFACE APPROXIMATION CRITERIA
pset-surf-approx-crit
SET TEXT COLOUR pset-text-colr
SET TEXT REPRESENTATION PLUS pset-text-repslus
TRIANGLE SET WITH DATA ptri-set-data
TRIANGLE SET 3 WITH DATA ptri-set3-data
TRIANGLE STRIP WITH DATA ptri-strip-data
TRIANGLE STRIP 3 WITH DATA
ptri-strip3-data
ISO/IEC 9593-4: 199UAmd.l: 1994(E)
o ISO/IEC
5 Type definitions
Change the clause heading to C PHIGS type definitions.

o ISO/IEC ISO/IEC 9593-4: 199UAmd.l: 1994(E)
6 Macro definitions
Change the clause heading to C PHIGS macro definitions.
o lSO/IEC
ISO/IEC 9593-4: 199UAmd.l: 1994(E)
7 C PHIGS functions
Change the following function definitions:
INQUIRE GENERALIZED DRAWING PRIMITIVE 3
void pinq_gdp3 (
/* workstation type */
Pint
ws-type,
/* GDP function identifier
Pint “1
gdp,
/* OUT error indicator
Pint *err-ind, */
/* OUT number of attributes used
Pint *num-attr, */
/* OUT list of attributes used
Pattrs attr[7] */
> ;
INQUIRE GENERALIZED DRAWING PRIMITIVE
void pinq_gdp (
/* workstation type
Pint */
ws.Jype,
/* GDP function identifier
Pint */
gdp,
/* OUT error indicator
Pint *err-ind, */
/* OUT number of attributes used
Pint *num-attr, */
/* OUT list of attributes used
Pattrs attr[7] “1
> ;
o ISO/IEC
ISO/IEC 9593-4: 199WAmd.l: 1994(E)
8 C PHIGS PLUS type definitions
8.1 Mapping of PHIGS PLUS data types
ISO/IEC 9592-4 specifies a set of abstract data types beyond the types defined in ISO/IEC 9592-l. Table 4 - gives the
mapping from those additional data types defined in ISO/IEC 9592-4 to the data types defined later in this binding.
Table 4 - Mapping of PHIGS PLUS data types to C
C binding data type
PHIGS PLUS data type
,
COLRV Pcolrv
colour value
COLRVH
homogeneous colour value Phomo-colr-rep-ptr
GCOLR
general colour Pgcolr
NORM normal vector Pvec3
P3H Phomoqoint3
3D homogeneous point
P4H Phomoqoint4
4D homogeneous point
ISO/IEC 9593-4: 199UAmd.l: 1994(E) o ISO/IEC
8.2 Modifications to PHIGS data types .
Paspect ASPECT
typedef enum (
/* start of PHIGS enumerations */
;&d of PHIGS enumerations */
/* start of PHIGS PLUS enumerations */
PASPECT-LINE-COLR,
PASPECT-MARKER-COLR,
PASPECT TEXT COLR,
- -
PASPECT INT COLR,
- -
PASPECT-EDGE-COLR,
PASPECT-LINE-SHAD-METHOD,
PASPECT INT SHAD METHOD,
- -
PASPECT-DATA MAP METHOD,
- - -
PASPECT REFL PROPS,
- -
PASPECT-REFL-MODEL,
PASPECT BACK INT STYLE,
- - -
PASPECT BACK INT STYLE IND,
- - - -
PASPECT BACK INT COLR,
- - -
PASPECT-BACK-INT-SHAD-METHOD,
PASPECT BACK DATA MAP METHOD,
- - - -
PASPECT BACK REFL PROPS,
- - -
PASPECT BACK REFL MODEL,
- - -
PASPECT-CURVE-APPROX-CRIT,
PASPECT SURF APPROX CRIT,
- - -
PASPECT PARAM SURF CHARS
- - -
/* end of PHIGS PLUS enumerations */
) Paspect;
Pat t rs ATTRIBUTES USED
typedef enum (
/* start of PHIGS enumerations */
;;'kd of PHIGS enumerations */
/* start of PHIGS PLUS enumerations */
PATTR REFL,
PATTR-PARAM SURF
- -
/* end of PHIGS PLUS enumerations */
) Pattrs;
o ISO/IEC ISO/IEC 9593-4: 199UAmd.l: 1994(E)
Pelem data ELEMENT DATA
-
typedef union (
/* start of PHIGS element data */
;&d of PHIGS element data */
/* start of PHIGS PLUS element data */
struct Pelem_polyline~set3~colr (
*
Pint colr-type; /* colour type
/
Pvertex3 set vertex-data; /* list of vertex lists
*/
) polylinLet3 colr;
- -
struct Pelem-fill-area-set3-data (
Pint colr-type; /* colour type
*/
Pfacet *facet-data; /* facet data
*/
Pedge-flag-set *edge-flags; /* list of edge flag lists
*/
Pvertex3 set vertex-data; /* list of vertex lists
“1
> fill ar& set3 data;
- - -
struct Pelem~fill~area~set~data (
Pint colr-type; /* colour type
*/
Pfacet *facet-data; /* facet data
*/
Pedge-flag-set *edge-flags; /* list of edge flag lists
*/
*
Pvertex set vertex-data; /* list of vertex lists
/
) fill a&a set data;
- - -
struct Pelem_cell_array3_plus (
Pparal paral; /* parallelogram P, Q, R
*/
Ppat-rep_plus pattern; /* pattern colour array
*/
) cell_array3_plus;
struct Pelem~set~of~fill~area~sets3~data (
Pint colr-type; /* colour type
*/
Pset of fill area sets data *set-data;/* fill area sets data
*/
- - - - -
Pedge flag set list *edge-flags; /* list of edge flag sets */
- - -
Pvertex3Jist vertex-data; /* list of vertices */
Pcontour set list contours; /* list of contour sets
- - */
) set-of-fill-area-sets3-data;
struct Pelem~set~of~fill~area~sets~data (
/* colour type
Pint colr-type; */
*set-data;/* fill area sets data
Pset of fill area sets data */
- - - - -
/* list of edge flag sets
Pedge flag set list *edge-flags; */
- - -
Pvertex list vertex-data; /* list of vertices */
-
Pcontour set list contours; /* list of contour sets *I
-
-
) set-of-fill-area-sets-data;
struct Pelem tri-set3-data (
-
*
/* colour type
Pint colr-type; /
Ptri set data *set-data; /* triangle set data */
- -
Pedge flag triplet list *edge-flags; /* list of triangle edge flag */
- -
-
/* triplets */
*
Pvertex3-list vertex-data; /* list of vertices /
Pvertex ind triplet /* list of triangle vertex index */
list triplets;
- - -
/* triplets
*/
o ISO/IEC
ISO/IEC 9593-4: 199UAmd.l: 1994(E)
> tri set3 data;
-
-
struct Pelem-tri-set-data (
/* colour type
Pint colr-type; “1
/* triangle set data
Ptri set data *set-data; */
-
-
Pedge flag triplet-list *edge-flags; /* list of triangle edge flag */
-
-
/* triplets */
Pvertex list vertex-data; /* list of vertices */
-
*
Pvertex-ind-triplet-list triplets; /* list of triangle vertex index /
*
/* triplets /
) tri set data;
-
-
struct Pelem-tri-strip3-data (
/* colour type
Pint colr-type; */
/* list of facet data
Pfacet list *facet-data; */
-
Pedge-flag-list *edge-flags; /* list of edge flags */
Pvertex3Jist vertex-data; /* list of vertex data */
) tri strip3-data;
-
struct Pelem-tri-strip-data (
Pint colr-type; /* colour type “1
Pfacet-list *facet-data; /* list of facet data “1
Pedge-flag-list *edge-flags; /* list of edge flags */
Pvertex-list vertex-data; /* list of vertex data “1
> tri-strip-data;
struct Pelem-quad-mesh3-data (
Pint colr-type; /* colour type */
Pfacet-array *facet-data; /* array of facet data */
Pedge-flag-array *edge-flags; /* array of edge flags
*/
Pvertex3-array vertex-data; /* array of vertex data
*/
) quad-mesh3-data;
struct Pelem-quad-mesh-data (
Pint colr-type; /* colour type
*/
Pfacet-array *facet-data; /* array of facet data
*/
Pedge-flag-array *edge-flags; /* array of edge flags
*/
Pvertex-array vertex-data; /* array of vertex data
“1
) quad-mesh data;
-
struct Pelem-non-uniform-b-spline-curve3
Pcurve-geom-spline geom-spline; /* geometry spline
*/
) nonuniform-b-spline-curve3;
struct Pelem_nonuniform_b_spline_curve3_colr (
Pcurve-geom-spline geom-spline; /* geometry spline
*/
Pcurve-colr-spline *colr-spline; /* colour spline
*/
) nonuniform_b_spline_curve3_colr;
struct Pelem_nonuniform_b_spline_surf3 (
Psurf-geom-spline
geom-spline; /* geometry spline */
Ptrim-curve-loop list *trim-loops;
/* list of trimming curve loops
- */
) non-uniform-b-spline-surf3;
struct Pelem-non-uniform-b-spline-surf3_data (
Psurf-geom-spline geom-spline; /* geometry spline
*/
Ptrim-curve-loop list *trim-loops; /* list of trimming curve loops
*/
-
Psurf colr-spline
*colr-spline; /* colour spline */
-
Psurf-data spline list *data-spline; /* data spline “1
- -
) non-uniform-b-spline-surf3-data;
ISO/IEC 9593-4: 199UAmd.l: 1994(E)
o ISO/IEC
Pgcolr colr; /* general colour
*/
Pfacet disting mode facet disting_mode;/*facet distinguishing mode
- - */
-
Pfacet cull mode facet cull mode; /* facet culling mode
- - */
- -
Pdatamap-rep data map method; /* data mapping method
- - */
Prefl_prop refl_prop; /* reflectance property data
*/
struct Pelem-light-source-St (
*
Pint list act-list; /* activation list
/
-
Pint list deact list; /* deactivation list
- */
> light source st;
- -
Pcurve-approx crit curve approx-crit; /* curve approximation criteria */
-
-
/* data record
*/
surf-approx-crit; /* surface approximation criteria */
Psurf-approx-crit
/* data record
*/
Pparam-surf chars param surf-chars; /* parametric surface
*/
- -
/* characteristics data record */
/* end of PHIGS PLUS element data */
) Pelem data;
-
NOTE - ANULLvajue forthe facet-data,edge-flags,set-data,colr-spline,
trim-loops, or data-spl ine fields indicates the corresponding optional data is not
defined.
ISO/IEC 9593-4: 199UAmd.l: 1994(E)
0 ISO/IEC
Pelem type ELEMENT TYPE
-
typedef enum (
/* start of PHIGS enumerations */
;;';?nd of PHIGS enumerations */
/* start of PHIGS PLUS enumerations */
PELEM_POLYLINE_SET3_COLR,
PELEM FILL AREA SET3 DATA,
PELEM-FILL-AREA-SET DATA,
- -
PELEM CELL-ARRAY3 PLUS
- -
PELEM SET OF FILL AREA'SETS3 DATA,
- - - - - -
PELEM-SET-OF-FILL-AREA-SETS-DATA,
PELEM TRI SET3 DATA,
PELEM-TRI-SET DATA,
-
PELEM;TRI;STRIP3_DATA,
PELEM-TRI-STRIP-DATA,
PELEM QUAD MESH3 DATA,
PELEM-QUAD-MESH DATA,
PELEM-NON iNIFO6M B SPLINE CURVE3
PELEM-NON-UNIFORiB-SPLINE-CURVE3'COLR,
PELEM-NON-UNIFORM-B-SPLINE-SURF3,-
- - -- -
PELEM-NON-UNIFORM-B-SPLINE_SURF3_DATA,
PELEM DATA MAP IND,
PELEM-REFL-IND;
-
PELEM-BACK INT IND,
- - -
PELEM-BACK-DATA-MAP-IND,
PELEM BACK REFL IND,
- - -
PELEM PARAM SURF IND,
-
PELEM LINE :OLR,-
-
-
PELEM LINE SHAD METHOD,
-
COLR,
PELEM MARKER
- -
PELEM TEXT COLR,
- -
PELEM FACET DISTING MODE,
- -
PELEM FACET CULL MODE,
PELEM-INT C:LR -
PELEM-INT-SHAD'METHOD,
- - -
PELEM DATA MAP METHOD,
PELEM-REFL-PROPS,
- -
PELEM REFL MODEL,
- -
PELEM BACK INT STYLE,
- - -
PELEM-BACK-INT-STYLE-IND,
PELEM BACK INT COLR,
PELEM-BACK-INT-SHAD METHOD,
-
PELEM-BACK DATA MAP-METHOD,
- - - -
PELEM BACK REFL PROPS,
PELEM-BACK-REFL-MODEL,
- - -
PELEM LIGHT SOURCE ST,
-
PELEM-EDGE COLR,
- -
o ISO/IEC ISO/IEC 9593-4:1991/Amd.l:1994(E)
PELEM-CURVE-APPROX-CRIT,
PELEM-SURF-APPROX-CRIT,
PELEM-PARAM SURF CHARS,
- -
PELEM-REND-COLR-MODEL,
PELEM-DEPTH-CUE IND,
-
PELEM-COLR_MAP-IND
/* end of PHIGS PLUS enumerations */
> Pelem-type;
8.3 Implementation dependent PHIGS PLUS type definitions
The following type definitions may be modified by the implementation. If the implementation adds new fields to the
unions, the convention specified in clause 5.3 shall be used for naming the new field with the following addition:
For the name of a new field in a PHIGS PLUS implementation dependent type, called “xxx” in clause 5.3,
use “type."
Pcolr map method COLOUR MAPPING METHOD
- -
typedef struct (
/* colour mapping method
Pint method; */
union Pcolrmap-method-data (
*
/* number of true colours
Pint num-true-colrs; /
*
/* maximum number of pseudo
Pint max_num_pseudo-colrs; /
/* colours
*/
/* implementation defined */
} data;
) Pcolr map method;
- -
o ISO/IEC
ISO/IEC 9593-4: 199UAmd.l: 1994(E)
Pcolr map rep COLOUR MAPPING REPRESENTATION
- -
typedef struct (
Pint method; /* colour mapping method
*/
union Pcolrmap-rep-data (
struct Pcolrmap-rep-pseudo (
Pint model; /* colour model
*/
Pfloat list weight-vector; /* list of weight vector
- */
Pcolrv-list colrs; /* list of colour values
*/
) pseudo;
struct Pcolrmap-rep_pseudo-N (
Pint model; /* colour model
*/
Pfloat-set colrs; /* list of lists of colour
*/
*
/* coordinates
/
> pseudo-N;
*
/* implementation defined
/
j-data;
) Pcolrmap-rep;
Pcolr map st COLOUR MAPPING STATE
- -
typedef struct (
Pint method;
/* colour mapping method */
union Pcolrmap-St-data (
Pint num-true-colrs;
/* number of available true */
*
/ * colours
/
Pint
max-numBseudo_colrs; /* maximum number of pseudo
*/
/* colour entries
*/
/* implementation defined
*/
> 'ddta;
> Pcolrmap-st;
o ISO/IEC ISO/IEC 9593-4:199l/Amd.l:1994(E)
Pcolr rep_ptr COLOUR REPRESENTATION POINTER
-
typedef union (
Prgb *rgb; /* pointer to RGB colour values */
Pcieluv *cieluv; /* pointer to CIELW colour values*/
Phls "his; /* pointer to HLS colour values */
Phsv *hsv; /* pointer to HSV colour values */
Pdata *unsupp; /* pointer to unsupported colour */
/* values
*/
. . . /* implementation defined
*/
> Pcolr-repstr;
ISO/IEC 9593-4: 199UAmd.l: 1994(E) o ISO/IEC
Pcurve
approx cr i t CURVE APPROXIMATION CRITERIA
- -
typedef struct (
Pint /* curve approximation criteria */
type ;
/* type */
union Pcurve-approx-crit-data (
struct Pcurve-approx const_param-subd
(
-
Pint
count; /* count */
) const_param-subd;
struct Pcurve-approx-chordal-sizewc (
Pfloat
approx; /* approximation value */
> chordal-sizewc;
struct Pcurve-approx-chordal-size-npc (
Pfloat
approx; /* approximation value
*/
) chordal-size npc;
-
struct Pcurve-approx-chordal-size-dc (
Pfloat
approx; /* approximation value */
) chordal-size-dc;
struct Pcurve-approx-chordal-dev-wc (
Pfloat approx;
/* approximation value */
) chordal dev-wc;
-
struct Pcurve-approx-chordal-dev-npc (
Pfloat
approx; /* approximation value */
) chordal-dev-npc;
struct Pcurve-approx-chordal-dev-dc (
*
Pfloat
approx; /* approximation value
/
> chordal dev dc;
- -
struct Pcurve-approx-rel-wc (
*
Pf loat
approx; /* approximation value
/
) relwc;
struct Pcurve-approx-rel-npc (
Pfloat approx; /* approximation value
*/
> rel-npc;
struct Pcurve-approx-rel-dc (
Pfloat approx;
/* approximation value “1
) rel-dc;
Pdata
unsupp; /* unsupported curve approximation*/
*
/* criteria data
/
/* implementation defined
*/
> data;
) Pcurve approx crit;
-
-
ISO/IEC 9593-4: 1991/Amd.l:1994(E)
o ISO/IEC
Pdata map rep DATA MAPPING REPRESENTATION
- -
typedef struct (
Pint method; /* data mapping method
*/
Psource select list selectors; /* list of source selectors
- - */
union Pdatamap-rep-data (
struct Pdatamap-rep-single-uniform (
Pint ind; /* data value index
*/
Pfloat lower limit; /* lower range limit
- */
Pfloat upper-limit; /* upper range limit
*/
Pint colr-type; /* colour type
*/
Pcolrv-list colr-values; /* list of colour values
*/
) single-uniform;
struct Pdata~map~rep~single~non~uniform (
Pint ind; /* data value index
*/
Pfloat-list range; /* range boundaries
*/
Pint colr-type; /* colour type
*/
Pcolrv-list colr-values; /* list of colour values
*/
) single-non-uniform;
struct Pdata-map-rep-bi-uniform (
Pint inds[2]; /* data value indices
*/
Pfloat lower limit-a; /* lower limit of Ra range
- */
Pfloat upper-limit-a; /* upper limit of Ra range */
*
Pfloat lower-limit b; /* lower limit of Rb range
- /
Pfloat upper-limit-b; /* upper limit of Rb range */
Pint colr-type; /* colour type
*/
Pcolrv set colr-values; /* list of colour value lists
*/
) bi uniform;
-
struct Pdata-map-rep-bi-non-uniform (
Pint /* data value indices
inds[2]; */
/* Ra range boundaries
Pfloat list range-a; */
-
*
Pfloat set range-b; /* Rb range boundaries /
-
Pint colr-type; /* colour type */
*
Pcolrv set colr-values; /* array of colour values
- /
) bi-non-uniform;
/* implementation defined
*/
) data;
) Pdatamap-rep;
NOTE - The indexing of data mapping values is 1 based.
ISO/IEC 9593-4:199l/Amd.l:1994(E)
o ISO/IEC
Phomo colr repstr HOMOGENEOUS COLOUR REPRESENTATION POINTER
-
-
typedef union (
Phomo rgb *rgb; /* pointer to homogeneous
- rgb */
/* colour value
*/
Phomo-cieluv *cieluv; /* pointer to homogeneous
cieluv */
/* colour value
*/
Phomo-hls *his
...