--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/guestrendering/guestegl/src/egldebug.cpp	Wed Sep 08 15:45:18 2010 +0100
@@ -0,0 +1,286 @@
+// Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of "Eclipse Public License v1.0"
+// which accompanies this distribution, and is available
+// at the URL "http://www.eclipse.org/legal/epl-v10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+// Guest egl implementation debugging support
+
+#include <e32debug.h>
+#include "eglapi.h"
+
+
+#ifdef _DEBUG
+
+// These functions help with verbose debug logging of EGL Attibutes
+
+// Try to get an attribute name string, and a description of the value - switch statements can be extended for later EGL versions
+void TAttribUtils::TraceAttribNames(EGLint aAttrib, EGLint aValue, char** aAttrName, char** aValueName)
+	{
+	char* attrName = NULL;
+	char* valueName = NULL;
+	switch (aAttrib)
+		{
+		case EGL_BUFFER_SIZE: attrName = "EGL_BUFFER_SIZE"; break;
+		case EGL_ALPHA_SIZE: attrName = "EGL_ALPHA_SIZE"; break;
+		case EGL_BLUE_SIZE: attrName = "EGL_BLUE_SIZE"; break;
+		case EGL_GREEN_SIZE: attrName = "EGL_GREEN_SIZE"; break;
+		case EGL_RED_SIZE: attrName = "EGL_RED_SIZE"; break;
+		case EGL_DEPTH_SIZE: attrName = "EGL_DEPTH_SIZE"; break;
+		case EGL_STENCIL_SIZE: attrName = "EGL_STENCIL_SIZE"; break;
+		case EGL_CONFIG_CAVEAT: attrName = "EGL_CONFIG_CAVEAT";
+			switch (aValue)
+				{
+				// Config attribute values
+				case EGL_SLOW_CONFIG: valueName = "EGL_SLOW_CONFIG"; break;
+				case EGL_NON_CONFORMANT_CONFIG: valueName = "EGL_NON_CONFORMANT_CONFIG"; break;
+				}
+			break;
+		case EGL_CONFIG_ID: attrName = "EGL_CONFIG_ID"; break;
+		case EGL_LEVEL: attrName = "EGL_LEVEL"; break;
+		case EGL_MAX_PBUFFER_HEIGHT: attrName = "EGL_MAX_PBUFFER_HEIGHT"; break;
+		case EGL_MAX_PBUFFER_PIXELS: attrName = "EGL_MAX_PBUFFER_PIXELS"; break;
+		case EGL_MAX_PBUFFER_WIDTH: attrName = "EGL_MAX_PBUFFER_WIDTH"; break;
+		case EGL_NATIVE_RENDERABLE: attrName = "EGL_NATIVE_RENDERABLE"; break;
+		case EGL_NATIVE_VISUAL_ID: attrName = "EGL_NATIVE_VISUAL_ID"; break;
+		case EGL_NATIVE_VISUAL_TYPE: attrName = "EGL_NATIVE_VISUAL_TYPE"; break;
+		case EGL_PRESERVED_RESOURCES: attrName = "EGL_PRESERVED_RESOURCES"; break;
+		case EGL_SAMPLES: attrName = "EGL_SAMPLES"; break;
+		case EGL_SAMPLE_BUFFERS: attrName = "EGL_SAMPLE_BUFFERS"; break;
+		case EGL_SURFACE_TYPE: attrName = "EGL_SURFACE_TYPE";
+			switch(aValue & 7)
+				{
+				case 0: valueName = "* | EGL_NONE"; break;
+				case 1: valueName = "* | PBUFFER"; break; // EGL_PBUFFER_BIT
+				case 2: valueName = "* | PIXMAP"; break; // EGL_PIXMAP_BIT
+				case 3: valueName = "* | PIXMAP | PBUFFER"; break;
+				case 4: valueName = "* | WINDOW"; break; // EGL_WINDOW_BIT
+				case 5: valueName = "* | WINDOW | PBUFFER"; break;
+				case 6: valueName = "* | WINDOW | PIXMAP"; break;
+				case 7: valueName = "* | WINDOW | PIXMAP | PBUFFER"; break;
+				}
+			break;
+		case EGL_TRANSPARENT_TYPE: attrName = "EGL_TRANSPARENT_TYPE";
+			if (aValue == EGL_TRANSPARENT_RGB)
+				valueName = "EGL_TRANSPARENT_RGB";
+			break;
+		case EGL_TRANSPARENT_BLUE_VALUE: attrName = "EGL_TRANSPARENT_BLUE_VALUE"; break;
+		case EGL_TRANSPARENT_GREEN_VALUE: attrName = "EGL_TRANSPARENT_GREEN_VALUE"; break;
+		case EGL_TRANSPARENT_RED_VALUE: attrName = "EGL_TRANSPARENT_RED_VALUE"; break;
+		case EGL_BIND_TO_TEXTURE_RGB: attrName = "EGL_BIND_TO_TEXTURE_RGB"; break;
+		case EGL_BIND_TO_TEXTURE_RGBA: attrName = "EGL_BIND_TO_TEXTURE_RGBA"; break;
+		case EGL_MIN_SWAP_INTERVAL: attrName = "EGL_MIN_SWAP_INTERVAL"; break;
+		case EGL_MAX_SWAP_INTERVAL: attrName = "EGL_MAX_SWAP_INTERVAL"; break;
+		case EGL_LUMINANCE_SIZE: attrName = "EGL_LUMINANCE_SIZE"; break;
+		case EGL_ALPHA_MASK_SIZE: attrName = "EGL_ALPHA_MASK_SIZE"; break;
+		case EGL_COLOR_BUFFER_TYPE: attrName = "EGL_COLOR_BUFFER_TYPE";
+			switch (aValue)
+				{
+				// EGL_COLOR_BUFFER_TYPE values
+				case EGL_RGB_BUFFER: valueName = "EGL_RGB_BUFFER"; break;
+				case EGL_LUMINANCE_BUFFER: valueName = "EGL_LUMINANCE_BUFFER"; break;
+				}
+			break;
+		case EGL_RENDERABLE_TYPE: attrName = "EGL_RENDERABLE_TYPE";
+			switch(aValue)
+				{
+				case 0: valueName = "EGL_NONE"; break;
+				case 1: valueName = "GL-ES"; break;
+				case 2: valueName = "VG"; break;
+				case 3: valueName = "VG | GL-ES"; break;
+				case 4: valueName = "GL-ES2"; break;
+				case 5: valueName = "GL-ES2 | GL-ES"; break;
+				case 6: valueName = "GL-ES2 | VG"; break;
+				case 7: valueName = "GL-ES2 | VG | GL-ES"; break;
+				case 8: valueName = "GL"; break;
+				case 9: valueName = "GL | GL-ES"; break;
+				case 10: valueName = "GL | VG"; break;
+				case 11: valueName = "GL | VG | GL-ES"; break;
+				case 12: valueName = "GL | GL-ES2"; break;
+				case 13: valueName = "GL | GL-ES2 | GL-ES"; break;
+				case 14: valueName = "GL | GL-ES2 | VG"; break;
+				case 15: valueName = "GL | GL-ES2 | VG | GL-ES"; break;
+				}
+			break;
+		case EGL_MATCH_NATIVE_PIXMAP: attrName = "EGL_MATCH_NATIVE_PIXMAP"; break; // Pseudo-attribute (not queryable)
+		case EGL_CONFORMANT: attrName = "EGL_CONFORMANT"; break;
+		case EGL_HEIGHT: attrName = "EGL_HEIGHT"; break;
+		case EGL_WIDTH: attrName = "EGL_WIDTH"; break;
+		case EGL_LARGEST_PBUFFER: attrName = "EGL_LARGEST_PBUFFER"; break;
+		case EGL_TEXTURE_FORMAT: attrName = "EGL_TEXTURE_FORMAT";
+			switch (aValue)
+				{
+				// config attribute values, for EGL_TEXTURE_FORMAT
+				case EGL_NO_TEXTURE: valueName = "EGL_NO_TEXTURE"; break;
+				case EGL_TEXTURE_RGB: valueName = "EGL_TEXTURE_RGB"; break;
+				case EGL_TEXTURE_RGBA: valueName = "EGL_TEXTURE_RGBA"; break;
+				case EGL_TEXTURE_2D: valueName = "EGL_TEXTURE_2D"; break;
+				}
+			break;
+		case EGL_TEXTURE_TARGET: attrName = "EGL_TEXTURE_TARGET"; break;
+		case EGL_MIPMAP_TEXTURE: attrName = "EGL_MIPMAP_TEXTURE"; break;
+		case EGL_MIPMAP_LEVEL: attrName = "EGL_MIPMAP_LEVEL"; break;
+		case EGL_RENDER_BUFFER: attrName = "EGL_RENDER_BUFFER";
+			switch (aValue)
+				{
+				// EGL_RENDER_BUFFER values / BindTexImage / ReleaseTexImage buffer targets
+				case EGL_BACK_BUFFER: valueName = "EGL_BACK_BUFFER"; break;
+				case EGL_SINGLE_BUFFER: valueName = "EGL_SINGLE_BUFFER"; break;
+				}
+			break;
+		case EGL_VG_COLORSPACE: attrName = "EGL_VG_COLORSPACE";
+			switch (aValue)
+				{
+				// OpenVG color spaces
+				case EGL_VG_COLORSPACE_sRGB: valueName = "EGL_VG_COLORSPACE_sRGB"; break;
+				case EGL_VG_COLORSPACE_LINEAR: valueName = "EGL_VG_COLORSPACE_LINEAR"; break;
+				}
+			break;
+		case EGL_VG_ALPHA_FORMAT: attrName = "EGL_VG_ALPHA_FORMAT";
+			switch (aValue)
+				{
+				// OpenVG alpha formats
+				case EGL_VG_ALPHA_FORMAT_NONPRE: valueName = "EGL_VG_ALPHA_FORMAT_NONPRE"; break;
+				case EGL_VG_ALPHA_FORMAT_PRE: valueName = "EGL_VG_ALPHA_FORMAT_PRE"; break;
+				}
+			break;
+		case EGL_HORIZONTAL_RESOLUTION: attrName = "EGL_HORIZONTAL_RESOLUTION"; break;
+		case EGL_VERTICAL_RESOLUTION: attrName = "EGL_VERTICAL_RESOLUTION"; break;
+		case EGL_PIXEL_ASPECT_RATIO: attrName = "EGL_PIXEL_ASPECT_RATIO"; break;
+		case EGL_SWAP_BEHAVIOR: attrName = "EGL_SWAP_BEHAVIOR"; break;
+		case EGL_MULTISAMPLE_RESOLVE: attrName = "EGL_MULTISAMPLE_RESOLVE"; break;
+		default: // unknown value - maybe buggy data or a later EGL version.  Debug prints include the hex anyway.
+			break;
+		}
+
+	if (aValue == EGL_NONE)
+		valueName = "EGL_NONE";
+	if (aAttrib == EGL_NONE)
+		attrName = "EGL_NONE";
+
+	*aAttrName = attrName;
+	*aValueName = valueName;
+	}
+
+// verbose debug logging of EGL Attibute Lists
+void TAttribUtils::TraceAttribList(const EGLint* aAttribList)
+    {
+    int length = 0;
+    if (aAttribList)
+        {
+		while (aAttribList[length] != EGL_NONE)
+			{
+			char* attrName = NULL;
+			char* valueName = NULL;
+			// try to get an attribute name string, and a description of the value
+			TraceAttribNames(aAttribList[length], aAttribList[length+1], &attrName, &valueName);
+			// print attribute & value as numbers, and also print a string name/description if one could be determined  
+			if (attrName)
+				{
+				if (valueName)
+					{
+					EGL_TRACE("  TraceAttribList aAttribList[%d]=0x%x (\"%s\"), aAttribList[%d]=0x%x (\"%s\")",
+							length, aAttribList[length], attrName, length+1, aAttribList[length+1], valueName);
+					}
+				else
+					{
+					EGL_TRACE("  TraceAttribList aAttribList[%d]=0x%x (\"%s\"), aAttribList[%d]=0x%x (%d)",
+							length, aAttribList[length], attrName, length+1, aAttribList[length+1], aAttribList[length+1]);
+					}
+				}
+			else
+				{
+				EGL_TRACE("  TraceAttribList aAttribList[%d]=0x%x, aAttribList[%d]=0x%x (%d)",
+						length, aAttribList[length], length+1, aAttribList[length+1], aAttribList[length+1]);			
+				}
+			length += 2;
+			}
+        ++length;
+        }
+    }
+
+// verbose debug logging of EGL Get Attibute fn
+void TAttribUtils::TraceGetAttrib(char* aApiName, char* aObjType, EGLDisplay aDisplay, EGLint aObject, EGLint aAttribute, EGLint *aValue, EGLBoolean aResult)
+	{
+	char* attrName = NULL;
+	char* valueName = NULL;
+	if (aResult)
+		{
+		// try to get an attribute name string, and a description of the value
+		TraceAttribNames(aAttribute, *aValue, &attrName, &valueName);
+		// print attribute & value as numbers, and also print a string name/description if one could be determined  
+		if (attrName)
+			{
+			if (valueName)
+				{
+				EGL_TRACE("%s succeeded: aDisplay=%d, %s=%d,  aAttrib=0x%x (\"%s\"), aValue=0x%x (\"%s\")",
+						aApiName, aDisplay, aObjType, aObject, aAttribute, attrName, *aValue, valueName);			
+				}
+			else
+				{
+				EGL_TRACE("%s succeeded: aDisplay=%d, %s=%d,  aAttrib=0x%x (\"%s\"), aValue=0x%x (%d)",
+						aApiName, aDisplay, aObjType, aObject, aAttribute, attrName, *aValue, *aValue);			
+				}
+			}
+		else
+			{
+			EGL_TRACE("%s succeeded: aDisplay=%d, %s=%d,  aAttrib=0x%x, aValue=0x%x (%d)",
+					aApiName, aDisplay, aObjType, aObject, aAttribute, *aValue, *aValue);			
+			}
+		}
+	else
+		{
+		// try to get an attribute name string
+		TraceAttribNames(aAttribute, 0, &attrName, &valueName);
+		if (attrName)
+			{
+			EGL_TRACE("%s failed: aDisplay=%d, %s=%d, attribute=0x%x (\"%s\")",
+					aApiName, aDisplay, aObjType, aObject, aAttribute, attrName);
+			}
+		else
+			{
+			EGL_TRACE("%s failed: aDisplay=%d, %s=%d, attribute=0x%x",
+					aApiName, aDisplay, aObjType, aObject, aAttribute);
+			}
+		}
+	}
+
+
+// verbose debug logging of EGL Get Attibute fn
+void TAttribUtils::TraceSetAttrib(char* aApiName, char* aObjType, EGLDisplay aDisplay, EGLint aObject, EGLint aAttribute, EGLint aValue)
+	{
+	char* attrName = NULL;
+	char* valueName = NULL;
+	// try to get an attribute name string, and a description of the value
+	TraceAttribNames(aAttribute, aValue, &attrName, &valueName);
+	// print attribute & value as numbers, and also print a string name/description if one could be determined  
+	if (attrName)
+		{
+		if (valueName)
+			{
+			EGL_TRACE("%s: aDisplay=%d, %s=%d,  aAttrib=0x%x (\"%s\"), aValue=0x%x (\"%s\")",
+					aApiName, aDisplay, aObjType, aObject, aAttribute, attrName, aValue, valueName);			
+			}
+		else
+			{
+			EGL_TRACE("%s: aDisplay=%d, %s=%d,  aAttrib=0x%x (\"%s\"), aValue=0x%x (%d)",
+					aApiName, aDisplay, aObjType, aObject, aAttribute, attrName, aValue, aValue);			
+			}
+		}
+	else
+		{
+		EGL_TRACE("%s: aDisplay=%d, %s=%d,  aAttrib=0x%x, aValue=0x%x (%d)",
+				aApiName, aDisplay, aObjType, aObject, aAttribute, aValue, aValue);			
+		}
+	}
+
+
+#endif
+