User Macro Document - texture_wave_field

<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">P0099</th> <th nowrap width="98%">TextureWave</th> <th nowrap width="1%">14th June 2000</th> </tr> <tr> <td align="left" colspan="3"> <p><b>Authors:</b> Ian Curington, AVS Inc.; Andrew Dodd, IAC <b>Version:</b> 1.0 <b>Path:</b> iac_proj/twave/</p> <a href="../../filters.shtml" target="_top"><img src="../../../../img/filter.gif" width="44" height="30" border="0" alt="Filter"></a> <a href="twave.shtml" target="_top"> <img src="../../../../img/doc_umac.gif" border="0" width="30" height="30" alt="User Macro Document - texture_wave"></a> <a href="twavefld.shtml" target="_top"> <img src="../../../../img/doc_umac.gif" border="0" width="30" height="30" alt="User Macro Document - texture_wave_field"></a> <a href="source/filters/twave/twave.tar.gz"> <img src="../../../../img/targz.gif" border="0" width="52" height="30" alt="Archive - twave.tar.gz"></a> <a href="source/filters/twave/twave.tar.Z"> <img src="../../../../img/tarz.gif" border="0" width="52" height="30" alt="Archive - twave.tar.Z"></a> <a href="source/filters/twave/twave.zip"> <img src="../../../../img/zip.gif" border="0" width="52" height="30" alt="Archive - twave.zip"></a> <a href="image_twave.shtml" target="_top"> <img src="../../../../img/image.gif" border="0" width="42" height="30" alt="Example Image"></a> <a href="../scl2tex/doc_umac.shtml" target="_top"> <img src="../../../../img/prereq.gif" width="30" border="0" height="30" alt="Pre-requisite - Filter - Scalar2Texture"></a> </td> </tr> </table> <br> </td> </tr> <tr> <td>  <h1>texture_wave</h1> <h3>Synopsis</h3> <p>The texture_wave_field macro applies a texture with a moving wave function in the alpha channel to a field.</p> <h4>Input Ports</h4> <table class="parameters" summary="Input Ports used by texture_wave_field"> <tr> <td width="100"><b>Name</b></td> <td width="75"><b>Type</b></td> <td width="425"><b>Description</b></td> </tr> <tr> <td colspan="4"><hr></td> </tr> <tr> <td width="100"><i>in_fld</i></td> <td width="75">Field</td> <td width="425">Data that is to be textured.</td> </tr> <tr> <td width="100"><i>in_image</i></td> <td width="75">Image_ARGB</td> <td width="425">Image that is to be used for texturing.</td> </tr> <tr> <td colspan="4"><hr></td> </tr> </table> <h4>Parameters</h4> <p>The texture_wave_field macro does not have any parameters of its own. Please see the <a href="twave.shtml" target="_top">texture_wave</a> documentation for a full description of the parameters of that macro.</p> <h4>Output Ports</h4> <table class="parameters" summary="Output Ports used by texture_wave_field"> <tr> <td width="100"><b>Name</b></td> <td width="75"><b>Type</b></td> <td width="425"><b>Description</b></td> </tr> <tr> <td colspan="4"><hr></td> </tr> <tr> <td width="100"><i>out_fld</i></td> <td width="75">Field</td> <td width="425">Field data with generated UV coordinates.</td> </tr> <tr> <td width="100"><i>out_image</i></td> <td width="75">Image_ARGB</td> <td width="425">Image with generated pulse function.</td> </tr> <tr> <td width="100"><i>out_obj</i></td> <td width="75">GDobject</td> <td width="425">Directly renderable output object with alpha blended texture mapping.</td> </tr> <tr> <td colspan="4"><hr></td> </tr> </table> <h3>Description</h3> <p>The texture_wave_field macro generates a pulse-wave function in the alpha channel of an existing ARGB image field and applies it to the input field data. It does this by combining two macros. The <a href="twave.shtml" target="_top">texture_wave</a> macro is used to generate a pulse-wave function and insert it into the alpha channel of an existing image. The <a href="../scl2tex/doc_umac.shtml" target="_top">Scalar2Texture</a> macro is used to generate UV coordinate data from scalar node data and apply the generated texture to the input field data. This results in three outputs; the image with generated pulse-wave function, the field data with generated UV coordinate data and a renderable GDobject that contains the field data and texture image. The renderable GDobject is the output that should normally be used.</p> <p>By using this module to apply an alpha blended texture to existing field data a number of very interesting visualizations can be seen that cannot be easily achieved by other means. Animating the textures can lead to further visualizations. However it should be noted that animating textures on complex fields is a graphically intensive task and for decent results good hardware texture-mapping support is essential.</p> <p>A conference paper fully describing this technique can be obtained by contacting <a href="mailto:ianc@avs.com">Ian Curington</a>; the original author of this project.</p> <h3>Inputs</h3> <p><b><i>in_fld</i></b></p> <p>Input field data that is be to be textured. The field data should contain a mesh and one component of scalar node data. The node data is to generate UV texture coordinates so that the field can be correctly textured. If other node data components are present they will be ignored.</p> <p><b><i>in_image</i></b> : Image_ARGB</p> <p>Original image data that is to be used as the basis of the pulse-wave image. The field data should contain a 2D structured mesh with a 4 byte vector of node data containing the Alpha, Red, Green and Blue components of the image. This is the field format output by modules such as read_image. Any data present in the alpha channel is completely replaced by the generated wave function.</p> <h3>Parameters</h3> <p>The texture_wave_field macro does not make use of any parameters. A full description of all the <a href="twave.shtml" target="_top">texture_wave</a> parameters can be found in the documentation for that module. </p> <h3>Outputs</h3> <p><b><i>out_fld</i></b></p> <p>Output field containing the input mesh data and the generated node data containing UV texture coordinates. This output does not contain the generated texture data.</p> <p><b><i>out_image</i></b> : Image_ARGB</p> <p>Output image containing the texture image with the generated pulse-wave stored in the alpha channel. The image is output as a field with a 2D structured mesh and a 4 byte vector of node data containing the ARGB components of the image.</p> <p><b><i>out_obj</i></b></p> <p>GDobject that contains the field data and the generated texture image. This output is suitable for direct connection to the viewer. As alpha blending is enabled for this GDobject the effect of the pulse wave function should be visible.</p> <h3>Utility Macros</h3> <p> The texture_wave_field user macro uses the <a href="twave.shtml" target="_top">texture_wave</a> and <a href="../scl2tex/doc_umac.shtml" target="_top">Scalar2Texture</a> user macros. </p> <h3>Example</h3> <p>The project includes two example applications that demonstrates the use of the texture_wave_field macro. The TextureWaveEg3 application uses the texture_wave_field macro to apply a texture to a dataset representing Mt. Helens. The texture pulses should be visible as strips of colour. The animation facility can be used to move these strips of colour. The TextureWaveEg4 application loads a dataset representing the air movement in a room, generates streamlines and uses the texture_wave_field macro to apply texturing to the streamlines.</p> <p>It should be noted that both of these examples use complex datasets and hence the rendering performance is likely to be low unless good hardware texturing support is available</p> <h3>Files</h3> <p><i>iac_proj/twave/tw_mods.v</i> contains the V definitions of the TextureWaveCore module and the TextureWaveParams parameter block.</p> <p><i>iac_proj/twave/tw_macs.v</i> contains the V definitions of the TextureWaveUI UI macro, the TextureWaveFunc functional macro and the texture_wave and texture_wave_field user macros.</p> <p><i>iac_proj/twave/tw_apps.v</i> contains the V definitions of the TextureWaveEg1, TextureWaveEg2, TextureWaveEg3 and TextureWaveEg4 example applications.</p> <h3>Prerequisites</h3> <p>The texture_wave_field user macro and example applications rely on the successful installation of the following component. Without them it will not function correctly. All other macros in this project will function correctly.</p> <ul> <li><a href="../scl2tex/doc_umac.shtml" target="_top">Scalar2Texture</a> Project</li> </ul> <h3>Other Notes</h3> <p>The low-level TextureWaveMods library containing the low-level TextureWaveCore module does not specify a process. By default the <tt>express</tt> process will be used.</p> <h3>Author</h3> <p> <pre> Ian Curington, Advanced Visual Systems, Inc. </pre> </p> <h3>Modifications</h3> <p> <pre> Andrew Dodd, International AVS Centre </pre> </p> <h3>Contact</h3> <p> <pre> International AVS Centre Manchester Visualization Centre Manchester Computing University of Manchester Oxford Road Manchester United Kingdom M13 9PL </pre> </p> <h3>See Also</h3> <ul> <li><a href="twave.shtml" target="_top">texture_wave</a> IAC module</li> <li><a href="../scl2tex/doc_umac.shtml" target="_top">Scalar2Texture</a> IAC project</li> <li>Contact the author for a full conference paper describing this technique.</li> </ul>  </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:  26th November 2002 </td> </tr> </table>