/* * 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 {} /* these constants need to match those in hardware/hardware.h */ 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; /** * @deprecated use {@link android.graphics.ImageFormat#JPEG * ImageFormat.JPEG} instead. */ @Deprecated public static final int JPEG = 0x100; public static void getPixelFormatInfo(int format, PixelFormat info) { switch (format) { case RGBA_8888: case RGBX_8888: 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; default: throw new IllegalArgumentException("unknown pixel format " + format); } } public static boolean formatHasAlpha(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.TRANSLUCENT: case PixelFormat.TRANSPARENT: return true; } return false; } public int bytesPerPixel; public int bitsPerPixel; /** * Determine whether or not this is a public-visible and non-deprecated {@code format}. * *

In particular, {@code @hide} formats will return {@code false}.

* *

Any other indirect formats (such as {@code TRANSPARENT} or {@code TRANSLUCENT}) * will return {@code false}.

* * @param format an integer format * @return a boolean * * @hide */ public static boolean isPublicFormat(int format) { switch (format) { case RGBA_8888: case RGBX_8888: case RGB_888: case RGB_565: return true; } return false; } }