ReadPolygon

Synopsis

Reads a polygon format geometry files and creates mesh output.

Parameters

Name Type Description UI Control

filename string Name of poly file to read. File Dialog

Output Ports

Name Type Description

out 3D Mesh and node data Geometry data read from file.
obj DefaultObject Directly Renderable Output Object.

Description

The ReadPolygon user macro reads polygon format data from the specified ASCII file and outputs a mesh based on the data read. A poly file contains multiple cell sets, each set contains the number of vertices, the coordinates of each node, the colour, the number of connections and the connectivity data.

The data read by the ReadPolygon module is stored as a coordinate array and several cell sets. This data is mapped to a mesh using either triangle faces or quad faces, usually triangular. The type of face used is specified in the polygon file. The colour data stored in the polygon file is output as Node_Data.

Parameters

filename

String parameter that contains the name of the polygon file that should be read.

Outputs

out

Mesh+Node_Data output that contains the geometry data read from the polygon file with the colour information stored as Node_Data. The output consists of the nodal coordinates and multiple cell sets describing the data read.

obj

The directly renderable output of the ReadPolygon macro. This output contains the geometry data read from the polygon file in a form that can be rendered by the standard data viewers.

Utility Macros

The ReadPolygonFunc functional macro uses the ReadPolygonCore low-level module. The ReadPolygon user macro uses this functional macro and the ReadPolygonUI user interface macro.

Example

An example application is included named ReadPolygonEg, this should quickly allow a user to check that the ReadPolygon Macro works.

Files

iac_proj/rd_poly/rdp_mods.v contains the V definition of the ReadPolygonCore module.

iac_proj/rd_poly/rdp_macs.v contains the V definitions of the ReadPolygonUI UI macro, the ReadPolygonFunc functional macro and the ReadPolygon user macro.

iac_proj/rd_poly/rdp_apps.v contains the V definition of the ReadPolygonEg example application.

Other Notes

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

Author

Jonathan F Harden,
Manchester Visualization Centre

Modifications

Tobias Schiebeck
Manchester Visualization Centre

Contact

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