RISsetDimensions(3DTM)

NAME
RISsetDimensions, RISgetDimensions - Functions dealing with raster image dimensions

SYNOPSIS
#include <ris.h>

void RISsetDimensions(char *header, int xdim, int ydim)

int RISgetDimensions(char *header, int *xdim, int *ydim)

DESCRIPTION
RISsetDimensions inserts into the string header the RISdims flag followed by the two dimensions xdim and ydim of the raster image. It is the user's responsibility to ensure that the dimensions specified here match the actual dimensions of the data.

RISgetDimensions examines the string header and returns the specified dimensions, xdim and ydim, of the raster image. There is no guarantee that the dimensions read from the header will match the dimensionality of the data received since RISgetDimensions has no way of reviewing and interpreting the data.

SEE ALSO
DTM, RISclass

DIAGNOSTICS
RISgetDimensions returns a value of 0 upon successful parsing of the header. If the tag RISdims is not found within the header, the function returns the error DTMERROR and no values are assigned to the dimensions.

BUGS
RISsetDimensions has no way of determining if the header contains sufficient space to hold the tag RISdims and the number of dimensions specified. The results of this operation is undefined.

RISgetDimensions assumes that two dimensions follow the RISdims flag. If less than two follow the tag, the results are undefined.