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 andal 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, Anda tidak boleh membatasi jumlah konteks di driver.
• Memperhatikan 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.

Sebaiknya dukung juga EGL_ANDROID_blob_cache, EGL_KHR_fence_sync, dan EGL_ANDROID_native_fence_sync.

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

Catatan: OpenGL API yang ditampilkan kepada developer aplikasi berbeda dengan OpenGL yang diimplementasikan di perangkat. Aplikasi tidak dapat mengakses lapisan driver GL secara langsung dan harus melalui antarmuka yang disediakan oleh API.

Pemuatan driver

Android mengharapkan GPU yang tersedia untuk sistem diketahui saat image sistem dibuat. Jalur yang lebih disukai untuk driver OpenGL ES 32-bit dan 64-bit masing-masing adalah /vendor/lib/egl dan /vendor/lib64/egl. Loader menggunakan dua properti sistem, ro.hardware.egl dan ro.board.platform, atau nama yang tepat untuk menemukan dan memuat driver sistem. Driver OpenGL ES harus dikirim 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 dikirim ke dalam tiga biner, gunakan salah satu kumpulan 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 atau yang lebih baru. 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 dengan Vulkan.

Perhatian: Jika pelapisan diaktifkan, fungsi eksklusif GLES 1.x akan terus dirutekan ke driver GLES 1.x, tetapi fungsi yang dibagikan dengan GLES 2.0 ke atas akan dirutekan ke driver 2.0 ke atas.

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

Mengaktifkan lapisan

Catatan: Model keamanan dan kebijakan Android berbeda secara signifikan dibandingkan platform lainnya. Android hanya mengizinkan pengguna yang memiliki akses root untuk memuat lapisan GLES dari penyimpanan lokal perangkat. Tanpa akses root, lapisan GLES hanya dapat dimuat untuk aplikasi yang dapat di-debug.

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 Android CTS dan harus lulus pengujian CTS untuk perangkat yang kompatibel. Untuk mengidentifikasi apakah lapisan berfungsi di perangkat, jalankan $ atest CtsGpuToolsHostTestCases.