Vulkan'ı uygulama

Vulkan, yüksek performanslı 3D grafikler için düşük maliyetli, platformlar arası bir API'dir. OpenGL ES (GLES) gibi Vulkan da uygulamalarda yüksek kaliteli, gerçek zamanlı grafikler oluşturmak için araçlar sağlar. Vulkan'ı kullanmanın avantajları arasında CPU yükü azaltma ve SPIR-V Binary Intermediate dili desteği yer alır.

Vulkan'ın başarıyla uygulanabilmesi için cihazda aşağıdakiler bulunmalıdır:

  • Android tarafından sağlanan Vulkan yükleyici.
  • GPU IHV'ler gibi SoC'ler tarafından sağlanan ve Vulkan API'yi uygulayan bir Vulkan sürücüsü. Vulkan işlevini desteklemek için Android cihazın Vulkan özellikli GPU donanımına ve ilişkili sürücüye ihtiyacı vardır. GPU, GLES 3.1 ve sonraki sürümleri de desteklemelidir. Sürücü desteği istemek için SoC tedarikçinizle iletişime geçin.

Bir cihazda Vulkan sürücüsü varsa cihazın, FEATURE_VULKAN_HARDWARE_LEVEL ve FEATURE_VULKAN_HARDWARE_VERSION sistem özelliklerini, cihazın özelliklerini doğru yansıtan sürümlerle bildirmesi gerekir. Bu, cihazın Uyumluluk Tanımlama Belgesi'ne (CDD) uygun olmasını sağlar.

Vulkan yükleyici

Vulkan yükleyici platform/frameworks/native/vulkan, Vulkan uygulamaları ile cihazın Vulkan sürücüsü arasındaki birincil arayüzdür. Vulkan yükleyicisi /system/lib[64]/libvulkan.so'e yüklenir. Yükleyici, temel Vulkan API giriş noktalarını, Android CDD tarafından zorunlu kılınan uzantıların giriş noktalarını ve birçok ek isteğe bağlı uzantı sağlar. Pencere Sistemi Entegrasyonu (WSI) uzantıları, yükleyici tarafından dışa aktarılır ve öncelikle sürücüde değil, yükleyicide uygulanır. Yükleyici, ek uzantılar gösterebilen ve sürücüye giderken temel API çağrılarını engelleyebilecek katmanların listelenmesini ve yüklenmesini de destekler.

NDK, bağlama yönelik bir libvulkan.so kitaplığı içerir. Kitaplık, yükleyiciyle aynı sembolleri dışa aktarır. Uygulamalar, gerçek libvulkan.so kitaplığından dışa aktarılan işlevleri çağırarak yükleyiciye trampolin işlevleri girer. Bu işlevler, ilk bağımsız değişkenlerine göre uygun katmana veya sürücüye dağıtılır. vkGet*ProcAddr() çağrısı, trambolinlerin dağıttığı işlev işaretçilerini döndürür (yani doğrudan temel API kodunu çağırır). Trampolü ve dağıtımı atladığı için dışa aktarılan simgeler yerine işlev işaretçileri aracılığıyla çağrı yapmak daha verimlidir.

Sürücü numaralandırma ve yükleme

Sistem görüntüsü oluşturulurken Android, sistemin hangi GPU'ların kullanılabileceğini bilmesini bekler. Yükleyici, sürücüyü bulup yüklemek için hardware.h mevcut HAL mekanizmasını kullanır. 32 bit ve 64 bit Vulkan sürücüleri için tercih edilen yollar şunlardır:

/vendor/lib/hw/vulkan.<ro.hardware.vulkan>.so
/vendor/lib/hw/vulkan.<ro.product.platform>.so
/vendor/lib64/hw/vulkan.<ro.hardware.vulkan>.so
/vendor/lib64/hw/vulkan.<ro.product.platform>.so

Android 7.0 ve sonraki sürümlerde Vulkan hw_module_t türevi tek bir hw_module_t yapısını sarmalar; yalnızca bir sürücü desteklenir ve sabit dize HWVULKAN_DEVICE_0, open()'ye iletilir.

