KGameAudioScene

KGameAudioScene Namespace Reference

Typedefs

typedef QFlags< CapabilityCapabilities
 

Enumerations

enum  Capability { SupportsLowLatencyPlayback = 1 << 0 , SupportsPositionalPlayback = 1 << 1 }
 

Functions

Capabilities capabilities ()
 
bool hasError ()
 
QPointF listenerPos ()
 
void setListenerPos (QPointF pos)
 
void setVolume (qreal volume)
 
qreal volume ()
 

Detailed Description

This class exposes general properties of the audio playback context.

Actual sounds are represented in this context by KGameSound instances.

The audio scene basically consists of a listener. The position of this listener is relevant when sounds are played at certain positions: The audio channels will then be balanced to make the sound appear to come from that direction.

Because there can ogly be one listener, all methods in this class are static.

Warning
Not all functionally exposed by the API of this class is guaranteed to be available on the compiled KGameAudio backend. Check KGameAudioScene::capabilities() if in doubt.

Typedef Documentation

◆ Capabilities

Stores a combination of Capability values.

Definition at line 44 of file audio/kgameaudioscene.h.

Enumeration Type Documentation

◆ Capability

This enumeration represents capabilities which may not be provided by every KGameAudio backend.

Enumerator
SupportsLowLatencyPlayback 

Playback starts as soon as KGameSound::start is called.

Definition at line 36 of file audio/kgameaudioscene.h.

Function Documentation

◆ capabilities()

KGameAudioScene::Capabilities KGameAudioScene::capabilities ( )
Returns
which capabilities are supported by the compiled KGameAudio backend

Definition at line 17 of file kgameaudioscene-openal.cpp.

◆ hasError()

bool KGameAudioScene::hasError ( )
Returns
whether an error was detected in the audio backend

Since KGameAudio is typically used by games where audio is not an absolutely vital part of the gameplay, we do not need to fail if sound does not work, over even make some sort of deep analysis why something did not work. The user will notice missing sound, and advanced users may investigate the kWarning() messages. That is usually enough. If not, use this method.

The state of hasError() may theoretically change while the application runs, but in practice, this is very unlikely. (The only tricky part is typically the initial allocation of resources.)

See also
KGameSound::hasError()

Definition at line 48 of file kgameaudioscene-openal.cpp.

◆ listenerPos()

QPointF KGameAudioScene::listenerPos ( )
Returns
the position of the listener

Definition at line 22 of file kgameaudioscene-openal.cpp.

◆ setListenerPos()

void KGameAudioScene::setListenerPos ( QPointF pos)

Sets the position of the listener.

The default is (0.0, 0.0), the point of origin.

Note
Effective only if positional playback is supported.

Definition at line 27 of file kgameaudioscene-openal.cpp.

◆ setVolume()

void KGameAudioScene::setVolume ( qreal volume)

Sets the master volume for sounds outputted by TagaroAudio.

The default is 1.0, which means no volume change, compared to the original sounds. 0.0 means that all sounds are muted.

Definition at line 40 of file kgameaudioscene-openal.cpp.

◆ volume()

qreal KGameAudioScene::volume ( )
Returns
the master volume for sounds outputted by TagaroAudio

Definition at line 35 of file kgameaudioscene-openal.cpp.

This file is part of the KDE documentation.
Documentation copyright © 1996-2024 The KDE developers.
Generated on Sat Dec 21 2024 16:59:04 by doxygen 1.12.0 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.