diff options
author | Ruben Brunk <rubenbrunk@google.com> | 2014-04-15 23:53:53 -0700 |
---|---|---|
committer | Ruben Brunk <rubenbrunk@google.com> | 2014-04-16 16:01:29 -0700 |
commit | 7c062369d55ad6f6f0c9c3bd8439c50cbfb88f42 (patch) | |
tree | da246cfa19be857a177cdf71382b4bcb81d1eafd /core/java/android/hardware/camera2 | |
parent | 2271a91c327cee8a6c1dffcbfd3419c95d56c37e (diff) | |
download | frameworks_base-7c062369d55ad6f6f0c9c3bd8439c50cbfb88f42.zip frameworks_base-7c062369d55ad6f6f0c9c3bd8439c50cbfb88f42.tar.gz frameworks_base-7c062369d55ad6f6f0c9c3bd8439c50cbfb88f42.tar.bz2 |
Update DNG tags.
Change-Id: I497b0fac5d52005c126eaf52c67d30bd224a80b5
Diffstat (limited to 'core/java/android/hardware/camera2')
3 files changed, 301 insertions, 175 deletions
diff --git a/core/java/android/hardware/camera2/CameraCharacteristics.java b/core/java/android/hardware/camera2/CameraCharacteristics.java index 9852776..528e119 100644 --- a/core/java/android/hardware/camera2/CameraCharacteristics.java +++ b/core/java/android/hardware/camera2/CameraCharacteristics.java @@ -1030,6 +1030,195 @@ public final class CameraCharacteristics extends CameraMetadata { new Key<Integer>("android.sensor.info.whiteLevel", int.class); /** + * <p>The standard reference illuminant used as the scene light source when + * calculating the {@link CameraCharacteristics#SENSOR_COLOR_TRANSFORM1 android.sensor.colorTransform1}, + * {@link CameraCharacteristics#SENSOR_CALIBRATION_TRANSFORM1 android.sensor.calibrationTransform1}, and + * {@link CameraCharacteristics#SENSOR_FORWARD_MATRIX1 android.sensor.forwardMatrix1} matrices.</p> + * <p>The values in this tag correspond to the values defined for the + * EXIF LightSource tag. These illuminants are standard light sources + * that are often used calibrating camera devices.</p> + * <p>If this tag is present, then {@link CameraCharacteristics#SENSOR_COLOR_TRANSFORM1 android.sensor.colorTransform1}, + * {@link CameraCharacteristics#SENSOR_CALIBRATION_TRANSFORM1 android.sensor.calibrationTransform1}, and + * {@link CameraCharacteristics#SENSOR_FORWARD_MATRIX1 android.sensor.forwardMatrix1} will also be present.</p> + * <p>Some devices may choose to provide a second set of calibration + * information for improved quality, including + * {@link CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT2 android.sensor.referenceIlluminant2} and its corresponding matrices.</p> + * + * @see CameraCharacteristics#SENSOR_CALIBRATION_TRANSFORM1 + * @see CameraCharacteristics#SENSOR_COLOR_TRANSFORM1 + * @see CameraCharacteristics#SENSOR_FORWARD_MATRIX1 + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT2 + * @see #SENSOR_REFERENCE_ILLUMINANT1_DAYLIGHT + * @see #SENSOR_REFERENCE_ILLUMINANT1_FLUORESCENT + * @see #SENSOR_REFERENCE_ILLUMINANT1_TUNGSTEN + * @see #SENSOR_REFERENCE_ILLUMINANT1_FLASH + * @see #SENSOR_REFERENCE_ILLUMINANT1_FINE_WEATHER + * @see #SENSOR_REFERENCE_ILLUMINANT1_CLOUDY_WEATHER + * @see #SENSOR_REFERENCE_ILLUMINANT1_SHADE + * @see #SENSOR_REFERENCE_ILLUMINANT1_DAYLIGHT_FLUORESCENT + * @see #SENSOR_REFERENCE_ILLUMINANT1_DAY_WHITE_FLUORESCENT + * @see #SENSOR_REFERENCE_ILLUMINANT1_COOL_WHITE_FLUORESCENT + * @see #SENSOR_REFERENCE_ILLUMINANT1_WHITE_FLUORESCENT + * @see #SENSOR_REFERENCE_ILLUMINANT1_STANDARD_A + * @see #SENSOR_REFERENCE_ILLUMINANT1_STANDARD_B + * @see #SENSOR_REFERENCE_ILLUMINANT1_STANDARD_C + * @see #SENSOR_REFERENCE_ILLUMINANT1_D55 + * @see #SENSOR_REFERENCE_ILLUMINANT1_D65 + * @see #SENSOR_REFERENCE_ILLUMINANT1_D75 + * @see #SENSOR_REFERENCE_ILLUMINANT1_D50 + * @see #SENSOR_REFERENCE_ILLUMINANT1_ISO_STUDIO_TUNGSTEN + */ + public static final Key<Integer> SENSOR_REFERENCE_ILLUMINANT1 = + new Key<Integer>("android.sensor.referenceIlluminant1", int.class); + + /** + * <p>The standard reference illuminant used as the scene light source when + * calculating the {@link CameraCharacteristics#SENSOR_COLOR_TRANSFORM2 android.sensor.colorTransform2}, + * {@link CameraCharacteristics#SENSOR_CALIBRATION_TRANSFORM2 android.sensor.calibrationTransform2}, and + * {@link CameraCharacteristics#SENSOR_FORWARD_MATRIX2 android.sensor.forwardMatrix2} matrices.</p> + * <p>See {@link CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 android.sensor.referenceIlluminant1} for more details. + * Valid values for this are the same as those given for the first + * reference illuminant.</p> + * <p>If this tag is present, then {@link CameraCharacteristics#SENSOR_COLOR_TRANSFORM2 android.sensor.colorTransform2}, + * {@link CameraCharacteristics#SENSOR_CALIBRATION_TRANSFORM2 android.sensor.calibrationTransform2}, and + * {@link CameraCharacteristics#SENSOR_FORWARD_MATRIX2 android.sensor.forwardMatrix2} will also be present.</p> + * + * @see CameraCharacteristics#SENSOR_CALIBRATION_TRANSFORM2 + * @see CameraCharacteristics#SENSOR_COLOR_TRANSFORM2 + * @see CameraCharacteristics#SENSOR_FORWARD_MATRIX2 + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final Key<Byte> SENSOR_REFERENCE_ILLUMINANT2 = + new Key<Byte>("android.sensor.referenceIlluminant2", byte.class); + + /** + * <p>A per-device calibration transform matrix that maps from the + * reference sensor colorspace to the actual device sensor colorspace.</p> + * <p>This matrix is used to correct for per-device variations in the + * sensor colorspace, and is used for processing raw buffer data.</p> + * <p>The matrix is expressed as a 3x3 matrix in row-major-order, and + * contains a per-device calibration transform that maps colors + * from reference sensor color space (i.e. the "golden module" + * colorspace) into this camera device's native sensor color + * space under the first reference illuminant + * ({@link CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 android.sensor.referenceIlluminant1}).</p> + * <p><b>Optional</b> - This value may be {@code null} on some devices.</p> + * + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final Key<Rational[]> SENSOR_CALIBRATION_TRANSFORM1 = + new Key<Rational[]>("android.sensor.calibrationTransform1", Rational[].class); + + /** + * <p>A per-device calibration transform matrix that maps from the + * reference sensor colorspace to the actual device sensor colorspace + * (this is the colorspace of the raw buffer data).</p> + * <p>This matrix is used to correct for per-device variations in the + * sensor colorspace, and is used for processing raw buffer data.</p> + * <p>The matrix is expressed as a 3x3 matrix in row-major-order, and + * contains a per-device calibration transform that maps colors + * from reference sensor color space (i.e. the "golden module" + * colorspace) into this camera device's native sensor color + * space under the second reference illuminant + * ({@link CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT2 android.sensor.referenceIlluminant2}).</p> + * <p>This matrix will only be present if the second reference + * illuminant is present.</p> + * <p><b>Optional</b> - This value may be {@code null} on some devices.</p> + * + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT2 + */ + public static final Key<Rational[]> SENSOR_CALIBRATION_TRANSFORM2 = + new Key<Rational[]>("android.sensor.calibrationTransform2", Rational[].class); + + /** + * <p>A matrix that transforms color values from CIE XYZ color space to + * reference sensor color space.</p> + * <p>This matrix is used to convert from the standard CIE XYZ color + * space to the reference sensor colorspace, and is used when processing + * raw buffer data.</p> + * <p>The matrix is expressed as a 3x3 matrix in row-major-order, and + * contains a color transform matrix that maps colors from the CIE + * XYZ color space to the reference sensor color space (i.e. the + * "golden module" colorspace) under the first reference illuminant + * ({@link CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 android.sensor.referenceIlluminant1}).</p> + * <p>The white points chosen in both the reference sensor color space + * and the CIE XYZ colorspace when calculating this transform will + * match the standard white point for the first reference illuminant + * (i.e. no chromatic adaptation will be applied by this transform).</p> + * <p><b>Optional</b> - This value may be {@code null} on some devices.</p> + * + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final Key<Rational[]> SENSOR_COLOR_TRANSFORM1 = + new Key<Rational[]>("android.sensor.colorTransform1", Rational[].class); + + /** + * <p>A matrix that transforms color values from CIE XYZ color space to + * reference sensor color space.</p> + * <p>This matrix is used to convert from the standard CIE XYZ color + * space to the reference sensor colorspace, and is used when processing + * raw buffer data.</p> + * <p>The matrix is expressed as a 3x3 matrix in row-major-order, and + * contains a color transform matrix that maps colors from the CIE + * XYZ color space to the reference sensor color space (i.e. the + * "golden module" colorspace) under the second reference illuminant + * ({@link CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT2 android.sensor.referenceIlluminant2}).</p> + * <p>The white points chosen in both the reference sensor color space + * and the CIE XYZ colorspace when calculating this transform will + * match the standard white point for the second reference illuminant + * (i.e. no chromatic adaptation will be applied by this transform).</p> + * <p>This matrix will only be present if the second reference + * illuminant is present.</p> + * <p><b>Optional</b> - This value may be {@code null} on some devices.</p> + * + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT2 + */ + public static final Key<Rational[]> SENSOR_COLOR_TRANSFORM2 = + new Key<Rational[]>("android.sensor.colorTransform2", Rational[].class); + + /** + * <p>A matrix that transforms white balanced camera colors from the reference + * sensor colorspace to the CIE XYZ colorspace with a D50 whitepoint.</p> + * <p>This matrix is used to convert to the standard CIE XYZ colorspace, and + * is used when processing raw buffer data.</p> + * <p>This matrix is expressed as a 3x3 matrix in row-major-order, and contains + * a color transform matrix that maps white balanced colors from the + * reference sensor color space to the CIE XYZ color space with a D50 white + * point.</p> + * <p>Under the first reference illuminant ({@link CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 android.sensor.referenceIlluminant1}) + * this matrix is chosen so that the standard white point for this reference + * illuminant in the reference sensor colorspace is mapped to D50 in the + * CIE XYZ colorspace.</p> + * <p><b>Optional</b> - This value may be {@code null} on some devices.</p> + * + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final Key<Rational[]> SENSOR_FORWARD_MATRIX1 = + new Key<Rational[]>("android.sensor.forwardMatrix1", Rational[].class); + + /** + * <p>A matrix that transforms white balanced camera colors from the reference + * sensor colorspace to the CIE XYZ colorspace with a D50 whitepoint.</p> + * <p>This matrix is used to convert to the standard CIE XYZ colorspace, and + * is used when processing raw buffer data.</p> + * <p>This matrix is expressed as a 3x3 matrix in row-major-order, and contains + * a color transform matrix that maps white balanced colors from the + * reference sensor color space to the CIE XYZ color space with a D50 white + * point.</p> + * <p>Under the second reference illuminant ({@link CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT2 android.sensor.referenceIlluminant2}) + * this matrix is chosen so that the standard white point for this reference + * illuminant in the reference sensor colorspace is mapped to D50 in the + * CIE XYZ colorspace.</p> + * <p>This matrix will only be present if the second reference + * illuminant is present.</p> + * <p><b>Optional</b> - This value may be {@code null} on some devices.</p> + * + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT2 + */ + public static final Key<Rational[]> SENSOR_FORWARD_MATRIX2 = + new Key<Rational[]>("android.sensor.forwardMatrix2", Rational[].class); + + /** * <p>Gain factor from electrons to raw units when * ISO=100</p> * <p><b>Optional</b> - This value may be {@code null} on some devices.</p> diff --git a/core/java/android/hardware/camera2/CameraMetadata.java b/core/java/android/hardware/camera2/CameraMetadata.java index 9b1bc53..ba8db3a 100644 --- a/core/java/android/hardware/camera2/CameraMetadata.java +++ b/core/java/android/hardware/camera2/CameraMetadata.java @@ -457,6 +457,110 @@ public abstract class CameraMetadata { public static final int SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_RGB = 4; // + // Enumeration values for CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + // + + /** + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final int SENSOR_REFERENCE_ILLUMINANT1_DAYLIGHT = 1; + + /** + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final int SENSOR_REFERENCE_ILLUMINANT1_FLUORESCENT = 2; + + /** + * <p>Incandescent light</p> + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final int SENSOR_REFERENCE_ILLUMINANT1_TUNGSTEN = 3; + + /** + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final int SENSOR_REFERENCE_ILLUMINANT1_FLASH = 4; + + /** + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final int SENSOR_REFERENCE_ILLUMINANT1_FINE_WEATHER = 9; + + /** + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final int SENSOR_REFERENCE_ILLUMINANT1_CLOUDY_WEATHER = 10; + + /** + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final int SENSOR_REFERENCE_ILLUMINANT1_SHADE = 11; + + /** + * <p>D 5700 - 7100K</p> + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final int SENSOR_REFERENCE_ILLUMINANT1_DAYLIGHT_FLUORESCENT = 12; + + /** + * <p>N 4600 - 5400K</p> + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final int SENSOR_REFERENCE_ILLUMINANT1_DAY_WHITE_FLUORESCENT = 13; + + /** + * <p>W 3900 - 4500K</p> + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final int SENSOR_REFERENCE_ILLUMINANT1_COOL_WHITE_FLUORESCENT = 14; + + /** + * <p>WW 3200 - 3700K</p> + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final int SENSOR_REFERENCE_ILLUMINANT1_WHITE_FLUORESCENT = 15; + + /** + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final int SENSOR_REFERENCE_ILLUMINANT1_STANDARD_A = 17; + + /** + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final int SENSOR_REFERENCE_ILLUMINANT1_STANDARD_B = 18; + + /** + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final int SENSOR_REFERENCE_ILLUMINANT1_STANDARD_C = 19; + + /** + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final int SENSOR_REFERENCE_ILLUMINANT1_D55 = 20; + + /** + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final int SENSOR_REFERENCE_ILLUMINANT1_D65 = 21; + + /** + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final int SENSOR_REFERENCE_ILLUMINANT1_D75 = 22; + + /** + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final int SENSOR_REFERENCE_ILLUMINANT1_D50 = 23; + + /** + * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 + */ + public static final int SENSOR_REFERENCE_ILLUMINANT1_ISO_STUDIO_TUNGSTEN = 24; + + // // Enumeration values for CameraCharacteristics#LED_AVAILABLE_LEDS // @@ -1731,110 +1835,6 @@ public abstract class CameraMetadata { public static final int LENS_STATE_MOVING = 1; // - // Enumeration values for CaptureResult#SENSOR_REFERENCE_ILLUMINANT - // - - /** - * @see CaptureResult#SENSOR_REFERENCE_ILLUMINANT - */ - public static final int SENSOR_REFERENCE_ILLUMINANT_DAYLIGHT = 1; - - /** - * @see CaptureResult#SENSOR_REFERENCE_ILLUMINANT - */ - public static final int SENSOR_REFERENCE_ILLUMINANT_FLUORESCENT = 2; - - /** - * <p>Incandescent light</p> - * @see CaptureResult#SENSOR_REFERENCE_ILLUMINANT - */ - public static final int SENSOR_REFERENCE_ILLUMINANT_TUNGSTEN = 3; - - /** - * @see CaptureResult#SENSOR_REFERENCE_ILLUMINANT - */ - public static final int SENSOR_REFERENCE_ILLUMINANT_FLASH = 4; - - /** - * @see CaptureResult#SENSOR_REFERENCE_ILLUMINANT - */ - public static final int SENSOR_REFERENCE_ILLUMINANT_FINE_WEATHER = 9; - - /** - * @see CaptureResult#SENSOR_REFERENCE_ILLUMINANT - */ - public static final int SENSOR_REFERENCE_ILLUMINANT_CLOUDY_WEATHER = 10; - - /** - * @see CaptureResult#SENSOR_REFERENCE_ILLUMINANT - */ - public static final int SENSOR_REFERENCE_ILLUMINANT_SHADE = 11; - - /** - * <p>D 5700 - 7100K</p> - * @see CaptureResult#SENSOR_REFERENCE_ILLUMINANT - */ - public static final int SENSOR_REFERENCE_ILLUMINANT_DAYLIGHT_FLUORESCENT = 12; - - /** - * <p>N 4600 - 5400K</p> - * @see CaptureResult#SENSOR_REFERENCE_ILLUMINANT - */ - public static final int SENSOR_REFERENCE_ILLUMINANT_DAY_WHITE_FLUORESCENT = 13; - - /** - * <p>W 3900 - 4500K</p> - * @see CaptureResult#SENSOR_REFERENCE_ILLUMINANT - */ - public static final int SENSOR_REFERENCE_ILLUMINANT_COOL_WHITE_FLUORESCENT = 14; - - /** - * <p>WW 3200 - 3700K</p> - * @see CaptureResult#SENSOR_REFERENCE_ILLUMINANT - */ - public static final int SENSOR_REFERENCE_ILLUMINANT_WHITE_FLUORESCENT = 15; - - /** - * @see CaptureResult#SENSOR_REFERENCE_ILLUMINANT - */ - public static final int SENSOR_REFERENCE_ILLUMINANT_STANDARD_A = 17; - - /** - * @see CaptureResult#SENSOR_REFERENCE_ILLUMINANT - */ - public static final int SENSOR_REFERENCE_ILLUMINANT_STANDARD_B = 18; - - /** - * @see CaptureResult#SENSOR_REFERENCE_ILLUMINANT - */ - public static final int SENSOR_REFERENCE_ILLUMINANT_STANDARD_C = 19; - - /** - * @see CaptureResult#SENSOR_REFERENCE_ILLUMINANT - */ - public static final int SENSOR_REFERENCE_ILLUMINANT_D55 = 20; - - /** - * @see CaptureResult#SENSOR_REFERENCE_ILLUMINANT - */ - public static final int SENSOR_REFERENCE_ILLUMINANT_D65 = 21; - - /** - * @see CaptureResult#SENSOR_REFERENCE_ILLUMINANT - */ - public static final int SENSOR_REFERENCE_ILLUMINANT_D75 = 22; - - /** - * @see CaptureResult#SENSOR_REFERENCE_ILLUMINANT - */ - public static final int SENSOR_REFERENCE_ILLUMINANT_D50 = 23; - - /** - * @see CaptureResult#SENSOR_REFERENCE_ILLUMINANT - */ - public static final int SENSOR_REFERENCE_ILLUMINANT_ISO_STUDIO_TUNGSTEN = 24; - - // // Enumeration values for CaptureResult#STATISTICS_SCENE_FLICKER // diff --git a/core/java/android/hardware/camera2/CaptureResult.java b/core/java/android/hardware/camera2/CaptureResult.java index b3bce3b..70d3c63 100644 --- a/core/java/android/hardware/camera2/CaptureResult.java +++ b/core/java/android/hardware/camera2/CaptureResult.java @@ -1607,77 +1607,14 @@ public final class CaptureResult extends CameraMetadata { new Key<Float>("android.sensor.temperature", float.class); /** - * <p>A reference illumination source roughly matching the current scene - * illumination, which is used to describe the sensor color space - * transformations.</p> - * <p>The values in this tag correspond to the values defined for the - * EXIF LightSource tag. These illuminants are standard light sources - * that are often used for calibrating camera devices.</p> - * @see #SENSOR_REFERENCE_ILLUMINANT_DAYLIGHT - * @see #SENSOR_REFERENCE_ILLUMINANT_FLUORESCENT - * @see #SENSOR_REFERENCE_ILLUMINANT_TUNGSTEN - * @see #SENSOR_REFERENCE_ILLUMINANT_FLASH - * @see #SENSOR_REFERENCE_ILLUMINANT_FINE_WEATHER - * @see #SENSOR_REFERENCE_ILLUMINANT_CLOUDY_WEATHER - * @see #SENSOR_REFERENCE_ILLUMINANT_SHADE - * @see #SENSOR_REFERENCE_ILLUMINANT_DAYLIGHT_FLUORESCENT - * @see #SENSOR_REFERENCE_ILLUMINANT_DAY_WHITE_FLUORESCENT - * @see #SENSOR_REFERENCE_ILLUMINANT_COOL_WHITE_FLUORESCENT - * @see #SENSOR_REFERENCE_ILLUMINANT_WHITE_FLUORESCENT - * @see #SENSOR_REFERENCE_ILLUMINANT_STANDARD_A - * @see #SENSOR_REFERENCE_ILLUMINANT_STANDARD_B - * @see #SENSOR_REFERENCE_ILLUMINANT_STANDARD_C - * @see #SENSOR_REFERENCE_ILLUMINANT_D55 - * @see #SENSOR_REFERENCE_ILLUMINANT_D65 - * @see #SENSOR_REFERENCE_ILLUMINANT_D75 - * @see #SENSOR_REFERENCE_ILLUMINANT_D50 - * @see #SENSOR_REFERENCE_ILLUMINANT_ISO_STUDIO_TUNGSTEN - */ - public static final Key<Integer> SENSOR_REFERENCE_ILLUMINANT = - new Key<Integer>("android.sensor.referenceIlluminant", int.class); - - /** - * <p>A per-device calibration transform matrix to be applied after the - * color space transform when rendering the raw image buffer.</p> - * <p>This matrix is expressed as a 3x3 matrix in row-major-order, and - * contains a per-device calibration transform that maps colors - * from reference camera color space (i.e. the "golden module" - * colorspace) into this camera device's linear native sensor color - * space for the current scene illumination and white balance choice.</p> - * <p><b>Optional</b> - This value may be {@code null} on some devices.</p> - */ - public static final Key<Rational[]> SENSOR_CALIBRATION_TRANSFORM = - new Key<Rational[]>("android.sensor.calibrationTransform", Rational[].class); - - /** - * <p>A matrix that transforms color values from CIE XYZ color space to - * reference camera color space when rendering the raw image buffer.</p> - * <p>This matrix is expressed as a 3x3 matrix in row-major-order, and - * contains a color transform matrix that maps colors from the CIE - * XYZ color space to the reference camera raw color space (i.e. the - * "golden module" colorspace) for the current scene illumination and - * white balance choice.</p> - * <p><b>Optional</b> - This value may be {@code null} on some devices.</p> - */ - public static final Key<Rational[]> SENSOR_COLOR_TRANSFORM = - new Key<Rational[]>("android.sensor.colorTransform", Rational[].class); - - /** - * <p>A matrix that transforms white balanced camera colors to the CIE XYZ - * colorspace with a D50 whitepoint.</p> - * <p>This matrix is expressed as a 3x3 matrix in row-major-order, and contains - * a color transform matrix that maps a unit vector in the linear native - * sensor color space to the D50 whitepoint in CIE XYZ color space.</p> - * <p><b>Optional</b> - This value may be {@code null} on some devices.</p> - */ - public static final Key<Rational[]> SENSOR_FORWARD_MATRIX = - new Key<Rational[]>("android.sensor.forwardMatrix", Rational[].class); - - /** - * <p>The estimated white balance at the time of capture.</p> - * <p>The estimated white balance encoded as the RGB values of the - * perfectly neutral color point in the linear native sensor color space. - * The order of the values is R, G, B; where R is in the lowest index.</p> + * <p>The estimated camera neutral color in the native sensor colorspace at + * the time of capture.</p> + * <p>This value gives the neutral color point encoded as an RGB value in the + * native sensor color space. The neutral color point indicates the + * currently estimated white point of the scene illumination. It can be + * used to interpolate between the provided color transforms when + * processing raw sensor data.</p> + * <p>The order of the values is R, G, B; where R is in the lowest index.</p> * <p><b>Optional</b> - This value may be {@code null} on some devices.</p> */ public static final Key<Rational[]> SENSOR_NEUTRAL_COLOR_POINT = |