ISO/IEC 8651-4:1995

INTERNATIONAL ISO/IEC
STANDARD 8651-4
Second edition
1995-06-01
Information technology - Computer
graphics - Graphical Kerne1 System (GKS)
language bindings -
Part 4:
C
Technologies de I ’information - Infogt-aphie - Interfaces langage avec
GKS -
Partie 4: C
Contents
V
Foreword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Vi
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.......................................................................................................................................................
1 Scope
...........................................................................................................................
2 Normative references
.......................................................................................................................
3 The C language binding
................................................................................................
3.1 Classification and designation
..........................................................................................................
3.2 Functions versus macros
.......................................................................................................................
3.3 Character strings
...................................................................................................................
3.4 Function identifiers
3.5 Registration .
................................................................................................. 4
3.6 Identifiers for graphical items
3.7 Return values .
Headers .
3.8
3.8.1 gks.h .
3.8.2 gks compat.h .
..............................................................................................................
3.9 Memory management
3.9.1 Functions which return simple lists .
Functions which return complex data structures .
3.9.2
...........................................................................................................................
3.10 Error handling
Application supplied error handlers .
3.10.1
.................................................................................................................
3.10.2 Error Codes
...............................................................................................
3.10.3 C-specific GKS errors
............................................................................
3.11 Colour representations and specifications
...............................................................................................................
3.12 Colour characteristics
......................................................................................
3.13 Storage of multi-dimensional arrays
.............................................................................................
3.13.1 Storage of 2*3 matrices
.............................................................................
3.13.2 Storage of conics in 3*3 matrices
3.13.3 Storage of colour arrays .
.......................................................................................
3.14 Compatibility with the 1991 edition
-
4 Tables .
4.1 Abbreviation policy in construction of identifiers .
4.2 Table of abbreviations used .
4.3 Function names .
4.3.1 List ordered alphabetically by bound name .
4.3.2 List ordered alphabetically by GKS name .
5 .
Type definitions
..................................................................................................
5.1 Mapping of GKS data types
5.2 .
Environment-defined type definitions
.....................................................................
5.3 Implementation dependent type definitions
...................................................................
5.4 Implementation independent type definitions
6 Macro definitions .
6.1 Function identifiers .
6.1.1 In Order of appearance .
- -
6.1.2 In alphabetical Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
0 ISO/IEC 1995
All rights reserved. Unless otherwise specified, no part of this publication may be
reproduced or utilized in any form or by any means, electronie or mechanical, including
photocopying and microfilm, without permission in writing from the publisher.
ISO/IEC Copyright Office l Case postale 56 l CH-121 1 Geneve 20 0 Switzerland
Printed in S witzerland
ii
--
ISO/IEC 8651-4 : 1995(E)
0 ISO/IEC
6.2 Error Codes . . . . . . . . . . . . . . . . . . ‘.
6.3 Miscellaneous . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . “.
6.3.1 Linetypes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.3.2 Marker types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . “.
6.3.3 Hatch styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.3.4 Colour models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.3.5 Prompt and echo types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.3.6 Default Parameter of gopen gks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
-
7 C GKS function interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Notational conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.1
Workstation independent functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.2
7.2.1 Control functions .
7.2.2 Output functions .
7.2.3 Design output functions .
7.2.4 Primitive attribute functions .
7.2.5 Normalization transformation functions .
NDC picture functions .
7.2.6
7.2.7 Metafile functions .
7.2.8 Picture part store functions .
7.2.9 Input functions .
7.2.10 Font and glyph functions . 131
7.2.11 Audit and playback functions .
7.2.12 Inquiry functions .
7.2.13 Utility functions .
7.3 Workstation functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.3.1 Control functions Y.
7.3.2 Inquiry functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.3.3 Retrieval functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.3.4 Viewing Utility functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.3.5 Colour Utility functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
7.4 Segment functions and workstation activation functions
7.4.1 Segment functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.4.2 Workstation activation functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.4.3 Utility functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
I
Annexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .~.
A Compiled GKS /C specification .
AS Data types in compilation Order .
A.2 Macros .
A.3 Function calls .
A.4 Compatibility layer .
..............................................................................................................................
B Sample programs
B.l STAR .
B.2 IRON .
.................................................................................................................
c Short function identifiers
In Order of appearance .
...