pinq_data_map_rep(3g) — Subroutines
Name
pinq_data_map_rep − Returns the data mapping information associated with the specified index.
Operating States: PHOP, WSOP, ∗, ∗
PHIGS PLUS function
Syntax
void pinq_data_map_rep (
Pint wsid, /∗ (I) Workstation identifier. ∗/
Pint index, /∗ (I) Data mapping 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. ∗/
Pdata_map_rep ∗∗rep /∗ (O) Data mapping 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 method; /∗ data mapping method ∗/
Psource_select_list selectors; /∗ list of source selectors ∗/
union Pdata_map_rep_data {
struct Pdata_map_rep_single_uniform {
Pint ind; /∗ data value index ∗/
Pfloat lower_limit; /∗ lower range limit ∗/
Pfloat upper_limit; /∗ upper range limit ∗/
Pint colr_type; /∗ color type ∗/
Pcolrv_list colr_values; /∗ list of color values ∗/
} single_uniform;
struct Pdata_map_rep_single_non_uniform {
Pint ind; /∗ data value index ∗/
Pfloat_list range; /∗ range boundaries ∗/
Pint colr_type; /∗ color type ∗/
Pcolrv_list colr_values; /∗ list of color values ∗/
} single_non_uniform;
struct Pdata_map_rep_bi_uniform {
Pint inds[2]; /∗ data value indexes ∗/
Pfloat lower_limit_a; /∗ lower limit of Ra range ∗/
Pfloat upper_limit_a; /∗ upper limit of Ra range ∗/
Pfloat lower_limit_b; /∗ lower limit of Rb range ∗/
Pfloat upper_limit_b; /∗ upper limit of Rb range ∗/
Pint colr_type; /∗ color type ∗/
Pcolrv_set colr_values; /∗ list of color value lists ∗/
} bi_uniform;
struct Pdata_map_rep_bi_non_uniform {
Pint inds[2]; /∗ data value indexes ∗/
Pfloat_list range_a; /∗ Ra range boundaries ∗/
Pfloat_set range_b; /∗ Rb range boundaries ∗/
Pint colr_type; /∗ color type ∗/
Pcolrv_set colr_values; /∗ array of color values ∗/
} bi_non_uniform;
} data;
} Pdata_map_rep;
typedef struct {
Pint num_selectors; /∗ number of selectors ∗/
Psource_select ∗selectors; /∗ list of source selectors ∗/
} Psource_select_list;
typedef enum {
PB_SOURCE_SELECT_COLR_ASPECT, /∗ color aspect ∗/
PB_SOURCE_SELECT_VERT_COLR, /∗ vertex color ∗/
PB_SOURCE_SELECT_VERT_DATA, /∗ vertex data ∗/
PB_SOURCE_SELECT_FACET_COLR, /∗ facet color ∗/
PB_SOURCE_SELECT_FACET_DATA /∗ facet data ∗/
} Psource_select;
typedef struct {
Pint num_colrs; /∗ number of colors ∗/
Pcolrv_ptr colrs; /∗ list of color values ∗/
} Pcolrv_list;
typedef union {
Pint ∗colr_inds; /∗ pointer to color indexes ∗/
Pcolr_rep_ptr colr_reps; /∗ pointer to color
representations ∗/
} Pcolrv_ptr;
typedef union {
Prgb ∗rgb; /∗ pointer to RGB color values ∗/
Pcieluv ∗cieluv; /∗ pointer to CIELUV color values ∗/
Phls ∗hls; /∗ pointer to HLS color values ∗/
Phsv ∗hsv; /∗ pointer to HSV color values ∗/
Pdata ∗unsupp; /∗ pointer to unsupported color
values ∗/
} Pcolr_rep_ptr;
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;
typedef struct {
Pint num_floats; /∗ number of floats in the list ∗/
Pfloat ∗floats; /∗ list of floats ∗/
} Pfloat_list;
typedef struct {
Pint num_lists; /∗ number of color value lists ∗/
Pcolrv_list ∗colrs; /∗ list of color value lists ∗/
} Pcolrv_set;
typedef struct {
Pint num_lists; /∗ number of float lists ∗/
Pfloat_list ∗floats; /∗ list of float lists ∗/
} Pfloat_set;
Constants
Data Structure Constant Description
Constants
---------------------------------------------------------------------------
Data mapping methods PDATA_MAP_METHOD_COLR Digital PHIGS uses any
colors specified with the
output primitive as the
source of color.
PDATA_MAP_METHOD_ Digital PHIGS maps a single
SINGLE_UNIFORM data value to a color
selected from a specified
list of colors. Digital
PHIGS selects the color
based on the relationship
of the data value to a
specified data range.
PDATA_MAP_METHOD_ Digital PHIGS maps a single
SINGLE_NON_UNIFORM data value to a color
selected from a specified
list of colors. Digital
PHIGS selects the color
based on the relationship
of the data value to a
specified set of data
ranges.
PDATA_MAP_METHOD_BI_ Digital PHIGS maps two data
UNIFORM values to a single color
selected from one of a
set of color lists.
The first value specifies
the list to use, and the
second value specifies
which color to select
from that list.
PDATA_MAP_METHOD_BI_ Digital PHIGS maps two data
NON_UNIFORM values to a single color
selected from one of a
set of color lists.
Digital PHIGS selects the
color based on the
relationships of the data
values to a specified
set of data ranges.
---------------------------------------------------------------------------
Description
pinq_data_map_rep returns the data mapping information associated with the specified index.
Digital PHIGS Version 4.1 does not support this function.
See Also
pcreate_store
pdel_store
pinq_data_map_facs
pinq_list_data_map_inds
pset_data_map_ind
pset_data_map_rep