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.
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.
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.