Vulkan hw_device_t türevi, birden fazla fiziksel cihazı destekleyebilecek tek bir sürücüye karşılık gelir. hw_device_t yapısı, vkGetGlobalExtensionProperties(), vkCreateInstance() ve vkGetInstanceProcAddr() işlevlerini dışa aktaracak şekilde genişletilebilir. Yükleyici, hw_device_t yapısının vkGetInstanceProcAddr() işlevini çağırarak diğer tüm VkInstance(), VkPhysicalDevice() ve vkGetDeviceProcAddr() işlevlerini bulabilir.

Android 15'ten beri yükleyici, Vulkan sürücüsünü yüklemek için APEX'i destekler. Vulkan'ı APEX'ten yüklemek için ro.vulkan.apex değerini Vulkan APEX'in adına ayarlayın.

Katman keşfi ve yükleme

Vulkan yükleyici, ek uzantılar sunabilen ve sürücüye giden temel API çağrılarını engelleyebilecek katmanların listelenmesini ve yüklenmesini destekler. Android, sistem resminde katman içermez. Ancak uygulamalar APK'larına katman ekleyebilir.

Katmanları kullanırken Android'in güvenlik modelinin ve politikalarının diğer platformlardan önemli ölçüde farklı olduğunu unutmayın. Özellikle Android, üretim cihazlarındaki (rootlanmamış) hata ayıklama yapılamayan bir işleme harici kod yüklenmesine izin vermez. Ayrıca harici kodun, işlemin belleğini, durumunu vb. incelemesine veya kontrol etmesine izin vermez. Buna, daha sonra incelenmek üzere çekirdek dökümlerinin, API izlemelerinin vb. diske kaydedilmesinin yasaklanması da dahildir. Üretim cihazlarında yalnızca hata ayıklama yapılamayan uygulamaların bir parçası olarak sunulan katmanlar etkinleştirilir ve sürücüler bu politikaları ihlal eden işlevler sağlamamalıdır.

Katmanların kullanım alanları şunlardır:

  • Geliştirme aşaması katmanları: İzleme/profil oluşturma/hata ayıklama araçları için doğrulama katmanları ve ara katmanlar, üretim cihazlarının sistem resmine yüklenmemelidir. İzleme/profil oluşturma/hata ayıklama araçları için doğrulama katmanları ve ara katmanlar, sistem görüntüsü olmadan güncellenebilir olmalıdır. Geliştirme sırasında bu katmanlardan birini kullanmak isteyen geliştiriciler, uygulama paketini değiştirebilir (ör. yerel kitaplıklar dizinine dosya ekleyerek). Değiştirilemeyen uygulamaların gönderimindeki hataları teşhis etmek isteyen IHV ve OEM mühendislerinin, bu uygulamalarda hata ayıklama yapılamadığı sürece sistem görüntüsünün üretim dışı (rootlu) derlemelerine erişebildiği varsayılır. Daha fazla bilgi için Android'de Vulkan doğrulama katmanları başlıklı makaleyi inceleyin.
  • Yardımcı program katmanları: Bu katmanlar, cihaz belleği için bellek yöneticisi uygulayan bir katman gibi uzantıları gösterir. Geliştiriciler, uygulamalarında kullanacakları katmanları ve bu katmanların sürümlerini seçer. Aynı katmanı kullanan farklı uygulamalar yine de farklı sürümler kullanabilir. Geliştiriciler, uygulama paketlerinde hangi katmanların gönderileceğini seçer.
  • Enjekte edilen (örtük) katmanlar: Kullanıcı tarafından veya başka bir uygulama tarafından uygulamanın bilgisi veya izni olmadan sağlanan kare hızı, sosyal ağ ve oyun başlatıcı yer paylaşımları gibi katmanları içerir. Bunlar Android'in güvenlik politikalarını ihlal ettiğinden desteklenmez.

Hata ayıklama yapılamayan uygulamalarda yükleyici, katmanları yalnızca uygulamanın yerel kütüphane dizininde arar ve adı belirli bir kalıpla (örneğin, libVKLayer_foo.so) eşleşen tüm kütüphaneleri yüklemeye çalışır.

