read_movie_byu

Synopsis

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

Parameters

The following lists all of the parameters found in the parameter block ReadMovieBYUParams, which are accessed by the module ReadMovieBYUFile and the UI Macro ReadMovieBYUUI.

Name Type Description UI Control

filename string BYU file to be read 'Read MOVIE-BYU File Name'

Output Ports

Name Type Description

out Mesh+Cell_Data+Node_Data field data representing the BYU model.
obj DataObject directly renderable output object.

Description

read_movie_byu reads in a BYU data file and generates both field data and renderable Data Objects 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. The BYU file to read can be specified through a simple user interface.

Parameters

filename

A member of the ReadMovieBYUParams parameter block group, this string value is used to specify the name of the BYU file that should be loaded.

Output Ports

out

The most primitive output field of the read_movie_byu macro. This contains the model read from the BYU file represented as field data.

obj

The directly renderable output field of the read_movie_byu macro. This contains a DataObject object that can be rendered by the standard data viewers. The Data Object is generated directly from the field data created from the BYU file.

Utility Macros

The low-level ReadMovieBYUFile module is used in this User Macro read_movie_byu.

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/rdmbmacs.v contains the read_movie_byu User Macro, the ReadMovieBYU Functional Macro, the ReadMovieBYUUI UI Macro, and the example application ReadMovieBYUEg V definitions. The file also contains several other macro definitions.

Other Notes

The ReadMovieBYUMacs library inherits its process. As this library contains no procedural code, the process is not important. The low-level ReadMovieBYUFile module, executes under the process specified in its library, not the process defined in the high-level library.

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 and ReadMovieBYUFile.