IAC Project Files

<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 width="100%" border="0" cellspacing="0" cellpadding="0" bgcolor="c6c6e0" height="32"> <tr align="center" valign="center"> <td> <font face="Verdana, Arial, Helvetica, sans-serif" size="4">IAC Project Files</font></td> </tr> </table>  <br> <table border="0" cellspacing="5" cellpadding="0" align="center"> <tr> <td><img src="../../img/spot1.gif" alt="" width="8" height="8"></td> <td nowrap><font face="Verdana, Arial, Helvetica, sans-serif" size="3"><b>New Version </b></font></td> <td><img src="../../img/spot1.gif" alt="" width="8" height="8"></td> </tr> </table> <br> <p>As of 28th March 2002 the IAC Project Files have been updated to Version 3.0. The general description and installation instructions below still apply. The changes made include the addition of an install program install.exe for MS Windows and a shell script (/bin/sh) install.sh for UNIX that allow an automatic installation of IAC Modules. This allows an easy installation of multiple modules at one time. Both the windows binary and the UNIX shell script do not remove installed modules or install an already installed module again. </p> <p>As of 16th July 1999 the IAC Project Files have been updated to Version 2.0. The general description and installation instructions below still apply. The changes made include the addition of two new <b>IAC</b> library page sub-libraries, namely <b>GLYPHS</b> and <b>COMMON</b>, and the removal of the unused <b>OUTPUT</b> library. The <a href="../express/misc.shtml#common" target="_top">Common</a> project in the repository now places its objects under the new COMMON library heading, rather than under MISC. Similarly the <a href="../express/misc.shtml#gly_lib" target="_top">GlyphLibrary</a> project now places its objects under the GLYPH library heading. Please note however that these two projects, which are frequently updated, are still found in the Miscellaneous category of the AVS/Express repository.</p> <p>Other minor changes include ensuring that library object references now use the original path and name to an object in the <b>IAC_PROJ</b> library structure, rather than to named objects in the IAC library page. Previously it was not possible to use an existing macro from the IAC library page in a new project for the IAC without performing some manual editing of the path and name.</p> <p><b>Note</b>: Exisiting users of the IAC repository should update their current IAC projects files to the new version, however care must be taken. Once downloaded, the new IAC project files should be unpacked to an empty directory, so as not to destroy any existing user projects! Please read the notes below about <a href="#upgrade">Upgrading</a> to Version 2.0.</p> <br> <table border="0" cellspacing="5" cellpadding="0" align="center"> <tr> <td><img src="../../img/spot1.gif" alt="" width="8" height="8"></td> <td nowrap><font face="Verdana, Arial, Helvetica, sans-serif" size="3"><b>Project Integration </b></font></td> <td><img src="../../img/spot1.gif" alt="" width="8" height="8"></td> </tr> </table> <br> <p>The integration of AVS/Express projects (modules, macros and other objects) with your own has been simplified with the introduction of IAC Project Files. Once these files have been downloaded and setup, individual projects from the AVS/Express repository may be downloaded and added easily. Read the <a href="../pog/index.shtml" target="_top">Project Organization Guidelines</a> for a more detailed description of how the IAC Project Files work.</p> <p> The IAC Project Files simply enforces an organization on the storage and usage of any downloaded projects from the IAC, making it easier to add them, and simplifying maintenance of the sensitive Express files, such as <tt>v/templ.v</tt>.</p> <br> <table border="0" cellspacing="5" cellpadding="0" align="center"> <tr> <td><img src="../../img/spot1.gif" alt="" width="8" height="8"></td> <td nowrap><font face="Verdana, Arial, Helvetica, sans-serif" size="3"><b>Setup</b></font></td> <td><img src="../../img/spot1.gif" alt="" width="8" height="8"></td> </tr> </table> <br> <p>Download the IAC Project Files:</p> <ul> <li>in <a href="../pfiles/iac.tar.gz"><b>tar.gz</b></a>, <a href="../pfiles/iac.tar.Z"><b>tar.Z</b></a> or <a href="../pfiles/iac.zip"><b>zip</b></a> format.</li> </ul> <p>Unpack the IAC Project Files by:</p> <p><b>UNIX (iac.tar.Z)</b></p> <ul> <li><code>uncompress iac.tar.Z</code></li> <li><code>tar xvf iac.tar</code></li> </ul> <p><b>UNIX (iac.tar.gz)</b></p> <ul> <li><code>gunzip iac.tar.gz</code></li> <li><code>tar xvf iac.tar</code></li> </ul> <p><b>UNIX (iac.zip)</b></p> <ul> <li><code>unzip iac.zip</code><code></code></li> </ul> <p><b>WINDOWS (all formats)</b></p> <ul> <li>Load the archive into the Winzip Application, and extract to an empty directory.</li> </ul> <p> </p> <p><b>Note:</b> Do not unpack the IAC Project Files into a directory already containing a user project, as it may overwrite the system V files (such as <code>v/templ.v</code>) used to define the project in that directory structure! Always use an empty directory.</p> <br> <table border="0" cellspacing="5" cellpadding="0" align="center"> <tr> <td><img src="../../img/spot1.gif" alt="" width="8" height="8"></td> <td nowrap><font face="Verdana, Arial, Helvetica, sans-serif" size="3"><b>File Structure </b></font></td> <td><img src="../../img/spot1.gif" alt="" width="8" height="8"></td> </tr> </table> <br> <p>Once downloaded and unpacked, the project files will create a <code>v/</code> directory, containing a <tt>templ.v</tt> file, which simply adds the <b>IAC_PROJ</b> library into <b>Templates</b>, and adds a top-level library page called <b>IAC</b>; a <tt>proc.v</tt> file, which is the default; a <tt>lib_xp.v</tt> and a <tt>lib_vxp.v</tt> file, to create the network editor links for the IAC library page, for the Visualization and Developer Editions of AVS/Express. </p> <p> In addition to this, a directory <tt>iac_lib/</tt> will be created, containing a nunber of files, used to create the IAC library page. Each project contains an <b>INSTALL</b> file, which provides information about which of these files should be edited to add the newly downloaded project. Eventually, the IAC will provide installation scripts to automate this procedure.</p> <p> Finally, the Project Files add the directory <tt>iac_proj/</tt>, which contains the <tt>iac_proj.v</tt> file, which adds the individual project libraries. The <b>INSTALL</b> file included with each newly downloaded project, includes information on how to edit this file to add the project. Again, this file will eventually be used by an installation script.</p> <br> <table border="0" cellspacing="5" cellpadding="0" align="center"> <tr> <td><img src="../../img/spot1.gif" alt="" width="8" height="8"></td> <td nowrap><font face="Verdana, Arial, Helvetica, sans-serif" size="3"><b>Example Project </b></font></td> <td><img src="../../img/spot1.gif" alt="" width="8" height="8"></td> </tr> </table> <br> <p>The IAC also provides a sample project for you to download so that you may test that the IAC Project Files have been setup successfully. This project can also be found in the AVS/Express project repository.</p> <p>Download the IAC Threshold project:</p> <ul> <li>in <b><a href="../express/source/filters/thresh/thresh.tar.gz">tar.gz</a></b>, <b><a href="../express/source/filters/thresh/thresh.tar.Z">tar.Z</a></b> or <b><a href="../express/source/filters/thresh/thresh.zip">zip</a></b> format.</li> </ul> <a name="upgrade"></a><br> <table border="0" cellspacing="5" cellpadding="0" align="center"> <tr> <td><img src="../../img/spot1.gif" alt="" width="8" height="8"></td> <td nowrap><font face="Verdana, Arial, Helvetica, sans-serif" size="3"><b>Upgrading to Version 2.0</b></font></td> <td><img src="../../img/spot1.gif" alt="" width="8" height="8"></td> </tr> </table> <br> <p>For users upgrading from version 1.0 to version 2.0 of the IAC project files, please read the following carefully.</p> <p>The following files <b>do not</b> have to be modified, and may be left as is:</p> <ul> <li>iac_proj/iac_proj.v<br> This is the file used to add references to each downloaded project from the IAC. <b>Do not replace your existing copy of this file</b>.</li> <li>v/templ.v<br> This file adds the references for the IAC_PROJ library, and the IAC library page. <b>Do not replace your existing copy of this file</b>.</li> <li>v/proc.v</li> <li>avsenv</li> </ul> <p>The following files <b>do</b> have to be modified:</p> <ul> <li>v/lib_xp.v<br> Creates the IAC library page and the sub-library headings used for the various categories of macros for the Developer Edition of AVS/Express. <b>Replace this file with the new version</b>.</li> <li>v/lib_vxp.v<br> Creates the IAC library page and the sub-library headings used for the various categories of macros for the Visualization Edition of AVS/Express. <b>Replace this file with the new version</b>.</li> <li>iac_lib/iac_lib.v<br> This creates the empty libraries for the IAC library page. <b>Replace this file with the new version</b>.</li> <li>iac_lib/data_io.v<br> The following properties must be added to the flibrary object for future compatibility with IAC projects: The library line should now read:<br>     <tt>flibrary DATA_IO<font color="#0000FF"><b><user_library=0,compile_subs=0></b></font> {</tt><br> New code is in bold and blue. The remaining contents of the library must be kept the same to retain the references to the IAC projects you have downloaded. <b>Carefully modify this file</b>.</li> <li>iac_lib/filters.v<br> iac_lib/mappers.v<br> iac_lib/misc.v<br> iac_lib/examples.v<br> As for the data_io.v file. <b>Carefully modify these files</b>.</li> </ul> <p>The following files are new and should be added to your existing project:</p> <ul> <li>iac_lib/common.v</li> <li>iac_lib/glyphs.v</li> </ul> <p>The following file which was unused by any of the IAC projects should be removed:</p> <ul> <li>iac_lib/output.v</li> </ul> <p>Finally, for users who have already downloaded the <a href="../express/misc.shtml#common" target="_top">Common</a> and/or <a href="../express/misc.shtml#gly_lib" target="_top">GlyphLibrary</a> projects, please download the latest versions of these projects and follow the new installation instructions. The existing references to these projects in the iac_lib/misc.v file, should be removed.</p> <p>If you have any queries, problems or suggestions about the new IAC projects files, then please contact the IAC at <a href="mailto:avs@iavsc.org">avs@iavsc.org.</a></p>  </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="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> </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%">  </td> </tr> </table>