Class PointSoundSource

A specialized subclass of the BaseEffectSource which describes a point-based source of sound.

Mixes

Hierarchy (view full)

Constructors

constructor

Properties

object sourceId data shape suppression _flags sourceType effectsCollection defaultData

Accessors

effectsCollection x y elevation updateId active attached suppressed

Methods

_getPolygonConfiguration getVolumeMultiplier initialize _initialize refresh destroy add remove _createShapes _configure _refresh _destroy

Constructors

constructor

Properties

object

object: object

Some other object which is responsible for this source.

sourceId

sourceId: string

The source id linked to this effect source.

data

data: any = ...

The data of this source.

shape

shape: any

The geometric shape of the effect source which is generated later.

suppression

suppression: Record<string, boolean> = {}

Records of suppression strings with a boolean value. If any of this record is true, the source is suppressed.

Protected _flags

_flags: Record<string, number | boolean> = {}

A collection of boolean flags which control rendering and refresh behavior for the source.

Static sourceType

sourceType: string = "sound"

Static effectsCollection

effectsCollection: string

The target collection into the effects canvas group.

Abstract

Static defaultData

defaultData: SourceData = ...

Effect source default data.

Accessors

effectsCollection

  • get effectsCollection(): any

  • Returns any

x

  • get x(): number

  • The x-coordinate of the point source origin.

    Returns number

y

  • get y(): number

  • The y-coordinate of the point source origin.

    Returns number

elevation

  • get elevation(): number

  • The elevation bound to this source.

    Returns number

updateId

  • get updateId(): number

  • Returns the update ID associated with this source. The update ID is increased whenever the shape of the source changes.

    Returns number

active

  • get active(): boolean

  • Is this source currently active? A source is active if it is attached to an effect collection and is not disabled or suppressed.

    Returns boolean

attached

  • get attached(): boolean

  • Is this source attached to an effect collection?

    Returns boolean

suppressed

  • get suppressed(): boolean

  • Is this source temporarily suppressed?

    Returns boolean

Methods

_getPolygonConfiguration

  • _getPolygonConfiguration(): any

  • Returns any

    Inherit Doc

getVolumeMultiplier

  • getVolumeMultiplier(listener, options?): number

  • Get the effective volume at which an AmbientSound source should be played for a certain listener.

    Parameters

    • listener: Point
    • Optional options: {
          easing: boolean;
      } = {}
      • easing: boolean

    Returns number

initialize

  • initialize(data?, options?): BaseEffectSource<any, any>

  • Initialize and configure the source using provided data.

    Parameters

    • data: Partial<any> = {}

      Provided data for configuration

    • options: {
          behaviors: object;
          reset: boolean;
      } = {}

      Additional options which modify source initialization

      • behaviors: object

        An object containing optional behaviors to apply.

      • reset: boolean

        Should source data be reset to default values before applying changes?

    Returns BaseEffectSource<any, any>

    The initialized source

_initialize

  • _initialize(data): void

  • Subclass specific data initialization steps.

    Parameters

    • data: Partial<any>

      Provided data for configuration

    Returns void

    Abstract

refresh

  • refresh(): void

  • Refresh the state and uniforms of the source. Only active sources are refreshed.

    Returns void

destroy

  • destroy(): void

  • Steps that must be performed when the source is destroyed.

    Returns void

add

  • add(): void

  • Add this BaseEffectSource instance to the active collection.

    Returns void

remove

  • remove(): void

  • Remove this BaseEffectSource instance from the active collection.

    Returns void

Protected _createShapes

  • _createShapes(): void
  • Protected

    Create the polygon shape (or shapes) for this source using configured data.

    Returns void

    Abstract

Protected _configure

  • _configure(changes): void
  • Protected

    Subclass specific configuration steps. Occurs after data initialization and shape computation. Only called if the source is attached and not disabled.

    Parameters

    • changes: Partial<any>

      Changes to the source data which were applied

    Returns void

Protected _refresh

Protected _destroy

Settings

Member Visibility

Theme

On This Page

constructorobjectsourceIddatashapesuppression_flagssourceTypeeffectsCollectiondefaultDataeffectsCollectionxyelevationupdateIdactiveattachedsuppressed_getPolygonConfigurationgetVolumeMultiplierinitialize_initializerefreshdestroyaddremove_createShapes_configure_refresh_destroy