Implementare OpenGL ES ed EGL

OpenGL è un'API grafica multipiattaforma che specifica un'interfaccia software standard per l'hardware di elaborazione grafica 3D. OpenGL ES è un sottoinsieme della specifica OpenGL per i dispositivi incorporati.

Per essere compatibili con Android, i dispositivi devono fornire driver per EGL, OpenGL ES 1.x e OpenGL ES 2.0. Il supporto per OpenGL ES 3.x è facoltativo. Le considerazioni principali includono:

  • Garantire che il driver GL sia affidabile e conforme agli standard OpenGL ES.
  • Consentendo un numero illimitato di contesti GL. Poiché Android consente le app in background e tenta di mantenere attivi i contesti GL, non devi limitare il numero di contesti nel driver.
  • Tieni presente la quantità di memoria allocata per ogni contesto, perché è comune avere 20-30 contesti GL attivi contemporaneamente.
  • Supporto del formato immagine YV12 e di altri formati immagine YUV provenienti da altri componenti del sistema, come i codec multimediali o la videocamera.
  • Supporto delle estensioni obbligatorie EGL_KHR_wait_sync, GL_OES_texture_external, EGL_ANDROID_image_native_buffer e EGL_ANDROID_recordable. Inoltre, Hardware Composer v1.1 e versioni successive richiedono l'estensione EGL_ANDROID_framebuffer_target.

Ti consigliamo vivamente di supportare anche EGL_ANDROID_blob_cache, EGL_KHR_fence_sync e EGL_ANDROID_native_fence_sync.

Android 10 implementa l'interfaccia EGL 1.5. Per informazioni sulle nuove funzionalità di EGL 1.5, consulta le specifiche della versione 1.5 di Khronos.

Caricamento del driver in corso…

Android prevede che le GPU disponibili per il sistema siano note quando viene creata l'immagine di sistema. I percorsi preferiti per i driver OpenGL ES a 32 bit e 64 bit sono /vendor/lib/egl e /vendor/lib64/egl rispettivamente. Il loader utilizza due proprietà di sistema, ro.hardware.egl e ro.board.platform, o il nome esatto per rilevare e caricare i driver di sistema. Il driver OpenGL ES deve essere fornito in un unico binario o suddiviso in tre binari. Se il driver OpenGL ES viene fornito in un unico binario, utilizza uno dei seguenti nomi:

libGLES_${ro.hardware.egl}.so
libGLES_${ro.board.platform}.so
libGLES.so

Se il driver OpenGL ES viene fornito in tre file binari, utilizza uno dei seguenti set di nomi:

libEGL_${ro.hardware.egl}.so
libGLESv1_CM_${ro.hardware.egl}.so
libGLESv2_${ro.hardware.egl}.so

libEGL_${ro.board.platform}.so
libGLESv1_CM_${ro.board.platform}.so
libGLESv2_${ro.board.platform}.so

libEGL.so
libGLESv1_CM.so
libGLESv2.so

Livelli OpenGL ES

Android 10 introduce un sistema di stratificazione per GLES 2.0+. I livelli GLES sono oggetti condivisi disponibili all'interno delle app o forniti dagli strumenti. I livelli GLES consentono alle app sottoponibili a debug di rilevare e caricare i livelli utilizzando gli stessi meccanismi di configurazione di Vulkan.

GLES LayerLoader, un componente all'interno del caricatore EGL, identifica i livelli GLES. Per ogni livello trovato da GLES LayerLoader, GLES LayerLoader chiama AndroidGLESLayer_Initialize, esamina gli elenchi di funzioni di libEGL e chiama AndroidGLESLayer_GetProcAddress per tutte le funzioni note. Se il livello intercetta una funzione, ne monitora l'indirizzo. Se il livello non intercetta una funzione, AndroidGLESLayer_GetProcAddress restituisce lo stesso indirizzo della funzione che è stato trasmesso. LayerLoader aggiorna quindi l'elenco degli hook di funzione in modo che punti al punto di ingresso del livello.

Attivare i livelli

Puoi attivare i livelli GLES per app o a livello globale. Le impostazioni per app vengono mantenute dopo i riavvii, mentre le proprietà globali vengono cancellate al riavvio.

Per attivare i livelli per app:

# Enable layers
adb shell settings put global enable_gpu_debug_layers 1

# Specify target app
adb shell settings put global gpu_debug_app package_name

# Specify layer list (from top to bottom)
adb shell settings put global gpu_debug_layers_gles layer1:layer2:...:layerN

# Specify packages to search for layers
adb shell settings put global gpu_debug_layer_app package1:package2:...:packageN

Per disattivare i livelli per app:

adb shell settings delete global enable_gpu_debug_layers
adb shell settings delete global gpu_debug_app
adb shell settings delete global gpu_debug_layer_app

Per attivare i livelli a livello globale:

# Attempts to load layers for all applications, including native executables
adb shell setprop debug.gles.layers layer1:layer2:...:layerN

Livelli di test

I livelli GLES sono supportati da Android CTS e devono superare i test CTS per i dispositivi compatibili. Per verificare se i livelli funzionano su un dispositivo, esegui $ atest CtsGpuToolsHostTestCases.