PatternPathMotion


public class PatternPathMotion
extends PathMotion

java.lang.Object
   ↳ android.transition.PathMotion
     ↳ android.transition.PatternPathMotion


A PathMotion that takes a Path pattern and applies it to the separation between two points. The starting point of the Path will be moved to the origin and the end point will be scaled and rotated so that it matches with the target end point.

This may be used in XML as an element inside a transition.

<changeBounds>
     <patternPathMotion android:patternPathData="M0 0 L0 100 L100 100"/>
 </changeBounds>
 

Summary

XML attributes

android:patternPathData The path string describing the pattern to use for the PathPathMotion. 

Public constructors

PatternPathMotion()

Constructs a PatternPathMotion with a straight-line pattern.

PatternPathMotion(Context context, AttributeSet attrs)
PatternPathMotion(Path patternPath)

Creates a PatternPathMotion with the Path defining a pattern of motion between two coordinates.

Public methods

Path getPath(float startX, float startY, float endX, float endY)

Provide a Path to interpolate between two points (startX, startY) and (endX, endY).

Path getPatternPath()

Returns the Path defining a pattern of motion between two coordinates.

void setPatternPath(Path patternPath)

Sets the Path defining a pattern of motion between two coordinates.

Inherited methods

abstract Path getPath(float startX, float startY, float endX, float endY)

Provide a Path to interpolate between two points (startX, startY) and (endX, endY).

Object clone()

Creates and returns a copy of this object.

boolean equals(Object obj)

Indicates whether some other object is "equal to" this one.

void finalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

final Class<?> getClass()

Returns the runtime class of this Object.

int hashCode()

Returns a hash code value for the object.

final void notify()

Wakes up a single thread that is waiting on this object's monitor.

final void notifyAll()

Wakes up all threads that are waiting on this object's monitor.

String toString()

Returns a string representation of the object.

final void wait(long timeoutMillis, int nanos)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait(long timeoutMillis)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait()

Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

XML attributes

android:patternPathData

The path string describing the pattern to use for the PathPathMotion.

May be a string value, using '\\;' to escape characters such as '\\n' or '\\uxxxx' for a unicode character;

Related methods:

Public constructors

PatternPathMotion

Added in API level 21
public PatternPathMotion ()

Constructs a PatternPathMotion with a straight-line pattern.

PatternPathMotion

Added in API level 21
public PatternPathMotion (Context context, 
                AttributeSet attrs)

Parameters
context Context

attrs AttributeSet

PatternPathMotion

Added in API level 21
public PatternPathMotion (Path patternPath)

Creates a PatternPathMotion with the Path defining a pattern of motion between two coordinates. The pattern will be translated, rotated, and scaled to fit between the start and end points. The pattern must not be empty and must have the end point differ from the start point.

Parameters
patternPath Path: A Path to be used as a pattern for two-dimensional motion.

Public methods

getPath

Added in API level 21
public Path getPath (float startX, 
                float startY, 
                float endX, 
                float endY)

Provide a Path to interpolate between two points (startX, startY) and (endX, endY). This allows controlled curved motion along two dimensions.

Parameters
startX float: The x coordinate of the starting point.

startY float: The y coordinate of the starting point.

endX float: The x coordinate of the ending point.

endY float: The y coordinate of the ending point.

Returns
Path A Path along which the points should be interpolated. The returned Path must start at point (startX, startY), typically using Path.moveTo(float, float) and end at (endX, endY).

getPatternPath

Added in API level 21
public Path getPatternPath ()

Returns the Path defining a pattern of motion between two coordinates. The pattern will be translated, rotated, and scaled to fit between the start and end points. The pattern must not be empty and must have the end point differ from the start point.

Related XML Attributes:

Returns
Path the Path defining a pattern of motion between two coordinates.

setPatternPath

Added in API level 21
public void setPatternPath (Path patternPath)

Sets the Path defining a pattern of motion between two coordinates. The pattern will be translated, rotated, and scaled to fit between the start and end points. The pattern must not be empty and must have the end point differ from the start point.

Related XML Attributes:

Parameters
patternPath Path: A Path to be used as a pattern for two-dimensional motion.