CONTENTS Title Page Copyright Page Preface 1 Using the C Binding 1.1 C Binding Files on VMS Systems 1.2 Supported Compilers and Linkers 1.2.1 Supported Compilers and Linkers on ULTRIX Systems with RISC Processors 1.2.2 Supported Compilers and Linkers on ULTRIX Systems with VAX Processors 1.3 Linking the Program 1.3.1 Linking the Program on VMS Systems 1.3.2 Linking the Program on ULTRIX Systems with RISC Processors 1.3.3 Linking the Program on ULTRIX Systems with VAX Processors 1.4 Opening a Workstation 1.4.1 Specifying the Connection Identifier on VMS Systems 1.4.2 Specifying the Connection Identifier on ULTRIX Systems 1.4.3 Specifying the Workstation Type on VMS Systems 1.4.4 Specifying the Workstation Type on ULTRIX Systems 1.5 Error Handling 1.5.1 VMS Error Codes 1.5.2 VMS Error Files 1.5.3 ULTRIX Error Codes 1.5.4 ULTRIX Error Files 2 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 3 Output Functions CELL ARRAY CELL ARRAY 3 FILL AREA FILL AREA 3 FILL AREA SET FILL AREA SET 3 GENERALIZED DRAWING PRIMITIVE GENERALIZED DRAWING PRIMITIVE 3 POLYLINE POLYLINE 3 POLYMARKER POLYMARKER 3 TEXT TEXT 3 4 Attribute Functions SET ASPECT SOURCE FLAGS SET ASPECT SOURCE FLAGS 3 SET CHARACTER EXPANSION FACTOR SET CHARACTER HEIGHT SET CHARACTER SPACING SET CHARACTER UP VECTOR SET COLOUR MODEL SET COLOUR REPRESENTATION SET EDGE COLOUR INDEX SET EDGE FLAG SET EDGE INDEX SET EDGE REPRESENTATION SET EDGETYPE SET EDGEWIDTH SCALE FACTOR SET FILL AREA COLOUR INDEX SET FILL AREA INDEX SET FILL AREA INTERIOR STYLE SET FILL AREA REPRESENTATION SET FILL AREA STYLE INDEX SET HLHSR IDENTIFIER SET HLHSR MODE SET LINETYPE SET LINEWIDTH SCALE FACTOR SET MARKER SIZE SCALE FACTOR SET MARKER TYPE SET PATTERN REFERENCE POINT SET PATTERN REFERENCE POINT AND VECTORS 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 5 Transformation Functions SELECT NORMALIZATION TRANSFORMATION SET CLIPPING INDICATOR SET VIEW INDEX SET VIEW REPRESENTATION 3 SET VIEW TRANSFORMATION INPUT PRIORITY SET VIEWPORT SET VIEWPORT 3 SET VIEWPORT INPUT PRIORITY SET WINDOW SET WINDOW 3 SET WORKSTATION VIEWPORT SET WORKSTATION VIEWPORT 3 SET WORKSTATION WINDOW SET WORKSTATION WINDOW 3 6 Segment Functions ASSOCIATE SEGMENT WITH WORKSTATION CLOSE SEGMENT COPY SEGMENT TO WORKSTATION CREATE SEGMENT DELETE SEGMENT DELETE SEGMENT FROM WORKSTATION INSERT SEGMENT INSERT SEGMENT 3 RENAME SEGMENT SET DETECTABILITY SET HIGHLIGHTING SET SEGMENT PRIORITY SET SEGMENT TRANSFORMATION SET SEGMENT TRANSFORMATION 3 SET VISIBILITY 7 Input Functions AWAIT EVENT FLUSH DEVICE EVENTS GET CHOICE GET LOCATOR GET LOCATOR 3 GET PICK GET STRING GET STROKE GET STROKE 3 GET VALUATOR INITIALIZE CHOICE INITIALIZE CHOICE 3 INITIALIZE LOCATOR INITIALIZE LOCATOR 3 INITIALIZE PICK INITIALIZE PICK 3 INITIALIZE STRING INITIALIZE STRING 3 INITIALIZE STROKE INITIALIZE STROKE 3 INITIALIZE VALUATOR INITIALIZE VALUATOR 3 REQUEST CHOICE REQUEST LOCATOR REQUEST LOCATOR 3 REQUEST PICK REQUEST STRING REQUEST STROKE REQUEST STROKE 3 REQUEST VALUATOR SAMPLE CHOICE SAMPLE LOCATOR SAMPLE LOCATOR 3 SAMPLE PICK SAMPLE STRING SAMPLE STROKE SAMPLE STROKE 3 SAMPLE VALUATOR SET CHOICE MODE SET LOCATOR MODE SET PICK MODE SET STRING MODE SET STROKE MODE SET VALUATOR MODE 8 Metafile Functions GET ITEM TYPE FROM GKSM INTERPRET ITEM READ ITEM FROM GKSM WRITE ITEM TO GKSM 9 Utility Functions ACCUMULATE TRANSFORMATION MATRIX ACCUMULATE TRANSFORMATION MATRIX 3 EVALUATE TRANSFORMATION MATRIX EVALUATE TRANSFORMATION MATRIX 3 EVALUATE VIEW MAPPING MATRIX 3 EVALUATE VIEW ORIENTATION MATRIX 3 10 Inquiry Functions INQUIRE CHARACTER BASE VECTOR INQUIRE CHARACTER EXPANSION FACTOR INQUIRE CHARACTER HEIGHT INQUIRE CHARACTER SPACING INQUIRE CHARACTER UP VECTOR INQUIRE CHARACTER WIDTH INQUIRE CHOICE DEVICE STATE INQUIRE CHOICE DEVICE STATE 3 INQUIRE CLIPPING INQUIRE CLIPPING 3 INQUIRE COLOUR FACILITIES INQUIRE COLOUR MODEL INQUIRE COLOUR MODEL FACILITIES INQUIRE COLOUR REPRESENTATION INQUIRE CURRENT HLHSR IDENTIFIER VALUE INQUIRE CURRENT INDIVIDUAL ATTRIBUTE VALUES INQUIRE CURRENT INDIVIDUAL ATTRIBUTE VALUES 3 INQUIRE CURRENT NORMALIZATION TRANSFORMATION NUMBER INQUIRE CURRENT PICK IDENTIFIER VALUE INQUIRE CURRENT PRIMITIVE ATTRIBUTE VALUES INQUIRE CURRENT PRIMITIVE ATTRIBUTE VALUES 3 INQUIRE DEFAULT CHOICE DEVICE DATA INQUIRE DEFAULT CHOICE DEVICE DATA 3 INQUIRE DEFAULT DEFERRAL STATE VALUES INQUIRE DEFAULT LOCATOR DEVICE DATA INQUIRE DEFAULT LOCATOR DEVICE DATA 3 INQUIRE DEFAULT PICK DEVICE DATA INQUIRE DEFAULT PICK DEVICE DATA 3 INQUIRE DEFAULT STRING DEVICE DATA INQUIRE DEFAULT STRING DEVICE DATA 3 INQUIRE DEFAULT STROKE DEVICE DATA INQUIRE DEFAULT STROKE DEVICE DATA 3 INQUIRE DEFAULT VALUATOR DEVICE DATA INQUIRE DEFAULT VALUATOR DEVICE DATA 3 INQUIRE DISPLAY SPACE SIZE INQUIRE DISPLAY SPACE SIZE 3 INQUIRE DYNAMIC MODIFICATION OF SEGMENT ATTRIBUTES INQUIRE DYNAMIC MODIFICATION OF WORKSTATION ATTRIBUTES INQUIRE DYNAMIC MODIFICATION OF WORKSTATION ATTRIBUTES 3 INQUIRE EDGE COLOUR INDEX INQUIRE EDGE FACILITIES INQUIRE EDGE FLAG INQUIRE EDGE REPRESENTATION INQUIRE EDGETYPE INQUIRE EDGEWIDTH INQUIRE FILL AREA COLOUR INDEX INQUIRE FILL AREA FACILITIES INQUIRE FILL AREA INDEX INQUIRE FILL AREA INTERIOR STYLE INDEX INQUIRE FILL AREA REPRESENTATION INQUIRE FILL AREA STYLE INDEX INQUIRE GENERALIZED DRAWING PRIMITIVE INQUIRE GENERALIZED DRAWING PRIMITIVE 3 INQUIRE HLHSR FACILITIES INQUIRE HLHSR MODE INQUIRE INPUT QUEUE OVERFLOW INQUIRE LEVEL OF GKS INQUIRE LINE TYPE INQUIRE LINE WIDTH INQUIRE LIST OF ASPECT SOURCE FLAGS INQUIRE LIST OF ASPECT SOURCE FLAGS 3 INQUIRE LIST OF AVAILABLE GENERALIZED DRAWING PRIMITIVES INQUIRE LIST OF AVAILABLE GENERALIZED DRAWING PRIMITIVES 3 INQUIRE LIST OF AVAILABLE WORKSTATION TYPES INQUIRE LIST OF COLOUR INDICES INQUIRE LIST OF EDGE INDICES INQUIRE LIST OF FILL AREA INDICES 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 VIEW INDICES INQUIRE LOCATOR DEVICE STATE INQUIRE LOCATOR DEVICE STATE 3 INQUIRE MARKER SIZE SCALE FACTOR INQUIRE MARKER TYPE INQUIRE MAXIMUM LENGTH OF WORKSTATION STATE TABLES INQUIRE MAXIMUM LENGTH OF WORKSTATION STATE TABLES 3 INQUIRE MAXIMUM NORMALIZATION TRANSFORMATION NUMBER INQUIRE MORE SIMULTANEOUS EVENTS INQUIRE NAME OF OPEN SEGMENT INQUIRE NORMALIZATION TRANSFORMATION INQUIRE NORMALIZATION TRANSFORMATION 3 INQUIRE NUMBER OF AVAILABLE LOGICAL INPUT DEVICES INQUIRE NUMBER OF SEGMENT PRIORITIES SUPPORTED INQUIRE OPERATING STATE VALUE INQUIRE PATTERN FACILITIES INQUIRE PATTERN HEIGHT VECTOR INQUIRE PATTERN REFERENCE POINT INQUIRE PATTERN REFERENCE POINT AND VECTOR INQUIRE PATTERN REPRESENTATION INQUIRE PATTERN WIDTH VECTOR INQUIRE PICK DEVICE STATE INQUIRE PICK DEVICE STATE 3 INQUIRE PIXEL INQUIRE PIXEL ARRAY INQUIRE PIXEL ARRAY DIMENSIONS INQUIRE POLYLINE COLOUR INDEX INQUIRE POLYLINE FACILITIES INQUIRE POLYLINE INDEX INQUIRE POLYLINE REPRESENTATION INQUIRE POLYMARKER COLOUR INDEX INQUIRE POLYMARKER FACILITIES INQUIRE POLYMARKER INDEX INQUIRE POLYMARKER REPRESENTATION INQUIRE PREDEFINED COLOUR REPRESENTATION INQUIRE PREDEFINED EDGE REPRESENTATION INQUIRE PREDEFINED FILL AREA REPRESENTATION INQUIRE PREDEFINED PATTERN REPRESENTATION INQUIRE PREDEFINED POLYLINE REPRESENTATION INQUIRE PREDEFINED POLYMARKER REPRESENTATION INQUIRE PREDEFINED TEXT REPRESENTATION INQUIRE PREDEFINED VIEW REPRESENTATION INQUIRE SEGMENT ATTRIBUTES INQUIRE SEGMENT ATTRIBUTES 3 INQUIRE SET OF ACTIVE WORKSTATIONS INQUIRE SET OF ASSOCIATED WORKSTATIONS INQUIRE SET OF OPEN WORKSTATIONS INQUIRE SET OF SEGMENT NAMES IN USE INQUIRE SET OF SEGMENT NAMES ON WORKSTATION INQUIRE STRING DEVICE STATE INQUIRE STRING DEVICE STATE 3 INQUIRE STROKE DEVICE STATE INQUIRE STROKE DEVICE STATE 3 INQUIRE TEXT ALIGNMENT INQUIRE TEXT COLOUR INDEX INQUIRE TEXT EXTENT INQUIRE TEXT EXTENT 3 INQUIRE TEXT FACILITIES INQUIRE TEXT FONT AND PRECISION INQUIRE TEXT INDEX INQUIRE TEXT PATH INQUIRE TEXT REPRESENTATION INQUIRE VALUATOR DEVICE STATE INQUIRE VALUATOR DEVICE STATE 3 INQUIRE VIEW FACILITIES INQUIRE VIEW REPRESENTATION 3 INQUIRE WORKSTATION CATEGORY INQUIRE WORKSTATION CLASSIFICATION INQUIRE WORKSTATION CONNECTION AND TYPE INQUIRE WORKSTATION DEFERRAL AND UPDATE STATES INQUIRE WORKSTATION MAXIMUM NUMBERS INQUIRE WORKSTATION STATE INQUIRE WORKSTATION TRANSFORMATION INQUIRE WORKSTATION TRANSFORMATION 3 11 Error Handling Functions EMERGENCY CLOSE GKS ERROR HANDLING ERROR LOGGING A Error Codes B Constants C Program Example C.1 C Program D Function Identifiers TABLES A-1 DEC GKS-3D Error Codes and Messages B-1 C Constants