1、 - BSI BS*ISO/IEC 9636-3 94 Lb24bb9 0470995 936 BRITISH STANDARD Implementation of ISOAEC 9638-3 : 1994 Information technology - Computer graphics - Interfacing techniques for dialogues with graphical devices (CGI) - Language bindings Part 3. Ada BS ISO/IEC 9638-3 : 1994 - BSI BS*ISO/IEC 9638-3 94 I
2、t624669 0470996 872 W BS ISO/IEC 9638-3 : 1994 Committees responsible for this British Standard The preparation of this British Standard was entrusted by the Information Systems Technology Assembly (IST/-) to Technical Committee IST/31, Computer graphics and image processing, upon which the followin
3、g bodies were represented Department of Trade and industry (National Engineering Laboratory) Department of Trade and Industry (It Standards Unit (ItdGa) Joint Information System Committee Rutherford Appleton Laboratory This British Standard, having been prepared under the direction of the Informatio
4、n Systems Technology Assembly, was published under the authority of the Standards Board and comes into effect on 16 June 1995 O BSI 1995 Amendments issued since publication Amd. No. Date I Text affected The following BSI references relate to the work on this standard: Committee reference IST/31 Draf
5、t for comment 93/642824DC ISBN O 580 24406 7 BSI BS*ISO/IEC 9638-3 94 1624669 0470997 709 W BS ISO/IEC 9638-3 : 1994 National foreword Thic British Standard reproduces verbatim ISOAEC 96383 : 1994 and implements it as the UK national standard. This British Standard is published under the direction o
6、f the Information Systems Technology Assembly whose Technical Committee ISTB1 has the responsibility to: - aid enquirers to understand the text; - present to the responsible international committee any enquiries on interpretation, or proposals for change, and keep UK interests informed; - monitor re
7、lated international and European developments and promulgate them in the UK NOTE. International and European Standards, as weii as overseas standards, are available from Customer SeMces, BSI, 389 Chiswick High Road, London W4 4AL. Compliance with a British Standard does not of itself confer immunity
8、 from legal obligations. i BSI BS*ISO/IEC 9638-3 94 W Lb24bb9 0470998 645 1 N TE R NAT I O NA L STANDARD ISO/IEC First edition 1994-1 2-1 5 Information technology - Computer graphics - Interfacing techniques for dialogues with graphical devices (CGI) - Language bindings - Part 3: Ada Technologies de
9、 linformation - Infographie - Techniques interfaciales pour dialogues avec dispositifs graphiques (CGI) - Liants de langage - Partie 3: Ada Reference number ISO/IEC 963&3:1994(E) BSI BS*ISO/IEC 9638-3 94 Lb24bb9 0470997 5BL ISO/IEC 9638-3: 199403 Contents Foreword iv IntNxuctian v 1scope . 1 2Normat
10、iveref 3 Principles . 3 3.1Confomance . 3 3 3.2.1FunctionalmapPng . 3 3.2.2 Impiemenration and bost dependencies 5 3.2.4 Continuation of functions . 7 3.2.5 Packeddataformats . 8 3.2.6 Events and event report lists . 8 3.2.7Datamapping . 9 3.2.8Mdti-tasking . 11 3.2 Implications of the language 3.2.
11、3 Error handling . 5 3.2.9packaging 11 3.2.10 Client program environment 13 4.1 Abbreviations used m the Ada language binding 14 4.2 Abbreviation poiicy in consuction of identiers 14 4.3.1 Alphabetical by bound name . 15 4.3.2 Alphabetical by CGI function name 21 3.2.11Registration . 13 4Tables . 14
12、 4.3CGIfunUionnames 15 5CGIconfgurationvalues 28 6Typedefmitions 34 6.1Arraymdexranging 35 6.2 Representation of CGI basic data types . 36 6.3 Representation of CGI strings . 42 6.4 Representation of CGI data records . 44 6.6 Representation of CGI enumerateci data types 53 6.5RepresentationofCGItdat
13、atypes . 45 0 ISOLEC 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 . Printed in Switzerland
14、 ISODEC Copyright Office Case postale 56 CH-1211 Genve 20 Switzerland ii BSI BS*ISO/IEC 9638-3 74 m 1624669 OY71000 9Tl m 6.7 CGI Ada record types . 67 6.9CGIAdaarraytypes . 78 6.10 CGI Ada access types 91 6.11 CGI exceptions 92 6.8CGIAdasubtypes . 77 7CGI/Adafunctions 93 7.1 Part 2 conml functions
15、93 7.2Part3outputfunctions . 100 7.3 Part 4 segment functions 125 7.4 Patt 5 input functions 130 7.5Part6rasterfunctions 155 7.6 Binding defined utility functions 160 7.6.1 Data record utilities 160 7.6.1.1 Data record utility constants . 160 7.6.1.2 Data record utility types . 163 7.6.1.3 Data reco
16、rd utility functions . 164 7.6.2 String utilities 174 7.6.2.1 String utility functions 174 7.6.3 Error handling utilities 175 7.6.3.1 Error handling utility functions . 175 7.6.4 Data packing utilities . 177 7.6.4.1 Data packing utility types 177 7.6.4.2 Data packing utility functions . 178 AnnexA 1
17、81 A.l Package specification CGI-CONFIG . 182 A.2 Package specification CGI-TYPES 187 A.3 Package Specification CGI-DATA-RECORD_UTILS . 218 A.4 Package specification CGI 225 AS Package specification CGI-PROFLE-ID-CONST . 271 A.6 Package specification CGI-FNCTION-Ii-CONST 273 A.7 Package specificatio
18、n CGI-REGISTRATION-CONST 295 A.8 Package specification CGI-ERROR-CONST . 297 A.9 Package specification CGI-STRING-UTKS 310 A.10 Package specification CGI-ERROR-HANDLING-UTILS . 311 A.11 Package specification CGOACIUNG-UTLS . 312 AnnexB 315 B.l Example Program 1: Star . 315 B.2 Example Program 2: Nam
19、e Object . 319 A.3 Example Program 3: Text . 328 B.4 Example Program 4: Load CGI Database 331 B.4 Example Program 5: Event Queue Pkg 335 AnnexC 340 AnoexD 346 AnnexE 354 iii ISO/IEC 9638-3: 1994) BSI BS*ISO/IEC 7638-3 74 D 1b24bb9 047L001 838 D Foreword IS0 (the International Organization for Standa
20、rdization) 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 organiza
21、tion 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,
22、 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. Publication as an International Standard requires approval by at least 75 % of the national bodies casting a
23、vote. International Standard ISOAEC 9638-3 was prepared by Joint Technical Com- mittee ISOAEC JTC 1, Information technology, Subcommittee 24, Computer graphics and image processing. ISOIEC 9638 consists of the following parts, under the general title Information technology - Computer graphics - Inte
24、rfacing techniques for dialogues with graphical devices (CGZ) - Language bindings: - Part 1: FORTRAN - Part 2: PASCAL - Part 3: Ada ISO/IEc Annexes A, B, C, D and E of this part of ISOIEC 9638 are for information only. iv BSI BS*ISO/IEC 9638-3 94 1624669 0473002 774 ISOAEC %38-3:1994(E) Introduction
25、 The Computer Griiphics Interface (CGI) (ISOAEC 9636) is specified in a language iodependent man= and needs to be embedded in language depemknt layers (language bindings) for use with particular pugramming ianguages. The purpose of this doanneat is to defm a staodard binding ofCGI to the Ada awpiter
26、programming WYWe. V BSI BS*ISO/IEC 9638-3 94 = I1624669 0471003 600 H INTERNATIONAL STANDARD ISO/IEC 9638-3:1994(E) Information technology - Computer graphics - Interfacing techniques for dialogues with graphical devices (CGI) - Language bindings - Part 3: Ada 1 scope The Computer Graphics Interface
27、 (CGI) (ISO/IEC 9636). specifies a language independent standard mterface between device-independent and devicedependent parts of a graphics system. For integration into a programmmg bguage, CGI is embeddeb in a ianguage &pendent ayer obeying the particuiar cwventions of that ianguage. This part of
28、ISO/IEC 9638 specifies such a language aependent layer for the Ada programming language. scope 1 BSI BS*ISO/IEC 7b38-3 94 W 3624667 O473004 547 M ISO/IEC %38-3:1994(E) 2 Normative references The foliowing standards amtam provisions which, through reference in this text, constitute provisiis of this
29、part of ISOIIEC %38. At the time of Won, the editions mdicated were valid. AU standards are subject to revisim, and parties to agreemeats based on this part of ISOE 9638 am enawaged to investigate the possibility of applying the most recent editions of the standards listed below. Members of IEC and
30、IS0 maintah registers of currenly valid hemaid Standards. IS0 8652 1987, Programming Languages - Ada. ISO/LEc %36k 1991, Information technoiogy - Computer graphics - Interfacing techniques for dialogues with graphics devices (CGI) - Functional Specmation - Part 1: Overview, profles, and conformance.
31、 ISO/IEc %3&21991, Information technology - Computer graphcs - Interfacing techniques for dialogues with graphics devices (CGI) - Functional Specmation - Part 2: Control. ISO/IEc 96363:1991, Infotvnathn technoiogy - Computer graphics - Interfacing lechniques for dialogues with graphics devices (CGI)
32、 - Functional Specijkation - Part 3: Output. ISO/IEc %3#:1991, Information techmhgy - Computer graphics - Inteqacing lechniQues for diaiogues with graphics devices (CGI) - Functiona Specmation - Part 4: Segments. ISO/IEc %365:1991, Information technobgy - Computer graphics - Integachg techniques for
33、 dialogues with graphics devices (CGI) - Functiona Spec#ication - Part 5: Input and echoing. ISO/IEc %36-6:1991, Information technoiogy - Computer graphics - Interfacing techniques for dialogues with graphics devices (CGI) - Functional Specification - Part 6: Raster. ISO/IEc %37-1:1S92, Infomation t
34、echnology - Computer graphics - Interfcing techniques for dialogues with graphics devices(CGI) - Data stream binding - Part i: Character encoding. ISOIiEC 9637-2 1992, Information technology - Computer graphics - Interfacing techniques for dialogues with graphics devices(CGI) - Data stream binding -
35、 Part 2: Binary encoding. 2 BSI BS*ISO/IEC 9638-3 94 Lb24bb9 0473005 483 3 Principles Thisbioding supporis the impiementalion independent aspects of the Adastandard exceptas discussedunder multi-taskhg. This bmding does not aswme that tbe cunpiex supports any Ada language feanires which are impiem.n
36、tatian dependent, but impiies that tbe annpiier must be able to support the declaratioos contained in this CGVAda binding. This binding does not make any assumptioos regarding the machme representation of the preefmed Ada nvmeric types. 3.1 Conformance Thisbindingmcorporates the niles of conformance
37、 defuied m the ISOIIEC 9636 for CGI impiemenrations wit tbese additiooal requirements specifically dened foi Ada impleaneutations of CGI. The foiowing critaia are established for detemirnui . g conformance or nonconformance of an implementation to this binding: - The semantics of an implmentation &a
38、il be those stated in the CGI standard as modified or extended for Ada as stated m this binding document. - The package(s) correspondm . g to CGI &ali be an availabie Adalibrary unit, with ail names as specifed by this document or as modined fa one of more CGI pmfhs. 3.2 Implications of the language
39、 3.2.1 Fiinetionril map- The fuactions wbicb constitute tbe ISO/IEC % are each mapped to Ada procediaes witbin tbis language binding. This mapping utilizes a one-to-one correlation between the CGI functions eanboied in the CGI standard and the Ada pnicedutes berein, with the exption of tbe gene& fua
40、ctid defmitions within the CGI staadard In the case of tbese g&c functional definitions, multiple Ada procedures have been utili to attain the functional mappiug (big). The following list denotes ali such functions and Wu Ada binding complements: ISOE %3 Functioa : Put Current Unput class Measure is
41、 bound to - Put Ciirrent Locator Measre Put Current Stroke Measure Put Cmmt Vaiuatar Measure Put Current Choice Measure Put Current Pick Measure Put Ciirrent String Measure Put Cinrent Raster Measure Put Current Genemi Measure ISO/IEC 9636 Fimction : &put class Device Data 3 ES1 BS*ISO/IEC 9638-3 94
42、 W Lb24669 0471006 3LT W ISO/IEc 9638-3: 1994(E) is bound to - Set Locator Device Data Set Stroke Device Data Set Valuator Device Data Set Choice Device Data Set Pick Device Data Set String Device Data Set Raster Device Data Set General Device Data ISO/IEC 9636 Function : Request is bound to - Reque
43、st Locator Request Stroke Request Valuator Request Choice Request Pick Request String Request Raster Request General ISOIIEC 9636 Function : Sample is bound to - Sample Locator Sample Stroke Sample Valuator Sample Choice Sample Pick Sample String Sample Raster Sample General ISO/IEc 9636 Function :
44、Echo Request is bound to - Echo Request Locator Echo Request Stroke Echo Request Valuator Echo Request Choice Echo Request Pick Echo Request Suing Echo Request Raster Echo Request General ISO/IEC 9636 Function : Dequeue Event is bound to - Dequeue Locator Event Dequeue Stroke Event Dequeue Valuator
45、Event Dequeue Choice Event Dequeue Pick Event Dequeue String Event 4 Principles BSI BS*ISO/IEC 9638-3 94 1624669 0473007 256 M ISOm 9638-3: 1994) Dequeue Raster Event Dequeue General Event ISOIIEC 9636 Function : Update Echo Output is bound to - Update Locator Echo Output Update Stroke Echo Output U
46、pdate Valuator Echo Output Update Choice Echo Output Update Pick Echo Output Update String Echo Output Update Raster Echo Output Update General Echo Output 3.2.2 Implementation and host dependencies There are a number of implementation and host dependent issues which will be associated with an Ada c
47、ompiler and its run-time environment. These issues will affect the portability of application (clientlgenerator, driver, target, .) programs utilizing this binding of CGI. The client programmer should follow accepted practices for ensuring portability of Ada programs to avoid introducing problems wh
48、en rehosting an application of CGI to another system. This binding attempts to avoid dependencies on compiler specific Ada types which may vary from machine to machine. Since CGI provides for variable precisions which may be specified by the client, the situation could exist in which an 8-bit, 16-bi
49、t, %-bit, or 32-bit machine will meet all of the required needs for a particular CGI client as long as the client stays within the ranges provided by the host machine. Wherever possible, universal integer type definitions have been applied in this part of ISOAEC 9638 in order to support the variable precisions required by the CGI client. These universal types are specified via minimum and maximum values which are contained in the CGI configuration package. Therefore a conforming implementation/application of CGI may change these val