Hata ayıklama yapılabilir uygulamalarda yükleyici, /data/local/debug/vulkan içinde katmanlar arar ve belirli bir kalıpla eşleşen tüm kitaplıkları yüklemeye çalışır.

Android, katmanların Android ile diğer platformlar arasında derleme ortamı değişiklikleriyle taşınmasını sağlar. Katmanlar ile yükleyici arasındaki arayüz hakkında ayrıntılı bilgi için Vulkan Yükleyici Arayüzlerinin Mimarisi başlıklı makaleyi inceleyin. Khronos tarafından yönetilen doğrulama katmanları Vulkan Doğrulama Katmanları'nda barındırılır.

Vulkan API sürümleri ve özellikleri

Aşağıdaki tabloda, çeşitli Android sürümlerinin Vulkan API sürümleri listelenmektedir.
Android Sürümü Vulkan sürümü
Android 13 Vulkan 1.3
Android 9 Vulkan 1.1
Android 7 Vulkan 1.0

Vulkan 1.3 işlevlerine genel bakış

Vulkan 1.3, daha önce isteğe bağlı olan bazı uzantıları Vulkan temel işlevlerine dahil eder. Bu işlevlerin çoğu, Vulkan programlama arayüzü üzerinde kontrol ve ayrıntı düzeyini artırmak amacıyla eklenmiştir. Tek geçişli oluşturma geçişi örneklerinde artık oluşturma geçişi nesnelerine veya çerçeve önbellekleri gerekmez. Toplam ardışık düzen durum nesnesi sayısı azaltılabilir ve API'deki senkronizasyon tamamen yenilenir. Vulkan 1.3, Vulkan 1.2, 1.1 ve 1.0 ile aynı donanım gereksinimlerine sahiptir. Uygulamanın büyük kısmı çerçevede değil, SoC'ye özel grafik sürücüsündedir.

Android için Vulkan 1.3'ün en önemli özellikleri şunlardır:

  • Tek geçişli oluşturma geçişi örnekleri için destek
  • Gölgelendirici çağrısının hemen sonlandırılması için destek
  • Ardışık düzen oluşturma, paylaşma ve kontrol üzerinde daha ayrıntılı düzeyde denetim

Vulkan 1.3, birkaç küçük özellik ve API kullanılabilirliğiyle ilgili iyileştirmeler de içerir. 1.3 küçük düzeltmesi ile temel Vulkan API'sinde yapılan tüm değişiklikleri Temel Düzeltmeler (Vulkan 1.3) bölümünde bulabilirsiniz.

Vulkan 1.2 işlevlerine genel bakış

Vulkan 1.2, API yüzeyini basitleştiren çeşitli özellikler ve uzantılar ekler. Buna birleşik bir Bellek Modeli ve cihaz sürücüsünden sorgulanabilir ek bilgiler dahildir. Vulkan 1.2, Vulkan 1.0 ve 1.1 ile aynı donanım gereksinimlerine sahiptir. Tüm uygulama, çerçevede değil, SoC'ye özel grafik sürücüsündedir.

Android için Vulkan 1.2'nin en önemli özelliği 8 bit depolama desteğidir.

Vulkan 1.2, birkaç küçük özellik ve API kullanılabilirliğiyle ilgili iyileştirmeler de içerir. 1.2 küçük düzeltmesi ile temel Vulkan API'sinde yapılan tüm değişiklikleri Temel Düzeltmeler (Vulkan 1.2) başlıklı makalede bulabilirsiniz.

Vulkan 1.1 işlevlerine genel bakış

Vulkan 1.1, OEM'lerin cihazlarda Vulkan 1.1'i desteklemesine olanak tanıyan bellek/senkronizasyon birlikte çalışabilirliği desteği içerir. Ayrıca, bellek/senkronizasyon birlikte çalışabilirliği, geliştiricilerin Vulkan 1.1'in bir cihazda desteklenip desteklenmediğini belirlemesine ve destekleniyorsa etkili bir şekilde kullanmasına olanak tanır. Vulkan 1.1, Vulkan 1.0 ile aynı donanım gereksinimlerine sahiptir ancak uygulamanın çoğu, çerçevede değil, SOC'ye özgü grafik sürücüsündedir.

