1// Copyright 2014-2021 The Khronos Group, Inc. 2// 3// SPDX-License-Identifier: CC-BY-4.0 4 5include::{generated}/meta/{refprefix}VK_KHR_android_surface.txt[] 6 7=== Other Extension Metadata 8 9*Last Modified Date*:: 10 2016-01-14 11*IP Status*:: 12 No known IP claims. 13*Contributors*:: 14 - Patrick Doane, Blizzard 15 - Jason Ekstrand, Intel 16 - Ian Elliott, LunarG 17 - Courtney Goeltzenleuchter, LunarG 18 - Jesse Hall, Google 19 - James Jones, NVIDIA 20 - Antoine Labour, Google 21 - Jon Leech, Khronos 22 - David Mao, AMD 23 - Norbert Nopper, Freescale 24 - Alon Or-bach, Samsung 25 - Daniel Rakos, AMD 26 - Graham Sellers, AMD 27 - Ray Smith, ARM 28 - Jeff Vigil, Qualcomm 29 - Chia-I Wu, LunarG 30 31=== Description 32 33The `VK_KHR_android_surface` extension is an instance extension. 34It provides a mechanism to create a slink:VkSurfaceKHR object (defined by 35the `apiext:VK_KHR_surface` extension) that refers to an 36basetype:ANativeWindow, Android's native surface type. 37The basetype:ANativeWindow represents the producer endpoint of any buffer 38queue, regardless of consumer endpoint. 39Common consumer endpoints for code:ANativeWindows are the system window 40compositor, video encoders, and application-specific compositors importing 41the images through a code:SurfaceTexture. 42 43include::{generated}/interfaces/VK_KHR_android_surface.txt[] 44 45=== Issues 46 471) Does Android need a way to query for compatibility between a particular 48physical device (and queue family?) and a specific Android display? 49 50*RESOLVED*: No. 51Currently on Android, any physical device is expected to be able to present 52to the system compositor, and all queue families must support the necessary 53image layout transitions and synchronization operations. 54 55=== Version History 56 57 * Revision 1, 2015-09-23 (Jesse Hall) 58 - Initial draft. 59 60 * Revision 2, 2015-10-26 (Ian Elliott) 61 - Renamed from VK_EXT_KHR_android_surface to VK_KHR_android_surface. 62 63 * Revision 3, 2015-11-03 (Daniel Rakos) 64 - Added allocation callbacks to surface creation function. 65 66 * Revision 4, 2015-11-10 (Jesse Hall) 67 - Removed VK_ERROR_INVALID_ANDROID_WINDOW_KHR. 68 69 * Revision 5, 2015-11-28 (Daniel Rakos) 70 - Updated the surface create function to take a pCreateInfo structure. 71 72 * Revision 6, 2016-01-14 (James Jones) 73 - Moved VK_ERROR_NATIVE_WINDOW_IN_USE_KHR from the VK_KHR_android_surface 74 to the VK_KHR_surface extension. 75