diff options
| author | Roman Stratiienko <r.stratiienko@gmail.com> | 2022-12-19 18:24:47 +0200 |
|---|---|---|
| committer | Roman Stratiienko <r.stratiienko@gmail.com> | 2023-11-21 18:50:58 +0200 |
| commit | 2a93e4c8826f96ab2092f848e4346a92250a6923 (patch) | |
| tree | 0672cdb6b64ef1ffb20a5ed940fddd8d04316e52 | |
| parent | b9bd2712fbc61174120f63d948e68f93d1ab410b (diff) | |
| download | drm_hwcomposer-2a93e4c8826f96ab2092f848e4346a92250a6923.tar.gz | |
drm_hwcomposer: CI: Use aospext to provide headers for clang-tidy
Since we're now using aospless archive for meson.build, we can use
headers from there and remove .ci/android_headers/ directory completely.
Adding aospless cflags also raised some new tidy checks fails,
which were fixed by this commit.
Since clang-tidy now relies on aospless files, running CI on the host
can't be supported and removed. Running CI within the docker container
is the only option left.
Signed-off-by: Roman Stratiienko <r.stratiienko@gmail.com>
26 files changed, 34 insertions, 6587 deletions
diff --git a/.ci/Makefile b/.ci/Makefile index 9c82fca..a30414c 100644 --- a/.ci/Makefile +++ b/.ci/Makefile @@ -1,5 +1,6 @@ -INCLUDE_DIRS := . ../libdrm/include/drm include ./.ci/android_headers ./tests/test_include +BASE_DIR:=../aospless + SYSTEM_INCLUDE_DIRS := /usr/include/libdrm CLANG := clang++-15 @@ -7,12 +8,17 @@ CLANG_TIDY := clang-tidy-15 OUT_DIR := /tmp/drm_hwcomposer/build SRC_DIR := . -CXXFLAGS := -fPIC -Wall -Wextra -Werror -D__ANDROID_API__=31 +CXXFLAGS := -Wall -Wextra -Werror CXXFLAGS += -D_LIBCPP_ENABLE_THREAD_SAFETY_ANNOTATIONS CXXFLAGS += -fvisibility-inlines-hidden -std=gnu++17 -DHWC2_USE_CPP11 -DHWC2_INCLUDE_STRINGIFICATION -fno-rtti -SKIP_FILES := \ - bufferinfo/BufferInfoMapperMetadata.cpp +CXXARGS := $(shell cat $(BASE_DIR)/build_flags/sharedlib.cppflags) +CXXARGS := $(subst [BASE_DIR],$(BASE_DIR),$(CXXARGS)) +# clang-tidy doesn't like -mcpu=xxx flag +CXXARGS := $(patsubst -mcpu=%,,$(CXXARGS)) +# TODO: build aospless with gtest enabled and remove line below +CXXARGS := $(subst -nostdlibinc,,$(CXXARGS)) +CXXARGS += -I. -I./tests/test_include $(CXXFLAGS) TIDY_FILES_OVERRIDE := \ bufferinfo/legacy/BufferInfoImagination.cpp:COARSE \ @@ -90,15 +96,14 @@ DEPS := $(patsubst %.cpp,$(OUT_DIR)/%.d,$(BUILD_FILES)) build: $(OBJ) -CXXARGS := $(foreach dir,$(INCLUDE_DIRS),-I$(SRC_DIR)/$(dir)) $(foreach dir,$(SYSTEM_INCLUDE_DIRS),-I$(dir)) $(CXXFLAGS) - $(OUT_DIR)/%.o: $(SRC_DIR)/%.cpp - mkdir -p $(dir $@) - $(CLANG) $< $(CXXARGS) -c -o $@ + @mkdir -p $(dir $@) + @echo "CC $<" + @$(CLANG) $< $(CXXARGS) -c -o $@ $(OUT_DIR)/%.d: $(SRC_DIR)/%.cpp - mkdir -p $(dir $@) - $(CLANG) $(CXXARGS) $< -MM -MT $(OUT_DIR)/$(patsubst %.cpp,%.o,$<) -o $@ + @mkdir -p $(dir $@) + @$(CLANG) $(CXXARGS) $< -MM -MT $(OUT_DIR)/$(patsubst %.cpp,%.o,$<) -o $@ # TIDY TIDY_FILES_AUTO := $(shell find -L $(SRC_DIR) -not -path '*/\.*' -not -path '*/tests/test_include/*' \( -path '*.cpp' -o -path '*.h' \)) @@ -123,7 +128,7 @@ TIDY_ARGS_COARSE := --checks="$(subst $(space),$(comma),$(strip $(TIDY_CHECKS_CO define process-tidy _TARG := $(OUT_DIR)/$1.tidy.ts -_DEP := $(SRC_DIR)/$1 +_DEP := $1 TIDY_DEPS += $(_TARG) @@ -137,9 +142,10 @@ $$(_TARG): _DEP := $$(_DEP) $$(_TARG): _TARG := $$(_TARG) $$(_TARG): TIDY_ARGS := $$(TIDY_ARGS) $$(_TARG): $$(_DEP) - mkdir -p $$(dir $$(_TARG)) - $$(CLANG_TIDY) $$(_DEP) $$(TIDY_ARGS) -- -x c++ $$(CXXARGS) -Wno-pragma-once-outside-header - touch $$(_TARG) + @mkdir -p $$(dir $$(_TARG)) + @echo "TIDY $$<" + @$$(CLANG_TIDY) $$(_DEP) $$(TIDY_ARGS) --quiet -- -x c++ $$(CXXARGS) -Wno-pragma-once-outside-header + @touch $$(_TARG) endef diff --git a/.ci/android_headers/cutils/compiler.h b/.ci/android_headers/cutils/compiler.h deleted file mode 100644 index 5754666..0000000 --- a/.ci/android_headers/cutils/compiler.h +++ /dev/null @@ -1,45 +0,0 @@ -// clang-format off -/* - * Copyright (C) 2009 The Android Open Source Project - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -#ifndef ANDROID_CUTILS_COMPILER_H -#define ANDROID_CUTILS_COMPILER_H - -/* - * helps the compiler's optimizer predicting branches - */ - -#ifdef __cplusplus -# define CC_LIKELY( exp ) (__builtin_expect( !!(exp), true )) -# define CC_UNLIKELY( exp ) (__builtin_expect( !!(exp), false )) -#else -# define CC_LIKELY( exp ) (__builtin_expect( !!(exp), 1 )) -# define CC_UNLIKELY( exp ) (__builtin_expect( !!(exp), 0 )) -#endif - -/** - * exports marked symbols - * - * if used on a C++ class declaration, this macro must be inserted - * after the "class" keyword. For instance: - * - * template <typename TYPE> - * class ANDROID_API Singleton { } - */ - -#define ANDROID_API __attribute__((visibility("default"))) - -#endif // ANDROID_CUTILS_COMPILER_H diff --git a/.ci/android_headers/cutils/native_handle.h b/.ci/android_headers/cutils/native_handle.h deleted file mode 100644 index 4f500f6..0000000 --- a/.ci/android_headers/cutils/native_handle.h +++ /dev/null @@ -1,107 +0,0 @@ -// clang-format off -/* - * Copyright (C) 2009 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 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 - * - * closes the file descriptors contained in this native_handle_t - * - * return 0 on success, or a negative error code on failure - * - */ -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 - * - * creates a native_handle_t and initializes it. must be destroyed with - * native_handle_delete(). Note that numFds must be <= NATIVE_HANDLE_MAX_FDS, - * numInts must be <= NATIVE_HANDLE_MAX_INTS, and both must be >= 0. - * - */ -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 - * - * frees a native_handle_t allocated with native_handle_create(). - * This ONLY frees the memory allocated for the native_handle_t, but doesn't - * close the file descriptors; which can be achieved with native_handle_close(). - * - * return 0 on success, or a negative error code on failure - * - */ -int native_handle_delete(native_handle_t* h); - - -#ifdef __cplusplus -} -#endif - -#endif /* NATIVE_HANDLE_H_ */ diff --git a/.ci/android_headers/cutils/trace.h b/.ci/android_headers/cutils/trace.h deleted file mode 100644 index 54265a7..0000000 --- a/.ci/android_headers/cutils/trace.h +++ /dev/null @@ -1,247 +0,0 @@ -// clang-format off -/* - * Copyright (C) 2012 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 _LIBS_CUTILS_TRACE_H -#define _LIBS_CUTILS_TRACE_H - -#include <inttypes.h> -#include <stdatomic.h> -#include <stdbool.h> -#include <stdint.h> -#include <stdio.h> -#include <sys/cdefs.h> -#include <sys/types.h> -#include <unistd.h> -#include <cutils/compiler.h> - -__BEGIN_DECLS - -/** - * The ATRACE_TAG macro can be defined before including this header to trace - * using one of the tags defined below. It must be defined to one of the - * following ATRACE_TAG_* macros. The trace tag is used to filter tracing in - * userland to avoid some of the runtime cost of tracing when it is not desired. - * - * Defining ATRACE_TAG to be ATRACE_TAG_ALWAYS will result in the tracing always - * being enabled - this should ONLY be done for debug code, as userland tracing - * has a performance cost even when the trace is not being recorded. Defining - * ATRACE_TAG to be ATRACE_TAG_NEVER or leaving ATRACE_TAG undefined will result - * in the tracing always being disabled. - * - * ATRACE_TAG_HAL should be bitwise ORed with the relevant tags for tracing - * within a hardware module. For example a camera hardware module would set: - * #define ATRACE_TAG (ATRACE_TAG_CAMERA | ATRACE_TAG_HAL) - * - * Keep these in sync with frameworks/base/core/java/android/os/Trace.java. - */ -#define ATRACE_TAG_NEVER 0 // This tag is never enabled. -#define ATRACE_TAG_ALWAYS (1<<0) // This tag is always enabled. -#define ATRACE_TAG_GRAPHICS (1<<1) -#define ATRACE_TAG_INPUT (1<<2) -#define ATRACE_TAG_VIEW (1<<3) -#define ATRACE_TAG_WEBVIEW (1<<4) -#define ATRACE_TAG_WINDOW_MANAGER (1<<5) -#define ATRACE_TAG_ACTIVITY_MANAGER (1<<6) -#define ATRACE_TAG_SYNC_MANAGER (1<<7) -#define ATRACE_TAG_AUDIO (1<<8) -#define ATRACE_TAG_VIDEO (1<<9) -#define ATRACE_TAG_CAMERA (1<<10) -#define ATRACE_TAG_HAL (1<<11) -#define ATRACE_TAG_APP (1<<12) -#define ATRACE_TAG_RESOURCES (1<<13) -#define ATRACE_TAG_DALVIK (1<<14) -#define ATRACE_TAG_RS (1<<15) -#define ATRACE_TAG_BIONIC (1<<16) -#define ATRACE_TAG_POWER (1<<17) -#define ATRACE_TAG_PACKAGE_MANAGER (1<<18) -#define ATRACE_TAG_SYSTEM_SERVER (1<<19) -#define ATRACE_TAG_DATABASE (1<<20) -#define ATRACE_TAG_NETWORK (1<<21) -#define ATRACE_TAG_ADB (1<<22) -#define ATRACE_TAG_VIBRATOR (1<<23) -#define ATRACE_TAG_AIDL (1<<24) -#define ATRACE_TAG_NNAPI (1<<25) -#define ATRACE_TAG_RRO (1<<26) -#define ATRACE_TAG_LAST ATRACE_TAG_RRO - -// Reserved for initialization. -#define ATRACE_TAG_NOT_READY (1ULL<<63) - -#define ATRACE_TAG_VALID_MASK ((ATRACE_TAG_LAST - 1) | ATRACE_TAG_LAST) - -#ifndef ATRACE_TAG -#define ATRACE_TAG ATRACE_TAG_NEVER -#elif ATRACE_TAG > ATRACE_TAG_VALID_MASK -#error ATRACE_TAG must be defined to be one of the tags defined in cutils/trace.h -#endif - -/** - * Opens the trace file for writing and reads the property for initial tags. - * The atrace.tags.enableflags property sets the tags to trace. - * This function should not be explicitly called, the first call to any normal - * trace function will cause it to be run safely. - */ -void atrace_setup(); - -/** - * If tracing is ready, set atrace_enabled_tags to the system property - * debug.atrace.tags.enableflags. Can be used as a sysprop change callback. - */ -void atrace_update_tags(); - -/** - * Set whether the process is debuggable. By default the process is not - * considered debuggable. If the process is not debuggable then application- - * level tracing is not allowed unless the ro.debuggable system property is - * set to '1'. - */ -void atrace_set_debuggable(bool debuggable); - -/** - * Set whether tracing is enabled for the current process. This is used to - * prevent tracing within the Zygote process. - */ -void atrace_set_tracing_enabled(bool enabled); - -/** - * This is always set to false. This forces code that uses an old version - * of this header to always call into atrace_setup, in which we call - * atrace_init unconditionally. - */ -extern atomic_bool atrace_is_ready; - -/** - * Set of ATRACE_TAG flags to trace for, initialized to ATRACE_TAG_NOT_READY. - * A value of zero indicates setup has failed. - * Any other nonzero value indicates setup has succeeded, and tracing is on. - */ -extern uint64_t atrace_enabled_tags; - -/** - * Handle to the kernel's trace buffer, initialized to -1. - * Any other value indicates setup has succeeded, and is a valid fd for tracing. - */ -extern int atrace_marker_fd; - -/** - * atrace_init readies the process for tracing by opening the trace_marker file. - * Calling any trace function causes this to be run, so calling it is optional. - * This can be explicitly run to avoid setup delay on first trace function. - */ -#define ATRACE_INIT() atrace_init() -#define ATRACE_GET_ENABLED_TAGS() atrace_get_enabled_tags() - -void atrace_init(); -uint64_t atrace_get_enabled_tags(); - -/** - * Test if a given tag is currently enabled. - * Returns nonzero if the tag is enabled, otherwise zero. - * It can be used as a guard condition around more expensive trace calculations. - */ -#define ATRACE_ENABLED() atrace_is_tag_enabled(ATRACE_TAG) -static inline uint64_t atrace_is_tag_enabled(uint64_t tag) -{ - return atrace_get_enabled_tags() & tag; -} - -/** - * Trace the beginning of a context. name is used to identify the context. - * This is often used to time function execution. - */ -#define ATRACE_BEGIN(name) atrace_begin(ATRACE_TAG, name) -static inline void atrace_begin(uint64_t tag, const char* name) -{ - if (CC_UNLIKELY(atrace_is_tag_enabled(tag))) { - void atrace_begin_body(const char*); - atrace_begin_body(name); - } -} - -/** - * Trace the end of a context. - * This should match up (and occur after) a corresponding ATRACE_BEGIN. - */ -#define ATRACE_END() atrace_end(ATRACE_TAG) -static inline void atrace_end(uint64_t tag) -{ - if (CC_UNLIKELY(atrace_is_tag_enabled(tag))) { - void atrace_end_body(); - atrace_end_body(); - } -} - -/** - * Trace the beginning of an asynchronous event. Unlike ATRACE_BEGIN/ATRACE_END - * contexts, asynchronous events do not need to be nested. The name describes - * the event, and the cookie provides a unique identifier for distinguishing - * simultaneous events. The name and cookie used to begin an event must be - * used to end it. - */ -#define ATRACE_ASYNC_BEGIN(name, cookie) \ - atrace_async_begin(ATRACE_TAG, name, cookie) -static inline void atrace_async_begin(uint64_t tag, const char* name, - int32_t cookie) -{ - if (CC_UNLIKELY(atrace_is_tag_enabled(tag))) { - void atrace_async_begin_body(const char*, int32_t); - atrace_async_begin_body(name, cookie); - } -} - -/** - * Trace the end of an asynchronous event. - * This should have a corresponding ATRACE_ASYNC_BEGIN. - */ -#define ATRACE_ASYNC_END(name, cookie) atrace_async_end(ATRACE_TAG, name, cookie) -static inline void atrace_async_end(uint64_t tag, const char* name, int32_t cookie) -{ - if (CC_UNLIKELY(atrace_is_tag_enabled(tag))) { - void atrace_async_end_body(const char*, int32_t); - atrace_async_end_body(name, cookie); - } -} - -/** - * Traces an integer counter value. name is used to identify the counter. - * This can be used to track how a value changes over time. - */ -#define ATRACE_INT(name, value) atrace_int(ATRACE_TAG, name, value) -static inline void atrace_int(uint64_t tag, const char* name, int32_t value) -{ - if (CC_UNLIKELY(atrace_is_tag_enabled(tag))) { - void atrace_int_body(const char*, int32_t); - atrace_int_body(name, value); - } -} - -/** - * Traces a 64-bit integer counter value. name is used to identify the - * counter. This can be used to track how a value changes over time. - */ -#define ATRACE_INT64(name, value) atrace_int64(ATRACE_TAG, name, value) -static inline void atrace_int64(uint64_t tag, const char* name, int64_t value) -{ - if (CC_UNLIKELY(atrace_is_tag_enabled(tag))) { - void atrace_int64_body(const char*, int64_t); - atrace_int64_body(name, value); - } -} - -__END_DECLS - -#endif // _LIBS_CUTILS_TRACE_H diff --git a/.ci/android_headers/gralloc_handle.h b/.ci/android_headers/gralloc_handle.h deleted file mode 100644 index 4a7c9dd..0000000 --- a/.ci/android_headers/gralloc_handle.h +++ /dev/null @@ -1,112 +0,0 @@ -// clang-format off -/* - * Copyright (C) 2010-2011 Chia-I Wu <olvaffe@gmail.com> - * Copyright (C) 2010-2011 LunarG Inc. - * Copyright (C) 2016 Linaro, Ltd., Rob Herring <robh@kernel.org> - * Copyright (C) 2018 Collabora, Robert Foss <robert.foss@collabora.com> - * - * Permission is hereby granted, free of charge, to any person obtaining a - * copy of this software and associated documentation files (the "Software"), - * to deal in the Software without restriction, including without limitation - * the rights to use, copy, modify, merge, publish, distribute, sublicense, - * and/or sell copies of the Software, and to permit persons to whom the - * Software is furnished to do so, subject to the following conditions: - * - * The above copyright notice and this permission notice shall be included - * in all copies or substantial portions of the Software. - * - * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR - * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, - * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL - * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER - * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING - * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER - * DEALINGS IN THE SOFTWARE. - */ - -#ifndef __ANDROID_GRALLOC_HANDLE_H__ -#define __ANDROID_GRALLOC_HANDLE_H__ - -#include <cutils/native_handle.h> -#include <stdint.h> - -/* support users of drm_gralloc/gbm_gralloc */ -#define gralloc_gbm_handle_t gralloc_handle_t -#define gralloc_drm_handle_t gralloc_handle_t - -struct gralloc_handle_t { - native_handle_t base; - - /* dma-buf file descriptor - * Must be located first since, native_handle_t is allocated - * using native_handle_create(), which allocates space for - * sizeof(native_handle_t) + sizeof(int) * (numFds + numInts) - * numFds = GRALLOC_HANDLE_NUM_FDS - * numInts = GRALLOC_HANDLE_NUM_INTS - * Where numFds represents the number of FDs and - * numInts represents the space needed for the - * remainder of this struct. - * And the FDs are expected to be found first following - * native_handle_t. - */ - int prime_fd; - - /* api variables */ - uint32_t magic; /* differentiate between allocator impls */ - uint32_t version; /* api version */ - - uint32_t width; /* width of buffer in pixels */ - uint32_t height; /* height of buffer in pixels */ - uint32_t format; /* pixel format (Android) */ - uint32_t usage; /* android libhardware usage flags */ - - uint32_t stride; /* the stride in bytes */ - int data_owner; /* owner of data (for validation) */ - uint64_t modifier __attribute__((aligned(8))); /* buffer modifiers */ - - union { - void *data; /* pointer to struct gralloc_gbm_bo_t */ - uint64_t reserved; - } __attribute__((aligned(8))); -}; - -#define GRALLOC_HANDLE_VERSION 4 -#define GRALLOC_HANDLE_MAGIC 0x60585350 -#define GRALLOC_HANDLE_NUM_FDS 1 -#define GRALLOC_HANDLE_NUM_INTS ( \ - ((sizeof(struct gralloc_handle_t) - sizeof(native_handle_t))/sizeof(int)) \ - - GRALLOC_HANDLE_NUM_FDS) - -static inline struct gralloc_handle_t *gralloc_handle(buffer_handle_t handle) -{ - return (struct gralloc_handle_t *)handle; -} - -/** - * Create a buffer handle. - */ -static inline native_handle_t *gralloc_handle_create(int32_t width, - int32_t height, - int32_t hal_format, - int32_t usage) -{ - struct gralloc_handle_t *handle; - native_handle_t *nhandle = native_handle_create(GRALLOC_HANDLE_NUM_FDS, - GRALLOC_HANDLE_NUM_INTS); - - if (!nhandle) - return NULL; - - handle = gralloc_handle(nhandle); - handle->magic = GRALLOC_HANDLE_MAGIC; - handle->version = GRALLOC_HANDLE_VERSION; - handle->width = width; - handle->height = height; - handle->format = hal_format; - handle->usage = usage; - handle->prime_fd = -1; - - return nhandle; -} - -#endif diff --git a/.ci/android_headers/hardware/gralloc.h b/.ci/android_headers/hardware/gralloc.h deleted file mode 100644 index 260140e..0000000 --- a/.ci/android_headers/hardware/gralloc.h +++ /dev/null @@ -1,451 +0,0 @@ -// clang-format off -/* - * Copyright (C) 2008 The Android Open Source Project - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - - -#ifndef ANDROID_GRALLOC_INTERFACE_H -#define ANDROID_GRALLOC_INTERFACE_H - -#include <system/graphics.h> -#include <hardware/hardware.h> - -#include <stdint.h> -#include <sys/cdefs.h> -#include <sys/types.h> - -#include <cutils/native_handle.h> - -#include <hardware/hardware.h> -#if 0 /* Header below is not used by drm_hwcomposer */ -#include <hardware/fb.h> -#endif - -__BEGIN_DECLS - -/** - * Module versioning information for the Gralloc hardware module, based on - * gralloc_module_t.common.module_api_version. - * - * Version History: - * - * GRALLOC_MODULE_API_VERSION_0_1: - * Initial Gralloc hardware module API. - * - * GRALLOC_MODULE_API_VERSION_0_2: - * Add support for flexible YCbCr format with (*lock_ycbcr)() method. - * - * GRALLOC_MODULE_API_VERSION_0_3: - * Add support for fence passing to/from lock/unlock. - */ - -#define GRALLOC_MODULE_API_VERSION_0_1 HARDWARE_MODULE_API_VERSION(0, 1) -#define GRALLOC_MODULE_API_VERSION_0_2 HARDWARE_MODULE_API_VERSION(0, 2) -#define GRALLOC_MODULE_API_VERSION_0_3 HARDWARE_MODULE_API_VERSION(0, 3) - -#define GRALLOC_DEVICE_API_VERSION_0_1 HARDWARE_DEVICE_API_VERSION(0, 1) - -/** - * The id of this module - */ -#define GRALLOC_HARDWARE_MODULE_ID "gralloc" - -/** - * Name of the graphics device to open - */ - -#define GRALLOC_HARDWARE_GPU0 "gpu0" - -enum { - /* buffer is never read in software */ - GRALLOC_USAGE_SW_READ_NEVER = 0x00000000U, - /* buffer is rarely read in software */ - GRALLOC_USAGE_SW_READ_RARELY = 0x00000002U, - /* buffer is often read in software */ - GRALLOC_USAGE_SW_READ_OFTEN = 0x00000003U, - /* mask for the software read values */ - GRALLOC_USAGE_SW_READ_MASK = 0x0000000FU, - - /* buffer is never written in software */ - GRALLOC_USAGE_SW_WRITE_NEVER = 0x00000000U, - /* buffer is rarely written in software */ - GRALLOC_USAGE_SW_WRITE_RARELY = 0x00000020U, - /* buffer is often written in software */ - GRALLOC_USAGE_SW_WRITE_OFTEN = 0x00000030U, - /* mask for the software write values */ - GRALLOC_USAGE_SW_WRITE_MASK = 0x000000F0U, - - /* buffer will be used as an OpenGL ES texture */ - GRALLOC_USAGE_HW_TEXTURE = 0x00000100U, - /* buffer will be used as an OpenGL ES render target */ - GRALLOC_USAGE_HW_RENDER = 0x00000200U, - /* buffer will be used by the 2D hardware blitter */ - GRALLOC_USAGE_HW_2D = 0x00000400U, - /* buffer will be used by the HWComposer HAL module */ - GRALLOC_USAGE_HW_COMPOSER = 0x00000800U, - /* buffer will be used with the framebuffer device */ - GRALLOC_USAGE_HW_FB = 0x00001000U, - - /* buffer should be displayed full-screen on an external display when - * possible */ - 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 = 0x00004000U, - - /* buffer may be used as a cursor */ - GRALLOC_USAGE_CURSOR = 0x00008000U, - - /* buffer will be used with the HW video encoder */ - GRALLOC_USAGE_HW_VIDEO_ENCODER = 0x00010000U, - /* buffer will be written by the HW camera pipeline */ - GRALLOC_USAGE_HW_CAMERA_WRITE = 0x00020000U, - /* buffer will be read by the HW camera pipeline */ - GRALLOC_USAGE_HW_CAMERA_READ = 0x00040000U, - /* buffer will be used as part of zero-shutter-lag queue */ - GRALLOC_USAGE_HW_CAMERA_ZSL = 0x00060000U, - /* mask for the camera access values */ - GRALLOC_USAGE_HW_CAMERA_MASK = 0x00060000U, - /* mask for the software usage bit-mask */ - GRALLOC_USAGE_HW_MASK = 0x00071F00U, - - /* buffer will be used as a RenderScript Allocation */ - 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 = 0x00200000U, - - /* buffer will be used as input to HW HEIC image encoder */ - GRALLOC_USAGE_HW_IMAGE_ENCODER = 0x08000000U, - - /* 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 - * gralloc modules. */ - GRALLOC_USAGE_ALLOC_MASK = ~(GRALLOC_USAGE_FOREIGN_BUFFERS), - - /* implementation-specific private usage flags */ - 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, -}; - -/*****************************************************************************/ - -/** - * Every hardware module must have a data structure named HAL_MODULE_INFO_SYM - * and the fields of this data structure must begin with hw_module_t - * followed by module specific information. - */ -typedef struct gralloc_module_t { - struct hw_module_t common; - - /* - * (*registerBuffer)() must be called before a buffer_handle_t that has not - * been created with (*alloc_device_t::alloc)() can be used. - * - * This is intended to be used with buffer_handle_t's that have been - * received in this process through IPC. - * - * This function checks that the handle is indeed a valid one and prepares - * it for use with (*lock)() and (*unlock)(). - * - * It is not necessary to call (*registerBuffer)() on a handle created - * with (*alloc_device_t::alloc)(). - * - * returns an error if this buffer_handle_t is not valid. - */ - int (*registerBuffer)(struct gralloc_module_t const* module, - buffer_handle_t handle); - - /* - * (*unregisterBuffer)() is called once this handle is no longer needed in - * this process. After this call, it is an error to call (*lock)(), - * (*unlock)(), or (*registerBuffer)(). - * - * This function doesn't close or free the handle itself; this is done - * by other means, usually through libcutils's native_handle_close() and - * native_handle_free(). - * - * It is an error to call (*unregisterBuffer)() on a buffer that wasn't - * explicitly registered first. - */ - int (*unregisterBuffer)(struct gralloc_module_t const* module, - buffer_handle_t handle); - - /* - * The (*lock)() method is called before a buffer is accessed for the - * specified usage. This call may block, for instance if the h/w needs - * to finish rendering or if CPU caches need to be synchronized. - * - * The caller promises to modify only pixels in the area specified - * by (l,t,w,h). - * - * The content of the buffer outside of the specified area is NOT modified - * by this call. - * - * If usage specifies GRALLOC_USAGE_SW_*, vaddr is filled with the address - * of the buffer in virtual memory. - * - * Note calling (*lock)() on HAL_PIXEL_FORMAT_YCbCr_*_888 buffers will fail - * and return -EINVAL. These buffers must be locked with (*lock_ycbcr)() - * instead. - * - * THREADING CONSIDERATIONS: - * - * It is legal for several different threads to lock a buffer from - * read access, none of the threads are blocked. - * - * However, locking a buffer simultaneously for write or read/write is - * undefined, but: - * - shall not result in termination of the process - * - shall not block the caller - * It is acceptable to return an error or to leave the buffer's content - * into an indeterminate state. - * - * If the buffer was created with a usage mask incompatible with the - * requested usage flags here, -EINVAL is returned. - * - */ - - int (*lock)(struct gralloc_module_t const* module, - buffer_handle_t handle, int usage, - int l, int t, int w, int h, - void** vaddr); - - - /* - * The (*unlock)() method must be called after all changes to the buffer - * are completed. - */ - - int (*unlock)(struct gralloc_module_t const* module, - buffer_handle_t handle); - - - /* reserved for future use */ - int (*perform)(struct gralloc_module_t const* module, - int operation, ... ); - - /* - * The (*lock_ycbcr)() method is like the (*lock)() method, with the - * difference that it fills a struct ycbcr with a description of the buffer - * layout, and zeroes out the reserved fields. - * - * If the buffer format is not compatible with a flexible YUV format (e.g. - * the buffer layout cannot be represented with the ycbcr struct), it - * will return -EINVAL. - * - * This method must work on buffers with HAL_PIXEL_FORMAT_YCbCr_*_888 - * if supported by the device, as well as with any other format that is - * requested by the multimedia codecs when they are configured with a - * flexible-YUV-compatible color-format with android native buffers. - * - * Note that this method may also be called on buffers of other formats, - * including non-YUV formats. - * - * Added in GRALLOC_MODULE_API_VERSION_0_2. - */ - - int (*lock_ycbcr)(struct gralloc_module_t const* module, - buffer_handle_t handle, int usage, - int l, int t, int w, int h, - struct android_ycbcr *ycbcr); - - /* - * The (*lockAsync)() method is like the (*lock)() method except - * that the buffer's sync fence object is passed into the lock - * call instead of requiring the caller to wait for completion. - * - * The gralloc implementation takes ownership of the fenceFd and - * is responsible for closing it when no longer needed. - * - * Added in GRALLOC_MODULE_API_VERSION_0_3. - */ - int (*lockAsync)(struct gralloc_module_t const* module, - buffer_handle_t handle, int usage, - int l, int t, int w, int h, - void** vaddr, int fenceFd); - - /* - * The (*unlockAsync)() method is like the (*unlock)() method - * except that a buffer sync fence object is returned from the - * lock call, representing the completion of any pending work - * performed by the gralloc implementation. - * - * The caller takes ownership of the fenceFd and is responsible - * for closing it when no longer needed. - * - * Added in GRALLOC_MODULE_API_VERSION_0_3. - */ - int (*unlockAsync)(struct gralloc_module_t const* module, - buffer_handle_t handle, int* fenceFd); - - /* - * The (*lockAsync_ycbcr)() method is like the (*lock_ycbcr)() - * method except that the buffer's sync fence object is passed - * into the lock call instead of requiring the caller to wait for - * completion. - * - * The gralloc implementation takes ownership of the fenceFd and - * is responsible for closing it when no longer needed. - * - * Added in GRALLOC_MODULE_API_VERSION_0_3. - */ - int (*lockAsync_ycbcr)(struct gralloc_module_t const* module, - buffer_handle_t handle, int usage, - int l, int t, int w, int h, - struct android_ycbcr *ycbcr, int fenceFd); - - /* getTransportSize(..., outNumFds, outNumInts) - * This function is mandatory on devices running IMapper2.1 or higher. - * - * Get the transport size of a buffer. An imported buffer handle is a raw - * buffer handle with the process-local runtime data appended. This - * function, for example, allows a caller to omit the process-local - * runtime data at the tail when serializing the imported buffer handle. - * - * Note that a client might or might not omit the process-local runtime - * data when sending an imported buffer handle. The mapper must support - * both cases on the receiving end. - */ - int32_t (*getTransportSize)( - struct gralloc_module_t const* module, buffer_handle_t handle, uint32_t *outNumFds, - uint32_t *outNumInts); - - /* validateBufferSize(..., w, h, format, usage, stride) - * This function is mandatory on devices running IMapper2.1 or higher. - * - * Validate that the buffer can be safely accessed by a caller who assumes - * the specified width, height, format, usage, and stride. This must at least validate - * that the buffer size is large enough. Validating the buffer against - * individual buffer attributes is optional. - */ - int32_t (*validateBufferSize)( - struct gralloc_module_t const* device, buffer_handle_t handle, - uint32_t w, uint32_t h, int32_t format, int usage, - uint32_t stride); - - /* reserved for future use */ - void* reserved_proc[1]; - -} gralloc_module_t; - -/*****************************************************************************/ - -/** - * Every device data structure must begin with hw_device_t - * followed by module specific public methods and attributes. - */ - -typedef struct alloc_device_t { - struct hw_device_t common; - - /* - * (*alloc)() Allocates a buffer in graphic memory with the requested - * parameters and returns a buffer_handle_t and the stride in pixels to - * allow the implementation to satisfy hardware constraints on the width - * of a pixmap (eg: it may have to be multiple of 8 pixels). - * The CALLER TAKES OWNERSHIP of the buffer_handle_t. - * - * If format is HAL_PIXEL_FORMAT_YCbCr_420_888, the returned stride must be - * 0, since the actual strides are available from the android_ycbcr - * structure. - * - * Returns 0 on success or -errno on error. - */ - - int (*alloc)(struct alloc_device_t* dev, - int w, int h, int format, int usage, - buffer_handle_t* handle, int* stride); - - /* - * (*free)() Frees a previously allocated buffer. - * Behavior is undefined if the buffer is still mapped in any process, - * but shall not result in termination of the program or security breaches - * (allowing a process to get access to another process' buffers). - * THIS FUNCTION TAKES OWNERSHIP of the buffer_handle_t which becomes - * invalid after the call. - * - * Returns 0 on success or -errno on error. - */ - int (*free)(struct alloc_device_t* dev, - buffer_handle_t handle); - - /* This hook is OPTIONAL. - * - * If non NULL it will be caused by SurfaceFlinger on dumpsys - */ - void (*dump)(struct alloc_device_t *dev, char *buff, int buff_len); - - void* reserved_proc[7]; -} alloc_device_t; - - -/** convenience API for opening and closing a supported device */ - -static inline int gralloc_open(const struct hw_module_t* module, - struct alloc_device_t** device) { - return module->methods->open(module, - 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/.ci/android_headers/hardware/hardware.h b/.ci/android_headers/hardware/hardware.h deleted file mode 100644 index a6d9ad9..0000000 --- a/.ci/android_headers/hardware/hardware.h +++ /dev/null @@ -1,245 +0,0 @@ -// clang-format off -/* - * Copyright (C) 2008 The Android Open Source Project - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -#ifndef ANDROID_INCLUDE_HARDWARE_HARDWARE_H -#define ANDROID_INCLUDE_HARDWARE_HARDWARE_H - -#include <stdint.h> -#include <sys/cdefs.h> - -#include <cutils/native_handle.h> -#include <system/graphics.h> - -__BEGIN_DECLS - -/* - * Value for the hw_module_t.tag field - */ - -#define MAKE_TAG_CONSTANT(A,B,C,D) (((A) << 24) | ((B) << 16) | ((C) << 8) | (D)) - -#define HARDWARE_MODULE_TAG MAKE_TAG_CONSTANT('H', 'W', 'M', 'T') -#define HARDWARE_DEVICE_TAG MAKE_TAG_CONSTANT('H', 'W', 'D', 'T') - -#define HARDWARE_MAKE_API_VERSION(maj,min) \ - ((((maj) & 0xff) << 8) | ((min) & 0xff)) - -#define HARDWARE_MAKE_API_VERSION_2(maj,min,hdr) \ - ((((maj) & 0xff) << 24) | (((min) & 0xff) << 16) | ((hdr) & 0xffff)) -#define HARDWARE_API_VERSION_2_MAJ_MIN_MASK 0xffff0000 -#define HARDWARE_API_VERSION_2_HEADER_MASK 0x0000ffff - - -/* - * The current HAL API version. - * - * All module implementations must set the hw_module_t.hal_api_version field - * to this value when declaring the module with HAL_MODULE_INFO_SYM. - * - * Note that previous implementations have always set this field to 0. - * Therefore, libhardware HAL API will always consider versions 0.0 and 1.0 - * to be 100% binary compatible. - * - */ -#define HARDWARE_HAL_API_VERSION HARDWARE_MAKE_API_VERSION(1, 0) - -/* - * Helper macros for module implementors. - * - * The derived modules should provide convenience macros for supported - * versions so that implementations can explicitly specify module/device - * versions at definition time. - * - * Use this macro to set the hw_module_t.module_api_version field. - */ -#define HARDWARE_MODULE_API_VERSION(maj,min) HARDWARE_MAKE_API_VERSION(maj,min) -#define HARDWARE_MODULE_API_VERSION_2(maj,min,hdr) HARDWARE_MAKE_API_VERSION_2(maj,min,hdr) - -/* - * Use this macro to set the hw_device_t.version field - */ -#define HARDWARE_DEVICE_API_VERSION(maj,min) HARDWARE_MAKE_API_VERSION(maj,min) -#define HARDWARE_DEVICE_API_VERSION_2(maj,min,hdr) HARDWARE_MAKE_API_VERSION_2(maj,min,hdr) - -struct hw_module_t; -struct hw_module_methods_t; -struct hw_device_t; - -/** - * Every hardware module must have a data structure named HAL_MODULE_INFO_SYM - * and the fields of this data structure must begin with hw_module_t - * followed by module specific information. - */ -typedef struct hw_module_t { - /** tag must be initialized to HARDWARE_MODULE_TAG */ - uint32_t tag; - - /** - * The API version of the implemented module. The module owner is - * responsible for updating the version when a module interface has - * changed. - * - * The derived modules such as gralloc and audio own and manage this field. - * The module user must interpret the version field to decide whether or - * not to inter-operate with the supplied module implementation. - * For example, SurfaceFlinger is responsible for making sure that - * it knows how to manage different versions of the gralloc-module API, - * and AudioFlinger must know how to do the same for audio-module API. - * - * The module API version should include a major and a minor component. - * For example, version 1.0 could be represented as 0x0100. This format - * implies that versions 0x0100-0x01ff are all API-compatible. - * - * In the future, libhardware will expose a hw_get_module_version() - * (or equivalent) function that will take minimum/maximum supported - * versions as arguments and would be able to reject modules with - * versions outside of the supplied range. - */ - uint16_t module_api_version; -#define version_major module_api_version - /** - * version_major/version_minor defines are supplied here for temporary - * source code compatibility. They will be removed in the next version. - * ALL clients must convert to the new version format. - */ - - /** - * The API version of the HAL module interface. This is meant to - * version the hw_module_t, hw_module_methods_t, and hw_device_t - * structures and definitions. - * - * The HAL interface owns this field. Module users/implementations - * must NOT rely on this value for version information. - * - * Presently, 0 is the only valid value. - */ - uint16_t hal_api_version; -#define version_minor hal_api_version - - /** Identifier of module */ - const char *id; - - /** Name of this module */ - const char *name; - - /** Author/owner/implementor of the module */ - const char *author; - - /** Modules methods */ - struct hw_module_methods_t* methods; - - /** module's dso */ - void* dso; - -#ifdef __LP64__ - uint64_t reserved[32-7]; -#else - /** padding to 128 bytes, reserved for future use */ - uint32_t reserved[32-7]; -#endif - -} hw_module_t; - -typedef struct hw_module_methods_t { - /** Open a specific device */ - int (*open)(const struct hw_module_t* module, const char* id, - struct hw_device_t** device); - -} hw_module_methods_t; - -/** - * Every device data structure must begin with hw_device_t - * followed by module specific public methods and attributes. - */ -typedef struct hw_device_t { - /** tag must be initialized to HARDWARE_DEVICE_TAG */ - uint32_t tag; - - /** - * Version of the module-specific device API. This value is used by - * the derived-module user to manage different device implementations. - * - * The module user is responsible for checking the module_api_version - * and device version fields to ensure that the user is capable of - * communicating with the specific module implementation. - * - * One module can support multiple devices with different versions. This - * can be useful when a device interface changes in an incompatible way - * but it is still necessary to support older implementations at the same - * time. One such example is the Camera 2.0 API. - * - * This field is interpreted by the module user and is ignored by the - * HAL interface itself. - */ - uint32_t version; - - /** reference to the module this device belongs to */ - struct hw_module_t* module; - - /** padding reserved for future use */ -#ifdef __LP64__ - uint64_t reserved[12]; -#else - uint32_t reserved[12]; -#endif - - /** Close this device */ - int (*close)(struct hw_device_t* device); - -} 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 - */ -#define HAL_MODULE_INFO_SYM HMI - -/** - * Name of the hal_module_info as a string - */ -#define HAL_MODULE_INFO_SYM_AS_STR "HMI" - -/** - * Get the module info associated with a module by id. - * - * @return: 0 == success, <0 == error and *module == NULL - */ -int hw_get_module(const char *id, const struct hw_module_t **module); - -/** - * Get the module info associated with a module instance by class 'class_id' - * and instance 'inst'. - * - * Some modules types necessitate multiple instances. For example audio supports - * multiple concurrent interfaces and thus 'audio' is the module class - * and 'primary' or 'a2dp' are module interfaces. This implies that the files - * providing these modules would be named audio.primary.<variant>.so and - * audio.a2dp.<variant>.so - * - * @return: 0 == success, <0 == error and *module == NULL - */ -int hw_get_module_by_class(const char *class_id, const char *inst, - const struct hw_module_t **module); - -__END_DECLS - -#endif /* ANDROID_INCLUDE_HARDWARE_HARDWARE_H */ diff --git a/.ci/android_headers/hardware/hwcomposer.h b/.ci/android_headers/hardware/hwcomposer.h deleted file mode 100644 index fd083d9..0000000 --- a/.ci/android_headers/hardware/hwcomposer.h +++ /dev/null @@ -1,799 +0,0 @@ -// clang-format off -/* - * Copyright (C) 2010 The Android Open Source Project - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -#ifndef ANDROID_INCLUDE_HARDWARE_HWCOMPOSER_H -#define ANDROID_INCLUDE_HARDWARE_HWCOMPOSER_H - -#include <stdint.h> -#include <sys/cdefs.h> - -#include <hardware/gralloc.h> -#include <hardware/hardware.h> -#include <cutils/native_handle.h> - -#include <hardware/hwcomposer_defs.h> - -__BEGIN_DECLS - -/*****************************************************************************/ - -/* for compatibility */ -#define HWC_MODULE_API_VERSION HWC_MODULE_API_VERSION_0_1 -#define HWC_DEVICE_API_VERSION HWC_DEVICE_API_VERSION_0_1 -#define HWC_API_VERSION HWC_DEVICE_API_VERSION - -/*****************************************************************************/ - -typedef struct hwc_layer_1 { - /* - * compositionType is used to specify this layer's type and is set by either - * the hardware composer implementation, or by the caller (see below). - * - * This field is always reset to HWC_BACKGROUND or HWC_FRAMEBUFFER - * before (*prepare)() is called when the HWC_GEOMETRY_CHANGED flag is - * also set, otherwise, this field is preserved between (*prepare)() - * calls. - * - * HWC_BACKGROUND - * Always set by the caller before calling (*prepare)(), this value - * indicates this is a special "background" layer. The only valid field - * is backgroundColor. - * The HWC can toggle this value to HWC_FRAMEBUFFER to indicate it CANNOT - * handle the background color. - * - * - * HWC_FRAMEBUFFER_TARGET - * Always set by the caller before calling (*prepare)(), this value - * indicates this layer is the framebuffer surface used as the target of - * OpenGL ES composition. If the HWC sets all other layers to HWC_OVERLAY - * or HWC_BACKGROUND, then no OpenGL ES composition will be done, and - * this layer should be ignored during set(). - * - * This flag (and the framebuffer surface layer) will only be used if the - * HWC version is HWC_DEVICE_API_VERSION_1_1 or higher. In older versions, - * the OpenGL ES target surface is communicated by the (dpy, sur) fields - * in hwc_compositor_device_1_t. - * - * This value cannot be set by the HWC implementation. - * - * - * HWC_FRAMEBUFFER - * Set by the caller before calling (*prepare)() ONLY when the - * HWC_GEOMETRY_CHANGED flag is also set. - * - * Set by the HWC implementation during (*prepare)(), this indicates - * that the layer will be drawn into the framebuffer using OpenGL ES. - * The HWC can toggle this value to HWC_OVERLAY to indicate it will - * handle the layer. - * - * - * HWC_OVERLAY - * Set by the HWC implementation during (*prepare)(), this indicates - * that the layer will be handled by the HWC (ie: it must not be - * composited with OpenGL ES). - * - * - * HWC_SIDEBAND - * Set by the caller before calling (*prepare)(), this value indicates - * the contents of this layer come from a sideband video stream. - * - * The h/w composer is responsible for receiving new image buffers from - * the stream at the appropriate time (e.g. synchronized to a separate - * audio stream), compositing them with the current contents of other - * layers, and displaying the resulting image. This happens - * independently of the normal prepare/set cycle. The prepare/set calls - * only happen when other layers change, or when properties of the - * sideband layer such as position or size change. - * - * If the h/w composer can't handle the layer as a sideband stream for - * some reason (e.g. unsupported scaling/blending/rotation, or too many - * sideband layers) it can set compositionType to HWC_FRAMEBUFFER in - * (*prepare)(). However, doing so will result in the layer being shown - * as a solid color since the platform is not currently able to composite - * sideband layers with the GPU. This may be improved in future - * versions of the platform. - * - * - * HWC_CURSOR_OVERLAY - * Set by the HWC implementation during (*prepare)(), this value - * indicates the layer's composition will now be handled by the HWC. - * Additionally, the client can now asynchronously update the on-screen - * position of this layer using the setCursorPositionAsync() api. - */ - int32_t compositionType; - - /* - * hints is bit mask set by the HWC implementation during (*prepare)(). - * It is preserved between (*prepare)() calls, unless the - * HWC_GEOMETRY_CHANGED flag is set, in which case it is reset to 0. - * - * see hwc_layer_t::hints - */ - uint32_t hints; - - /* see hwc_layer_t::flags */ - uint32_t flags; - - union { - /* color of the background. hwc_color_t.a is ignored */ - hwc_color_t backgroundColor; - - struct { - union { - /* When compositionType is HWC_FRAMEBUFFER, HWC_OVERLAY, - * HWC_FRAMEBUFFER_TARGET, this is the handle of the buffer to - * compose. This handle is guaranteed to have been allocated - * from gralloc using the GRALLOC_USAGE_HW_COMPOSER usage flag. - * If the layer's handle is unchanged across two consecutive - * prepare calls and the HWC_GEOMETRY_CHANGED flag is not set - * for the second call then the HWComposer implementation may - * assume that the contents of the buffer have not changed. */ - buffer_handle_t handle; - - /* When compositionType is HWC_SIDEBAND, this is the handle - * of the sideband video stream to compose. */ - const native_handle_t* sidebandStream; - }; - - /* transformation to apply to the buffer during composition */ - uint32_t transform; - - /* blending to apply during composition */ - int32_t blending; - - /* area of the source to consider, the origin is the top-left corner of - * the buffer. As of HWC_DEVICE_API_VERSION_1_3, sourceRect uses floats. - * If the h/w can't support a non-integer source crop rectangle, it should - * punt to OpenGL ES composition. - */ - union { - // crop rectangle in integer (pre HWC_DEVICE_API_VERSION_1_3) - hwc_rect_t sourceCropi; - hwc_rect_t sourceCrop; // just for source compatibility - // crop rectangle in floats (as of HWC_DEVICE_API_VERSION_1_3) - hwc_frect_t sourceCropf; - }; - - /* where to composite the sourceCrop onto the display. The sourceCrop - * is scaled using linear filtering to the displayFrame. The origin is the - * top-left corner of the screen. - */ - hwc_rect_t displayFrame; - - /* visible region in screen space. The origin is the - * top-left corner of the screen. - * The visible region INCLUDES areas overlapped by a translucent layer. - */ - hwc_region_t visibleRegionScreen; - - /* Sync fence object that will be signaled when the buffer's - * contents are available. May be -1 if the contents are already - * available. This field is only valid during set(), and should be - * ignored during prepare(). The set() call must not wait for the - * fence to be signaled before returning, but the HWC must wait for - * all buffers to be signaled before reading from them. - * - * HWC_FRAMEBUFFER layers will never have an acquire fence, since - * reads from them are complete before the framebuffer is ready for - * display. - * - * HWC_SIDEBAND layers will never have an acquire fence, since - * synchronization is handled through implementation-defined - * sideband mechanisms. - * - * The HWC takes ownership of the acquireFenceFd and is responsible - * for closing it when no longer needed. - */ - int acquireFenceFd; - - /* During set() the HWC must set this field to a file descriptor for - * a sync fence object that will signal after the HWC has finished - * reading from the buffer. The field is ignored by prepare(). Each - * layer should have a unique file descriptor, even if more than one - * refer to the same underlying fence object; this allows each to be - * closed independently. - * - * If buffer reads can complete at significantly different times, - * then using independent fences is preferred. For example, if the - * HWC handles some layers with a blit engine and others with - * overlays, then the blit layers can be reused immediately after - * the blit completes, but the overlay layers can't be reused until - * a subsequent frame has been displayed. - * - * Since HWC doesn't read from HWC_FRAMEBUFFER layers, it shouldn't - * produce a release fence for them. The releaseFenceFd will be -1 - * for these layers when set() is called. - * - * Since HWC_SIDEBAND buffers don't pass through the HWC client, - * the HWC shouldn't produce a release fence for them. The - * releaseFenceFd will be -1 for these layers when set() is called. - * - * The HWC client taks ownership of the releaseFenceFd and is - * responsible for closing it when no longer needed. - */ - int releaseFenceFd; - - /* - * Availability: HWC_DEVICE_API_VERSION_1_2 - * - * Alpha value applied to the whole layer. The effective - * value of each pixel is computed as: - * - * if (blending == HWC_BLENDING_PREMULT) - * pixel.rgb = pixel.rgb * planeAlpha / 255 - * pixel.a = pixel.a * planeAlpha / 255 - * - * Then blending proceeds as usual according to the "blending" - * field above. - * - * NOTE: planeAlpha applies to YUV layers as well: - * - * pixel.rgb = yuv_to_rgb(pixel.yuv) - * if (blending == HWC_BLENDING_PREMULT) - * pixel.rgb = pixel.rgb * planeAlpha / 255 - * pixel.a = planeAlpha - * - * - * IMPLEMENTATION NOTE: - * - * If the source image doesn't have an alpha channel, then - * the h/w can use the HWC_BLENDING_COVERAGE equations instead of - * HWC_BLENDING_PREMULT and simply set the alpha channel to - * planeAlpha. - * - * e.g.: - * - * if (blending == HWC_BLENDING_PREMULT) - * blending = HWC_BLENDING_COVERAGE; - * pixel.a = planeAlpha; - * - */ - uint8_t planeAlpha; - - /* Pad to 32 bits */ - uint8_t _pad[3]; - - /* - * Availability: HWC_DEVICE_API_VERSION_1_5 - * - * This defines the region of the source buffer that has been - * modified since the last frame. - * - * If surfaceDamage.numRects > 0, then it may be assumed that any - * portion of the source buffer not covered by one of the rects has - * not been modified this frame. If surfaceDamage.numRects == 0, - * then the whole source buffer must be treated as if it had been - * modified. - * - * If the layer's contents are not modified relative to the prior - * prepare/set cycle, surfaceDamage will contain exactly one empty - * rect ([0, 0, 0, 0]). - * - * The damage rects are relative to the pre-transformed buffer, and - * their origin is the top-left corner. - */ - hwc_region_t surfaceDamage; - }; - }; - -#ifdef __LP64__ - /* - * For 64-bit mode, this struct is 120 bytes (and 8-byte aligned), and needs - * to be padded as such to maintain binary compatibility. - */ - uint8_t reserved[120 - 112]; -#else - /* - * For 32-bit mode, this struct is 96 bytes, and needs to be padded as such - * to maintain binary compatibility. - */ - uint8_t reserved[96 - 84]; -#endif - -} hwc_layer_1_t; - -/* This represents a display, typically an EGLDisplay object */ -typedef void* hwc_display_t; - -/* This represents a surface, typically an EGLSurface object */ -typedef void* hwc_surface_t; - -/* - * hwc_display_contents_1_t::flags values - */ -enum { - /* - * HWC_GEOMETRY_CHANGED is set by SurfaceFlinger to indicate that the list - * passed to (*prepare)() has changed by more than just the buffer handles - * and acquire fences. - */ - HWC_GEOMETRY_CHANGED = 0x00000001, -}; - -/* - * Description of the contents to output on a display. - * - * This is the top-level structure passed to the prepare and set calls to - * negotiate and commit the composition of a display image. - */ -typedef struct hwc_display_contents_1 { - /* File descriptor referring to a Sync HAL fence object which will signal - * when this composition is retired. For a physical display, a composition - * is retired when it has been replaced on-screen by a subsequent set. For - * a virtual display, the composition is retired when the writes to - * outputBuffer are complete and can be read. The fence object is created - * and returned by the set call; this field will be -1 on entry to prepare - * and set. SurfaceFlinger will close the returned file descriptor. - */ - int retireFenceFd; - - union { - /* Fields only relevant for HWC_DEVICE_VERSION_1_0. */ - struct { - /* (dpy, sur) is the target of SurfaceFlinger's OpenGL ES - * composition for HWC_DEVICE_VERSION_1_0. They aren't relevant to - * prepare. The set call should commit this surface atomically to - * the display along with any overlay layers. - */ - hwc_display_t dpy; - hwc_surface_t sur; - }; - - /* These fields are used for virtual displays when the h/w composer - * version is at least HWC_DEVICE_VERSION_1_3. */ - struct { - /* outbuf is the buffer that receives the composed image for - * virtual displays. Writes to the outbuf must wait until - * outbufAcquireFenceFd signals. A fence that will signal when - * writes to outbuf are complete should be returned in - * retireFenceFd. - * - * This field is set before prepare(), so properties of the buffer - * can be used to decide which layers can be handled by h/w - * composer. - * - * If prepare() sets all layers to FRAMEBUFFER, then GLES - * composition will happen directly to the output buffer. In this - * case, both outbuf and the FRAMEBUFFER_TARGET layer's buffer will - * be the same, and set() has no work to do besides managing fences. - * - * If the TARGET_FORCE_HWC_FOR_VIRTUAL_DISPLAYS board config - * variable is defined (not the default), then this behavior is - * changed: if all layers are marked for FRAMEBUFFER, GLES - * composition will take place to a scratch framebuffer, and - * h/w composer must copy it to the output buffer. This allows the - * h/w composer to do format conversion if there are cases where - * that is more desirable than doing it in the GLES driver or at the - * virtual display consumer. - * - * If some or all layers are marked OVERLAY, then the framebuffer - * and output buffer will be different. As with physical displays, - * the framebuffer handle will not change between frames if all - * layers are marked for OVERLAY. - */ - buffer_handle_t outbuf; - - /* File descriptor for a fence that will signal when outbuf is - * ready to be written. The h/w composer is responsible for closing - * this when no longer needed. - * - * Will be -1 whenever outbuf is NULL, or when the outbuf can be - * written immediately. - */ - int outbufAcquireFenceFd; - }; - }; - - /* List of layers that will be composed on the display. The buffer handles - * in the list will be unique. If numHwLayers is 0, all composition will be - * performed by SurfaceFlinger. - */ - uint32_t flags; - size_t numHwLayers; - hwc_layer_1_t hwLayers[0]; - -} hwc_display_contents_1_t; - -/* see hwc_composer_device::registerProcs() - * All of the callbacks are required and non-NULL unless otherwise noted. - */ -typedef struct hwc_procs { - /* - * (*invalidate)() triggers a screen refresh, in particular prepare and set - * will be called shortly after this call is made. Note that there is - * NO GUARANTEE that the screen refresh will happen after invalidate() - * returns (in particular, it could happen before). - * invalidate() is GUARANTEED TO NOT CALL BACK into the h/w composer HAL and - * it is safe to call invalidate() from any of hwc_composer_device - * hooks, unless noted otherwise. - */ - void (*invalidate)(const struct hwc_procs* procs); - - /* - * (*vsync)() is called by the h/w composer HAL when a vsync event is - * received and HWC_EVENT_VSYNC is enabled on a display - * (see: hwc_event_control). - * - * the "disp" parameter indicates which display the vsync event is for. - * the "timestamp" parameter is the system monotonic clock timestamp in - * nanosecond of when the vsync event happened. - * - * vsync() is GUARANTEED TO NOT CALL BACK into the h/w composer HAL. - * - * It is expected that vsync() is called from a thread of at least - * HAL_PRIORITY_URGENT_DISPLAY with as little latency as possible, - * typically less than 0.5 ms. - * - * It is a (silent) error to have HWC_EVENT_VSYNC enabled when calling - * hwc_composer_device.set(..., 0, 0, 0) (screen off). The implementation - * can either stop or continue to process VSYNC events, but must not - * crash or cause other problems. - */ - void (*vsync)(const struct hwc_procs* procs, int disp, int64_t timestamp); - - /* - * (*hotplug)() is called by the h/w composer HAL when a display is - * connected or disconnected. The PRIMARY display is always connected and - * the hotplug callback should not be called for it. - * - * The disp parameter indicates which display type this event is for. - * The connected parameter indicates whether the display has just been - * connected (1) or disconnected (0). - * - * The hotplug() callback may call back into the h/w composer on the same - * thread to query refresh rate and dpi for the display. Additionally, - * other threads may be calling into the h/w composer while the callback - * is in progress. - * - * The h/w composer must serialize calls to the hotplug callback; only - * one thread may call it at a time. - * - * This callback will be NULL if the h/w composer is using - * HWC_DEVICE_API_VERSION_1_0. - */ - void (*hotplug)(const struct hwc_procs* procs, int disp, int connected); - -} hwc_procs_t; - - -/*****************************************************************************/ - -typedef struct hwc_module { - /** - * Common methods of the hardware composer module. This *must* be the first member of - * hwc_module as users of this structure will cast a hw_module_t to - * hwc_module pointer in contexts where it's known the hw_module_t references a - * hwc_module. - */ - struct hw_module_t common; -} hwc_module_t; - -#define HWC_ERROR (-1) -typedef struct hwc_composer_device_1 { - /** - * Common methods of the hardware composer device. This *must* be the first member of - * hwc_composer_device_1 as users of this structure will cast a hw_device_t to - * hwc_composer_device_1 pointer in contexts where it's known the hw_device_t references a - * hwc_composer_device_1. - */ - struct hw_device_t common; - - /* - * (*prepare)() is called for each frame before composition and is used by - * SurfaceFlinger to determine what composition steps the HWC can handle. - * - * (*prepare)() can be called more than once, the last call prevails. - * - * The HWC responds by setting the compositionType field in each layer to - * either HWC_FRAMEBUFFER, HWC_OVERLAY, or HWC_CURSOR_OVERLAY. For the - * HWC_FRAMEBUFFER type, composition for the layer is handled by - * SurfaceFlinger with OpenGL ES. For the latter two overlay types, - * the HWC will have to handle the layer's composition. compositionType - * and hints are preserved between (*prepare)() calles unless the - * HWC_GEOMETRY_CHANGED flag is set. - * - * (*prepare)() is called with HWC_GEOMETRY_CHANGED to indicate that the - * list's geometry has changed, that is, when more than just the buffer's - * handles have been updated. Typically this happens (but is not limited to) - * when a window is added, removed, resized or moved. In this case - * compositionType and hints are reset to their default value. - * - * For HWC 1.0, numDisplays will always be one, and displays[0] will be - * non-NULL. - * - * For HWC 1.1, numDisplays will always be HWC_NUM_PHYSICAL_DISPLAY_TYPES. - * Entries for unsupported or disabled/disconnected display types will be - * NULL. - * - * In HWC 1.3, numDisplays may be up to HWC_NUM_DISPLAY_TYPES. The extra - * entries correspond to enabled virtual displays, and will be non-NULL. - * - * returns: 0 on success. An negative error code on error. If an error is - * returned, SurfaceFlinger will assume that none of the layer will be - * handled by the HWC. - */ - int (*prepare)(struct hwc_composer_device_1 *dev, - size_t numDisplays, hwc_display_contents_1_t** displays); - - /* - * (*set)() is used in place of eglSwapBuffers(), and assumes the same - * functionality, except it also commits the work list atomically with - * the actual eglSwapBuffers(). - * - * The layer lists are guaranteed to be the same as the ones returned from - * the last call to (*prepare)(). - * - * When this call returns the caller assumes that the displays will be - * updated in the near future with the content of their work lists, without - * artifacts during the transition from the previous frame. - * - * A display with zero layers indicates that the entire composition has - * been handled by SurfaceFlinger with OpenGL ES. In this case, (*set)() - * behaves just like eglSwapBuffers(). - * - * For HWC 1.0, numDisplays will always be one, and displays[0] will be - * non-NULL. - * - * For HWC 1.1, numDisplays will always be HWC_NUM_PHYSICAL_DISPLAY_TYPES. - * Entries for unsupported or disabled/disconnected display types will be - * NULL. - * - * In HWC 1.3, numDisplays may be up to HWC_NUM_DISPLAY_TYPES. The extra - * entries correspond to enabled virtual displays, and will be non-NULL. - * - * IMPORTANT NOTE: There is an implicit layer containing opaque black - * pixels behind all the layers in the list. It is the responsibility of - * the hwcomposer module to make sure black pixels are output (or blended - * from). - * - * IMPORTANT NOTE: In the event of an error this call *MUST* still cause - * any fences returned in the previous call to set to eventually become - * signaled. The caller may have already issued wait commands on these - * fences, and having set return without causing those fences to signal - * will likely result in a deadlock. - * - * returns: 0 on success. A negative error code on error: - * HWC_EGL_ERROR: eglGetError() will provide the proper error code (only - * allowed prior to HWComposer 1.1) - * Another code for non EGL errors. - */ - int (*set)(struct hwc_composer_device_1 *dev, - size_t numDisplays, hwc_display_contents_1_t** displays); - - /* - * eventControl(..., event, enabled) - * Enables or disables h/w composer events for a display. - * - * eventControl can be called from any thread and takes effect - * immediately. - * - * Supported events are: - * HWC_EVENT_VSYNC - * - * returns -EINVAL if the "event" parameter is not one of the value above - * or if the "enabled" parameter is not 0 or 1. - */ - int (*eventControl)(struct hwc_composer_device_1* dev, int disp, - int event, int enabled); - - union { - /* - * For HWC 1.3 and earlier, the blank() interface is used. - * - * blank(..., blank) - * Blanks or unblanks a display's screen. - * - * Turns the screen off when blank is nonzero, on when blank is zero. - * Multiple sequential calls with the same blank value must be - * supported. - * The screen state transition must be be complete when the function - * returns. - * - * returns 0 on success, negative on error. - */ - int (*blank)(struct hwc_composer_device_1* dev, int disp, int blank); - - /* - * For HWC 1.4 and above, setPowerMode() will be used in place of - * blank(). - * - * setPowerMode(..., mode) - * Sets the display screen's power state. - * - * Refer to the documentation of the HWC_POWER_MODE_* constants - * for information about each power mode. - * - * The functionality is similar to the blank() command in previous - * versions of HWC, but with support for more power states. - * - * The display driver is expected to retain and restore the low power - * state of the display while entering and exiting from suspend. - * - * Multiple sequential calls with the same mode value must be supported. - * - * The screen state transition must be be complete when the function - * returns. - * - * returns 0 on success, negative on error. - */ - int (*setPowerMode)(struct hwc_composer_device_1* dev, int disp, - int mode); - }; - - /* - * Used to retrieve information about the h/w composer - * - * Returns 0 on success or -errno on error. - */ - int (*query)(struct hwc_composer_device_1* dev, int what, int* value); - - /* - * (*registerProcs)() registers callbacks that the h/w composer HAL can - * later use. It will be called immediately after the composer device is - * opened with non-NULL procs. It is FORBIDDEN to call any of the callbacks - * from within registerProcs(). registerProcs() must save the hwc_procs_t - * pointer which is needed when calling a registered callback. - */ - void (*registerProcs)(struct hwc_composer_device_1* dev, - hwc_procs_t const* procs); - - /* - * This field is OPTIONAL and can be NULL. - * - * If non NULL it will be called by SurfaceFlinger on dumpsys - */ - void (*dump)(struct hwc_composer_device_1* dev, char *buff, int buff_len); - - /* - * (*getDisplayConfigs)() returns handles for the configurations available - * on the connected display. These handles must remain valid as long as the - * display is connected. - * - * Configuration handles are written to configs. The number of entries - * allocated by the caller is passed in *numConfigs; getDisplayConfigs must - * not try to write more than this number of config handles. On return, the - * total number of configurations available for the display is returned in - * *numConfigs. If *numConfigs is zero on entry, then configs may be NULL. - * - * Hardware composers implementing HWC_DEVICE_API_VERSION_1_3 or prior - * shall choose one configuration to activate and report it as the first - * entry in the returned list. Reporting the inactive configurations is not - * required. - * - * HWC_DEVICE_API_VERSION_1_4 and later provide configuration management - * through SurfaceFlinger, and hardware composers implementing these APIs - * must also provide getActiveConfig and setActiveConfig. Hardware composers - * implementing these API versions may choose not to activate any - * configuration, leaving configuration selection to higher levels of the - * framework. - * - * Returns 0 on success or a negative error code on error. If disp is a - * hotpluggable display type and no display is connected, an error shall be - * returned. - * - * This field is REQUIRED for HWC_DEVICE_API_VERSION_1_1 and later. - * It shall be NULL for previous versions. - */ - int (*getDisplayConfigs)(struct hwc_composer_device_1* dev, int disp, - uint32_t* configs, size_t* numConfigs); - - /* - * (*getDisplayAttributes)() returns attributes for a specific config of a - * connected display. The config parameter is one of the config handles - * returned by getDisplayConfigs. - * - * The list of attributes to return is provided in the attributes - * parameter, terminated by HWC_DISPLAY_NO_ATTRIBUTE. The value for each - * requested attribute is written in order to the values array. The - * HWC_DISPLAY_NO_ATTRIBUTE attribute does not have a value, so the values - * array will have one less value than the attributes array. - * - * This field is REQUIRED for HWC_DEVICE_API_VERSION_1_1 and later. - * It shall be NULL for previous versions. - * - * If disp is a hotpluggable display type and no display is connected, - * or if config is not a valid configuration for the display, a negative - * error code shall be returned. - */ - int (*getDisplayAttributes)(struct hwc_composer_device_1* dev, int disp, - uint32_t config, const uint32_t* attributes, int32_t* values); - - /* - * (*getActiveConfig)() returns the index of the configuration that is - * currently active on the connected display. The index is relative to - * the list of configuration handles returned by getDisplayConfigs. If there - * is no active configuration, HWC_ERROR shall be returned. - * - * Returns the configuration index on success or HWC_ERROR on error. - * - * This field is REQUIRED for HWC_DEVICE_API_VERSION_1_4 and later. - * It shall be NULL for previous versions. - */ - int (*getActiveConfig)(struct hwc_composer_device_1* dev, int disp); - - /* - * (*setActiveConfig)() instructs the hardware composer to switch to the - * display configuration at the given index in the list of configuration - * handles returned by getDisplayConfigs. - * - * If this function returns without error, any subsequent calls to - * getActiveConfig shall return the index set by this function until one - * of the following occurs: - * 1) Another successful call of this function - * 2) The display is disconnected - * - * Returns 0 on success or a negative error code on error. If disp is a - * hotpluggable display type and no display is connected, or if index is - * outside of the range of hardware configurations returned by - * getDisplayConfigs, an error shall be returned. - * - * This field is REQUIRED for HWC_DEVICE_API_VERSION_1_4 and later. - * It shall be NULL for previous versions. - */ - int (*setActiveConfig)(struct hwc_composer_device_1* dev, int disp, - int index); - /* - * Asynchronously update the location of the cursor layer. - * - * Within the standard prepare()/set() composition loop, the client - * (surfaceflinger) can request that a given layer uses dedicated cursor - * composition hardware by specifiying the HWC_IS_CURSOR_LAYER flag. Only - * one layer per display can have this flag set. If the layer is suitable - * for the platform's cursor hardware, hwcomposer will return from prepare() - * a composition type of HWC_CURSOR_OVERLAY for that layer. This indicates - * not only that the client is not responsible for compositing that layer, - * but also that the client can continue to update the position of that layer - * after a call to set(). This can reduce the visible latency of mouse - * movement to visible, on-screen cursor updates. Calls to - * setCursorPositionAsync() may be made from a different thread doing the - * prepare()/set() composition loop, but care must be taken to not interleave - * calls of setCursorPositionAsync() between calls of set()/prepare(). - * - * Notes: - * - Only one layer per display can be specified as a cursor layer with - * HWC_IS_CURSOR_LAYER. - * - hwcomposer will only return one layer per display as HWC_CURSOR_OVERLAY - * - This returns 0 on success or -errno on error. - * - This field is optional for HWC_DEVICE_API_VERSION_1_4 and later. It - * should be null for previous versions. - */ - int (*setCursorPositionAsync)(struct hwc_composer_device_1 *dev, int disp, int x_pos, int y_pos); - - /* - * Reserved for future use. Must be NULL. - */ - void* reserved_proc[1]; - -} hwc_composer_device_1_t; - -/** convenience API for opening and closing a device */ - -static inline int hwc_open_1(const struct hw_module_t* module, - hwc_composer_device_1_t** device) { - return module->methods->open(module, - HWC_HARDWARE_COMPOSER, TO_HW_DEVICE_T_OPEN(device)); -} - -static inline int hwc_close_1(hwc_composer_device_1_t* device) { - return device->common.close(&device->common); -} - -/*****************************************************************************/ - -__END_DECLS - -#endif /* ANDROID_INCLUDE_HARDWARE_HWCOMPOSER_H */ diff --git a/.ci/android_headers/hardware/hwcomposer2.h b/.ci/android_headers/hardware/hwcomposer2.h deleted file mode 100644 index df5670f..0000000 --- a/.ci/android_headers/hardware/hwcomposer2.h +++ /dev/null @@ -1,3183 +0,0 @@ -// clang-format off -/* - * Copyright 2015 The Android Open Source Project - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -#ifndef ANDROID_HARDWARE_HWCOMPOSER2_H -#define ANDROID_HARDWARE_HWCOMPOSER2_H - -#include <sys/cdefs.h> - -#include <hardware/hardware.h> - -#include "hwcomposer_defs.h" - -/* Missing in glibc, pull from BIONIC */ -#if defined(__cplusplus) -#define __BIONIC_CAST(_k,_t,_v) (_k<_t>(_v)) -#else -#define __BIONIC_CAST(_k,_t,_v) ((_t) (_v)) -#endif - -__BEGIN_DECLS - -/* - * Enums - * - * For most of these enums, there is an invalid value defined to be 0. This is - * an attempt to catch uninitialized fields, and these values should not be - * used. - */ - -/* Display attributes queryable through getDisplayAttribute */ -typedef enum { - HWC2_ATTRIBUTE_INVALID = 0, - - /* Dimensions in pixels */ - HWC2_ATTRIBUTE_WIDTH = 1, - HWC2_ATTRIBUTE_HEIGHT = 2, - - /* Vsync period in nanoseconds */ - HWC2_ATTRIBUTE_VSYNC_PERIOD = 3, - - /* Dots per thousand inches (DPI * 1000). Scaling by 1000 allows these - * numbers to be stored in an int32_t without losing too much precision. If - * the DPI for a configuration is unavailable or is considered unreliable, - * the device may return -1 instead */ - HWC2_ATTRIBUTE_DPI_X = 4, - HWC2_ATTRIBUTE_DPI_Y = 5, - - /* The configuration group this config is associated to. - * Switching between configurations within the same group may be done seamlessly - * in some conditions via setActiveConfigWithConstraints. */ - HWC2_ATTRIBUTE_CONFIG_GROUP = 7, -} hwc2_attribute_t; - -/* Blend modes, settable per layer */ -typedef enum { - HWC2_BLEND_MODE_INVALID = 0, - - /* colorOut = colorSrc */ - HWC2_BLEND_MODE_NONE = 1, - - /* colorOut = colorSrc + colorDst * (1 - alphaSrc) */ - HWC2_BLEND_MODE_PREMULTIPLIED = 2, - - /* colorOut = colorSrc * alphaSrc + colorDst * (1 - alphaSrc) */ - HWC2_BLEND_MODE_COVERAGE = 3, -} hwc2_blend_mode_t; - -/* See the 'Callbacks' section for more detailed descriptions of what these - * functions do */ -typedef enum { - HWC2_CALLBACK_INVALID = 0, - HWC2_CALLBACK_HOTPLUG = 1, - HWC2_CALLBACK_REFRESH = 2, - HWC2_CALLBACK_VSYNC = 3, - HWC2_CALLBACK_VSYNC_2_4 = 4, - HWC2_CALLBACK_VSYNC_PERIOD_TIMING_CHANGED = 5, - HWC2_CALLBACK_SEAMLESS_POSSIBLE = 6, -} hwc2_callback_descriptor_t; - -/* Optional capabilities which may be supported by some devices. The particular - * set of supported capabilities for a given device may be retrieved using - * getCapabilities. */ -typedef enum { - HWC2_CAPABILITY_INVALID = 0, - - /* Specifies that the device supports sideband stream layers, for which - * buffer content updates and other synchronization will not be provided - * through the usual validate/present cycle and must be handled by an - * external implementation-defined mechanism. Only changes to layer state - * (such as position, size, etc.) need to be performed through the - * validate/present cycle. */ - HWC2_CAPABILITY_SIDEBAND_STREAM = 1, - - /* Specifies that the device will apply a color transform even when either - * the client or the device has chosen that all layers should be composed by - * the client. This will prevent the client from applying the color - * transform during its composition step. */ - HWC2_CAPABILITY_SKIP_CLIENT_COLOR_TRANSFORM = 2, - - /* Specifies that the present fence must not be used as an accurate - * representation of the actual present time of a frame. - * This capability must never be set by HWC2 devices. - * This capability may be set for HWC1 devices that use the - * HWC2On1Adapter where emulation of the present fence using the retire - * fence is not feasible. - * In the future, CTS tests will require present time to be reliable. - */ - HWC2_CAPABILITY_PRESENT_FENCE_IS_NOT_RELIABLE = 3, - - /* Specifies that a device is able to skip the validateDisplay call before - * receiving a call to presentDisplay. The client will always skip - * validateDisplay and try to call presentDisplay regardless of the changes - * in the properties of the layers. If the device returns anything else than - * HWC2_ERROR_NONE, it will call validateDisplay then presentDisplay again. - * For this capability to be worthwhile the device implementation of - * presentDisplay should fail as fast as possible in the case a - * validateDisplay step is needed. - */ - HWC2_CAPABILITY_SKIP_VALIDATE = 4, -} hwc2_capability_t; - -/* Possible composition types for a given layer */ -typedef enum { - HWC2_COMPOSITION_INVALID = 0, - - /* The client will composite this layer into the client target buffer - * (provided to the device through setClientTarget). - * - * The device must not request any composition type changes for layers of - * this type. */ - HWC2_COMPOSITION_CLIENT = 1, - - /* The device will handle the composition of this layer through a hardware - * overlay or other similar means. - * - * Upon validateDisplay, the device may request a change from this type to - * HWC2_COMPOSITION_CLIENT. */ - HWC2_COMPOSITION_DEVICE = 2, - - /* The device will render this layer using the color set through - * setLayerColor. If this functionality is not supported on a layer that the - * client sets to HWC2_COMPOSITION_SOLID_COLOR, the device must request that - * the composition type of that layer is changed to HWC2_COMPOSITION_CLIENT - * upon the next call to validateDisplay. - * - * Upon validateDisplay, the device may request a change from this type to - * HWC2_COMPOSITION_CLIENT. */ - HWC2_COMPOSITION_SOLID_COLOR = 3, - - /* Similar to DEVICE, but the position of this layer may also be set - * asynchronously through setCursorPosition. If this functionality is not - * supported on a layer that the client sets to HWC2_COMPOSITION_CURSOR, the - * device must request that the composition type of that layer is changed to - * HWC2_COMPOSITION_CLIENT upon the next call to validateDisplay. - * - * Upon validateDisplay, the device may request a change from this type to - * either HWC2_COMPOSITION_DEVICE or HWC2_COMPOSITION_CLIENT. Changing to - * HWC2_COMPOSITION_DEVICE will prevent the use of setCursorPosition but - * still permit the device to composite the layer. */ - HWC2_COMPOSITION_CURSOR = 4, - - /* The device will handle the composition of this layer, as well as its - * buffer updates and content synchronization. Only supported on devices - * which provide HWC2_CAPABILITY_SIDEBAND_STREAM. - * - * Upon validateDisplay, the device may request a change from this type to - * either HWC2_COMPOSITION_DEVICE or HWC2_COMPOSITION_CLIENT, but it is - * unlikely that content will display correctly in these cases. */ - HWC2_COMPOSITION_SIDEBAND = 5, -} hwc2_composition_t; - -/* Possible connection options from the hotplug callback */ -typedef enum { - HWC2_CONNECTION_INVALID = 0, - - /* The display has been connected */ - HWC2_CONNECTION_CONNECTED = 1, - - /* The display has been disconnected */ - HWC2_CONNECTION_DISCONNECTED = 2, -} hwc2_connection_t; - -/* Display requests returned by getDisplayRequests */ -typedef enum { - /* Instructs the client to provide a new client target buffer, even if no - * layers are marked for client composition. */ - HWC2_DISPLAY_REQUEST_FLIP_CLIENT_TARGET = 1 << 0, - - /* Instructs the client to write the result of client composition directly - * into the virtual display output buffer. If any of the layers are not - * marked as HWC2_COMPOSITION_CLIENT or the given display is not a virtual - * display, this request has no effect. */ - HWC2_DISPLAY_REQUEST_WRITE_CLIENT_TARGET_TO_OUTPUT = 1 << 1, -} hwc2_display_request_t; - -/* Display types returned by getDisplayType */ -typedef enum { - HWC2_DISPLAY_TYPE_INVALID = 0, - - /* All physical displays, including both internal displays and hotpluggable - * external displays */ - HWC2_DISPLAY_TYPE_PHYSICAL = 1, - - /* Virtual displays created by createVirtualDisplay */ - HWC2_DISPLAY_TYPE_VIRTUAL = 2, -} hwc2_display_type_t; - -/* Physical display types returned by getDisplayConnectionType */ -typedef enum { - HWC2_DISPLAY_CONNECTION_TYPE_INTERNAL = 0, - HWC2_DISPLAY_CONNECTION_TYPE_EXTERNAL = 1, -} hwc2_display_connection_type_t; - -/* Return codes from all functions */ -typedef enum { - HWC2_ERROR_NONE = 0, - HWC2_ERROR_BAD_CONFIG, - HWC2_ERROR_BAD_DISPLAY, - HWC2_ERROR_BAD_LAYER, - HWC2_ERROR_BAD_PARAMETER, - HWC2_ERROR_HAS_CHANGES, - HWC2_ERROR_NO_RESOURCES, - HWC2_ERROR_NOT_VALIDATED, - HWC2_ERROR_UNSUPPORTED, - HWC2_ERROR_SEAMLESS_NOT_ALLOWED, - HWC2_ERROR_SEAMLESS_NOT_POSSIBLE, -} hwc2_error_t; - -/* Function descriptors for use with getFunction */ -typedef enum { - HWC2_FUNCTION_INVALID = 0, - HWC2_FUNCTION_ACCEPT_DISPLAY_CHANGES, - HWC2_FUNCTION_CREATE_LAYER, - HWC2_FUNCTION_CREATE_VIRTUAL_DISPLAY, - HWC2_FUNCTION_DESTROY_LAYER, - HWC2_FUNCTION_DESTROY_VIRTUAL_DISPLAY, - HWC2_FUNCTION_DUMP, - HWC2_FUNCTION_GET_ACTIVE_CONFIG, - HWC2_FUNCTION_GET_CHANGED_COMPOSITION_TYPES, - HWC2_FUNCTION_GET_CLIENT_TARGET_SUPPORT, - HWC2_FUNCTION_GET_COLOR_MODES, - HWC2_FUNCTION_GET_DISPLAY_ATTRIBUTE, - HWC2_FUNCTION_GET_DISPLAY_CONFIGS, - HWC2_FUNCTION_GET_DISPLAY_NAME, - HWC2_FUNCTION_GET_DISPLAY_REQUESTS, - HWC2_FUNCTION_GET_DISPLAY_TYPE, - HWC2_FUNCTION_GET_DOZE_SUPPORT, - HWC2_FUNCTION_GET_HDR_CAPABILITIES, - HWC2_FUNCTION_GET_MAX_VIRTUAL_DISPLAY_COUNT, - HWC2_FUNCTION_GET_RELEASE_FENCES, - HWC2_FUNCTION_PRESENT_DISPLAY, - HWC2_FUNCTION_REGISTER_CALLBACK, - HWC2_FUNCTION_SET_ACTIVE_CONFIG, - HWC2_FUNCTION_SET_CLIENT_TARGET, - HWC2_FUNCTION_SET_COLOR_MODE, - HWC2_FUNCTION_SET_COLOR_TRANSFORM, - HWC2_FUNCTION_SET_CURSOR_POSITION, - HWC2_FUNCTION_SET_LAYER_BLEND_MODE, - HWC2_FUNCTION_SET_LAYER_BUFFER, - HWC2_FUNCTION_SET_LAYER_COLOR, - HWC2_FUNCTION_SET_LAYER_COMPOSITION_TYPE, - HWC2_FUNCTION_SET_LAYER_DATASPACE, - HWC2_FUNCTION_SET_LAYER_DISPLAY_FRAME, - HWC2_FUNCTION_SET_LAYER_PLANE_ALPHA, - HWC2_FUNCTION_SET_LAYER_SIDEBAND_STREAM, - HWC2_FUNCTION_SET_LAYER_SOURCE_CROP, - HWC2_FUNCTION_SET_LAYER_SURFACE_DAMAGE, - HWC2_FUNCTION_SET_LAYER_TRANSFORM, - HWC2_FUNCTION_SET_LAYER_VISIBLE_REGION, - HWC2_FUNCTION_SET_LAYER_Z_ORDER, - HWC2_FUNCTION_SET_OUTPUT_BUFFER, - HWC2_FUNCTION_SET_POWER_MODE, - HWC2_FUNCTION_SET_VSYNC_ENABLED, - HWC2_FUNCTION_VALIDATE_DISPLAY, - HWC2_FUNCTION_SET_LAYER_FLOAT_COLOR, - HWC2_FUNCTION_SET_LAYER_PER_FRAME_METADATA, - HWC2_FUNCTION_GET_PER_FRAME_METADATA_KEYS, - HWC2_FUNCTION_SET_READBACK_BUFFER, - HWC2_FUNCTION_GET_READBACK_BUFFER_ATTRIBUTES, - HWC2_FUNCTION_GET_READBACK_BUFFER_FENCE, - HWC2_FUNCTION_GET_RENDER_INTENTS, - HWC2_FUNCTION_SET_COLOR_MODE_WITH_RENDER_INTENT, - HWC2_FUNCTION_GET_DATASPACE_SATURATION_MATRIX, - - // composer 2.3 - HWC2_FUNCTION_GET_DISPLAY_IDENTIFICATION_DATA, - HWC2_FUNCTION_GET_DISPLAY_CAPABILITIES, - HWC2_FUNCTION_SET_LAYER_COLOR_TRANSFORM, - HWC2_FUNCTION_GET_DISPLAYED_CONTENT_SAMPLING_ATTRIBUTES, - HWC2_FUNCTION_SET_DISPLAYED_CONTENT_SAMPLING_ENABLED, - HWC2_FUNCTION_GET_DISPLAYED_CONTENT_SAMPLE, - HWC2_FUNCTION_SET_LAYER_PER_FRAME_METADATA_BLOBS, - HWC2_FUNCTION_GET_DISPLAY_BRIGHTNESS_SUPPORT, - HWC2_FUNCTION_SET_DISPLAY_BRIGHTNESS, - - // composer 2.4 - HWC2_FUNCTION_GET_DISPLAY_CONNECTION_TYPE, - HWC2_FUNCTION_GET_DISPLAY_VSYNC_PERIOD, - HWC2_FUNCTION_SET_ACTIVE_CONFIG_WITH_CONSTRAINTS, - HWC2_FUNCTION_SET_AUTO_LOW_LATENCY_MODE, - HWC2_FUNCTION_GET_SUPPORTED_CONTENT_TYPES, - HWC2_FUNCTION_SET_CONTENT_TYPE, - HWC2_FUNCTION_GET_CLIENT_TARGET_PROPERTY, - HWC2_FUNCTION_SET_LAYER_GENERIC_METADATA, - HWC2_FUNCTION_GET_LAYER_GENERIC_METADATA_KEY, -} hwc2_function_descriptor_t; - -/* Layer requests returned from getDisplayRequests */ -typedef enum { - /* The client should clear its target with transparent pixels where this - * layer would be. The client may ignore this request if the layer must be - * blended. */ - HWC2_LAYER_REQUEST_CLEAR_CLIENT_TARGET = 1 << 0, -} hwc2_layer_request_t; - -/* Power modes for use with setPowerMode */ -typedef enum { - /* The display is fully off (blanked) */ - HWC2_POWER_MODE_OFF = 0, - - /* These are optional low power modes. getDozeSupport may be called to - * determine whether a given display supports these modes. */ - - /* The display is turned on and configured in a low power state that is - * suitable for presenting ambient information to the user, possibly with - * lower fidelity than HWC2_POWER_MODE_ON, but with greater efficiency. */ - HWC2_POWER_MODE_DOZE = 1, - - /* The display is configured as in HWC2_POWER_MODE_DOZE but may stop - * applying display updates from the client. This is effectively a hint to - * the device that drawing to the display has been suspended and that the - * the device should remain on in a low power state and continue displaying - * its current contents indefinitely until the power mode changes. - * - * This mode may also be used as a signal to enable hardware-based doze - * functionality. In this case, the device is free to take over the display - * and manage it autonomously to implement a low power always-on display. */ - HWC2_POWER_MODE_DOZE_SUSPEND = 3, - - /* The display is fully on */ - HWC2_POWER_MODE_ON = 2, -} hwc2_power_mode_t; - -typedef enum { - HWC2_CONTENT_TYPE_NONE = 0, - HWC2_CONTENT_TYPE_GRAPHICS = 1, - HWC2_CONTENT_TYPE_PHOTO = 2, - HWC2_CONTENT_TYPE_CINEMA = 3, - HWC2_CONTENT_TYPE_GAME = 4, -} hwc2_content_type_t; - -/* Vsync values passed to setVsyncEnabled */ -typedef enum { - HWC2_VSYNC_INVALID = 0, - - /* Enable vsync */ - HWC2_VSYNC_ENABLE = 1, - - /* Disable vsync */ - HWC2_VSYNC_DISABLE = 2, -} hwc2_vsync_t; - -/* MUST match HIDL's V2_2::IComposerClient::PerFrameMetadataKey */ -typedef enum { - /* SMPTE ST 2084:2014. - * Coordinates defined in CIE 1931 xy chromaticity space - */ - HWC2_DISPLAY_RED_PRIMARY_X = 0, - HWC2_DISPLAY_RED_PRIMARY_Y = 1, - HWC2_DISPLAY_GREEN_PRIMARY_X = 2, - HWC2_DISPLAY_GREEN_PRIMARY_Y = 3, - HWC2_DISPLAY_BLUE_PRIMARY_X = 4, - HWC2_DISPLAY_BLUE_PRIMARY_Y = 5, - HWC2_WHITE_POINT_X = 6, - HWC2_WHITE_POINT_Y = 7, - /* SMPTE ST 2084:2014. - * Units: nits - * max as defined by ST 2048: 10,000 nits - */ - HWC2_MAX_LUMINANCE = 8, - HWC2_MIN_LUMINANCE = 9, - - /* CTA 861.3 - * Units: nits - */ - HWC2_MAX_CONTENT_LIGHT_LEVEL = 10, - HWC2_MAX_FRAME_AVERAGE_LIGHT_LEVEL = 11, -} hwc2_per_frame_metadata_key_t; - -/* SetDisplayedContentSampling values passed to setDisplayedContentSamplingEnabled */ -typedef enum { - HWC2_DISPLAYED_CONTENT_SAMPLING_INVALID = 0, - - /* Enable displayed content sampling */ - HWC2_DISPLAYED_CONTENT_SAMPLING_ENABLE = 1, - - /* Disable displayed content sampling */ - HWC2_DISPLAYED_CONTENT_SAMPLING_DISABLE = 2, -} hwc2_displayed_content_sampling_t; - -typedef enum { - HWC2_FORMAT_COMPONENT_0 = 1 << 0, /* The first component (eg, for RGBA_8888, this is R) */ - HWC2_FORMAT_COMPONENT_1 = 1 << 1, /* The second component (eg, for RGBA_8888, this is G) */ - HWC2_FORMAT_COMPONENT_2 = 1 << 2, /* The third component (eg, for RGBA_8888, this is B) */ - HWC2_FORMAT_COMPONENT_3 = 1 << 3, /* The fourth component (eg, for RGBA_8888, this is A) */ -} hwc2_format_color_component_t; - -/* Optional display capabilities which may be supported by some displays. - * The particular set of supported capabilities for a given display may be - * retrieved using getDisplayCapabilities. */ -typedef enum { - HWC2_DISPLAY_CAPABILITY_INVALID = 0, - - /** - * Specifies that the display must apply a color transform even when either - * the client or the device has chosen that all layers should be composed by - * the client. This prevents the client from applying the color transform - * during its composition step. - * If getDisplayCapabilities is supported, the global capability - * HWC2_CAPABILITY_SKIP_CLIENT_COLOR_TRANSFORM is ignored. - * If getDisplayCapabilities is not supported, and the global capability - * HWC2_CAPABILITY_SKIP_CLIENT_COLOR_TRANSFORM is returned by getCapabilities, - * then all displays must be treated as having - * HWC2_DISPLAY_CAPABILITY_SKIP_CLIENT_COLOR_TRANSFORM. - */ - HWC2_DISPLAY_CAPABILITY_SKIP_CLIENT_COLOR_TRANSFORM = 1, - - /** - * Specifies that the display supports PowerMode::DOZE and - * PowerMode::DOZE_SUSPEND. DOZE_SUSPEND may not provide any benefit - * over DOZE (see the definition of PowerMode for more information), - * but if both DOZE and DOZE_SUSPEND are no different from - * PowerMode::ON, the device must not claim support. - * HWC2_DISPLAY_CAPABILITY_DOZE must be returned by getDisplayCapabilities - * when getDozeSupport indicates the display supports PowerMode::DOZE and - * PowerMode::DOZE_SUSPEND. - */ - HWC2_DISPLAY_CAPABILITY_DOZE = 2, - - /** - * Specified that the display supports brightness operations. - */ - HWC2_DISPLAY_CAPABILITY_BRIGHTNESS = 3, - - /** - * Specifies that the display supports a low latency mode. If the connection - * to the display is via HDMI, this specifies whether Auto Low Latency Mode - * is supported. If, instead, there is an internal connection to the display, - * then this specifies that the display has some other custom low latency - * mode. - */ - HWC2_DISPLAY_CAPABILITY_AUTO_LOW_LATENCY_MODE = 5, -} hwc2_display_capability_t; - -/* - * Stringification Functions - */ - -#ifdef HWC2_INCLUDE_STRINGIFICATION - -static inline const char* getAttributeName(hwc2_attribute_t attribute) { - switch (attribute) { - case HWC2_ATTRIBUTE_INVALID: return "Invalid"; - case HWC2_ATTRIBUTE_WIDTH: return "Width"; - case HWC2_ATTRIBUTE_HEIGHT: return "Height"; - case HWC2_ATTRIBUTE_VSYNC_PERIOD: return "VsyncPeriod"; - case HWC2_ATTRIBUTE_DPI_X: return "DpiX"; - case HWC2_ATTRIBUTE_DPI_Y: return "DpiY"; - case HWC2_ATTRIBUTE_CONFIG_GROUP: return "ConfigGroup"; - default: return "Unknown"; - } -} - -static inline const char* getBlendModeName(hwc2_blend_mode_t mode) { - switch (mode) { - case HWC2_BLEND_MODE_INVALID: return "Invalid"; - case HWC2_BLEND_MODE_NONE: return "None"; - case HWC2_BLEND_MODE_PREMULTIPLIED: return "Premultiplied"; - case HWC2_BLEND_MODE_COVERAGE: return "Coverage"; - default: return "Unknown"; - } -} - -static inline const char* getCallbackDescriptorName( - hwc2_callback_descriptor_t desc) { - switch (desc) { - case HWC2_CALLBACK_INVALID: return "Invalid"; - case HWC2_CALLBACK_HOTPLUG: return "Hotplug"; - case HWC2_CALLBACK_REFRESH: return "Refresh"; - case HWC2_CALLBACK_VSYNC: return "Vsync"; - case HWC2_CALLBACK_VSYNC_2_4: return "Vsync2.4"; - case HWC2_CALLBACK_VSYNC_PERIOD_TIMING_CHANGED: return "VsyncPeriodTimingChanged"; - case HWC2_CALLBACK_SEAMLESS_POSSIBLE: return "SeamlessPossible"; - default: return "Unknown"; - } -} - -static inline const char* getCapabilityName(hwc2_capability_t capability) { - switch (capability) { - case HWC2_CAPABILITY_INVALID: return "Invalid"; - case HWC2_CAPABILITY_SIDEBAND_STREAM: return "SidebandStream"; - case HWC2_CAPABILITY_SKIP_CLIENT_COLOR_TRANSFORM: - return "SkipClientColorTransform"; - case HWC2_CAPABILITY_PRESENT_FENCE_IS_NOT_RELIABLE: - return "PresentFenceIsNotReliable"; - default: return "Unknown"; - } -} - -static inline const char* getCompositionName(hwc2_composition_t composition) { - switch (composition) { - case HWC2_COMPOSITION_INVALID: return "Invalid"; - case HWC2_COMPOSITION_CLIENT: return "Client"; - case HWC2_COMPOSITION_DEVICE: return "Device"; - case HWC2_COMPOSITION_SOLID_COLOR: return "SolidColor"; - case HWC2_COMPOSITION_CURSOR: return "Cursor"; - case HWC2_COMPOSITION_SIDEBAND: return "Sideband"; - default: return "Unknown"; - } -} - -static inline const char* getConnectionName(hwc2_connection_t connection) { - switch (connection) { - case HWC2_CONNECTION_INVALID: return "Invalid"; - case HWC2_CONNECTION_CONNECTED: return "Connected"; - case HWC2_CONNECTION_DISCONNECTED: return "Disconnected"; - default: return "Unknown"; - } -} - -static inline const char* getDisplayRequestName( - hwc2_display_request_t request) { - switch (__BIONIC_CAST(static_cast, int, request)) { - case 0: return "None"; - case HWC2_DISPLAY_REQUEST_FLIP_CLIENT_TARGET: return "FlipClientTarget"; - case HWC2_DISPLAY_REQUEST_WRITE_CLIENT_TARGET_TO_OUTPUT: - return "WriteClientTargetToOutput"; - case HWC2_DISPLAY_REQUEST_FLIP_CLIENT_TARGET | - HWC2_DISPLAY_REQUEST_WRITE_CLIENT_TARGET_TO_OUTPUT: - return "FlipClientTarget|WriteClientTargetToOutput"; - default: return "Unknown"; - } -} - -static inline const char* getDisplayTypeName(hwc2_display_type_t type) { - switch (type) { - case HWC2_DISPLAY_TYPE_INVALID: return "Invalid"; - case HWC2_DISPLAY_TYPE_PHYSICAL: return "Physical"; - case HWC2_DISPLAY_TYPE_VIRTUAL: return "Virtual"; - default: return "Unknown"; - } -} - -static inline const char* getDisplayConnectionTypeName(hwc2_display_connection_type_t type) { - switch (type) { - case HWC2_DISPLAY_CONNECTION_TYPE_INTERNAL: return "Internal"; - case HWC2_DISPLAY_CONNECTION_TYPE_EXTERNAL: return "External"; - default: return "Unknown"; - } -} - -static inline const char* getErrorName(hwc2_error_t error) { - switch (error) { - case HWC2_ERROR_NONE: return "None"; - case HWC2_ERROR_BAD_CONFIG: return "BadConfig"; - case HWC2_ERROR_BAD_DISPLAY: return "BadDisplay"; - case HWC2_ERROR_BAD_LAYER: return "BadLayer"; - case HWC2_ERROR_BAD_PARAMETER: return "BadParameter"; - case HWC2_ERROR_HAS_CHANGES: return "HasChanges"; - case HWC2_ERROR_NO_RESOURCES: return "NoResources"; - case HWC2_ERROR_NOT_VALIDATED: return "NotValidated"; - case HWC2_ERROR_UNSUPPORTED: return "Unsupported"; - case HWC2_ERROR_SEAMLESS_NOT_ALLOWED: return "SeamlessNotAllowed"; - case HWC2_ERROR_SEAMLESS_NOT_POSSIBLE: return "SeamlessNotPossible"; - default: return "Unknown"; - } -} - -static inline const char* getFunctionDescriptorName( - hwc2_function_descriptor_t desc) { - switch (desc) { - case HWC2_FUNCTION_INVALID: return "Invalid"; - case HWC2_FUNCTION_ACCEPT_DISPLAY_CHANGES: - return "AcceptDisplayChanges"; - case HWC2_FUNCTION_CREATE_LAYER: return "CreateLayer"; - case HWC2_FUNCTION_CREATE_VIRTUAL_DISPLAY: - return "CreateVirtualDisplay"; - case HWC2_FUNCTION_DESTROY_LAYER: return "DestroyLayer"; - case HWC2_FUNCTION_DESTROY_VIRTUAL_DISPLAY: - return "DestroyVirtualDisplay"; - case HWC2_FUNCTION_DUMP: return "Dump"; - case HWC2_FUNCTION_GET_ACTIVE_CONFIG: return "GetActiveConfig"; - case HWC2_FUNCTION_GET_CHANGED_COMPOSITION_TYPES: - return "GetChangedCompositionTypes"; - case HWC2_FUNCTION_GET_CLIENT_TARGET_SUPPORT: - return "GetClientTargetSupport"; - case HWC2_FUNCTION_GET_COLOR_MODES: return "GetColorModes"; - case HWC2_FUNCTION_GET_DISPLAY_ATTRIBUTE: return "GetDisplayAttribute"; - case HWC2_FUNCTION_GET_DISPLAY_CONFIGS: return "GetDisplayConfigs"; - case HWC2_FUNCTION_GET_DISPLAY_NAME: return "GetDisplayName"; - case HWC2_FUNCTION_GET_DISPLAY_REQUESTS: return "GetDisplayRequests"; - case HWC2_FUNCTION_GET_DISPLAY_TYPE: return "GetDisplayType"; - case HWC2_FUNCTION_GET_DOZE_SUPPORT: return "GetDozeSupport"; - case HWC2_FUNCTION_GET_HDR_CAPABILITIES: return "GetHdrCapabilities"; - case HWC2_FUNCTION_GET_MAX_VIRTUAL_DISPLAY_COUNT: - return "GetMaxVirtualDisplayCount"; - case HWC2_FUNCTION_GET_RELEASE_FENCES: return "GetReleaseFences"; - case HWC2_FUNCTION_PRESENT_DISPLAY: return "PresentDisplay"; - case HWC2_FUNCTION_REGISTER_CALLBACK: return "RegisterCallback"; - case HWC2_FUNCTION_SET_ACTIVE_CONFIG: return "SetActiveConfig"; - case HWC2_FUNCTION_SET_CLIENT_TARGET: return "SetClientTarget"; - case HWC2_FUNCTION_SET_COLOR_MODE: return "SetColorMode"; - case HWC2_FUNCTION_SET_COLOR_TRANSFORM: return "SetColorTransform"; - case HWC2_FUNCTION_SET_CURSOR_POSITION: return "SetCursorPosition"; - case HWC2_FUNCTION_SET_LAYER_BLEND_MODE: return "SetLayerBlendMode"; - case HWC2_FUNCTION_SET_LAYER_BUFFER: return "SetLayerBuffer"; - case HWC2_FUNCTION_SET_LAYER_COLOR: return "SetLayerColor"; - case HWC2_FUNCTION_SET_LAYER_COMPOSITION_TYPE: - return "SetLayerCompositionType"; - case HWC2_FUNCTION_SET_LAYER_DATASPACE: return "SetLayerDataspace"; - case HWC2_FUNCTION_SET_LAYER_DISPLAY_FRAME: - return "SetLayerDisplayFrame"; - case HWC2_FUNCTION_SET_LAYER_PLANE_ALPHA: return "SetLayerPlaneAlpha"; - case HWC2_FUNCTION_SET_LAYER_SIDEBAND_STREAM: - return "SetLayerSidebandStream"; - case HWC2_FUNCTION_SET_LAYER_SOURCE_CROP: return "SetLayerSourceCrop"; - case HWC2_FUNCTION_SET_LAYER_SURFACE_DAMAGE: - return "SetLayerSurfaceDamage"; - case HWC2_FUNCTION_SET_LAYER_TRANSFORM: return "SetLayerTransform"; - case HWC2_FUNCTION_SET_LAYER_VISIBLE_REGION: - return "SetLayerVisibleRegion"; - case HWC2_FUNCTION_SET_LAYER_Z_ORDER: return "SetLayerZOrder"; - case HWC2_FUNCTION_SET_OUTPUT_BUFFER: return "SetOutputBuffer"; - case HWC2_FUNCTION_SET_POWER_MODE: return "SetPowerMode"; - case HWC2_FUNCTION_SET_VSYNC_ENABLED: return "SetVsyncEnabled"; - case HWC2_FUNCTION_VALIDATE_DISPLAY: return "ValidateDisplay"; - case HWC2_FUNCTION_SET_LAYER_FLOAT_COLOR: return "SetLayerFloatColor"; - case HWC2_FUNCTION_SET_LAYER_PER_FRAME_METADATA: return "SetLayerPerFrameMetadata"; - case HWC2_FUNCTION_GET_PER_FRAME_METADATA_KEYS: return "GetPerFrameMetadataKeys"; - case HWC2_FUNCTION_SET_READBACK_BUFFER: return "SetReadbackBuffer"; - case HWC2_FUNCTION_GET_READBACK_BUFFER_ATTRIBUTES: return "GetReadbackBufferAttributes"; - case HWC2_FUNCTION_GET_READBACK_BUFFER_FENCE: return "GetReadbackBufferFence"; - case HWC2_FUNCTION_GET_RENDER_INTENTS: return "GetRenderIntents"; - case HWC2_FUNCTION_SET_COLOR_MODE_WITH_RENDER_INTENT: return "SetColorModeWithRenderIntent"; - case HWC2_FUNCTION_GET_DATASPACE_SATURATION_MATRIX: return "GetDataspaceSaturationMatrix"; - - // composer 2.3 - case HWC2_FUNCTION_GET_DISPLAY_IDENTIFICATION_DATA: return "GetDisplayIdentificationData"; - case HWC2_FUNCTION_GET_DISPLAY_CAPABILITIES: return "GetDisplayCapabilities"; - case HWC2_FUNCTION_SET_LAYER_COLOR_TRANSFORM: return "SetLayerColorTransform"; - case HWC2_FUNCTION_GET_DISPLAYED_CONTENT_SAMPLING_ATTRIBUTES: return "GetDisplayedContentSamplingAttributes"; - case HWC2_FUNCTION_SET_DISPLAYED_CONTENT_SAMPLING_ENABLED: return "SetDisplayedContentSamplingEnabled"; - case HWC2_FUNCTION_GET_DISPLAYED_CONTENT_SAMPLE: return "GetDisplayedContentSample"; - case HWC2_FUNCTION_SET_LAYER_PER_FRAME_METADATA_BLOBS: return "SetLayerPerFrameMetadataBlobs"; - case HWC2_FUNCTION_GET_DISPLAY_BRIGHTNESS_SUPPORT: return "GetDisplayBrightnessSupport"; - case HWC2_FUNCTION_SET_DISPLAY_BRIGHTNESS: return "SetDisplayBrightness"; - - // composer 2.4 - case HWC2_FUNCTION_GET_DISPLAY_CONNECTION_TYPE: return "GetDisplayConnectionType"; - case HWC2_FUNCTION_GET_DISPLAY_VSYNC_PERIOD: return "GetDisplayVsyncPeriod"; - case HWC2_FUNCTION_SET_ACTIVE_CONFIG_WITH_CONSTRAINTS: return "SetActiveConfigWithConstraints"; - case HWC2_FUNCTION_SET_AUTO_LOW_LATENCY_MODE: return "SetAutoLowLatencyMode"; - case HWC2_FUNCTION_GET_SUPPORTED_CONTENT_TYPES: return "GetSupportedContentTypes"; - case HWC2_FUNCTION_SET_CONTENT_TYPE: return "SetContentType"; - case HWC2_FUNCTION_GET_CLIENT_TARGET_PROPERTY: return "GetClientTargetProperty"; - case HWC2_FUNCTION_SET_LAYER_GENERIC_METADATA: return "SetLayerGenericMetadata"; - case HWC2_FUNCTION_GET_LAYER_GENERIC_METADATA_KEY: return "GetLayerGenericMetadataKey"; - - default: return "Unknown"; - } -} - -static inline const char* getLayerRequestName(hwc2_layer_request_t request) { - switch (__BIONIC_CAST(static_cast, int, request)) { - case 0: return "None"; - case HWC2_LAYER_REQUEST_CLEAR_CLIENT_TARGET: return "ClearClientTarget"; - default: return "Unknown"; - } -} - -static inline const char* getPowerModeName(hwc2_power_mode_t mode) { - switch (mode) { - case HWC2_POWER_MODE_OFF: return "Off"; - case HWC2_POWER_MODE_DOZE_SUSPEND: return "DozeSuspend"; - case HWC2_POWER_MODE_DOZE: return "Doze"; - case HWC2_POWER_MODE_ON: return "On"; - default: return "Unknown"; - } -} - -static inline const char* getContentTypeName(hwc2_content_type_t contentType) { - switch(contentType) { - case HWC2_CONTENT_TYPE_NONE: return "None"; - case HWC2_CONTENT_TYPE_GRAPHICS: return "Graphics"; - case HWC2_CONTENT_TYPE_PHOTO: return "Photo"; - case HWC2_CONTENT_TYPE_CINEMA: return "Cinema"; - case HWC2_CONTENT_TYPE_GAME: return "Game"; - default: return "Unknown"; - } -} - -static inline const char* getTransformName(hwc_transform_t transform) { - switch (__BIONIC_CAST(static_cast, int, transform)) { - case 0: return "None"; - case HWC_TRANSFORM_FLIP_H: return "FlipH"; - case HWC_TRANSFORM_FLIP_V: return "FlipV"; - case HWC_TRANSFORM_ROT_90: return "Rotate90"; - case HWC_TRANSFORM_ROT_180: return "Rotate180"; - case HWC_TRANSFORM_ROT_270: return "Rotate270"; - case HWC_TRANSFORM_FLIP_H_ROT_90: return "FlipHRotate90"; - case HWC_TRANSFORM_FLIP_V_ROT_90: return "FlipVRotate90"; - default: return "Unknown"; - } -} - -static inline const char* getVsyncName(hwc2_vsync_t vsync) { - switch (vsync) { - case HWC2_VSYNC_INVALID: return "Invalid"; - case HWC2_VSYNC_ENABLE: return "Enable"; - case HWC2_VSYNC_DISABLE: return "Disable"; - default: return "Unknown"; - } -} - -static inline const char* getDisplayedContentSamplingName( - hwc2_displayed_content_sampling_t sampling) { - switch (sampling) { - case HWC2_DISPLAYED_CONTENT_SAMPLING_INVALID: return "Invalid"; - case HWC2_DISPLAYED_CONTENT_SAMPLING_ENABLE: return "Enable"; - case HWC2_DISPLAYED_CONTENT_SAMPLING_DISABLE: return "Disable"; - default: return "Unknown"; - } -} - -static inline const char* getFormatColorComponentName(hwc2_format_color_component_t component) { - switch (component) { - case HWC2_FORMAT_COMPONENT_0: return "FirstComponent"; - case HWC2_FORMAT_COMPONENT_1: return "SecondComponent"; - case HWC2_FORMAT_COMPONENT_2: return "ThirdComponent"; - case HWC2_FORMAT_COMPONENT_3: return "FourthComponent"; - default: return "Unknown"; - } -} - -static inline const char* getDisplayCapabilityName(hwc2_display_capability_t capability) { - switch (capability) { - case HWC2_DISPLAY_CAPABILITY_INVALID: return "Invalid"; - case HWC2_DISPLAY_CAPABILITY_SKIP_CLIENT_COLOR_TRANSFORM: - return "SkipClientColorTransform"; - case HWC2_DISPLAY_CAPABILITY_DOZE: - return "Doze"; - case HWC2_DISPLAY_CAPABILITY_BRIGHTNESS: - return "Brightness"; - case HWC2_DISPLAY_CAPABILITY_AUTO_LOW_LATENCY_MODE: - return "AutoLowLatencyMode"; - default: - return "Unknown"; - } -} - -#define TO_STRING(E, T, printer) \ - inline std::string to_string(E value) { return printer(value); } \ - inline std::string to_string(T value) { return to_string(static_cast<E>(value)); } -#else // !HWC2_INCLUDE_STRINGIFICATION -#define TO_STRING(name, printer) -#endif // HWC2_INCLUDE_STRINGIFICATION - -/* - * C++11 features - */ - -#ifdef HWC2_USE_CPP11 -__END_DECLS - -#ifdef HWC2_INCLUDE_STRINGIFICATION -#include <string> -#endif - -namespace HWC2 { - -enum class Attribute : int32_t { - Invalid = HWC2_ATTRIBUTE_INVALID, - Width = HWC2_ATTRIBUTE_WIDTH, - Height = HWC2_ATTRIBUTE_HEIGHT, - VsyncPeriod = HWC2_ATTRIBUTE_VSYNC_PERIOD, - DpiX = HWC2_ATTRIBUTE_DPI_X, - DpiY = HWC2_ATTRIBUTE_DPI_Y, - ConfigGroup = HWC2_ATTRIBUTE_CONFIG_GROUP, -}; -TO_STRING(hwc2_attribute_t, Attribute, getAttributeName) - -enum class BlendMode : int32_t { - Invalid = HWC2_BLEND_MODE_INVALID, - None = HWC2_BLEND_MODE_NONE, - Premultiplied = HWC2_BLEND_MODE_PREMULTIPLIED, - Coverage = HWC2_BLEND_MODE_COVERAGE, -}; -TO_STRING(hwc2_blend_mode_t, BlendMode, getBlendModeName) - -enum class Callback : int32_t { - Invalid = HWC2_CALLBACK_INVALID, - Hotplug = HWC2_CALLBACK_HOTPLUG, - Refresh = HWC2_CALLBACK_REFRESH, - Vsync = HWC2_CALLBACK_VSYNC, - Vsync_2_4 = HWC2_CALLBACK_VSYNC_2_4, - VsyncPeriodTimingChanged = HWC2_CALLBACK_VSYNC_PERIOD_TIMING_CHANGED, - SeamlessPossible = HWC2_CALLBACK_SEAMLESS_POSSIBLE, -}; -TO_STRING(hwc2_callback_descriptor_t, Callback, getCallbackDescriptorName) - -enum class Capability : int32_t { - Invalid = HWC2_CAPABILITY_INVALID, - SidebandStream = HWC2_CAPABILITY_SIDEBAND_STREAM, - SkipClientColorTransform = HWC2_CAPABILITY_SKIP_CLIENT_COLOR_TRANSFORM, - PresentFenceIsNotReliable = HWC2_CAPABILITY_PRESENT_FENCE_IS_NOT_RELIABLE, - SkipValidate = HWC2_CAPABILITY_SKIP_VALIDATE, -}; -TO_STRING(hwc2_capability_t, Capability, getCapabilityName) - -enum class Composition : int32_t { - Invalid = HWC2_COMPOSITION_INVALID, - Client = HWC2_COMPOSITION_CLIENT, - Device = HWC2_COMPOSITION_DEVICE, - SolidColor = HWC2_COMPOSITION_SOLID_COLOR, - Cursor = HWC2_COMPOSITION_CURSOR, - Sideband = HWC2_COMPOSITION_SIDEBAND, -}; -TO_STRING(hwc2_composition_t, Composition, getCompositionName) - -enum class Connection : int32_t { - Invalid = HWC2_CONNECTION_INVALID, - Connected = HWC2_CONNECTION_CONNECTED, - Disconnected = HWC2_CONNECTION_DISCONNECTED, -}; -TO_STRING(hwc2_connection_t, Connection, getConnectionName) - -enum class DisplayRequest : int32_t { - FlipClientTarget = HWC2_DISPLAY_REQUEST_FLIP_CLIENT_TARGET, - WriteClientTargetToOutput = - HWC2_DISPLAY_REQUEST_WRITE_CLIENT_TARGET_TO_OUTPUT, -}; -TO_STRING(hwc2_display_request_t, DisplayRequest, getDisplayRequestName) - -enum class DisplayType : int32_t { - Invalid = HWC2_DISPLAY_TYPE_INVALID, - Physical = HWC2_DISPLAY_TYPE_PHYSICAL, - Virtual = HWC2_DISPLAY_TYPE_VIRTUAL, -}; -TO_STRING(hwc2_display_type_t, DisplayType, getDisplayTypeName) - -enum class DisplayConnectionType : uint32_t { - Internal = HWC2_DISPLAY_CONNECTION_TYPE_INTERNAL, - External = HWC2_DISPLAY_CONNECTION_TYPE_EXTERNAL, -}; -TO_STRING(hwc2_display_connection_type_t, DisplayConnectionType, getDisplayConnectionTypeName) - -enum class Error : int32_t { - None = HWC2_ERROR_NONE, - BadConfig = HWC2_ERROR_BAD_CONFIG, - BadDisplay = HWC2_ERROR_BAD_DISPLAY, - BadLayer = HWC2_ERROR_BAD_LAYER, - BadParameter = HWC2_ERROR_BAD_PARAMETER, - HasChanges = HWC2_ERROR_HAS_CHANGES, - NoResources = HWC2_ERROR_NO_RESOURCES, - NotValidated = HWC2_ERROR_NOT_VALIDATED, - Unsupported = HWC2_ERROR_UNSUPPORTED, - SeamlessNotAllowed = HWC2_ERROR_SEAMLESS_NOT_ALLOWED, - SeamlessNotPossible = HWC2_ERROR_SEAMLESS_NOT_POSSIBLE, -}; -TO_STRING(hwc2_error_t, Error, getErrorName) - -enum class FunctionDescriptor : int32_t { - Invalid = HWC2_FUNCTION_INVALID, - AcceptDisplayChanges = HWC2_FUNCTION_ACCEPT_DISPLAY_CHANGES, - CreateLayer = HWC2_FUNCTION_CREATE_LAYER, - CreateVirtualDisplay = HWC2_FUNCTION_CREATE_VIRTUAL_DISPLAY, - DestroyLayer = HWC2_FUNCTION_DESTROY_LAYER, - DestroyVirtualDisplay = HWC2_FUNCTION_DESTROY_VIRTUAL_DISPLAY, - Dump = HWC2_FUNCTION_DUMP, - GetActiveConfig = HWC2_FUNCTION_GET_ACTIVE_CONFIG, - GetChangedCompositionTypes = HWC2_FUNCTION_GET_CHANGED_COMPOSITION_TYPES, - GetClientTargetSupport = HWC2_FUNCTION_GET_CLIENT_TARGET_SUPPORT, - GetColorModes = HWC2_FUNCTION_GET_COLOR_MODES, - GetDisplayAttribute = HWC2_FUNCTION_GET_DISPLAY_ATTRIBUTE, - GetDisplayConfigs = HWC2_FUNCTION_GET_DISPLAY_CONFIGS, - GetDisplayName = HWC2_FUNCTION_GET_DISPLAY_NAME, - GetDisplayRequests = HWC2_FUNCTION_GET_DISPLAY_REQUESTS, - GetDisplayType = HWC2_FUNCTION_GET_DISPLAY_TYPE, - GetDozeSupport = HWC2_FUNCTION_GET_DOZE_SUPPORT, - GetHdrCapabilities = HWC2_FUNCTION_GET_HDR_CAPABILITIES, - GetMaxVirtualDisplayCount = HWC2_FUNCTION_GET_MAX_VIRTUAL_DISPLAY_COUNT, - GetReleaseFences = HWC2_FUNCTION_GET_RELEASE_FENCES, - PresentDisplay = HWC2_FUNCTION_PRESENT_DISPLAY, - RegisterCallback = HWC2_FUNCTION_REGISTER_CALLBACK, - SetActiveConfig = HWC2_FUNCTION_SET_ACTIVE_CONFIG, - SetClientTarget = HWC2_FUNCTION_SET_CLIENT_TARGET, - SetColorMode = HWC2_FUNCTION_SET_COLOR_MODE, - SetColorTransform = HWC2_FUNCTION_SET_COLOR_TRANSFORM, - SetCursorPosition = HWC2_FUNCTION_SET_CURSOR_POSITION, - SetLayerBlendMode = HWC2_FUNCTION_SET_LAYER_BLEND_MODE, - SetLayerBuffer = HWC2_FUNCTION_SET_LAYER_BUFFER, - SetLayerColor = HWC2_FUNCTION_SET_LAYER_COLOR, - SetLayerCompositionType = HWC2_FUNCTION_SET_LAYER_COMPOSITION_TYPE, - SetLayerDataspace = HWC2_FUNCTION_SET_LAYER_DATASPACE, - SetLayerDisplayFrame = HWC2_FUNCTION_SET_LAYER_DISPLAY_FRAME, - SetLayerPlaneAlpha = HWC2_FUNCTION_SET_LAYER_PLANE_ALPHA, - SetLayerSidebandStream = HWC2_FUNCTION_SET_LAYER_SIDEBAND_STREAM, - SetLayerSourceCrop = HWC2_FUNCTION_SET_LAYER_SOURCE_CROP, - SetLayerSurfaceDamage = HWC2_FUNCTION_SET_LAYER_SURFACE_DAMAGE, - SetLayerTransform = HWC2_FUNCTION_SET_LAYER_TRANSFORM, - SetLayerVisibleRegion = HWC2_FUNCTION_SET_LAYER_VISIBLE_REGION, - SetLayerZOrder = HWC2_FUNCTION_SET_LAYER_Z_ORDER, - SetOutputBuffer = HWC2_FUNCTION_SET_OUTPUT_BUFFER, - SetPowerMode = HWC2_FUNCTION_SET_POWER_MODE, - SetVsyncEnabled = HWC2_FUNCTION_SET_VSYNC_ENABLED, - ValidateDisplay = HWC2_FUNCTION_VALIDATE_DISPLAY, - SetLayerFloatColor = HWC2_FUNCTION_SET_LAYER_FLOAT_COLOR, - SetLayerPerFrameMetadata = HWC2_FUNCTION_SET_LAYER_PER_FRAME_METADATA, - GetPerFrameMetadataKeys = HWC2_FUNCTION_GET_PER_FRAME_METADATA_KEYS, - SetReadbackBuffer = HWC2_FUNCTION_SET_READBACK_BUFFER, - GetReadbackBufferAttributes = HWC2_FUNCTION_GET_READBACK_BUFFER_ATTRIBUTES, - GetReadbackBufferFence = HWC2_FUNCTION_GET_READBACK_BUFFER_FENCE, - GetRenderIntents = HWC2_FUNCTION_GET_RENDER_INTENTS, - SetColorModeWithRenderIntent = HWC2_FUNCTION_SET_COLOR_MODE_WITH_RENDER_INTENT, - GetDataspaceSaturationMatrix = HWC2_FUNCTION_GET_DATASPACE_SATURATION_MATRIX, - - // composer 2.3 - GetDisplayIdentificationData = HWC2_FUNCTION_GET_DISPLAY_IDENTIFICATION_DATA, - GetDisplayCapabilities = HWC2_FUNCTION_GET_DISPLAY_CAPABILITIES, - SetLayerColorTransform = HWC2_FUNCTION_SET_LAYER_COLOR_TRANSFORM, - GetDisplayedContentSamplingAttributes = HWC2_FUNCTION_GET_DISPLAYED_CONTENT_SAMPLING_ATTRIBUTES, - SetDisplayedContentSamplingEnabled = HWC2_FUNCTION_SET_DISPLAYED_CONTENT_SAMPLING_ENABLED, - GetDisplayedContentSample = HWC2_FUNCTION_GET_DISPLAYED_CONTENT_SAMPLE, - SetLayerPerFrameMetadataBlobs = HWC2_FUNCTION_SET_LAYER_PER_FRAME_METADATA_BLOBS, - GetDisplayBrightnessSupport = HWC2_FUNCTION_GET_DISPLAY_BRIGHTNESS_SUPPORT, - SetDisplayBrightness = HWC2_FUNCTION_SET_DISPLAY_BRIGHTNESS, - - // composer 2.4 - GetDisplayConnectionType = HWC2_FUNCTION_GET_DISPLAY_CONNECTION_TYPE, - GetDisplayVsyncPeriod = HWC2_FUNCTION_GET_DISPLAY_VSYNC_PERIOD, - SetActiveConfigWithConstraints = HWC2_FUNCTION_SET_ACTIVE_CONFIG_WITH_CONSTRAINTS, - SetAutoLowLatencyMode = HWC2_FUNCTION_SET_AUTO_LOW_LATENCY_MODE, - GetSupportedContentTypes = HWC2_FUNCTION_GET_SUPPORTED_CONTENT_TYPES, - SetContentType = HWC2_FUNCTION_SET_CONTENT_TYPE, - GetClientTargetProperty = HWC2_FUNCTION_GET_CLIENT_TARGET_PROPERTY, - SetLayerGenericMetadata = HWC2_FUNCTION_SET_LAYER_GENERIC_METADATA, - GetLayerGenericMetadataKey = HWC2_FUNCTION_GET_LAYER_GENERIC_METADATA_KEY, -}; -TO_STRING(hwc2_function_descriptor_t, FunctionDescriptor, - getFunctionDescriptorName) - -enum class LayerRequest : int32_t { - ClearClientTarget = HWC2_LAYER_REQUEST_CLEAR_CLIENT_TARGET, -}; -TO_STRING(hwc2_layer_request_t, LayerRequest, getLayerRequestName) - -enum class PowerMode : int32_t { - Off = HWC2_POWER_MODE_OFF, - DozeSuspend = HWC2_POWER_MODE_DOZE_SUSPEND, - Doze = HWC2_POWER_MODE_DOZE, - On = HWC2_POWER_MODE_ON, -}; -TO_STRING(hwc2_power_mode_t, PowerMode, getPowerModeName) - -enum class ContentType : int32_t { - None = HWC2_CONTENT_TYPE_NONE, - Graphics = HWC2_CONTENT_TYPE_GRAPHICS, - Photo = HWC2_CONTENT_TYPE_PHOTO, - Cinema = HWC2_CONTENT_TYPE_CINEMA, - Game = HWC2_CONTENT_TYPE_GAME, -}; -TO_STRING(hwc2_content_type_t, ContentType, getContentTypeName) - -enum class Transform : int32_t { - None = 0, - FlipH = HWC_TRANSFORM_FLIP_H, - FlipV = HWC_TRANSFORM_FLIP_V, - Rotate90 = HWC_TRANSFORM_ROT_90, - Rotate180 = HWC_TRANSFORM_ROT_180, - Rotate270 = HWC_TRANSFORM_ROT_270, - FlipHRotate90 = HWC_TRANSFORM_FLIP_H_ROT_90, - FlipVRotate90 = HWC_TRANSFORM_FLIP_V_ROT_90, -}; -TO_STRING(hwc_transform_t, Transform, getTransformName) - -enum class Vsync : int32_t { - Invalid = HWC2_VSYNC_INVALID, - Enable = HWC2_VSYNC_ENABLE, - Disable = HWC2_VSYNC_DISABLE, -}; -TO_STRING(hwc2_vsync_t, Vsync, getVsyncName) - -enum class DisplayCapability : int32_t { - Invalid = HWC2_DISPLAY_CAPABILITY_INVALID, - SkipClientColorTransform = HWC2_DISPLAY_CAPABILITY_SKIP_CLIENT_COLOR_TRANSFORM, - Doze = HWC2_DISPLAY_CAPABILITY_DOZE, - Brightness = HWC2_DISPLAY_CAPABILITY_BRIGHTNESS, - AutoLowLatencyMode = HWC2_DISPLAY_CAPABILITY_AUTO_LOW_LATENCY_MODE, -}; -TO_STRING(hwc2_display_capability_t, DisplayCapability, getDisplayCapabilityName) - -} // namespace HWC2 - -__BEGIN_DECLS -#endif // HWC2_USE_CPP11 - -/* - * Typedefs - */ - -typedef void (*hwc2_function_pointer_t)(); - -typedef void* hwc2_callback_data_t; -typedef uint32_t hwc2_config_t; -typedef uint64_t hwc2_display_t; -typedef uint64_t hwc2_layer_t; -typedef uint32_t hwc2_vsync_period_t; - -/* - * Device Struct - */ - -typedef struct hwc2_device { - /* Must be the first member of this struct, since a pointer to this struct - * will be generated by casting from a hw_device_t* */ - struct hw_device_t common; - - /* getCapabilities(..., outCount, outCapabilities) - * - * Provides a list of capabilities (described in the definition of - * hwc2_capability_t above) supported by this device. This list must - * not change after the device has been loaded. - * - * Parameters: - * outCount - if outCapabilities was NULL, the number of capabilities - * which would have been returned; if outCapabilities was not NULL, - * the number of capabilities returned, which must not exceed the - * value stored in outCount prior to the call - * outCapabilities - a list of capabilities supported by this device; may - * be NULL, in which case this function must write into outCount the - * number of capabilities which would have been written into - * outCapabilities - */ - void (*getCapabilities)(struct hwc2_device* device, uint32_t* outCount, - int32_t* /*hwc2_capability_t*/ outCapabilities); - - /* getFunction(..., descriptor) - * - * Returns a function pointer which implements the requested description. - * - * Parameters: - * descriptor - the function to return - * - * Returns either a function pointer implementing the requested descriptor - * or NULL if the described function is not supported by this device. - */ - hwc2_function_pointer_t (*getFunction)(struct hwc2_device* device, - int32_t /*hwc2_function_descriptor_t*/ descriptor); -} hwc2_device_t; - -static inline int hwc2_open(const struct hw_module_t* module, - hwc2_device_t** device) { - return module->methods->open(module, HWC_HARDWARE_COMPOSER, - TO_HW_DEVICE_T_OPEN(device)); -} - -static inline int hwc2_close(hwc2_device_t* device) { - return device->common.close(&device->common); -} - -/* - * Callbacks - * - * All of these callbacks take as their first parameter the callbackData which - * was provided at the time of callback registration, so this parameter is - * omitted from the described parameter lists. - */ - -/* hotplug(..., display, connected) - * Descriptor: HWC2_CALLBACK_HOTPLUG - * Will be provided to all HWC2 devices - * - * Notifies the client that the given display has either been connected or - * disconnected. Every active display (even a built-in physical display) must - * trigger at least one hotplug notification, even if it only occurs immediately - * after callback registration. - * - * The client may call back into the device on the same thread to query display - * properties (such as width, height, and vsync period), and other threads may - * call into the device while the callback is in progress. The device must - * serialize calls to this callback such that only one thread is calling it at a - * time. - * - * Displays which have been connected are assumed to be in HWC2_POWER_MODE_OFF, - * and the vsync callback should not be called for a display until vsync has - * been enabled with setVsyncEnabled. - * - * Parameters: - * display - the display which has been hotplugged - * connected - whether the display has been connected or disconnected - */ -typedef void (*HWC2_PFN_HOTPLUG)(hwc2_callback_data_t callbackData, - hwc2_display_t display, int32_t /*hwc2_connection_t*/ connected); - -/* refresh(..., display) - * Descriptor: HWC2_CALLBACK_REFRESH - * Will be provided to all HWC2 devices - * - * Notifies the client to trigger a screen refresh. This forces all layer state - * for this display to be resent, and the display to be validated and presented, - * even if there have been no changes. - * - * This refresh will occur some time after the callback is initiated, but not - * necessarily before it returns. This thread, however, is guaranteed not to - * call back into the device, thus it is safe to trigger this callback from - * other functions which call into the device. - * - * Parameters: - * display - the display to refresh - */ -typedef void (*HWC2_PFN_REFRESH)(hwc2_callback_data_t callbackData, - hwc2_display_t display); - -/* vsync(..., display, timestamp) - * Descriptor: HWC2_CALLBACK_VSYNC - * Will be provided to all HWC2 devices - * - * Notifies the client that a vsync event has occurred. This callback must - * only be triggered when vsync is enabled for this display (through - * setVsyncEnabled). - * - * This callback should be triggered from a thread of at least - * HAL_PRIORITY_URGENT_DISPLAY with as little latency as possible, typically - * less than 0.5 ms. This thread is guaranteed not to call back into the device. - * - * Parameters: - * display - the display which has received a vsync event - * timestamp - the CLOCK_MONOTONIC time at which the vsync event occurred, in - * nanoseconds - */ -typedef void (*HWC2_PFN_VSYNC)(hwc2_callback_data_t callbackData, - hwc2_display_t display, int64_t timestamp); - -/* vsync_2_4(..., display, timestamp, vsyncPeriodNanos) - * Descriptor: HWC2_CALLBACK_VSYNC_2_4 - * Required for HWC2 devices for composer 2.4 - * - * Notifies the client that a vsync event has occurred. This callback must - * only be triggered when vsync is enabled for this display (through - * setVsyncEnabled). - * - * This callback should be triggered from a thread of at least - * HAL_PRIORITY_URGENT_DISPLAY with as little latency as possible, typically - * less than 0.5 ms. This thread is guaranteed not to call back into the device. - * - * Parameters: - * display - the display which has received a vsync event - * timestamp - the CLOCK_MONOTONIC time at which the vsync event occurred, in - * nanoseconds - * vsyncPeriodNanos - the display vsync period in nanoseconds i.e. the next onVsync2_4 is - * expected to be called vsyncPeriod nanoseconds after this call. - */ -typedef void (*HWC2_PFN_VSYNC_2_4)(hwc2_callback_data_t callbackData, - hwc2_display_t display, int64_t timestamp, hwc2_vsync_period_t vsyncPeriodNanos); - -/* vsyncPeriodTimingChanged(..., display, updated_timeline) - * Descriptor: HWC2_CALLBACK_VSYNC_PERIOD_TIMING_CHANGED - * Optional for HWC2 devices for composer 2.4 - * - * Notifies the client that the previously reported timing for vsync period change has been - * updated. This may occur if the composer missed the deadline for changing the vsync period - * or the client submitted a refresh frame too late. - * - * This callback should be triggered from a thread of at least - * HAL_PRIORITY_URGENT_DISPLAY with as little latency as possible, typically - * less than 0.5 ms. This thread is guaranteed not to call back into the device. - * - * Parameters: - * display - the display which has received a vsync event - * updated_timeline - new timeline for the vsync period change - */ -typedef void (*HWC2_PFN_VSYNC_PERIOD_TIMING_CHANGED)(hwc2_callback_data_t callbackData, - hwc2_display_t display, hwc_vsync_period_change_timeline_t* updated_timeline); - -/* SeamlessPossible(..., display) - * Descriptor: HWC2_CALLBACK_SEAMLESS_POSSIBLE - * Optional for HWC2 devices for composer 2.4 - * - * Notifies the client that the conditions which previously led to returning SEAMLESS_NOT_POSSIBLE - * from setActiveConfigWithConstraints have changed and now seamless may be possible. Client should - * retry calling setActiveConfigWithConstraints. - * - * - * Parameters: - * display - a display setActiveConfigWithConstraints previously failed with - * SEAMLESS_NOT_POSSIBLE. - */ -typedef void (*HWC2_PFN_SEAMLESS_POSSIBLE)(hwc2_callback_data_t callbackData, - hwc2_display_t display); - -/* - * Device Functions - * - * All of these functions take as their first parameter a device pointer, so - * this parameter is omitted from the described parameter lists. - */ - -/* createVirtualDisplay(..., width, height, format, outDisplay) - * Descriptor: HWC2_FUNCTION_CREATE_VIRTUAL_DISPLAY - * Must be provided by all HWC2 devices - * - * Creates a new virtual display with the given width and height. The format - * passed into this function is the default format requested by the consumer of - * the virtual display output buffers. If a different format will be returned by - * the device, it should be returned in this parameter so it can be set properly - * when handing the buffers to the consumer. - * - * The display will be assumed to be on from the time the first frame is - * presented until the display is destroyed. - * - * Parameters: - * width - width in pixels - * height - height in pixels - * format - prior to the call, the default output buffer format selected by - * the consumer; after the call, the format the device will produce - * outDisplay - the newly-created virtual display; pointer will be non-NULL - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_UNSUPPORTED - the width or height is too large for the device to - * be able to create a virtual display - * HWC2_ERROR_NO_RESOURCES - the device is unable to create a new virtual - * display at this time - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_CREATE_VIRTUAL_DISPLAY)( - hwc2_device_t* device, uint32_t width, uint32_t height, - int32_t* /*android_pixel_format_t*/ format, hwc2_display_t* outDisplay); - -/* destroyVirtualDisplay(..., display) - * Descriptor: HWC2_FUNCTION_DESTROY_VIRTUAL_DISPLAY - * Must be provided by all HWC2 devices - * - * Destroys a virtual display. After this call all resources consumed by this - * display may be freed by the device and any operations performed on this - * display should fail. - * - * Parameters: - * display - the virtual display to destroy - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_BAD_PARAMETER - the display handle which was passed in does not - * refer to a virtual display - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_DESTROY_VIRTUAL_DISPLAY)( - hwc2_device_t* device, hwc2_display_t display); - -/* dump(..., outSize, outBuffer) - * Descriptor: HWC2_FUNCTION_DUMP - * Must be provided by all HWC2 devices - * - * Retrieves implementation-defined debug information, which will be displayed - * during, for example, `dumpsys SurfaceFlinger`. - * - * If called with outBuffer == NULL, the device should store a copy of the - * desired output and return its length in bytes in outSize. If the device - * already has a stored copy, that copy should be purged and replaced with a - * fresh copy. - * - * If called with outBuffer != NULL, the device should copy its stored version - * of the output into outBuffer and store how many bytes of data it copied into - * outSize. Prior to this call, the client will have populated outSize with the - * maximum number of bytes outBuffer can hold. The device must not write more - * than this amount into outBuffer. If the device does not currently have a - * stored copy, then it should return 0 in outSize. - * - * Any data written into outBuffer need not be null-terminated. - * - * Parameters: - * outSize - if outBuffer was NULL, the number of bytes needed to copy the - * device's stored output; if outBuffer was not NULL, the number of bytes - * written into it, which must not exceed the value stored in outSize - * prior to the call; pointer will be non-NULL - * outBuffer - the buffer to write the dump output into; may be NULL as - * described above; data written into this buffer need not be - * null-terminated - */ -typedef void (*HWC2_PFN_DUMP)(hwc2_device_t* device, uint32_t* outSize, - char* outBuffer); - -/* getMaxVirtualDisplayCount(...) - * Descriptor: HWC2_FUNCTION_GET_MAX_VIRTUAL_DISPLAY_COUNT - * Must be provided by all HWC2 devices - * - * Returns the maximum number of virtual displays supported by this device - * (which may be 0). The client will not attempt to create more than this many - * virtual displays on this device. This number must not change for the lifetime - * of the device. - */ -typedef uint32_t (*HWC2_PFN_GET_MAX_VIRTUAL_DISPLAY_COUNT)( - hwc2_device_t* device); - -/* registerCallback(..., descriptor, callbackData, pointer) - * Descriptor: HWC2_FUNCTION_REGISTER_CALLBACK - * Must be provided by all HWC2 devices - * - * Provides a callback for the device to call. All callbacks take a callbackData - * item as the first parameter, so this value should be stored with the callback - * for later use. The callbackData may differ from one callback to another. If - * this function is called multiple times with the same descriptor, later - * callbacks replace earlier ones. - * - * Parameters: - * descriptor - which callback should be set - * callBackdata - opaque data which must be passed back through the callback - * pointer - a non-NULL function pointer corresponding to the descriptor - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_PARAMETER - descriptor was invalid - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_REGISTER_CALLBACK)( - hwc2_device_t* device, - int32_t /*hwc2_callback_descriptor_t*/ descriptor, - hwc2_callback_data_t callbackData, hwc2_function_pointer_t pointer); - -/* getDataspaceSaturationMatrix(..., dataspace, outMatrix) - * Descriptor: HWC2_FUNCTION_GET_DATASPACE_SATURATION_MATRIX - * Provided by HWC2 devices which don't return nullptr function pointer. - * - * Get the saturation matrix of the specified dataspace. The saturation matrix - * can be used to approximate the dataspace saturation operation performed by - * the HWC2 device when non-colorimetric mapping is allowed. It is to be - * applied on linear pixel values. - * - * Parameters: - * dataspace - the dataspace to query for - * outMatrix - a column-major 4x4 matrix (16 floats). It must be an identity - * matrix unless dataspace is HAL_DATASPACE_SRGB_LINEAR. - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_PARAMETER - dataspace was invalid - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_DATASPACE_SATURATION_MATRIX)( - hwc2_device_t* device, int32_t /*android_dataspace_t*/ dataspace, - float* outMatrix); - -/* - * Display Functions - * - * All of these functions take as their first two parameters a device pointer - * and a display handle, so these parameters are omitted from the described - * parameter lists. - */ - -/* acceptDisplayChanges(...) - * Descriptor: HWC2_FUNCTION_ACCEPT_DISPLAY_CHANGES - * Must be provided by all HWC2 devices - * - * Accepts the changes required by the device from the previous validateDisplay - * call (which may be queried using getChangedCompositionTypes) and revalidates - * the display. This function is equivalent to requesting the changed types from - * getChangedCompositionTypes, setting those types on the corresponding layers, - * and then calling validateDisplay again. - * - * After this call it must be valid to present this display. Calling this after - * validateDisplay returns 0 changes must succeed with HWC2_ERROR_NONE, but - * should have no other effect. - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_NOT_VALIDATED - validateDisplay has not been called - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_ACCEPT_DISPLAY_CHANGES)( - hwc2_device_t* device, hwc2_display_t display); - -/* createLayer(..., outLayer) - * Descriptor: HWC2_FUNCTION_CREATE_LAYER - * Must be provided by all HWC2 devices - * - * Creates a new layer on the given display. - * - * Parameters: - * outLayer - the handle of the new layer; pointer will be non-NULL - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_NO_RESOURCES - the device was unable to create this layer - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_CREATE_LAYER)(hwc2_device_t* device, - hwc2_display_t display, hwc2_layer_t* outLayer); - -/* destroyLayer(..., layer) - * Descriptor: HWC2_FUNCTION_DESTROY_LAYER - * Must be provided by all HWC2 devices - * - * Destroys the given layer. - * - * Parameters: - * layer - the handle of the layer to destroy - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_BAD_LAYER - an invalid layer handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_DESTROY_LAYER)( - hwc2_device_t* device, hwc2_display_t display, hwc2_layer_t layer); - -/* getActiveConfig(..., outConfig) - * Descriptor: HWC2_FUNCTION_GET_ACTIVE_CONFIG - * Must be provided by all HWC2 devices - * - * Retrieves which display configuration is currently active. - * - * If no display configuration is currently active, this function must return - * HWC2_ERROR_BAD_CONFIG and place no configuration handle in outConfig. It is - * the responsibility of the client to call setActiveConfig with a valid - * configuration before attempting to present anything on the display. - * - * Parameters: - * outConfig - the currently active display configuration; pointer will be - * non-NULL - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_BAD_CONFIG - no configuration is currently active - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_ACTIVE_CONFIG)( - hwc2_device_t* device, hwc2_display_t display, - hwc2_config_t* outConfig); - -/* getChangedCompositionTypes(..., outNumElements, outLayers, outTypes) - * Descriptor: HWC2_FUNCTION_GET_CHANGED_COMPOSITION_TYPES - * Must be provided by all HWC2 devices - * - * Retrieves the layers for which the device requires a different composition - * type than had been set prior to the last call to validateDisplay. The client - * will either update its state with these types and call acceptDisplayChanges, - * or will set new types and attempt to validate the display again. - * - * outLayers and outTypes may be NULL to retrieve the number of elements which - * will be returned. The number of elements returned must be the same as the - * value returned in outNumTypes from the last call to validateDisplay. - * - * Parameters: - * outNumElements - if outLayers or outTypes were NULL, the number of layers - * and types which would have been returned; if both were non-NULL, the - * number of elements returned in outLayers and outTypes, which must not - * exceed the value stored in outNumElements prior to the call; pointer - * will be non-NULL - * outLayers - an array of layer handles - * outTypes - an array of composition types, each corresponding to an element - * of outLayers - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_NOT_VALIDATED - validateDisplay has not been called for this - * display - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_CHANGED_COMPOSITION_TYPES)( - hwc2_device_t* device, hwc2_display_t display, - uint32_t* outNumElements, hwc2_layer_t* outLayers, - int32_t* /*hwc2_composition_t*/ outTypes); - -/* getClientTargetSupport(..., width, height, format, dataspace) - * Descriptor: HWC2_FUNCTION_GET_CLIENT_TARGET_SUPPORT - * Must be provided by all HWC2 devices - * - * Returns whether a client target with the given properties can be handled by - * the device. - * - * The valid formats can be found in android_pixel_format_t in - * <system/graphics.h>. - * - * For more about dataspaces, see setLayerDataspace. - * - * This function must return true for a client target with width and height - * equal to the active display configuration dimensions, - * HAL_PIXEL_FORMAT_RGBA_8888, and HAL_DATASPACE_UNKNOWN. It is not required to - * return true for any other configuration. - * - * Parameters: - * width - client target width in pixels - * height - client target height in pixels - * format - client target format - * dataspace - client target dataspace, as described in setLayerDataspace - * - * Returns HWC2_ERROR_NONE if the given configuration is supported or one of the - * following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_UNSUPPORTED - the given configuration is not supported - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_CLIENT_TARGET_SUPPORT)( - hwc2_device_t* device, hwc2_display_t display, uint32_t width, - uint32_t height, int32_t /*android_pixel_format_t*/ format, - int32_t /*android_dataspace_t*/ dataspace); - -/* getColorModes(..., outNumModes, outModes) - * Descriptor: HWC2_FUNCTION_GET_COLOR_MODES - * Must be provided by all HWC2 devices - * - * Returns the color modes supported on this display. - * - * The valid color modes can be found in android_color_mode_t in - * <system/graphics.h>. All HWC2 devices must support at least - * HAL_COLOR_MODE_NATIVE. - * - * outNumModes may be NULL to retrieve the number of modes which will be - * returned. - * - * Parameters: - * outNumModes - if outModes was NULL, the number of modes which would have - * been returned; if outModes was not NULL, the number of modes returned, - * which must not exceed the value stored in outNumModes prior to the - * call; pointer will be non-NULL - * outModes - an array of color modes - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_COLOR_MODES)( - hwc2_device_t* device, hwc2_display_t display, uint32_t* outNumModes, - int32_t* /*android_color_mode_t*/ outModes); - -/* getRenderIntents(..., mode, outNumIntents, outIntents) - * Descriptor: HWC2_FUNCTION_GET_RENDER_INTENTS - * Provided by HWC2 devices which don't return nullptr function pointer. - * - * Returns the render intents supported on this display. - * - * The valid render intents can be found in android_render_intent_v1_1_t in - * <system/graphics.h>. All HWC2 devices must support at least - * HAL_RENDER_INTENT_COLORIMETRIC. - * - * outNumIntents may be NULL to retrieve the number of intents which will be - * returned. - * - * Parameters: - * mode - the color mode to query the render intents for - * outNumIntents - if outIntents was NULL, the number of intents which would - * have been returned; if outIntents was not NULL, the number of intents - * returned, which must not exceed the value stored in outNumIntents - * prior to the call; pointer will be non-NULL - * outIntents - an array of render intents - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_RENDER_INTENTS)( - hwc2_device_t* device, hwc2_display_t display, int32_t mode, - uint32_t* outNumIntents, - int32_t* /*android_render_intent_v1_1_t*/ outIntents); - -/* getDisplayAttribute(..., config, attribute, outValue) - * Descriptor: HWC2_FUNCTION_GET_DISPLAY_ATTRIBUTE - * Must be provided by all HWC2 devices - * - * Returns a display attribute value for a particular display configuration. - * - * Any attribute which is not supported or for which the value is unknown by the - * device must return a value of -1. - * - * Parameters: - * config - the display configuration for which to return attribute values - * attribute - the attribute to query - * outValue - the value of the attribute; the pointer will be non-NULL - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_BAD_CONFIG - config does not name a valid configuration for this - * display - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_DISPLAY_ATTRIBUTE)( - hwc2_device_t* device, hwc2_display_t display, hwc2_config_t config, - int32_t /*hwc2_attribute_t*/ attribute, int32_t* outValue); - -/* getDisplayConfigs(..., outNumConfigs, outConfigs) - * Descriptor: HWC2_FUNCTION_GET_DISPLAY_CONFIGS - * Must be provided by all HWC2 devices - * - * Returns handles for all of the valid display configurations on this display. - * - * outConfigs may be NULL to retrieve the number of elements which will be - * returned. - * - * Parameters: - * outNumConfigs - if outConfigs was NULL, the number of configurations which - * would have been returned; if outConfigs was not NULL, the number of - * configurations returned, which must not exceed the value stored in - * outNumConfigs prior to the call; pointer will be non-NULL - * outConfigs - an array of configuration handles - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_DISPLAY_CONFIGS)( - hwc2_device_t* device, hwc2_display_t display, uint32_t* outNumConfigs, - hwc2_config_t* outConfigs); - -/* getDisplayName(..., outSize, outName) - * Descriptor: HWC2_FUNCTION_GET_DISPLAY_NAME - * Must be provided by all HWC2 devices - * - * Returns a human-readable version of the display's name. - * - * outName may be NULL to retrieve the length of the name. - * - * Parameters: - * outSize - if outName was NULL, the number of bytes needed to return the - * name if outName was not NULL, the number of bytes written into it, - * which must not exceed the value stored in outSize prior to the call; - * pointer will be non-NULL - * outName - the display's name - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_DISPLAY_NAME)( - hwc2_device_t* device, hwc2_display_t display, uint32_t* outSize, - char* outName); - -/* getDisplayRequests(..., outDisplayRequests, outNumElements, outLayers, - * outLayerRequests) - * Descriptor: HWC2_FUNCTION_GET_DISPLAY_REQUESTS - * Must be provided by all HWC2 devices - * - * Returns the display requests and the layer requests required for the last - * validated configuration. - * - * Display requests provide information about how the client should handle the - * client target. Layer requests provide information about how the client - * should handle an individual layer. - * - * If outLayers or outLayerRequests is NULL, the required number of layers and - * requests must be returned in outNumElements, but this number may also be - * obtained from validateDisplay as outNumRequests (outNumElements must be equal - * to the value returned in outNumRequests from the last call to - * validateDisplay). - * - * Parameters: - * outDisplayRequests - the display requests for the current validated state - * outNumElements - if outLayers or outLayerRequests were NULL, the number of - * elements which would have been returned, which must be equal to the - * value returned in outNumRequests from the last validateDisplay call on - * this display; if both were not NULL, the number of elements in - * outLayers and outLayerRequests, which must not exceed the value stored - * in outNumElements prior to the call; pointer will be non-NULL - * outLayers - an array of layers which all have at least one request - * outLayerRequests - the requests corresponding to each element of outLayers - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_NOT_VALIDATED - validateDisplay has not been called for this - * display - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_DISPLAY_REQUESTS)( - hwc2_device_t* device, hwc2_display_t display, - int32_t* /*hwc2_display_request_t*/ outDisplayRequests, - uint32_t* outNumElements, hwc2_layer_t* outLayers, - int32_t* /*hwc2_layer_request_t*/ outLayerRequests); - -/* getDisplayType(..., outType) - * Descriptor: HWC2_FUNCTION_GET_DISPLAY_TYPE - * Must be provided by all HWC2 devices - * - * Returns whether the given display is a physical or virtual display. - * - * Parameters: - * outType - the type of the display; pointer will be non-NULL - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_DISPLAY_TYPE)( - hwc2_device_t* device, hwc2_display_t display, - int32_t* /*hwc2_display_type_t*/ outType); - -/* getDisplayIdentificationData(..., outPort, outDataSize, outData) - * Descriptor: HWC2_FUNCTION_GET_DISPLAY_IDENTIFICATION_DATA - * Optional for HWC2 devices - * - * If supported, getDisplayIdentificationData returns the port and data that - * describe a physical display. The port is a unique number that identifies a - * physical connector (e.g. eDP, HDMI) for display output. The data blob is - * parsed to determine its format, typically EDID 1.3 as specified in VESA - * E-EDID Standard Release A Revision 1. - * - * Devices for which display identification is unsupported must return null when - * getFunction is called with HWC2_FUNCTION_GET_DISPLAY_IDENTIFICATION_DATA. - * - * Parameters: - * outPort - the connector to which the display is connected; - * pointer will be non-NULL - * outDataSize - if outData is NULL, the size in bytes of the data which would - * have been returned; if outData is not NULL, the size of outData, which - * must not exceed the value stored in outDataSize prior to the call; - * pointer will be non-NULL - * outData - the EDID 1.3 blob identifying the display - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_DISPLAY_IDENTIFICATION_DATA)( - hwc2_device_t* device, hwc2_display_t display, uint8_t* outPort, - uint32_t* outDataSize, uint8_t* outData); - -/* getDozeSupport(..., outSupport) - * Descriptor: HWC2_FUNCTION_GET_DOZE_SUPPORT - * Must be provided by all HWC2 devices - * - * Returns whether the given display supports HWC2_POWER_MODE_DOZE and - * HWC2_POWER_MODE_DOZE_SUSPEND. DOZE_SUSPEND may not provide any benefit over - * DOZE (see the definition of hwc2_power_mode_t for more information), but if - * both DOZE and DOZE_SUSPEND are no different from HWC2_POWER_MODE_ON, the - * device should not claim support. - * - * Parameters: - * outSupport - whether the display supports doze modes (1 for yes, 0 for no); - * pointer will be non-NULL - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_DOZE_SUPPORT)( - hwc2_device_t* device, hwc2_display_t display, int32_t* outSupport); - -/* getHdrCapabilities(..., outNumTypes, outTypes, outMaxLuminance, - * outMaxAverageLuminance, outMinLuminance) - * Descriptor: HWC2_FUNCTION_GET_HDR_CAPABILITIES - * Must be provided by all HWC2 devices - * - * Returns the high dynamic range (HDR) capabilities of the given display, which - * are invariant with regard to the active configuration. - * - * Displays which are not HDR-capable must return no types in outTypes and set - * outNumTypes to 0. - * - * If outTypes is NULL, the required number of HDR types must be returned in - * outNumTypes. - * - * Parameters: - * outNumTypes - if outTypes was NULL, the number of types which would have - * been returned; if it was not NULL, the number of types stored in - * outTypes, which must not exceed the value stored in outNumTypes prior - * to the call; pointer will be non-NULL - * outTypes - an array of HDR types, may have 0 elements if the display is not - * HDR-capable - * outMaxLuminance - the desired content maximum luminance for this display in - * cd/m^2; pointer will be non-NULL - * outMaxAverageLuminance - the desired content maximum frame-average - * luminance for this display in cd/m^2; pointer will be non-NULL - * outMinLuminance - the desired content minimum luminance for this display in - * cd/m^2; pointer will be non-NULL - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_HDR_CAPABILITIES)( - hwc2_device_t* device, hwc2_display_t display, uint32_t* outNumTypes, - int32_t* /*android_hdr_t*/ outTypes, float* outMaxLuminance, - float* outMaxAverageLuminance, float* outMinLuminance); - -/* getReleaseFences(..., outNumElements, outLayers, outFences) - * Descriptor: HWC2_FUNCTION_GET_RELEASE_FENCES - * Must be provided by all HWC2 devices - * - * Retrieves the release fences for device layers on this display which will - * receive new buffer contents this frame. - * - * A release fence is a file descriptor referring to a sync fence object which - * will be signaled after the device has finished reading from the buffer - * presented in the prior frame. This indicates that it is safe to start writing - * to the buffer again. If a given layer's fence is not returned from this - * function, it will be assumed that the buffer presented on the previous frame - * is ready to be written. - * - * The fences returned by this function should be unique for each layer (even if - * they point to the same underlying sync object), and ownership of the fences - * is transferred to the client, which is responsible for closing them. - * - * If outLayers or outFences is NULL, the required number of layers and fences - * must be returned in outNumElements. - * - * Parameters: - * outNumElements - if outLayers or outFences were NULL, the number of - * elements which would have been returned; if both were not NULL, the - * number of elements in outLayers and outFences, which must not exceed - * the value stored in outNumElements prior to the call; pointer will be - * non-NULL - * outLayers - an array of layer handles - * outFences - an array of sync fence file descriptors as described above, - * each corresponding to an element of outLayers - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_RELEASE_FENCES)( - hwc2_device_t* device, hwc2_display_t display, uint32_t* outNumElements, - hwc2_layer_t* outLayers, int32_t* outFences); - -/* presentDisplay(..., outPresentFence) - * Descriptor: HWC2_FUNCTION_PRESENT_DISPLAY - * Must be provided by all HWC2 devices - * - * Presents the current display contents on the screen (or in the case of - * virtual displays, into the output buffer). - * - * Prior to calling this function, the display must be successfully validated - * with validateDisplay. Note that setLayerBuffer and setLayerSurfaceDamage - * specifically do not count as layer state, so if there are no other changes - * to the layer state (or to the buffer's properties as described in - * setLayerBuffer), then it is safe to call this function without first - * validating the display. - * - * If this call succeeds, outPresentFence will be populated with a file - * descriptor referring to a present sync fence object. For physical displays, - * this fence will be signaled at the vsync when the result of composition of - * this frame starts to appear (for video-mode panels) or starts to transfer to - * panel memory (for command-mode panels). For virtual displays, this fence will - * be signaled when writes to the output buffer have completed and it is safe to - * read from it. - * - * Parameters: - * outPresentFence - a sync fence file descriptor as described above; pointer - * will be non-NULL - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_NO_RESOURCES - no valid output buffer has been set for a virtual - * display - * HWC2_ERROR_NOT_VALIDATED - validateDisplay has not successfully been called - * for this display - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_PRESENT_DISPLAY)( - hwc2_device_t* device, hwc2_display_t display, - int32_t* outPresentFence); - -/* setActiveConfig(..., config) - * Descriptor: HWC2_FUNCTION_SET_ACTIVE_CONFIG - * Must be provided by all HWC2 devices - * - * Sets the active configuration for this display. Upon returning, the given - * display configuration should be active and remain so until either this - * function is called again or the display is disconnected. - * - * Parameters: - * config - the new display configuration - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_BAD_CONFIG - the configuration handle passed in is not valid for - * this display - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_ACTIVE_CONFIG)( - hwc2_device_t* device, hwc2_display_t display, hwc2_config_t config); - -/* setClientTarget(..., target, acquireFence, dataspace, damage) - * Descriptor: HWC2_FUNCTION_SET_CLIENT_TARGET - * Must be provided by all HWC2 devices - * - * Sets the buffer handle which will receive the output of client composition. - * Layers marked as HWC2_COMPOSITION_CLIENT will be composited into this buffer - * prior to the call to presentDisplay, and layers not marked as - * HWC2_COMPOSITION_CLIENT should be composited with this buffer by the device. - * - * The buffer handle provided may be null if no layers are being composited by - * the client. This must not result in an error (unless an invalid display - * handle is also provided). - * - * Also provides a file descriptor referring to an acquire sync fence object, - * which will be signaled when it is safe to read from the client target buffer. - * If it is already safe to read from this buffer, -1 may be passed instead. - * The device must ensure that it is safe for the client to close this file - * descriptor at any point after this function is called. - * - * For more about dataspaces, see setLayerDataspace. - * - * The damage parameter describes a surface damage region as defined in the - * description of setLayerSurfaceDamage. - * - * Will be called before presentDisplay if any of the layers are marked as - * HWC2_COMPOSITION_CLIENT. If no layers are so marked, then it is not - * necessary to call this function. It is not necessary to call validateDisplay - * after changing the target through this function. - * - * Parameters: - * target - the new target buffer - * acquireFence - a sync fence file descriptor as described above - * dataspace - the dataspace of the buffer, as described in setLayerDataspace - * damage - the surface damage region - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_BAD_PARAMETER - the new target handle was invalid - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_CLIENT_TARGET)( - hwc2_device_t* device, hwc2_display_t display, buffer_handle_t target, - int32_t acquireFence, int32_t /*android_dataspace_t*/ dataspace, - hwc_region_t damage); - -/* setColorMode(..., mode) - * Descriptor: HWC2_FUNCTION_SET_COLOR_MODE - * Must be provided by all HWC2 devices - * - * Sets the color mode of the given display. - * - * This must be called outside of validateDisplay/presentDisplay, and it takes - * effect on next presentDisplay. - * - * The valid color modes can be found in android_color_mode_t in - * <system/graphics.h>. All HWC2 devices must support at least - * HAL_COLOR_MODE_NATIVE, and displays are assumed to be in this mode upon - * hotplug. - * - * Parameters: - * mode - the mode to set - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_BAD_PARAMETER - mode is not a valid color mode - * HWC2_ERROR_UNSUPPORTED - mode is not supported on this display - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_COLOR_MODE)( - hwc2_device_t* device, hwc2_display_t display, - int32_t /*android_color_mode_t*/ mode); - -/* setColorModeWithIntent(..., mode, intent) - * Descriptor: HWC2_FUNCTION_SET_COLOR_MODE_WITH_RENDER_INTENT - * Provided by HWC2 devices which don't return nullptr function pointer. - * - * This must be called outside of validateDisplay/presentDisplay, and it takes - * effect on next presentDisplay. - * - * The valid color modes and render intents can be found in - * android_color_mode_t and android_render_intent_v1_1_t in - * <system/graphics.h>. All HWC2 devices must support at least - * HAL_COLOR_MODE_NATIVE and HAL_RENDER_INTENT_COLORIMETRIC, and displays are - * assumed to be in this mode and intent upon hotplug. - * - * Parameters: - * mode - the mode to set - * intent - the intent to set - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_BAD_PARAMETER - mode/intent is not a valid color mode or - * render intent - * HWC2_ERROR_UNSUPPORTED - mode or intent is not supported on this display - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_COLOR_MODE_WITH_RENDER_INTENT)( - hwc2_device_t* device, hwc2_display_t display, - int32_t /*android_color_mode_t*/ mode, - int32_t /*android_render_intent_v1_1_t */ intent); - -/* setColorTransform(..., matrix, hint) - * Descriptor: HWC2_FUNCTION_SET_COLOR_TRANSFORM - * Must be provided by all HWC2 devices - * - * Sets a color transform which will be applied after composition. - * - * If hint is not HAL_COLOR_TRANSFORM_ARBITRARY, then the device may use the - * hint to apply the desired color transform instead of using the color matrix - * directly. - * - * If the device is not capable of either using the hint or the matrix to apply - * the desired color transform, it should force all layers to client composition - * during validateDisplay. - * - * If HWC2_CAPABILITY_SKIP_CLIENT_COLOR_TRANSFORM is present, then the client - * will never apply the color transform during client composition, even if all - * layers are being composed by the client. - * - * The matrix provided is an affine color transformation of the following form: - * - * |r.r r.g r.b 0| - * |g.r g.g g.b 0| - * |b.r b.g b.b 0| - * |Tr Tg Tb 1| - * - * This matrix will be provided in row-major form: {r.r, r.g, r.b, 0, g.r, ...}. - * - * Given a matrix of this form and an input color [R_in, G_in, B_in], the output - * color [R_out, G_out, B_out] will be: - * - * R_out = R_in * r.r + G_in * g.r + B_in * b.r + Tr - * G_out = R_in * r.g + G_in * g.g + B_in * b.g + Tg - * B_out = R_in * r.b + G_in * g.b + B_in * b.b + Tb - * - * Parameters: - * matrix - a 4x4 transform matrix (16 floats) as described above - * hint - a hint value which may be used instead of the given matrix unless it - * is HAL_COLOR_TRANSFORM_ARBITRARY - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_BAD_PARAMETER - hint is not a valid color transform hint - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_COLOR_TRANSFORM)( - hwc2_device_t* device, hwc2_display_t display, const float* matrix, - int32_t /*android_color_transform_t*/ hint); - -/* getPerFrameMetadataKeys(..., outKeys) - * Descriptor: HWC2_FUNCTION_GET_PER_FRAME_METADATA_KEYS - * Optional for HWC2 devices - * - * If supported (getFunction(HWC2_FUNCTION_GET_PER_FRAME_METADATA_KEYS) is non-null), - * getPerFrameMetadataKeys returns the list of supported PerFrameMetadataKeys - * which are invariant with regard to the active configuration. - * - * Devices which are not HDR-capable, must return null when getFunction is called - * with HWC2_FUNCTION_GET_PER_FRAME_METADATA_KEYS. - * - * If outKeys is NULL, the required number of PerFrameMetadataKey keys - * must be returned in outNumKeys. - * - * Parameters: - * outNumKeys - if outKeys is NULL, the number of keys which would have - * been returned; if outKeys is not NULL, the number of keys stored in - * outKeys, which must not exceed the value stored in outNumKeys prior - * to the call; pointer will be non-NULL - * outKeys - an array of hwc2_per_frame_metadata_key_t keys - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_PER_FRAME_METADATA_KEYS)( - hwc2_device_t* device, hwc2_display_t display, uint32_t* outNumKeys, - int32_t* /*hwc2_per_frame_metadata_key_t*/ outKeys); - -/* setOutputBuffer(..., buffer, releaseFence) - * Descriptor: HWC2_FUNCTION_SET_OUTPUT_BUFFER - * Must be provided by all HWC2 devices - * - * Sets the output buffer for a virtual display. That is, the buffer to which - * the composition result will be written. - * - * Also provides a file descriptor referring to a release sync fence object, - * which will be signaled when it is safe to write to the output buffer. If it - * is already safe to write to the output buffer, -1 may be passed instead. The - * device must ensure that it is safe for the client to close this file - * descriptor at any point after this function is called. - * - * Must be called at least once before presentDisplay, but does not have any - * interaction with layer state or display validation. - * - * Parameters: - * buffer - the new output buffer - * releaseFence - a sync fence file descriptor as described above - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_BAD_PARAMETER - the new output buffer handle was invalid - * HWC2_ERROR_UNSUPPORTED - display does not refer to a virtual display - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_OUTPUT_BUFFER)( - hwc2_device_t* device, hwc2_display_t display, buffer_handle_t buffer, - int32_t releaseFence); - -/* setPowerMode(..., mode) - * Descriptor: HWC2_FUNCTION_SET_POWER_MODE - * Must be provided by all HWC2 devices - * - * Sets the power mode of the given display. The transition must be complete - * when this function returns. It is valid to call this function multiple times - * with the same power mode. - * - * All displays must support HWC2_POWER_MODE_ON and HWC2_POWER_MODE_OFF. Whether - * a display supports HWC2_POWER_MODE_DOZE or HWC2_POWER_MODE_DOZE_SUSPEND may - * be queried using getDozeSupport. - * - * Parameters: - * mode - the new power mode - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_BAD_PARAMETER - mode was not a valid power mode - * HWC2_ERROR_UNSUPPORTED - mode was a valid power mode, but is not supported - * on this display - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_POWER_MODE)( - hwc2_device_t* device, hwc2_display_t display, - int32_t /*hwc2_power_mode_t*/ mode); - -/* getReadbackBufferAttributes(..., outFormat, outDataspace) - * Optional for HWC2 devices - * - * Returns the format which should be used when allocating a buffer for use by - * device readback as well as the dataspace in which its contents should be - * interpreted. - * - * If readback is not supported by this HWC implementation, this call will also - * be able to return HWC2_ERROR_UNSUPPORTED so we can fall back to another method. - * Returning NULL to a getFunction request for this function will also indicate - * that readback is not supported. - * - * The width and height of this buffer will be those of the currently-active - * display configuration, and the usage flags will consist of the following: - * BufferUsage::CPU_READ | BufferUsage::GPU_TEXTURE | - * BufferUsage::COMPOSER_OUTPUT - * - * The format and dataspace provided must be sufficient such that if a - * correctly-configured buffer is passed into setReadbackBuffer, filled by - * the device, and then displayed by the client as a full-screen buffer, the - * output of the display remains the same (subject to the note about protected - * content in the description of setReadbackBuffer). - * - * If the active configuration or color mode of this display has changed since - * the previous call to this function, it will be called again prior to setting - * a readback buffer such that the returned format and dataspace can be updated - * accordingly. - * - * Parameters: - * outFormat - the format the client should use when allocating a device - * readback buffer; pointer will be non-NULL - * outDataspace - the dataspace the client will use when interpreting the - * contents of a device readback buffer; pointer will be non-NULL - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * - * See also: - * setReadbackBuffer - * getReadbackBufferFence - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_READBACK_BUFFER_ATTRIBUTES)( - hwc2_device_t* device, hwc2_display_t display, - int32_t* /*android_pixel_format_t*/ outFormat, - int32_t* /*android_dataspace_t*/ outDataspace); - -/* getReadbackBufferFence(..., outFence) - * Optional for HWC2 devices - * - * Returns an acquire sync fence file descriptor which will signal when the - * buffer provided to setReadbackBuffer has been filled by the device and is - * safe for the client to read. - * - * If it is already safe to read from this buffer, -1 may be returned instead. - * The client takes ownership of this file descriptor and is responsible for - * closing it when it is no longer needed. - * - * This function will be called immediately after the composition cycle being - * captured into the readback buffer. The complete ordering of a readback buffer - * capture is as follows: - * - * getReadbackBufferAttributes - * // Readback buffer is allocated - * // Many frames may pass - * - * setReadbackBuffer - * validateDisplay - * presentDisplay - * getReadbackBufferFence - * // Implicitly wait on the acquire fence before accessing the buffer - * - * Parameters: - * outFence - a sync fence file descriptor as described above; pointer - * will be non-NULL - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_NO_RESOURCES - the readback operation was successful, but - * resulted in a different validate result than would have occurred - * without readback - * HWC2_ERROR_UNSUPPORTED - the readback operation was unsuccessful because - * of resource constraints, the presence of protected content, or other - * reasons; -1 must be returned in outFence - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_READBACK_BUFFER_FENCE)( - hwc2_device_t* device, hwc2_display_t display, - int32_t* outFence); - -/* setReadbackBuffer(..., buffer, releaseFence) - * Optional for HWC2 devices - * - * Sets the readback buffer to be filled with the contents of the next - * composition performed for this display (i.e., the contents present at the - * time of the next validateDisplay/presentDisplay cycle). - * - * This buffer will have been allocated as described in - * getReadbackBufferAttributes and will be interpreted as being in the dataspace - * provided by the same. - * - * If there is hardware protected content on the display at the time of the next - * composition, the area of the readback buffer covered by such content must be - * completely black. Any areas of the buffer not covered by such content may - * optionally be black as well. - * - * The release fence file descriptor provided works identically to the one - * described for setOutputBuffer. - * - * This function will not be called between any call to validateDisplay and a - * subsequent call to presentDisplay. - * - * Parameters: - * buffer - the new readback buffer - * releaseFence - a sync fence file descriptor as described in setOutputBuffer - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_BAD_PARAMETER - the new readback buffer handle was invalid - * - * See also: - * getReadbackBufferAttributes - * getReadbackBufferFence - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_READBACK_BUFFER)( - hwc2_device_t* device, hwc2_display_t display, - buffer_handle_t buffer, int32_t releaseFence); - -/* setVsyncEnabled(..., enabled) - * Descriptor: HWC2_FUNCTION_SET_VSYNC_ENABLED - * Must be provided by all HWC2 devices - * - * Enables or disables the vsync signal for the given display. Virtual displays - * never generate vsync callbacks, and any attempt to enable vsync for a virtual - * display though this function must return HWC2_ERROR_NONE and have no other - * effect. - * - * Parameters: - * enabled - whether to enable or disable vsync - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_BAD_PARAMETER - enabled was an invalid value - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_VSYNC_ENABLED)( - hwc2_device_t* device, hwc2_display_t display, - int32_t /*hwc2_vsync_t*/ enabled); - -/* validateDisplay(..., outNumTypes, outNumRequests) - * Descriptor: HWC2_FUNCTION_VALIDATE_DISPLAY - * Must be provided by all HWC2 devices - * - * Instructs the device to inspect all of the layer state and determine if - * there are any composition type changes necessary before presenting the - * display. Permitted changes are described in the definition of - * hwc2_composition_t above. - * - * Also returns the number of layer requests required - * by the given layer configuration. - * - * Parameters: - * outNumTypes - the number of composition type changes required by the - * device; if greater than 0, the client must either set and validate new - * types, or call acceptDisplayChanges to accept the changes returned by - * getChangedCompositionTypes; must be the same as the number of changes - * returned by getChangedCompositionTypes (see the declaration of that - * function for more information); pointer will be non-NULL - * outNumRequests - the number of layer requests required by this layer - * configuration; must be equal to the number of layer requests returned - * by getDisplayRequests (see the declaration of that function for - * more information); pointer will be non-NULL - * - * Returns HWC2_ERROR_NONE if no changes are necessary and it is safe to present - * the display using the current layer state. Otherwise returns one of the - * following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_HAS_CHANGES - outNumTypes was greater than 0 (see parameter list - * for more information) - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_VALIDATE_DISPLAY)( - hwc2_device_t* device, hwc2_display_t display, - uint32_t* outNumTypes, uint32_t* outNumRequests); - -/* - * Layer Functions - * - * These are functions which operate on layers, but which do not modify state - * that must be validated before use. See also 'Layer State Functions' below. - * - * All of these functions take as their first three parameters a device pointer, - * a display handle for the display which contains the layer, and a layer - * handle, so these parameters are omitted from the described parameter lists. - */ - -/* setCursorPosition(..., x, y) - * Descriptor: HWC2_FUNCTION_SET_CURSOR_POSITION - * Must be provided by all HWC2 devices - * - * Asynchonously sets the position of a cursor layer. - * - * Prior to validateDisplay, a layer may be marked as HWC2_COMPOSITION_CURSOR. - * If validation succeeds (i.e., the device does not request a composition - * change for that layer), then once a buffer has been set for the layer and it - * has been presented, its position may be set by this function at any time - * between presentDisplay and any subsequent validateDisplay calls for this - * display. - * - * Once validateDisplay is called, this function will not be called again until - * the validate/present sequence is completed. - * - * May be called from any thread so long as it is not interleaved with the - * validate/present sequence as described above. - * - * Parameters: - * x - the new x coordinate (in pixels from the left of the screen) - * y - the new y coordinate (in pixels from the top of the screen) - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_BAD_LAYER - the layer is invalid or is not currently marked as - * HWC2_COMPOSITION_CURSOR - * HWC2_ERROR_NOT_VALIDATED - the device is currently in the middle of the - * validate/present sequence - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_CURSOR_POSITION)( - hwc2_device_t* device, hwc2_display_t display, hwc2_layer_t layer, - int32_t x, int32_t y); - -/* setLayerBuffer(..., buffer, acquireFence) - * Descriptor: HWC2_FUNCTION_SET_LAYER_BUFFER - * Must be provided by all HWC2 devices - * - * Sets the buffer handle to be displayed for this layer. If the buffer - * properties set at allocation time (width, height, format, and usage) have not - * changed since the previous frame, it is not necessary to call validateDisplay - * before calling presentDisplay unless new state needs to be validated in the - * interim. - * - * Also provides a file descriptor referring to an acquire sync fence object, - * which will be signaled when it is safe to read from the given buffer. If it - * is already safe to read from the buffer, -1 may be passed instead. The - * device must ensure that it is safe for the client to close this file - * descriptor at any point after this function is called. - * - * This function must return HWC2_ERROR_NONE and have no other effect if called - * for a layer with a composition type of HWC2_COMPOSITION_SOLID_COLOR (because - * it has no buffer) or HWC2_COMPOSITION_SIDEBAND or HWC2_COMPOSITION_CLIENT - * (because synchronization and buffer updates for these layers are handled - * elsewhere). - * - * Parameters: - * buffer - the buffer handle to set - * acquireFence - a sync fence file descriptor as described above - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_LAYER - an invalid layer handle was passed in - * HWC2_ERROR_BAD_PARAMETER - the buffer handle passed in was invalid - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_LAYER_BUFFER)( - hwc2_device_t* device, hwc2_display_t display, hwc2_layer_t layer, - buffer_handle_t buffer, int32_t acquireFence); - -/* setLayerSurfaceDamage(..., damage) - * Descriptor: HWC2_FUNCTION_SET_LAYER_SURFACE_DAMAGE - * Must be provided by all HWC2 devices - * - * Provides the region of the source buffer which has been modified since the - * last frame. This region does not need to be validated before calling - * presentDisplay. - * - * Once set through this function, the damage region remains the same until a - * subsequent call to this function. - * - * If damage.numRects > 0, then it may be assumed that any portion of the source - * buffer not covered by one of the rects has not been modified this frame. If - * damage.numRects == 0, then the whole source buffer must be treated as if it - * has been modified. - * - * If the layer's contents are not modified relative to the prior frame, damage - * will contain exactly one empty rect([0, 0, 0, 0]). - * - * The damage rects are relative to the pre-transformed buffer, and their origin - * is the top-left corner. They will not exceed the dimensions of the latched - * buffer. - * - * Parameters: - * damage - the new surface damage region - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_LAYER - an invalid layer handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_LAYER_SURFACE_DAMAGE)( - hwc2_device_t* device, hwc2_display_t display, hwc2_layer_t layer, - hwc_region_t damage); - -/* setLayerPerFrameMetadata(..., numMetadata, metadata) - * Descriptor: HWC2_FUNCTION_SET_LAYER_PER_FRAME_METADATA - * Optional for HWC2 devices - * - * If supported (getFunction(HWC2_FUNCTION_SET_LAYER_PER_FRAME_METADATA) is - * non-null), sets the metadata for the given display for all following - * frames. - * - * Upon returning from this function, the metadata change must have - * fully taken effect. - * - * This function will only be called if getPerFrameMetadataKeys is non-NULL - * and returns at least one key. - * - * Parameters: - * numElements is the number of elements in each of the keys and metadata arrays - * keys is a pointer to the array of keys. - * outMetadata is a pointer to the corresponding array of metadata. - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_BAD_PARAMETER - metadata is not valid - * HWC2_ERROR_UNSUPPORTED - metadata is not supported on this display - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_LAYER_PER_FRAME_METADATA)( - hwc2_device_t* device, hwc2_display_t display, hwc2_layer_t layer, - uint32_t numElements, const int32_t* /*hw2_per_frame_metadata_key_t*/ keys, - const float* metadata); - -/* setLayerPerFrameMetadataBlobs(...,numElements, keys, sizes, blobs) - * Descriptor: HWC2_FUNCTION_SET_LAYER_PER_FRAME_METADATA_BLOBS - * Optional for HWC2 devices - * - * If supported, (getFunction(HWC2_FUNCTION_SET_LAYER_PER_FRAME_METADATA_BLOBS) - * is non-null), sets the metadata for the given display and layer. - * - * Upon returning from this function, the metadata change must have fully taken - * effect. - * - * This function must only be called if getPerFrameMetadataKeys is non-NULL - * and returns at least one key that corresponds to a blob type. - * - * Current valid blob type keys are: HDR10_PLUS_SEI - * - * Parameters: - * numElements is the number of elements in each of the keys, sizes, and - * metadata arrays - * keys is a pointer to an array of keys. Current valid keys are those listed - * above as valid blob type keys. - * sizes is a pointer to an array of unsigned ints specifying the sizes of - * each metadata blob - * metadata is a pointer to a blob of data holding all blobs contiguously in - * memory - * - * Returns HWC2_ERROR_NONE or one of the following erros: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_BAD_PARAMETER - sizes of keys and metadata parameters does - * not match numElements, numElements < 0, or keys contains a - * non-valid key (see above for current valid blob type keys). - * HWC2_ERROR_UNSUPPORTED - metadata is not supported on this display - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_LAYER_PER_FRAME_METADATA_BLOBS)( - hwc2_device_t* device, hwc2_display_t display, hwc2_layer_t layer, - uint32_t numElements, const int32_t* keys, const uint32_t* sizes, - const uint8_t* metadata); -/* - * Layer State Functions - * - * These functions modify the state of a given layer. They do not take effect - * until the display configuration is successfully validated with - * validateDisplay and the display contents are presented with presentDisplay. - * - * All of these functions take as their first three parameters a device pointer, - * a display handle for the display which contains the layer, and a layer - * handle, so these parameters are omitted from the described parameter lists. - */ - -/* setLayerBlendMode(..., mode) - * Descriptor: HWC2_FUNCTION_SET_LAYER_BLEND_MODE - * Must be provided by all HWC2 devices - * - * Sets the blend mode of the given layer. - * - * Parameters: - * mode - the new blend mode - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_LAYER - an invalid layer handle was passed in - * HWC2_ERROR_BAD_PARAMETER - an invalid blend mode was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_LAYER_BLEND_MODE)( - hwc2_device_t* device, hwc2_display_t display, hwc2_layer_t layer, - int32_t /*hwc2_blend_mode_t*/ mode); - -/* setLayerColor(..., color) - * Descriptor: HWC2_FUNCTION_SET_LAYER_COLOR - * Must be provided by all HWC2 devices - * - * Sets the color of the given layer. If the composition type of the layer is - * not HWC2_COMPOSITION_SOLID_COLOR, this call must return HWC2_ERROR_NONE and - * have no other effect. - * - * Parameters: - * color - the new color - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_LAYER - an invalid layer handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_LAYER_COLOR)( - hwc2_device_t* device, hwc2_display_t display, hwc2_layer_t layer, - hwc_color_t color); - -/* setLayerFloatColor(..., color) - * Descriptor: HWC2_FUNCTION_SET_LAYER_FLOAT_COLOR - * Provided by HWC2 devices which don't return nullptr function pointer. - * - * Sets the color of the given layer. If the composition type of the layer is - * not HWC2_COMPOSITION_SOLID_COLOR, this call must return HWC2_ERROR_NONE and - * have no other effect. - * - * Parameters: - * color - the new color in float type, rage is [0.0, 1.0], the colorspace is - * defined by the dataspace that gets set by calling setLayerDataspace. - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_LAYER - an invalid layer handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_LAYER_FLOAT_COLOR)( - hwc2_device_t* device, hwc2_display_t display, hwc2_layer_t layer, - hwc_float_color_t color); - -/* setLayerCompositionType(..., type) - * Descriptor: HWC2_FUNCTION_SET_LAYER_COMPOSITION_TYPE - * Must be provided by all HWC2 devices - * - * Sets the desired composition type of the given layer. During validateDisplay, - * the device may request changes to the composition types of any of the layers - * as described in the definition of hwc2_composition_t above. - * - * Parameters: - * type - the new composition type - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_LAYER - an invalid layer handle was passed in - * HWC2_ERROR_BAD_PARAMETER - an invalid composition type was passed in - * HWC2_ERROR_UNSUPPORTED - a valid composition type was passed in, but it is - * not supported by this device - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_LAYER_COMPOSITION_TYPE)( - hwc2_device_t* device, hwc2_display_t display, hwc2_layer_t layer, - int32_t /*hwc2_composition_t*/ type); - -/* setLayerDataspace(..., dataspace) - * Descriptor: HWC2_FUNCTION_SET_LAYER_DATASPACE - * Must be provided by all HWC2 devices - * - * Sets the dataspace that the current buffer on this layer is in. - * - * The dataspace provides more information about how to interpret the buffer - * contents, such as the encoding standard and color transform. - * - * See the values of android_dataspace_t in <system/graphics.h> for more - * information. - * - * Parameters: - * dataspace - the new dataspace - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_LAYER - an invalid layer handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_LAYER_DATASPACE)( - hwc2_device_t* device, hwc2_display_t display, hwc2_layer_t layer, - int32_t /*android_dataspace_t*/ dataspace); - -/* setLayerDisplayFrame(..., frame) - * Descriptor: HWC2_FUNCTION_SET_LAYER_DISPLAY_FRAME - * Must be provided by all HWC2 devices - * - * Sets the display frame (the portion of the display covered by a layer) of the - * given layer. This frame will not exceed the display dimensions. - * - * Parameters: - * frame - the new display frame - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_LAYER - an invalid layer handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_LAYER_DISPLAY_FRAME)( - hwc2_device_t* device, hwc2_display_t display, hwc2_layer_t layer, - hwc_rect_t frame); - -/* setLayerPlaneAlpha(..., alpha) - * Descriptor: HWC2_FUNCTION_SET_LAYER_PLANE_ALPHA - * Must be provided by all HWC2 devices - * - * Sets an alpha value (a floating point value in the range [0.0, 1.0]) which - * will be applied to the whole layer. It can be conceptualized as a - * preprocessing step which applies the following function: - * if (blendMode == HWC2_BLEND_MODE_PREMULTIPLIED) - * out.rgb = in.rgb * planeAlpha - * out.a = in.a * planeAlpha - * - * If the device does not support this operation on a layer which is marked - * HWC2_COMPOSITION_DEVICE, it must request a composition type change to - * HWC2_COMPOSITION_CLIENT upon the next validateDisplay call. - * - * Parameters: - * alpha - the plane alpha value to apply - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_LAYER - an invalid layer handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_LAYER_PLANE_ALPHA)( - hwc2_device_t* device, hwc2_display_t display, hwc2_layer_t layer, - float alpha); - -/* setLayerSidebandStream(..., stream) - * Descriptor: HWC2_FUNCTION_SET_LAYER_SIDEBAND_STREAM - * Provided by HWC2 devices which support HWC2_CAPABILITY_SIDEBAND_STREAM - * - * Sets the sideband stream for this layer. If the composition type of the given - * layer is not HWC2_COMPOSITION_SIDEBAND, this call must return HWC2_ERROR_NONE - * and have no other effect. - * - * Parameters: - * stream - the new sideband stream - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_LAYER - an invalid layer handle was passed in - * HWC2_ERROR_BAD_PARAMETER - an invalid sideband stream was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_LAYER_SIDEBAND_STREAM)( - hwc2_device_t* device, hwc2_display_t display, hwc2_layer_t layer, - const native_handle_t* stream); - -/* setLayerSourceCrop(..., crop) - * Descriptor: HWC2_FUNCTION_SET_LAYER_SOURCE_CROP - * Must be provided by all HWC2 devices - * - * Sets the source crop (the portion of the source buffer which will fill the - * display frame) of the given layer. This crop rectangle will not exceed the - * dimensions of the latched buffer. - * - * If the device is not capable of supporting a true float source crop (i.e., it - * will truncate or round the floats to integers), it should set this layer to - * HWC2_COMPOSITION_CLIENT when crop is non-integral for the most accurate - * rendering. - * - * If the device cannot support float source crops, but still wants to handle - * the layer, it should use the following code (or similar) to convert to - * an integer crop: - * intCrop.left = (int) ceilf(crop.left); - * intCrop.top = (int) ceilf(crop.top); - * intCrop.right = (int) floorf(crop.right); - * intCrop.bottom = (int) floorf(crop.bottom); - * - * Parameters: - * crop - the new source crop - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_LAYER - an invalid layer handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_LAYER_SOURCE_CROP)( - hwc2_device_t* device, hwc2_display_t display, hwc2_layer_t layer, - hwc_frect_t crop); - -/* setLayerTransform(..., transform) - * Descriptor: HWC2_FUNCTION_SET_LAYER_TRANSFORM - * Must be provided by all HWC2 devices - * - * Sets the transform (rotation/flip) of the given layer. - * - * Parameters: - * transform - the new transform - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_LAYER - an invalid layer handle was passed in - * HWC2_ERROR_BAD_PARAMETER - an invalid transform was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_LAYER_TRANSFORM)( - hwc2_device_t* device, hwc2_display_t display, hwc2_layer_t layer, - int32_t /*hwc_transform_t*/ transform); - -/* setLayerVisibleRegion(..., visible) - * Descriptor: HWC2_FUNCTION_SET_LAYER_VISIBLE_REGION - * Must be provided by all HWC2 devices - * - * Specifies the portion of the layer that is visible, including portions under - * translucent areas of other layers. The region is in screen space, and will - * not exceed the dimensions of the screen. - * - * Parameters: - * visible - the new visible region, in screen space - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_LAYER - an invalid layer handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_LAYER_VISIBLE_REGION)( - hwc2_device_t* device, hwc2_display_t display, hwc2_layer_t layer, - hwc_region_t visible); - -/* setLayerZOrder(..., z) - * Descriptor: HWC2_FUNCTION_SET_LAYER_Z_ORDER - * Must be provided by all HWC2 devices - * - * Sets the desired Z order (height) of the given layer. A layer with a greater - * Z value occludes a layer with a lesser Z value. - * - * Parameters: - * z - the new Z order - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_LAYER - an invalid layer handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_LAYER_Z_ORDER)( - hwc2_device_t* device, hwc2_display_t display, hwc2_layer_t layer, - uint32_t z); - -/* setLayerColorTransform(..., matrix) - * Descriptor: HWC2_FUNCTION_SET_LAYER_COLOR_TRANSFORM - * Optional by all HWC2 devices - * - * Sets a matrix for color transform which will be applied on this layer - * before composition. - * - * If the device is not capable of apply the matrix on this layer, it must force - * this layer to client composition during VALIDATE_DISPLAY. - * - * The matrix provided is an affine color transformation of the following form: - * - * |r.r r.g r.b 0| - * |g.r g.g g.b 0| - * |b.r b.g b.b 0| - * |Tr Tg Tb 1| - * - * This matrix must be provided in row-major form: - * - * {r.r, r.g, r.b, 0, g.r, ...}. - * - * Given a matrix of this form and an input color [R_in, G_in, B_in], - * the input color must first be converted to linear space - * [R_linear, G_linear, B_linear], then the output linear color - * [R_out_linear, G_out_linear, B_out_linear] will be: - * - * R_out_linear = R_linear * r.r + G_linear * g.r + B_linear * b.r + Tr - * G_out_linear = R_linear * r.g + G_linear * g.g + B_linear * b.g + Tg - * B_out_linear = R_linear * r.b + G_linear * g.b + B_linear * b.b + Tb - * - * [R_out_linear, G_out_linear, B_out_linear] must then be converted to - * gamma space: [R_out, G_out, B_out] before blending. - * - * Parameters: - * matrix - a 4x4 transform matrix (16 floats) as described above - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_BAD_LAYER - an invalid layer handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_LAYER_COLOR_TRANSFORM)( - hwc2_device_t* device, hwc2_display_t display, hwc2_layer_t layer, - const float* matrix); - -/* getDisplayedContentSamplingAttributes(..., - * format, dataspace, supported_components, max_frames) - * Descriptor: HWC2_FUNCTION_GET_DISPLAYED_CONTENT_SAMPLING_ATTRIBUTES - * Optional by all HWC2 devices - * - * Query for what types of color sampling the hardware supports. - * - * Parameters: - * format - The format of the sampled pixels; pointer will be non-NULL - * dataspace - The dataspace of the sampled pixels; pointer will be non-NULL - * supported_components - The mask of which components can be sampled; pointer - * will be non-NULL - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY when an invalid display was passed in, or - * HWC2_ERROR_UNSUPPORTED when there is no efficient way to sample. - */ -typedef int32_t (*HWC2_PFN_GET_DISPLAYED_CONTENT_SAMPLING_ATTRIBUTES)( - hwc2_device_t* device, hwc2_display_t display, - int32_t* /* android_pixel_format_t */ format, - int32_t* /* android_dataspace_t */ dataspace, - uint8_t* /* mask of android_component_t */ supported_components); - -/* setDisplayedContentSamplingEnabled(..., enabled) - * Descriptor: HWC2_FUNCTION_SET_DISPLAYED_CONTENT_SAMPLING_ENABLED - * Optional by all HWC2 devices - * - * Enables or disables the collection of color content statistics - * on this display. - * - * Sampling occurs on the contents of the final composition on this display - * (i.e., the contents presented on screen). - * - * Sampling support is optional, and is set to DISABLE by default. - * On each call to ENABLE, all collected statistics will be reset. - * - * Sample data can be queried via getDisplayedContentSample(). - * - * Parameters: - * enabled - indicates whether to enable or disable sampling. - * component_mask - The mask of which components should be sampled. - * If zero, all supported components are to be enabled. - * max_frames - is the maximum number of frames that should be stored before - * discard. The sample represents the most-recently posted frames. - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY when an invalid display handle was passed in, - * HWC2_ERROR_BAD_PARAMETER when enabled was an invalid value, or - * HWC2_ERROR_NO_RESOURCES when the requested ringbuffer size via max_frames - * was not available. - * HWC2_ERROR_UNSUPPORTED when there is no efficient way to sample. - */ -typedef int32_t (*HWC2_PFN_SET_DISPLAYED_CONTENT_SAMPLING_ENABLED)( - hwc2_device_t* device, hwc2_display_t display, - int32_t /*hwc2_displayed_content_sampling_t*/ enabled, - uint8_t /* mask of android_component_t */ component_mask, - uint64_t max_frames); - -/* getDisplayedContentSample(..., component, max_frames, timestamp, - * samples_size, samples, frame_count) - * Descriptor: HWC2_FUNCTION_GET_DISPLAYED_CONTENT_SAMPLE - * Optional by all HWC2 devices - * - * Collects the results of display content color sampling for display. - * - * Collection of data can occur whether the sampling is in ENABLE or - * DISABLE state. - * - * Parameters: - * max_frames - is the maximum number of frames that should be represented in - * the sample. The sample represents the most-recently posted frames. - * If max_frames is 0, all frames are to be represented by the sample. - * timestamp - is the timestamp after which any frames were posted that should - * be included in the sample. Timestamp is CLOCK_MONOTONIC. - * If timestamp is 0, do not filter from the sample by time. - * frame_count - The number of frames represented by this sample; pointer will - * be non-NULL. - * samples_size - The sizes of the color histogram representing the color - * sampling. Sample_sizes are indexed in the same order as - * HWC2_FORMAT_COMPONENT_. - * samples - The arrays of data corresponding to the sampling data. Samples are - * indexed in the same order as HWC2_FORMAT_COMPONENT_. - * The size of each sample is the samples_size for the same index. - * Each components sample is an array that is to be filled with the - * evenly-weighted buckets of a histogram counting how many times a pixel - * of the given component was displayed onscreen. Caller owns the data and - * pointer may be NULL to query samples_size. - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY when an invalid display was passed in, or - * HWC2_ERROR_UNSUPPORTED when there is no efficient way to sample, or - * HWC2_ERROR_BAD_PARAMETER when the component is not supported by the hardware. - */ -typedef int32_t (*HWC2_PFN_GET_DISPLAYED_CONTENT_SAMPLE)( - hwc2_device_t* device, hwc2_display_t display, - uint64_t max_frames, uint64_t timestamp, - uint64_t* frame_count, int32_t samples_size[4], uint64_t* samples[4]); - -/* getDisplayCapabilities(..., outCapabilities) - * Descriptor: HWC2_FUNCTION_GET_DISPLAY_CAPABILITIES - * Required for HWC2 devices for composer 2.3 - * Optional for HWC2 devices for composer 2.1 and 2.2 - * - * getDisplayCapabilities returns a list of supported capabilities - * (as described in the definition of Capability above). - * This list must not change after initialization. - * - * Parameters: - * outNumCapabilities - if outCapabilities was nullptr, returns the number of capabilities - * if outCapabilities was not nullptr, returns the number of capabilities stored in - * outCapabilities, which must not exceed the value stored in outNumCapabilities prior - * to the call; pointer will be non-NULL - * outCapabilities - a list of supported capabilities. - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_DISPLAY_CAPABILITIES)( - hwc2_device_t* device, hwc2_display_t display, uint32_t* outNumCapabilities, - uint32_t* outCapabilities); - -/* Use getDisplayCapabilities instead. If brightness is supported, must return - * DisplayCapability::BRIGHTNESS as one of the display capabilities via getDisplayCapabilities. - * Only use getDisplayCapabilities as the source of truth to query brightness support. - * - * getDisplayBrightnessSupport(displayToken) - * Descriptor: HWC2_FUNCTION_GET_DISPLAY_BRIGHTNESS_SUPPORT - * Required for HWC2 devices for composer 2.3 - * Optional for HWC2 devices for composer 2.1 and 2.2 - * - * getDisplayBrightnessSupport returns whether brightness operations are supported on a display. - * - * Parameters: - * outSupport - whether the display supports operations. - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY when the display is invalid. - */ -typedef int32_t /*hwc_error_t*/ (*HWC2_PFN_GET_DISPLAY_BRIGHTNESS_SUPPORT)(hwc2_device_t* device, - hwc2_display_t display, bool* outSupport); - -/* setDisplayBrightness(displayToken, brightnesss) - * Descriptor: HWC2_FUNCTION_SET_DISPLAY_BRIGHTNESS - * Required for HWC2 devices for composer 2.3 - * Optional for HWC2 devices for composer 2.1 and 2.2 - * - * setDisplayBrightness sets the brightness of a display. - * - * Parameters: - * brightness - a number between 0.0f (minimum brightness) and 1.0f (maximum brightness), or - * -1.0f to turn the backlight off. - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY when the display is invalid, or - * HWC2_ERROR_UNSUPPORTED when brightness operations are not supported, or - * HWC2_ERROR_BAD_PARAMETER when the brightness is invalid, or - * HWC2_ERROR_NO_RESOURCES when the brightness cannot be applied. - */ -typedef int32_t /*hwc_error_t*/ (*HWC2_PFN_SET_DISPLAY_BRIGHTNESS)(hwc2_device_t* device, - hwc2_display_t display, float brightness); - -/* Composer 2.4 additions */ - -/* getDisplayConnectionType(..., outType) - * Descriptor: HWC2_FUNCTION_GET_DISPLAY_CONNECTION_TYPE - * Optional for all HWC2 devices - * - * Returns whether the given physical display is internal or external. - * - * Parameters: - * outType - the connection type of the display; pointer will be non-NULL - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY when the display is invalid or virtual. - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_DISPLAY_CONNECTION_TYPE)( - hwc2_device_t* device, hwc2_display_t display, - uint32_t* /*hwc2_display_connection_type_t*/ outType); - -/* getDisplayVsyncPeriod(..., outVsyncPeriods) - * Descriptor: HWC2_FUNCTION_GET_DISPLAY_VSYNC_PERIOD - * Required for HWC2 devices for composer 2.4 - * - * Retrieves which vsync period the display is currently using. - * - * If no display configuration is currently active, this function must - * return BAD_CONFIG. If a vsync period is about to change due to a - * setActiveConfigWithConstraints call, this function must return the current vsync period - * until the change has taken place. - * - * Parameters: - * outVsyncPeriod - the current vsync period of the display. - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_BAD_CONFIG - no configuration is currently active - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_DISPLAY_VSYNC_PERIOD)( - hwc2_device_t* device, hwc2_display_t display, hwc2_vsync_period_t* outVsyncPeriod); - -/* setActiveConfigWithConstraints(..., - * config, - * vsyncPeriodChangeConstraints, - * outTimeline) - * Descriptor: HWC2_FUNCTION_SET_ACTIVE_CONFIG_WITH_CONSTRAINTS - * Required for HWC2 devices for composer 2.4 - * - * Sets the active configuration and the refresh rate for this display. - * If the new config shares the same config group as the current config, - * only the vsync period shall change. - * Upon returning, the given display configuration, except vsync period, must be active and - * remain so until either this function is called again or the display is disconnected. - * When the display starts to refresh at the new vsync period, onVsync_2_4 callback must be - * called with the new vsync period. - * - * Parameters: - * config - the new display configuration. - * vsyncPeriodChangeConstraints - constraints required for changing vsync period: - * desiredTimeNanos - the time in CLOCK_MONOTONIC after - * which the vsync period may change - * (i.e., the vsync period must not change - * before this time). - * seamlessRequired - if true, requires that the vsync period - * change must happen seamlessly without - * a noticeable visual artifact. - * When the conditions change and it may be - * possible to change the vsync period - * seamlessly, HWC2_CALLBACK_SEAMLESS_POSSIBLE - * callback must be called to indicate that - * caller should retry. - * outTimeline - the timeline for the vsync period change. - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in. - * HWC2_ERROR_BAD_CONFIG - an invalid configuration handle passed in. - * HWC2_ERROR_SEAMLESS_NOT_ALLOWED - when seamlessRequired was true but config provided doesn't - * share the same config group as the current config. - * HWC2_ERROR_SEAMLESS_NOT_POSSIBLE - when seamlessRequired was true but the display cannot - * achieve the vsync period change without a noticeable - * visual artifact. - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_SET_ACTIVE_CONFIG_WITH_CONSTRAINTS)( - hwc2_device_t* device, hwc2_display_t display, hwc2_config_t config, - hwc_vsync_period_change_constraints_t* vsyncPeriodChangeConstraints, - hwc_vsync_period_change_timeline_t* outTimeline); - -/* setAutoLowLatencyMode(displayToken, on) - * Descriptor: HWC2_FUNCTION_SET_AUTO_LOW_LATENCY_MODE - * Optional for HWC2 devices - * - * setAutoLowLatencyMode requests that the display goes into low latency mode. If the display - * is connected via HDMI 2.1, then Auto Low Latency Mode should be triggered. If the display is - * internally connected, then a custom low latency mode should be triggered (if available). - * - * Parameters: - * on - indicates whether to turn low latency mode on (=true) or off (=false) - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - when the display is invalid, or - * HWC2_ERROR_UNSUPPORTED - when the display does not support any low latency mode - */ -typedef int32_t /*hwc_error_t*/ (*HWC2_PFN_SET_AUTO_LOW_LATENCY_MODE)(hwc2_device_t* device, - hwc2_display_t display, bool on); - -/* getSupportedContentTypes(..., outSupportedContentTypes) - * Descriptor: HWC2_FUNCTION_GET_SUPPORTED_CONTENT_TYPES - * Optional for HWC2 devices - * - * getSupportedContentTypes returns a list of supported content types - * (as described in the definition of ContentType above). - * This list must not change after initialization. - * - * Parameters: - * outNumSupportedContentTypes - if outSupportedContentTypes was nullptr, returns the number - * of supported content types; if outSupportedContentTypes was not nullptr, returns the - * number of capabilities stored in outSupportedContentTypes, which must not exceed the - * value stored in outNumSupportedContentTypes prior to the call; pointer will be non-NULL - * outSupportedContentTypes - a list of supported content types. - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - */ -typedef int32_t /*hwc_error_t*/ (*HWC2_PFN_GET_SUPPORTED_CONTENT_TYPES)(hwc2_device_t* device, - hwc2_display_t display, uint32_t* outNumSupportedContentTypes, uint32_t* outSupportedContentTypes); - -/* setContentType(displayToken, contentType) - * Descriptor: HWC2_FUNCTION_SET_CONTENT_TYPE - * Optional for HWC2 devices - * - * setContentType instructs the display that the content being shown is of the given contentType - * (one of GRAPHICS, PHOTO, CINEMA, GAME). - * - * According to the HDMI 1.4 specification, supporting all content types is optional. Whether - * the display supports a given content type is reported by getSupportedContentTypes. - * - * Parameters: - * contentType - the type of content that is currently being shown on the display - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - when the display is invalid, or - * HWC2_ERROR_UNSUPPORTED - when the given content type is a valid content type, but is not - * supported on this display, or - * HWC2_ERROR_BAD_PARAMETER - when the given content type is invalid - */ -typedef int32_t /*hwc_error_t*/ (*HWC2_PFN_SET_CONTENT_TYPE)(hwc2_device_t* device, - hwc2_display_t display, int32_t /* hwc2_content_type_t */ contentType); - -/* getClientTargetProperty(..., outClientTargetProperty) - * Descriptor: HWC2_FUNCTION_GET_CLIENT_TARGET_PROPERTY - * Optional for HWC2 devices - * - * Retrieves the client target properties for which the hardware composer - * requests after the last call to validateDisplay. The client must set the - * properties of the client target to match the returned values. - * When this API is implemented, if client composition is needed, the hardware - * composer must return meaningful client target property with dataspace not - * setting to UNKNOWN. - * When the returned dataspace is set to UNKNOWN, it means hardware composer - * requests nothing, the client must ignore the returned client target property - * structrue. - * - * Parameters: - * outClientTargetProperty - the client target properties that hardware - * composer requests. If dataspace field is set to UNKNOWN, it means - * the hardware composer requests nothing, the client must ignore the - * returned client target property structure. - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_NOT_VALIDATED - validateDisplay has not been called for this - * display - */ -typedef int32_t /*hwc2_error_t*/ (*HWC2_PFN_GET_CLIENT_TARGET_PROPERTY)( - hwc2_device_t* device, hwc2_display_t display, - hwc_client_target_property_t* outClientTargetProperty); - -/* setLayerGenericMetadata(..., keyLength, key, mandatory, valueLength, value) - * Descriptor: HWC2_FUNCTION_SET_LAYER_GENERIC_METADATA - * Optional for HWC2 devices for composer 2.4+ - * - * setLayerGenericMetadata sets a piece of generic metadata for the given layer. - * If this function is called twice with the same key but different values, the - * newer value must override the older one. Calling this function with - * valueLength == 0 must reset that key's metadata as if it had not been set. - * - * A given piece of metadata may either be mandatory or a hint (non-mandatory) - * as indicated by the `mandatory` parameter. Mandatory metadata may affect the - * composition result, which is to say that it may cause a visible change in the - * final image. By contrast, hints may only affect the composition strategy, - * such as which layers are composited by the client, but must not cause a - * visible change in the final image. - * - * This implies that if the device does not understand a given key: - * - If the key is marked as mandatory, it must mark this layer for client - * composition in order to ensure the correct composition result - * - If the key is a hint, the metadata provided may be ignored - * - * Parameters: - * keyLength - the length of the key parameter - * key - the metadata key - * mandatory - indicates whether this particular key represents mandatory - * metadata or a hint, as described above - * valueLength - the length of the value parameter - * value - the metadata value - * - * Returns HWC2_ERROR_NONE or one of the following errors: - * HWC2_ERROR_BAD_DISPLAY - an invalid display handle was passed in - * HWC2_ERROR_BAD_LAYER - an invalid layer handle was passed in - * HWC2_ERROR_BAD_PARAMETER - an unsupported key was passed in, or the value - * does not conform to the expected format for the key - */ -typedef int32_t /*hwc_error_t*/ (*HWC2_PFN_SET_LAYER_GENERIC_METADATA)(hwc2_device_t* device, - hwc2_display_t display, hwc2_layer_t layer, uint32_t keyLength, const char* key, - bool mandatory, uint32_t valueLength, const uint8_t* value); - -/* getLayerGenericMetadataKey(..., keyIndex, outKeyLength, outKey, outMandatory) - * Descriptor: HWC2_FUNCTION_GET_LAYER_GENERIC_METADATA_KEY - * Optional for HWC2 devices for composer 2.4+ - * - * getLayerGenericMetadataKey allows the client to query which metadata keys are - * supported by the composer implementation. Only keys in this list will be - * passed into setLayerGenericMetadata. Additionally, the key names in this list - * must meet the following requirements: - * - Must be specified in reverse domain name notation - * - Must not start with 'com.android' or 'android' - * - Must be unique within the returned list of keys - * - Must correspond to a matching HIDL struct type, which defines the structure - * of its values. For example, the key 'com.example.V1-3.Foo' should - * correspond to a value of type com.example@1.3::Foo, which is defined in a - * vendor HAL extension - * - * Client code which calls this function will look similar to this: - * - * struct Key { - * std::string name; - * bool mandatory; - * } - * - * std::vector<Key> keys; - * uint32_t index = 0; - * uint32_t keyLength = 0; - * while (true) { - * getLayerGenericMetadataKey(device, index, &keyLength, nullptr, nullptr); - * if (keyLength == 0) break; - * - * Key key; - * key.name.resize(keyLength); - * getLayerGenericMetadataKey(device, index, &keyLength, key.name.data(), &key.mandatory); - * keys.push_back(key); - * - * ++index; - * } - * - * Parameters: - * keyIndex - the index of the key to retrieve. For values beyond the end of - * the list of supported keys, outKeyLength should return 0, and the - * client may assume that if the length is 0 for keyIndex N, then it is - * also 0 for all keyIndex values > N. - * outKeyLength - if outKey was nullptr, returns the length of the key to - * allow the client to allocate an appropriately-sized buffer; if outKey - * was not nullptr, returns the length of the returned key, which must not - * exceed the value stored in outKeyLength prior to the call; pointer will - * be non-null - * outKey - the key at the given index, or nullptr to query the key's length - * outMandatory - whether the given metadata is mandatory or not (see - * setLayerGenericMetadata for more information), may be nullptr - */ -typedef void (*HWC2_PFN_GET_LAYER_GENERIC_METADATA_KEY)(hwc2_device_t* device, uint32_t keyIndex, - uint32_t* outKeyLength, char* outKey, bool* outMandatory); - -__END_DECLS - -#endif diff --git a/.ci/android_headers/hardware/hwcomposer_defs.h b/.ci/android_headers/hardware/hwcomposer_defs.h deleted file mode 100644 index f466a36..0000000 --- a/.ci/android_headers/hardware/hwcomposer_defs.h +++ /dev/null @@ -1,345 +0,0 @@ -// clang-format off -/* - * Copyright (C) 2010 The Android Open Source Project - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -#ifndef ANDROID_INCLUDE_HARDWARE_HWCOMPOSER_DEFS_H -#define ANDROID_INCLUDE_HARDWARE_HWCOMPOSER_DEFS_H - -#include <stdint.h> -#include <sys/cdefs.h> - -#include <hardware/gralloc.h> -#include <hardware/hardware.h> -#include <cutils/native_handle.h> - -__BEGIN_DECLS - -/* Shared by HWC1 and HWC2 */ - -#define HWC_HEADER_VERSION 1 - -#define HWC_MODULE_API_VERSION_0_1 HARDWARE_MODULE_API_VERSION(0, 1) - -#define HWC_DEVICE_API_VERSION_1_0 HARDWARE_DEVICE_API_VERSION_2(1, 0, HWC_HEADER_VERSION) -#define HWC_DEVICE_API_VERSION_1_1 HARDWARE_DEVICE_API_VERSION_2(1, 1, HWC_HEADER_VERSION) -#define HWC_DEVICE_API_VERSION_1_2 HARDWARE_DEVICE_API_VERSION_2(1, 2, HWC_HEADER_VERSION) -#define HWC_DEVICE_API_VERSION_1_3 HARDWARE_DEVICE_API_VERSION_2(1, 3, HWC_HEADER_VERSION) -#define HWC_DEVICE_API_VERSION_1_4 HARDWARE_DEVICE_API_VERSION_2(1, 4, HWC_HEADER_VERSION) -#define HWC_DEVICE_API_VERSION_1_5 HARDWARE_DEVICE_API_VERSION_2(1, 5, HWC_HEADER_VERSION) - -#define HWC_DEVICE_API_VERSION_2_0 HARDWARE_DEVICE_API_VERSION_2(2, 0, HWC_HEADER_VERSION) - -/** - * The id of this module - */ -#define HWC_HARDWARE_MODULE_ID "hwcomposer" - -/** - * Name of the sensors device to open - */ -#define HWC_HARDWARE_COMPOSER "composer" - -typedef struct hwc_color { - uint8_t r; - uint8_t g; - uint8_t b; - uint8_t a; -} hwc_color_t; - -typedef struct hwc_float_color { - float r; - float g; - float b; - float a; -} hwc_float_color_t; - -typedef struct hwc_frect { - float left; - float top; - float right; - float bottom; -} hwc_frect_t; - -typedef struct hwc_rect { - int left; - int top; - int right; - int bottom; -} hwc_rect_t; - -typedef struct hwc_region { - size_t numRects; - hwc_rect_t const* rects; -} hwc_region_t; - -/* - * hwc_layer_t::transform values - */ -typedef enum { - /* flip source image horizontally */ - HWC_TRANSFORM_FLIP_H = HAL_TRANSFORM_FLIP_H, - /* flip source image vertically */ - HWC_TRANSFORM_FLIP_V = HAL_TRANSFORM_FLIP_V, - /* rotate source image 90 degrees clock-wise */ - HWC_TRANSFORM_ROT_90 = HAL_TRANSFORM_ROT_90, - /* rotate source image 180 degrees */ - HWC_TRANSFORM_ROT_180 = HAL_TRANSFORM_ROT_180, - /* rotate source image 270 degrees clock-wise */ - HWC_TRANSFORM_ROT_270 = HAL_TRANSFORM_ROT_270, - /* flip source image horizontally, the rotate 90 degrees clock-wise */ - HWC_TRANSFORM_FLIP_H_ROT_90 = HAL_TRANSFORM_FLIP_H | HAL_TRANSFORM_ROT_90, - /* flip source image vertically, the rotate 90 degrees clock-wise */ - HWC_TRANSFORM_FLIP_V_ROT_90 = HAL_TRANSFORM_FLIP_V | HAL_TRANSFORM_ROT_90, -} hwc_transform_t; - -/* Constraints for changing vsync period */ -typedef struct hwc_vsync_period_change_constraints { - /* Time in CLOCK_MONOTONIC after which the vsync period may change - * (i.e., the vsync period must not change before this time). */ - int64_t desiredTimeNanos; - /* - * If true, requires that the vsync period change must happen seamlessly without - * a noticeable visual artifact. */ - uint8_t seamlessRequired; -} hwc_vsync_period_change_constraints_t; - -/* Timing for a vsync period change. */ -typedef struct hwc_vsync_period_change_timeline { - /* The time in CLOCK_MONOTONIC when the new display will start to refresh at - * the new vsync period. */ - int64_t newVsyncAppliedTimeNanos; - - /* Set to true if the client is required to sent a frame to be displayed before - * the change can take place. */ - uint8_t refreshRequired; - - /* The time in CLOCK_MONOTONIC when the client is expected to send the new frame. - * Should be ignored if refreshRequired is false. */ - int64_t refreshTimeNanos; -} hwc_vsync_period_change_timeline_t; - -typedef struct hwc_client_target_property { - // The pixel format of client target requested by hardware composer. - int32_t pixelFormat; - // The dataspace of the client target requested by hardware composer. - int32_t dataspace; -} hwc_client_target_property_t; - -/******************************************************************************* - * Beyond this point are things only used by HWC1, which should be ignored when - * implementing a HWC2 device - ******************************************************************************/ - -enum { - /* hwc_composer_device_t::set failed in EGL */ - HWC_EGL_ERROR = -1 -}; - -/* - * hwc_layer_t::hints values - * Hints are set by the HAL and read by SurfaceFlinger - */ -enum { - /* - * HWC can set the HWC_HINT_TRIPLE_BUFFER hint to indicate to SurfaceFlinger - * that it should triple buffer this layer. Typically HWC does this when - * the layer will be unavailable for use for an extended period of time, - * e.g. if the display will be fetching data directly from the layer and - * the layer can not be modified until after the next set(). - */ - HWC_HINT_TRIPLE_BUFFER = 0x00000001, - - /* - * HWC sets HWC_HINT_CLEAR_FB to tell SurfaceFlinger that it should clear the - * framebuffer with transparent pixels where this layer would be. - * SurfaceFlinger will only honor this flag when the layer has no blending - * - */ - HWC_HINT_CLEAR_FB = 0x00000002 -}; - -/* - * hwc_layer_t::flags values - * Flags are set by SurfaceFlinger and read by the HAL - */ -enum { - /* - * HWC_SKIP_LAYER is set by SurfaceFlinger to indicate that the HAL - * shall not consider this layer for composition as it will be handled - * by SurfaceFlinger (just as if compositionType was set to HWC_FRAMEBUFFER). - */ - HWC_SKIP_LAYER = 0x00000001, - - /* - * HWC_IS_CURSOR_LAYER is set by surfaceflinger to indicate that this - * layer is being used as a cursor on this particular display, and that - * surfaceflinger can potentially perform asynchronous position updates for - * this layer. If a call to prepare() returns HWC_CURSOR_OVERLAY for the - * composition type of this layer, then the hwcomposer will allow async - * position updates to this layer via setCursorPositionAsync(). - */ - HWC_IS_CURSOR_LAYER = 0x00000002 -}; - -/* - * hwc_layer_t::compositionType values - */ -enum { - /* this layer is to be drawn into the framebuffer by SurfaceFlinger */ - HWC_FRAMEBUFFER = 0, - - /* this layer will be handled in the HWC */ - HWC_OVERLAY = 1, - - /* this is the background layer. it's used to set the background color. - * there is only a single background layer */ - HWC_BACKGROUND = 2, - - /* this layer holds the result of compositing the HWC_FRAMEBUFFER layers. - * Added in HWC_DEVICE_API_VERSION_1_1. */ - HWC_FRAMEBUFFER_TARGET = 3, - - /* this layer's contents are taken from a sideband buffer stream. - * Added in HWC_DEVICE_API_VERSION_1_4. */ - HWC_SIDEBAND = 4, - - /* this layer's composition will be handled by hwcomposer by dedicated - cursor overlay hardware. hwcomposer will also all async position updates - of this layer outside of the normal prepare()/set() loop. Added in - HWC_DEVICE_API_VERSION_1_4. */ - HWC_CURSOR_OVERLAY = 5 - }; -/* - * hwc_layer_t::blending values - */ -enum { - /* no blending */ - HWC_BLENDING_NONE = 0x0100, - - /* ONE / ONE_MINUS_SRC_ALPHA */ - HWC_BLENDING_PREMULT = 0x0105, - - /* SRC_ALPHA / ONE_MINUS_SRC_ALPHA */ - HWC_BLENDING_COVERAGE = 0x0405 -}; - -/* attributes queriable with query() */ -enum { - /* - * Must return 1 if the background layer is supported, 0 otherwise. - */ - HWC_BACKGROUND_LAYER_SUPPORTED = 0, - - /* - * Returns the vsync period in nanoseconds. - * - * This query is not used for HWC_DEVICE_API_VERSION_1_1 and later. - * Instead, the per-display attribute HWC_DISPLAY_VSYNC_PERIOD is used. - */ - HWC_VSYNC_PERIOD = 1, - - /* - * Availability: HWC_DEVICE_API_VERSION_1_1 - * Returns a mask of supported display types. - */ - HWC_DISPLAY_TYPES_SUPPORTED = 2, -}; - -/* display attributes returned by getDisplayAttributes() */ -enum { - /* Indicates the end of an attribute list */ - HWC_DISPLAY_NO_ATTRIBUTE = 0, - - /* The vsync period in nanoseconds */ - HWC_DISPLAY_VSYNC_PERIOD = 1, - - /* The number of pixels in the horizontal and vertical directions. */ - HWC_DISPLAY_WIDTH = 2, - HWC_DISPLAY_HEIGHT = 3, - - /* The number of pixels per thousand inches of this configuration. - * - * Scaling DPI by 1000 allows it to be stored in an int without losing - * too much precision. - * - * If the DPI for a configuration is unavailable or the HWC implementation - * considers it unreliable, it should set these attributes to zero. - */ - HWC_DISPLAY_DPI_X = 4, - HWC_DISPLAY_DPI_Y = 5, - - /* Indicates which of the vendor-defined color transforms is provided by - * this configuration. */ - HWC_DISPLAY_COLOR_TRANSFORM = 6, - - /* The configuration group this config is associated to. The groups are defined - * to mark certain configs as similar and changing configs within a certain group - * may be done seamlessly in some conditions. setActiveConfigWithConstraints. */ - HWC_DISPLAY_CONFIG_GROUP = 7, -}; - -/* Allowed events for hwc_methods::eventControl() */ -enum { - HWC_EVENT_VSYNC = 0 -}; - -/* Display types and associated mask bits. */ -enum { - HWC_DISPLAY_PRIMARY = 0, - HWC_DISPLAY_EXTERNAL = 1, // HDMI, DP, etc. - HWC_DISPLAY_VIRTUAL = 2, - - HWC_NUM_PHYSICAL_DISPLAY_TYPES = 2, - HWC_NUM_DISPLAY_TYPES = 3, -}; - -enum { - HWC_DISPLAY_PRIMARY_BIT = 1 << HWC_DISPLAY_PRIMARY, - HWC_DISPLAY_EXTERNAL_BIT = 1 << HWC_DISPLAY_EXTERNAL, - HWC_DISPLAY_VIRTUAL_BIT = 1 << HWC_DISPLAY_VIRTUAL, -}; - -/* Display power modes */ -enum { - /* The display is turned off (blanked). */ - HWC_POWER_MODE_OFF = 0, - /* The display is turned on and configured in a low power state - * that is suitable for presenting ambient information to the user, - * possibly with lower fidelity than normal but greater efficiency. */ - HWC_POWER_MODE_DOZE = 1, - /* The display is turned on normally. */ - HWC_POWER_MODE_NORMAL = 2, - /* The display is configured as in HWC_POWER_MODE_DOZE but may - * stop applying frame buffer updates from the graphics subsystem. - * This power mode is effectively a hint from the doze dream to - * tell the hardware that it is done drawing to the display for the - * time being and that the display should remain on in a low power - * state and continue showing its current contents indefinitely - * until the mode changes. - * - * This mode may also be used as a signal to enable hardware-based doze - * functionality. In this case, the doze dream is effectively - * indicating that the hardware is free to take over the display - * and manage it autonomously to implement low power always-on display - * functionality. */ - HWC_POWER_MODE_DOZE_SUSPEND = 3, -}; - -/*****************************************************************************/ - -__END_DECLS - -#endif /* ANDROID_INCLUDE_HARDWARE_HWCOMPOSER_DEFS_H */ diff --git a/.ci/android_headers/ndk/sync.h b/.ci/android_headers/ndk/sync.h deleted file mode 100644 index 2ca389b..0000000 --- a/.ci/android_headers/ndk/sync.h +++ /dev/null @@ -1,111 +0,0 @@ -// clang-format off -/* - * Copyright 2017 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. - */ - -/** - * @addtogroup Sync - * @{ - */ - -/** - * @file sync.h - */ - -#ifndef ANDROID_SYNC_H -#define ANDROID_SYNC_H - -#include <stdint.h> -#include <sys/cdefs.h> - -#include <linux/sync_file.h> - -__BEGIN_DECLS - -#if __ANDROID_API__ >= 26 - -/* Fences indicate the status of an asynchronous task. They are initially - * in unsignaled state (0), and make a one-time transition to either signaled - * (1) or error (< 0) state. A sync file is a collection of one or more fences; - * the sync file's status is error if any of its fences are in error state, - * signaled if all of the child fences are signaled, or unsignaled otherwise. - * - * Sync files are created by various device APIs in response to submitting - * tasks to the device. Standard file descriptor lifetime syscalls like dup() - * and close() are used to manage sync file lifetime. - * - * The poll(), ppoll(), or select() syscalls can be used to wait for the sync - * file to change status, or (with a timeout of zero) to check its status. - * - * The functions below provide a few additional sync-specific operations. - */ - -/** - * Merge two sync files. - * - * This produces a new sync file with the given name which has the union of the - * two original sync file's fences; redundant fences may be removed. - * - * If one of the input sync files is signaled or invalid, then this function - * may behave like dup(): the new file descriptor refers to the valid/unsignaled - * sync file with its original name, rather than a new sync file. - * - * The original fences remain valid, and the caller is responsible for closing - * them. - * - * Available since API level 26. - */ -int32_t sync_merge(const char* name, int32_t fd1, int32_t fd2) /* __INTRODUCED_IN(26) */; - -/** - * Retrieve detailed information about a sync file and its fences. - * - * The returned sync_file_info must be freed by calling sync_file_info_free(). - * - * Available since API level 26. - */ -struct sync_file_info* sync_file_info(int32_t fd) /* __INTRODUCED_IN(26) */; - -/** - * Get the array of fence infos from the sync file's info. - * - * The returned array is owned by the parent sync file info, and has - * info->num_fences entries. - * - * Available since API level 26. - */ -static inline struct sync_fence_info* sync_get_fence_info(const struct sync_file_info* info) { -// This header should compile in C, but some C++ projects enable -// warnings-as-error for C-style casts. -#pragma GCC diagnostic push -#pragma GCC diagnostic ignored "-Wold-style-cast" - return (struct sync_fence_info *)(uintptr_t)(info->sync_fence_info); -#pragma GCC diagnostic pop -} - -/** - * Free a struct sync_file_info structure - * - * Available since API level 26. - */ -void sync_file_info_free(struct sync_file_info* info) /* __INTRODUCED_IN(26) */; - -#endif /* __ANDROID_API__ >= 26 */ - -__END_DECLS - -#endif /* ANDROID_SYNC_H */ - -/** @} */ diff --git a/.ci/android_headers/sync/sync.h b/.ci/android_headers/sync/sync.h deleted file mode 100644 index 4ec6d4c..0000000 --- a/.ci/android_headers/sync/sync.h +++ /dev/null @@ -1,50 +0,0 @@ -// clang-format off -/* - * sync.h - * - * Copyright 2012 Google, Inc - * - * 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 __SYS_CORE_SYNC_H -#define __SYS_CORE_SYNC_H - -/* This file contains the legacy sync interface used by Android platform and - * device code. The direct contents will be removed over time as code - * transitions to using the updated interface in ndk/sync.h. When this file is - * empty other than the ndk/sync.h include, that file will be renamed to - * replace this one. - * - * New code should continue to include this file (#include <android/sync.h>) - * instead of ndk/sync.h so the eventual rename is seamless, but should only - * use the things declared in ndk/sync.h. - * - * This file used to be called sync/sync.h, but we renamed to that both the - * platform and NDK call it android/sync.h. A symlink from the old name to this - * one exists temporarily to avoid having to change all sync clients - * simultaneously. It will be removed when they've been updated, and probably - * after this change has been delivered to AOSP so that integrations don't - * break builds. - */ - -#include "../ndk/sync.h" - -__BEGIN_DECLS - -/* timeout in msecs */ -int sync_wait(int fd, int timeout); - -__END_DECLS - -#endif /* __SYS_CORE_SYNC_H */ diff --git a/.ci/android_headers/system/graphics-base-v1.0.h b/.ci/android_headers/system/graphics-base-v1.0.h deleted file mode 100644 index 20a80ed..0000000 --- a/.ci/android_headers/system/graphics-base-v1.0.h +++ /dev/null @@ -1,141 +0,0 @@ -// clang-format off -// This file is autogenerated by hidl-gen. Do not edit manually. -// Source: android.hardware.graphics.common@1.0 -// Location: hardware/interfaces/graphics/common/1.0/ - -#ifndef HIDL_GENERATED_ANDROID_HARDWARE_GRAPHICS_COMMON_V1_0_EXPORTED_CONSTANTS_H_ -#define HIDL_GENERATED_ANDROID_HARDWARE_GRAPHICS_COMMON_V1_0_EXPORTED_CONSTANTS_H_ - -#ifdef __cplusplus -extern "C" { -#endif - -typedef enum { - HAL_PIXEL_FORMAT_RGBA_8888 = 1, - HAL_PIXEL_FORMAT_RGBX_8888 = 2, - HAL_PIXEL_FORMAT_RGB_888 = 3, - HAL_PIXEL_FORMAT_RGB_565 = 4, - HAL_PIXEL_FORMAT_BGRA_8888 = 5, - HAL_PIXEL_FORMAT_YCBCR_422_SP = 16, - HAL_PIXEL_FORMAT_YCRCB_420_SP = 17, - HAL_PIXEL_FORMAT_YCBCR_422_I = 20, - HAL_PIXEL_FORMAT_RGBA_FP16 = 22, - HAL_PIXEL_FORMAT_RAW16 = 32, - HAL_PIXEL_FORMAT_BLOB = 33, - HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED = 34, - HAL_PIXEL_FORMAT_YCBCR_420_888 = 35, - HAL_PIXEL_FORMAT_RAW_OPAQUE = 36, - HAL_PIXEL_FORMAT_RAW10 = 37, - HAL_PIXEL_FORMAT_RAW12 = 38, - HAL_PIXEL_FORMAT_RGBA_1010102 = 43, - HAL_PIXEL_FORMAT_Y8 = 538982489, - HAL_PIXEL_FORMAT_Y16 = 540422489, - HAL_PIXEL_FORMAT_YV12 = 842094169, -} android_pixel_format_t; - -typedef enum { - HAL_TRANSFORM_FLIP_H = 1, // (1 << 0) - HAL_TRANSFORM_FLIP_V = 2, // (1 << 1) - HAL_TRANSFORM_ROT_90 = 4, // (1 << 2) - HAL_TRANSFORM_ROT_180 = 3, // (FLIP_H | FLIP_V) - HAL_TRANSFORM_ROT_270 = 7, // ((FLIP_H | FLIP_V) | ROT_90) -} android_transform_t; - -typedef enum { - HAL_DATASPACE_UNKNOWN = 0, - HAL_DATASPACE_ARBITRARY = 1, - HAL_DATASPACE_STANDARD_SHIFT = 16, - HAL_DATASPACE_STANDARD_MASK = 4128768, // (63 << STANDARD_SHIFT) - HAL_DATASPACE_STANDARD_UNSPECIFIED = 0, // (0 << STANDARD_SHIFT) - HAL_DATASPACE_STANDARD_BT709 = 65536, // (1 << STANDARD_SHIFT) - HAL_DATASPACE_STANDARD_BT601_625 = 131072, // (2 << STANDARD_SHIFT) - HAL_DATASPACE_STANDARD_BT601_625_UNADJUSTED = 196608, // (3 << STANDARD_SHIFT) - HAL_DATASPACE_STANDARD_BT601_525 = 262144, // (4 << STANDARD_SHIFT) - HAL_DATASPACE_STANDARD_BT601_525_UNADJUSTED = 327680, // (5 << STANDARD_SHIFT) - HAL_DATASPACE_STANDARD_BT2020 = 393216, // (6 << STANDARD_SHIFT) - HAL_DATASPACE_STANDARD_BT2020_CONSTANT_LUMINANCE = 458752, // (7 << STANDARD_SHIFT) - HAL_DATASPACE_STANDARD_BT470M = 524288, // (8 << STANDARD_SHIFT) - HAL_DATASPACE_STANDARD_FILM = 589824, // (9 << STANDARD_SHIFT) - HAL_DATASPACE_STANDARD_DCI_P3 = 655360, // (10 << STANDARD_SHIFT) - HAL_DATASPACE_STANDARD_ADOBE_RGB = 720896, // (11 << STANDARD_SHIFT) - HAL_DATASPACE_TRANSFER_SHIFT = 22, - HAL_DATASPACE_TRANSFER_MASK = 130023424, // (31 << TRANSFER_SHIFT) - HAL_DATASPACE_TRANSFER_UNSPECIFIED = 0, // (0 << TRANSFER_SHIFT) - HAL_DATASPACE_TRANSFER_LINEAR = 4194304, // (1 << TRANSFER_SHIFT) - HAL_DATASPACE_TRANSFER_SRGB = 8388608, // (2 << TRANSFER_SHIFT) - HAL_DATASPACE_TRANSFER_SMPTE_170M = 12582912, // (3 << TRANSFER_SHIFT) - HAL_DATASPACE_TRANSFER_GAMMA2_2 = 16777216, // (4 << TRANSFER_SHIFT) - HAL_DATASPACE_TRANSFER_GAMMA2_6 = 20971520, // (5 << TRANSFER_SHIFT) - HAL_DATASPACE_TRANSFER_GAMMA2_8 = 25165824, // (6 << TRANSFER_SHIFT) - HAL_DATASPACE_TRANSFER_ST2084 = 29360128, // (7 << TRANSFER_SHIFT) - HAL_DATASPACE_TRANSFER_HLG = 33554432, // (8 << TRANSFER_SHIFT) - HAL_DATASPACE_RANGE_SHIFT = 27, - HAL_DATASPACE_RANGE_MASK = 939524096, // (7 << RANGE_SHIFT) - HAL_DATASPACE_RANGE_UNSPECIFIED = 0, // (0 << RANGE_SHIFT) - HAL_DATASPACE_RANGE_FULL = 134217728, // (1 << RANGE_SHIFT) - HAL_DATASPACE_RANGE_LIMITED = 268435456, // (2 << RANGE_SHIFT) - HAL_DATASPACE_RANGE_EXTENDED = 402653184, // (3 << RANGE_SHIFT) - HAL_DATASPACE_SRGB_LINEAR = 512, - HAL_DATASPACE_V0_SRGB_LINEAR = 138477568, // ((STANDARD_BT709 | TRANSFER_LINEAR) | RANGE_FULL) - HAL_DATASPACE_V0_SCRGB_LINEAR = - 406913024, // ((STANDARD_BT709 | TRANSFER_LINEAR) | RANGE_EXTENDED) - HAL_DATASPACE_SRGB = 513, - HAL_DATASPACE_V0_SRGB = 142671872, // ((STANDARD_BT709 | TRANSFER_SRGB) | RANGE_FULL) - HAL_DATASPACE_V0_SCRGB = 411107328, // ((STANDARD_BT709 | TRANSFER_SRGB) | RANGE_EXTENDED) - HAL_DATASPACE_JFIF = 257, - HAL_DATASPACE_V0_JFIF = 146931712, // ((STANDARD_BT601_625 | TRANSFER_SMPTE_170M) | RANGE_FULL) - HAL_DATASPACE_BT601_625 = 258, - HAL_DATASPACE_V0_BT601_625 = - 281149440, // ((STANDARD_BT601_625 | TRANSFER_SMPTE_170M) | RANGE_LIMITED) - HAL_DATASPACE_BT601_525 = 259, - HAL_DATASPACE_V0_BT601_525 = - 281280512, // ((STANDARD_BT601_525 | TRANSFER_SMPTE_170M) | RANGE_LIMITED) - HAL_DATASPACE_BT709 = 260, - HAL_DATASPACE_V0_BT709 = 281083904, // ((STANDARD_BT709 | TRANSFER_SMPTE_170M) | RANGE_LIMITED) - HAL_DATASPACE_DCI_P3_LINEAR = 139067392, // ((STANDARD_DCI_P3 | TRANSFER_LINEAR) | RANGE_FULL) - HAL_DATASPACE_DCI_P3 = 155844608, // ((STANDARD_DCI_P3 | TRANSFER_GAMMA2_6) | RANGE_FULL) - HAL_DATASPACE_DISPLAY_P3_LINEAR = - 139067392, // ((STANDARD_DCI_P3 | TRANSFER_LINEAR) | RANGE_FULL) - HAL_DATASPACE_DISPLAY_P3 = 143261696, // ((STANDARD_DCI_P3 | TRANSFER_SRGB) | RANGE_FULL) - HAL_DATASPACE_ADOBE_RGB = 151715840, // ((STANDARD_ADOBE_RGB | TRANSFER_GAMMA2_2) | RANGE_FULL) - HAL_DATASPACE_BT2020_LINEAR = 138805248, // ((STANDARD_BT2020 | TRANSFER_LINEAR) | RANGE_FULL) - HAL_DATASPACE_BT2020 = 147193856, // ((STANDARD_BT2020 | TRANSFER_SMPTE_170M) | RANGE_FULL) - HAL_DATASPACE_BT2020_PQ = 163971072, // ((STANDARD_BT2020 | TRANSFER_ST2084) | RANGE_FULL) - HAL_DATASPACE_DEPTH = 4096, - HAL_DATASPACE_SENSOR = 4097, -} android_dataspace_t; - -typedef enum { - HAL_COLOR_MODE_NATIVE = 0, - HAL_COLOR_MODE_STANDARD_BT601_625 = 1, - HAL_COLOR_MODE_STANDARD_BT601_625_UNADJUSTED = 2, - HAL_COLOR_MODE_STANDARD_BT601_525 = 3, - HAL_COLOR_MODE_STANDARD_BT601_525_UNADJUSTED = 4, - HAL_COLOR_MODE_STANDARD_BT709 = 5, - HAL_COLOR_MODE_DCI_P3 = 6, - HAL_COLOR_MODE_SRGB = 7, - HAL_COLOR_MODE_ADOBE_RGB = 8, - HAL_COLOR_MODE_DISPLAY_P3 = 9, -} android_color_mode_t; - -typedef enum { - HAL_COLOR_TRANSFORM_IDENTITY = 0, - HAL_COLOR_TRANSFORM_ARBITRARY_MATRIX = 1, - HAL_COLOR_TRANSFORM_VALUE_INVERSE = 2, - HAL_COLOR_TRANSFORM_GRAYSCALE = 3, - HAL_COLOR_TRANSFORM_CORRECT_PROTANOPIA = 4, - HAL_COLOR_TRANSFORM_CORRECT_DEUTERANOPIA = 5, - HAL_COLOR_TRANSFORM_CORRECT_TRITANOPIA = 6, -} android_color_transform_t; - -typedef enum { - HAL_HDR_DOLBY_VISION = 1, - HAL_HDR_HDR10 = 2, - HAL_HDR_HLG = 3, -} android_hdr_t; - -#ifdef __cplusplus -} -#endif - -#endif // HIDL_GENERATED_ANDROID_HARDWARE_GRAPHICS_COMMON_V1_0_EXPORTED_CONSTANTS_H_ diff --git a/.ci/android_headers/system/graphics-base-v1.1.h b/.ci/android_headers/system/graphics-base-v1.1.h deleted file mode 100644 index a90da62..0000000 --- a/.ci/android_headers/system/graphics-base-v1.1.h +++ /dev/null @@ -1,49 +0,0 @@ -// clang-format off -// This file is autogenerated by hidl-gen. Do not edit manually. -// Source: android.hardware.graphics.common@1.1 -// Location: hardware/interfaces/graphics/common/1.1/ - -#ifndef HIDL_GENERATED_ANDROID_HARDWARE_GRAPHICS_COMMON_V1_1_EXPORTED_CONSTANTS_H_ -#define HIDL_GENERATED_ANDROID_HARDWARE_GRAPHICS_COMMON_V1_1_EXPORTED_CONSTANTS_H_ - -#ifdef __cplusplus -extern "C" { -#endif - -typedef enum { - HAL_PIXEL_FORMAT_DEPTH_16 = 48, - HAL_PIXEL_FORMAT_DEPTH_24 = 49, - HAL_PIXEL_FORMAT_DEPTH_24_STENCIL_8 = 50, - HAL_PIXEL_FORMAT_DEPTH_32F = 51, - HAL_PIXEL_FORMAT_DEPTH_32F_STENCIL_8 = 52, - HAL_PIXEL_FORMAT_STENCIL_8 = 53, - HAL_PIXEL_FORMAT_YCBCR_P010 = 54, -} android_pixel_format_v1_1_t; - -typedef enum { - HAL_DATASPACE_BT2020_ITU = - 281411584, // ((STANDARD_BT2020 | TRANSFER_SMPTE_170M) | RANGE_LIMITED) - HAL_DATASPACE_BT2020_ITU_PQ = - 298188800, // ((STANDARD_BT2020 | TRANSFER_ST2084) | RANGE_LIMITED) - HAL_DATASPACE_BT2020_ITU_HLG = 302383104, // ((STANDARD_BT2020 | TRANSFER_HLG) | RANGE_LIMITED) - HAL_DATASPACE_BT2020_HLG = 168165376, // ((STANDARD_BT2020 | TRANSFER_HLG) | RANGE_FULL) -} android_dataspace_v1_1_t; - -typedef enum { - HAL_COLOR_MODE_BT2020 = 10, - HAL_COLOR_MODE_BT2100_PQ = 11, - HAL_COLOR_MODE_BT2100_HLG = 12, -} android_color_mode_v1_1_t; - -typedef enum { - HAL_RENDER_INTENT_COLORIMETRIC = 0, - HAL_RENDER_INTENT_ENHANCE = 1, - HAL_RENDER_INTENT_TONE_MAP_COLORIMETRIC = 2, - HAL_RENDER_INTENT_TONE_MAP_ENHANCE = 3, -} android_render_intent_v1_1_t; - -#ifdef __cplusplus -} -#endif - -#endif // HIDL_GENERATED_ANDROID_HARDWARE_GRAPHICS_COMMON_V1_1_EXPORTED_CONSTANTS_H_ diff --git a/.ci/android_headers/system/graphics-base-v1.2.h b/.ci/android_headers/system/graphics-base-v1.2.h deleted file mode 100644 index baddf79..0000000 --- a/.ci/android_headers/system/graphics-base-v1.2.h +++ /dev/null @@ -1,32 +0,0 @@ -// clang-format off -// This file is autogenerated by hidl-gen. Do not edit manually. -// Source: android.hardware.graphics.common@1.2 -// Location: hardware/interfaces/graphics/common/1.2/ - -#ifndef HIDL_GENERATED_ANDROID_HARDWARE_GRAPHICS_COMMON_V1_2_EXPORTED_CONSTANTS_H_ -#define HIDL_GENERATED_ANDROID_HARDWARE_GRAPHICS_COMMON_V1_2_EXPORTED_CONSTANTS_H_ - -#ifdef __cplusplus -extern "C" { -#endif - -typedef enum { - HAL_HDR_HDR10_PLUS = 4, -} android_hdr_v1_2_t; - -typedef enum { - HAL_DATASPACE_DISPLAY_BT2020 = 142999552 /* ((STANDARD_BT2020 | TRANSFER_SRGB) | RANGE_FULL) */, - HAL_DATASPACE_DYNAMIC_DEPTH = 4098 /* 0x1002 */, - HAL_DATASPACE_JPEG_APP_SEGMENTS = 4099 /* 0x1003 */, - HAL_DATASPACE_HEIF = 4100 /* 0x1004 */, -} android_dataspace_v1_2_t; - -typedef enum { - HAL_PIXEL_FORMAT_HSV_888 = 55 /* 0x37 */, -} android_pixel_format_v1_2_t; - -#ifdef __cplusplus -} -#endif - -#endif // HIDL_GENERATED_ANDROID_HARDWARE_GRAPHICS_COMMON_V1_2_EXPORTED_CONSTANTS_H_ diff --git a/.ci/android_headers/system/graphics-base.h b/.ci/android_headers/system/graphics-base.h deleted file mode 100644 index 073b985..0000000 --- a/.ci/android_headers/system/graphics-base.h +++ /dev/null @@ -1,9 +0,0 @@ -// clang-format off -#ifndef SYSTEM_CORE_GRAPHICS_BASE_H_ -#define SYSTEM_CORE_GRAPHICS_BASE_H_ - -#include "graphics-base-v1.0.h" -#include "graphics-base-v1.1.h" -#include "graphics-base-v1.2.h" - -#endif // SYSTEM_CORE_GRAPHICS_BASE_H_ diff --git a/.ci/android_headers/system/graphics-sw.h b/.ci/android_headers/system/graphics-sw.h deleted file mode 100644 index dd29e63..0000000 --- a/.ci/android_headers/system/graphics-sw.h +++ /dev/null @@ -1,17 +0,0 @@ -// clang-format off -#ifndef SYSTEM_CORE_GRAPHICS_SW_H_ -#define SYSTEM_CORE_GRAPHICS_SW_H_ - -/* Software formats not in the HAL definitions. */ -typedef enum { - HAL_PIXEL_FORMAT_YCBCR_422_888 = 39, // 0x27 - HAL_PIXEL_FORMAT_YCBCR_444_888 = 40, // 0x28 - HAL_PIXEL_FORMAT_FLEX_RGB_888 = 41, // 0x29 - HAL_PIXEL_FORMAT_FLEX_RGBA_8888 = 42, // 0x2A -} android_pixel_format_sw_t; - -/* for compatibility */ -#define HAL_PIXEL_FORMAT_YCbCr_422_888 HAL_PIXEL_FORMAT_YCBCR_422_888 -#define HAL_PIXEL_FORMAT_YCbCr_444_888 HAL_PIXEL_FORMAT_YCBCR_444_888 - -#endif // SYSTEM_CORE_GRAPHICS_SW_H_ diff --git a/.ci/android_headers/system/graphics.h b/.ci/android_headers/system/graphics.h deleted file mode 100644 index 8693587..0000000 --- a/.ci/android_headers/system/graphics.h +++ /dev/null @@ -1,269 +0,0 @@ -// clang-format off -/* - * 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_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 - * if they can block the main rendering thread in any way. - * - * the priority of the current thread can be set with: - * - * #include <sys/resource.h> - * setpriority(PRIO_PROCESS, 0, HAL_PRIORITY_URGENT_DISPLAY); - * - */ - -#define HAL_PRIORITY_URGENT_DISPLAY (-8) - -/* - * Structure for describing YCbCr formats for consumption by applications. - * This is used with HAL_PIXEL_FORMAT_YCbCr_*_888. - * - * Buffer chroma subsampling is defined in the format. - * e.g. HAL_PIXEL_FORMAT_YCbCr_420_888 has subsampling 4:2:0. - * - * Buffers must have a 8 bit depth. - * - * 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. - * - * 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. - */ - -struct android_ycbcr { - void *y; - void *cb; - void *cr; - size_t ystride; - size_t cstride; - size_t chroma_step; - - /** reserved for future use, set to 0 by gralloc's (*lock_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. - * When locking a native buffer of the above format and dataSpace value, - * the vaddr pointer can be cast to this structure. - * - * A variable-length list of (x,y,z, confidence) 3D points, as floats. (x, y, - * z) represents a measured point's position, with the coordinate system defined - * by the data source. Confidence represents the estimated likelihood that this - * 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 - * - * xyz_points is the flexible array of floating-point values. - * It contains (num_points) * 4 floats. - * - * For example: - * android_depth_points d = get_depth_buffer(); - * struct { - * float x; float y; float z; float confidence; - * } firstPoint, lastPoint; - * - * firstPoint.x = d.xyzc_points[0]; - * firstPoint.y = d.xyzc_points[1]; - * firstPoint.z = d.xyzc_points[2]; - * firstPoint.confidence = d.xyzc_points[3]; - * lastPoint.x = d.xyzc_points[(d.num_points - 1) * 4 + 0]; - * lastPoint.y = d.xyzc_points[(d.num_points - 1) * 4 + 1]; - * lastPoint.z = d.xyzc_points[(d.num_points - 1) * 4 + 2]; - * lastPoint.confidence = d.xyzc_points[(d.num_points - 1) * 4 + 3]; - */ - -struct android_depth_points { - uint32_t num_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 -}; - -/** - * 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; -}; - -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; -}; - -struct android_cta861_3_metadata { - float maxContentLightLevel; - float maxFrameAverageLightLevel; -}; - -#ifdef __cplusplus -} -#endif - -#endif /* SYSTEM_CORE_INCLUDE_ANDROID_GRAPHICS_H */ diff --git a/.ci/android_headers/ui/GraphicBuffer.h b/.ci/android_headers/ui/GraphicBuffer.h deleted file mode 100644 index 701340c..0000000 --- a/.ci/android_headers/ui/GraphicBuffer.h +++ /dev/null @@ -1,286 +0,0 @@ -// clang-format off -/* - * Copyright (C) 2007 The Android Open Source Project - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -#ifndef ANDROID_GRAPHIC_BUFFER_H -#define ANDROID_GRAPHIC_BUFFER_H - -#include <stdint.h> -#include <sys/types.h> - -#include <string> -#include <utility> -#include <vector> - -#include <android/hardware_buffer.h> -#include <ui/ANativeObjectBase.h> -#include <ui/GraphicBufferMapper.h> -#include <ui/PixelFormat.h> -#include <ui/Rect.h> -#include <utils/Flattenable.h> -#include <utils/RefBase.h> - -#include <nativebase/nativebase.h> - -#include <hardware/gralloc.h> - -namespace android { - -class GraphicBufferMapper; - -using GraphicBufferDeathCallback = std::function<void(void* /*context*/, uint64_t bufferId)>; - -// =========================================================================== -// GraphicBuffer -// =========================================================================== - -class GraphicBuffer - : public ANativeObjectBase<ANativeWindowBuffer, GraphicBuffer, RefBase>, - public Flattenable<GraphicBuffer> -{ - friend class Flattenable<GraphicBuffer>; -public: - - enum { - USAGE_SW_READ_NEVER = GRALLOC_USAGE_SW_READ_NEVER, - USAGE_SW_READ_RARELY = GRALLOC_USAGE_SW_READ_RARELY, - USAGE_SW_READ_OFTEN = GRALLOC_USAGE_SW_READ_OFTEN, - USAGE_SW_READ_MASK = GRALLOC_USAGE_SW_READ_MASK, - - USAGE_SW_WRITE_NEVER = GRALLOC_USAGE_SW_WRITE_NEVER, - USAGE_SW_WRITE_RARELY = GRALLOC_USAGE_SW_WRITE_RARELY, - USAGE_SW_WRITE_OFTEN = GRALLOC_USAGE_SW_WRITE_OFTEN, - USAGE_SW_WRITE_MASK = GRALLOC_USAGE_SW_WRITE_MASK, - - USAGE_SOFTWARE_MASK = USAGE_SW_READ_MASK|USAGE_SW_WRITE_MASK, - - USAGE_PROTECTED = GRALLOC_USAGE_PROTECTED, - - USAGE_HW_TEXTURE = GRALLOC_USAGE_HW_TEXTURE, - USAGE_HW_RENDER = GRALLOC_USAGE_HW_RENDER, - USAGE_HW_2D = GRALLOC_USAGE_HW_2D, - USAGE_HW_COMPOSER = GRALLOC_USAGE_HW_COMPOSER, - USAGE_HW_VIDEO_ENCODER = GRALLOC_USAGE_HW_VIDEO_ENCODER, - USAGE_HW_MASK = GRALLOC_USAGE_HW_MASK, - - USAGE_CURSOR = GRALLOC_USAGE_CURSOR, - }; - - static sp<GraphicBuffer> from(ANativeWindowBuffer *); - - static GraphicBuffer* fromAHardwareBuffer(AHardwareBuffer*); - static GraphicBuffer const* fromAHardwareBuffer(AHardwareBuffer const*); - AHardwareBuffer* toAHardwareBuffer(); - AHardwareBuffer const* toAHardwareBuffer() const; - - // Create a GraphicBuffer to be unflatten'ed into or be reallocated. - GraphicBuffer(); - - // Create a GraphicBuffer by allocating and managing a buffer internally. - // This function is privileged. See reallocate for details. - GraphicBuffer(uint32_t inWidth, uint32_t inHeight, PixelFormat inFormat, - uint32_t inLayerCount, uint64_t inUsage, - std::string requestorName = "<Unknown>"); - - // Create a GraphicBuffer from an existing handle. - enum HandleWrapMethod : uint8_t { - // Wrap and use the handle directly. It assumes the handle has been - // registered and never fails. The handle must have a longer lifetime - // than this wrapping GraphicBuffer. - // - // This can be used when, for example, you want to wrap a handle that - // is already managed by another GraphicBuffer. - WRAP_HANDLE, - - // Take ownership of the handle and use it directly. It assumes the - // handle has been registered and never fails. - // - // This can be used to manage an already registered handle with - // GraphicBuffer. - TAKE_HANDLE, - - // Take onwership of an unregistered handle and use it directly. It - // can fail when the buffer does not register. There is no ownership - // transfer on failures. - // - // This can be used to, for example, create a GraphicBuffer from a - // handle returned by Parcel::readNativeHandle. - TAKE_UNREGISTERED_HANDLE, - - // Make a clone of the handle and use the cloned handle. It can fail - // when cloning fails or when the buffer does not register. There is - // never ownership transfer. - // - // This can be used to create a GraphicBuffer from a handle that - // cannot be used directly, such as one from hidl_handle. - CLONE_HANDLE, - }; - GraphicBuffer(const native_handle_t* inHandle, HandleWrapMethod method, uint32_t inWidth, - uint32_t inHeight, PixelFormat inFormat, uint32_t inLayerCount, uint64_t inUsage, - uint32_t inStride); - - // These functions are deprecated because they only take 32 bits of usage - GraphicBuffer(const native_handle_t* inHandle, HandleWrapMethod method, uint32_t inWidth, - uint32_t inHeight, PixelFormat inFormat, uint32_t inLayerCount, uint32_t inUsage, - uint32_t inStride) - : GraphicBuffer(inHandle, method, inWidth, inHeight, inFormat, inLayerCount, - static_cast<uint64_t>(inUsage), inStride) {} - GraphicBuffer(uint32_t inWidth, uint32_t inHeight, PixelFormat inFormat, - uint32_t inLayerCount, uint32_t inUsage, uint32_t inStride, - native_handle_t* inHandle, bool keepOwnership); - GraphicBuffer(uint32_t inWidth, uint32_t inHeight, PixelFormat inFormat, - uint32_t inUsage, std::string requestorName = "<Unknown>"); - - // return status - status_t initCheck() const; - - uint32_t getWidth() const { return static_cast<uint32_t>(width); } - uint32_t getHeight() const { return static_cast<uint32_t>(height); } - uint32_t getStride() const { return static_cast<uint32_t>(stride); } - uint64_t getUsage() const { return usage; } - PixelFormat getPixelFormat() const { return format; } - uint32_t getLayerCount() const { return static_cast<uint32_t>(layerCount); } - Rect getBounds() const { return Rect(width, height); } - uint64_t getId() const { return mId; } - - uint32_t getGenerationNumber() const { return mGenerationNumber; } - void setGenerationNumber(uint32_t generation) { - mGenerationNumber = generation; - } - - // This function is privileged. It requires access to the allocator - // device or service, which usually involves adding suitable selinux - // rules. - status_t reallocate(uint32_t inWidth, uint32_t inHeight, - PixelFormat inFormat, uint32_t inLayerCount, uint64_t inUsage); - - bool needsReallocation(uint32_t inWidth, uint32_t inHeight, - PixelFormat inFormat, uint32_t inLayerCount, uint64_t inUsage); - - // For the following two lock functions, if bytesPerStride or bytesPerPixel - // are unknown or variable, -1 will be returned - status_t lock(uint32_t inUsage, void** vaddr, int32_t* outBytesPerPixel = nullptr, - int32_t* outBytesPerStride = nullptr); - status_t lock(uint32_t inUsage, const Rect& rect, void** vaddr, - int32_t* outBytesPerPixel = nullptr, int32_t* outBytesPerStride = nullptr); - // For HAL_PIXEL_FORMAT_YCbCr_420_888 - status_t lockYCbCr(uint32_t inUsage, android_ycbcr *ycbcr); - status_t lockYCbCr(uint32_t inUsage, const Rect& rect, - android_ycbcr *ycbcr); - status_t unlock(); - // For the following three lockAsync functions, if bytesPerStride or bytesPerPixel - // are unknown or variable, -1 will be returned - status_t lockAsync(uint32_t inUsage, void** vaddr, int fenceFd, - int32_t* outBytesPerPixel = nullptr, int32_t* outBytesPerStride = nullptr); - status_t lockAsync(uint32_t inUsage, const Rect& rect, void** vaddr, int fenceFd, - int32_t* outBytesPerPixel = nullptr, int32_t* outBytesPerStride = nullptr); - status_t lockAsync(uint64_t inProducerUsage, uint64_t inConsumerUsage, const Rect& rect, - void** vaddr, int fenceFd, int32_t* outBytesPerPixel = nullptr, - int32_t* outBytesPerStride = nullptr); - status_t lockAsyncYCbCr(uint32_t inUsage, android_ycbcr *ycbcr, - int fenceFd); - status_t lockAsyncYCbCr(uint32_t inUsage, const Rect& rect, - android_ycbcr *ycbcr, int fenceFd); - status_t unlockAsync(int *fenceFd); - - status_t isSupported(uint32_t inWidth, uint32_t inHeight, PixelFormat inFormat, - uint32_t inLayerCount, uint64_t inUsage, bool* outSupported) const; - - ANativeWindowBuffer* getNativeBuffer() const; - - // for debugging - static void dumpAllocationsToSystemLog(); - - // Flattenable protocol - size_t getFlattenedSize() const; - size_t getFdCount() const; - status_t flatten(void*& buffer, size_t& size, int*& fds, size_t& count) const; - status_t unflatten(void const*& buffer, size_t& size, int const*& fds, size_t& count); - - GraphicBufferMapper::Version getBufferMapperVersion() const { - return mBufferMapper.getMapperVersion(); - } - - void addDeathCallback(GraphicBufferDeathCallback deathCallback, void* context); - -private: - ~GraphicBuffer(); - - enum { - ownNone = 0, - ownHandle = 1, - ownData = 2, - }; - - inline const GraphicBufferMapper& getBufferMapper() const { - return mBufferMapper; - } - inline GraphicBufferMapper& getBufferMapper() { - return mBufferMapper; - } - uint8_t mOwner; - -private: - friend class Surface; - friend class BpSurface; - friend class BnSurface; - friend class LightRefBase<GraphicBuffer>; - GraphicBuffer(const GraphicBuffer& rhs); - GraphicBuffer& operator = (const GraphicBuffer& rhs); - const GraphicBuffer& operator = (const GraphicBuffer& rhs) const; - - status_t initWithSize(uint32_t inWidth, uint32_t inHeight, - PixelFormat inFormat, uint32_t inLayerCount, - uint64_t inUsage, std::string requestorName); - - status_t initWithHandle(const native_handle_t* inHandle, HandleWrapMethod method, - uint32_t inWidth, uint32_t inHeight, PixelFormat inFormat, - uint32_t inLayerCount, uint64_t inUsage, uint32_t inStride); - - void free_handle(); - - GraphicBufferMapper& mBufferMapper; - ssize_t mInitCheck; - - // numbers of fds/ints in native_handle_t to flatten - uint32_t mTransportNumFds; - uint32_t mTransportNumInts; - - uint64_t mId; - - // Stores the generation number of this buffer. If this number does not - // match the BufferQueue's internal generation number (set through - // IGBP::setGenerationNumber), attempts to attach the buffer will fail. - uint32_t mGenerationNumber; - - // Send a callback when a GraphicBuffer dies. - // - // This is used for BufferStateLayer caching. GraphicBuffers are refcounted per process. When - // A GraphicBuffer doesn't have any more sp<> in a process, it is destroyed. This causes - // problems when trying to implicitcly cache across process boundaries. Ideally, both sides - // of the cache would hold onto wp<> references. When an app dropped its sp<>, the GraphicBuffer - // would be destroyed. Unfortunately, when SurfaceFlinger has only a wp<> reference to the - // GraphicBuffer, it immediately goes out of scope in the SurfaceFlinger process. SurfaceFlinger - // must hold onto a sp<> to the buffer. When the GraphicBuffer goes out of scope in the app's - // process, the client side cache will get this callback. It erases the buffer from its cache - // and informs SurfaceFlinger that it should drop its strong pointer reference to the buffer. - std::vector<std::pair<GraphicBufferDeathCallback, void* /*mDeathCallbackContext*/>> - mDeathCallbacks; -}; - -}; // namespace android - -#endif // ANDROID_GRAPHIC_BUFFER_H diff --git a/.ci/android_headers/utils/Trace.h b/.ci/android_headers/utils/Trace.h deleted file mode 100644 index 88c4db5..0000000 --- a/.ci/android_headers/utils/Trace.h +++ /dev/null @@ -1,62 +0,0 @@ -// clang-format off -/* - * Copyright (C) 2012 The Android Open Source Project - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -#ifndef ANDROID_TRACE_H -#define ANDROID_TRACE_H - -#if defined(_WIN32) - -#define ATRACE_NAME(...) -#define ATRACE_CALL() - -#else // !_WIN32 - -#include <stdint.h> - -#include <cutils/trace.h> - -// See <cutils/trace.h> for more ATRACE_* macros. - -// ATRACE_NAME traces from its location until the end of its enclosing scope. -#define _PASTE(x, y) x ## y -#define PASTE(x, y) _PASTE(x,y) -#define ATRACE_NAME(name) ::android::ScopedTrace PASTE(___tracer, __LINE__)(ATRACE_TAG, name) - -// ATRACE_CALL is an ATRACE_NAME that uses the current function name. -#define ATRACE_CALL() ATRACE_NAME(__FUNCTION__) - -namespace android { - -class ScopedTrace { -public: - inline ScopedTrace(uint64_t tag, const char* name) : mTag(tag) { - atrace_begin(mTag, name); - } - - inline ~ScopedTrace() { - atrace_end(mTag); - } - -private: - uint64_t mTag; -}; - -} // namespace android - -#endif // _WIN32 - -#endif // ANDROID_TRACE_H diff --git a/.clang-tidy b/.clang-tidy index 3731a29..8336d3f 100644 --- a/.clang-tidy +++ b/.clang-tidy @@ -58,3 +58,5 @@ CheckOptions: value: "LOG_TAG|ATRACE_TAG" - key: readability-magic-numbers.IgnoredFloatingPointValues value: '1000.0' + - key: readability-function-cognitive-complexity.IgnoreMacros + value: 1 diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml index 80b010a..bdbb8be 100644 --- a/.gitlab-ci.yml +++ b/.gitlab-ci.yml @@ -24,6 +24,8 @@ build: script: - mkdir -p install/arm64 - cd .. + - rm -f aospless_drm_hwcomposer_arm64.tar.xz + - rm -rf aospless/* - wget https://gitlab.freedesktop.org/drm-hwcomposer/drm-hwcomposer/uploads/28ef9379b1a0ec1ee19a17825b0f3f3f/aospless_drm_hwcomposer_arm64.tar.xz - tar xf aospless_drm_hwcomposer_arm64.tar.xz - rm -r aospless/src @@ -39,6 +41,12 @@ build: tidy: stage: tidy script: + - cd .. + - rm -f aospless_drm_hwcomposer_arm64.tar.xz + - rm -rf aospless/* + - wget https://gitlab.freedesktop.org/drm-hwcomposer/drm-hwcomposer/uploads/28ef9379b1a0ec1ee19a17825b0f3f3f/aospless_drm_hwcomposer_arm64.tar.xz + - tar xf aospless_drm_hwcomposer_arm64.tar.xz + - cd - - make -f .ci/Makefile checkstyle: @@ -59,7 +59,7 @@ ci: ## Run presubmit within the docker container @echo "\n\e[32m --- SUCCESS ---\n" ci_cleanup: ## Cleanup after 'make ci' - $(DOCKER_BIN) exec -it $(IMAGE_NAME) bash -c "make local_cleanup" + $(DOCKER_BIN) exec -it $(IMAGE_NAME) bash -c "make -f .ci/Makefile clean " $(DOCKER_BIN) exec -it $(IMAGE_NAME) bash -c "rm -rf ~/aospless/build" $(DOCKER_BIN) exec -it $(IMAGE_NAME) bash -c "rm -rf ~/aospless/install" $(DOCKER_BIN) exec -it $(IMAGE_NAME) bash -c "rm -rf ~/aospless/out_src" @@ -83,13 +83,3 @@ build_deploy: ## Build for Andoid and deploy onto the target device (require act bd: build_deploy bd: ## Alias for build_deploy - -local_presubmit: ## Run local presubmit script (requires latest Ubuntu + additional packages). Consider 'make ci' instead - @echo "Run native build:" - make -f .ci/Makefile -j12 - @echo "Run style check:" - ./.ci/.gitlab-ci-checkcommit.sh - @echo "\n\e[32m --- SUCCESS ---\n" - -local_cleanup: ## Cleanup after 'make local_presubmit' - make -f .ci/Makefile clean diff --git a/bufferinfo/BufferInfoMapperMetadata.h b/bufferinfo/BufferInfoMapperMetadata.h index ce66fe5..5b05325 100644 --- a/bufferinfo/BufferInfoMapperMetadata.h +++ b/bufferinfo/BufferInfoMapperMetadata.h @@ -26,7 +26,7 @@ class BufferInfoMapperMetadata : public BufferInfoGetter { auto GetBoInfo(buffer_handle_t handle) -> std::optional<BufferInfo> override; - int GetFds(buffer_handle_t handle, BufferInfo *bo); + static int GetFds(buffer_handle_t handle, BufferInfo *bo); static BufferInfoGetter *CreateInstance(); }; diff --git a/drm/DrmAtomicStateManager.h b/drm/DrmAtomicStateManager.h index e5a0945..923927d 100644 --- a/drm/DrmAtomicStateManager.h +++ b/drm/DrmAtomicStateManager.h @@ -44,7 +44,7 @@ struct AtomicCommitArgs { SharedFd out_fence; /* helpers */ - auto HasInputs() -> bool { + auto HasInputs() const -> bool { return display_mode || active || composition; } }; diff --git a/hwc2_device/HwcDisplay.h b/hwc2_device/HwcDisplay.h index aef029a..13d4328 100644 --- a/hwc2_device/HwcDisplay.h +++ b/hwc2_device/HwcDisplay.h @@ -37,6 +37,7 @@ class DrmHwcTwo; inline constexpr uint32_t kPrimaryDisplay = 0; +// NOLINTNEXTLINE class HwcDisplay { public: HwcDisplay(hwc2_display_t handle, HWC2::DisplayType type, DrmHwcTwo *hwc2); |