Using prebuilt binaries

First download and install a suitable binary package for your operating system at the download page. We'd like to stress that the precompiled binaries have been tested only against the versions of Qt mentioned on the download page. If you have any other version installed, you may need to compile Into from sources.

Linux
Ensure that Qt environment is set up correctly. At the minimum, Qt libraries must be found in system library path or in directory that is in the LD_LIBRARY_PATH environment variable. Into does this automatically if you installed the Qt SDK to the default location or set QTDIR correctly. Type the following at the command prompt:

export QTDIR=/path/to/qt
. into_install_dir/bin/intoenv

Replace into_install_dir with the name of the directory you chose as the installation directory. This script adds into/lib to LD_LIBRARY_PATH and into/bin to PATH. Try out the demos:

cd into_install_dir/demos
./intodemo

Mac OS X
Into will be installed to /Developer/into. If you have installed Qt SDK globally, the demo application can be started by double-clicking IntoDemo.app in the demos folder. In shell, type the following commands:

export QTDIR=/path/to/qt
. bin/intoenv
cd /Developer/into/demos
IntoDemo.app/Contents/MacOS/intodemo.sh

Windows
Ensure that Qt environment is set up correctly. On Windows, Qt dlls must be found in PATH. The Into command prompt present in the start menu after installation does this for you. Open the Into command prompt and type the following commands:

cd into_install_dir\demos
intodemo

Using Into in your project

Create a project file myproject.pro with the following contents:

# Your own project file
INTODIR=into_install_dir/src
include($$INTODIR/base.pri)
SOURCES = MySource.cc MyOtherSource.cc
HEADERS = MySource.h MyOtherSource.h
win32:LIBS += -lpiicore2 -lpiiydin2
unix|macx:LIBS += -lpiicore -lpiiydin

Typing qmake myproject.pro in Into command prompt will create a makefile for you. Please see the QMake Manual for details.

If you use Into from an IDE, you need to add into_install_dir/include to the include path, into_install_dir/lib to the library path, and the piicore and piiydin libraries to linked libraries. On Windows, the library names must contain a version number (piicore2, piiydin2).