pinq_depth_cue_rep(3g) — Subroutines

Name

pinq_depth_cue_rep − Returns depth cue representation information.

Operating States: PHOP, WSOP, ∗, ∗
PHIGS PLUS function

Syntax

void pinq_depth_cue_rep (
Pint             wsid,         /∗ (I) Workstation identifier ∗/
Pint             index,        /∗ (I) Depth cue index ∗/
Pinq_type        return_type, /∗ (I) Type of returned values ∗/
Pint            ∗error_ind,    /∗ (O) Error indicator ∗/
Pdepth_cue_rep ∗rep           /∗ (O) Depth cue representation ∗/
)

Data Structures

typedef enum {
    PINQ_SET,        /∗ Use the exact state list values. ∗/
    PINQ_REALIZED    /∗ Use the values approximated by the graphics
                        handler. ∗/
} Pinq_type;
typedef struct {
    Pdepth_cue_mode     mode;           /∗ depth cue mode ∗/
    Pfloat              ref_planes[2]; /∗ depth cue reference planes
                                           (minimum, maximum) ∗/
    Pfloat              scale[2];       /∗ depth cue scale factors
                                           (minimum, maximum) ∗/
    Pgcolr              gcolr;          /∗ depth cue color ∗/
} Pdepth_cue_rep;
    typedef enum {
        PDEPTH_CUE_SUPPR,      /∗ no depth cueing ∗/
        PDEPTH_CUE_ALLOWED     /∗ perform depth cueing ∗/
    } Pdepth_cue_mode;
    typedef struct {
        Pint     colr_type;   /∗ color type ∗/
        Pcolrv   colr_value; /∗ color value ∗/
    } Pgcolr;
        typedef union {
            Pint         colr_ind;    /∗ color index ∗/
            Pcolr_rep    colr_rep;    /∗ color representation ∗/
        } Pcolrv;
            typedef union {
                Prgb        rgb;       /∗ red, green, and blue color
                                          specification ∗/
                Pcieluv     cieluv;    /∗ CIELUV color specification ∗/
                Phls        hls;       /∗ hue, lightness, and saturation
                                          color specification ∗/
                Phsv        hsv;       /∗ hue, saturation, and value color
                                          specification ∗/
                Pdata       unsupp;    /∗ color in an unsupported color
                                          model ∗/
                int         impl_dep; /∗ implementation-defined ∗/
            } Pcolr_rep;
                typedef struct {
                    Pfloat    red;     /∗ red intensity ∗/
                    Pfloat    green;   /∗ green intensity ∗/
                    Pfloat    blue;    /∗ blue intensity ∗/
                } Prgb;
                typedef struct {
                    Pfloat    cieluv_x;      /∗ x coefficient ∗/
                    Pfloat    cieluv_y;      /∗ y coefficient ∗/
                    Pfloat    cieluv_y_lum; /∗ y luminance ∗/
                } Pcieluv;
                typedef struct {
                    Pfloat    hue;         /∗ hue ∗/
                    Pfloat    lightness;   /∗ lightness ∗/
                    Pfloat    satur;       /∗ saturation ∗/
                } Phls;
                typedef struct {
                    Pfloat    hue;      /∗ hue ∗/
                    Pfloat    satur;    /∗ saturation ∗/
                    Pfloat    value;    /∗ value ∗/
                } Phsv;
                typedef struct {
                    size_t    size;     /∗ size of data ∗/
                    void     ∗data;     /∗ pointer to the data ∗/
                } Pdata;

Constants

Data Structure               Constant         Description
Constants
---------------------------------------------------------------------------
Color types                  PCOLR_INDIRECT   Indirect (indexed) color
                             PCOLR_RGB        Direct specification of red,
                                              green, and blue
                             PCOLR_CIELUV     Direct specification in the
                                              format of the Commission
                                              Internationale de l’Eclairage
                             PCOLR_HSV        Direct specification of hue,
                                              saturation, and value
                             PCOLR_HLS        Direct specification of hue,
                                              lightness, and saturation
---------------------------------------------------------------------------

Description

pinq_depth_cue_rep returns values for the following:

•Depth cue mode

•Depth cue reference planes

•Depth cue scale factors

•Depth cue color

If the specified depth cue index is not in the depth cue table on the specified workstation, and the specified type of returned value is PINQ_REALIZED, the function returns the representation for the depth cue index 1.