CONTENTS Title Page Copyright Page Preface 1 Introduction 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.3 C Binding Function Syntax 1.4 C Binding Data Types INITIALIZE CHOICE 1.5 C Binding Passing Mechanism 1.6 Standard Escape/GDP Data Records 1.7 C Binding Function Organization 2 Compiling, Linking, and Running DEC GKS Programs 2.1 Binding Function Names 2.2 Compiling, Linking, and Running 2.3 Including Definition Files 2.3.1 Buffer Management for Inquiry and Input Functions 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 COLOUR REPRESENTATION SET FILL AREA COLOUR 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 COLOUR INDEX SET POLYLINE INDEX SET POLYLINE REPRESENTATION SET POLYMARKER COLOUR INDEX SET POLYMARKER INDEX SET POLYMARKER REPRESENTATION SET TEXT ALIGNMENT SET TEXT COLOUR 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 WINDOW SET VIEWPORT SET VIEWPORT INPUT PRIORITY SET WORKSTATION WINDOW SET WORKSTATION VIEWPORT 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 SEGMENT TRANSFORMATION SET VISIBILITY 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 EVALUATE TRANSFORMATION MATRIX ACCUMULATE TRANSFORMATION MATRIX 10 Inquiry Functions INQUIRE OPERATING STATE VALUE INQUIRE LEVEL OF GKS INQUIRE LIST OF AVAILABLE WORKSTATION TYPES INQUIRE MAXIMUM NORMALIZATION TRANSFORMATION INQUIRE WORKSTATION MAXIMUM NUMBERS INQUIRE COLOUR FACILITIES 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 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 COLOUR 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 CHARACTER BASE VECTOR INQUIRE CHARACTER EXPANSION FACTOR INQUIRE CHARACTER HEIGHT INQUIRE CHARACTER SPACING INQUIRE CHARACTER UP VECTOR INQUIRE CHARACTER WIDTH INQUIRE CURRENT PICK IDENTIFIER VALUE INQUIRE CURRENT NORMALIZATION TRANSFORMATION NUMBER INQUIRE FILL AREA COLOUR INDEX INQUIRE FILL AREA INDEX INQUIRE FILL AREA INTERIOR STYLE INQUIRE FILL AREA STYLE INDEX INQUIRE INDIVIDUAL ATTRIBUTES INQUIRE INPUT QUEUE OVERFLOW INQUIRE LINETYPE INQUIRE LINEWIDTH SCALE FACTOR INQUIRE LIST OF ASPECT SOURCE FLAGS INQUIRE LIST OF NORMALIZATION TRANSFORMATION NUMBERS INQUIRE MORE SIMULTANEOUS EVENTS INQUIRE MARKER SIZE SCALE FACTOR INQUIRE MARKER TYPE INQUIRE NAME OF OPEN SEGMENT INQUIRE NORMALIZATION TRANSFORMATION INQUIRE PATTERN REFERENCE POINT INQUIRE PATTERN HEIGHT VECTOR INQUIRE PATTERN WIDTH VECTOR INQUIRE POLYLINE COLOUR INDEX INQUIRE POLYLINE INDEX INQUIRE POLYMARKER COLOUR INDEX INQUIRE POLYMARKER INDEX INQUIRE PRIMITIVE ATTRIBUTES INQUIRE TEXT ALIGNMENT INQUIRE TEXT COLOUR INDEX INQUIRE TEXT FONT AND PRECISION INQUIRE TEXT INDEX INQUIRE TEXT PATH INQUIRE SET OF ACTIVE WORKSTATIONS INQUIRE SET OF OPEN WORKSTATIONS INQUIRE SET OF SEGMENT NAMES IN USE INQUIRE CHOICE DEVICE STATE INQUIRE COLOUR REPRESENTATION INQUIRE FILL AREA REPRESENTATION INQUIRE LIST OF COLOUR 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 SET OF ASSOCIATED WORKSTATIONS INQUIRE SEGMENT ATTRIBUTES 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 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 A.13 C Binding Errors B C Binding Constants C C Binding Type Definitions C.1 A C.2 C C.3 D C.4 E C.5 F C.6 G C.7 I C.8 L C.9 M C.10 N C.11 O C.12 P C.13 Q C.14 R C.15 S C.16 T C.17 U C.18 V C.19 W D DEC GKS Function Names and C Binding Function Names EXAMPLES 1-1 Example of C Binding Data Types TABLES B-1 C Constants D-1 DEC GKS Function Names and Corresponding C Binding Names