pinq_pred_data_map_rep(3g) — Subroutines
Name
pinq_pred_data_map_rep − Returns the data mapping information for an index.
Operating States: PHOP, ∗, ∗, ∗
PHIGS PLUS function
Syntax
void pinq_pred_data_map_rep (
Pint wstype, /∗ (I) Workstation type. ∗/
Pint index, /∗ (I) Predefined data mapping index. ∗/
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) Predefined data mapping
representation. ∗/
)
Data Structures
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 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_pred_data_map_rep queries the workstation description table and returns the data mapping type and data mapping information for the specified index.
Digital PHIGS Version 4.1 does not support this function.
See Also
pcreate_store
pdel_store
pinq_data_map_facs
pinq_data_map_rep
pinq_list_data_map_inds
pset_data_map_rep