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

Commit 2a420c3a authored by Leon Scroggins III's avatar Leon Scroggins III
Browse files

Add comments regarding FILTER_BITMAP_FLAG 

Fixes: 179934762
Bug: 77949917
Test: make -j docs
Change-Id: I7d831b24877e73ce090d53dc497d749afab6bd7b
parent e5809444

graphics/java/android/graphics/Paint.java

+22 −0
Original line number Diff line number Diff line
@@ -153,6 +153,13 @@ public class Paint { 
     * resource bitmaps often are) the filtering will already have been

     * done.</p>

     *

     * <p>On devices running {@link Build.VERSION_CODES#O} and below, hardware

     * accelerated drawing always uses bilinear sampling on scaled bitmaps,

     * regardless of this flag. On devices running {@link Build.VERSION_CODES#Q}

     * and above, this flag defaults to being set on a new {@code Paint}. It can

     * be cleared with {@link #setFlags} or {@link #setFilterBitmap}.</p>

     *

     * @see #Paint()

     * @see #Paint(int)

     * @see #setFlags(int)

     */
@@ -558,6 +565,12 @@ public class Paint { 


    /**

     * Create a new paint with default settings.

     *

     * <p>On devices running {@link Build.VERSION_CODES#O} and below, hardware

     * accelerated drawing always acts as if {@link #FILTER_BITMAP_FLAG} is set.

     * On devices running {@link Build.VERSION_CODES#Q} and above,

     * {@code FILTER_BITMAP_FLAG} is set by this constructor, and it can be

     * cleared with {@link #setFlags} or {@link #setFilterBitmap}.</p>

     */

    public Paint() {

        this(0);
@@ -567,6 +580,13 @@ public class Paint { 
     * Create a new paint with the specified flags. Use setFlags() to change

     * these after the paint is created.

     *

     * <p>On devices running {@link Build.VERSION_CODES#O} and below, hardware

     * accelerated drawing always acts as if {@link #FILTER_BITMAP_FLAG} is set.

     * On devices running {@link Build.VERSION_CODES#Q} and above,

     * {@code FILTER_BITMAP_FLAG} is always set by this constructor, regardless

     * of the value of {@code flags}. It can be cleared with {@link #setFlags} or

     * {@link #setFilterBitmap}.</p>

     *

     * @param flags initial flag bits, as if they were passed via setFlags().

     */

    public Paint(int flags) {
@@ -991,6 +1011,7 @@ public class Paint { 
     * device pixels. That is dependent on dithering and xfermodes.

     *

     * @see #setFilterBitmap(boolean) setFilterBitmap()

     * @see #FILTER_BITMAP_FLAG

     */

    public final boolean isFilterBitmap() {

        return (getFlags() & FILTER_BITMAP_FLAG) != 0;
@@ -1004,6 +1025,7 @@ public class Paint { 
     *

     * @param filter true to set the FILTER_BITMAP_FLAG bit in the paint's

     *               flags, false to clear it.

     * @see #FILTER_BITMAP_FLAG

     */

    public void setFilterBitmap(boolean filter) {

        nSetFilterBitmap(mNativePaint, filter);