INTERNATIONAL ISO/IEC STANDARD 8806-4 First edition 1991-12-15 Information technology - Computer graphics Graphical Kernel System for Three Dimensions (GKS-3D) language bindings - Part 4: c pour GKS (Graphical Kernel System) pour trois dimensions Partie 4:C Reference number ISO/IEC 8806-4:1991(E) Copyright Intermational Organization for Standardization Not for Resale IS0/IEC 8806-4 : 1991(E) Contents 1 Scope..... 2 Normative referen 3 The C Language Binding of GKS-3D. 3.1 3.2 Functions versus Macros 3.3 Character Strings .... 3.4 Function Identifiers . 3.5 3.6 Identifiers for Graphical Items. 3.7 Return Values ... 3.8 Header Files... 3.9 Memory Management... 3.9.1 3.9.2 Functions which Retum Complex Data Structures 3.10 3.10.1 Application Supplied Error Handlers . 3.10.2 Error Codes.. 3.10.3 C-specific GKS-3D errors .... 3.11 Colour Representations.... 3.12 Storage of Multi-dimensional Arrays .... 3.12.1 Storage of 2*3 Matrices... 3.12.2 Storage of 3*4 Matrices... 3.12.3 Storage of 4*4 Matrices. 3.12.4 Storage of Colour Arrays... Tables... 4.1 Abbreviation Policy in Construction of Identifiers. 4.2 Table of Abbreviations Used........ 4.3 Function Names.. 4.3.1List Ordered Alphabetically by Bound Name .. 13 4.3.2ListOrderedAlphabeticallybyGKS-3DName 19 4.3.3 List Ordered Alphabetically by Bound Name within Level.... Type Definitions . 5.1 Mapping of GKS-3D data types .... 32 5.2 Environmental Type Definitions... 32 5.3 Implementation Dependent Type Definitions . 33 5.4 Implementation Independent Type Definitions ... Macro Definitions ... 6.1 Functionidentifiers .65 6.2 Error Codes.. 6.3 Miscellaneous Macros . 75 6.3.1 Linetypes.. 75 6.3.2 Marker Types.. 75 6.3.3 Colour Models... 75 6.3.4 Prompt and Echo Types. 75 6.3.5 Default Parameters of OPEN GKS. 76 CGKS-3DFunctionInterface 7.1 Notational Conventions 7.2 Control Functions 7.3 Output Functions ?ISO/IEC1991 All rights reserved. No part of this publication may be reproduced or utilized in any form or by any means, electronic or mechanicai, including photocopying and microfilm, without permission in writing from the publisher. ISO/IEC Copyright Office Case postale 56 . CH-1211 Geneve 20 . Switzerland Printed in Switzerland i Not for Resale ISO/IEC 8806-4 : 1991(E) 7.4 7.4.1 Workstation Independent Primitive Attributes... .81 7.4.2 Workstation Attributes... ...85 7.5 Transformation Functions... ..87 7.5.1 Normalization Transformation .. .87 7.5.2 View transformation functions... ..88 7.5.3 .88 7.5.4 Workstation transformation. 7.6 Segment Functions... 7.6.1 Segment Manipulation Functions ... 7.6.2 Segment Attribute Functions.. 7.7 Input Functions .... 7.7.1 Initialization of Input Devices Functions . .92 7.7.2 Setting the Mode of Input Devices Functions .... 7.7.3 Request Input Functions .. ...96 7.7.4 Sample Input Functions.. .98 7.7.5 Event Input Functions... ..100 7.8 Metafile Functions . ..102 7.9 Inquiry Functions... 7.9.1 Inquiry Functions for Operating State Value .. ..102 7.9.2 Inquiry Functions for GKS-3D Description Table .... .103 7.9.3 Inquiry Functions for GKS-3D State List... ..103 7.9.4 Inquiry Functions for Workstation State List ... .112 7.9.5 Inquiry Functions for Workstation Description Table .. ..124 7.9.6 Inquire functions for the Segment State List . .135 7.9.7 Pixel Inquiries... .136 7.9.8 Inquiry Functions for Error State List. ..137 7.10 Utility Functions ... 7.10.1 Utility Functions in GKS-3D... .10.. Binding Specific Utilities...... .138 7.11 Error Handling. ..139 A Compiled GKS-3D/C Specification.. .141 B Sample Programs . B.1 STARProgram ..204 B.2 IRON Program B.3 MAP Program. .213 B.4 ...215 B.5 SHOW LINE Program... ..221 B.6 DODECA Program..... .226 C Metafile Items.. ..231 D Short Function Identifiers .233 E Memory Management. E.1 Introduction. .240 E.2 .240 E.2.1 Operation of ginq_1ist_line_inds ..240 E.3 Functions That Return Structured Data .... .243 E.3.1 Operation of gcreate_store... 244 E.3.2 Operation of ging_stroke.st and ging pat_rep. 2