Installing and Configuring ImageGear for Java

This topic provides information about the following:

System Requirements

Supported Operating Systems

Windows Operating Systems:

Linux Distributions:

Mac Operating Systems:

Java Runtime Environment

Windows:

  • All OSes: Oracle JavaSE 1.6.0.23 or Later

    • Linux:

  • All Distributions: Oracle JavaSE 1.6.0.23 or Later

    • Mac:

  • Snow Leopard: Java for Mac OS X 10.6 Update 4

  • Leopard: Java for Mac OS X 10.5 Update 9

    • Disk Space

    The Installation program will tell you exactly how much disk space you need in order to load ImageGear for Java, which is around 133MB.

    Installing ImageGear for Java

    1. Start the installer.
    2. Click the Next button to continue past the welcome dialog.
    3. Carefully read the information contained in the License Agreement form before making a decision to accept the terms of the agreement. Choose I accept the license agreement to accept the conditions outlined in the License Agreement and then click the Next button to continue the installation, or click Cancel to exit the installation process.
    4. After clicking Next the Choose Install Folder form is displayed. Choose the destination folder where the ImageGear product should be installed or choose the default installation destination folder. Then click Next.
    5. Once you click the Next button, the Choose Shortcut Folder form is displayed. On this page you can choose where to place shortcuts to product features. Once you have selected the desired option, click Next.
    6. The last page presented to you is the Pre-Installation Summary checklist. Review the items on this page. You can change installation options by clicking the Previous button, or cancel the installation by clicking the Cancel button. To proceed with installation, click the "Install" button.
    7. Once installation is complete you will be presented with the License Manager dialog. Using this dialog you can select the type of license you wish to obtain, an evaluation license or a development license.

    Note: It has been reported that when installing to 2003 Server x64 or XP x64 the Installer can prompt the user that the 'Windows Imaging Component' is required and further report failure trying to install it. This can be safely ignored. The ImageGear installation will continue without issue after that and the product will function without issue.

    Using ImageGear for Java

    Note: The ImageGear for Java documentation provides information for all platforms and Java versions. However, not all features are available for all ImageGear for Java versions.

    Before you can use any ImageGear functionality, you need to call the ImageGear licensing API. When you evaluate the product or develop your application using ImageGear, you have to call the Set Solution Name API function.

    The call to setSolutionName() method looks like this:

         String arch = System.getProperty("os.arch");

         if (arch.contains("64")) {

              ImGearLicense.setSolutionName("AccuSoft 21-33-2");

          } else {

              ImGearLicense.setSolutionName("AccuSoft 21-32-2");

         }

    The ImageGear samples installed with the product already have this call included, so you can simply copy/paste this call from the source code of the samples.

    Note: ImageGear reads the license information from from a file named accusoft.<solution_name>.imagegear that is either in a peer directory, config, of lib directory containing the SDK jars or at the directory specified by the environment variable, IMAGE_GEAR_LICENSE_DIR. Obtain the product license (evaluation or development) using the Accusoft License Manager (see "Installing and Distributing ImageGear" Chapter of the product documentation included in your package) in order for the product to work.

    When you’re ready to deploy your application you will need to use all three licensing API calls. Please refer to the product documentation for the details of how to use these calls. Please contact Accusoft about obtaining a platinum (OEM) license. It will explain additional steps (including the API calls) that you need to take to deploy your application.

    Licensing Model

    The ImageGear for Java licensing model is a flexible and straightforward method for licensing your ImageGear-based development and deployment efforts. This involves a simple API based licensing structure used when deploying your ImageGear-based application. Details on the licensing API and different licensing schemes are outlined in the "Installing and Distributing" Chapter of the documentation.

    If you are running in Evaluation mode your images will have a watermark. Call the Accusoft Sales department at 1.800.875.7009 (dial 1) to address any questions concerning ImageGear pricing, licensing, or options.

    Back to Top