GLSurfaceView.java revision 1179efbb3b8856eb8160e2dd67a300a5d64e8e98
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; 150b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 151b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * The renderer only renders 152b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * when the surface is created, or when {@link #requestRender} is called. 153b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * 154b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #getRenderMode() 155b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #setRenderMode(int) 156b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int RENDERMODE_WHEN_DIRTY = 0; 158b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 159b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * The renderer is called 160b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * continuously to re-render the scene. 161b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * 162b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #getRenderMode() 163b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #setRenderMode(int) 164b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #requestRender() 165b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 1663e832dbe966c2ca0fde2f4bd87ad9c974a93a7cfJack Palevich public final static int RENDERMODE_CONTINUOUSLY = 1; 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 169b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Check glError() after every GL call and throw an exception if glError indicates 170b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * that an error has occurred. This can be used to help track down which OpenGL ES call 171b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * is causing an error. 172b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * 173b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #getDebugFlags 174b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #setDebugFlags 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int DEBUG_CHECK_GL_ERROR = 1; 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Log GL calls to the system log at "verbose" level with tag "GLSurfaceView". 180b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * 181b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #getDebugFlags 182b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #setDebugFlags 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int DEBUG_LOG_GL_CALLS = 2; 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 186b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 187b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Standard View constructor. In order to render something, you 188b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * must call {@link #setRenderer} to register a renderer. 189b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public GLSurfaceView(Context context) { 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(context); 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project init(); 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 195b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 196b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Standard View constructor. In order to render something, you 197b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * must call {@link #setRenderer} to register a renderer. 198b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public GLSurfaceView(Context context, AttributeSet attrs) { 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(context, attrs); 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project init(); 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void init() { 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Install a SurfaceHolder.Callback so we get notified when the 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // underlying surface is created and destroyed 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project SurfaceHolder holder = getHolder(); 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project holder.addCallback(this); 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 212b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Set the glWrapper. If the glWrapper is not null, its 213b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * {@link GLWrapper#wrap(GL)} method is called 214b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * whenever a surface is created. A GLWrapper can be used to wrap 215b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * the GL object that's passed to the renderer. Wrapping a GL 216b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * object enables examining and modifying the behavior of the 217b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * GL calls made by the renderer. 218b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 219b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Wrapping is typically used for debugging purposes. 220b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 221b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * The default value is null. 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param glWrapper the new GLWrapper 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setGLWrapper(GLWrapper glWrapper) { 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLWrapper = glWrapper; 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 229b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Set the debug flags to a new value. The value is 230b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * constructed by OR-together zero or more 231b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * of the DEBUG_CHECK_* constants. The debug flags take effect 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * whenever a surface is created. The default value is zero. 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param debugFlags the new debug flags 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #DEBUG_CHECK_GL_ERROR 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #DEBUG_LOG_GL_CALLS 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setDebugFlags(int debugFlags) { 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDebugFlags = debugFlags; 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 241b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 242b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Get the current value of the debug flags. 243b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @return the current value of the debug flags. 244b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getDebugFlags() { 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mDebugFlags; 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 250b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Set the renderer associated with this view. Also starts the thread that 251b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * will call the renderer, which in turn causes the rendering to start. 252b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p>This method should be called once and only once in the life-cycle of 253b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * a GLSurfaceView. 254b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p>The following GLSurfaceView methods can only be called <em>before</em> 255b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * setRenderer is called: 256b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <ul> 257b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #setEGLConfigChooser(boolean)} 258b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #setEGLConfigChooser(EGLConfigChooser)} 259b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #setEGLConfigChooser(int, int, int, int, int, int)} 260b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * </ul> 261b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 262b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * The following GLSurfaceView methods can only be called <em>after</em> 263b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * setRenderer is called: 264b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <ul> 265b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #getRenderMode()} 266b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #onPause()} 267b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #onResume()} 268b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #queueEvent(Runnable)} 269b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #requestRender()} 270b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <li>{@link #setRenderMode(int)} 271b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * </ul> 272b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * 273b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @param renderer the renderer to use to perform OpenGL drawing. 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setRenderer(Renderer renderer) { 27615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich checkRenderThreadState(); 277a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich if (mEGLConfigChooser == null) { 278a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mEGLConfigChooser = new SimpleEGLConfigChooser(true); 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 28015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich if (mEGLContextFactory == null) { 28115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mEGLContextFactory = new DefaultContextFactory(); 28215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 28315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich if (mEGLWindowSurfaceFactory == null) { 28415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mEGLWindowSurfaceFactory = new DefaultWindowSurfaceFactory(); 28515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread = new GLThread(renderer); 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread.start(); 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 29115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * Install a custom EGLContextFactory. 29215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * <p>If this method is 29315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * called, it must be called before {@link #setRenderer(Renderer)} 29415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * is called. 29515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * <p> 29615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * If this method is not called, then by default 29715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * a context will be created with no shared context and 29815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * with a null attribute list. 29915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich */ 300a8fecb87c5eaaefc9ca6272e3b59ef88d293dd6dJack Palevich public void setEGLContextFactory(EGLContextFactory factory) { 30115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich checkRenderThreadState(); 30215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mEGLContextFactory = factory; 30315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 30415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 30515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich /** 30615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * Install a custom EGLWindowSurfaceFactory. 30715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * <p>If this method is 30815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * called, it must be called before {@link #setRenderer(Renderer)} 30915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * is called. 31015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * <p> 31115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * If this method is not called, then by default 31215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * a window surface will be created with a null attribute list. 31315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich */ 314a8fecb87c5eaaefc9ca6272e3b59ef88d293dd6dJack Palevich public void setEGLWindowSurfaceFactory(EGLWindowSurfaceFactory factory) { 31515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich checkRenderThreadState(); 31615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mEGLWindowSurfaceFactory = factory; 31715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 31815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 31915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich /** 320b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Install a custom EGLConfigChooser. 321b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p>If this method is 322b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * called, it must be called before {@link #setRenderer(Renderer)} 323a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * is called. 324a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * <p> 325b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * If no setEGLConfigChooser method is called, then by default the 326b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * view will choose a config as close to 16-bit RGB as possible, with 327b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * a depth buffer as close to 16 bits as possible. 328a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * @param configChooser 329a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich */ 330a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich public void setEGLConfigChooser(EGLConfigChooser configChooser) { 33115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich checkRenderThreadState(); 332a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mEGLConfigChooser = configChooser; 333a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 334a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 335a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich /** 336b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Install a config chooser which will choose a config 337a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * as close to 16-bit RGB as possible, with or without an optional depth 338a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * buffer as close to 16-bits as possible. 339b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p>If this method is 340b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * called, it must be called before {@link #setRenderer(Renderer)} 341b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * is called. 342a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * <p> 343b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * If no setEGLConfigChooser method is called, then by default the 344a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * view will choose a config as close to 16-bit RGB as possible, with 345b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * a depth buffer as close to 16 bits as possible. 346a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * 347a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * @param needDepth 348a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich */ 349a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich public void setEGLConfigChooser(boolean needDepth) { 350a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich setEGLConfigChooser(new SimpleEGLConfigChooser(needDepth)); 351a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 352a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 353a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich /** 354b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Install a config chooser which will choose a config 355b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * with at least the specified component sizes, and as close 356b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * to the specified component sizes as possible. 357b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p>If this method is 358a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * called, it must be called before {@link #setRenderer(Renderer)} 359a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * is called. 360a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * <p> 361b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * If no setEGLConfigChooser method is called, then by default the 362b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * view will choose a config as close to 16-bit RGB as possible, with 363b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * a depth buffer as close to 16 bits as possible. 364a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * 365a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich */ 366a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich public void setEGLConfigChooser(int redSize, int greenSize, int blueSize, 367a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich int alphaSize, int depthSize, int stencilSize) { 368a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich setEGLConfigChooser(new ComponentSizeChooser(redSize, greenSize, 369a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich blueSize, alphaSize, depthSize, stencilSize)); 370a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 371a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich /** 372b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Set the rendering mode. When renderMode is 3733e832dbe966c2ca0fde2f4bd87ad9c974a93a7cfJack Palevich * RENDERMODE_CONTINUOUSLY, the renderer is called 374b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * repeatedly to re-render the scene. When renderMode 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is RENDERMODE_WHEN_DIRTY, the renderer only rendered when the surface 3763e832dbe966c2ca0fde2f4bd87ad9c974a93a7cfJack Palevich * is created, or when {@link #requestRender} is called. Defaults to RENDERMODE_CONTINUOUSLY. 377b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 378b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Using RENDERMODE_WHEN_DIRTY can improve battery life and overall system performance 379b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * by allowing the GPU and CPU to idle when the view does not need to be updated. 380b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 381b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * This method can only be called after {@link #setRenderer(Renderer)} 382b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param renderMode one of the RENDERMODE_X constants 3843e832dbe966c2ca0fde2f4bd87ad9c974a93a7cfJack Palevich * @see #RENDERMODE_CONTINUOUSLY 385b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #RENDERMODE_WHEN_DIRTY 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setRenderMode(int renderMode) { 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread.setRenderMode(renderMode); 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get the current rendering mode. May be called 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from any thread. Must not be called before a renderer has been set. 394b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @return the current rendering mode. 3953e832dbe966c2ca0fde2f4bd87ad9c974a93a7cfJack Palevich * @see #RENDERMODE_CONTINUOUSLY 396b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #RENDERMODE_WHEN_DIRTY 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getRenderMode() { 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mGLThread.getRenderMode(); 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 403b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Request that the renderer render a frame. 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This method is typically used when the render mode has been set to 405b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * {@link #RENDERMODE_WHEN_DIRTY}, so that frames are only rendered on demand. 406b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * May be called 407b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * from any thread. Must not be called before a renderer has been set. 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void requestRender() { 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread.requestRender(); 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 413b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 414b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * This method is part of the SurfaceHolder.Callback interface, and is 415b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * not normally called or subclassed by clients of GLSurfaceView. 416b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void surfaceCreated(SurfaceHolder holder) { 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread.surfaceCreated(); 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 421b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 422b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * This method is part of the SurfaceHolder.Callback interface, and is 423b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * not normally called or subclassed by clients of GLSurfaceView. 424b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void surfaceDestroyed(SurfaceHolder holder) { 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Surface will be destroyed when we return 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread.surfaceDestroyed(); 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 430b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 431b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * This method is part of the SurfaceHolder.Callback interface, and is 432b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * not normally called or subclassed by clients of GLSurfaceView. 433b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void surfaceChanged(SurfaceHolder holder, int format, int w, int h) { 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread.onWindowResize(w, h); 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Inform the view that the activity is paused. The owner of this view must 440b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * call this method when the activity is paused. Calling this method will 441b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * pause the rendering thread. 442b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Must not be called before a renderer has been set. 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onPause() { 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread.onPause(); 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Inform the view that the activity is resumed. The owner of this view must 450b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * call this method when the activity is resumed. Calling this method will 451b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * recreate the OpenGL display and resume the rendering 452b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * thread. 453b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Must not be called before a renderer has been set. 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onResume() { 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread.onResume(); 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 460b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Queue a runnable to be run on the GL rendering thread. This can be used 461b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * to communicate with the Renderer on the rendering thread. 462b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Must not be called before a renderer has been set. 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r the runnable to be run on the GL rendering thread. 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void queueEvent(Runnable r) { 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread.queueEvent(r); 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 469b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 470b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * This method is used as part of the View class and is not normally 471b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * called or subclassed by clients of GLSurfaceView. 472b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Must not be called before a renderer has been set. 473b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onDetachedFromWindow() { 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onDetachedFromWindow(); 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGLThread.requestExitAndWait(); 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // ---------------------------------------------------------------------- 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 482b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 483b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * An interface used to wrap a GL interface. 484b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p>Typically 485b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * used for implementing debugging and tracing on top of the default 486b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * GL interface. You would typically use this by creating your own class 487b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * that implemented all the GL methods by delegating to another GL instance. 488b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Then you could add your own behavior before or after calling the 489b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * delegate. All the GLWrapper would do was instantiate and return the 490b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * wrapper GL instance: 491b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <pre class="prettyprint"> 492b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * class MyGLWrapper implements GLWrapper { 493b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * GL wrap(GL gl) { 494b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * return new MyGLImplementation(gl); 495b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * } 496b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * static class MyGLImplementation implements GL,GL10,GL11,... { 497b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * ... 498b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * } 499b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * } 500b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * </pre> 501b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #setGLWrapper(GLWrapper) 502b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface GLWrapper { 504b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich /** 505b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Wraps a gl interface in another gl interface. 506b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @param gl a GL interface that is to be wrapped. 507b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @return either the input argument or another GL object that wraps the input argument. 508b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich */ 509b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich GL wrap(GL gl); 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A generic renderer interface. 514b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 515b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * The renderer is responsible for making OpenGL calls to render a frame. 516b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 517b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * GLSurfaceView clients typically create their own classes that implement 518b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * this interface, and then call {@link GLSurfaceView#setRenderer} to 519b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * register the renderer with the GLSurfaceView. 520b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 521b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <h3>Threading</h3> 522b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * The renderer will be called on a separate thread, so that rendering 523b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * performance is decoupled from the UI thread. Clients typically need to 524b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * communicate with the renderer from the UI thread, because that's where 525b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * input events are received. Clients can communicate using any of the 526b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * standard Java techniques for cross-thread communication, or they can 527b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * use the {@link GLSurfaceView#queueEvent(Runnable)} convenience method. 528b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 529b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <h3>EGL Context Lost</h3> 530b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * There are situations where the EGL rendering context will be lost. This 531b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * typically happens when device wakes up after going to sleep. When 532b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * the EGL context is lost, all OpenGL resources (such as textures) that are 533b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * associated with that context will be automatically deleted. In order to 534b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * keep rendering correctly, a renderer must recreate any lost resources 535b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * that it still needs. The {@link #onSurfaceCreated(GL10, EGLConfig)} method 536b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * is a convenient place to do this. 537b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * 538b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * 539b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * @see #setRenderer(Renderer) 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface Renderer { 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 543b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Called when the surface is created or recreated. 544b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 545b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Called when the rendering thread 546b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * starts and whenever the EGL context is lost. The context will typically 547b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * be lost when the Android device awakes after going to sleep. 548b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 549b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Since this method is called at the beginning of rendering, as well as 550b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * every time the EGL context is lost, this method is a convenient place to put 551b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * code to create resources that need to be created when the rendering 552b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * starts, and that need to be recreated when the EGL context is lost. 553b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Textures are an example of a resource that you might want to create 554b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * here. 555b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 556b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Note that when the EGL context is lost, all OpenGL resources associated 557b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * with that context will be automatically deleted. You do not need to call 558b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * the corresponding "glDelete" methods such as glDeleteTextures to 559b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * manually delete these lost resources. 560b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gl the GL interface. Use <code>instanceof</code> to 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * test if the interface supports GL11 or higher interfaces. 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config the EGLConfig of the created surface. Can be used 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to create matching pbuffers. 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onSurfaceCreated(GL10 gl, EGLConfig config); 567b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 569b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Called when the surface changed size. 570b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called after the surface is created and whenever 572b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * the OpenGL ES surface size changes. 573b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 574b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Typically you will set your viewport here. If your camera 575b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * is fixed then you could also set your projection matrix here: 576b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <pre class="prettyprint"> 577b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * void onSurfaceChanged(GL10 gl, int width, int height) { 578b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * gl.glViewport(0, 0, width, height); 579b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * // for a fixed camera, set the projection too 580b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * float ratio = (float) width / height; 581b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * gl.glMatrixMode(GL10.GL_PROJECTION); 582b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * gl.glLoadIdentity(); 583b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * gl.glFrustumf(-ratio, ratio, -1, 1, 1, 10); 584b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * } 585b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * </pre> 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gl the GL interface. Use <code>instanceof</code> to 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * test if the interface supports GL11 or higher interfaces. 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onSurfaceChanged(GL10 gl, int width, int height); 592b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 594b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * Called to draw the current frame. 595b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 596b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * This method is responsible for drawing the current frame. 597b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 598b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * The implementation of this method typically looks like this: 599b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <pre class="prettyprint"> 600b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * void onDrawFrame(GL10 gl) { 601b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * gl.glClear(GL10.GL_COLOR_BUFFER_BIT | GL10.GL_DEPTH_BUFFER_BIT); 602b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * //... other gl calls to render the scene ... 603b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * } 604b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * </pre> 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gl the GL interface. Use <code>instanceof</code> to 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * test if the interface supports GL11 or higher interfaces. 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onDrawFrame(GL10 gl); 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 61215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * An interface for customizing the eglCreateContext and eglDestroyContext calls. 61315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * <p> 61415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * This interface must be implemented by clients wishing to call 61515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * {@link GLSurfaceView#setEGLContextFactory(EGLContextFactory)} 61615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich */ 61715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich public interface EGLContextFactory { 61815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich EGLContext createContext(EGL10 egl, EGLDisplay display, EGLConfig eglConfig); 61915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich void destroyContext(EGL10 egl, EGLDisplay display, EGLContext context); 62015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 62115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 62215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich private static class DefaultContextFactory implements EGLContextFactory { 62315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 62415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich public EGLContext createContext(EGL10 egl, EGLDisplay display, EGLConfig config) { 62515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich return egl.eglCreateContext(display, config, EGL10.EGL_NO_CONTEXT, null); 62615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 62715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 62815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich public void destroyContext(EGL10 egl, EGLDisplay display, 62915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich EGLContext context) { 63015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich egl.eglDestroyContext(display, context); 63115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 63215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 63315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 63415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich /** 63515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * An interface for customizing the eglCreateWindowSurface and eglDestroySurface calls. 63615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * <p> 63715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * This interface must be implemented by clients wishing to call 638d40dfbbbff81219258ca36b762a89ff503154345Jack Palevich * {@link GLSurfaceView#setEGLWindowSurfaceFactory(EGLWindowSurfaceFactory)} 63915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich */ 64015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich public interface EGLWindowSurfaceFactory { 64115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich EGLSurface createWindowSurface(EGL10 egl, EGLDisplay display, EGLConfig config, 64215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich Object nativeWindow); 64315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich void destroySurface(EGL10 egl, EGLDisplay display, EGLSurface surface); 64415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 64515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 64615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich private static class DefaultWindowSurfaceFactory implements EGLWindowSurfaceFactory { 64715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 64815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich public EGLSurface createWindowSurface(EGL10 egl, EGLDisplay display, 64915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich EGLConfig config, Object nativeWindow) { 65015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich return egl.eglCreateWindowSurface(display, config, nativeWindow, null); 65115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 65215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 65315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich public void destroySurface(EGL10 egl, EGLDisplay display, 65415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich EGLSurface surface) { 65515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich egl.eglDestroySurface(display, surface); 65615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 65715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 65815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 65915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich /** 660b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * An interface for choosing an EGLConfig configuration from a list of 661a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * potential configurations. 662b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * <p> 663b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * This interface must be implemented by clients wishing to call 664b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * {@link GLSurfaceView#setEGLConfigChooser(EGLConfigChooser)} 665a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich */ 666a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich public interface EGLConfigChooser { 667a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich /** 668a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * Choose a configuration from the list. Implementors typically 669a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * implement this method by calling 670b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * {@link EGL10#eglChooseConfig} and iterating through the results. Please consult the 671b47c641fe8330fc68dbed91163ff07015068d0ceJack Palevich * EGL specification available from The Khronos Group to learn how to call eglChooseConfig. 672a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * @param egl the EGL10 for the current display. 673a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * @param display the current display. 674a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * @return the chosen configuration. 675a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich */ 676a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGLConfig chooseConfig(EGL10 egl, EGLDisplay display); 677a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 678a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 679a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich private static abstract class BaseConfigChooser 680a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich implements EGLConfigChooser { 681a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich public BaseConfigChooser(int[] configSpec) { 682a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mConfigSpec = configSpec; 683a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 684a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich public EGLConfig chooseConfig(EGL10 egl, EGLDisplay display) { 685a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich int[] num_config = new int[1]; 68628023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich if (!egl.eglChooseConfig(display, mConfigSpec, null, 0, 68728023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich num_config)) { 68828023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich throw new IllegalArgumentException("eglChooseConfig failed"); 68928023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich } 690a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 691a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich int numConfigs = num_config[0]; 692a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 693a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich if (numConfigs <= 0) { 694a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich throw new IllegalArgumentException( 695a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich "No configs match configSpec"); 696a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 697a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 698a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGLConfig[] configs = new EGLConfig[numConfigs]; 69928023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich if (!egl.eglChooseConfig(display, mConfigSpec, configs, numConfigs, 70028023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich num_config)) { 70128023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich throw new IllegalArgumentException("eglChooseConfig#2 failed"); 70228023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich } 703a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGLConfig config = chooseConfig(egl, display, configs); 704a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich if (config == null) { 705a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich throw new IllegalArgumentException("No config chosen"); 706a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 707a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich return config; 708a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 709a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 710a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich abstract EGLConfig chooseConfig(EGL10 egl, EGLDisplay display, 711a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGLConfig[] configs); 712a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 713a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich protected int[] mConfigSpec; 714a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 715a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 716a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich private static class ComponentSizeChooser extends BaseConfigChooser { 717a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich public ComponentSizeChooser(int redSize, int greenSize, int blueSize, 718a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich int alphaSize, int depthSize, int stencilSize) { 719a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich super(new int[] { 720a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGL10.EGL_RED_SIZE, redSize, 721a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGL10.EGL_GREEN_SIZE, greenSize, 722a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGL10.EGL_BLUE_SIZE, blueSize, 723a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGL10.EGL_ALPHA_SIZE, alphaSize, 724a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGL10.EGL_DEPTH_SIZE, depthSize, 725a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGL10.EGL_STENCIL_SIZE, stencilSize, 726a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGL10.EGL_NONE}); 727a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mValue = new int[1]; 728a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mRedSize = redSize; 729a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mGreenSize = greenSize; 730a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mBlueSize = blueSize; 731a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mAlphaSize = alphaSize; 732a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mDepthSize = depthSize; 733a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mStencilSize = stencilSize; 734a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 735a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 736a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich @Override 737a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich public EGLConfig chooseConfig(EGL10 egl, EGLDisplay display, 738a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGLConfig[] configs) { 739a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGLConfig closestConfig = null; 740a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich int closestDistance = 1000; 741a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich for(EGLConfig config : configs) { 742a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich int d = findConfigAttrib(egl, display, config, 743a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGL10.EGL_DEPTH_SIZE, 0); 744a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich int s = findConfigAttrib(egl, display, config, 745a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGL10.EGL_STENCIL_SIZE, 0); 74682fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian if (d >= mDepthSize && s>= mStencilSize) { 74782fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian int r = findConfigAttrib(egl, display, config, 74882fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian EGL10.EGL_RED_SIZE, 0); 74982fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian int g = findConfigAttrib(egl, display, config, 75082fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian EGL10.EGL_GREEN_SIZE, 0); 75182fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian int b = findConfigAttrib(egl, display, config, 75282fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian EGL10.EGL_BLUE_SIZE, 0); 75382fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian int a = findConfigAttrib(egl, display, config, 75482fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian EGL10.EGL_ALPHA_SIZE, 0); 75582fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian int distance = Math.abs(r - mRedSize) 75682fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian + Math.abs(g - mGreenSize) 75782fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian + Math.abs(b - mBlueSize) 75882fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian + Math.abs(a - mAlphaSize); 75982fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian if (distance < closestDistance) { 76082fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian closestDistance = distance; 76182fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian closestConfig = config; 76282fd4fce16b9bbde25d044acc86ddf7306ebdd10Mathias Agopian } 763a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 764a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 765a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich return closestConfig; 766a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 767a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 768a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich private int findConfigAttrib(EGL10 egl, EGLDisplay display, 769a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich EGLConfig config, int attribute, int defaultValue) { 770a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 771a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich if (egl.eglGetConfigAttrib(display, config, attribute, mValue)) { 772a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich return mValue[0]; 773a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 774a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich return defaultValue; 775a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 776a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 777a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich private int[] mValue; 778a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich // Subclasses can adjust these values: 779a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich protected int mRedSize; 780a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich protected int mGreenSize; 781a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich protected int mBlueSize; 782a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich protected int mAlphaSize; 783a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich protected int mDepthSize; 784a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich protected int mStencilSize; 785a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 786a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 787a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich /** 788a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * This class will choose a supported surface as close to 789a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * RGB565 as possible, with or without a depth buffer. 790a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich * 791a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich */ 792a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich private static class SimpleEGLConfigChooser extends ComponentSizeChooser { 793a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich public SimpleEGLConfigChooser(boolean withDepthBuffer) { 794a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich super(4, 4, 4, 0, withDepthBuffer ? 16 : 0, 0); 795a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich // Adjust target values. This way we'll accept a 4444 or 796a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich // 555 buffer if there's no 565 buffer available. 797a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mRedSize = 5; 798a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mGreenSize = 6; 799a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mBlueSize = 5; 800a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 801a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich } 802a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich 803a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich /** 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * An EGL helper class. 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private class EglHelper { 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public EglHelper() { 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Initialize EGL for a given configuration spec. 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param configSpec 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 816a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich public void start(){ 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get an EGL instance 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEgl = (EGL10) EGLContext.getEGL(); 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get to the default display. 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEglDisplay = mEgl.eglGetDisplay(EGL10.EGL_DEFAULT_DISPLAY); 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 82728023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich if (mEglDisplay == EGL10.EGL_NO_DISPLAY) { 82828023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich throw new RuntimeException("eglGetDisplay failed"); 82928023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich } 83028023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * We can now initialize EGL for that display 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] version = new int[2]; 83528023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich if(!mEgl.eglInitialize(mEglDisplay, version)) { 83628023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich throw new RuntimeException("eglInitialize failed"); 83728023911a4b572f0ca640e7a3e3f9a0dd6f535e9Jack Palevich } 838a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich mEglConfig = mEGLConfigChooser.chooseConfig(mEgl, mEglDisplay); 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Create an OpenGL ES context. This must be done only once, an 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * OpenGL context is a somewhat heavy object. 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 84415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mEglContext = mEGLContextFactory.createContext(mEgl, mEglDisplay, mEglConfig); 8452e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich if (mEglContext == null || mEglContext == EGL10.EGL_NO_CONTEXT) { 8462e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich throw new RuntimeException("createContext failed"); 8472e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich } 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEglSurface = null; 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * React to the creation of a new surface by creating and returning an 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * OpenGL interface that renders to that surface. 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public GL createSurface(SurfaceHolder holder) { 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The window size has changed, so we need to create a new 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * surface. 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8612e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich if (mEglSurface != null && mEglSurface != EGL10.EGL_NO_SURFACE) { 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unbind and destroy the old EGL surface, if 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * there is one. 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEgl.eglMakeCurrent(mEglDisplay, EGL10.EGL_NO_SURFACE, 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EGL10.EGL_NO_SURFACE, EGL10.EGL_NO_CONTEXT); 86915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mEGLWindowSurfaceFactory.destroySurface(mEgl, mEglDisplay, mEglSurface); 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Create an EGL surface we can render into. 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 87515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mEglSurface = mEGLWindowSurfaceFactory.createWindowSurface(mEgl, 87615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mEglDisplay, mEglConfig, holder); 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8782e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich if (mEglSurface == null || mEglSurface == EGL10.EGL_NO_SURFACE) { 8792e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich throw new RuntimeException("createWindowSurface failed"); 8802e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich } 8812e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Before we can issue GL commands, we need to make sure 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the context is current and bound to a surface. 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8862e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich if (!mEgl.eglMakeCurrent(mEglDisplay, mEglSurface, mEglSurface, mEglContext)) { 8872e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich throw new RuntimeException("eglMakeCurrent failed."); 8882e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich } 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project GL gl = mEglContext.getGL(); 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mGLWrapper != null) { 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project gl = mGLWrapper.wrap(gl); 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((mDebugFlags & (DEBUG_CHECK_GL_ERROR | DEBUG_LOG_GL_CALLS))!= 0) { 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int configFlags = 0; 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Writer log = null; 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((mDebugFlags & DEBUG_CHECK_GL_ERROR) != 0) { 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project configFlags |= GLDebugHelper.CONFIG_CHECK_GL_ERROR; 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((mDebugFlags & DEBUG_LOG_GL_CALLS) != 0) { 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project log = new LogWriter(); 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project gl = GLDebugHelper.wrap(gl, configFlags, log); 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return gl; 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Display the current render surface. 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return false if the context has been lost. 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean swap() { 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEgl.eglSwapBuffers(mEglDisplay, mEglSurface); 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Always check for EGL_CONTEXT_LOST, which means the context 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and all associated data were lost (For instance because 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the device went to sleep). We need to sleep until we 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * get a new surface. 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mEgl.eglGetError() != EGL11.EGL_CONTEXT_LOST; 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9251bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich public void destroySurface() { 9262e26fc08aa1939c19e939d983bd608cdec050024Jack Palevich if (mEglSurface != null && mEglSurface != EGL10.EGL_NO_SURFACE) { 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEgl.eglMakeCurrent(mEglDisplay, EGL10.EGL_NO_SURFACE, 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EGL10.EGL_NO_SURFACE, 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EGL10.EGL_NO_CONTEXT); 93015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mEGLWindowSurfaceFactory.destroySurface(mEgl, mEglDisplay, mEglSurface); 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEglSurface = null; 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9331bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich } 9341bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich 9351bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich public void finish() { 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mEglContext != null) { 93715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mEGLContextFactory.destroyContext(mEgl, mEglDisplay, mEglContext); 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEglContext = null; 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mEglDisplay != null) { 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEgl.eglTerminate(mEglDisplay); 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEglDisplay = null; 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EGL10 mEgl; 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EGLDisplay mEglDisplay; 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EGLSurface mEglSurface; 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EGLConfig mEglConfig; 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EGLContext mEglContext; 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A generic GL Thread. Takes care of initializing EGL and GL. Delegates 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to a Renderer instance to do the actual drawing. Can be configured to 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * render continuously or on request. 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 95867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich * All potentially blocking synchronization is done through the 95967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich * sGLThreadManager object. This avoids multiple-lock ordering issues. 96067dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich * 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project class GLThread extends Thread { 9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project GLThread(Renderer renderer) { 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super(); 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDone = false; 9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWidth = 0; 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeight = 0; 9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRequestRender = true; 9693e832dbe966c2ca0fde2f4bd87ad9c974a93a7cfJack Palevich mRenderMode = RENDERMODE_CONTINUOUSLY; 9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRenderer = renderer; 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void run() { 9758b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich setName("GLThread " + getId()); 9768b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich if (LOG_THREADS) { 9778b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich Log.i("GLThread", "starting tid=" + getId()); 9788b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich } 9798b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project guardedRun(); 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (InterruptedException e) { 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // fall thru and exit normally 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } finally { 98567dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.threadExiting(this); 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 98967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich /* 99067dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich * This private method should only be called inside a 99167dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich * synchronized(sGLThreadManager) block. 99267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich */ 99367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich private void stopEglLocked() { 99432d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich if (mHaveEgl) { 99532d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich mHaveEgl = false; 99632d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich mEglHelper.destroySurface(); 99732d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich mEglHelper.finish(); 99867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.releaseEglSurface(this); 99932d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich } 100032d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich } 100132d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void guardedRun() throws InterruptedException { 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEglHelper = new EglHelper(); 100415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich try { 100515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich GL10 gl = null; 100615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich boolean tellRendererSurfaceCreated = true; 100715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich boolean tellRendererSurfaceChanged = true; 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 101015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * This is our main activity thread's loop, we go until 101115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * asked to quit. 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 101367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich while (!isDone()) { 101415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich /* 101515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * Update the asynchronous state (window size) 101615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich */ 101767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich int w = 0; 101867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich int h = 0; 101967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich boolean changed = false; 102015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich boolean needStart = false; 102167dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich boolean eventsWaiting = false; 102267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich 102367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized (sGLThreadManager) { 102467dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich while (true) { 102567dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich // Manage acquiring and releasing the SurfaceView 102667dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich // surface and the EGL surface. 102767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich if (mPaused) { 102867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich stopEglLocked(); 102967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich } 103015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich if (!mHasSurface) { 103115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich if (!mWaitingForSurface) { 103267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich stopEglLocked(); 103315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mWaitingForSurface = true; 103467dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.notifyAll(); 103515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 103632d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich } else { 103767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich if (!mHaveEgl) { 103867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich if (sGLThreadManager.tryAcquireEglSurface(this)) { 103967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich mHaveEgl = true; 104067dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich mEglHelper.start(); 104167dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich mRequestRender = true; 104267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich needStart = true; 104367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich } 104432d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich } 104532d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich } 104667dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich 104767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich // Check if we need to wait. If not, update any state 104867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich // that needs to be updated, copy any state that 104967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich // needs to be copied, and use "break" to exit the 105067dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich // wait loop. 105167dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich 105267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich if (mDone) { 105367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich return; 105467dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich } 105567dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich 105667dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich if (mEventsWaiting) { 105767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich eventsWaiting = true; 105867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich mEventsWaiting = false; 105967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich break; 106067dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich } 106167dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich 106267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich if ( (! mPaused) && mHasSurface && mHaveEgl 106367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich && (mWidth > 0) && (mHeight > 0) 106467dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich && (mRequestRender || (mRenderMode == RENDERMODE_CONTINUOUSLY)) 106567dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich ) { 106667dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich changed = mSizeChanged; 106767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich w = mWidth; 106867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich h = mHeight; 106967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich mSizeChanged = false; 107067dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich mRequestRender = false; 107167dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich if (mHasSurface && mWaitingForSurface) { 107267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich changed = true; 107367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich mWaitingForSurface = false; 107467dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.notifyAll(); 107567dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich } 107632d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich break; 107732d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich } 107867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich 107967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich // By design, this is the only place where we wait(). 108067dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich 108132d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich if (LOG_THREADS) { 108267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich Log.i("GLThread", "waiting tid=" + getId()); 10831bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich } 108467dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.wait(); 108515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 108667dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich } // end of synchronized(sGLThreadManager) 108767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich 108867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich /* 108967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich * Handle queued events 109067dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich */ 109167dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich if (eventsWaiting) { 109267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich Runnable r; 109367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich while ((r = getEvent()) != null) { 109467dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich r.run(); 109567dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich if (isDone()) { 109667dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich return; 109767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich } 10981bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich } 109967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich // Go back and see if we need to wait to render. 110067dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich continue; 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 110267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich 110315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich if (needStart) { 110415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich tellRendererSurfaceCreated = true; 11051bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich changed = true; 11061bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich } 110715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich if (changed) { 110815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich gl = (GL10) mEglHelper.createSurface(getHolder()); 110979447b2087c8c820d742185dda7305101f9656f0Jack Palevich sGLThreadManager.checkGLDriver(gl); 111015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich tellRendererSurfaceChanged = true; 111115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 111215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich if (tellRendererSurfaceCreated) { 111315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mRenderer.onSurfaceCreated(gl, mEglHelper.mEglConfig); 111415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich tellRendererSurfaceCreated = false; 111515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 111615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich if (tellRendererSurfaceChanged) { 111715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mRenderer.onSurfaceChanged(gl, w, h); 111815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich tellRendererSurfaceChanged = false; 111915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 112015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich if ((w > 0) && (h > 0)) { 112115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich /* draw a frame here */ 112215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mRenderer.onDrawFrame(gl); 112315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 112415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich /* 112515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * Once we're done with GL, we need to call swapBuffers() 112615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * to instruct the system to display the rendered frame 112715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich */ 112815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich mEglHelper.swap(); 112915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 113015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 113115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } finally { 113215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich /* 113315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich * clean-up everything... 113415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich */ 113567dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized (sGLThreadManager) { 113667dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich stopEglLocked(); 113767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich } 113815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 11399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 114167dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich private boolean isDone() { 114267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized (sGLThreadManager) { 114367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich return mDone; 11449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setRenderMode(int renderMode) { 11483e832dbe966c2ca0fde2f4bd87ad9c974a93a7cfJack Palevich if ( !((RENDERMODE_WHEN_DIRTY <= renderMode) && (renderMode <= RENDERMODE_CONTINUOUSLY)) ) { 11499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("renderMode"); 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 115167dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized(sGLThreadManager) { 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRenderMode = renderMode; 11533e832dbe966c2ca0fde2f4bd87ad9c974a93a7cfJack Palevich if (renderMode == RENDERMODE_CONTINUOUSLY) { 115467dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.notifyAll(); 11559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getRenderMode() { 116067dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized(sGLThreadManager) { 11619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mRenderMode; 11629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void requestRender() { 116667dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized(sGLThreadManager) { 11679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRequestRender = true; 116867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.notifyAll(); 11699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void surfaceCreated() { 117367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized(sGLThreadManager) { 11748b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich if (LOG_THREADS) { 11758b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich Log.i("GLThread", "surfaceCreated tid=" + getId()); 11768b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich } 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHasSurface = true; 117867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.notifyAll(); 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void surfaceDestroyed() { 118367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized(sGLThreadManager) { 11848b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich if (LOG_THREADS) { 11858b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich Log.i("GLThread", "surfaceDestroyed tid=" + getId()); 11868b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich } 11879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHasSurface = false; 118867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.notifyAll(); 11898b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich while(!mWaitingForSurface && isAlive() && ! mDone) { 11901bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich try { 119167dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.wait(); 11921bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich } catch (InterruptedException e) { 11931bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich Thread.currentThread().interrupt(); 11941bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich } 11951bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich } 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onPause() { 120067dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized (sGLThreadManager) { 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPaused = true; 120267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.notifyAll(); 12039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onResume() { 120767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized (sGLThreadManager) { 12089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPaused = false; 12098b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich mRequestRender = true; 121067dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.notifyAll(); 12119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onWindowResize(int w, int h) { 121567dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized (sGLThreadManager) { 12169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mWidth = w; 12179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeight = h; 12189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mSizeChanged = true; 121967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.notifyAll(); 12209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void requestExitAndWait() { 12249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // don't call this from GLThread thread or it is a guaranteed 12259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // deadlock! 122667dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized(sGLThreadManager) { 12279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDone = true; 122867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.notifyAll(); 12299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 12319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project join(); 12329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (InterruptedException ex) { 12339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Thread.currentThread().interrupt(); 12349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Queue an "event" to be run on the GL rendering thread. 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r the runnable to be run on the GL rendering thread. 12409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void queueEvent(Runnable r) { 12429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(this) { 12439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mEventQueue.add(r); 124467dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich synchronized(sGLThreadManager) { 124567dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich mEventsWaiting = true; 124667dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich sGLThreadManager.notifyAll(); 124767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich } 12489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Runnable getEvent() { 12529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized(this) { 12539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mEventQueue.size() > 0) { 12549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mEventQueue.remove(0); 12559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 12599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 126167dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich // Once the thread is started, all accesses to the following member 126267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich // variables are protected by the sGLThreadManager monitor 12639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mDone; 12649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mPaused; 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mHasSurface; 12661bd888ba2e0976a179258cfa65ef07be31602a0aJack Palevich private boolean mWaitingForSurface; 126732d416518473f3bf5323d660e5910ca5633ffed6Jack Palevich private boolean mHaveEgl; 12689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mWidth; 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mHeight; 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mRenderMode; 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mRequestRender; 127267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich private boolean mEventsWaiting; 127367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich // End of member variables protected by the sGLThreadManager monitor. 127467dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich 12759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Renderer mRenderer; 12769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private ArrayList<Runnable> mEventQueue = new ArrayList<Runnable>(); 12779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private EglHelper mEglHelper; 12789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static class LogWriter extends Writer { 12819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override public void close() { 12839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project flushBuilder(); 12849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override public void flush() { 12879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project flushBuilder(); 12889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override public void write(char[] buf, int offset, int count) { 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for(int i = 0; i < count; i++) { 12929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char c = buf[offset + i]; 12939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ( c == '\n') { 12949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project flushBuilder(); 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project else { 12979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBuilder.append(c); 12989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void flushBuilder() { 13039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mBuilder.length() > 0) { 13049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Log.v("GLSurfaceView", mBuilder.toString()); 13059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBuilder.delete(0, mBuilder.length()); 13069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private StringBuilder mBuilder = new StringBuilder(); 13109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 131215e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 131315e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich private void checkRenderThreadState() { 131415e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich if (mGLThread != null) { 131515e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich throw new IllegalStateException( 131615e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich "setRenderer has already been called for this instance."); 131715e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 131815e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich } 131915e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich 132079447b2087c8c820d742185dda7305101f9656f0Jack Palevich private static class GLThreadManager { 13218da3ac92a6a6247ef06de4d4b684f8635d8fc003Jack Palevich 132267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich public synchronized void threadExiting(GLThread thread) { 132367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich if (LOG_THREADS) { 132467dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich Log.i("GLThread", "exiting tid=" + thread.getId()); 13258b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich } 132667dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich thread.mDone = true; 132767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich if (mEglOwner == thread) { 132867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich mEglOwner = null; 13298b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich } 133067dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich notifyAll(); 133167dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich } 1332c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich 133367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich /* 13341179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich * Tries to acquire the right to use an EGL 133567dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich * surface. Does not block. 133667dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich * @return true if the right to use an EGL surface was acquired. 133767dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich */ 133867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich public synchronized boolean tryAcquireEglSurface(GLThread thread) { 133967dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich if (mEglOwner == thread || mEglOwner == null) { 134067dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich mEglOwner = thread; 134167dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich notifyAll(); 134267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich return true; 13438b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich } 13441179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich checkGLESVersion(); 13451179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich if (mMultipleGLESContextsAllowed) { 13461179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich return true; 13478b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich } 134867dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich return false; 1349c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich } 1350c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich 135167dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich public synchronized void releaseEglSurface(GLThread thread) { 135267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich if (mEglOwner == thread) { 135367dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich mEglOwner = null; 135479447b2087c8c820d742185dda7305101f9656f0Jack Palevich } 135567dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich notifyAll(); 1356c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich } 1357c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich 1358c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich public synchronized void checkGLDriver(GL10 gl) { 1359c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich if (! mGLESDriverCheckComplete) { 13601179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich checkGLESVersion(); 1361c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich if (mGLESVersion < kGLES_20) { 1362c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich String renderer = gl.glGetString(GL10.GL_RENDERER); 1363c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich mMultipleGLESContextsAllowed = 1364c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich ! renderer.startsWith(kMSM7K_RENDERER_PREFIX); 1365c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich notifyAll(); 1366c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich } 1367c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich mGLESDriverCheckComplete = true; 1368c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich } 1369c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich } 1370c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich 13711179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich private void checkGLESVersion() { 13721179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich if (! mGLESVersionCheckComplete) { 13731179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich mGLESVersion = SystemProperties.getInt( 13741179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich "ro.opengles.version", 13751179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich ConfigurationInfo.GL_ES_VERSION_UNDEFINED); 13761179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich if (mGLESVersion >= kGLES_20) { 13771179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich mMultipleGLESContextsAllowed = true; 13781179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich } 13791179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich mGLESVersionCheckComplete = true; 13801179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich } 13811179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich 13821179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich } 13831179efbb3b8856eb8160e2dd67a300a5d64e8e98Jack Palevich 1384c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich private boolean mGLESVersionCheckComplete; 1385c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich private int mGLESVersion; 1386c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich private boolean mGLESDriverCheckComplete; 1387c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich private boolean mMultipleGLESContextsAllowed; 1388c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich private int mGLContextCount; 1389c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich private static final int kGLES_20 = 0x20000; 1390c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich private static final String kMSM7K_RENDERER_PREFIX = 1391c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich "Q3Dimension MSM7500 "; 139267dcd6c2392caf3ff98f35a3d1ec550d229c167bJack Palevich private GLThread mEglOwner; 13938b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich } 1394c52ba78cab001ff68b4823f4769c129b8acfddeeJack Palevich 13958b2c9c9ecb08d25244fa97fb42c2c315ae3cf03dJack Palevich private static final GLThreadManager sGLThreadManager = new GLThreadManager(); 13969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mSizeChanged = true; 13979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private GLThread mGLThread; 1399a605a51e63de2e7dc99ed085639a6f12b7f85af7Jack Palevich private EGLConfigChooser mEGLConfigChooser; 140015e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich private EGLContextFactory mEGLContextFactory; 140115e1c6dc7a778590068b1cad55beea2bc6159509Jack Palevich private EGLWindowSurfaceFactory mEGLWindowSurfaceFactory; 14029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private GLWrapper mGLWrapper; 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mDebugFlags; 14049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1405