User Macro Document - AnimatedImageGenerator

<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">P0200</th> <th nowrap width="98%">AnimatedImageGenerator</th> <th nowrap width="1%">27th September 2002</th> </tr> <tr> <td align="left" colspan="3"> <p><b>Authors:</b> Ian Curington, AVS Inc.;Tobias Schiebeck,MVC <b>Version:</b> 1.0 <b>Path:</b> iac_proj/gen_anim/</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="gen_anim.shtml" target="_top"> <img src="../../../../img/doc_umac.gif" border="0" width="30" height="30" alt="User Macro Document - AnimatedImageGenerator"></a> <a href="source/data_io/gen_anim/gen_anim.tar.gz"> <img src="../../../../img/targz.gif" border="0" width="52" height="30" alt="Archive - gen_anim.tar.gz"></a> <a href="source/data_io/gen_anim/gen_anim.tar.Z"> <img src="../../../../img/tarz.gif" border="0" width="52" height="30" alt="Archive - gen_anim.tar.Z"></a> <a href="source/data_io/gen_anim/gen_anim.zip"> <img src="../../../../img/zip.gif" border="0" width="52" height="30" alt="Archive - gen_anim.zip"></a> <img src="../../../../img/note.gif" width="15" height="30" alt="Developer Edition Only"> </td> </tr> </table> <br> </td> </tr> <tr> <td>  <h1>AnimatedImageGenerator</h1> <h3>Synopsis</h3> <p>The AnimatedImageGenerator writes a sequence of images on every view refresh, either from the network of modules generating new content, or mouse interaction with the window. </p> <h4>Input Ports</h4> <table class="parameters" summary="Input Ports used by the AnimatedImageGenerator"> <tr> <td width="100"><b>Name</b></td> <td width="75"><b>Type</b></td> <td width="400"><b>Description</b></td> </tr> <tr> <td colspan="3"><hr></td> </tr> <tr> <td width="100"><i>view_in</i></td> <td width="75">DefaultView</td> <td width="400">Output from the Viewer.</td> </tr> <tr> <td colspan="3"><hr></td> </tr> </table> <h4>Parameters</h4> <table class="parameters" summary="Parameters used by AnimatedImageGenerator"> <tr> <td width="100"><b>Name</b></td> <td width="75"><b>Type</b></td> <td width="300"><b>Description</b></td> <td width="100"><b>UI control</b></td> </tr> <tr> <td colspan="4"><hr></td> </tr> <tr> <td width="100"><i>Prefix</i></td> <td width="75">string</td> <td width="300">Prefix for the filename (text before the sequence number)</td> <td width="100">TextField</td> </tr> <tr> <td width="100"><i>Extension</i></td> <td width="75">string</td> <td width="300">Filename extension (text after the sequence number)</td> <td width="100">TextField</td> </tr> <tr> <td width="100"><i>Reset Counter</i></td> <td width="75">string</td> <td width="300">Resets the counter for the sequence number</td> <td width="100">Button</td> </tr> <tr> <td colspan="4"><hr></td> </tr> <tr> <td colspan="4">The remaining parameters are identical to the parameters given to Write Image.</td> </tr> <tr> <td colspan="4"><hr></td> </tr> </table> <h3>Description</h3> <p>The AnimatedImageGenerator macro connects to a Viewer, and writes a sequence of images. The images are written whenever the Viewer refreshes. The refresh can be either from the network of modules connected to the viewer generating new content, or due to mouse interaction with the viewer window.</p> <p>The images are numbered automatically in a sequence incrementing the number by 1 on each update. A prefix and postfix string can be provided to generate meaningful images names. The output images can be used to create an animation using external programs.</p> <p>The AnimatedImageGenerator macro uses lower-level parts only available in the Developer Edition.</p> <h3>Inputs</h3> <p><b><i>view_in</i></b></p> <p>The View that is provided by the Viewer macro. Whenever the Viewer updates its output this input is modified and written to a file.</p> <h3>Parameters</h3> <p><b><i>Prefix</i></b></p> <p>This string parameter is the beginning of each of the output filenames for the images. This is the part of the filename which comes before the seuqence number.</p> <p><b><i>Extension</i></b></p> <p>This string parameter is the end of each of the output filenames for the images. This contains the file extension for each image. </p> <p><b><i>Reset Counter</i></b></p> <p>This toggle resets the counter used as the sequence number for the filenames.</p> <p> The remaining parameters are identical to the parameters given to Write Image. </p> <h3>Example</h3> <p>The AnimatedImageGeneratorEg example application reads in the Hydrogen field, creates an isosurface uses AnimatedImageGenerator to create animation images.</p> <h3>Files</h3> <p><i>iac_proj/gen_anim/ganimmac.v</i> Creates the AnimatedImageGeneratorMacs library containing the high-level user macros AnimatedImageGenerator.</p> <p><i>iac_proj/gen_anim/ganimapp.v</i> Creates the AnimatedImageGeneratorApps library containing the example application AnimatedImageGeneratorEg.</p> <h3>Prerequisites</h3> <p> This project requires the following components to be installed correctly. Without these components the user level macros will not work correctly. <ul> <li>AVS/Express Developer's Edition</li> </ul> </p> <h3>Other Notes</h3> <p>This reader does not use external C or C++ code.</p> <p>The high level macros use DV low level objects, and hence these macros require a license for the AVS/Express Developer Edition. </p> <h3>Authors</h3> <p> <pre> Ian Curington Advanced Visual Systems, Inc. </pre> </p> <h3>Modifications</h3> <p> <pre> Tobias Schiebeck Manchester Visualization 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>  </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>