pinq_refl_rep(3g) — Subroutines

Name

pinq_refl_rep − Returns reflectance representation information for a reflectance index.

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

Syntax

void pinq_refl_rep (
Pint           wsid,       /∗ (I) Workstation identifier. ∗/
Pint           index,      /∗ (I) Reflectance index. ∗/
Pinq_type      type,       /∗ (I) Type of returned values. ∗/
Pstore         store,      /∗ (I) Handle to store the object. store
                                    manages the memory referenced by
                                    ∗rep. ∗/
Pint          ∗error_ind, /∗ (O) Error indicator ∗/
Prefl_rep    ∗∗rep         /∗ (O) Reflectance 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 void ∗Pstore;
typedef struct {
    Pint          refl_model;   /∗ reflectance model ∗/
    Prefl_prop    refl_prop;    /∗ reflectance property data ∗/
} Prefl_rep;
    typedef struct {
        Pint    type;    /∗ reflectance property type ∗/
        union Prefl_prop_data {
            struct Prefl_prop_simple_refl {
                Pfloat    amb_coeff;    /∗ ambient reflection
                                           coefficient ∗/
                Pfloat    diff_coeff;   /∗ diffuse reflection
                                           coefficient ∗/
                Pfloat    spec_coeff;   /∗ specular reflection
                                           coefficient ∗/
                Pgcolr    spec_colr;    /∗ specular color ∗/
                Pfloat    spec_exp;     /∗ specular exponent ∗/
            } simple_refl;
            Pdata   unsupp;   /∗ unsupported reflectance property data ∗/
        } data;
    } Prefl_prop;
        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 satura-
                                              tion 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
---------------------------------------------------------------------------
Reflectance models        PREFL_MODEL_NO_REFL          Digital PHIGS pro-
                                                       duces no reflec-
                                                       tance calculation.
                          PREFL_MODEL_AMB_REFL         Digital PHIGS pro-
                                                       duces ambient re-
                                                       flectance effects.
                          PREFL_MODEL_AMB_DIFF_REFL    Digital PHIGS pro-
                                                       duce ambient and
                                                       diffuse reflectance
                                                       effects.
                          PREFL_MODEL_AMB_DIFF_SPEC_   Digital PHIGS pro-
                          REFL                         duces ambient, dif-
                                                       fuse, and specular
                                                       reflectance effects.
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.
Reflectance property      PREFL_PROPS_SIMPLE_REFL      Simple reflectance.
type
---------------------------------------------------------------------------

Description

pinq_refl_rep returns the reflectance representation information associated with the specified reflectance index.

Digital PHIGS Version 4.1 does not support this function.