ANSI INCITS 124.2-1988 Information Systems - Computer Graphics - Graphical Kernel System (GKS) Pascal Binding.pdf

1、ADOPTED FOR USE BYTHE FEDERAL GOVERNMENTSEE NOTICE ON INSIDEANSI INCITS 124.2-1988 (R1999)(formerly ANSI X3.124.2-1988 (R1999) for Information Systems -Computer Graphics -Graphical Kernel System (GKS)Pascal Binding PUB 120-1This standard has been adopted for Federal Government use. Details concernin

2、g its use within the Federal Government are contained in Federal information Processing Standards Publication 120-1, Graphical Kernel System (GKS). For a complete list of the publications available in the Federal Information Processing Standards Series, write to the Standards Processing Coordinator

3、(ADP), National Institute of Standards and Technology, Gaithersburg, MD 20899. ANSI X3.124.2-1988 American National Standard for Information Systems - Computer Graphics 7 Graphical Kernel System (GKS) Pascal Binding Secretariat Computer and Business Equipment Manufacturers Association Approved Febru

4、ary 18, 1988 American National Standards Institute, Inc AmericanNationalStandardApproval of an American National Standard requires review by ANSI that therequirements for due process, consensus, and other criteria for approval havebeen met by the standards developer.Consensus is established when, in

5、 the judgment of the ANSI Board of StandardsReview, substantial agreement has been reached by directly and materiallyaffected interests. Substantial agreement means much more than a simplemajority, but not necessarily unanimity. Consensus requires that all views andobjections be considered, and that

6、 a concerted effort be made toward theirresolution.The use of American National Standards is completely voluntary; their existencedoes not in any respect preclude anyone, whether he has approved the standardsor not, from manufacturing, marketing, purchasing, or using products, processes,or procedure

7、s not conforming to the standards.The American National Standards Institute does not develop standards and will inno circumstances give an interpretation of any American National Standard.Moreover, no person shall have the right or authority to issue an interpretation ofan American National Standard

8、 in the name of the American National StandardsInstitute. Requests for interpretations should be addressed to the secretariat orsponsor whose name appears on the title page of this standard.CAUTION NOTICE: This American National Standard may be revised orwithdrawn at any time. The procedures of the

9、American National StandardsInstitute require that action be taken periodically to reaffirm, revise, or withdrawthis standard. Purchasers of American National Standards may receive currentinformation on all standards by calling or writing the American National StandardsInstitute.Published byAmerican

10、National Standards Institute11 West 42nd Street, New York, New York 10036Copyright 1988 by Information Technology Industry Council (ITI)All rights reserved.No part of this publication may be reproduced in anyform, in an electronic retrieval system or otherwise,without prior written permission of ITI

11、, 1250 Eye Street NW,Washington, DC 20005.Printed in the United States of AmericaForeword (This Foreword is not part of American National Standard X3 124 2-1988.) This American National Standard provides access to a set of basic functions for computer graphics pro- gramming in American National Stan

12、dard Programming Language Pascal, ANSI/LEE 770X3.97-1983 These graphics functions taken as a whole are called the Pascal language binding of the Graphical Kernel System (GKS). This standard defines a Pascal application level programming interface to a graphics system. Hence, it contains functions fo

13、r (1) outputting graphical primitives, (2) controlling the appearance of graphical primitives with attributes, (3) controlling graphical workstations, (4) controlling transformation and coor- dinate systems, (5) generating and controlling groups of primitives called segments, (6) obtaining graphi- c

14、al input, (7) manipulating groups of device-independent instructions called metafiles, (8) inquiring the capabilities and states of the graphics system, and (9) handling errors. For each GKS function, a Pascal procedure declaration is given. In addition, any special errors associated only with the P

15、ascal language binding of GKS are specified and assigned unique error numbers. Finally, all of the data types and constants necessary to access the procedures are defined. Twelve upwardly compatible levels of conformance are defined, addressing the most common classes of equipment and applications.

16、American National Standard for Information Systems - Computer Graphics - Graphical Kernel System (GKS) Functional Description, ANSI X3.124-1985, is supplemented by this derivative standard. ANSI X3.124-1985 corresponds to IS0 7942-1985 in that it represents the functional aspects of GKS. ANSI X3.124

17、.2-1988 contains specifications not present in ANSI X3.124-1985, namely, the syntax for using GKS functions and data types from Pascal. This standard was developed by Technical Committee X3H3 of American National Standards Committee X3 under project 531-D authorized by X3 (described in document X3H3

18、/85-116). This standard was approved as an American National Standard by the American National Standards Insti- tute on February 18, 19S8. Suggestions for improvement of this standard will be welcome. They should be sent to Computer and Business Equipment Manufacturers Association, 311 First Street,

19、 NW, Suite 500, Washington, DC 20001. This standard was processed and approved for submittal to ANSI by Accredited Standards Committee on Information Processing Systems, X3. Committee approval of the standard does not necessarily imply that all committee members voted for its approval. At the time i

20、t approved this standard, the X3 committee had the following members: Richard Gibson, Chair Donald C. Loughry, Vice-Chair Catherine A. Kachurik, Administrative Secretary Organizarion Represeured Name of Representalive American Library Association . Paul Peters American Nuclear Society . Geraldine C

21、Main Organization Represented Name of Representative AMP Incorporated . Apple . Association of the Institute for Certification of Computer Professionals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AT-1-.- -I.-;._ -_-_ .- _ -c-i =e-.- -:s_ ._ .- . . _ .“. _-m I _A- .-.-Ail- r AMERICAN

22、 NATIONAL STANDARD X3.124.2-1988 3. The Pascal Language Binding of GKS 3.1 Specification The GKS language binding interface for Pascal, as described in ANSI/IEEE 770X3.97-1983, shall be as described in clauses 3, 4, 5, and 6. 3.2 Mapping of GKS Function Names to Pascal Procedure Names The function n

23、ames of GKS are all mapped to Pascal procedures which begin with the letter “G”. Words and phrases used in the GKS function names are often abbreviated in the Pascal representation. There is a set of such abbreviations given in Table 1 and the resulting Pascal procedure names are listed in Tables 2,

24、 3, and 4. For example, the abbreviation for the GKS function DELETE SEGMENT FROM WORKSTATION is GDclSegWs. “Del”, “Seg”, “Ws” are the abbreviations for DELETE, SEGMENT and WORKSTATION. Conjunctives such as “from”, “and”, “of” and “to” are mapped to null strings, as are a number of other words used

25、in the GKS abstract names. For example, INQUIRE MAXIMUM LENGTH OF WORKSTATION STATE TABLES is mapped to GInqMaxWsSt. Here LENGTH and TABLES are represented by null strings. AMERICAN NATIONAL STANDARD X3.124.2-1988 The Pascal Language Binding of GKS Mapping of GKS Function Names to Pascal Procedure N

26、ames Table 1 - Abbreviations Ordered Alphabetically r! ACCUMULATE ALIGNMENT ALL AND ASPECT SOURCE FLAGS ASSOCIATE ATIRIBUTE ATTRIBUTES AVAILABLE CHARACTER CLASSIFICATION CLIPPING COLOUR CONNECTION CURRENT DEFAULT DEFERRAL DELETE DETECTABILITY DIMENSIONS DYNAMIC EVALUATE EXPANSION FACILmES FACTOR FIL

27、L AREA FROM GENERALIZED DRAWING PRIMITIVE GRAPHICAL KERNEL SYSTEM GKSM HIGHLIGHTING IDENTIFIER IN INDEX INDICATOR INDICES INDIVIDUAL MITIALISE INPUT INQUIRE INTERIOR LENGTH LIST LOGICAL MATRIX MAXIMUM MODIFICATION NAME NORMALIZATION GKS word Abbreviation Accum Align NULL NULL ASF ASSOC Attr Attr NUL

28、L / Char Class Clip , Colr , Conn , Cur Def Defer Del Det Dim DYE Eva1 Expan Facil NULL Fill NULL GDP GKS NULL Highlight Id NULL Ind NULL Ind Indiv Init NULL 14 Int NULL NULL NULL NULL Max Mod NULL Norm 1 _“-l .-_ .-. _- _ ,._- .-d-L -i-.,1- -L _- i . . AMERICAN NATIONAL STANDARD X3.124.2-1988 Mappi

29、ng of GKS Function Names to Pascal Procedure Names The Pascal Language Binding of GKS GKS word Abbreviation NUMBER Num NUMBERS Num OF NULL ON NULL OPERATING OP POLYLME Line POLYMARKER Marker PRECISION Prec PREDEFINED Pred PRIMITIVE Prim QUEUE NULL REFERENCE Ref REPRESENTATION Rep REQUEST Req SEGMENT

30、 SEGMENTS SET SIMULTANEOUS SPACE STATE SUPPORTED TABLES TO TRANSFORMATION UPDATE at? kg NULL NULL NULL St NULL NULL NULL Tran W USE NULL VALUE NULL VALUES NULL VISIBILITY Vis WITH NULL WORKSTATION ws NOTE - NULL represents the null string Table 1 - Abbreviations Ordered Alphabetically 6 AMERICAN NAT

31、IONAL STANDARD X3.124.2-1988 The Pascal Language Binding of GKS Mapping of GKS Function Names to Pascal Procedure Names Table 2 - GKS Function Names and Pascal Names Ordered by Pascal Name GKS Function Name Level ACCUMULATE TRANSFORMATION MATRIX Lla ACTIVATE WORKSTATION Lma ASSOCIATE SEGMENT WITH WO

32、RKSTATION L2a AWAIT EVENT Lmc CELL ARRAY LOa CLEAR WORKSTATION Lma CLOSE GKS Lma CLOSE SEGMENT Lla CLOSE WORKSTATION Lma COPY SEGMENT TO WORKSTATION L2a CREATE SEGMENT Lla DEACTIVATE WORKSTATION Lma DELETE SEGMENT Lla DELETE SEGMENT FROM WORKSTATION Lla EMERGENCY CLOSE GKS LOa ERROR HANDLJNG LOa ERR

33、OR LOGGING LOa ESCAPE Lma ESCAPE Lma EVALUATE TRANSFORMATION MATRIX Lla FILL AREA Lma FLUSH DEVICE EVENTS Lmc GENERALIZED DRAWING PRIMITIVE (GDP) LOa GENERALIZED DRAWING PRIMITIVE (GDP) LOa GET CHOICE Lmc GET ITEM TYPE FROM GKSM LOa GET LOCATOR Lmc GET PICK Llc GET STRING Lmc GET STROKE Lmc GET VALU

34、ATOR Lmc INITIALISE CHOICE Lmb INITIALISE LOCATOR Lmb INITIALISE PICK Llb MITIALISE STRING Lmb INITIALISE STROKE Lmb INITIALISE VALUATOR Lmb INQUIRE ASPECT SOURCE FLAGS Lma INQUIRE SET OF ACTIVE WORKSTATIONS Lla MQUIRE SET OF ASSOCLATED WORKSTATIONS Lla INQUIRE CHARACTER BASE VECTOR Lma INQUIRE CHAR

35、ACTER EXPANSION FACTOR Lma INQUIRE CHARACTER HEIGHT Lma INQUIRE CHARACTER SPACING Lma INQUIRE CHARACTER UP VECTOR Lma INQUIRE CHARACTER WIDTH Lma INQUIRE CHOICE DEVICE STATE Lmb NQUIRE CLIPPING Lma NQUIRE COLOUR FACILITIES Lma I Pascal Name GAccumTran GActivateWs GAssocSegWs GAwaitEvent GCellArray G

36、ClearWs GCloseGKS GCloseSeg GCloseWs GCopySegWs GCreateSeg GDeactivateWs GDelSeg GDelSegWs GEmergencyCloseGKS GErrorHandling GErrorLogging GEscape GEscapeGeneralized GEvalTran GFill GFlushDeviceEvents GGDP GGDPGeneralized GGetChoice GGetItemType GGetLocator GGetPick GGetString GGetStroke GGetValuato

37、r GInitChoice GInitLocator GInitPick GInitString GInitStroke GInitValuator GInqASF GInqActiveWs GInqAssocWs GInqCharBaseVector GInqCharExpan GInqCharHeight GInqCharSpacing GInqCharUpVector GInqCharWidth GInqChoiceDeviceSt GInqClip GInqColrFacil AMERICAN NATIONAL STANDARD X3.124.2-1988 Mapping of GKS

38、 Function Names to Pascal Procedure Names The Pascal Language Binding of GKS Table 2 - GKS Function Names and Pascal Names Ordered by Pascal Name GKS Function Name Level Pascal Name INQUIRE COLOUR REPRESENTATION INQUIRE CURRENT INDIVIDUAL ATTRIBUTE VALUES INQUIRE CURRENT NORMALIZATION TRANSFORMATION

39、 NUMBER INQUIRE CURRENT PICK IDENTIFIER INQUIRE CURRENT PRIMITIVE ATTRIBUTE VALUES INQUIRE DEFAULT CHOICE DEVICE DATA INQUIRE DEFAULT DEFERRAL STATE VALUES INQUIRE DEFAULT LOCATOR DEVICE DATA INQUIRE DEFAULT PICK DEVICE DATA INQUIRE DEFAULT STRING DEVICE DATA INQUIRE DEFAULT STROKE DEVICE DATA INQUI

40、RE DEFAULT VALUATOR DEVICE DATA INQUIRE DISPLAY SPACE SIZE INQUIRE DYNAMIC MODIFICATION OF SEGMENT ATTRIBUTES INQUIRE DYNAMIC MODIFICATION OF WORKSTATION ATTRIBUTES INQUIRE FILL AREA COLOUR INDEX INQUIRE FILL AREA FACILITIES INQUIRE FILL AREA INDEX INQUIRE FILL AREA INTERIOR STYLE INQUIRE FILL AREA

41、REPRESENTATION INQUIRE FILL AREA STYLE INDEX INQUIRE GENERALIZED DRAWING PRIMITIVE INQUIRE INPUT QUEUE OVERFLOW INQUIRE LEVEL OF GKS INQUIRE POLYLINE COLOUR INDEX INQUIRE POLYLJNE INDEX INQUIRE LINETYPE INQUIRE LINEWIDTH SCALE FACTOR INQUIRE LIST OF COLOUR INDICES INQUIRE LIST OF FILL AREA INDICES I

42、NQUIRE LIST OF AVAILABLE GENERALIZED DRAWING PRIMITIVES INQUIRE LIST OF NORMALIZATION TRANSFORMATION NUMBERS INQUIRE LIST OF PATTERN INDICES INQUIRE LIST OF POLYLINE INDICES INQUIRE LIST OF POLYMARKER INDICES INQUIRE LIST OF TEXT INDICES INQUIRE LIST OF AVAILABLE WORKSTATION TYPES INQUIRE LOCATOR DE

43、VICE STATE INQUIRE POLYMARKER COLOUR INDEX INQUIRE POLYMARKER INDEX INQUIRE POLYMARKER SIZE SCALE FACTOR INQUIRE POLYMARKER TYPE INQUIRE MAXIMUM NORMALIZATION TRANSFORMATION NUMBER INQUIRE MAXIMUM LENGTH OF WORKSTATION STATE TABLES INQUIRE MORE SIMULTANEOUS EVENTS INQUIRE NORMALIZATION TRANSFORMATIO

44、N INQUIRE NUMBER OF AVAILABLE LOGICAL INPUT DEVICES INQUIRE NUMBER OF SEGMENT PRIORITIES SUPPORTED INQUIRE OPERATING STATE VALUE Lma Lma Lma Llb Lma Lmb Lla Lmb Llb Lmb Lmb Lmb Lma Lla Lla Lma Lma Lma Lma Lla Lma LOa Lmc Lma Lma Lma Lma Lma Lma Lla LOa LOa Lla Lla Lla Lla LOa Lmb Lma Lma Lma Lma LOa

45、 Lma Lmc Lma Lmb Lla LOa GInqColrRep GInqCurIndivAttr GInqCurNormTranNum GInqCurPickId GInqCurPrimAttr GInqDefChoiceDeviceData GInqDefDeferSt GInqDefLocatorDeviceData GInqDefPickDeviceData GInqDefStringDeviccData GInqDefStrokeDeviceData GInqDefValuatorDeviceData GInqDisplaySize GInqDynModSegAttr GIn

46、qDynModWsAttr GInqFillColrInd GInqFillFacil GInqFillInd GInqFillIntStyle GInqFillRep GInqFillStyleInd GInqGDP GInqInputOverflow GInqLevelGKS GInqLineColrInd GInqLineInd GInqLineType GInqLineWidthScale GInqListColrInd GInqListFillInd GInqListGDP GInqListNormTranNum GInqListPatternInd GInqListPolyline

47、Ind GInqListPolymarkerInd GInqListTextInd GInqListWsTypes GInqLocatorDeviceSt GInqMarkerColrInd GInqMarkerInd GInqMarkerSizeScale GInqMarkerType GInqMaxNormTranNum GInqMaxWsSt GInqMoreEvents GInqNormTran GInqNumInputDevices GInqNumSegPriorities GInqOpSt AMERICAN NATIONAL STANDARD X3.124.2-1988 The P

48、ascal Language Binding of GKS Mapping of GKS Function Names to Pascal Procedure Names Table 2 - GKS Function Names and Pascal Names Ordered by Pascal Name GKS Function Name Level INQUIRE NAME OF OPEN SEGMENT INQUIRE SET OF OPEN WORKSTATIONS INQUIRE PATTERN FACILITIES INQUIRE PATTERN REFERENCE POINT

49、INQUIRE PATTERN REPRESENTATION INQUIRE PATTERN SIZE INQUIRE PICK DEVICE STATE INQUIRE PIXEL INQUIRE PIXEL ARRAY INQUIRE PIXEL ARRAY DIMENSIONS INQUIRE POLYLINE FACILITIES INQUIRE POLYLINE REPRESENTATION INQUIRE POLYMARKER FACILITIES INQUIRE POLYMARKER REPRESENTATION INQUIRE PREDEFINED COLOUR REPRESENTATION INQUIRE PREDEFINED FILL AREA REPRESENTATION INQUIRE PREDEFINED PATTERN REPRESENTATION INQUIRE PREDEFINED POLYLINE REPRESENTATION INQUIRE PREDEFINED POLYMARKER REPRESENTATION INQUIRE PREDEFINED TEXT REPRESENTATION INQUIRE SEGMENT ATTRIBUTES INQUIRE SET OF SEGM