MicrophoneBvr Class

Creates an object that represents a microphone behavior. A microphone is used with the render method to produce spatialized sound behaviors from sounds embedded in a geometry.

Every microphone has a location and an orientation in a three-dimensional space, and this location determines how a sound is detected. The closer a microphone is to the source of a sound, the louder and sooner the microphone detects that sound. The effect is to "spatialize" the sound, that is, make it seem that it was actually recorded in a three-dimensional space.

For the default microphone, the location is the origin, looking in the negative z-direction, with positive y considered up. You can create new microphones at different locations by using the transform method. Microphones are omnidirectional.

For more information about behaviors, see the Behavior class.

For relevant fields from the Statics class, see Statics Fields Relevant to MicrophoneBvr Objects.

MicrophoneBvr Methods

transform Creates a new microphone behavior that is the result of applying the given transformation to the original microphone's location.

newUninitBvr Enables you to refer to a MicrophoneBvr behavior before that behavior has been defined.

transform

MicrophoneBvr Class

Creates a new microphone behavior that is the result of applying the given transformation to the original microphone's location.

Syntax

public MicrophoneBvr transform( Transform3Bvr xf );

Parameters

xf
Transform3Bvr object.

Return Value

Returns the MicrophoneBvr object.

Remarks

This attribute composes values.

newUninitBvr

MicrophoneBvr Class

Enables you to refer to a MicrophoneBvr behavior before that behavior has been defined. With this method you can create the behavior and use it in the definition of other behaviors, but not actually define its contents until some later point. (This is accomplished with the init method, which is available on all behaviors.) The system generates a run-time error if you initialize a non-uninitialized behavior, initialize an uninitialized behavior that has already been initialized, or run an initialized behavior that has not yet been initialized.

Syntax

public static MicrophoneBvr newUninitBvr( );

Return Value

Returns the MicrophoneBvr object.