GEOMETRY (geometry) functions


LIBRARY ROUTINE

lkslicer - extract an (N-1)D slice from N-D data

LIBRARY CALL

int
lkslicer(
   kobject src_obj,
   int	   plane,
   int     force_int_slice,
   int     slice_flag,
   float   slice,
   int     pslice_flag,
   float   pslice,
   int     reorient,
   int     add_locs,
   kobject dst_obj)

INPUT

OUTPUT

RETURN VALUE

TRUE (1) on success, FALSE (0) on failure

DESCRIPTION

This routine will generate an (N-1)D data set from an N-D data set. This is done by selecting a plane to slice along and a slice number into that plane. Planes are specified as being orthogonal to either the width, height, depth, time, or element dimenstions of the input data object. The slice plane can either be specified as a specific plane number, or a percentage depth into the data along the specified slice plane.

The user also has the option of reorienting the slice to be aligned with the width-height plane. This will make it suitable for direct viewing with any of the image viewing programs. If the original data set contains no location data, then explicit corner markers may be added to position the data in space.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$GEOMETRY/objects/library/geometry/src/lkslicer.c

SEE ALSO

geometry(3)

COPYRIGHT

Copyright (C) 1996,1997 , The Regents of the University of California. All rights reserved.