source files: xmri.[ch] ge.[ch]
(XMRI-READ-VOXEL-SLICE :FILENAME <string:filename> [ :RESULT-IN <grl:voxels> ] [ :SLICE <fix:slice> ] [ :SUBSAMPLE-BY <fix:factor> ] )
'filename' should be of a GE-format MRI/CAT image file.
If 'voxels' is supplied and is a rank-three cubical CLASS-16-BIT-FLOAT-ARRAY instance congruent with the image file (for example, the image file will typically be 256x256, and the array (256 256 256) or a graphic relation holding such an array named :INTENSITY, the slice will be stored in that array, else a new array will be created and the result returned in it.
'slice' should be an integer in [0,N), indicating where in 'voxels' the input data should be stored.
If :SUBSAMPLE-BY is provided, the result image will be shrunk correspondingly. Currently, the only value supported is '2', which results in a 256x256 image loading as 128x128. (This can be useful to speed computations during software development or experimental data massaging.)
This function will fill voxels ('slice' * *) of the array with image data from the given file.
Return value is the 'voxels' array/relation in which the slice was actually stored.