Installing GroIMP

Important: Groimp migrates to Gitlab. You can find the latest code and documentation at https://gitlab.com/grogra/groimp/-/wikis/home. The version on Sourceforge will not be updated anymore.

GroIMP is a pure Java application, therefore a Java Virtual Machine should be installed before installing GroIMP. GroIMP releases consist of the source code, the API documentation, the compiled executable and two pre-packaged versions for Win32 and Mac (containing not just the GroIMP executable, but also JOGL).

Win32

For 32 bit Windows there is an installer provided containing GroIMP together with JOGL. Just download https://sourceforge.net/projects/groimp/files GroIMP-*-win32.exe and run it. The installer will ask you where to install and then copy all files to this location. It also creates an icon in the start menu and provides uninstall information.

MacOS

For MacOS, there is also a package containing GroIMP and JOGL together. Just download https://sourceforge.net/projects/groimp/files GroIMP-*-MacOS.zip> and unzip to the location you want GroIMP to be installed in.

Linux, Win64, ...

For all other systems, just download https://sourceforge.net/projects/groimp/files GroIMP-*.zip and unzip it to the location you want GroIMP to be installed in. You can then run GroIMP by calling:

java -jar core.jar

from within the GroIMP folder.

If you also want to use OpenGL for the 3D view, then you need to install JOGL as well. Download the version of JOGL for your system from here: http://download.java.net/media/jogl/builds/archive/jsr-231-1.1.1a/

If you have a 32bit JVM, then you need a 32bit JOGL. If you have a 64bit JVM then you need a 64bit JOGL. Then unzip the JOGL file you downloaded, create a folder named '''ext''' inside your GroIMP folder, and copy the .jar and .so/.dll files from JOGL into that folder. When restarting GroIMP the 3D view should allow selecting OpenGL now.

Adjusting the amount of memory available to GroIMP

For the Oracle JVM (formerly Sun JVM) there is a command line switch -Xmx to select the amount of memory that can be used by the Java application. For instance if you would want to start GroIMP with 1.5GB of memory, you could call:

java -Xmx1500m -jar core.jar

Note that on 32bit systems this is approximately the maximum you could get, even if your computer has more memory installed. This is because of virtual address space. On a 64bit system, no such limit applies and the memory could be set much higher. However, do not set the amount of memory bigger than the memory your computer has physically installed, but instead to maybe 90% of the physically installed memory.

Note that the Windows installer creates an icon that calls GroIMP with the -Xmx option and an estimated size of memory depending on the physically installed memory, so in general Win32 users do not have to worry. However for some larger models increasing the default amount of memory to be used by GroIMP is advisable.