com.iristick.smartglass.support.camera2.params

Class ColorSpaceTransform

• java.lang.Object
• • com.iristick.smartglass.support.camera2.params.ColorSpaceTransform

---

Deprecated. 

Not maintained anymore. Please use the com.iristick.smartglass.core.camera package instead.

@Deprecated
public abstract class ColorSpaceTransform
extends Object

Immutable class for describing a 3x3 matrix of Rational values in row-major order.

This matrix maps a transform from one color space to another. For the particular color space source and target, see the appropriate camera metadata documentation for the key that provides this value.

Since:

Android API level 21

See Also:

CameraMetadata

Constructor Summary

Constructor and Description
ColorSpaceTransform() Deprecated.

Method Summary

Modifier and Type	Method and Description
abstract void	copyElements(int[] destination, int offset) Deprecated.  Copy the Rational elements in row-major order from this matrix into the destination.
abstract void	copyElements(Rational[] destination, int offset) Deprecated.  Copy the Rational elements in row-major order from this matrix into the destination.
static ColorSpaceTransform	create(int[] elements) Deprecated.  Create a new immutable ColorSpaceTransform instance from an int array.
static ColorSpaceTransform	create(Rational[] elements) Deprecated.  Create a new immutable ColorSpaceTransform instance from a Rational array.
abstract boolean	equals(Object obj) Deprecated.  Check if this ColorSpaceTransform is equal to another ColorSpaceTransform.
abstract Rational	getElement(int column, int row) Deprecated.  Get an element of this matrix by its row and column.
abstract String	toString() Deprecated.  Return the color space transform as a string representation.

Methods inherited from class java.lang.Object

getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ColorSpaceTransform

public ColorSpaceTransform()

Deprecated. 

Method Detail

create

public static ColorSpaceTransform create(Rational[] elements)

Deprecated. 

Create a new immutable ColorSpaceTransform instance from a Rational array.

The elements must be stored in a row-major order.

Parameters:

elements - An array of 9 elements

Returns:

A new ColorSpaceTransform instance.

Throws:

IllegalArgumentException - if the count of elements is not 9

NullPointerException - if elements or any sub-element is null

create

public static ColorSpaceTransform create(int[] elements)

Deprecated. 

Create a new immutable ColorSpaceTransform instance from an int array.

The elements must be stored in a row-major order. Each rational is stored contiguously as a (numerator, denominator) pair.

In particular:

 int[] elements = new int[
     N11, D11, N12, D12, N13, D13,
     N21, D21, N22, D22, N23, D23,
     N31, D31, N32, D32, N33, D33
 ];

 ColorSpaceTransform.create(elements)

where Nij and Dij is the numerator and denominator for row i and column j.

Parameters:

elements - An array of 18 elements

Returns:

A new ColorSpaceTransform instance.

Throws:

IllegalArgumentException - if the count of elements is not 18

NullPointerException - if elements is null

getElement

public abstract Rational getElement(int column,
                                    int row)

Deprecated. 

Get an element of this matrix by its row and column.

The rows must be within the range [0, 3), and the column must be within the range [0, 3).

Parameters:

column - The column.

row - The row.

Returns:

element (non-null)

Throws:

IllegalArgumentException - if column or row was out of range

copyElements

public abstract void copyElements(Rational[] destination,
                                  int offset)

Deprecated. 

Copy the Rational elements in row-major order from this matrix into the destination.

Parameters:

destination - an array big enough to hold at least 9 elements after the offset

offset - a non-negative offset into the array

Throws:

NullPointerException - If destination was null

ArrayIndexOutOfBoundsException - If there's not enough room to write the elements at the specified destination and offset.

copyElements

public abstract void copyElements(int[] destination,
                                  int offset)

Deprecated. 

Copy the Rational elements in row-major order from this matrix into the destination.

Each element is stored as a contiguous rational packed as a (numerator, denominator) pair of ints, identical to the create(int[]) static construction method.

Parameters:

destination - an array big enough to hold at least 18 elements after the offset

offset - a non-negative offset into the array

Throws:

NullPointerException - If destination was null

ArrayIndexOutOfBoundsException - If there's not enough room to write the elements at the specified destination and offset.

See Also:

create(int[])

equals

public abstract boolean equals(Object obj)

Deprecated. 

Check if this ColorSpaceTransform is equal to another ColorSpaceTransform.

Two color space transforms are equal if and only if all of their elements are equal.

Overrides:

equals in class Object

Returns:

true if the objects were equal, false otherwise

toString

public abstract String toString()

Deprecated. 

Return the color space transform as a string representation.

Example: "ColorSpaceTransform([1/1, 0/1, 0/1], [0/1, 1/1, 0/1], [0/1, 0/1, 1/1])" is an identity transform. Elements are printed in row major order.

Overrides:

toString in class Object

Returns:

string representation of color space transform