diff options
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.java | 414 |
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); - } - } -} |