mapbox-maps-android/com.mapbox.maps.plugin.animation/CameraAnimationsPluginImpl

CameraAnimationsPluginImpl

class CameraAnimationsPluginImpl : CameraAnimationsPlugin

CameraAnimationsPluginImpl is designed to rule all the animations happening to the map driven by changing CameraOptions. It is responsible for:

Storing all the ValueAnimator's that could be run. Only specific camera animators could be used in this plugin.
Controlling animation execution - only one ValueAnimator of certain type could be run at a time. If some another animation with same CameraAnimator.type is about to start previous one will be cancelled.
Giving possibility to listen to CameraOptions values changes during animations via listeners.
If several animations of different CameraAnimator.type are running simultaneously map camera will be updated only on oldest animation update (the oldest is the one that was started first). That actually means that animation start order matters. High-level animations flyTo and easeTo will always trigger camera center animator first.

CameraAnimationsPluginImpl is NOT thread-safe meaning all animations must be started from one thread. However, it doesn't have to be the UI thread.

Constructors

CameraAnimationsPluginImpl

androidJvm

fun CameraAnimationsPluginImpl()

Types

Companion

androidJvm

object Companion

Static variables and methods.

Functions

addCameraAnchorChangeListener

androidJvm

open override fun addCameraAnchorChangeListener(listener: CameraAnimatorNullableChangeListener<ScreenCoordinate?>)

Add CameraAnimatorNullableChangeListener to receive map anchor updates.

addCameraAnimationsLifecycleListener

androidJvm

open override fun addCameraAnimationsLifecycleListener(listener: CameraAnimationsLifecycleListener)

Add given CameraAnimationsLifecycleListener for capturing all events about animators lifecycle.

addCameraBearingChangeListener

androidJvm

open override fun addCameraBearingChangeListener(listener: CameraAnimatorChangeListener<Double>)

Add CameraAnimatorChangeListener to receive map bearing updates.

addCameraCenterChangeListener

androidJvm

open override fun addCameraCenterChangeListener(listener: CameraAnimatorChangeListener<Point>)

Add CameraAnimatorChangeListener to receive map center updates.

addCameraPaddingChangeListener

androidJvm

open override fun addCameraPaddingChangeListener(listener: CameraAnimatorChangeListener<EdgeInsets>)

Add CameraAnimatorChangeListener to receive map padding updates.

addCameraPitchChangeListener

androidJvm

open override fun addCameraPitchChangeListener(listener: CameraAnimatorChangeListener<Double>)

Add CameraAnimatorChangeListener to receive map pitch updates.

addCameraZoomChangeListener

androidJvm

open override fun addCameraZoomChangeListener(listener: CameraAnimatorChangeListener<Double>)

Add CameraAnimatorChangeListener to receive map zoom updates.

calculateScaleBy

androidJvm

open override fun calculateScaleBy(amount: Double, currentZoom: Double): Double

Calculate target zoom by applying scale

cancelAllAnimators

androidJvm

open override fun cancelAllAnimators(exceptOwnerList: List<String>)

Cancel all animators except ones owned by exceptOwnerList list.

cleanup

androidJvm

open override fun cleanup()

Called when the map is destroyed.

createAnchorAnimator

androidJvm

open override fun createAnchorAnimator(options: CameraAnimatorOptions<ScreenCoordinate>, block: ValueAnimator.() -> Unit?): ValueAnimator

Create CameraAnchorAnimator

createBearingAnimator

androidJvm

open override fun createBearingAnimator(options: CameraAnimatorOptions<Double>, useShortestPath: Boolean, block: ValueAnimator.() -> Unit?): ValueAnimator

Create CameraBearingAnimator.

createCenterAnimator

androidJvm

open override fun createCenterAnimator(options: CameraAnimatorOptions<Point>, block: ValueAnimator.() -> Unit?): ValueAnimator

Create CameraCenterAnimator.

createPaddingAnimator

androidJvm

open override fun createPaddingAnimator(options: CameraAnimatorOptions<EdgeInsets>, block: ValueAnimator.() -> Unit?): ValueAnimator

Create CameraPaddingAnimator.

createPitchAnimator

androidJvm

open override fun createPitchAnimator(options: CameraAnimatorOptions<Double>, block: ValueAnimator.() -> Unit?): ValueAnimator

Create CameraPitchAnimator.

createZoomAnimator

androidJvm

