void imgCancl(char *param, int *status) Cancel an image/parameter association void imgDelet(char *param, int *status) Delete an image void imgFree(char *param, int *status) Free an image void imgIn[N][X](char *param, int *nx, [int *ny,] [int *nz,] TYPE **ip, int *status) Access an existing image for reading void imgIndf(char *param, int *indf, int *status) Obtain an NDF identifier for an image void imgMod[N][X](char *param, int *nx, [int *ny,] [int nz,] TYPE **ip, int *status) Access an image for modification void imgNew[N][X](char *param, int nx, [int ny,] [int nz,] TYPE **ip, int *status) Create a new image void imgName(char *param, char *value, int value_length, int *status) Return the image name void imgOut[X](char *param1, char *param2, TYPE **ip, int *status) Create an output image void imgTmp[N][X](char *param, int nx, [int ny,] [int nz,] TYPE **ip, int *status) Create a temporary image
Where the parts in "[]" are optional or not always available. [N] indicates the number of dimensions of the data you want to access and the necessary nx, ny and nz arguments should be passed.
Number of dimensions [N] | nx, ny & nz required |
1 | nx |
2 | nx & ny |
3 | nx, ny & nz |
The ordering of array dimensions is different in C to Fortran, so for instance the Fortran array ARRAY(NX,NY,NZ) is equivalent to the C array ARRAY[NZ][NY][NX], but usually this is of little importance since images are not of fixed sizes (so you're unlikely to hard code any array dimensions) and you're far more likely to use the data via a pointer to the first element. Since C arrays also always start at 0 (rather than 1 as is the default in Fortran) the index of an element say [y][x] is nx x y + x. In 3-D this becomes [z][y][x] -- nx x ny x z + nx x y + x.
The data type of the image is specified by replacing the [X] part of the name by one of the following character codes:
Character code [X] | C data type (TYPE) | Description |
F | float | |
D | double | |
I | int | |
S | short | |
US | unsigned short | |
B | signed char | Signed byte |
UB | unsigned char | Unsigned byte |
IMG Simple Image Data Access