19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2005 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// Pixel formats used across the system. 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// These formats might not all be supported by all renderers, for instance 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// skia or SurfaceFlinger are not required to support all of these formats 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// (either as source or destination) 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// XXX: we should consolidate these formats and skia's 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#ifndef UI_PIXELFORMAT_H 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#define UI_PIXELFORMAT_H 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#include <stdint.h> 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#include <sys/types.h> 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#include <utils/Errors.h> 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#include <pixelflinger/format.h> 338f2423e8f394ae0666f1b61f83df4c0c7a4782d9Mathias Agopian#include <hardware/hardware.h> 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectnamespace android { 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectenum { 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // these constants need to match those 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // in graphics/PixelFormat.java & pixelflinger/format.h 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PIXEL_FORMAT_UNKNOWN = 0, 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PIXEL_FORMAT_NONE = 0, 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // logical pixel formats used by the SurfaceFlinger ----------------------- 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PIXEL_FORMAT_CUSTOM = -4, 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Custom pixel-format described by a PixelFormatInfo structure 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PIXEL_FORMAT_TRANSLUCENT = -3, 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // System chooses a format that supports translucency (many alpha bits) 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PIXEL_FORMAT_TRANSPARENT = -2, 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // System chooses a format that supports transparency 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // (at least 1 alpha bit) 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PIXEL_FORMAT_OPAQUE = -1, 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // System chooses an opaque format (no alpha bits required) 5826a197120c1bad8797f35e9b43482f5466280f8cPannag Sanketi 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // real pixel formats supported for rendering ----------------------------- 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 618f2423e8f394ae0666f1b61f83df4c0c7a4782d9Mathias Agopian PIXEL_FORMAT_RGBA_8888 = HAL_PIXEL_FORMAT_RGBA_8888, // 4x8-bit RGBA 628f2423e8f394ae0666f1b61f83df4c0c7a4782d9Mathias Agopian PIXEL_FORMAT_RGBX_8888 = HAL_PIXEL_FORMAT_RGBX_8888, // 4x8-bit RGB0 638f2423e8f394ae0666f1b61f83df4c0c7a4782d9Mathias Agopian PIXEL_FORMAT_RGB_888 = HAL_PIXEL_FORMAT_RGB_888, // 3x8-bit RGB 648f2423e8f394ae0666f1b61f83df4c0c7a4782d9Mathias Agopian PIXEL_FORMAT_RGB_565 = HAL_PIXEL_FORMAT_RGB_565, // 16-bit RGB 658f2423e8f394ae0666f1b61f83df4c0c7a4782d9Mathias Agopian PIXEL_FORMAT_BGRA_8888 = HAL_PIXEL_FORMAT_BGRA_8888, // 4x8-bit BGRA 668f2423e8f394ae0666f1b61f83df4c0c7a4782d9Mathias Agopian PIXEL_FORMAT_RGBA_5551 = HAL_PIXEL_FORMAT_RGBA_5551, // 16-bit ARGB 678f2423e8f394ae0666f1b61f83df4c0c7a4782d9Mathias Agopian PIXEL_FORMAT_RGBA_4444 = HAL_PIXEL_FORMAT_RGBA_4444, // 16-bit ARGB 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PIXEL_FORMAT_A_8 = GGL_PIXEL_FORMAT_A_8, // 8-bit A 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PIXEL_FORMAT_L_8 = GGL_PIXEL_FORMAT_L_8, // 8-bit L (R=G=B=L) 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PIXEL_FORMAT_LA_88 = GGL_PIXEL_FORMAT_LA_88, // 16-bit LA 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PIXEL_FORMAT_RGB_332 = GGL_PIXEL_FORMAT_RGB_332, // 8-bit RGB 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // New formats can be added if they're also defined in 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // pixelflinger/format.h 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project}; 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecttypedef int32_t PixelFormat; 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectstruct PixelFormatInfo 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 811473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian enum { 821473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian INDEX_ALPHA = 0, 831473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian INDEX_RED = 1, 841473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian INDEX_GREEN = 2, 851473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian INDEX_BLUE = 3 861473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian }; 8726a197120c1bad8797f35e9b43482f5466280f8cPannag Sanketi 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project enum { // components 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ALPHA = 1, 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project RGB = 2, 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project RGBA = 3, 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project LUMINANCE = 4, 93102f49f361b9d8d780b0f683f417f8c02a4e25f3Mathias Agopian LUMINANCE_ALPHA = 5, 94102f49f361b9d8d780b0f683f417f8c02a4e25f3Mathias Agopian OTHER = 0xFF 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 971473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian struct szinfo { 981473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian uint8_t h; 991473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian uint8_t l; 1001473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian }; 10126a197120c1bad8797f35e9b43482f5466280f8cPannag Sanketi 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline PixelFormatInfo() : version(sizeof(PixelFormatInfo)) { } 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project size_t getScanlineSize(unsigned int width) const; 10426a197120c1bad8797f35e9b43482f5466280f8cPannag Sanketi size_t getSize(size_t ci) const { 1051473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian return (ci <= 3) ? (cinfo[ci].h - cinfo[ci].l) : 0; 1061473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian } 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project size_t version; 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PixelFormat format; 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project size_t bytesPerPixel; 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project size_t bitsPerPixel; 1111473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian union { 1121473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian szinfo cinfo[4]; 1131473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian struct { 1141473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian uint8_t h_alpha; 11526a197120c1bad8797f35e9b43482f5466280f8cPannag Sanketi uint8_t l_alpha; 1161473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian uint8_t h_red; 1171473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian uint8_t l_red; 1181473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian uint8_t h_green; 1191473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian uint8_t l_green; 1201473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian uint8_t h_blue; 1211473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian uint8_t l_blue; 1221473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian }; 1231473f46cbc82aa6f0ba744cc896a36923823d55bMathias Agopian }; 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project uint8_t components; 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project uint8_t reserved0[3]; 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project uint32_t reserved1; 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project}; 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// Consider caching the results of these functions are they're not 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// guaranteed to be fast. 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectssize_t bytesPerPixel(PixelFormat format); 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectssize_t bitsPerPixel(PixelFormat format); 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectstatus_t getPixelFormatInfo(PixelFormat format, PixelFormatInfo* info); 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project}; // namespace android 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#endif // UI_PIXELFORMAT_H 138