ly.img.android.sdk.utils

Class FloatPointList

java.lang.Object

ly.img.android.sdk.utils.FloatPointList

public class FloatPointList
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
protected int	modCount The number of times this list has been structurally modified.

Constructor Summary

Constructors

Constructor and Description
FloatPointList() Constructs an empty list with an initial capacity of ten.
FloatPointList(float[] points) Constructs an empty list with the specified initial capacity.
FloatPointList(int initialCapacity) Constructs an empty list with the specified initial capacity.

Method Summary

Modifier and Type	Method and Description
boolean	add(float e) Appends the specified element to the end of this list.
void	add(int index, float element) Inserts the specified element at the specified position in this list.
boolean	addAll(float[] a) Appends all of the elements in the specified collection to the end of this list, in the order that they are returned by the specified collection's Iterator.
boolean	addAll(int index, float[] a) Inserts all of the elements in the specified collection into this list, starting at the specified position.
boolean	addPoint(float[] point) Appends the specified element to the end of this list.
boolean	addPoint(float x, float y) Appends the specified element to the end of this list.
void	addPoint(int pointIndex, float[] point) Inserts the specified element at the specified position in this list.
void	addPoint(int pointIndex, float x, float y) Inserts the specified element at the specified position in this list.
void	clear() Removes all of the elements from this list.
float[]	createArray()
void	ensureCapacity(int minCapacity) Increases the capacity of this ArrayList instance, if necessary, to ensure that it can hold at least the number of elements specified by the minimum capacity argument.
boolean	equals(java.lang.Object o) Compares the specified object with this list for equality.
float	get(int index) Returns the element at the specified position in this list.
float[]	getPoint(int pointIndex) Returns the element at the specified position in this list.
float[]	getPoint(int pointIndex, float[] dst) Returns the element at the specified position in this list.
int	hashCode() Returns the hash code value for this list.
boolean	isEmpty() Returns true if this list contains no elements.
FloatPointList	mapPoints(android.graphics.Matrix matrix)
int	pointCount() Returns the number of points in this list.
float[]	rawArray()
float	remove(int index) Removes the element at the specified position in this list.
boolean	remove(java.lang.Object o) Removes the first occurrence of the specified element from this list, if it is present.
void	removePoint(int pointIndex) Removes the element at the specified position in this list.
protected void	removeRange(int fromIndex, int toIndex) Removes from this list all of the elements whose index is between fromIndex, inclusive, and toIndex, exclusive.
float	set(int index, float element) Replaces the element at the specified position in this list with the specified element.
void	set(int pointIndex, float[] point) Replaces the element at the specified position in this list with the specified element.
int	size() Returns the number of elements in this list.
void	trimToSize() Trims the capacity of this ArrayList instance to be the list's current size.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

modCount

protected transient int modCount

The number of times this list has been structurally modified. Structural modifications are those that change the size of the list, or otherwise perturb it in such a fashion that iterations in progress may yield incorrect results.

This field is used by the iterator and list iterator implementation returned by the iterator and listIterator methods. If the value of this field changes unexpectedly, the iterator (or list iterator) will throw a ConcurrentModificationException in response to the next, remove, previous, set or add operations. This provides fail-fast behavior, rather than non-deterministic behavior in the face of concurrent modification during iteration.

Use of this field by subclasses is optional. If a subclass wishes to provide fail-fast iterators (and list iterators), then it merely has to increment this field in its add(int, E) and remove(int) methods (and any other methods that it overrides that result in structural modifications to the list). A single call to add(int, E) or remove(int) must add no more than one to this field, or the iterators (and list iterators) will throw bogus ConcurrentModificationExceptions. If an implementation does not wish to provide fail-fast iterators, this field may be ignored.

Constructor Detail

FloatPointList

public FloatPointList()

Constructs an empty list with an initial capacity of ten.

FloatPointList

public FloatPointList(@NonNull
                      float[] points)

Constructs an empty list with the specified initial capacity.

