IAC Project Files

New Version

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.

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 IAC library page sub-libraries, namely GLYPHS and COMMON, and the removal of the unused OUTPUT library. The Common project in the repository now places its objects under the new COMMON library heading, rather than under MISC. Similarly the GlyphLibrary 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.

Other minor changes include ensuring that library object references now use the original path and name to an object in the IAC_PROJ 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.

Note: 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 Upgrading to Version 2.0.


Project Integration

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 Project Organization Guidelines for a more detailed description of how the IAC Project Files work.

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 v/templ.v.


Setup

Download the IAC Project Files:

Unpack the IAC Project Files by:

UNIX (iac.tar.Z)

  • uncompress iac.tar.Z
  • tar xvf iac.tar

UNIX (iac.tar.gz)

  • gunzip iac.tar.gz
  • tar xvf iac.tar

UNIX (iac.zip)

  • unzip iac.zip

WINDOWS (all formats)

  • Load the archive into the Winzip Application, and extract to an empty directory.

Note: 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 v/templ.v) used to define the project in that directory structure! Always use an empty directory.


File Structure

Once downloaded and unpacked, the project files will create a v/ directory, containing a templ.v file, which simply adds the IAC_PROJ library into Templates, and adds a top-level library page called IAC; a proc.v file, which is the default; a lib_xp.v and a lib_vxp.v file, to create the network editor links for the IAC library page, for the Visualization and Developer Editions of AVS/Express.

In addition to this, a directory iac_lib/ will be created, containing a nunber of files, used to create the IAC library page. Each project contains an INSTALL 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.

Finally, the Project Files add the directory iac_proj/, which contains the iac_proj.v file, which adds the individual project libraries. The INSTALL 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.


Example Project

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.

Download the IAC Threshold project:


Upgrading to Version 2.0

For users upgrading from version 1.0 to version 2.0 of the IAC project files, please read the following carefully.

The following files do not have to be modified, and may be left as is:

  • iac_proj/iac_proj.v
    This is the file used to add references to each downloaded project from the IAC. Do not replace your existing copy of this file.
  • v/templ.v
    This file adds the references for the IAC_PROJ library, and the IAC library page. Do not replace your existing copy of this file.
  • v/proc.v
  • avsenv

The following files do have to be modified:

  • v/lib_xp.v
    Creates the IAC library page and the sub-library headings used for the various categories of macros for the Developer Edition of AVS/Express. Replace this file with the new version.
  • v/lib_vxp.v
    Creates the IAC library page and the sub-library headings used for the various categories of macros for the Visualization Edition of AVS/Express. Replace this file with the new version.
  • iac_lib/iac_lib.v
    This creates the empty libraries for the IAC library page. Replace this file with the new version.
  • iac_lib/data_io.v
    The following properties must be added to the flibrary object for future compatibility with IAC projects: The library line should now read:
        flibrary DATA_IO<user_library=0,compile_subs=0> {
    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. Carefully modify this file.
  • iac_lib/filters.v
    iac_lib/mappers.v
    iac_lib/misc.v
    iac_lib/examples.v
    As for the data_io.v file. Carefully modify these files.

The following files are new and should be added to your existing project:

  • iac_lib/common.v
  • iac_lib/glyphs.v

The following file which was unused by any of the IAC projects should be removed:

  • iac_lib/output.v

Finally, for users who have already downloaded the Common and/or GlyphLibrary 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.

If you have any queries, problems or suggestions about the new IAC projects files, then please contact the IAC at avs@iavsc.org.