RETRO (vutils) functions
LIBRARY ROUTINE
load_vector - convert image data into vector data
LIBRARY CALL
char **load_vector(
xvimage *image,
int border,
int *num_vects,
int *dimension)
INPUT
- image - a pointer to the image to vectorize.
- border - the border width to skip.
OUTPUT
- num_vects - the total number of vectors loaded into the array
- dimension - the dimension of each vector.
RETURN VALUE
a (char **) pointer to a 2-d array containing the
vectorized data.
DESCRIPTION
takes a multiband image and rearanges the data so
that the data is stored as a list of vectors.
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 routine 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.
When a border is specified a row and coluwn on each
side of the image is dropped.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
Restrictions on data or input as applicable
MODIFICATION
none
FILES
$RETRO/objects/library/vutils/src/loadvector.c
SEE ALSO
vutils(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.