ScaleAnimation


public class ScaleAnimation
extends Animation

java.lang.Object
   ↳ android.view.animation.Animation
     ↳ android.view.animation.ScaleAnimation


An animation that controls the scale of an object. You can specify the point to use for the center of scaling.

Summary

Inherited XML attributes

Inherited constants

Public constructors

ScaleAnimation(Context context, AttributeSet attrs)

Constructor used when a ScaleAnimation is loaded from a resource.

ScaleAnimation(float fromX, float toX, float fromY, float toY)

Constructor to use when building a ScaleAnimation from code

ScaleAnimation(float fromX, float toX, float fromY, float toY, float pivotX, float pivotY)

Constructor to use when building a ScaleAnimation from code

ScaleAnimation(float fromX, float toX, float fromY, float toY, int pivotXType, float pivotXValue, int pivotYType, float pivotYValue)

Constructor to use when building a ScaleAnimation from code

Public methods

void initialize(int width, int height, int parentWidth, int parentHeight)

Initialize this animation with the dimensions of the object being animated as well as the objects parents.

Protected methods

void applyTransformation(float interpolatedTime, Transformation t)

Helper for getTransformation.

Inherited methods

Public constructors

ScaleAnimation

Added in API level 1
public ScaleAnimation (Context context, 
                AttributeSet attrs)

Constructor used when a ScaleAnimation is loaded from a resource.

Parameters
context Context: Application context to use

attrs AttributeSet: Attribute set from which to read values

ScaleAnimation

Added in API level 1
public ScaleAnimation (float fromX, 
                float toX, 
                float fromY, 
                float toY)

Constructor to use when building a ScaleAnimation from code

Parameters
fromX float: Horizontal scaling factor to apply at the start of the animation

toX float: Horizontal scaling factor to apply at the end of the animation

fromY float: Vertical scaling factor to apply at the start of the animation

toY float: Vertical scaling factor to apply at the end of the animation

ScaleAnimation

Added in API level 1
public ScaleAnimation (float fromX, 
                float toX, 
                float fromY, 
                float toY, 
                float pivotX, 
                float pivotY)

Constructor to use when building a ScaleAnimation from code

Parameters
fromX float: Horizontal scaling factor to apply at the start of the animation

toX float: Horizontal scaling factor to apply at the end of the animation

fromY float: Vertical scaling factor to apply at the start of the animation

toY float: Vertical scaling factor to apply at the end of the animation

pivotX float: The X coordinate of the point about which the object is being scaled, specified as an absolute number where 0 is the left edge. (This point remains fixed while the object changes size.)

pivotY float: The Y coordinate of the point about which the object is being scaled, specified as an absolute number where 0 is the top edge. (This point remains fixed while the object changes size.)

ScaleAnimation

Added in API level 1
public ScaleAnimation (float fromX, 
                float toX, 
                float fromY, 
                float toY, 
                int pivotXType, 
                float pivotXValue, 
                int pivotYType, 
                float pivotYValue)

Constructor to use when building a ScaleAnimation from code

Parameters
fromX float: Horizontal scaling factor to apply at the start of the animation

toX float: Horizontal scaling factor to apply at the end of the animation

fromY float: Vertical scaling factor to apply at the start of the animation

toY float: Vertical scaling factor to apply at the end of the animation

pivotXType int: Specifies how pivotXValue should be interpreted. One of Animation.ABSOLUTE, Animation.RELATIVE_TO_SELF, or Animation.RELATIVE_TO_PARENT.

pivotXValue float: The X coordinate of the point about which the object is being scaled, specified as an absolute number where 0 is the left edge. (This point remains fixed while the object changes size.) This value can either be an absolute number if pivotXType is ABSOLUTE, or a percentage (where 1.0 is 100%) otherwise.

pivotYType int: Specifies how pivotYValue should be interpreted. One of Animation.ABSOLUTE, Animation.RELATIVE_TO_SELF, or Animation.RELATIVE_TO_PARENT.

pivotYValue float: The Y coordinate of the point about which the object is being scaled, specified as an absolute number where 0 is the top edge. (This point remains fixed while the object changes size.) This value can either be an absolute number if pivotYType is ABSOLUTE, or a percentage (where 1.0 is 100%) otherwise.

Public methods

initialize

Added in API level 1
public void initialize (int width, 
                int height, 
                int parentWidth, 
                int parentHeight)

Initialize this animation with the dimensions of the object being animated as well as the objects parents. (This is to support animation sizes being specified relative to these dimensions.)

Objects that interpret Animations should call this method when the sizes of the object being animated and its parent are known, and before calling getTransformation(long, Transformation).

Parameters
width int: Width of the object being animated

height int: Height of the object being animated

parentWidth int: Width of the animated object's parent

parentHeight int: Height of the animated object's parent

Protected methods

applyTransformation

Added in API level 1
protected void applyTransformation (float interpolatedTime, 
                Transformation t)

Helper for getTransformation. Subclasses should implement this to apply their transforms given an interpolation value. Implementations of this method should always replace the specified Transformation or document they are doing otherwise.

Parameters
interpolatedTime float: The value of the normalized time (0.0 to 1.0) after it has been run through the interpolation function.

t Transformation: The Transformation object to fill in with the current transforms.