Android için Vulkan 1.1'in en önemli özellikleri şunlardır:

  • Vulkan dışından bellek arabelleklerinin ve senkronizasyon nesnelerinin içe ve dışa aktarılması desteği (kamera, codec'ler ve GLES ile birlikte çalışabilirlik için)
  • YCbCr biçimleri için destek

Vulkan 1.1, birkaç küçük özellik ve API kullanılabilirliğiyle ilgili geliştirmeler de içerir. 1.1 küçük düzeltmesi ile temel Vulkan API'sinde yapılan tüm değişiklikleri Temel Düzeltmeler (Vulkan 1.1) bölümünde bulabilirsiniz.

Vulkan desteğini seçme

Android cihazlar, 64 bit ABI'yi desteklemeleri ve düşük bellek kapasitesine sahip olmamaları koşuluyla mevcut en gelişmiş Vulkan özellik grubunu desteklemelidir.

Android 13 ve sonraki sürümlerle kullanıma sunulan cihazlar Vulkan 1.3'ü desteklemelidir.

Android 10 ile kullanıma sunulan cihazlar Vulkan 1.1'i desteklemelidir.

Diğer cihazlar isteğe bağlı olarak Vulkan 1.3, 1.2 ve 1.1'i destekleyebilir.

Vulkan sürümünü destekleme

Aşağıdaki koşullar karşılanıyorsa Android cihazlar Vulkan sürümlerini destekler:

  1. Android sürümünün ek CDD şartlarını yerine getirmek için, istenen Vulkan sürümünü (Vulkan 1.3, 1.1 veya 1.0 sürümlerinden biri olmalıdır) destekleyen bir Vulkan sürücüsü ekleyin. Alternatif olarak, daha düşük bir Vulkan sürüm numarasına sahip mevcut bir Vulkan sürücüsünü güncelleyebilirsiniz.
  2. Vulkan 1.3 veya 1.1 için paket yöneticisi tarafından döndürülen sistem özelliğinin, doğru Vulkan sürümü için true döndürdüğünden emin olun.
    • Vulkan 1.3 için bu özellik PackageManager#hasSystemFeature(PackageManager.FEATURE_VULKAN_HARDWARE_VERSION, 0x403000) şeklindedir.
    • Vulkan 1.1 için bu özellik PackageManager#hasSystemFeature(PackageManager.FEATURE_VULKAN_HARDWARE_VERSION, 0x401000) olarak ayarlanır.
    Paket yöneticisi, uygun bir device.mk dosyasına aşağıdaki gibi gösterilen bir kural ekleyerek Vulkan 1.3 ve Vulkan 1.1 için true değerini döndürür.
    • Vulkan 1.3 için aşağıdakileri ekleyin: 
      PRODUCT_COPY_FILES += frameworks/native/data/etc/android.hardware.vulkan.version-1_3.xml:
$(TARGET_COPY_OUT_VENDOR)/etc/permissions/android.hardware.vulkan.version.xml
    • Vulkan 1.1 için aşağıdakileri ekleyin: 
      PRODUCT_COPY_FILES += frameworks/native/data/etc/android.hardware.vulkan.version-1_1.xml:
$(TARGET_COPY_OUT_VENDOR)/etc/permissions/android.hardware.vulkan.version.xml

Android temel profili (ABP)

Tüm Android cihazların, Android Baseline profil kılavuzunda belirtildiği şekilde en son Android Baseline 2022 profiline uymasını öneririz.

Android 14 veya sonraki sürümleri ve Vulkan API'yi destekleyen tüm cihazlar, Android Baseline 2021 profilinde tanımlanan tüm işlevleri karşılamalıdır. Gerekli işlevlerin tam listesi Vulkan profili json dosyasında belirtilmiştir ancak gerekli işlevlerin önemli bir alt kümesi şunları içerir:

  • ASTC ve ETC aracılığıyla sıkıştırılmış dokular.
  • VK_EXT_swapchain_colorspace aracılığıyla değişken renk uzaylarını kullanın.
  • sampleRateShading aracılığıyla örnek gölgeleme ve çok örnekli kesme

Pencere sistemi entegrasyonu (WSI)

Sürücü, libvulkan.so sürümünde aşağıdaki pencere sistemi entegrasyonu (WSI) uzantılarını uygular:

  • VK_KHR_surface
  • VK_KHR_android_surface
  • VK_KHR_swapchain
  • VK_KHR_driver_properties, yalnızca Android 10'da Vulkan 1.1 için uygulanır
  • VK_GOOGLE_display_timing, Android 10'daki tüm Vulkan sürümleri için uygulanır

VkSurfaceKHR ve VkSwapchainKHR nesneleri ile ANativeWindow arasındaki tüm etkileşimler platform tarafından yönetilir ve sürücülere gösterilmez. WSI uygulaması, sürücü tarafından desteklenmesi gereken VK_ANDROID_native_buffer uzantısını kullanır. Bu uzantı yalnızca WSI uygulaması tarafından kullanılır ve uygulamalara gösterilmez.

Gralloc kullanım işaretleri

Vulkan uygulamalarında, takas zinciri arabelleklerinin uygulama tanımlı özel Gralloc kullanım işaretleriyle ayrılması gerekebilir. Android, takas zinciri oluştururken sürücüden aşağıdakileri çağırarak istenen biçim ve resim kullanım işaretlerini Gralloc kullanım işaretlerine çevirmesini ister:

typedef enum VkSwapchainImageUsageFlagBitsANDROID {
    VK_SWAPCHAIN_IMAGE_USAGE_SHARED_BIT_ANDROID = 0x00000001,
    VK_SWAPCHAIN_IMAGE_USAGE_FLAG_BITS_MAX_ENUM = 0x7FFFFFFF
} VkSwapchainImageUsageFlagBitsANDROID;
typedef VkFlags VkSwapchainImageUsageFlagsANDROID;

VkResult VKAPI vkGetSwapchainGrallocUsage2ANDROID(
    VkDevice                          device,
    VkFormat                          format,
    VkImageUsageFlags                 imageUsage,
    VkSwapchainImageUsageFlagsANDROID swapchainUsage,
    uint64_t*                         grallocConsumerUsage,
    uint64_t*                         grallocProducerUsage
);

format ve imageUsage parametreleri VkSwapchainCreateInfoKHR yapısından alınır. Sürücü, *grallocConsumerUsage ve *grallocProducerUsage değerlerini biçim ve kullanım için gereken Gralloc kullanım işaretleriyle doldurmalıdır. Sürücü tarafından döndürülen kullanım işaretleri, arabellek ayırırken takas zinciri tüketicisi tarafından istenen kullanım işaretleriyle birleştirilir.

Android 7.x, VkSwapchainImageUsageFlagsANDROID()'ın vkGetSwapchainGrallocUsageANDROID() adlı önceki bir sürümünü çağırır. Android 8.0 ve sonraki sürümlerde vkGetSwapchainGrallocUsageANDROID() desteği sonlandırılmıştır ancak sürücü tarafından vkGetSwapchainGrallocUsage2ANDROID() sağlanmazsa vkGetSwapchainGrallocUsageANDROID() çağrısı yine de yapılır:

VkResult VKAPI vkGetSwapchainGrallocUsageANDROID(
    VkDevice            device,
    VkFormat            format,
    VkImageUsageFlags   imageUsage,
    int*                grallocUsage
);

vkGetSwapchainGrallocUsageANDROID(), takas zinciri kullanım işaretlerini veya genişletilmiş Gralloc kullanım işaretlerini desteklemez.

Gralloc destekli resimler

VkNativeBufferANDROID, Gralloc arabelleği tarafından desteklenen bir resim oluşturmak için kullanılan bir vkCreateImage uzantı yapısıdır. VkNativeBufferANDROID, VkImageCreateInfo yapı zincirindeki vkCreateImage()'e sağlanır. VkNativeBufferANDROID, vkCreateSwapchainKHR ile yapılan arama sırasında vkCreateImage()'ü arar. WSI uygulaması, takas zinciri için istenen yerel arabellek sayısını ayırır ve ardından her biri için bir VkImage oluşturur:

typedef struct {
    VkStructureType             sType; // must be VK_STRUCTURE_TYPE_NATIVE_BUFFER_ANDROID
    const void*                 pNext;

    // Buffer handle and stride returned from gralloc alloc()
    buffer_handle_t             handle;
    int                         stride;

    // Gralloc format and usage requested when the buffer was allocated.
    int                         format;
    int                         usage;
    // Beginning in Android 8.0, the usage field above is deprecated and the
    // usage2 struct below was added. The usage field is still filled in for
    // compatibility with Android 7.0 drivers. Drivers for Android 8.0
    // should prefer the usage2 struct, especially if the
    // android.hardware.graphics.allocator HAL uses the extended usage bits.
    struct {
        uint64_t                consumer;
        uint64_t                producer;
    } usage2;
} VkNativeBufferANDROID;

Gralloc destekli bir resim oluştururken VkImageCreateInfo aşağıdaki verileri içerir:

  .sType               = VK_STRUCTURE_TYPE_IMAGE_CREATE_INFO
  .pNext               = the above VkNativeBufferANDROID structure
  .imageType           = VK_IMAGE_TYPE_2D
  .format              = a VkFormat matching the format requested for the gralloc buffer
  .extent              = the 2D dimensions requested for the gralloc buffer
  .mipLevels           = 1
  .arraySize           = 1
  .samples             = 1
  .tiling              = VK_IMAGE_TILING_OPTIMAL
  .usage               = VkSwapchainCreateInfoKHR::imageUsage
  .flags               = 0
  .sharingMode         = VkSwapchainCreateInfoKHR::imageSharingMode
  .queueFamilyCount    = VkSwapchainCreateInfoKHR::queueFamilyIndexCount
  .pQueueFamilyIndices = VkSwapchainCreateInfoKHR::pQueueFamilyIndices

Android 8.0 ve sonraki sürümlerde platform, takas zinciri için herhangi bir takas zinciri resim kullanım işareti gerektiğinde vkCreateImage'ye sağlanan VkImageCreateInfo zincirinde bir VkSwapchainImageCreateInfoKHR uzantı yapısı sağlar. Uzantı yapısı, takas zinciri resim kullanım işaretlerini içerir:

typedef struct {
    VkStructureType                        sType; // must be VK_STRUCTURE_TYPE_SWAPCHAIN_IMAGE_CREATE_INFO_ANDROID
    const void*                            pNext;

    VkSwapchainImageUsageFlagsANDROID      usage;
} VkSwapchainImageCreateInfoANDROID;

Android 10 ve sonraki sürümlerde platform VK_KHR_swapchain v70'i destekler. Bu nedenle Vulkan uygulaması, takas zinciri belleği tarafından desteklenen bir VkImage oluşturabilir. Uygulama, önce VkImageCreateInfo yapısına zincirlenmiş bir VkImageSwapchainCreateInfoKHR yapısıyla vkCreateImage işlevini çağırır. Ardından uygulama, VkBindImageMemoryInfo yapısına zincirlenmiş bir VkBindImageMemorySwapchainInfoKHR yapısıyla vkBindImageMemory2(KHR) işlevini çağırır. VkBindImageMemorySwapchainInfoKHR yapısında belirtilen imageIndex, geçerli bir takas zinciri resim dizini olmalıdır. Bu sırada platform, VkBindImageMemoryInfo zincirine karşılık gelen Gralloc arabellek bilgilerini içeren bir VkNativeBufferANDROID uzantı yapısı sağlar. Böylece sürücü, VkImage öğesini hangi Gralloc arabelleğine bağlayacağını bilir.

Görüntü edinme

vkAcquireImageANDROID, bir takas zinciri resminin sahipliğini alır ve harici olarak sinyalize edilen yerel bir çiti hem mevcut bir VkSemaphore nesnesine hem de mevcut bir VkFence nesnesine aktarır:

VkResult VKAPI vkAcquireImageANDROID(
    VkDevice            device,
    VkImage             image,
    int                 nativeFenceFd,
    VkSemaphore         semaphore,
    VkFence             fence
);

vkAcquireImageANDROID(), uygulama tarafından sağlanan VkSemaphore ve VkFence nesnelerine yerel bir çit içe aktarmak için vkAcquireNextImageKHR sırasında çağrılır (ancak bu çağrıda hem semafor hem de çit nesneleri isteğe bağlıdır). Sürücü, Gralloc arabellek durumundaki harici değişiklikleri tanımak ve işlemek için de bu fırsattan yararlanabilir. Birçok sürücünün burada herhangi bir işlem yapması gerekmez. Bu çağrı, VkSemaphore ve VkFence'yi vkQueueSubmit tarafından sinyallenmiş gibi bekleme durumuna geçirir. Böylece, sıralar semaforda ve uygulama da çitte bekleyebilir.

Temel yerel çit sinyal gönderdiğinde her iki nesne de sinyal alır. Yerel çit zaten sinyal göndermişse bu işlev döndürüldüğünde semafor sinyallenmiş durumda olur. Sürücü, çit dosya tanımlayıcısının sahipliğini alır ve artık gerekli olmadığında çit dosya tanımlayıcısını kapatır. Sürücü, semafor veya çit nesnesi sağlanmamış olsa bile veya vkAcquireImageANDROID başarısız olup hata döndürmüş olsa bile bunu yapmalıdır. fenceFd -1 ise yerel çit zaten sinyallenmiş gibidir.

Resimleri yayınlama

vkQueueSignalReleaseImageANDROID, harici kullanım için bir takas zinciri resmi hazırlar, doğal bir çit oluşturur ve doğal çitin, giriş semaforları sinyal gönderdikten sonra sinyal göndermesi için planlamasını yapar:

VkResult VKAPI vkQueueSignalReleaseImageANDROID(
    VkQueue             queue,
    uint32_t            waitSemaphoreCount,
    const VkSemaphore*  pWaitSemaphores,
    VkImage             image,
    int*                pNativeFenceFd
);

Sağlanan sırada vkQueuePresentKHR() vkQueueSignalReleaseImageANDROID() araması Sürücü, pWaitSemaphores içindeki tüm waitSemaphoreCount semaforları sinyal gönderene ve image'yi sunmaya hazırlamak için gereken tüm çalışmalar tamamlanana kadar sinyal göndermeyen yerel bir çit oluşturmalıdır.

Bekleme semaforları (varsa) zaten sinyal verdiyse ve queue zaten boştaysa sürücü, *pNativeFenceFd değerini gerçek bir yerel çit dosya tanımlayıcısı yerine -1 olarak ayarlayarak bekleyecek bir şey olmadığını gösterir. *pNativeFenceFd içinde döndürülen dosya tanımlayıcısının sahibi ve kapatıcısı arayan olur.

Birçok sürücü, resim parametresini yoksayabilir ancak bazı sürücülerin, harici resim tüketicileri tarafından kullanılması için Gralloc arabelleğiyle ilişkili CPU taraflı veri yapılarını hazırlaması gerekebilir. Arabellek içeriklerinin harici tüketiciler tarafından kullanılması için hazırlanması, resmi VK_IMAGE_LAYOUT_PRESENT_SRC_KHR'e geçirmenin bir parçası olarak eşzamansız olarak yapılmalıdır.

Görüntü VK_SWAPCHAIN_IMAGE_USAGE_SHARED_BIT_ANDROID ile oluşturulduysa sürücü, vkAcquireImageANDROID() çağrıları olmadan vkQueueSignalReleaseImageANDROID()'in tekrar tekrar çağrılmasına izin vermelidir.

Paylaşılan, sunulacak resim desteği

Bazı cihazlar, gecikmeyi en aza indirmek için tek bir resmin sahipliğini ekran ardışık düzeni ile Vulkan uygulaması arasında paylaşabilir. Android 9 ve sonraki sürümlerde yükleyici, sürücünün vkGetPhysicalDeviceProperties2 çağrısına verdiği yanıta bağlı olarak VK_KHR_shared_presentable_image uzantısının reklamını koşullu olarak yapar.

Sürücü Vulkan 1.1'i veya VK_KHR_physical_device_properties2 uzantısını desteklemiyorsa yükleyici, paylaşılan ve görüntülenebilir resimler için destek sunduğunu belirtmez. Aksi takdirde yükleyici, vkGetPhysicalDeviceProperties2() çağrısını yaparak ve VkPhysicalDeviceProperties2::pNext zincirine aşağıdaki yapıyı ekleyerek sürücü özelliklerini sorgulamaz:

typedef struct {
    VkStructureType sType; // must be VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PRESENTATION_PROPERTIES_ANDROID
    const void*     pNext;
    VkBool32        sharedImage;
} VkPhysicalDevicePresentationPropertiesANDROID;

Sürücü, bir resmin sahipliğini ekran sistemiyle paylaşabiliyorsa sharedImage üyesini VK_TRUE olarak ayarlar.

Doğrulama

OEM'ler, Vulkan uygulamalarını CTS'yi kullanarak test edebilir. CTS aşağıdakileri içerir:

  • Vulkan 1.0, 1.1, 1.2 ve 1.3 için işlevsel API testlerini içeren CtsDeqpTestCases modülündeki Khronos Vulkan Uygunluk testleri.
  • Cihazın desteklediği Vulkan özellikleri için doğru şekilde yapılandırıldığını test eden CtsGraphicsTestCases modülü.

Vulkan özellik bayrağı

Android 11 veya sonraki sürümleri ve Vulkan API'yi destekleyen bir cihazın, android.software.vulkan.deqp.level özellik işaretini göstermesi gerekir. Bu özellik işaretinin değeri, tam sayı değeri olarak kodlanmış bir tarihtir. Cihazın geçtiğini iddia ettiği Vulkan dEQP testleriyle ilişkili tarihi belirtir.

YYYY-AA-GG biçimindeki tarihler 32 bitlik bir tam sayı olarak aşağıdaki şekilde kodlanır:

  • 0-15 bitleri yılı saklar.
  • 16-23 bitleri ayı saklar.
  • 24-31 bitleri günü saklar.

Özellik işareti için izin verilen minimum değer 0x07E30301'tür. Bu değer, Android 10 için Vulkan dEQP testleriyle ilişkili tarih olan 01.03.2019 tarihine karşılık gelir. Özellik işareti en az bu değerdeyse cihaz, Android 10 Vulkan dEQP testlerinin tümünü geçtiğini iddia eder.

0x07E40301 değeri, Android 11 için Vulkan dEQP testleriyle ilişkili tarih olan 01.03.2020 tarihine karşılık gelir. Özellik işareti en az bu değerdeyse cihaz, Android 11 Vulkan dEQP testlerinin tümünü geçtiğini iddia eder.

0x07E60301 değeri, Android 13 için Vulkan dEQP testleriyle ilişkili tarih olan 01.03.2022 tarihine karşılık gelir. Özellik işareti en az bu değerdeyse cihaz, Android 13 Vulkan dEQP testlerinin tümünü geçtiğini iddia eder.

Belirli bir özellik işaretini (ör. 0x07E30301, 0x07E40301, 0x07E60301) gösteren bir cihaz, söz konusu özellik işaretiyle ilgili tüm Android Vulkan dEQP testlerini (sırasıyla Android 10, Android 11, Android 13) geçtiğini iddia eder. Bu cihaz, daha sonraki bir Android sürümünün Vulkan dEQP testlerini geçebilir.

Vulkan dEQP, Android CTS'nin bir parçasıdır. Android 11'den itibaren CTS'nin dEQP test çalıştırıcı bileşeni, android.software.vulkan.deqp.level özellik işaretini algılar ve bu özellik işaretine göre cihazın desteklediğini iddia etmediği tüm Vulkan dEQP testlerini atlar. Bu tür testler, basit bir şekilde geçiyor olarak raporlanır.