Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit eaa6263b authored by John Reck's avatar John Reck
Browse files

Clarify byte packing is only for "raw" access 

Fixes: 264608640
Test: n/a doc only change
Flag: DOCS_ONLY
Change-Id: Ib8c18671d7f4fada5358a41229f61a2154bcf992
parent 73588b3f

graphics/java/android/graphics/Bitmap.java

+8 −4
Original line number Diff line number Diff line
@@ -479,7 +479,8 @@ public final class Bitmap implements Parcelable { 
         * This configuration may be useful when using opaque bitmaps

         * that do not require high color fidelity.

         *

         * <p>Use this formula to pack into 16 bits:</p>

         * <p>When accessing directly via #copyPixelsFromBuffer or #copyPixelsToBuffer,

         *    use this formula to pack into 16 bits:</p>

         * <pre class="prettyprint">

         * short color = (R & 0x1f) << 11 | (G & 0x3f) << 5 | (B & 0x1f);

         * </pre>
@@ -516,7 +517,8 @@ public final class Bitmap implements Parcelable { 
         * This configuration is very flexible and offers the best

         * quality. It should be used whenever possible.

         *

         * <p>Use this formula to pack into 32 bits:</p>

         * <p>When accessing directly via #copyPixelsFromBuffer or #copyPixelsToBuffer,

         *    use this formula to pack into 32 bits:</p>

         * <pre class="prettyprint">

         * int color = (A & 0xff) << 24 | (B & 0xff) << 16 | (G & 0xff) << 8 | (R & 0xff);

         * </pre>
@@ -531,7 +533,8 @@ public final class Bitmap implements Parcelable { 
         * This configuration is particularly suited for wide-gamut and

         * HDR content.

         *

         * <p>Use this formula to pack into 64 bits:</p>

         * <p>When accessing directly via #copyPixelsFromBuffer or #copyPixelsToBuffer,

         *    use this formula to pack into 64 bits:</p>

         * <pre class="prettyprint">

         * long color = (A & 0xffff) << 48 | (B & 0xffff) << 32 | (G & 0xffff) << 16 | (R & 0xffff);

         * </pre>
@@ -556,7 +559,8 @@ public final class Bitmap implements Parcelable { 
         * blending, such that the memory cost is the same as ARGB_8888 while enabling higher color

         * precision.

         *

         * <p>Use this formula to pack into 32 bits:</p>

         * <p>When accessing directly via #copyPixelsFromBuffer or #copyPixelsToBuffer,

         *  use this formula to pack into 32 bits:</p>

         * <pre class="prettyprint">

         * int color = (A & 0x3) << 30 | (B & 0x3ff) << 20 | (G & 0x3ff) << 10 | (R & 0x3ff);

         * </pre>