ISO/IEC INTERNATIONAL STANDARD 8651-4 Second edition 1995-06-01 Information technology - Computer graphics Graphical Kernel System (GKS) language bindings - Part 4: c Technologies de I'information - Infographie Interfaces langage avec GKS Partie 4: C 4T Referencenumber ISO/IEC 8651-4:1995(E) Copyright Intemational Organization for Standardization Not for Resale ISO/IEC 8651-4: 1995(E) Contents Foreword. Introduction Scope Normative references 3 The C language binding. 3.1 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 Headers 3.8.1 gks.h... 3.8.2 gks_compat.h.. 3.9 Memory management. 3.9.1 3.9.2 Functionswhichreturncomplexdata structures 3.10 Error handling... 3.10.1 Application supplied error handlers... 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.... Tables.. 4.1 Abbreviation policy in construction of identifiers. 4.2 Table of abbreviations used.... 4.3 Function names 4.3.1 List ordered alphabeticaily by bound name 4.3.2 List ordered alphabetically by GKS name... 20 5.1 Mapping of GKS data types .28 5.2 Environment-defined type definitions.... .28 5.3 Implementation dependenttypedefinitions 29 5.4 Implementation independent type definitions. 35 6 Macro definitions .... 91 6.1 Function identifiers.. 91 6.1.1 In order of appearance. 91 6.1.2 In alphabetical order... ..95 ISO/IEC1995 All rights reserved. Unless otherwise specified, no part of this publication may be reproduced or utilized in any form or by any means,eiectronic or mechanical, including photocopying andmicrofilm,withoutpermission inwritingfromthepublisher. ISO/IEC Copyright Office · Case postale 56 · CH-1211 Geneve 20 · Switzerland Printed in Switzerland ii Copyright Intemational Organization for Standardization ing permitted without license from IHS Not for Resale @ISO/IEC ISO/IEC 8651-4 : 1995(E) 6.2 Error codes .99 6.3 Miscellaneous .104 6.3.1 Linetypes 6.3.2 Marker types. .104 6.3.3 Hatch styles.... ...104 6.3.4 Colour models.. .104 6.3.5 Prompt and echo types ..105 6.3.6 Default parameter of gopen_gks. ..105 CGKS function interface . .106 7.1 7.2 Workstation independent functions... ..106 7.2.1 Control functions ... 7.2.2 Output functions .108 7.2.3 Design output functions .110 7.2.4 Primitive attribute functions.... ...113 7.2.5 Normalization transformation functions .. ..119 7.2.6 NDC picture functions..... 7.2.7 Metafile functions .... .121 7.2.8 Picture part store functions ... 7.2.9 Input functions . ...124 7.2.10 Font and glyph functions .131 7.2.11 Audit and playback functions 7.2.12 Inquiry functions.. .132 7.2.13 Utility functions 7.3 Workstation functions. ..148 7.3.1 Control functions ... .148 7.3.2 Inquiry functions........... ..155 7.3.3 Retrieval functions .172 7.3.4 Viewing utility functions 7.3.5 Colour utility functions . ...173 7.4 Segment functions and workstation activation functions.. .173 7.4.1 Segment functions.... 7.4.2 Workstation activation functions .. 176 7.4.3 Utility functions . ...176 Annexes .177 Compiled GKS/C specification .. .177 A.1 Data types in compilation order. ...177 A.2 Macros . .223 A.3 Function call.. A.4 Compatibility layer .260 B Sample programs . ...271 B.1 STAR.. .271 B.2 IRON.. .273 C Short function identifiers C.1 In order of appearance ..280 C.2 In alphabetical order .. D Memory management.. 294 D.1 Introduction..... ..294 D.2 Functions that return simple lists... D.2.1 Operationofginq_list_line_inds ..295 D.3 D.3.1 Operation of gcreate_store..... ..298 iii Copyright Intemational Organization for Standardization No reproduc ing permitted without license from IHS Not for Resale ISO/IEC 8651-4 : 1995(E) @ISO/IEC D.3.