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