1edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project/* 2edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * Copyright (C) 2005 The Android Open Source Project 3edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * 4edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 5edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * you may not use this file except in compliance with the License. 6edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * You may obtain a copy of the License at 7edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * 8edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 9edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * 10edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 11edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 12edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * See the License for the specific language governing permissions and 14edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * limitations under the License. 15edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project */ 16edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 17edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// 18edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 19edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// Pixel formats used across the system. 20edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// These formats might not all be supported by all renderers, for instance 21edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// skia or SurfaceFlinger are not required to support all of these formats 22edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// (either as source or destination) 23edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 24edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 25edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#ifndef UI_PIXELFORMAT_H 26edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#define UI_PIXELFORMAT_H 27edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 28edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <stdint.h> 29edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <sys/types.h> 30edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <utils/Errors.h> 3154ed4f6282bdea251455f39b978626026affdbefMathias Agopian#include <hardware/hardware.h> 32edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 33edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectnamespace android { 34edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 35edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectenum { 36edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // 37edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // these constants need to match those 38edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // in graphics/PixelFormat.java & pixelflinger/format.h 39edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // 40edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project PIXEL_FORMAT_UNKNOWN = 0, 41edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project PIXEL_FORMAT_NONE = 0, 42edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 43edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // logical pixel formats used by the SurfaceFlinger ----------------------- 44edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project PIXEL_FORMAT_CUSTOM = -4, 45edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // Custom pixel-format described by a PixelFormatInfo structure 46edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 47edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project PIXEL_FORMAT_TRANSLUCENT = -3, 48edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // System chooses a format that supports translucency (many alpha bits) 49edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 50edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project PIXEL_FORMAT_TRANSPARENT = -2, 51edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // System chooses a format that supports transparency 52edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // (at least 1 alpha bit) 53edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 54edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project PIXEL_FORMAT_OPAQUE = -1, 55edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // System chooses an opaque format (no alpha bits required) 56acb7b5dfc804d2e6b2e75b688f536fd38d75641aPannag Sanketi 57edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // real pixel formats supported for rendering ----------------------------- 58edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 5954ed4f6282bdea251455f39b978626026affdbefMathias Agopian PIXEL_FORMAT_RGBA_8888 = HAL_PIXEL_FORMAT_RGBA_8888, // 4x8-bit RGBA 6054ed4f6282bdea251455f39b978626026affdbefMathias Agopian PIXEL_FORMAT_RGBX_8888 = HAL_PIXEL_FORMAT_RGBX_8888, // 4x8-bit RGB0 6154ed4f6282bdea251455f39b978626026affdbefMathias Agopian PIXEL_FORMAT_RGB_888 = HAL_PIXEL_FORMAT_RGB_888, // 3x8-bit RGB 6254ed4f6282bdea251455f39b978626026affdbefMathias Agopian PIXEL_FORMAT_RGB_565 = HAL_PIXEL_FORMAT_RGB_565, // 16-bit RGB 6354ed4f6282bdea251455f39b978626026affdbefMathias Agopian PIXEL_FORMAT_BGRA_8888 = HAL_PIXEL_FORMAT_BGRA_8888, // 4x8-bit BGRA 6454ed4f6282bdea251455f39b978626026affdbefMathias Agopian PIXEL_FORMAT_RGBA_5551 = HAL_PIXEL_FORMAT_RGBA_5551, // 16-bit ARGB 6554ed4f6282bdea251455f39b978626026affdbefMathias Agopian PIXEL_FORMAT_RGBA_4444 = HAL_PIXEL_FORMAT_RGBA_4444, // 16-bit ARGB 6642e2458144778596281ea2c4a98ad671053234e0Mathias Agopian PIXEL_FORMAT_A_8 = 8, // 8-bit A 67edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; 68edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 69edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projecttypedef int32_t PixelFormat; 70edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 7142e2458144778596281ea2c4a98ad671053234e0Mathias Agopianstruct PixelFormatInfo { 72076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian enum { 73076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian INDEX_ALPHA = 0, 74076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian INDEX_RED = 1, 75076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian INDEX_GREEN = 2, 76076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian INDEX_BLUE = 3 77076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian }; 78acb7b5dfc804d2e6b2e75b688f536fd38d75641aPannag Sanketi 79edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project enum { // components 80ff615cc7a1cceedd705b0623b058c54669b29596Mathias Agopian ALPHA = 1, 81ff615cc7a1cceedd705b0623b058c54669b29596Mathias Agopian RGB = 2, 82ff615cc7a1cceedd705b0623b058c54669b29596Mathias Agopian RGBA = 3, 83ff615cc7a1cceedd705b0623b058c54669b29596Mathias Agopian L = 4, 84ff615cc7a1cceedd705b0623b058c54669b29596Mathias Agopian LA = 5, 85ff615cc7a1cceedd705b0623b058c54669b29596Mathias Agopian OTHER = 0xFF 86edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project }; 87edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 88076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian struct szinfo { 89076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian uint8_t h; 90076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian uint8_t l; 91076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian }; 92acb7b5dfc804d2e6b2e75b688f536fd38d75641aPannag Sanketi 93edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project inline PixelFormatInfo() : version(sizeof(PixelFormatInfo)) { } 94edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project size_t getScanlineSize(unsigned int width) const; 95acb7b5dfc804d2e6b2e75b688f536fd38d75641aPannag Sanketi size_t getSize(size_t ci) const { 96076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian return (ci <= 3) ? (cinfo[ci].h - cinfo[ci].l) : 0; 97076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian } 98edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project size_t version; 99edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project PixelFormat format; 100edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project size_t bytesPerPixel; 101edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project size_t bitsPerPixel; 102076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian union { 103076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian szinfo cinfo[4]; 104076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian struct { 105076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian uint8_t h_alpha; 106acb7b5dfc804d2e6b2e75b688f536fd38d75641aPannag Sanketi uint8_t l_alpha; 107076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian uint8_t h_red; 108076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian uint8_t l_red; 109076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian uint8_t h_green; 110076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian uint8_t l_green; 111076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian uint8_t h_blue; 112076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian uint8_t l_blue; 113076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian }; 114076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian }; 115edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project uint8_t components; 116edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project uint8_t reserved0[3]; 117edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project uint32_t reserved1; 118edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; 119edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 120edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// Consider caching the results of these functions are they're not 121edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// guaranteed to be fast. 122edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectssize_t bytesPerPixel(PixelFormat format); 123edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectssize_t bitsPerPixel(PixelFormat format); 124edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectstatus_t getPixelFormatInfo(PixelFormat format, PixelFormatInfo* info); 125edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 126edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; // namespace android 127edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 128edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#endif // UI_PIXELFORMAT_H 129