Parameters:

points - the initial point list to copy into

Throws:

java.lang.IllegalArgumentException - if the specified initial capacity is negative

FloatPointList

public FloatPointList(int initialCapacity)

Constructs an empty list with the specified initial capacity.

Parameters:

initialCapacity - the initial capacity of the list

Throws:

java.lang.IllegalArgumentException - if the specified initial capacity is negative

Method Detail

add

public boolean add(float e)

Appends the specified element to the end of this list.

Parameters:

e - element to be appended to this list

Returns:

true

add

public void add(int index,
                float element)

Inserts the specified element at the specified position in this list. Shifts the element currently at that position (if any) and any subsequent elements to the right (adds one to their indices).

Parameters:

index - index at which the specified element is to be inserted

element - element to be inserted

Throws:

java.lang.IndexOutOfBoundsException

addAll

public boolean addAll(float[] a)

Appends all of the elements in the specified collection to the end of this list, in the order that they are returned by the specified collection's Iterator. The behavior of this operation is undefined if the specified collection is modified while the operation is in progress. (This implies that the behavior of this call is undefined if the specified collection is this list, and this list is nonempty.)

Parameters:

a - collection containing elements to be added to this list

Returns:

true if this list changed as a result of the call

Throws:

java.lang.NullPointerException - if the specified collection is null

addAll

public boolean addAll(int index,
                      float[] a)

Inserts all of the elements in the specified collection into this list, starting at the specified position. Shifts the element currently at that position (if any) and any subsequent elements to the right (increases their indices). The new elements will appear in the list in the order that they are returned by the specified collection's iterator.

Parameters:

index - index at which to insert the first element from the specified collection

a - collection containing elements to be added to this list

Returns:

true if this list changed as a result of the call

Throws:

java.lang.IndexOutOfBoundsException

java.lang.NullPointerException - if the specified collection is null

addPoint

public boolean addPoint(@NonNull
                        float[] point)

Appends the specified element to the end of this list.

Parameters:

point - point to be appended to this list

Returns:

true

addPoint

public boolean addPoint(@NonNull
                        float x,
                        float y)

Appends the specified element to the end of this list.

Parameters:

x - point x coordinate to be appended to this list

y - point y coordinate to be appended to this list

Returns:

true

addPoint

public void addPoint(int pointIndex,
                     float[] point)

Inserts the specified element at the specified position in this list. Shifts the element currently at that position (if any) and any subsequent elements to the right (adds one to their indices).

Parameters:

pointIndex - index at which the specified element is to be inserted

point - element to be inserted

Throws:

java.lang.IndexOutOfBoundsException

addPoint

public void addPoint(int pointIndex,
                     float x,
                     float y)

Inserts the specified element at the specified position in this list. Shifts the element currently at that position (if any) and any subsequent elements to the right (adds one to their indices).

Parameters:

pointIndex - index at which the specified element is to be inserted

x - point x coordinate to be inserted

y - point y coordinate to be inserted

Throws:

java.lang.IndexOutOfBoundsException

clear

public void clear()

Removes all of the elements from this list. The list will be empty after this call returns.

createArray

public float[] createArray()

ensureCapacity

public void ensureCapacity(int minCapacity)

Increases the capacity of this ArrayList instance, if necessary, to ensure that it can hold at least the number of elements specified by the minimum capacity argument.

Parameters:

minCapacity - the desired minimum capacity

equals

public boolean equals(java.lang.Object o)

Compares the specified object with this list for equality. Returns true if and only if the specified object is also a list, both lists have the same size, and all corresponding pairs of elements in the two lists are equal. (Two elements e1 and e2 are equal if (e1==null ? e2==null : e1.equals(e2)).) In other words, two lists are defined to be equal if they contain the same elements in the same order.

