NAME miget_dimension_offsets, miset_dimension_offsets - get or set the absolute world coordinates of points along a MINC dimension SYNOPSIS #include <minc2.h> int miget_dimension_offsets ( midimhandle_t dimension, double offsets[], unsigned long array_length, unsigned long start_position); int miset_dimension_offsets ( midimhandle_t dimension, const double offsets[], unsigned long array_length, unsigned long start_position); DESCRIPTION These functions get or set the dimension offsets, that is, the absolute world coordinates of each sampled point along the dimension. The caller may retrieve up to "array_length" values, starting at the integer index "start_position". Thus an arbitrary contiguous subset of the dimension's offsets may be retrieved or stored. An error is returned if the "start_position" exceeds the total size of the dimension. If the value of "start_position" is legal, but the sum of "start_position" and "array_length" exceeds the size of the dimension, the function will get or set offsets up to the size of the dimension. Any extra positions in the offsets[] array will be ignored. It is explicitly legal to call this function for a regularly sampled dimension. The result will be a list of values calculated from the "start" and "separation" values of the dimension. However, it is not possible to set offsets on a regularly sampled dimension. RETURN VALUE Returns the number of offset values read or written , or MI_ERROR if an error is detected.