Reads in an offset file and constructs a 1 dimensional array of floating point numbers from it.
module ReadMovieOffsetFile <src_file="rdmovoff.c"> {
string &filename <NEportLevels={2,0}>;
int+read+write+nonotify size;
float+Oparam out[];
omethod+notify_val+notify_inst read_off_update <status=1>
= "read_off_update";
};
ReadMovieOffsetFile reads in an offset file and generates an array of floating point numbers from it. The offset file is an ASCII file which should consist of a series of 3D vectors that represent the offset to be applied to the respective coordinate in the field data constructed from the BYU data. The file format can be seen in the supplied example files, cube001 to cube008.
&filename
Name of the offset file to be loaded. The parameter is of type string.
out
The output field containing a 1 dimensional array of floating point offsets. The vector offsets are placed sequentially into the array, therefore the first values would by x1,y1,z1, x2,y2,z2 and so on. This array can be converted into a 2D array of vectors by using the ReadMovieBYUFltToCoord module or the ReadMovieBYUApplyOffset module can be used to apply the offsets in the 1D array directly to a set of field data.
The low-level ReadMovieOffsetFile module is used in the Functional Macros ReadMovieOffset and ReadMovieOffsets and the User Macros read_movie_offset, read_movie_offsets and read_movie_animate.
An example application ReadMovieBYUEg is provided, which uses the read_movie_byu macro to load a BYU file that is then animated by the read_movie_animate macro.
iac_proj/rdmovbyu/rdmbmods.v contains the ReadMovieOffsetFile module V definition. The file also contains several other module definitions.
The low-level ReadMovieBYUMods library containing the module ReadMovieOffsetFile does not specify a process. By default the express process will be used.
Ian Curington Paul G. Lever Andrew Dodd
International AVS Centre Manchester Visualization Centre Manchester Computing University of Manchester Oxford Road Manchester United Kingdom M13 9PL
ReadMovieOffsetUI, ReadMovieOffset, read_movie_offset