Installing Simage For Windows

Introduction

Simage is a library capable of loading, manipulating and saving images, creating and saving movies (AVI and mpeg), and loading audio. The simage library relies heavily on third party libraries to perform these tasks. The simage library is used within Tonatiuh to complement the Coin 3D library, since Coin uses simage to read textures.

Here you will find the instructions to install the simage library in your computer and make the library available for the development of Tonatiuh.

Details

Since the simage library binary installers for Windows, available at the Coin 3D website, are only valid for Visual C++ and we need to use the MinGW C++ compiler in order to be able to use the open source version of the Qt libraries, we need to build the simage library from the source code.

Download the latest realese of the Simage source package, currently simage-1.7.0. To do it, click on the following link to go to the "Downloads" webpage of the Coin3D website. Once you reach the webpage, click on the link entitled "simage-1.7.0.tar.gz" (see Figure 1). This will start the downloading of the simage source package. When prompted if to open or to store the file in your computer, select the appropriate option to store the file in your computer.

Figure 1. View of the "simage 1.7.0" webpage.

Once the simage source code package is on your PC, place it into the user directory under your MSYS folder. This will typically be C:\sde\MinGW\msys\1.0\home\username.

Open an MSYS shell console. Navigate to your MSYS user directory and extract the archive by typing:

tar -zxvf simage-1.7.0.tar.gz

This will create a directory called simage-1.7.0 in your user directory. Using the MSYS shell navigate to the just created directory.

To build the library in release mode type:

./configure --disable-msvc --without-gdiplus --with-qt=/c:/sde/Qt/Desktop/Qt/version/mingw --enable-debug=no --enable-symbols=no

This will start the configuration process. Depending on your computer, this process may take some time to finish. When it does, install the Simage library by typing:

make 
make install

The installation process may take several minutes. At the end of the installation process, the simage dynamic library "libsimage-20.dll" and the file "simage-config" will be installed at the folder "C:\sde\MinGW\msys\1.0\local\bin" and the simage library files "libsimage.dll.a" and "libsimage.la" will be installed at the folder "C:\sde\MinGW\msys\1.0\local\lib". In addition, the file "simage.pc" will be installed at the folder "C:\sde\MinGW\msys\1.0\local\lib\pkgconfig" and the necessary include files will be installed at the folder "C:\sde\MinGW\msys\1.0\local\include".

Once the simage library is installed the next step is to install the Coin library. To do it, follow the instructions in the following wiki page: Coin3D

---

Windows Configuration | Wiki Home