Создайте среду OpenGL ES.

Чтобы рисовать графику с помощью OpenGL ES в вашем приложении Android, вы должны создать для нее контейнер представления. Один из наиболее простых способов сделать это — реализовать как GLSurfaceView , так и GLSurfaceView.Renderer . GLSurfaceView — это контейнер представления для графики, нарисованной с помощью OpenGL, и GLSurfaceView.Renderer управляет тем, что отображается в этом представлении. Дополнительные сведения об этих классах см. в руководстве разработчика OpenGL ES .

GLSurfaceView — это всего лишь один из способов включить графику OpenGL ES в ваше приложение. Для полноэкранного или почти полноэкранного просмотра графики это разумный выбор. Разработчикам, которые хотят включить графику OpenGL ES в небольшую часть своих макетов, следует обратить внимание на TextureView . Настоящие разработчики, работающие самостоятельно, также могут создать представление OpenGL ES с помощью SurfaceView , но для этого потребуется написать довольно много дополнительного кода.

В этом уроке объясняется, как выполнить минимальную реализацию GLSurfaceView и GLSurfaceView.Renderer в простом приложении.

Объявите использование OpenGL ES в манифесте.

Чтобы ваше приложение могло использовать API OpenGL ES 2.0, вы должны добавить в манифест следующее объявление:

<uses-feature android:glEsVersion="0x00020000" android:required="true" />

Если ваше приложение использует сжатие текстур, вы также должны указать, какие форматы сжатия поддерживает ваше приложение, чтобы оно устанавливалось только на совместимые устройства.

<supports-gl-texture android:name="GL_OES_compressed_ETC1_RGB8_texture" />
<supports-gl-texture android:name="GL_OES_compressed_paletted_texture" />

Дополнительные сведения о форматах сжатия текстур см. в руководстве разработчика OpenGL .

Создайте действие для графики OpenGL ES.

Приложения Android, использующие OpenGL ES, выполняют действия, как и любое другое приложение, имеющее пользовательский интерфейс. Основное отличие от других приложений — это то, что вы помещаете в макет своей деятельности. Хотя во многих приложениях вы можете использовать TextView , Button и ListView , в приложении, использующем OpenGL ES, вы также можете добавить GLSurfaceView .

В следующем примере кода показана минимальная реализация действия, которое использует GLSurfaceView в качестве основного представления:

class OpenGLES20Activity : Activity() {

    private lateinit var gLView: GLSurfaceView

    public override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // Create a GLSurfaceView instance and set it
        // as the ContentView for this Activity.
        gLView = MyGLSurfaceView(this)
        setContentView(gLView)
    }
}

public class OpenGLES20Activity extends Activity {

    private GLSurfaceView gLView;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        // Create a GLSurfaceView instance and set it
        // as the ContentView for this Activity.
        gLView = new MyGLSurfaceView(this);
        setContentView(gLView);
    }
}

Примечание. Для OpenGL ES 2.0 требуется Android 2.2 (уровень API 8) или выше, поэтому убедитесь, что ваш проект Android ориентирован на этот API или выше.

Создайте объект GLSurfaceView.

GLSurfaceView — это специализированное представление, в котором можно рисовать графику OpenGL ES. Само по себе оно мало что делает. Фактическое рисование объектов контролируется в GLSurfaceView.Renderer , который вы установили для этого представления. На самом деле код этого объекта настолько тонкий, что у вас может возникнуть соблазн пропустить его расширение и просто создать немодифицированный экземпляр GLSurfaceView , но не делайте этого. Вам необходимо расширить этот класс, чтобы фиксировать события касания, которые рассматриваются в уроке «Реагирование на события касания» .

Основной код для GLSurfaceView минимален, поэтому для быстрой реализации обычно просто создают внутренний класс в активности, которая его использует:

import android.content.Context
import android.opengl.GLSurfaceView

class MyGLSurfaceView(context: Context) : GLSurfaceView(context) {

    private val renderer: MyGLRenderer

    init {

        // Create an OpenGL ES 2.0 context
        setEGLContextClientVersion(2)

        renderer = MyGLRenderer()

        // Set the Renderer for drawing on the GLSurfaceView
        setRenderer(renderer)
    }
}

