ISO/IEC 9593-4:1991/Amd 1:1994
(Amendment)Information technology — Computer graphics — Programmer's Hierarchical Interactive Graphics System (PHIGS) language bindings — Part 4: C — Amendment 1
Information technology — Computer graphics — Programmer's Hierarchical Interactive Graphics System (PHIGS) language bindings — Part 4: C — Amendment 1
Amends Introduction, clauses 1, 2, 3, 4, 6, 7, subclauses 3.1, 3.11.3, 3.12.2, 3.13, 4.2 (table 1), 4.3.1 (table 2), 4.3.2 (table 3), A.1, A.2, A.3, B.6, C.1, E.1, E.2, adds clauses 8 (C PHIGS PLUS type definitions) (8.1 to 8.4), 9 (C PHIGS PLUS macro definitions) (9.1 to 9.3), 10 (C PHIGS PLUS functions) (10.1 to 10.3).
Technologies de l'information — Infographie — Interfaces langage avec PHIGS — Partie 4: C — Amendement 1
General Information
Relations
Standards Content (Sample)
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
.
directiona
...
Questions, Comments and Discussion
Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.