android.graphics.PixelFormat.java Source code

Java tutorial

Introduction

Here is the source code for android.graphics.PixelFormat.java

Source

/*
 * Copyright (C) 2006 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package android.graphics;

import android.annotation.IntDef;

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;

public class PixelFormat {
    /** @hide */
    @IntDef({ UNKNOWN, TRANSLUCENT, TRANSPARENT, OPAQUE })
    @Retention(RetentionPolicy.SOURCE)
    public @interface Opacity {
    }

    /** @hide */
    @Retention(RetentionPolicy.SOURCE)
    @IntDef({ RGBA_8888, RGBX_8888, RGBA_F16, RGBA_1010102, RGB_888, RGB_565 })
    public @interface Format {
    }

    // NOTE: these constants must match the values from graphics/common/x.x/types.hal

    public static final int UNKNOWN = 0;

    /** System chooses a format that supports translucency (many alpha bits) */
    public static final int TRANSLUCENT = -3;

    /**
     * System chooses a format that supports transparency
     * (at least 1 alpha bit)
     */
    public static final int TRANSPARENT = -2;

    /** System chooses an opaque format (no alpha bits required) */
    public static final int OPAQUE = -1;

    public static final int RGBA_8888 = 1;
    public static final int RGBX_8888 = 2;
    public static final int RGB_888 = 3;
    public static final int RGB_565 = 4;

    @Deprecated
    public static final int RGBA_5551 = 6;
    @Deprecated
    public static final int RGBA_4444 = 7;
    @Deprecated
    public static final int A_8 = 8;
    @Deprecated
    public static final int L_8 = 9;
    @Deprecated
    public static final int LA_88 = 0xA;
    @Deprecated
    public static final int RGB_332 = 0xB;

    /**
     * @deprecated use {@link android.graphics.ImageFormat#NV16
     * ImageFormat.NV16} instead.
     */
    @Deprecated
    public static final int YCbCr_422_SP = 0x10;

    /**
     * @deprecated use {@link android.graphics.ImageFormat#NV21
     * ImageFormat.NV21} instead.
     */
    @Deprecated
    public static final int YCbCr_420_SP = 0x11;

    /**
     * @deprecated use {@link android.graphics.ImageFormat#YUY2
     * ImageFormat.YUY2} instead.
     */
    @Deprecated
    public static final int YCbCr_422_I = 0x14;

    public static final int RGBA_F16 = 0x16;
    public static final int RGBA_1010102 = 0x2B;

    /**
     * @deprecated use {@link android.graphics.ImageFormat#JPEG
     * ImageFormat.JPEG} instead.
     */
    @Deprecated
    public static final int JPEG = 0x100;

    public int bytesPerPixel;
    public int bitsPerPixel;

    public static void getPixelFormatInfo(@Format int format, PixelFormat info) {
        switch (format) {
        case RGBA_8888:
        case RGBX_8888:
        case RGBA_1010102:
            info.bitsPerPixel = 32;
            info.bytesPerPixel = 4;
            break;
        case RGB_888:
            info.bitsPerPixel = 24;
            info.bytesPerPixel = 3;
            break;
        case RGB_565:
        case RGBA_5551:
        case RGBA_4444:
        case LA_88:
            info.bitsPerPixel = 16;
            info.bytesPerPixel = 2;
            break;
        case A_8:
        case L_8:
        case RGB_332:
            info.bitsPerPixel = 8;
            info.bytesPerPixel = 1;
            break;
        case YCbCr_422_SP:
        case YCbCr_422_I:
            info.bitsPerPixel = 16;
            info.bytesPerPixel = 1;
            break;
        case YCbCr_420_SP:
            info.bitsPerPixel = 12;
            info.bytesPerPixel = 1;
            break;
        case RGBA_F16:
            info.bitsPerPixel = 64;
            info.bytesPerPixel = 8;
            break;
        default:
            throw new IllegalArgumentException("unknown pixel format " + format);
        }
    }

    public static boolean formatHasAlpha(@Format int format) {
        switch (format) {
        case PixelFormat.A_8:
        case PixelFormat.LA_88:
        case PixelFormat.RGBA_4444:
        case PixelFormat.RGBA_5551:
        case PixelFormat.RGBA_8888:
        case PixelFormat.RGBA_F16:
        case PixelFormat.RGBA_1010102:
        case PixelFormat.TRANSLUCENT:
        case PixelFormat.TRANSPARENT:
            return true;
        }
        return false;
    }

    /**
     * Determine whether or not this is a public-visible and non-deprecated {@code format}.
     *
     * <p>In particular, {@code @hide} formats will return {@code false}.</p>
     *
     * <p>Any other indirect formats (such as {@code TRANSPARENT} or {@code TRANSLUCENT})
     * will return {@code false}.</p>
     *
     * @param format an integer format
     * @return a boolean
     *
     * @hide
     */
    public static boolean isPublicFormat(@Format int format) {
        switch (format) {
        case RGBA_8888:
        case RGBX_8888:
        case RGB_888:
        case RGB_565:
        case RGBA_F16:
        case RGBA_1010102:
            return true;
        }

        return false;
    }

    /**
     * @hide
     */
    public static String formatToString(@Format int format) {
        switch (format) {
        case UNKNOWN:
            return "UNKNOWN";
        case TRANSLUCENT:
            return "TRANSLUCENT";
        case TRANSPARENT:
            return "TRANSPARENT";
        case RGBA_8888:
            return "RGBA_8888";
        case RGBX_8888:
            return "RGBX_8888";
        case RGB_888:
            return "RGB_888";
        case RGB_565:
            return "RGB_565";
        case RGBA_5551:
            return "RGBA_5551";
        case RGBA_4444:
            return "RGBA_4444";
        case A_8:
            return "A_8";
        case L_8:
            return "L_8";
        case LA_88:
            return "LA_88";
        case RGB_332:
            return "RGB_332";
        case YCbCr_422_SP:
            return "YCbCr_422_SP";
        case YCbCr_420_SP:
            return "YCbCr_420_SP";
        case YCbCr_422_I:
            return "YCbCr_422_I";
        case RGBA_F16:
            return "RGBA_F16";
        case RGBA_1010102:
            return "RGBA_1010102";
        case JPEG:
            return "JPEG";
        default:
            return Integer.toString(format);
        }
    }
}