window.h revision 208ec5ec564597bdf8b478a424cc9ccc09547bac
10ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 20ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Copyright (C) 2011 The Android Open Source Project 30ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 40ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Licensed under the Apache License, Version 2.0 (the "License"); 50ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * you may not use this file except in compliance with the License. 60ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * You may obtain a copy of the License at 70ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 80ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * http://www.apache.org/licenses/LICENSE-2.0 90ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 100ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Unless required by applicable law or agreed to in writing, software 110ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * distributed under the License is distributed on an "AS IS" BASIS, 120ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 130ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * See the License for the specific language governing permissions and 140ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * limitations under the License. 150ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 160ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 170ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#ifndef SYSTEM_CORE_INCLUDE_ANDROID_WINDOW_H 180ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#define SYSTEM_CORE_INCLUDE_ANDROID_WINDOW_H 190ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 200ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#include <stdint.h> 210ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#include <sys/cdefs.h> 220ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#include <system/graphics.h> 230ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#include <cutils/native_handle.h> 240ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 250ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev__BEGIN_DECLS 260ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 270ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/*****************************************************************************/ 280ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 290ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#define ANDROID_NATIVE_MAKE_CONSTANT(a,b,c,d) \ 300ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev (((unsigned)(a)<<24)|((unsigned)(b)<<16)|((unsigned)(c)<<8)|(unsigned)(d)) 310ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 320ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#define ANDROID_NATIVE_WINDOW_MAGIC \ 330ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev ANDROID_NATIVE_MAKE_CONSTANT('_','w','n','d') 340ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 350ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#define ANDROID_NATIVE_BUFFER_MAGIC \ 360ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev ANDROID_NATIVE_MAKE_CONSTANT('_','b','f','r') 370ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 380ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev// --------------------------------------------------------------------------- 390ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 400ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef const native_handle_t* buffer_handle_t; 410ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 420ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev// --------------------------------------------------------------------------- 430ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 440ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef struct android_native_rect_t 450ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 460ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int32_t left; 470ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int32_t top; 480ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int32_t right; 490ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int32_t bottom; 500ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} android_native_rect_t; 510ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 520ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev// --------------------------------------------------------------------------- 530ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 540ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef struct android_native_base_t 550ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 560ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* a magic value defined by the actual EGL native type */ 570ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int magic; 580ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 590ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* the sizeof() of the actual EGL native type */ 600ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int version; 610ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 620ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void* reserved[4]; 630ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 640ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* reference-counting interface */ 650ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void (*incRef)(struct android_native_base_t* base); 660ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void (*decRef)(struct android_native_base_t* base); 670ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} android_native_base_t; 680ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 690ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef struct ANativeWindowBuffer 700ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 710ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#ifdef __cplusplus 720ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev ANativeWindowBuffer() { 730ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.magic = ANDROID_NATIVE_BUFFER_MAGIC; 740ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.version = sizeof(ANativeWindowBuffer); 750ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev memset(common.reserved, 0, sizeof(common.reserved)); 760ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev } 770ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 780ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev // Implement the methods that sp<ANativeWindowBuffer> expects so that it 790ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev // can be used to automatically refcount ANativeWindowBuffer's. 800ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void incStrong(const void* id) const { 810ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.incRef(const_cast<android_native_base_t*>(&common)); 820ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev } 830ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void decStrong(const void* id) const { 840ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.decRef(const_cast<android_native_base_t*>(&common)); 850ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev } 860ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#endif 870ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 880ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct android_native_base_t common; 890ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 900ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int width; 910ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int height; 920ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int stride; 930ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int format; 940ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int usage; 950ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 960ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void* reserved[2]; 970ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 980ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev buffer_handle_t handle; 990ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1000ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void* reserved_proc[8]; 1010ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} ANativeWindowBuffer_t; 1020ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1030ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev// Old typedef for backwards compatibility. 1040ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef ANativeWindowBuffer_t android_native_buffer_t; 1050ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1060ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev// --------------------------------------------------------------------------- 1070ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1080ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* attributes queriable with query() */ 1090ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevenum { 1100ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_WIDTH = 0, 1110ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_HEIGHT, 1120ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_FORMAT, 1130ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1140ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* The minimum number of buffers that must remain un-dequeued after a buffer 1150ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * has been queued. This value applies only if set_buffer_count was used to 1160ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * override the number of buffers and if a buffer has since been queued. 1170ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Users of the set_buffer_count ANativeWindow method should query this 1180ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * value before calling set_buffer_count. If it is necessary to have N 1190ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * buffers simultaneously dequeued as part of the steady-state operation, 1200ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * and this query returns M then N+M buffers should be requested via 1210ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_buffer_count. 1220ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 1230ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Note that this value does NOT apply until a single buffer has been 1240ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * queued. In particular this means that it is possible to: 1250ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 1260ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 1. Query M = min undequeued buffers 1270ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 2. Set the buffer count to N + M 1280ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3. Dequeue all N + M buffers 1290ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 4. Cancel M buffers 1300ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 5. Queue, dequeue, queue, dequeue, ad infinitum 1310ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 1320ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_MIN_UNDEQUEUED_BUFFERS, 1330ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1340ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* Check whether queueBuffer operations on the ANativeWindow send the buffer 1350ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * to the window compositor. The query sets the returned 'value' argument 1360ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * to 1 if the ANativeWindow DOES send queued buffers directly to the window 1370ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * compositor and 0 if the buffers do not go directly to the window 1380ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * compositor. 1390ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 1400ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * This can be used to determine whether protected buffer content should be 1410ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * sent to the ANativeWindow. Note, however, that a result of 1 does NOT 1420ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * indicate that queued buffers will be protected from applications or users 1430ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * capturing their contents. If that behavior is desired then some other 1440ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * mechanism (e.g. the GRALLOC_USAGE_PROTECTED flag) should be used in 1450ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * conjunction with this query. 1460ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 1470ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_QUEUES_TO_WINDOW_COMPOSER, 1480ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1490ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* Get the concrete type of a ANativeWindow. See below for the list of 1500ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * possible return values. 1510ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 1520ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * This query should not be used outside the Android framework and will 1530ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * likely be removed in the near future. 1540ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 1550ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_CONCRETE_TYPE, 1560ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 1570ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1580ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* valid operations for the (*perform)() hook */ 1590ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevenum { 1600ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_SET_USAGE = 0, 1610ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_CONNECT, 1620ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_DISCONNECT, 1630ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_SET_CROP, 1640ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_SET_BUFFER_COUNT, 1650ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_SET_BUFFERS_GEOMETRY, 1660ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_SET_BUFFERS_TRANSFORM, 1670ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_SET_BUFFERS_TIMESTAMP, 168208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis NATIVE_WINDOW_SET_BUFFERS_DIMENSIONS, 169208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis NATIVE_WINDOW_SET_BUFFERS_FORMAT, 1700ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 1710ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1720ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* parameter for NATIVE_WINDOW_[DIS]CONNECT */ 1730ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevenum { 1740ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_API_EGL = 1 1750ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 1760ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1770ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* parameter for NATIVE_WINDOW_SET_BUFFERS_TRANSFORM */ 1780ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevenum { 1790ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* flip source image horizontally */ 1800ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_TRANSFORM_FLIP_H = HAL_TRANSFORM_FLIP_H , 1810ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* flip source image vertically */ 1820ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_TRANSFORM_FLIP_V = HAL_TRANSFORM_FLIP_V, 1830ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* rotate source image 90 degrees clock-wise */ 1840ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_TRANSFORM_ROT_90 = HAL_TRANSFORM_ROT_90, 1850ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* rotate source image 180 degrees */ 1860ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_TRANSFORM_ROT_180 = HAL_TRANSFORM_ROT_180, 1870ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* rotate source image 270 degrees clock-wise */ 1880ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_TRANSFORM_ROT_270 = HAL_TRANSFORM_ROT_270, 1890ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 1900ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1910ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* values returned by the NATIVE_WINDOW_CONCRETE_TYPE query */ 1920ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevenum { 1930ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_FRAMEBUFFER, // FramebufferNativeWindow 1940ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_SURFACE, // Surface 1950ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev NATIVE_WINDOW_SURFACE_TEXTURE_CLIENT, // SurfaceTextureClient 1960ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 1970ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 1980ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* parameter for NATIVE_WINDOW_SET_BUFFERS_TIMESTAMP 1990ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 2000ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Special timestamp value to indicate that timestamps should be auto-generated 2010ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * by the native window when queueBuffer is called. This is equal to INT64_MIN, 2020ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * defined directly to avoid problems with C99/C++ inclusion of stdint.h. 2030ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 2040ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic const int64_t NATIVE_WINDOW_TIMESTAMP_AUTO = (-9223372036854775807LL-1); 2050ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2060ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstruct ANativeWindow 2070ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 2080ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#ifdef __cplusplus 2090ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev ANativeWindow() 2100ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev : flags(0), minSwapInterval(0), maxSwapInterval(0), xdpi(0), ydpi(0) 2110ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev { 2120ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.magic = ANDROID_NATIVE_WINDOW_MAGIC; 2130ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.version = sizeof(ANativeWindow); 2140ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev memset(common.reserved, 0, sizeof(common.reserved)); 2150ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev } 2160ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2170ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev // Implement the methods that sp<ANativeWindow> expects so that it 2180ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev // can be used to automatically refcount ANativeWindow's. 2190ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void incStrong(const void* id) const { 2200ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.incRef(const_cast<android_native_base_t*>(&common)); 2210ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev } 2220ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void decStrong(const void* id) const { 2230ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev common.decRef(const_cast<android_native_base_t*>(&common)); 2240ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev } 2250ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev#endif 2260ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2270ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct android_native_base_t common; 2280ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2290ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* flags describing some attributes of this surface or its updater */ 2300ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev const uint32_t flags; 2310ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2320ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* min swap interval supported by this updated */ 2330ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev const int minSwapInterval; 2340ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2350ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* max swap interval supported by this updated */ 2360ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev const int maxSwapInterval; 2370ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2380ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* horizontal and vertical resolution in DPI */ 2390ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev const float xdpi; 2400ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev const float ydpi; 2410ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2420ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* Some storage reserved for the OEM's driver. */ 2430ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev intptr_t oem[4]; 2440ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2450ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 2460ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Set the swap interval for this surface. 2470ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 2480ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Returns 0 on success or -errno on error. 2490ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 2500ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*setSwapInterval)(struct ANativeWindow* window, 2510ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int interval); 2520ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2530ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 2540ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * hook called by EGL to acquire a buffer. After this call, the buffer 2550ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * is not locked, so its content cannot be modified. 2560ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * this call may block if no buffers are available. 2570ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 2580ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Returns 0 on success or -errno on error. 2590ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 2600ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*dequeueBuffer)(struct ANativeWindow* window, 2610ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindowBuffer** buffer); 2620ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2630ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 2640ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * hook called by EGL to lock a buffer. This MUST be called before modifying 2650ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * the content of a buffer. The buffer must have been acquired with 2660ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * dequeueBuffer first. 2670ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 2680ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Returns 0 on success or -errno on error. 2690ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 2700ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*lockBuffer)(struct ANativeWindow* window, 2710ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindowBuffer* buffer); 2720ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 2730ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * hook called by EGL when modifications to the render buffer are done. 2740ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * This unlocks and post the buffer. 2750ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 2760ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Buffers MUST be queued in the same order than they were dequeued. 2770ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 2780ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Returns 0 on success or -errno on error. 2790ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 2800ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*queueBuffer)(struct ANativeWindow* window, 2810ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindowBuffer* buffer); 2820ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2830ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 2840ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * hook used to retrieve information about the native window. 2850ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 2860ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Returns 0 on success or -errno on error. 2870ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 2880ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*query)(const struct ANativeWindow* window, 2890ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int what, int* value); 2900ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 2910ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 2920ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * hook used to perform various operations on the surface. 2930ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * (*perform)() is a generic mechanism to add functionality to 2940ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * ANativeWindow while keeping backward binary compatibility. 2950ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 2960ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * DO NOT CALL THIS HOOK DIRECTLY. Instead, use the helper functions 2970ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * defined below. 2980ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 2990ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * (*perform)() returns -ENOENT if the 'what' parameter is not supported 3000ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * by the surface's implementation. 3010ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3020ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * The valid operations are: 3030ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_SET_USAGE 3040ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_CONNECT 3050ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_DISCONNECT 3060ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_SET_CROP 3070ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_SET_BUFFER_COUNT 3080ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_SET_BUFFERS_GEOMETRY 3090ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_SET_BUFFERS_TRANSFORM 3100ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * NATIVE_WINDOW_SET_BUFFERS_TIMESTAMP 311208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * NATIVE_WINDOW_SET_BUFFERS_DIMENSIONS 312208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * NATIVE_WINDOW_SET_BUFFERS_FORMAT 3130ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3140ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 3150ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3160ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*perform)(struct ANativeWindow* window, 3170ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int operation, ... ); 3180ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3190ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* 3200ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * hook used to cancel a buffer that has been dequeued. 3210ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * No synchronization is performed between dequeue() and cancel(), so 3220ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * either external synchronization is needed, or these functions must be 3230ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * called from the same thread. 3240ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 3250ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int (*cancelBuffer)(struct ANativeWindow* window, 3260ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindowBuffer* buffer); 3270ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3280ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3290ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev void* reserved_proc[2]; 3300ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev}; 3310ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3320ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev /* Backwards compatibility: use ANativeWindow (struct ANativeWindow in C). 3330ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * android_native_window_t is deprecated. 3340ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 3350ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef struct ANativeWindow ANativeWindow; 3360ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevtypedef struct ANativeWindow android_native_window_t; 3370ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3380ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 3390ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_usage(..., usage) 3400ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Sets the intended usage flags for the next buffers 3410ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * acquired with (*lockBuffer)() and on. 3420ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * By default (if this function is never called), a usage of 3430ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * GRALLOC_USAGE_HW_RENDER | GRALLOC_USAGE_HW_TEXTURE 3440ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * is assumed. 3450ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Calling this function will usually cause following buffers to be 3460ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * reallocated. 3470ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 3480ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3490ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_set_usage( 3500ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, int usage) 3510ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 3520ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_SET_USAGE, usage); 3530ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 3540ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3550ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 3560ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_connect(..., NATIVE_WINDOW_API_EGL) 3570ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Must be called by EGL when the window is made current. 3580ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Returns -EINVAL if for some reason the window cannot be connected, which 3590ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * can happen if it's connected to some other API. 3600ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 3610ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_connect( 3620ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, int api) 3630ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 3640ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_CONNECT, api); 3650ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 3660ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3670ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 3680ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_disconnect(..., NATIVE_WINDOW_API_EGL) 3690ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Must be called by EGL when the window is made not current. 3700ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * An error is returned if for instance the window wasn't connected in the 3710ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * first place. 3720ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 3730ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_disconnect( 3740ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, int api) 3750ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 3760ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_DISCONNECT, api); 3770ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 3780ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3790ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 3800ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_crop(..., crop) 3810ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Sets which region of the next queued buffers needs to be considered. 3820ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * A buffer's crop region is scaled to match the surface's size. 3830ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3840ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * The specified crop region applies to all buffers queued after it is called. 3850ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3860ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * if 'crop' is NULL, subsequently queued buffers won't be cropped. 3870ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 3880ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * An error is returned if for instance the crop region is invalid, 3890ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * out of the buffer's bound or if the window is invalid. 3900ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 3910ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_set_crop( 3920ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, 3930ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev android_native_rect_t const * crop) 3940ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 3950ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_SET_CROP, crop); 3960ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 3970ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 3980ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 3990ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_buffer_count(..., count) 4000ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Sets the number of buffers associated with this native window. 4010ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 4020ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_set_buffer_count( 4030ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, 4040ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev size_t bufferCount) 4050ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 4060ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_SET_BUFFER_COUNT, bufferCount); 4070ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 4080ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4090ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 4100ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_buffers_geometry(..., int w, int h, int format) 411208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * All buffers dequeued after this call will have the dimensions and format 412208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * specified. A successful call to this function has the same effect as calling 413208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * native_window_set_buffers_size and native_window_set_buffers_format. 414208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * 415208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * XXX: This function is deprecated. The native_window_set_buffers_dimensions 416208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * and native_window_set_buffers_format functions should be used instead. 417208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis */ 418208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennisstatic inline int native_window_set_buffers_geometry( 419208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis struct ANativeWindow* window, 420208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis int w, int h, int format) 421208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis{ 422208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_GEOMETRY, 423208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis w, h, format); 424208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis} 425208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis 426208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis/* 427208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * native_window_set_buffers_dimensions(..., int w, int h) 428208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * All buffers dequeued after this call will have the dimensions specified. 4290ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * In particular, all buffers will have a fixed-size, independent form the 4300ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native-window size. They will be appropriately scaled to the window-size 431208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * upon window composition. 4320ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 433208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * If w and h are 0, the normal behavior is restored. That is, dequeued buffers 434208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * following this call will be sized to match the window's size. 4350ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * 4360ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * Calling this function will reset the window crop to a NULL value, which 4370ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * disables cropping of the buffers. 4380ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 439208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennisstatic inline int native_window_set_buffers_dimensions( 4400ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, 441208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis int w, int h) 4420ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 443208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_DIMENSIONS, 444208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis w, h); 445208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis} 446208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis 447208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis/* 448208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * native_window_set_buffers_format(..., int format) 449208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * All buffers dequeued after this call will have the format specified. 450208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * 451208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis * If the specified format is 0, the default buffer format will be used. 452208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis */ 453208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennisstatic inline int native_window_set_buffers_format( 454208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis struct ANativeWindow* window, 455208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis int format) 456208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis{ 457208ec5ec564597bdf8b478a424cc9ccc09547bacJamie Gennis return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_FORMAT, format); 4580ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 4590ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4600ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 4610ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_buffers_transform(..., int transform) 4620ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * All buffers queued after this call will be displayed transformed according 4630ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * to the transform parameter specified. 4640ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 4650ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_set_buffers_transform( 4660ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, 4670ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int transform) 4680ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 4690ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_TRANSFORM, 4700ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev transform); 4710ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 4720ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4730ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev/* 4740ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * native_window_set_buffers_timestamp(..., int64_t timestamp) 4750ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * All buffers queued after this call will be associated with the timestamp 4760ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * parameter specified. If the timestamp is set to NATIVE_WINDOW_TIMESTAMP_AUTO 4770ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev * (the default), timestamps will be generated automatically when queueBuffer is 478c322f67140d52014c47dff41d03a601b251f56edGlenn Kasten * called. The timestamp is measured in nanoseconds, and is normally monotonically 479c322f67140d52014c47dff41d03a601b251f56edGlenn Kasten * increasing. The timestamp should be unaffected by time-of-day adjustments, 480c322f67140d52014c47dff41d03a601b251f56edGlenn Kasten * and for a camera should be strictly monotonic but for a media player may be 481c322f67140d52014c47dff41d03a601b251f56edGlenn Kasten * reset when the position is set. 4820ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev */ 4830ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchevstatic inline int native_window_set_buffers_timestamp( 4840ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev struct ANativeWindow* window, 4850ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev int64_t timestamp) 4860ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev{ 4870ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev return window->perform(window, NATIVE_WINDOW_SET_BUFFERS_TIMESTAMP, 4880ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev timestamp); 4890ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev} 4900ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4910ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev__END_DECLS 4920ab886bdabd167b32aad90ce5d4e00ce8392858cIliyan Malchev 4931ffdb38213d177a83d74e1dc3bf41237dcbe8c9atedbo#endif /* SYSTEM_CORE_INCLUDE_ANDROID_WINDOW_H */ 494