DVread_polygon

Synopsis

reads in polygon-oriented CAD/CAM geometry formats such as OBJ, PLY, and VTK

module DVread_polygon {
string+Iparam filename;
// cell data sometimes ... depends on file.
Mesh+Space3+Oparam outFld {
Polyhedron+Cell_Data_Set_Poly cell_set[ncell_sets];
};
omethod+notify_val+notify_inst update<status=1> =
"DVread_polygon_update";
};

Description

DVread_polygon reads in files in OBJ, PLY or VTK format and out puts the data in a mesh.
An OBJ file is a Wavefront Advanced Visualizer Object File. This reader accepts a subset of the OBJ format. It processes v, f, and g commands. It can also process usemtl and mtllib commands, but only uses the diffuse color ('Kd'). DVread_polygon can read f commands that include normal and texture information, but the normal/texture information is not used.

PLY represents a Stanford Polygon File. This reader accepts a subset of the PLY format. The files must be ASCII format and it only understands basic properties such as vertex x,y,z and face vertex indicies.

DVread_polygon reads ASCII VTK (Visualization ToolKit) files, with the following restrictions. The dataset must be either POLYDATA or UNSTRUCTURED_GRID. If its a POLYDATA dataset, then the points must be followed by either LINES or POLYGONS. The POINTS must be broken up into lines no longer than 1024 characters each. The face index information for each line or polygon must be on a single line (usually the case but not always). If its a UNSTRUCTURED_GRID dataset, then only cells of type line, tri, polygon, pixel, and quad.

Input

filename

A string. Names the input file to be read.

Output

outFld

The output mesh.

Example

File

v/dv.v

See also

DVread_triangle