RSL color table routines
Synopsis
#include "rsl.h"
void RSL_load_color_table(char *infile, char buffer[256], int *ncolors);
void RSL_load_green_table(char *infile);
void RSL_load_blue_table(char *infile);
void RSL_load_red_table(char *infile);
void RSL_load_refl_color_table();
void RSL_load_sw_color_table();
void RSL_load_vel_color_table();
void RSL_load_zdr_color_table();
void RSL_load_rainfall_color_table();
void RSL_load_height_color_table();
Description
These are the color table routines. The color table is use when making
images and is merely 256 bytes in size representing red, green and blue
color indexes. The routines RSL_load_refl_color_table, RSL_load_sw_color_table,
RSL_load_vel_color_table,and RSL_load_zdr_color_table each call
the three routines RSL_load_red_table, RSL_load_green_table,
and RSL_load_blue_table with a hard coded (defined during software
installation) color input file. Under normal usage, you only have to call
these routines once prior to any image generation function calls.
The routines RSL_load_rainfall_color_table and RSL_load_height_color_table
use the default files defined during installation. These routines exist
to simplify the interface when generating height or rainfall images.
The default input file names are defined in volume.h. When you don't
want to use the default color tables for reflectivity, spectrum width,
or velocity, and have your own color tables, you can use RSL_load_red_table,
RSL_load_green_table,
and RSL_load_blue_table directly. Be sure to call all three routines.
The most general of the routines, and one you should not normally use,
is RSL_load_color_table. It manages a static global color table
array and it is how the color table is remembered throughout your application.
The organization of the input color table files is binary. They contain,
at most, 256 bytes with no delimeters and represent the color ramp from
index 0 to 255.
Return value
None.
See also
RSL_sweep_to_gif, RSL_sweep_to_pict,
RSL_sweep_to_pgm,
RSL_sweep_to_ppm,
RSL_bscan_ray, RSL_bscan_sweep,
RSL_bscan_volume,
RSL_volume_to_gif, RSL_volume_to_pict,
RSL_volume_to_pgm,
RSL_volume_to_ppm,
RSL_get_color_table, RSL_set_color_table.
Author: John H. Merritt