ThegraPHIGSProgrammingInterface: ISO PHIGS Subroutine Reference SC23-6623-00 ThegraPHIGSProgrammingInterface: ISO PHIGS Subroutine Reference SC23-6623-00 Note Before using this information and the product it supports, read the information in “Notices,” on page 529. First Edition (November 2007) This edition applies to the IBM® PEX/PHIGS for AIX® Version 4, Program Number 5696-907, and to all subsequent releases of this product until otherwise indicated in new editions. © Copyright IBM Corporation 1994, 2007. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents About This Book ................................xi Who Should Use This Book .............................xi Highlighting ...................................xi ISO 9000 ....................................xi Related Publications................................xi Chapter 1. Introduction ..............................1 Calling Conventions for ISO PHIGS Subroutines .....................1 graPHIGS API Subroutines .............................1 Subroutine Descriptions ..............................2 Reference Manual Abbreviations ...........................2 Chapter 2. Control Subroutines ...........................5 CLOSE PHIGS (PHOP,WSCL,STCL,ARCL) .......................5 Close Workstation (PHOP,*,*,*) ............................5 MESSAGE (PHOP,WSOP,*,*) ............................6 OPEN PHIGS (PHCL, WSCL, STCL, ARCL) .......................7 OPEN WORKSTATION (PHOP,*,*,*) ..........................9 REDRAW ALL STRUCTURES (PHOP,WSOP,*,*) .....................11 SET DISPLAY UPDATE STATE (PHOP,WSOP,*,*) ....................12 UPDATE WORKSTATION(PHOP,WSOP,*,*) .......................13 Chapter 3. Output Primitives............................15 ANNOTATION TEXT RELATIVE (PHOP,*,STOP,*) ....................15 ANNOTATION TEXT RELATIVE 3 (PHOP,*,STOP,*)....................17 CELL ARRAY (PHOP,*,STOP,*) ...........................18 CELL ARRAY 3 (PHOP,*,STOP,*) ..........................20 FILL AREA (PHOP,*,STOP,*) ............................21 FILL AREA 3 (PHOP,*,STOP,*) ...........................22 FILL AREA SET (PHOP,*,STOP,*) ..........................23 FILL AREA SET 3 (PHOP,*,STOP,*)..........................24 GENERALIZED DRAWING PRIMITIVE (PHOP,*,STOP,*) ..................25 GENERALIZED DRAWING PRIMITIVE 3 (PHOP,*,STOP,*) .................26 POLYLINE (PHOP,*,STOP,*) ............................28 POLYLINE 3 (PHOP,*,STOP,*)............................28 POLYMARKER (PHOP,*,STOP,*)...........................29 POLYMARKER 3 (PHOP,*,STOP,*) ..........................30 TEXT (PHOP,*,STOP,*) ..............................31 TEXT 3 (PHOP,*,STOP,*) .............................33 Chapter 4. Attribute Specification ..........................37 ADD NAMES TO SET (PHOP,*,STOP,*) ........................37 REMOVE NAMES FROM SET (PHOP,*,STOP,*) .....................38 SET ANNOTATION STYLE (PHOP,*,STOP,*) ......................39 SET ANNOTATION TEXT ALIGNMENT (PHOP,*,STOP,*) ..................40 SET ANNOTATION TEXT CHARACTER HEIGHT (PHOP,*,STOP,*) ..............41 SET ANNOTATION TEXT CHARACTER UP VECTOR (PHOP,*,STOP,*) ............42 SET ANNOTATION TEXT PATH (PHOP,*,STOP,*) ....................43 SET CHARACTER EXPANSION FACTOR (PHOP,*,STOP,*).................43 SET CHARACTER HEIGHT (PHOP,*,STOP,*) ......................44 SET CHARACTER SPACING (PHOP,*,STOP,*) .....................45 SET CHARACTER UP VECTOR (PHOP,*,STOP,*) ....................46 SET EDGE COLOR INDEX (PHOP,*,STOP,*) ......................47 © Copyright IBM Corp. 1994, 2007 iii SET EDGE FLAG (PHOP,*,STOP,*)..........................48 SET EDGE INDEX (PHOP,*,STOP,*) .........................49 SET EDGETYPE (PHOP,*,STOP,*) ..........................50 SET EDGEWIDTH SCALE FACTOR (PHOP,*,STOP,*) ...................51 SET HLHSR IDENTIFIER (PHOP,*,STOP,*) .......................52 SET INDIVIDUAL ASF (PHOP,*,STOP,*) ........................53 SET INTERIOR COLOR INDEX (PHOP,*,STOP,*) ....................54 SET INTERIOR INDEX (PHOP,*,STOP,*) ........................55 SET INTERIOR STYLE (PHOP,*,STOP,*)........................56 SET INTERIOR STYLE INDEX (PHOP,*,STOP,*) .....................57 SET LINETYPE (PHOP,*,STOP,*) ..........................58 SET LINEWIDTH SCALE FACTOR (PHOP,*,STOP,*) ...................59 SET MARKER SIZE SCALE FACTOR (PHOP,*,STOP,*) ..................60 SET MARKER TYPE (PHOP,*,STOP,*) ........................61 SET PATTERN REFERENCE POINT (PHOP,*,STOP,*) ..................61 SET PATTERN REFERENCE POINT AND VECTORS (PHOP,*,STOP,*) ............62 SET PATTERN SIZE (PHOP,*,STOP,*).........................64 SET PICK IDENTIFIER (PHOP,*,STOP,*)........................64 SET POLYLINE COLOR INDEX (PHOP,*,STOP,*) ....................65 SET POLYLINE INDEX (PHOP,*,STOP,*)........................66 SET POLYMARKER COLOR INDEX (PHOP,*,STOP,*) ...................67 SET POLYMARKER INDEX (PHOP,*,STOP,*) ......................68 SET TEXT ALIGNMENT (PHOP,*,STOP,*) .......................69 SET TEXT COLOR INDEX (PHOP,*,STOP,*) ......................70 SET TEXT FONT (PHOP,*,STOP,*) ..........................70 SET TEXT INDEX (PHOP,*,STOP,*) .........................71 SET TEXT PATH (PHOP,*,STOP,*) ..........................72 SET TEXT PRECISION (PHOP,*,STOP,*) .......................73 SET VIEW INDEX (PHOP,*,STOP,*) .........................75 Chapter 5. Miscellaneous Structure Element Subroutines ................77 APPLICATION DATA (PHOP,*,STOP,*).........................77 EXECUTE STRUCTURE (PHOP,*,STOP,*) .......................77 GENERALIZED STRUCTURE ELEMENT (PHOP,*,STOP,*) .................78 Chapter 6. Structure Operation Subroutines .....................81 CHANGE STRUCTURE IDENTIFIER (PHOP,*,*,*) ....................81 CHANGE STRUCTURE IDENTIFIER AND REFERENCES (PHOP,*,*,*) ............82 CHANGE STRUCTURE REFERENCES (PHOP,*,*,*) ...................83 CLOSE STRUCTURE (PHOP,*,STOP,*) ........................84 COPY ALL ELEMENTS FROM STRUCTURE (PHOP,*,STOP,*) ...............84 DELETE ALL STRUCTURES (PHOP,*,*,*) .......................85 DELETE ELEMENT (PHOP,*,STOP,*) .........................85 DELETE ELEMENT RANGE (PHOP,*,STOP,*) ......................86 DELETE ELEMENTS BETWEEN LABELS (PHOP,*,STOP,*) ................87 DELETE STRUCTURE (PHOP,*,*,*) .........................88 DELETE STRUCTURE NETWORK (PHOP,*,*,*) .....................88 EMPTY STRUCTURE (PHOP,*,*,*) ..........................89 LABEL (PHOP,*,STOP,*) ..............................90 OFFSET ELEMENT POINTER (PHOP,*,STOP,*) .....................91 OPEN STRUCTURE (PHOP,*,STCL,*).........................91 SET EDIT MODE (PHOP,*,*,*)............................92 SET ELEMENT POINTER (PHOP,*,STOP,*).......................93 SET ELEMENT POINTER AT LABEL (PHOP,*,STOP,*) ..................94 Chapter 7. Workstation Table Settings ........................95 iv The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference SET COLOR MODEL (PHOP,WSOP,*,*) ........................95 SET COLOR REPRESENTATION (PHOP,WSOP,*,*) ...................96 SET EDGE REPRESENTATION (PHOP,WSOP,*,*) ....................97 SET HIGHLIGHTING FILTER (PHOP,WSOP,*,*) .....................98 SET HLHSR MODE (PHOP,WSOP,*,*).........................99 SET INTERIOR REPRESENTATION (PHOP,WSOP,*,*) ..................100 SET INVISIBILITY FILTER (PHOP,WSOP,*,*) ......................101 SET PATTERN REPRESENTATION (PHOP,WSOP,*,*) ..................102 SET POLYLINE REPRESENTATION (PHOP,WSOP,*,*) ..................104 SET POLYMARKER REPRESENTATION (PHOP,WSOP,*,*) ................105 SET TEXT REPRESENTATION (PHOP,WSOP,*,*) ....................106 SET VIEW REPRESENTATION (PHOP,WSOP,*,*) ....................108 SET VIEW REPRESENTATION 3 (PHOP,WSOP,*,*) ...................109 SET VIEW TRANSFORMATION INPUT PRIORITY (PHOP,WSOP,*,*) .............110 Chapter 8. Structure Display Subroutines ......................113 POST STRUCTURE (PHOP,WSOP,*,*) ........................113 UNPOST ALL STRUCTURES (PHOP,WSOP,*,*).....................114 UNPOST STRUCTURE (PHOP,WSOP,*,*) .......................115 Chapter 9. Structure Archiving Subroutines .....................117 ARCHIVE ALL STRUCTURES (PHOP,*,*,AROP) ....................117 ARCHIVE STRUCTURE NETWORKS (PHOP,*,*,AROP) .................118 ARCHIVE STRUCTURES (PHOP,*,*,AROP) ......................119 CLOSE ARCHIVE FILE (PHOP,*,*,AROP) .......................120 DELETE ALL STRUCTURES FROM ARCHIVE (PHOP,*,*,AROP) ..............120 DELETE STRUCTURE NETWORKS FROM ARCHIVE (PHOP,*,*,AROP) ...........121 DELETE STRUCTURES FROM ARCHIVE (PHOP,*,*,AROP) ................122 OPEN ARCHIVE FILE (PHOP,*,*,*) .........................123 RETRIEVE ALL STRUCTURES (PHOP,*,*,AROP) ....................125 RETRIEVE PATHS TO ANCESTORS (PHOP,*,*,AROP) ..................126 RETRIEVE PATHS TO DESCENDANTS (PHOP,*,*,AROP).................127 RETRIEVE STRUCTURE IDENTIFIERS (PHOP,*,*,AROP).................129 RETRIEVE STRUCTURE NETWORKS (PHOP,*,*,AROP) .................130 RETRIEVE STRUCTURES (PHOP,*,*,AROP) .....................131 SET CONFLICT RESOLUTION (PHOP,*,*,*) ......................133 Chapter 10. Transformation Subroutines ......................135 RESTORE MODELING CLIPPING VOLUME (PHOP,*,STOP,*) ...............135 SET GLOBAL TRANSFORMATION (PHOP,*,STOP,*) ...................136 SET GLOBAL TRANSFORMATION 3 (PHOP,*,STOP,*) ..................136 SET LOCAL TRANSFORMATION (PHOP,*,STOP,*) ...................137 SET LOCAL TRANSFORMATION 3 (PHOP,*,STOP,*) ..................138 SET MODELING CLIPPING VOLUME