Om
1.0.0
A universal framework for multimedia simulation
|
A class that represents a sound listener in a virtual acoustic context. More...
#include <omSoundListener.h>
Public Member Functions | |
SoundListener () | |
Create a default sound listener positioned at the origin. More... | |
SoundListener (const Vector3f &newPosition, Float newRadius) | |
Create a sound listener with the specified position and radius. More... | |
Float | getSensitivity () const |
void | setSensitivity (Float newSensitivity) |
Set the conversion factor in decibels converting from pascals to full-scale digital audio (e.g. [-1,1]). More... | |
const ChannelLayout & | getChannelLayout () const |
Return the channel layout that should be used for the listener's output audio. More... | |
void | setChannelLayout (const ChannelLayout &newChannelLayout) |
Set the channel layout that should be used for the listener's output audio. More... | |
SoundResult | render (SoundBuffer &outputBuffer, Size numSamples) const |
Render the specified number of samples from this listener to an output buffer. More... | |
virtual Bool | setContext (AcousticContext *newContext) |
Set a pointer to the acoustics context this context object should use to do simulation. More... | |
SoundListenerID | getID () const |
Return the ID of this sound listener within its current acoustic context. More... | |
virtual Bool | addSceneObjects (SoundSceneID sceneID) |
Add internal context objects to the scene with the specified ID. More... | |
virtual Bool | removeSceneObjects (SoundSceneID sceneID) |
Remove internal context objects from the scene with the specified ID. More... | |
Public Member Functions inherited from om::sound::acoustics::objects::SoundTransducer | |
SoundTransducer () | |
Create a default sound transducer positioned at the origin. More... | |
SoundTransducer (const Vector3f &newPosition, Float newRadius) | |
Create a sound transducer with the specified position and radius. More... | |
const Vector3f & | getPosition () const |
Return the position of this transducer. More... | |
void | setPosition (const Vector3f &newPosition) |
Set the position of this transducer. More... | |
const Matrix3f & | getOrientation () const |
Return the orientation of this transducer. More... | |
void | setOrientation (const Matrix3f &newOrientation) |
Set the orientation of this transducer. More... | |
const Vector3f & | getScale () const |
Return the scale of the transducer. More... | |
void | setScale (Float newScale) |
Set the scale of the transducer uniformly for all dimensions. More... | |
void | setScale (const Vector3f &newScale) |
Set the scale of the transducer. More... | |
const Transform3f & | getTransform () const |
Return the transformation for this transducer between its local and parent coordinate frame. More... | |
void | setTransform (const Transform3f &newTransform) |
Set the transformation for this transducer between its local and parent coordinate frame. More... | |
const Vector3f & | getVelocity () const |
Return the world-space linear velocity of this tranducer in meters per second. More... | |
void | setVelocity (const Vector3f &newVelocity) |
Set the world-space linear velocity of this tranducer in meters per second. More... | |
const Vector3f & | getAngularVelocity () const |
Return the world-space angular velocity of this tranducer in radians per second. More... | |
void | setAngularVelocity (const Vector3f &newAngularVelocity) |
Set the world-space angular velocity of this tranducer in radians per second. More... | |
Float | getRadius () const |
Return the nominal radius of the transducer's spherical representation. More... | |
void | setRadius (Float newRadius) |
Set the nominal radius of the transducer's spherical representation. More... | |
Size | getShapeCount () const |
Return the number of shapes that this transducer has. More... | |
SoundShape * | getShape (Index shapeIndex) const |
Return a pointer to the shape for this transducer at the specified index. More... | |
Bool | addShape (SoundShape *newShape) |
Add a new shape to this transducer. More... | |
Bool | setShape (Index shapeIndex, SoundShape *newShape) |
Set the shape for this transducer at the specified index. More... | |
Bool | removeShape (Index shapeIndex) |
Remove the shape from this transducer at the specified index. More... | |
Bool | removeShape (const SoundShape *shape) |
Remove the specified shape from this transducer. More... | |
void | clearShapes () |
Remove all shapes from this transducer. More... | |
Float | getPriority () const |
Return a number indicating the priority for this sound transducer. More... | |
void | setPriority (Float newPriority) |
Set a number indicating the priority for this sound transducer. More... | |
SampleRate | getSampleRate () const |
Return the sample rate that should be used for this transducer. More... | |
void | setSampleRate (SampleRate newSampleRate) |
Set the sample rate that should be used for this transducer. More... | |
DTF * | getDTF () const |
Return a pointer to the optional directional transfer function for this sound source. More... | |
void | setDTF (DTF *newDTF) |
Set a pointer to the optional directional transfer function for this sound transducer. More... | |
SoundTransducerFlags & | getFlags () |
Return a reference to an object which contains boolean parameters of the sound transducer. More... | |
const SoundTransducerFlags & | getFlags () const |
Return an object which contains boolean parameters of the sound transducer. More... | |
void | setFlags (const SoundTransducerFlags &newFlags) |
Set an object which contains boolean parameters of the sound transducer. More... | |
Bool | flagIsSet (SoundTransducerFlags::Flag flag) const |
Return whether or not the specified boolan flag is set for this sound transducer. More... | |
void | setFlag (SoundTransducerFlags::Flag flag, Bool newIsSet=true) |
Set whether or not the specified boolan flag is set for this sound transducer. More... | |
Bool | getIsEnabled () const |
Return whether or not this source is enabled for sound propagation and rendering. More... | |
void | setIsEnabled (Bool newIsEnabled) |
Set whether or not this source should be enabled for sound propagation and rendering. More... | |
Public Member Functions inherited from om::sound::acoustics::contexts::AcousticContextObject | |
virtual | ~AcousticContextObject () |
Destory this acoustics context object. More... | |
AcousticContext * | getContext () const |
Return a pointer to the acoustics context this context object is using to do simulation. More... | |
Bool | clearContext () |
Clear the previous context from this object. More... | |
Static Public Attributes | |
static const ResourceType | RESOURCE_TYPE |
The resource type for a sound listener. More... | |
Additional Inherited Members | |
Protected Member Functions inherited from om::sound::acoustics::contexts::AcousticContextObject | |
AcousticContextObject () | |
Create a new acoustics context object that doesn't have an associated acoustics context. More... | |
AcousticContextObject (AcousticContext *newContext) | |
Create a new acoustics context object that uses the specified context for simulation. More... | |
Protected Attributes inherited from om::sound::acoustics::contexts::AcousticContextObject | |
AcousticContext * | context |
A pointer to the acoustics context this object is using. More... | |
A class that represents a sound listener in a virtual acoustic context.
om::sound::acoustics::objects::SoundListener::SoundListener | ( | ) |
Create a default sound listener positioned at the origin.
om::sound::acoustics::objects::SoundListener::SoundListener | ( | const Vector3f & | newPosition, |
Float | newRadius | ||
) |
Create a sound listener with the specified position and radius.
|
inline |
This is used to calibrate the volume of the listener's final sound output with respect to a normal listening level.
|
inline |
Set the conversion factor in decibels converting from pascals to full-scale digital audio (e.g. [-1,1]).
This is used to calibrate the volume of the listener's final sound output with respect to a normal listening level.
|
inline |
Return the channel layout that should be used for the listener's output audio.
|
inline |
Set the channel layout that should be used for the listener's output audio.
SoundResult om::sound::acoustics::objects::SoundListener::render | ( | SoundBuffer & | outputBuffer, |
Size | numSamples | ||
) | const |
Render the specified number of samples from this listener to an output buffer.
|
virtual |
Set a pointer to the acoustics context this context object should use to do simulation.
Reimplemented from om::sound::acoustics::contexts::AcousticContextObject.
|
inline |
Return the ID of this sound listener within its current acoustic context.
|
virtual |
Add internal context objects to the scene with the specified ID.
Reimplemented from om::sound::acoustics::objects::SoundSceneObject.
|
virtual |
Remove internal context objects from the scene with the specified ID.
Reimplemented from om::sound::acoustics::objects::SoundSceneObject.
|
static |
The resource type for a sound listener.