The Graphigs Programming Interface: Technical Reference Font File Naming Conventions
Total Page:16
File Type:pdf, Size:1020Kb
ThegraPHIGSProgrammingInterface: Technical Reference SC23-6625-00 ThegraPHIGSProgrammingInterface: Technical Reference SC23-6625-00 Note Before using this information and the product it supports, read the information in Appendix F, “Notices,” on page 407. First Edition (November 2007) This edition applies to the GDDM/graPHIGS Programming Interface, Version 2, Release 2.5, program number 5688-093, AIXwindows Environment/6000 (1.3) AIXwindows/3D feature, Program Number 5601-257, 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 ................................vii Who Should Use This Book .............................vii Highlighting ...................................vii ISO 9000 ...................................vii Related Publications ...............................vii Part 1. Workstations .............................1 Chapter 1. General Information for Workstations ....................3 Accessing a Workstation ..............................3 Description Tables in the graPHIGS API ........................5 Chapter 2. Supported Workstations .........................15 The X Workstation Family .............................15 Additional Notes for DWA Adapters ..........................36 The XSOFT Workstation ..............................41 The 6090 Workstation ...............................43 The 5080 Workstation ...............................44 The GDDM Workstation ..............................45 The GDF Workstation ...............................45 The CGM Workstation...............................47 The IMAGE Workstation ..............................57 Chapter 3. Workstation Description Tables ......................65 General Workstation Facilities ............................66 General Output Facilities ..............................69 Polyline Facilities ................................74 Polymarker Facilities ...............................78 Text Facilities ..................................80 Interior Facilities .................................85 Edge Facilities .................................89 Color Facilities .................................92 Generalized Drawing Primitive (GDP) Facilities .....................95 Generalized Structure Element (GSE) Facilities .....................97 Escape Facilities.................................98 Image Facilities.................................100 Advanced Output Facilities ............................101 Curve and Surface Facilities ............................103 Advanced Attribute Facilities ............................104 General Input Facilities ..............................108 Available Triggers ................................113 Locator Devices ................................115 Stroke Devices .................................117 Valuator Devices ................................120 Choice Devices.................................124 Pick Devices..................................130 String Devices .................................133 Button Devices .................................138 Scalar Devices .................................140 Vector Devices .................................141 Break Action ..................................142 © Copyright IBM Corp. 1994, 2007 iii Part 2. Distributed graPHIGS API ......................143 Chapter 4. The graPHIGS API Nucleus .......................145 Connecting to the Nucleus.............................145 The Nucleus Description Table ...........................146 gPafut Command ................................149 gPinit Command ................................149 gPhost Command ................................152 gPq Command .................................153 gPterm Command ................................154 makegP Command(AIX PS/2 only) .........................155 Chapter 5. graPHIGS API Host and Workstation Connectivity ..............157 The graPHIGS API Gateway Daemon ........................157 The SOCKETS Connection Method .........................161 graPHIGS/GAM Direct Connection..........................163 chgPcon Command ...............................165 gPgated Command ...............................168 ls6098 Command ................................171 lsgPcon Command ...............................172 mkgPcon Command ...............................174 Chapter 6. Enabling User Exits for Conferencing ...................177 Starting and Stopping the Conference Utility Controller ..................179 The Conference Controller.............................179 The User Exit Routine ..............................179 The Application Intercept Exit Routine ........................181 Part 3. Defaults and Nicknames .......................185 Chapter 7. Controlling the Environment with Defaults and Nicknames ...........187 Overview of Controlling the Environment .......................187 The External Defaults File (EDF) ..........................188 The Application Defaults Interface Block (ADIB) .....................189 Defaults ...................................190 Nicknames ..................................199 PROCOPTS ..................................203 Part 4. Character Sets and Fonts ......................219 Chapter 8. Character Set Facilities of the graPHIGS API ................221 Identifying a Character Set ............................221 Identifying a Font ................................221 Using the Character Set Facilities ..........................222 Chapter 9. Character Sets and Fonts Provided by the API................223 Using the Unicode Character Set ..........................223 Using Kanji Character Sets in the Operating System ...................223 Character Code Points and Symbols .........................224 Chapter 10. User-Definable Fonts .........................257 Defining Your Own Characters ...........................257 Displaying a Text String..............................260 Font File Organization Overview ..........................264 Overview of Font File Contents ...........................266 iv The graPHIGS Programming Interface: Technical Reference Font File Naming Conventions ...........................267 Font File Format Specifications ...........................268 IBM 5080 Character Set Restrictions .........................276 Part 5. Format and Content of Structure Element Records ..........277 Chapter 11. Structure Element Content as Returned by GPQED .............279 General Format.................................283 Structure Element Codes .............................284 Common Data Types...............................289 Output Primitives ................................292 Attribute Setting Structure Elements .........................307 Transformation Setting Structure Elements.......................325 Miscellaneous Structure Elements ..........................328 Chapter 12. Structure Element Content as Returned by GPQE ..............333 Output Primitives ................................333 Attributes ...................................339 Modeling and Viewing ..............................343 Miscellaneous Structure Elements ..........................346 Appendix A. State Lists .............................349 Operating States List (OSL) ............................349 The graPHIGS API Descriptor Table (PDT).......................350 The graPHIGS API State List (PSL) .........................351 Structure Store State List (SSL)...........................352 Workstation State List (WSL)............................353 The graPHIGS API Error State List (ESL) .......................363 Utility Function State List (USL) ...........................364 Appendix B. Event Data Formats .........................367 Event Summary ................................367 Event Data Format ...............................367 Appendix C. Plotting with graPHIGS ........................371 Plotting on the RS/6000 .............................371 Plotting GDF Files................................371 Plotting on AIX PS/2 ...............................390 Plotting on VM/MVS ...............................390 Plotting CGM Files ...............................391 Appendix D. Printing with graPHIGS ........................397 Appendix E. How the Mnemonics are Generated ...................399 Deletions ...................................399 Abbreviations .................................399 Appendix F. Notices ..............................407 Trademarks ..................................408 Index ....................................409 Contents v vi The graPHIGS Programming Interface: Technical Reference About This Book This book provides technical information about the functions and limitations of the graPHIGS API and its supported workstations. It also contains reference information, both general and specific, about particular aspects of writing applications, namely on Character Set Facilities and on Defaults and Nicknames. The purpose of this book is to provide a comprehensive volume of technical information needed to accurately code or modify applications using the graPHIGS API. Who Should Use This Book This book is intended for application programmers. Highlighting The following highlighting conventions are used in this book: Bold Identifies commands, subroutines, keywords, files, structures, directories, and other items whose names are predefined by the system. Also identifies graphical objects such as buttons, labels, and icons