CONTENTS Title Page Copyright Page Preface 1 Introduction 1.1 GKS Levels 1.2 Programming Considerations 1.2.1 Online Help 1.2.2 Supported Languages 1.2.3 Capabilities of Supported Devices 1.2.4 Calling Sequences 1.2.5 Constants and Include Files 1.2.6 Returning a Data Record 1.2.7 Packing and Unpacking Records 1.3 Binding Function Names 1.4 FORTRAN Binding Function Syntax 1.5 FORTRAN Binding Function Organization 1.5.1 Standard Escape/GDP Data Records 2 Compiling, Linking, and Running DEC GKS Programs 2.1 Compiling, Linking, and Running 2.2 Using User-Defined Error-Handling Functions 3 Control Functions ACTIVATE WORKSTATION CLEAR WORKSTATION CLOSE GKS CLOSE WORKSTATION DEACTIVATE WORKSTATION ESCAPE MESSAGE (FORTRAN 77) MESSAGE (FORTRAN 77 subset) OPEN GKS OPEN WORKSTATION REDRAW ALL SEGMENTS ON WORKSTATION SET DEFERRAL STATE UPDATE WORKSTATION 4 Output Functions CELL ARRAY FILL AREA GENERALIZED DRAWING PRIMITIVE POLYLINE POLYMARKER TEXT (FORTRAN 77) TEXT (FORTRAN 77 subset) 5 Output Attribute Functions SET ASPECT SOURCE FLAGS SET CHARACTER EXPANSION FACTOR SET CHARACTER HEIGHT SET CHARACTER SPACING SET CHARACTER UP VECTOR SET COLOR REPRESENTATION SET FILL AREA COLOR INDEX SET FILL AREA INDEX SET FILL AREA INTERIOR STYLE SET FILL AREA REPRESENTATION SET FILL AREA STYLE INDEX SET LINETYPE SET LINEWIDTH SCALE FACTOR SET MARKER SIZE SCALE FACTOR SET MARKER TYPE SET PATTERN REFERENCE POINT SET PATTERN REPRESENTATION SET PATTERN SIZE SET PICK IDENTIFIER SET POLYLINE COLOR INDEX SET POLYLINE INDEX SET POLYLINE REPRESENTATION SET POLYMARKER COLOR INDEX SET POLYMARKER INDEX SET POLYMARKER REPRESENTATION SET TEXT ALIGNMENT SET TEXT COLOR INDEX SET TEXT FONT AND PRECISION SET TEXT INDEX SET TEXT PATH SET TEXT REPRESENTATION 6 Transformation Functions SELECT NORMALIZATION TRANSFORMATION SET CLIPPING INDICATOR SET VIEWPORT SET VIEWPORT INPUT PRIORITY SET WINDOW SET WORKSTATION VIEWPORT SET WORKSTATION WINDOW 7 Input Functions AWAIT EVENT FLUSH DEVICE EVENTS GET CHOICE GET LOCATOR GET PICK GET STRING (FORTRAN 77) GET STRING (FORTRAN 77 subset) GET STROKE GET VALUATOR INITIALIZE CHOICE INITIALIZE LOCATOR INITIALIZE PICK INITIALIZE STRING (FORTRAN 77) INITIALIZE STRING (FORTRAN 77 subset) INITIALIZE STROKE INITIALIZE VALUATOR REQUEST CHOICE REQUEST LOCATOR REQUEST PICK REQUEST STRING (FORTRAN 77) REQUEST STRING (FORTRAN 77 subset) REQUEST STROKE REQUEST VALUATOR SAMPLE CHOICE SAMPLE LOCATOR SAMPLE PICK SAMPLE STRING (FORTRAN 77) SAMPLE STRING (FORTRAN 77 subset) SAMPLE STROKE SAMPLE VALUATOR SET CHOICE MODE SET LOCATOR MODE SET PICK MODE SET STRING MODE SET STROKE MODE SET VALUATOR MODE 8 Segment Functions ACCUMULATE TRANSFORMATION MATRIX ASSOCIATE SEGMENT WITH WORKSTATION CLOSE SEGMENT COPY SEGMENT TO WORKSTATION CREATE SEGMENT DELETE SEGMENT DELETE SEGMENT FROM WORKSTATION EVALUATE TRANSFORMATION MATRIX INSERT SEGMENT RENAME SEGMENT SET DETECTABILITY SET HIGHLIGHTING SET SEGMENT PRIORITY SET VISIBILITY SET SEGMENT TRANSFORMATION 9 Metafile, Error, and Utility Functions GET ITEM TYPE FROM GKSM INTERPRET ITEM READ ITEM FROM GKSM WRITE ITEM TO GKSM EMERGENCY CLOSE GKS ERROR HANDLING ERROR LOGGING PACK DATA RECORD PACK DATA RECORD (FORTRAN 77 subset) UNPACK DATA RECORD UNPACK DATA RECORD (FORTRAN 77 subset) 10 Inquiry Functions INQUIRE LEVEL OF GKS INQUIRE LIST element OF AVAILABLE WORKSTATION TYPES INQUIRE MAXIMUM NORMALIZATION TRANSFORMATION INQUIRE WORKSTATION MAXIMUM NUMBERS INQUIRE COLOR FACILITIES INQUIRE DEFAULT CHOICE 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 INQUIRE DEFAULT VALUATOR DEVICE DATA INQUIRE DISPLAY SPACE SIZE INQUIRE DYNAMIC MODIFICATION OF SEGMENT ATTRIBUTES INQUIRE DYNAMIC MODIFICATION OF WORKSTATION ATTRIBUTES INQUIRE FILL AREA FACILITIES INQUIRE GENERALIZED DRAWING PRIMITIVE INQUIRE LIST element OF AVAILABLE GENERALIZED DRAWING PRIMITIVES INQUIRE MAXIMUM LENGTH OF WORKSTATION STATE TABLE INQUIRE NUMBER OF AVAILABLE LOGICAL INPUT DEVICES INQUIRE NUMBER OF SEGMENT PRIORITIES SUPPORTED INQUIRE PATTERN FACILITIES INQUIRE POLYLINE FACILITIES INQUIRE POLYMARKER FACILITIES INQUIRE PREDEFINED COLOR REPRESENTATION INQUIRE PREDEFINED FILL AREA REPRESENTATION INQUIRE PREDEFINED PATTERN REPRESENTATION INQUIRE PREDEFINED POLYLINE REPRESENTATION INQUIRE PREDEFINED POLYMARKER REPRESENTATION INQUIRE PREDEFINED TEXT REPRESENTATION INQUIRE TEXT FACILITIES INQUIRE WORKSTATION CATEGORY INQUIRE WORKSTATION CLASSIFICATION INQUIRE (current) ASPECT SOURCE FLAGS INQUIRE (current) CHARACTER BASE VECTOR INQUIRE (current) CHARACTER EXPANSION FACTOR INQUIRE (current) CHARACTER HEIGHT INQUIRE (current) CHARACTER SPACING INQUIRE (current) CHARACTER UP VECTOR INQUIRE (current) CHARACTER WIDTH INQUIRE CLIPPING INQUIRE (current) FILL AREA COLOR INDEX INQUIRE (current) FILL AREA INDEX INQUIRE (current) FILL AREA INTERIOR STYLE INQUIRE (current) FILL AREA STYLE INDEX INQUIRE INPUT QUEUE OVERFLOW INQUIRE (current) LINETYPE INQUIRE (current) LINEWIDTH SCALE FACTOR INQUIRE MORE SIMULTANEOUS EVENTS INQUIRE (current) MARKER SIZE SCALE FACTOR INQUIRE (current) MARKERTYPE INQUIRE CURRENT NORMALIZATION TRANSFORMATION INQUIRE (current) PATTERN REFERENCE POINT INQUIRE (current) PATTERN SIZE INQUIRE CURRENT PICK IDENTIFIER INQUIRE (current) POLYLINE COLOR INDEX INQUIRE (current) POLYLINE INDEX INQUIRE (current) POLYMARKER COLOR INDEX INQUIRE (current) POLYMARKER INDEX INQUIRE (current) TEXT ALIGNMENT INQUIRE (current) TEXT COLOR INDEX INQUIRE (current) TEXT FONT AND PRECISION INQUIRE (current) TEXT INDEX INQUIRE (current) TEXT INQUIRE LIST element OF NORMALIZATION TRANSFORMATION NUMBERS INQUIRE NAME OF OPEN SEGMENT INQUIRE NORMALIZATION TRANSFORMATION NUMBER INQUIRE OPERATING STATE VALUE INQUIRE SET member OF ACTIVE WORKSTATIONS INQUIRE SET member OF OPEN WORKSTATIONS INQUIRE SET member OF SEGMENT NAMES IN USE INQUIRE CHOICE DEVICE STATE INQUIRE COLOR REPRESENTATION INQUIRE FILL AREA REPRESENTATION INQUIRE LIST element OF COLOR INDICES INQUIRE LIST element OF FILL AREA INDICES INQUIRE LIST element OF PATTERN INDICES INQUIRE LIST element OF POLYLINE INDICES INQUIRE LIST element OF POLYMARKER INDICES INQUIRE LIST element OF TEXT INDICES INQUIRE LOCATOR DEVICE STATE INQUIRE PATTERN REPRESENTATION INQUIRE PICK DEVICE STATE INQUIRE POLYLINE REPRESENTATION INQUIRE POLYMARKER REPRESENTATION INQUIRE SET member OF SEGMENT NAMES ON WORKSTATION INQUIRE STRING DEVICE STATE (FORTRAN 77) INQUIRE STRING DEVICE STATE (FORTRAN 77 subset) INQUIRE STROKE DEVICE STATE INQUIRE TEXT EXTENT (FORTRAN 77) INQUIRE TEXT EXTENT (FORTRAN 77 subset) INQUIRE TEXT REPRESENTATION INQUIRE VALUATOR DEVICE STATE INQUIRE WORKSTATION CONNECTION AND TYPE INQUIRE WORKSTATION DEFERRAL AND UPDATE STATES INQUIRE WORKSTATION STATE INQUIRE WORKSTATION TRANSFORMATION INQUIRE SEGMENT ATTRIBUTES INQUIRE SET member OF ASSOCIATED WORKSTATIONS INQUIRE PIXEL INQUIRE PIXEL ARRAY INQUIRE PIXEL ARRAY DIMENSIONS A DEC GKS Error Messages A.1 Implementation-Specific Errors A.2 Operating State Errors A.3 Workstation Errors A.4 Transformation Function Errors A.5 Output Attribute Errors A.6 Output Function Errors A.7 Segment Function Errors A.8 Input Function Errors A.9 Metafile Function Errors A.10 Escape Function Errors A.11 Miscellaneous Errors A.12 System Errors B DEC GKS Constants C DEC GKS Function Names and FORTRAN Binding Function Names EXAMPLES 1-1 Packing and Unpacking a Data Record TABLES B-1 FORTRAN Constants C-1 DEC GKS Function Names and Corresponding FORTRAN Binding Names