QtAudio3D

English | Deutsch | Русский | Polski | Nederlands | Português | Español | Українською | فارسی | عربي | 한국어 | Suomi | Català | Italiano | 日本語 | Français | Magyar | ಕನ್ನಡ | हिन्दी | ภาษาไทย | 简体中文 | Български

[toc align_right="yes" depth="3"]

QtAudio3D

News

Public mirror on "Gitorious": https://qt.gitorious.org/qtplayground/qtaudio3d

It is now possible to browse the source code inside the preferred WEB browser for the bleeding edge changes as well as getting a snapshot about the project in archive format.

Brief description

The QtAudio3D module is an add-on for the Qt5 library, providing a simple API for deliviring 3D positional audio experience.

History

QtAudio3D originates from the KDE Playground repository "QtOpenAL". The migration was initiated to the Qt Project since it is based upon the Qt technology and the project itself might be useful for others outside KDE.

The development and code review takes place through "Gerrit":http://wiki.qt.io/Setting_up_Gerrit. A Qt Developer account must be created for anyone in order to be able to contribute to the project.

More information about the registration process and development in general can be found on the following site: http://wiki.qt.io/Code_Reviews

Functionality

The QtAudio3D module has support the following operating systems:

{background:#009900}. |. Operating system |. Support state |. Note | |Windows NT/2K/XP/Vista/7 |YES |Full support | |Windows CE |YES |Tested only on 5 and 6 platforms in the emulator | |Gnu/Linux |YES |Full support | |MacOSX |YES |Full support | |Others Unix |YES |All POSIX-compatible | |Symbian |YES |Partially, tested only in the emulator () |

Note:

() -

h2. Getting the source code

In order to get get the source code, you need to register to get a Qt Developer account. Moreover, you need to set that account up for Gerrit usage (see "Setting up Gerrit":http://wiki.qt.io/Setting_up_Gerrit).

You can then check out the repository using git, like this:

git clone ssh://<username>@codereview.qt.io:29418/playground/qtaudio3d.git<code>

<username>: the Gerrit user identifier

h2. Building and Installing

The following is a preliminary procedure for building and installing the module for Qt5 on Windows using "QtCreator":
http://qt.nokia.com/products/developer-tools/.

First you need to [[:Building_Qt_5_from_Git|build Qt5 from source]]. 

*Note: You do not need to build all Qt5 components, it is enough to just build the qtbase module.

In the following, we'll assume that qtbase from Qt5 has been built and is located in:

с:5-build\qtbase

Next, you need to open "QtCreator": http://qt.nokia.com/products/developer-tools/

Select "Tools->Options->Build & Run->Qt Versions", add a new profile that contains the path to the Qt5 qmake.

In our case this would be the path:

c:5-build\qtbase\bin\qmake.exe<code>

Now that all preliminary preparations are completed, you can proceed to building the QtAudio3D module itself.

h3. Building

To build the module, you must go to the source directory of your local clone of the QtAudio3D repository:

cd qtaudio3D

Now run QtCreator and select the QtAudio3D CMakeLists.txt cmake file found in the project root folder.

$projectroot/CMakeLists.txt<code>

h3. Installation

After building the module, there will be two library files (Release and Debug builds, respectively) in the Qt5 qtbase binary directory:

c:5-build\qtbase\bin\QtAddOnAudio3D1.dll c:5-build\qtbase\bin\QtAddOnAudio3Dd1.dll

In addition, copy the whole QtAddOnAudio3D folder from the QtAudio3D shadow build directory to the Qt5 qtbase include directory:

cp audio3d-build-desktop-Qt_5_0_0qt5-build3D c:5-build\qtbase\include\QtAddOnAudio3D

Known Issues

Fill up