summaryrefslogtreecommitdiffstats
path: root/graphics
diff options
context:
space:
mode:
authorEino-Ville Talvala <etalvala@google.com>2012-04-10 15:57:31 -0700
committerEino-Ville Talvala <etalvala@google.com>2012-04-10 15:57:31 -0700
commit9184ec307be30719b2b7bfc3fb3e0a1365ccdf73 (patch)
treea0f71cbb5159d6e609a0312c5d04aa2ca38fcc50 /graphics
parentc1c2ca0cc62e482ec30d17a7ea30a0ff393a6009 (diff)
downloadframeworks_base-9184ec307be30719b2b7bfc3fb3e0a1365ccdf73.zip
frameworks_base-9184ec307be30719b2b7bfc3fb3e0a1365ccdf73.tar.gz
frameworks_base-9184ec307be30719b2b7bfc3fb3e0a1365ccdf73.tar.bz2
Editing fixes to ImageFormat documentation.
Change-Id: I74738a65abc3abbb49825b16f4efe3ac2eb6d28e
Diffstat (limited to 'graphics')
-rw-r--r--graphics/java/android/graphics/ImageFormat.java38
1 files changed, 21 insertions, 17 deletions
diff --git a/graphics/java/android/graphics/ImageFormat.java b/graphics/java/android/graphics/ImageFormat.java
index 7269a71..b3a8fd7 100644
--- a/graphics/java/android/graphics/ImageFormat.java
+++ b/graphics/java/android/graphics/ImageFormat.java
@@ -25,34 +25,38 @@ public class ImageFormat {
public static final int UNKNOWN = 0;
/**
- * RGB format used for pictures encoded as RGB_565 see
+ * RGB format used for pictures encoded as RGB_565. See
* {@link android.hardware.Camera.Parameters#setPictureFormat(int)}.
*/
public static final int RGB_565 = 4;
/**
- * Android YUV format:
+ * <p>Android YUV format.</p>
*
- * This format is exposed to software decoders and applications.
+ * <p>This format is exposed to software decoders and applications.</p>
*
- * YV12 is a 4:2:0 YCrCb planar format comprised of a WxH Y plane followed
- * by (W/2) x (H/2) Cr and Cb planes.
+ * <p>YV12 is a 4:2:0 YCrCb planar format comprised of a WxH Y plane followed
+ * by (W/2) x (H/2) Cr and Cb planes.</p>
*
- * This format assumes
- * - an even width
- * - an even height
- * - a horizontal stride multiple of 16 pixels
- * - a vertical stride equal to the height
+ * <p>This format assumes
+ * <ul>
+ * <li>an even width</li>
+ * <li>an even height</li>
+ * <li>a horizontal stride multiple of 16 pixels</li>
+ * <li>a vertical stride equal to the height</li>
+ * </ul>
+ * </p>
*
- * y_size = stride * height
- * c_size = ALIGN(stride/2, 16) * height/2
- * size = y_size + c_size * 2
- * cr_offset = y_size
- * cb_offset = y_size + c_size
+ * <pre> y_size = stride * height
+ * c_size = ALIGN(stride/2, 16) * height/2
+ * size = y_size + c_size * 2
+ * cr_offset = y_size
+ * cb_offset = y_size + c_size</pre>
*
- * Whether this format is supported by the camera hardware can be determined
- * by
+ * This format is guaranteed to be supported for camera preview images since
+ * API level 12; for earlier API versions, check
* {@link android.hardware.Camera.Parameters#getSupportedPreviewFormats()}.
+ * </p>
*/
public static final int YV12 = 0x32315659;