Mengimplementasikan OpenGL ES dan EGL

OpenGL adalah API grafis lintas platform yang menentukan antarmuka software standar untuk hardware pemrosesan grafis 3D. OpenGL ES adalah subset dari spesifikasi OpenGL untuk perangkat tersemat.

Agar kompatibel dengan Android, perangkat harus menyediakan driver untuk EGL, OpenGL ES 1.x, dan OpenGL ES 2.0. Dukungan untuk OpenGL ES 3.x bersifat opsional. Pertimbangan utama meliputi:

  • Memastikan bahwa driver GL kuat dan sesuai dengan standar OpenGL ES.
  • Mengizinkan konteks GL dalam jumlah yang tidak terbatas. Karena Android mengizinkan aplikasi di latar belakang dan mencoba mempertahankan konteks GL tetap aktif, Anda tidak boleh membatasi jumlah konteks di driver.
  • Perhatikan jumlah memori yang dialokasikan untuk setiap konteks, karena biasanya ada 20–30 konteks GL aktif sekaligus.
  • Mendukung format gambar YV12 dan format gambar YUV lainnya yang berasal dari komponen lain dalam sistem, seperti codec media atau kamera.
  • Mendukung ekstensi wajib EGL_KHR_wait_sync, GL_OES_texture_external, EGL_ANDROID_image_native_buffer, dan EGL_ANDROID_recordable. Selain itu, Hardware Composer v1.1 dan yang lebih tinggi memerlukan ekstensi EGL_ANDROID_framebuffer_target.

Sangat direkomendasikan untuk juga mendukung EGL_ANDROID_blob_cache, EGL_KHR_fence_sync, dan EGL_ANDROID_native_fence_sync.

Android 10 mengimplementasikan antarmuka EGL 1.5. Untuk mengetahui informasi tentang fitur baru di EGL 1.5, lihat Spesifikasi Rilis 1.5 Khronos.

Memuat driver

Android mengharapkan GPU yang tersedia untuk sistem diketahui saat image sistem dibuat. Jalur pilihan untuk driver OpenGL ES 32-bit dan 64-bit adalah /vendor/lib/egl dan /vendor/lib64/egl. Loader menggunakan dua properti sistem, ro.hardware.egl dan ro.board.platform, atau nama persis untuk menemukan dan memuat driver sistem. Driver OpenGL ES harus dikirimkan dalam satu biner atau dibagi menjadi tiga biner. Jika driver OpenGL ES dikirim dalam satu biner, gunakan salah satu nama berikut:

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

Jika driver OpenGL ES dikirimkan ke dalam tiga biner, gunakan salah satu set nama berikut:

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

Lapisan OpenGL ES

Android 10 memperkenalkan sistem pelapisan untuk GLES 2.0+. Lapisan GLES adalah objek bersama yang tersedia dari dalam aplikasi atau disediakan oleh alat. Lapisan GLES memungkinkan aplikasi yang dapat di-debug menemukan dan memuat lapisan menggunakan mekanisme penyiapan yang sama seperti Vulkan.

GLES LayerLoader, komponen dalam loader EGL, mengidentifikasi lapisan GLES. Untuk setiap lapisan yang ditemukan, GLES LayerLoader akan memanggil AndroidGLESLayer_Initialize, menelusuri daftar fungsi libEGL, dan memanggil AndroidGLESLayer_GetProcAddress untuk semua fungsi yang dikenal. Jika mengintersep fungsi, lapisan akan melacak alamat fungsi tersebut. Jika lapisan tidak mengintersep fungsi, AndroidGLESLayer_GetProcAddress akan menampilkan alamat fungsi yang sama seperti yang diteruskan padanya. Selanjutnya, LayerLoader akan memperbarui daftar hook fungsi agar mengarah ke titik entri lapisan.

Mengaktifkan lapisan

Anda dapat mengaktifkan lapisan GLES per aplikasi maupun secara global. Setelan per aplikasi tetap dipertahankan meskipun perangkat dimulai ulang, sedangkan properti global akan dihapus saat perangkat dimulai ulang.

Untuk mengaktifkan lapisan per aplikasi:

# 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

Untuk menonaktifkan lapisan per aplikasi:

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

Untuk mengaktifkan lapisan secara global:

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

Lapisan pengujian

Lapisan GLES didukung oleh CTS Android dan harus lulus pengujian CTS untuk perangkat yang kompatibel. Untuk mengidentifikasi apakah lapisan berfungsi di perangkat, jalankan $ atest CtsGpuToolsHostTestCases.