guestrendering/guestegl/src/egldebug.cpp
author Faisal Memon <faisal.memon@nokia.com>
Thu, 09 Sep 2010 16:50:12 +0100
branchbug235_bringup_0
changeset 18 3064c37a6509
parent 13 220791dae4c4
permissions -rwxr-xr-x
Add TPIP-free implementation of eglGetProcAddress

// 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