[libcamera-devel] [PATCH 2/2] android: Update Android headers
Hirokazu Honda
hiroh at chromium.org
Thu May 27 05:27:06 CEST 2021
Hi Laurent, thank you for the patch.
On Thu, May 27, 2021 at 10:02 AM Laurent Pinchart <
laurent.pinchart at ideasonboard.com> wrote:
> Import the latest version of the Android headers from Chrome OS (commit
> a30340e77ec8 ("camera: Uprev Android camera headers")). This brings in
> the Camera HAL v3.5 support.
>
> The headers are imported verbatim, except for the addition of the SPDX
> headers.
>
> Signed-off-by: Laurent Pinchart <laurent.pinchart at ideasonboard.com>
> ---
> .../libhardware/include/hardware/camera3.h | 215 +++-
> .../include/hardware/camera_common.h | 16 +-
> .../libhardware/include/hardware/fb.h | 2 +-
> .../libhardware/include/hardware/gralloc.h | 97 +-
> .../libhardware/include/hardware/hardware.h | 6 +
> .../core/include/cutils/native_handle.h | 36 +
> .../system/core/include/system/camera.h | 9 +
> .../system/core/include/system/graphics.h | 793 +++------------
> .../system/core/include/system/window.h | 955 ------------------
> 9 files changed, 469 insertions(+), 1660 deletions(-)
> delete mode 100644 include/android/system/core/include/system/window.h
>
I confirmed no difference in headers between libcamera and ChromeOS after
this patch.
I would wait for Jacopo's review.
Reviewed-by: Hirokazu Honda <hiroh at chromium.org>
> ---
> Compile-tested only for now.
>
> diff --git
> a/include/android/hardware/libhardware/include/hardware/camera3.h
> b/include/android/hardware/libhardware/include/hardware/camera3.h
> index d89bc9304b00..fd1e2072ad20 100644
> --- a/include/android/hardware/libhardware/include/hardware/camera3.h
> +++ b/include/android/hardware/libhardware/include/hardware/camera3.h
> @@ -1,6 +1,6 @@
> /* SPDX-License-Identifier: Apache-2.0 */
> /*
> - * Copyright (C) 2013 The Android Open Source Project
> + * Copyright (C) 2013-2018 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.
> @@ -22,21 +22,21 @@
> #include "camera_common.h"
>
> /**
> - * Camera device HAL 3.3 [ CAMERA_DEVICE_API_VERSION_3_3 ]
> + * Camera device HAL 3.5[ CAMERA_DEVICE_API_VERSION_3_5 ]
> *
> * This is the current recommended version of the camera device HAL.
> *
> * Supports the android.hardware.Camera API, and as of v3.2, the
> - * android.hardware.camera2 API in LIMITED or FULL modes.
> + * android.hardware.camera2 API as LIMITED or above hardware level.
> *
> * Camera devices that support this version of the HAL must return
> - * CAMERA_DEVICE_API_VERSION_3_3 in camera_device_t.common.version and in
> + * CAMERA_DEVICE_API_VERSION_3_5 in camera_device_t.common.version and in
> * camera_info_t.device_version (from camera_module_t.get_camera_info).
> *
> - * CAMERA_DEVICE_API_VERSION_3_3:
> - * Camera modules that may contain version 3.3 devices must implement
> at
> - * least version 2.2 of the camera module interface (as defined by
> - * camera_module_t.common.module_api_version).
> + * CAMERA_DEVICE_API_VERSION_3_3 and above:
> + * Camera modules that may contain version 3.3 or above devices must
> + * implement at least version 2.2 of the camera module interface (as
> defined
> + * by camera_module_t.common.module_api_version).
> *
> * CAMERA_DEVICE_API_VERSION_3_2:
> * Camera modules that may contain version 3.2 devices must implement
> at
> @@ -138,6 +138,52 @@
> *
> * - Addition of camera3 stream configuration operation mode to
> camera3_stream_configuration_t
> *
> + * 3.4: Minor additions to supported metadata and changes to data_space
> support
> + *
> + * - Add ANDROID_SENSOR_OPAQUE_RAW_SIZE static metadata as mandatory if
> + * RAW_OPAQUE format is supported.
> + *
> + * - Add ANDROID_CONTROL_POST_RAW_SENSITIVITY_BOOST_RANGE static
> metadata as
> + * mandatory if any RAW format is supported
> + *
> + * - Switch camera3_stream_t data_space field to a more flexible
> definition,
> + * using the version 0 definition of dataspace encoding.
> + *
> + * - General metadata additions which are available to use for HALv3.2
> or
> + * newer:
> + * - ANDROID_INFO_SUPPORTED_HARDWARE_LEVEL_3
> + * - ANDROID_CONTROL_POST_RAW_SENSITIVITY_BOOST
> + * - ANDROID_CONTROL_POST_RAW_SENSITIVITY_BOOST_RANGE
> + * - ANDROID_SENSOR_DYNAMIC_BLACK_LEVEL
> + * - ANDROID_SENSOR_DYNAMIC_WHITE_LEVEL
> + * - ANDROID_SENSOR_OPAQUE_RAW_SIZE
> + * - ANDROID_SENSOR_OPTICAL_BLACK_REGIONS
> + *
> + * 3.5: Minor revisions to support session parameters and logical multi
> camera:
> + *
> + * - Add ANDROID_REQUEST_AVAILABLE_SESSION_KEYS static metadata, which
> is
> + * optional for implementations that want to support session
> parameters. If support is
> + * needed, then Hal should populate the list with all available
> capture request keys
> + * that can cause severe processing delays when modified by client.
> Typical examples
> + * include parameters that require time-consuming HW re-configuration
> or internal camera
> + * pipeline update.
> + *
> + * - Add a session parameter field to camera3_stream_configuration
> which can be populated
> + * by clients with initial values for the keys found in
> ANDROID_REQUEST_AVAILABLE_SESSION_KEYS.
> + *
> + * - Metadata additions for logical multi camera capability:
> + * - ANDROID_REQUEST_AVAILABLE_CAPABILITIES_LOGICAL_MULTI_CAMERA
> + * - ANDROID_LOGICAL_MULTI_CAMERA_PHYSICAL_IDS
> + * - ANDROID_LOGICAL_MULTI_CAMERA_SYNC_TYPE
> + *
> + * - Add physical camera id field in camera3_stream, so that for a
> logical
> + * multi camera, the application has the option to specify which
> physical camera
> + * a particular stream is configured on.
> + *
> + * - Add physical camera id and settings field in
> camera3_capture_request, so that
> + * for a logical multi camera, the application has the option to
> specify individual
> + * settings for a particular physical device.
> + *
> */
>
> /**
> @@ -1460,6 +1506,13 @@ typedef enum camera3_stream_configuration_mode {
> * android.lens.opticalStabilizationMode (if it is supported)
> * android.scaler.cropRegion
> * android.statistics.faceDetectMode (if it is supported)
> + * 6. To reduce the amount of data passed across process boundaries
> at
> + * high frame rate, within one batch, camera framework only
> propagates
> + * the last shutter notify and the last capture results
> (including partial
> + * results and final result) to the app. The shutter notifies
> and capture
> + * results for the other requests in the batch are derived by
> + * the camera framework. As a result, the HAL can return empty
> metadata
> + * except for the last result in the batch.
> *
> * For more details about high speed stream requirements, see
> * android.control.availableHighSpeedVideoConfigurations and
> CONSTRAINED_HIGH_SPEED_VIDEO
> @@ -1578,6 +1631,13 @@ typedef struct camera3_stream {
> * value of this is 0.
> * For all streams passed via configure_streams(), the HAL must
> write
> * over this field with its usage flags.
> + *
> + * From Android O, the usage flag for an output stream may be
> bitwise
> + * combination of usage flags for multiple consumers, for the
> purpose of
> + * sharing one camera stream between those consumers. The HAL must
> fail
> + * configure_streams call with -EINVAL if the combined flags cannot
> be
> + * supported due to imcompatible buffer format, dataSpace, or other
> hardware
> + * limitations.
> */
> uint32_t usage;
>
> @@ -1612,11 +1672,19 @@ typedef struct camera3_stream {
> * be HAL_DATASPACE_UNKNOWN, and the appropriate color space, etc,
> should
> * be determined from the usage flags and the format.
> *
> - * >= CAMERA_DEVICE_API_VERSION_3_3:
> + * = CAMERA_DEVICE_API_VERSION_3_3:
> *
> * Always set by the camera service. HAL must use this dataSpace to
> * configure the stream to the correct colorspace, or to select
> between
> - * color and depth outputs if supported.
> + * color and depth outputs if supported. The dataspace values are
> the
> + * legacy definitions in graphics.h
> + *
> + * >= CAMERA_DEVICE_API_VERSION_3_4:
> + *
> + * Always set by the camera service. HAL must use this dataSpace to
> + * configure the stream to the correct colorspace, or to select
> between
> + * color and depth outputs if supported. The dataspace values are
> set
> + * using the V0 dataspace definitions in graphics.h
> */
> android_dataspace_t data_space;
>
> @@ -1646,6 +1714,29 @@ typedef struct camera3_stream {
> */
> int rotation;
>
> + /**
> + * The physical camera id this stream belongs to.
> + *
> + * <= CAMERA_DEVICE_API_VERISON_3_4:
> + *
> + * Not defined and must not be accessed.
> + *
> + * >= CAMERA_DEVICE_API_VERISON_3_5:
> + *
> + * Always set by camera service. If the camera device is not a
> logical
> + * multi camera, or if the camera is a logical multi camera but
> the stream
> + * is not a physical output stream, this field will point to a
> 0-length
> + * string.
> + *
> + * A logical multi camera is a camera device backed by multiple
> physical
> + * cameras that are also exposed to the application. And for a
> logical
> + * multi camera, a physical output stream is an output stream
> specifically
> + * requested on an underlying physical camera.
> + *
> + * For an input stream, this field is guaranteed to be a 0-length
> string.
> + */
> + const char* physical_camera_id;
> +
> /**
> * This should be one of the camera3_stream_rotation_t values except
> for
> * CAMERA3_STREAM_ROTATION_180.
> @@ -1663,7 +1754,7 @@ typedef struct camera3_stream {
> int crop_rotate_scale_degrees;
>
> /* reserved for future use */
> - void *reserved[6];
> + void *reserved[5];
>
> } camera3_stream_t;
>
> @@ -1697,16 +1788,30 @@ typedef struct camera3_stream_configuration {
> /**
> * >= CAMERA_DEVICE_API_VERSION_3_3:
> *
> - * The operation mode of streams in this configuration, one of the
> value defined in
> - * camera3_stream_configuration_mode_t.
> - * The HAL can use this mode as an indicator to set the stream
> property (e.g.,
> - * camera3_stream->max_buffers) appropriately. For example, if the
> configuration is
> - * CAMERA3_STREAM_CONFIGURATION_CONSTRAINED_HIGH_SPEED_MODE, the HAL
> may want to set aside more
> - * buffers for batch mode operation (see
> android.control.availableHighSpeedVideoConfigurations
> - * for batch mode definition).
> + * The operation mode of streams in this configuration, one of the
> value
> + * defined in camera3_stream_configuration_mode_t. The HAL can use
> this
> + * mode as an indicator to set the stream property (e.g.,
> + * camera3_stream->max_buffers) appropriately. For example, if the
> + * configuration is
> + * CAMERA3_STREAM_CONFIGURATION_CONSTRAINED_HIGH_SPEED_MODE, the HAL
> may
> + * want to set aside more buffers for batch mode operation (see
> + * android.control.availableHighSpeedVideoConfigurations for batch
> mode
> + * definition).
> *
> */
> uint32_t operation_mode;
> +
> + /**
> + * >= CAMERA_DEVICE_API_VERSION_3_5:
> + *
> + * The session metadata buffer contains the initial values of
> + * ANDROID_REQUEST_AVAILABLE_SESSION_KEYS. This field is optional
> + * and camera clients can choose to ignore it, in which case it will
> + * be set to NULL. If parameters are present, then Hal should examine
> + * the parameter values and configure its internal camera pipeline
> + * accordingly.
> + */
> + const camera_metadata_t *session_parameters;
> } camera3_stream_configuration_t;
>
> /**
> @@ -1950,7 +2055,7 @@ typedef enum camera3_error_msg_code {
> * available. Subsequent requests are unaffected, and the device
> remains
> * operational. The frame_number field specifies the request for
> which the
> * buffer was dropped, and error_stream contains a pointer to the
> stream
> - * that dropped the frame.u
> + * that dropped the frame.
> */
> CAMERA3_MSG_ERROR_BUFFER = 4,
>
> @@ -2190,6 +2295,44 @@ typedef struct camera3_capture_request {
> */
> const camera3_stream_buffer_t *output_buffers;
>
> + /**
> + * <= CAMERA_DEVICE_API_VERISON_3_4:
> + *
> + * Not defined and must not be accessed.
> + *
> + * >= CAMERA_DEVICE_API_VERSION_3_5:
> + * The number of physical camera settings to be applied. If
> 'num_physcam_settings'
> + * equals 0 or a physical device is not included, then Hal must
> decide the
> + * specific physical device settings based on the default
> 'settings'.
> + */
> + uint32_t num_physcam_settings;
> +
> + /**
> + * <= CAMERA_DEVICE_API_VERISON_3_4:
> + *
> + * Not defined and must not be accessed.
> + *
> + * >= CAMERA_DEVICE_API_VERSION_3_5:
> + * The physical camera ids. The array will contain
> 'num_physcam_settings'
> + * camera id strings for all physical devices that have specific
> settings.
> + * In case some id is invalid, the process capture request must
> fail and return
> + * -EINVAL.
> + */
> + const char **physcam_id;
> +
> + /**
> + * <= CAMERA_DEVICE_API_VERISON_3_4:
> + *
> + * Not defined and must not be accessed.
> + *
> + * >= CAMERA_DEVICE_API_VERSION_3_5:
> + * The capture settings for the physical cameras. The array will
> contain
> + * 'num_physcam_settings' settings for invididual physical
> devices. In
> + * case the settings at some particular index are empty, the
> process capture
> + * request must fail and return -EINVAL.
> + */
> + const camera_metadata_t **physcam_settings;
> +
> } camera3_capture_request_t;
>
> /**
> @@ -2367,6 +2510,37 @@ typedef struct camera3_capture_result {
> */
> uint32_t partial_result;
>
> + /**
> + * >= CAMERA_DEVICE_API_VERSION_3_5:
> + *
> + * Specifies the number of physical camera metadata this capture
> result
> + * contains. It must be equal to the number of physical cameras being
> + * requested from.
> + *
> + * If the current camera device is not a logical multi-camera, or the
> + * corresponding capture_request doesn't request on any physical
> camera,
> + * this field must be 0.
> + */
> + uint32_t num_physcam_metadata;
> +
> + /**
> + * >= CAMERA_DEVICE_API_VERSION_3_5:
> + *
> + * An array of strings containing the physical camera ids for the
> returned
> + * physical camera metadata. The length of the array is
> + * num_physcam_metadata.
> + */
> + const char **physcam_ids;
> +
> + /**
> + * >= CAMERA_DEVICE_API_VERSION_3_5:
> + *
> + * The array of physical camera metadata for the physical cameras
> being
> + * requested upon. This array should have a 1-to-1 mapping with the
> + * physcam_ids. The length of the array is num_physcam_metadata.
> + */
> + const camera_metadata_t **physcam_metadata;
> +
> } camera3_capture_result_t;
>
> /**********************************************************************
> @@ -2899,7 +3073,8 @@ typedef struct camera3_device_ops {
> * 0: On a successful start to processing the capture request
> *
> * -EINVAL: If the input is malformed (the settings are NULL when not
> - * allowed, there are 0 output buffers, etc) and capture
> processing
> + * allowed, invalid physical camera settings,
> + * there are 0 output buffers, etc) and capture processing
> * cannot start. Failures during request processing should be
> * handled by calling camera3_callback_ops_t.notify(). In
> case of
> * this error, the framework will retain responsibility for
> the
> diff --git
> a/include/android/hardware/libhardware/include/hardware/camera_common.h
> b/include/android/hardware/libhardware/include/hardware/camera_common.h
> index 26df06987030..5c9bc06fe0b7 100644
> --- a/include/android/hardware/libhardware/include/hardware/camera_common.h
> +++ b/include/android/hardware/libhardware/include/hardware/camera_common.h
> @@ -141,17 +141,19 @@ __BEGIN_DECLS
> * All device versions <= HARDWARE_DEVICE_API_VERSION(1, 0xFF) must be
> treated
> * as CAMERA_DEVICE_API_VERSION_1_0
> */
> -#define CAMERA_DEVICE_API_VERSION_1_0 HARDWARE_DEVICE_API_VERSION(1, 0)
> -#define CAMERA_DEVICE_API_VERSION_2_0 HARDWARE_DEVICE_API_VERSION(2, 0)
> -#define CAMERA_DEVICE_API_VERSION_2_1 HARDWARE_DEVICE_API_VERSION(2, 1)
> -#define CAMERA_DEVICE_API_VERSION_3_0 HARDWARE_DEVICE_API_VERSION(3, 0)
> -#define CAMERA_DEVICE_API_VERSION_3_1 HARDWARE_DEVICE_API_VERSION(3, 1)
> +#define CAMERA_DEVICE_API_VERSION_1_0 HARDWARE_DEVICE_API_VERSION(1, 0)
> // DEPRECATED
> +#define CAMERA_DEVICE_API_VERSION_2_0 HARDWARE_DEVICE_API_VERSION(2, 0)
> // NO LONGER SUPPORTED
> +#define CAMERA_DEVICE_API_VERSION_2_1 HARDWARE_DEVICE_API_VERSION(2, 1)
> // NO LONGER SUPPORTED
> +#define CAMERA_DEVICE_API_VERSION_3_0 HARDWARE_DEVICE_API_VERSION(3, 0)
> // NO LONGER SUPPORTED
> +#define CAMERA_DEVICE_API_VERSION_3_1 HARDWARE_DEVICE_API_VERSION(3, 1)
> // NO LONGER SUPPORTED
> #define CAMERA_DEVICE_API_VERSION_3_2 HARDWARE_DEVICE_API_VERSION(3, 2)
> #define CAMERA_DEVICE_API_VERSION_3_3 HARDWARE_DEVICE_API_VERSION(3, 3)
> +#define CAMERA_DEVICE_API_VERSION_3_4 HARDWARE_DEVICE_API_VERSION(3, 4)
> +#define CAMERA_DEVICE_API_VERSION_3_5 HARDWARE_DEVICE_API_VERSION(3, 5)
>
> -// Device version 3.3 is current, older HAL camera device versions are not
> +// Device version 3.5 is current, older HAL camera device versions are not
> // recommended for new devices.
> -#define CAMERA_DEVICE_API_VERSION_CURRENT CAMERA_DEVICE_API_VERSION_3_3
> +#define CAMERA_DEVICE_API_VERSION_CURRENT CAMERA_DEVICE_API_VERSION_3_5
>
> /**
> * Defined in /system/media/camera/include/system/camera_metadata.h
> diff --git a/include/android/hardware/libhardware/include/hardware/fb.h
> b/include/android/hardware/libhardware/include/hardware/fb.h
> index 9ea9a6e60f05..2d9153aed00b 100644
> --- a/include/android/hardware/libhardware/include/hardware/fb.h
> +++ b/include/android/hardware/libhardware/include/hardware/fb.h
> @@ -161,7 +161,7 @@ typedef struct framebuffer_device_t {
> static inline int framebuffer_open(const struct hw_module_t* module,
> struct framebuffer_device_t** device) {
> return module->methods->open(module,
> - GRALLOC_HARDWARE_FB0, (struct hw_device_t**)device);
> + GRALLOC_HARDWARE_FB0, TO_HW_DEVICE_T_OPEN(device));
> }
>
> static inline int framebuffer_close(struct framebuffer_device_t* device) {
> diff --git
> a/include/android/hardware/libhardware/include/hardware/gralloc.h
> b/include/android/hardware/libhardware/include/hardware/gralloc.h
> index 80da4cb8e16b..01a7672747a4 100644
> --- a/include/android/hardware/libhardware/include/hardware/gralloc.h
> +++ b/include/android/hardware/libhardware/include/hardware/gralloc.h
> @@ -19,9 +19,8 @@
> #ifndef ANDROID_GRALLOC_INTERFACE_H
> #define ANDROID_GRALLOC_INTERFACE_H
>
> -#include <system/window.h>
> +#include <hardware/hardware.h>
> #include <system/graphics.h>
> -#include <hardware/hardware.h>
>
> #include <stdint.h>
> #include <sys/cdefs.h>
> @@ -29,8 +28,8 @@
>
> #include <cutils/native_handle.h>
>
> -#include <hardware/hardware.h>
> #include <hardware/fb.h>
> +#include <hardware/hardware.h>
>
> __BEGIN_DECLS
>
> @@ -69,69 +68,69 @@ __BEGIN_DECLS
>
> enum {
> /* buffer is never read in software */
> - GRALLOC_USAGE_SW_READ_NEVER = 0x00000000,
> + GRALLOC_USAGE_SW_READ_NEVER = 0x00000000U,
> /* buffer is rarely read in software */
> - GRALLOC_USAGE_SW_READ_RARELY = 0x00000002,
> + GRALLOC_USAGE_SW_READ_RARELY = 0x00000002U,
> /* buffer is often read in software */
> - GRALLOC_USAGE_SW_READ_OFTEN = 0x00000003,
> + GRALLOC_USAGE_SW_READ_OFTEN = 0x00000003U,
> /* mask for the software read values */
> - GRALLOC_USAGE_SW_READ_MASK = 0x0000000F,
> + GRALLOC_USAGE_SW_READ_MASK = 0x0000000FU,
>
> /* buffer is never written in software */
> - GRALLOC_USAGE_SW_WRITE_NEVER = 0x00000000,
> + GRALLOC_USAGE_SW_WRITE_NEVER = 0x00000000U,
> /* buffer is rarely written in software */
> - GRALLOC_USAGE_SW_WRITE_RARELY = 0x00000020,
> + GRALLOC_USAGE_SW_WRITE_RARELY = 0x00000020U,
> /* buffer is often written in software */
> - GRALLOC_USAGE_SW_WRITE_OFTEN = 0x00000030,
> + GRALLOC_USAGE_SW_WRITE_OFTEN = 0x00000030U,
> /* mask for the software write values */
> - GRALLOC_USAGE_SW_WRITE_MASK = 0x000000F0,
> + GRALLOC_USAGE_SW_WRITE_MASK = 0x000000F0U,
>
> /* buffer will be used as an OpenGL ES texture */
> - GRALLOC_USAGE_HW_TEXTURE = 0x00000100,
> + GRALLOC_USAGE_HW_TEXTURE = 0x00000100U,
> /* buffer will be used as an OpenGL ES render target */
> - GRALLOC_USAGE_HW_RENDER = 0x00000200,
> + GRALLOC_USAGE_HW_RENDER = 0x00000200U,
> /* buffer will be used by the 2D hardware blitter */
> - GRALLOC_USAGE_HW_2D = 0x00000400,
> + GRALLOC_USAGE_HW_2D = 0x00000400U,
> /* buffer will be used by the HWComposer HAL module */
> - GRALLOC_USAGE_HW_COMPOSER = 0x00000800,
> + GRALLOC_USAGE_HW_COMPOSER = 0x00000800U,
> /* buffer will be used with the framebuffer device */
> - GRALLOC_USAGE_HW_FB = 0x00001000,
> + GRALLOC_USAGE_HW_FB = 0x00001000U,
>
> /* buffer should be displayed full-screen on an external display when
> * possible */
> - GRALLOC_USAGE_EXTERNAL_DISP = 0x00002000,
> + GRALLOC_USAGE_EXTERNAL_DISP = 0x00002000U,
>
> /* Must have a hardware-protected path to external display sink for
> * this buffer. If a hardware-protected path is not available, then
> * either don't composite only this buffer (preferred) to the
> * external sink, or (less desirable) do not route the entire
> * composition to the external sink. */
> - GRALLOC_USAGE_PROTECTED = 0x00004000,
> + GRALLOC_USAGE_PROTECTED = 0x00004000U,
>
> /* buffer may be used as a cursor */
> - GRALLOC_USAGE_CURSOR = 0x00008000,
> + GRALLOC_USAGE_CURSOR = 0x00008000U,
>
> /* buffer will be used with the HW video encoder */
> - GRALLOC_USAGE_HW_VIDEO_ENCODER = 0x00010000,
> + GRALLOC_USAGE_HW_VIDEO_ENCODER = 0x00010000U,
> /* buffer will be written by the HW camera pipeline */
> - GRALLOC_USAGE_HW_CAMERA_WRITE = 0x00020000,
> + GRALLOC_USAGE_HW_CAMERA_WRITE = 0x00020000U,
> /* buffer will be read by the HW camera pipeline */
> - GRALLOC_USAGE_HW_CAMERA_READ = 0x00040000,
> + GRALLOC_USAGE_HW_CAMERA_READ = 0x00040000U,
> /* buffer will be used as part of zero-shutter-lag queue */
> - GRALLOC_USAGE_HW_CAMERA_ZSL = 0x00060000,
> + GRALLOC_USAGE_HW_CAMERA_ZSL = 0x00060000U,
> /* mask for the camera access values */
> - GRALLOC_USAGE_HW_CAMERA_MASK = 0x00060000,
> + GRALLOC_USAGE_HW_CAMERA_MASK = 0x00060000U,
> /* mask for the software usage bit-mask */
> - GRALLOC_USAGE_HW_MASK = 0x00071F00,
> + GRALLOC_USAGE_HW_MASK = 0x00071F00U,
>
> /* buffer will be used as a RenderScript Allocation */
> - GRALLOC_USAGE_RENDERSCRIPT = 0x00100000,
> + GRALLOC_USAGE_RENDERSCRIPT = 0x00100000U,
>
> /* Set by the consumer to indicate to the producer that they may
> attach a
> * buffer that they did not detach from the BufferQueue. Will be
> filtered
> * out by GRALLOC_USAGE_ALLOC_MASK, so gralloc modules will not need
> to
> * handle this flag. */
> - GRALLOC_USAGE_FOREIGN_BUFFERS = 0x00200000,
> + GRALLOC_USAGE_FOREIGN_BUFFERS = 0x00200000U,
>
> /* Mask of all flags which could be passed to a gralloc module for
> buffer
> * allocation. Any flags not in this mask do not need to be handled by
> @@ -139,11 +138,11 @@ enum {
> GRALLOC_USAGE_ALLOC_MASK =
> ~(GRALLOC_USAGE_FOREIGN_BUFFERS),
>
> /* implementation-specific private usage flags */
> - GRALLOC_USAGE_PRIVATE_0 = 0x10000000,
> - GRALLOC_USAGE_PRIVATE_1 = 0x20000000,
> - GRALLOC_USAGE_PRIVATE_2 = 0x40000000,
> - GRALLOC_USAGE_PRIVATE_3 = 0x80000000,
> - GRALLOC_USAGE_PRIVATE_MASK = 0xF0000000,
> + GRALLOC_USAGE_PRIVATE_0 = 0x10000000U,
> + GRALLOC_USAGE_PRIVATE_1 = 0x20000000U,
> + GRALLOC_USAGE_PRIVATE_2 = 0x40000000U,
> + GRALLOC_USAGE_PRIVATE_3 = 0x80000000U,
> + GRALLOC_USAGE_PRIVATE_MASK = 0xF0000000U,
> };
>
>
> /*****************************************************************************/
> @@ -373,13 +372,45 @@ typedef struct alloc_device_t {
> static inline int gralloc_open(const struct hw_module_t* module,
> struct alloc_device_t** device) {
> return module->methods->open(module,
> - GRALLOC_HARDWARE_GPU0, (struct hw_device_t**)device);
> + GRALLOC_HARDWARE_GPU0, TO_HW_DEVICE_T_OPEN(device));
> }
>
> static inline int gralloc_close(struct alloc_device_t* device) {
> return device->common.close(&device->common);
> }
>
> +/**
> + * map_usage_to_memtrack should be called after allocating a gralloc
> buffer.
> + *
> + * @param usage - it is the flag used when alloc function is called.
> + *
> + * This function maps the gralloc usage flags to appropriate memtrack
> bucket.
> + * GrallocHAL implementers and users should make an additional
> ION_IOCTL_TAG
> + * call using the memtrack tag returned by this function. This will help
> the
> + * in-kernel memtack to categorize the memory allocated by different
> processes
> + * according to their usage.
> + *
> + */
> +static inline const char* map_usage_to_memtrack(uint32_t usage) {
> + usage &= GRALLOC_USAGE_ALLOC_MASK;
> +
> + if ((usage & GRALLOC_USAGE_HW_CAMERA_WRITE) != 0) {
> + return "camera";
> + } else if ((usage & GRALLOC_USAGE_HW_VIDEO_ENCODER) != 0 ||
> + (usage & GRALLOC_USAGE_EXTERNAL_DISP) != 0) {
> + return "video";
> + } else if ((usage & GRALLOC_USAGE_HW_RENDER) != 0 ||
> + (usage & GRALLOC_USAGE_HW_TEXTURE) != 0) {
> + return "gl";
> + } else if ((usage & GRALLOC_USAGE_HW_CAMERA_READ) != 0) {
> + return "camera";
> + } else if ((usage & GRALLOC_USAGE_SW_READ_MASK) != 0 ||
> + (usage & GRALLOC_USAGE_SW_WRITE_MASK) != 0) {
> + return "cpu";
> + }
> + return "graphics";
> +}
> +
> __END_DECLS
>
> #endif // ANDROID_GRALLOC_INTERFACE_H
> diff --git
> a/include/android/hardware/libhardware/include/hardware/hardware.h
> b/include/android/hardware/libhardware/include/hardware/hardware.h
> index 10b73df7150a..8919f1204cde 100644
> --- a/include/android/hardware/libhardware/include/hardware/hardware.h
> +++ b/include/android/hardware/libhardware/include/hardware/hardware.h
> @@ -202,6 +202,12 @@ typedef struct hw_device_t {
>
> } hw_device_t;
>
> +#ifdef __cplusplus
> +#define TO_HW_DEVICE_T_OPEN(x) reinterpret_cast<struct hw_device_t**>(x)
> +#else
> +#define TO_HW_DEVICE_T_OPEN(x) (struct hw_device_t**)(x)
> +#endif
> +
> /**
> * Name of the hal_module_info
> */
> diff --git a/include/android/system/core/include/cutils/native_handle.h
> b/include/android/system/core/include/cutils/native_handle.h
> index edd7888fe284..dbd37672f040 100644
> --- a/include/android/system/core/include/cutils/native_handle.h
> +++ b/include/android/system/core/include/cutils/native_handle.h
> @@ -18,18 +18,37 @@
> #ifndef NATIVE_HANDLE_H_
> #define NATIVE_HANDLE_H_
>
> +#include <stdalign.h>
> +
> #ifdef __cplusplus
> extern "C" {
> #endif
>
> +#define NATIVE_HANDLE_MAX_FDS 1024
> +#define NATIVE_HANDLE_MAX_INTS 1024
> +
> +/* Declare a char array for use with native_handle_init */
> +#define NATIVE_HANDLE_DECLARE_STORAGE(name, maxFds, maxInts) \
> + alignas(native_handle_t) char (name)[ \
> + sizeof(native_handle_t) + sizeof(int) * ((maxFds) + (maxInts))]
> +
> typedef struct native_handle
> {
> int version; /* sizeof(native_handle_t) */
> int numFds; /* number of file-descriptors at &data[0] */
> int numInts; /* number of ints at &data[numFds] */
> +#if defined(__clang__)
> +#pragma clang diagnostic push
> +#pragma clang diagnostic ignored "-Wzero-length-array"
> +#endif
> int data[0]; /* numFds + numInts ints */
> +#if defined(__clang__)
> +#pragma clang diagnostic pop
> +#endif
> } native_handle_t;
>
> +typedef const native_handle_t* buffer_handle_t;
> +
> /*
> * native_handle_close
> *
> @@ -40,6 +59,14 @@ typedef struct native_handle
> */
> int native_handle_close(const native_handle_t* h);
>
> +/*
> + * native_handle_init
> + *
> + * Initializes a native_handle_t from storage. storage must be declared
> with
> + * NATIVE_HANDLE_DECLARE_STORAGE. numFds and numInts must not
> respectively
> + * exceed maxFds and maxInts used to declare the storage.
> + */
> +native_handle_t* native_handle_init(char* storage, int numFds, int
> numInts);
>
> /*
> * native_handle_create
> @@ -50,6 +77,15 @@ int native_handle_close(const native_handle_t* h);
> */
> native_handle_t* native_handle_create(int numFds, int numInts);
>
> +/*
> + * native_handle_clone
> + *
> + * creates a native_handle_t and initializes it from another
> native_handle_t.
> + * Must be destroyed with native_handle_delete().
> + *
> + */
> +native_handle_t* native_handle_clone(const native_handle_t* handle);
> +
> /*
> * native_handle_delete
> *
> diff --git a/include/android/system/core/include/system/camera.h
> b/include/android/system/core/include/system/camera.h
> index a1b68d054d93..9d69588f9829 100644
> --- a/include/android/system/core/include/system/camera.h
> +++ b/include/android/system/core/include/system/camera.h
> @@ -204,6 +204,15 @@ enum {
> * (except disconnect and sending CAMERA_CMD_PING) after getting this.
> */
> CAMERA_ERROR_RELEASED = 2,
> +
> + /**
> + * Camera was released because device policy change or the client
> application
> + * is going to background. The client should call Camera::disconnect
> + * immediately after getting this notification. Otherwise, the camera
> will be
> + * released by camera service in a short time. The client should not
> call any
> + * method (except disconnect and sending CAMERA_CMD_PING) after
> getting this.
> + */
> + CAMERA_ERROR_DISABLED = 3,
> CAMERA_ERROR_SERVER_DIED = 100
> };
>
> diff --git a/include/android/system/core/include/system/graphics.h
> b/include/android/system/core/include/system/graphics.h
> index 909ffe68e78b..6341e642d57c 100644
> --- a/include/android/system/core/include/system/graphics.h
> +++ b/include/android/system/core/include/system/graphics.h
> @@ -18,12 +18,32 @@
> #ifndef SYSTEM_CORE_INCLUDE_ANDROID_GRAPHICS_H
> #define SYSTEM_CORE_INCLUDE_ANDROID_GRAPHICS_H
>
> +#include <stddef.h>
> #include <stdint.h>
>
> +/*
> + * Some of the enums are now defined in HIDL in hardware/interfaces and
> are
> + * generated.
> + */
> +#include "graphics-base.h"
> +#include "graphics-sw.h"
> +
> #ifdef __cplusplus
> extern "C" {
> #endif
>
> +/* for compatibility */
> +#define HAL_PIXEL_FORMAT_YCbCr_420_888 HAL_PIXEL_FORMAT_YCBCR_420_888
> +#define HAL_PIXEL_FORMAT_YCbCr_422_SP HAL_PIXEL_FORMAT_YCBCR_422_SP
> +#define HAL_PIXEL_FORMAT_YCrCb_420_SP HAL_PIXEL_FORMAT_YCRCB_420_SP
> +#define HAL_PIXEL_FORMAT_YCbCr_422_I HAL_PIXEL_FORMAT_YCBCR_422_I
> +typedef android_pixel_format_t android_pixel_format;
> +typedef android_transform_t android_transform;
> +typedef android_dataspace_t android_dataspace;
> +typedef android_color_mode_t android_color_mode;
> +typedef android_color_transform_t android_color_transform;
> +typedef android_hdr_t android_hdr;
> +
> /*
> * If the HAL needs to create service threads to handle graphics related
> * tasks, these threads need to run at HAL_PRIORITY_URGENT_DISPLAY
> priority
> @@ -38,411 +58,6 @@ extern "C" {
>
> #define HAL_PRIORITY_URGENT_DISPLAY (-8)
>
> -/**
> - * pixel format definitions
> - */
> -
> -enum {
> - /*
> - * "linear" color pixel formats:
> - *
> - * When used with ANativeWindow, the dataSpace field describes the
> color
> - * space of the buffer.
> - *
> - * The color space determines, for example, if the formats are linear
> or
> - * gamma-corrected; or whether any special operations are performed
> when
> - * reading or writing into a buffer in one of these formats.
> - */
> - 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,
> -
> - /*
> - * 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 a 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_stride = ALIGN(stride/2, 16)
> - * c_size = c_stride * height/2
> - * size = y_size + c_size * 2
> - * cr_offset = y_size
> - * cb_offset = y_size + c_size
> - *
> - * When used with ANativeWindow, the dataSpace field describes the
> color
> - * space of the buffer.
> - */
> - HAL_PIXEL_FORMAT_YV12 = 0x32315659, // YCrCb 4:2:0 Planar
> -
> -
> - /*
> - * Android Y8 format:
> - *
> - * This format is exposed outside of the HAL to the framework.
> - * The expected gralloc usage flags are SW_* and HW_CAMERA_*,
> - * and no other HW_ flags will be used.
> - *
> - * Y8 is a YUV planar format comprised of a WxH Y plane,
> - * with each pixel being represented by 8 bits.
> - *
> - * It is equivalent to just the Y plane from YV12.
> - *
> - * This format assumes
> - * - an even width
> - * - an even height
> - * - a horizontal stride multiple of 16 pixels
> - * - a vertical stride equal to the height
> - *
> - * size = stride * height
> - *
> - * When used with ANativeWindow, the dataSpace field describes the
> color
> - * space of the buffer.
> - */
> - HAL_PIXEL_FORMAT_Y8 = 0x20203859,
> -
> - /*
> - * Android Y16 format:
> - *
> - * This format is exposed outside of the HAL to the framework.
> - * The expected gralloc usage flags are SW_* and HW_CAMERA_*,
> - * and no other HW_ flags will be used.
> - *
> - * Y16 is a YUV planar format comprised of a WxH Y plane,
> - * with each pixel being represented by 16 bits.
> - *
> - * It is just like Y8, but has double the bits per pixel (little
> endian).
> - *
> - * This format assumes
> - * - an even width
> - * - an even height
> - * - a horizontal stride multiple of 16 pixels
> - * - a vertical stride equal to the height
> - * - strides are specified in pixels, not in bytes
> - *
> - * size = stride * height * 2
> - *
> - * When used with ANativeWindow, the dataSpace field describes the
> color
> - * space of the buffer, except that dataSpace field
> - * HAL_DATASPACE_DEPTH indicates that this buffer contains a depth
> - * image where each sample is a distance value measured by a depth
> camera,
> - * plus an associated confidence value.
> - */
> - HAL_PIXEL_FORMAT_Y16 = 0x20363159,
> -
> - /*
> - * Android RAW sensor format:
> - *
> - * This format is exposed outside of the camera HAL to applications.
> - *
> - * RAW16 is a single-channel, 16-bit, little endian format, typically
> - * representing raw Bayer-pattern images from an image sensor, with
> minimal
> - * processing.
> - *
> - * The exact pixel layout of the data in the buffer is
> sensor-dependent, and
> - * needs to be queried from the camera device.
> - *
> - * Generally, not all 16 bits are used; more common values are 10 or
> 12
> - * bits. If not all bits are used, the lower-order bits are filled
> first.
> - * All parameters to interpret the raw data (black and white points,
> - * color space, etc) must be queried from the camera device.
> - *
> - * This format assumes
> - * - an even width
> - * - an even height
> - * - a horizontal stride multiple of 16 pixels
> - * - a vertical stride equal to the height
> - * - strides are specified in pixels, not in bytes
> - *
> - * size = stride * height * 2
> - *
> - * This format must be accepted by the gralloc module when used with
> the
> - * following usage flags:
> - * - GRALLOC_USAGE_HW_CAMERA_*
> - * - GRALLOC_USAGE_SW_*
> - * - GRALLOC_USAGE_RENDERSCRIPT
> - *
> - * When used with ANativeWindow, the dataSpace should be
> - * HAL_DATASPACE_ARBITRARY, as raw image sensor buffers require
> substantial
> - * extra metadata to define.
> - */
> - HAL_PIXEL_FORMAT_RAW16 = 0x20,
> -
> - /*
> - * Android RAW10 format:
> - *
> - * This format is exposed outside of the camera HAL to applications.
> - *
> - * RAW10 is a single-channel, 10-bit per pixel, densely packed in
> each row,
> - * unprocessed format, usually representing raw Bayer-pattern images
> coming from
> - * an image sensor.
> - *
> - * In an image buffer with this format, starting from the first pixel
> of each
> - * row, each 4 consecutive pixels are packed into 5 bytes (40 bits).
> Each one
> - * of the first 4 bytes contains the top 8 bits of each pixel, The
> fifth byte
> - * contains the 2 least significant bits of the 4 pixels, the exact
> layout data
> - * for each 4 consecutive pixels is illustrated below (Pi[j] stands
> for the jth
> - * bit of the ith pixel):
> - *
> - * bit 7 bit 0
> - * =====|=====|=====|=====|=====|=====|=====|=====|
> - * Byte 0: |P0[9]|P0[8]|P0[7]|P0[6]|P0[5]|P0[4]|P0[3]|P0[2]|
> - * |-----|-----|-----|-----|-----|-----|-----|-----|
> - * Byte 1: |P1[9]|P1[8]|P1[7]|P1[6]|P1[5]|P1[4]|P1[3]|P1[2]|
> - * |-----|-----|-----|-----|-----|-----|-----|-----|
> - * Byte 2: |P2[9]|P2[8]|P2[7]|P2[6]|P2[5]|P2[4]|P2[3]|P2[2]|
> - * |-----|-----|-----|-----|-----|-----|-----|-----|
> - * Byte 3: |P3[9]|P3[8]|P3[7]|P3[6]|P3[5]|P3[4]|P3[3]|P3[2]|
> - * |-----|-----|-----|-----|-----|-----|-----|-----|
> - * Byte 4: |P3[1]|P3[0]|P2[1]|P2[0]|P1[1]|P1[0]|P0[1]|P0[0]|
> - * ===============================================
> - *
> - * This format assumes
> - * - a width multiple of 4 pixels
> - * - an even height
> - * - a vertical stride equal to the height
> - * - strides are specified in bytes, not in pixels
> - *
> - * size = stride * height
> - *
> - * When stride is equal to width * (10 / 8), there will be no padding
> bytes at
> - * the end of each row, the entire image data is densely packed. When
> stride is
> - * larger than width * (10 / 8), padding bytes will be present at the
> end of each
> - * row (including the last row).
> - *
> - * This format must be accepted by the gralloc module when used with
> the
> - * following usage flags:
> - * - GRALLOC_USAGE_HW_CAMERA_*
> - * - GRALLOC_USAGE_SW_*
> - * - GRALLOC_USAGE_RENDERSCRIPT
> - *
> - * When used with ANativeWindow, the dataSpace field should be
> - * HAL_DATASPACE_ARBITRARY, as raw image sensor buffers require
> substantial
> - * extra metadata to define.
> - */
> - HAL_PIXEL_FORMAT_RAW10 = 0x25,
> -
> - /*
> - * Android RAW12 format:
> - *
> - * This format is exposed outside of camera HAL to applications.
> - *
> - * RAW12 is a single-channel, 12-bit per pixel, densely packed in
> each row,
> - * unprocessed format, usually representing raw Bayer-pattern images
> coming from
> - * an image sensor.
> - *
> - * In an image buffer with this format, starting from the first pixel
> of each
> - * row, each two consecutive pixels are packed into 3 bytes (24
> bits). The first
> - * and second byte contains the top 8 bits of first and second pixel.
> The third
> - * byte contains the 4 least significant bits of the two pixels, the
> exact layout
> - * data for each two consecutive pixels is illustrated below (Pi[j]
> stands for
> - * the jth bit of the ith pixel):
> - *
> - * bit 7 bit 0
> - * ======|======|======|======|======|======|======|======|
> - * Byte 0: |P0[11]|P0[10]|P0[ 9]|P0[ 8]|P0[ 7]|P0[ 6]|P0[ 5]|P0[ 4]|
> - * |------|------|------|------|------|------|------|------|
> - * Byte 1: |P1[11]|P1[10]|P1[ 9]|P1[ 8]|P1[ 7]|P1[ 6]|P1[ 5]|P1[ 4]|
> - * |------|------|------|------|------|------|------|------|
> - * Byte 2: |P1[ 3]|P1[ 2]|P1[ 1]|P1[ 0]|P0[ 3]|P0[ 2]|P0[ 1]|P0[ 0]|
> - * =======================================================
> - *
> - * This format assumes:
> - * - a width multiple of 4 pixels
> - * - an even height
> - * - a vertical stride equal to the height
> - * - strides are specified in bytes, not in pixels
> - *
> - * size = stride * height
> - *
> - * When stride is equal to width * (12 / 8), there will be no padding
> bytes at
> - * the end of each row, the entire image data is densely packed. When
> stride is
> - * larger than width * (12 / 8), padding bytes will be present at the
> end of
> - * each row (including the last row).
> - *
> - * This format must be accepted by the gralloc module when used with
> the
> - * following usage flags:
> - * - GRALLOC_USAGE_HW_CAMERA_*
> - * - GRALLOC_USAGE_SW_*
> - * - GRALLOC_USAGE_RENDERSCRIPT
> - *
> - * When used with ANativeWindow, the dataSpace field should be
> - * HAL_DATASPACE_ARBITRARY, as raw image sensor buffers require
> substantial
> - * extra metadata to define.
> - */
> - HAL_PIXEL_FORMAT_RAW12 = 0x26,
> -
> - /*
> - * Android opaque RAW format:
> - *
> - * This format is exposed outside of the camera HAL to applications.
> - *
> - * RAW_OPAQUE is a format for unprocessed raw image buffers coming
> from an
> - * image sensor. The actual structure of buffers of this format is
> - * implementation-dependent.
> - *
> - * This format must be accepted by the gralloc module when used with
> the
> - * following usage flags:
> - * - GRALLOC_USAGE_HW_CAMERA_*
> - * - GRALLOC_USAGE_SW_*
> - * - GRALLOC_USAGE_RENDERSCRIPT
> - *
> - * When used with ANativeWindow, the dataSpace field should be
> - * HAL_DATASPACE_ARBITRARY, as raw image sensor buffers require
> substantial
> - * extra metadata to define.
> - */
> - HAL_PIXEL_FORMAT_RAW_OPAQUE = 0x24,
> -
> - /*
> - * Android binary blob graphics buffer format:
> - *
> - * This format is used to carry task-specific data which does not
> have a
> - * standard image structure. The details of the format are left to
> the two
> - * endpoints.
> - *
> - * A typical use case is for transporting JPEG-compressed images from
> the
> - * Camera HAL to the framework or to applications.
> - *
> - * Buffers of this format must have a height of 1, and width equal to
> their
> - * size in bytes.
> - *
> - * When used with ANativeWindow, the mapping of the dataSpace field to
> - * buffer contents for BLOB is as follows:
> - *
> - * dataSpace value | Buffer contents
> - *
> -------------------------------+-----------------------------------------
> - * HAL_DATASPACE_JFIF | An encoded JPEG image
> - * HAL_DATASPACE_DEPTH | An android_depth_points buffer
> - * Other | Unsupported
> - *
> - */
> - HAL_PIXEL_FORMAT_BLOB = 0x21,
> -
> - /*
> - * Android format indicating that the choice of format is entirely up
> to the
> - * device-specific Gralloc implementation.
> - *
> - * The Gralloc implementation should examine the usage bits passed in
> when
> - * allocating a buffer with this format, and it should derive the
> pixel
> - * format from those usage flags. This format will never be used
> with any
> - * of the GRALLOC_USAGE_SW_* usage flags.
> - *
> - * If a buffer of this format is to be used as an OpenGL ES texture,
> the
> - * framework will assume that sampling the texture will always return
> an
> - * alpha value of 1.0 (i.e. the buffer contains only opaque pixel
> values).
> - *
> - * When used with ANativeWindow, the dataSpace field describes the
> color
> - * space of the buffer.
> - */
> - HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED = 0x22,
> -
> - /*
> - * Android flexible YCbCr 4:2:0 formats
> - *
> - * This format allows platforms to use an efficient YCbCr/YCrCb 4:2:0
> - * buffer layout, while still describing the general format in a
> - * layout-independent manner. While called YCbCr, it can be
> - * used to describe formats with either chromatic ordering, as well as
> - * whole planar or semiplanar layouts.
> - *
> - * struct android_ycbcr (below) is the the struct used to describe it.
> - *
> - * This format must be accepted by the gralloc module when
> - * USAGE_SW_WRITE_* or USAGE_SW_READ_* are set.
> - *
> - * This format is locked for use by gralloc's (*lock_ycbcr) method,
> and
> - * locking with the (*lock) method will return an error.
> - *
> - * When used with ANativeWindow, the dataSpace field describes the
> color
> - * space of the buffer.
> - */
> - HAL_PIXEL_FORMAT_YCbCr_420_888 = 0x23,
> -
> - /*
> - * Android flexible YCbCr 4:2:2 formats
> - *
> - * This format allows platforms to use an efficient YCbCr/YCrCb 4:2:2
> - * buffer layout, while still describing the general format in a
> - * layout-independent manner. While called YCbCr, it can be
> - * used to describe formats with either chromatic ordering, as well as
> - * whole planar or semiplanar layouts.
> - *
> - * This format is currently only used by SW readable buffers
> - * produced by MediaCodecs, so the gralloc module can ignore this
> format.
> - */
> - HAL_PIXEL_FORMAT_YCbCr_422_888 = 0x27,
> -
> - /*
> - * Android flexible YCbCr 4:4:4 formats
> - *
> - * This format allows platforms to use an efficient YCbCr/YCrCb 4:4:4
> - * buffer layout, while still describing the general format in a
> - * layout-independent manner. While called YCbCr, it can be
> - * used to describe formats with either chromatic ordering, as well as
> - * whole planar or semiplanar layouts.
> - *
> - * This format is currently only used by SW readable buffers
> - * produced by MediaCodecs, so the gralloc module can ignore this
> format.
> - */
> - HAL_PIXEL_FORMAT_YCbCr_444_888 = 0x28,
> -
> - /*
> - * Android flexible RGB 888 formats
> - *
> - * This format allows platforms to use an efficient RGB/BGR/RGBX/BGRX
> - * buffer layout, while still describing the general format in a
> - * layout-independent manner. While called RGB, it can be
> - * used to describe formats with either color ordering and optional
> - * padding, as well as whole planar layout.
> - *
> - * This format is currently only used by SW readable buffers
> - * produced by MediaCodecs, so the gralloc module can ignore this
> format.
> - */
> - HAL_PIXEL_FORMAT_FLEX_RGB_888 = 0x29,
> -
> - /*
> - * Android flexible RGBA 8888 formats
> - *
> - * This format allows platforms to use an efficient
> RGBA/BGRA/ARGB/ABGR
> - * buffer layout, while still describing the general format in a
> - * layout-independent manner. While called RGBA, it can be
> - * used to describe formats with any of the component orderings, as
> - * well as whole planar layout.
> - *
> - * This format is currently only used by SW readable buffers
> - * produced by MediaCodecs, so the gralloc module can ignore this
> format.
> - */
> - HAL_PIXEL_FORMAT_FLEX_RGBA_8888 = 0x2A,
> -
> - /* 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
> -};
> -
> /*
> * Structure for describing YCbCr formats for consumption by applications.
> * This is used with HAL_PIXEL_FORMAT_YCbCr_*_888.
> @@ -452,15 +67,15 @@ enum {
> *
> * Buffers must have a 8 bit depth.
> *
> - * @y, @cb, and @cr point to the first byte of their respective planes.
> + * y, cb, and cr point to the first byte of their respective planes.
> *
> * Stride describes the distance in bytes from the first value of one row
> of
> * the image to the first value of the next row. It includes the width
> of the
> * image plus padding.
> - * @ystride is the stride of the luma plane.
> - * @cstride is the stride of the chroma planes.
> + * ystride is the stride of the luma plane.
> + * cstride is the stride of the chroma planes.
> *
> - * @chroma_step is the distance in bytes from one chroma pixel value to
> the
> + * chroma_step is the distance in bytes from one chroma pixel value to the
> * next. This is 2 bytes for semiplanar (because chroma values are
> interleaved
> * and each chroma value is one byte) and 1 for planar.
> */
> @@ -477,6 +92,102 @@ struct android_ycbcr {
> uint32_t reserved[8];
> };
>
> +/*
> + * Structures for describing flexible YUVA/RGBA formats for consumption by
> + * applications. Such flexible formats contain a plane for each component
> (e.g.
> + * red, green, blue), where each plane is laid out in a grid-like pattern
> + * occupying unique byte addresses and with consistent byte offsets
> between
> + * neighboring pixels.
> + *
> + * The android_flex_layout structure is used with any pixel format that
> can be
> + * represented by it, such as:
> + * - HAL_PIXEL_FORMAT_YCbCr_*_888
> + * - HAL_PIXEL_FORMAT_FLEX_RGB*_888
> + * - HAL_PIXEL_FORMAT_RGB[AX]_888[8],BGRA_8888,RGB_888
> + * - HAL_PIXEL_FORMAT_YV12,Y8,Y16,YCbCr_422_SP/I,YCrCb_420_SP
> + * - even implementation defined formats that can be represented by
> + * the structures
> + *
> + * Vertical increment (aka. row increment or stride) describes the
> distance in
> + * bytes from the first pixel of one row to the first pixel of the next
> row
> + * (below) for the component plane. This can be negative.
> + *
> + * Horizontal increment (aka. column or pixel increment) describes the
> distance
> + * in bytes from one pixel to the next pixel (to the right) on the same
> row for
> + * the component plane. This can be negative.
> + *
> + * Each plane can be subsampled either vertically or horizontally by
> + * a power-of-two factor.
> + *
> + * The bit-depth of each component can be arbitrary, as long as the
> pixels are
> + * laid out on whole bytes, in native byte-order, using the most
> significant
> + * bits of each unit.
> + */
> +
> +typedef enum android_flex_component {
> + /* luma */
> + FLEX_COMPONENT_Y = 1 << 0,
> + /* chroma blue */
> + FLEX_COMPONENT_Cb = 1 << 1,
> + /* chroma red */
> + FLEX_COMPONENT_Cr = 1 << 2,
> +
> + /* red */
> + FLEX_COMPONENT_R = 1 << 10,
> + /* green */
> + FLEX_COMPONENT_G = 1 << 11,
> + /* blue */
> + FLEX_COMPONENT_B = 1 << 12,
> +
> + /* alpha */
> + FLEX_COMPONENT_A = 1 << 30,
> +} android_flex_component_t;
> +
> +typedef struct android_flex_plane {
> + /* pointer to the first byte of the top-left pixel of the plane. */
> + uint8_t *top_left;
> +
> + android_flex_component_t component;
> +
> + /* bits allocated for the component in each pixel. Must be a positive
> + multiple of 8. */
> + int32_t bits_per_component;
> + /* number of the most significant bits used in the format for this
> + component. Must be between 1 and bits_per_component, inclusive. */
> + int32_t bits_used;
> +
> + /* horizontal increment */
> + int32_t h_increment;
> + /* vertical increment */
> + int32_t v_increment;
> + /* horizontal subsampling. Must be a positive power of 2. */
> + int32_t h_subsampling;
> + /* vertical subsampling. Must be a positive power of 2. */
> + int32_t v_subsampling;
> +} android_flex_plane_t;
> +
> +typedef enum android_flex_format {
> + /* not a flexible format */
> + FLEX_FORMAT_INVALID = 0x0,
> + FLEX_FORMAT_Y = FLEX_COMPONENT_Y,
> + FLEX_FORMAT_YCbCr = FLEX_COMPONENT_Y | FLEX_COMPONENT_Cb |
> FLEX_COMPONENT_Cr,
> + FLEX_FORMAT_YCbCrA = FLEX_FORMAT_YCbCr | FLEX_COMPONENT_A,
> + FLEX_FORMAT_RGB = FLEX_COMPONENT_R | FLEX_COMPONENT_G |
> FLEX_COMPONENT_B,
> + FLEX_FORMAT_RGBA = FLEX_FORMAT_RGB | FLEX_COMPONENT_A,
> +} android_flex_format_t;
> +
> +typedef struct android_flex_layout {
> + /* the kind of flexible format */
> + android_flex_format_t format;
> +
> + /* number of planes; 0 for FLEX_FORMAT_INVALID */
> + uint32_t num_planes;
> + /* a plane for each component; ordered in increasing component value
> order.
> + E.g. FLEX_FORMAT_RGBA maps 0 -> R, 1 -> G, etc.
> + Can be NULL for FLEX_FORMAT_INVALID */
> + android_flex_plane_t *planes;
> +} android_flex_layout_t;
> +
> /**
> * Structure used to define depth point clouds for format
> HAL_PIXEL_FORMAT_BLOB
> * with dataSpace value of HAL_DATASPACE_DEPTH.
> @@ -489,9 +200,9 @@ struct android_ycbcr {
> * measurement is correct. It is between 0.f and 1.f, inclusive, with 1.f
> ==
> * 100% confidence.
> *
> - * @num_points is the number of points in the list
> + * num_points is the number of points in the list
> *
> - * @xyz_points is the flexible array of floating-point values.
> + * xyz_points is the flexible array of floating-point values.
> * It contains (num_points) * 4 floats.
> *
> * For example:
> @@ -516,246 +227,40 @@ struct android_depth_points {
> /** reserved for future use, set to 0 by gralloc's (*lock)() */
> uint32_t reserved[8];
>
> +#if defined(__clang__)
> +#pragma clang diagnostic push
> +#pragma clang diagnostic ignored "-Wc99-extensions"
> +#endif
> float xyzc_points[];
> +#if defined(__clang__)
> +#pragma clang diagnostic pop
> +#endif
> };
>
> /**
> - * 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,
> - /* don't use. see system/window.h */
> - HAL_TRANSFORM_RESERVED = 0x08,
> + * These structures are used to define the reference display's
> + * capabilities for HDR content. Display engine can use this
> + * to better tone map content to user's display.
> + * Color is defined in CIE XYZ coordinates
> + */
> +struct android_xy_color {
> + float x;
> + float y;
> };
>
> -/**
> - * Dataspace Definitions
> - * ======================
> - *
> - * Dataspace is the definition of how pixel values should be interpreted.
> - *
> - * For many formats, this is the colorspace of the image data, which
> includes
> - * primaries (including white point) and the transfer characteristic
> function,
> - * which describes both gamma curve and numeric range (within the bit
> depth).
> - *
> - * Other dataspaces include depth measurement data from a depth camera.
> - */
> -
> -typedef enum android_dataspace {
> - /*
> - * Default-assumption data space, when not explicitly specified.
> - *
> - * It is safest to assume the buffer is an image with sRGB primaries
> and
> - * encoding ranges, but the consumer and/or the producer of the data
> may
> - * simply be using defaults. No automatic gamma transform should be
> - * expected, except for a possible display gamma transform when drawn
> to a
> - * screen.
> - */
> - HAL_DATASPACE_UNKNOWN = 0x0,
> -
> - /*
> - * Arbitrary dataspace with manually defined characteristics.
> Definition
> - * for colorspaces or other meaning must be communicated separately.
> - *
> - * This is used when specifying primaries, transfer characteristics,
> - * etc. separately.
> - *
> - * A typical use case is in video encoding parameters (e.g. for
> H.264),
> - * where a colorspace can have separately defined primaries, transfer
> - * characteristics, etc.
> - */
> - HAL_DATASPACE_ARBITRARY = 0x1,
> -
> - /*
> - * RGB Colorspaces
> - * -----------------
> - *
> - * Primaries are given using (x,y) coordinates in the CIE 1931
> definition
> - * of x and y specified by ISO 11664-1.
> - *
> - * Transfer characteristics are the opto-electronic transfer
> characteristic
> - * at the source as a function of linear optical intensity
> (luminance).
> - */
> -
> - /*
> - * sRGB linear encoding:
> - *
> - * The red, green, and blue components are stored in sRGB space, but
> - * are linear, not gamma-encoded.
> - * The RGB primaries and the white point are the same as BT.709.
> - *
> - * The values are encoded using the full range ([0,255] for 8-bit)
> for all
> - * components.
> - */
> - HAL_DATASPACE_SRGB_LINEAR = 0x200,
> -
> - /*
> - * sRGB gamma encoding:
> - *
> - * The red, green and blue components are stored in sRGB space, and
> - * converted to linear space when read, using the standard sRGB to
> linear
> - * equation:
> - *
> - * Clinear = Csrgb / 12.92 for Csrgb <= 0.04045
> - * = (Csrgb + 0.055 / 1.055)^2.4 for Csrgb > 0.04045
> - *
> - * When written the inverse transformation is performed:
> - *
> - * Csrgb = 12.92 * Clinear for Clinear <= 0.0031308
> - * = 1.055 * Clinear^(1/2.4) - 0.055 for Clinear > 0.0031308
> - *
> - *
> - * The alpha component, if present, is always stored in linear space
> and
> - * is left unmodified when read or written.
> - *
> - * The RGB primaries and the white point are the same as BT.709.
> - *
> - * The values are encoded using the full range ([0,255] for 8-bit)
> for all
> - * components.
> - *
> - */
> - HAL_DATASPACE_SRGB = 0x201,
> -
> - /*
> - * YCbCr Colorspaces
> - * -----------------
> - *
> - * Primaries are given using (x,y) coordinates in the CIE 1931
> definition
> - * of x and y specified by ISO 11664-1.
> - *
> - * Transfer characteristics are the opto-electronic transfer
> characteristic
> - * at the source as a function of linear optical intensity
> (luminance).
> - */
> -
> - /*
> - * JPEG File Interchange Format (JFIF)
> - *
> - * Same model as BT.601-625, but all values (Y, Cb, Cr) range from 0
> to 255
> - *
> - * Transfer characteristic curve:
> - * E = 1.099 * L ^ 0.45 - 0.099, 1.00 >= L >= 0.018
> - * E = 4.500 L, 0.018 > L >= 0
> - * L - luminance of image 0 <= L <= 1 for conventional
> colorimetry
> - * E - corresponding electrical signal
> - *
> - * Primaries: x y
> - * green 0.290 0.600
> - * blue 0.150 0.060
> - * red 0.640 0.330
> - * white (D65) 0.3127 0.3290
> - */
> - HAL_DATASPACE_JFIF = 0x101,
> -
> - /*
> - * ITU-R Recommendation 601 (BT.601) - 625-line
> - *
> - * Standard-definition television, 625 Lines (PAL)
> - *
> - * For 8-bit-depth formats:
> - * Luma (Y) samples should range from 16 to 235, inclusive
> - * Chroma (Cb, Cr) samples should range from 16 to 240, inclusive
> - *
> - * For 10-bit-depth formats:
> - * Luma (Y) samples should range from 64 to 940, inclusive
> - * Chroma (Cb, Cr) samples should range from 64 to 960, inclusive
> - *
> - * Transfer characteristic curve:
> - * E = 1.099 * L ^ 0.45 - 0.099, 1.00 >= L >= 0.018
> - * E = 4.500 L, 0.018 > L >= 0
> - * L - luminance of image 0 <= L <= 1 for conventional
> colorimetry
> - * E - corresponding electrical signal
> - *
> - * Primaries: x y
> - * green 0.290 0.600
> - * blue 0.150 0.060
> - * red 0.640 0.330
> - * white (D65) 0.3127 0.3290
> - */
> - HAL_DATASPACE_BT601_625 = 0x102,
> -
> - /*
> - * ITU-R Recommendation 601 (BT.601) - 525-line
> - *
> - * Standard-definition television, 525 Lines (NTSC)
> - *
> - * For 8-bit-depth formats:
> - * Luma (Y) samples should range from 16 to 235, inclusive
> - * Chroma (Cb, Cr) samples should range from 16 to 240, inclusive
> - *
> - * For 10-bit-depth formats:
> - * Luma (Y) samples should range from 64 to 940, inclusive
> - * Chroma (Cb, Cr) samples should range from 64 to 960, inclusive
> - *
> - * Transfer characteristic curve:
> - * E = 1.099 * L ^ 0.45 - 0.099, 1.00 >= L >= 0.018
> - * E = 4.500 L, 0.018 > L >= 0
> - * L - luminance of image 0 <= L <= 1 for conventional
> colorimetry
> - * E - corresponding electrical signal
> - *
> - * Primaries: x y
> - * green 0.310 0.595
> - * blue 0.155 0.070
> - * red 0.630 0.340
> - * white (D65) 0.3127 0.3290
> - */
> - HAL_DATASPACE_BT601_525 = 0x103,
> -
> - /*
> - * ITU-R Recommendation 709 (BT.709)
> - *
> - * High-definition television
> - *
> - * For 8-bit-depth formats:
> - * Luma (Y) samples should range from 16 to 235, inclusive
> - * Chroma (Cb, Cr) samples should range from 16 to 240, inclusive
> - *
> - * For 10-bit-depth formats:
> - * Luma (Y) samples should range from 64 to 940, inclusive
> - * Chroma (Cb, Cr) samples should range from 64 to 960, inclusive
> - *
> - * Primaries: x y
> - * green 0.300 0.600
> - * blue 0.150 0.060
> - * red 0.640 0.330
> - * white (D65) 0.3127 0.3290
> - */
> - HAL_DATASPACE_BT709 = 0x104,
> -
> - /*
> - * The buffer contains depth ranging measurements from a depth camera.
> - * This value is valid with formats:
> - * HAL_PIXEL_FORMAT_Y16: 16-bit samples, consisting of a depth
> measurement
> - * and an associated confidence value. The 3 MSBs of the sample
> make
> - * up the confidence value, and the low 13 LSBs of the sample
> make up
> - * the depth measurement.
> - * For the confidence section, 0 means 100% confidence, 1 means
> 0%
> - * confidence. The mapping to a linear float confidence value
> between
> - * 0.f and 1.f can be obtained with
> - * float confidence = (((depthSample >> 13) - 1) & 0x7) /
> 7.0f;
> - * The depth measurement can be extracted simply with
> - * uint16_t range = (depthSample & 0x1FFF);
> - * HAL_PIXEL_FORMAT_BLOB: A depth point cloud, as
> - * a variable-length float (x,y,z, confidence) coordinate point
> list.
> - * The point cloud will be represented with the
> android_depth_points
> - * structure.
> - */
> - HAL_DATASPACE_DEPTH = 0x1000
> +struct android_smpte2086_metadata {
> + struct android_xy_color displayPrimaryRed;
> + struct android_xy_color displayPrimaryGreen;
> + struct android_xy_color displayPrimaryBlue;
> + struct android_xy_color whitePoint;
> + float maxLuminance;
> + float minLuminance;
> +};
>
> -} android_dataspace_t;
> +struct android_cta861_3_metadata {
> + float maxContentLightLevel;
> + float maxFrameAverageLightLevel;
> +};
>
> #ifdef __cplusplus
> }
> diff --git a/include/android/system/core/include/system/window.h
> b/include/android/system/core/include/system/window.h
> deleted file mode 100644
> index 2c9d6063fdb5..000000000000
> --- a/include/android/system/core/include/system/window.h
> +++ /dev/null
> @@ -1,955 +0,0 @@
> -/* SPDX-License-Identifier: Apache-2.0 */
> -/*
> - * Copyright (C) 2011 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 SYSTEM_CORE_INCLUDE_ANDROID_WINDOW_H
> -#define SYSTEM_CORE_INCLUDE_ANDROID_WINDOW_H
> -
> -#include <cutils/native_handle.h>
> -#include <errno.h>
> -#include <limits.h>
> -#include <stdint.h>
> -#include <string.h>
> -#include <sys/cdefs.h>
> -#include <system/graphics.h>
> -#include <unistd.h>
> -
> -#ifndef __UNUSED
> -#define __UNUSED __attribute__((__unused__))
> -#endif
> -#ifndef __deprecated
> -#define __deprecated __attribute__((__deprecated__))
> -#endif
> -
> -__BEGIN_DECLS
> -
>
> -/*****************************************************************************/
> -
> -#define ANDROID_NATIVE_MAKE_CONSTANT(a,b,c,d) \
> -
> (((unsigned)(a)<<24)|((unsigned)(b)<<16)|((unsigned)(c)<<8)|(unsigned)(d))
> -
> -#define ANDROID_NATIVE_WINDOW_MAGIC \
> - ANDROID_NATIVE_MAKE_CONSTANT('_','w','n','d')
> -
> -#define ANDROID_NATIVE_BUFFER_MAGIC \
> - ANDROID_NATIVE_MAKE_CONSTANT('_','b','f','r')
> -
> -//
> ---------------------------------------------------------------------------
> -
> -// This #define may be used to conditionally compile device-specific code
> to
> -// support either the prior ANativeWindow interface, which did not pass
> libsync
> -// fences around, or the new interface that does. This #define is only
> present
> -// when the ANativeWindow interface does include libsync support.
> -#define ANDROID_NATIVE_WINDOW_HAS_SYNC 1
> -
> -//
> ---------------------------------------------------------------------------
> -
> -typedef const native_handle_t* buffer_handle_t;
> -
> -//
> ---------------------------------------------------------------------------
> -
> -typedef struct android_native_rect_t
> -{
> - int32_t left;
> - int32_t top;
> - int32_t right;
> - int32_t bottom;
> -} android_native_rect_t;
> -
> -//
> ---------------------------------------------------------------------------
> -
> -typedef struct android_native_base_t
> -{
> - /* a magic value defined by the actual EGL native type */
> - int magic;
> -
> - /* the sizeof() of the actual EGL native type */
> - int version;
> -
> - void* reserved[4];
> -
> - /* reference-counting interface */
> - void (*incRef)(struct android_native_base_t* base);
> - void (*decRef)(struct android_native_base_t* base);
> -} android_native_base_t;
> -
> -typedef struct ANativeWindowBuffer
> -{
> -#ifdef __cplusplus
> - ANativeWindowBuffer() {
> - common.magic = ANDROID_NATIVE_BUFFER_MAGIC;
> - common.version = sizeof(ANativeWindowBuffer);
> - memset(common.reserved, 0, sizeof(common.reserved));
> - }
> -
> - // Implement the methods that sp<ANativeWindowBuffer> expects so that
> it
> - // can be used to automatically refcount ANativeWindowBuffer's.
> - void incStrong(const void* /*id*/) const {
> - common.incRef(const_cast<android_native_base_t*>(&common));
> - }
> - void decStrong(const void* /*id*/) const {
> - common.decRef(const_cast<android_native_base_t*>(&common));
> - }
> -#endif
> -
> - struct android_native_base_t common;
> -
> - int width;
> - int height;
> - int stride;
> - int format;
> - int usage;
> -
> - void* reserved[2];
> -
> - buffer_handle_t handle;
> -
> - void* reserved_proc[8];
> -} ANativeWindowBuffer_t;
> -
> -// Old typedef for backwards compatibility.
> -typedef ANativeWindowBuffer_t android_native_buffer_t;
> -
> -//
> ---------------------------------------------------------------------------
> -
> -/* attributes queriable with query() */
> -enum {
> - NATIVE_WINDOW_WIDTH = 0,
> - NATIVE_WINDOW_HEIGHT = 1,
> - NATIVE_WINDOW_FORMAT = 2,
> -
> - /* The minimum number of buffers that must remain un-dequeued after a
> buffer
> - * has been queued. This value applies only if set_buffer_count was
> used to
> - * override the number of buffers and if a buffer has since been
> queued.
> - * Users of the set_buffer_count ANativeWindow method should query
> this
> - * value before calling set_buffer_count. If it is necessary to have
> N
> - * buffers simultaneously dequeued as part of the steady-state
> operation,
> - * and this query returns M then N+M buffers should be requested via
> - * native_window_set_buffer_count.
> - *
> - * Note that this value does NOT apply until a single buffer has been
> - * queued. In particular this means that it is possible to:
> - *
> - * 1. Query M = min undequeued buffers
> - * 2. Set the buffer count to N + M
> - * 3. Dequeue all N + M buffers
> - * 4. Cancel M buffers
> - * 5. Queue, dequeue, queue, dequeue, ad infinitum
> - */
> - NATIVE_WINDOW_MIN_UNDEQUEUED_BUFFERS = 3,
> -
> - /* Check whether queueBuffer operations on the ANativeWindow send the
> buffer
> - * to the window compositor. The query sets the returned 'value'
> argument
> - * to 1 if the ANativeWindow DOES send queued buffers directly to the
> window
> - * compositor and 0 if the buffers do not go directly to the window
> - * compositor.
> - *
> - * This can be used to determine whether protected buffer content
> should be
> - * sent to the ANativeWindow. Note, however, that a result of 1 does
> NOT
> - * indicate that queued buffers will be protected from applications
> or users
> - * capturing their contents. If that behavior is desired then some
> other
> - * mechanism (e.g. the GRALLOC_USAGE_PROTECTED flag) should be used in
> - * conjunction with this query.
> - */
> - NATIVE_WINDOW_QUEUES_TO_WINDOW_COMPOSER = 4,
> -
> - /* Get the concrete type of a ANativeWindow. See below for the list
> of
> - * possible return values.
> - *
> - * This query should not be used outside the Android framework and
> will
> - * likely be removed in the near future.
> - */
> - NATIVE_WINDOW_CONCRETE_TYPE = 5,
> -
> -
> - /*
> - * Default width and height of ANativeWindow buffers, these are the
> - * dimensions of the window buffers irrespective of the
> - * NATIVE_WINDOW_SET_BUFFERS_DIMENSIONS call and match the native
> window
> - * size unless overridden by
> NATIVE_WINDOW_SET_BUFFERS_USER_DIMENSIONS.
> - */
> - NATIVE_WINDOW_DEFAULT_WIDTH = 6,
> - NATIVE_WINDOW_DEFAULT_HEIGHT = 7,
> -
> - /*
> - * transformation that will most-likely be applied to buffers. This
> is only
> - * a hint, the actual transformation applied might be different.
> - *
> - * INTENDED USE:
> - *
> - * The transform hint can be used by a producer, for instance the GLES
> - * driver, to pre-rotate the rendering such that the final
> transformation
> - * in the composer is identity. This can be very useful when used in
> - * conjunction with the h/w composer HAL, in situations where it
> - * cannot handle arbitrary rotations.
> - *
> - * 1. Before dequeuing a buffer, the GL driver (or any other ANW
> client)
> - * queries the ANW for NATIVE_WINDOW_TRANSFORM_HINT.
> - *
> - * 2. The GL driver overrides the width and height of the ANW to
> - * account for NATIVE_WINDOW_TRANSFORM_HINT. This is done by
> querying
> - * NATIVE_WINDOW_DEFAULT_{WIDTH | HEIGHT}, swapping the dimensions
> - * according to NATIVE_WINDOW_TRANSFORM_HINT and calling
> - * native_window_set_buffers_dimensions().
> - *
> - * 3. The GL driver dequeues a buffer of the new pre-rotated size.
> - *
> - * 4. The GL driver renders to the buffer such that the image is
> - * already transformed, that is applying
> NATIVE_WINDOW_TRANSFORM_HINT
> - * to the rendering.
> - *
> - * 5. The GL driver calls native_window_set_transform to apply
> - * inverse transformation to the buffer it just rendered.
> - * In order to do this, the GL driver needs
> - * to calculate the inverse of NATIVE_WINDOW_TRANSFORM_HINT, this
> is
> - * done easily:
> - *
> - * int hintTransform, inverseTransform;
> - * query(..., NATIVE_WINDOW_TRANSFORM_HINT, &hintTransform);
> - * inverseTransform = hintTransform;
> - * if (hintTransform & HAL_TRANSFORM_ROT_90)
> - * inverseTransform ^= HAL_TRANSFORM_ROT_180;
> - *
> - *
> - * 6. The GL driver queues the pre-transformed buffer.
> - *
> - * 7. The composer combines the buffer transform with the display
> - * transform. If the buffer transform happens to cancel out the
> - * display transform then no rotation is needed.
> - *
> - */
> - NATIVE_WINDOW_TRANSFORM_HINT = 8,
> -
> - /*
> - * Boolean that indicates whether the consumer is running more than
> - * one buffer behind the producer.
> - */
> - NATIVE_WINDOW_CONSUMER_RUNNING_BEHIND = 9,
> -
> - /*
> - * The consumer gralloc usage bits currently set by the consumer.
> - * The values are defined in hardware/libhardware/include/gralloc.h.
> - */
> - NATIVE_WINDOW_CONSUMER_USAGE_BITS = 10,
> -
> - /**
> - * Transformation that will by applied to buffers by the hwcomposer.
> - * This must not be set or checked by producer endpoints, and will
> - * disable the transform hint set in SurfaceFlinger (see
> - * NATIVE_WINDOW_TRANSFORM_HINT).
> - *
> - * INTENDED USE:
> - * Temporary - Please do not use this. This is intended only to be
> used
> - * by the camera's LEGACY mode.
> - *
> - * In situations where a SurfaceFlinger client wishes to set a
> transform
> - * that is not visible to the producer, and will always be applied in
> the
> - * hardware composer, the client can set this flag with
> - * native_window_set_buffers_sticky_transform. This can be used to
> rotate
> - * and flip buffers consumed by hardware composer without actually
> changing
> - * the aspect ratio of the buffers produced.
> - */
> - NATIVE_WINDOW_STICKY_TRANSFORM = 11,
> -
> - /**
> - * The default data space for the buffers as set by the consumer.
> - * The values are defined in graphics.h.
> - */
> - NATIVE_WINDOW_DEFAULT_DATASPACE = 12,
> -
> - /*
> - * Returns the age of the contents of the most recently dequeued
> buffer as
> - * the number of frames that have elapsed since it was last queued.
> For
> - * example, if the window is double-buffered, the age of any given
> buffer in
> - * steady state will be 2. If the dequeued buffer has never been
> queued, its
> - * age will be 0.
> - */
> - NATIVE_WINDOW_BUFFER_AGE = 13,
> -};
> -
> -/* Valid operations for the (*perform)() hook.
> - *
> - * Values marked as 'deprecated' are supported, but have been superceded
> by
> - * other functionality.
> - *
> - * Values marked as 'private' should be considered private to the
> framework.
> - * HAL implementation code with access to an ANativeWindow should not use
> these,
> - * as it may not interact properly with the framework's use of the
> - * ANativeWindow.
> - */
> -enum {
> - NATIVE_WINDOW_SET_USAGE = 0,
> - NATIVE_WINDOW_CONNECT = 1, /* deprecated */
> - NATIVE_WINDOW_DISCONNECT = 2, /* deprecated */
> - NATIVE_WINDOW_SET_CROP = 3, /* private */
> - NATIVE_WINDOW_SET_BUFFER_COUNT = 4,
> - NATIVE_WINDOW_SET_BUFFERS_GEOMETRY = 5, /* deprecated */
> - NATIVE_WINDOW_SET_BUFFERS_TRANSFORM = 6,
> - NATIVE_WINDOW_SET_BUFFERS_TIMESTAMP = 7,
> - NATIVE_WINDOW_SET_BUFFERS_DIMENSIONS = 8,
> - NATIVE_WINDOW_SET_BUFFERS_FORMAT = 9,
> - NATIVE_WINDOW_SET_SCALING_MODE = 10, /* private */
> - NATIVE_WINDOW_LOCK = 11, /* private */
> - NATIVE_WINDOW_UNLOCK_AND_POST = 12, /* private */
> - NATIVE_WINDOW_API_CONNECT = 13, /* private */
> - NATIVE_WINDOW_API_DISCONNECT = 14, /* private */
> - NATIVE_WINDOW_SET_BUFFERS_USER_DIMENSIONS = 15, /* private */
> - NATIVE_WINDOW_SET_POST_TRANSFORM_CROP = 16, /* private */
> - NATIVE_WINDOW_SET_BUFFERS_STICKY_TRANSFORM = 17,/* private */
> - NATIVE_WINDOW_SET_SIDEBAND_STREAM = 18,
> - NATIVE_WINDOW_SET_BUFFERS_DATASPACE = 19,
> - NATIVE_WINDOW_SET_SURFACE_DAMAGE = 20, /* private */
> -};
> -
> -/* parameter for NATIVE_WINDOW_[API_][DIS]CONNECT */
> -enum {
> - /* Buffers will be queued by EGL via eglSwapBuffers after being
> filled using
> - * OpenGL ES.
> - */
> - NATIVE_WINDOW_API_EGL = 1,
> -
> - /* Buffers will be queued after being filled using the CPU
> - */
> - NATIVE_WINDOW_API_CPU = 2,
> -
> - /* Buffers will be queued by Stagefright after being filled by a video
> - * decoder. The video decoder can either be a software or hardware
> decoder.
> - */
> - NATIVE_WINDOW_API_MEDIA = 3,
> -
> - /* Buffers will be queued by the the camera HAL.
> - */
> - NATIVE_WINDOW_API_CAMERA = 4,
> -};
> -
> -/* parameter for NATIVE_WINDOW_SET_BUFFERS_TRANSFORM */
> -enum {
> - /* flip source image horizontally */
> - NATIVE_WINDOW_TRANSFORM_FLIP_H = HAL_TRANSFORM_FLIP_H ,
> - /* flip source image vertically */
> - NATIVE_WINDOW_TRANSFORM_FLIP_V = HAL_TRANSFORM_FLIP_V,
> - /* rotate source image 90 degrees clock-wise, and is applied after
> TRANSFORM_FLIP_{H|V} */
> - NATIVE_WINDOW_TRANSFORM_ROT_90 = HAL_TRANSFORM_ROT_90,
> - /* rotate source image 180 degrees */
> - NATIVE_WINDOW_TRANSFORM_ROT_180 = HAL_TRANSFORM_ROT_180,
> - /* rotate source image 270 degrees clock-wise */
> - NATIVE_WINDOW_TRANSFORM_ROT_270 = HAL_TRANSFORM_ROT_270,
> - /* transforms source by the inverse transform of the screen it is
> displayed onto. This
> - * transform is applied last */
> - NATIVE_WINDOW_TRANSFORM_INVERSE_DISPLAY = 0x08
> -};
> -
> -/* parameter for NATIVE_WINDOW_SET_SCALING_MODE */
> -enum {
> - /* the window content is not updated (frozen) until a buffer of
> - * the window size is received (enqueued)
> - */
> - NATIVE_WINDOW_SCALING_MODE_FREEZE = 0,
> - /* the buffer is scaled in both dimensions to match the window size */
> - NATIVE_WINDOW_SCALING_MODE_SCALE_TO_WINDOW = 1,
> - /* the buffer is scaled uniformly such that the smaller dimension
> - * of the buffer matches the window size (cropping in the process)
> - */
> - NATIVE_WINDOW_SCALING_MODE_SCALE_CROP = 2,
> - /* the window is clipped to the size of the buffer's crop rectangle;
> pixels
> - * outside the crop rectangle are treated as if they are completely
> - * transparent.
> - */
> - NATIVE_WINDOW_SCALING_MODE_NO_SCALE_CROP = 3,
> -};
> -
> -/* values returned by the NATIVE_WINDOW_CONCRETE_TYPE query */
> -enum {
> - NATIVE_WINDOW_FRAMEBUFFER = 0, /*
> FramebufferNativeWindow */
> - NATIVE_WINDOW_SURFACE = 1, /* Surface */
> -};
> -
> -/* parameter for NATIVE_WINDOW_SET_BUFFERS_TIMESTAMP
> - *
> - * Special timestamp value to indicate that timestamps should be
> auto-generated
> - * by the native window when queueBuffer is called. This is equal to
> INT64_MIN,
> - * defined directly to avoid problems with C99/C++ inclusion of stdint.h.
> - */
> -static const int64_t NATIVE_WINDOW_TIMESTAMP_AUTO =
> (-9223372036854775807LL-1);
> -
> -struct ANativeWindow
> -{
> -#ifdef __cplusplus
> - ANativeWindow()
> - : flags(0), minSwapInterval(0), maxSwapInterval(0), xdpi(0),
> ydpi(0)
> - {
> - common.magic = ANDROID_NATIVE_WINDOW_MAGIC;
> - common.version = sizeof(ANativeWindow);
> - memset(common.reserved, 0, sizeof(common.reserved));
> - }
> -
> - /* Implement the methods that sp<ANativeWindow> expects so that it
> - can be used to automatically refcount ANativeWindow's. */
> - void incStrong(const void* /*id*/) const {
> - common.incRef(const_cast<android_native_base_t*>(&common));
> - }
> - void decStrong(const void* /*id*/) const {
> - common.decRef(const_cast<android_native_base_t*>(&common));
> - }
> -#endif
> -
> - struct android_native_base_t common;
> -
> - /* flags describing some attributes of this surface or its updater */
> - const uint32_t flags;
> -
> - /* min swap interval supported by this updated */
> - const int minSwapInterval;
> -
> - /* max swap interval supported by this updated */
> - const int maxSwapInterval;
> -
> - /* horizontal and vertical resolution in DPI */
> - const float xdpi;
> - const float ydpi;
> -
> - /* Some storage reserved for the OEM's driver. */
> - intptr_t oem[4];
> -
> - /*
> - * Set the swap interval for this surface.
> - *
> - * Returns 0 on success or -errno on error.
> - */
> - int (*setSwapInterval)(struct ANativeWindow* window,
> - int interval);
> -
> - /*
> - * Hook called by EGL to acquire a buffer. After this call, the buffer
> - * is not locked, so its content cannot be modified. This call may
> block if
> - * no buffers are available.
> - *
> - * The window holds a reference to the buffer between dequeueBuffer
> and
> - * either queueBuffer or cancelBuffer, so clients only need their own
> - * reference if they might use the buffer after queueing or canceling
> it.
> - * Holding a reference to a buffer after queueing or canceling it is
> only
> - * allowed if a specific buffer count has been set.
> - *
> - * Returns 0 on success or -errno on error.
> - *
> - * XXX: This function is deprecated. It will continue to work for
> some
> - * time for binary compatibility, but the new dequeueBuffer function
> that
> - * outputs a fence file descriptor should be used in its place.
> - */
> - int (*dequeueBuffer_DEPRECATED)(struct ANativeWindow* window,
> - struct ANativeWindowBuffer** buffer);
> -
> - /*
> - * hook called by EGL to lock a buffer. This MUST be called before
> modifying
> - * the content of a buffer. The buffer must have been acquired with
> - * dequeueBuffer first.
> - *
> - * Returns 0 on success or -errno on error.
> - *
> - * XXX: This function is deprecated. It will continue to work for
> some
> - * time for binary compatibility, but it is essentially a no-op, and
> calls
> - * to it should be removed.
> - */
> - int (*lockBuffer_DEPRECATED)(struct ANativeWindow* window,
> - struct ANativeWindowBuffer* buffer);
> -
> - /*
> - * Hook called by EGL when modifications to the render buffer are
> done.
> - * This unlocks and post the buffer.
> - *
> - * The window holds a reference to the buffer between dequeueBuffer
> and
> - * either queueBuffer or cancelBuffer, so clients only need their own
> - * reference if they might use the buffer after queueing or canceling
> it.
> - * Holding a reference to a buffer after queueing or canceling it is
> only
> - * allowed if a specific buffer count has been set.
> - *
> - * Buffers MUST be queued in the same order than they were dequeued.
> - *
> - * Returns 0 on success or -errno on error.
> - *
> - * XXX: This function is deprecated. It will continue to work for
> some
> - * time for binary compatibility, but the new queueBuffer function
> that
> - * takes a fence file descriptor should be used in its place (pass a
> value
> - * of -1 for the fence file descriptor if there is no valid one to
> pass).
> - */
> - int (*queueBuffer_DEPRECATED)(struct ANativeWindow* window,
> - struct ANativeWindowBuffer* buffer);
> -
> - /*
> - * hook used to retrieve information about the native window.
> - *
> - * Returns 0 on success or -errno on error.
> - */
> - int (*query)(const struct ANativeWindow* window,
> - int what, int* value);
> -
> - /*
> - * hook used to perform various operations on the surface.
> - * (*perform)() is a generic mechanism to add functionality to
> - * ANativeWindow while keeping backward binary compatibility.
> - *
> - * DO NOT CALL THIS HOOK DIRECTLY. Instead, use the helper functions
> - * defined below.
> - *
> - * (*perform)() returns -ENOENT if the 'what' parameter is not
> supported
> - * by the surface's implementation.
> - *
> - * See above for a list of valid operations, such as
> - * NATIVE_WINDOW_SET_USAGE or NATIVE_WINDOW_CONNECT
> - */
> - int (*perform)(struct ANativeWindow* window,
> - int operation, ... );
> -
> - /*
> - * Hook used to cancel a buffer that has been dequeued.
> - * No synchronization is performed between dequeue() and cancel(), so
> - * either external synchronization is needed, or these functions must
> be
> - * called from the same thread.
> - *
> - * The window holds a reference to the buffer between dequeueBuffer
> and
> - * either queueBuffer or cancelBuffer, so clients only need their own
> - * reference if they might use the buffer after queueing or canceling
> it.
> - * Holding a reference to a buffer after queueing or canceling it is
> only
> - * allowed if a specific buffer count has been set.
> - *
> - * XXX: This function is deprecated. It will continue to work for
> some
> - * time for binary compatibility, but the new cancelBuffer function
> that
> - * takes a fence file descriptor should be used in its place (pass a
> value
> - * of -1 for the fence file descriptor if there is no valid one to
> pass).
> - */
> - int (*cancelBuffer_DEPRECATED)(struct ANativeWindow* window,
> - struct ANativeWindowBuffer* buffer);
> -
> - /*
> - * Hook called by EGL to acquire a buffer. This call may block if no
> - * buffers are available.
> - *
> - * The window holds a reference to the buffer between dequeueBuffer
> and
> - * either queueBuffer or cancelBuffer, so clients only need their own
> - * reference if they might use the buffer after queueing or canceling
> it.
> - * Holding a reference to a buffer after queueing or canceling it is
> only
> - * allowed if a specific buffer count has been set.
> - *
> - * The libsync fence file descriptor returned in the int pointed to
> by the
> - * fenceFd argument will refer to the fence that must signal before
> the
> - * dequeued buffer may be written to. A value of -1 indicates that
> the
> - * caller may access the buffer immediately without waiting on a
> fence. If
> - * a valid file descriptor is returned (i.e. any value except -1)
> then the
> - * caller is responsible for closing the file descriptor.
> - *
> - * Returns 0 on success or -errno on error.
> - */
> - int (*dequeueBuffer)(struct ANativeWindow* window,
> - struct ANativeWindowBuffer** buffer, int* fenceFd);
> -
> - /*
> - * Hook called by EGL when modifications to the render buffer are
> done.
> - * This unlocks and post the buffer.
> - *
> - * The window holds a reference to the buffer between dequeueBuffer
> and
> - * either queueBuffer or cancelBuffer, so clients only need their own
> - * reference if they might use the buffer after queueing or canceling
> it.
> - * Holding a reference to a buffer after queueing or canceling it is
> only
> - * allowed if a specific buffer count has been set.
> - *
> - * The fenceFd argument specifies a libsync fence file descriptor for
> a
> - * fence that must signal before the buffer can be accessed. If the
> buffer
> - * can be accessed immediately then a value of -1 should be used. The
> - * caller must not use the file descriptor after it is passed to
> - * queueBuffer, and the ANativeWindow implementation is responsible
> for
> - * closing it.
> - *
> - * Returns 0 on success or -errno on error.
> - */
> - int (*queueBuffer)(struct ANativeWindow* window,
> - struct ANativeWindowBuffer* buffer, int fenceFd);
> -
> - /*
> - * Hook used to cancel a buffer that has been dequeued.
> - * No synchronization is performed between dequeue() and cancel(), so
> - * either external synchronization is needed, or these functions must
> be
> - * called from the same thread.
> - *
> - * The window holds a reference to the buffer between dequeueBuffer
> and
> - * either queueBuffer or cancelBuffer, so clients only need their own
> - * reference if they might use the buffer after queueing or canceling
> it.
> - * Holding a reference to a buffer after queueing or canceling it is
> only
> - * allowed if a specific buffer count has been set.
> - *
> - * The fenceFd argument specifies a libsync fence file decsriptor for
> a
> - * fence that must signal before the buffer can be accessed. If the
> buffer
> - * can be accessed immediately then a value of -1 should be used.
> - *
> - * Note that if the client has not waited on the fence that was
> returned
> - * from dequeueBuffer, that same fence should be passed to
> cancelBuffer to
> - * ensure that future uses of the buffer are preceded by a wait on
> that
> - * fence. The caller must not use the file descriptor after it is
> passed
> - * to cancelBuffer, and the ANativeWindow implementation is
> responsible for
> - * closing it.
> - *
> - * Returns 0 on success or -errno on error.
> - */
> - int (*cancelBuffer)(struct ANativeWindow* window,
> - struct ANativeWindowBuffer* buffer, int fenceFd);
> -};
> -
> - /* Backwards compatibility: use ANativeWindow (struct ANativeWindow in
> C).
> - * android_native_window_t is deprecated.
> - */
> -typedef struct ANativeWindow ANativeWindow;
> -typedef struct ANativeWindow android_native_window_t __deprecated;
> -
> -/*
> - * native_window_set_usage(..., usage)
> - * Sets the intended usage flags for the next buffers
> - * acquired with (*lockBuffer)() and on.
> - * By default (if this function is never called), a usage of
> - * GRALLOC_USAGE_HW_RENDER | GRALLOC_USAGE_HW_TEXTURE
> - * is assumed.
> - * Calling this function will usually cause following buffers to be
> - * reallocated.
> - */
> -
> -static inline int native_window_set_usage(
> - struct ANativeWindow* window, int usage)
> -{
> - return window->perform(window, NATIVE_WINDOW_SET_USAGE, usage);
> -}
> -
> -/* deprecated. Always returns 0. Don't call. */
> -static inline int native_window_connect(
> - struct ANativeWindow* window __UNUSED, int api __UNUSED)
> __deprecated;
> -
> -static inline int native_window_connect(
> - struct ANativeWindow* window __UNUSED, int api __UNUSED) {
> - return 0;
> -}
> -
> -/* deprecated. Always returns 0. Don't call. */
> -static inline int native_window_disconnect(
> - struct ANativeWindow* window __UNUSED, int api __UNUSED)
> __deprecated;
> -
> -static inline int native_window_disconnect(
> - struct ANativeWindow* window __UNUSED, int api __UNUSED) {
> - return 0;
> -}
> -
> -/*
> - * native_window_set_crop(..., crop)
> - * Sets which region of the next queued buffers needs to be considered.
> - * Depending on the scaling mode, a buffer's crop region is scaled and/or
> - * cropped to match the surface's size. This function sets the crop in
> - * pre-transformed buffer pixel coordinates.
> - *
> - * The specified crop region applies to all buffers queued after it is
> called.
> - *
> - * If 'crop' is NULL, subsequently queued buffers won't be cropped.
> - *
> - * An error is returned if for instance the crop region is invalid, out
> of the
> - * buffer's bound or if the window is invalid.
> - */
> -static inline int native_window_set_crop(
> - struct ANativeWindow* window,
> - android_native_rect_t const * crop)
> -{
> - return window->perform(window, NATIVE_WINDOW_SET_CROP, crop);
> -}
> -
> -/*
> - * native_window_set_post_transform_crop(..., crop)
> - * Sets which region of the next queued buffers needs to be considered.
> - * Depending on the scaling mode, a buffer's crop region is scaled and/or
> - * cropped to match the surface's size. This function sets the crop in
> - * post-transformed pixel coordinates.
> - *
> - * The specified crop region applies to all buffers queued after it is
> called.
> - *
> - * If 'crop' is NULL, subsequently queued buffers won't be cropped.
> - *
> - * An error is returned if for instance the crop region is invalid, out
> of the
> - * buffer's bound or if the window is invalid.
> - */
> -static inline int native_window_set_post_transform_crop(
> - struct ANativeWindow* window,
> - android_native_rect_t const * crop)
> -{
> - return window->perform(window, NATIVE_WINDOW_SET_POST_TRANSFORM_CROP,
> crop);
> -}
> -
> -/*
> - * native_window_set_active_rect(..., active_rect)
> - *
> - * This function is deprecated and will be removed soon. For now it
> simply
> - * sets the post-transform crop for compatibility while multi-project
> commits
> - * get checked.
> - */
> -static inline int native_window_set_active_rect(
> - struct ANativeWindow* window,
> - android_native_rect_t const * active_rect) __deprecated;
> -
> -static inline int native_window_set_active_rect(
> - struct ANativeWindow* window,
> - android_native_rect_t const * active_rect)
> -{
> - return native_window_set_post_transform_crop(window, active_rect);
> -}
> -
> -/*
> - * native_window_set_buffer_count(..., count)
> - * Sets the number of buffers associated with this native window.
> - */
> -static inline int native_window_set_buffer_count(
> - struct ANativeWindow* window,
> - size_t bufferCount)
> -{
> - return window->perform(window, NATIVE_WINDOW_SET_BUFFER_COUNT,
> bufferCount);
> -}
> -
> -/*
> - * native_window_set_buffers_geometry(..., int w, int h, int format)
> - * All buffers dequeued after this call will have the dimensions and
> format
> - * specified. A successful call to this function has the same effect as
> calling
> - * native_window_set_buffers_size and native_window_set_buffers_format.
> - *
> - * XXX: This function is deprecated. The
> native_window_set_buffers_dimensions
> - * and native_window_set_buffers_format functions should be used instead.
> - */
> -static inline int native_window_set_buffers_geometry(
> - struct ANativeWindow* window,
> - int w, int h, int format) __deprecated;
> -
> -static inline int native_window_set_buffers_geometry(
> - struct ANativeWindow* window,
> - int w, int h, int format)
> -{
> - return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_GEOMETRY,
> - w, h, format);
> -}
> -
> -/*
> - * native_window_set_buffers_dimensions(..., int w, int h)
> - * All buffers dequeued after this call will have the dimensions
> specified.
> - * In particular, all buffers will have a fixed-size, independent from the
> - * native-window size. They will be scaled according to the scaling mode
> - * (see native_window_set_scaling_mode) upon window composition.
> - *
> - * If w and h are 0, the normal behavior is restored. That is, dequeued
> buffers
> - * following this call will be sized to match the window's size.
> - *
> - * Calling this function will reset the window crop to a NULL value, which
> - * disables cropping of the buffers.
> - */
> -static inline int native_window_set_buffers_dimensions(
> - struct ANativeWindow* window,
> - int w, int h)
> -{
> - return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_DIMENSIONS,
> - w, h);
> -}
> -
> -/*
> - * native_window_set_buffers_user_dimensions(..., int w, int h)
> - *
> - * Sets the user buffer size for the window, which overrides the
> - * window's size. All buffers dequeued after this call will have the
> - * dimensions specified unless overridden by
> - * native_window_set_buffers_dimensions. All buffers will have a
> - * fixed-size, independent from the native-window size. They will be
> - * scaled according to the scaling mode (see
> - * native_window_set_scaling_mode) upon window composition.
> - *
> - * If w and h are 0, the normal behavior is restored. That is, the
> - * default buffer size will match the windows's size.
> - *
> - * Calling this function will reset the window crop to a NULL value, which
> - * disables cropping of the buffers.
> - */
> -static inline int native_window_set_buffers_user_dimensions(
> - struct ANativeWindow* window,
> - int w, int h)
> -{
> - return window->perform(window,
> NATIVE_WINDOW_SET_BUFFERS_USER_DIMENSIONS,
> - w, h);
> -}
> -
> -/*
> - * native_window_set_buffers_format(..., int format)
> - * All buffers dequeued after this call will have the format specified.
> - *
> - * If the specified format is 0, the default buffer format will be used.
> - */
> -static inline int native_window_set_buffers_format(
> - struct ANativeWindow* window,
> - int format)
> -{
> - return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_FORMAT,
> format);
> -}
> -
> -/*
> - * native_window_set_buffers_data_space(..., int dataSpace)
> - * All buffers queued after this call will be associated with the
> dataSpace
> - * parameter specified.
> - *
> - * dataSpace specifies additional information about the buffer that's
> dependent
> - * on the buffer format and the endpoints. For example, it can be used to
> convey
> - * the color space of the image data in the buffer, or it can be used to
> - * indicate that the buffers contain depth measurement data instead of
> color
> - * images. The default dataSpace is 0, HAL_DATASPACE_UNKNOWN, unless it
> has been
> - * overridden by the consumer.
> - */
> -static inline int native_window_set_buffers_data_space(
> - struct ANativeWindow* window,
> - android_dataspace_t dataSpace)
> -{
> - return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_DATASPACE,
> - dataSpace);
> -}
> -
> -/*
> - * native_window_set_buffers_transform(..., int transform)
> - * All buffers queued after this call will be displayed transformed
> according
> - * to the transform parameter specified.
> - */
> -static inline int native_window_set_buffers_transform(
> - struct ANativeWindow* window,
> - int transform)
> -{
> - return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_TRANSFORM,
> - transform);
> -}
> -
> -/*
> - * native_window_set_buffers_sticky_transform(..., int transform)
> - * All buffers queued after this call will be displayed transformed
> according
> - * to the transform parameter specified applied on top of the regular
> buffer
> - * transform. Setting this transform will disable the transform hint.
> - *
> - * Temporary - This is only intended to be used by the LEGACY camera
> mode, do
> - * not use this for anything else.
> - */
> -static inline int native_window_set_buffers_sticky_transform(
> - struct ANativeWindow* window,
> - int transform)
> -{
> - return window->perform(window,
> NATIVE_WINDOW_SET_BUFFERS_STICKY_TRANSFORM,
> - transform);
> -}
> -
> -/*
> - * native_window_set_buffers_timestamp(..., int64_t timestamp)
> - * All buffers queued after this call will be associated with the
> timestamp
> - * parameter specified. If the timestamp is set to
> NATIVE_WINDOW_TIMESTAMP_AUTO
> - * (the default), timestamps will be generated automatically when
> queueBuffer is
> - * called. The timestamp is measured in nanoseconds, and is normally
> monotonically
> - * increasing. The timestamp should be unaffected by time-of-day
> adjustments,
> - * and for a camera should be strictly monotonic but for a media player
> may be
> - * reset when the position is set.
> - */
> -static inline int native_window_set_buffers_timestamp(
> - struct ANativeWindow* window,
> - int64_t timestamp)
> -{
> - return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_TIMESTAMP,
> - timestamp);
> -}
> -
> -/*
> - * native_window_set_scaling_mode(..., int mode)
> - * All buffers queued after this call will be associated with the scaling
> mode
> - * specified.
> - */
> -static inline int native_window_set_scaling_mode(
> - struct ANativeWindow* window,
> - int mode)
> -{
> - return window->perform(window, NATIVE_WINDOW_SET_SCALING_MODE,
> - mode);
> -}
> -
> -/*
> - * native_window_api_connect(..., int api)
> - * connects an API to this window. only one API can be connected at a
> time.
> - * Returns -EINVAL if for some reason the window cannot be connected,
> which
> - * can happen if it's connected to some other API.
> - */
> -static inline int native_window_api_connect(
> - struct ANativeWindow* window, int api)
> -{
> - return window->perform(window, NATIVE_WINDOW_API_CONNECT, api);
> -}
> -
> -/*
> - * native_window_api_disconnect(..., int api)
> - * disconnect the API from this window.
> - * An error is returned if for instance the window wasn't connected in the
> - * first place.
> - */
> -static inline int native_window_api_disconnect(
> - struct ANativeWindow* window, int api)
> -{
> - return window->perform(window, NATIVE_WINDOW_API_DISCONNECT, api);
> -}
> -
> -/*
> - * native_window_dequeue_buffer_and_wait(...)
> - * Dequeue a buffer and wait on the fence associated with that buffer.
> The
> - * buffer may safely be accessed immediately upon this function
> returning. An
> - * error is returned if either of the dequeue or the wait operations fail.
> - */
> -static inline int native_window_dequeue_buffer_and_wait(ANativeWindow
> *anw,
> - struct ANativeWindowBuffer** anb) {
> - return anw->dequeueBuffer_DEPRECATED(anw, anb);
> -}
> -
> -/*
> - * native_window_set_sideband_stream(..., native_handle_t*)
> - * Attach a sideband buffer stream to a native window.
> - */
> -static inline int native_window_set_sideband_stream(
> - struct ANativeWindow* window,
> - native_handle_t* sidebandHandle)
> -{
> - return window->perform(window, NATIVE_WINDOW_SET_SIDEBAND_STREAM,
> - sidebandHandle);
> -}
> -
> -/*
> - * native_window_set_surface_damage(..., android_native_rect_t* rects,
> int numRects)
> - * Set the surface damage (i.e., the region of the surface that has
> changed
> - * since the previous frame). The damage set by this call will be reset
> (to the
> - * default of full-surface damage) after calling queue, so this must be
> called
> - * prior to every frame with damage that does not cover the whole surface
> if the
> - * caller desires downstream consumers to use this optimization.
> - *
> - * The damage region is specified as an array of rectangles, with the
> important
> - * caveat that the origin of the surface is considered to be the
> bottom-left
> - * corner, as in OpenGL ES.
> - *
> - * If numRects is set to 0, rects may be NULL, and the surface damage
> will be
> - * set to the full surface (the same as if this function had not been
> called for
> - * this frame).
> - */
> -static inline int native_window_set_surface_damage(
> - struct ANativeWindow* window,
> - const android_native_rect_t* rects, size_t numRects)
> -{
> - return window->perform(window, NATIVE_WINDOW_SET_SURFACE_DAMAGE,
> - rects, numRects);
> -}
> -
> -__END_DECLS
> -
> -#endif /* SYSTEM_CORE_INCLUDE_ANDROID_WINDOW_H */
> --
> Regards,
>
> Laurent Pinchart
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.libcamera.org/pipermail/libcamera-devel/attachments/20210527/82e571df/attachment-0001.htm>
More information about the libcamera-devel
mailing list