# CircularPropagation

Artifact: [androidx.transition:transition](https://developer.android.com/jetpack/androidx/releases/transition) [View Source](https://cs.android.com/search?q=file:androidx/transition/CircularPropagation.java+class:androidx.transition.CircularPropagation) Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/transition#1.0.0)

*** ** * ** ***


```
public class CircularPropagation extends VisibilityPropagation
```

<br />

|---|---|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object.html) ||||
| ↳ | [androidx.transition.TransitionPropagation](https://developer.android.com/reference/androidx/transition/TransitionPropagation) |||
|   | ↳ | [androidx.transition.VisibilityPropagation](https://developer.android.com/reference/androidx/transition/VisibilityPropagation) ||
|   |   | ↳ | [androidx.transition.CircularPropagation](https://developer.android.com/reference/androidx/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/androidx/transition/Explode`.

## Summary

| ### Public constructors |
|---|
| `https://developer.android.com/reference/androidx/transition/CircularPropagation#CircularPropagation()()` |

| ### Public methods |
|---|---|
| `long` | `https://developer.android.com/reference/androidx/transition/CircularPropagation#getStartDelay(android.view.ViewGroup,androidx.transition.Transition,androidx.transition.TransitionValues,androidx.transition.TransitionValues)( @https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/view/ViewGroup.html sceneRoot, @https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/transition/Transition transition, @https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/androidx/transition/TransitionValues startValues, @https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/androidx/transition/TransitionValues endValues )` Called by Transition to alter the Animator start delay. |
| `void` | `https://developer.android.com/reference/androidx/transition/CircularPropagation#setPropagationSpeed(float)(float propagationSpeed)` Sets the speed at which transition propagation happens, relative to the duration of the Transition. |

| ### Inherited methods |
|---|
| From [androidx.transition.VisibilityPropagation](https://developer.android.com/reference/androidx/transition/VisibilityPropagation) |---|---| | `void` | `https://developer.android.com/reference/androidx/transition/VisibilityPropagation#captureValues(androidx.transition.TransitionValues)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/transition/TransitionValues transitionValues)` Captures the values in the start or end scene for the properties that this transition propagation monitors. | | `@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html String[]` | `https://developer.android.com/reference/androidx/transition/VisibilityPropagation#getPropagationProperties()()` Returns the set of property names stored in the `https://developer.android.com/reference/androidx/transition/TransitionValues` object passed into `https://developer.android.com/reference/androidx/transition/TransitionPropagation#captureValues(androidx.transition.TransitionValues)` that this transition propagation cares about for the purposes of preventing duplicate capturing of property values. | | `int` | `https://developer.android.com/reference/androidx/transition/VisibilityPropagation#getViewVisibility(androidx.transition.TransitionValues)(@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/androidx/transition/TransitionValues values)` Returns `https://developer.android.com/reference/android/view/View.html#getVisibility()` for the View at the time the values were captured. | | `int` | `https://developer.android.com/reference/androidx/transition/VisibilityPropagation#getViewX(androidx.transition.TransitionValues)(@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/androidx/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/androidx/transition/VisibilityPropagation#getViewY(androidx.transition.TransitionValues)(@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/androidx/transition/TransitionValues values)` Returns the View's center y coordinate, relative to the screen, at the time the values were captured. | |

## Public constructors

### CircularPropagation

Added in 1.0.0

```
public CircularPropagation()
```

## Public methods

### getStartDelay

```
public long getStartDelay(
    @NonNull ViewGroup sceneRoot,
    @NonNull Transition transition,
    @Nullable TransitionValues startValues,
    @Nullable TransitionValues endValues
)
```

Called by Transition to alter the Animator start delay. All start delays will be adjusted such that the minimum becomes zero.

| Parameters |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/view/ViewGroup.html sceneRoot` | The root of the View hierarchy running the transition. |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/transition/Transition transition` | The transition that created the Animator |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/androidx/transition/TransitionValues startValues` | The values for a specific target in the start scene. |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/androidx/transition/TransitionValues endValues` | 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 [1.0.0](https://developer.android.com/jetpack/androidx/releases/transition#1.0.0)

```
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 |
|---|---|
| `float propagationSpeed` | 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. |