|
Purpose
|
Writes the RIS8 for the image as the first image in the file, overwriting any information previously in the file. |
|
Return value
|
Returns SUCCEED (or 0) if successful and FAIL (or -1) otherwise. |
|
Description
|
The compress parameter identifies the method to be used for compressing the data, if any. If IMCOMP compression is used, the image must include a palette. |
|
|
DFR8putimage overwrites any information that exists in the HDF file. To write an image to a file by appending it, rather than overwriting it, use DFR8addimage.
|
|
|
In FORTRAN-77, the dimensions of the image array must be the same as the dimensions of the image itself. |
|
|
The order in which dimensions are declared is different between C and FORTRAN-77. Ordering varies because FORTRAN-77 arrays are stored in column-major order, while C arrays are stored in row-major order. (Row-major order implies that the horizontal coordinate varies fastest). When DFR8putimage writes an image to a file, it assumes row-major order. The FORTRAN-77 declaration that causes an image to be stored in this way must have the width as its first dimension and the height as its second dimension, the reverse of the way it is done in C. To take this into account as you build your image in your FORTRAN-77 program, the image must be built "on its side". |