GPHIGS USER GUIDE - Contents
Part 1 :
An Introduction to
GPHIGS
1
General
1.1. INTRODUCTION
1.2. STANDARDIZATION
1.3. GPHIGS LIBRARY
1.4. GPHIGS FUNCTIONS
1.4.1. CENTRALIZED STRUCTURE STORE (CSS)
1.4.1.1. STRUCTURE CREATION
1.4.1.2. HIERARCHICAL STRUCTURE
1.4.1.3. STRUCTURE EDITING
1.4.1.4. STRUCTURE HANDLING
1.4.1.5. STRUCTURE DISPLAY
1.4.2. WORKSTATION
1.4.3. TRANSFORMATIONS AND RENDERING
1.4.4. INTERACTION
1.4.5. INQUIRY
1.4.6. ARCHIVES
1.4.7. METAFILES
1.4.8. ERROR HANDLING
2
GPHIGS Data Structure
2.1. INTRODUCTION
2.2. FINITE-STATE MACHINE
2.3. GPHIGS DATA ORGANIZATION
2.3.1. CENTRALIZED STRUCTURE STORE (CSS)
2.3.2. STATE LISTS
2.3.3. DESCRIPTION TABLES
2.4. INQUIRY FUNCTIONS
3
Workstations
3.1. INTRODUCTION
3.2. GPHIGS WORKSTATION TYPES
3.3. WORKSTATION CONTROL FUNCTIONS
3.3.1. OPENING A WORKSTATION
3.3.2. CLOSING A WORKSTATION
4
Structure Management
Functions
4.1. INTRODUCTION
4.2. HIERARCHICAL STRUCTURE
4.3. STRUCTURE ELEMENTS
4.3.1. STRUCTURE IDENTIFIER
4.3.2. GRAPHICAL OUTPUT PRIMITIVES
4.3.3. ATTRIBUTES
4.3.4. MODELLING TRANSFORMATIONS
4.3.5. VIEW SELECTION
4.3.6. MODELLING CLIPPING
4.3.7. PICK IDENTIFIER
4.3.8. LABELS
4.3.9. NAME SETS
4.3.10. CALLING ANOTHER STRUCTURE
4.3.11. CONTENTS OF A STRUCTURE
4.4. STRUCTURE CREATION
4.4.1. OPENING A STRUCTURE
4.4.2. OTHER METHODS
4.5. STRUCTURE EDITING
4.5.1. EDITING: BEGINNING AND TERMINATING
4.5.2. ELEMENT POINTER
4.5.3 ELEMENT INSERTION OR REPLACEMENT
4.5.4. ELEMENT DELETION
4.5.5. STRUCTURE OPERATIONS
4.6. STRUCTURE HANDLING
4.6.1. STRUCTURE DELETION
4.6.2. STRUCTURE NETWORK DELETION
4.6.3. CHANGING A STRUCTURE IDENTIFIER AND/OR REFERENCE
4.7. STRUCTURE DISPLAY
4.7.1. TRAVERSAL
4.7.2. TRAVERSAL STATE LIST
4.7.3. DISPLAY STATES
4.7.3.1 DEFERRAL MODES
4.7.3.2 MODIFICATION MODES
4.7.4. WORKSTATION UPDATE AND VISUAL EFFECT
4.7.5. UNPOSTING STRUCTURES
4.8. SEARCH AND INQUIRY IN THE CSS
4.8.1. ELEMENT INQUIRY
4.8.2. RELATIONS BETWEEN STRUCTURES
4.9. SEARCH INSIDE A STRUCTURE
4.9.1. ELEMENT SEARCH
4.9.2. GUIDED SEARCH IN A STRUCTURE NETWORK
4.10. ARCHIVE
4.10.1. OPENING AND CLOSING AN ARCHIVE FILE
4.10.2. RECORDING STRUCTURES IN AN ARCHIVE FILE
4.10.3. RETRIEVING ARCHIVED STRUCTURES
4.10.4. DELETING STRUCTURES FROM AN ARCHIVE FILE
4.10.5. ARCHIVE INQUIRY
4.10.6. DATA PROTECTION
5
Graphic Functions
5.1. INTRODUCTION
5.2. PRIMITIVES
5.2.1. 2D AND 3D PRIMITIVES
5.2.2. PLANAR PRIMITIVES
5.2.3. PRIMITIVE PLANES
5.2.4. COPLANAR POINTS
5.3. ATTRIBUTES
5.3.1. GEOMETRIC ATTRIBUTES
5.3.2. NON-GEOMETRIC ATTRIBUTES
5.3.2.1. ASPECT SOURCE FLAGS
5.3.3. DISPLAY ATTRIBUTES
5.3.4. IDENTIFICATION ATTRIBUTES
5.4. POLYLINE
5.5. POLYMARKER
5.6. TEXT
5.7. ANNOTATION TEXT RELATIVE
5.8. FILL AREA
5.8.1. PATTERN DEFINITION
5.9. FILL AREA SET
5.10. FILL AREA SET WITH DATA
5.11. SET OF FILL AREA SET WITH DATA
5.12. TRIANGLE SET WITH DATA
5.13. TRIANGLE STRIP WITH DATA
5.14. QUADRILATERAL MESH WITH DATA
5.15. NON-UNIFORM B-SPLINE CURVE
5.16. NON-UNIFORM B-SPLINE SURFACE
5.16.1. DEFINITION
5.16.2. SURFACE TRIMMING
5.16.3. SURFACE APPROXIMATION CRITERIA
5.16.4. PARAMETRIC SURFACE CHARACTERISTICS
5.16.5. EDGE FLAG FOR TRIMMING CURVES
5.17. CELL ARRAY
5.18. COLOUR
5.19. VIEW INDEX
5.20. HIDDEN LINE/HIDDEN SURFACE REMOVAL
5.21. PICK IDENTIFIER
5.22. NAME SET
5.23. LABELS
5.24. STRUCTURE CALLS
5.25. APPLICATION DATA
5.26. AREA PRIMITIVES IMPLICITLY SPECIFIED ATTRIBUTES
5.26.1. GENERAL
5.26.2. GEOMETRIC NORMAL
5.26.3. REFLECTANCE NORMALS
5.26.4. INTRINSIC COLOR
6
Transformations and
Rendering
6.1. INTRODUCTION
6.2. COORDINATE TRANSFORMATIONS
6.3 COLOR RENDERING
6.4. DATA MAPPING
6.5. MODELLING TRANSFORMATION AND CLIPPING
6.5.1. SET LOCAL TRANSFORMATION
6.5.2. SET GLOBAL TRANSFORMATION
6.5.3. G AND L ALLOCATION DURING A TRAVERSAL
6.5.4. MODELLING CLIPPING
6.5.5. MODELLING UTILITIES
6.6. LIGHTING AND SHADING
6.6.1. LIGHT SOURCES
6.6.2. LIGHTING AND SHADING OF AREA PRIMITIVES
6.6.3. THE RENDERING COLOR MODEL
6.7. VISUALIZATION TRANSFORMATION
6.7.1. VIEW ORIENTATION, VRC SYSTEM
6.7.2. VIEW PROJECTION, NPC SYSTEM
6.7.3. VIEW CLIPPING
6.7.4. VISUALIZATION UTILITIES
6.8. DEPTH CUEING
6.9 COLOR MAPPING STAGE
6.10. WORKSTATION TRANSFORMATION
6.10.1. DEVICE COORDINATE SPACE
6.10.2. WORKSTATION TRANSFORMATION
6.11. LOCATOR INPUT TRANSFORMATION
6.12. DISPLAY
6.12.1. STRUCTURE ASSOCIATION
6.12.2. STRUCTURE TRAVERSAL
6.12.3. STRUCTURE DISPLAY PRIORITY
6.12.4. ASSIGNING ATTRIBUTES DURING TRAVERSAL
7
GPHIGS Input
7.1. INTRODUCTION
7.2. GPHIGS INPUT CLASSES
7.3. INPUT MODES
7.3.1. REQUEST
7.3.2. SAMPLE
7.3.3. EVENT
7.4. INPUT DEVICE DESCRIPTION
7.4.1. INPUT DEVICE MEASURE, EVALUATION PROCESS
7.4.2. INPUT DEVICE TRIGGER, VALIDATION PROCESS
7.4.3. INITIAL VALUE
7.4.4. PROMPT ECHO TYPE (PET)
7.4.5. ECHO SURFACE/VOLUME
7.4.6. DATA RECORD
7.5. INPUT DEVICE OPERATING MODES
7.5.1. SETTING THE OPERATING MODE
7.5.2. REQUEST MODE OPERATION
7.5.3. SAMPLE MODE OPERATION
7.5.4. EVENT MODE OPERATION
7.6. MEASURE AS APPLIED FOR EACH INPUT CLASS
7.6.1. LOCATOR DEVICE MEASURE
7.6.2. STROKE DEVICE MEASURE
7.6.3. VALUATOR DEVICE MEASURE
7.6.4. CHOICE DEVICE MEASURE
7.6.5. PICK DEVICE MEASURE
7.6.6. STRING DEVICE MEASURE
7.7. INPUT QUEUE AND CURRENT EVENT REPORT
7.7.1. INPUT QUEUE OVERFLOW
7.7.2. REMOVING EVENTS FROM THE INPUT QUEUE
7.7.3. CURRENT EVENT REPORT
7.8. INPUT DEVICE INITIALIZATION
8
Definitions
Part 2 :
GPHIGS Special
Features
1
General
1.1. PRODUCT DESCRIPTION
1.2 PRODUCT INSTALLATION
1.3. LIBRARIES
1.4. INCLUDE FILES
1.5. RUN-TIME AND LICENSE
1.6. GETTING STARTED WITH EXAMPLE PROGRAMS
1.7. DRIVER CONFIGURATION
1.8. GPHIGS ARCHITECTURE
1.9 LANGUAGE BINDING
1.10. MULTI-WORKSTATION
2
Implementation
Dependant
Features
2.1. DEFINITION
2.2. GPHIGS IMPLEMENTATION PARAMETERS
2.3. WORKSTATION DEPENDANT PARAMETERS
2.4. DISPLAY AND UPDATE MODES
2.5 GPHIGS INPUT DEVICES FOR X11, MOTIF AND GDI ENVIRONMENTS
2.5.1. LOCATOR INPUT DEVICE
2.5.1.1. LOCATOR INITIALIZATION
2.5.1.2. NON-INTERACTIVE LOCATOR
2.5.2. STROKE INPUT DEVICE
2.5.2.1. INITIALIZATION
2.5.3. VALUATOR INPUT DEVICE
2.5.3.1. INITIALIZATION
2.5.4. CHOICE INPUT DEVICE
2.5.4.1. INITIALIZATION
2.5.5. PICK INPUT DEVICE
2.5.5.1. INITIALIZATION
2.5.5.2. NON-INTERACTIVE PICK
2.5.6. STRING INPUT DEVICE
2.5.6.1 INITIALIZATION
2.5.6.2 INPUT OF UNICODE STRINGS
2.6. HARDWARE VALUATORS ( DIAL BOX ) IN X11 ENVIRONMENT
2.6.1. INITIALIZATION
2.6.2. EXAMPLE
2.7. MISCELLANEOUS
3
GPHIGS Extensions
3.1. CONFIGURATION DIRECTIVES
3.2. GPHIGS AND X11 OR WINDOWS
3.2.1. X11 DRIVER
3.2.2. WINDOWS GDI DRIVER
3.2.3. 3D DRIVERS AND WINDOWING ENVIRONMENT
3.2.4. USING AN EXISTING X11 WINDOW
3.2.5. USING AN EXISTING WINDOWS CONTEXT
3.2.6. LOCATOR AND PICK INPUTS IN X11 OR WINDOWS INPUT MODELS
3.3. NON RETAINED STRUCTURES (NRS)
3.4. NON DUPLICATE DATA STORAGE (NDDS)
3.5. POST ON VIEW FACILITIES
3.6. TARGET FACILITIES
3.7. USER FUNCTION CALL
3.8 INQUIRE TRAVERSAL STATE LIST
3.9. Z-BUFFER SHIFT ELEMENT
3.10. TRANSPARENCY
3.11. ANTIALIASING
3.12. HIGHLIGHTING METHODS
3.13. CELL ARRAY ALIGNMENT
3.14. USER DEFINED POLYMARKERS
3.15. ANNOTATION TEXT FIXED
3.16. UNICODE FONT SUPPORT
3.16.1. BACKGROUND
3.16.2. UNICODE SUPPORT IN GPHIGS
3.16.3. SPECIFYING A UNICODE TEXT STRING
3.16.4. UNICODE FONT FILE
3.17. EXTENDED TEXT ATTRIBUTES
3.17.1. TEXT CULLING
3.17.2. TEXT SLANT ANGLE
3.17.3. TEXT LINE WIDTH
3.18. STRUCTURE HANDLING EXTENSIONS
3.18.1. STRUCTURE OPEN MODE
3.18.2. COPYING AND MOVING ELEMENTS
3.18.3. PICK IDENTIFIER LABELING
3.18.4. NO OP ELEMENT
3.19. ANNOTATION CLIPPING MODE
3.20. COMPLEX DRAWING PRIMITIVES AND GDP UTILITIES
3.21. MODELING TRANSFORMATION MATRIX UTILITIES
3.22. POLYLINE SET
3.23. PICKING CUSTOMIZATION
3.24. USER DEFINED LINE TYPE
3.25. BACKGROUND COLOR CONTROL
3.26. QUICK UPDATE TRAVERSAL
3.27. TRAVERSAL HALT
3.28. CONDITIONAL TRAVERSAL
3.28.1. CONDITIONAL TRAVERSAL ELEMENTS
3.28.2. TEST METHODS
3.29. PLOTTER AND PRINTERS EXTENSIONS
3.29.1. METRIC SUPPORT FOR PLOTTERS
3.29.2. POLYGON AND LINE WIDTH SIMULATION
3.29.3. LINE JOIN AND END STYLE SELECTION
3.29.4. PEN COLOUR/WIDTH MAPPING
3.30. NURBS SIMULATION
3.31. HANDLING OF NON-CONVEX POLYGONS
4
C Binding Special
Features
4.1. MEMORY MANAGEMENT
4.1.1. INQUIRY FUNCTIONS RETURNING A SINGLE LIST
4.1.2. INQUIRY FUNCTIONS RETURNING COMPLEX DATA
4.2. ELEMENT SIZE
4.3. ERRORS
4.4. ERROR INDICATOR
4.5. ERROR HANDLER
4.6. STORAGE OF ARRAYS
5
Fortran Binding Special
Features
5.1 PARAMETERS
5.2 ERROR HANDLING
5.3 DATA RECORDS
6
Compatibility, Porting
To GPHIGS V6.0
6.1 COMPATIBILITY WITH PREVIOUS RELEASES
6.2 COMPATIBILITY OF C APPLICATIONS
6.3 COMPATIBILITY OF FORTRAN APPLICATIONS
6.4 COMPATIBILITY OF ARCHIVE FILES
6.5 PORTING PHIGS APPLICATIONS TO GPHIGS
6.5.1 PORTING C APPLICATIONS
6.5.2 PORTING FORTRAN APPLICATIONS
7
GPHIGS Motif Widget
7.1. INTRODUCTION
7.2. GPHIGS WIDGET CREATION
7.3. ANIMATION
7.4. EXAMPLE
7.5. WIDGET CREATION FUNCTION
7.6. WIDGET DESCRIPTION
7.7. ADDITIONAL FUNCTIONS
7.8. USING WIDGET WITH PHIGURE
7.9. SUMMARIZES WIDGET RESOURCES
8
GPHIGS Markers and
Character Fonts
8.1. SOFT MARKERS
8.2. FONTS
Part 3 :
Drivers
1
CGM Driver
1.1. WORKSTATION TYPE
1.2. OPENING A CGM WORKSTATION
1.3. ATTRIBUTES
1.4. WORKSTATION BUNDLE TABLE LENGTH
1.5. DEVICE COORDINATES
1.6. CONFIGURATION PARAMETERS
1.7. Z-BUFFER SIMULATION
1.8. EXTENSION ACCEPTED BY THIS DRIVER
1.9. CGM METRIC
2
GL Driver
2.1. WORKSTATION TYPE
2.2. GL ON AN SGI WORSTATIONS OS 4.X
2.2.1. LIBRARIES
2.2.2. HARDWARE CONFIGURATION
2.3. GL ON AN SGI WORSTATIONS OS 5.X
2.3.1. LIBRARIES
2.3.2. HARDWARE CONFIGURATION
2.4. GL ON AN IBM RISC SYSTEM 6000
2.5. ATTRIBUTES
2.6. WORKSTATION BUNDLE TABLE LENGTH
2.7. DEVICE COORDINATES
2.8. CONFIGURATION PARAMETERS
2.9. INPUT
2.9.1. 7176
2.9.2. 7177
2.9.3. HARD VALUATORS
2.10. USING AN EXISTING X-WINDOW
2.11. EXTENSION ACCEPTED BY THIS DRIVER
3
HPGL Driver
3.1. WORKSTATION TYPES
3.2. OPENING AN HPGL WORKSTATION
3.3. ATTRIBUTES
3.4. WORKSTATION BUNDLE TABLE LENGTH
3.5. DEVICE COORDINATES
3.6. CONFIGURATION PARAMETERS
3.7. EXTENSION ACCEPTED BY THIS DRIVER
3.8. PLOTTER ORIGIN
3.9. PEN COLOUR/WIDTH MAPPING
4
OpenGL Driver
4.1. WORKSTATION TYPE
4.2. OPENGL ON UNIX SYSTEMS
4.2.1. LIBRARIES
4.3. OPENGL ON WINDOWS NT
4.4. ATTRIBUTES
4.5. WORKSTATION BUNDLE TABLE LENGTH
4.6. DEVICE COORDINATES
4.7. CONFIGURATION PARAMETERS
4.8. INPUT
4.8.1. HARD VALUATORS
4.9. USING AN EXISTING X-WINDOW
4.10. EXTENSION ACCEPTED BY THIS DRIVER
5
PEXlib Driver
5.1. WORKSTATION TYPE
5.2. PEXLIB
5.3. STRUCTURE MODE
5.4. IMMEDIATE MODE
5.5. SIMULATED MODE
5.6. ATTRIBUTES
5.7. WORKSTATION BUNDLE TABLES LENGTH
5.8. DEVICE COORDINATES
5.9. CONFIGURATION PARAMETERS
5.10 INPUT
5.11. EXTENSION ACCEPTED BY THIS DRIVER
6
PICT Driver
6.1. WORKSTATION TYPE
6.2. OPENING A PICT WORKSTATION
6.3. ATTRIBUTES
6.4. WORKSTATION BUNDLE TABLE LENGTH
6.5. DEVICE COORDINATES
6.6. CONFIGURATION PARAMETERS
6.7. EXTENSION ACCEPTED BY THIS DRIVER
6.8. HARDWARE FONTS
7
POSTSCRIPT Driver
7.1. WORKSTATION TYPES
7.2. OPENING A POSTSCRIPT WORKSTATION
7.3. ATTRIBUTES
7.4. WORKSTATION BUNDLE TABLE LENGTH
7.5. DEVICE COORDINATES
7.6. CONFIGURATION PARAMETERS
7.7. GRAYSCALE PRINTERS
7.8. Z-BUFFER SIMULATION
7.8.1. Z-BUFFER COMPRESSION MODE
7.8.2. POSTSCRIPT IMAGE DEFINITION
7.9 EXTENSION ACCEPTED BY THIS DRIVER
8
RASTER Driver
8.1. WORKSTATION TYPE
8.2. OPENING A RASTER WORKSTATION
8.3. ATTRIBUTES
8.4. WORKSTATION BUNDLE TABLE LENGTH
8.5. DEVICE COORDINATES
8.6. CONFIGURATION PARAMETERS
8.7. GRAYSCALE PRINTERS
8.8. FORMATS
8.9. EXTENSION ACCEPTED BY THIS DRIVER
9
Windows Driver
9.1. WORKSTATION TYPE
9.2. LIBRARIES AND HARDWARE REQUIRED
9.3. ATTRIBUTES
9.4. WORKSTATION BUNDLE TABLE LENGTH
9.5. DEVICE COORDINATES
9.6. CONFIGURATION PARAMETERS
9.7. DITHERING
9.8. Z-BUFFER SIMULATION
9.9. WINDOW
9.10. DOUBLE BUFFERING
9.11. INPUT
9.12 EXTENSION ACCEPTED BY THIS DRIVER
9.13 THE BMP DRIVER
10
X11 Driver
10.1. WORKSTATION TYPE
10.2. LIBRARIES AND HARDWARE REQUIRED
10.3. ATTRIBUTES
10.4. WORKSTATION BUNDLE TABLE LENGTH
10.5. DEVICE COORDINATES
10.6. CONFIGURATION PARAMETERS
10.7. COLOR MODES
10.8. DITHERING
10.9. Z-BUFFER SIMULATION
10.10. WINDOW
10.11. DOUBLE BUFFERING
10.12. DISPLAY
10.13. MULTI-PLANE
10.14. INPUT
10.15. CELL ARRAY SIMULATION
10.16 EXTENSION ACCEPTED BY THIS DRIVER
10.17 VISUAL SELECTION
11
XGL Driver
11.1. WORKSTATION TYPE
11.2. XGL
11.2.1. XGL ON SUNOS 5.X (SOLARIS 2.X)
11.2.2. XGL ON SUNOS 4.1.X (SOLARIS 1.X)
11.2.3. GX, GXPLUS, TGX, TGXPLUS
11.2.4. GT, GS, ZX, CREATOR 3D
11.2.5. FREEDOM,...
11.3. ATTRIBUTES
11.4. WORKSTATION BUNDLE TABLE LENGTH
11.5. DEVICE COORDINATES
11.6. CONFIGURATION PARAMETERS
11.7. COLORS
11.8. DOUBLE BUFFERING
11.9. INPUT
11.10. EXTENSION ACCEPTED BY THIS DRIVER