ANSI INCITS ISO IEC 9593-3-1990 Information Technology - Computer Graphics - Programmer s Hierarchical Interactive Graphics System (PHIGS) Language Bindings (Part 3 Ada) (Amendment.pdf

1、INCITS/ISO/IEC 9593-3-1 990/ AMI-1994 (R1999) (formerly ANSI/ISO/IEC 9593-3-1990/ AM 1 - 1 994 (R 1 999) for Information Technology - Computer Graphics - Programmers Hierarchical Interactive Graphics System (PHIGS) Language Bindings - Part 3: Ada - Amendment 1: Incorporation of PHIGS PLUS Developed

2、by SM Where IT all begins Approval of an American National Standard requires review by ANSI that the requirements for due process, consensus, and other criteria for approval have been met by the standards developer. Consensus is established when, in the judgment of the ANSI Board of Standards Review

3、, substantial agreement has been reached by directly and materially affected interests. Substantial agreement means much more than a simple majority, but not necessarily unanimity. Consensus requires that all views and objections be considered, and that a concerted effort be made toward their resolu

4、tion. The use of American National Standards is completely voluntary; their existence does not in any respect preclude anyone, whether he has approved the standards or not, from manufacturing, marketing, purchasing, or using products, processes, or procedures not conforming to the standards. The Ame

5、rican National Standards Institute does not develop standards and will in no circumstances give an interpretation of any American National Standard. Moreover, no person shall have the right or authority to issue an interpretation of an American National Standard in the name of the American National

6、Standards Institute. Requests for interpretations should be addressed to the secretariat or sponsor whose name appears on the title page of this standard. CAUTION NOTICE: This American National Standard may be revised or withdrawn at any time. The procedures of the American National Standards Instit

7、ute require that action be taken periodically to reaffirm, revise, or withdraw this standard. Purchasers of American National Standards may receive current information on all standards by calling or writing the American National Standards Institute. American National Published by American National S

8、tandards Institute 11 West 42nd Street, New York, New York 10036 Copyright O1 994 by Information Technology Industry Council (ITI) All rights reserved. These materials are subject to copyright claims of International Standardization Organization (ISO), International Electrotechnical Commission (IEC)

9、, American National Standards Institute (ANSI), and Information Technology Industry Council (ITI). Not for resale. No part of this publication may be reproduced in any form, including an electronic retrieval system, without the prior written permission of ITI. All requests pertaining to this standar

10、d should be submitted to ITI, 1250 Eye Street NW, Washington, DC 20005. Printed in the United States of America ANSI/ISO/IEC 9593-3-1 990/AM 1-1 994 Supplement to ANSI/ISO 9593-3-1 990 American National Standard for Information Technology Computer Graphics - Programmers Hierarchical I n teractive G

11、rap hics System (PHIGS) Language Bindings - Part 3: Ada - Amendment 1 : Incorporation of PHIGS PLUS Secretariat Information Technology Industry Council Approved November 17, 1994 American National Standards Institute, Inc. Contents Page Foreword v Introduction vi 1 Scope . 1 2 Normative references .

12、 2 3 Principles .3 3.1 Conformance . . 3 3 2 implications of the Language. .3 3.2.1 Functional Mapping. . 3 3 2.2 Implementations and Host Dependencies 3 3 2 3 Error Handling . 4 4 3.2.4 Data Mapping 3.2 5 Multi-tasking . 4 3 3 2 6 Packaging 3.2 7 Application Program Environment 3 3 2 8 Registration

13、 1 4 Tables . 4 1 Abhreviations used in procedure names 4 1 1 List of procedures using the abbrcviations 4 1 2 Alphabctical bj bound name 4 1 3 Alphabetical PHIGS functions 4 2 1 Abbreviations used in the data tjpe definitions 4.2.2 Alphabetical list of hpe definitions 4.2.3 Alphabetical list of pri

14、vate tjpe definitions 4 2 4 List of constant declarations 4 2 5 PHIGS configuration values 4 3 Error Codes . 4 2 Data tlpe definitions 5 5 5 6 8 x x 8 8 X 8 9 11 4.3.1 Precluded Error Codes 9 4.3.2 Binding Specific Error Codes 9 5 Functions in the Ada Binding of PHIGS . 10 5.2 Output primitive funct

15、ions 10 5.3 Attribute specification functions . 10 5.4 Transformation and clipping functions 10 5.5 Structure content functions . 10 5.6 Structure manipulation functions 11 5.7 Structure display functions . 11 5.8 Structure archive functions . 11 5.9 input functions . 11 5.10 Metafile functions 11 5

16、.11 Inquiry functions . 11 5.12 Error control functions . 11 5.13 Special interface functions 12 5.14 Additional functions . 12 5.14.1 Subprograms for manipulating input data records 12 5.14.2 PHIGS generic coordinate system package . 12 5.14.3 PHIGS generic list utility package . 12 5 . i4 4 PHIGS

17、name set facility package 12 5.14.5 Deallocation of structure element records 12 5 i4 6 Metafile function utilities 13 5.15 Conformal variants . 13 5.1 Control functions 10 6 Tables for PHIGS PLUS 14 6 1 Data type definitions . 14 6 1 1 Abbreviations used in the data type definitions 14 6.1.2 Replac

18、ement definition for type ASPECT . . . 14 6 1 3 Replacement definition for type ATRIBTES-USED-TYPE . 16 6.1.4 Replacement definition for type ELEMENT-TYPE . 16 6 1 5 Replacement definition for type STRUCTURE-ELEMENT-RECORD . . . 20 6 1.6 Additions to alphabetical list of PHIGS type definitions . . .

19、 30 6.1 7 Additions to list of constant declarations . . 67 6.1 8 PHIGS PLUS configuration values . . 69 7 Functions in the Ada Binding of PHIGS PLUS . 7.1 Output primitive functions 7.2 Attribute specification functions 7.3 Inquiry functions . 7 4 Additional functions 92 93 7 4 1 Changes to PHIGS g

20、eneric coordinate system package . 7 4 1 Additions to PHIGS generic coordinate system package 93 7 4.2 PHIGS PLUS generic colour package 05 7.4 3 Deallocation of PHIGS PLUS structure element records . 08 Compilable PHIGS Specification . 10 . 111 Cross Reference Listing of Implementation Defined Item

21、s . 298 Example Programs 299 C . 1 Example Program 1: STAR . 299 C.2 Example Program 2: IRON 299 C.3 Example Program 3 . DYNASTAR 299 C.4 Example Program 4: TRANSFORM_POLYLE . 299 C.5 Example Program 5 : SHOW-LINETYPES . 299 C.6 Example Program 6: DODECAHEDRON . 300 C.7 Example Program 7: TRIMMED-SU

22、RFACE 308 PHIGS Multi-Tasking . 313 Index 314 iv Foreword (This foreword is not part of American National Standard ANSI/ISO/IEC 9593-3-1 990/AM 1-1 994. This document is identical to ISO/IEC 9593- 3:1990/Amd. 1:1994 and the following three paragraphs are the original fore- word as it appeared in tha

23、t document.) IS0 (the international Organization for Standardization) and IEC (the International 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 te

24、chnical committees established by the respective organization to deal with particular fields of technical activity. IS0 and IEC technical commit- tees collaborate in fields of mutual interest. Other international organiza- tions, governmental and non-governmental, in liaison with IS0 and IEC take pa

25、rt 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 adopt- ed by the joint technical committee are circulated to national bodies for voting. Publication as an International Standard requires ap

26、proval by at least 75% of the national bodies casting a vote. Amendment 1 to International Standard ISO/IEC 9593-3:1990 was prepared by Joint Technical Committee ISOAEC JTC 1 , Information technology. Requests for interpretation, suggestions for improvement or addenda, or defect reports are welcome.

27、 They should be sent to the X3 Secretariat, Information Technology Industry Council, 1250 Eye Street, NW, Suite 200, Washington, DC 20005. This standard was processed and approved for submittal to ANSI by Accredited Standards Committee on Information Technology, X3. Committee approval of the standar

28、d does not necessarily imply that all committee members voted for its approval. At the time it approved this standard, the X3 Committee had the following members: James D. Converse, Chair Donald C. Loughry, Vice-Chair Joanne Flanagan, Secretary Organization Represented Name of Representative America

29、n Nuclear Society Geraldine C. Main Sally Hartzell (Alt.) AMP, Inc. Edward Kelly Charles Brill (Alt.) Apple Computer, Inc. . David K. Michael AT No changes o ISO/IEC 4.2.5 PHIGS configuration values pages 69 to 71. No changes 8 O ISOAEC 4.3 Error Codes page 72: No changes. ISOAEC 9593:1990/Amd. 1:19

30、94(E) 4.3.1 Precluded Error Codes page 72: No changes. page 72: The following text should be added after clause 4.3.1 as clause 4.3.2 of ISOAEC 9593-3. 4.3.2 Binding Specific Error Codes The following binding specific error has been defined for use with this binding: 2502 Ignoring firnction. the par

31、ameters have inconsistent dimensions. 9 ISO/IEC 9593:1990/Amd. 1:1994(E) 5 Functions in the Ada Binding of PHIGS page 73: No changes. 5.1 Control functions pages 73 and 74: No changes. 5.2 Output primitive functions pages 74 to 77: No changes. 5.3 Attribute specification functions pages 78 to 84: No

32、 changes. 5.4 Transformation and clipping functions pages 85 to 91 : No changes O ISOAEC 5.5 Structure content functions pages 91 lo 94: No changes 10 O ISOfiEC 5.6 Structure manipulation functions pages 94 and 95: No changes. 5.7 Structure display functions page 95: No changes. 5.8 Structure archiv

33、e functions pages 95 to 97: No changes. 5.9 Input functions pages 98 to I06 No changes 5.10 Metafile functions pages I06 and 107. No changes 5.11 Inquiry functions pages 107 to 132. No changes ISO/IEC 9593:1990/Amd. 1:1994(E) 5.12 Error control functions page 132 No changes. 11 ISO/IEC 9593:1990/Amd

34、. 1:1994(E) 5.13 Special interface functions pages 133 and 134: No changes. 5.14 Additional functions page 134: No changes. 5.14.1 Subprograms for manipulating input data records pages I34 to 138: No changes. 5.14.2 PHIGS generic coordinate system package pages 138 and 141 No changes. 5.14.3 PHIGS g

35、eneric list utili9 package pages 141 to 143. No changes 5.14.4 PHIGS name set facility package pages III to I47 No changes 5.14.5 Deallocation of structure element records pages I4 7 to 149 No changes 12 O ISOflEC 5.14.6 Metafile function utilities page 149: No changes. ISO/IEC 9593: 1990/Amd. 1 : 1

36、994(E) 5.15 Conformal variants page 150: No changes. 13 ISO/IEC 9593:1990/Amd. 1:1994(E) O ISOAEC page 150: The following text should be added after clause 5 as clauses 6 and 7 of ISOAEC 9593-3: 6 Tables for PHIGS PLUS 6.1 Data type definitions This clause contains modifications to type definitions

37、used for PHIGS as well as new type definitions used to support PHiGS PLUS 6.1.1 Abbreviations used in the data type definitions page 16: The following should be added to the list of abbreviations used in the data type definitions in clause 4.2.1: APPROX approximation 6.1.2 Replacement definition for

38、 type ASPECT The following definition should replace the type ASPECT in 4.2.2. ASPECT type ASPECT is ( TYPEOF-LME, LINEWIDTH-SF, LINECOLOUS 14 O ISOAEC ISOIIEC 9593:1990/Amd. 1:1994(E) TYPE-OF-MARKER, SIZE, MARKER-C OLOUR, FONT, PRECISION, EXPANSION, SPACING, TEXT-COLOUR, STYLE-OF-INTERIOR, STYLE-IN

39、D, INTERIOR-COLOUR, FLAG, WE-OFEDGE, EDGEWIDTH-SF, EDGE-COLOUR, GENER4L-POLYLINE-COLOUR, GENERAL-POLYMARKER-COLOUR, GENERALTEXT-COLOUR, GENERAL-INTERIOR COLOUR, GENERAL-EDGECOLOUR, METHOD-OF-POLYLINE-SHADING, METHOD-OF-INTERIOR-SHADING, METHOD-OF-DATA-MAPPING, REFLECTANCE-PROPERTIES, MODELOF-REFLECT

40、ANCE, BAC KSTYLE-OF-INTE RI O R, BACK-STYLE-iND, BACK-INTERIOR-COLOUR-DI R, BACK-METHOD-OF-INTERIOR-SHADING, BACKMETHOD-OF-D AT AM APPING, BACK-REFLECTANCE-PROPERTIES, BACK-REFLECTANCE-MODEL, CRITERIAFOR-CURVEAPPROX, CRITERIAFOR-SURFACEAPPROX, CHARACTERISTICS-OF-PARAMETRIC-SURFACE), - This type list

41、s the aspects for which an aspect source flag exists in PHIGS PLUS 15 ISOIIEC 9593:1990/Amd. 1:1994(E) O ISOAEC 6.1.3 Replacement definition for type ATTRIBUTES-USED-TYPE The following definition should replace the type ATTRIBUTES-USED-TYPE in 4.2.2: AITRIBUTES-USED-TYPE type ATRIBUTES-USED-TYPE is

42、( POLYLINE-ATTRIBUTES, POLYMAFKER-ATRIBUTES, TEXT-ATRIBUTES, INTERIOR-AlBUTES, EDGE-AITRIBUTES, REFLECTANCE-ATIRIBUS, PAR4METRIC-SURFACE-AlTRIBUTES); - The types of attributes which may be used in generating output for a GDP and in generating - prompt and echo information for certain prompt and echo

43、 types of certain classes of input - devices. 6.1.4 Replacement definition for type ELEMENT-TYPE The following definition should replace the type ELEMENTTYPE in 4.2.2: ELEMENT-TYPE type ELEMENT-TYPE is ( ALLELEMENT-TYPES , NIL, POLYLME 3, POLYLME; POLYMARKER-3, POLYMARKER, TEXT-3, TEXT, ANNOTATI ONT

44、EXT-RELATIVE-3, ANNOTATION-TEXT-RELATiVE, 16 O ISO/IEC ISO/IEC 9593:1990/Amd. 1:1994(E) FILL-AREA-3, FILL-AREA, FILL-AREA-SET-3, FILL-AREA-SET, CELL-ARRAY-3, CELL-ARRAY, GDP-3, GDP, SET-P OLYLINE-INDEX, SET-POLYMARKER-INDEX, S ET-TEXT-INDEX, SET-INTERIOR-INDEX, SET-EDGE-INDEX, SET-LINETYPE, SET-LINE

45、WIDTH-SCALE-FACTOR, SET-POLYLINE-COLOLR-INDEX, SET-MARKER-TYPE, SET-MARKER-SIZE-SCALE-FACTOR, SET-P OLYMARKER-C OLOUR-INDEX, S ETTEXT-FONT, SET-TEXT-PRECISION, SET-CHAR-EXPANSIONFACTOR, SET-CHAR-SPACING, SET-TEXT-COLOUR-INDEX, SET-CHAR-HEIGHT, SET-CHAR-UP-VECTOR, SET-TEXT-PATH, SET-TEXT-ALIGNMENT, S

46、ET ANNOTATION TEXT CHAR HEIGHT, SET ANNOTATION TEXT PATH, S ET-ANNOT AT ON-STYLE, s ETANN OTATIONTEXTCHAR-VECTOR, SETANNOTATIONTEXTALIGNMENT, S ET-INTE RI O R-STYLE, SET-INTERIOR-STYLE-INDEX, SET-INTERIOR-COLOUR-INDEX, 17 ISO/IEC 9593:1990/Amd. 1 :1994(E) O ISOAEC SET EDGE FLAG, SET-EDGEWIDTH-SCALE-

47、FACTOR, SET-EDGE-COLOUR-INDEX, SETEDGE-E, SET-PATERN-SIZE, SET-P ATTERN-REFERENCE_POI“D_VECTORS , SET-PATIERN-REFERENCE-POINT, ADD-N AMES-TO-SET, REMOVE-NAMESFROM-SET, SET-INDMDUALASF, SET-HLHSR-IDENTIFIER, SET-LOCAL-TRANSFORMATION-3, SET LOCAL-TRANSFORMATION, SETIGLOBAL-TRANSFORMATION-3, SET-GLOBAL

48、-TRANSFORMATION, SET-MODELLING-CLIPPING-VOLUME 3, SET-MODELLING-CLIPPING-INDICATOR, RESTORE MODELLING-CLIPPING-VOLUME, SET-MODELLING-CLIPPING-VOLUME: SET-VIEG-INDEX, EXECUTE-STRUCTURE, LABEL, APPLICATION-D ATA, GSE, SET-PICK-IDENTIFIER, POLYLINE-SET-3-WITH-COLOUR, FILL-AREA-SET-3-WITH_DATA, FILLAREA

49、-SETWITH-DATA, CELLARRAY-3-PLUS, SET-OF-FILL-AREA-SETS-3W ITH-D ATA, SET-OF-FILLAREA-SETS-WITH-DATA, TRIANGLE-SET-3-WITH-DATA, TRIANGLESET-WITH-D ATA, TRIANGLESTRIP-3WITH-DATA, TRIANGLE-STRIP-WITH-D ATA, QUADRILATERAL_MESH3WITH-DATA, QUADRILATERAL-MESHWITH-DATA, NON-UNIFORM-E3-SPLINE-CURVE, NON-UNIFORM-B-S PLINE-C UR*-WITH-COLOUR, NON-UNIFORMB-S PLINE-S URFACE, NON-UNIFORM-B-SPLINE-SURFACE-WITH-DATA, 18 O ISODEC ISOliEC 9593:1990/Amd. 1:1994(E) SET-DATA-MAPPING-INDEX, S ET-REFLECTANCE-INDEX, SET-B ACK-INTERIOR-INDEX, SET-BACK-D ATA-MAPPING-INDEX, SET-B ACK-REFLECT