open override fun createZoomAnimator(options: CameraAnimatorOptions<Double>, block: ValueAnimator.() -> Unit?): ValueAnimator

Create CameraZoomAnimator

easeTo

androidJvm

open override fun easeTo(cameraOptions: CameraOptions, animationOptions: MapAnimationOptions?): Cancelable

Ease the map camera to a given camera options and animation options.

equals

androidJvm

open operator fun equals(other: Any?): Boolean

flyTo

androidJvm

open override fun flyTo(cameraOptions: CameraOptions, animationOptions: MapAnimationOptions?): Cancelable

Fly the map camera to a given camera options.

hashCode

androidJvm

open fun hashCode(): Int

initialize

androidJvm

open fun initialize()

moveBy

androidJvm

open override fun moveBy(screenCoordinate: ScreenCoordinate, animationOptions: MapAnimationOptions?): Cancelable

Move the map by a given screen coordinate with optional animation.

onDelegateProvider

androidJvm

open override fun onDelegateProvider(delegateProvider: MapDelegateProvider)

Provides all map delegate instances.

pitchBy

androidJvm

open override fun pitchBy(pitch: Double, animationOptions: MapAnimationOptions?): Cancelable

Pitch the map by with optional animation.

playAnimatorsSequentially

androidJvm

open override fun playAnimatorsSequentially(vararg animators: ValueAnimator)

Play given ValueAnimator's sequentially

playAnimatorsTogether

androidJvm

open override fun playAnimatorsTogether(vararg animators: ValueAnimator)

Play given ValueAnimator's together

registerAnimators

androidJvm

open override fun registerAnimators(vararg cameraAnimators: ValueAnimator)

Register given ValueAnimator's.

removeCameraAnchorChangeListener

androidJvm

open override fun removeCameraAnchorChangeListener(listener: CameraAnimatorNullableChangeListener<ScreenCoordinate?>)

Remove CameraAnimatorNullableChangeListener.

removeCameraAnimationsLifecycleListener

androidJvm

open override fun removeCameraAnimationsLifecycleListener(listener: CameraAnimationsLifecycleListener)

Remove given CameraAnimationsLifecycleListener for capturing all events about animators lifecycle.

removeCameraBearingChangeListener

androidJvm

open override fun removeCameraBearingChangeListener(listener: CameraAnimatorChangeListener<Double>)

Remove CameraAnimatorChangeListener.

removeCameraCenterChangeListener

androidJvm

open override fun removeCameraCenterChangeListener(listener: CameraAnimatorChangeListener<Point>)

Remove CameraAnimatorChangeListener.

removeCameraPaddingChangeListener

androidJvm

open override fun removeCameraPaddingChangeListener(listener: CameraAnimatorChangeListener<EdgeInsets>)

Remove CameraAnimatorChangeListener.

removeCameraPitchChangeListener

androidJvm

open override fun removeCameraPitchChangeListener(listener: CameraAnimatorChangeListener<Double>)

Remove CameraAnimatorChangeListener.

removeCameraZoomChangeListener

androidJvm

open override fun removeCameraZoomChangeListener(listener: CameraAnimatorChangeListener<Double>)

Remove CameraAnimatorChangeListener.

rotateBy

androidJvm

open override fun rotateBy(first: ScreenCoordinate, second: ScreenCoordinate, animationOptions: MapAnimationOptions?): Cancelable

Rotate the map by with optional animation.

scaleBy

androidJvm

open override fun scaleBy(amount: Double, screenCoordinate: ScreenCoordinate?, animationOptions: MapAnimationOptions?): Cancelable

Scale the map by with optional animation.

toString

androidJvm

open fun toString(): String

unregisterAllAnimators

androidJvm

fun unregisterAllAnimators()

Unregister all previously registered ValueAnimator's.

unregisterAnimators

androidJvm

open override fun unregisterAnimators(vararg cameraAnimators: ValueAnimator, cancelAnimators: Boolean)

Unregister given ValueAnimator's.

Properties

anchor

androidJvm

open override var anchor: ScreenCoordinate?

Map camera anchor value.

cameraAnimationsFactory

androidJvm

lateinit var cameraAnimationsFactory: CameraAnimatorsFactory

Factory to provide animators for the default animations like easeTo, scaleBy, moveBy, rotateBy, pitchBy

debugMode

androidJvm

open override var debugMode: Boolean = false

If debug mode is enabled extra logs will be written about animation lifecycle and some other events that may be useful for debugging.