19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2007 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 Project 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport javax.microedition.khronos.egl.EGL; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport javax.microedition.khronos.opengles.GL; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A helper class for debugging OpenGL ES applications. 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wraps the supplied GL interface with a new GL interface that adds support for 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error checking and logging. 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class GLDebugHelper { 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wrap an existing GL interface in a new GL interface that adds support for 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error checking and/or logging. 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wrapping means that the GL instance that is passed in to this method is 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * wrapped inside a new GL instance that optionally performs additional 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * operations before and after calling the wrapped GL instance. 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Error checking means that the wrapper will automatically call 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * glError after each GL operation, 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and throw a GLException if an error occurs. (By design, calling glError 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * itself will not cause an exception to be thrown.) Enabling error checking 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is an alternative to manually calling glError after every GL operation. 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Logging means writing a text representation of each GL method call to 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a log. 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param gl the existing GL interface. Must implement GL and GL10. May 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * optionally implement GL11 as well. 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param configFlags A bitmask of error checking flags. 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param log - null to disable logging, non-null to enable logging. 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the wrapped GL instance. 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Check glError() after every call. 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CONFIG_CHECK_GL_ERROR = (1 << 0); 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Check if all calls are on the same thread. 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CONFIG_CHECK_THREAD = (1 << 1); 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Print argument names when logging GL Calls. 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CONFIG_LOG_ARGUMENT_NAMES = (1 << 2); 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The Error number used in the GLException that is thrown if 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * CONFIG_CHECK_THREAD is enabled and you call OpenGL ES on the 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a different thread. 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR_WRONG_THREAD = 0x7000; 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static GL wrap(GL gl, int configFlags, Writer log) { 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ( configFlags != 0 ) { 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project gl = new GLErrorWrapper(gl, configFlags); 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ( log != null ) { 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean logArgumentNames = 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project (CONFIG_LOG_ARGUMENT_NAMES & configFlags) != 0; 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project gl = new GLLogWrapper(gl, log, logArgumentNames); 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return gl; 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wrap an existing EGL interface in a new EGL interface that adds 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * support for error checking and/or logging. 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param egl the existing GL interface. Must implement EGL and EGL10. May 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * optionally implement EGL11 as well. 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param configFlags A bitmask of error checking flags. 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param log - null to disable logging, non-null to enable logging. 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the wrapped EGL interface. 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static EGL wrap(EGL egl, int configFlags, Writer log) { 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (log != null) { 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project egl = new EGLLogWrapper(egl, configFlags, log); 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return egl; 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 108