Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Ctors](https://developer.android.com/reference/android/transition/CircularPropagation#pubctors) \| [Methods](https://developer.android.com/reference/android/transition/CircularPropagation#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/transition/CircularPropagation#inhmethods)
# CircularPropagation
*** ** * ** ***
[Kotlin](https://developer.android.com/reference/kotlin/android/transition/CircularPropagation "View this page in Kotlin") \|Java
`
public
class
CircularPropagation
`
`
`
`
`
`
extends https://developer.android.com/reference/android/transition/VisibilityPropagation
`
`
`
|---|---|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||||
| ↳ | [android.transition.TransitionPropagation](https://developer.android.com/reference/android/transition/TransitionPropagation) |||
| | ↳ | [android.transition.VisibilityPropagation](https://developer.android.com/reference/android/transition/VisibilityPropagation) ||
| | | ↳ | android.transition.CircularPropagation |
*** ** * ** ***
A propagation that varies with the distance to the epicenter of the Transition
or center of the scene if no epicenter exists. When a View is visible in the
start of the transition, Views farther from the epicenter will transition
sooner than Views closer to the epicenter. When a View is not in the start
of the transition or is not visible at the start of the transition, it will
transition sooner when closer to the epicenter and later when farther from
the epicenter. This is the default TransitionPropagation used with
`https://developer.android.com/reference/android/transition/Explode`.
## Summary
| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/android/transition/CircularPropagation#CircularPropagation()() ` |
| ### Public methods ||
|---|---|
| ` long` | ` https://developer.android.com/reference/android/transition/CircularPropagation#getStartDelay(android.view.ViewGroup,%20android.transition.Transition,%20android.transition.TransitionValues,%20android.transition.TransitionValues)(https://developer.android.com/reference/android/view/ViewGroup sceneRoot, https://developer.android.com/reference/android/transition/Transition transition, https://developer.android.com/reference/android/transition/TransitionValues startValues, https://developer.android.com/reference/android/transition/TransitionValues endValues) ` Called by Transition to alter the Animator start delay. |
| ` void` | ` https://developer.android.com/reference/android/transition/CircularPropagation#setPropagationSpeed(float)(float propagationSpeed) ` Sets the speed at which transition propagation happens, relative to the duration of the Transition. |
| ### Inherited methods |
|---|---|
| From class ` https://developer.android.com/reference/android/transition/VisibilityPropagation ` |---|---| | ` void` | ` https://developer.android.com/reference/android/transition/VisibilityPropagation#captureValues(android.transition.TransitionValues)(https://developer.android.com/reference/android/transition/TransitionValues values) ` Captures the values in the start or end scene for the properties that this transition propagation monitors. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/transition/VisibilityPropagation#getPropagationProperties()() ` Returns the set of property names stored in the `https://developer.android.com/reference/android/transition/TransitionValues` object passed into `https://developer.android.com/reference/android/transition/TransitionPropagation#captureValues(android.transition.TransitionValues)` that this transition propagation cares about for the purposes of preventing duplicate capturing of property values. | | ` int` | ` https://developer.android.com/reference/android/transition/VisibilityPropagation#getViewVisibility(android.transition.TransitionValues)(https://developer.android.com/reference/android/transition/TransitionValues values) ` Returns `https://developer.android.com/reference/android/view/View#getVisibility()` for the View at the time the values were captured. | | ` int` | ` https://developer.android.com/reference/android/transition/VisibilityPropagation#getViewX(android.transition.TransitionValues)(https://developer.android.com/reference/android/transition/TransitionValues values) ` Returns the View's center x coordinate, relative to the screen, at the time the values were captured. | | ` int` | ` https://developer.android.com/reference/android/transition/VisibilityPropagation#getViewY(android.transition.TransitionValues)(https://developer.android.com/reference/android/transition/TransitionValues values) ` Returns the View's center y coordinate, relative to the screen, at the time the values were captured. | ||
| From class ` https://developer.android.com/reference/android/transition/TransitionPropagation ` |---|---| | ` abstract void` | ` https://developer.android.com/reference/android/transition/TransitionPropagation#captureValues(android.transition.TransitionValues)(https://developer.android.com/reference/android/transition/TransitionValues transitionValues) ` Captures the values in the start or end scene for the properties that this transition propagation monitors. | | ` abstract https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/transition/TransitionPropagation#getPropagationProperties()() ` Returns the set of property names stored in the `https://developer.android.com/reference/android/transition/TransitionValues` object passed into `https://developer.android.com/reference/android/transition/TransitionPropagation#captureValues(android.transition.TransitionValues)` that this transition propagation cares about for the purposes of preventing duplicate capturing of property values. | | ` abstract long` | ` https://developer.android.com/reference/android/transition/TransitionPropagation#getStartDelay(android.view.ViewGroup,%20android.transition.Transition,%20android.transition.TransitionValues,%20android.transition.TransitionValues)(https://developer.android.com/reference/android/view/ViewGroup sceneRoot, https://developer.android.com/reference/android/transition/Transition transition, https://developer.android.com/reference/android/transition/TransitionValues startValues, https://developer.android.com/reference/android/transition/TransitionValues endValues) ` Called by Transition to alter the Animator start delay. | ||
| From class ` https://developer.android.com/reference/java/lang/Object ` |---|---| | ` https://developer.android.com/reference/java/lang/Object` | ` https://developer.android.com/reference/java/lang/Object#clone()() ` Creates and returns a copy of this object. | | ` boolean` | ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` https://developer.android.com/reference/java/lang/Object#finalize()() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final https://developer.android.com/reference/java/lang/Class` | ` https://developer.android.com/reference/java/lang/Object#getClass()() ` Returns the runtime class of this `Object`. | | ` int` | ` https://developer.android.com/reference/java/lang/Object#hashCode()() ` Returns a hash code value for the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notify()() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notifyAll()() ` Wakes up all threads that are waiting on this object's monitor. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/lang/Object#toString()() ` Returns a string representation of the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(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` | ` https://developer.android.com/reference/java/lang/Object#wait(long)(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` | ` https://developer.android.com/reference/java/lang/Object#wait()() ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*. | ||
## Public constructors
### CircularPropagation
```
public CircularPropagation ()
```
## Public methods
### getStartDelay
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public long getStartDelay (ViewGroup sceneRoot,
Transition transition,
TransitionValues startValues,
TransitionValues endValues)
```
Called by Transition to alter the Animator start delay. All start delays will be adjusted
such that the minimum becomes zero.
| Parameters ||
|---|---|
| `sceneRoot` | `ViewGroup`: The root of the View hierarchy running the transition.
|
| `transition` | `Transition`: The transition that created the Animator
|
| `startValues` | `TransitionValues`: The values for a specific target in the start scene.
|
| `endValues` | `TransitionValues`: The values for the target in the end scene.
|
| Returns ||
|---|---|
| `long` | A start delay to use with the Animator created by `transition`. The delay will be offset by the minimum delay of all `TransitionPropagation`s used in the Transition so that the smallest delay will be 0. Returned values may be negative.
|
### setPropagationSpeed
Added in [API level 21](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public void setPropagationSpeed (float propagationSpeed)
```
Sets the speed at which transition propagation happens, relative to the duration of the
Transition. A `propagationSpeed` of 1 means that a View centered farthest from
the epicenter and View centered at the epicenter will have a difference
in start delay of approximately the duration of the Transition. A speed of 2 means the
start delay difference will be approximately half of the duration of the transition. A
value of 0 is illegal, but negative values will invert the propagation.
| Parameters ||
|---|---|
| `propagationSpeed` | `float`: The speed at which propagation occurs, relative to the duration of the transition. A speed of 4 means it works 4 times as fast as the duration of the transition. May not be 0.
|