pset_data_map_rep(3g) — Subroutines
Name
pset_data_map_rep − Associates the data mapping index with the specified parameters.
Operating States: PHOP, WSOP, ∗, ∗
PHIGS PLUS function
Syntax
void pset_data_map_rep (
Pint wsid, /∗ (I) Workstation identifier ∗/
Pint index, /∗ (I) Data mapping index ∗/
const Pdata_map_rep ∗rep /∗ (I) Data mapping representation ∗/
)
Data Structures
typedef struct {
Pint method; /∗ data mapping method ∗/
Psource_select_listselectors; /∗ 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 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 Constants Constant Description
---------------------------------------------------------------------------
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_SINGLE_ Digital PHIGS maps a
UNIFORM single 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_SINGLE_ Digital PHIGS maps a
NON_UNIFORM single 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
UNIFORM data 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
NON_UNIFORM data 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
pset_data_map_rep associates the data mapping index with the specified parameters. The data mapping bundle table has predefined entries taken from the workstation description table. You can set any entry, including the predefined entries, with this function.
During structure traversal, Digital PHIGS uses the current data mapping index and current back data mapping index entries in the PHIGS traversal state list to select entries in the data mapping bundle table. If the entry corresponding to either of these indexes is undefined, Digital PHIGS uses the entry corresponding to index 1.
Digital PHIGS Version 4.1 does not support this function.
See Also
pinq_data_map_rep