Installing SoQt For Windows

SoQt is a library that provides the glue between the Coin 3D libraries and the Qt 2D GUI and application framework libraries. The SoQt library is used within Tonatiuh mainly to implement different types of Coin 3D scene viewers inside traditional 2D Qt-generated windows.

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

Details

Before installing SoQt, please, verify that the Qt and Coin 3D libraries are already properly installed in your computer. If they are not, install them first by following the corresponding procedures to installing Qt and installing Coin.

Since the SoQt library binary installers for Windows, available at the Coin 3D website, are only valid for Visual C++ and the open source version of the Qt libraries can only be compiled under Windows with the MinGW C++ compiler, the SoQt library have to be built from the source code.

Download the latest release of the SoQt, currently SoQt 1.5.0. To do it, click on the following link to go to the "SoQt 1.5.0" webpage of the Coin website. Once you reach the webpage, click on the link titled "Get SoQt 1.5.0 for all platforms" (see Figure 1). This will start the downloading of the SoQt 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 "SoQt 1.5.0" webpage.

Once the SoQt source code package is on your computer, 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 SoQt-1.5.0.tar.gz

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

To build the library in release mode type:

export QTDIR=/c/sde/Qt/Desktop/Qt/version/mingw
export COINDIR=/usr/local
export INCLUDE=/usr/local/include:/c/sde/MinGW/include
export PATH=$QTDIR/bin:$PATH
export QMAKESPEC=$QTDIR/mkspecs/win32-g++
./configure --disable-msvc --enable-debug=no --enable-symbols=no

The configure command for the last Qt version is:

./configure --disable-msvc --enable-debug=no --enable-symbols=no --enable-pkgconfig=no CPPFLAGS="-I/c/sde/Qt/Qt5.1.1/5.1.1/mingw48_32/include/QtCore -I/c/sde/Qt/Qt5.1.1/5.1.1/mingw48_32/include/QtGui -I/c/sde/Qt/Qt5.1.1/5.1.1/mingw48_32/include/QtWidgets -I/c/sde/Qt/Qt5.1.1/5.1.1/mingw48_32/include/QtOpenGL " LDFLAGS="-L/c/sde/qt/Qt5.1.1/5.1.1/mingw48_32/lib" CONFIG_QTLIBS="-lQt5Core -lQt5Gui -lQt5Widgets -lQt5OpenGL"

This will start the configuration process. Depending on your computer, this process may take some time to finish. When it does, a set of messages indicating the SoQt configuration settings will be displayed at MSYS shell (see Figure 2).

Figure 2. MSYS shell messages shown when the configuration process ends.

Now, you can install the SoQt library by typing:

make 
make install

The installation process may take some time. At the end of the installation process, the SoQt dynamic library "libSoQt-20.dll" and the file "soqt-config" will be installed at the folder "C:\sde\MinGW\msys\1.0\local\bin" and the SoQt library files "libSoQt.dll.a" and "libSoQt.la" will be installed at the folder "C:\sde\MinGW\msys\1.0\local\lib". In addition, the file "SoQt.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 folders "C:\sde\MinGW\msys\1.0\local\include" and "C:\sde\MinGW\msys\1.0\local\include\Inventor".

Once the SoQt library is installed the next step is to install the Marble library. To do it, follow the instructions in the following wiki page: Installing Marble for Windows

---

Windows Configuration | Wiki Home