[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

Chapter 7. Workstation Table Operations

When your application opens a workstation, the graPHIGS API creates workstation tables that describe that workstation. Each workstation table has default settings. Use the subroutines in this section to modify some of the table entries according to your application's specifications.

Most workstation table indexes begin with 1. The following exceptions begin with 0:

  • color tables

  • color processing tables

  • depth cue tables

  • view tables
  • Some table entries may not be modified.

    The subroutines in this section do not create structure elements or modify structure content. The changed table values only take effect after you update the workstation. The application may inquire the default table settings by issuing the appropriate inquiry programming calls. For a listing of the default tables for each supported workstation type, see The graPHIGS Programming Interface: Technical Reference

    GPCML - Set Color Model

    GPCML (wsid, model)

    Purpose

    Use GPCML to set the current color model for the specified workstation to the given color model.

    This subroutine enables the application to specify the color model that the graPHIGS API uses to interpret the following colors when your application sets or inquires these colors by the corresponding API subroutines:

  • colors in bundle tables

  • light source color

  • depth cue color

  • view colors

  • input echo colors
  • The color model set with GPCML does not apply to colors in primitive definitions or individual direct color attributes.

    Parameters

    wsid -- specified by user, fullword integer

    Workstation identifier.

    model -- specified by user, fullword integer

    Color model (1=RGB, 2=HSV, 3=CMY, 4=CIELUV )

    Error Codes

    25
    SPECIFIED WORKSTATION DOES NOT EXIST
    35
    WORKSTATION HAS ONLY INPUT CAPABILITIES
    318
    COLOR MODEL INVALID

    Related Subroutines

    GPQCML
    Inquire Color Model
    GPTXCD
    Set Text Color Direct

    RCP code

    201329415 (X'0C000B07')


    [ Previous | Next | Contents | Glossary | Home | Search ]