Android APIs
public class

PatternPathMotion

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

Class Overview

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
Attribute Name Related Method Description
android:patternPathData setPatternPath(Path) 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.
[Expand]
Inherited Methods
From class android.transition.PathMotion
From class java.lang.Object

XML Attributes

android:patternPathData

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

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

This may also be a reference to a resource (in the form "@[package:]type:name") or theme attribute (in the form "?[package:][type:]name") containing a value of this type.

This corresponds to the global attribute resource symbol patternPathData.

Related Methods

Public Constructors

public PatternPathMotion ()

Added in API level 21

Constructs a PatternPathMotion with a straight-line pattern.

public PatternPathMotion (Context context, AttributeSet attrs)

Added in API level 21

public PatternPathMotion (Path patternPath)

Added in API level 21

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 A Path to be used as a pattern for two-dimensional motion.

Public Methods

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

Added in API level 21

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

Parameters
startX The x coordinate of the starting point.
startY The y coordinate of the starting point.
endX The x coordinate of the ending point.
endY The y coordinate of the ending point.
Returns
  • A Path along which the points should be interpolated. The returned Path must start at point (startX, startY), typically using moveTo(float, float) and end at (endX, endY).

public Path getPatternPath ()

Added in API level 21

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
  • the Path defining a pattern of motion between two coordinates.

public void setPatternPath (Path patternPath)

Added in API level 21

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 A Path to be used as a pattern for two-dimensional motion.