pinq_pred_refl_rep(3g) — Subroutines

Name

pinq_pred_refl_rep − Returns the reflectance representation of an index.

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

Syntax

void pinq_pred_refl_rep (
Pint           wstype,     /∗ (I) Workstation type. ∗/
Pint           index,      /∗ (I) Predefined reflectance index. ∗/
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) Predefined reflectance
                                    representation ∗/
)

Data Structures

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 Constants   Constant          Description
---------------------------------------------------------------------------
Reflectance models         PREFL_MODEL_      Digital PHIGS produces no
                           NO_REFL           reflectance calculation.
                           PREFL_MODEL_AMB_ Digital PHIGS produces
                           REFL              ambient reflectance effects.
                           PREFL_MODEL_AMB_ Digital PHIGS produces
                           DIFF_REFL         ambient and diffuse
                                             reflectance effects.
                           PREFL_MODEL_AMB_ Digital PHIGS produces
                           DIFF_SPEC_REFL    ambient, diffuse, 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 reflectance.
type                       SIMPLE_REFL
---------------------------------------------------------------------------

Description

pinq_pred_refl_rep queries the workstation description table and returns the predefined reflectance representation of the specified index.

Digital PHIGS Version 4.1 does not support this function.