Chapter 295: PropertyMixer

Core Idea

Buffered scene graph property that allows weighted accumulation; used internally.

binding : PropertyBinding: The property binding.
cumulativeWeight : number: Accumulated weight of the property binding.
cumulativeWeightAdditive : number: Accumulated additive weight of the property binding.
referenceCount : number: Number of keyframe tracks referencing this property binding.
useCount : number: Number of active keyframe tracks currently using this property binding.
valueSize : number: The keyframe track value size.

Constructor

Signature
`new PropertyMixer( binding : PropertyBinding, typeName : string, valueSize : number )`

Properties

Property	Description
`.binding : PropertyBinding`	The property binding.
`.cumulativeWeight : number`	Accumulated weight of the property binding.
`.cumulativeWeightAdditive : number`	Accumulated additive weight of the property binding.
`.referenceCount : number`	Number of keyframe tracks referencing this property binding.
`.useCount : number`	Number of active keyframe tracks currently using this property binding.
`.valueSize : number`	The keyframe track value size.

Methods

Method	Description
`.accumulate( accuIndex : number, weight : number )`	Accumulates data in the `incoming` region into `accu<i>`.
`.accumulateAdditive( weight : number )`	Accumulates data in the `incoming` region into `add`.
`.apply( accuIndex : number )`	Applies the state of `accu<i>` to the binding when accus differ.
`.restoreOriginalState()`	Applies the state previously taken via PropertyMixer#saveOriginalState to the binding.
`.saveOriginalState()`	Remembers the state of the bound property and copy it to both accus.

Most relevant properties: binding, cumulativeWeight, cumulativeWeightAdditive, referenceCount.
Key methods: accumulate, accumulateAdditive, apply, restoreOriginalState.