<![CDATA[
<table cellspacing="0" cellpadding="0">
<tr height="150">
<td align="left"><img src="../../../../img/logo.gif" alt="IAC logo"></img></td>
<td width="100%" rowspan="2" align="left" valign="center">
<table cellspacing="0" cellpadding="0">
<tr>
<td>
<table class="navigate_doc" width="100%" border="0" align="center">
<tr bgcolor="c6c6e0" align="center">
<th nowrap width="1%" height="32">P0020</th>
<th nowrap width="98%">ReadGocad</th>
<th nowrap width="1%">10th June 1998</th>
</tr>
<tr>
<td align="left" colspan="3">
<p><b>Author:</b> Justin Greenhalgh and Federico Gamba
<b>Version:</b> 1.1
<b>Path:</b> iac_proj/rdgocad/</p>
<a href="../../data_io.shtml" target="_top"><img src="../../../../img/data_io.gif" width="60" height="30" border="0" alt="Data IO"></a>
<a href="doc_mod.shtml" target="_top">
<img src="../../../../img/doc_mod.gif" border="0"
width="30" height="30"
alt="Module Document - ReadGocad"></a>
<a href="doc_umac.shtml" target="_top">
<img src="../../../../img/doc_umac.gif" border="0"
width="30" height="30"
alt="User Macro Document - read_gocad"></a>
<a href="source/data_io/rdgocad/rdgocad.tar.gz">
<img src="../../../../img/targz.gif"
border="0" width="52" height="30"
alt="Archive - rdgocad.tar.gz"></a>
<a href="source/data_io/rdgocad/rdgocad.tar.Z">
<img src="../../../../img/tarz.gif"
border="0" width="52" height="30"
alt="Archive - rdgocad.tar.Z"></a>
<a href="source/data_io/rdgocad/rdgocad.zip">
<img src="../../../../img/zip.gif"
border="0" width="52" height="30"
alt="Archive - rdgocad.zip"></a>
</td>
</tr>
</table>
<br>
</td>
</tr>
<tr>
<td>
<!-- BEGIN CONTENT PAGE -->
<h1>ReadGOCAD</h1>
<h3>Synopsis</h3>
<p>
Reads GOCAD files and re-scales the data along the x, y and z axis.
</p>
<p>
<hr>
<pre>
module ReadGOCAD <src_file="gocad.cxx",
libdeps="FLD",
cxx_hdr_files="fld/Xfld.h">
{
GocadParams &group_ref<NEportLevels={2,0},export=2>;
boolean scale<export=2> => group_ref.scale;
string file_name<export=2> => group_ref.file_name;
float x<export=2> => group_ref.x;
float y<export=2> => group_ref.y;
float z<export=2> => group_ref.z;
Grid Grid<export=2> {
nspace = 3;
coordinates {
min => ;
max => ;
};
};
Cells Cells<export=2> {
ncell_sets = 1;
cell_set = {
{ cell_nnodes=3,poly_flag=0,cell_order=1,cell_ndim=2 }
};
};
Xform Xform<export=2>;
Mesh &Mesh<NEportLevels={0,2},export=2> => merge(.Grid,.Cells,.Xform);
cxxmethod+notify_inst+req update<export=2>(
Grid+write,
Cells+write,
scale+read+notify+req,
x+read+notify+req,
y+read+notify+req,
z+read+notify+req,
file_name+read+notify+req
);
};
</pre>
<hr>
</p>
<h3>Description</h3>
<p>
ReadGOCAD reads the contents of one GOCAD file, and converts this to a Mesh
(Xform+Cells+Grid), suitable for input into a DataObject module. The module
ignores all other lines from the GOCAD file except for vertices and triangles.
It scans each line for the appropriate keywords. If the the line contains
"VRTX", then it reads the id, and the position x, y, z. If the line contains
"TRGL", it reads three index numbers for which set of vertices to tie together
as a triangle. Axis specific scaling is achievable by using the floating point
parameters x,y and z.
</p>
<h3>Inputs</h3>
<p>
<i><b>&group_ref</b></i>
</p>
<p>
Reference to the GocadParams parameter block.
</p>
<h3>Outputs</h3>
<p>
<i><b>Mesh (Xform+Cells+Grid)</b></i>
</p>
<p>
The output field contains scaled/not scaled data, suitable for input into a
DataObject. This can be viewed using either a 2D or 3D Uviewer.
</p>
<h3>Utility Macros</h3>
<p>
The low-level ReadGOCAD is used in the Functional Macro Gocad and the User Macro
<a href="doc_umac.shtml" target="_top">read_gocad</a>. Additionally, these macros also use the
GocadParams parameter block group object, as does the GocadUI UI Macro.
</p>
<h3>Example</h3>
<p>
An example application ReadGocadEg is provided, which uses the sample data file
worldmap.tsurf, to display a picture of the world.
</p>
<h3>Files</h3>
<p>
<I>iac_proj/rdgocad/goc_mods.v</I> contains the GocadParams group and the
ReadGocad module V definitions.
</p>
<h3>Other Notes</h3>
<p>
By default the low-level library GocadMods, inherits its process as
<tt>express</tt>. See the README file for details.
</p>
<h3>Authors</h3>
<p>
<pre>
AVS5 version
Ian Curington, AVS/UNIRAS Ltd.
Ported to AVS/Express by
Justin Greenhalgh
Manchester Visualization Centre
Manchester Computing
University of Manchester
Oxford Road
Manchester
UK
M13 9PL
</pre>
</p>
<h3>See Also</h3>
<p>
GocadParams, Gocad, GocadUI and <a href="doc_umac.shtml" target="_top">read_gocad</a>.
</p>
<!-- END CONTENT PAGE -->
</td>
</tr>
</table>
</td>
</tr>
<tr height="100%">
<td class="sideLink" width="25%" align="left" valign="top" nowrap="nowrap">
<p><a href="../../../../general/index.shtml" target="_top">General Information</a></p>
<p><a href="../../../../repository/index.shtml" target="_top">Repositories</a></p>
<p class="sideLinkLevel2"><a href="../../../new/index.shtml" target="_top"> New Releases</a></p>
<p class="sideLinkLevel2"><a href="../../../download/index.shtml" target="_top"> Download</a></p>
<p class="sideLinkLevel2"><a href="../../../submit/index.shtml" target="_top"> Submit</a></p>
<p class="sideLinkLevel2"><a href="../../../pfiles/index.shtml" target="_top"> Project Files</a></p>
<p class="sideLinkLevel2"><a href="../../../avs5/index.shtml" target="_top"> AVS5</a></p>
<p class="sideLinkLevel2"><a href="../../../express/index.shtml" target="_top"> AVS/Express</a></p>
<p class="sideLinkLevel3"><a href="../../atoz.shtml" target="_top"> A to Z</a></p>
<p class="sideLinkLevel3"><a href="../../number.shtml" target="_top"> Project #</a></p>
<p></p>
<p class="sideLinkLevel3"><a href="../../data_io.shtml" target="_top"> Data IO</a></p>
<p class="sideLinkLevel3"><a href="../../filters.shtml" target="_top"> Filters</a></p>
<p class="sideLinkLevel3"><a href="../../mappers.shtml" target="_top"> Mappers</a></p>
<p class="sideLinkLevel3"><a href="../../misc.shtml" target="_top"> Miscellaneous</a></p>
<p class="sideLinkLevel3"><a href="../../special.shtml" target="_top"> Special Projects</a></p>
<p class="sideLinkLevel2"><a href="../../../pog/index.shtml" target="_top"> Project Guidelines</a></p>
<p><a href="../../../../usergroup/index.shtml" target="_top">User Group</a></p>
<p><a href="../../../../training/index.shtml" target="_top">Training Materials</a></p>
</td>
</tr>
</table>
<table width="100%" border="0" cellspacing="0" cellpadding="0" bgcolor="c6c6e0">
<tr>
<td><img src="../../../../img/foot1.gif" alt="IAC" width="155" height="25"></td>
<td width="100%"> Last Updated:
<!-- #BeginEditable "date-stamp" -->
26th November 2002
<!-- #EndEditable --></td>
</tr>
</table>
]]>