Documentation

Reads an image from a file and returns an image descriptor or NULL if
reading failed.
Reads from stdin if image name is NULL. If the image is vectorial, it is uninterlaced, i.e. the image data field points to a xdim * ydim * zdim * vdim buffer containing voxels in order:

(V1, Z1, Y1, X1) (V1, Z1, Y1, X2), ... , (V1, Z1, Y1, Xn),
(V1, Z1, Y2, X1) ...         ...       , (V1, Z1, Y2, Xn),
...
(V1, Z1, Ym, X1) ...         ...       , (V1, Z1, Ym, Xn),
(V1, Z2, Y1, X1) ...         ...       , (V1, Z2, Y1, Xn),
...
(V2, Z1, Y1, X1) ...         ...       , (V2, Z1, Y1, Xn),
...
...         ...       , (Vt, Zl, Ym, Xn)

Parameters:

name - image file name or NULL