This implementation first checks if the specified object is this list. If so, it returns true; if not, it checks if the specified object is a list. If not, it returns false; if so, it iterates over both lists, comparing corresponding pairs of elements. If any comparison returns false, this method returns false. If either iterator runs out of elements before the other it returns false (as the lists are of unequal length); otherwise it returns true when the iterations complete.

Overrides:

equals in class java.lang.Object

Parameters:

o - the object to be compared for equality with this list

Returns:

true if the specified object is equal to this list

get

public float get(int index)

Returns the element at the specified position in this list.

Parameters:

index - index of the element to return

Returns:

the element at the specified position in this list

Throws:

java.lang.IndexOutOfBoundsException

getPoint

@CheckResult
public float[] getPoint(int pointIndex)

Returns the element at the specified position in this list.

Parameters:

pointIndex - index of the element to return

Returns:

the point element at the specified position in this list

Throws:

java.lang.IndexOutOfBoundsException

getPoint

public float[] getPoint(int pointIndex,
                        float[] dst)

Returns the element at the specified position in this list.

Parameters:

pointIndex - index of the element to return

dst - destination element

Returns:

the element at the specified position in this list

Throws:

java.lang.IndexOutOfBoundsException

hashCode

public int hashCode()

Returns the hash code value for this list.

This implementation uses exactly the code that is used to define the list hash function in the documentation for the List.hashCode() method.

Overrides:

hashCode in class java.lang.Object

Returns:

the hash code value for this list

isEmpty

public boolean isEmpty()

Returns true if this list contains no elements.

Returns:

true if this list contains no elements

mapPoints

public FloatPointList mapPoints(android.graphics.Matrix matrix)

pointCount

public int pointCount()

Returns the number of points in this list.

Returns:

the number of points in this list

rawArray

public float[] rawArray()

remove

public float remove(int index)

Removes the element at the specified position in this list. Shifts any subsequent elements to the left (subtracts one from their indices).

Parameters:

index - the index of the element to be removed

Returns:

the element that was removed from the list

Throws:

java.lang.IndexOutOfBoundsException

remove

public boolean remove(java.lang.Object o)

Removes the first occurrence of the specified element from this list, if it is present. If the list does not contain the element, it is unchanged. More formally, removes the element with the lowest index i such that (o==null ? get(i)==null : o.equals(get(i))) (if such an element exists). Returns true if this list contained the specified element (or equivalently, if this list changed as a result of the call).

Parameters:

o - element to be removed from this list, if present

Returns:

true if this list contained the specified element

removePoint

public void removePoint(int pointIndex)

Removes the element at the specified position in this list. Shifts any subsequent elements to the left (subtracts one from their indices).

Parameters:

pointIndex - the index of the element to be removed

Throws:

java.lang.IndexOutOfBoundsException

removeRange

protected void removeRange(int fromIndex,
                           int toIndex)

Removes from this list all of the elements whose index is between fromIndex, inclusive, and toIndex, exclusive. Shifts any succeeding elements to the left (reduces their index). This call shortens the list by (toIndex - fromIndex) elements. (If toIndex==fromIndex, this operation has no effect.)

Throws:

java.lang.IndexOutOfBoundsException - if fromIndex or toIndex is out of range (fromIndex < 0 || fromIndex >= size() || toIndex > size() || toIndex < fromIndex)

set

public float set(int index,
                 float element)

Replaces the element at the specified position in this list with the specified element.

Parameters:

index - index of the element to replace

element - element to be stored at the specified position

Returns:

the element previously at the specified position

Throws:

java.lang.IndexOutOfBoundsException

set

public void set(int pointIndex,
                float[] point)

Replaces the element at the specified position in this list with the specified element.

Parameters:

pointIndex - index of the element to replace

point - element to be stored at the specified position

Throws:

java.lang.IndexOutOfBoundsException

size

public int size()

Returns the number of elements in this list.

Returns:

the number of elements in this list

trimToSize

public void trimToSize()

Trims the capacity of this ArrayList instance to be the list's current size. An application can use this operation to minimize the storage of an ArrayList instance.