MapCameraKeyframeTrack (API Reference)
Class MapCameraKeyframeTrack
Stores keyframes for interpolation of a camera property using a specific easing function and interpolation mode. Can only hold keyframes of a single type.
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic enumDescribes a reason for failing to create a MapCameraKeyframeTrack.static final classThrown when a problem occurs while trying to createMapCameraKeyframeTrack. -
Method Summary
Modifier and TypeMethodDescriptionstatic MapCameraKeyframeTrackfieldOfView(List<ScalarKeyframe> keyframes, Easing easing, KeyframeInterpolationMode interpolationMode) Creates a map camera field-of-view keyframe track.Gets the interpolation mode for the between key frames in the track.static MapCameraKeyframeTracklookAtDistance(MapMeasure.Kind distanceKind, List<ScalarKeyframe> keyframes, Easing easing, KeyframeInterpolationMode interpolationMode) Creates a map camera look-at distance keyframe track.static MapCameraKeyframeTracklookAtDistance(List<ScalarKeyframe> keyframes, Easing easing, KeyframeInterpolationMode interpolationMode) Deprecated.Will be removed in v4.27.0.static MapCameraKeyframeTracklookAtOrientation(List<GeoOrientationKeyframe> keyframes, Easing easing, KeyframeInterpolationMode interpolationMode) Creates a map camera look-at orientation keyframe track.static MapCameraKeyframeTracklookAtTarget(List<GeoCoordinatesKeyframe> keyframes, Easing easing, KeyframeInterpolationMode interpolationMode) Creates a map camera look-at target keyframe track.static MapCameraKeyframeTracknormalizedPrincipalPoint(List<Anchor2DKeyframe> keyframes, Easing easing, KeyframeInterpolationMode interpolationMode) Creates a map camera principal point keyframe track.static MapCameraKeyframeTrackprincipalPoint(List<Point2DKeyframe> keyframes, Easing easing, KeyframeInterpolationMode interpolationMode) Creates a map camera principal point keyframe track.
-
Method Details
-
getScalarKeyframes
- Returns:
a copy of the scalar keyframes or nothing if this is not a scalar keyframe track.
-
getPoint2DKeyframes
- Returns:
a copy of the point 2d keyframes or nothing if this is not a point 2d keyframe track.
-
getAnchor2DKeyframes
- Returns:
a copy of the anchor 2d keyframes or nothing if this is not an anchor 2d keyframe track.
-
getGeoCoordinatesKeyframes
- Returns:
a copy of the geo coordinates keyframes or nothing if this is not a geo coordinates keyframe track.
-
getGeoOrientationKeyframes
- Returns:
a copy of the geo orientation keyframes or nothing if this is not a geo orientation keyframe track.
-
lookAtDistance
@Deprecated @NonNull public static MapCameraKeyframeTrack lookAtDistance(@NonNull List<ScalarKeyframe> keyframes, @NonNull Easing easing, @NonNull KeyframeInterpolationMode interpolationMode) throws MapCameraKeyframeTrack.InstantiationException Deprecated.Will be removed in v4.27.0. Use
, Easing, KeyframeInterpolationMode) instead. Creates a map camera look-at distance keyframe track. It enables animations of the distance from the map camera to the target point that the camera looks at in meters. The values will be clamped according to the minimum and maximum zoom levels set for the map camera.
- Parameters:
keyframes-The list of keyframes that specify how the camera property is changed. Keyframe time offsets are considered to be relative to the previous keyframe in the list or relative to the start of the animation if the current keyframe is first in the list. Time offset of the first keyframe in the list should be 0, otherwise an error occurs and creation of the keyframe track will fail.
easing-The easing to apply during keyframe interpolation.
interpolationMode-The type of interpolation done between keyframe values.
- Returns:
A keyframe track over the distance from the map camera to its target.
- Throws:
MapCameraKeyframeTrack.InstantiationException-Indicates an instantiation issue.
-
lookAtDistance
@NonNull public static MapCameraKeyframeTrack lookAtDistance(@NonNull MapMeasure.Kind distanceKind, @NonNull List<ScalarKeyframe> keyframes, @NonNull Easing easing, @NonNull KeyframeInterpolationMode interpolationMode) throws MapCameraKeyframeTrack.InstantiationException Creates a map camera look-at distance keyframe track. It enables animations of the distance from the map camera to the target point that the camera looks at. The measure kind of that distance can be specified. The values will be clamped according to the minimum and maximum zoom levels set for the map camera.
- Parameters:
distanceKind-The kind of measure of distance between camera and target point.
keyframes-The list of keyframes that specify how the camera property is changed. Keyframe time offsets are considered to be relative to the previous keyframe in the list or relative to the start of the animation if the current keyframe is first in the list. Time offset of the first keyframe in the list should be 0, otherwise an error occurs and creation of the keyframe track will fail.
easing-The easing to apply during keyframe interpolation.
interpolationMode-The type of interpolation done between keyframe values.
- Returns:
A keyframe track over the distance from the map camera to its target.
- Throws:
MapCameraKeyframeTrack.InstantiationException-Indicates an instantiation issue.
-
lookAtTarget
@NonNull public static MapCameraKeyframeTrack lookAtTarget(@NonNull List<GeoCoordinatesKeyframe> keyframes, @NonNull Easing easing, @NonNull KeyframeInterpolationMode interpolationMode) throws MapCameraKeyframeTrack.InstantiationException Creates a map camera look-at target keyframe track. It enables animations over the geographical coordinates of the target point that the map camera is looking at. Altitude components of coordinates are ignored.
- Parameters:
keyframes-The list of keyframes that specify how the camera property is changed. Keyframe time offsets are considered to be relative to the previous keyframe in the list or relative to the start of the animation if the current keyframe is first in the list. Time offset of the first keyframe in the list should be 0, otherwise an error occurs and creation of the keyframe track will fail.
easing-The easing to apply during keyframe interpolation.
interpolationMode-The type of interpolation done between keyframe values.
- Returns:
A keyframe track over the map camera target coordinates.
- Throws:
MapCameraKeyframeTrack.InstantiationException-Indicates an instantiation issue.
-
lookAtOrientation
@NonNull public static MapCameraKeyframeTrack lookAtOrientation(@NonNull List<GeoOrientationKeyframe> keyframes, @NonNull Easing easing, @NonNull KeyframeInterpolationMode interpolationMode) throws MapCameraKeyframeTrack.InstantiationException Creates a map camera look-at orientation keyframe track. It enables animations over the orientation of the map camera target (bearing and tilt).
- Parameters:
keyframes-The list of keyframes that specify how the camera property is changed. Keyframe time offsets are considered to be relative to the previous keyframe in the list or relative to the start of the animation if the current keyframe is first in the list. Time offset of the first keyframe in the list should be 0, otherwise an error occurs and creation of the keyframe track will fail.
easing-The easing to apply during keyframe interpolation.
interpolationMode-The type of interpolation done between keyframe values.
- Returns:
A keyframe track over the map camera target orientation.
- Throws:
MapCameraKeyframeTrack.InstantiationException-Indicates an instantiation issue.
-
principalPoint
@NonNull public static MapCameraKeyframeTrack principalPoint(@NonNull List<Point2DKeyframe> keyframes, @NonNull Easing easing, @NonNull KeyframeInterpolationMode interpolationMode) throws MapCameraKeyframeTrack.InstantiationException Creates a map camera principal point keyframe track. It enables animations on the pixel point where the map camera's target is placed in view coordinates. (0,0) is top left of the viewport, (viewport width, viewport height) is bottom right.
- Parameters:
keyframes-The list of keyframes that specify how the camera property is changed. Point values must be in screen (pixel) coordinates with origin (0,0) in the top left of the viewport. Point values outside of viewport boundaries will be clamped to the viewport boundaries during animation. Keyframe time offsets are considered to be relative to the previous keyframe in the list or relative to the start of the animation if the current keyframe is first in the list. Time offset of the first keyframe in the list should be 0, otherwise an error occurs and creation of the keyframe track will fail.
easing-The easing to apply during keyframe interpolation.
interpolationMode-The type of interpolation done between keyframe values.
- Returns:
A keyframe track over the principal point.
- Throws:
MapCameraKeyframeTrack.InstantiationException-Indicates an instantiation issue.
-
normalizedPrincipalPoint
@NonNull public static MapCameraKeyframeTrack normalizedPrincipalPoint(@NonNull List<Anchor2DKeyframe> keyframes, @NonNull Easing easing, @NonNull KeyframeInterpolationMode interpolationMode) throws MapCameraKeyframeTrack.InstantiationException Creates a map camera principal point keyframe track. It enables animations on the point where the map camera's target is placed in normalized view coordinates. (0,0) is top left of the viewport, (1, 1) is bottom right.
- Parameters:
keyframes-The list of keyframes that specify how the camera property is changed. Point values must be in normalized screen coordinates with origin (0,0) in the top left and (1,1) in the bottom right of the viewport. Point values outside of viewport boundaries will be clamped to the viewport boundaries during animation. Keyframe time offsets are considered to be relative to the previous keyframe in the list or relative to the start of the animation if the current keyframe is first in the list. Time offset of the first keyframe in the list should be 0, otherwise an error occurs and creation of the keyframe track will fail.
easing-The easing to apply during keyframe interpolation.
interpolationMode-The type of interpolation done between keyframe values.
- Returns:
A keyframe track over the principal point.
- Throws:
MapCameraKeyframeTrack.InstantiationException-Indicates an instantiation issue.
-
fieldOfView
@NonNull public static MapCameraKeyframeTrack fieldOfView(@NonNull List<ScalarKeyframe> keyframes, @NonNull Easing easing, @NonNull KeyframeInterpolationMode interpolationMode) throws MapCameraKeyframeTrack.InstantiationException Creates a map camera field-of-view keyframe track. It enables animations over the angle of the field of view captured by the map camera in degrees. Values will be clamped to a range from 1 to 150.
- Parameters:
keyframes-The list of keyframes that specify how the camera property is changed. Keyframe time offsets are considered to be relative to the previous keyframe in the list or relative to the start of the animation if the current keyframe is first in the list. Time offset of the first keyframe in the list should be 0, otherwise an error occurs and creation of the keyframe track will fail.
easing-The easing to apply during keyframe interpolation.
interpolationMode-The type of interpolation done between keyframe values.
- Returns:
A keyframe track over the map camera field-of-view.
- Throws:
MapCameraKeyframeTrack.InstantiationException-Indicates an instantiation issue.
-
getInterpolationMode
Gets the interpolation mode for the between key frames in the track.
- Returns:
Interpolation mode affects the shape of the spline going through all keyframes.
-