harmonic_software_research/PhysicalModeling/INSTALL.html
  Speech Input 
    Happy Hands Java 
      User's Manual 
      Change Log 
      Download 
      Demo Movies 
      Paper 
      Examples 
      Pictures 
      Future Plans 
  Physical Modeling 
    Download 
    Documentation 
    Gallery 
    Paper 
    Change Log 
    Open Source 
    Future Plans 
    Credits 
    CAD-Zilla 
      Download 
      Developer Docs 
      User's Manual 
      Dependencies 
      Screen Shot 
      Old Screen Shot 
    Vincent van Mol 
      Download 
      Developer Docs 
      User's Manual 
      Dependencies 
      Screen Shot 
    GridZilla 
      Download 
      Developer Docs 
      User's Manual 
      Dependencies 
    ZillaTracer 
      Download 
      User's Manual 
    Jython Console 
      Download 
      User's Manual 
  People 
    Sean 
      Contact 

Modelzilla Project - Installation and Platform Requirements

[Summary] [Download] [Documentation] [Change Log] [Open Source] [Future Plans] [Credits] [Issues]

The following platforms are supported

  • Windows XP, 2000, 98
  • Solaris 5.7 and up
  • Any modern Linux (Red Had ~7, SuSE ~7)
  • Mac 0S 10.3

JAVA versions

Modelzilla is a Java program, making it uncrashable and easier to maintain. Java 1.4.1 or greater is required on all systems. This minimum is needed for the JOGL OpenGL binding.

Get Java Here

Hardware Requirements

Like all JAVA programs it is important that your computer is fast! At least a 800 MHz Pentium, maybe a 400 MHz Sparc. Equally important is that you have a good three dimensional graphics video card. At least 40 Mbytes of disk space is required and 128 Mbytes of RAM, but 256 Mbytes is required for serious use.

Installation procedure common to all platforms

Run the install program with java -jar install_all_modelzilla.jar, or whatever the file is called that ends with .jar. You need to be in the directory that has the jar file when you do this, or the install program will not be able to find itself on the file system. It is also possible to double click on install_all_modelzilla.jar from a file manager.

The install program asks you for a directory to install Modelzilla too. If you are installing an application module, make sure you pick the same directory that you picked when installing the framework. NOTE: The install program puts all the files in a directory called ModelzillaProject that is within the directory you pick. This way, all files are certain to be grouped under this directory. So there is no need to create a new directory for Modelzilla yourself.

The install program will also ask you for the JRE directory, which it needs only to create the start script.

The install program then:

  • uncompressed files and places them in the installation directory
  • localizes some Modelzilla settings files so that they point to this directory
  • writes start up scripts

The install program does not modify your configuration files. (Such as .cshrc or AUTOEXEC.BAT). Environment variables that need to be set are set in the executable script that starts Modelzilla. The entire installation is self contained within the Modelzilla directory, with the exception of links made in the Windows StartMenu.

Special procedures for Windows

You may make a short cut to Modelzilla on the desktop by copying as a short cut the file Modelzilla.bat. We have provided an icon - Modelzilla.ico that you can associate to the short cut by right clicking on it and selecing Properties then Shortcut then Chose Icon.

Install program options

-nfs
The most important option in the install program is the command line switch -nfs. Using this switch will cause all UNIX binaries for all platforms to be installed, regardless of what computer the install program runs on. This enables your entire lab or office to use the same installation. When Modelzilla runs it creates independant settings files for each user.

Running after installation

  • Windows - use Modelzilla.bat
  • Solaris - use start_mz_Sun
  • Linux - use start_mz_Linux
  • Mac - use start_mz_Mac

Reading the user manuals

Each application module comes with a user's manual. For example for the CAD-Zilla application, the users manual is under CAD-Zilla/manual.

Reading the developer's API's

Modelzilla is built in components that each have a separate developer's manual. They are under the directories Modelzilla/docs, ViewerCore/docs, MeshGeom/docs etc.

Troubleshooting

If the view port has no graphics you likely have a problem with your OpenGL installation. To test your OpenGL installation, we have included a small script "test_graphics". Run this from the Modelzilla installation directory. If everything goes well, a black window with a box will appear. You can spin the box with your right mouse button. If you get no box, there is a problem with your OpenGL.
Last updated: Wed, 22 Dec 2004 04:05:40 -0500