Packageorg.si.sound
Classpublic class SoundObjectContainer
InheritanceSoundObjectContainer Inheritance SoundObject Inheritance flash.events.EventDispatcher

The SoundObjectContainer class is the base class for all objects that can serve as sound object containers on the sound list.



Public Properties
 PropertyDefined By
 InheritedcoarseTune : int
Master coarse tuning, 1 for half-tone.
SoundObject
 Inheriteddelay : Number
Sound delay, uint in 16th beat.
SoundObject
 Inheriteddriver : SiONDriver
[read-only] SiONDriver instrance to operate.
SoundObject
 Inheritedeffectors : Array
Array of SiEffectBase to modify this sound object's output.
SoundObject
 InheritedeffectSend1 : Number
Channel effect send level for slot 1 (0:Minimum - 1:Maximum), this property can control track after play().
SoundObject
 InheritedeffectSend2 : Number
Channel effect send level for slot 2 (0:Minimum - 1:Maximum), this property can control track after play().
SoundObject
 InheritedeffectSend3 : Number
Channel effect send level for slot 3 (0:Minimum - 1:Maximum), this property can control track after play().
SoundObject
 InheritedeffectSend4 : Number
Channel effect send level for slot 4 (0:Minimum - 1:Maximum), this property can control track after play().
SoundObject
 InheritedeventMask : int
Track event mask.
SoundObject
 InheritedeventTriggerID : int
Track event trigger ID
SoundObject
 InheritedfineTune : Number
Master fine tuning, 1 for half-tone, you can specify fineTune<-1 or fineTune>1.
SoundObject
 InheritedgateTime : Number
Track gate time (0:Minimum - 1:Maximum).
SoundObject
 InheritedisPlaying : Boolean
[read-only] is playing ?
SoundObject
 Inheritedlength : Number
Sound length in 16th beat, 0 sets inifinity length.
SoundObject
 Inheritedmute : Boolean
Channel mute, this property can control track after play().
SoundObject
 Inheritedname : String
Name.
SoundObject
 Inheritednote : int
Base note of this sound
SoundObject
 InheritednoteOffTriggerType : int
[read-only] Track note off trigger type
SoundObject
 InheritednoteOnTriggerType : int
[read-only] Track note on trigger type
SoundObject
  numChildren : int
[read-only] Returns the number of children of this object.
SoundObjectContainer
 Inheritedpan : Number
Channel panning (-1:Left - 0:Center - +1:Right), this property can control track after play().
SoundObject
 Inheritedparent : SoundObjectContainer
[read-only] parent container.
SoundObject
 InheritedpitchBend : Number
Channel pitch bend, 1 for halftone, this property can control track after play().
SoundObject
 Inheritedquantize : Number
Synchronizing quantizing, uint in 16th beat.
SoundObject
 Inheritedsynthesizer : VoiceReference
Synthesizer to generate sound
SoundObject
 InheritedtrackID : int
[read-only] Track id
SoundObject
 Inheritedvoice : SiONVoice
Voice data to play
SoundObject
 Inheritedvolume : Number
Channel volume (0:Minimum - 1:Maximum), this property can control track after play().
SoundObject
Public Methods
 MethodDefined By
  
constructor.
SoundObjectContainer
  
Adds a child SoundObject instance to this SoundObjectContainer instance.
SoundObjectContainer
  
Adds a child SoundObject instance to this SoundObjectContainer instance.
SoundObjectContainer
 Inherited
fadeIn(time:Number):void
Set fading in.
SoundObject
 Inherited
fadeOut(time:Number):void
Set fading out.
SoundObject
  
Returns the child sound object instance that exists at the specified index.
SoundObjectContainer
  
Returns the child sound object that exists with the specified name.
SoundObjectContainer
  
Returns the index position of a child SoundObject instance.
SoundObjectContainer
  
play():void
[override] Play all children sound.
SoundObjectContainer
  
Removes the specified child SoundObject instance from the child list of the SoundObjectContainer instance.
SoundObjectContainer
  
Removes a child SoundObject from the specified index position in the child list of the SoundObjectContainer.
SoundObjectContainer
  
reset():void
[override] Reset
SoundObjectContainer
  
Changes the position of an existing child in the sound object container.
SoundObjectContainer
  
setVolume(slot:int, volume:Number):void
[override] Set all children's volume by index.
SoundObjectContainer
  
