Java tutorial
/* * 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); } } }