char **dload_vector(
xvimage *image,
int *num_vects,
int *dimension,
int process_dir)
Dload_vector checks that number of image data bands is at least 1. If data processing is in DSP_VECTOR direction, Calls load_vector. If data processing is in DSP_BAND direction, assigns data to 2 dimensional vector array.
DSP_VECTOR Processing Direction: Each pixel in a multiband image can be thought of as a vector looking down all the bands. Thus, each pixel is a vector with dimension = number of data bands. This format is obtained if the parameter, process_dir, passed to dload_vector is DSP_VECTOR (0). Memory is allocated for the vector array by load_vector.
When process_dir = DSP_VECTOR, dload_vector will scan the image row by row making a linear 2-dimensional array, where the first array index points to a vector (which corresponds to some pixel), the second array index contains the values for that pixel looking down the bands on the image. Memory is allocated for the vector array in dload_vector.
DSP_BAND Processing Direction: If process_dir is DSP_BAND (1), the calling routine requires that each data band be represented as a vector. Therefore dload_vector will return a 2-dimensional array where each band is a vector of dimension rows*cols.
Data type can be of any type except BIT.
none
none
$RETRO/objects/library/vutils/src/dloadvect.c