summaryrefslogtreecommitdiff
path: root/platform/android/MapboxGLAndroidSDK/src/main/java/com/mapbox/mapboxsdk/camera/CameraPosition.java
diff options
context:
space:
mode:
Diffstat (limited to 'platform/android/MapboxGLAndroidSDK/src/main/java/com/mapbox/mapboxsdk/camera/CameraPosition.java')
-rw-r--r--platform/android/MapboxGLAndroidSDK/src/main/java/com/mapbox/mapboxsdk/camera/CameraPosition.java414
1 files changed, 0 insertions, 414 deletions
diff --git a/platform/android/MapboxGLAndroidSDK/src/main/java/com/mapbox/mapboxsdk/camera/CameraPosition.java b/platform/android/MapboxGLAndroidSDK/src/main/java/com/mapbox/mapboxsdk/camera/CameraPosition.java
deleted file mode 100644
index fb89688e28..0000000000
--- a/platform/android/MapboxGLAndroidSDK/src/main/java/com/mapbox/mapboxsdk/camera/CameraPosition.java
+++ /dev/null
@@ -1,414 +0,0 @@
-package com.mapbox.mapboxsdk.camera;
-
-import android.content.res.TypedArray;
-import android.os.Parcel;
-import android.os.Parcelable;
-import android.support.annotation.FloatRange;
-import android.support.annotation.Keep;
-import android.support.annotation.NonNull;
-import android.support.annotation.Nullable;
-import android.support.annotation.Size;
-
-import com.mapbox.mapboxsdk.R;
-import com.mapbox.mapboxsdk.constants.MapboxConstants;
-import com.mapbox.mapboxsdk.geometry.LatLng;
-import com.mapbox.mapboxsdk.utils.MathUtils;
-
-import java.util.Arrays;
-
-/**
- * Resembles the position, angle, zoom and tilt of the user's viewpoint.
- */
-public final class CameraPosition implements Parcelable {
-
- public static final CameraPosition DEFAULT = new CameraPosition(new LatLng(), 0, 0, 0, new double[] {0, 0, 0, 0});
-
- public static final Parcelable.Creator<CameraPosition> CREATOR =
- new Parcelable.Creator<CameraPosition>() {
- public CameraPosition createFromParcel(Parcel in) {
- double bearing = in.readDouble();
- LatLng target = in.readParcelable(LatLng.class.getClassLoader());
- double tilt = in.readDouble();
- double zoom = in.readDouble();
-
- double[] padding = null;
- int paddingSize = in.readInt();
- if (paddingSize > 0) {
- padding = new double[paddingSize];
- for (int i = 0; i < paddingSize; i++) {
- padding[i] = in.readDouble();
- }
- }
-
- return new CameraPosition(target, zoom, tilt, bearing, padding);
- }
-
- public CameraPosition[] newArray(int size) {
- return new CameraPosition[size];
- }
- };
-
- /**
- * Direction that the camera is pointing in, in degrees clockwise from north.
- */
- @Keep
- public final double bearing;
-
- /**
- * The location that the camera is pointing at.
- */
- @Keep
- public final LatLng target;
-
- /**
- * The angle, in degrees, of the camera angle from the nadir (directly facing the Earth).
- * See {@link Builder#tilt(double)} for details of restrictions on the range of values.
- */
- @Keep
- public final double tilt;
-
- /**
- * Zoom level near the center of the screen. See {@link Builder#zoom(double)} for the definition of the camera's
- * zoom level.
- */
- @Keep
- public final double zoom;
-
- /**
- * Padding in pixels. Specified in left, top, right, bottom order.
- * See {@link Builder#padding(double[])} for the definition of the camera's padding.
- */
- @Keep
- public final double[] padding;
-
- /**
- * Constructs a CameraPosition.
- *
- * @param target The target location to align with the center of the screen.
- * @param zoom Zoom level at target. See zoom(float) for details of restrictions.
- * @param tilt The camera angle, in degrees, from the nadir (directly down). See tilt(float)
- * for details of restrictions.
- * @param bearing Direction that the camera is pointing in, in degrees clockwise from north.
- * This value will be normalized to be within 0 degrees inclusive and 360 degrees
- * exclusive.
- * @throws NullPointerException if target is null
- * @throws IllegalArgumentException if tilt is outside the range of 0 to 90 degrees inclusive.
- * @deprecated use {@link CameraPosition#CameraPosition(LatLng, double, double, double, double[])} instead.
- */
- @Deprecated
- CameraPosition(LatLng target, double zoom, double tilt, double bearing) {
- this(target, zoom, tilt, bearing, null);
- }
-
- /**
- * Constructs a CameraPosition.
- *
- * @param target The target location to align with the center of the screen.
- * @param zoom Zoom level at target. See zoom(float) for details of restrictions.
- * @param tilt The camera angle, in degrees, from the nadir (directly down). See tilt(float)
- * for details of restrictions.
- * @param bearing Direction that the camera is pointing in, in degrees clockwise from north.
- * This value will be normalized to be within 0 degrees inclusive and 360 degrees
- * exclusive.
- * @param padding Padding in pixels. Specified in left, top, right, bottom order.
- * @throws NullPointerException if target is null
- * @throws IllegalArgumentException if tilt is outside the range of 0 to 90 degrees inclusive.
- */
- @Keep
- CameraPosition(LatLng target, double zoom, double tilt, double bearing, double[] padding) {
- this.target = target;
- this.bearing = bearing;
- this.tilt = tilt;
- this.zoom = zoom;
- this.padding = padding;
- }
-
- /**
- * Describe the kinds of special objects contained in this Parcelable's
- * marshalled representation.
- *
- * @return integer 0.
- */
- @Override
- public int describeContents() {
- return 0;
- }
-
- /**
- * Flatten this object in to a Parcel.
- *
- * @param out The Parcel in which the object should be written.
- * @param flags Additional flags about how the object should be written. May be 0 or
- * {@link #PARCELABLE_WRITE_RETURN_VALUE}.
- */
- @Override
- public void writeToParcel(Parcel out, int flags) {
- out.writeDouble(bearing);
- out.writeParcelable(target, flags);
- out.writeDouble(tilt);
- out.writeDouble(zoom);
-
- if (padding != null) {
- int length = padding.length;
- out.writeInt(length);
- for (double v : padding) {
- out.writeDouble(v);
- }
- } else {
- out.writeInt(-1);
- }
- }
-
- /**
- * Returns a String with the camera target, zoom, bearing and tilt.
- *
- * @return A String with CameraPosition information.
- */
- @Override
- public String toString() {
- return "Target: " + target + ", Zoom:" + zoom + ", Bearing:" + bearing + ", Tilt:" + tilt
- + ", Padding:" + Arrays.toString(padding);
- }
-
- /**
- * Compares this {@link CameraPosition} object with another {@link CameraPosition} and
- * determines if their target, zoom, tilt, and bearing match.
- *
- * @param o Another {@link CameraPosition} to compare with this object.
- * @return True if target, zoom, tilt, and bearing match this {@link CameraPosition} object.
- * Else, false.
- */
- @Override
- public boolean equals(@Nullable Object o) {
- if (this == o) {
- return true;
- }
-
- if (o == null || getClass() != o.getClass()) {
- return false;
- }
-
- CameraPosition cameraPosition = (CameraPosition) o;
- if (target != null && !target.equals(cameraPosition.target)) {
- return false;
- } else if (zoom != cameraPosition.zoom) {
- return false;
- } else if (tilt != cameraPosition.tilt) {
- return false;
- } else if (bearing != cameraPosition.bearing) {
- return false;
- } else if (!Arrays.equals(padding, cameraPosition.padding)) {
- return false;
- }
- return true;
- }
-
- /**
- * Gives an integer which can be used as the bucket number for storing elements of the set/map.
- * This bucket number is the address of the element inside the set/map. There's no guarantee
- * that this hash value will be consistent between different Java implementations, or even
- * between different execution runs of the same program.
- *
- * @return integer value you can use for storing element.
- */
- @Override
- public int hashCode() {
- int result;
- long temp;
- temp = Double.doubleToLongBits(bearing);
- result = (int) (temp ^ (temp >>> 32));
- result = 31 * result + (target != null ? target.hashCode() : 0);
- temp = Double.doubleToLongBits(tilt);
- result = 31 * result + (int) (temp ^ (temp >>> 32));
- temp = Double.doubleToLongBits(zoom);
- result = 31 * result + (int) (temp ^ (temp >>> 32));
- result = 31 * result + Arrays.hashCode(padding);
- return result;
- }
-
- /**
- * Builder for composing CameraPosition objects.
- */
- public static final class Builder {
-
- private double bearing = -1;
- @Nullable
- private LatLng target = null;
- private double tilt = -1;
- private double zoom = -1;
- private double[] padding = null;
-
- /**
- * Create an empty builder.
- */
- public Builder() {
- super();
- }
-
- /**
- * Create a builder with an existing CameraPosition data.
- *
- * @param previous Existing CameraPosition values to use
- */
- public Builder(@Nullable CameraPosition previous) {
- super();
- if (previous != null) {
- this.bearing = previous.bearing;
- this.target = previous.target;
- this.tilt = previous.tilt;
- this.zoom = previous.zoom;
- this.padding = previous.padding;
- }
- }
-
- /**
- * Create a builder with an existing CameraPosition data.
- *
- * @param typedArray TypedArray containing attribute values
- */
- public Builder(@Nullable TypedArray typedArray) {
- super();
- if (typedArray != null) {
- this.bearing = typedArray.getFloat(R.styleable.mapbox_MapView_mapbox_cameraBearing, 0.0f);
- double lat = typedArray.getFloat(R.styleable.mapbox_MapView_mapbox_cameraTargetLat, 0.0f);
- double lng = typedArray.getFloat(R.styleable.mapbox_MapView_mapbox_cameraTargetLng, 0.0f);
- this.target = new LatLng(lat, lng);
- this.tilt = typedArray.getFloat(R.styleable.mapbox_MapView_mapbox_cameraTilt, 0.0f);
- this.zoom = typedArray.getFloat(R.styleable.mapbox_MapView_mapbox_cameraZoom, 0.0f);
- }
- }
-
- /**
- * Create a builder from an existing CameraPositionUpdate update.
- *
- * @param update Update containing camera options
- */
- public Builder(@Nullable CameraUpdateFactory.CameraPositionUpdate update) {
- super();
- if (update != null) {
- bearing = update.getBearing();
- target = update.getTarget();
- tilt = update.getTilt();
- zoom = update.getZoom();
- padding = update.getPadding();
- }
- }
-
- /**
- * Create builder from an existing CameraPositionUpdate update.
- *
- * @param update Update containing camera options
- */
- public Builder(@Nullable CameraUpdateFactory.ZoomUpdate update) {
- super();
- if (update != null) {
- this.zoom = update.getZoom();
- }
- }
-
- /**
- * Sets the direction that the camera is pointing in, in degrees clockwise from north.
- *
- * @param bearing Bearing
- * @return this
- */
- @NonNull
- public Builder bearing(double bearing) {
- double direction = bearing;
-
- while (direction >= 360) {
- direction -= 360;
- }
- while (direction < 0) {
- direction += 360;
- }
-
- this.bearing = direction;
- return this;
- }
-
- /**
- * Sets the location where the camera is pointing at.
- *
- * @param location target of the camera
- * @return this
- */
- @NonNull
- public Builder target(LatLng location) {
- this.target = location;
- return this;
- }
-
- /**
- * Set the tilt of the camera in degrees
- * <p>
- * value is clamped to {@link MapboxConstants#MINIMUM_TILT} and {@link MapboxConstants#MAXIMUM_TILT}.
- * </p>
- *
- * @param tilt Tilt value of the camera
- * @return this
- */
- @NonNull
- public Builder tilt(@FloatRange(from = MapboxConstants.MINIMUM_TILT,
- to = MapboxConstants.MAXIMUM_TILT) double tilt) {
- this.tilt = MathUtils.clamp(tilt, MapboxConstants.MINIMUM_TILT, MapboxConstants.MAXIMUM_TILT);
- return this;
- }
-
- /**
- * Set the zoom of the camera
- * <p>
- * Zoom ranges from {@link MapboxConstants#MINIMUM_ZOOM} to {@link MapboxConstants#MAXIMUM_ZOOM}
- * </p>
- *
- * @param zoom Zoom value of the camera
- * @return this
- */
- @NonNull
- public Builder zoom(@FloatRange(from = MapboxConstants.MINIMUM_ZOOM,
- to = MapboxConstants.MAXIMUM_ZOOM) double zoom) {
- this.zoom = zoom;
- return this;
- }
-
- /**
- * Padding in pixels that shifts the viewport by the specified amount.
- * Applied padding is going to persist and impact following camera transformations.
- * <p>
- * Specified in left, top, right, bottom order.
- * </p>
- *
- * @param padding Camera padding
- * @return this
- */
- @NonNull
- public Builder padding(@Size(4) double[] padding) {
- this.padding = padding;
- return this;
- }
-
- /**
- * Padding in pixels that shifts the viewport by the specified amount.
- * Applied padding is going to persist and impact following camera transformations.
- * <p>
- * Specified in left, top, right, bottom order.
- * </p>
- *
- * @return this
- */
- @NonNull
- public Builder padding(double left, double top, double right, double bottom) {
- this.padding = new double[] {left, top, right, bottom};
- return this;
- }
-
- /**
- * Builds the CameraPosition.
- *
- * @return CameraPosition
- */
- public CameraPosition build() {
- return new CameraPosition(target, zoom, tilt, bearing, padding);
- }
- }
-}