ReadMovieBYUFile

Synopsis

Reads in a BYU file and constructs field data from it.


  module ReadMovieBYUFile <src_file="rdmovbyu.c"> {
    ReadMovieBYUParams &ReadMovieBYUParams <NEportLevels={2,0}>;
    string filename => ReadMovieBYUParams.filename;
    Mesh+Cell_Data+Node_Data+Oparam out;
    omethod+notify_val+notify_inst read_byu_update <status=1>
        = "read_byu_update";
  };

Description

ReadMovieBYUFile reads in a BYU data file and generates field data from the information contained in the file. The BYU file format was created by the Brigham Young University and contains the information necessary for reconstructing one or more surfaces consisting of 3-D polygons.

Inputs

&ReadMovieBYUParams

Reference to the parameter block, which contains real instances of the parameters for the ReadMovieBYUFile function.

filename

Name of the BYU file to be loaded. The parameter is of type string. Normally the value of this parameter is found by referring to the parameter block, which is referenced by the &ReadMovieBYUParams input.

Outputs

out

The output field containing field data constructed from the data present in the BYU file.

Utility Macros

The low-level ReadMovieBYUFile module is used in the Functional Macro ReadMovieBYU and the User Macro read_movie_byu. Additionally, this macro also uses the ReadMovieBYUParams parameter block group object, as does the ReadMovieBYUUI UI Macro.

Example

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.

Files

iac_proj/rdmovbyu/rdmbmods.v contains the ReadMovieBYUParams group and the ReadMovieBYUFile module V definitions. The file also contains several other module definitions.

Other Notes

The low-level ReadMovieBYUMods library containing the module ReadMovieBYUFile does not specify a process. By default the express process will be used.

Authors

Ian Curington
Paul G. Lever
Andrew Dodd

Contact

International AVS Centre
Manchester Visualization Centre
Manchester Computing
University of Manchester
Oxford Road
Manchester
United Kingdom
M13 9PL

See Also

ReadMovieBYUParams, ReadMovieBYUUI, ReadMovieBYU, read_movie_byu