Dvije osnovne klase koje omogućuju kreiranje i manipulaciju grafičkih elemenata sa Android OpenGL ES API-em su GLSurfaceView i GLSurfaceView.Renderer.
GLSurfaceView klasa je pogled (View) na koji se može crtati i manipulirati objektima korištenjem OpenGL API poziva. Funkcijski je slična android klasi SurfaceView.
GLSurfaceView.Renderer je sučelje koje definira metode potrebne za crtanje grafičkih elemenata u GLSurfaceView-u. Implementacija ovog sučelja treba biti odvojena klasa koja se sa instancom GLSurfaceView klase povezuje GLSurfaceView.setRenderer() metodom.
GLSurfaceView.Renderer sučelje zahtjeva implementaciju sljedećih metoda:
- onSurfaceCreated(): Sustav poziva ovu metodu jednom, prilikom izrade GLSurfaceView-a. Koristi se za obavljanje radnji koje je potrebno obaviti samo jednom, poput postavljanja OpenGL parametara okruženja ili inicijalizacije OpenGL grafičkih objekata.
- onDrawFrame(): Sustav poziva ovu metodu svakim ponovnim iscrtavanjem GLSurfaceView-a. Koristi se za crtanje (i ponovno crtanja) grafičkih objekata.
- onSurfaceChanged(): Sustav poziva ovu metodu kada se promjeni geometrija GLSurfaceView-a. To uključuje i promjene u veličini GLSurfaceView-a ili orijentacije ekrana uređaja. Tako primjerice, sustav poziva ovu metodu kada se uređaj mijenja iz vertikalnog u vodoravni položaj.
Koristi za odgovaranje na promjene u GLSurfaceView kontejneru.
Definiranje OpenGL zahtjeva
Ako program koristi OpenGL funkcionalnosti dobro je uključiti sljedeće uvjete u AndroidManifest.xml datoteku.
Razlog tome je što OpenGL ne podržavaju svi uređaji.
Definiranjem koja je verzija OpenGL-a potrebna za pokretanje aplikacije definira se koji sve uređaji mogu preuzeti i instalirati aplikaciju sa Google Play-a.
<!-- Tell the system this app requires OpenGL ES 2.0. -->
<uses-feature android:glEsVersion="0x00020000" android:required="true" />
<!-- Tell the system this app requires OpenGL ES 3.0. -->
<uses-feature android:glEsVersion="0x00030000" android:required="true" />