diff options
author | Zhijun He <zhijunhe@google.com> | 2016-04-14 05:17:45 +0000 |
---|---|---|
committer | Android (Google) Code Review <android-gerrit@google.com> | 2016-04-14 05:17:45 +0000 |
commit | 4bf96dd47c621b1a40d3601cf5be0fc301f4b01e (patch) | |
tree | 44d5ac228a660c2a507543d60701c5b37ac17832 | |
parent | 94f013bc07c61d0c06af951f0eb5885baa3a1c47 (diff) | |
parent | 5f92cff081ba23044733504428fcb29235ecefe2 (diff) | |
download | android_system_media-4bf96dd47c621b1a40d3601cf5be0fc301f4b01e.tar.gz android_system_media-4bf96dd47c621b1a40d3601cf5be0fc301f4b01e.tar.bz2 android_system_media-4bf96dd47c621b1a40d3601cf5be0fc301f4b01e.zip |
Merge "Camera: clarify lens shading map" into nyc-dev
-rw-r--r-- | camera/docs/docs.html | 18 | ||||
-rw-r--r-- | camera/docs/metadata_properties.xml | 21 |
2 files changed, 31 insertions, 8 deletions
diff --git a/camera/docs/docs.html b/camera/docs/docs.html index a8f886cd..fcb399d1 100644 --- a/camera/docs/docs.html +++ b/camera/docs/docs.html @@ -23608,8 +23608,8 @@ image of a gray wall (using bicubic interpolation for visual quality) as capture <td class="entry_description"> <p>The shading map is a low-resolution floating-point map -that lists the coefficients used to correct for vignetting,<wbr/> for each -Bayer color channel of RAW image data.<wbr/></p> +that lists the coefficients used to correct for vignetting and color shading,<wbr/> +for each Bayer color channel of RAW image data.<wbr/></p> </td> <td class="entry_units"> @@ -23628,8 +23628,18 @@ Bayer color channel of RAW image data.<wbr/></p> </tr> <tr class="entry_cont"> <td class="entry_details" colspan="5"> - <p>The least shaded section of the image should have a gain factor -of 1; all other sections should have gains above 1.<wbr/></p> + <p>The lens shading correction is defined as a full shading correction that +corrects both color shading for the output non-RAW images.<wbr/> After the +shading map is applied,<wbr/> the output non-RAW images will be flat-field images +for flat scenes under uniform illumination.<wbr/></p> +<p>When there is no lens shading correction applied to RAW output images +(<a href="#static_android.sensor.info.lensShadingApplied">android.<wbr/>sensor.<wbr/>info.<wbr/>lens<wbr/>Shading<wbr/>Applied</a> <code>==</code> false),<wbr/> this map is a full lens +shading correction map; when there is some lens shading correction applied +to the RAW output image (<a href="#static_android.sensor.info.lensShadingApplied">android.<wbr/>sensor.<wbr/>info.<wbr/>lens<wbr/>Shading<wbr/>Applied</a> <code>==</code> true),<wbr/> +this map reports the remaining lens shading correction map that needs to be +applied to get fully shading corrected images.<wbr/></p> +<p>For a full shading correction map,<wbr/> the least shaded section of the image +should have a gain factor of 1; all other sections should have gains above 1.<wbr/></p> <p>When <a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> = TRANSFORM_<wbr/>MATRIX,<wbr/> the map must take into account the colorCorrection settings.<wbr/></p> <p>The shading map is for the entire active pixel array,<wbr/> and is not diff --git a/camera/docs/metadata_properties.xml b/camera/docs/metadata_properties.xml index e0a1737e..b2168519 100644 --- a/camera/docs/metadata_properties.xml +++ b/camera/docs/metadata_properties.xml @@ -7680,11 +7680,24 @@ xsi:schemaLocation="http://schemas.android.com/service/camera/metadata/ metadata <size>m</size> </array> <description>The shading map is a low-resolution floating-point map - that lists the coefficients used to correct for vignetting, for each - Bayer color channel of RAW image data.</description> + that lists the coefficients used to correct for vignetting and color shading, + for each Bayer color channel of RAW image data.</description> <range>Each gain factor is &gt;= 1</range> - <details>The least shaded section of the image should have a gain factor - of 1; all other sections should have gains above 1. + <details> + The lens shading correction is defined as a full shading correction that + corrects both color shading for the output non-RAW images. After the + shading map is applied, the output non-RAW images will be flat-field images + for flat scenes under uniform illumination. + + When there is no lens shading correction applied to RAW output images + (android.sensor.info.lensShadingApplied `==` false), this map is a full lens + shading correction map; when there is some lens shading correction applied + to the RAW output image (android.sensor.info.lensShadingApplied `==` true), + this map reports the remaining lens shading correction map that needs to be + applied to get fully shading corrected images. + + For a full shading correction map, the least shaded section of the image + should have a gain factor of 1; all other sections should have gains above 1. When android.colorCorrection.mode = TRANSFORM_MATRIX, the map must take into account the colorCorrection settings. |