glfw/src/init.c

229 lines
7.1 KiB
C
Raw Normal View History

2010-09-07 15:34:51 +00:00
//========================================================================
// GLFW - An OpenGL library
2010-09-07 15:34:51 +00:00
// Platform: Any
2010-09-07 15:41:26 +00:00
// API version: 3.0
2010-09-07 15:34:51 +00:00
// WWW: http://www.glfw.org/
//------------------------------------------------------------------------
// Copyright (c) 2002-2006 Marcus Geelnard
// Copyright (c) 2006-2010 Camilla Berglund <elmindreda@elmindreda.org>
//
// This software is provided 'as-is', without any express or implied
// warranty. In no event will the authors be held liable for any damages
// arising from the use of this software.
//
// Permission is granted to anyone to use this software for any purpose,
// including commercial applications, and to alter it and redistribute it
// freely, subject to the following restrictions:
//
// 1. The origin of this software must not be misrepresented; you must not
// claim that you wrote the original software. If you use this software
// in a product, an acknowledgment in the product documentation would
// be appreciated but is not required.
//
// 2. Altered source versions must be plainly marked as such, and must not
// be misrepresented as being the original software.
//
// 3. This notice may not be removed or altered from any source
// distribution.
//
//========================================================================
#include "internal.h"
#include <string.h>
2010-09-16 02:11:06 +00:00
#include <stdlib.h>
2012-08-26 16:49:39 +00:00
#include <stdio.h>
#include <stdarg.h>
2010-09-16 02:11:06 +00:00
2012-08-26 18:11:32 +00:00
//------------------------------------------------------------------------
// Flag indicating whether GLFW has been successfully initialized
//------------------------------------------------------------------------
GLboolean _glfwInitialized = GL_FALSE;
2012-08-26 18:11:32 +00:00
//------------------------------------------------------------------------
// All shared and API-specific global data protected by _glfwInitialized
// This should only be touched after a call to glfwInit that has not been
// followed by a call to glfwTerminate
//------------------------------------------------------------------------
_GLFWlibrary _glfw;
2012-08-26 18:11:32 +00:00
//------------------------------------------------------------------------
2012-08-26 16:49:39 +00:00
// The current error callback
// This is outside of _glfw so it can be initialized and usable before
// glfwInit is called, which lets that function report errors
2012-08-26 18:11:32 +00:00
//------------------------------------------------------------------------
2012-08-26 16:49:39 +00:00
static GLFWerrorfun _glfwErrorCallback = NULL;
//========================================================================
// Returns a generic string representation of the specified error
//========================================================================
static const char* getErrorString(int error)
{
switch (error)
{
case GLFW_NO_ERROR:
return "No error";
case GLFW_NOT_INITIALIZED:
return "The GLFW library is not initialized";
case GLFW_NO_CURRENT_CONTEXT:
return "There is no current context";
case GLFW_INVALID_ENUM:
return "Invalid argument for enum parameter";
case GLFW_INVALID_VALUE:
return "Invalid value for parameter";
case GLFW_OUT_OF_MEMORY:
return "Out of memory";
case GLFW_API_UNAVAILABLE:
return "The requested client API is unavailable";
case GLFW_VERSION_UNAVAILABLE:
return "The requested client API version is unavailable";
case GLFW_PLATFORM_ERROR:
return "A platform-specific error occurred";
case GLFW_FORMAT_UNAVAILABLE:
return "The requested format is unavailable";
}
return "ERROR: UNKNOWN ERROR TOKEN PASSED TO glfwErrorString";
}
2012-08-26 18:11:32 +00:00
//////////////////////////////////////////////////////////////////////////
////// GLFW internal API //////
//////////////////////////////////////////////////////////////////////////
2012-08-26 16:49:39 +00:00
//========================================================================
// Register error
2012-08-26 16:49:39 +00:00
//========================================================================
void _glfwInputError(int error, const char* format, ...)
2012-08-26 16:49:39 +00:00
{
if (_glfwErrorCallback)
{
char buffer[16384];
const char* description;
if (format)
{
int count;
va_list vl;
va_start(vl, format);
count = vsnprintf(buffer, sizeof(buffer), format, vl);
va_end(vl);
if (count < 0)
buffer[sizeof(buffer) - 1] = '\0';
description = buffer;
}
else
description = getErrorString(error);
2012-08-26 16:49:39 +00:00
_glfwErrorCallback(error, description);
}
}
2010-09-16 02:11:06 +00:00
2010-09-09 18:59:50 +00:00
//////////////////////////////////////////////////////////////////////////
////// GLFW public API //////
//////////////////////////////////////////////////////////////////////////
2010-09-07 15:34:51 +00:00
//========================================================================
// Initialize various GLFW state
2010-09-07 15:34:51 +00:00
//========================================================================
2012-02-07 13:58:58 +00:00
GLFWAPI int glfwInit(void)
2010-09-07 15:34:51 +00:00
{
2010-09-08 12:45:52 +00:00
if (_glfwInitialized)
2010-09-07 15:34:51 +00:00
return GL_TRUE;
memset(&_glfw, 0, sizeof(_glfw));
2010-09-07 15:34:51 +00:00
2010-09-08 12:45:52 +00:00
if (!_glfwPlatformInit())
{
_glfwPlatformTerminate();
2010-09-07 15:34:51 +00:00
return GL_FALSE;
}
2010-09-07 15:34:51 +00:00
_glfw.monitors = _glfwPlatformGetMonitors(&_glfw.monitorCount);
if (!_glfw.monitors)
2012-09-12 17:35:52 +00:00
{
_glfwPlatformTerminate();
return GL_FALSE;
}
2010-09-07 15:34:51 +00:00
_glfwInitialized = GL_TRUE;
2012-10-22 00:59:05 +00:00
// Not all window hints have zero as their default value
glfwDefaultWindowHints();
2010-09-07 15:34:51 +00:00
return GL_TRUE;
}
//========================================================================
// Close window and shut down library
//========================================================================
2010-09-08 12:45:52 +00:00
GLFWAPI void glfwTerminate(void)
2010-09-07 15:34:51 +00:00
{
2010-09-08 12:45:52 +00:00
if (!_glfwInitialized)
2010-09-07 15:34:51 +00:00
return;
// Close all remaining windows
while (_glfw.windowListHead)
glfwDestroyWindow(_glfw.windowListHead);
2012-09-12 17:35:52 +00:00
_glfwDestroyMonitors();
_glfwPlatformTerminate();
2010-09-07 15:34:51 +00:00
_glfwInitialized = GL_FALSE;
}
//========================================================================
// Get GLFW version
2012-08-26 18:11:32 +00:00
// This function may be called without GLFW having been initialized
2010-09-07 15:34:51 +00:00
//========================================================================
2010-09-08 13:58:43 +00:00
GLFWAPI void glfwGetVersion(int* major, int* minor, int* rev)
2010-09-07 15:34:51 +00:00
{
2010-09-08 12:45:52 +00:00
if (major != NULL)
*major = GLFW_VERSION_MAJOR;
2010-09-08 12:45:52 +00:00
if (minor != NULL)
*minor = GLFW_VERSION_MINOR;
2010-09-08 12:45:52 +00:00
if (rev != NULL)
*rev = GLFW_VERSION_REVISION;
2010-09-07 15:34:51 +00:00
}
2010-09-13 16:05:59 +00:00
//========================================================================
// Get the GLFW version string
2012-08-26 18:11:32 +00:00
// This function may be called without GLFW having been initialized
2010-09-13 16:05:59 +00:00
//========================================================================
GLFWAPI const char* glfwGetVersionString(void)
{
return _glfwPlatformGetVersionString();
}
2012-08-26 16:49:39 +00:00
//========================================================================
// Sets the callback function for GLFW errors
// This function may be called without GLFW having been initialized
//========================================================================
GLFWAPI void glfwSetErrorCallback(GLFWerrorfun cbfun)
{
_glfwErrorCallback = cbfun;
}