Packagespark.effects.interpolation
Classpublic class HSBInterpolator
InheritanceHSBInterpolator Inheritance Object
Implements IInterpolator

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

The HSBInterpolator class provides Hue, Saturation, and Brightness (HSB) color interpolation between RGB uint start and end values. Interpolation is done by treating the start and end values as integers with RGB color channel information in the least-significant 3 bytes, converting these to HSB values, and interpolating linearly for each of the h (hue), s (saturation), and b (brightness) parameters.

Because this interpolator may perform more calculations than a typical interpolator that is simply interpolating a given type, specifically to convert the RGB start and end values, this interpolator provides the option of supplying start and end values to the constructor. If you specify the start and end RGB values, then the conversions of these values is calculated once, and does not need to be done at every future call to the interpolate() method during the animation.



Public Methods
 MethodDefined By
  
HSBInterpolator(startRGB:uint, endRGB:uint)
Constructor.
HSBInterpolator
  
decrement(baseValue:Object, decrementValue:Object):Object
Returns the result of the two RGB values added together as HSB colors.
HSBInterpolator
  
[static] Returns the singleton of this class.
HSBInterpolator
  
increment(baseValue:Object, incrementValue:Object):Object
Returns the result of the two RGB values added together as HSB colors.
HSBInterpolator
  
interpolate(fraction:Number, startValue:Object, endValue:Object):Object
The interpolation for the HSBInterpolator class takes the form of parametric calculations on each of the three values h (hue), s (saturation), and b (brightness) of HSB colors derived from the start and end RGB colors.
HSBInterpolator
Constructor Detail
HSBInterpolator()Constructor
public function HSBInterpolator(startRGB:uint, endRGB:uint)

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

Constructor. The optional parameters for startRGB and endRGB help to optimize runtime performance by performing RGB to HSB conversions at construction time, instead of dynamically with every call to the interpolate() method.

Parameters
startRGB:uint (default = NaN) — The starting color, as an unsigned integer RGB value.
 
endRGB:uint (default = NaN) — The ending color, as an unsigned integer RGB value.
Method Detail
decrement()method
public function decrement(baseValue:Object, decrementValue:Object):Object

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

Returns the result of the two RGB values added together as HSB colors. Each value is converted to an HSB color first, and then each component (hue, saturation, and brightness) is treated individually. The saturation and brightness components are clamped to lie between 0 and 1, and the hue degrees are modulated by 360 to lie between 0 and 360.

Parameters

baseValue:Object — The start value of the interpolation.
 
decrementValue:Object — The change to apply to the baseValue.

Returns
Object — The interpolated value.
getInstance()method 
public static function getInstance():HSBInterpolator

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

Returns the singleton of this class.

Note that the singleton of the HSBInterpolator class might be less useful than separate instances of the class because separate instances can take advantage of precalculating the RGB to HSB conversions for the start and end colors.

Returns
HSBInterpolator — The singleton of the HSBInterpolator class.
increment()method 
public function increment(baseValue:Object, incrementValue:Object):Object

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

Returns the result of the two RGB values added together as HSB colors. Each value is converted to an HSB color first, and then each component (hue, saturation, and brightness) will be treated individually. The saturation and brightness components are clamped to lie between 0 and 1, and the hue degrees are modulated by 360 to lie between 0 and 360.

Parameters

baseValue:Object — The start value of the interpolation.
 
incrementValue:Object — The change to apply to the baseValue.

Returns
Object — The interpolated value.
interpolate()method 
public function interpolate(fraction:Number, startValue:Object, endValue:Object):Object

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

The interpolation for the HSBInterpolator class takes the form of parametric calculations on each of the three values h (hue), s (saturation), and b (brightness) of HSB colors derived from the start and end RGB colors.

Parameters

fraction:Number — The fraction elapsed of the animation, between 0.0 and 1.0.
 
startValue:Object — The start value of the interpolation.
 
endValue:Object — The end value of the interpolation.

Returns
Object — The interpolated value.