import android.content.Context;
import android.opengl.GLSurfaceView;

class MyGLSurfaceView extends GLSurfaceView {

    private final MyGLRenderer renderer;

    public MyGLSurfaceView(Context context){
        super(context);

        // Create an OpenGL ES 2.0 context
        setEGLContextClientVersion(2);

        renderer = new MyGLRenderer();

        // Set the Renderer for drawing on the GLSurfaceView
        setRenderer(renderer);
    }
}

Еще одним необязательным дополнением к вашей реализации GLSurfaceView является установка режима рендеринга для рисования представления только при изменении данных рисования с помощью параметра GLSurfaceView.RENDERMODE_WHEN_DIRTY :

// Render the view only when there is a change in the drawing data
renderMode = GLSurfaceView.RENDERMODE_WHEN_DIRTY

// Render the view only when there is a change in the drawing data
setRenderMode(GLSurfaceView.RENDERMODE_WHEN_DIRTY);

Этот параметр предотвращает перерисовку кадра GLSurfaceView до тех пор, пока вы не вызовете requestRender() , что более эффективно для этого примера приложения.

Создайте класс рендеринга

Реализация класса GLSurfaceView.Renderer или средства визуализации в приложении, использующем OpenGL ES, — вот где все становится интереснее. Этот класс управляет тем, что отображается в GLSurfaceView , с которым он связан. В рендерере есть три метода, которые вызываются системой Android для того, чтобы понять, что и как рисовать на GLSurfaceView :

• onSurfaceCreated() — вызывается один раз для настройки среды OpenGL ES представления.
• onDrawFrame() — вызывается при каждой перерисовке представления.
• onSurfaceChanged() — вызывается, если изменяется геометрия вида, например, когда меняется ориентация экрана устройства.

Вот очень простая реализация средства рендеринга OpenGL ES, которая не делает ничего, кроме рисования черного фона в GLSurfaceView :

import javax.microedition.khronos.egl.EGLConfig
import javax.microedition.khronos.opengles.GL10

import android.opengl.GLES20
import android.opengl.GLSurfaceView

class MyGLRenderer : GLSurfaceView.Renderer {

    override fun onSurfaceCreated(unused: GL10, config: EGLConfig) {
        // Set the background frame color
        GLES20.glClearColor(0.0f, 0.0f, 0.0f, 1.0f)
    }

    override fun onDrawFrame(unused: GL10) {
        // Redraw background color
        GLES20.glClear(GLES20.GL_COLOR_BUFFER_BIT)
    }

    override fun onSurfaceChanged(unused: GL10, width: Int, height: Int) {
        GLES20.glViewport(0, 0, width, height)
    }
}

import javax.microedition.khronos.egl.EGLConfig;
import javax.microedition.khronos.opengles.GL10;

import android.opengl.GLES20;
import android.opengl.GLSurfaceView;

public class MyGLRenderer implements GLSurfaceView.Renderer {

    public void onSurfaceCreated(GL10 unused, EGLConfig config) {
        // Set the background frame color
        GLES20.glClearColor(0.0f, 0.0f, 0.0f, 1.0f);
    }

    public void onDrawFrame(GL10 unused) {
        // Redraw background color
        GLES20.glClear(GLES20.GL_COLOR_BUFFER_BIT);
    }

    public void onSurfaceChanged(GL10 unused, int width, int height) {
        GLES20.glViewport(0, 0, width, height);
    }
}

Вот и все! В приведенных выше примерах кода создается простое приложение для Android, которое отображает черный экран с использованием OpenGL. Хотя этот код не делает ничего особенно интересного, создав эти классы, вы заложили основу, необходимую для рисования графических элементов с помощью OpenGL.

Примечание. Вы можете задаться вопросом, почему эти методы имеют параметр GL10 , когда вы используете API OpengGL ES 2.0. Эти сигнатуры методов просто повторно используются в API версии 2.0, чтобы упростить код платформы Android.

Если вы знакомы с API-интерфейсами OpenGL ES, теперь вы сможете настроить среду OpenGL ES в своем приложении и начать рисовать графику. Однако, если вам нужна дополнительная помощь для начала работы с OpenGL, перейдите к следующим урокам, чтобы получить еще несколько подсказок.