The Tor Browser / file revision

 /*

  * Copyright (C) 2008 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.

  */

 #ifndef ANDROID_INCLUDE_HARDWARE_HARDWARE_H

 #define ANDROID_INCLUDE_HARDWARE_HARDWARE_H

 #include <stdint.h>

 #include <sys/cdefs.h>

 #include <cutils/native_handle.h>

 __BEGIN_DECLS

 /*

  * Value for the hw_module_t.tag field

  */

 #define MAKE_TAG_CONSTANT(A,B,C,D) (((A) << 24) | ((B) << 16) | ((C) << 8) | (D))

 #define HARDWARE_MODULE_TAG MAKE_TAG_CONSTANT('H', 'W', 'M', 'T')

 #define HARDWARE_DEVICE_TAG MAKE_TAG_CONSTANT('H', 'W', 'D', 'T')

 struct hw_module_t;

 struct hw_module_methods_t;

 struct hw_device_t;

 /**

  * Every hardware module must have a data structure named HAL_MODULE_INFO_SYM

  * and the fields of this data structure must begin with hw_module_t

  * followed by module specific information.

  */

 typedef struct hw_module_t {

     /** tag must be initialized to HARDWARE_MODULE_TAG */

     uint32_t tag;

     /** major version number for the module */

     uint16_t version_major;

     /** minor version number of the module */

     uint16_t version_minor;

     /** Identifier of module */

     const char *id;

     /** Name of this module */

     const char *name;

     /** Author/owner/implementor of the module */

     const char *author;

     /** Modules methods */

     struct hw_module_methods_t* methods;

     /** module's dso */

     void* dso;

     /** padding to 128 bytes, reserved for future use */

     uint32_t reserved[32-7];

 } hw_module_t;

 typedef struct hw_module_methods_t {

     /** Open a specific device */

     int (*open)(const struct hw_module_t* module, const char* id,

             struct hw_device_t** device);

 } hw_module_methods_t;

 /**

  * Every device data structure must begin with hw_device_t

  * followed by module specific public methods and attributes.

  */

 typedef struct hw_device_t {

     /** tag must be initialized to HARDWARE_DEVICE_TAG */

     uint32_t tag;

     /** version number for hw_device_t */

     uint32_t version;

     /** reference to the module this device belongs to */

     struct hw_module_t* module;

     /** padding reserved for future use */

     uint32_t reserved[12];

     /** Close this device */

     int (*close)(struct hw_device_t* device);

 } hw_device_t;

 /**

  * Name of the hal_module_info

  */

 #define HAL_MODULE_INFO_SYM         HMI

 /**

  * Name of the hal_module_info as a string

  */

 #define HAL_MODULE_INFO_SYM_AS_STR  "HMI"

 /**

  * Get the module info associated with a module by id.

  * @return: 0 == success, <0 == error and *pHmi == NULL

  */

 int hw_get_module(const char *id, const struct hw_module_t **module);

 /**

  * pixel format definitions

  */

 enum {

     HAL_PIXEL_FORMAT_RGBA_8888          = 1,

     HAL_PIXEL_FORMAT_RGBX_8888          = 2,

     HAL_PIXEL_FORMAT_RGB_888            = 3,

     HAL_PIXEL_FORMAT_RGB_565            = 4,

     HAL_PIXEL_FORMAT_BGRA_8888          = 5,

     HAL_PIXEL_FORMAT_RGBA_5551          = 6,

     HAL_PIXEL_FORMAT_RGBA_4444          = 7,

     /* 0x8 - 0xFF range unavailable */

     /*

      * 0x100 - 0x1FF

      *

      * This range is reserved for pixel formats that are specific to the HAL

      * implementation.  Implementations can use any value in this range to

      * communicate video pixel formats between their HAL modules.  These formats

      * must not have an alpha channel.  Additionally, an EGLimage created from a

      * gralloc buffer of one of these formats must be supported for use with the

      * GL_OES_EGL_image_external OpenGL ES extension.

      */

     /*

      * Android YUV format:

      *

      * This format is exposed outside of the HAL to software

      * decoders and applications.

      * EGLImageKHR must support it in conjunction with the

      * OES_EGL_image_external extension.

      *

      * YV12 is 4:2:0 YCrCb planar format comprised of a WxH Y plane followed

      * by (W/2) x (H/2) Cr and Cb planes.

      *

      * This format assumes

      * - an even width

      * - an even height

      * - a horizontal stride multiple of 16 pixels

      * - a vertical stride equal to the height

      *

      *   y_size = stride * height

      *   c_size = ALIGN(stride/2, 16) * height/2

      *   size = y_size + c_size * 2

      *   cr_offset = y_size

      *   cb_offset = y_size + c_size

      *

      */

     HAL_PIXEL_FORMAT_YV12   = 0x32315659, // YCrCb 4:2:0 Planar

     /* Legacy formats (deprecated), used by ImageFormat.java */

     HAL_PIXEL_FORMAT_YCbCr_422_SP       = 0x10, // NV16

     HAL_PIXEL_FORMAT_YCrCb_420_SP       = 0x11, // NV21

     HAL_PIXEL_FORMAT_YCbCr_422_I        = 0x14, // YUY2

 };

 /**

  * Transformation definitions

  *

  * IMPORTANT NOTE:

  * HAL_TRANSFORM_ROT_90 is applied CLOCKWISE and AFTER HAL_TRANSFORM_FLIP_{H|V}.

  *

  */

 enum {

     /* flip source image horizontally (around the vertical axis) */

     HAL_TRANSFORM_FLIP_H    = 0x01,

     /* flip source image vertically (around the horizontal axis)*/

     HAL_TRANSFORM_FLIP_V    = 0x02,

     /* rotate source image 90 degrees clockwise */

     HAL_TRANSFORM_ROT_90    = 0x04,

     /* rotate source image 180 degrees */

     HAL_TRANSFORM_ROT_180   = 0x03,

     /* rotate source image 270 degrees clockwise */

     HAL_TRANSFORM_ROT_270   = 0x07,

 };

 __END_DECLS

 #endif  /* ANDROID_INCLUDE_HARDWARE_HARDWARE_H */