src.android.graphics.PixelFormat Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of android-all Show documentation
Show all versions of android-all Show documentation
A library jar that provides APIs for Applications written for the Google Android Platform.
/*
* 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;
/** @hide */
public static final int HSV_888 = 0x37;
/**
* @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:
case HSV_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}.
*
* 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(@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 HSV_888:
return "HSV_888";
case JPEG:
return "JPEG";
default:
return Integer.toString(format);
}
}
}