window.h revision 5100916182b05971975f8d8fe65a1255e2c5ac96
10ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 20ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Copyright (C) 2011 The Android Open Source Project 30ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 40ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Licensed under the Apache License, Version 2.0 (the "License"); 50ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * you may not use this file except in compliance with the License. 60ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * You may obtain a copy of the License at 70ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 80ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * http://www.apache.org/licenses/LICENSE-2.0 90ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 100ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Unless required by applicable law or agreed to in writing, software 110ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * distributed under the License is distributed on an "AS IS" BASIS, 120ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 130ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * See the License for the specific language governing permissions and 140ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * limitations under the License. 150ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 160ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 170ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#ifndef SYSTEM_CORE_INCLUDE_ANDROID_WINDOW_H 180ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#define SYSTEM_CORE_INCLUDE_ANDROID_WINDOW_H 190ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 200ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#include <stdint.h> 210ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#include <sys/cdefs.h> 220ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#include <system/graphics.h> 230ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#include <cutils/native_handle.h> 240ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 250ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev__BEGIN_DECLS 260ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 270ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/*****************************************************************************/ 280ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 290ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#define ANDROID_NATIVE_MAKE_CONSTANT(a,b,c,d) \ 300ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev (((unsigned)(a)<<24)|((unsigned)(b)<<16)|((unsigned)(c)<<8)|(unsigned)(d)) 310ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 320ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#define ANDROID_NATIVE_WINDOW_MAGIC \ 330ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev ANDROID_NATIVE_MAKE_CONSTANT('_','w','n','d') 340ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 350ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#define ANDROID_NATIVE_BUFFER_MAGIC \ 360ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev ANDROID_NATIVE_MAKE_CONSTANT('_','b','f','r') 370ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 380ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev// --------------------------------------------------------------------------- 390ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 400ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef const native_handle_t* buffer_handle_t; 410ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 420ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev// --------------------------------------------------------------------------- 430ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 440ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef struct android_native_rect_t 450ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 460ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int32_t left; 470ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int32_t top; 480ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int32_t right; 490ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int32_t bottom; 500ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} android_native_rect_t; 510ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 520ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev// --------------------------------------------------------------------------- 530ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 540ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef struct android_native_base_t 550ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 560ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* a magic value defined by the actual EGL native type */ 570ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int magic; 580ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 590ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* the sizeof() of the actual EGL native type */ 600ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int version; 610ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 620ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void* reserved[4]; 630ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 640ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* reference-counting interface */ 650ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void (*incRef)(struct android_native_base_t* base); 660ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void (*decRef)(struct android_native_base_t* base); 670ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} android_native_base_t; 680ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 690ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef struct ANativeWindowBuffer 700ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 710ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#ifdef __cplusplus 720ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev ANativeWindowBuffer() { 730ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.magic = ANDROID_NATIVE_BUFFER_MAGIC; 740ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.version = sizeof(ANativeWindowBuffer); 750ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev memset(common.reserved, 0, sizeof(common.reserved)); 760ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev } 770ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 780ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev // Implement the methods that sp<ANativeWindowBuffer> expects so that it 790ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev // can be used to automatically refcount ANativeWindowBuffer's. 800ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void incStrong(const void* id) const { 810ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.incRef(const_cast<android_native_base_t*>(&common)); 820ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev } 830ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void decStrong(const void* id) const { 840ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.decRef(const_cast<android_native_base_t*>(&common)); 850ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev } 860ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#endif 870ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 880ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct android_native_base_t common; 890ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 900ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int width; 910ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int height; 920ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int stride; 930ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int format; 940ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int usage; 950ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 960ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void* reserved[2]; 970ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 980ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev buffer_handle_t handle; 990ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1000ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void* reserved_proc[8]; 1010ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} ANativeWindowBuffer_t; 1020ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1030ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev// Old typedef for backwards compatibility. 1040ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef ANativeWindowBuffer_t android_native_buffer_t; 1050ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1060ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev// --------------------------------------------------------------------------- 1070ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1080ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* attributes queriable with query() */ 1090ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevenum { 1100ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_WIDTH = 0, 11142cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_HEIGHT = 1, 11242cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_FORMAT = 2, 1130ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1140ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* The minimum number of buffers that must remain un-dequeued after a buffer 1150ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * has been queued. This value applies only if set_buffer_count was used to 1160ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * override the number of buffers and if a buffer has since been queued. 1170ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Users of the set_buffer_count ANativeWindow method should query this 1180ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * value before calling set_buffer_count. If it is necessary to have N 1190ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * buffers simultaneously dequeued as part of the steady-state operation, 1200ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * and this query returns M then N+M buffers should be requested via 1210ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_buffer_count. 1220ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 1230ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Note that this value does NOT apply until a single buffer has been 1240ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * queued. In particular this means that it is possible to: 1250ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 1260ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 1. Query M = min undequeued buffers 1270ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 2. Set the buffer count to N + M 1280ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3. Dequeue all N + M buffers 1290ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 4. Cancel M buffers 1300ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 5. Queue, dequeue, queue, dequeue, ad infinitum 1310ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 13242cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_MIN_UNDEQUEUED_BUFFERS = 3, 1330ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1340ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* Check whether queueBuffer operations on the ANativeWindow send the buffer 1350ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * to the window compositor. The query sets the returned 'value' argument 1360ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * to 1 if the ANativeWindow DOES send queued buffers directly to the window 1370ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * compositor and 0 if the buffers do not go directly to the window 1380ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * compositor. 1390ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 1400ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * This can be used to determine whether protected buffer content should be 1410ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * sent to the ANativeWindow. Note, however, that a result of 1 does NOT 1420ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * indicate that queued buffers will be protected from applications or users 1430ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * capturing their contents. If that behavior is desired then some other 1440ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * mechanism (e.g. the GRALLOC_USAGE_PROTECTED flag) should be used in 1450ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * conjunction with this query. 1460ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 14742cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_QUEUES_TO_WINDOW_COMPOSER = 4, 1480ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1490ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* Get the concrete type of a ANativeWindow. See below for the list of 1500ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * possible return values. 1510ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 1520ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * This query should not be used outside the Android framework and will 1530ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * likely be removed in the near future. 1540ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 15542cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_CONCRETE_TYPE = 5, 1565100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian 1575100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian 1585100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian /* 1595100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * Default width and height of the ANativeWindow, these are the dimensions 1605100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * of the window irrespective of the NATIVE_WINDOW_SET_BUFFERS_DIMENSIONS 1615100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * call. 1625100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian */ 1635100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian NATIVE_WINDOW_DEFAULT_WIDTH = 6, 1645100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian NATIVE_WINDOW_DEFAULT_HEIGHT = 7, 1655100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian 1665100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian /* 1675100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * transformation that will most-likely be applied to buffers. This is only 1685100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * a hint, the actual transformation applied might be different. 1695100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 1705100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * INTENDED USE: 1715100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 1725100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * The transform hint can be used by a producer, for instance the GLES 1735100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * driver, to pre-rotate the rendering such that the final transformation 1745100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * in the composer is identity. This can be very useful when used in 1755100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * conjunction with the h/w composer HAL, in situations where it 1765100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * cannot handle arbitrary rotations. 1775100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 1785100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 1. Before dequeuing a buffer, the GL driver (or any other ANW client) 1795100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * queries the ANW for NATIVE_WINDOW_TRANSFORM_HINT. 1805100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 1815100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 2. The GL driver overrides the width and height of the ANW to 1825100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * account for NATIVE_WINDOW_TRANSFORM_HINT. This is done by querying 1835100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * NATIVE_WINDOW_DEFAULT_{WIDTH | HEIGHT}, swapping the dimensions 1845100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * according to NATIVE_WINDOW_TRANSFORM_HINT and calling 1855100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * native_window_set_buffers_dimensions(). 1865100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 1875100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 3. The GL driver dequeues a buffer of the new pre-rotated size. 1885100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 1895100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 4. The GL driver renders to the buffer such that the image is 1905100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * already transformed, that is applying NATIVE_WINDOW_TRANSFORM_HINT 1915100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * to the rendering. 1925100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 1935100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 5. The GL driver calls native_window_set_transform to apply 1945100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * inverse transformation to the buffer it just rendered. 1955100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * In order to do this, the GL driver needs 1965100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * to calculate the inverse of NATIVE_WINDOW_TRANSFORM_HINT, this is 1975100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * done easily: 1985100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 1995100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * int hintTransform, inverseTransform; 2005100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * query(..., NATIVE_WINDOW_TRANSFORM_HINT, &hintTransform); 2015100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * inverseTransform = hintTransform; 2025100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * if (hintTransform & HAL_TRANSFORM_ROT_90) 2035100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * inverseTransform ^= HAL_TRANSFORM_ROT_180; 2045100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 2055100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 2065100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 6. The GL driver queues the pre-transformed buffer. 2075100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 2085100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 7. The composer combines the buffer transform with the display 2095100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * transform. If the buffer transform happens to cancel out the 2105100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * display transform then no rotation is needed. 2115100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 2125100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian */ 2135100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian NATIVE_WINDOW_TRANSFORM_HINT = 8, 2140ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 2150ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2160ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* valid operations for the (*perform)() hook */ 2170ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevenum { 21842cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_USAGE = 0, 21942cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_CONNECT = 1, 22042cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_DISCONNECT = 2, 22142cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_CROP = 3, 22242cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_BUFFER_COUNT = 4, 22342cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_BUFFERS_GEOMETRY = 5, /* deprecated */ 22442cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_BUFFERS_TRANSFORM = 6, 22542cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_BUFFERS_TIMESTAMP = 7, 22642cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_BUFFERS_DIMENSIONS = 8, 22742cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_BUFFERS_FORMAT = 9, 228ae3736a3d1418eb1a1e57895ce410256d7106aa3Mathias Agopian NATIVE_WINDOW_SET_SCALING_MODE = 10, 229ae3736a3d1418eb1a1e57895ce410256d7106aa3Mathias Agopian NATIVE_WINDOW_LOCK = 11, /* private */ 230ae3736a3d1418eb1a1e57895ce410256d7106aa3Mathias Agopian NATIVE_WINDOW_UNLOCK_AND_POST = 12, /* private */ 2310ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 2320ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2330ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* parameter for NATIVE_WINDOW_[DIS]CONNECT */ 2340ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevenum { 2355423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis /* Buffers will be queued by EGL via eglSwapBuffers after being filled using 2365423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis * OpenGL ES. 2375423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis */ 2385423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis NATIVE_WINDOW_API_EGL = 1, 2395423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis 2405423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis /* Buffers will be queued after being filled using the CPU 2415423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis */ 2425423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis NATIVE_WINDOW_API_CPU = 2, 2435423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis 2445423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis /* Buffers will be queued by Stagefright after being filled by a video 2455423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis * decoder. The video decoder can either be a software or hardware decoder. 2465423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis */ 2475423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis NATIVE_WINDOW_API_MEDIA = 3, 2485423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis 2495423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis /* Buffers will be queued by the the camera HAL. 2505423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis */ 2515423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis NATIVE_WINDOW_API_CAMERA = 4, 2520ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 2530ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2540ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* parameter for NATIVE_WINDOW_SET_BUFFERS_TRANSFORM */ 2550ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevenum { 2560ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* flip source image horizontally */ 2570ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_TRANSFORM_FLIP_H = HAL_TRANSFORM_FLIP_H , 2580ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* flip source image vertically */ 2590ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_TRANSFORM_FLIP_V = HAL_TRANSFORM_FLIP_V, 2600ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* rotate source image 90 degrees clock-wise */ 2610ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_TRANSFORM_ROT_90 = HAL_TRANSFORM_ROT_90, 2620ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* rotate source image 180 degrees */ 2630ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_TRANSFORM_ROT_180 = HAL_TRANSFORM_ROT_180, 2640ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* rotate source image 270 degrees clock-wise */ 2650ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_TRANSFORM_ROT_270 = HAL_TRANSFORM_ROT_270, 2660ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 2670ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 26842cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian/* parameter for NATIVE_WINDOW_SET_SCALING_MODE */ 26942cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopianenum { 27042cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian /* the window content is not updated (frozen) until a buffer of 27142cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * the window size is received (enqueued) 27242cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian */ 27342cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SCALING_MODE_FREEZE = 0, 27442cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian /* the buffer is scaled in both dimensions to match the window size */ 27542cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SCALING_MODE_SCALE_TO_WINDOW = 1, 27642cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian}; 27742cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian 2780ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* values returned by the NATIVE_WINDOW_CONCRETE_TYPE query */ 2790ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevenum { 28042cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_FRAMEBUFFER = 0, /* FramebufferNativeWindow */ 28142cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SURFACE = 1, /* Surface */ 28242cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SURFACE_TEXTURE_CLIENT = 2, /* SurfaceTextureClient */ 2830ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 2840ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2850ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* parameter for NATIVE_WINDOW_SET_BUFFERS_TIMESTAMP 2860ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 2870ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Special timestamp value to indicate that timestamps should be auto-generated 2880ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * by the native window when queueBuffer is called. This is equal to INT64_MIN, 2890ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * defined directly to avoid problems with C99/C++ inclusion of stdint.h. 2900ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 2910ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic const int64_t NATIVE_WINDOW_TIMESTAMP_AUTO = (-9223372036854775807LL-1); 2920ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2930ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstruct ANativeWindow 2940ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 2950ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#ifdef __cplusplus 2960ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev ANativeWindow() 2970ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev : flags(0), minSwapInterval(0), maxSwapInterval(0), xdpi(0), ydpi(0) 2980ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev { 2990ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.magic = ANDROID_NATIVE_WINDOW_MAGIC; 3000ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.version = sizeof(ANativeWindow); 3010ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev memset(common.reserved, 0, sizeof(common.reserved)); 3020ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev } 3030ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 30442cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian /* Implement the methods that sp<ANativeWindow> expects so that it 30542cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian can be used to automatically refcount ANativeWindow's. */ 3060ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void incStrong(const void* id) const { 3070ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.incRef(const_cast<android_native_base_t*>(&common)); 3080ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev } 3090ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void decStrong(const void* id) const { 3100ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.decRef(const_cast<android_native_base_t*>(&common)); 3110ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev } 3120ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#endif 3130ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3140ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct android_native_base_t common; 3150ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3160ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* flags describing some attributes of this surface or its updater */ 3170ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev const uint32_t flags; 3180ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3190ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* min swap interval supported by this updated */ 3200ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev const int minSwapInterval; 3210ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3220ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* max swap interval supported by this updated */ 3230ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev const int maxSwapInterval; 3240ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3250ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* horizontal and vertical resolution in DPI */ 3260ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev const float xdpi; 3270ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev const float ydpi; 3280ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3290ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* Some storage reserved for the OEM's driver. */ 3300ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev intptr_t oem[4]; 3310ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3320ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 3330ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Set the swap interval for this surface. 3340ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3350ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Returns 0 on success or -errno on error. 3360ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 3370ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*setSwapInterval)(struct ANativeWindow* window, 3380ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int interval); 3390ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3400ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 3410ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * hook called by EGL to acquire a buffer. After this call, the buffer 3420ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * is not locked, so its content cannot be modified. 3430ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * this call may block if no buffers are available. 3440ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3450ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Returns 0 on success or -errno on error. 3460ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 3470ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*dequeueBuffer)(struct ANativeWindow* window, 3480ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindowBuffer** buffer); 3490ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3500ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 3510ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * hook called by EGL to lock a buffer. This MUST be called before modifying 3520ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * the content of a buffer. The buffer must have been acquired with 3530ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * dequeueBuffer first. 3540ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3550ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Returns 0 on success or -errno on error. 3560ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 3570ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*lockBuffer)(struct ANativeWindow* window, 3580ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindowBuffer* buffer); 3590ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 3600ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * hook called by EGL when modifications to the render buffer are done. 3610ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * This unlocks and post the buffer. 3620ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3630ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Buffers MUST be queued in the same order than they were dequeued. 3640ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3650ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Returns 0 on success or -errno on error. 3660ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 3670ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*queueBuffer)(struct ANativeWindow* window, 3680ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindowBuffer* buffer); 3690ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3700ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 3710ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * hook used to retrieve information about the native window. 3720ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3730ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Returns 0 on success or -errno on error. 3740ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 3750ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*query)(const struct ANativeWindow* window, 3760ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int what, int* value); 3770ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3780ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 3790ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * hook used to perform various operations on the surface. 3800ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * (*perform)() is a generic mechanism to add functionality to 3810ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * ANativeWindow while keeping backward binary compatibility. 3820ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3830ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * DO NOT CALL THIS HOOK DIRECTLY. Instead, use the helper functions 3840ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * defined below. 3850ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3860ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * (*perform)() returns -ENOENT if the 'what' parameter is not supported 3870ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * by the surface's implementation. 3880ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3890ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * The valid operations are: 3900ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_SET_USAGE 3910ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_CONNECT 3920ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_DISCONNECT 3930ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_SET_CROP 3940ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_SET_BUFFER_COUNT 39542cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * NATIVE_WINDOW_SET_BUFFERS_GEOMETRY (deprecated) 3960ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_SET_BUFFERS_TRANSFORM 3970ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_SET_BUFFERS_TIMESTAMP 398208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * NATIVE_WINDOW_SET_BUFFERS_DIMENSIONS 399208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * NATIVE_WINDOW_SET_BUFFERS_FORMAT 40042cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * NATIVE_WINDOW_SET_SCALING_MODE 401ae3736a3d1418eb1a1e57895ce410256d7106aa3Mathias Agopian * NATIVE_WINDOW_LOCK (private) 402ae3736a3d1418eb1a1e57895ce410256d7106aa3Mathias Agopian * NATIVE_WINDOW_UNLOCK_AND_POST (private) 4030ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 4040ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 4050ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4060ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*perform)(struct ANativeWindow* window, 4070ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int operation, ... ); 4080ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4090ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 4100ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * hook used to cancel a buffer that has been dequeued. 4110ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * No synchronization is performed between dequeue() and cancel(), so 4120ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * either external synchronization is needed, or these functions must be 4130ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * called from the same thread. 4140ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 4150ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*cancelBuffer)(struct ANativeWindow* window, 4160ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindowBuffer* buffer); 4170ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4180ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4190ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void* reserved_proc[2]; 4200ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 4210ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4220ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* Backwards compatibility: use ANativeWindow (struct ANativeWindow in C). 4230ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * android_native_window_t is deprecated. 4240ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 4250ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef struct ANativeWindow ANativeWindow; 4260ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef struct ANativeWindow android_native_window_t; 4270ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4280ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 4290ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_usage(..., usage) 4300ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Sets the intended usage flags for the next buffers 4310ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * acquired with (*lockBuffer)() and on. 4320ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * By default (if this function is never called), a usage of 4330ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * GRALLOC_USAGE_HW_RENDER | GRALLOC_USAGE_HW_TEXTURE 4340ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * is assumed. 4350ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Calling this function will usually cause following buffers to be 4360ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * reallocated. 4370ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 4380ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4390ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_set_usage( 4400ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, int usage) 4410ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 4420ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_SET_USAGE, usage); 4430ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 4440ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4450ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 4460ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_connect(..., NATIVE_WINDOW_API_EGL) 4470ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Must be called by EGL when the window is made current. 4480ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Returns -EINVAL if for some reason the window cannot be connected, which 4490ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * can happen if it's connected to some other API. 4500ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 4510ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_connect( 4520ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, int api) 4530ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 4540ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_CONNECT, api); 4550ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 4560ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4570ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 4580ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_disconnect(..., NATIVE_WINDOW_API_EGL) 4590ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Must be called by EGL when the window is made not current. 4600ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * An error is returned if for instance the window wasn't connected in the 4610ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * first place. 4620ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 4630ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_disconnect( 4640ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, int api) 4650ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 4660ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_DISCONNECT, api); 4670ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 4680ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4690ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 4700ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_crop(..., crop) 4710ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Sets which region of the next queued buffers needs to be considered. 4720ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * A buffer's crop region is scaled to match the surface's size. 4730ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 4740ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * The specified crop region applies to all buffers queued after it is called. 4750ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 4760ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * if 'crop' is NULL, subsequently queued buffers won't be cropped. 4770ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 4780ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * An error is returned if for instance the crop region is invalid, 4790ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * out of the buffer's bound or if the window is invalid. 4800ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 4810ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_set_crop( 4820ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, 4830ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev android_native_rect_t const * crop) 4840ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 4850ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_SET_CROP, crop); 4860ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 4870ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4880ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 4890ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_buffer_count(..., count) 4900ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Sets the number of buffers associated with this native window. 4910ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 4920ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_set_buffer_count( 4930ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, 4940ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev size_t bufferCount) 4950ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 4960ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_SET_BUFFER_COUNT, bufferCount); 4970ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 4980ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4990ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 5000ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_buffers_geometry(..., int w, int h, int format) 501208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * All buffers dequeued after this call will have the dimensions and format 502208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * specified. A successful call to this function has the same effect as calling 503208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * native_window_set_buffers_size and native_window_set_buffers_format. 504208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * 505208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * XXX: This function is deprecated. The native_window_set_buffers_dimensions 506208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * and native_window_set_buffers_format functions should be used instead. 507208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis */ 508208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennisstatic inline int native_window_set_buffers_geometry( 509208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis struct ANativeWindow* window, 510208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis int w, int h, int format) 511208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis{ 512208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_GEOMETRY, 513208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis w, h, format); 514208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis} 515208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis 516208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis/* 517208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * native_window_set_buffers_dimensions(..., int w, int h) 518208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * All buffers dequeued after this call will have the dimensions specified. 5190ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * In particular, all buffers will have a fixed-size, independent form the 52042cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * native-window size. They will be scaled according to the scaling mode 52142cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * (see native_window_set_scaling_mode) upon window composition. 5220ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 523208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * If w and h are 0, the normal behavior is restored. That is, dequeued buffers 524208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * following this call will be sized to match the window's size. 5250ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 5260ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Calling this function will reset the window crop to a NULL value, which 5270ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * disables cropping of the buffers. 5280ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 529208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennisstatic inline int native_window_set_buffers_dimensions( 5300ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, 531208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis int w, int h) 5320ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 533208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_DIMENSIONS, 534208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis w, h); 535208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis} 536208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis 537208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis/* 538208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * native_window_set_buffers_format(..., int format) 539208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * All buffers dequeued after this call will have the format specified. 540208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * 541208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * If the specified format is 0, the default buffer format will be used. 542208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis */ 543208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennisstatic inline int native_window_set_buffers_format( 544208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis struct ANativeWindow* window, 545208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis int format) 546208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis{ 547208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_FORMAT, format); 5480ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 5490ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 5500ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 5510ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_buffers_transform(..., int transform) 5520ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * All buffers queued after this call will be displayed transformed according 5530ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * to the transform parameter specified. 5540ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 5550ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_set_buffers_transform( 5560ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, 5570ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int transform) 5580ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 5590ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_TRANSFORM, 5600ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev transform); 5610ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 5620ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 5630ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 5640ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_buffers_timestamp(..., int64_t timestamp) 5650ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * All buffers queued after this call will be associated with the timestamp 5660ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * parameter specified. If the timestamp is set to NATIVE_WINDOW_TIMESTAMP_AUTO 5670ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * (the default), timestamps will be generated automatically when queueBuffer is 568c322f67140d52014c47dff41d03a601b251f56edGlenn Kasten * called. The timestamp is measured in nanoseconds, and is normally monotonically 569c322f67140d52014c47dff41d03a601b251f56edGlenn Kasten * increasing. The timestamp should be unaffected by time-of-day adjustments, 570c322f67140d52014c47dff41d03a601b251f56edGlenn Kasten * and for a camera should be strictly monotonic but for a media player may be 571c322f67140d52014c47dff41d03a601b251f56edGlenn Kasten * reset when the position is set. 5720ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 5730ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_set_buffers_timestamp( 5740ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, 5750ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int64_t timestamp) 5760ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 5770ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_TIMESTAMP, 5780ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev timestamp); 5790ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 5800ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 58142cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian/* 58242cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * native_window_set_scaling_mode(..., int mode) 58342cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * All buffers queued after this call will be associated with the scaling mode 58442cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * specified. 58542cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian */ 58642cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopianstatic inline int native_window_set_scaling_mode( 58742cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian struct ANativeWindow* window, 58842cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian int mode) 58942cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian{ 59042cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian return window->perform(window, NATIVE_WINDOW_SET_SCALING_MODE, 59142cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian mode); 59242cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian} 59342cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian 5940ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev__END_DECLS 5950ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 5961ffdb38213d177a83d74e1dc3bf41237dcbe8c9atedbo#endif /* SYSTEM_CORE_INCLUDE_ANDROID_WINDOW_H */ 597