Requirements

To use this application, you need the latest of Sun's java. Get it here.

Downloading ivata masks

ivata masks files are available for download from the SourceForge files page.

Use this page to download the source code (and documentation - see section at the end of this page), or the demo application. To use the library in your own projects, you can download and use ivata masks from within maven, as described in the next section.

ivata masks within maven

It's easiest to use ivata masks from within Maven. To do this, you need to amend the repository entry in your project properties file to include the ivata maven repository. For example:

maven.repo.remote = http://portal.ivata.com/maven,http://www.ibiblio.org/maven
        

Now you can include the various ivata masks libraries in your project.xml file and maven will download and use the libraries automatically (this example is for the latest version, 1.0):

          
<dependency>
  <groupId>ivatamasks</groupId>
  <artifactId>ivatamasks-build</artifactId>
  <version>1.0</version>
</dependency>
<dependency>
  <groupId>ivatamasks</groupId>
  <artifactId>ivatamasks-mask</artifactId>
  <version>1.0</version>
  <properties>
    <ear.bundle>true</ear.bundle>
    <ejb.manifest.classpath>true</ejb.manifest.classpath>
    <war.bundle>true</war.bundle>
  </properties>
</dependency>
<dependency>
  <groupId>ivatamasks</groupId>
  <artifactId>ivatamasks-util</artifactId>
  <version>1.0</version>
  <properties>
    <ear.bundle>true</ear.bundle>
    <ejb.manifest.classpath>true</ejb.manifest.classpath>
    <war.bundle>true</war.bundle>
  </properties>
</dependency>
<dependency>
  <groupId>ivatamasks</groupId>
  <artifactId>ivatamasks-web</artifactId>
  <version>1.0</version>
  <properties>
    <ear.bundle>true</ear.bundle>
    <ejb.manifest.classpath>true</ejb.manifest.classpath>
    <war.bundle>true</war.bundle>
  </properties>
</dependency>
<dependency>
  <groupId>ivatamasks</groupId>
  <artifactId>ivatamasks-webtheme-jar</artifactId>
  <version>1.0</version>
  <properties>
    <ear.bundle>true</ear.bundle>
    <ejb.manifest.classpath>true</ejb.manifest.classpath>
    <war.bundle>true</war.bundle>
  </properties>
</dependency>
<dependency>
  <groupId>ivatamasks</groupId>
  <artifactId>ivatamasks-webtheme-war</artifactId>
  <version>1.0</version>
  <type>war</type>
</dependency>
<dependency>
  <groupId>ivatamasks-thirdparty</groupId>
  <artifactId>ivatamasks-thirdparty-imageinfo</artifactId>
  <version>0.1.1</version>
  <properties>
    <ear.bundle>true</ear.bundle>
    <ejb.manifest.classpath>true</ejb.manifest.classpath>
    <war.bundle>true</war.bundle>
  </properties>
</dependency>
          
        

For an example of using maven to build an ivata masks project, look at the demo project included in the ivata masks source.

Getting ivata masks from CVS

If you need access to the latest source code, you need a CVS client.

• Microsoft Windows machines: a good CVS client is TortoiseCVS (screenshot). When prompted for a password (anonymous user), simply press the Enter key.
• UNIX/Linux machines: you can get CVS from https://ccvs.cvshome.org/servlets/ProjectDownloadList.

Follow the instructions explained here to configure your client.

Building ivata masks from Sources

ivata masks uses Maven to build.

1. install Maven - you must use the 1.1 series (not 1.0.x and not 2.x).
2. get ivata masks from CVS
3. go to the ivatamasks directory
4. to build the libraries, execute
   • maven

Generating the ivata masks Documentation

ivata masks uses Maven to generate the documentation.

Most of the documentation (xdocs) is in Anakia format. More information along with samples, can be found at:

• The jakarta-site tags
• The jakarta-site tags examples

1. install Maven - you must use the 1.1 series (not 1.0.x and not 2.x).
2. get ivata masks from CVS
3. go to the ivatamasks directory
4. to build the documentation, execute
   • maven multiproject:site