4.5.1. Debugging settings

Debugging is controlled by a number of parameters, These are not created during installation, so you must manually add these to enable debugging output.

How you set these parameters depends on the OS you are using. To enable debugging in the OpenGL ES 2.0 Emulator on Windows, add them as registry keys. On Linux, add them as environment variables.

The feedback provided by the OpenGL ES 2.0 Emulator depends on the OS it is running on.

The following parameters control debugging:

EGL_INTERNAL_REPORT

This reports errors returned by the underlying calls to the underlying windowing system. These errors are always returned through the normal EGL error reporting mechanism. The report to standard error might provide more information on the exact cause of the failure.

EGL_OUT_OF_MEMORY_REPORT

Memory allocation failures within the EGL Library are reported. These are always reported as EGL_BAD_ALLOC. The report to standard error indicates the size and purpose of the failed allocation.

EGL_WARNING_REPORT

The EGL Library outputs warnings about limitations of the library. This includes warnings about limitations and failure to set EGL_RENDERABLE_TYPE or EGL_CONTEXT_CLIENT_VERSION.

GLES2_INTERNAL_REPORT

This reports errors returned by the underlying calls to the underlying windowing system. These errors are always returned through the normal EGL error reporting mechanism. The report to standard error might provide more information on the exact cause of the failure.

The Windows version of the EGL library uses the WGL windowing system, and the Linux version of the library uses GLX.

GLES2_OUT_OF_MEMORY_REPORT

Memory allocation failures within the OpenGL ES 2.0 Emulator are reported. These are always reported as EGL_BAD_ALLOC. The report to standard error indicates the size and purpose of the failed allocation.

GLES2_WARNING_REPORT

Any failure to run the Mali GPU Offline Shader Compiler is reported to standard error. See Shader syntax checking by the Mali GPU Offline Shader Compiler.

Note

The following key formats are deprecated but still supported:

  • EGLInternalReport

  • EGLOutOfMemoryReport

  • EGLWarningReport

  • GLES2InternalReport

  • GLESOutOfMemoryReport

  • GLES2WarningReport.

Copyright © 2009-2010 ARM. All rights reserved.ARM DUI 0511C
Non-ConfidentialID072410