AudioListener QML Type

Control global listener parameters. More...

Import Statement: import QtAudioEngine 1.0
Since: Qt 5.0
Inherits:

Item

Properties

Detailed Description

This type is part of the QtAudioEngine 1.0 module.

AudioListener will have only one global instance and you can either access it through the listener property of AudioEngine:


  import QtQuick 2.0
  import QtAudioEngine 1.0

  Rectangle {
      color:"white"
      width: 300
      height: 500

      AudioEngine {
          id:audioengine
          listener.up:"0,0,1"
          listener.velocity:"0,0,0"
          listener.direction:"0,1,0"
          listener.position:Qt.vector3d(observer.x, observer.y, 0);
      }

      Item {
          id: observer
          x: 10 + observer.percent * 100
          y: 20 + observer.percent * 80
          property real percent: 0
          SequentialAnimation on percent {
              loops: Animation.Infinite
              running: true
              NumberAnimation {
                  duration: 8000
                  from: 0
                  to: 1
              }
          }
      }
  }

or alternatively, by defining an AudioListener outside AudioEngine:


  import QtQuick 2.0
  import QtAudioEngine 1.0

  Rectangle {
      color:"white"
      width: 300
      height: 500

      AudioEngine {
          id:audioengine
          listener.up:"0,0,1"
          listener.velocity:"0,0,0"
          listener.direction:"0,1,0"
      }

      AudioListener {
          engine:audioengine
          position: Qt.vector3d(observer.x, observer.y, 0);
      }

      Item {
          id: observer
          x: 10 + observer.percent * 100
          y: 20 + observer.percent * 80
          property real percent: 0
          SequentialAnimation on percent {
              loops: Animation.Infinite
              running: true
              NumberAnimation {
                  duration: 8000
                  from: 0
                  to: 1
              }
          }
      }
  }

This separate AudioListener definition is allowed to make QML bindings easier in some cases.

Property Documentation

direction : vector3d

This property holds the normalized 3D direction vector of the listener.


This property holds the reference to AudioEngine, and must only be set once.


gain : real

This property will modulate all audio output from audio engine instances.


position : vector3d

This property holds the 3D position of the listener.


up : vector3d

This property holds the normalized 3D up vector of the listener.


velocity : vector3d

This property holds the 3D velocity vector of the listener.