CONTENTS Title Page Copyright Page Preface 1 Introduction to DEC GKS 1.1 GKS Levels 1.2 Programming Considerations 1.2.1 Online Help 1.2.2 Capabilities of Supported Devices 1.2.3 Calling Sequences 1.2.4 Constants and Include Files 1.2.4.1 Including Definition Files 1.3 Function Syntax 1.3.1 Argument Descriptions 1.4 GKS$ Binding Data Types 1.5 GKS Function Organization 1.6 Using User-Defined Error-Handling Functions 1.7 Standard Escape/GDP Data Records 2 Compiling, Linking, and Running DEC GKS Programs 2.1 Compiling, Linking, and Running 3 Control Functions ACTIVATE WORKSTATION CLEAR WORKSTATION CLOSE GKS CLOSE WORKSTATION DEACTIVATE WORKSTATION ESCAPE MESSAGE 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 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 GET STROKE GET VALUATOR INITIALIZE CHOICE INITIALIZE LOCATOR INITIALIZE PICK INITIALIZE STRING INITIALIZE STROKE INITIALIZE VALUATOR REQUEST CHOICE REQUEST LOCATOR REQUEST PICK REQUEST STRING REQUEST STROKE REQUEST VALUATOR SAMPLE CHOICE SAMPLE LOCATOR SAMPLE PICK SAMPLE STRING 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 ASSOCIATE SEGMENT WITH WORKSTATION CLOSE SEGMENT COPY SEGMENT TO WORKSTATION CREATE SEGMENT DELETE SEGMENT DELETE SEGMENT FROM WORKSTATION INSERT SEGMENT RENAME SEGMENT SET DETECTABILITY SET HIGHLIGHTING SET SEGMENT PRIORITY SET VISIBILITY SET SEGMENT TRANSFORMATION 9 Metafile, Error-Handling, 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 ACCUMULATE TRANSFORMATION MATRIX EVALUATE TRANSFORMATION MATRIX 10 Inquiry Functions INQUIRE LEVEL OF GKS INQUIRE LIST 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 OF AVAILABLE GENERALIZED DRAWING PRIMITIVES INQUIRE MAXIMUM LENGTH OF WORKSTATION STATE TABLES 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 CLIPPING INQUIRE CURRENT INDIVIDUAL ATTRIBUTE VALUES INQUIRE CURRENT NORMALIZATION TRANSFORMATION NUMBER INQUIRE CURRENT PRIMITIVE ATTRIBUTE VALUES INQUIRE INPUT QUEUE OVERFLOW INQUIRE LIST OF NORMALIZATION TRANSFORMATION NUMBERS INQUIRE MORE SIMULTANEOUS EVENTS INQUIRE NAME OF OPEN SEGMENT INQUIRE NORMALIZATION TRANSFORMATION INQUIRE OPERATING STATE VALUE INQUIRE PICK IDENTIFIER VALUE INQUIRE SET OF ACTIVE WORKSTATIONS INQUIRE SET OF OPEN WORKSTATIONS INQUIRE SET OF SEGMENT NAMES IN USE INQUIRE CHOICE DEVICE STATE INQUIRE COLOR REPRESENTATION INQUIRE FILL AREA REPRESENTATION INQUIRE LIST OF COLOR INDICES INQUIRE LIST OF FILL AREA INDICES INQUIRE LIST OF PATTERN INDICES INQUIRE LIST OF POLYLINE INDICES INQUIRE LIST OF POLYMARKER INDICES INQUIRE LIST OF TEXT INDICES INQUIRE LOCATOR DEVICE STATE INQUIRE PATTERN REPRESENTATION INQUIRE PICK DEVICE STATE INQUIRE POLYLINE REPRESENTATION INQUIRE POLYMARKER REPRESENTATION INQUIRE SET OF SEGMENT NAMES ON WORKSTATION INQUIRE STRING DEVICE STATE INQUIRE STROKE DEVICE STATE INQUIRE TEXT EXTENT INQUIRE TEXT REPRESENTATION INQUIRE VALUATOR DEVICE STATE INQUIRE WORKSTATION DEFERRAL AND UPDATE STATES INQUIRE WORKSTATION CONNECTION AND TYPE INQUIRE WORKSTATION STATE INQUIRE WORKSTATION TRANSFORMATION INQUIRE SEGMENT ATTRIBUTES INQUIRE SET 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 C.1 DEC GKS Function Names and FORTRAN Binding Function Names TABLES B-1 GKS$ Constants C-1 DEC GKS Function Names and Corresponding FORTRAN Binding Names