ThegraPHIGSProgrammingInterface: Subroutine Reference GPXCR - Set Extended Color Representation .....273

  • View
    0

  • Download
    0

Embed Size (px)

Text of ThegraPHIGSProgrammingInterface: Subroutine Reference GPXCR - Set Extended Color Representation...

  • The graPHIGS Programming Interface: Subroutine Reference

    SC23-6624-00

    ���

  • The graPHIGS Programming Interface: Subroutine Reference

    SC23-6624-00

    ���

  • Note Before using this information and the product it supports, read the information in Appendix D, “Notices,” on page 771.

    First Edition (November 2007)

    This edition applies to the GDDM/graPHIGS Programming Interface, Version 2, Release 2.5, Program Number 5688-093, the AIXwindows Environment/6000 (1.2.5) AIXwindows/3D feature, Program Number 5601-257, and all subsequent releasees 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv Who Should Use This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv Highlighting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv ISO 9000 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv Related Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

    Chapter 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Calling Conventions for Subroutines . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Request Control Parameter Codes . . . . . . . . . . . . . . . . . . . . . . . . . . 1 graPHIGS API Subroutines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Subroutine Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Reference Manual Abbreviations . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

    Chapter 2. Control Subroutines . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 GPATR - Attach Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 GPCLAR - Close Archive File . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 GPCLPH - Close graPHIGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 GPCLWS - Close Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 GPCNC - Connect Nucleus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 GPCRFD - Create Font Directory . . . . . . . . . . . . . . . . . . . . . . . . . . 10 GPCRIB - Create Image Board . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 GPCRSS - Create Structure Store . . . . . . . . . . . . . . . . . . . . . . . . . . 13 GPCRWS - Create Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 GPDF - Set Deferral State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 GPDNC - Disconnect Nucleus . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 GPDTR - Detach Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 GPMSG - Message. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 GPMSPW - Set Message Password . . . . . . . . . . . . . . . . . . . . . . . . . 19 GPOPAR - Open Archive File . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 GPOPPH - Open graPHIGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 GPOPWS - Open Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 GPPW - Set Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 GPRAST - Redraw All Structures. . . . . . . . . . . . . . . . . . . . . . . . . . . 26 GPSBMS - Send Broadcast Message . . . . . . . . . . . . . . . . . . . . . . . . . 27 GPSDAL - Sound Alarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 GPSHDF - Set Shell Deferral State . . . . . . . . . . . . . . . . . . . . . . . . . . 28 GPSPMS - Send Private Message . . . . . . . . . . . . . . . . . . . . . . . . . . 30 GPSYNC - Synchronize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 GPTRCE - Internal Trace Control . . . . . . . . . . . . . . . . . . . . . . . . . . 32 GPUPWA - Update Workstation Asynchronous. . . . . . . . . . . . . . . . . . . . . . 32 GPUPWS - Update Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

    Chapter 3. Output Primitives. . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 GPAN2 - Annotation Text 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 GPAN3 - Annotation Text 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 GPANR2 - Annotation Text Relative 2 . . . . . . . . . . . . . . . . . . . . . . . . . 37 GPANR3 - Annotation Text Relative 3 . . . . . . . . . . . . . . . . . . . . . . . . . 38 GPCFA2 - Composite Fill Area 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 GPCHL2 - Character Line 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 GPCR2 - Circle 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 GPCRA2 - Circular Arc 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 GPDPL2 - Disjoint Polyline 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 GPDPL3 - Disjoint Polyline 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

    © Copyright IBM Corp. 1994, 2007 iii

  • GPEL2 - Ellipse 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 GPEL3 - Ellipse 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 GPELA2 - Elliptical Arc 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 GPELA3 - Elliptical Arc 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 GPLG2 - Line Grid 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 GPLG3 - Line Grid 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 GPMG2 - Marker Grid 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 GPMG3 - Marker Grid 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 GPNBC2 - Non-Uniform B-Spline Curve 2 . . . . . . . . . . . . . . . . . . . . . . . 58 GPNBC3 - Non-Uniform B-Spline Curve 3 . . . . . . . . . . . . . . . . . . . . . . . 60 GPNBS - Non-Uniform B-Spline Surface . . . . . . . . . . . . . . . . . . . . . . . . 63 GPPGD2 - Polygon 2 With Data . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 GPPGD3 - Polygon 3 With Data . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 GPPG2 - Polygon 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 GPPG3 - Polygon 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 GPPHE - Polyhedron Edge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 GPPL2 - Polyline 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 GPPL3 - Polyline 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 GPPLD3 - Polyline Set 3 With Data. . . . . . . . . . . . . . . . . . . . . . . . . . 84 GPPM2 - Polymarker 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 GPPM3 - Polymarker 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 GPPXL2 - Pixel 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 GPPXL3 - Pixel 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 GPQM3 - Quadrilateral Mesh 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 GPSPH - Polysphere . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 GPTNBS - Trimmed Non-Uniform B-Spline Surface . . . . . . . . . . . . . . . . . . . . 99 GPTS3 - Triangle Strip 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 GPTX2 - Geometric Text 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 GPTX3 - Geometric Text 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

    Chapter 4. Attribute Structure Elements . . . . . . . . . . . . . . . . . . . . . . . 113 GPAAL - Set Annotation Alignment. . . . . . . . . . . . . . . . . . . . . . . . . . 113 GPADCN - Add Class Name to Set . . . . . . . . . . . . . . . . . . . . . . . . . 114 GPAH - Set Annotation Height . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 GPAHSC - Set Annotation Height Scale Factor . . . . . . . . . . . . . . . . . . . . . 116 GPAID - Set Antialiasing Identifier . . . . . . . . . . . . . . . . . . . . . . . . . . 116 GPAPT - Set Annotation Path . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 GPAS - Set Annotation Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 GPASF - Attribute Source Flag Setting . . . . . . . . . . . . . . . . . . . . . . . . 119 GPAUP - Set Annotation Up Vector . . . . . . . . . . . . . . . . . . . . . . . . . 120 GPBBLF - Set Back Blending Function . . . . . . . . . . . . . . . . . . . . . . . . 121 GPBDFM - Set Back Data Filtering Method . . . . . . . . . . . . . . . . . . . . . . 123 GPBDMI - Set Back Data Mapping Index . . . . . . . . . . . . . . . . . . . . . . . 124 GPBDM2 - Set Back Data Matrix 2 . . . . . . . . . . . . . . . . . . . . . . . . . 125 GPBICD - Set Back Interior Color Direct . . . . . . . . . . . . . . . . . . . . . . . 125 GPBICI - Set Back Interior Color Index . . . . . . . . . . . . . . . . . . . . . . . . 126 GPBISM - Set Back Interior Shading Method . . . . . . . . . . . . . . . . . . . . . . 127 GPBLF - Set Blending Function . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 GPBRMO - Set Back Reflectance Model . . . . . . . . . . . . . . . . . . . . . . . 130 GPBSCD - Set Back Specular Color Direct . . . . . . . . . . . . . . . . . . . . . . 131 GPBSCI - Set Back Specular Color Index . . . . . . . . . . . . . . . . . . . . . . . 132 GPBSPR - Set Back Surface Properties. . . . . . . . . . . . . . . . . . . . . . . . 133 GPBTCO - Set Back Transparency Coefficient . . . . . . . . . . . . . . . . . . . . . 134 GPCAC - Set Curve Approximation Criteria . . . . . . . . . . . . . . . . . . . . . . 135 GPCHH - Set Character Height . . . . . . . . . . . . . . . . . .