GLSurfaceView.java revision 6ae4da75422bbb31c3e0a09f616cdaee1d465946
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2008 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.opengl; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.Writer; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.ArrayList; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport javax.microedition.khronos.egl.EGL10; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport javax.microedition.khronos.egl.EGL11; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport javax.microedition.khronos.egl.EGLConfig; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport javax.microedition.khronos.egl.EGLContext; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport javax.microedition.khronos.egl.EGLDisplay; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport javax.microedition.khronos.egl.EGLSurface; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport javax.microedition.khronos.opengles.GL; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport javax.microedition.khronos.opengles.GL10; 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Context; 32c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevichimport android.content.pm.ConfigurationInfo; 33c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevichimport android.os.SystemProperties; 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.AttributeSet; 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.SurfaceHolder; 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.SurfaceView; 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * An implementation of SurfaceView that uses the dedicated surface for 41b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * displaying OpenGL rendering. 42b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 43b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * A GLSurfaceView provides the following features: 44b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 45b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <ul> 46b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>Manages a surface, which is a special piece of memory that can be 47b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * composited into the Android view system. 48b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>Manages an EGL display, which enables OpenGL to render into a surface. 49b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>Accepts a user-provided Renderer object that does the actual rendering. 50b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>Renders on a dedicated thread to decouple rendering performance from the 51b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * UI thread. 52b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>Supports both on-demand and continuous rendering. 53b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>Optionally wraps, traces, and/or error-checks the renderer's OpenGL calls. 54b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * </ul> 55b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * 56b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <h3>Using GLSurfaceView</h3> 57b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 58b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Typically you use GLSurfaceView by subclassing it and overriding one or more of the 59b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * View system input event methods. If your application does not need to override event 60b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * methods then GLSurfaceView can be used as-is. For the most part 61b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * GLSurfaceView behavior is customized by calling "set" methods rather than by subclassing. 62b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * For example, unlike a regular View, drawing is delegated to a separate Renderer object which 63b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * is registered with the GLSurfaceView 64b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * using the {@link #setRenderer(Renderer)} call. 65b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 66b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <h3>Initializing GLSurfaceView</h3> 67b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * All you have to do to initialize a GLSurfaceView is call {@link #setRenderer(Renderer)}. 68b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * However, if desired, you can modify the default behavior of GLSurfaceView by calling one or 69b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * more of these methods before calling setRenderer: 70b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <ul> 71b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #setDebugFlags(int)} 72b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #setEGLConfigChooser(boolean)} 73b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #setEGLConfigChooser(EGLConfigChooser)} 74b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #setEGLConfigChooser(int, int, int, int, int, int)} 75b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #setGLWrapper(GLWrapper)} 76b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * </ul> 77b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 78b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <h4>Choosing an EGL Configuration</h4> 79b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * A given Android device may support multiple possible types of drawing surfaces. 80b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * The available surfaces may differ in how may channels of data are present, as 81b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * well as how many bits are allocated to each channel. Therefore, the first thing 82b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * GLSurfaceView has to do when starting to render is choose what type of surface to use. 83b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 84b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * By default GLSurfaceView chooses an available surface that's closest to a 16-bit R5G6B5 surface 85b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * with a 16-bit depth buffer and no stencil. If you would prefer a different surface (for example, 86b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * if you do not need a depth buffer) you can override the default behavior by calling one of the 87b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * setEGLConfigChooser methods. 88b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 89b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <h4>Debug Behavior</h4> 90b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * You can optionally modify the behavior of GLSurfaceView by calling 91b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * one or more of the debugging methods {@link #setDebugFlags(int)}, 92b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * and {@link #setGLWrapper}. These methods may be called before and/or after setRenderer, but 93b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * typically they are called before setRenderer so that they take effect immediately. 94b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 95b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <h4>Setting a Renderer</h4> 96b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Finally, you must call {@link #setRenderer} to register a {@link Renderer}. 97b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * The renderer is 98b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * responsible for doing the actual OpenGL rendering. 99b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 100b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <h3>Rendering Mode</h3> 101b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Once the renderer is set, you can control whether the renderer draws 102b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * continuously or on-demand by calling 103b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * {@link #setRenderMode}. The default is continuous rendering. 104b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 105b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <h3>Activity Life-cycle</h3> 106b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * A GLSurfaceView must be notified when the activity is paused and resumed. GLSurfaceView clients 107b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * are required to call {@link #onPause()} when the activity pauses and 108b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * {@link #onResume()} when the activity resumes. These calls allow GLSurfaceView to 109b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * pause and resume the rendering thread, and also allow GLSurfaceView to release and recreate 110b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * the OpenGL display. 111b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 112b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <h3>Handling events</h3> 113b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 114b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * To handle an event you will typically subclass GLSurfaceView and override the 115b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * appropriate method, just as you would with any other View. However, when handling 116b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * the event, you may need to communicate with the Renderer object 117b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * that's running in the rendering thread. You can do this using any 118b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * standard Java cross-thread communication mechanism. In addition, 119b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * one relatively easy way to communicate with your renderer is 120b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * to call 121b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * {@link #queueEvent(Runnable)}. For example: 122b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <pre class="prettyprint"> 123b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * class MyGLSurfaceView extends GLSurfaceView { 124b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * 125b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * private MyRenderer mMyRenderer; 126b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * 127b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * public void start() { 128b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * mMyRenderer = ...; 129b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * setRenderer(mMyRenderer); 130b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * } 131b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * 132b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * public boolean onKeyDown(int keyCode, KeyEvent event) { 133b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * if (keyCode == KeyEvent.KEYCODE_DPAD_CENTER) { 134b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * queueEvent(new Runnable() { 135b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * // This method will be called on the rendering 136b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * // thread: 137b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * public void run() { 138b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * mMyRenderer.handleDpadCenter(); 139b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * }}); 140b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * return true; 141b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * } 142b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * return super.onKeyDown(keyCode, event); 143b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * } 144b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * } 145b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * </pre> 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class GLSurfaceView extends SurfaceView implements SurfaceHolder.Callback { 1498b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich private final static boolean LOG_THREADS = false; 150a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich private final static boolean LOG_SURFACE = false; 151a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich private final static boolean LOG_RENDERER = false; 152a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich // Work-around for bug 2263168 153a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich private final static boolean DRAW_TWICE_AFTER_SIZE_CHANGED = true; 154b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 155b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * The renderer only renders 156b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * when the surface is created, or when {@link #requestRender} is called. 157b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * 158b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #getRenderMode() 159b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #setRenderMode(int) 160b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int RENDERMODE_WHEN_DIRTY = 0; 162b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 163b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * The renderer is called 164b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * continuously to re-render the scene. 165b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * 166b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #getRenderMode() 167b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #setRenderMode(int) 168b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #requestRender() 169b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 1703e832dbe966c2ca0fde2f4bd87ad9c974a93a7cfJack Palevich public final static int RENDERMODE_CONTINUOUSLY = 1; 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 173b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Check glError() after every GL call and throw an exception if glError indicates 174b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * that an error has occurred. This can be used to help track down which OpenGL ES call 175b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * is causing an error. 176b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * 177b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #getDebugFlags 178b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #setDebugFlags 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int DEBUG_CHECK_GL_ERROR = 1; 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Log GL calls to the system log at "verbose" level with tag "GLSurfaceView". 184b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * 185b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #getDebugFlags 186b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #setDebugFlags 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int DEBUG_LOG_GL_CALLS = 2; 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 190b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 191b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Standard View constructor. In order to render something, you 192b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * must call {@link #setRenderer} to register a renderer. 193b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public GLSurfaceView(Context context) { 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(context); 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project init(); 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 200b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Standard View constructor. In order to render something, you 201b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * must call {@link #setRenderer} to register a renderer. 202b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public GLSurfaceView(Context context, AttributeSet attrs) { 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(context, attrs); 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project init(); 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void init() { 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Install a SurfaceHolder.Callback so we get notified when the 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // underlying surface is created and destroyed 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project SurfaceHolder holder = getHolder(); 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project holder.addCallback(this); 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 216b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Set the glWrapper. If the glWrapper is not null, its 217b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * {@link GLWrapper#wrap(GL)} method is called 218b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * whenever a surface is created. A GLWrapper can be used to wrap 219b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * the GL object that's passed to the renderer. Wrapping a GL 220b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * object enables examining and modifying the behavior of the 221b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * GL calls made by the renderer. 222b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 223b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Wrapping is typically used for debugging purposes. 224b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 225b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * The default value is null. 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param glWrapper the new GLWrapper 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setGLWrapper(GLWrapper glWrapper) { 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLWrapper = glWrapper; 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 233b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Set the debug flags to a new value. The value is 234b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * constructed by OR-together zero or more 235b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * of the DEBUG_CHECK_* constants. The debug flags take effect 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * whenever a surface is created. The default value is zero. 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param debugFlags the new debug flags 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #DEBUG_CHECK_GL_ERROR 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #DEBUG_LOG_GL_CALLS 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setDebugFlags(int debugFlags) { 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDebugFlags = debugFlags; 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 245b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 246b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Get the current value of the debug flags. 247b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @return the current value of the debug flags. 248b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getDebugFlags() { 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mDebugFlags; 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 254b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Set the renderer associated with this view. Also starts the thread that 255b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * will call the renderer, which in turn causes the rendering to start. 256b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p>This method should be called once and only once in the life-cycle of 257b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * a GLSurfaceView. 258b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p>The following GLSurfaceView methods can only be called <em>before</em> 259b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * setRenderer is called: 260b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <ul> 261b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #setEGLConfigChooser(boolean)} 262b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #setEGLConfigChooser(EGLConfigChooser)} 263b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #setEGLConfigChooser(int, int, int, int, int, int)} 264b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * </ul> 265b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 266b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * The following GLSurfaceView methods can only be called <em>after</em> 267b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * setRenderer is called: 268b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <ul> 269b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #getRenderMode()} 270b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #onPause()} 271b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #onResume()} 272b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #queueEvent(Runnable)} 273b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #requestRender()} 274b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #setRenderMode(int)} 275b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * </ul> 276b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * 277b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @param renderer the renderer to use to perform OpenGL drawing. 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setRenderer(Renderer renderer) { 28015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich checkRenderThreadState(); 281a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich if (mEGLConfigChooser == null) { 282a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mEGLConfigChooser = new SimpleEGLConfigChooser(true); 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 28415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich if (mEGLContextFactory == null) { 28515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mEGLContextFactory = new DefaultContextFactory(); 28615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 28715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich if (mEGLWindowSurfaceFactory == null) { 28815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mEGLWindowSurfaceFactory = new DefaultWindowSurfaceFactory(); 28915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread = new GLThread(renderer); 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread.start(); 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 29515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * Install a custom EGLContextFactory. 29615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * <p>If this method is 29715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * called, it must be called before {@link #setRenderer(Renderer)} 29815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * is called. 29915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * <p> 30015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * If this method is not called, then by default 30115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * a context will be created with no shared context and 30215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * with a null attribute list. 30315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich */ 304a8fecb87c5eaaefc9ca6272e3b59ef88d293dd6dJack Palevich public void setEGLContextFactory(EGLContextFactory factory) { 30515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich checkRenderThreadState(); 30615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mEGLContextFactory = factory; 30715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 30815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 30915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich /** 31015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * Install a custom EGLWindowSurfaceFactory. 31115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * <p>If this method is 31215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * called, it must be called before {@link #setRenderer(Renderer)} 31315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * is called. 31415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * <p> 31515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * If this method is not called, then by default 31615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * a window surface will be created with a null attribute list. 31715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich */ 318a8fecb87c5eaaefc9ca6272e3b59ef88d293dd6dJack Palevich public void setEGLWindowSurfaceFactory(EGLWindowSurfaceFactory factory) { 31915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich checkRenderThreadState(); 32015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mEGLWindowSurfaceFactory = factory; 32115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 32215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 32315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich /** 324b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Install a custom EGLConfigChooser. 325b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p>If this method is 326b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * called, it must be called before {@link #setRenderer(Renderer)} 327a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * is called. 328a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * <p> 329b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * If no setEGLConfigChooser method is called, then by default the 330b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * view will choose a config as close to 16-bit RGB as possible, with 331b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * a depth buffer as close to 16 bits as possible. 332a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * @param configChooser 333a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich */ 334a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich public void setEGLConfigChooser(EGLConfigChooser configChooser) { 33515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich checkRenderThreadState(); 336a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mEGLConfigChooser = configChooser; 337a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 338a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 339a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich /** 340b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Install a config chooser which will choose a config 341a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * as close to 16-bit RGB as possible, with or without an optional depth 342a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * buffer as close to 16-bits as possible. 343b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p>If this method is 344b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * called, it must be called before {@link #setRenderer(Renderer)} 345b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * is called. 346a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * <p> 347b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * If no setEGLConfigChooser method is called, then by default the 348a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * view will choose a config as close to 16-bit RGB as possible, with 349b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * a depth buffer as close to 16 bits as possible. 350a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * 351a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * @param needDepth 352a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich */ 353a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich public void setEGLConfigChooser(boolean needDepth) { 354a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich setEGLConfigChooser(new SimpleEGLConfigChooser(needDepth)); 355a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 356a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 357a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich /** 358b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Install a config chooser which will choose a config 359b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * with at least the specified component sizes, and as close 360b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * to the specified component sizes as possible. 361b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p>If this method is 362a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * called, it must be called before {@link #setRenderer(Renderer)} 363a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * is called. 364a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * <p> 365b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * If no setEGLConfigChooser method is called, then by default the 366b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * view will choose a config as close to 16-bit RGB as possible, with 367b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * a depth buffer as close to 16 bits as possible. 368a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * 369a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich */ 370a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich public void setEGLConfigChooser(int redSize, int greenSize, int blueSize, 371a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich int alphaSize, int depthSize, int stencilSize) { 372a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich setEGLConfigChooser(new ComponentSizeChooser(redSize, greenSize, 373a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich blueSize, alphaSize, depthSize, stencilSize)); 374a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 3756ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich 3766ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich /** 3776ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * Inform the default EGLContextFactory and default EGLConfigChooser 3786ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * which EGLContext client version to pick. 3796ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * <p>Use this method to create an OpenGL ES 2.0-compatible context. 3806ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * Example: 3816ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * <pre class="prettyprint"> 3826ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * public MyView(Context context) { 3836ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * super(context); 3846ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * setEGLContextClientVersion(2); // Pick an OpenGL ES 2.0 context. 3856ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * setRenderer(new MyRenderer()); 3866ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * } 3876ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * </pre> 3886ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * <p>Note: Activities which require OpenGL ES 2.0 should indicate this by 3896ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * setting @lt;uses-feature android:glEsVersion="0x00020000" /> in the activity's 3906ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * AndroidManifest.xml file. 3916ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * <p>If this method is called, it must be called before {@link #setRenderer(Renderer)} 3926ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * is called. 3936ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * <p>This method only affects the behavior of the default EGLContexFactory and the 3946ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * default EGLConfigChooser. If 3956ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * {@link #setEGLContextFactory(EGLContextFactory)} has been called, then the supplied 3966ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * EGLContextFactory is responsible for creating an OpenGL ES 2.0-compatible context. 3976ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * If 3986ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * {@link #setEGLConfigChooser(EGLConfigChooser)} has been called, then the supplied 3996ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * EGLConfigChooser is responsible for choosing an OpenGL ES 2.0-compatible config. 4006ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * @param version The EGLContext client version to choose. Use 2 for OpenGL ES 2.0 4016ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * @hide 4026ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich */ 4036ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich public void setEGLContextClientVersion(int version) { 4046ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich checkRenderThreadState(); 4056ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich mEGLContextClientVersion = version; 4066ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich } 4076ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich 408a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich /** 409b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Set the rendering mode. When renderMode is 4103e832dbe966c2ca0fde2f4bd87ad9c974a93a7cfJack Palevich * RENDERMODE_CONTINUOUSLY, the renderer is called 411b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * repeatedly to re-render the scene. When renderMode 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is RENDERMODE_WHEN_DIRTY, the renderer only rendered when the surface 4133e832dbe966c2ca0fde2f4bd87ad9c974a93a7cfJack Palevich * is created, or when {@link #requestRender} is called. Defaults to RENDERMODE_CONTINUOUSLY. 414b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 415b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Using RENDERMODE_WHEN_DIRTY can improve battery life and overall system performance 416b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * by allowing the GPU and CPU to idle when the view does not need to be updated. 417b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 418b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * This method can only be called after {@link #setRenderer(Renderer)} 419b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param renderMode one of the RENDERMODE_X constants 4213e832dbe966c2ca0fde2f4bd87ad9c974a93a7cfJack Palevich * @see #RENDERMODE_CONTINUOUSLY 422b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #RENDERMODE_WHEN_DIRTY 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setRenderMode(int renderMode) { 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread.setRenderMode(renderMode); 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get the current rendering mode. May be called 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from any thread. Must not be called before a renderer has been set. 431b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @return the current rendering mode. 4323e832dbe966c2ca0fde2f4bd87ad9c974a93a7cfJack Palevich * @see #RENDERMODE_CONTINUOUSLY 433b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #RENDERMODE_WHEN_DIRTY 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getRenderMode() { 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mGLThread.getRenderMode(); 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 440b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Request that the renderer render a frame. 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method is typically used when the render mode has been set to 442b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * {@link #RENDERMODE_WHEN_DIRTY}, so that frames are only rendered on demand. 443b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * May be called 444b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * from any thread. Must not be called before a renderer has been set. 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void requestRender() { 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread.requestRender(); 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 450b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 451b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * This method is part of the SurfaceHolder.Callback interface, and is 452b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * not normally called or subclassed by clients of GLSurfaceView. 453b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void surfaceCreated(SurfaceHolder holder) { 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread.surfaceCreated(); 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 458b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 459b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * This method is part of the SurfaceHolder.Callback interface, and is 460b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * not normally called or subclassed by clients of GLSurfaceView. 461b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void surfaceDestroyed(SurfaceHolder holder) { 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Surface will be destroyed when we return 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread.surfaceDestroyed(); 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 467b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 468b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * This method is part of the SurfaceHolder.Callback interface, and is 469b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * not normally called or subclassed by clients of GLSurfaceView. 470b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void surfaceChanged(SurfaceHolder holder, int format, int w, int h) { 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread.onWindowResize(w, h); 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Inform the view that the activity is paused. The owner of this view must 477b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * call this method when the activity is paused. Calling this method will 478b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * pause the rendering thread. 479b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Must not be called before a renderer has been set. 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onPause() { 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread.onPause(); 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Inform the view that the activity is resumed. The owner of this view must 487b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * call this method when the activity is resumed. Calling this method will 488b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * recreate the OpenGL display and resume the rendering 489b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * thread. 490b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Must not be called before a renderer has been set. 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onResume() { 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread.onResume(); 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 497b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Queue a runnable to be run on the GL rendering thread. This can be used 498b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * to communicate with the Renderer on the rendering thread. 499b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Must not be called before a renderer has been set. 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r the runnable to be run on the GL rendering thread. 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void queueEvent(Runnable r) { 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread.queueEvent(r); 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 506b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 507b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * This method is used as part of the View class and is not normally 508b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * called or subclassed by clients of GLSurfaceView. 509b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Must not be called before a renderer has been set. 510b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onDetachedFromWindow() { 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onDetachedFromWindow(); 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread.requestExitAndWait(); 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // ---------------------------------------------------------------------- 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 519b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 520b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * An interface used to wrap a GL interface. 521b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p>Typically 522b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * used for implementing debugging and tracing on top of the default 523b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * GL interface. You would typically use this by creating your own class 524b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * that implemented all the GL methods by delegating to another GL instance. 525b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Then you could add your own behavior before or after calling the 526b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * delegate. All the GLWrapper would do was instantiate and return the 527b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * wrapper GL instance: 528b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <pre class="prettyprint"> 529b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * class MyGLWrapper implements GLWrapper { 530b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * GL wrap(GL gl) { 531b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * return new MyGLImplementation(gl); 532b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * } 533b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * static class MyGLImplementation implements GL,GL10,GL11,... { 534b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * ... 535b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * } 536b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * } 537b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * </pre> 538b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #setGLWrapper(GLWrapper) 539b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface GLWrapper { 541b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 542b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Wraps a gl interface in another gl interface. 543b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @param gl a GL interface that is to be wrapped. 544b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @return either the input argument or another GL object that wraps the input argument. 545b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 546b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich GL wrap(GL gl); 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A generic renderer interface. 551b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 552b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * The renderer is responsible for making OpenGL calls to render a frame. 553b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 554b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * GLSurfaceView clients typically create their own classes that implement 555b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * this interface, and then call {@link GLSurfaceView#setRenderer} to 556b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * register the renderer with the GLSurfaceView. 557b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 558b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <h3>Threading</h3> 559b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * The renderer will be called on a separate thread, so that rendering 560b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * performance is decoupled from the UI thread. Clients typically need to 561b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * communicate with the renderer from the UI thread, because that's where 562b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * input events are received. Clients can communicate using any of the 563b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * standard Java techniques for cross-thread communication, or they can 564b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * use the {@link GLSurfaceView#queueEvent(Runnable)} convenience method. 565b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 566b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <h3>EGL Context Lost</h3> 567b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * There are situations where the EGL rendering context will be lost. This 568b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * typically happens when device wakes up after going to sleep. When 569b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * the EGL context is lost, all OpenGL resources (such as textures) that are 570b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * associated with that context will be automatically deleted. In order to 571b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * keep rendering correctly, a renderer must recreate any lost resources 572b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * that it still needs. The {@link #onSurfaceCreated(GL10, EGLConfig)} method 573b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * is a convenient place to do this. 574b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * 575b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * 576b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #setRenderer(Renderer) 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface Renderer { 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 580b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Called when the surface is created or recreated. 581b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 582b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Called when the rendering thread 583b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * starts and whenever the EGL context is lost. The context will typically 584b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * be lost when the Android device awakes after going to sleep. 585b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 586b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Since this method is called at the beginning of rendering, as well as 587b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * every time the EGL context is lost, this method is a convenient place to put 588b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * code to create resources that need to be created when the rendering 589b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * starts, and that need to be recreated when the EGL context is lost. 590b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Textures are an example of a resource that you might want to create 591b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * here. 592b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 593b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Note that when the EGL context is lost, all OpenGL resources associated 594b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * with that context will be automatically deleted. You do not need to call 595b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * the corresponding "glDelete" methods such as glDeleteTextures to 596b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * manually delete these lost resources. 597b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gl the GL interface. Use <code>instanceof</code> to 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * test if the interface supports GL11 or higher interfaces. 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config the EGLConfig of the created surface. Can be used 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to create matching pbuffers. 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onSurfaceCreated(GL10 gl, EGLConfig config); 604b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 606b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Called when the surface changed size. 607b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called after the surface is created and whenever 609b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * the OpenGL ES surface size changes. 610b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 611b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Typically you will set your viewport here. If your camera 612b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * is fixed then you could also set your projection matrix here: 613b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <pre class="prettyprint"> 614b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * void onSurfaceChanged(GL10 gl, int width, int height) { 615b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * gl.glViewport(0, 0, width, height); 616b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * // for a fixed camera, set the projection too 617b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * float ratio = (float) width / height; 618b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * gl.glMatrixMode(GL10.GL_PROJECTION); 619b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * gl.glLoadIdentity(); 620b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * gl.glFrustumf(-ratio, ratio, -1, 1, 1, 10); 621b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * } 622b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * </pre> 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gl the GL interface. Use <code>instanceof</code> to 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * test if the interface supports GL11 or higher interfaces. 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onSurfaceChanged(GL10 gl, int width, int height); 629b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 631b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Called to draw the current frame. 632b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 633b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * This method is responsible for drawing the current frame. 634b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 635b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * The implementation of this method typically looks like this: 636b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <pre class="prettyprint"> 637b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * void onDrawFrame(GL10 gl) { 638b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * gl.glClear(GL10.GL_COLOR_BUFFER_BIT | GL10.GL_DEPTH_BUFFER_BIT); 639b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * //... other gl calls to render the scene ... 640b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * } 641b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * </pre> 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gl the GL interface. Use <code>instanceof</code> to 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * test if the interface supports GL11 or higher interfaces. 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onDrawFrame(GL10 gl); 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 64915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * An interface for customizing the eglCreateContext and eglDestroyContext calls. 65015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * <p> 65115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * This interface must be implemented by clients wishing to call 65215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * {@link GLSurfaceView#setEGLContextFactory(EGLContextFactory)} 65315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich */ 65415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich public interface EGLContextFactory { 65515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich EGLContext createContext(EGL10 egl, EGLDisplay display, EGLConfig eglConfig); 65615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich void destroyContext(EGL10 egl, EGLDisplay display, EGLContext context); 65715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 65815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 6596ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich private class DefaultContextFactory implements EGLContextFactory { 6606ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich private int EGL_CONTEXT_CLIENT_VERSION = 0x3098; 66115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 66215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich public EGLContext createContext(EGL10 egl, EGLDisplay display, EGLConfig config) { 6636ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich int[] attrib_list = {EGL_CONTEXT_CLIENT_VERSION, mEGLContextClientVersion, 6646ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich EGL10.EGL_NONE }; 6656ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich 6666ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich return egl.eglCreateContext(display, config, EGL10.EGL_NO_CONTEXT, 6676ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich mEGLContextClientVersion != 0 ? attrib_list : null); 66815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 66915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 67015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich public void destroyContext(EGL10 egl, EGLDisplay display, 67115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich EGLContext context) { 67215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich egl.eglDestroyContext(display, context); 67315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 67415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 67515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 67615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich /** 67715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * An interface for customizing the eglCreateWindowSurface and eglDestroySurface calls. 67815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * <p> 67915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * This interface must be implemented by clients wishing to call 680d40dfbbbff81219258ca36b762a89ff503154345Jack Palevich * {@link GLSurfaceView#setEGLWindowSurfaceFactory(EGLWindowSurfaceFactory)} 68115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich */ 68215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich public interface EGLWindowSurfaceFactory { 68315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich EGLSurface createWindowSurface(EGL10 egl, EGLDisplay display, EGLConfig config, 68415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich Object nativeWindow); 68515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich void destroySurface(EGL10 egl, EGLDisplay display, EGLSurface surface); 68615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 68715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 68815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich private static class DefaultWindowSurfaceFactory implements EGLWindowSurfaceFactory { 68915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 69015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich public EGLSurface createWindowSurface(EGL10 egl, EGLDisplay display, 69115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich EGLConfig config, Object nativeWindow) { 69215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich return egl.eglCreateWindowSurface(display, config, nativeWindow, null); 69315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 69415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 69515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich public void destroySurface(EGL10 egl, EGLDisplay display, 69615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich EGLSurface surface) { 69715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich egl.eglDestroySurface(display, surface); 69815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 69915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 70015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 70115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich /** 702b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * An interface for choosing an EGLConfig configuration from a list of 703a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * potential configurations. 704b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 705b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * This interface must be implemented by clients wishing to call 706b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * {@link GLSurfaceView#setEGLConfigChooser(EGLConfigChooser)} 707a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich */ 708a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich public interface EGLConfigChooser { 709a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich /** 710a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * Choose a configuration from the list. Implementors typically 711a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * implement this method by calling 712b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * {@link EGL10#eglChooseConfig} and iterating through the results. Please consult the 713b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * EGL specification available from The Khronos Group to learn how to call eglChooseConfig. 714a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * @param egl the EGL10 for the current display. 715a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * @param display the current display. 716a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * @return the chosen configuration. 717a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich */ 718a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGLConfig chooseConfig(EGL10 egl, EGLDisplay display); 719a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 720a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 7216ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich private abstract class BaseConfigChooser 722a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich implements EGLConfigChooser { 723a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich public BaseConfigChooser(int[] configSpec) { 7246ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich mConfigSpec = filterConfigSpec(configSpec); 725a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 7266ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich 727a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich public EGLConfig chooseConfig(EGL10 egl, EGLDisplay display) { 728a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich int[] num_config = new int[1]; 72928023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich if (!egl.eglChooseConfig(display, mConfigSpec, null, 0, 73028023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich num_config)) { 73128023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich throw new IllegalArgumentException("eglChooseConfig failed"); 73228023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich } 733a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 734a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich int numConfigs = num_config[0]; 735a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 736a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich if (numConfigs <= 0) { 737a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich throw new IllegalArgumentException( 738a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich "No configs match configSpec"); 739a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 740a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 741a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGLConfig[] configs = new EGLConfig[numConfigs]; 74228023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich if (!egl.eglChooseConfig(display, mConfigSpec, configs, numConfigs, 74328023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich num_config)) { 74428023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich throw new IllegalArgumentException("eglChooseConfig#2 failed"); 74528023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich } 746a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGLConfig config = chooseConfig(egl, display, configs); 747a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich if (config == null) { 748a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich throw new IllegalArgumentException("No config chosen"); 749a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 750a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich return config; 751a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 752a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 753a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich abstract EGLConfig chooseConfig(EGL10 egl, EGLDisplay display, 754a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGLConfig[] configs); 755a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 756a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich protected int[] mConfigSpec; 7576ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich 7586ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich private int[] filterConfigSpec(int[] configSpec) { 7596ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich if (mEGLContextClientVersion != 2) { 7606ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich return configSpec; 7616ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich } 7626ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich /* We know none of the subclasses define EGL_RENDERABLE_TYPE. 7636ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich * And we know the configSpec is well formed. 7646ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich */ 7656ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich int len = configSpec.length; 7666ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich int[] newConfigSpec = new int[len + 2]; 7676ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich System.arraycopy(configSpec, 0, newConfigSpec, 0, len-1); 7686ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich newConfigSpec[len-1] = EGL10.EGL_RENDERABLE_TYPE; 7696ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich newConfigSpec[len] = 4; /* EGL_OPENGL_ES2_BIT */ 7706ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich newConfigSpec[len+1] = EGL10.EGL_NONE; 7716ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich return newConfigSpec; 7726ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich } 773a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 774a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 7756ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich private class ComponentSizeChooser extends BaseConfigChooser { 776a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich public ComponentSizeChooser(int redSize, int greenSize, int blueSize, 777a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich int alphaSize, int depthSize, int stencilSize) { 778a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich super(new int[] { 779a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGL10.EGL_RED_SIZE, redSize, 780a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGL10.EGL_GREEN_SIZE, greenSize, 781a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGL10.EGL_BLUE_SIZE, blueSize, 782a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGL10.EGL_ALPHA_SIZE, alphaSize, 783a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGL10.EGL_DEPTH_SIZE, depthSize, 784a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGL10.EGL_STENCIL_SIZE, stencilSize, 785a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGL10.EGL_NONE}); 786a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mValue = new int[1]; 787a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mRedSize = redSize; 788a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mGreenSize = greenSize; 789a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mBlueSize = blueSize; 790a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mAlphaSize = alphaSize; 791a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mDepthSize = depthSize; 792a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mStencilSize = stencilSize; 793a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 794a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 795a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich @Override 796a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich public EGLConfig chooseConfig(EGL10 egl, EGLDisplay display, 797a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGLConfig[] configs) { 798a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGLConfig closestConfig = null; 799a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich int closestDistance = 1000; 800a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich for(EGLConfig config : configs) { 801a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich int d = findConfigAttrib(egl, display, config, 802a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGL10.EGL_DEPTH_SIZE, 0); 803a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich int s = findConfigAttrib(egl, display, config, 804a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGL10.EGL_STENCIL_SIZE, 0); 80582fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian if (d >= mDepthSize && s>= mStencilSize) { 80682fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian int r = findConfigAttrib(egl, display, config, 80782fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian EGL10.EGL_RED_SIZE, 0); 80882fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian int g = findConfigAttrib(egl, display, config, 80982fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian EGL10.EGL_GREEN_SIZE, 0); 81082fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian int b = findConfigAttrib(egl, display, config, 81182fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian EGL10.EGL_BLUE_SIZE, 0); 81282fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian int a = findConfigAttrib(egl, display, config, 81382fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian EGL10.EGL_ALPHA_SIZE, 0); 81482fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian int distance = Math.abs(r - mRedSize) 81582fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian + Math.abs(g - mGreenSize) 81682fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian + Math.abs(b - mBlueSize) 81782fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian + Math.abs(a - mAlphaSize); 81882fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian if (distance < closestDistance) { 81982fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian closestDistance = distance; 82082fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian closestConfig = config; 82182fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian } 822a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 823a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 824a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich return closestConfig; 825a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 826a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 827a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich private int findConfigAttrib(EGL10 egl, EGLDisplay display, 828a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGLConfig config, int attribute, int defaultValue) { 829a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 830a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich if (egl.eglGetConfigAttrib(display, config, attribute, mValue)) { 831a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich return mValue[0]; 832a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 833a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich return defaultValue; 834a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 835a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 836a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich private int[] mValue; 837a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich // Subclasses can adjust these values: 838a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich protected int mRedSize; 839a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich protected int mGreenSize; 840a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich protected int mBlueSize; 841a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich protected int mAlphaSize; 842a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich protected int mDepthSize; 843a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich protected int mStencilSize; 844a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 845a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 846a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich /** 847a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * This class will choose a supported surface as close to 848a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * RGB565 as possible, with or without a depth buffer. 849a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * 850a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich */ 8516ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich private class SimpleEGLConfigChooser extends ComponentSizeChooser { 852a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich public SimpleEGLConfigChooser(boolean withDepthBuffer) { 853a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich super(4, 4, 4, 0, withDepthBuffer ? 16 : 0, 0); 854a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich // Adjust target values. This way we'll accept a 4444 or 855a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich // 555 buffer if there's no 565 buffer available. 856a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mRedSize = 5; 857a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mGreenSize = 6; 858a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mBlueSize = 5; 859a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 860a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 861a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 862a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich /** 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * An EGL helper class. 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private class EglHelper { 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public EglHelper() { 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Initialize EGL for a given configuration spec. 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param configSpec 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 875a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich public void start(){ 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get an EGL instance 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEgl = (EGL10) EGLContext.getEGL(); 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get to the default display. 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEglDisplay = mEgl.eglGetDisplay(EGL10.EGL_DEFAULT_DISPLAY); 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 88628023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich if (mEglDisplay == EGL10.EGL_NO_DISPLAY) { 88728023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich throw new RuntimeException("eglGetDisplay failed"); 88828023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich } 88928023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * We can now initialize EGL for that display 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] version = new int[2]; 89428023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich if(!mEgl.eglInitialize(mEglDisplay, version)) { 89528023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich throw new RuntimeException("eglInitialize failed"); 89628023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich } 897a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mEglConfig = mEGLConfigChooser.chooseConfig(mEgl, mEglDisplay); 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Create an OpenGL ES context. This must be done only once, an 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * OpenGL context is a somewhat heavy object. 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 90315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mEglContext = mEGLContextFactory.createContext(mEgl, mEglDisplay, mEglConfig); 9042e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich if (mEglContext == null || mEglContext == EGL10.EGL_NO_CONTEXT) { 9052e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich throw new RuntimeException("createContext failed"); 9062e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich } 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEglSurface = null; 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * React to the creation of a new surface by creating and returning an 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * OpenGL interface that renders to that surface. 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public GL createSurface(SurfaceHolder holder) { 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The window size has changed, so we need to create a new 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * surface. 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9202e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich if (mEglSurface != null && mEglSurface != EGL10.EGL_NO_SURFACE) { 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unbind and destroy the old EGL surface, if 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * there is one. 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEgl.eglMakeCurrent(mEglDisplay, EGL10.EGL_NO_SURFACE, 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EGL10.EGL_NO_SURFACE, EGL10.EGL_NO_CONTEXT); 92815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mEGLWindowSurfaceFactory.destroySurface(mEgl, mEglDisplay, mEglSurface); 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Create an EGL surface we can render into. 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 93415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mEglSurface = mEGLWindowSurfaceFactory.createWindowSurface(mEgl, 93515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mEglDisplay, mEglConfig, holder); 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9372e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich if (mEglSurface == null || mEglSurface == EGL10.EGL_NO_SURFACE) { 9382e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich throw new RuntimeException("createWindowSurface failed"); 9392e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich } 9402e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Before we can issue GL commands, we need to make sure 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the context is current and bound to a surface. 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9452e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich if (!mEgl.eglMakeCurrent(mEglDisplay, mEglSurface, mEglSurface, mEglContext)) { 9462e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich throw new RuntimeException("eglMakeCurrent failed."); 9472e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich } 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project GL gl = mEglContext.getGL(); 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mGLWrapper != null) { 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project gl = mGLWrapper.wrap(gl); 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 954a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if ((mDebugFlags & (DEBUG_CHECK_GL_ERROR | DEBUG_LOG_GL_CALLS)) != 0) { 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int configFlags = 0; 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Writer log = null; 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((mDebugFlags & DEBUG_CHECK_GL_ERROR) != 0) { 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project configFlags |= GLDebugHelper.CONFIG_CHECK_GL_ERROR; 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((mDebugFlags & DEBUG_LOG_GL_CALLS) != 0) { 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project log = new LogWriter(); 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project gl = GLDebugHelper.wrap(gl, configFlags, log); 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return gl; 9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Display the current render surface. 9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return false if the context has been lost. 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean swap() { 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEgl.eglSwapBuffers(mEglDisplay, mEglSurface); 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Always check for EGL_CONTEXT_LOST, which means the context 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and all associated data were lost (For instance because 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the device went to sleep). We need to sleep until we 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * get a new surface. 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mEgl.eglGetError() != EGL11.EGL_CONTEXT_LOST; 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9841bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich public void destroySurface() { 9852e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich if (mEglSurface != null && mEglSurface != EGL10.EGL_NO_SURFACE) { 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEgl.eglMakeCurrent(mEglDisplay, EGL10.EGL_NO_SURFACE, 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EGL10.EGL_NO_SURFACE, 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EGL10.EGL_NO_CONTEXT); 98915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mEGLWindowSurfaceFactory.destroySurface(mEgl, mEglDisplay, mEglSurface); 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEglSurface = null; 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9921bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich } 9931bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich 9941bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich public void finish() { 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mEglContext != null) { 99615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mEGLContextFactory.destroyContext(mEgl, mEglDisplay, mEglContext); 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEglContext = null; 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mEglDisplay != null) { 10009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEgl.eglTerminate(mEglDisplay); 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEglDisplay = null; 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EGL10 mEgl; 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EGLDisplay mEglDisplay; 10079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EGLSurface mEglSurface; 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EGLConfig mEglConfig; 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EGLContext mEglContext; 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A generic GL Thread. Takes care of initializing EGL and GL. Delegates 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to a Renderer instance to do the actual drawing. Can be configured to 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * render continuously or on request. 10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 101767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich * All potentially blocking synchronization is done through the 101867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich * sGLThreadManager object. This avoids multiple-lock ordering issues. 101967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich * 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project class GLThread extends Thread { 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project GLThread(Renderer renderer) { 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(); 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWidth = 0; 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeight = 0; 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRequestRender = true; 10273e832dbe966c2ca0fde2f4bd87ad9c974a93a7cfJack Palevich mRenderMode = RENDERMODE_CONTINUOUSLY; 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRenderer = renderer; 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void run() { 10338b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich setName("GLThread " + getId()); 10348b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich if (LOG_THREADS) { 10358b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich Log.i("GLThread", "starting tid=" + getId()); 10368b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich } 10378b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project guardedRun(); 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (InterruptedException e) { 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // fall thru and exit normally 10429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } finally { 104367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.threadExiting(this); 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 104767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich /* 104867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich * This private method should only be called inside a 104967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich * synchronized(sGLThreadManager) block. 105067dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich */ 105167dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich private void stopEglLocked() { 105232d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich if (mHaveEgl) { 105332d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich mHaveEgl = false; 105432d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich mEglHelper.destroySurface(); 105532d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich mEglHelper.finish(); 1056a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich sGLThreadManager.releaseEglSurfaceLocked(this); 105732d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich } 105832d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich } 105932d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich 10609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void guardedRun() throws InterruptedException { 10619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEglHelper = new EglHelper(); 106215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich try { 106315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich GL10 gl = null; 1064a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich boolean createEglSurface = false; 1065a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich boolean sizeChanged = false; 1066a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich int w = 0; 1067a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich int h = 0; 1068a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich Runnable event = null; 106967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich 1070a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich while (true) { 107167dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized (sGLThreadManager) { 107267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich while (true) { 1073a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if (mShouldExit) { 1074a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich return; 1075a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich } 1076a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich 1077a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if (! mEventQueue.isEmpty()) { 1078a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich event = mEventQueue.remove(0); 1079a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich break; 1080a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich } 1081a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich 1082a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich // Do we need to release the EGL surface? 1083a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if (mHaveEgl && mPaused) { 1084a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if (LOG_SURFACE) { 1085a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich Log.i("GLThread", "releasing EGL surface because paused tid=" + getId()); 1086a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich } 108767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich stopEglLocked(); 108867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich } 1089a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich 1090a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich // Have we lost the surface view surface? 1091a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if ((! mHasSurface) && (! mWaitingForSurface)) { 1092a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if (LOG_SURFACE) { 1093a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich Log.i("GLThread", "noticed surfaceView surface lost tid=" + getId()); 109415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 1095a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if (mHaveEgl) { 1096a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich stopEglLocked(); 109732d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich } 1098a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich mWaitingForSurface = true; 1099a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich sGLThreadManager.notifyAll(); 110032d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich } 110167dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich 1102a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich // Have we acquired the surface view surface? 1103a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if (mHasSurface && mWaitingForSurface) { 1104a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if (LOG_SURFACE) { 1105a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich Log.i("GLThread", "noticed surfaceView surface acquired tid=" + getId()); 1106a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich } 1107a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich mWaitingForSurface = false; 1108a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich sGLThreadManager.notifyAll(); 110967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich } 111067dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich 1111a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich // Ready to draw? 1112a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if ((!mPaused) && mHasSurface 1113a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich && (mWidth > 0) && (mHeight > 0) 1114a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich && (mRequestRender || (mRenderMode == RENDERMODE_CONTINUOUSLY))) { 1115a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich 1116a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich // If we don't have an egl surface, try to acquire one. 1117a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if ((! mHaveEgl) && sGLThreadManager.tryAcquireEglSurfaceLocked(this)) { 1118a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich mHaveEgl = true; 1119a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich mEglHelper.start(); 1120a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich createEglSurface = true; 1121a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich sizeChanged = true; 1122a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich sGLThreadManager.notifyAll(); 1123a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich } 112467dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich 1125a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if (mHaveEgl) { 1126a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if (mSizeChanged) { 1127a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich sizeChanged = true; 1128a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich w = mWidth; 1129a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich h = mHeight; 1130a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if (DRAW_TWICE_AFTER_SIZE_CHANGED) { 1131a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich // We keep mRequestRender true so that we draw twice after the size changes. 1132a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich // (Once because of mSizeChanged, the second time because of mRequestRender.) 1133a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich // This forces the updated graphics onto the screen. 1134a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich } else { 1135a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich mRequestRender = false; 1136a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich } 1137a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich mSizeChanged = false; 1138a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich } else { 1139a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich mRequestRender = false; 1140a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich } 114167dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.notifyAll(); 1142a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich break; 114367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich } 114432d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich } 114567dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich 1146a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich // By design, this is the only place in a GLThread thread where we wait(). 114732d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich if (LOG_THREADS) { 114867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich Log.i("GLThread", "waiting tid=" + getId()); 11491bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich } 115067dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.wait(); 115115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 115267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich } // end of synchronized(sGLThreadManager) 115367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich 1154a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if (event != null) { 1155a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich event.run(); 1156a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich event = null; 115767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich continue; 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 115967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich 1160a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if (createEglSurface) { 116115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich gl = (GL10) mEglHelper.createSurface(getHolder()); 116279447b2087c8c820d742185dda7305101f9656f0Jack Palevich sGLThreadManager.checkGLDriver(gl); 1163a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if (LOG_RENDERER) { 1164a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich Log.w("GLThread", "onSurfaceCreated"); 1165a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich } 116615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mRenderer.onSurfaceCreated(gl, mEglHelper.mEglConfig); 1167a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich createEglSurface = false; 116815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 1169a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich 1170a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if (sizeChanged) { 1171a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if (LOG_RENDERER) { 1172a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich Log.w("GLThread", "onSurfaceChanged(" + w + ", " + h + ")"); 1173a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich } 117415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mRenderer.onSurfaceChanged(gl, w, h); 1175a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich sizeChanged = false; 117615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 1177a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich 1178a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if (LOG_RENDERER) { 1179a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich Log.w("GLThread", "onDrawFrame"); 1180a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich } 1181a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich mRenderer.onDrawFrame(gl); 1182a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if(!mEglHelper.swap()) { 1183a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if (LOG_SURFACE) { 1184a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich Log.i("GLThread", "egl surface lost tid=" + getId()); 1185a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich } 118615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 1187a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich } 118815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } finally { 118915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich /* 119015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * clean-up everything... 119115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich */ 119267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized (sGLThreadManager) { 119367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich stopEglLocked(); 119467dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich } 119515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setRenderMode(int renderMode) { 11993e832dbe966c2ca0fde2f4bd87ad9c974a93a7cfJack Palevich if ( !((RENDERMODE_WHEN_DIRTY <= renderMode) && (renderMode <= RENDERMODE_CONTINUOUSLY)) ) { 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("renderMode"); 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 120267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized(sGLThreadManager) { 12039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRenderMode = renderMode; 1204a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich sGLThreadManager.notifyAll(); 12059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getRenderMode() { 120967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized(sGLThreadManager) { 12109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mRenderMode; 12119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void requestRender() { 121567dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized(sGLThreadManager) { 12169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRequestRender = true; 121767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.notifyAll(); 12189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void surfaceCreated() { 122267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized(sGLThreadManager) { 12238b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich if (LOG_THREADS) { 12248b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich Log.i("GLThread", "surfaceCreated tid=" + getId()); 12258b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich } 12269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHasSurface = true; 122767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.notifyAll(); 12289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void surfaceDestroyed() { 123267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized(sGLThreadManager) { 12338b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich if (LOG_THREADS) { 12348b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich Log.i("GLThread", "surfaceDestroyed tid=" + getId()); 12358b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich } 12369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHasSurface = false; 123767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.notifyAll(); 1238a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich while((!mWaitingForSurface) && (!mExited)) { 12391bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich try { 124067dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.wait(); 12411bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich } catch (InterruptedException e) { 12421bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich Thread.currentThread().interrupt(); 12431bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich } 12441bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich } 12459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onPause() { 124967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized (sGLThreadManager) { 12509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPaused = true; 125167dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.notifyAll(); 12529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onResume() { 125667dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized (sGLThreadManager) { 12579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPaused = false; 12588b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich mRequestRender = true; 125967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.notifyAll(); 12609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onWindowResize(int w, int h) { 126467dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized (sGLThreadManager) { 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWidth = w; 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeight = h; 12679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSizeChanged = true; 1268a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich mRequestRender = true; 126967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.notifyAll(); 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void requestExitAndWait() { 12749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // don't call this from GLThread thread or it is a guaranteed 12759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // deadlock! 127667dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized(sGLThreadManager) { 1277a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich mShouldExit = true; 127867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.notifyAll(); 1279a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich while (! mExited) { 1280a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich try { 1281a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich sGLThreadManager.wait(); 1282a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich } catch (InterruptedException ex) { 1283a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich Thread.currentThread().interrupt(); 1284a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich } 1285a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich } 12869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Queue an "event" to be run on the GL rendering thread. 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r the runnable to be run on the GL rendering thread. 12929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void queueEvent(Runnable r) { 1294a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich if (r == null) { 1295a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich throw new IllegalArgumentException("r must not be null"); 12969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1297a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich synchronized(sGLThreadManager) { 1298a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich mEventQueue.add(r); 1299a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich sGLThreadManager.notifyAll(); 13009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 130367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich // Once the thread is started, all accesses to the following member 130467dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich // variables are protected by the sGLThreadManager monitor 1305a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich private boolean mShouldExit; 1306a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich private boolean mExited; 13079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mPaused; 13089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mHasSurface; 13091bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich private boolean mWaitingForSurface; 131032d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich private boolean mHaveEgl; 13119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mWidth; 13129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mHeight; 13139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mRenderMode; 13149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mRequestRender; 1315a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich private ArrayList<Runnable> mEventQueue = new ArrayList<Runnable>(); 131667dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich // End of member variables protected by the sGLThreadManager monitor. 131767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich 13189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Renderer mRenderer; 13199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private EglHelper mEglHelper; 13209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static class LogWriter extends Writer { 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override public void close() { 13259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project flushBuilder(); 13269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override public void flush() { 13299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project flushBuilder(); 13309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override public void write(char[] buf, int offset, int count) { 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for(int i = 0; i < count; i++) { 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char c = buf[offset + i]; 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ( c == '\n') { 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project flushBuilder(); 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project else { 13399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBuilder.append(c); 13409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void flushBuilder() { 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mBuilder.length() > 0) { 13469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.v("GLSurfaceView", mBuilder.toString()); 13479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBuilder.delete(0, mBuilder.length()); 13489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private StringBuilder mBuilder = new StringBuilder(); 13529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 135415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 135515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich private void checkRenderThreadState() { 135615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich if (mGLThread != null) { 135715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich throw new IllegalStateException( 135815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich "setRenderer has already been called for this instance."); 135915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 136015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 136115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 136279447b2087c8c820d742185dda7305101f9656f0Jack Palevich private static class GLThreadManager { 13638da3ac92a6a6247ef06de4d4b684f8635d8fc003Jack Palevich 136467dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich public synchronized void threadExiting(GLThread thread) { 136567dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich if (LOG_THREADS) { 136667dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich Log.i("GLThread", "exiting tid=" + thread.getId()); 13678b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich } 1368a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich thread.mExited = true; 136967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich if (mEglOwner == thread) { 137067dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich mEglOwner = null; 13718b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich } 137267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich notifyAll(); 137367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich } 1374c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich 137567dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich /* 1376a822f02bb9c7f5bf2e3fa3cb63effc391be158c5Jack Palevich<<<<<<< HEAD 13771179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich * Tries to acquire the right to use an EGL 137867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich * surface. Does not block. 1379a822f02bb9c7f5bf2e3fa3cb63effc391be158c5Jack Palevich======= 138067dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich * Tries once to acquire the right to use an EGL 1381a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich * surface. Does not block. Requires that we are already 1382a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich * in the sGLThreadManager monitor when this is called. 1383a822f02bb9c7f5bf2e3fa3cb63effc391be158c5Jack Palevich>>>>>>> dc49acb0 138467dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich * @return true if the right to use an EGL surface was acquired. 138567dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich */ 1386a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich public boolean tryAcquireEglSurfaceLocked(GLThread thread) { 138767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich if (mEglOwner == thread || mEglOwner == null) { 138867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich mEglOwner = thread; 138967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich notifyAll(); 139067dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich return true; 13918b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich } 13921179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich checkGLESVersion(); 13931179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich if (mMultipleGLESContextsAllowed) { 13941179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich return true; 13958b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich } 139667dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich return false; 1397c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich } 1398a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich /* 1399a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich * Releases the EGL surface. Requires that we are already in the 1400a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich * sGLThreadManager monitor when this is called. 1401a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich */ 1402a08d46d8aaabb53eef4d5dc47272565d50f23c19Jack Palevich public void releaseEglSurfaceLocked(GLThread thread) { 140367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich if (mEglOwner == thread) { 140467dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich mEglOwner = null; 140579447b2087c8c820d742185dda7305101f9656f0Jack Palevich } 140667dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich notifyAll(); 1407c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich } 1408c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich 1409c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich public synchronized void checkGLDriver(GL10 gl) { 1410c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich if (! mGLESDriverCheckComplete) { 14111179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich checkGLESVersion(); 1412c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich if (mGLESVersion < kGLES_20) { 1413c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich String renderer = gl.glGetString(GL10.GL_RENDERER); 1414c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich mMultipleGLESContextsAllowed = 1415c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich ! renderer.startsWith(kMSM7K_RENDERER_PREFIX); 1416c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich notifyAll(); 1417c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich } 1418c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich mGLESDriverCheckComplete = true; 1419c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich } 1420c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich } 1421c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich 14221179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich private void checkGLESVersion() { 14231179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich if (! mGLESVersionCheckComplete) { 14241179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich mGLESVersion = SystemProperties.getInt( 14251179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich "ro.opengles.version", 14261179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich ConfigurationInfo.GL_ES_VERSION_UNDEFINED); 14271179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich if (mGLESVersion >= kGLES_20) { 14281179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich mMultipleGLESContextsAllowed = true; 14291179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich } 14301179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich mGLESVersionCheckComplete = true; 14311179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich } 14321179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich 14331179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich } 14341179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich 1435c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich private boolean mGLESVersionCheckComplete; 1436c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich private int mGLESVersion; 1437c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich private boolean mGLESDriverCheckComplete; 1438c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich private boolean mMultipleGLESContextsAllowed; 1439c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich private int mGLContextCount; 1440c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich private static final int kGLES_20 = 0x20000; 1441c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich private static final String kMSM7K_RENDERER_PREFIX = 1442c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich "Q3Dimension MSM7500 "; 144367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich private GLThread mEglOwner; 14448b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich } 1445c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich 14468b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich private static final GLThreadManager sGLThreadManager = new GLThreadManager(); 14479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mSizeChanged = true; 14489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private GLThread mGLThread; 1450a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich private EGLConfigChooser mEGLConfigChooser; 145115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich private EGLContextFactory mEGLContextFactory; 145215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich private EGLWindowSurfaceFactory mEGLWindowSurfaceFactory; 14539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private GLWrapper mGLWrapper; 14549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mDebugFlags; 14556ae4da75422bbb31c3e0a09f616cdaee1d465946Jack Palevich private int mEGLContextClientVersion; 14569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1457