stop():void
[override] Stop all children sound.
SoundObjectContainer
Events
 Event Summary Defined By
 Inherited Dispatch when the sound ends.SoundObject
 Inherited Dispatch when the note off appears in the sequence.SoundObject
 Inherited Dispatch when the sound starts.SoundObject
 Inherited Dispatch when the note on appears.SoundObject
Property Detail
numChildrenproperty
numChildren:int  [read-only]

Returns the number of children of this object.


Implementation
    public function get numChildren():int
Constructor Detail
SoundObjectContainer()Constructor
public function SoundObjectContainer(name:String)

constructor.

Parameters
name:String
Method Detail
addChild()method
public function addChild(sound:SoundObject):SoundObject

Adds a child SoundObject instance to this SoundObjectContainer instance. The added sound object will play sound during this container is playing. The child is added to the end of all other children in this SoundObjectContainer instance. (To add a child to a specific index position, use the addChildAt() method.) If you add a child object that already has a different sound object container as a parent, the object is removed from the child list of the other sound object container.

Parameters

sound:SoundObject — The SoundObject instance to add as a child of this SoundObjectContainer instance.

Returns
SoundObject — The SoundObject instance that you pass in the sound parameter
addChildAt()method 
public function addChildAt(sound:SoundObject, index:int):SoundObject

Adds a child SoundObject instance to this SoundObjectContainer instance. The added sound object will play sound during this container is playing. The child is added at the index position specified. An index of 0 represents the head of the sound list for this SoundObjectContainer object.

Parameters

sound:SoundObject — The SoundObject instance to add as a child of this SoundObjectContainer instance.
 
index:int — The index position to which the child is added. If you specify a currently occupied index position, the child object that exists at that position and all higher positions are moved up one position in the child list.

Returns
SoundObject — The child sound object at the specified index position.
getChildAt()method 
public function getChildAt(index:int):SoundObject

Returns the child sound object instance that exists at the specified index.

Parameters

index:int — child index of the SoundObject to find.

Returns
SoundObject — founded SoundObject instance.
getChildByName()method 
public function getChildByName(name:String):SoundObject

Returns the child sound object that exists with the specified name. If more than one child sound object has the specified name, the method returns the first object in the child list.

Parameters

name:String — child name of the SoundObject to find.

Returns
SoundObject — founded SoundObject instance. Returns null if its not found.
getChildIndex()method 
public function getChildIndex(sound:SoundObject):Number

Returns the index position of a child SoundObject instance.

Parameters

sound:SoundObject — The SoundObject instance want to know.

Returns
Number — index of specifyed SoundObject. Returns -1 if its not found.
play()method 
override public function play():void

Play all children sound.

removeChild()method 
public function removeChild(sound:SoundObject):SoundObject

Removes the specified child SoundObject instance from the child list of the SoundObjectContainer instance. The removed sound object always stops. The parent property of the removed child is set to null, and the object is garbage collected if no other references to the child exist. The index positions of any sound objects after the child in the SoundObjectContainer are decreased by 1.

Parameters

sound:SoundObject — The DisplayObject instance to remove

Returns
SoundObject — The SoundObject instance that you pass in the sound parameter.
removeChildAt()method 
public function removeChildAt(index:int):SoundObject

Removes a child SoundObject from the specified index position in the child list of the SoundObjectContainer. The removed sound object always stops. The parent property of the removed child is set to null, and the object is garbage collected if no other references to the child exist. The index positions of any display objects above the child in the DisplayObjectContainer are decreased by 1.

Parameters

index:int — child index of the SoundObject to remove.

Returns
SoundObject — The SoundObject instance that was removed.
reset()method 
override public function reset():void

Reset

setChildIndex()method 
public function setChildIndex(child:SoundObject, index:int):SoundObject

Changes the position of an existing child in the sound object container. This affects the processing order of child objects.

Parameters

child:SoundObject — The child SoundObject instance for which you want to change the index number.
 
index:int — The resulting index number for the child sound object.

Returns
SoundObject
setVolume()method 
override public function setVolume(slot:int, volume:Number):void

Set all children's volume by index.

Parameters

slot:int — streaming slot number.
 
volume:Number — volume (0:Minimum - 1:Maximum).

stop()method 
override public function stop():void

Stop all children sound.