next up previous contents
Next: miget_dimension_size/miset_dimension_size Up: DIMENSION FUNCTIONS (39) Previous: miget_dimension_separation/miset_dimension_separation   Contents

miget_dimension_separations/miset_dimension_separations

NAME

miget_dimension_separations, miset_dimension_separations - get/set the
sampling intervals for a list of dimensions.

SYNOPSIS

#include <minc2.h>

int miget_dimension_separations ( const midimhandle_t   dimensions[],
                                  mivoxel_order_t       voxel_order,
                                  int                   array_length,
                                  double                separations[] );

int miset_dimension_separations ( const midimhandle_t   dimensions[],
                                  mivoxel_order_t       voxel_order,
                                  int                   array_length,
                                  const double          separations[] );

DESCRIPTION

These functions get or set the scalar separation (sampling interval)
associated with each of the dimensions in the input "dimensions[]"
array.  The "array_length" parameter specifies the size of both the
input and output arrays. While it is legal to call these functions for
an irregularly- sampled dimension, the values will be ignored.

RETURN VALUE

Returns the number of separations copied to (or from) the array, or
MI_ERROR if an error occurs.

SEE ALSO

miget_dimension_separation, miset_dimension_separation



Robert VINCENT 2005-03-09