window.h revision 190b6e2698dc47ddb4888b9c51abb23f69fcf064
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 163aa3f4c3591d83728adec17bf0004f8dd5e46a3bbJamie Gennis * size unless overridden 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, 216aa3f4c3591d83728adec17bf0004f8dd5e46a3bbJamie Gennis 217aa3f4c3591d83728adec17bf0004f8dd5e46a3bbJamie Gennis /* 218aa3f4c3591d83728adec17bf0004f8dd5e46a3bbJamie Gennis * Boolean that indicates whether the consumer is running more than 219aa3f4c3591d83728adec17bf0004f8dd5e46a3bbJamie Gennis * one buffer behind the producer. 220aa3f4c3591d83728adec17bf0004f8dd5e46a3bbJamie Gennis */ 221aa3f4c3591d83728adec17bf0004f8dd5e46a3bbJamie Gennis NATIVE_WINDOW_CONSUMER_RUNNING_BEHIND = 9 2220ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 2230ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 224fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis/* Valid operations for the (*perform)() hook. 225fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * 226fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * Values marked as 'deprecated' are supported, but have been superceded by 227fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * other functionality. 228fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * 229fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * Values marked as 'private' should be considered private to the framework. 230fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * HAL implementation code with access to an ANativeWindow should not use these, 231fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * as it may not interact properly with the framework's use of the 232fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * ANativeWindow. 233fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis */ 2340ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevenum { 23542cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_USAGE = 0, 2368ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian NATIVE_WINDOW_CONNECT = 1, /* deprecated */ 2378ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian NATIVE_WINDOW_DISCONNECT = 2, /* deprecated */ 238fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis NATIVE_WINDOW_SET_CROP = 3, /* private */ 23942cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_BUFFER_COUNT = 4, 24042cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_BUFFERS_GEOMETRY = 5, /* deprecated */ 24142cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_BUFFERS_TRANSFORM = 6, 24242cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_BUFFERS_TIMESTAMP = 7, 24342cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_BUFFERS_DIMENSIONS = 8, 24442cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SET_BUFFERS_FORMAT = 9, 245fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis NATIVE_WINDOW_SET_SCALING_MODE = 10, /* private */ 246ae3736a3d1418eb1a1e57895ce410256d7106aa3Mathias Agopian NATIVE_WINDOW_LOCK = 11, /* private */ 247ae3736a3d1418eb1a1e57895ce410256d7106aa3Mathias Agopian NATIVE_WINDOW_UNLOCK_AND_POST = 12, /* private */ 2488ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian NATIVE_WINDOW_API_CONNECT = 13, /* private */ 2498ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian NATIVE_WINDOW_API_DISCONNECT = 14, /* private */ 250afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold NATIVE_WINDOW_SET_BUFFERS_USER_DIMENSIONS = 15, /* private */ 251fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis NATIVE_WINDOW_SET_ACTIVE_RECT = 16, /* private */ 2520ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 2530ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2548ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian/* parameter for NATIVE_WINDOW_[API_][DIS]CONNECT */ 2550ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevenum { 2565423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis /* Buffers will be queued by EGL via eglSwapBuffers after being filled using 2575423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis * OpenGL ES. 2585423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis */ 2595423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis NATIVE_WINDOW_API_EGL = 1, 2605423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis 2615423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis /* Buffers will be queued after being filled using the CPU 2625423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis */ 2635423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis NATIVE_WINDOW_API_CPU = 2, 2645423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis 2655423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis /* Buffers will be queued by Stagefright after being filled by a video 2665423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis * decoder. The video decoder can either be a software or hardware decoder. 2675423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis */ 2685423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis NATIVE_WINDOW_API_MEDIA = 3, 2695423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis 2705423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis /* Buffers will be queued by the the camera HAL. 2715423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis */ 2725423e9e4ce52a45ac42419f1467e79ba9e62298fJamie Gennis NATIVE_WINDOW_API_CAMERA = 4, 2730ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 2740ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2750ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* parameter for NATIVE_WINDOW_SET_BUFFERS_TRANSFORM */ 2760ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevenum { 2770ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* flip source image horizontally */ 2780ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_TRANSFORM_FLIP_H = HAL_TRANSFORM_FLIP_H , 2790ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* flip source image vertically */ 2800ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_TRANSFORM_FLIP_V = HAL_TRANSFORM_FLIP_V, 2810ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* rotate source image 90 degrees clock-wise */ 2820ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_TRANSFORM_ROT_90 = HAL_TRANSFORM_ROT_90, 2830ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* rotate source image 180 degrees */ 2840ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_TRANSFORM_ROT_180 = HAL_TRANSFORM_ROT_180, 2850ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* rotate source image 270 degrees clock-wise */ 2860ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_TRANSFORM_ROT_270 = HAL_TRANSFORM_ROT_270, 2870ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 2880ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 28942cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian/* parameter for NATIVE_WINDOW_SET_SCALING_MODE */ 29042cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopianenum { 29142cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian /* the window content is not updated (frozen) until a buffer of 29242cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * the window size is received (enqueued) 29342cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian */ 29442cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SCALING_MODE_FREEZE = 0, 29542cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian /* the buffer is scaled in both dimensions to match the window size */ 29642cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SCALING_MODE_SCALE_TO_WINDOW = 1, 29729392a4e5bedcff53a1d1f6674c73de00e0e5055Daniel Lam /* the buffer is scaled uniformly such that the smaller dimension 29829392a4e5bedcff53a1d1f6674c73de00e0e5055Daniel Lam * of the buffer matches the window size (cropping in the process) 29929392a4e5bedcff53a1d1f6674c73de00e0e5055Daniel Lam */ 30029392a4e5bedcff53a1d1f6674c73de00e0e5055Daniel Lam NATIVE_WINDOW_SCALING_MODE_SCALE_CROP = 2, 30142cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian}; 30242cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian 3030ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* values returned by the NATIVE_WINDOW_CONCRETE_TYPE query */ 3040ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevenum { 30542cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_FRAMEBUFFER = 0, /* FramebufferNativeWindow */ 30642cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SURFACE = 1, /* Surface */ 30742cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian NATIVE_WINDOW_SURFACE_TEXTURE_CLIENT = 2, /* SurfaceTextureClient */ 3080ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 3090ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3100ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* parameter for NATIVE_WINDOW_SET_BUFFERS_TIMESTAMP 3110ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3120ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Special timestamp value to indicate that timestamps should be auto-generated 3130ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * by the native window when queueBuffer is called. This is equal to INT64_MIN, 3140ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * defined directly to avoid problems with C99/C++ inclusion of stdint.h. 3150ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 3160ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic const int64_t NATIVE_WINDOW_TIMESTAMP_AUTO = (-9223372036854775807LL-1); 3170ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3180ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstruct ANativeWindow 3190ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 3200ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#ifdef __cplusplus 3210ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev ANativeWindow() 3220ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev : flags(0), minSwapInterval(0), maxSwapInterval(0), xdpi(0), ydpi(0) 3230ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev { 3240ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.magic = ANDROID_NATIVE_WINDOW_MAGIC; 3250ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.version = sizeof(ANativeWindow); 3260ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev memset(common.reserved, 0, sizeof(common.reserved)); 3270ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev } 3280ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 32942cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian /* Implement the methods that sp<ANativeWindow> expects so that it 33042cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian can be used to automatically refcount ANativeWindow's. */ 3310ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void incStrong(const void* id) const { 3320ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.incRef(const_cast<android_native_base_t*>(&common)); 3330ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev } 3340ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void decStrong(const void* id) const { 3350ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.decRef(const_cast<android_native_base_t*>(&common)); 3360ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev } 3370ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#endif 3380ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3390ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct android_native_base_t common; 3400ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3410ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* flags describing some attributes of this surface or its updater */ 3420ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev const uint32_t flags; 3430ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3440ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* min swap interval supported by this updated */ 3450ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev const int minSwapInterval; 3460ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3470ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* max swap interval supported by this updated */ 3480ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev const int maxSwapInterval; 3490ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3500ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* horizontal and vertical resolution in DPI */ 3510ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev const float xdpi; 3520ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev const float ydpi; 3530ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3540ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* Some storage reserved for the OEM's driver. */ 3550ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev intptr_t oem[4]; 3560ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3570ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 3580ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Set the swap interval for this surface. 3590ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3600ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Returns 0 on success or -errno on error. 3610ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 3620ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*setSwapInterval)(struct ANativeWindow* window, 3630ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int interval); 3640ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3650ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 3667cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * Hook called by EGL to acquire a buffer. After this call, the buffer 3677cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * is not locked, so its content cannot be modified. This call may block if 3687cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * no buffers are available. 3697cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * 3707cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * The window holds a reference to the buffer between dequeueBuffer and 3717cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * either queueBuffer or cancelBuffer, so clients only need their own 3727cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * reference if they might use the buffer after queueing or canceling it. 3737cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * Holding a reference to a buffer after queueing or canceling it is only 3747cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * allowed if a specific buffer count has been set. 3750ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3760ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Returns 0 on success or -errno on error. 3770ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 3780ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*dequeueBuffer)(struct ANativeWindow* window, 3790ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindowBuffer** buffer); 3800ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3810ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 3820ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * hook called by EGL to lock a buffer. This MUST be called before modifying 3830ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * the content of a buffer. The buffer must have been acquired with 3840ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * dequeueBuffer first. 3850ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3860ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Returns 0 on success or -errno on error. 3870ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 3880ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*lockBuffer)(struct ANativeWindow* window, 3890ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindowBuffer* buffer); 3907cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall /* 3917cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * Hook called by EGL when modifications to the render buffer are done. 3927cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * This unlocks and post the buffer. 3937cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * 3947cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * The window holds a reference to the buffer between dequeueBuffer and 3957cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * either queueBuffer or cancelBuffer, so clients only need their own 3967cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * reference if they might use the buffer after queueing or canceling it. 3977cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * Holding a reference to a buffer after queueing or canceling it is only 3987cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * allowed if a specific buffer count has been set. 3997cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * 4007cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * Buffers MUST be queued in the same order than they were dequeued. 4017cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * 4027cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * Returns 0 on success or -errno on error. 4037cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall */ 4040ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*queueBuffer)(struct ANativeWindow* window, 4050ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindowBuffer* buffer); 4060ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4070ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 4080ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * hook used to retrieve information about the native window. 4090ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 4100ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Returns 0 on success or -errno on error. 4110ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 4120ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*query)(const struct ANativeWindow* window, 4130ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int what, int* value); 4140ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4150ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 4160ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * hook used to perform various operations on the surface. 4170ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * (*perform)() is a generic mechanism to add functionality to 4180ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * ANativeWindow while keeping backward binary compatibility. 4190ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 4200ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * DO NOT CALL THIS HOOK DIRECTLY. Instead, use the helper functions 4210ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * defined below. 4220ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 4230ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * (*perform)() returns -ENOENT if the 'what' parameter is not supported 4240ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * by the surface's implementation. 4250ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 4260ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * The valid operations are: 4270ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_SET_USAGE 4288ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * NATIVE_WINDOW_CONNECT (deprecated) 4298ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * NATIVE_WINDOW_DISCONNECT (deprecated) 430190b6e2698dc47ddb4888b9c51abb23f69fcf064Jamie Gennis * NATIVE_WINDOW_SET_CROP (private) 4310ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_SET_BUFFER_COUNT 43242cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * NATIVE_WINDOW_SET_BUFFERS_GEOMETRY (deprecated) 4330ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_SET_BUFFERS_TRANSFORM 4340ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_SET_BUFFERS_TIMESTAMP 435208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * NATIVE_WINDOW_SET_BUFFERS_DIMENSIONS 436208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * NATIVE_WINDOW_SET_BUFFERS_FORMAT 437190b6e2698dc47ddb4888b9c51abb23f69fcf064Jamie Gennis * NATIVE_WINDOW_SET_SCALING_MODE (private) 438ae3736a3d1418eb1a1e57895ce410256d7106aa3Mathias Agopian * NATIVE_WINDOW_LOCK (private) 439ae3736a3d1418eb1a1e57895ce410256d7106aa3Mathias Agopian * NATIVE_WINDOW_UNLOCK_AND_POST (private) 4408ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * NATIVE_WINDOW_API_CONNECT (private) 4418ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * NATIVE_WINDOW_API_DISCONNECT (private) 442afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * NATIVE_WINDOW_SET_BUFFERS_USER_DIMENSIONS (private) 443190b6e2698dc47ddb4888b9c51abb23f69fcf064Jamie Gennis * NATIVE_WINDOW_SET_ACTIVE_RECT (private) 4440ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 4450ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 4460ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4470ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*perform)(struct ANativeWindow* window, 4480ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int operation, ... ); 4490ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4500ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 4517cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * Hook used to cancel a buffer that has been dequeued. 4520ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * No synchronization is performed between dequeue() and cancel(), so 4530ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * either external synchronization is needed, or these functions must be 4540ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * called from the same thread. 4557cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * 4567cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * The window holds a reference to the buffer between dequeueBuffer and 4577cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * either queueBuffer or cancelBuffer, so clients only need their own 4587cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * reference if they might use the buffer after queueing or canceling it. 4597cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * Holding a reference to a buffer after queueing or canceling it is only 4607cd3e0a3a2f9b104cd6c04f699ae62c4577787e2Jesse Hall * allowed if a specific buffer count has been set. 4610ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 4620ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*cancelBuffer)(struct ANativeWindow* window, 4630ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindowBuffer* buffer); 4640ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4650ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4660ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void* reserved_proc[2]; 4670ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 4680ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4690ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* Backwards compatibility: use ANativeWindow (struct ANativeWindow in C). 4700ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * android_native_window_t is deprecated. 4710ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 4720ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef struct ANativeWindow ANativeWindow; 4730ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef struct ANativeWindow android_native_window_t; 4740ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4750ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 4760ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_usage(..., usage) 4770ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Sets the intended usage flags for the next buffers 4780ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * acquired with (*lockBuffer)() and on. 4790ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * By default (if this function is never called), a usage of 4800ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * GRALLOC_USAGE_HW_RENDER | GRALLOC_USAGE_HW_TEXTURE 4810ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * is assumed. 4820ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Calling this function will usually cause following buffers to be 4830ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * reallocated. 4840ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 4850ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4860ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_set_usage( 4870ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, int usage) 4880ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 4890ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_SET_USAGE, usage); 4900ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 4910ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4928ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian/* deprecated. Always returns 0. Don't call. */ 4930ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_connect( 4948ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian struct ANativeWindow* window, int api) { 495319f4e2793e691a7aeabad09e463ac09df562ed4Mathias Agopian return 0; 4960ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 4970ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4988ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian/* deprecated. Always returns 0. Don't call. */ 4990ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_disconnect( 5008ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian struct ANativeWindow* window, int api) { 501319f4e2793e691a7aeabad09e463ac09df562ed4Mathias Agopian return 0; 5020ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 5030ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 5040ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 5050ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_crop(..., crop) 5060ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Sets which region of the next queued buffers needs to be considered. 5070ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * A buffer's crop region is scaled to match the surface's size. 5080ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 5090ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * The specified crop region applies to all buffers queued after it is called. 5100ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 5110ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * if 'crop' is NULL, subsequently queued buffers won't be cropped. 5120ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 5130ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * An error is returned if for instance the crop region is invalid, 5140ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * out of the buffer's bound or if the window is invalid. 5150ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 5160ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_set_crop( 5170ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, 5180ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev android_native_rect_t const * crop) 5190ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 5200ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_SET_CROP, crop); 5210ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 5220ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 5230ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 524fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * native_window_set_active_rect(..., active_rect) 525fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * Sets the region of future queued buffers that are 'active'. Pixels outside 526fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * this 'active' region are considered to be completely transparent regardless 527fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * of the pixel values in the buffer. The active_rect argument specifies the 528fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * active rectangle in buffer pixel coordinates. 529fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * 530fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * The specified active rectangle applies to all buffers queued after it is 531fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * called. 532fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * 533fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * An error is returned if for instance the crop region is invalid, 534fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis * out of the buffer's bound or if the window is invalid. 535fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis */ 536fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennisstatic inline int native_window_set_active_rect( 537fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis struct ANativeWindow* window, 538fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis android_native_rect_t const * active_rect) 539fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis{ 540fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis return window->perform(window, NATIVE_WINDOW_SET_ACTIVE_RECT, active_rect); 541fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis} 542fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis 543fb1ee571446c13ad698e91f13fd4e0274a37d4d7Jamie Gennis/* 5440ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_buffer_count(..., count) 5450ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Sets the number of buffers associated with this native window. 5460ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 5470ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_set_buffer_count( 5480ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, 5490ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev size_t bufferCount) 5500ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 5510ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_SET_BUFFER_COUNT, bufferCount); 5520ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 5530ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 5540ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 5550ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_buffers_geometry(..., int w, int h, int format) 556208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * All buffers dequeued after this call will have the dimensions and format 557208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * specified. A successful call to this function has the same effect as calling 558208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * native_window_set_buffers_size and native_window_set_buffers_format. 559208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * 560208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * XXX: This function is deprecated. The native_window_set_buffers_dimensions 561208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * and native_window_set_buffers_format functions should be used instead. 562208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis */ 563208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennisstatic inline int native_window_set_buffers_geometry( 564208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis struct ANativeWindow* window, 565208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis int w, int h, int format) 566208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis{ 567208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_GEOMETRY, 568208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis w, h, format); 569208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis} 570208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis 571208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis/* 572208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * native_window_set_buffers_dimensions(..., int w, int h) 573208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * All buffers dequeued after this call will have the dimensions specified. 574afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * In particular, all buffers will have a fixed-size, independent from the 57542cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * native-window size. They will be scaled according to the scaling mode 57642cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * (see native_window_set_scaling_mode) upon window composition. 5770ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 578208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * If w and h are 0, the normal behavior is restored. That is, dequeued buffers 579208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * following this call will be sized to match the window's size. 5800ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 5810ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Calling this function will reset the window crop to a NULL value, which 5820ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * disables cropping of the buffers. 5830ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 584208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennisstatic inline int native_window_set_buffers_dimensions( 5850ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, 586208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis int w, int h) 5870ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 588208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_DIMENSIONS, 589208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis w, h); 590208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis} 591208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis 592208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis/* 593afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * native_window_set_buffers_user_dimensions(..., int w, int h) 594afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * 595afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * Sets the user buffer size for the window, which overrides the 596afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * window's size. All buffers dequeued after this call will have the 597afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * dimensions specified unless overridden by 598afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * native_window_set_buffers_dimensions. All buffers will have a 599afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * fixed-size, independent from the native-window size. They will be 600afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * scaled according to the scaling mode (see 601afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * native_window_set_scaling_mode) upon window composition. 602afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * 603afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * If w and h are 0, the normal behavior is restored. That is, the 604afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * default buffer size will match the windows's size. 605afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * 606afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * Calling this function will reset the window crop to a NULL value, which 607afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold * disables cropping of the buffers. 608afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold */ 609afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Goldstatic inline int native_window_set_buffers_user_dimensions( 610afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold struct ANativeWindow* window, 611afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold int w, int h) 612afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold{ 613afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_USER_DIMENSIONS, 614afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold w, h); 615afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold} 616afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold 617afcdef635718985aae26e5f94c21ae4f3248a0b9Michael I. Gold/* 618208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * native_window_set_buffers_format(..., int format) 619208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * All buffers dequeued after this call will have the format specified. 620208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * 621208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * If the specified format is 0, the default buffer format will be used. 622208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis */ 623208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennisstatic inline int native_window_set_buffers_format( 624208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis struct ANativeWindow* window, 625208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis int format) 626208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis{ 627208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_FORMAT, format); 6280ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 6290ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 6300ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 6310ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_buffers_transform(..., int transform) 6320ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * All buffers queued after this call will be displayed transformed according 6330ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * to the transform parameter specified. 6340ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 6350ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_set_buffers_transform( 6360ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, 6370ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int transform) 6380ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 6390ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_TRANSFORM, 6400ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev transform); 6410ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 6420ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 6430ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 6440ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_buffers_timestamp(..., int64_t timestamp) 6450ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * All buffers queued after this call will be associated with the timestamp 6460ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * parameter specified. If the timestamp is set to NATIVE_WINDOW_TIMESTAMP_AUTO 6470ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * (the default), timestamps will be generated automatically when queueBuffer is 648c322f67140d52014c47dff41d03a601b251f56edGlenn Kasten * called. The timestamp is measured in nanoseconds, and is normally monotonically 649c322f67140d52014c47dff41d03a601b251f56edGlenn Kasten * increasing. The timestamp should be unaffected by time-of-day adjustments, 650c322f67140d52014c47dff41d03a601b251f56edGlenn Kasten * and for a camera should be strictly monotonic but for a media player may be 651c322f67140d52014c47dff41d03a601b251f56edGlenn Kasten * reset when the position is set. 6520ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 6530ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_set_buffers_timestamp( 6540ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, 6550ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int64_t timestamp) 6560ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 6570ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_TIMESTAMP, 6580ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev timestamp); 6590ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 6600ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 66142cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian/* 66242cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * native_window_set_scaling_mode(..., int mode) 66342cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * All buffers queued after this call will be associated with the scaling mode 66442cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian * specified. 66542cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian */ 66642cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopianstatic inline int native_window_set_scaling_mode( 66742cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian struct ANativeWindow* window, 66842cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian int mode) 66942cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian{ 67042cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian return window->perform(window, NATIVE_WINDOW_SET_SCALING_MODE, 67142cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian mode); 67242cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian} 67342cc1edfe7edf613e17bff97f30ff124ada05136Mathias Agopian 6748ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian/* 6758ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * native_window_api_connect(..., int api) 6768ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * connects an API to this window. only one API can be connected at a time. 6778ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * Returns -EINVAL if for some reason the window cannot be connected, which 6788ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * can happen if it's connected to some other API. 6798ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian */ 6808ad545297cdb180893c4f957682857953c0d3c5fMathias Agopianstatic inline int native_window_api_connect( 6818ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian struct ANativeWindow* window, int api) 6828ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian{ 683319f4e2793e691a7aeabad09e463ac09df562ed4Mathias Agopian return window->perform(window, NATIVE_WINDOW_API_CONNECT, api); 6848ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian} 6858ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian 6868ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian/* 6878ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * native_window_api_disconnect(..., int api) 6888ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * disconnect the API from this window. 6898ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * An error is returned if for instance the window wasn't connected in the 6908ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian * first place. 6918ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian */ 6928ad545297cdb180893c4f957682857953c0d3c5fMathias Agopianstatic inline int native_window_api_disconnect( 6938ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian struct ANativeWindow* window, int api) 6948ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian{ 695319f4e2793e691a7aeabad09e463ac09df562ed4Mathias Agopian return window->perform(window, NATIVE_WINDOW_API_DISCONNECT, api); 6968ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian} 6978ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian 6988ad545297cdb180893c4f957682857953c0d3c5fMathias Agopian 6990ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev__END_DECLS 7000ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 7011ffdb38213d177a83d74e1dc3bf41237dcbe8c9atedbo#endif /* SYSTEM_CORE_INCLUDE_ANDROID_WINDOW_H */ 702