glfw/src/window.c

1154 lines
34 KiB
C
Raw Normal View History

2010-09-07 15:34:51 +00:00
//========================================================================
2019-04-16 12:43:29 +00:00
// GLFW 3.4 - www.glfw.org
2010-09-07 15:34:51 +00:00
//------------------------------------------------------------------------
// Copyright (c) 2002-2006 Marcus Geelnard
2019-04-15 18:50:00 +00:00
// Copyright (c) 2006-2019 Camilla Löwy <elmindreda@glfw.org>
// Copyright (c) 2012 Torsten Walluhn <tw@mad-cad.net>
2010-09-07 15:34:51 +00:00
//
// 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 <assert.h>
#include <string.h>
2010-09-09 16:15:32 +00:00
#include <stdlib.h>
#include <float.h>
2010-09-07 15:34:51 +00:00
2010-09-09 18:59:50 +00:00
//////////////////////////////////////////////////////////////////////////
////// GLFW event API //////
2010-09-09 18:59:50 +00:00
//////////////////////////////////////////////////////////////////////////
// Notifies shared code that a window has lost or received input focus
//
2015-08-23 17:30:04 +00:00
void _glfwInputWindowFocus(_GLFWwindow* window, GLFWbool focused)
{
assert(window != NULL);
assert(focused == GLFW_TRUE || focused == GLFW_FALSE);
2017-01-29 15:17:05 +00:00
if (window->callbacks.focus)
window->callbacks.focus((GLFWwindow*) window, focused);
2014-04-08 13:50:27 +00:00
2017-01-29 15:17:05 +00:00
if (!focused)
{
int key, button;
2014-04-08 13:50:27 +00:00
2017-01-29 15:17:05 +00:00
for (key = 0; key <= GLFW_KEY_LAST; key++)
2014-04-08 13:50:27 +00:00
{
2017-01-29 15:17:05 +00:00
if (window->keys[key] == GLFW_PRESS)
{
const int scancode = _glfw.platform.getKeyScancode(key);
_glfwInputKey(window, key, scancode, GLFW_RELEASE, 0);
}
2014-04-08 13:50:27 +00:00
}
2017-01-29 15:17:05 +00:00
for (button = 0; button <= GLFW_MOUSE_BUTTON_LAST; button++)
2012-09-16 10:42:51 +00:00
{
2017-01-29 15:17:05 +00:00
if (window->mouseButtons[button] == GLFW_PRESS)
_glfwInputMouseClick(window, button, GLFW_RELEASE, 0);
2012-09-16 10:42:51 +00:00
}
}
}
// Notifies shared code that a window has moved
// The position is specified in content area relative screen coordinates
//
void _glfwInputWindowPos(_GLFWwindow* window, int x, int y)
{
assert(window != NULL);
2013-01-15 20:34:26 +00:00
if (window->callbacks.pos)
window->callbacks.pos((GLFWwindow*) window, x, y);
}
// Notifies shared code that a window has been resized
// The size is specified in screen coordinates
//
void _glfwInputWindowSize(_GLFWwindow* window, int width, int height)
{
assert(window != NULL);
assert(width >= 0);
assert(height >= 0);
2013-01-15 20:34:26 +00:00
if (window->callbacks.size)
window->callbacks.size((GLFWwindow*) window, width, height);
}
// Notifies shared code that a window has been iconified or restored
//
2015-11-05 07:58:40 +00:00
void _glfwInputWindowIconify(_GLFWwindow* window, GLFWbool iconified)
{
assert(window != NULL);
assert(iconified == GLFW_TRUE || iconified == GLFW_FALSE);
2013-01-15 20:34:26 +00:00
if (window->callbacks.iconify)
window->callbacks.iconify((GLFWwindow*) window, iconified);
}
// Notifies shared code that a window has been maximized or restored
//
void _glfwInputWindowMaximize(_GLFWwindow* window, GLFWbool maximized)
{
assert(window != NULL);
assert(maximized == GLFW_TRUE || maximized == GLFW_FALSE);
if (window->callbacks.maximize)
window->callbacks.maximize((GLFWwindow*) window, maximized);
}
// Notifies shared code that a window framebuffer has been resized
// The size is specified in pixels
//
void _glfwInputFramebufferSize(_GLFWwindow* window, int width, int height)
{
assert(window != NULL);
assert(width >= 0);
assert(height >= 0);
if (window->callbacks.fbsize)
window->callbacks.fbsize((GLFWwindow*) window, width, height);
}
// Notifies shared code that a window content scale has changed
// The scale is specified as the ratio between the current and default DPI
//
void _glfwInputWindowContentScale(_GLFWwindow* window, float xscale, float yscale)
{
assert(window != NULL);
assert(xscale > 0.f);
assert(xscale < FLT_MAX);
assert(yscale > 0.f);
assert(yscale < FLT_MAX);
if (window->callbacks.scale)
window->callbacks.scale((GLFWwindow*) window, xscale, yscale);
}
// Notifies shared code that the window contents needs updating
//
void _glfwInputWindowDamage(_GLFWwindow* window)
{
assert(window != NULL);
2013-01-15 20:34:26 +00:00
if (window->callbacks.refresh)
window->callbacks.refresh((GLFWwindow*) window);
}
// Notifies shared code that the user wishes to close a window
//
void _glfwInputWindowCloseRequest(_GLFWwindow* window)
{
assert(window != NULL);
2016-12-08 13:53:01 +00:00
window->shouldClose = GLFW_TRUE;
2013-01-15 20:34:26 +00:00
if (window->callbacks.close)
window->callbacks.close((GLFWwindow*) window);
}
// Notifies shared code that a window has changed its desired monitor
//
2017-10-26 16:05:56 +00:00
void _glfwInputWindowMonitor(_GLFWwindow* window, _GLFWmonitor* monitor)
{
assert(window != NULL);
window->monitor = monitor;
}
2010-09-09 18:59:50 +00:00
//////////////////////////////////////////////////////////////////////////
////// GLFW public API //////
//////////////////////////////////////////////////////////////////////////
2010-09-07 15:34:51 +00:00
GLFWAPI GLFWwindow* glfwCreateWindow(int width, int height,
const char* title,
GLFWmonitor* monitor,
GLFWwindow* share)
2010-09-07 15:34:51 +00:00
{
_GLFWfbconfig fbconfig;
_GLFWctxconfig ctxconfig;
2010-09-07 15:34:51 +00:00
_GLFWwndconfig wndconfig;
2010-09-09 16:15:32 +00:00
_GLFWwindow* window;
2010-09-07 15:34:51 +00:00
2016-03-02 16:58:05 +00:00
assert(title != NULL);
2017-02-23 16:47:41 +00:00
assert(width >= 0);
assert(height >= 0);
_GLFW_REQUIRE_INIT_OR_RETURN(NULL);
2013-01-04 06:28:12 +00:00
if (width <= 0 || height <= 0)
{
2016-03-29 08:49:34 +00:00
_glfwInputError(GLFW_INVALID_VALUE,
"Invalid window size %ix%i",
width, height);
return NULL;
2013-01-04 06:28:12 +00:00
}
2010-09-09 16:15:32 +00:00
2015-06-07 16:14:07 +00:00
fbconfig = _glfw.hints.framebuffer;
ctxconfig = _glfw.hints.context;
wndconfig = _glfw.hints.window;
wndconfig.width = width;
wndconfig.height = height;
wndconfig.title = title;
ctxconfig.share = (_GLFWwindow*) share;
2010-09-07 15:34:51 +00:00
if (!_glfwIsValidContextConfig(&ctxconfig))
return NULL;
2010-09-07 15:34:51 +00:00
window = _glfw_calloc(1, sizeof(_GLFWwindow));
window->next = _glfw.windowListHead;
_glfw.windowListHead = window;
2011-03-07 13:30:23 +00:00
2015-06-07 16:14:07 +00:00
window->videoMode.width = width;
window->videoMode.height = height;
window->videoMode.redBits = fbconfig.redBits;
window->videoMode.greenBits = fbconfig.greenBits;
window->videoMode.blueBits = fbconfig.blueBits;
window->videoMode.refreshRate = _glfw.hints.refreshRate;
window->monitor = (_GLFWmonitor*) monitor;
window->resizable = wndconfig.resizable;
window->decorated = wndconfig.decorated;
window->autoIconify = wndconfig.autoIconify;
window->floating = wndconfig.floating;
window->focusOnShow = wndconfig.focusOnShow;
window->mousePassthrough = wndconfig.mousePassthrough;
window->cursorMode = GLFW_CURSOR_NORMAL;
2010-09-07 15:34:51 +00:00
window->doublebuffer = fbconfig.doublebuffer;
window->minwidth = GLFW_DONT_CARE;
window->minheight = GLFW_DONT_CARE;
window->maxwidth = GLFW_DONT_CARE;
window->maxheight = GLFW_DONT_CARE;
window->numer = GLFW_DONT_CARE;
window->denom = GLFW_DONT_CARE;
if (!_glfw.platform.createWindow(window, &wndconfig, &ctxconfig, &fbconfig))
2010-09-09 16:15:32 +00:00
{
glfwDestroyWindow((GLFWwindow*) window);
return NULL;
2010-09-09 16:15:32 +00:00
}
2010-09-07 15:34:51 +00:00
return (GLFWwindow*) window;
2010-09-09 16:15:32 +00:00
}
2012-10-22 00:59:05 +00:00
void glfwDefaultWindowHints(void)
{
_GLFW_REQUIRE_INIT();
2012-10-22 00:59:05 +00:00
// The default is OpenGL with minimum version 1.0
memset(&_glfw.hints.context, 0, sizeof(_glfw.hints.context));
_glfw.hints.context.client = GLFW_OPENGL_API;
_glfw.hints.context.source = GLFW_NATIVE_CONTEXT_API;
_glfw.hints.context.major = 1;
_glfw.hints.context.minor = 0;
2012-10-22 00:59:05 +00:00
// The default is a focused, visible, resizable window with decorations
memset(&_glfw.hints.window, 0, sizeof(_glfw.hints.window));
_glfw.hints.window.resizable = GLFW_TRUE;
_glfw.hints.window.visible = GLFW_TRUE;
_glfw.hints.window.decorated = GLFW_TRUE;
_glfw.hints.window.focused = GLFW_TRUE;
_glfw.hints.window.autoIconify = GLFW_TRUE;
_glfw.hints.window.centerCursor = GLFW_TRUE;
_glfw.hints.window.focusOnShow = GLFW_TRUE;
_glfw.hints.window.xpos = GLFW_ANY_POSITION;
_glfw.hints.window.ypos = GLFW_ANY_POSITION;
2012-10-22 00:59:05 +00:00
2014-04-24 17:21:10 +00:00
// The default is 24 bits of color, 24 bits of depth and 8 bits of stencil,
// double buffered
memset(&_glfw.hints.framebuffer, 0, sizeof(_glfw.hints.framebuffer));
2015-06-07 16:14:07 +00:00
_glfw.hints.framebuffer.redBits = 8;
_glfw.hints.framebuffer.greenBits = 8;
_glfw.hints.framebuffer.blueBits = 8;
_glfw.hints.framebuffer.alphaBits = 8;
_glfw.hints.framebuffer.depthBits = 24;
_glfw.hints.framebuffer.stencilBits = 8;
2015-08-23 17:30:04 +00:00
_glfw.hints.framebuffer.doublebuffer = GLFW_TRUE;
2015-06-07 16:22:38 +00:00
// The default is to select the highest available refresh rate
_glfw.hints.refreshRate = GLFW_DONT_CARE;
// The default is to use full Retina resolution framebuffers
_glfw.hints.window.ns.retina = GLFW_TRUE;
2012-10-22 00:59:05 +00:00
}
2016-01-27 02:25:21 +00:00
GLFWAPI void glfwWindowHint(int hint, int value)
2010-09-07 15:34:51 +00:00
{
_GLFW_REQUIRE_INIT();
2010-09-07 15:34:51 +00:00
2016-01-27 02:25:21 +00:00
switch (hint)
2010-09-07 15:34:51 +00:00
{
case GLFW_RED_BITS:
2016-01-27 02:25:21 +00:00
_glfw.hints.framebuffer.redBits = value;
2017-09-10 00:55:29 +00:00
return;
case GLFW_GREEN_BITS:
2016-01-27 02:25:21 +00:00
_glfw.hints.framebuffer.greenBits = value;
2017-09-10 00:55:29 +00:00
return;
case GLFW_BLUE_BITS:
2016-01-27 02:25:21 +00:00
_glfw.hints.framebuffer.blueBits = value;
2017-09-10 00:55:29 +00:00
return;
case GLFW_ALPHA_BITS:
2016-01-27 02:25:21 +00:00
_glfw.hints.framebuffer.alphaBits = value;
2017-09-10 00:55:29 +00:00
return;
case GLFW_DEPTH_BITS:
2016-01-27 02:25:21 +00:00
_glfw.hints.framebuffer.depthBits = value;
2017-09-10 00:55:29 +00:00
return;
case GLFW_STENCIL_BITS:
2016-01-27 02:25:21 +00:00
_glfw.hints.framebuffer.stencilBits = value;
2017-09-10 00:55:29 +00:00
return;
2010-09-07 15:34:51 +00:00
case GLFW_ACCUM_RED_BITS:
2016-01-27 02:25:21 +00:00
_glfw.hints.framebuffer.accumRedBits = value;
2017-09-10 00:55:29 +00:00
return;
2010-09-07 15:34:51 +00:00
case GLFW_ACCUM_GREEN_BITS:
2016-01-27 02:25:21 +00:00
_glfw.hints.framebuffer.accumGreenBits = value;
2017-09-10 00:55:29 +00:00
return;
2010-09-07 15:34:51 +00:00
case GLFW_ACCUM_BLUE_BITS:
2016-01-27 02:25:21 +00:00
_glfw.hints.framebuffer.accumBlueBits = value;
2017-09-10 00:55:29 +00:00
return;
2010-09-07 15:34:51 +00:00
case GLFW_ACCUM_ALPHA_BITS:
2016-01-27 02:25:21 +00:00
_glfw.hints.framebuffer.accumAlphaBits = value;
2017-09-10 00:55:29 +00:00
return;
2010-09-07 15:34:51 +00:00
case GLFW_AUX_BUFFERS:
2016-01-27 02:25:21 +00:00
_glfw.hints.framebuffer.auxBuffers = value;
2017-09-10 00:55:29 +00:00
return;
2010-09-07 15:34:51 +00:00
case GLFW_STEREO:
2016-01-27 02:25:21 +00:00
_glfw.hints.framebuffer.stereo = value ? GLFW_TRUE : GLFW_FALSE;
2017-09-10 00:55:29 +00:00
return;
2014-04-24 17:21:10 +00:00
case GLFW_DOUBLEBUFFER:
2016-01-27 02:25:21 +00:00
_glfw.hints.framebuffer.doublebuffer = value ? GLFW_TRUE : GLFW_FALSE;
2017-09-10 00:55:29 +00:00
return;
case GLFW_TRANSPARENT_FRAMEBUFFER:
_glfw.hints.framebuffer.transparent = value ? GLFW_TRUE : GLFW_FALSE;
return;
2015-06-07 16:22:38 +00:00
case GLFW_SAMPLES:
2016-01-27 02:25:21 +00:00
_glfw.hints.framebuffer.samples = value;
2017-09-10 00:55:29 +00:00
return;
2015-06-07 16:22:38 +00:00
case GLFW_SRGB_CAPABLE:
2016-01-27 02:25:21 +00:00
_glfw.hints.framebuffer.sRGB = value ? GLFW_TRUE : GLFW_FALSE;
2017-09-10 00:55:29 +00:00
return;
case GLFW_RESIZABLE:
2016-01-27 02:25:21 +00:00
_glfw.hints.window.resizable = value ? GLFW_TRUE : GLFW_FALSE;
2017-09-10 00:55:29 +00:00
return;
2013-04-08 13:16:32 +00:00
case GLFW_DECORATED:
2016-01-27 02:25:21 +00:00
_glfw.hints.window.decorated = value ? GLFW_TRUE : GLFW_FALSE;
2017-09-10 00:55:29 +00:00
return;
case GLFW_FOCUSED:
2016-01-27 02:25:21 +00:00
_glfw.hints.window.focused = value ? GLFW_TRUE : GLFW_FALSE;
2017-09-10 00:55:29 +00:00
return;
case GLFW_AUTO_ICONIFY:
2016-01-27 02:25:21 +00:00
_glfw.hints.window.autoIconify = value ? GLFW_TRUE : GLFW_FALSE;
2017-09-10 00:55:29 +00:00
return;
2014-05-23 12:01:02 +00:00
case GLFW_FLOATING:
2016-01-27 02:25:21 +00:00
_glfw.hints.window.floating = value ? GLFW_TRUE : GLFW_FALSE;
2017-09-10 00:55:29 +00:00
return;
case GLFW_MAXIMIZED:
_glfw.hints.window.maximized = value ? GLFW_TRUE : GLFW_FALSE;
2017-09-10 00:55:29 +00:00
return;
case GLFW_VISIBLE:
2016-01-27 02:25:21 +00:00
_glfw.hints.window.visible = value ? GLFW_TRUE : GLFW_FALSE;
2017-09-10 00:55:29 +00:00
return;
case GLFW_POSITION_X:
_glfw.hints.window.xpos = value;
return;
case GLFW_POSITION_Y:
_glfw.hints.window.ypos = value;
return;
case GLFW_COCOA_RETINA_FRAMEBUFFER:
_glfw.hints.window.ns.retina = value ? GLFW_TRUE : GLFW_FALSE;
return;
case GLFW_WIN32_KEYBOARD_MENU:
_glfw.hints.window.win32.keymenu = value ? GLFW_TRUE : GLFW_FALSE;
2017-09-10 00:55:29 +00:00
return;
case GLFW_COCOA_GRAPHICS_SWITCHING:
_glfw.hints.context.nsgl.offline = value ? GLFW_TRUE : GLFW_FALSE;
2017-09-10 00:55:29 +00:00
return;
case GLFW_SCALE_TO_MONITOR:
_glfw.hints.window.scaleToMonitor = value ? GLFW_TRUE : GLFW_FALSE;
return;
2017-02-06 14:03:50 +00:00
case GLFW_CENTER_CURSOR:
_glfw.hints.window.centerCursor = value ? GLFW_TRUE : GLFW_FALSE;
2017-09-10 00:55:29 +00:00
return;
case GLFW_FOCUS_ON_SHOW:
_glfw.hints.window.focusOnShow = value ? GLFW_TRUE : GLFW_FALSE;
return;
case GLFW_MOUSE_PASSTHROUGH:
_glfw.hints.window.mousePassthrough = value ? GLFW_TRUE : GLFW_FALSE;
return;
case GLFW_CLIENT_API:
_glfw.hints.context.client = value;
2017-09-10 00:55:29 +00:00
return;
case GLFW_CONTEXT_CREATION_API:
_glfw.hints.context.source = value;
2017-09-10 00:55:29 +00:00
return;
case GLFW_CONTEXT_VERSION_MAJOR:
2016-01-27 02:25:21 +00:00
_glfw.hints.context.major = value;
2017-09-10 00:55:29 +00:00
return;
case GLFW_CONTEXT_VERSION_MINOR:
2016-01-27 02:25:21 +00:00
_glfw.hints.context.minor = value;
2017-09-10 00:55:29 +00:00
return;
case GLFW_CONTEXT_ROBUSTNESS:
2016-01-27 02:25:21 +00:00
_glfw.hints.context.robustness = value;
2017-09-10 00:55:29 +00:00
return;
2010-09-07 15:34:51 +00:00
case GLFW_OPENGL_FORWARD_COMPAT:
2016-01-27 02:25:21 +00:00
_glfw.hints.context.forward = value ? GLFW_TRUE : GLFW_FALSE;
2017-09-10 00:55:29 +00:00
return;
case GLFW_CONTEXT_DEBUG:
2016-01-27 02:25:21 +00:00
_glfw.hints.context.debug = value ? GLFW_TRUE : GLFW_FALSE;
2017-09-10 00:55:29 +00:00
return;
case GLFW_CONTEXT_NO_ERROR:
2016-01-27 02:25:21 +00:00
_glfw.hints.context.noerror = value ? GLFW_TRUE : GLFW_FALSE;
2017-09-10 00:55:29 +00:00
return;
2010-09-07 15:34:51 +00:00
case GLFW_OPENGL_PROFILE:
2016-01-27 02:25:21 +00:00
_glfw.hints.context.profile = value;
2017-09-10 00:55:29 +00:00
return;
case GLFW_CONTEXT_RELEASE_BEHAVIOR:
2016-01-27 02:25:21 +00:00
_glfw.hints.context.release = value;
2017-09-10 00:55:29 +00:00
return;
2015-06-07 16:22:38 +00:00
case GLFW_REFRESH_RATE:
2016-01-27 02:25:21 +00:00
_glfw.hints.refreshRate = value;
2017-09-10 00:55:29 +00:00
return;
2010-09-07 15:34:51 +00:00
}
2017-09-10 00:55:29 +00:00
_glfwInputError(GLFW_INVALID_ENUM, "Invalid window hint 0x%08X", hint);
2010-09-07 15:34:51 +00:00
}
GLFWAPI void glfwWindowHintString(int hint, const char* value)
{
assert(value != NULL);
_GLFW_REQUIRE_INIT();
switch (hint)
{
case GLFW_COCOA_FRAME_NAME:
strncpy(_glfw.hints.window.ns.frameName, value,
sizeof(_glfw.hints.window.ns.frameName) - 1);
return;
case GLFW_X11_CLASS_NAME:
strncpy(_glfw.hints.window.x11.className, value,
sizeof(_glfw.hints.window.x11.className) - 1);
return;
case GLFW_X11_INSTANCE_NAME:
strncpy(_glfw.hints.window.x11.instanceName, value,
sizeof(_glfw.hints.window.x11.instanceName) - 1);
return;
case GLFW_WAYLAND_APP_ID:
strncpy(_glfw.hints.window.wl.appId, value,
sizeof(_glfw.hints.window.wl.appId) - 1);
return;
}
_glfwInputError(GLFW_INVALID_ENUM, "Invalid window hint string 0x%08X", hint);
}
GLFWAPI void glfwDestroyWindow(GLFWwindow* handle)
2010-09-07 15:34:51 +00:00
{
2011-04-06 18:38:55 +00:00
_GLFWwindow* window = (_GLFWwindow*) handle;
_GLFW_REQUIRE_INIT();
2010-09-07 15:34:51 +00:00
2011-03-08 22:14:42 +00:00
// Allow closing of NULL (to match the behavior of free)
if (window == NULL)
return;
// Clear all callbacks to avoid exposing a half torn-down window object
2013-01-15 20:34:26 +00:00
memset(&window->callbacks, 0, sizeof(window->callbacks));
// The window's context must not be current on another thread when the
// window is destroyed
if (window == _glfwPlatformGetTls(&_glfw.contextSlot))
glfwMakeContextCurrent(NULL);
2010-09-07 15:34:51 +00:00
_glfw.platform.destroyWindow(window);
2010-09-09 16:15:32 +00:00
2010-09-16 00:05:01 +00:00
// Unlink window from global linked list
{
_GLFWwindow** prev = &_glfw.windowListHead;
2010-09-16 00:05:01 +00:00
while (*prev != window)
prev = &((*prev)->next);
2010-09-09 22:06:23 +00:00
2010-09-16 00:05:01 +00:00
*prev = window->next;
}
2010-09-09 22:30:10 +00:00
_glfw_free(window);
2010-09-07 15:34:51 +00:00
}
GLFWAPI int glfwWindowShouldClose(GLFWwindow* handle)
{
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
_GLFW_REQUIRE_INIT_OR_RETURN(0);
2016-12-08 13:53:01 +00:00
return window->shouldClose;
}
GLFWAPI void glfwSetWindowShouldClose(GLFWwindow* handle, int value)
{
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
_GLFW_REQUIRE_INIT();
2016-12-08 13:53:01 +00:00
window->shouldClose = value;
}
GLFWAPI void glfwSetWindowTitle(GLFWwindow* handle, const char* title)
2010-09-07 15:34:51 +00:00
{
2011-04-06 18:38:55 +00:00
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
assert(title != NULL);
_GLFW_REQUIRE_INIT();
_glfw.platform.setWindowTitle(window, title);
2010-09-07 15:34:51 +00:00
}
GLFWAPI void glfwSetWindowIcon(GLFWwindow* handle,
int count, const GLFWimage* images)
{
int i;
_GLFWwindow* window = (_GLFWwindow*) handle;
assert(window != NULL);
assert(count >= 0);
assert(count == 0 || images != NULL);
_GLFW_REQUIRE_INIT();
if (count < 0)
{
_glfwInputError(GLFW_INVALID_VALUE, "Invalid image count for window icon");
return;
}
for (i = 0; i < count; i++)
{
assert(images[i].pixels != NULL);
if (images[i].width <= 0 || images[i].height <= 0)
{
_glfwInputError(GLFW_INVALID_VALUE,
"Invalid image dimensions for window icon");
return;
}
}
_glfw.platform.setWindowIcon(window, count, images);
}
GLFWAPI void glfwGetWindowPos(GLFWwindow* handle, int* xpos, int* ypos)
{
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
2014-04-07 13:28:32 +00:00
if (xpos)
*xpos = 0;
if (ypos)
*ypos = 0;
_GLFW_REQUIRE_INIT();
_glfw.platform.getWindowPos(window, xpos, ypos);
}
GLFWAPI void glfwSetWindowPos(GLFWwindow* handle, int xpos, int ypos)
{
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
_GLFW_REQUIRE_INIT();
if (window->monitor)
return;
_glfw.platform.setWindowPos(window, xpos, ypos);
}
GLFWAPI void glfwGetWindowSize(GLFWwindow* handle, int* width, int* height)
2010-09-07 15:34:51 +00:00
{
2011-04-06 18:38:55 +00:00
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
2014-04-07 13:28:32 +00:00
if (width)
*width = 0;
if (height)
*height = 0;
_GLFW_REQUIRE_INIT();
_glfw.platform.getWindowSize(window, width, height);
2010-09-07 15:34:51 +00:00
}
GLFWAPI void glfwSetWindowSize(GLFWwindow* handle, int width, int height)
2010-09-07 15:34:51 +00:00
{
2011-04-06 18:38:55 +00:00
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
2017-02-23 16:47:41 +00:00
assert(width >= 0);
assert(height >= 0);
2011-04-06 18:38:55 +00:00
_GLFW_REQUIRE_INIT();
window->videoMode.width = width;
window->videoMode.height = height;
_glfw.platform.setWindowSize(window, width, height);
2010-09-07 15:34:51 +00:00
}
GLFWAPI void glfwSetWindowSizeLimits(GLFWwindow* handle,
int minwidth, int minheight,
int maxwidth, int maxheight)
{
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
_GLFW_REQUIRE_INIT();
if (minwidth != GLFW_DONT_CARE && minheight != GLFW_DONT_CARE)
{
if (minwidth < 0 || minheight < 0)
{
_glfwInputError(GLFW_INVALID_VALUE,
"Invalid window minimum size %ix%i",
minwidth, minheight);
return;
}
}
if (maxwidth != GLFW_DONT_CARE && maxheight != GLFW_DONT_CARE)
{
if (maxwidth < 0 || maxheight < 0 ||
maxwidth < minwidth || maxheight < minheight)
{
_glfwInputError(GLFW_INVALID_VALUE,
"Invalid window maximum size %ix%i",
maxwidth, maxheight);
return;
}
}
window->minwidth = minwidth;
window->minheight = minheight;
window->maxwidth = maxwidth;
window->maxheight = maxheight;
if (window->monitor || !window->resizable)
return;
_glfw.platform.setWindowSizeLimits(window,
minwidth, minheight,
maxwidth, maxheight);
}
GLFWAPI void glfwSetWindowAspectRatio(GLFWwindow* handle, int numer, int denom)
{
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
2017-02-23 16:47:41 +00:00
assert(numer != 0);
assert(denom != 0);
_GLFW_REQUIRE_INIT();
if (numer != GLFW_DONT_CARE && denom != GLFW_DONT_CARE)
{
if (numer <= 0 || denom <= 0)
{
_glfwInputError(GLFW_INVALID_VALUE,
"Invalid window aspect ratio %i:%i",
numer, denom);
return;
}
}
window->numer = numer;
window->denom = denom;
if (window->monitor || !window->resizable)
return;
_glfw.platform.setWindowAspectRatio(window, numer, denom);
}
GLFWAPI void glfwGetFramebufferSize(GLFWwindow* handle, int* width, int* height)
{
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-05-03 15:44:46 +00:00
assert(window != NULL);
2014-04-07 13:28:32 +00:00
if (width)
*width = 0;
if (height)
*height = 0;
2014-04-07 13:28:32 +00:00
_GLFW_REQUIRE_INIT();
_glfw.platform.getFramebufferSize(window, width, height);
}
2014-03-25 20:30:13 +00:00
GLFWAPI void glfwGetWindowFrameSize(GLFWwindow* handle,
int* left, int* top,
int* right, int* bottom)
{
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
2014-04-07 13:28:32 +00:00
if (left)
*left = 0;
if (top)
*top = 0;
if (right)
*right = 0;
if (bottom)
*bottom = 0;
2014-03-25 20:30:13 +00:00
_GLFW_REQUIRE_INIT();
_glfw.platform.getWindowFrameSize(window, left, top, right, bottom);
2014-03-25 20:30:13 +00:00
}
GLFWAPI void glfwGetWindowContentScale(GLFWwindow* handle,
float* xscale, float* yscale)
{
_GLFWwindow* window = (_GLFWwindow*) handle;
assert(window != NULL);
if (xscale)
*xscale = 0.f;
if (yscale)
*yscale = 0.f;
_GLFW_REQUIRE_INIT();
_glfw.platform.getWindowContentScale(window, xscale, yscale);
}
GLFWAPI float glfwGetWindowOpacity(GLFWwindow* handle)
{
_GLFWwindow* window = (_GLFWwindow*) handle;
assert(window != NULL);
_GLFW_REQUIRE_INIT_OR_RETURN(1.f);
return _glfw.platform.getWindowOpacity(window);
}
GLFWAPI void glfwSetWindowOpacity(GLFWwindow* handle, float opacity)
{
_GLFWwindow* window = (_GLFWwindow*) handle;
assert(window != NULL);
assert(opacity == opacity);
assert(opacity >= 0.f);
assert(opacity <= 1.f);
_GLFW_REQUIRE_INIT();
if (opacity != opacity || opacity < 0.f || opacity > 1.f)
{
_glfwInputError(GLFW_INVALID_VALUE, "Invalid window opacity %f", opacity);
return;
}
_glfw.platform.setWindowOpacity(window, opacity);
}
GLFWAPI void glfwIconifyWindow(GLFWwindow* handle)
2010-09-07 15:34:51 +00:00
{
2011-04-06 18:38:55 +00:00
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
_GLFW_REQUIRE_INIT();
_glfw.platform.iconifyWindow(window);
2010-09-07 15:34:51 +00:00
}
GLFWAPI void glfwRestoreWindow(GLFWwindow* handle)
{
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
_GLFW_REQUIRE_INIT();
_glfw.platform.restoreWindow(window);
}
GLFWAPI void glfwMaximizeWindow(GLFWwindow* handle)
{
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-07-11 14:39:53 +00:00
assert(window != NULL);
_GLFW_REQUIRE_INIT();
if (window->monitor)
return;
_glfw.platform.maximizeWindow(window);
}
GLFWAPI void glfwShowWindow(GLFWwindow* handle)
{
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
_GLFW_REQUIRE_INIT();
2012-09-27 19:37:36 +00:00
if (window->monitor)
return;
_glfw.platform.showWindow(window);
if (window->focusOnShow)
_glfw.platform.focusWindow(window);
}
GLFWAPI void glfwRequestWindowAttention(GLFWwindow* handle)
{
_GLFWwindow* window = (_GLFWwindow*) handle;
assert(window != NULL);
_GLFW_REQUIRE_INIT();
_glfw.platform.requestWindowAttention(window);
}
GLFWAPI void glfwHideWindow(GLFWwindow* handle)
2010-09-07 15:34:51 +00:00
{
2011-04-06 18:38:55 +00:00
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
2011-04-06 18:38:55 +00:00
_GLFW_REQUIRE_INIT();
2012-09-27 19:37:36 +00:00
if (window->monitor)
2010-09-07 15:34:51 +00:00
return;
_glfw.platform.hideWindow(window);
}
GLFWAPI void glfwFocusWindow(GLFWwindow* handle)
{
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
_GLFW_REQUIRE_INIT();
_glfw.platform.focusWindow(window);
2010-09-07 15:34:51 +00:00
}
GLFWAPI int glfwGetWindowAttrib(GLFWwindow* handle, int attrib)
2010-09-07 15:34:51 +00:00
{
2011-04-06 18:38:55 +00:00
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
2011-04-06 18:38:55 +00:00
_GLFW_REQUIRE_INIT_OR_RETURN(0);
2010-09-07 15:34:51 +00:00
switch (attrib)
2010-09-07 15:34:51 +00:00
{
case GLFW_FOCUSED:
return _glfw.platform.windowFocused(window);
2010-09-07 15:34:51 +00:00
case GLFW_ICONIFIED:
return _glfw.platform.windowIconified(window);
case GLFW_VISIBLE:
return _glfw.platform.windowVisible(window);
case GLFW_MAXIMIZED:
return _glfw.platform.windowMaximized(window);
case GLFW_HOVERED:
return _glfw.platform.windowHovered(window);
case GLFW_FOCUS_ON_SHOW:
return window->focusOnShow;
case GLFW_MOUSE_PASSTHROUGH:
return window->mousePassthrough;
case GLFW_TRANSPARENT_FRAMEBUFFER:
return _glfw.platform.framebufferTransparent(window);
case GLFW_RESIZABLE:
return window->resizable;
2013-04-08 13:16:32 +00:00
case GLFW_DECORATED:
return window->decorated;
2014-05-23 12:01:02 +00:00
case GLFW_FLOATING:
return window->floating;
case GLFW_AUTO_ICONIFY:
return window->autoIconify;
case GLFW_DOUBLEBUFFER:
return window->doublebuffer;
2012-09-30 13:43:26 +00:00
case GLFW_CLIENT_API:
return window->context.client;
case GLFW_CONTEXT_CREATION_API:
return window->context.source;
case GLFW_CONTEXT_VERSION_MAJOR:
return window->context.major;
case GLFW_CONTEXT_VERSION_MINOR:
return window->context.minor;
case GLFW_CONTEXT_REVISION:
return window->context.revision;
case GLFW_CONTEXT_ROBUSTNESS:
return window->context.robustness;
2010-09-07 15:34:51 +00:00
case GLFW_OPENGL_FORWARD_COMPAT:
return window->context.forward;
case GLFW_CONTEXT_DEBUG:
return window->context.debug;
2010-09-07 15:34:51 +00:00
case GLFW_OPENGL_PROFILE:
return window->context.profile;
case GLFW_CONTEXT_RELEASE_BEHAVIOR:
return window->context.release;
case GLFW_CONTEXT_NO_ERROR:
return window->context.noerror;
2010-09-07 15:34:51 +00:00
}
_glfwInputError(GLFW_INVALID_ENUM, "Invalid window attribute 0x%08X", attrib);
return 0;
2010-09-07 15:34:51 +00:00
}
GLFWAPI void glfwSetWindowAttrib(GLFWwindow* handle, int attrib, int value)
{
_GLFWwindow* window = (_GLFWwindow*) handle;
assert(window != NULL);
_GLFW_REQUIRE_INIT();
value = value ? GLFW_TRUE : GLFW_FALSE;
switch (attrib)
{
case GLFW_AUTO_ICONIFY:
window->autoIconify = value;
return;
case GLFW_RESIZABLE:
window->resizable = value;
if (!window->monitor)
_glfw.platform.setWindowResizable(window, value);
return;
case GLFW_DECORATED:
window->decorated = value;
if (!window->monitor)
_glfw.platform.setWindowDecorated(window, value);
return;
case GLFW_FLOATING:
window->floating = value;
if (!window->monitor)
_glfw.platform.setWindowFloating(window, value);
return;
case GLFW_FOCUS_ON_SHOW:
window->focusOnShow = value;
return;
case GLFW_MOUSE_PASSTHROUGH:
window->mousePassthrough = value;
_glfw.platform.setWindowMousePassthrough(window, value);
return;
}
_glfwInputError(GLFW_INVALID_ENUM, "Invalid window attribute 0x%08X", attrib);
}
GLFWAPI GLFWmonitor* glfwGetWindowMonitor(GLFWwindow* handle)
2012-10-02 15:24:18 +00:00
{
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
_GLFW_REQUIRE_INIT_OR_RETURN(NULL);
return (GLFWmonitor*) window->monitor;
2012-10-02 15:24:18 +00:00
}
GLFWAPI void glfwSetWindowMonitor(GLFWwindow* wh,
GLFWmonitor* mh,
int xpos, int ypos,
int width, int height,
int refreshRate)
{
_GLFWwindow* window = (_GLFWwindow*) wh;
_GLFWmonitor* monitor = (_GLFWmonitor*) mh;
2016-05-03 15:44:46 +00:00
assert(window != NULL);
2017-02-23 16:47:41 +00:00
assert(width >= 0);
assert(height >= 0);
_GLFW_REQUIRE_INIT();
if (width <= 0 || height <= 0)
{
_glfwInputError(GLFW_INVALID_VALUE,
"Invalid window size %ix%i",
width, height);
return;
}
if (refreshRate < 0 && refreshRate != GLFW_DONT_CARE)
{
_glfwInputError(GLFW_INVALID_VALUE,
"Invalid refresh rate %i",
refreshRate);
return;
}
window->videoMode.width = width;
window->videoMode.height = height;
window->videoMode.refreshRate = refreshRate;
_glfw.platform.setWindowMonitor(window, monitor,
xpos, ypos, width, height,
refreshRate);
}
GLFWAPI void glfwSetWindowUserPointer(GLFWwindow* handle, void* pointer)
2010-09-09 20:44:38 +00:00
{
2011-04-06 18:38:55 +00:00
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
_GLFW_REQUIRE_INIT();
2010-09-09 20:44:38 +00:00
window->userPointer = pointer;
}
GLFWAPI void* glfwGetWindowUserPointer(GLFWwindow* handle)
2010-09-09 20:44:38 +00:00
{
2011-04-06 18:38:55 +00:00
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
_GLFW_REQUIRE_INIT_OR_RETURN(NULL);
2010-09-09 20:44:38 +00:00
return window->userPointer;
}
GLFWAPI GLFWwindowposfun glfwSetWindowPosCallback(GLFWwindow* handle,
GLFWwindowposfun cbfun)
2012-11-30 12:56:42 +00:00
{
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
_GLFW_REQUIRE_INIT_OR_RETURN(NULL);
_GLFW_SWAP(GLFWwindowposfun, window->callbacks.pos, cbfun);
return cbfun;
2012-11-30 12:56:42 +00:00
}
GLFWAPI GLFWwindowsizefun glfwSetWindowSizeCallback(GLFWwindow* handle,
GLFWwindowsizefun cbfun)
2010-09-07 15:34:51 +00:00
{
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
_GLFW_REQUIRE_INIT_OR_RETURN(NULL);
_GLFW_SWAP(GLFWwindowsizefun, window->callbacks.size, cbfun);
return cbfun;
2010-09-07 15:34:51 +00:00
}
GLFWAPI GLFWwindowclosefun glfwSetWindowCloseCallback(GLFWwindow* handle,
GLFWwindowclosefun cbfun)
2010-09-07 15:34:51 +00:00
{
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
_GLFW_REQUIRE_INIT_OR_RETURN(NULL);
_GLFW_SWAP(GLFWwindowclosefun, window->callbacks.close, cbfun);
return cbfun;
2010-09-07 15:34:51 +00:00
}
GLFWAPI GLFWwindowrefreshfun glfwSetWindowRefreshCallback(GLFWwindow* handle,
GLFWwindowrefreshfun cbfun)
2010-09-07 15:34:51 +00:00
{
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
_GLFW_REQUIRE_INIT_OR_RETURN(NULL);
_GLFW_SWAP(GLFWwindowrefreshfun, window->callbacks.refresh, cbfun);
return cbfun;
2010-09-07 15:34:51 +00:00
}
GLFWAPI GLFWwindowfocusfun glfwSetWindowFocusCallback(GLFWwindow* handle,
GLFWwindowfocusfun cbfun)
{
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
_GLFW_REQUIRE_INIT_OR_RETURN(NULL);
_GLFW_SWAP(GLFWwindowfocusfun, window->callbacks.focus, cbfun);
return cbfun;
}
GLFWAPI GLFWwindowiconifyfun glfwSetWindowIconifyCallback(GLFWwindow* handle,
GLFWwindowiconifyfun cbfun)
2010-09-20 00:22:35 +00:00
{
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
_GLFW_REQUIRE_INIT_OR_RETURN(NULL);
_GLFW_SWAP(GLFWwindowiconifyfun, window->callbacks.iconify, cbfun);
return cbfun;
2010-09-20 00:22:35 +00:00
}
GLFWAPI GLFWwindowmaximizefun glfwSetWindowMaximizeCallback(GLFWwindow* handle,
GLFWwindowmaximizefun cbfun)
{
_GLFWwindow* window = (_GLFWwindow*) handle;
assert(window != NULL);
_GLFW_REQUIRE_INIT_OR_RETURN(NULL);
_GLFW_SWAP(GLFWwindowmaximizefun, window->callbacks.maximize, cbfun);
return cbfun;
}
GLFWAPI GLFWframebuffersizefun glfwSetFramebufferSizeCallback(GLFWwindow* handle,
GLFWframebuffersizefun cbfun)
{
_GLFWwindow* window = (_GLFWwindow*) handle;
2016-03-02 16:58:05 +00:00
assert(window != NULL);
_GLFW_REQUIRE_INIT_OR_RETURN(NULL);
_GLFW_SWAP(GLFWframebuffersizefun, window->callbacks.fbsize, cbfun);
return cbfun;
}
GLFWAPI GLFWwindowcontentscalefun glfwSetWindowContentScaleCallback(GLFWwindow* handle,
GLFWwindowcontentscalefun cbfun)
{
_GLFWwindow* window = (_GLFWwindow*) handle;
assert(window != NULL);
_GLFW_REQUIRE_INIT_OR_RETURN(NULL);
_GLFW_SWAP(GLFWwindowcontentscalefun, window->callbacks.scale, cbfun);
return cbfun;
}
2010-09-08 12:45:52 +00:00
GLFWAPI void glfwPollEvents(void)
2010-09-07 15:34:51 +00:00
{
_GLFW_REQUIRE_INIT();
_glfw.platform.pollEvents();
2010-09-07 15:34:51 +00:00
}
2010-09-08 12:45:52 +00:00
GLFWAPI void glfwWaitEvents(void)
2010-09-07 15:34:51 +00:00
{
_GLFW_REQUIRE_INIT();
_glfw.platform.waitEvents();
2010-09-07 15:34:51 +00:00
}
GLFWAPI void glfwWaitEventsTimeout(double timeout)
{
_GLFW_REQUIRE_INIT();
2017-02-23 16:47:41 +00:00
assert(timeout == timeout);
assert(timeout >= 0.0);
assert(timeout <= DBL_MAX);
if (timeout != timeout || timeout < 0.0 || timeout > DBL_MAX)
{
2016-03-29 08:49:34 +00:00
_glfwInputError(GLFW_INVALID_VALUE, "Invalid time %f", timeout);
return;
}
_glfw.platform.waitEventsTimeout(timeout);
}
2014-02-10 17:16:58 +00:00
GLFWAPI void glfwPostEmptyEvent(void)
{
_GLFW_REQUIRE_INIT();
_glfw.platform.postEmptyEvent();
2014-02-10 17:16:58 +00:00
}
2020-08-21 13:56:51 +00:00