window.h revision fb1ee571446c13ad698e91f13fd4e0274a37d4d7
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> 21c958a7f4988f3dd98135b23619cdf55ec55bd1f6Mathias Agopian#include <string.h> 220ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#include <sys/cdefs.h> 230ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#include <system/graphics.h> 240ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#include <cutils/native_handle.h> 250ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 260ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev__BEGIN_DECLS 270ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 280ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/*****************************************************************************/ 290ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 300ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#define ANDROID_NATIVE_MAKE_CONSTANT(a,b,c,d) \ 310ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev (((unsigned)(a)<<24)|((unsigned)(b)<<16)|((unsigned)(c)<<8)|(unsigned)(d)) 320ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 330ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#define ANDROID_NATIVE_WINDOW_MAGIC \ 340ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev ANDROID_NATIVE_MAKE_CONSTANT('_','w','n','d') 350ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 360ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#define ANDROID_NATIVE_BUFFER_MAGIC \ 370ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev ANDROID_NATIVE_MAKE_CONSTANT('_','b','f','r') 380ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 390ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev// --------------------------------------------------------------------------- 400ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 410ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef const native_handle_t* buffer_handle_t; 420ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 430ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev// --------------------------------------------------------------------------- 440ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 450ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef struct android_native_rect_t 460ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 470ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int32_t left; 480ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int32_t top; 490ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int32_t right; 500ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int32_t bottom; 510ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} android_native_rect_t; 520ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 530ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev// --------------------------------------------------------------------------- 540ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 550ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef struct android_native_base_t 560ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 570ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* a magic value defined by the actual EGL native type */ 580ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int magic; 590ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 600ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* the sizeof() of the actual EGL native type */ 610ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int version; 620ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 630ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void* reserved[4]; 640ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 650ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* reference-counting interface */ 660ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void (*incRef)(struct android_native_base_t* base); 670ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void (*decRef)(struct android_native_base_t* base); 680ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} android_native_base_t; 690ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 700ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef struct ANativeWindowBuffer 710ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 720ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#ifdef __cplusplus 730ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev ANativeWindowBuffer() { 740ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.magic = ANDROID_NATIVE_BUFFER_MAGIC; 750ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.version = sizeof(ANativeWindowBuffer); 760ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev memset(common.reserved, 0, sizeof(common.reserved)); 770ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev } 780ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 790ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev // Implement the methods that sp<ANativeWindowBuffer> expects so that it 800ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev // can be used to automatically refcount ANativeWindowBuffer's. 810ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void incStrong(const void* id) const { 820ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.incRef(const_cast<android_native_base_t*>(&common)); 830ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev } 840ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void decStrong(const void* id) const { 850ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.decRef(const_cast<android_native_base_t*>(&common)); 860ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev } 870ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#endif 880ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 890ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct android_native_base_t common; 900ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 910ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int width; 920ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int height; 930ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int stride; 940ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int format; 950ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int usage; 960ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 970ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void* reserved[2]; 980ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 990ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev buffer_handle_t handle; 1000ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1010ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void* reserved_proc[8]; 1020ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} ANativeWindowBuffer_t; 1030ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1040ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev// Old typedef for backwards compatibility. 1050ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef ANativeWindowBuffer_t android_native_buffer_t; 1060ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1070ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev// --------------------------------------------------------------------------- 1080ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1090ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* attributes queriable with query() */ 1100ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevenum { 1110ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_WIDTH = 0, 11242cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_HEIGHT = 1, 11342cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_FORMAT = 2, 1140ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1150ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* The minimum number of buffers that must remain un-dequeued after a buffer 1160ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * has been queued. This value applies only if set_buffer_count was used to 1170ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * override the number of buffers and if a buffer has since been queued. 1180ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Users of the set_buffer_count ANativeWindow method should query this 1190ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * value before calling set_buffer_count. If it is necessary to have N 1200ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * buffers simultaneously dequeued as part of the steady-state operation, 1210ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * and this query returns M then N+M buffers should be requested via 1220ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_buffer_count. 1230ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 1240ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Note that this value does NOT apply until a single buffer has been 1250ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * queued. In particular this means that it is possible to: 1260ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 1270ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 1. Query M = min undequeued buffers 1280ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 2. Set the buffer count to N + M 1290ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3. Dequeue all N + M buffers 1300ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 4. Cancel M buffers 1310ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 5. Queue, dequeue, queue, dequeue, ad infinitum 1320ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 13342cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_MIN_UNDEQUEUED_BUFFERS = 3, 1340ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1350ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* Check whether queueBuffer operations on the ANativeWindow send the buffer 1360ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * to the window compositor. The query sets the returned 'value' argument 1370ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * to 1 if the ANativeWindow DOES send queued buffers directly to the window 1380ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * compositor and 0 if the buffers do not go directly to the window 1390ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * compositor. 1400ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 1410ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * This can be used to determine whether protected buffer content should be 1420ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * sent to the ANativeWindow. Note, however, that a result of 1 does NOT 1430ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * indicate that queued buffers will be protected from applications or users 1440ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * capturing their contents. If that behavior is desired then some other 1450ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * mechanism (e.g. the GRALLOC_USAGE_PROTECTED flag) should be used in 1460ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * conjunction with this query. 1470ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 14842cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_QUEUES_TO_WINDOW_COMPOSER = 4, 1490ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1500ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* Get the concrete type of a ANativeWindow. See below for the list of 1510ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * possible return values. 1520ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 1530ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * This query should not be used outside the Android framework and will 1540ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * likely be removed in the near future. 1550ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 15642cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_CONCRETE_TYPE = 5, 1575100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian 1585100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian 1595100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian /* 160afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * Default width and height of ANativeWindow buffers, these are the 161afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * dimensions of the window buffers irrespective of the 162afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * NATIVE_WINDOW_SET_BUFFERS_DIMENSIONS call and match the native window 163afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * size unless overriden by NATIVE_WINDOW_SET_BUFFERS_USER_DIMENSIONS. 1645100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian */ 1655100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian NATIVE_WINDOW_DEFAULT_WIDTH = 6, 1665100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian NATIVE_WINDOW_DEFAULT_HEIGHT = 7, 1675100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian 1685100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian /* 1695100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * transformation that will most-likely be applied to buffers. This is only 1705100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * a hint, the actual transformation applied might be different. 1715100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 1725100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * INTENDED USE: 1735100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 1745100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * The transform hint can be used by a producer, for instance the GLES 1755100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * driver, to pre-rotate the rendering such that the final transformation 1765100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * in the composer is identity. This can be very useful when used in 1775100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * conjunction with the h/w composer HAL, in situations where it 1785100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * cannot handle arbitrary rotations. 1795100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 1805100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 1. Before dequeuing a buffer, the GL driver (or any other ANW client) 1815100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * queries the ANW for NATIVE_WINDOW_TRANSFORM_HINT. 1825100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 1835100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 2. The GL driver overrides the width and height of the ANW to 1845100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * account for NATIVE_WINDOW_TRANSFORM_HINT. This is done by querying 1855100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * NATIVE_WINDOW_DEFAULT_{WIDTH | HEIGHT}, swapping the dimensions 1865100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * according to NATIVE_WINDOW_TRANSFORM_HINT and calling 1875100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * native_window_set_buffers_dimensions(). 1885100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 1895100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 3. The GL driver dequeues a buffer of the new pre-rotated size. 1905100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 1915100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 4. The GL driver renders to the buffer such that the image is 1925100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * already transformed, that is applying NATIVE_WINDOW_TRANSFORM_HINT 1935100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * to the rendering. 1945100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 1955100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 5. The GL driver calls native_window_set_transform to apply 1965100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * inverse transformation to the buffer it just rendered. 1975100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * In order to do this, the GL driver needs 1985100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * to calculate the inverse of NATIVE_WINDOW_TRANSFORM_HINT, this is 1995100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * done easily: 2005100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 2015100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * int hintTransform, inverseTransform; 2025100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * query(..., NATIVE_WINDOW_TRANSFORM_HINT, &hintTransform); 2035100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * inverseTransform = hintTransform; 2045100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * if (hintTransform & HAL_TRANSFORM_ROT_90) 2055100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * inverseTransform ^= HAL_TRANSFORM_ROT_180; 2065100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 2075100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 2085100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 6. The GL driver queues the pre-transformed buffer. 2095100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 2105100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 7. The composer combines the buffer transform with the display 2115100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * transform. If the buffer transform happens to cancel out the 2125100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * display transform then no rotation is needed. 2135100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian * 2145100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian */ 2155100916182b05971975f8d8fe65a1255e2c5ac96Mathias Agopian NATIVE_WINDOW_TRANSFORM_HINT = 8, 2160ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 2170ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 218fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis/* Valid operations for the (*perform)() hook. 219fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * 220fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * Values marked as 'deprecated' are supported, but have been superceded by 221fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * other functionality. 222fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * 223fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * Values marked as 'private' should be considered private to the framework. 224fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * HAL implementation code with access to an ANativeWindow should not use these, 225fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * as it may not interact properly with the framework's use of the 226fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * ANativeWindow. 227fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis */ 2280ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevenum { 22942cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_USAGE = 0, 2308ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian NATIVE_WINDOW_CONNECT = 1, /* deprecated */ 2318ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian NATIVE_WINDOW_DISCONNECT = 2, /* deprecated */ 232fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis NATIVE_WINDOW_SET_CROP = 3, /* private */ 23342cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_BUFFER_COUNT = 4, 23442cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_BUFFERS_GEOMETRY = 5, /* deprecated */ 23542cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_BUFFERS_TRANSFORM = 6, 23642cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_BUFFERS_TIMESTAMP = 7, 23742cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_BUFFERS_DIMENSIONS = 8, 23842cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_BUFFERS_FORMAT = 9, 239fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis NATIVE_WINDOW_SET_SCALING_MODE = 10, /* private */ 240ae3736a3d1418eb1a1e57895ce410256d7106aa3Mathias Agopian NATIVE_WINDOW_LOCK = 11, /* private */ 241ae3736a3d1418eb1a1e57895ce410256d7106aa3Mathias Agopian NATIVE_WINDOW_UNLOCK_AND_POST = 12, /* private */ 2428ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian NATIVE_WINDOW_API_CONNECT = 13, /* private */ 2438ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian NATIVE_WINDOW_API_DISCONNECT = 14, /* private */ 244afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold NATIVE_WINDOW_SET_BUFFERS_USER_DIMENSIONS = 15, /* private */ 245fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis NATIVE_WINDOW_SET_ACTIVE_RECT = 16, /* private */ 2460ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 2470ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2488ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian/* parameter for NATIVE_WINDOW_[API_][DIS]CONNECT */ 2490ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevenum { 2505423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis /* Buffers will be queued by EGL via eglSwapBuffers after being filled using 2515423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis * OpenGL ES. 2525423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis */ 2535423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis NATIVE_WINDOW_API_EGL = 1, 2545423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis 2555423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis /* Buffers will be queued after being filled using the CPU 2565423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis */ 2575423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis NATIVE_WINDOW_API_CPU = 2, 2585423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis 2595423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis /* Buffers will be queued by Stagefright after being filled by a video 2605423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis * decoder. The video decoder can either be a software or hardware decoder. 2615423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis */ 2625423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis NATIVE_WINDOW_API_MEDIA = 3, 2635423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis 2645423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis /* Buffers will be queued by the the camera HAL. 2655423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis */ 2665423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis NATIVE_WINDOW_API_CAMERA = 4, 2670ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 2680ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2690ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* parameter for NATIVE_WINDOW_SET_BUFFERS_TRANSFORM */ 2700ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevenum { 2710ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* flip source image horizontally */ 2720ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_TRANSFORM_FLIP_H = HAL_TRANSFORM_FLIP_H , 2730ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* flip source image vertically */ 2740ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_TRANSFORM_FLIP_V = HAL_TRANSFORM_FLIP_V, 2750ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* rotate source image 90 degrees clock-wise */ 2760ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_TRANSFORM_ROT_90 = HAL_TRANSFORM_ROT_90, 2770ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* rotate source image 180 degrees */ 2780ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_TRANSFORM_ROT_180 = HAL_TRANSFORM_ROT_180, 2790ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* rotate source image 270 degrees clock-wise */ 2800ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_TRANSFORM_ROT_270 = HAL_TRANSFORM_ROT_270, 2810ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 2820ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 28342cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian/* parameter for NATIVE_WINDOW_SET_SCALING_MODE */ 28442cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopianenum { 28542cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian /* the window content is not updated (frozen) until a buffer of 28642cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * the window size is received (enqueued) 28742cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian */ 28842cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SCALING_MODE_FREEZE = 0, 28942cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian /* the buffer is scaled in both dimensions to match the window size */ 29042cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SCALING_MODE_SCALE_TO_WINDOW = 1, 29129392a4e5bedcff53a1d1f6674c73de00e0e5055Daniel Lam /* the buffer is scaled uniformly such that the smaller dimension 29229392a4e5bedcff53a1d1f6674c73de00e0e5055Daniel Lam * of the buffer matches the window size (cropping in the process) 29329392a4e5bedcff53a1d1f6674c73de00e0e5055Daniel Lam */ 29429392a4e5bedcff53a1d1f6674c73de00e0e5055Daniel Lam NATIVE_WINDOW_SCALING_MODE_SCALE_CROP = 2, 29542cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian}; 29642cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian 2970ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* values returned by the NATIVE_WINDOW_CONCRETE_TYPE query */ 2980ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevenum { 29942cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_FRAMEBUFFER = 0, /* FramebufferNativeWindow */ 30042cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SURFACE = 1, /* Surface */ 30142cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SURFACE_TEXTURE_CLIENT = 2, /* SurfaceTextureClient */ 3020ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 3030ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3040ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* parameter for NATIVE_WINDOW_SET_BUFFERS_TIMESTAMP 3050ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3060ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Special timestamp value to indicate that timestamps should be auto-generated 3070ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * by the native window when queueBuffer is called. This is equal to INT64_MIN, 3080ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * defined directly to avoid problems with C99/C++ inclusion of stdint.h. 3090ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 3100ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic const int64_t NATIVE_WINDOW_TIMESTAMP_AUTO = (-9223372036854775807LL-1); 3110ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3120ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstruct ANativeWindow 3130ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 3140ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#ifdef __cplusplus 3150ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev ANativeWindow() 3160ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev : flags(0), minSwapInterval(0), maxSwapInterval(0), xdpi(0), ydpi(0) 3170ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev { 3180ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.magic = ANDROID_NATIVE_WINDOW_MAGIC; 3190ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.version = sizeof(ANativeWindow); 3200ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev memset(common.reserved, 0, sizeof(common.reserved)); 3210ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev } 3220ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 32342cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian /* Implement the methods that sp<ANativeWindow> expects so that it 32442cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian can be used to automatically refcount ANativeWindow's. */ 3250ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void incStrong(const void* id) const { 3260ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.incRef(const_cast<android_native_base_t*>(&common)); 3270ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev } 3280ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void decStrong(const void* id) const { 3290ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.decRef(const_cast<android_native_base_t*>(&common)); 3300ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev } 3310ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#endif 3320ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3330ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct android_native_base_t common; 3340ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3350ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* flags describing some attributes of this surface or its updater */ 3360ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev const uint32_t flags; 3370ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3380ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* min swap interval supported by this updated */ 3390ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev const int minSwapInterval; 3400ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3410ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* max swap interval supported by this updated */ 3420ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev const int maxSwapInterval; 3430ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3440ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* horizontal and vertical resolution in DPI */ 3450ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev const float xdpi; 3460ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev const float ydpi; 3470ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3480ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* Some storage reserved for the OEM's driver. */ 3490ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev intptr_t oem[4]; 3500ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3510ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 3520ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Set the swap interval for this surface. 3530ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3540ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Returns 0 on success or -errno on error. 3550ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 3560ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*setSwapInterval)(struct ANativeWindow* window, 3570ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int interval); 3580ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3590ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 3607cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * Hook called by EGL to acquire a buffer. After this call, the buffer 3617cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * is not locked, so its content cannot be modified. This call may block if 3627cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * no buffers are available. 3637cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * 3647cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * The window holds a reference to the buffer between dequeueBuffer and 3657cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * either queueBuffer or cancelBuffer, so clients only need their own 3667cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * reference if they might use the buffer after queueing or canceling it. 3677cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * Holding a reference to a buffer after queueing or canceling it is only 3687cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * allowed if a specific buffer count has been set. 3690ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3700ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Returns 0 on success or -errno on error. 3710ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 3720ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*dequeueBuffer)(struct ANativeWindow* window, 3730ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindowBuffer** buffer); 3740ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3750ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 3760ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * hook called by EGL to lock a buffer. This MUST be called before modifying 3770ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * the content of a buffer. The buffer must have been acquired with 3780ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * dequeueBuffer first. 3790ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3800ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Returns 0 on success or -errno on error. 3810ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 3820ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*lockBuffer)(struct ANativeWindow* window, 3830ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindowBuffer* buffer); 3847cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall /* 3857cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * Hook called by EGL when modifications to the render buffer are done. 3867cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * This unlocks and post the buffer. 3877cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * 3887cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * The window holds a reference to the buffer between dequeueBuffer and 3897cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * either queueBuffer or cancelBuffer, so clients only need their own 3907cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * reference if they might use the buffer after queueing or canceling it. 3917cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * Holding a reference to a buffer after queueing or canceling it is only 3927cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * allowed if a specific buffer count has been set. 3937cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * 3947cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * Buffers MUST be queued in the same order than they were dequeued. 3957cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * 3967cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * Returns 0 on success or -errno on error. 3977cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall */ 3980ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*queueBuffer)(struct ANativeWindow* window, 3990ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindowBuffer* buffer); 4000ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4010ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 4020ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * hook used to retrieve information about the native window. 4030ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 4040ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Returns 0 on success or -errno on error. 4050ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 4060ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*query)(const struct ANativeWindow* window, 4070ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int what, int* value); 4080ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4090ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 4100ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * hook used to perform various operations on the surface. 4110ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * (*perform)() is a generic mechanism to add functionality to 4120ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * ANativeWindow while keeping backward binary compatibility. 4130ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 4140ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * DO NOT CALL THIS HOOK DIRECTLY. Instead, use the helper functions 4150ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * defined below. 4160ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 4170ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * (*perform)() returns -ENOENT if the 'what' parameter is not supported 4180ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * by the surface's implementation. 4190ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 4200ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * The valid operations are: 4210ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_SET_USAGE 4228ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * NATIVE_WINDOW_CONNECT (deprecated) 4238ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * NATIVE_WINDOW_DISCONNECT (deprecated) 4240ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_SET_CROP 4250ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_SET_BUFFER_COUNT 42642cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * NATIVE_WINDOW_SET_BUFFERS_GEOMETRY (deprecated) 4270ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_SET_BUFFERS_TRANSFORM 4280ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_SET_BUFFERS_TIMESTAMP 429208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * NATIVE_WINDOW_SET_BUFFERS_DIMENSIONS 430208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * NATIVE_WINDOW_SET_BUFFERS_FORMAT 43142cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * NATIVE_WINDOW_SET_SCALING_MODE 432ae3736a3d1418eb1a1e57895ce410256d7106aa3Mathias Agopian * NATIVE_WINDOW_LOCK (private) 433ae3736a3d1418eb1a1e57895ce410256d7106aa3Mathias Agopian * NATIVE_WINDOW_UNLOCK_AND_POST (private) 4348ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * NATIVE_WINDOW_API_CONNECT (private) 4358ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * NATIVE_WINDOW_API_DISCONNECT (private) 436afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * NATIVE_WINDOW_SET_BUFFERS_USER_DIMENSIONS (private) 4370ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 4380ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 4390ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4400ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*perform)(struct ANativeWindow* window, 4410ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int operation, ... ); 4420ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4430ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 4447cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * Hook used to cancel a buffer that has been dequeued. 4450ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * No synchronization is performed between dequeue() and cancel(), so 4460ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * either external synchronization is needed, or these functions must be 4470ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * called from the same thread. 4487cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * 4497cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * The window holds a reference to the buffer between dequeueBuffer and 4507cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * either queueBuffer or cancelBuffer, so clients only need their own 4517cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * reference if they might use the buffer after queueing or canceling it. 4527cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * Holding a reference to a buffer after queueing or canceling it is only 4537cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * allowed if a specific buffer count has been set. 4540ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 4550ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*cancelBuffer)(struct ANativeWindow* window, 4560ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindowBuffer* buffer); 4570ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4580ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4590ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void* reserved_proc[2]; 4600ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 4610ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4620ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* Backwards compatibility: use ANativeWindow (struct ANativeWindow in C). 4630ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * android_native_window_t is deprecated. 4640ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 4650ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef struct ANativeWindow ANativeWindow; 4660ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef struct ANativeWindow android_native_window_t; 4670ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4680ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 4690ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_usage(..., usage) 4700ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Sets the intended usage flags for the next buffers 4710ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * acquired with (*lockBuffer)() and on. 4720ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * By default (if this function is never called), a usage of 4730ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * GRALLOC_USAGE_HW_RENDER | GRALLOC_USAGE_HW_TEXTURE 4740ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * is assumed. 4750ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Calling this function will usually cause following buffers to be 4760ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * reallocated. 4770ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 4780ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4790ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_set_usage( 4800ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, int usage) 4810ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 4820ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_SET_USAGE, usage); 4830ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 4840ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4858ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian/* deprecated. Always returns 0. Don't call. */ 4860ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_connect( 4878ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian struct ANativeWindow* window, int api) { 488319f4e2793e691a7aeabad09e463ac09df562ed4Mathias Agopian return 0; 4890ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 4900ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4918ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian/* deprecated. Always returns 0. Don't call. */ 4920ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_disconnect( 4938ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian struct ANativeWindow* window, int api) { 494319f4e2793e691a7aeabad09e463ac09df562ed4Mathias Agopian return 0; 4950ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 4960ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4970ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 4980ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_crop(..., crop) 4990ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Sets which region of the next queued buffers needs to be considered. 5000ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * A buffer's crop region is scaled to match the surface's size. 5010ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 5020ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * The specified crop region applies to all buffers queued after it is called. 5030ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 5040ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * if 'crop' is NULL, subsequently queued buffers won't be cropped. 5050ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 5060ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * An error is returned if for instance the crop region is invalid, 5070ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * out of the buffer's bound or if the window is invalid. 5080ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 5090ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_set_crop( 5100ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, 5110ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev android_native_rect_t const * crop) 5120ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 5130ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_SET_CROP, crop); 5140ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 5150ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 5160ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 517fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * native_window_set_active_rect(..., active_rect) 518fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * Sets the region of future queued buffers that are 'active'. Pixels outside 519fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * this 'active' region are considered to be completely transparent regardless 520fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * of the pixel values in the buffer. The active_rect argument specifies the 521fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * active rectangle in buffer pixel coordinates. 522fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * 523fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * The specified active rectangle applies to all buffers queued after it is 524fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * called. 525fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * 526fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * An error is returned if for instance the crop region is invalid, 527fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * out of the buffer's bound or if the window is invalid. 528fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis */ 529fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennisstatic inline int native_window_set_active_rect( 530fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis struct ANativeWindow* window, 531fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis android_native_rect_t const * active_rect) 532fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis{ 533fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis return window->perform(window, NATIVE_WINDOW_SET_ACTIVE_RECT, active_rect); 534fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis} 535fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis 536fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis/* 5370ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_buffer_count(..., count) 5380ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Sets the number of buffers associated with this native window. 5390ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 5400ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_set_buffer_count( 5410ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, 5420ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev size_t bufferCount) 5430ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 5440ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_SET_BUFFER_COUNT, bufferCount); 5450ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 5460ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 5470ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 5480ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_buffers_geometry(..., int w, int h, int format) 549208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * All buffers dequeued after this call will have the dimensions and format 550208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * specified. A successful call to this function has the same effect as calling 551208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * native_window_set_buffers_size and native_window_set_buffers_format. 552208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * 553208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * XXX: This function is deprecated. The native_window_set_buffers_dimensions 554208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * and native_window_set_buffers_format functions should be used instead. 555208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis */ 556208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennisstatic inline int native_window_set_buffers_geometry( 557208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis struct ANativeWindow* window, 558208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis int w, int h, int format) 559208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis{ 560208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_GEOMETRY, 561208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis w, h, format); 562208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis} 563208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis 564208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis/* 565208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * native_window_set_buffers_dimensions(..., int w, int h) 566208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * All buffers dequeued after this call will have the dimensions specified. 567afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * In particular, all buffers will have a fixed-size, independent from the 56842cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * native-window size. They will be scaled according to the scaling mode 56942cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * (see native_window_set_scaling_mode) upon window composition. 5700ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 571208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * If w and h are 0, the normal behavior is restored. That is, dequeued buffers 572208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * following this call will be sized to match the window's size. 5730ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 5740ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Calling this function will reset the window crop to a NULL value, which 5750ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * disables cropping of the buffers. 5760ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 577208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennisstatic inline int native_window_set_buffers_dimensions( 5780ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, 579208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis int w, int h) 5800ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 581208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_DIMENSIONS, 582208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis w, h); 583208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis} 584208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis 585208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis/* 586afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * native_window_set_buffers_user_dimensions(..., int w, int h) 587afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * 588afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * Sets the user buffer size for the window, which overrides the 589afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * window's size. All buffers dequeued after this call will have the 590afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * dimensions specified unless overridden by 591afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * native_window_set_buffers_dimensions. All buffers will have a 592afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * fixed-size, independent from the native-window size. They will be 593afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * scaled according to the scaling mode (see 594afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * native_window_set_scaling_mode) upon window composition. 595afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * 596afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * If w and h are 0, the normal behavior is restored. That is, the 597afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * default buffer size will match the windows's size. 598afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * 599afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * Calling this function will reset the window crop to a NULL value, which 600afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * disables cropping of the buffers. 601afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold */ 602afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Goldstatic inline int native_window_set_buffers_user_dimensions( 603afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold struct ANativeWindow* window, 604afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold int w, int h) 605afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold{ 606afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_USER_DIMENSIONS, 607afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold w, h); 608afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold} 609afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold 610afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold/* 611208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * native_window_set_buffers_format(..., int format) 612208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * All buffers dequeued after this call will have the format specified. 613208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * 614208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * If the specified format is 0, the default buffer format will be used. 615208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis */ 616208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennisstatic inline int native_window_set_buffers_format( 617208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis struct ANativeWindow* window, 618208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis int format) 619208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis{ 620208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_FORMAT, format); 6210ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 6220ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 6230ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 6240ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_buffers_transform(..., int transform) 6250ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * All buffers queued after this call will be displayed transformed according 6260ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * to the transform parameter specified. 6270ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 6280ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_set_buffers_transform( 6290ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, 6300ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int transform) 6310ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 6320ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_TRANSFORM, 6330ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev transform); 6340ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 6350ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 6360ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 6370ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_buffers_timestamp(..., int64_t timestamp) 6380ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * All buffers queued after this call will be associated with the timestamp 6390ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * parameter specified. If the timestamp is set to NATIVE_WINDOW_TIMESTAMP_AUTO 6400ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * (the default), timestamps will be generated automatically when queueBuffer is 641c322f67140d52014c47dff41d03a601b251f56edGlenn Kasten * called. The timestamp is measured in nanoseconds, and is normally monotonically 642c322f67140d52014c47dff41d03a601b251f56edGlenn Kasten * increasing. The timestamp should be unaffected by time-of-day adjustments, 643c322f67140d52014c47dff41d03a601b251f56edGlenn Kasten * and for a camera should be strictly monotonic but for a media player may be 644c322f67140d52014c47dff41d03a601b251f56edGlenn Kasten * reset when the position is set. 6450ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 6460ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_set_buffers_timestamp( 6470ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, 6480ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int64_t timestamp) 6490ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 6500ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_TIMESTAMP, 6510ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev timestamp); 6520ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 6530ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 65442cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian/* 65542cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * native_window_set_scaling_mode(..., int mode) 65642cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * All buffers queued after this call will be associated with the scaling mode 65742cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * specified. 65842cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian */ 65942cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopianstatic inline int native_window_set_scaling_mode( 66042cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian struct ANativeWindow* window, 66142cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian int mode) 66242cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian{ 66342cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian return window->perform(window, NATIVE_WINDOW_SET_SCALING_MODE, 66442cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian mode); 66542cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian} 66642cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian 6678ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian/* 6688ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * native_window_api_connect(..., int api) 6698ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * connects an API to this window. only one API can be connected at a time. 6708ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * Returns -EINVAL if for some reason the window cannot be connected, which 6718ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * can happen if it's connected to some other API. 6728ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian */ 6738ad545297cdb180893c4f957682857953c0d3c5fMathias Agopianstatic inline int native_window_api_connect( 6748ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian struct ANativeWindow* window, int api) 6758ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian{ 676319f4e2793e691a7aeabad09e463ac09df562ed4Mathias Agopian return window->perform(window, NATIVE_WINDOW_API_CONNECT, api); 6778ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian} 6788ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian 6798ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian/* 6808ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * native_window_api_disconnect(..., int api) 6818ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * disconnect the API from this window. 6828ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * An error is returned if for instance the window wasn't connected in the 6838ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * first place. 6848ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian */ 6858ad545297cdb180893c4f957682857953c0d3c5fMathias Agopianstatic inline int native_window_api_disconnect( 6868ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian struct ANativeWindow* window, int api) 6878ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian{ 688319f4e2793e691a7aeabad09e463ac09df562ed4Mathias Agopian return window->perform(window, NATIVE_WINDOW_API_DISCONNECT, api); 6898ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian} 6908ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian 6918ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian 6920ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev__END_DECLS 6930ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 6941ffdb38213d177a83d74e1dc3bf41237dcbe8c9atedbo#endif /* SYSTEM_CORE_INCLUDE_ANDROID_WINDOW_H */ 695