Functions | |
void | Show_One_Color (const char *type, char *color) |
void | Show_One_Color_By_Index (const char *type, int *index) |
void | Show_One_Color_By_Value (const char *type, char *color_space, float *a, float *b, float *c) |
void | QShow_One_Color (const char *segment, const char *type, char *color) |
void | QShow_One_Color_By_Index (const char *segment, const char *type, int *index) |
void | QShow_One_Color_By_Value (const char *segment, const char *type, char *color_space, float *a, float *b, float *c) |
void | Show_One_Net_Color (const char *type, char *color) |
void | Show_One_Net_Color_By_Index (const char *type, int *index) |
void | Show_One_Net_Color_By_Value (const char *type, char *color_space, float *a, float *b, float *c) |
void | PShow_One_Net_Color (int count, HC_KEY *keys, const char *type, char *color) |
void | PShow_One_Net_Color_By_Index (int count, HC_KEY *keys, const char *type, int *index) |
void | PShow_One_Net_Color_By_Value (int count, HC_KEY *keys, const char *type, char *color_space, float *a, float *b, float *c) |
void | QShow_One_Net_Color (const char *segment, const char *type, char *color) |
void | QShow_One_Net_Color_By_Index (const char *segment, const char *type, int *index) |
void | QShow_One_Net_Color_By_Value (const char *segment, const char *type, char *color_space, float *a, float *b, float *c) |
void Show_One_Color | ( | const char * | type, | |
char * | color | |||
) |
Returns the color value for one particular type of geometry.
type | - The type of geometry whose current color setting should be shown. | |
color | - An English description of the color's current setting. Returned to caller. Passed by reference in all languages. |
Legal choices for type are the same as in Set_Color_By_Value() . If you use a name that is really composed of more than one color, such as "polygons", all the pieces (edges and faces) have to agree or you'll get an error.
The color_space is returned to you, not passed in. In the present implementation, the color will be equivalent to the color you originally set, but it won't necessarily be written the same way. For example, if you set a color by RGB value, the system may, at its discretion, return an HLS color when asked to show that color. If you want a particular color space, use Compute_Color() on the return values.
An error will occur if you Show a color by value that was originally set by index, or vice versa.
The "Show Net" routines can always return a value, but you'll get an error if you use one of the "simple" Show routines on a segment that doesn't have that particular color set on it.
void Show_One_Color_By_Index | ( | const char * | type, | |
int * | index | |||
) |
Similar to Show_One_Color(), but returns the value of a single attribute in the currently open segment. Operates with map indices rather than names or values.
type | - The type of geometry whose current color setting should be shown. | |
index | - The offset in the applicable Color Map. Returned to caller. Passed by reference in all languages. |
void Show_One_Color_By_Value | ( | const char * | type, | |
char * | color_space, | |||
float * | a, | |||
float * | b, | |||
float * | c | |||
) |
Similar to Show_One_Color(), but returns the value of a single attribute in the currently open segment. Operates with a color values rather than names or map indices.
type | - The type of geometry whose current color setting should be shown. | |
color_space | - Special constant---either "HLS", "HSV", "HIC", or "RGB". Returned to caller. Passed by reference in all languages. | |
a | - The location in the color space---hue, lightness, and satura tion; red, green, and blue; etc. Returned to caller. Passed by reference in all languages. | |
b | - | |
c | - |
void QShow_One_Color | ( | const char * | segment, | |
const char * | type, | |||
char * | color | |||
) |
Similar to Show_One_Color(), but operates on a given segment rather than the currently open one.
segment | - Name of the segment to be shown. | |
type | - The type of geometry whose current color setting should be shown. | |
color | - An English description of the color's current setting. Returned to caller. Passed by reference in all languages. |
void QShow_One_Color_By_Index | ( | const char * | segment, | |
const char * | type, | |||
int * | index | |||
) |
Similar to Show_One_Color(), but returns the value of a single attribute in a given segment, rather than the currently open one. Operates with map indices rather than names or values.
segment | - Name of the segment to be shown. | |
type | - The type of geometry whose current color setting should be shown. | |
index | - The offset in the applicable Color Map. Returned to caller. Passed by reference in all languages. |
void QShow_One_Color_By_Value | ( | const char * | segment, | |
const char * | type, | |||
char * | color_space, | |||
float * | a, | |||
float * | b, | |||
float * | c | |||
) |
Similar to Show_One_Color(), but returns the value of a single attribute in a given segment, rather than the currently open one. Operates with a color values rather than names or map indices.
segment | - Name of the segment to be shown. | |
type | - The type of geometry whose current color setting should be shown. | |
color_space | - Special constant---either "HLS", "HSV", "HIC", or "RGB". Returned to caller. Passed by reference in all languages. | |
a | - The location in the color space---hue, lightness, and satura tion; red, green, and blue; etc. Returned to caller. Passed by reference in all languages. | |
b | - | |
c | - |
void Show_One_Net_Color | ( | const char * | type, | |
char * | color | |||
) |
Similar to Show_One_Color(), but returns the net effective value of a single attribute in the currently open segment.
type | - The type of geometry whose current color setting should be shown. | |
color | - An English description of the color's current setting. Returned to caller. Passed by reference in all languages. |
void Show_One_Net_Color_By_Index | ( | const char * | type, | |
int * | index | |||
) |
Similar to Show_One_Color(), but returns the net effective value of a single attribute in the currently open segment. Operates with map indices rather than names or values.
type | - The type of geometry whose current color setting should be shown. | |
index | - The offset in the applicable Color Map. Returned to caller. Passed by reference in all languages. |
void Show_One_Net_Color_By_Value | ( | const char * | type, | |
char * | color_space, | |||
float * | a, | |||
float * | b, | |||
float * | c | |||
) |
Similar to Show_One_Color(), but returns the net effective value of a single attribute in the currently open segment. Operates with a color values rather than names or map indices.
type | - The type of geometry whose current color setting should be shown. | |
color_space | - Special constant---either "HLS", "HSV", "HIC", or "RGB". Returned to caller. Passed by reference in all languages. | |
a | - The location in the color space---hue, lightness, and satura tion; red, green, and blue; etc. Returned to caller. Passed by reference in all languages. | |
b | - | |
c | - |
void PShow_One_Net_Color | ( | int | count, | |
HC_KEY * | keys, | |||
const char * | type, | |||
char * | color | |||
) |
Similar to Show_One_Color(), but returns the net effective value of a single attribute along a path of segments specified by an array of HC_KEY's.
count | - The size of the keys array | |
keys | - The list of keys starting with the owning segment and following all the way back to the root segment or other desired segment. | |
type | - The type of geometry whose current color setting should be shown. | |
color | - An English description of the color's current setting. Returned to caller. Passed by reference in all languages. |
void PShow_One_Net_Color_By_Index | ( | int | count, | |
HC_KEY * | keys, | |||
const char * | type, | |||
int * | index | |||
) |
Similar to Show_One_Color(), but returns the net effective value of a single attribute along a path of segments specified by an array of HC_KEY's. Operates with map indices rather than names or values.
count | - The size of the keys array | |
keys | - The list of keys starting with the owning segment and following all the way back to the root segment or other desired segment. | |
type | - The type of geometry whose current color setting should be shown. | |
index | - The offset in the applicable Color Map. Returned to caller. Passed by reference in all languages. |
void PShow_One_Net_Color_By_Value | ( | int | count, | |
HC_KEY * | keys, | |||
const char * | type, | |||
char * | color_space, | |||
float * | a, | |||
float * | b, | |||
float * | c | |||
) |
Similar to Show_One_Color(), but returns the net effective value of a single attribute along a path of segments specified by an array of HC_KEY's. Operates with a color values rather than names or map indices.
count | - The size of the keys array | |
keys | - The list of keys starting with the owning segment and following all the way back to the root segment or other desired segment. | |
type | - The type of geometry whose current color setting should be shown. | |
color_space | - Special constant---either "HLS", "HSV", "HIC", or "RGB". Returned to caller. Passed by reference in all languages. | |
a | - The location in the color space---hue, lightness, and satura tion; red, green, and blue; etc. Returned to caller. Passed by reference in all languages. | |
b | - | |
c | - |
void QShow_One_Net_Color | ( | const char * | segment, | |
const char * | type, | |||
char * | color | |||
) |
Similar to Show_One_Color(), but returns the net effective value of a single attribute in a given segment, rather than the currently open one.
segment | - Name of the segment to be shown. | |
type | - The type of geometry whose current color setting should be shown. | |
color | - An English description of the color's current setting. Returned to caller. Passed by reference in all languages. |
void QShow_One_Net_Color_By_Index | ( | const char * | segment, | |
const char * | type, | |||
int * | index | |||
) |
Similar to Show_One_Color(), but returns the net effective value of a single attribute in a given segment, rather than the currently open one. Operates with map indices rather than names or values.
segment | - Name of the segment to be shown. | |
type | - The type of geometry whose current color setting should be shown. | |
index | - The offset in the applicable Color Map. Returned to caller. Passed by reference in all languages. |
void QShow_One_Net_Color_By_Value | ( | const char * | segment, | |
const char * | type, | |||
char * | color_space, | |||
float * | a, | |||
float * | b, | |||
float * | c | |||
) |
Similar to Show_One_Color(), but returns the net effective value of a single attribute in a given segment, rather than the currently open one. Operates with a color values rather than names or map indices.
segment | - Name of the segment to be shown. | |
type | - The type of geometry whose current color setting should be shown. | |
color_space | - Special constant---either "HLS", "HSV", "HIC", or "RGB". Returned to caller. Passed by reference in all languages. | |
a | - The location in the color space---hue, lightness, and satura tion; red, green, and blue; etc. Returned to caller. Passed by reference in all languages. | |
b | - | |
c | - |