accurate windows timer and misc ui

16 files changed, 16637 insertions, 16563 deletions

diff --git a/.gitignore b/.gitignore
index cdf1ed2..1b2211d 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1 @@
-build*

+build*
diff --git a/frontends/curses/curses_ui.c b/frontends/curses/curses_ui.c
index 096f294..1c0fb00 100644
--- a/frontends/curses/curses_ui.c
+++ b/frontends/curses/curses_ui.c
@@ -1,239 +1,239 @@
-/* very simple curses interface, DAS is not functional because you cant detect 

- * key up presses on the terminal, there are 2 character sets, ASCII_COMPATIBLE

- * for no UTF-8 chars and the normal which will look better on a platform that can

- * support UTF-8. Color support is limited because I havent figured out colors yet */

-

-#include <stdlib.h>

-#include <string.h>

-#include <stdio.h>

-#include <stdbool.h>

-#ifdef _WIN32

-#include "win\curses.h"

-#include <windows.h>

-#else

-#include <ncurses.h>

-#include <unistd.h>

-#include <pthread.h>

-#endif

-#include <locale.h>

-

-#include "cetris.h"

-

-#define WIN_COL 55 

-#define WIN_LINE 25 

-

-#ifdef ASCII_COMPATIBLE

-#define BLOCK "[]"

-#define PLAY_FIELD_STR  "       /--------------------\\   /----------------\\ \n"\

-                        "       |                    |   |                |   \n"\

-                        "       |                    |   \\----------------/  \n"\

-                        "       |                    |                        \n"\

-                        "       |                    |                        \n"\

-                        "       |                    |      /---------\\      \n"\

-                        "       |                    |      |         |       \n"\

-                        "       |                    |      |         |       \n"\

-                        "       |                    |      |         |       \n"\

-                        "       |                    |      |         |       \n"\

-                        "       |                    |      \\---------/      \n"\

-                        "       |                    |                        \n"\

-                        "       |                    |                        \n"\

-                        "       |                    |                        \n"\

-                        "       |                    |                        \n"\

-                        "       |                    |                        \n"\

-                        "       |                    |                        \n"\

-                        "       |                    |                        \n"\

-                        "       |                    |                        \n"\

-                        "       |                    |                        \n"\

-                        "       |                    |                        \n"\

-                        "       \\--------------------/"

-#else

-#define BLOCK "[]"

-#define PLAY_FIELD_STR  "       ┏━━━━━━━━━━━━━━━━━━━━┓  ┏━━━━━score━━━━━┓  \n"\

-                        "       ┃                    ┃  ┃               ┃  \n"\

-                        "       ┃                    ┃  ┗━━━━━━━━━━━━━━━┛  \n"\

-                        "       ┃                    ┃                     \n"\

-                        "       ┃                    ┃                     \n"\

-                        "       ┃                    ┃    ┏━━━queue━━━┓    \n"\

-                        "       ┃                    ┃    ┃           ┃    \n"\

-                        "       ┃                    ┃    ┃           ┃    \n"\

-                        "       ┃                    ┃    ┃           ┃    \n"\

-                        "       ┃                    ┃    ┃           ┃    \n"\

-                        "       ┃                    ┃    ┗━━━━━━━━━━━┛    \n"\

-                        "       ┃                    ┃                     \n"\

-                        "       ┃                    ┃                     \n"\

-                        "       ┃                    ┃                     \n"\

-                        "       ┃                    ┃                     \n"\

-                        "       ┃                    ┃                     \n"\

-                        "       ┃                    ┃                     \n"\

-                        "       ┃                    ┃                     \n"\

-                        "       ┃                    ┃                     \n"\

-                        "       ┃                    ┃                     \n"\

-                        "       ┃                    ┃                     \n"\

-                        "       ┗━━━━━━━━━━━━━━━━━━━━┛                        "

-#endif

-

-#define X_OFFSET 8 

-#define Y_OFFSET 1

-

-cetris_game game;

-bool is_paused = false;

-

-void curses_init() {

-  setlocale(LC_CTYPE, "");

-  initscr();

-  curs_set(0);

-  noecho();

-  keypad(stdscr, TRUE);

-  timeout(2);

-

-#ifdef _WIN32 // only resize manually on windows

-  resize_term(WIN_LINE, WIN_COL);

-#endif

-

-  start_color();

-  init_pair(MINO_O, COLOR_YELLOW, COLOR_BLACK);

-  init_pair(MINO_Z, COLOR_RED, COLOR_BLACK);

-  init_pair(MINO_S, COLOR_GREEN, COLOR_BLACK);

-  init_pair(MINO_T, COLOR_MAGENTA, COLOR_BLACK);

-  init_pair(MINO_L, COLOR_WHITE, COLOR_BLACK); // should be orange

-  init_pair(MINO_I, COLOR_CYAN, COLOR_BLACK);

-  init_pair(MINO_J, COLOR_BLUE, COLOR_BLACK);

-  clear();

-}

-

-#ifdef _WIN32

-DWORD WINAPI game_loop(void* data) {

-  while(1) {

-    Sleep((1.0/60.0) * 1000.0);

-    if (!is_paused) update_game_tick(&game);

-  }

-  return 0;

-}

-#else

-void *game_loop(void) {

-  while(1) {

-    usleep((1.0/60.0) * 1000000.0);

-    if (!is_paused) update_game_tick(&game);

-  }

-  return 0;

-}

-#endif

-

-

-void draw_board() {

-  mvaddstr(0, 0, PLAY_FIELD_STR);

-

-  for (int y = 0; y < 4; y++) {

-    for (int x = 0; x < 4; x++) {

-      if ((game.current.m[y]>>(3 - x))&1) {

-        int draw_x = X_OFFSET + ((x + game.current.pos.x) * 2);

-        int draw_y = Y_OFFSET + (y + game.current.pos.y) - CETRIS_BOARD_VISABLE;

-        int ghost_y = Y_OFFSET + (y + game.current.ghost_y) - CETRIS_BOARD_VISABLE;

-	      attron(COLOR_PAIR(game.current.t) | A_BOLD);

-        mvaddstr(draw_y, draw_x, BLOCK);

-

-

-	      attroff(COLOR_PAIR(game.current.t) | A_BOLD);

-        attron(A_DIM);

-        mvaddstr(ghost_y, draw_x, BLOCK);

-        attroff(A_DIM);

-      }

-      if ((default_matrices[game.piece_queue[game.current_index]][y]>>(3 - x))&1) {

-        mvaddstr(6 + y, (x * 2) + 36, BLOCK);

-      }

-    }

-  }

-

-  for (int x = 0; x < CETRIS_BOARD_X; x++) {

-    for (int y = game.highest_line; y < CETRIS_BOARD_Y; y++) {

-      int draw_y = y - CETRIS_BOARD_VISABLE + Y_OFFSET;

-      int draw_x = x * 2 + X_OFFSET;

-      if (game.board[x][y] & SLOT_OCCUPIED) {

-	      attron(COLOR_PAIR(game.board[x][y] >> 5) | A_BOLD);

-        if (game.line_remove_tick[y]) {

-          if (game.tick % 2 == 0) {

-            mvaddstr(draw_y, draw_x, BLOCK);

-          }

-        } else {

-          mvaddstr(draw_y, draw_x, BLOCK);

-        }

-	      attroff(COLOR_PAIR(game.board[x][y] >> 5) | A_BOLD);

-      }

-    }

-

-    attron(A_BOLD);

-

-    char score[50];

-    sprintf(score, "%i", game.score);

-    mvaddstr(1, (39 + X_OFFSET) - strlen(score), score);

-

-    char level[20];

-    sprintf(level, "%i", game.level);

-    mvaddstr(3, 37, "Level"); 

-    mvaddstr(4, 40 - strlen(level), level); 

-

-    if (game.game_over) {

-      mvaddstr(10, 5 + X_OFFSET, "GAME OVER");

-      mvaddstr(11, 4 + X_OFFSET, "r to restart");

-    }

-

-    if (is_paused) {

-      mvaddstr(10, 7 + X_OFFSET, "paused");

-    }

-

-    attroff(A_BOLD);

-  }

-}

-

-int main(void) {

-  curses_init();

-

-  init_game(&game);

-

-#ifdef _WIN32

-  HANDLE thread = CreateThread(NULL, 0, game_loop, NULL, 0, NULL);

-#else

-  pthread_t thread;

-  pthread_create(&thread, NULL, (void*)game_loop, (void*)0);

-#endif

-

-  int c;

-  while(1) {

-    c = getch();

-    switch (c) {

-      case 'q': endwin(); exit(1);

-      case 27: // esc or alt

-        is_paused = !is_paused; break;

-      case 'r':

-        if (game.game_over) {

-          init_game(&game);

-        }

-        break;

-    }

-    if (is_paused) continue; // dont allow input if paused

-    switch (c) {

-      case KEY_LEFT:

-        move_piece(&game, LEFT); break;

-      case KEY_RIGHT:

-        move_piece(&game, RIGHT); break;

-      case KEY_DOWN:

-        move_piece(&game, USER_DOWN); break;

-      case KEY_UP:

-      case 'x':

-        move_piece(&game, ROTATE_CW); break;

-      case '^':

-      case 'z':

-        move_piece(&game, ROTATE_CCW); break;

-      case ' ':

-        move_piece(&game, HARD_DROP); break;

-      case KEY_SLEFT:

-      case 'c':

-        hold_piece(&game); break;

-    }

-    erase();

-    draw_board();

-    refresh();

-  }

-  return 0;

-}

-

+/* very simple curses interface, DAS is not functional because you cant detect 
+ * key up presses on the terminal, there are 2 character sets, ASCII_COMPATIBLE
+ * for no UTF-8 chars and the normal which will look better on a platform that can
+ * support UTF-8. Color support is limited because I havent figured out colors yet */
+
+#include <stdlib.h>
+#include <string.h>
+#include <stdio.h>
+#include <stdbool.h>
+#ifdef _WIN32
+#include "win\curses.h"
+#include <windows.h>
+#else
+#include <ncurses.h>
+#include <unistd.h>
+#include <pthread.h>
+#endif
+#include <locale.h>
+
+#include "cetris.h"
+
+#define WIN_COL 55 
+#define WIN_LINE 25 
+
+#ifdef ASCII_COMPATIBLE
+#define BLOCK "[]"
+#define PLAY_FIELD_STR  "       /--------------------\\   /----------------\\ \n"\
+                        "       |                    |   |                |   \n"\
+                        "       |                    |   \\----------------/  \n"\
+                        "       |                    |                        \n"\
+                        "       |                    |                        \n"\
+                        "       |                    |      /---------\\      \n"\
+                        "       |                    |      |         |       \n"\
+                        "       |                    |      |         |       \n"\
+                        "       |                    |      |         |       \n"\
+                        "       |                    |      |         |       \n"\
+                        "       |                    |      \\---------/      \n"\
+                        "       |                    |                        \n"\
+                        "       |                    |                        \n"\
+                        "       |                    |                        \n"\
+                        "       |                    |                        \n"\
+                        "       |                    |                        \n"\
+                        "       |                    |                        \n"\
+                        "       |                    |                        \n"\
+                        "       |                    |                        \n"\
+                        "       |                    |                        \n"\
+                        "       |                    |                        \n"\
+                        "       \\--------------------/"
+#else
+#define BLOCK "[]"
+#define PLAY_FIELD_STR  "       ┏━━━━━━━━━━━━━━━━━━━━┓  ┏━━━━━score━━━━━┓  \n"\
+                        "       ┃                    ┃  ┃               ┃  \n"\
+                        "       ┃                    ┃  ┗━━━━━━━━━━━━━━━┛  \n"\
+                        "       ┃                    ┃                     \n"\
+                        "       ┃                    ┃                     \n"\
+                        "       ┃                    ┃    ┏━━━queue━━━┓    \n"\
+                        "       ┃                    ┃    ┃           ┃    \n"\
+                        "       ┃                    ┃    ┃           ┃    \n"\
+                        "       ┃                    ┃    ┃           ┃    \n"\
+                        "       ┃                    ┃    ┃           ┃    \n"\
+                        "       ┃                    ┃    ┗━━━━━━━━━━━┛    \n"\
+                        "       ┃                    ┃                     \n"\
+                        "       ┃                    ┃                     \n"\
+                        "       ┃                    ┃                     \n"\
+                        "       ┃                    ┃                     \n"\
+                        "       ┃                    ┃                     \n"\
+                        "       ┃                    ┃                     \n"\
+                        "       ┃                    ┃                     \n"\
+                        "       ┃                    ┃                     \n"\
+                        "       ┃                    ┃                     \n"\
+                        "       ┃                    ┃                     \n"\
+                        "       ┗━━━━━━━━━━━━━━━━━━━━┛                        "
+#endif
+
+#define X_OFFSET 8 
+#define Y_OFFSET 1
+
+cetris_game game;
+bool is_paused = false;
+
+void curses_init() {
+  setlocale(LC_CTYPE, "");
+  initscr();
+  curs_set(0);
+  noecho();
+  keypad(stdscr, TRUE);
+  timeout(2);
+
+#ifdef _WIN32 // only resize manually on windows
+  resize_term(WIN_LINE, WIN_COL);
+#endif
+
+  start_color();
+  init_pair(MINO_O, COLOR_YELLOW, COLOR_BLACK);
+  init_pair(MINO_Z, COLOR_RED, COLOR_BLACK);
+  init_pair(MINO_S, COLOR_GREEN, COLOR_BLACK);
+  init_pair(MINO_T, COLOR_MAGENTA, COLOR_BLACK);
+  init_pair(MINO_L, COLOR_WHITE, COLOR_BLACK); // should be orange
+  init_pair(MINO_I, COLOR_CYAN, COLOR_BLACK);
+  init_pair(MINO_J, COLOR_BLUE, COLOR_BLACK);
+  clear();
+}
+
+#ifdef _WIN32
+DWORD WINAPI game_loop(void* data) {
+  while(1) {
+    Sleep((1.0/60.0) * 1000.0);
+    if (!is_paused) update_game_tick(&game);
+  }
+  return 0;
+}
+#else
+void *game_loop(void) {
+  while(1) {
+    usleep((1.0/60.0) * 1000000.0);
+    if (!is_paused) update_game_tick(&game);
+  }
+  return 0;
+}
+#endif
+
+
+void draw_board() {
+  mvaddstr(0, 0, PLAY_FIELD_STR);
+
+  for (int y = 0; y < 4; y++) {
+    for (int x = 0; x < 4; x++) {
+      if ((game.current.m[y]>>(3 - x))&1) {
+        int draw_x = X_OFFSET + ((x + game.current.pos.x) * 2);
+        int draw_y = Y_OFFSET + (y + game.current.pos.y) - CETRIS_BOARD_VISABLE;
+        int ghost_y = Y_OFFSET + (y + game.current.ghost_y) - CETRIS_BOARD_VISABLE;
+	      attron(COLOR_PAIR(game.current.t) | A_BOLD);
+        mvaddstr(draw_y, draw_x, BLOCK);
+
+
+	      attroff(COLOR_PAIR(game.current.t) | A_BOLD);
+        attron(A_DIM);
+        mvaddstr(ghost_y, draw_x, BLOCK);
+        attroff(A_DIM);
+      }
+      if ((default_matrices[game.piece_queue[game.current_index]][y]>>(3 - x))&1) {
+        mvaddstr(6 + y, (x * 2) + 36, BLOCK);
+      }
+    }
+  }
+
+  for (int x = 0; x < CETRIS_BOARD_X; x++) {
+    for (int y = game.highest_line; y < CETRIS_BOARD_Y; y++) {
+      int draw_y = y - CETRIS_BOARD_VISABLE + Y_OFFSET;
+      int draw_x = x * 2 + X_OFFSET;
+      if (game.board[x][y] & SLOT_OCCUPIED) {
+	      attron(COLOR_PAIR(game.board[x][y] >> 5) | A_BOLD);
+        if (game.line_remove_tick[y]) {
+          if (game.tick % 2 == 0) {
+            mvaddstr(draw_y, draw_x, BLOCK);
+          }
+        } else {
+          mvaddstr(draw_y, draw_x, BLOCK);
+        }
+	      attroff(COLOR_PAIR(game.board[x][y] >> 5) | A_BOLD);
+      }
+    }
+
+    attron(A_BOLD);
+
+    char score[50];
+    sprintf(score, "%i", game.score);
+    mvaddstr(1, (39 + X_OFFSET) - strlen(score), score);
+
+    char level[20];
+    sprintf(level, "%i", game.level);
+    mvaddstr(3, 37, "Level"); 
+    mvaddstr(4, 40 - strlen(level), level); 
+
+    if (game.game_over) {
+      mvaddstr(10, 5 + X_OFFSET, "GAME OVER");
+      mvaddstr(11, 4 + X_OFFSET, "r to restart");
+    }
+
+    if (is_paused) {
+      mvaddstr(10, 7 + X_OFFSET, "paused");
+    }
+
+    attroff(A_BOLD);
+  }
+}
+
+int main(void) {
+  curses_init();
+
+  init_game(&game);
+
+#ifdef _WIN32
+  HANDLE thread = CreateThread(NULL, 0, game_loop, NULL, 0, NULL);
+#else
+  pthread_t thread;
+  pthread_create(&thread, NULL, (void*)game_loop, (void*)0);
+#endif
+
+  int c;
+  while(1) {
+    c = getch();
+    switch (c) {
+      case 'q': endwin(); exit(1);
+      case 27: // esc or alt
+        is_paused = !is_paused; break;
+      case 'r':
+        if (game.game_over) {
+          init_game(&game);
+        }
+        break;
+    }
+    if (is_paused) continue; // dont allow input if paused
+    switch (c) {
+      case KEY_LEFT:
+        move_piece(&game, LEFT); break;
+      case KEY_RIGHT:
+        move_piece(&game, RIGHT); break;
+      case KEY_DOWN:
+        move_piece(&game, USER_DOWN); break;
+      case KEY_UP:
+      case 'x':
+        move_piece(&game, ROTATE_CW); break;
+      case '^':
+      case 'z':
+        move_piece(&game, ROTATE_CCW); break;
+      case ' ':
+        move_piece(&game, HARD_DROP); break;
+      case KEY_SLEFT:
+      case 'c':
+        hold_piece(&game); break;
+    }
+    erase();
+    draw_board();
+    refresh();
+  }
+  return 0;
+}
+
diff --git a/frontends/curses/meson.build b/frontends/curses/meson.build
index 8adbd40..6c7497f 100644
--- a/frontends/curses/meson.build
+++ b/frontends/curses/meson.build
@@ -1,18 +1,18 @@
-src = ['curses_ui.c']

-

-inc = [cetris_inc]

-deps = []

-

-if host_machine.system() == 'windows'

-  inc += include_directories('win')

-  deps += compiler.find_library('pdcurses', dirs: meson.current_source_dir() + '/win')

-else

-  deps += dependency('ncursesw')

-  deps += dependency('tinfow')

-  deps += dependency('threads')

-endif

-

-executable('cetris', src,

-           dependencies: deps,

-           include_directories: inc,

-           install: false)

+src = ['curses_ui.c']
+
+inc = [cetris_inc]
+deps = []
+
+if host_machine.system() == 'windows'
+  inc += include_directories('win')
+  deps += compiler.find_library('pdcurses', dirs: meson.current_source_dir() + '/win')
+else
+  deps += dependency('ncursesw')
+  deps += dependency('tinfow')
+  deps += dependency('threads')
+endif
+
+executable('cetris', src,
+           dependencies: deps,
+           include_directories: inc,
+           install: false)
diff --git a/frontends/curses/win/curses.h b/frontends/curses/win/curses.h
index 1ee294b..8251ec5 100644
--- a/frontends/curses/win/curses.h
+++ b/frontends/curses/win/curses.h
@@ -1,1383 +1,1383 @@
-/*----------------------------------------------------------------------*

- *                              PDCurses                                *

- *----------------------------------------------------------------------*/

-

-#ifndef __PDCURSES__

-#define __PDCURSES__ 1

-

-/*man-start**************************************************************

-

-Define before inclusion (only those needed):

-

-    XCURSES         True if compiling for X11.

-    PDC_RGB         True if you want to use RGB color definitions

-                    (Red = 1, Green = 2, Blue = 4) instead of BGR.

-    PDC_WIDE        True if building wide-character support.

-    PDC_DLL_BUILD   True if building a Windows DLL.

-    PDC_NCMOUSE     Use the ncurses mouse API instead

-                    of PDCurses' traditional mouse API.

-

-Defined by this header:

-

-    PDCURSES        Enables access to PDCurses-only routines.

-    PDC_BUILD       Defines API build version.

-    PDC_VER_MAJOR   Major version number

-    PDC_VER_MINOR   Minor version number

-    PDC_VERDOT      Version string

-

-**man-end****************************************************************/

-

-#define PDCURSES        1      /* PDCurses-only routines */

-#define PDC_BUILD    3802

-#define PDC_VER_MAJOR   3

-#define PDC_VER_MINOR   8

-#define PDC_VERDOT   "3.8"

-#define CHTYPE_LONG     1      /* chtype >= 32 bits */

-

-#if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L

-# define PDC_99         1

-#endif

-

-#if defined(__cplusplus) && __cplusplus >= 199711L

-# define PDC_PP98       1

-#endif

-

-/*----------------------------------------------------------------------*/

-

-#include <stdarg.h>

-#include <stddef.h>

-#include <stdio.h>             /* Required by X/Open usage below */

-

-#ifdef PDC_WIDE

-# include <wchar.h>

-#endif

-

-#if defined(PDC_99) && !defined(__bool_true_false_are_defined)

-# include <stdbool.h>

-#endif

-

-#ifdef __cplusplus

-extern "C"

-{

-# ifndef PDC_PP98

-#  define bool _bool

-# endif

-#endif

-

-/*----------------------------------------------------------------------

- *

- *  Constants and Types

- *

- */

-

-#undef FALSE

-#define FALSE 0

-

-#undef TRUE

-#define TRUE 1

-

-#undef ERR

-#define ERR (-1)

-

-#undef OK

-#define OK 0

-

-#if !defined(PDC_PP98) && !defined(__bool_true_false_are_defined)

-typedef unsigned char bool;

-#endif

-

-#if _LP64

-typedef unsigned int chtype;

-#else

-typedef unsigned long chtype;  /* 16-bit attr + 16-bit char */

-#endif

-

-#ifdef PDC_WIDE

-typedef chtype cchar_t;

-#endif

-

-typedef chtype attr_t;

-

-/*----------------------------------------------------------------------

- *

- *  Version Info

- *

- */

-

-/* Use this structure with PDC_get_version() for run-time info about the

-   way the library was built, in case it doesn't match the header. */

-

-typedef struct

-{

-    short flags;          /* flags OR'd together (see below) */

-    short build;          /* PDC_BUILD at compile time */

-    unsigned char major;  /* PDC_VER_MAJOR */

-    unsigned char minor;  /* PDC_VER_MINOR */

-    unsigned char csize;  /* sizeof chtype */

-    unsigned char bsize;  /* sizeof bool */

-} PDC_VERSION;

-

-enum

-{

-    PDC_VFLAG_DEBUG = 1,  /* set if built with -DPDCDEBUG */

-    PDC_VFLAG_WIDE  = 2,  /* -DPDC_WIDE */

-    PDC_VFLAG_UTF8  = 4,  /* -DPDC_FORCE_UTF8 */

-    PDC_VFLAG_DLL   = 8,  /* -DPDC_DLL_BUILD */

-    PDC_VFLAG_RGB   = 16  /* -DPDC_RGB */

-};

-

-/*----------------------------------------------------------------------

- *

- *  Mouse Interface -- SYSVR4, with extensions

- *

- */

-

-#if _LP64

-typedef unsigned int mmask_t;

-#else

-typedef unsigned long mmask_t;

-#endif

-

-typedef struct

-{

-    int x;           /* absolute column, 0 based, measured in characters */

-    int y;           /* absolute row, 0 based, measured in characters */

-    short button[3]; /* state of each button */

-    int changes;     /* flags indicating what has changed with the mouse */

-} MOUSE_STATUS;

-

-#define BUTTON_RELEASED         0x0000

-#define BUTTON_PRESSED          0x0001

-#define BUTTON_CLICKED          0x0002

-#define BUTTON_DOUBLE_CLICKED   0x0003

-#define BUTTON_TRIPLE_CLICKED   0x0004

-#define BUTTON_MOVED            0x0005  /* PDCurses */

-#define WHEEL_SCROLLED          0x0006  /* PDCurses */

-#define BUTTON_ACTION_MASK      0x0007  /* PDCurses */

-

-#define PDC_BUTTON_SHIFT        0x0008  /* PDCurses */

-#define PDC_BUTTON_CONTROL      0x0010  /* PDCurses */

-#define PDC_BUTTON_ALT          0x0020  /* PDCurses */

-#define BUTTON_MODIFIER_MASK    0x0038  /* PDCurses */

-

-#define MOUSE_X_POS             (Mouse_status.x)

-#define MOUSE_Y_POS             (Mouse_status.y)

-

-/*

- * Bits associated with the .changes field:

- *   3         2         1         0

- * 210987654321098765432109876543210

- *                                 1 <- button 1 has changed

- *                                10 <- button 2 has changed

- *                               100 <- button 3 has changed

- *                              1000 <- mouse has moved

- *                             10000 <- mouse position report

- *                            100000 <- mouse wheel up

- *                           1000000 <- mouse wheel down

- *                          10000000 <- mouse wheel left

- *                         100000000 <- mouse wheel right

- */

-

-#define PDC_MOUSE_MOVED         0x0008

-#define PDC_MOUSE_POSITION      0x0010

-#define PDC_MOUSE_WHEEL_UP      0x0020

-#define PDC_MOUSE_WHEEL_DOWN    0x0040

-#define PDC_MOUSE_WHEEL_LEFT    0x0080

-#define PDC_MOUSE_WHEEL_RIGHT   0x0100

-

-#define A_BUTTON_CHANGED        (Mouse_status.changes & 7)

-#define MOUSE_MOVED             (Mouse_status.changes & PDC_MOUSE_MOVED)

-#define MOUSE_POS_REPORT        (Mouse_status.changes & PDC_MOUSE_POSITION)

-#define BUTTON_CHANGED(x)       (Mouse_status.changes & (1 << ((x) - 1)))

-#define BUTTON_STATUS(x)        (Mouse_status.button[(x) - 1])

-#define MOUSE_WHEEL_UP          (Mouse_status.changes & PDC_MOUSE_WHEEL_UP)

-#define MOUSE_WHEEL_DOWN        (Mouse_status.changes & PDC_MOUSE_WHEEL_DOWN)

-#define MOUSE_WHEEL_LEFT        (Mouse_status.changes & PDC_MOUSE_WHEEL_LEFT)

-#define MOUSE_WHEEL_RIGHT       (Mouse_status.changes & PDC_MOUSE_WHEEL_RIGHT)

-

-/* mouse bit-masks */

-

-#define BUTTON1_RELEASED        0x00000001L

-#define BUTTON1_PRESSED         0x00000002L

-#define BUTTON1_CLICKED         0x00000004L

-#define BUTTON1_DOUBLE_CLICKED  0x00000008L

-#define BUTTON1_TRIPLE_CLICKED  0x00000010L

-#define BUTTON1_MOVED           0x00000010L /* PDCurses */

-

-#define BUTTON2_RELEASED        0x00000020L

-#define BUTTON2_PRESSED         0x00000040L

-#define BUTTON2_CLICKED         0x00000080L

-#define BUTTON2_DOUBLE_CLICKED  0x00000100L

-#define BUTTON2_TRIPLE_CLICKED  0x00000200L

-#define BUTTON2_MOVED           0x00000200L /* PDCurses */

-

-#define BUTTON3_RELEASED        0x00000400L

-#define BUTTON3_PRESSED         0x00000800L

-#define BUTTON3_CLICKED         0x00001000L

-#define BUTTON3_DOUBLE_CLICKED  0x00002000L

-#define BUTTON3_TRIPLE_CLICKED  0x00004000L

-#define BUTTON3_MOVED           0x00004000L /* PDCurses */

-

-/* For the ncurses-compatible functions only, BUTTON4_PRESSED and

-   BUTTON5_PRESSED are returned for mouse scroll wheel up and down;

-   otherwise PDCurses doesn't support buttons 4 and 5 */

-

-#define BUTTON4_RELEASED        0x00008000L

-#define BUTTON4_PRESSED         0x00010000L

-#define BUTTON4_CLICKED         0x00020000L

-#define BUTTON4_DOUBLE_CLICKED  0x00040000L

-#define BUTTON4_TRIPLE_CLICKED  0x00080000L

-

-#define BUTTON5_RELEASED        0x00100000L

-#define BUTTON5_PRESSED         0x00200000L

-#define BUTTON5_CLICKED         0x00400000L

-#define BUTTON5_DOUBLE_CLICKED  0x00800000L

-#define BUTTON5_TRIPLE_CLICKED  0x01000000L

-

-#define MOUSE_WHEEL_SCROLL      0x02000000L /* PDCurses */

-#define BUTTON_MODIFIER_SHIFT   0x04000000L /* PDCurses */

-#define BUTTON_MODIFIER_CONTROL 0x08000000L /* PDCurses */

-#define BUTTON_MODIFIER_ALT     0x10000000L /* PDCurses */

-

-#define ALL_MOUSE_EVENTS        0x1fffffffL

-#define REPORT_MOUSE_POSITION   0x20000000L

-

-/* ncurses mouse interface */

-

-typedef struct

-{

-    short id;       /* unused, always 0 */

-    int x, y, z;    /* x, y same as MOUSE_STATUS; z unused */

-    mmask_t bstate; /* equivalent to changes + button[], but

-                       in the same format as used for mousemask() */

-} MEVENT;

-

-#if defined(PDC_NCMOUSE) && !defined(NCURSES_MOUSE_VERSION)

-# define NCURSES_MOUSE_VERSION 2

-#endif

-

-#ifdef NCURSES_MOUSE_VERSION

-# define BUTTON_SHIFT   BUTTON_MODIFIER_SHIFT

-# define BUTTON_CONTROL BUTTON_MODIFIER_CONTROL

-# define BUTTON_CTRL    BUTTON_MODIFIER_CONTROL

-# define BUTTON_ALT     BUTTON_MODIFIER_ALT

-#else

-# define BUTTON_SHIFT   PDC_BUTTON_SHIFT

-# define BUTTON_CONTROL PDC_BUTTON_CONTROL

-# define BUTTON_ALT     PDC_BUTTON_ALT

-#endif

-

-/*----------------------------------------------------------------------

- *

- *  Window and Screen Structures

- *

- */

-

-typedef struct _win       /* definition of a window */

-{

-    int   _cury;          /* current pseudo-cursor */

-    int   _curx;

-    int   _maxy;          /* max window coordinates */

-    int   _maxx;

-    int   _begy;          /* origin on screen */

-    int   _begx;

-    int   _flags;         /* window properties */

-    chtype _attrs;        /* standard attributes and colors */

-    chtype _bkgd;         /* background, normally blank */

-    bool  _clear;         /* causes clear at next refresh */

-    bool  _leaveit;       /* leaves cursor where it is */

-    bool  _scroll;        /* allows window scrolling */

-    bool  _nodelay;       /* input character wait flag */

-    bool  _immed;         /* immediate update flag */

-    bool  _sync;          /* synchronise window ancestors */

-    bool  _use_keypad;    /* flags keypad key mode active */

-    chtype **_y;          /* pointer to line pointer array */

-    int   *_firstch;      /* first changed character in line */

-    int   *_lastch;       /* last changed character in line */

-    int   _tmarg;         /* top of scrolling region */

-    int   _bmarg;         /* bottom of scrolling region */

-    int   _delayms;       /* milliseconds of delay for getch() */

-    int   _parx, _pary;   /* coords relative to parent (0,0) */

-    struct _win *_parent; /* subwin's pointer to parent win */

-} WINDOW;

-

-/* Avoid using the SCREEN struct directly -- use the corresponding

-   functions if possible. This struct may eventually be made private. */

-

-typedef struct

-{

-    bool  alive;          /* if initscr() called, and not endwin() */

-    bool  autocr;         /* if cr -> lf */

-    bool  cbreak;         /* if terminal unbuffered */

-    bool  echo;           /* if terminal echo */

-    bool  raw_inp;        /* raw input mode (v. cooked input) */

-    bool  raw_out;        /* raw output mode (7 v. 8 bits) */

-    bool  audible;        /* FALSE if the bell is visual */

-    bool  mono;           /* TRUE if current screen is mono */

-    short resized;        /* TRUE if TERM has been resized */

-    bool  orig_attr;      /* TRUE if we have the original colors */

-    short orig_fore;      /* original screen foreground color */

-    short orig_back;      /* original screen foreground color */

-    int   cursrow;        /* position of physical cursor */

-    int   curscol;        /* position of physical cursor */

-    int   visibility;     /* visibility of cursor */

-    int   orig_cursor;    /* original cursor size */

-    int   lines;          /* new value for LINES */

-    int   cols;           /* new value for COLS */

-    mmask_t _trap_mbe;             /* trap these mouse button events */

-    int   mouse_wait;              /* time to wait (in ms) for a

-                                      button release after a press, in

-                                      order to count it as a click */

-    int   slklines;                /* lines in use by slk_init() */

-    WINDOW *slk_winptr;            /* window for slk */

-    int   linesrippedoff;          /* lines ripped off via ripoffline() */

-    int   linesrippedoffontop;     /* lines ripped off on

-                                      top via ripoffline() */

-    int   delaytenths;             /* 1/10ths second to wait block

-                                      getch() for */

-    bool  _preserve;               /* TRUE if screen background

-                                      to be preserved */

-    int   _restore;                /* specifies if screen background

-                                      to be restored, and how */

-    bool  save_key_modifiers;      /* TRUE if each key modifiers saved

-                                      with each key press */

-    bool  return_key_modifiers;    /* TRUE if modifier keys are

-                                      returned as "real" keys */

-    bool  key_code;                /* TRUE if last key is a special key;

-                                      used internally by get_wch() */

-#ifdef XCURSES

-    int   XcurscrSize;    /* size of Xcurscr shared memory block */

-    bool  sb_on;

-    int   sb_viewport_y;

-    int   sb_viewport_x;

-    int   sb_total_y;

-    int   sb_total_x;

-    int   sb_cur_y;

-    int   sb_cur_x;

-#endif

-    short line_color;     /* color of line attributes - default -1 */

-    attr_t termattrs;     /* attribute capabilities */

-} SCREEN;

-

-/*----------------------------------------------------------------------

- *

- *  External Variables

- *

- */

-

-#ifdef PDC_DLL_BUILD

-# ifdef CURSES_LIBRARY

-#  define PDCEX __declspec(dllexport) extern

-# else

-#  define PDCEX __declspec(dllimport)

-# endif

-#else

-# define PDCEX extern

-#endif

-

-PDCEX  int          LINES;        /* terminal height */

-PDCEX  int          COLS;         /* terminal width */

-PDCEX  WINDOW       *stdscr;      /* the default screen window */

-PDCEX  WINDOW       *curscr;      /* the current screen image */

-PDCEX  SCREEN       *SP;          /* curses variables */

-PDCEX  MOUSE_STATUS Mouse_status;

-PDCEX  int          COLORS;

-PDCEX  int          COLOR_PAIRS;

-PDCEX  int          TABSIZE;

-PDCEX  chtype       acs_map[];    /* alternate character set map */

-PDCEX  char         ttytype[];    /* terminal name/description */

-

-/*man-start**************************************************************

-

-Text Attributes

-===============

-

-PDCurses uses a 32-bit integer for its chtype:

-

-    +--------------------------------------------------------------------+

-    |31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|..| 2| 1| 0|

-    +--------------------------------------------------------------------+

-          color pair        |     modifiers         |   character eg 'a'

-

-There are 256 color pairs (8 bits), 8 bits for modifiers, and 16 bits

-for character data. The modifiers are bold, underline, right-line,

-left-line, italic, reverse and blink, plus the alternate character set

-indicator.

-

-**man-end****************************************************************/

-

-/*** Video attribute macros ***/

-

-#define A_NORMAL      (chtype)0

-

-#define A_ALTCHARSET  (chtype)0x00010000

-#define A_RIGHT       (chtype)0x00020000

-#define A_LEFT        (chtype)0x00040000

-#define A_ITALIC      (chtype)0x00080000

-#define A_UNDERLINE   (chtype)0x00100000

-#define A_REVERSE     (chtype)0x00200000

-#define A_BLINK       (chtype)0x00400000

-#define A_BOLD        (chtype)0x00800000

-

-#define A_ATTRIBUTES  (chtype)0xffff0000

-#define A_CHARTEXT    (chtype)0x0000ffff

-#define A_COLOR       (chtype)0xff000000

-

-#define PDC_COLOR_SHIFT 24

-

-#define A_LEFTLINE    A_LEFT

-#define A_RIGHTLINE   A_RIGHT

-#define A_STANDOUT    (A_REVERSE | A_BOLD) /* X/Open */

-

-#define A_DIM         A_NORMAL

-#define A_INVIS       A_NORMAL

-#define A_PROTECT     A_NORMAL

-

-#define A_HORIZONTAL  A_NORMAL

-#define A_LOW         A_NORMAL

-#define A_TOP         A_NORMAL

-#define A_VERTICAL    A_NORMAL

-

-#define CHR_MSK       A_CHARTEXT           /* Obsolete */

-#define ATR_MSK       A_ATTRIBUTES         /* Obsolete */

-#define ATR_NRM       A_NORMAL             /* Obsolete */

-

-/* For use with attr_t -- X/Open says, "these shall be distinct", so

-   this is a non-conforming implementation. */

-

-#define WA_NORMAL     A_NORMAL

-

-#define WA_ALTCHARSET A_ALTCHARSET

-#define WA_BLINK      A_BLINK

-#define WA_BOLD       A_BOLD

-#define WA_DIM        A_DIM

-#define WA_INVIS      A_INVIS

-#define WA_ITALIC     A_ITALIC

-#define WA_LEFT       A_LEFT

-#define WA_PROTECT    A_PROTECT

-#define WA_REVERSE    A_REVERSE

-#define WA_RIGHT      A_RIGHT

-#define WA_STANDOUT   A_STANDOUT

-#define WA_UNDERLINE  A_UNDERLINE

-

-#define WA_HORIZONTAL A_HORIZONTAL

-#define WA_LOW        A_LOW

-#define WA_TOP        A_TOP

-#define WA_VERTICAL   A_VERTICAL

-

-#define WA_ATTRIBUTES A_ATTRIBUTES

-

-/*** Alternate character set macros ***/

-

-#define PDC_ACS(w) ((chtype)w | A_ALTCHARSET)

-

-/* VT100-compatible symbols -- box chars */

-

-#define ACS_ULCORNER  PDC_ACS('l')

-#define ACS_LLCORNER  PDC_ACS('m')

-#define ACS_URCORNER  PDC_ACS('k')

-#define ACS_LRCORNER  PDC_ACS('j')

-#define ACS_RTEE      PDC_ACS('u')

-#define ACS_LTEE      PDC_ACS('t')

-#define ACS_BTEE      PDC_ACS('v')

-#define ACS_TTEE      PDC_ACS('w')

-#define ACS_HLINE     PDC_ACS('q')

-#define ACS_VLINE     PDC_ACS('x')

-#define ACS_PLUS      PDC_ACS('n')

-

-/* VT100-compatible symbols -- other */

-

-#define ACS_S1        PDC_ACS('o')

-#define ACS_S9        PDC_ACS('s')

-#define ACS_DIAMOND   PDC_ACS('`')

-#define ACS_CKBOARD   PDC_ACS('a')

-#define ACS_DEGREE    PDC_ACS('f')

-#define ACS_PLMINUS   PDC_ACS('g')

-#define ACS_BULLET    PDC_ACS('~')

-

-/* Teletype 5410v1 symbols -- these are defined in SysV curses, but

-   are not well-supported by most terminals. Stick to VT100 characters

-   for optimum portability. */

-

-#define ACS_LARROW    PDC_ACS(',')

-#define ACS_RARROW    PDC_ACS('+')

-#define ACS_DARROW    PDC_ACS('.')

-#define ACS_UARROW    PDC_ACS('-')

-#define ACS_BOARD     PDC_ACS('h')

-#define ACS_LANTERN   PDC_ACS('i')

-#define ACS_BLOCK     PDC_ACS('0')

-

-/* That goes double for these -- undocumented SysV symbols. Don't use

-   them. */

-

-#define ACS_S3        PDC_ACS('p')

-#define ACS_S7        PDC_ACS('r')

-#define ACS_LEQUAL    PDC_ACS('y')

-#define ACS_GEQUAL    PDC_ACS('z')

-#define ACS_PI        PDC_ACS('{')

-#define ACS_NEQUAL    PDC_ACS('|')

-#define ACS_STERLING  PDC_ACS('}')

-

-/* Box char aliases */

-

-#define ACS_BSSB      ACS_ULCORNER

-#define ACS_SSBB      ACS_LLCORNER

-#define ACS_BBSS      ACS_URCORNER

-#define ACS_SBBS      ACS_LRCORNER

-#define ACS_SBSS      ACS_RTEE

-#define ACS_SSSB      ACS_LTEE

-#define ACS_SSBS      ACS_BTEE

-#define ACS_BSSS      ACS_TTEE

-#define ACS_BSBS      ACS_HLINE

-#define ACS_SBSB      ACS_VLINE

-#define ACS_SSSS      ACS_PLUS

-

-/* cchar_t aliases */

-

-#ifdef PDC_WIDE

-# define WACS_ULCORNER (&(acs_map['l']))

-# define WACS_LLCORNER (&(acs_map['m']))

-# define WACS_URCORNER (&(acs_map['k']))

-# define WACS_LRCORNER (&(acs_map['j']))

-# define WACS_RTEE     (&(acs_map['u']))

-# define WACS_LTEE     (&(acs_map['t']))

-# define WACS_BTEE     (&(acs_map['v']))

-# define WACS_TTEE     (&(acs_map['w']))

-# define WACS_HLINE    (&(acs_map['q']))

-# define WACS_VLINE    (&(acs_map['x']))

-# define WACS_PLUS     (&(acs_map['n']))

-

-# define WACS_S1       (&(acs_map['o']))

-# define WACS_S9       (&(acs_map['s']))

-# define WACS_DIAMOND  (&(acs_map['`']))

-# define WACS_CKBOARD  (&(acs_map['a']))

-# define WACS_DEGREE   (&(acs_map['f']))

-# define WACS_PLMINUS  (&(acs_map['g']))

-# define WACS_BULLET   (&(acs_map['~']))

-

-# define WACS_LARROW   (&(acs_map[',']))

-# define WACS_RARROW   (&(acs_map['+']))

-# define WACS_DARROW   (&(acs_map['.']))

-# define WACS_UARROW   (&(acs_map['-']))

-# define WACS_BOARD    (&(acs_map['h']))

-# define WACS_LANTERN  (&(acs_map['i']))

-# define WACS_BLOCK    (&(acs_map['0']))

-

-# define WACS_S3       (&(acs_map['p']))

-# define WACS_S7       (&(acs_map['r']))

-# define WACS_LEQUAL   (&(acs_map['y']))

-# define WACS_GEQUAL   (&(acs_map['z']))

-# define WACS_PI       (&(acs_map['{']))

-# define WACS_NEQUAL   (&(acs_map['|']))

-# define WACS_STERLING (&(acs_map['}']))

-

-# define WACS_BSSB     WACS_ULCORNER

-# define WACS_SSBB     WACS_LLCORNER

-# define WACS_BBSS     WACS_URCORNER

-# define WACS_SBBS     WACS_LRCORNER

-# define WACS_SBSS     WACS_RTEE

-# define WACS_SSSB     WACS_LTEE

-# define WACS_SSBS     WACS_BTEE

-# define WACS_BSSS     WACS_TTEE

-# define WACS_BSBS     WACS_HLINE

-# define WACS_SBSB     WACS_VLINE

-# define WACS_SSSS     WACS_PLUS

-#endif

-

-/*** Color macros ***/

-

-#define COLOR_BLACK   0

-

-#ifdef PDC_RGB        /* RGB */

-# define COLOR_RED    1

-# define COLOR_GREEN  2

-# define COLOR_BLUE   4

-#else                 /* BGR */

-# define COLOR_BLUE   1

-# define COLOR_GREEN  2

-# define COLOR_RED    4

-#endif

-

-#define COLOR_CYAN    (COLOR_BLUE | COLOR_GREEN)

-#define COLOR_MAGENTA (COLOR_RED | COLOR_BLUE)

-#define COLOR_YELLOW  (COLOR_RED | COLOR_GREEN)

-

-#define COLOR_WHITE   7

-

-/*----------------------------------------------------------------------

- *

- *  Function and Keypad Key Definitions

- *  Many are just for compatibility

- *

- */

-

-#define KEY_CODE_YES  0x100  /* If get_wch() gives a key code */

-

-#define KEY_BREAK     0x101  /* Not on PC KBD */

-#define KEY_DOWN      0x102  /* Down arrow key */

-#define KEY_UP        0x103  /* Up arrow key */

-#define KEY_LEFT      0x104  /* Left arrow key */

-#define KEY_RIGHT     0x105  /* Right arrow key */

-#define KEY_HOME      0x106  /* home key */

-#define KEY_BACKSPACE 0x107  /* not on pc */

-#define KEY_F0        0x108  /* function keys; 64 reserved */

-

-#define KEY_DL        0x148  /* delete line */

-#define KEY_IL        0x149  /* insert line */

-#define KEY_DC        0x14a  /* delete character */

-#define KEY_IC        0x14b  /* insert char or enter ins mode */

-#define KEY_EIC       0x14c  /* exit insert char mode */

-#define KEY_CLEAR     0x14d  /* clear screen */

-#define KEY_EOS       0x14e  /* clear to end of screen */

-#define KEY_EOL       0x14f  /* clear to end of line */

-#define KEY_SF        0x150  /* scroll 1 line forward */

-#define KEY_SR        0x151  /* scroll 1 line back (reverse) */

-#define KEY_NPAGE     0x152  /* next page */

-#define KEY_PPAGE     0x153  /* previous page */

-#define KEY_STAB      0x154  /* set tab */

-#define KEY_CTAB      0x155  /* clear tab */

-#define KEY_CATAB     0x156  /* clear all tabs */

-#define KEY_ENTER     0x157  /* enter or send (unreliable) */

-#define KEY_SRESET    0x158  /* soft/reset (partial/unreliable) */

-#define KEY_RESET     0x159  /* reset/hard reset (unreliable) */

-#define KEY_PRINT     0x15a  /* print/copy */

-#define KEY_LL        0x15b  /* home down/bottom (lower left) */

-#define KEY_ABORT     0x15c  /* abort/terminate key (any) */

-#define KEY_SHELP     0x15d  /* short help */

-#define KEY_LHELP     0x15e  /* long help */

-#define KEY_BTAB      0x15f  /* Back tab key */

-#define KEY_BEG       0x160  /* beg(inning) key */

-#define KEY_CANCEL    0x161  /* cancel key */

-#define KEY_CLOSE     0x162  /* close key */

-#define KEY_COMMAND   0x163  /* cmd (command) key */

-#define KEY_COPY      0x164  /* copy key */

-#define KEY_CREATE    0x165  /* create key */

-#define KEY_END       0x166  /* end key */

-#define KEY_EXIT      0x167  /* exit key */

-#define KEY_FIND      0x168  /* find key */

-#define KEY_HELP      0x169  /* help key */

-#define KEY_MARK      0x16a  /* mark key */

-#define KEY_MESSAGE   0x16b  /* message key */

-#define KEY_MOVE      0x16c  /* move key */

-#define KEY_NEXT      0x16d  /* next object key */

-#define KEY_OPEN      0x16e  /* open key */

-#define KEY_OPTIONS   0x16f  /* options key */

-#define KEY_PREVIOUS  0x170  /* previous object key */

-#define KEY_REDO      0x171  /* redo key */

-#define KEY_REFERENCE 0x172  /* ref(erence) key */

-#define KEY_REFRESH   0x173  /* refresh key */

-#define KEY_REPLACE   0x174  /* replace key */

-#define KEY_RESTART   0x175  /* restart key */

-#define KEY_RESUME    0x176  /* resume key */

-#define KEY_SAVE      0x177  /* save key */

-#define KEY_SBEG      0x178  /* shifted beginning key */

-#define KEY_SCANCEL   0x179  /* shifted cancel key */

-#define KEY_SCOMMAND  0x17a  /* shifted command key */

-#define KEY_SCOPY     0x17b  /* shifted copy key */

-#define KEY_SCREATE   0x17c  /* shifted create key */

-#define KEY_SDC       0x17d  /* shifted delete char key */

-#define KEY_SDL       0x17e  /* shifted delete line key */

-#define KEY_SELECT    0x17f  /* select key */

-#define KEY_SEND      0x180  /* shifted end key */

-#define KEY_SEOL      0x181  /* shifted clear line key */

-#define KEY_SEXIT     0x182  /* shifted exit key */

-#define KEY_SFIND     0x183  /* shifted find key */

-#define KEY_SHOME     0x184  /* shifted home key */

-#define KEY_SIC       0x185  /* shifted input key */

-

-#define KEY_SLEFT     0x187  /* shifted left arrow key */

-#define KEY_SMESSAGE  0x188  /* shifted message key */

-#define KEY_SMOVE     0x189  /* shifted move key */

-#define KEY_SNEXT     0x18a  /* shifted next key */

-#define KEY_SOPTIONS  0x18b  /* shifted options key */

-#define KEY_SPREVIOUS 0x18c  /* shifted prev key */

-#define KEY_SPRINT    0x18d  /* shifted print key */

-#define KEY_SREDO     0x18e  /* shifted redo key */

-#define KEY_SREPLACE  0x18f  /* shifted replace key */

-#define KEY_SRIGHT    0x190  /* shifted right arrow */

-#define KEY_SRSUME    0x191  /* shifted resume key */

-#define KEY_SSAVE     0x192  /* shifted save key */

-#define KEY_SSUSPEND  0x193  /* shifted suspend key */

-#define KEY_SUNDO     0x194  /* shifted undo key */

-#define KEY_SUSPEND   0x195  /* suspend key */

-#define KEY_UNDO      0x196  /* undo key */

-

-/* PDCurses-specific key definitions -- PC only */

-

-#define ALT_0         0x197

-#define ALT_1         0x198

-#define ALT_2         0x199

-#define ALT_3         0x19a

-#define ALT_4         0x19b

-#define ALT_5         0x19c

-#define ALT_6         0x19d

-#define ALT_7         0x19e

-#define ALT_8         0x19f

-#define ALT_9         0x1a0

-#define ALT_A         0x1a1

-#define ALT_B         0x1a2

-#define ALT_C         0x1a3

-#define ALT_D         0x1a4

-#define ALT_E         0x1a5

-#define ALT_F         0x1a6

-#define ALT_G         0x1a7

-#define ALT_H         0x1a8

-#define ALT_I         0x1a9

-#define ALT_J         0x1aa

-#define ALT_K         0x1ab

-#define ALT_L         0x1ac

-#define ALT_M         0x1ad

-#define ALT_N         0x1ae

-#define ALT_O         0x1af

-#define ALT_P         0x1b0

-#define ALT_Q         0x1b1

-#define ALT_R         0x1b2

-#define ALT_S         0x1b3

-#define ALT_T         0x1b4

-#define ALT_U         0x1b5

-#define ALT_V         0x1b6

-#define ALT_W         0x1b7

-#define ALT_X         0x1b8

-#define ALT_Y         0x1b9

-#define ALT_Z         0x1ba

-

-#define CTL_LEFT      0x1bb  /* Control-Left-Arrow */

-#define CTL_RIGHT     0x1bc

-#define CTL_PGUP      0x1bd

-#define CTL_PGDN      0x1be

-#define CTL_HOME      0x1bf

-#define CTL_END       0x1c0

-

-#define KEY_A1        0x1c1  /* upper left on Virtual keypad */

-#define KEY_A2        0x1c2  /* upper middle on Virt. keypad */

-#define KEY_A3        0x1c3  /* upper right on Vir. keypad */

-#define KEY_B1        0x1c4  /* middle left on Virt. keypad */

-#define KEY_B2        0x1c5  /* center on Virt. keypad */

-#define KEY_B3        0x1c6  /* middle right on Vir. keypad */

-#define KEY_C1        0x1c7  /* lower left on Virt. keypad */

-#define KEY_C2        0x1c8  /* lower middle on Virt. keypad */

-#define KEY_C3        0x1c9  /* lower right on Vir. keypad */

-

-#define PADSLASH      0x1ca  /* slash on keypad */

-#define PADENTER      0x1cb  /* enter on keypad */

-#define CTL_PADENTER  0x1cc  /* ctl-enter on keypad */

-#define ALT_PADENTER  0x1cd  /* alt-enter on keypad */

-#define PADSTOP       0x1ce  /* stop on keypad */

-#define PADSTAR       0x1cf  /* star on keypad */

-#define PADMINUS      0x1d0  /* minus on keypad */

-#define PADPLUS       0x1d1  /* plus on keypad */

-#define CTL_PADSTOP   0x1d2  /* ctl-stop on keypad */

-#define CTL_PADCENTER 0x1d3  /* ctl-enter on keypad */

-#define CTL_PADPLUS   0x1d4  /* ctl-plus on keypad */

-#define CTL_PADMINUS  0x1d5  /* ctl-minus on keypad */

-#define CTL_PADSLASH  0x1d6  /* ctl-slash on keypad */

-#define CTL_PADSTAR   0x1d7  /* ctl-star on keypad */

-#define ALT_PADPLUS   0x1d8  /* alt-plus on keypad */

-#define ALT_PADMINUS  0x1d9  /* alt-minus on keypad */

-#define ALT_PADSLASH  0x1da  /* alt-slash on keypad */

-#define ALT_PADSTAR   0x1db  /* alt-star on keypad */

-#define ALT_PADSTOP   0x1dc  /* alt-stop on keypad */

-#define CTL_INS       0x1dd  /* ctl-insert */

-#define ALT_DEL       0x1de  /* alt-delete */

-#define ALT_INS       0x1df  /* alt-insert */

-#define CTL_UP        0x1e0  /* ctl-up arrow */

-#define CTL_DOWN      0x1e1  /* ctl-down arrow */

-#define CTL_TAB       0x1e2  /* ctl-tab */

-#define ALT_TAB       0x1e3

-#define ALT_MINUS     0x1e4

-#define ALT_EQUAL     0x1e5

-#define ALT_HOME      0x1e6

-#define ALT_PGUP      0x1e7

-#define ALT_PGDN      0x1e8

-#define ALT_END       0x1e9

-#define ALT_UP        0x1ea  /* alt-up arrow */

-#define ALT_DOWN      0x1eb  /* alt-down arrow */

-#define ALT_RIGHT     0x1ec  /* alt-right arrow */

-#define ALT_LEFT      0x1ed  /* alt-left arrow */

-#define ALT_ENTER     0x1ee  /* alt-enter */

-#define ALT_ESC       0x1ef  /* alt-escape */

-#define ALT_BQUOTE    0x1f0  /* alt-back quote */

-#define ALT_LBRACKET  0x1f1  /* alt-left bracket */

-#define ALT_RBRACKET  0x1f2  /* alt-right bracket */

-#define ALT_SEMICOLON 0x1f3  /* alt-semi-colon */

-#define ALT_FQUOTE    0x1f4  /* alt-forward quote */

-#define ALT_COMMA     0x1f5  /* alt-comma */

-#define ALT_STOP      0x1f6  /* alt-stop */

-#define ALT_FSLASH    0x1f7  /* alt-forward slash */

-#define ALT_BKSP      0x1f8  /* alt-backspace */

-#define CTL_BKSP      0x1f9  /* ctl-backspace */

-#define PAD0          0x1fa  /* keypad 0 */

-

-#define CTL_PAD0      0x1fb  /* ctl-keypad 0 */

-#define CTL_PAD1      0x1fc

-#define CTL_PAD2      0x1fd

-#define CTL_PAD3      0x1fe

-#define CTL_PAD4      0x1ff

-#define CTL_PAD5      0x200

-#define CTL_PAD6      0x201

-#define CTL_PAD7      0x202

-#define CTL_PAD8      0x203

-#define CTL_PAD9      0x204

-

-#define ALT_PAD0      0x205  /* alt-keypad 0 */

-#define ALT_PAD1      0x206

-#define ALT_PAD2      0x207

-#define ALT_PAD3      0x208

-#define ALT_PAD4      0x209

-#define ALT_PAD5      0x20a

-#define ALT_PAD6      0x20b

-#define ALT_PAD7      0x20c

-#define ALT_PAD8      0x20d

-#define ALT_PAD9      0x20e

-

-#define CTL_DEL       0x20f  /* clt-delete */

-#define ALT_BSLASH    0x210  /* alt-back slash */

-#define CTL_ENTER     0x211  /* ctl-enter */

-

-#define SHF_PADENTER  0x212  /* shift-enter on keypad */

-#define SHF_PADSLASH  0x213  /* shift-slash on keypad */

-#define SHF_PADSTAR   0x214  /* shift-star  on keypad */

-#define SHF_PADPLUS   0x215  /* shift-plus  on keypad */

-#define SHF_PADMINUS  0x216  /* shift-minus on keypad */

-#define SHF_UP        0x217  /* shift-up on keypad */

-#define SHF_DOWN      0x218  /* shift-down on keypad */

-#define SHF_IC        0x219  /* shift-insert on keypad */

-#define SHF_DC        0x21a  /* shift-delete on keypad */

-

-#define KEY_MOUSE     0x21b  /* "mouse" key */

-#define KEY_SHIFT_L   0x21c  /* Left-shift */

-#define KEY_SHIFT_R   0x21d  /* Right-shift */

-#define KEY_CONTROL_L 0x21e  /* Left-control */

-#define KEY_CONTROL_R 0x21f  /* Right-control */

-#define KEY_ALT_L     0x220  /* Left-alt */

-#define KEY_ALT_R     0x221  /* Right-alt */

-#define KEY_RESIZE    0x222  /* Window resize */

-#define KEY_SUP       0x223  /* Shifted up arrow */

-#define KEY_SDOWN     0x224  /* Shifted down arrow */

-

-#define KEY_MIN       KEY_BREAK      /* Minimum curses key value */

-#define KEY_MAX       KEY_SDOWN      /* Maximum curses key */

-

-#define KEY_F(n)      (KEY_F0 + (n))

-

-/*----------------------------------------------------------------------

- *

- *  Functions

- *

- */

-

-/* Standard */

-

-PDCEX  int     addch(const chtype);

-PDCEX  int     addchnstr(const chtype *, int);

-PDCEX  int     addchstr(const chtype *);

-PDCEX  int     addnstr(const char *, int);

-PDCEX  int     addstr(const char *);

-PDCEX  int     attroff(chtype);

-PDCEX  int     attron(chtype);

-PDCEX  int     attrset(chtype);

-PDCEX  int     attr_get(attr_t *, short *, void *);

-PDCEX  int     attr_off(attr_t, void *);

-PDCEX  int     attr_on(attr_t, void *);

-PDCEX  int     attr_set(attr_t, short, void *);

-PDCEX  int     baudrate(void);

-PDCEX  int     beep(void);

-PDCEX  int     bkgd(chtype);

-PDCEX  void    bkgdset(chtype);

-PDCEX  int     border(chtype, chtype, chtype, chtype,

-                      chtype, chtype, chtype, chtype);

-PDCEX  int     box(WINDOW *, chtype, chtype);

-PDCEX  bool    can_change_color(void);

-PDCEX  int     cbreak(void);

-PDCEX  int     chgat(int, attr_t, short, const void *);

-PDCEX  int     clearok(WINDOW *, bool);

-PDCEX  int     clear(void);

-PDCEX  int     clrtobot(void);

-PDCEX  int     clrtoeol(void);

-PDCEX  int     color_content(short, short *, short *, short *);

-PDCEX  int     color_set(short, void *);

-PDCEX  int     copywin(const WINDOW *, WINDOW *, int, int, int,

-                       int, int, int, int);

-PDCEX  int     curs_set(int);

-PDCEX  int     def_prog_mode(void);

-PDCEX  int     def_shell_mode(void);

-PDCEX  int     delay_output(int);

-PDCEX  int     delch(void);

-PDCEX  int     deleteln(void);

-PDCEX  void    delscreen(SCREEN *);

-PDCEX  int     delwin(WINDOW *);

-PDCEX  WINDOW *derwin(WINDOW *, int, int, int, int);

-PDCEX  int     doupdate(void);

-PDCEX  WINDOW *dupwin(WINDOW *);

-PDCEX  int     echochar(const chtype);

-PDCEX  int     echo(void);

-PDCEX  int     endwin(void);

-PDCEX  char    erasechar(void);

-PDCEX  int     erase(void);

-PDCEX  void    filter(void);

-PDCEX  int     flash(void);

-PDCEX  int     flushinp(void);

-PDCEX  chtype  getbkgd(WINDOW *);

-PDCEX  int     getnstr(char *, int);

-PDCEX  int     getstr(char *);

-PDCEX  WINDOW *getwin(FILE *);

-PDCEX  int     halfdelay(int);

-PDCEX  bool    has_colors(void);

-PDCEX  bool    has_ic(void);

-PDCEX  bool    has_il(void);

-PDCEX  int     hline(chtype, int);

-PDCEX  void    idcok(WINDOW *, bool);

-PDCEX  int     idlok(WINDOW *, bool);

-PDCEX  void    immedok(WINDOW *, bool);

-PDCEX  int     inchnstr(chtype *, int);

-PDCEX  int     inchstr(chtype *);

-PDCEX  chtype  inch(void);

-PDCEX  int     init_color(short, short, short, short);

-PDCEX  int     init_pair(short, short, short);

-PDCEX  WINDOW *initscr(void);

-PDCEX  int     innstr(char *, int);

-PDCEX  int     insch(chtype);

-PDCEX  int     insdelln(int);

-PDCEX  int     insertln(void);

-PDCEX  int     insnstr(const char *, int);

-PDCEX  int     insstr(const char *);

-PDCEX  int     instr(char *);

-PDCEX  int     intrflush(WINDOW *, bool);

-PDCEX  bool    isendwin(void);

-PDCEX  bool    is_linetouched(WINDOW *, int);

-PDCEX  bool    is_wintouched(WINDOW *);

-PDCEX  char   *keyname(int);

-PDCEX  int     keypad(WINDOW *, bool);

-PDCEX  char    killchar(void);

-PDCEX  int     leaveok(WINDOW *, bool);

-PDCEX  char   *longname(void);

-PDCEX  int     meta(WINDOW *, bool);

-PDCEX  int     move(int, int);

-PDCEX  int     mvaddch(int, int, const chtype);

-PDCEX  int     mvaddchnstr(int, int, const chtype *, int);

-PDCEX  int     mvaddchstr(int, int, const chtype *);

-PDCEX  int     mvaddnstr(int, int, const char *, int);

-PDCEX  int     mvaddstr(int, int, const char *);

-PDCEX  int     mvchgat(int, int, int, attr_t, short, const void *);

-PDCEX  int     mvcur(int, int, int, int);

-PDCEX  int     mvdelch(int, int);

-PDCEX  int     mvderwin(WINDOW *, int, int);

-PDCEX  int     mvgetch(int, int);

-PDCEX  int     mvgetnstr(int, int, char *, int);

-PDCEX  int     mvgetstr(int, int, char *);

-PDCEX  int     mvhline(int, int, chtype, int);

-PDCEX  chtype  mvinch(int, int);

-PDCEX  int     mvinchnstr(int, int, chtype *, int);

-PDCEX  int     mvinchstr(int, int, chtype *);

-PDCEX  int     mvinnstr(int, int, char *, int);

-PDCEX  int     mvinsch(int, int, chtype);

-PDCEX  int     mvinsnstr(int, int, const char *, int);

-PDCEX  int     mvinsstr(int, int, const char *);

-PDCEX  int     mvinstr(int, int, char *);

-PDCEX  int     mvprintw(int, int, const char *, ...);

-PDCEX  int     mvscanw(int, int, const char *, ...);

-PDCEX  int     mvvline(int, int, chtype, int);

-PDCEX  int     mvwaddchnstr(WINDOW *, int, int, const chtype *, int);

-PDCEX  int     mvwaddchstr(WINDOW *, int, int, const chtype *);

-PDCEX  int     mvwaddch(WINDOW *, int, int, const chtype);

-PDCEX  int     mvwaddnstr(WINDOW *, int, int, const char *, int);

-PDCEX  int     mvwaddstr(WINDOW *, int, int, const char *);

-PDCEX  int     mvwchgat(WINDOW *, int, int, int, attr_t, short, const void *);

-PDCEX  int     mvwdelch(WINDOW *, int, int);

-PDCEX  int     mvwgetch(WINDOW *, int, int);

-PDCEX  int     mvwgetnstr(WINDOW *, int, int, char *, int);

-PDCEX  int     mvwgetstr(WINDOW *, int, int, char *);

-PDCEX  int     mvwhline(WINDOW *, int, int, chtype, int);

-PDCEX  int     mvwinchnstr(WINDOW *, int, int, chtype *, int);

-PDCEX  int     mvwinchstr(WINDOW *, int, int, chtype *);

-PDCEX  chtype  mvwinch(WINDOW *, int, int);

-PDCEX  int     mvwinnstr(WINDOW *, int, int, char *, int);

-PDCEX  int     mvwinsch(WINDOW *, int, int, chtype);

-PDCEX  int     mvwinsnstr(WINDOW *, int, int, const char *, int);

-PDCEX  int     mvwinsstr(WINDOW *, int, int, const char *);

-PDCEX  int     mvwinstr(WINDOW *, int, int, char *);

-PDCEX  int     mvwin(WINDOW *, int, int);

-PDCEX  int     mvwprintw(WINDOW *, int, int, const char *, ...);

-PDCEX  int     mvwscanw(WINDOW *, int, int, const char *, ...);

-PDCEX  int     mvwvline(WINDOW *, int, int, chtype, int);

-PDCEX  int     napms(int);

-PDCEX  WINDOW *newpad(int, int);

-PDCEX  SCREEN *newterm(const char *, FILE *, FILE *);

-PDCEX  WINDOW *newwin(int, int, int, int);

-PDCEX  int     nl(void);

-PDCEX  int     nocbreak(void);

-PDCEX  int     nodelay(WINDOW *, bool);

-PDCEX  int     noecho(void);

-PDCEX  int     nonl(void);

-PDCEX  void    noqiflush(void);

-PDCEX  int     noraw(void);

-PDCEX  int     notimeout(WINDOW *, bool);

-PDCEX  int     overlay(const WINDOW *, WINDOW *);

-PDCEX  int     overwrite(const WINDOW *, WINDOW *);

-PDCEX  int     pair_content(short, short *, short *);

-PDCEX  int     pechochar(WINDOW *, chtype);

-PDCEX  int     pnoutrefresh(WINDOW *, int, int, int, int, int, int);

-PDCEX  int     prefresh(WINDOW *, int, int, int, int, int, int);

-PDCEX  int     printw(const char *, ...);

-PDCEX  int     putwin(WINDOW *, FILE *);

-PDCEX  void    qiflush(void);

-PDCEX  int     raw(void);

-PDCEX  int     redrawwin(WINDOW *);

-PDCEX  int     refresh(void);

-PDCEX  int     reset_prog_mode(void);

-PDCEX  int     reset_shell_mode(void);

-PDCEX  int     resetty(void);

-PDCEX  int     ripoffline(int, int (*)(WINDOW *, int));

-PDCEX  int     savetty(void);

-PDCEX  int     scanw(const char *, ...);

-PDCEX  int     scr_dump(const char *);

-PDCEX  int     scr_init(const char *);

-PDCEX  int     scr_restore(const char *);

-PDCEX  int     scr_set(const char *);

-PDCEX  int     scrl(int);

-PDCEX  int     scroll(WINDOW *);

-PDCEX  int     scrollok(WINDOW *, bool);

-PDCEX  SCREEN *set_term(SCREEN *);

-PDCEX  int     setscrreg(int, int);

-PDCEX  int     slk_attroff(const chtype);

-PDCEX  int     slk_attr_off(const attr_t, void *);

-PDCEX  int     slk_attron(const chtype);

-PDCEX  int     slk_attr_on(const attr_t, void *);

-PDCEX  int     slk_attrset(const chtype);

-PDCEX  int     slk_attr_set(const attr_t, short, void *);

-PDCEX  int     slk_clear(void);

-PDCEX  int     slk_color(short);

-PDCEX  int     slk_init(int);

-PDCEX  char   *slk_label(int);

-PDCEX  int     slk_noutrefresh(void);

-PDCEX  int     slk_refresh(void);

-PDCEX  int     slk_restore(void);

-PDCEX  int     slk_set(int, const char *, int);

-PDCEX  int     slk_touch(void);

-PDCEX  int     standend(void);

-PDCEX  int     standout(void);

-PDCEX  int     start_color(void);

-PDCEX  WINDOW *subpad(WINDOW *, int, int, int, int);

-PDCEX  WINDOW *subwin(WINDOW *, int, int, int, int);

-PDCEX  int     syncok(WINDOW *, bool);

-PDCEX  chtype  termattrs(void);

-PDCEX  attr_t  term_attrs(void);

-PDCEX  char   *termname(void);

-PDCEX  void    timeout(int);

-PDCEX  int     touchline(WINDOW *, int, int);

-PDCEX  int     touchwin(WINDOW *);

-PDCEX  int     typeahead(int);

-PDCEX  int     untouchwin(WINDOW *);

-PDCEX  void    use_env(bool);

-PDCEX  int     vidattr(chtype);

-PDCEX  int     vid_attr(attr_t, short, void *);

-PDCEX  int     vidputs(chtype, int (*)(int));

-PDCEX  int     vid_puts(attr_t, short, void *, int (*)(int));

-PDCEX  int     vline(chtype, int);

-PDCEX  int     vw_printw(WINDOW *, const char *, va_list);

-PDCEX  int     vwprintw(WINDOW *, const char *, va_list);

-PDCEX  int     vw_scanw(WINDOW *, const char *, va_list);

-PDCEX  int     vwscanw(WINDOW *, const char *, va_list);

-PDCEX  int     waddchnstr(WINDOW *, const chtype *, int);

-PDCEX  int     waddchstr(WINDOW *, const chtype *);

-PDCEX  int     waddch(WINDOW *, const chtype);

-PDCEX  int     waddnstr(WINDOW *, const char *, int);

-PDCEX  int     waddstr(WINDOW *, const char *);

-PDCEX  int     wattroff(WINDOW *, chtype);

-PDCEX  int     wattron(WINDOW *, chtype);

-PDCEX  int     wattrset(WINDOW *, chtype);

-PDCEX  int     wattr_get(WINDOW *, attr_t *, short *, void *);

-PDCEX  int     wattr_off(WINDOW *, attr_t, void *);

-PDCEX  int     wattr_on(WINDOW *, attr_t, void *);

-PDCEX  int     wattr_set(WINDOW *, attr_t, short, void *);

-PDCEX  void    wbkgdset(WINDOW *, chtype);

-PDCEX  int     wbkgd(WINDOW *, chtype);

-PDCEX  int     wborder(WINDOW *, chtype, chtype, chtype, chtype,

-                       chtype, chtype, chtype, chtype);

-PDCEX  int     wchgat(WINDOW *, int, attr_t, short, const void *);

-PDCEX  int     wclear(WINDOW *);

-PDCEX  int     wclrtobot(WINDOW *);

-PDCEX  int     wclrtoeol(WINDOW *);

-PDCEX  int     wcolor_set(WINDOW *, short, void *);

-PDCEX  void    wcursyncup(WINDOW *);

-PDCEX  int     wdelch(WINDOW *);

-PDCEX  int     wdeleteln(WINDOW *);

-PDCEX  int     wechochar(WINDOW *, const chtype);

-PDCEX  int     werase(WINDOW *);

-PDCEX  int     wgetch(WINDOW *);

-PDCEX  int     wgetnstr(WINDOW *, char *, int);

-PDCEX  int     wgetstr(WINDOW *, char *);

-PDCEX  int     whline(WINDOW *, chtype, int);

-PDCEX  int     winchnstr(WINDOW *, chtype *, int);

-PDCEX  int     winchstr(WINDOW *, chtype *);

-PDCEX  chtype  winch(WINDOW *);

-PDCEX  int     winnstr(WINDOW *, char *, int);

-PDCEX  int     winsch(WINDOW *, chtype);

-PDCEX  int     winsdelln(WINDOW *, int);

-PDCEX  int     winsertln(WINDOW *);

-PDCEX  int     winsnstr(WINDOW *, const char *, int);

-PDCEX  int     winsstr(WINDOW *, const char *);

-PDCEX  int     winstr(WINDOW *, char *);

-PDCEX  int     wmove(WINDOW *, int, int);

-PDCEX  int     wnoutrefresh(WINDOW *);

-PDCEX  int     wprintw(WINDOW *, const char *, ...);

-PDCEX  int     wredrawln(WINDOW *, int, int);

-PDCEX  int     wrefresh(WINDOW *);

-PDCEX  int     wscanw(WINDOW *, const char *, ...);

-PDCEX  int     wscrl(WINDOW *, int);

-PDCEX  int     wsetscrreg(WINDOW *, int, int);

-PDCEX  int     wstandend(WINDOW *);

-PDCEX  int     wstandout(WINDOW *);

-PDCEX  void    wsyncdown(WINDOW *);

-PDCEX  void    wsyncup(WINDOW *);

-PDCEX  void    wtimeout(WINDOW *, int);

-PDCEX  int     wtouchln(WINDOW *, int, int, int);

-PDCEX  int     wvline(WINDOW *, chtype, int);

-

-/* Wide-character functions */

-

-#ifdef PDC_WIDE

-PDCEX  int     addnwstr(const wchar_t *, int);

-PDCEX  int     addwstr(const wchar_t *);

-PDCEX  int     add_wch(const cchar_t *);

-PDCEX  int     add_wchnstr(const cchar_t *, int);

-PDCEX  int     add_wchstr(const cchar_t *);

-PDCEX  int     bkgrnd(const cchar_t *);

-PDCEX  void    bkgrndset(const cchar_t *);

-PDCEX  int     border_set(const cchar_t *, const cchar_t *, const cchar_t *,

-                          const cchar_t *, const cchar_t *, const cchar_t *,

-                          const cchar_t *, const cchar_t *);

-PDCEX  int     box_set(WINDOW *, const cchar_t *, const cchar_t *);

-PDCEX  int     echo_wchar(const cchar_t *);

-PDCEX  int     erasewchar(wchar_t *);

-PDCEX  int     getbkgrnd(cchar_t *);

-PDCEX  int     getcchar(const cchar_t *, wchar_t *, attr_t *, short *, void *);

-PDCEX  int     getn_wstr(wint_t *, int);

-PDCEX  int     get_wch(wint_t *);

-PDCEX  int     get_wstr(wint_t *);

-PDCEX  int     hline_set(const cchar_t *, int);

-PDCEX  int     innwstr(wchar_t *, int);

-PDCEX  int     ins_nwstr(const wchar_t *, int);

-PDCEX  int     ins_wch(const cchar_t *);

-PDCEX  int     ins_wstr(const wchar_t *);

-PDCEX  int     inwstr(wchar_t *);

-PDCEX  int     in_wch(cchar_t *);

-PDCEX  int     in_wchnstr(cchar_t *, int);

-PDCEX  int     in_wchstr(cchar_t *);

-PDCEX  char   *key_name(wchar_t);

-PDCEX  int     killwchar(wchar_t *);

-PDCEX  int     mvaddnwstr(int, int, const wchar_t *, int);

-PDCEX  int     mvaddwstr(int, int, const wchar_t *);

-PDCEX  int     mvadd_wch(int, int, const cchar_t *);

-PDCEX  int     mvadd_wchnstr(int, int, const cchar_t *, int);

-PDCEX  int     mvadd_wchstr(int, int, const cchar_t *);

-PDCEX  int     mvgetn_wstr(int, int, wint_t *, int);

-PDCEX  int     mvget_wch(int, int, wint_t *);

-PDCEX  int     mvget_wstr(int, int, wint_t *);

-PDCEX  int     mvhline_set(int, int, const cchar_t *, int);

-PDCEX  int     mvinnwstr(int, int, wchar_t *, int);

-PDCEX  int     mvins_nwstr(int, int, const wchar_t *, int);

-PDCEX  int     mvins_wch(int, int, const cchar_t *);

-PDCEX  int     mvins_wstr(int, int, const wchar_t *);

-PDCEX  int     mvinwstr(int, int, wchar_t *);

-PDCEX  int     mvin_wch(int, int, cchar_t *);

-PDCEX  int     mvin_wchnstr(int, int, cchar_t *, int);

-PDCEX  int     mvin_wchstr(int, int, cchar_t *);

-PDCEX  int     mvvline_set(int, int, const cchar_t *, int);

-PDCEX  int     mvwaddnwstr(WINDOW *, int, int, const wchar_t *, int);

-PDCEX  int     mvwaddwstr(WINDOW *, int, int, const wchar_t *);

-PDCEX  int     mvwadd_wch(WINDOW *, int, int, const cchar_t *);

-PDCEX  int     mvwadd_wchnstr(WINDOW *, int, int, const cchar_t *, int);

-PDCEX  int     mvwadd_wchstr(WINDOW *, int, int, const cchar_t *);

-PDCEX  int     mvwgetn_wstr(WINDOW *, int, int, wint_t *, int);

-PDCEX  int     mvwget_wch(WINDOW *, int, int, wint_t *);

-PDCEX  int     mvwget_wstr(WINDOW *, int, int, wint_t *);

-PDCEX  int     mvwhline_set(WINDOW *, int, int, const cchar_t *, int);

-PDCEX  int     mvwinnwstr(WINDOW *, int, int, wchar_t *, int);

-PDCEX  int     mvwins_nwstr(WINDOW *, int, int, const wchar_t *, int);

-PDCEX  int     mvwins_wch(WINDOW *, int, int, const cchar_t *);

-PDCEX  int     mvwins_wstr(WINDOW *, int, int, const wchar_t *);

-PDCEX  int     mvwin_wch(WINDOW *, int, int, cchar_t *);

-PDCEX  int     mvwin_wchnstr(WINDOW *, int, int, cchar_t *, int);

-PDCEX  int     mvwin_wchstr(WINDOW *, int, int, cchar_t *);

-PDCEX  int     mvwinwstr(WINDOW *, int, int, wchar_t *);

-PDCEX  int     mvwvline_set(WINDOW *, int, int, const cchar_t *, int);

-PDCEX  int     pecho_wchar(WINDOW *, const cchar_t*);

-PDCEX  int     setcchar(cchar_t*, const wchar_t*, const attr_t,

-                        short, const void*);

-PDCEX  int     slk_wset(int, const wchar_t *, int);

-PDCEX  int     unget_wch(const wchar_t);

-PDCEX  int     vline_set(const cchar_t *, int);

-PDCEX  int     waddnwstr(WINDOW *, const wchar_t *, int);

-PDCEX  int     waddwstr(WINDOW *, const wchar_t *);

-PDCEX  int     wadd_wch(WINDOW *, const cchar_t *);

-PDCEX  int     wadd_wchnstr(WINDOW *, const cchar_t *, int);

-PDCEX  int     wadd_wchstr(WINDOW *, const cchar_t *);

-PDCEX  int     wbkgrnd(WINDOW *, const cchar_t *);

-PDCEX  void    wbkgrndset(WINDOW *, const cchar_t *);

-PDCEX  int     wborder_set(WINDOW *, const cchar_t *, const cchar_t *,

-                           const cchar_t *, const cchar_t *, const cchar_t *,

-                           const cchar_t *, const cchar_t *, const cchar_t *);

-PDCEX  int     wecho_wchar(WINDOW *, const cchar_t *);

-PDCEX  int     wgetbkgrnd(WINDOW *, cchar_t *);

-PDCEX  int     wgetn_wstr(WINDOW *, wint_t *, int);

-PDCEX  int     wget_wch(WINDOW *, wint_t *);

-PDCEX  int     wget_wstr(WINDOW *, wint_t *);

-PDCEX  int     whline_set(WINDOW *, const cchar_t *, int);

-PDCEX  int     winnwstr(WINDOW *, wchar_t *, int);

-PDCEX  int     wins_nwstr(WINDOW *, const wchar_t *, int);

-PDCEX  int     wins_wch(WINDOW *, const cchar_t *);

-PDCEX  int     wins_wstr(WINDOW *, const wchar_t *);

-PDCEX  int     winwstr(WINDOW *, wchar_t *);

-PDCEX  int     win_wch(WINDOW *, cchar_t *);

-PDCEX  int     win_wchnstr(WINDOW *, cchar_t *, int);

-PDCEX  int     win_wchstr(WINDOW *, cchar_t *);

-PDCEX  wchar_t *wunctrl(cchar_t *);

-PDCEX  int     wvline_set(WINDOW *, const cchar_t *, int);

-#endif

-

-/* Quasi-standard */

-

-PDCEX  chtype  getattrs(WINDOW *);

-PDCEX  int     getbegx(WINDOW *);

-PDCEX  int     getbegy(WINDOW *);

-PDCEX  int     getmaxx(WINDOW *);

-PDCEX  int     getmaxy(WINDOW *);

-PDCEX  int     getparx(WINDOW *);

-PDCEX  int     getpary(WINDOW *);

-PDCEX  int     getcurx(WINDOW *);

-PDCEX  int     getcury(WINDOW *);

-PDCEX  void    traceoff(void);

-PDCEX  void    traceon(void);

-PDCEX  char   *unctrl(chtype);

-

-PDCEX  int     crmode(void);

-PDCEX  int     nocrmode(void);

-PDCEX  int     draino(int);

-PDCEX  int     resetterm(void);

-PDCEX  int     fixterm(void);

-PDCEX  int     saveterm(void);

-PDCEX  void    setsyx(int, int);

-

-PDCEX  int     mouse_set(mmask_t);

-PDCEX  int     mouse_on(mmask_t);

-PDCEX  int     mouse_off(mmask_t);

-PDCEX  int     request_mouse_pos(void);

-PDCEX  void    wmouse_position(WINDOW *, int *, int *);

-PDCEX  mmask_t getmouse(void);

-

-/* ncurses */

-

-PDCEX  int     assume_default_colors(int, int);

-PDCEX  const char *curses_version(void);

-PDCEX  bool    has_key(int);

-PDCEX  int     use_default_colors(void);

-PDCEX  int     wresize(WINDOW *, int, int);

-

-PDCEX  int     mouseinterval(int);

-PDCEX  mmask_t mousemask(mmask_t, mmask_t *);

-PDCEX  bool    mouse_trafo(int *, int *, bool);

-PDCEX  int     nc_getmouse(MEVENT *);

-PDCEX  int     ungetmouse(MEVENT *);

-PDCEX  bool    wenclose(const WINDOW *, int, int);

-PDCEX  bool    wmouse_trafo(const WINDOW *, int *, int *, bool);

-

-/* PDCurses */

-

-PDCEX  int     addrawch(chtype);

-PDCEX  int     insrawch(chtype);

-PDCEX  bool    is_termresized(void);

-PDCEX  int     mvaddrawch(int, int, chtype);

-PDCEX  int     mvdeleteln(int, int);

-PDCEX  int     mvinsertln(int, int);

-PDCEX  int     mvinsrawch(int, int, chtype);

-PDCEX  int     mvwaddrawch(WINDOW *, int, int, chtype);

-PDCEX  int     mvwdeleteln(WINDOW *, int, int);

-PDCEX  int     mvwinsertln(WINDOW *, int, int);

-PDCEX  int     mvwinsrawch(WINDOW *, int, int, chtype);

-PDCEX  int     raw_output(bool);

-PDCEX  int     resize_term(int, int);

-PDCEX  WINDOW *resize_window(WINDOW *, int, int);

-PDCEX  int     waddrawch(WINDOW *, chtype);

-PDCEX  int     winsrawch(WINDOW *, chtype);

-PDCEX  char    wordchar(void);

-

-#ifdef PDC_WIDE

-PDCEX  wchar_t *slk_wlabel(int);

-#endif

-

-PDCEX  void    PDC_debug(const char *, ...);

-PDCEX  void    PDC_get_version(PDC_VERSION *);

-PDCEX  int     PDC_ungetch(int);

-PDCEX  int     PDC_set_blink(bool);

-PDCEX  int     PDC_set_bold(bool);

-PDCEX  int     PDC_set_line_color(short);

-PDCEX  void    PDC_set_title(const char *);

-

-PDCEX  int     PDC_clearclipboard(void);

-PDCEX  int     PDC_freeclipboard(char *);

-PDCEX  int     PDC_getclipboard(char **, long *);

-PDCEX  int     PDC_setclipboard(const char *, long);

-

-PDCEX  unsigned long PDC_get_input_fd(void);

-PDCEX  unsigned long PDC_get_key_modifiers(void);

-PDCEX  int     PDC_return_key_modifiers(bool);

-PDCEX  int     PDC_save_key_modifiers(bool);

-

-#ifdef XCURSES

-PDCEX  WINDOW *Xinitscr(int, char **);

-PDCEX  void    XCursesExit(void);

-PDCEX  int     sb_init(void);

-PDCEX  int     sb_set_horz(int, int, int);

-PDCEX  int     sb_set_vert(int, int, int);

-PDCEX  int     sb_get_horz(int *, int *, int *);

-PDCEX  int     sb_get_vert(int *, int *, int *);

-PDCEX  int     sb_refresh(void);

-#endif

-

-/*** Functions defined as macros ***/

-

-/* getch() and ungetch() conflict with some DOS libraries */

-

-#define getch()            wgetch(stdscr)

-#define ungetch(ch)        PDC_ungetch(ch)

-

-#define COLOR_PAIR(n)      (((chtype)(n) << PDC_COLOR_SHIFT) & A_COLOR)

-#define PAIR_NUMBER(n)     (((n) & A_COLOR) >> PDC_COLOR_SHIFT)

-

-/* These will _only_ work as macros */

-

-#define getbegyx(w, y, x)  (y = getbegy(w), x = getbegx(w))

-#define getmaxyx(w, y, x)  (y = getmaxy(w), x = getmaxx(w))

-#define getparyx(w, y, x)  (y = getpary(w), x = getparx(w))

-#define getyx(w, y, x)     (y = getcury(w), x = getcurx(w))

-

-#define getsyx(y, x)       { if (curscr->_leaveit) (y)=(x)=-1; \

-                             else getyx(curscr,(y),(x)); }

-

-#ifdef NCURSES_MOUSE_VERSION

-# define getmouse(x) nc_getmouse(x)

-#endif

-

-/* return codes from PDC_getclipboard() and PDC_setclipboard() calls */

-

-#define PDC_CLIP_SUCCESS         0

-#define PDC_CLIP_ACCESS_ERROR    1

-#define PDC_CLIP_EMPTY           2

-#define PDC_CLIP_MEMORY_ERROR    3

-

-/* PDCurses key modifier masks */

-

-#define PDC_KEY_MODIFIER_SHIFT   1

-#define PDC_KEY_MODIFIER_CONTROL 2

-#define PDC_KEY_MODIFIER_ALT     4

-#define PDC_KEY_MODIFIER_NUMLOCK 8

-

-#ifdef __cplusplus

-# ifndef PDC_PP98

-#  undef bool

-# endif

-}

-#endif

-

-#endif  /* __PDCURSES__ */

+/*----------------------------------------------------------------------*
+ *                              PDCurses                                *
+ *----------------------------------------------------------------------*/
+
+#ifndef __PDCURSES__
+#define __PDCURSES__ 1
+
+/*man-start**************************************************************
+
+Define before inclusion (only those needed):
+
+    XCURSES         True if compiling for X11.
+    PDC_RGB         True if you want to use RGB color definitions
+                    (Red = 1, Green = 2, Blue = 4) instead of BGR.
+    PDC_WIDE        True if building wide-character support.
+    PDC_DLL_BUILD   True if building a Windows DLL.
+    PDC_NCMOUSE     Use the ncurses mouse API instead
+                    of PDCurses' traditional mouse API.
+
+Defined by this header:
+
+    PDCURSES        Enables access to PDCurses-only routines.
+    PDC_BUILD       Defines API build version.
+    PDC_VER_MAJOR   Major version number
+    PDC_VER_MINOR   Minor version number
+    PDC_VERDOT      Version string
+
+**man-end****************************************************************/
+
+#define PDCURSES        1      /* PDCurses-only routines */
+#define PDC_BUILD    3802
+#define PDC_VER_MAJOR   3
+#define PDC_VER_MINOR   8
+#define PDC_VERDOT   "3.8"
+#define CHTYPE_LONG     1      /* chtype >= 32 bits */
+
+#if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L
+# define PDC_99         1
+#endif
+
+#if defined(__cplusplus) && __cplusplus >= 199711L
+# define PDC_PP98       1
+#endif
+
+/*----------------------------------------------------------------------*/
+
+#include <stdarg.h>
+#include <stddef.h>
+#include <stdio.h>             /* Required by X/Open usage below */
+
+#ifdef PDC_WIDE
+# include <wchar.h>
+#endif
+
+#if defined(PDC_99) && !defined(__bool_true_false_are_defined)
+# include <stdbool.h>
+#endif
+
+#ifdef __cplusplus
+extern "C"
+{
+# ifndef PDC_PP98
+#  define bool _bool
+# endif
+#endif
+
+/*----------------------------------------------------------------------
+ *
+ *  Constants and Types
+ *
+ */
+
+#undef FALSE
+#define FALSE 0
+
+#undef TRUE
+#define TRUE 1
+
+#undef ERR
+#define ERR (-1)
+
+#undef OK
+#define OK 0
+
+#if !defined(PDC_PP98) && !defined(__bool_true_false_are_defined)
+typedef unsigned char bool;
+#endif
+
+#if _LP64
+typedef unsigned int chtype;
+#else
+typedef unsigned long chtype;  /* 16-bit attr + 16-bit char */
+#endif
+
+#ifdef PDC_WIDE
+typedef chtype cchar_t;
+#endif
+
+typedef chtype attr_t;
+
+/*----------------------------------------------------------------------
+ *
+ *  Version Info
+ *
+ */
+
+/* Use this structure with PDC_get_version() for run-time info about the
+   way the library was built, in case it doesn't match the header. */
+
+typedef struct
+{
+    short flags;          /* flags OR'd together (see below) */
+    short build;          /* PDC_BUILD at compile time */
+    unsigned char major;  /* PDC_VER_MAJOR */
+    unsigned char minor;  /* PDC_VER_MINOR */
+    unsigned char csize;  /* sizeof chtype */
+    unsigned char bsize;  /* sizeof bool */
+} PDC_VERSION;
+
+enum
+{
+    PDC_VFLAG_DEBUG = 1,  /* set if built with -DPDCDEBUG */
+    PDC_VFLAG_WIDE  = 2,  /* -DPDC_WIDE */
+    PDC_VFLAG_UTF8  = 4,  /* -DPDC_FORCE_UTF8 */
+    PDC_VFLAG_DLL   = 8,  /* -DPDC_DLL_BUILD */
+    PDC_VFLAG_RGB   = 16  /* -DPDC_RGB */
+};
+
+/*----------------------------------------------------------------------
+ *
+ *  Mouse Interface -- SYSVR4, with extensions
+ *
+ */
+
+#if _LP64
+typedef unsigned int mmask_t;
+#else
+typedef unsigned long mmask_t;
+#endif
+
+typedef struct
+{
+    int x;           /* absolute column, 0 based, measured in characters */
+    int y;           /* absolute row, 0 based, measured in characters */
+    short button[3]; /* state of each button */
+    int changes;     /* flags indicating what has changed with the mouse */
+} MOUSE_STATUS;
+
+#define BUTTON_RELEASED         0x0000
+#define BUTTON_PRESSED          0x0001
+#define BUTTON_CLICKED          0x0002
+#define BUTTON_DOUBLE_CLICKED   0x0003
+#define BUTTON_TRIPLE_CLICKED   0x0004
+#define BUTTON_MOVED            0x0005  /* PDCurses */
+#define WHEEL_SCROLLED          0x0006  /* PDCurses */
+#define BUTTON_ACTION_MASK      0x0007  /* PDCurses */
+
+#define PDC_BUTTON_SHIFT        0x0008  /* PDCurses */
+#define PDC_BUTTON_CONTROL      0x0010  /* PDCurses */
+#define PDC_BUTTON_ALT          0x0020  /* PDCurses */
+#define BUTTON_MODIFIER_MASK    0x0038  /* PDCurses */
+
+#define MOUSE_X_POS             (Mouse_status.x)
+#define MOUSE_Y_POS             (Mouse_status.y)
+
+/*
+ * Bits associated with the .changes field:
+ *   3         2         1         0
+ * 210987654321098765432109876543210
+ *                                 1 <- button 1 has changed
+ *                                10 <- button 2 has changed
+ *                               100 <- button 3 has changed
+ *                              1000 <- mouse has moved
+ *                             10000 <- mouse position report
+ *                            100000 <- mouse wheel up
+ *                           1000000 <- mouse wheel down
+ *                          10000000 <- mouse wheel left
+ *                         100000000 <- mouse wheel right
+ */
+
+#define PDC_MOUSE_MOVED         0x0008
+#define PDC_MOUSE_POSITION      0x0010
+#define PDC_MOUSE_WHEEL_UP      0x0020
+#define PDC_MOUSE_WHEEL_DOWN    0x0040
+#define PDC_MOUSE_WHEEL_LEFT    0x0080
+#define PDC_MOUSE_WHEEL_RIGHT   0x0100
+
+#define A_BUTTON_CHANGED        (Mouse_status.changes & 7)
+#define MOUSE_MOVED             (Mouse_status.changes & PDC_MOUSE_MOVED)
+#define MOUSE_POS_REPORT        (Mouse_status.changes & PDC_MOUSE_POSITION)
+#define BUTTON_CHANGED(x)       (Mouse_status.changes & (1 << ((x) - 1)))
+#define BUTTON_STATUS(x)        (Mouse_status.button[(x) - 1])
+#define MOUSE_WHEEL_UP          (Mouse_status.changes & PDC_MOUSE_WHEEL_UP)
+#define MOUSE_WHEEL_DOWN        (Mouse_status.changes & PDC_MOUSE_WHEEL_DOWN)
+#define MOUSE_WHEEL_LEFT        (Mouse_status.changes & PDC_MOUSE_WHEEL_LEFT)
+#define MOUSE_WHEEL_RIGHT       (Mouse_status.changes & PDC_MOUSE_WHEEL_RIGHT)
+
+/* mouse bit-masks */
+
+#define BUTTON1_RELEASED        0x00000001L
+#define BUTTON1_PRESSED         0x00000002L
+#define BUTTON1_CLICKED         0x00000004L
+#define BUTTON1_DOUBLE_CLICKED  0x00000008L
+#define BUTTON1_TRIPLE_CLICKED  0x00000010L
+#define BUTTON1_MOVED           0x00000010L /* PDCurses */
+
+#define BUTTON2_RELEASED        0x00000020L
+#define BUTTON2_PRESSED         0x00000040L
+#define BUTTON2_CLICKED         0x00000080L
+#define BUTTON2_DOUBLE_CLICKED  0x00000100L
+#define BUTTON2_TRIPLE_CLICKED  0x00000200L
+#define BUTTON2_MOVED           0x00000200L /* PDCurses */
+
+#define BUTTON3_RELEASED        0x00000400L
+#define BUTTON3_PRESSED         0x00000800L
+#define BUTTON3_CLICKED         0x00001000L
+#define BUTTON3_DOUBLE_CLICKED  0x00002000L
+#define BUTTON3_TRIPLE_CLICKED  0x00004000L
+#define BUTTON3_MOVED           0x00004000L /* PDCurses */
+
+/* For the ncurses-compatible functions only, BUTTON4_PRESSED and
+   BUTTON5_PRESSED are returned for mouse scroll wheel up and down;
+   otherwise PDCurses doesn't support buttons 4 and 5 */
+
+#define BUTTON4_RELEASED        0x00008000L
+#define BUTTON4_PRESSED         0x00010000L
+#define BUTTON4_CLICKED         0x00020000L
+#define BUTTON4_DOUBLE_CLICKED  0x00040000L
+#define BUTTON4_TRIPLE_CLICKED  0x00080000L
+
+#define BUTTON5_RELEASED        0x00100000L
+#define BUTTON5_PRESSED         0x00200000L
+#define BUTTON5_CLICKED         0x00400000L
+#define BUTTON5_DOUBLE_CLICKED  0x00800000L
+#define BUTTON5_TRIPLE_CLICKED  0x01000000L
+
+#define MOUSE_WHEEL_SCROLL      0x02000000L /* PDCurses */
+#define BUTTON_MODIFIER_SHIFT   0x04000000L /* PDCurses */
+#define BUTTON_MODIFIER_CONTROL 0x08000000L /* PDCurses */
+#define BUTTON_MODIFIER_ALT     0x10000000L /* PDCurses */
+
+#define ALL_MOUSE_EVENTS        0x1fffffffL
+#define REPORT_MOUSE_POSITION   0x20000000L
+
+/* ncurses mouse interface */
+
+typedef struct
+{
+    short id;       /* unused, always 0 */
+    int x, y, z;    /* x, y same as MOUSE_STATUS; z unused */
+    mmask_t bstate; /* equivalent to changes + button[], but
+                       in the same format as used for mousemask() */
+} MEVENT;
+
+#if defined(PDC_NCMOUSE) && !defined(NCURSES_MOUSE_VERSION)
+# define NCURSES_MOUSE_VERSION 2
+#endif
+
+#ifdef NCURSES_MOUSE_VERSION
+# define BUTTON_SHIFT   BUTTON_MODIFIER_SHIFT
+# define BUTTON_CONTROL BUTTON_MODIFIER_CONTROL
+# define BUTTON_CTRL    BUTTON_MODIFIER_CONTROL
+# define BUTTON_ALT     BUTTON_MODIFIER_ALT
+#else
+# define BUTTON_SHIFT   PDC_BUTTON_SHIFT
+# define BUTTON_CONTROL PDC_BUTTON_CONTROL
+# define BUTTON_ALT     PDC_BUTTON_ALT
+#endif
+
+/*----------------------------------------------------------------------
+ *
+ *  Window and Screen Structures
+ *
+ */
+
+typedef struct _win       /* definition of a window */
+{
+    int   _cury;          /* current pseudo-cursor */
+    int   _curx;
+    int   _maxy;          /* max window coordinates */
+    int   _maxx;
+    int   _begy;          /* origin on screen */
+    int   _begx;
+    int   _flags;         /* window properties */
+    chtype _attrs;        /* standard attributes and colors */
+    chtype _bkgd;         /* background, normally blank */
+    bool  _clear;         /* causes clear at next refresh */
+    bool  _leaveit;       /* leaves cursor where it is */
+    bool  _scroll;        /* allows window scrolling */
+    bool  _nodelay;       /* input character wait flag */
+    bool  _immed;         /* immediate update flag */
+    bool  _sync;          /* synchronise window ancestors */
+    bool  _use_keypad;    /* flags keypad key mode active */
+    chtype **_y;          /* pointer to line pointer array */
+    int   *_firstch;      /* first changed character in line */
+    int   *_lastch;       /* last changed character in line */
+    int   _tmarg;         /* top of scrolling region */
+    int   _bmarg;         /* bottom of scrolling region */
+    int   _delayms;       /* milliseconds of delay for getch() */
+    int   _parx, _pary;   /* coords relative to parent (0,0) */
+    struct _win *_parent; /* subwin's pointer to parent win */
+} WINDOW;
+
+/* Avoid using the SCREEN struct directly -- use the corresponding
+   functions if possible. This struct may eventually be made private. */
+
+typedef struct
+{
+    bool  alive;          /* if initscr() called, and not endwin() */
+    bool  autocr;         /* if cr -> lf */
+    bool  cbreak;         /* if terminal unbuffered */
+    bool  echo;           /* if terminal echo */
+    bool  raw_inp;        /* raw input mode (v. cooked input) */
+    bool  raw_out;        /* raw output mode (7 v. 8 bits) */
+    bool  audible;        /* FALSE if the bell is visual */
+    bool  mono;           /* TRUE if current screen is mono */
+    short resized;        /* TRUE if TERM has been resized */
+    bool  orig_attr;      /* TRUE if we have the original colors */
+    short orig_fore;      /* original screen foreground color */
+    short orig_back;      /* original screen foreground color */
+    int   cursrow;        /* position of physical cursor */
+    int   curscol;        /* position of physical cursor */
+    int   visibility;     /* visibility of cursor */
+    int   orig_cursor;    /* original cursor size */
+    int   lines;          /* new value for LINES */
+    int   cols;           /* new value for COLS */
+    mmask_t _trap_mbe;             /* trap these mouse button events */
+    int   mouse_wait;              /* time to wait (in ms) for a
+                                      button release after a press, in
+                                      order to count it as a click */
+    int   slklines;                /* lines in use by slk_init() */
+    WINDOW *slk_winptr;            /* window for slk */
+    int   linesrippedoff;          /* lines ripped off via ripoffline() */
+    int   linesrippedoffontop;     /* lines ripped off on
+                                      top via ripoffline() */
+    int   delaytenths;             /* 1/10ths second to wait block
+                                      getch() for */
+    bool  _preserve;               /* TRUE if screen background
+                                      to be preserved */
+    int   _restore;                /* specifies if screen background
+                                      to be restored, and how */
+    bool  save_key_modifiers;      /* TRUE if each key modifiers saved
+                                      with each key press */
+    bool  return_key_modifiers;    /* TRUE if modifier keys are
+                                      returned as "real" keys */
+    bool  key_code;                /* TRUE if last key is a special key;
+                                      used internally by get_wch() */
+#ifdef XCURSES
+    int   XcurscrSize;    /* size of Xcurscr shared memory block */
+    bool  sb_on;
+    int   sb_viewport_y;
+    int   sb_viewport_x;
+    int   sb_total_y;
+    int   sb_total_x;
+    int   sb_cur_y;
+    int   sb_cur_x;
+#endif
+    short line_color;     /* color of line attributes - default -1 */
+    attr_t termattrs;     /* attribute capabilities */
+} SCREEN;
+
+/*----------------------------------------------------------------------
+ *
+ *  External Variables
+ *
+ */
+
+#ifdef PDC_DLL_BUILD
+# ifdef CURSES_LIBRARY
+#  define PDCEX __declspec(dllexport) extern
+# else
+#  define PDCEX __declspec(dllimport)
+# endif
+#else
+# define PDCEX extern
+#endif
+
+PDCEX  int          LINES;        /* terminal height */
+PDCEX  int          COLS;         /* terminal width */
+PDCEX  WINDOW       *stdscr;      /* the default screen window */
+PDCEX  WINDOW       *curscr;      /* the current screen image */
+PDCEX  SCREEN       *SP;          /* curses variables */
+PDCEX  MOUSE_STATUS Mouse_status;
+PDCEX  int          COLORS;
+PDCEX  int          COLOR_PAIRS;
+PDCEX  int          TABSIZE;
+PDCEX  chtype       acs_map[];    /* alternate character set map */
+PDCEX  char         ttytype[];    /* terminal name/description */
+
+/*man-start**************************************************************
+
+Text Attributes
+===============
+
+PDCurses uses a 32-bit integer for its chtype:
+
+    +--------------------------------------------------------------------+
+    |31|30|29|28|27|26|25|24|23|22|21|20|19|18|17|16|15|14|13|..| 2| 1| 0|
+    +--------------------------------------------------------------------+
+          color pair        |     modifiers         |   character eg 'a'
+
+There are 256 color pairs (8 bits), 8 bits for modifiers, and 16 bits
+for character data. The modifiers are bold, underline, right-line,
+left-line, italic, reverse and blink, plus the alternate character set
+indicator.
+
+**man-end****************************************************************/
+
+/*** Video attribute macros ***/
+
+#define A_NORMAL      (chtype)0
+
+#define A_ALTCHARSET  (chtype)0x00010000
+#define A_RIGHT       (chtype)0x00020000
+#define A_LEFT        (chtype)0x00040000
+#define A_ITALIC      (chtype)0x00080000
+#define A_UNDERLINE   (chtype)0x00100000
+#define A_REVERSE     (chtype)0x00200000
+#define A_BLINK       (chtype)0x00400000
+#define A_BOLD        (chtype)0x00800000
+
+#define A_ATTRIBUTES  (chtype)0xffff0000
+#define A_CHARTEXT    (chtype)0x0000ffff
+#define A_COLOR       (chtype)0xff000000
+
+#define PDC_COLOR_SHIFT 24
+
+#define A_LEFTLINE    A_LEFT
+#define A_RIGHTLINE   A_RIGHT
+#define A_STANDOUT    (A_REVERSE | A_BOLD) /* X/Open */
+
+#define A_DIM         A_NORMAL
+#define A_INVIS       A_NORMAL
+#define A_PROTECT     A_NORMAL
+
+#define A_HORIZONTAL  A_NORMAL
+#define A_LOW         A_NORMAL
+#define A_TOP         A_NORMAL
+#define A_VERTICAL    A_NORMAL
+
+#define CHR_MSK       A_CHARTEXT           /* Obsolete */
+#define ATR_MSK       A_ATTRIBUTES         /* Obsolete */
+#define ATR_NRM       A_NORMAL             /* Obsolete */
+
+/* For use with attr_t -- X/Open says, "these shall be distinct", so
+   this is a non-conforming implementation. */
+
+#define WA_NORMAL     A_NORMAL
+
+#define WA_ALTCHARSET A_ALTCHARSET
+#define WA_BLINK      A_BLINK
+#define WA_BOLD       A_BOLD
+#define WA_DIM        A_DIM
+#define WA_INVIS      A_INVIS
+#define WA_ITALIC     A_ITALIC
+#define WA_LEFT       A_LEFT
+#define WA_PROTECT    A_PROTECT
+#define WA_REVERSE    A_REVERSE
+#define WA_RIGHT      A_RIGHT
+#define WA_STANDOUT   A_STANDOUT
+#define WA_UNDERLINE  A_UNDERLINE
+
+#define WA_HORIZONTAL A_HORIZONTAL
+#define WA_LOW        A_LOW
+#define WA_TOP        A_TOP
+#define WA_VERTICAL   A_VERTICAL
+
+#define WA_ATTRIBUTES A_ATTRIBUTES
+
+/*** Alternate character set macros ***/
+
+#define PDC_ACS(w) ((chtype)w | A_ALTCHARSET)
+
+/* VT100-compatible symbols -- box chars */
+
+#define ACS_ULCORNER  PDC_ACS('l')
+#define ACS_LLCORNER  PDC_ACS('m')
+#define ACS_URCORNER  PDC_ACS('k')
+#define ACS_LRCORNER  PDC_ACS('j')
+#define ACS_RTEE      PDC_ACS('u')
+#define ACS_LTEE      PDC_ACS('t')
+#define ACS_BTEE      PDC_ACS('v')
+#define ACS_TTEE      PDC_ACS('w')
+#define ACS_HLINE     PDC_ACS('q')
+#define ACS_VLINE     PDC_ACS('x')
+#define ACS_PLUS      PDC_ACS('n')
+
+/* VT100-compatible symbols -- other */
+
+#define ACS_S1        PDC_ACS('o')
+#define ACS_S9        PDC_ACS('s')
+#define ACS_DIAMOND   PDC_ACS('`')
+#define ACS_CKBOARD   PDC_ACS('a')
+#define ACS_DEGREE    PDC_ACS('f')
+#define ACS_PLMINUS   PDC_ACS('g')
+#define ACS_BULLET    PDC_ACS('~')
+
+/* Teletype 5410v1 symbols -- these are defined in SysV curses, but
+   are not well-supported by most terminals. Stick to VT100 characters
+   for optimum portability. */
+
+#define ACS_LARROW    PDC_ACS(',')
+#define ACS_RARROW    PDC_ACS('+')
+#define ACS_DARROW    PDC_ACS('.')
+#define ACS_UARROW    PDC_ACS('-')
+#define ACS_BOARD     PDC_ACS('h')
+#define ACS_LANTERN   PDC_ACS('i')
+#define ACS_BLOCK     PDC_ACS('0')
+
+/* That goes double for these -- undocumented SysV symbols. Don't use
+   them. */
+
+#define ACS_S3        PDC_ACS('p')
+#define ACS_S7        PDC_ACS('r')
+#define ACS_LEQUAL    PDC_ACS('y')
+#define ACS_GEQUAL    PDC_ACS('z')
+#define ACS_PI        PDC_ACS('{')
+#define ACS_NEQUAL    PDC_ACS('|')
+#define ACS_STERLING  PDC_ACS('}')
+
+/* Box char aliases */
+
+#define ACS_BSSB      ACS_ULCORNER
+#define ACS_SSBB      ACS_LLCORNER
+#define ACS_BBSS      ACS_URCORNER
+#define ACS_SBBS      ACS_LRCORNER
+#define ACS_SBSS      ACS_RTEE
+#define ACS_SSSB      ACS_LTEE
+#define ACS_SSBS      ACS_BTEE
+#define ACS_BSSS      ACS_TTEE
+#define ACS_BSBS      ACS_HLINE
+#define ACS_SBSB      ACS_VLINE
+#define ACS_SSSS      ACS_PLUS
+
+/* cchar_t aliases */
+
+#ifdef PDC_WIDE
+# define WACS_ULCORNER (&(acs_map['l']))
+# define WACS_LLCORNER (&(acs_map['m']))
+# define WACS_URCORNER (&(acs_map['k']))
+# define WACS_LRCORNER (&(acs_map['j']))
+# define WACS_RTEE     (&(acs_map['u']))
+# define WACS_LTEE     (&(acs_map['t']))
+# define WACS_BTEE     (&(acs_map['v']))
+# define WACS_TTEE     (&(acs_map['w']))
+# define WACS_HLINE    (&(acs_map['q']))
+# define WACS_VLINE    (&(acs_map['x']))
+# define WACS_PLUS     (&(acs_map['n']))
+
+# define WACS_S1       (&(acs_map['o']))
+# define WACS_S9       (&(acs_map['s']))
+# define WACS_DIAMOND  (&(acs_map['`']))
+# define WACS_CKBOARD  (&(acs_map['a']))
+# define WACS_DEGREE   (&(acs_map['f']))
+# define WACS_PLMINUS  (&(acs_map['g']))
+# define WACS_BULLET   (&(acs_map['~']))
+
+# define WACS_LARROW   (&(acs_map[',']))
+# define WACS_RARROW   (&(acs_map['+']))
+# define WACS_DARROW   (&(acs_map['.']))
+# define WACS_UARROW   (&(acs_map['-']))
+# define WACS_BOARD    (&(acs_map['h']))
+# define WACS_LANTERN  (&(acs_map['i']))
+# define WACS_BLOCK    (&(acs_map['0']))
+
+# define WACS_S3       (&(acs_map['p']))
+# define WACS_S7       (&(acs_map['r']))
+# define WACS_LEQUAL   (&(acs_map['y']))
+# define WACS_GEQUAL   (&(acs_map['z']))
+# define WACS_PI       (&(acs_map['{']))
+# define WACS_NEQUAL   (&(acs_map['|']))
+# define WACS_STERLING (&(acs_map['}']))
+
+# define WACS_BSSB     WACS_ULCORNER
+# define WACS_SSBB     WACS_LLCORNER
+# define WACS_BBSS     WACS_URCORNER
+# define WACS_SBBS     WACS_LRCORNER
+# define WACS_SBSS     WACS_RTEE
+# define WACS_SSSB     WACS_LTEE
+# define WACS_SSBS     WACS_BTEE
+# define WACS_BSSS     WACS_TTEE
+# define WACS_BSBS     WACS_HLINE
+# define WACS_SBSB     WACS_VLINE
+# define WACS_SSSS     WACS_PLUS
+#endif
+
+/*** Color macros ***/
+
+#define COLOR_BLACK   0
+
+#ifdef PDC_RGB        /* RGB */
+# define COLOR_RED    1
+# define COLOR_GREEN  2
+# define COLOR_BLUE   4
+#else                 /* BGR */
+# define COLOR_BLUE   1
+# define COLOR_GREEN  2
+# define COLOR_RED    4
+#endif
+
+#define COLOR_CYAN    (COLOR_BLUE | COLOR_GREEN)
+#define COLOR_MAGENTA (COLOR_RED | COLOR_BLUE)
+#define COLOR_YELLOW  (COLOR_RED | COLOR_GREEN)
+
+#define COLOR_WHITE   7
+
+/*----------------------------------------------------------------------
+ *
+ *  Function and Keypad Key Definitions
+ *  Many are just for compatibility
+ *
+ */
+
+#define KEY_CODE_YES  0x100  /* If get_wch() gives a key code */
+
+#define KEY_BREAK     0x101  /* Not on PC KBD */
+#define KEY_DOWN      0x102  /* Down arrow key */
+#define KEY_UP        0x103  /* Up arrow key */
+#define KEY_LEFT      0x104  /* Left arrow key */
+#define KEY_RIGHT     0x105  /* Right arrow key */
+#define KEY_HOME      0x106  /* home key */
+#define KEY_BACKSPACE 0x107  /* not on pc */
+#define KEY_F0        0x108  /* function keys; 64 reserved */
+
+#define KEY_DL        0x148  /* delete line */
+#define KEY_IL        0x149  /* insert line */
+#define KEY_DC        0x14a  /* delete character */
+#define KEY_IC        0x14b  /* insert char or enter ins mode */
+#define KEY_EIC       0x14c  /* exit insert char mode */
+#define KEY_CLEAR     0x14d  /* clear screen */
+#define KEY_EOS       0x14e  /* clear to end of screen */
+#define KEY_EOL       0x14f  /* clear to end of line */
+#define KEY_SF        0x150  /* scroll 1 line forward */
+#define KEY_SR        0x151  /* scroll 1 line back (reverse) */
+#define KEY_NPAGE     0x152  /* next page */
+#define KEY_PPAGE     0x153  /* previous page */
+#define KEY_STAB      0x154  /* set tab */
+#define KEY_CTAB      0x155  /* clear tab */
+#define KEY_CATAB     0x156  /* clear all tabs */
+#define KEY_ENTER     0x157  /* enter or send (unreliable) */
+#define KEY_SRESET    0x158  /* soft/reset (partial/unreliable) */
+#define KEY_RESET     0x159  /* reset/hard reset (unreliable) */
+#define KEY_PRINT     0x15a  /* print/copy */
+#define KEY_LL        0x15b  /* home down/bottom (lower left) */
+#define KEY_ABORT     0x15c  /* abort/terminate key (any) */
+#define KEY_SHELP     0x15d  /* short help */
+#define KEY_LHELP     0x15e  /* long help */
+#define KEY_BTAB      0x15f  /* Back tab key */
+#define KEY_BEG       0x160  /* beg(inning) key */
+#define KEY_CANCEL    0x161  /* cancel key */
+#define KEY_CLOSE     0x162  /* close key */
+#define KEY_COMMAND   0x163  /* cmd (command) key */
+#define KEY_COPY      0x164  /* copy key */
+#define KEY_CREATE    0x165  /* create key */
+#define KEY_END       0x166  /* end key */
+#define KEY_EXIT      0x167  /* exit key */
+#define KEY_FIND      0x168  /* find key */
+#define KEY_HELP      0x169  /* help key */
+#define KEY_MARK      0x16a  /* mark key */
+#define KEY_MESSAGE   0x16b  /* message key */
+#define KEY_MOVE      0x16c  /* move key */
+#define KEY_NEXT      0x16d  /* next object key */
+#define KEY_OPEN      0x16e  /* open key */
+#define KEY_OPTIONS   0x16f  /* options key */
+#define KEY_PREVIOUS  0x170  /* previous object key */
+#define KEY_REDO      0x171  /* redo key */
+#define KEY_REFERENCE 0x172  /* ref(erence) key */
+#define KEY_REFRESH   0x173  /* refresh key */
+#define KEY_REPLACE   0x174  /* replace key */
+#define KEY_RESTART   0x175  /* restart key */
+#define KEY_RESUME    0x176  /* resume key */
+#define KEY_SAVE      0x177  /* save key */
+#define KEY_SBEG      0x178  /* shifted beginning key */
+#define KEY_SCANCEL   0x179  /* shifted cancel key */
+#define KEY_SCOMMAND  0x17a  /* shifted command key */
+#define KEY_SCOPY     0x17b  /* shifted copy key */
+#define KEY_SCREATE   0x17c  /* shifted create key */
+#define KEY_SDC       0x17d  /* shifted delete char key */
+#define KEY_SDL       0x17e  /* shifted delete line key */
+#define KEY_SELECT    0x17f  /* select key */
+#define KEY_SEND      0x180  /* shifted end key */
+#define KEY_SEOL      0x181  /* shifted clear line key */
+#define KEY_SEXIT     0x182  /* shifted exit key */
+#define KEY_SFIND     0x183  /* shifted find key */
+#define KEY_SHOME     0x184  /* shifted home key */
+#define KEY_SIC       0x185  /* shifted input key */
+
+#define KEY_SLEFT     0x187  /* shifted left arrow key */
+#define KEY_SMESSAGE  0x188  /* shifted message key */
+#define KEY_SMOVE     0x189  /* shifted move key */
+#define KEY_SNEXT     0x18a  /* shifted next key */
+#define KEY_SOPTIONS  0x18b  /* shifted options key */
+#define KEY_SPREVIOUS 0x18c  /* shifted prev key */
+#define KEY_SPRINT    0x18d  /* shifted print key */
+#define KEY_SREDO     0x18e  /* shifted redo key */
+#define KEY_SREPLACE  0x18f  /* shifted replace key */
+#define KEY_SRIGHT    0x190  /* shifted right arrow */
+#define KEY_SRSUME    0x191  /* shifted resume key */
+#define KEY_SSAVE     0x192  /* shifted save key */
+#define KEY_SSUSPEND  0x193  /* shifted suspend key */
+#define KEY_SUNDO     0x194  /* shifted undo key */
+#define KEY_SUSPEND   0x195  /* suspend key */
+#define KEY_UNDO      0x196  /* undo key */
+
+/* PDCurses-specific key definitions -- PC only */
+
+#define ALT_0         0x197
+#define ALT_1         0x198
+#define ALT_2         0x199
+#define ALT_3         0x19a
+#define ALT_4         0x19b
+#define ALT_5         0x19c
+#define ALT_6         0x19d
+#define ALT_7         0x19e
+#define ALT_8         0x19f
+#define ALT_9         0x1a0
+#define ALT_A         0x1a1
+#define ALT_B         0x1a2
+#define ALT_C         0x1a3
+#define ALT_D         0x1a4
+#define ALT_E         0x1a5
+#define ALT_F         0x1a6
+#define ALT_G         0x1a7
+#define ALT_H         0x1a8
+#define ALT_I         0x1a9
+#define ALT_J         0x1aa
+#define ALT_K         0x1ab
+#define ALT_L         0x1ac
+#define ALT_M         0x1ad
+#define ALT_N         0x1ae
+#define ALT_O         0x1af
+#define ALT_P         0x1b0
+#define ALT_Q         0x1b1
+#define ALT_R         0x1b2
+#define ALT_S         0x1b3
+#define ALT_T         0x1b4
+#define ALT_U         0x1b5
+#define ALT_V         0x1b6
+#define ALT_W         0x1b7
+#define ALT_X         0x1b8
+#define ALT_Y         0x1b9
+#define ALT_Z         0x1ba
+
+#define CTL_LEFT      0x1bb  /* Control-Left-Arrow */
+#define CTL_RIGHT     0x1bc
+#define CTL_PGUP      0x1bd
+#define CTL_PGDN      0x1be
+#define CTL_HOME      0x1bf
+#define CTL_END       0x1c0
+
+#define KEY_A1        0x1c1  /* upper left on Virtual keypad */
+#define KEY_A2        0x1c2  /* upper middle on Virt. keypad */
+#define KEY_A3        0x1c3  /* upper right on Vir. keypad */
+#define KEY_B1        0x1c4  /* middle left on Virt. keypad */
+#define KEY_B2        0x1c5  /* center on Virt. keypad */
+#define KEY_B3        0x1c6  /* middle right on Vir. keypad */
+#define KEY_C1        0x1c7  /* lower left on Virt. keypad */
+#define KEY_C2        0x1c8  /* lower middle on Virt. keypad */
+#define KEY_C3        0x1c9  /* lower right on Vir. keypad */
+
+#define PADSLASH      0x1ca  /* slash on keypad */
+#define PADENTER      0x1cb  /* enter on keypad */
+#define CTL_PADENTER  0x1cc  /* ctl-enter on keypad */
+#define ALT_PADENTER  0x1cd  /* alt-enter on keypad */
+#define PADSTOP       0x1ce  /* stop on keypad */
+#define PADSTAR       0x1cf  /* star on keypad */
+#define PADMINUS      0x1d0  /* minus on keypad */
+#define PADPLUS       0x1d1  /* plus on keypad */
+#define CTL_PADSTOP   0x1d2  /* ctl-stop on keypad */
+#define CTL_PADCENTER 0x1d3  /* ctl-enter on keypad */
+#define CTL_PADPLUS   0x1d4  /* ctl-plus on keypad */
+#define CTL_PADMINUS  0x1d5  /* ctl-minus on keypad */
+#define CTL_PADSLASH  0x1d6  /* ctl-slash on keypad */
+#define CTL_PADSTAR   0x1d7  /* ctl-star on keypad */
+#define ALT_PADPLUS   0x1d8  /* alt-plus on keypad */
+#define ALT_PADMINUS  0x1d9  /* alt-minus on keypad */
+#define ALT_PADSLASH  0x1da  /* alt-slash on keypad */
+#define ALT_PADSTAR   0x1db  /* alt-star on keypad */
+#define ALT_PADSTOP   0x1dc  /* alt-stop on keypad */
+#define CTL_INS       0x1dd  /* ctl-insert */
+#define ALT_DEL       0x1de  /* alt-delete */
+#define ALT_INS       0x1df  /* alt-insert */
+#define CTL_UP        0x1e0  /* ctl-up arrow */
+#define CTL_DOWN      0x1e1  /* ctl-down arrow */
+#define CTL_TAB       0x1e2  /* ctl-tab */
+#define ALT_TAB       0x1e3
+#define ALT_MINUS     0x1e4
+#define ALT_EQUAL     0x1e5
+#define ALT_HOME      0x1e6
+#define ALT_PGUP      0x1e7
+#define ALT_PGDN      0x1e8
+#define ALT_END       0x1e9
+#define ALT_UP        0x1ea  /* alt-up arrow */
+#define ALT_DOWN      0x1eb  /* alt-down arrow */
+#define ALT_RIGHT     0x1ec  /* alt-right arrow */
+#define ALT_LEFT      0x1ed  /* alt-left arrow */
+#define ALT_ENTER     0x1ee  /* alt-enter */
+#define ALT_ESC       0x1ef  /* alt-escape */
+#define ALT_BQUOTE    0x1f0  /* alt-back quote */
+#define ALT_LBRACKET  0x1f1  /* alt-left bracket */
+#define ALT_RBRACKET  0x1f2  /* alt-right bracket */
+#define ALT_SEMICOLON 0x1f3  /* alt-semi-colon */
+#define ALT_FQUOTE    0x1f4  /* alt-forward quote */
+#define ALT_COMMA     0x1f5  /* alt-comma */
+#define ALT_STOP      0x1f6  /* alt-stop */
+#define ALT_FSLASH    0x1f7  /* alt-forward slash */
+#define ALT_BKSP      0x1f8  /* alt-backspace */
+#define CTL_BKSP      0x1f9  /* ctl-backspace */
+#define PAD0          0x1fa  /* keypad 0 */
+
+#define CTL_PAD0      0x1fb  /* ctl-keypad 0 */
+#define CTL_PAD1      0x1fc
+#define CTL_PAD2      0x1fd
+#define CTL_PAD3      0x1fe
+#define CTL_PAD4      0x1ff
+#define CTL_PAD5      0x200
+#define CTL_PAD6      0x201
+#define CTL_PAD7      0x202
+#define CTL_PAD8      0x203
+#define CTL_PAD9      0x204
+
+#define ALT_PAD0      0x205  /* alt-keypad 0 */
+#define ALT_PAD1      0x206
+#define ALT_PAD2      0x207
+#define ALT_PAD3      0x208
+#define ALT_PAD4      0x209
+#define ALT_PAD5      0x20a
+#define ALT_PAD6      0x20b
+#define ALT_PAD7      0x20c
+#define ALT_PAD8      0x20d
+#define ALT_PAD9      0x20e
+
+#define CTL_DEL       0x20f  /* clt-delete */
+#define ALT_BSLASH    0x210  /* alt-back slash */
+#define CTL_ENTER     0x211  /* ctl-enter */
+
+#define SHF_PADENTER  0x212  /* shift-enter on keypad */
+#define SHF_PADSLASH  0x213  /* shift-slash on keypad */
+#define SHF_PADSTAR   0x214  /* shift-star  on keypad */
+#define SHF_PADPLUS   0x215  /* shift-plus  on keypad */
+#define SHF_PADMINUS  0x216  /* shift-minus on keypad */
+#define SHF_UP        0x217  /* shift-up on keypad */
+#define SHF_DOWN      0x218  /* shift-down on keypad */
+#define SHF_IC        0x219  /* shift-insert on keypad */
+#define SHF_DC        0x21a  /* shift-delete on keypad */
+
+#define KEY_MOUSE     0x21b  /* "mouse" key */
+#define KEY_SHIFT_L   0x21c  /* Left-shift */
+#define KEY_SHIFT_R   0x21d  /* Right-shift */
+#define KEY_CONTROL_L 0x21e  /* Left-control */
+#define KEY_CONTROL_R 0x21f  /* Right-control */
+#define KEY_ALT_L     0x220  /* Left-alt */
+#define KEY_ALT_R     0x221  /* Right-alt */
+#define KEY_RESIZE    0x222  /* Window resize */
+#define KEY_SUP       0x223  /* Shifted up arrow */
+#define KEY_SDOWN     0x224  /* Shifted down arrow */
+
+#define KEY_MIN       KEY_BREAK      /* Minimum curses key value */
+#define KEY_MAX       KEY_SDOWN      /* Maximum curses key */
+
+#define KEY_F(n)      (KEY_F0 + (n))
+
+/*----------------------------------------------------------------------
+ *
+ *  Functions
+ *
+ */
+
+/* Standard */
+
+PDCEX  int     addch(const chtype);
+PDCEX  int     addchnstr(const chtype *, int);
+PDCEX  int     addchstr(const chtype *);
+PDCEX  int     addnstr(const char *, int);
+PDCEX  int     addstr(const char *);
+PDCEX  int     attroff(chtype);
+PDCEX  int     attron(chtype);
+PDCEX  int     attrset(chtype);
+PDCEX  int     attr_get(attr_t *, short *, void *);
+PDCEX  int     attr_off(attr_t, void *);
+PDCEX  int     attr_on(attr_t, void *);
+PDCEX  int     attr_set(attr_t, short, void *);
+PDCEX  int     baudrate(void);
+PDCEX  int     beep(void);
+PDCEX  int     bkgd(chtype);
+PDCEX  void    bkgdset(chtype);
+PDCEX  int     border(chtype, chtype, chtype, chtype,
+                      chtype, chtype, chtype, chtype);
+PDCEX  int     box(WINDOW *, chtype, chtype);
+PDCEX  bool    can_change_color(void);
+PDCEX  int     cbreak(void);
+PDCEX  int     chgat(int, attr_t, short, const void *);
+PDCEX  int     clearok(WINDOW *, bool);
+PDCEX  int     clear(void);
+PDCEX  int     clrtobot(void);
+PDCEX  int     clrtoeol(void);
+PDCEX  int     color_content(short, short *, short *, short *);
+PDCEX  int     color_set(short, void *);
+PDCEX  int     copywin(const WINDOW *, WINDOW *, int, int, int,
+                       int, int, int, int);
+PDCEX  int     curs_set(int);
+PDCEX  int     def_prog_mode(void);
+PDCEX  int     def_shell_mode(void);
+PDCEX  int     delay_output(int);
+PDCEX  int     delch(void);
+PDCEX  int     deleteln(void);
+PDCEX  void    delscreen(SCREEN *);
+PDCEX  int     delwin(WINDOW *);
+PDCEX  WINDOW *derwin(WINDOW *, int, int, int, int);
+PDCEX  int     doupdate(void);
+PDCEX  WINDOW *dupwin(WINDOW *);
+PDCEX  int     echochar(const chtype);
+PDCEX  int     echo(void);
+PDCEX  int     endwin(void);
+PDCEX  char    erasechar(void);
+PDCEX  int     erase(void);
+PDCEX  void    filter(void);
+PDCEX  int     flash(void);
+PDCEX  int     flushinp(void);
+PDCEX  chtype  getbkgd(WINDOW *);
+PDCEX  int     getnstr(char *, int);
+PDCEX  int     getstr(char *);
+PDCEX  WINDOW *getwin(FILE *);
+PDCEX  int     halfdelay(int);
+PDCEX  bool    has_colors(void);
+PDCEX  bool    has_ic(void);
+PDCEX  bool    has_il(void);
+PDCEX  int     hline(chtype, int);
+PDCEX  void    idcok(WINDOW *, bool);
+PDCEX  int     idlok(WINDOW *, bool);
+PDCEX  void    immedok(WINDOW *, bool);
+PDCEX  int     inchnstr(chtype *, int);
+PDCEX  int     inchstr(chtype *);
+PDCEX  chtype  inch(void);
+PDCEX  int     init_color(short, short, short, short);
+PDCEX  int     init_pair(short, short, short);
+PDCEX  WINDOW *initscr(void);
+PDCEX  int     innstr(char *, int);
+PDCEX  int     insch(chtype);
+PDCEX  int     insdelln(int);
+PDCEX  int     insertln(void);
+PDCEX  int     insnstr(const char *, int);
+PDCEX  int     insstr(const char *);
+PDCEX  int     instr(char *);
+PDCEX  int     intrflush(WINDOW *, bool);
+PDCEX  bool    isendwin(void);
+PDCEX  bool    is_linetouched(WINDOW *, int);
+PDCEX  bool    is_wintouched(WINDOW *);
+PDCEX  char   *keyname(int);
+PDCEX  int     keypad(WINDOW *, bool);
+PDCEX  char    killchar(void);
+PDCEX  int     leaveok(WINDOW *, bool);
+PDCEX  char   *longname(void);
+PDCEX  int     meta(WINDOW *, bool);
+PDCEX  int     move(int, int);
+PDCEX  int     mvaddch(int, int, const chtype);
+PDCEX  int     mvaddchnstr(int, int, const chtype *, int);
+PDCEX  int     mvaddchstr(int, int, const chtype *);
+PDCEX  int     mvaddnstr(int, int, const char *, int);
+PDCEX  int     mvaddstr(int, int, const char *);
+PDCEX  int     mvchgat(int, int, int, attr_t, short, const void *);
+PDCEX  int     mvcur(int, int, int, int);
+PDCEX  int     mvdelch(int, int);
+PDCEX  int     mvderwin(WINDOW *, int, int);
+PDCEX  int     mvgetch(int, int);
+PDCEX  int     mvgetnstr(int, int, char *, int);
+PDCEX  int     mvgetstr(int, int, char *);
+PDCEX  int     mvhline(int, int, chtype, int);
+PDCEX  chtype  mvinch(int, int);
+PDCEX  int     mvinchnstr(int, int, chtype *, int);
+PDCEX  int     mvinchstr(int, int, chtype *);
+PDCEX  int     mvinnstr(int, int, char *, int);
+PDCEX  int     mvinsch(int, int, chtype);
+PDCEX  int     mvinsnstr(int, int, const char *, int);
+PDCEX  int     mvinsstr(int, int, const char *);
+PDCEX  int     mvinstr(int, int, char *);
+PDCEX  int     mvprintw(int, int, const char *, ...);
+PDCEX  int     mvscanw(int, int, const char *, ...);
+PDCEX  int     mvvline(int, int, chtype, int);
+PDCEX  int     mvwaddchnstr(WINDOW *, int, int, const chtype *, int);
+PDCEX  int     mvwaddchstr(WINDOW *, int, int, const chtype *);
+PDCEX  int     mvwaddch(WINDOW *, int, int, const chtype);
+PDCEX  int     mvwaddnstr(WINDOW *, int, int, const char *, int);
+PDCEX  int     mvwaddstr(WINDOW *, int, int, const char *);
+PDCEX  int     mvwchgat(WINDOW *, int, int, int, attr_t, short, const void *);
+PDCEX  int     mvwdelch(WINDOW *, int, int);
+PDCEX  int     mvwgetch(WINDOW *, int, int);
+PDCEX  int     mvwgetnstr(WINDOW *, int, int, char *, int);
+PDCEX  int     mvwgetstr(WINDOW *, int, int, char *);
+PDCEX  int     mvwhline(WINDOW *, int, int, chtype, int);
+PDCEX  int     mvwinchnstr(WINDOW *, int, int, chtype *, int);
+PDCEX  int     mvwinchstr(WINDOW *, int, int, chtype *);
+PDCEX  chtype  mvwinch(WINDOW *, int, int);
+PDCEX  int     mvwinnstr(WINDOW *, int, int, char *, int);
+PDCEX  int     mvwinsch(WINDOW *, int, int, chtype);
+PDCEX  int     mvwinsnstr(WINDOW *, int, int, const char *, int);
+PDCEX  int     mvwinsstr(WINDOW *, int, int, const char *);
+PDCEX  int     mvwinstr(WINDOW *, int, int, char *);
+PDCEX  int     mvwin(WINDOW *, int, int);
+PDCEX  int     mvwprintw(WINDOW *, int, int, const char *, ...);
+PDCEX  int     mvwscanw(WINDOW *, int, int, const char *, ...);
+PDCEX  int     mvwvline(WINDOW *, int, int, chtype, int);
+PDCEX  int     napms(int);
+PDCEX  WINDOW *newpad(int, int);
+PDCEX  SCREEN *newterm(const char *, FILE *, FILE *);
+PDCEX  WINDOW *newwin(int, int, int, int);
+PDCEX  int     nl(void);
+PDCEX  int     nocbreak(void);
+PDCEX  int     nodelay(WINDOW *, bool);
+PDCEX  int     noecho(void);
+PDCEX  int     nonl(void);
+PDCEX  void    noqiflush(void);
+PDCEX  int     noraw(void);
+PDCEX  int     notimeout(WINDOW *, bool);
+PDCEX  int     overlay(const WINDOW *, WINDOW *);
+PDCEX  int     overwrite(const WINDOW *, WINDOW *);
+PDCEX  int     pair_content(short, short *, short *);
+PDCEX  int     pechochar(WINDOW *, chtype);
+PDCEX  int     pnoutrefresh(WINDOW *, int, int, int, int, int, int);
+PDCEX  int     prefresh(WINDOW *, int, int, int, int, int, int);
+PDCEX  int     printw(const char *, ...);
+PDCEX  int     putwin(WINDOW *, FILE *);
+PDCEX  void    qiflush(void);
+PDCEX  int     raw(void);
+PDCEX  int     redrawwin(WINDOW *);
+PDCEX  int     refresh(void);
+PDCEX  int     reset_prog_mode(void);
+PDCEX  int     reset_shell_mode(void);
+PDCEX  int     resetty(void);
+PDCEX  int     ripoffline(int, int (*)(WINDOW *, int));
+PDCEX  int     savetty(void);
+PDCEX  int     scanw(const char *, ...);
+PDCEX  int     scr_dump(const char *);
+PDCEX  int     scr_init(const char *);
+PDCEX  int     scr_restore(const char *);
+PDCEX  int     scr_set(const char *);
+PDCEX  int     scrl(int);
+PDCEX  int     scroll(WINDOW *);
+PDCEX  int     scrollok(WINDOW *, bool);
+PDCEX  SCREEN *set_term(SCREEN *);
+PDCEX  int     setscrreg(int, int);
+PDCEX  int     slk_attroff(const chtype);
+PDCEX  int     slk_attr_off(const attr_t, void *);
+PDCEX  int     slk_attron(const chtype);
+PDCEX  int     slk_attr_on(const attr_t, void *);
+PDCEX  int     slk_attrset(const chtype);
+PDCEX  int     slk_attr_set(const attr_t, short, void *);
+PDCEX  int     slk_clear(void);
+PDCEX  int     slk_color(short);
+PDCEX  int     slk_init(int);
+PDCEX  char   *slk_label(int);
+PDCEX  int     slk_noutrefresh(void);
+PDCEX  int     slk_refresh(void);
+PDCEX  int     slk_restore(void);
+PDCEX  int     slk_set(int, const char *, int);
+PDCEX  int     slk_touch(void);
+PDCEX  int     standend(void);
+PDCEX  int     standout(void);
+PDCEX  int     start_color(void);
+PDCEX  WINDOW *subpad(WINDOW *, int, int, int, int);
+PDCEX  WINDOW *subwin(WINDOW *, int, int, int, int);
+PDCEX  int     syncok(WINDOW *, bool);
+PDCEX  chtype  termattrs(void);
+PDCEX  attr_t  term_attrs(void);
+PDCEX  char   *termname(void);
+PDCEX  void    timeout(int);
+PDCEX  int     touchline(WINDOW *, int, int);
+PDCEX  int     touchwin(WINDOW *);
+PDCEX  int     typeahead(int);
+PDCEX  int     untouchwin(WINDOW *);
+PDCEX  void    use_env(bool);
+PDCEX  int     vidattr(chtype);
+PDCEX  int     vid_attr(attr_t, short, void *);
+PDCEX  int     vidputs(chtype, int (*)(int));
+PDCEX  int     vid_puts(attr_t, short, void *, int (*)(int));
+PDCEX  int     vline(chtype, int);
+PDCEX  int     vw_printw(WINDOW *, const char *, va_list);
+PDCEX  int     vwprintw(WINDOW *, const char *, va_list);
+PDCEX  int     vw_scanw(WINDOW *, const char *, va_list);
+PDCEX  int     vwscanw(WINDOW *, const char *, va_list);
+PDCEX  int     waddchnstr(WINDOW *, const chtype *, int);
+PDCEX  int     waddchstr(WINDOW *, const chtype *);
+PDCEX  int     waddch(WINDOW *, const chtype);
+PDCEX  int     waddnstr(WINDOW *, const char *, int);
+PDCEX  int     waddstr(WINDOW *, const char *);
+PDCEX  int     wattroff(WINDOW *, chtype);
+PDCEX  int     wattron(WINDOW *, chtype);
+PDCEX  int     wattrset(WINDOW *, chtype);
+PDCEX  int     wattr_get(WINDOW *, attr_t *, short *, void *);
+PDCEX  int     wattr_off(WINDOW *, attr_t, void *);
+PDCEX  int     wattr_on(WINDOW *, attr_t, void *);
+PDCEX  int     wattr_set(WINDOW *, attr_t, short, void *);
+PDCEX  void    wbkgdset(WINDOW *, chtype);
+PDCEX  int     wbkgd(WINDOW *, chtype);
+PDCEX  int     wborder(WINDOW *, chtype, chtype, chtype, chtype,
+                       chtype, chtype, chtype, chtype);
+PDCEX  int     wchgat(WINDOW *, int, attr_t, short, const void *);
+PDCEX  int     wclear(WINDOW *);
+PDCEX  int     wclrtobot(WINDOW *);
+PDCEX  int     wclrtoeol(WINDOW *);
+PDCEX  int     wcolor_set(WINDOW *, short, void *);
+PDCEX  void    wcursyncup(WINDOW *);
+PDCEX  int     wdelch(WINDOW *);
+PDCEX  int     wdeleteln(WINDOW *);
+PDCEX  int     wechochar(WINDOW *, const chtype);
+PDCEX  int     werase(WINDOW *);
+PDCEX  int     wgetch(WINDOW *);
+PDCEX  int     wgetnstr(WINDOW *, char *, int);
+PDCEX  int     wgetstr(WINDOW *, char *);
+PDCEX  int     whline(WINDOW *, chtype, int);
+PDCEX  int     winchnstr(WINDOW *, chtype *, int);
+PDCEX  int     winchstr(WINDOW *, chtype *);
+PDCEX  chtype  winch(WINDOW *);
+PDCEX  int     winnstr(WINDOW *, char *, int);
+PDCEX  int     winsch(WINDOW *, chtype);
+PDCEX  int     winsdelln(WINDOW *, int);
+PDCEX  int     winsertln(WINDOW *);
+PDCEX  int     winsnstr(WINDOW *, const char *, int);
+PDCEX  int     winsstr(WINDOW *, const char *);
+PDCEX  int     winstr(WINDOW *, char *);
+PDCEX  int     wmove(WINDOW *, int, int);
+PDCEX  int     wnoutrefresh(WINDOW *);
+PDCEX  int     wprintw(WINDOW *, const char *, ...);
+PDCEX  int     wredrawln(WINDOW *, int, int);
+PDCEX  int     wrefresh(WINDOW *);
+PDCEX  int     wscanw(WINDOW *, const char *, ...);
+PDCEX  int     wscrl(WINDOW *, int);
+PDCEX  int     wsetscrreg(WINDOW *, int, int);
+PDCEX  int     wstandend(WINDOW *);
+PDCEX  int     wstandout(WINDOW *);
+PDCEX  void    wsyncdown(WINDOW *);
+PDCEX  void    wsyncup(WINDOW *);
+PDCEX  void    wtimeout(WINDOW *, int);
+PDCEX  int     wtouchln(WINDOW *, int, int, int);
+PDCEX  int     wvline(WINDOW *, chtype, int);
+
+/* Wide-character functions */
+
+#ifdef PDC_WIDE
+PDCEX  int     addnwstr(const wchar_t *, int);
+PDCEX  int     addwstr(const wchar_t *);
+PDCEX  int     add_wch(const cchar_t *);
+PDCEX  int     add_wchnstr(const cchar_t *, int);
+PDCEX  int     add_wchstr(const cchar_t *);
+PDCEX  int     bkgrnd(const cchar_t *);
+PDCEX  void    bkgrndset(const cchar_t *);
+PDCEX  int     border_set(const cchar_t *, const cchar_t *, const cchar_t *,
+                          const cchar_t *, const cchar_t *, const cchar_t *,
+                          const cchar_t *, const cchar_t *);
+PDCEX  int     box_set(WINDOW *, const cchar_t *, const cchar_t *);
+PDCEX  int     echo_wchar(const cchar_t *);
+PDCEX  int     erasewchar(wchar_t *);
+PDCEX  int     getbkgrnd(cchar_t *);
+PDCEX  int     getcchar(const cchar_t *, wchar_t *, attr_t *, short *, void *);
+PDCEX  int     getn_wstr(wint_t *, int);
+PDCEX  int     get_wch(wint_t *);
+PDCEX  int     get_wstr(wint_t *);
+PDCEX  int     hline_set(const cchar_t *, int);
+PDCEX  int     innwstr(wchar_t *, int);
+PDCEX  int     ins_nwstr(const wchar_t *, int);
+PDCEX  int     ins_wch(const cchar_t *);
+PDCEX  int     ins_wstr(const wchar_t *);
+PDCEX  int     inwstr(wchar_t *);
+PDCEX  int     in_wch(cchar_t *);
+PDCEX  int     in_wchnstr(cchar_t *, int);
+PDCEX  int     in_wchstr(cchar_t *);
+PDCEX  char   *key_name(wchar_t);
+PDCEX  int     killwchar(wchar_t *);
+PDCEX  int     mvaddnwstr(int, int, const wchar_t *, int);
+PDCEX  int     mvaddwstr(int, int, const wchar_t *);
+PDCEX  int     mvadd_wch(int, int, const cchar_t *);
+PDCEX  int     mvadd_wchnstr(int, int, const cchar_t *, int);
+PDCEX  int     mvadd_wchstr(int, int, const cchar_t *);
+PDCEX  int     mvgetn_wstr(int, int, wint_t *, int);
+PDCEX  int     mvget_wch(int, int, wint_t *);
+PDCEX  int     mvget_wstr(int, int, wint_t *);
+PDCEX  int     mvhline_set(int, int, const cchar_t *, int);
+PDCEX  int     mvinnwstr(int, int, wchar_t *, int);
+PDCEX  int     mvins_nwstr(int, int, const wchar_t *, int);
+PDCEX  int     mvins_wch(int, int, const cchar_t *);
+PDCEX  int     mvins_wstr(int, int, const wchar_t *);
+PDCEX  int     mvinwstr(int, int, wchar_t *);
+PDCEX  int     mvin_wch(int, int, cchar_t *);
+PDCEX  int     mvin_wchnstr(int, int, cchar_t *, int);
+PDCEX  int     mvin_wchstr(int, int, cchar_t *);
+PDCEX  int     mvvline_set(int, int, const cchar_t *, int);
+PDCEX  int     mvwaddnwstr(WINDOW *, int, int, const wchar_t *, int);
+PDCEX  int     mvwaddwstr(WINDOW *, int, int, const wchar_t *);
+PDCEX  int     mvwadd_wch(WINDOW *, int, int, const cchar_t *);
+PDCEX  int     mvwadd_wchnstr(WINDOW *, int, int, const cchar_t *, int);
+PDCEX  int     mvwadd_wchstr(WINDOW *, int, int, const cchar_t *);
+PDCEX  int     mvwgetn_wstr(WINDOW *, int, int, wint_t *, int);
+PDCEX  int     mvwget_wch(WINDOW *, int, int, wint_t *);
+PDCEX  int     mvwget_wstr(WINDOW *, int, int, wint_t *);
+PDCEX  int     mvwhline_set(WINDOW *, int, int, const cchar_t *, int);
+PDCEX  int     mvwinnwstr(WINDOW *, int, int, wchar_t *, int);
+PDCEX  int     mvwins_nwstr(WINDOW *, int, int, const wchar_t *, int);
+PDCEX  int     mvwins_wch(WINDOW *, int, int, const cchar_t *);
+PDCEX  int     mvwins_wstr(WINDOW *, int, int, const wchar_t *);
+PDCEX  int     mvwin_wch(WINDOW *, int, int, cchar_t *);
+PDCEX  int     mvwin_wchnstr(WINDOW *, int, int, cchar_t *, int);
+PDCEX  int     mvwin_wchstr(WINDOW *, int, int, cchar_t *);
+PDCEX  int     mvwinwstr(WINDOW *, int, int, wchar_t *);
+PDCEX  int     mvwvline_set(WINDOW *, int, int, const cchar_t *, int);
+PDCEX  int     pecho_wchar(WINDOW *, const cchar_t*);
+PDCEX  int     setcchar(cchar_t*, const wchar_t*, const attr_t,
+                        short, const void*);
+PDCEX  int     slk_wset(int, const wchar_t *, int);
+PDCEX  int     unget_wch(const wchar_t);
+PDCEX  int     vline_set(const cchar_t *, int);
+PDCEX  int     waddnwstr(WINDOW *, const wchar_t *, int);
+PDCEX  int     waddwstr(WINDOW *, const wchar_t *);
+PDCEX  int     wadd_wch(WINDOW *, const cchar_t *);
+PDCEX  int     wadd_wchnstr(WINDOW *, const cchar_t *, int);
+PDCEX  int     wadd_wchstr(WINDOW *, const cchar_t *);
+PDCEX  int     wbkgrnd(WINDOW *, const cchar_t *);
+PDCEX  void    wbkgrndset(WINDOW *, const cchar_t *);
+PDCEX  int     wborder_set(WINDOW *, const cchar_t *, const cchar_t *,
+                           const cchar_t *, const cchar_t *, const cchar_t *,
+                           const cchar_t *, const cchar_t *, const cchar_t *);
+PDCEX  int     wecho_wchar(WINDOW *, const cchar_t *);
+PDCEX  int     wgetbkgrnd(WINDOW *, cchar_t *);
+PDCEX  int     wgetn_wstr(WINDOW *, wint_t *, int);
+PDCEX  int     wget_wch(WINDOW *, wint_t *);
+PDCEX  int     wget_wstr(WINDOW *, wint_t *);
+PDCEX  int     whline_set(WINDOW *, const cchar_t *, int);
+PDCEX  int     winnwstr(WINDOW *, wchar_t *, int);
+PDCEX  int     wins_nwstr(WINDOW *, const wchar_t *, int);
+PDCEX  int     wins_wch(WINDOW *, const cchar_t *);
+PDCEX  int     wins_wstr(WINDOW *, const wchar_t *);
+PDCEX  int     winwstr(WINDOW *, wchar_t *);
+PDCEX  int     win_wch(WINDOW *, cchar_t *);
+PDCEX  int     win_wchnstr(WINDOW *, cchar_t *, int);
+PDCEX  int     win_wchstr(WINDOW *, cchar_t *);
+PDCEX  wchar_t *wunctrl(cchar_t *);
+PDCEX  int     wvline_set(WINDOW *, const cchar_t *, int);
+#endif
+
+/* Quasi-standard */
+
+PDCEX  chtype  getattrs(WINDOW *);
+PDCEX  int     getbegx(WINDOW *);
+PDCEX  int     getbegy(WINDOW *);
+PDCEX  int     getmaxx(WINDOW *);
+PDCEX  int     getmaxy(WINDOW *);
+PDCEX  int     getparx(WINDOW *);
+PDCEX  int     getpary(WINDOW *);
+PDCEX  int     getcurx(WINDOW *);
+PDCEX  int     getcury(WINDOW *);
+PDCEX  void    traceoff(void);
+PDCEX  void    traceon(void);
+PDCEX  char   *unctrl(chtype);
+
+PDCEX  int     crmode(void);
+PDCEX  int     nocrmode(void);
+PDCEX  int     draino(int);
+PDCEX  int     resetterm(void);
+PDCEX  int     fixterm(void);
+PDCEX  int     saveterm(void);
+PDCEX  void    setsyx(int, int);
+
+PDCEX  int     mouse_set(mmask_t);
+PDCEX  int     mouse_on(mmask_t);
+PDCEX  int     mouse_off(mmask_t);
+PDCEX  int     request_mouse_pos(void);
+PDCEX  void    wmouse_position(WINDOW *, int *, int *);
+PDCEX  mmask_t getmouse(void);
+
+/* ncurses */
+
+PDCEX  int     assume_default_colors(int, int);
+PDCEX  const char *curses_version(void);
+PDCEX  bool    has_key(int);
+PDCEX  int     use_default_colors(void);
+PDCEX  int     wresize(WINDOW *, int, int);
+
+PDCEX  int     mouseinterval(int);
+PDCEX  mmask_t mousemask(mmask_t, mmask_t *);
+PDCEX  bool    mouse_trafo(int *, int *, bool);
+PDCEX  int     nc_getmouse(MEVENT *);
+PDCEX  int     ungetmouse(MEVENT *);
+PDCEX  bool    wenclose(const WINDOW *, int, int);
+PDCEX  bool    wmouse_trafo(const WINDOW *, int *, int *, bool);
+
+/* PDCurses */
+
+PDCEX  int     addrawch(chtype);
+PDCEX  int     insrawch(chtype);
+PDCEX  bool    is_termresized(void);
+PDCEX  int     mvaddrawch(int, int, chtype);
+PDCEX  int     mvdeleteln(int, int);
+PDCEX  int     mvinsertln(int, int);
+PDCEX  int     mvinsrawch(int, int, chtype);
+PDCEX  int     mvwaddrawch(WINDOW *, int, int, chtype);
+PDCEX  int     mvwdeleteln(WINDOW *, int, int);
+PDCEX  int     mvwinsertln(WINDOW *, int, int);
+PDCEX  int     mvwinsrawch(WINDOW *, int, int, chtype);
+PDCEX  int     raw_output(bool);
+PDCEX  int     resize_term(int, int);
+PDCEX  WINDOW *resize_window(WINDOW *, int, int);
+PDCEX  int     waddrawch(WINDOW *, chtype);
+PDCEX  int     winsrawch(WINDOW *, chtype);
+PDCEX  char    wordchar(void);
+
+#ifdef PDC_WIDE
+PDCEX  wchar_t *slk_wlabel(int);
+#endif
+
+PDCEX  void    PDC_debug(const char *, ...);
+PDCEX  void    PDC_get_version(PDC_VERSION *);
+PDCEX  int     PDC_ungetch(int);
+PDCEX  int     PDC_set_blink(bool);
+PDCEX  int     PDC_set_bold(bool);
+PDCEX  int     PDC_set_line_color(short);
+PDCEX  void    PDC_set_title(const char *);
+
+PDCEX  int     PDC_clearclipboard(void);
+PDCEX  int     PDC_freeclipboard(char *);
+PDCEX  int     PDC_getclipboard(char **, long *);
+PDCEX  int     PDC_setclipboard(const char *, long);
+
+PDCEX  unsigned long PDC_get_input_fd(void);
+PDCEX  unsigned long PDC_get_key_modifiers(void);
+PDCEX  int     PDC_return_key_modifiers(bool);
+PDCEX  int     PDC_save_key_modifiers(bool);
+
+#ifdef XCURSES
+PDCEX  WINDOW *Xinitscr(int, char **);
+PDCEX  void    XCursesExit(void);
+PDCEX  int     sb_init(void);
+PDCEX  int     sb_set_horz(int, int, int);
+PDCEX  int     sb_set_vert(int, int, int);
+PDCEX  int     sb_get_horz(int *, int *, int *);
+PDCEX  int     sb_get_vert(int *, int *, int *);
+PDCEX  int     sb_refresh(void);
+#endif
+
+/*** Functions defined as macros ***/
+
+/* getch() and ungetch() conflict with some DOS libraries */
+
+#define getch()            wgetch(stdscr)
+#define ungetch(ch)        PDC_ungetch(ch)
+
+#define COLOR_PAIR(n)      (((chtype)(n) << PDC_COLOR_SHIFT) & A_COLOR)
+#define PAIR_NUMBER(n)     (((n) & A_COLOR) >> PDC_COLOR_SHIFT)
+
+/* These will _only_ work as macros */
+
+#define getbegyx(w, y, x)  (y = getbegy(w), x = getbegx(w))
+#define getmaxyx(w, y, x)  (y = getmaxy(w), x = getmaxx(w))
+#define getparyx(w, y, x)  (y = getpary(w), x = getparx(w))
+#define getyx(w, y, x)     (y = getcury(w), x = getcurx(w))
+
+#define getsyx(y, x)       { if (curscr->_leaveit) (y)=(x)=-1; \
+                             else getyx(curscr,(y),(x)); }
+
+#ifdef NCURSES_MOUSE_VERSION
+# define getmouse(x) nc_getmouse(x)
+#endif
+
+/* return codes from PDC_getclipboard() and PDC_setclipboard() calls */
+
+#define PDC_CLIP_SUCCESS         0
+#define PDC_CLIP_ACCESS_ERROR    1
+#define PDC_CLIP_EMPTY           2
+#define PDC_CLIP_MEMORY_ERROR    3
+
+/* PDCurses key modifier masks */
+
+#define PDC_KEY_MODIFIER_SHIFT   1
+#define PDC_KEY_MODIFIER_CONTROL 2
+#define PDC_KEY_MODIFIER_ALT     4
+#define PDC_KEY_MODIFIER_NUMLOCK 8
+
+#ifdef __cplusplus
+# ifndef PDC_PP98
+#  undef bool
+# endif
+}
+#endif
+
+#endif  /* __PDCURSES__ */
diff --git a/frontends/curses/win/curspriv.h b/frontends/curses/win/curspriv.h
index e17fb7b..991b295 100644
--- a/frontends/curses/win/curspriv.h
+++ b/frontends/curses/win/curspriv.h
@@ -1,122 +1,122 @@
-/* Private definitions and declarations for use within PDCurses.

-   These should generally not be referenced by applications. */

-

-#ifndef __CURSES_INTERNALS__

-#define __CURSES_INTERNALS__ 1

-

-#define CURSES_LIBRARY

-#include <curses.h>

-

-#if defined(__TURBOC__) || defined(__EMX__) || defined(__DJGPP__) || \

-    defined(PDC_99) || defined(__WATCOMC__)

-# ifndef HAVE_VSSCANF

-#  define HAVE_VSSCANF       /* have vsscanf() */

-# endif

-#endif

-

-#if defined(PDC_99) || defined(__WATCOMC__)

-# ifndef HAVE_VSNPRINTF

-#  define HAVE_VSNPRINTF     /* have vsnprintf() */

-# endif

-#endif

-

-/*----------------------------------------------------------------------*/

-

-typedef struct           /* structure for ripped off lines */

-{

-    int line;

-    int (*init)(WINDOW *, int);

-} RIPPEDOFFLINE;

-

-/* Window properties */

-

-#define _SUBWIN    0x01  /* window is a subwindow */

-#define _PAD       0x10  /* X/Open Pad. */

-#define _SUBPAD    0x20  /* X/Open subpad. */

-

-/* Miscellaneous */

-

-#define _NO_CHANGE -1    /* flags line edge unchanged */

-

-#define _ECHAR     0x08  /* Erase char       (^H) */

-#define _DWCHAR    0x17  /* Delete Word char (^W) */

-#define _DLCHAR    0x15  /* Delete Line char (^U) */

-

-extern WINDOW *pdc_lastscr;

-extern FILE *pdc_dbfp;   /* tracing file pointer (NULL = off) */

-extern bool pdc_color_started;

-extern unsigned long pdc_key_modifiers;

-extern MOUSE_STATUS pdc_mouse_status;

-

-/*----------------------------------------------------------------------*/

-

-/* Platform implementation functions */

-

-void    PDC_beep(void);

-bool    PDC_can_change_color(void);

-int     PDC_color_content(short, short *, short *, short *);

-bool    PDC_check_key(void);

-int     PDC_curs_set(int);

-void    PDC_flushinp(void);

-int     PDC_get_columns(void);

-int     PDC_get_cursor_mode(void);

-int     PDC_get_key(void);

-int     PDC_get_rows(void);

-void    PDC_gotoyx(int, int);

-int     PDC_init_color(short, short, short, short);

-void    PDC_init_pair(short, short, short);

-int     PDC_modifiers_set(void);

-int     PDC_mouse_set(void);

-void    PDC_napms(int);

-int     PDC_pair_content(short, short *, short *);

-void    PDC_reset_prog_mode(void);

-void    PDC_reset_shell_mode(void);

-int     PDC_resize_screen(int, int);

-void    PDC_restore_screen_mode(int);

-void    PDC_save_screen_mode(int);

-void    PDC_scr_close(void);

-void    PDC_scr_free(void);

-int     PDC_scr_open(int, char **);

-void    PDC_set_keyboard_binary(bool);

-void    PDC_transform_line(int, int, int, const chtype *);

-const char *PDC_sysname(void);

-

-/* Internal cross-module functions */

-

-void    PDC_init_atrtab(void);

-WINDOW *PDC_makelines(WINDOW *);

-WINDOW *PDC_makenew(int, int, int, int);

-int     PDC_mouse_in_slk(int, int);

-void    PDC_slk_free(void);

-void    PDC_slk_initialize(void);

-void    PDC_sync(WINDOW *);

-

-#ifdef PDC_WIDE

-int     PDC_mbtowc(wchar_t *, const char *, size_t);

-size_t  PDC_mbstowcs(wchar_t *, const char *, size_t);

-size_t  PDC_wcstombs(char *, const wchar_t *, size_t);

-#endif

-

-#ifdef PDCDEBUG

-# define PDC_LOG(x) if (pdc_dbfp) PDC_debug x

-#else

-# define PDC_LOG(x)

-#endif

-

-/* Internal macros for attributes */

-

-#define PDC_COLOR_PAIRS 256

-

-#ifndef max

-# define max(a,b) (((a) > (b)) ? (a) : (b))

-#endif

-#ifndef min

-# define min(a,b) (((a) < (b)) ? (a) : (b))

-#endif

-

-#define DIVROUND(num, divisor) ((num) + ((divisor) >> 1)) / (divisor)

-

-#define PDC_CLICK_PERIOD 150  /* time to wait for a click, if

-                                 not set by mouseinterval() */

-

-#endif /* __CURSES_INTERNALS__ */

+/* Private definitions and declarations for use within PDCurses.
+   These should generally not be referenced by applications. */
+
+#ifndef __CURSES_INTERNALS__
+#define __CURSES_INTERNALS__ 1
+
+#define CURSES_LIBRARY
+#include <curses.h>
+
+#if defined(__TURBOC__) || defined(__EMX__) || defined(__DJGPP__) || \
+    defined(PDC_99) || defined(__WATCOMC__)
+# ifndef HAVE_VSSCANF
+#  define HAVE_VSSCANF       /* have vsscanf() */
+# endif
+#endif
+
+#if defined(PDC_99) || defined(__WATCOMC__)
+# ifndef HAVE_VSNPRINTF
+#  define HAVE_VSNPRINTF     /* have vsnprintf() */
+# endif
+#endif
+
+/*----------------------------------------------------------------------*/
+
+typedef struct           /* structure for ripped off lines */
+{
+    int line;
+    int (*init)(WINDOW *, int);
+} RIPPEDOFFLINE;
+
+/* Window properties */
+
+#define _SUBWIN    0x01  /* window is a subwindow */
+#define _PAD       0x10  /* X/Open Pad. */
+#define _SUBPAD    0x20  /* X/Open subpad. */
+
+/* Miscellaneous */
+
+#define _NO_CHANGE -1    /* flags line edge unchanged */
+
+#define _ECHAR     0x08  /* Erase char       (^H) */
+#define _DWCHAR    0x17  /* Delete Word char (^W) */
+#define _DLCHAR    0x15  /* Delete Line char (^U) */
+
+extern WINDOW *pdc_lastscr;
+extern FILE *pdc_dbfp;   /* tracing file pointer (NULL = off) */
+extern bool pdc_color_started;
+extern unsigned long pdc_key_modifiers;
+extern MOUSE_STATUS pdc_mouse_status;
+
+/*----------------------------------------------------------------------*/
+
+/* Platform implementation functions */
+
+void    PDC_beep(void);
+bool    PDC_can_change_color(void);
+int     PDC_color_content(short, short *, short *, short *);
+bool    PDC_check_key(void);
+int     PDC_curs_set(int);
+void    PDC_flushinp(void);
+int     PDC_get_columns(void);
+int     PDC_get_cursor_mode(void);
+int     PDC_get_key(void);
+int     PDC_get_rows(void);
+void    PDC_gotoyx(int, int);
+int     PDC_init_color(short, short, short, short);
+void    PDC_init_pair(short, short, short);
+int     PDC_modifiers_set(void);
+int     PDC_mouse_set(void);
+void    PDC_napms(int);
+int     PDC_pair_content(short, short *, short *);
+void    PDC_reset_prog_mode(void);
+void    PDC_reset_shell_mode(void);
+int     PDC_resize_screen(int, int);
+void    PDC_restore_screen_mode(int);
+void    PDC_save_screen_mode(int);
+void    PDC_scr_close(void);
+void    PDC_scr_free(void);
+int     PDC_scr_open(int, char **);
+void    PDC_set_keyboard_binary(bool);
+void    PDC_transform_line(int, int, int, const chtype *);
+const char *PDC_sysname(void);
+
+/* Internal cross-module functions */
+
+void    PDC_init_atrtab(void);
+WINDOW *PDC_makelines(WINDOW *);
+WINDOW *PDC_makenew(int, int, int, int);
+int     PDC_mouse_in_slk(int, int);
+void    PDC_slk_free(void);
+void    PDC_slk_initialize(void);
+void    PDC_sync(WINDOW *);
+
+#ifdef PDC_WIDE
+int     PDC_mbtowc(wchar_t *, const char *, size_t);
+size_t  PDC_mbstowcs(wchar_t *, const char *, size_t);
+size_t  PDC_wcstombs(char *, const wchar_t *, size_t);
+#endif
+
+#ifdef PDCDEBUG
+# define PDC_LOG(x) if (pdc_dbfp) PDC_debug x
+#else
+# define PDC_LOG(x)
+#endif
+
+/* Internal macros for attributes */
+
+#define PDC_COLOR_PAIRS 256
+
+#ifndef max
+# define max(a,b) (((a) > (b)) ? (a) : (b))
+#endif
+#ifndef min
+# define min(a,b) (((a) < (b)) ? (a) : (b))
+#endif
+
+#define DIVROUND(num, divisor) ((num) + ((divisor) >> 1)) / (divisor)
+
+#define PDC_CLICK_PERIOD 150  /* time to wait for a click, if
+                                 not set by mouseinterval() */
+
+#endif /* __CURSES_INTERNALS__ */
diff --git a/frontends/curses/win/panel.h b/frontends/curses/win/panel.h
index b2b3593..83d4f2c 100644
--- a/frontends/curses/win/panel.h
+++ b/frontends/curses/win/panel.h
@@ -1,54 +1,54 @@
-/*----------------------------------------------------------------------*

- *                         Panels for PDCurses                          *

- *----------------------------------------------------------------------*/

-

-#ifndef __PDCURSES_PANEL_H__

-#define __PDCURSES_PANEL_H__ 1

-

-#include <curses.h>

-

-#ifdef __cplusplus

-extern "C"

-{

-#endif

-

-typedef struct panelobs

-{

-    struct panelobs *above;

-    struct panel *pan;

-} PANELOBS;

-

-typedef struct panel

-{

-    WINDOW *win;

-    int wstarty;

-    int wendy;

-    int wstartx;

-    int wendx;

-    struct panel *below;

-    struct panel *above;

-    const void *user;

-    struct panelobs *obscure;

-} PANEL;

-

-PDCEX  int     bottom_panel(PANEL *pan);

-PDCEX  int     del_panel(PANEL *pan);

-PDCEX  int     hide_panel(PANEL *pan);

-PDCEX  int     move_panel(PANEL *pan, int starty, int startx);

-PDCEX  PANEL  *new_panel(WINDOW *win);

-PDCEX  PANEL  *panel_above(const PANEL *pan);

-PDCEX  PANEL  *panel_below(const PANEL *pan);

-PDCEX  int     panel_hidden(const PANEL *pan);

-PDCEX  const void *panel_userptr(const PANEL *pan);

-PDCEX  WINDOW *panel_window(const PANEL *pan);

-PDCEX  int     replace_panel(PANEL *pan, WINDOW *win);

-PDCEX  int     set_panel_userptr(PANEL *pan, const void *uptr);

-PDCEX  int     show_panel(PANEL *pan);

-PDCEX  int     top_panel(PANEL *pan);

-PDCEX  void    update_panels(void);

-

-#ifdef __cplusplus

-}

-#endif

-

-#endif /* __PDCURSES_PANEL_H__ */

+/*----------------------------------------------------------------------*
+ *                         Panels for PDCurses                          *
+ *----------------------------------------------------------------------*/
+
+#ifndef __PDCURSES_PANEL_H__
+#define __PDCURSES_PANEL_H__ 1
+
+#include <curses.h>
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+typedef struct panelobs
+{
+    struct panelobs *above;
+    struct panel *pan;
+} PANELOBS;
+
+typedef struct panel
+{
+    WINDOW *win;
+    int wstarty;
+    int wendy;
+    int wstartx;
+    int wendx;
+    struct panel *below;
+    struct panel *above;
+    const void *user;
+    struct panelobs *obscure;
+} PANEL;
+
+PDCEX  int     bottom_panel(PANEL *pan);
+PDCEX  int     del_panel(PANEL *pan);
+PDCEX  int     hide_panel(PANEL *pan);
+PDCEX  int     move_panel(PANEL *pan, int starty, int startx);
+PDCEX  PANEL  *new_panel(WINDOW *win);
+PDCEX  PANEL  *panel_above(const PANEL *pan);
+PDCEX  PANEL  *panel_below(const PANEL *pan);
+PDCEX  int     panel_hidden(const PANEL *pan);
+PDCEX  const void *panel_userptr(const PANEL *pan);
+PDCEX  WINDOW *panel_window(const PANEL *pan);
+PDCEX  int     replace_panel(PANEL *pan, WINDOW *win);
+PDCEX  int     set_panel_userptr(PANEL *pan, const void *uptr);
+PDCEX  int     show_panel(PANEL *pan);
+PDCEX  int     top_panel(PANEL *pan);
+PDCEX  void    update_panels(void);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* __PDCURSES_PANEL_H__ */
diff --git a/frontends/gl/main.c b/frontends/gl/main.c
index c1c6c2d..a8fa9c8 100644
--- a/frontends/gl/main.c
+++ b/frontends/gl/main.c
@@ -1,258 +1,258 @@
-#include <stdio.h>

-#include <string.h>

-

-#include <glad/gl.h>

-#include <GLFW/glfw3.h>

-

-#define STB_IMAGE_IMPLEMENTATION

-#include "stb_image.h"

-

-#include "cetris.h"

-

-static cetris_game cetris;

-

-const char *vertex_shader_source = "#version 450 core\n"

-    "layout (location = 0) in vec3 aPos;\n"

-    "layout (location = 1) in vec3 aColor;\n"

-    "layout (location = 2) in vec2 aTexCoord;\n"

-    "out vec3 ourColor;\n"

-    "out vec2 TexCoord;\n"

-    "void main()\n"

-    "{\n"

-    "   gl_Position = vec4(aPos, 1.0);\n"

-    "   ourColor = aColor;\n"

-    "   TexCoord = aTexCoord;\n"

-    "}\0";

-

-const char *fragment_shader_source = "#version 450 core\n"

-    "out vec4 FragColor;\n"

-    "in vec3 ourColor;\n"

-    "in vec2 TexCoord;\n"

-    "uniform sampler2D ourTexture;\n"

-    "void main()\n"

-    "{\n"

-    "   FragColor = texture(ourTexture, TexCoord) * vec4(ourColor, 1.0);\n"

-    "}\n\0";

-

-

-GLuint shader_program;

-

-GLfloat default_rect[32] = {

-   // positions       // colors          // texture coords

-   0.0f, 0.0f, 0.0f,  1.0f, 0.0f, 0.0f,  1.0f, 1.0f,   // top right

-   0.0f, 0.0f, 0.0f,  1.0f, 0.0f, 0.0f,  1.0f, 0.0f,   // bottom right

-   0.0f, 0.0f, 0.0f,  1.0f, 0.0f, 0.0f,  0.0f, 0.0f,   // bottom left

-   0.0f, 0.0f, 0.0f,  1.0f, 0.0f, 0.0f,  0.0f, 1.0f    // top left 

-};

-

-typedef struct {

-  GLfloat r;

-  GLfloat g;

-  GLfloat b;

-} rbg_color;

-

-GLuint indices[] = {  

-  0, 1, 3, // first triangle

-  1, 2, 3  // second triangle

-};

-

-rbg_color colors[7] = {

-  //{0.0f, 0.0f, 0.0f},     // Black

-  {0.127f,0.219f,0.255f}, // Aqua

-  {0.61f,0.153f,0.112f},  // Olive

-  {0.177f,0.13f,0.201f},  // Purple

-  {0.240f,0.18f,0.190f},  // Fuchsia

-  {0.255f,0.133f,0.27f},  // Orange

-  {0.0f,0.31f,0.63f},     // Navy

-  {0.255f,0.220f,0.0f}    // Yellow 

-};

-

-typedef struct {

-  GLuint vao;

-  GLuint vbo;

-  GLuint ebo;

-  GLuint texture;

-} drawable;

-

-void framebuffer_size_callback(GLFWwindow* window, int width, int height) {

-  glViewport(0, 0, width, height);

-}  

-

-void input_callback(GLFWwindow *window, int key, int scancode, int action, int mods) {

-  if (key == GLFW_KEY_ESCAPE && action == GLFW_PRESS)

-    glfwSetWindowShouldClose(window, 1);

-

-  if (key == GLFW_KEY_D && action == GLFW_PRESS)

-    move_piece(&cetris, RIGHT);

-

-  if (key == GLFW_KEY_S && action == GLFW_PRESS)

-    move_piece(&cetris, USER_DOWN);

-

-  if (key == GLFW_KEY_A && action == GLFW_PRESS)

-    move_piece(&cetris, LEFT);

-

-  if (key == GLFW_KEY_W && action == GLFW_PRESS)

-    move_piece(&cetris, ROTATE_CW);

-

-  if (key == GLFW_KEY_SPACE && action == GLFW_PRESS)

-    move_piece(&cetris, HARD_DROP);

-}

-

-void load_texture(char *file_name, GLuint texture) {

-  int w, h, channel;

-  unsigned char *data = stbi_load(file_name, &w, &h, &channel, 0);

-  glBindTexture(GL_TEXTURE_2D, texture);

-  glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_REPEAT);

-  glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_REPEAT);

-  glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR);

-  glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR);

-  glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB, w, h, 0, GL_RGB, GL_UNSIGNED_BYTE, data);

-  glGenerateMipmap(GL_TEXTURE_2D);

-  stbi_image_free(data);

-}

-

-void load_vertex_shader(GLuint program) {

-  GLint vertex_shader;

-  vertex_shader = glCreateShader(GL_VERTEX_SHADER);

-

-  glShaderSource(vertex_shader, 1, &vertex_shader_source, NULL);

-  glCompileShader(vertex_shader);

-  glAttachShader(program, vertex_shader);

-  glDeleteShader(vertex_shader);

-}

-

-void load_fragment_shader(GLuint program) {

-  GLint fragment_shader;

-  fragment_shader = glCreateShader(GL_FRAGMENT_SHADER);

-

-  glShaderSource(fragment_shader, 1, &fragment_shader_source, NULL);

-  glCompileShader(fragment_shader);

-  glAttachShader(program, fragment_shader);

-  glDeleteShader(fragment_shader);

-}

-

-void create_static_2d(drawable *b, char* texture_file) {

-  glGenVertexArrays(1, &b->vao);

-  glGenBuffers(1, &b->vbo);

-  glGenBuffers(1, &b->ebo);

-  glGenTextures(1, &b->texture);

-

-  glBindVertexArray(b->vao);

-  glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, b->ebo);

-  glBufferData(GL_ELEMENT_ARRAY_BUFFER, sizeof(indices), indices, GL_STATIC_DRAW); 

-

-  glBindBuffer(GL_ARRAY_BUFFER, b->vbo);

-

-  GLfloat rect[32];

-  memcpy(&rect, &default_rect, sizeof(GLfloat) * 32);

-  glBufferData(GL_ARRAY_BUFFER, 32 * sizeof(GLfloat), default_rect, GL_DYNAMIC_DRAW);

-

-  glVertexAttribPointer(0, 3, GL_FLOAT, GL_FALSE, 8 * sizeof(GLfloat), (void*)0);

-  glEnableVertexAttribArray(0);

-

-  glVertexAttribPointer(1, 3, GL_FLOAT, GL_FALSE, 8 * sizeof(GLfloat), (void*)(3* sizeof(GLfloat)));

-  glEnableVertexAttribArray(1);

-

-  glVertexAttribPointer(2, 2, GL_FLOAT, GL_FALSE, 8 * sizeof(GLfloat), (void*)(6 * sizeof(GLfloat)));

-  glEnableVertexAttribArray(2);

-

-  load_texture(texture_file, b->texture);

-}

-

-void calc_size(GLfloat *rect, int x, int y) {

-  rect[0] = rect[8] = (x + 1.0f) / 10.0f;

-  rect[1] = rect[25] = (((y) * -1.0f) + 1.0f) / 20.0f; 

-  rect[9] = rect[17] = rect[1] - .05f;

-  rect[16] = rect[24] = rect[0] - .1f;

-}

-

-

-void update_block(drawable *b, int x, int y, int color) {

-  GLfloat block[32];

-  memcpy(block, default_rect, sizeof(GLfloat) * 32);

-

-  x = x - 6;

-  y = y - 20;

-

-  block[0] = block[8] = (x + 1.0f) / 10.0f;

-  block[1] = block[25] = (((y) * -1.0f) + 1.0f) / 20.0f; 

-  block[9] = block[17] = block[1] - .05f;

-  block[16] = block[24] = block[0] - .1f;

-

-  block[3] = block[11] = block[19] = block[27] = colors[color].r;

-  block[4] = block[12] = block[20] = block[28] = colors[color].g;

-  block[5] = block[13] = block[21] = block[29] = colors[color].b;

-

-  glBindVertexArray(b->vao);

-  glBindBuffer(GL_ARRAY_BUFFER, b->vbo);

-  glBufferData(GL_ARRAY_BUFFER, 32 * sizeof(GLfloat), block, GL_DYNAMIC_DRAW);

-}

-

-int main(void) {

-  glfwInit();

-  glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 4);

-  glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 5);

-  glfwWindowHint(GLFW_OPENGL_PROFILE, GLFW_OPENGL_CORE_PROFILE);

-

-  GLFWwindow* window = glfwCreateWindow(400, 800, "Cetris", NULL, NULL);

-  if (window == NULL) {

-    printf("[Error] failed to create GLFW window\n");

-    glfwTerminate();

-    return -1;

-  }

-

-  glfwMakeContextCurrent(window);

-

-  if (!gladLoadGL(glfwGetProcAddress)) {

-    printf("[Error] failed to load GLAD\n");

-    return -1;

-  }

-

-  glViewport(0, 0, 400, 800);

-

-  glfwSetFramebufferSizeCallback(window, framebuffer_size_callback);

-

-  shader_program = glCreateProgram();

-  load_fragment_shader(shader_program);

-  load_vertex_shader(shader_program);

-  glLinkProgram(shader_program);

-

-  drawable block;

-  create_static_2d(&block, "block.jpg");

-

-

-  init_game(&cetris);

-

-  double prev_time = glfwGetTime();

-

-  glfwSetKeyCallback(window, input_callback);

-

-  while(!glfwWindowShouldClose(window)) {

-    glClearColor(0.2f, 0.3f, 0.3f, 1.0f);

-    glClear(GL_COLOR_BUFFER_BIT);

-

-    glBindTexture(GL_TEXTURE_2D, block.texture);

-    glUseProgram(shader_program);

-    glBindVertexArray(block.vao);

-    for (int x = 0; x < CETRIS_BOARD_X; x++) {

-      for (int y = 0; y < CETRIS_BOARD_Y; y++) {

-        if (cetris.board[x][y].flags & SLOT_OCCUPIED) {

-          update_block(&block, x, y, cetris.board[x][y].color);  

-          glDrawElements(GL_TRIANGLES, 6, GL_UNSIGNED_INT, 0);

-        }

-      }

-    }

-

-    double current_time = glfwGetTime();

-    if (current_time - prev_time >= 0.0166) {

-      update_game_tick(&cetris);

-      prev_time = current_time;

-    }

-

-    glfwSwapBuffers(window);

-    glfwPollEvents();

-  }

-  

-  glfwTerminate();

-  return 0;

-}

+#include <stdio.h>
+#include <string.h>
+
+#include <glad/gl.h>
+#include <GLFW/glfw3.h>
+
+#define STB_IMAGE_IMPLEMENTATION
+#include "stb_image.h"
+
+#include "cetris.h"
+
+static cetris_game cetris;
+
+const char *vertex_shader_source = "#version 450 core\n"
+    "layout (location = 0) in vec3 aPos;\n"
+    "layout (location = 1) in vec3 aColor;\n"
+    "layout (location = 2) in vec2 aTexCoord;\n"
+    "out vec3 ourColor;\n"
+    "out vec2 TexCoord;\n"
+    "void main()\n"
+    "{\n"
+    "   gl_Position = vec4(aPos, 1.0);\n"
+    "   ourColor = aColor;\n"
+    "   TexCoord = aTexCoord;\n"
+    "}\0";
+
+const char *fragment_shader_source = "#version 450 core\n"
+    "out vec4 FragColor;\n"
+    "in vec3 ourColor;\n"
+    "in vec2 TexCoord;\n"
+    "uniform sampler2D ourTexture;\n"
+    "void main()\n"
+    "{\n"
+    "   FragColor = texture(ourTexture, TexCoord) * vec4(ourColor, 1.0);\n"
+    "}\n\0";
+
+
+GLuint shader_program;
+
+GLfloat default_rect[32] = {
+   // positions       // colors          // texture coords
+   0.0f, 0.0f, 0.0f,  1.0f, 0.0f, 0.0f,  1.0f, 1.0f,   // top right
+   0.0f, 0.0f, 0.0f,  1.0f, 0.0f, 0.0f,  1.0f, 0.0f,   // bottom right
+   0.0f, 0.0f, 0.0f,  1.0f, 0.0f, 0.0f,  0.0f, 0.0f,   // bottom left
+   0.0f, 0.0f, 0.0f,  1.0f, 0.0f, 0.0f,  0.0f, 1.0f    // top left 
+};
+
+typedef struct {
+  GLfloat r;
+  GLfloat g;
+  GLfloat b;
+} rbg_color;
+
+GLuint indices[] = {  
+  0, 1, 3, // first triangle
+  1, 2, 3  // second triangle
+};
+
+rbg_color colors[7] = {
+  //{0.0f, 0.0f, 0.0f},     // Black
+  {0.127f,0.219f,0.255f}, // Aqua
+  {0.61f,0.153f,0.112f},  // Olive
+  {0.177f,0.13f,0.201f},  // Purple
+  {0.240f,0.18f,0.190f},  // Fuchsia
+  {0.255f,0.133f,0.27f},  // Orange
+  {0.0f,0.31f,0.63f},     // Navy
+  {0.255f,0.220f,0.0f}    // Yellow 
+};
+
+typedef struct {
+  GLuint vao;
+  GLuint vbo;
+  GLuint ebo;
+  GLuint texture;
+} drawable;
+
+void framebuffer_size_callback(GLFWwindow* window, int width, int height) {
+  glViewport(0, 0, width, height);
+}  
+
+void input_callback(GLFWwindow *window, int key, int scancode, int action, int mods) {
+  if (key == GLFW_KEY_ESCAPE && action == GLFW_PRESS)
+    glfwSetWindowShouldClose(window, 1);
+
+  if (key == GLFW_KEY_D && action == GLFW_PRESS)
+    move_piece(&cetris, RIGHT);
+
+  if (key == GLFW_KEY_S && action == GLFW_PRESS)
+    move_piece(&cetris, USER_DOWN);
+
+  if (key == GLFW_KEY_A && action == GLFW_PRESS)
+    move_piece(&cetris, LEFT);
+
+  if (key == GLFW_KEY_W && action == GLFW_PRESS)
+    move_piece(&cetris, ROTATE_CW);
+
+  if (key == GLFW_KEY_SPACE && action == GLFW_PRESS)
+    move_piece(&cetris, HARD_DROP);
+}
+
+void load_texture(char *file_name, GLuint texture) {
+  int w, h, channel;
+  unsigned char *data = stbi_load(file_name, &w, &h, &channel, 0);
+  glBindTexture(GL_TEXTURE_2D, texture);
+  glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_REPEAT);
+  glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_REPEAT);
+  glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR);
+  glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR);
+  glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB, w, h, 0, GL_RGB, GL_UNSIGNED_BYTE, data);
+  glGenerateMipmap(GL_TEXTURE_2D);
+  stbi_image_free(data);
+}
+
+void load_vertex_shader(GLuint program) {
+  GLint vertex_shader;
+  vertex_shader = glCreateShader(GL_VERTEX_SHADER);
+
+  glShaderSource(vertex_shader, 1, &vertex_shader_source, NULL);
+  glCompileShader(vertex_shader);
+  glAttachShader(program, vertex_shader);
+  glDeleteShader(vertex_shader);
+}
+
+void load_fragment_shader(GLuint program) {
+  GLint fragment_shader;
+  fragment_shader = glCreateShader(GL_FRAGMENT_SHADER);
+
+  glShaderSource(fragment_shader, 1, &fragment_shader_source, NULL);
+  glCompileShader(fragment_shader);
+  glAttachShader(program, fragment_shader);
+  glDeleteShader(fragment_shader);
+}
+
+void create_static_2d(drawable *b, char* texture_file) {
+  glGenVertexArrays(1, &b->vao);
+  glGenBuffers(1, &b->vbo);
+  glGenBuffers(1, &b->ebo);
+  glGenTextures(1, &b->texture);
+
+  glBindVertexArray(b->vao);
+  glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, b->ebo);
+  glBufferData(GL_ELEMENT_ARRAY_BUFFER, sizeof(indices), indices, GL_STATIC_DRAW); 
+
+  glBindBuffer(GL_ARRAY_BUFFER, b->vbo);
+
+  GLfloat rect[32];
+  memcpy(&rect, &default_rect, sizeof(GLfloat) * 32);
+  glBufferData(GL_ARRAY_BUFFER, 32 * sizeof(GLfloat), default_rect, GL_DYNAMIC_DRAW);
+
+  glVertexAttribPointer(0, 3, GL_FLOAT, GL_FALSE, 8 * sizeof(GLfloat), (void*)0);
+  glEnableVertexAttribArray(0);
+
+  glVertexAttribPointer(1, 3, GL_FLOAT, GL_FALSE, 8 * sizeof(GLfloat), (void*)(3* sizeof(GLfloat)));
+  glEnableVertexAttribArray(1);
+
+  glVertexAttribPointer(2, 2, GL_FLOAT, GL_FALSE, 8 * sizeof(GLfloat), (void*)(6 * sizeof(GLfloat)));
+  glEnableVertexAttribArray(2);
+
+  load_texture(texture_file, b->texture);
+}
+
+void calc_size(GLfloat *rect, int x, int y) {
+  rect[0] = rect[8] = (x + 1.0f) / 10.0f;
+  rect[1] = rect[25] = (((y) * -1.0f) + 1.0f) / 20.0f; 
+  rect[9] = rect[17] = rect[1] - .05f;
+  rect[16] = rect[24] = rect[0] - .1f;
+}
+
+
+void update_block(drawable *b, int x, int y, int color) {
+  GLfloat block[32];
+  memcpy(block, default_rect, sizeof(GLfloat) * 32);
+
+  x = x - 6;
+  y = y - 20;
+
+  block[0] = block[8] = (x + 1.0f) / 10.0f;
+  block[1] = block[25] = (((y) * -1.0f) + 1.0f) / 20.0f; 
+  block[9] = block[17] = block[1] - .05f;
+  block[16] = block[24] = block[0] - .1f;
+
+  block[3] = block[11] = block[19] = block[27] = colors[color].r;
+  block[4] = block[12] = block[20] = block[28] = colors[color].g;
+  block[5] = block[13] = block[21] = block[29] = colors[color].b;
+
+  glBindVertexArray(b->vao);
+  glBindBuffer(GL_ARRAY_BUFFER, b->vbo);
+  glBufferData(GL_ARRAY_BUFFER, 32 * sizeof(GLfloat), block, GL_DYNAMIC_DRAW);
+}
+
+int main(void) {
+  glfwInit();
+  glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 4);
+  glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 5);
+  glfwWindowHint(GLFW_OPENGL_PROFILE, GLFW_OPENGL_CORE_PROFILE);
+
+  GLFWwindow* window = glfwCreateWindow(400, 800, "Cetris", NULL, NULL);
+  if (window == NULL) {
+    printf("[Error] failed to create GLFW window\n");
+    glfwTerminate();
+    return -1;
+  }
+
+  glfwMakeContextCurrent(window);
+
+  if (!gladLoadGL(glfwGetProcAddress)) {
+    printf("[Error] failed to load GLAD\n");
+    return -1;
+  }
+
+  glViewport(0, 0, 400, 800);
+
+  glfwSetFramebufferSizeCallback(window, framebuffer_size_callback);
+
+  shader_program = glCreateProgram();
+  load_fragment_shader(shader_program);
+  load_vertex_shader(shader_program);
+  glLinkProgram(shader_program);
+
+  drawable block;
+  create_static_2d(&block, "block.jpg");
+
+
+  init_game(&cetris);
+
+  double prev_time = glfwGetTime();
+
+  glfwSetKeyCallback(window, input_callback);
+
+  while(!glfwWindowShouldClose(window)) {
+    glClearColor(0.2f, 0.3f, 0.3f, 1.0f);
+    glClear(GL_COLOR_BUFFER_BIT);
+
+    glBindTexture(GL_TEXTURE_2D, block.texture);
+    glUseProgram(shader_program);
+    glBindVertexArray(block.vao);
+    for (int x = 0; x < CETRIS_BOARD_X; x++) {
+      for (int y = 0; y < CETRIS_BOARD_Y; y++) {
+        if (cetris.board[x][y].flags & SLOT_OCCUPIED) {
+          update_block(&block, x, y, cetris.board[x][y].color);  
+          glDrawElements(GL_TRIANGLES, 6, GL_UNSIGNED_INT, 0);
+        }
+      }
+    }
+
+    double current_time = glfwGetTime();
+    if (current_time - prev_time >= 0.0166) {
+      update_game_tick(&cetris);
+      prev_time = current_time;
+    }
+
+    glfwSwapBuffers(window);
+    glfwPollEvents();
+  }
+  
+  glfwTerminate();
+  return 0;
+}
diff --git a/frontends/gl/meson.build b/frontends/gl/meson.build
index a1787b2..819011a 100644
--- a/frontends/gl/meson.build
+++ b/frontends/gl/meson.build
@@ -1,22 +1,22 @@
-src = ['main.c', 'glad/src/gl.c']

-

-inc = [cetris_inc, include_directories('glad/include')]

-deps = []

-

-if host_machine.system() == 'windows'

-  deps += compiler.find_library('glfw3', dirs: meson.current_source_dir() + '/win/glfw')

-  inc += include_directories('win/glfw/include')

-else

-  deps += dependency('glfw3')

-  deps += compiler.find_library('m')

-  deps += compiler.find_library('dl')

-endif

-

-configure_file(input: 'block.jpg', 

-        output: 'block.jpg',

-        copy: true, install: false)

-

-executable('cetris', src,

-        dependencies: deps,

-        include_directories: inc,

-        install: false)

+src = ['main.c', 'glad/src/gl.c']
+
+inc = [cetris_inc, include_directories('glad/include')]
+deps = []
+
+if host_machine.system() == 'windows'
+  deps += compiler.find_library('glfw3', dirs: meson.current_source_dir() + '/win/glfw')
+  inc += include_directories('win/glfw/include')
+else
+  deps += dependency('glfw3')
+  deps += compiler.find_library('m')
+  deps += compiler.find_library('dl')
+endif
+
+configure_file(input: 'block.jpg', 
+        output: 'block.jpg',
+        copy: true, install: false)
+
+executable('cetris', src,
+        dependencies: deps,
+        include_directories: inc,
+        install: false)
diff --git a/frontends/gl/stb_image.h b/frontends/gl/stb_image.h
index f8fb2a0..a6202a3 100644
--- a/frontends/gl/stb_image.h
+++ b/frontends/gl/stb_image.h
@@ -1,7547 +1,7547 @@
-/* stb_image - v2.22 - public domain image loader - http://nothings.org/stb

-                                  no warranty implied; use at your own risk

-

-   Do this:

-      #define STB_IMAGE_IMPLEMENTATION

-   before you include this file in *one* C or C++ file to create the implementation.

-

-   // i.e. it should look like this:

-   #include ...

-   #include ...

-   #include ...

-   #define STB_IMAGE_IMPLEMENTATION

-   #include "stb_image.h"

-

-   You can #define STBI_ASSERT(x) before the #include to avoid using assert.h.

-   And #define STBI_MALLOC, STBI_REALLOC, and STBI_FREE to avoid using malloc,realloc,free

-

-

-   QUICK NOTES:

-      Primarily of interest to game developers and other people who can

-          avoid problematic images and only need the trivial interface

-

-      JPEG baseline & progressive (12 bpc/arithmetic not supported, same as stock IJG lib)

-      PNG 1/2/4/8/16-bit-per-channel

-

-      TGA (not sure what subset, if a subset)

-      BMP non-1bpp, non-RLE

-      PSD (composited view only, no extra channels, 8/16 bit-per-channel)

-

-      GIF (*comp always reports as 4-channel)

-      HDR (radiance rgbE format)

-      PIC (Softimage PIC)

-      PNM (PPM and PGM binary only)

-

-      Animated GIF still needs a proper API, but here's one way to do it:

-          http://gist.github.com/urraka/685d9a6340b26b830d49

-

-      - decode from memory or through FILE (define STBI_NO_STDIO to remove code)

-      - decode from arbitrary I/O callbacks

-      - SIMD acceleration on x86/x64 (SSE2) and ARM (NEON)

-

-   Full documentation under "DOCUMENTATION" below.

-

-

-LICENSE

-

-  See end of file for license information.

-

-RECENT REVISION HISTORY:

-

-      2.22  (2019-03-04) gif fixes, fix warnings

-      2.21  (2019-02-25) fix typo in comment

-      2.20  (2019-02-07) support utf8 filenames in Windows; fix warnings and platform ifdefs 

-      2.19  (2018-02-11) fix warning

-      2.18  (2018-01-30) fix warnings

-      2.17  (2018-01-29) bugfix, 1-bit BMP, 16-bitness query, fix warnings

-      2.16  (2017-07-23) all functions have 16-bit variants; optimizations; bugfixes

-      2.15  (2017-03-18) fix png-1,2,4; all Imagenet JPGs; no runtime SSE detection on GCC

-      2.14  (2017-03-03) remove deprecated STBI_JPEG_OLD; fixes for Imagenet JPGs

-      2.13  (2016-12-04) experimental 16-bit API, only for PNG so far; fixes

-      2.12  (2016-04-02) fix typo in 2.11 PSD fix that caused crashes

-      2.11  (2016-04-02) 16-bit PNGS; enable SSE2 in non-gcc x64

-                         RGB-format JPEG; remove white matting in PSD;

-                         allocate large structures on the stack;

-                         correct channel count for PNG & BMP

-      2.10  (2016-01-22) avoid warning introduced in 2.09

-      2.09  (2016-01-16) 16-bit TGA; comments in PNM files; STBI_REALLOC_SIZED

-

-   See end of file for full revision history.

-

-

- ============================    Contributors    =========================

-

- Image formats                          Extensions, features

-    Sean Barrett (jpeg, png, bmp)          Jetro Lauha (stbi_info)

-    Nicolas Schulz (hdr, psd)              Martin "SpartanJ" Golini (stbi_info)

-    Jonathan Dummer (tga)                  James "moose2000" Brown (iPhone PNG)

-    Jean-Marc Lienher (gif)                Ben "Disch" Wenger (io callbacks)

-    Tom Seddon (pic)                       Omar Cornut (1/2/4-bit PNG)

-    Thatcher Ulrich (psd)                  Nicolas Guillemot (vertical flip)

-    Ken Miller (pgm, ppm)                  Richard Mitton (16-bit PSD)

-    github:urraka (animated gif)           Junggon Kim (PNM comments)

-    Christopher Forseth (animated gif)     Daniel Gibson (16-bit TGA)

-                                           socks-the-fox (16-bit PNG)

-                                           Jeremy Sawicki (handle all ImageNet JPGs)

- Optimizations & bugfixes                  Mikhail Morozov (1-bit BMP)

-    Fabian "ryg" Giesen                    Anael Seghezzi (is-16-bit query)

-    Arseny Kapoulkine

-    John-Mark Allen

-    Carmelo J Fdez-Aguera

-

- Bug & warning fixes

-    Marc LeBlanc            David Woo          Guillaume George   Martins Mozeiko

-    Christpher Lloyd        Jerry Jansson      Joseph Thomson     Phil Jordan

-    Dave Moore              Roy Eltham         Hayaki Saito       Nathan Reed

-    Won Chun                Luke Graham        Johan Duparc       Nick Verigakis

-    the Horde3D community   Thomas Ruf         Ronny Chevalier    github:rlyeh

-    Janez Zemva             John Bartholomew   Michal Cichon      github:romigrou

-    Jonathan Blow           Ken Hamada         Tero Hanninen      github:svdijk

-    Laurent Gomila          Cort Stratton      Sergio Gonzalez    github:snagar

-    Aruelien Pocheville     Thibault Reuille   Cass Everitt       github:Zelex

-    Ryamond Barbiero        Paul Du Bois       Engin Manap        github:grim210

-    Aldo Culquicondor       Philipp Wiesemann  Dale Weiler        github:sammyhw

-    Oriol Ferrer Mesia      Josh Tobin         Matthew Gregan     github:phprus

-    Julian Raschke          Gregory Mullen     Baldur Karlsson    github:poppolopoppo

-    Christian Floisand      Kevin Schmidt      JR Smith           github:darealshinji

-    Blazej Dariusz Roszkowski                                     github:Michaelangel007

-*/

-

-#ifndef STBI_INCLUDE_STB_IMAGE_H

-#define STBI_INCLUDE_STB_IMAGE_H

-

-// DOCUMENTATION

-//

-// Limitations:

-//    - no 12-bit-per-channel JPEG

-//    - no JPEGs with arithmetic coding

-//    - GIF always returns *comp=4

-//

-// Basic usage (see HDR discussion below for HDR usage):

-//    int x,y,n;

-//    unsigned char *data = stbi_load(filename, &x, &y, &n, 0);

-//    // ... process data if not NULL ...

-//    // ... x = width, y = height, n = # 8-bit components per pixel ...

-//    // ... replace '0' with '1'..'4' to force that many components per pixel

-//    // ... but 'n' will always be the number that it would have been if you said 0

-//    stbi_image_free(data)

-//

-// Standard parameters:

-//    int *x                 -- outputs image width in pixels

-//    int *y                 -- outputs image height in pixels

-//    int *channels_in_file  -- outputs # of image components in image file

-//    int desired_channels   -- if non-zero, # of image components requested in result

-//

-// The return value from an image loader is an 'unsigned char *' which points

-// to the pixel data, or NULL on an allocation failure or if the image is

-// corrupt or invalid. The pixel data consists of *y scanlines of *x pixels,

-// with each pixel consisting of N interleaved 8-bit components; the first

-// pixel pointed to is top-left-most in the image. There is no padding between

-// image scanlines or between pixels, regardless of format. The number of

-// components N is 'desired_channels' if desired_channels is non-zero, or

-// *channels_in_file otherwise. If desired_channels is non-zero,

-// *channels_in_file has the number of components that _would_ have been

-// output otherwise. E.g. if you set desired_channels to 4, you will always

-// get RGBA output, but you can check *channels_in_file to see if it's trivially

-// opaque because e.g. there were only 3 channels in the source image.

-//

-// An output image with N components has the following components interleaved

-// in this order in each pixel:

-//

-//     N=#comp     components

-//       1           grey

-//       2           grey, alpha

-//       3           red, green, blue

-//       4           red, green, blue, alpha

-//

-// If image loading fails for any reason, the return value will be NULL,

-// and *x, *y, *channels_in_file will be unchanged. The function

-// stbi_failure_reason() can be queried for an extremely brief, end-user

-// unfriendly explanation of why the load failed. Define STBI_NO_FAILURE_STRINGS

-// to avoid compiling these strings at all, and STBI_FAILURE_USERMSG to get slightly

-// more user-friendly ones.

-//

-// Paletted PNG, BMP, GIF, and PIC images are automatically depalettized.

-//

-// ===========================================================================

-//

-// UNICODE:

-//

-//   If compiling for Windows and you wish to use Unicode filenames, compile

-//   with

-//       #define STBI_WINDOWS_UTF8

-//   and pass utf8-encoded filenames. Call stbi_convert_wchar_to_utf8 to convert

-//   Windows wchar_t filenames to utf8.

-//

-// ===========================================================================

-//

-// Philosophy

-//

-// stb libraries are designed with the following priorities:

-//

-//    1. easy to use

-//    2. easy to maintain

-//    3. good performance

-//

-// Sometimes I let "good performance" creep up in priority over "easy to maintain",

-// and for best performance I may provide less-easy-to-use APIs that give higher

-// performance, in addition to the easy-to-use ones. Nevertheless, it's important

-// to keep in mind that from the standpoint of you, a client of this library,

-// all you care about is #1 and #3, and stb libraries DO NOT emphasize #3 above all.

-//

-// Some secondary priorities arise directly from the first two, some of which

-// provide more explicit reasons why performance can't be emphasized.

-//

-//    - Portable ("ease of use")

-//    - Small source code footprint ("easy to maintain")

-//    - No dependencies ("ease of use")

-//

-// ===========================================================================

-//

-// I/O callbacks

-//

-// I/O callbacks allow you to read from arbitrary sources, like packaged

-// files or some other source. Data read from callbacks are processed

-// through a small internal buffer (currently 128 bytes) to try to reduce

-// overhead.

-//

-// The three functions you must define are "read" (reads some bytes of data),

-// "skip" (skips some bytes of data), "eof" (reports if the stream is at the end).

-//

-// ===========================================================================

-//

-// SIMD support

-//

-// The JPEG decoder will try to automatically use SIMD kernels on x86 when

-// supported by the compiler. For ARM Neon support, you must explicitly

-// request it.

-//

-// (The old do-it-yourself SIMD API is no longer supported in the current

-// code.)

-//

-// On x86, SSE2 will automatically be used when available based on a run-time

-// test; if not, the generic C versions are used as a fall-back. On ARM targets,

-// the typical path is to have separate builds for NEON and non-NEON devices

-// (at least this is true for iOS and Android). Therefore, the NEON support is

-// toggled by a build flag: define STBI_NEON to get NEON loops.

-//

-// If for some reason you do not want to use any of SIMD code, or if

-// you have issues compiling it, you can disable it entirely by

-// defining STBI_NO_SIMD.

-//

-// ===========================================================================

-//

-// HDR image support   (disable by defining STBI_NO_HDR)

-//

-// stb_image supports loading HDR images in general, and currently the Radiance

-// .HDR file format specifically. You can still load any file through the existing

-// interface; if you attempt to load an HDR file, it will be automatically remapped

-// to LDR, assuming gamma 2.2 and an arbitrary scale factor defaulting to 1;

-// both of these constants can be reconfigured through this interface:

-//

-//     stbi_hdr_to_ldr_gamma(2.2f);

-//     stbi_hdr_to_ldr_scale(1.0f);

-//

-// (note, do not use _inverse_ constants; stbi_image will invert them

-// appropriately).

-//

-// Additionally, there is a new, parallel interface for loading files as

-// (linear) floats to preserve the full dynamic range:

-//

-//    float *data = stbi_loadf(filename, &x, &y, &n, 0);

-//

-// If you load LDR images through this interface, those images will

-// be promoted to floating point values, run through the inverse of

-// constants corresponding to the above:

-//

-//     stbi_ldr_to_hdr_scale(1.0f);

-//     stbi_ldr_to_hdr_gamma(2.2f);

-//

-// Finally, given a filename (or an open file or memory block--see header

-// file for details) containing image data, you can query for the "most

-// appropriate" interface to use (that is, whether the image is HDR or

-// not), using:

-//

-//     stbi_is_hdr(char *filename);

-//

-// ===========================================================================

-//

-// iPhone PNG support:

-//

-// By default we convert iphone-formatted PNGs back to RGB, even though

-// they are internally encoded differently. You can disable this conversion

-// by calling stbi_convert_iphone_png_to_rgb(0), in which case

-// you will always just get the native iphone "format" through (which

-// is BGR stored in RGB).

-//

-// Call stbi_set_unpremultiply_on_load(1) as well to force a divide per

-// pixel to remove any premultiplied alpha *only* if the image file explicitly

-// says there's premultiplied data (currently only happens in iPhone images,

-// and only if iPhone convert-to-rgb processing is on).

-//

-// ===========================================================================

-//

-// ADDITIONAL CONFIGURATION

-//

-//  - You can suppress implementation of any of the decoders to reduce

-//    your code footprint by #defining one or more of the following

-//    symbols before creating the implementation.

-//

-//        STBI_NO_JPEG

-//        STBI_NO_PNG

-//        STBI_NO_BMP

-//        STBI_NO_PSD

-//        STBI_NO_TGA

-//        STBI_NO_GIF

-//        STBI_NO_HDR

-//        STBI_NO_PIC

-//        STBI_NO_PNM   (.ppm and .pgm)

-//

-//  - You can request *only* certain decoders and suppress all other ones

-//    (this will be more forward-compatible, as addition of new decoders

-//    doesn't require you to disable them explicitly):

-//

-//        STBI_ONLY_JPEG

-//        STBI_ONLY_PNG

-//        STBI_ONLY_BMP

-//        STBI_ONLY_PSD

-//        STBI_ONLY_TGA

-//        STBI_ONLY_GIF

-//        STBI_ONLY_HDR

-//        STBI_ONLY_PIC

-//        STBI_ONLY_PNM   (.ppm and .pgm)

-//

-//   - If you use STBI_NO_PNG (or _ONLY_ without PNG), and you still

-//     want the zlib decoder to be available, #define STBI_SUPPORT_ZLIB

-//

-

-

-#ifndef STBI_NO_STDIO

-#include <stdio.h>

-#endif // STBI_NO_STDIO

-

-#define STBI_VERSION 1

-

-enum

-{

-   STBI_default = 0, // only used for desired_channels

-

-   STBI_grey       = 1,

-   STBI_grey_alpha = 2,

-   STBI_rgb        = 3,

-   STBI_rgb_alpha  = 4

-};

-

-#include <stdlib.h>

-typedef unsigned char stbi_uc;

-typedef unsigned short stbi_us;

-

-#ifdef __cplusplus

-extern "C" {

-#endif

-

-#ifndef STBIDEF

-#ifdef STB_IMAGE_STATIC

-#define STBIDEF static

-#else

-#define STBIDEF extern

-#endif

-#endif

-

-//////////////////////////////////////////////////////////////////////////////

-//

-// PRIMARY API - works on images of any type

-//

-

-//

-// load image by filename, open file, or memory buffer

-//

-

-typedef struct

-{

-   int      (*read)  (void *user,char *data,int size);   // fill 'data' with 'size' bytes.  return number of bytes actually read

-   void     (*skip)  (void *user,int n);                 // skip the next 'n' bytes, or 'unget' the last -n bytes if negative

-   int      (*eof)   (void *user);                       // returns nonzero if we are at end of file/data

-} stbi_io_callbacks;

-

-////////////////////////////////////

-//

-// 8-bits-per-channel interface

-//

-

-STBIDEF stbi_uc *stbi_load_from_memory   (stbi_uc           const *buffer, int len   , int *x, int *y, int *channels_in_file, int desired_channels);

-STBIDEF stbi_uc *stbi_load_from_callbacks(stbi_io_callbacks const *clbk  , void *user, int *x, int *y, int *channels_in_file, int desired_channels);

-

-#ifndef STBI_NO_STDIO

-STBIDEF stbi_uc *stbi_load            (char const *filename, int *x, int *y, int *channels_in_file, int desired_channels);

-STBIDEF stbi_uc *stbi_load_from_file  (FILE *f, int *x, int *y, int *channels_in_file, int desired_channels);

-// for stbi_load_from_file, file pointer is left pointing immediately after image

-#endif

-

-#ifndef STBI_NO_GIF

-STBIDEF stbi_uc *stbi_load_gif_from_memory(stbi_uc const *buffer, int len, int **delays, int *x, int *y, int *z, int *comp, int req_comp);

-#endif

-

-#ifdef STBI_WINDOWS_UTF8

-STBIDEF int stbi_convert_wchar_to_utf8(char *buffer, size_t bufferlen, const wchar_t* input);

-#endif

-

-////////////////////////////////////

-//

-// 16-bits-per-channel interface

-//

-

-STBIDEF stbi_us *stbi_load_16_from_memory   (stbi_uc const *buffer, int len, int *x, int *y, int *channels_in_file, int desired_channels);

-STBIDEF stbi_us *stbi_load_16_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *channels_in_file, int desired_channels);

-

-#ifndef STBI_NO_STDIO

-STBIDEF stbi_us *stbi_load_16          (char const *filename, int *x, int *y, int *channels_in_file, int desired_channels);

-STBIDEF stbi_us *stbi_load_from_file_16(FILE *f, int *x, int *y, int *channels_in_file, int desired_channels);

-#endif

-

-////////////////////////////////////

-//

-// float-per-channel interface

-//

-#ifndef STBI_NO_LINEAR

-   STBIDEF float *stbi_loadf_from_memory     (stbi_uc const *buffer, int len, int *x, int *y, int *channels_in_file, int desired_channels);

-   STBIDEF float *stbi_loadf_from_callbacks  (stbi_io_callbacks const *clbk, void *user, int *x, int *y,  int *channels_in_file, int desired_channels);

-

-   #ifndef STBI_NO_STDIO

-   STBIDEF float *stbi_loadf            (char const *filename, int *x, int *y, int *channels_in_file, int desired_channels);

-   STBIDEF float *stbi_loadf_from_file  (FILE *f, int *x, int *y, int *channels_in_file, int desired_channels);

-   #endif

-#endif

-

-#ifndef STBI_NO_HDR

-   STBIDEF void   stbi_hdr_to_ldr_gamma(float gamma);

-   STBIDEF void   stbi_hdr_to_ldr_scale(float scale);

-#endif // STBI_NO_HDR

-

-#ifndef STBI_NO_LINEAR

-   STBIDEF void   stbi_ldr_to_hdr_gamma(float gamma);

-   STBIDEF void   stbi_ldr_to_hdr_scale(float scale);

-#endif // STBI_NO_LINEAR

-

-// stbi_is_hdr is always defined, but always returns false if STBI_NO_HDR

-STBIDEF int    stbi_is_hdr_from_callbacks(stbi_io_callbacks const *clbk, void *user);

-STBIDEF int    stbi_is_hdr_from_memory(stbi_uc const *buffer, int len);

-#ifndef STBI_NO_STDIO

-STBIDEF int      stbi_is_hdr          (char const *filename);

-STBIDEF int      stbi_is_hdr_from_file(FILE *f);

-#endif // STBI_NO_STDIO

-

-

-// get a VERY brief reason for failure

-// NOT THREADSAFE

-STBIDEF const char *stbi_failure_reason  (void);

-

-// free the loaded image -- this is just free()

-STBIDEF void     stbi_image_free      (void *retval_from_stbi_load);

-

-// get image dimensions & components without fully decoding

-STBIDEF int      stbi_info_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp);

-STBIDEF int      stbi_info_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *comp);

-STBIDEF int      stbi_is_16_bit_from_memory(stbi_uc const *buffer, int len);

-STBIDEF int      stbi_is_16_bit_from_callbacks(stbi_io_callbacks const *clbk, void *user);

-

-#ifndef STBI_NO_STDIO

-STBIDEF int      stbi_info               (char const *filename,     int *x, int *y, int *comp);

-STBIDEF int      stbi_info_from_file     (FILE *f,                  int *x, int *y, int *comp);

-STBIDEF int      stbi_is_16_bit          (char const *filename);

-STBIDEF int      stbi_is_16_bit_from_file(FILE *f);

-#endif

-

-

-

-// for image formats that explicitly notate that they have premultiplied alpha,

-// we just return the colors as stored in the file. set this flag to force

-// unpremultiplication. results are undefined if the unpremultiply overflow.

-STBIDEF void stbi_set_unpremultiply_on_load(int flag_true_if_should_unpremultiply);

-

-// indicate whether we should process iphone images back to canonical format,

-// or just pass them through "as-is"

-STBIDEF void stbi_convert_iphone_png_to_rgb(int flag_true_if_should_convert);

-

-// flip the image vertically, so the first pixel in the output array is the bottom left

-STBIDEF void stbi_set_flip_vertically_on_load(int flag_true_if_should_flip);

-

-// ZLIB client - used by PNG, available for other purposes

-

-STBIDEF char *stbi_zlib_decode_malloc_guesssize(const char *buffer, int len, int initial_size, int *outlen);

-STBIDEF char *stbi_zlib_decode_malloc_guesssize_headerflag(const char *buffer, int len, int initial_size, int *outlen, int parse_header);

-STBIDEF char *stbi_zlib_decode_malloc(const char *buffer, int len, int *outlen);

-STBIDEF int   stbi_zlib_decode_buffer(char *obuffer, int olen, const char *ibuffer, int ilen);

-

-STBIDEF char *stbi_zlib_decode_noheader_malloc(const char *buffer, int len, int *outlen);

-STBIDEF int   stbi_zlib_decode_noheader_buffer(char *obuffer, int olen, const char *ibuffer, int ilen);

-

-

-#ifdef __cplusplus

-}

-#endif

-

-//

-//

-////   end header file   /////////////////////////////////////////////////////

-#endif // STBI_INCLUDE_STB_IMAGE_H

-

-#ifdef STB_IMAGE_IMPLEMENTATION

-

-#if defined(STBI_ONLY_JPEG) || defined(STBI_ONLY_PNG) || defined(STBI_ONLY_BMP) \

-  || defined(STBI_ONLY_TGA) || defined(STBI_ONLY_GIF) || defined(STBI_ONLY_PSD) \

-  || defined(STBI_ONLY_HDR) || defined(STBI_ONLY_PIC) || defined(STBI_ONLY_PNM) \

-  || defined(STBI_ONLY_ZLIB)

-   #ifndef STBI_ONLY_JPEG

-   #define STBI_NO_JPEG

-   #endif

-   #ifndef STBI_ONLY_PNG

-   #define STBI_NO_PNG

-   #endif

-   #ifndef STBI_ONLY_BMP

-   #define STBI_NO_BMP

-   #endif

-   #ifndef STBI_ONLY_PSD

-   #define STBI_NO_PSD

-   #endif

-   #ifndef STBI_ONLY_TGA

-   #define STBI_NO_TGA

-   #endif

-   #ifndef STBI_ONLY_GIF

-   #define STBI_NO_GIF

-   #endif

-   #ifndef STBI_ONLY_HDR

-   #define STBI_NO_HDR

-   #endif

-   #ifndef STBI_ONLY_PIC

-   #define STBI_NO_PIC

-   #endif

-   #ifndef STBI_ONLY_PNM

-   #define STBI_NO_PNM

-   #endif

-#endif

-

-#if defined(STBI_NO_PNG) && !defined(STBI_SUPPORT_ZLIB) && !defined(STBI_NO_ZLIB)

-#define STBI_NO_ZLIB

-#endif

-

-

-#include <stdarg.h>

-#include <stddef.h> // ptrdiff_t on osx

-#include <stdlib.h>

-#include <string.h>

-#include <limits.h>

-

-#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR)

-#include <math.h>  // ldexp, pow

-#endif

-

-#ifndef STBI_NO_STDIO

-#include <stdio.h>

-#endif

-

-#ifndef STBI_ASSERT

-#include <assert.h>

-#define STBI_ASSERT(x) assert(x)

-#endif

-

-#ifdef __cplusplus

-#define STBI_EXTERN extern "C"

-#else

-#define STBI_EXTERN extern

-#endif

-

-

-#ifndef _MSC_VER

-   #ifdef __cplusplus

-   #define stbi_inline inline

-   #else

-   #define stbi_inline

-   #endif

-#else

-   #define stbi_inline __forceinline

-#endif

-

-

-#ifdef _MSC_VER

-typedef unsigned short stbi__uint16;

-typedef   signed short stbi__int16;

-typedef unsigned int   stbi__uint32;

-typedef   signed int   stbi__int32;

-#else

-#include <stdint.h>

-typedef uint16_t stbi__uint16;

-typedef int16_t  stbi__int16;

-typedef uint32_t stbi__uint32;

-typedef int32_t  stbi__int32;

-#endif

-

-// should produce compiler error if size is wrong

-typedef unsigned char validate_uint32[sizeof(stbi__uint32)==4 ? 1 : -1];

-

-#ifdef _MSC_VER

-#define STBI_NOTUSED(v)  (void)(v)

-#else

-#define STBI_NOTUSED(v)  (void)sizeof(v)

-#endif

-

-#ifdef _MSC_VER

-#define STBI_HAS_LROTL

-#endif

-

-#ifdef STBI_HAS_LROTL

-   #define stbi_lrot(x,y)  _lrotl(x,y)

-#else

-   #define stbi_lrot(x,y)  (((x) << (y)) | ((x) >> (32 - (y))))

-#endif

-

-#if defined(STBI_MALLOC) && defined(STBI_FREE) && (defined(STBI_REALLOC) || defined(STBI_REALLOC_SIZED))

-// ok

-#elif !defined(STBI_MALLOC) && !defined(STBI_FREE) && !defined(STBI_REALLOC) && !defined(STBI_REALLOC_SIZED)

-// ok

-#else

-#error "Must define all or none of STBI_MALLOC, STBI_FREE, and STBI_REALLOC (or STBI_REALLOC_SIZED)."

-#endif

-

-#ifndef STBI_MALLOC

-#define STBI_MALLOC(sz)           malloc(sz)

-#define STBI_REALLOC(p,newsz)     realloc(p,newsz)

-#define STBI_FREE(p)              free(p)

-#endif

-

-#ifndef STBI_REALLOC_SIZED

-#define STBI_REALLOC_SIZED(p,oldsz,newsz) STBI_REALLOC(p,newsz)

-#endif

-

-// x86/x64 detection

-#if defined(__x86_64__) || defined(_M_X64)

-#define STBI__X64_TARGET

-#elif defined(__i386) || defined(_M_IX86)

-#define STBI__X86_TARGET

-#endif

-

-#if defined(__GNUC__) && defined(STBI__X86_TARGET) && !defined(__SSE2__) && !defined(STBI_NO_SIMD)

-// gcc doesn't support sse2 intrinsics unless you compile with -msse2,

-// which in turn means it gets to use SSE2 everywhere. This is unfortunate,

-// but previous attempts to provide the SSE2 functions with runtime

-// detection caused numerous issues. The way architecture extensions are

-// exposed in GCC/Clang is, sadly, not really suited for one-file libs.

-// New behavior: if compiled with -msse2, we use SSE2 without any

-// detection; if not, we don't use it at all.

-#define STBI_NO_SIMD

-#endif

-

-#if defined(__MINGW32__) && defined(STBI__X86_TARGET) && !defined(STBI_MINGW_ENABLE_SSE2) && !defined(STBI_NO_SIMD)

-// Note that __MINGW32__ doesn't actually mean 32-bit, so we have to avoid STBI__X64_TARGET

-//

-// 32-bit MinGW wants ESP to be 16-byte aligned, but this is not in the

-// Windows ABI and VC++ as well as Windows DLLs don't maintain that invariant.

-// As a result, enabling SSE2 on 32-bit MinGW is dangerous when not

-// simultaneously enabling "-mstackrealign".

-//

-// See https://github.com/nothings/stb/issues/81 for more information.

-//

-// So default to no SSE2 on 32-bit MinGW. If you've read this far and added

-// -mstackrealign to your build settings, feel free to #define STBI_MINGW_ENABLE_SSE2.

-#define STBI_NO_SIMD

-#endif

-

-#if !defined(STBI_NO_SIMD) && (defined(STBI__X86_TARGET) || defined(STBI__X64_TARGET))

-#define STBI_SSE2

-#include <emmintrin.h>

-

-#ifdef _MSC_VER

-

-#if _MSC_VER >= 1400  // not VC6

-#include <intrin.h> // __cpuid

-static int stbi__cpuid3(void)

-{

-   int info[4];

-   __cpuid(info,1);

-   return info[3];

-}

-#else

-static int stbi__cpuid3(void)

-{

-   int res;

-   __asm {

-      mov  eax,1

-      cpuid

-      mov  res,edx

-   }

-   return res;

-}

-#endif

-

-#define STBI_SIMD_ALIGN(type, name) __declspec(align(16)) type name

-

-#if !defined(STBI_NO_JPEG) && defined(STBI_SSE2)

-static int stbi__sse2_available(void)

-{

-   int info3 = stbi__cpuid3();

-   return ((info3 >> 26) & 1) != 0;

-}

-#endif

-

-#else // assume GCC-style if not VC++

-#define STBI_SIMD_ALIGN(type, name) type name __attribute__((aligned(16)))

-

-#if !defined(STBI_NO_JPEG) && defined(STBI_SSE2)

-static int stbi__sse2_available(void)

-{

-   // If we're even attempting to compile this on GCC/Clang, that means

-   // -msse2 is on, which means the compiler is allowed to use SSE2

-   // instructions at will, and so are we.

-   return 1;

-}

-#endif

-

-#endif

-#endif

-

-// ARM NEON

-#if defined(STBI_NO_SIMD) && defined(STBI_NEON)

-#undef STBI_NEON

-#endif

-

-#ifdef STBI_NEON

-#include <arm_neon.h>

-// assume GCC or Clang on ARM targets

-#define STBI_SIMD_ALIGN(type, name) type name __attribute__((aligned(16)))

-#endif

-

-#ifndef STBI_SIMD_ALIGN

-#define STBI_SIMD_ALIGN(type, name) type name

-#endif

-

-///////////////////////////////////////////////

-//

-//  stbi__context struct and start_xxx functions

-

-// stbi__context structure is our basic context used by all images, so it

-// contains all the IO context, plus some basic image information

-typedef struct

-{

-   stbi__uint32 img_x, img_y;

-   int img_n, img_out_n;

-

-   stbi_io_callbacks io;

-   void *io_user_data;

-

-   int read_from_callbacks;

-   int buflen;

-   stbi_uc buffer_start[128];

-

-   stbi_uc *img_buffer, *img_buffer_end;

-   stbi_uc *img_buffer_original, *img_buffer_original_end;

-} stbi__context;

-

-

-static void stbi__refill_buffer(stbi__context *s);

-

-// initialize a memory-decode context

-static void stbi__start_mem(stbi__context *s, stbi_uc const *buffer, int len)

-{

-   s->io.read = NULL;

-   s->read_from_callbacks = 0;

-   s->img_buffer = s->img_buffer_original = (stbi_uc *) buffer;

-   s->img_buffer_end = s->img_buffer_original_end = (stbi_uc *) buffer+len;

-}

-

-// initialize a callback-based context

-static void stbi__start_callbacks(stbi__context *s, stbi_io_callbacks *c, void *user)

-{

-   s->io = *c;

-   s->io_user_data = user;

-   s->buflen = sizeof(s->buffer_start);

-   s->read_from_callbacks = 1;

-   s->img_buffer_original = s->buffer_start;

-   stbi__refill_buffer(s);

-   s->img_buffer_original_end = s->img_buffer_end;

-}

-

-#ifndef STBI_NO_STDIO

-

-static int stbi__stdio_read(void *user, char *data, int size)

-{

-   return (int) fread(data,1,size,(FILE*) user);

-}

-

-static void stbi__stdio_skip(void *user, int n)

-{

-   fseek((FILE*) user, n, SEEK_CUR);

-}

-

-static int stbi__stdio_eof(void *user)

-{

-   return feof((FILE*) user);

-}

-

-static stbi_io_callbacks stbi__stdio_callbacks =

-{

-   stbi__stdio_read,

-   stbi__stdio_skip,

-   stbi__stdio_eof,

-};

-

-static void stbi__start_file(stbi__context *s, FILE *f)

-{

-   stbi__start_callbacks(s, &stbi__stdio_callbacks, (void *) f);

-}

-

-//static void stop_file(stbi__context *s) { }

-

-#endif // !STBI_NO_STDIO

-

-static void stbi__rewind(stbi__context *s)

-{

-   // conceptually rewind SHOULD rewind to the beginning of the stream,

-   // but we just rewind to the beginning of the initial buffer, because

-   // we only use it after doing 'test', which only ever looks at at most 92 bytes

-   s->img_buffer = s->img_buffer_original;

-   s->img_buffer_end = s->img_buffer_original_end;

-}

-

-enum

-{

-   STBI_ORDER_RGB,

-   STBI_ORDER_BGR

-};

-

-typedef struct

-{

-   int bits_per_channel;

-   int num_channels;

-   int channel_order;

-} stbi__result_info;

-

-#ifndef STBI_NO_JPEG

-static int      stbi__jpeg_test(stbi__context *s);

-static void    *stbi__jpeg_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri);

-static int      stbi__jpeg_info(stbi__context *s, int *x, int *y, int *comp);

-#endif

-

-#ifndef STBI_NO_PNG

-static int      stbi__png_test(stbi__context *s);

-static void    *stbi__png_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri);

-static int      stbi__png_info(stbi__context *s, int *x, int *y, int *comp);

-static int      stbi__png_is16(stbi__context *s);

-#endif

-

-#ifndef STBI_NO_BMP

-static int      stbi__bmp_test(stbi__context *s);

-static void    *stbi__bmp_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri);

-static int      stbi__bmp_info(stbi__context *s, int *x, int *y, int *comp);

-#endif

-

-#ifndef STBI_NO_TGA

-static int      stbi__tga_test(stbi__context *s);

-static void    *stbi__tga_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri);

-static int      stbi__tga_info(stbi__context *s, int *x, int *y, int *comp);

-#endif

-

-#ifndef STBI_NO_PSD

-static int      stbi__psd_test(stbi__context *s);

-static void    *stbi__psd_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri, int bpc);

-static int      stbi__psd_info(stbi__context *s, int *x, int *y, int *comp);

-static int      stbi__psd_is16(stbi__context *s);

-#endif

-

-#ifndef STBI_NO_HDR

-static int      stbi__hdr_test(stbi__context *s);

-static float   *stbi__hdr_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri);

-static int      stbi__hdr_info(stbi__context *s, int *x, int *y, int *comp);

-#endif

-

-#ifndef STBI_NO_PIC

-static int      stbi__pic_test(stbi__context *s);

-static void    *stbi__pic_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri);

-static int      stbi__pic_info(stbi__context *s, int *x, int *y, int *comp);

-#endif

-

-#ifndef STBI_NO_GIF

-static int      stbi__gif_test(stbi__context *s);

-static void    *stbi__gif_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri);

-static void    *stbi__load_gif_main(stbi__context *s, int **delays, int *x, int *y, int *z, int *comp, int req_comp);

-static int      stbi__gif_info(stbi__context *s, int *x, int *y, int *comp);

-#endif

-

-#ifndef STBI_NO_PNM

-static int      stbi__pnm_test(stbi__context *s);

-static void    *stbi__pnm_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri);

-static int      stbi__pnm_info(stbi__context *s, int *x, int *y, int *comp);

-#endif

-

-// this is not threadsafe

-static const char *stbi__g_failure_reason;

-

-STBIDEF const char *stbi_failure_reason(void)

-{

-   return stbi__g_failure_reason;

-}

-

-static int stbi__err(const char *str)

-{

-   stbi__g_failure_reason = str;

-   return 0;

-}

-

-static void *stbi__malloc(size_t size)

-{

-    return STBI_MALLOC(size);

-}

-

-// stb_image uses ints pervasively, including for offset calculations.

-// therefore the largest decoded image size we can support with the

-// current code, even on 64-bit targets, is INT_MAX. this is not a

-// significant limitation for the intended use case.

-//

-// we do, however, need to make sure our size calculations don't

-// overflow. hence a few helper functions for size calculations that

-// multiply integers together, making sure that they're non-negative

-// and no overflow occurs.

-

-// return 1 if the sum is valid, 0 on overflow.

-// negative terms are considered invalid.

-static int stbi__addsizes_valid(int a, int b)

-{

-   if (b < 0) return 0;

-   // now 0 <= b <= INT_MAX, hence also

-   // 0 <= INT_MAX - b <= INTMAX.

-   // And "a + b <= INT_MAX" (which might overflow) is the

-   // same as a <= INT_MAX - b (no overflow)

-   return a <= INT_MAX - b;

-}

-

-// returns 1 if the product is valid, 0 on overflow.

-// negative factors are considered invalid.

-static int stbi__mul2sizes_valid(int a, int b)

-{

-   if (a < 0 || b < 0) return 0;

-   if (b == 0) return 1; // mul-by-0 is always safe

-   // portable way to check for no overflows in a*b

-   return a <= INT_MAX/b;

-}

-

-// returns 1 if "a*b + add" has no negative terms/factors and doesn't overflow

-static int stbi__mad2sizes_valid(int a, int b, int add)

-{

-   return stbi__mul2sizes_valid(a, b) && stbi__addsizes_valid(a*b, add);

-}

-

-// returns 1 if "a*b*c + add" has no negative terms/factors and doesn't overflow

-static int stbi__mad3sizes_valid(int a, int b, int c, int add)

-{

-   return stbi__mul2sizes_valid(a, b) && stbi__mul2sizes_valid(a*b, c) &&

-      stbi__addsizes_valid(a*b*c, add);

-}

-

-// returns 1 if "a*b*c*d + add" has no negative terms/factors and doesn't overflow

-#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR)

-static int stbi__mad4sizes_valid(int a, int b, int c, int d, int add)

-{

-   return stbi__mul2sizes_valid(a, b) && stbi__mul2sizes_valid(a*b, c) &&

-      stbi__mul2sizes_valid(a*b*c, d) && stbi__addsizes_valid(a*b*c*d, add);

-}

-#endif

-

-// mallocs with size overflow checking

-static void *stbi__malloc_mad2(int a, int b, int add)

-{

-   if (!stbi__mad2sizes_valid(a, b, add)) return NULL;

-   return stbi__malloc(a*b + add);

-}

-

-static void *stbi__malloc_mad3(int a, int b, int c, int add)

-{

-   if (!stbi__mad3sizes_valid(a, b, c, add)) return NULL;

-   return stbi__malloc(a*b*c + add);

-}

-

-#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR)

-static void *stbi__malloc_mad4(int a, int b, int c, int d, int add)

-{

-   if (!stbi__mad4sizes_valid(a, b, c, d, add)) return NULL;

-   return stbi__malloc(a*b*c*d + add);

-}

-#endif

-

-// stbi__err - error

-// stbi__errpf - error returning pointer to float

-// stbi__errpuc - error returning pointer to unsigned char

-

-#ifdef STBI_NO_FAILURE_STRINGS

-   #define stbi__err(x,y)  0

-#elif defined(STBI_FAILURE_USERMSG)

-   #define stbi__err(x,y)  stbi__err(y)

-#else

-   #define stbi__err(x,y)  stbi__err(x)

-#endif

-

-#define stbi__errpf(x,y)   ((float *)(size_t) (stbi__err(x,y)?NULL:NULL))

-#define stbi__errpuc(x,y)  ((unsigned char *)(size_t) (stbi__err(x,y)?NULL:NULL))

-

-STBIDEF void stbi_image_free(void *retval_from_stbi_load)

-{

-   STBI_FREE(retval_from_stbi_load);

-}

-

-#ifndef STBI_NO_LINEAR

-static float   *stbi__ldr_to_hdr(stbi_uc *data, int x, int y, int comp);

-#endif

-

-#ifndef STBI_NO_HDR

-static stbi_uc *stbi__hdr_to_ldr(float   *data, int x, int y, int comp);

-#endif

-

-static int stbi__vertically_flip_on_load = 0;

-

-STBIDEF void stbi_set_flip_vertically_on_load(int flag_true_if_should_flip)

-{

-    stbi__vertically_flip_on_load = flag_true_if_should_flip;

-}

-

-static void *stbi__load_main(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri, int bpc)

-{

-   memset(ri, 0, sizeof(*ri)); // make sure it's initialized if we add new fields

-   ri->bits_per_channel = 8; // default is 8 so most paths don't have to be changed

-   ri->channel_order = STBI_ORDER_RGB; // all current input & output are this, but this is here so we can add BGR order

-   ri->num_channels = 0;

-

-   #ifndef STBI_NO_JPEG

-   if (stbi__jpeg_test(s)) return stbi__jpeg_load(s,x,y,comp,req_comp, ri);

-   #endif

-   #ifndef STBI_NO_PNG

-   if (stbi__png_test(s))  return stbi__png_load(s,x,y,comp,req_comp, ri);

-   #endif

-   #ifndef STBI_NO_BMP

-   if (stbi__bmp_test(s))  return stbi__bmp_load(s,x,y,comp,req_comp, ri);

-   #endif

-   #ifndef STBI_NO_GIF

-   if (stbi__gif_test(s))  return stbi__gif_load(s,x,y,comp,req_comp, ri);

-   #endif

-   #ifndef STBI_NO_PSD

-   if (stbi__psd_test(s))  return stbi__psd_load(s,x,y,comp,req_comp, ri, bpc);

-   #endif

-   #ifndef STBI_NO_PIC

-   if (stbi__pic_test(s))  return stbi__pic_load(s,x,y,comp,req_comp, ri);

-   #endif

-   #ifndef STBI_NO_PNM

-   if (stbi__pnm_test(s))  return stbi__pnm_load(s,x,y,comp,req_comp, ri);

-   #endif

-

-   #ifndef STBI_NO_HDR

-   if (stbi__hdr_test(s)) {

-      float *hdr = stbi__hdr_load(s, x,y,comp,req_comp, ri);

-      return stbi__hdr_to_ldr(hdr, *x, *y, req_comp ? req_comp : *comp);

-   }

-   #endif

-

-   #ifndef STBI_NO_TGA

-   // test tga last because it's a crappy test!

-   if (stbi__tga_test(s))

-      return stbi__tga_load(s,x,y,comp,req_comp, ri);

-   #endif

-

-   return stbi__errpuc("unknown image type", "Image not of any known type, or corrupt");

-}

-

-static stbi_uc *stbi__convert_16_to_8(stbi__uint16 *orig, int w, int h, int channels)

-{

-   int i;

-   int img_len = w * h * channels;

-   stbi_uc *reduced;

-

-   reduced = (stbi_uc *) stbi__malloc(img_len);

-   if (reduced == NULL) return stbi__errpuc("outofmem", "Out of memory");

-

-   for (i = 0; i < img_len; ++i)

-      reduced[i] = (stbi_uc)((orig[i] >> 8) & 0xFF); // top half of each byte is sufficient approx of 16->8 bit scaling

-

-   STBI_FREE(orig);

-   return reduced;

-}

-

-static stbi__uint16 *stbi__convert_8_to_16(stbi_uc *orig, int w, int h, int channels)

-{

-   int i;

-   int img_len = w * h * channels;

-   stbi__uint16 *enlarged;

-

-   enlarged = (stbi__uint16 *) stbi__malloc(img_len*2);

-   if (enlarged == NULL) return (stbi__uint16 *) stbi__errpuc("outofmem", "Out of memory");

-

-   for (i = 0; i < img_len; ++i)

-      enlarged[i] = (stbi__uint16)((orig[i] << 8) + orig[i]); // replicate to high and low byte, maps 0->0, 255->0xffff

-

-   STBI_FREE(orig);

-   return enlarged;

-}

-

-static void stbi__vertical_flip(void *image, int w, int h, int bytes_per_pixel)

-{

-   int row;

-   size_t bytes_per_row = (size_t)w * bytes_per_pixel;

-   stbi_uc temp[2048];

-   stbi_uc *bytes = (stbi_uc *)image;

-

-   for (row = 0; row < (h>>1); row++) {

-      stbi_uc *row0 = bytes + row*bytes_per_row;

-      stbi_uc *row1 = bytes + (h - row - 1)*bytes_per_row;

-      // swap row0 with row1

-      size_t bytes_left = bytes_per_row;

-      while (bytes_left) {

-         size_t bytes_copy = (bytes_left < sizeof(temp)) ? bytes_left : sizeof(temp);

-         memcpy(temp, row0, bytes_copy);

-         memcpy(row0, row1, bytes_copy);

-         memcpy(row1, temp, bytes_copy);

-         row0 += bytes_copy;

-         row1 += bytes_copy;

-         bytes_left -= bytes_copy;

-      }

-   }

-}

-

-#ifndef STBI_NO_GIF

-static void stbi__vertical_flip_slices(void *image, int w, int h, int z, int bytes_per_pixel)

-{

-   int slice;

-   int slice_size = w * h * bytes_per_pixel;

-

-   stbi_uc *bytes = (stbi_uc *)image;

-   for (slice = 0; slice < z; ++slice) {

-      stbi__vertical_flip(bytes, w, h, bytes_per_pixel); 

-      bytes += slice_size; 

-   }

-}

-#endif

-

-static unsigned char *stbi__load_and_postprocess_8bit(stbi__context *s, int *x, int *y, int *comp, int req_comp)

-{

-   stbi__result_info ri;

-   void *result = stbi__load_main(s, x, y, comp, req_comp, &ri, 8);

-

-   if (result == NULL)

-      return NULL;

-

-   if (ri.bits_per_channel != 8) {

-      STBI_ASSERT(ri.bits_per_channel == 16);

-      result = stbi__convert_16_to_8((stbi__uint16 *) result, *x, *y, req_comp == 0 ? *comp : req_comp);

-      ri.bits_per_channel = 8;

-   }

-

-   // @TODO: move stbi__convert_format to here

-

-   if (stbi__vertically_flip_on_load) {

-      int channels = req_comp ? req_comp : *comp;

-      stbi__vertical_flip(result, *x, *y, channels * sizeof(stbi_uc));

-   }

-

-   return (unsigned char *) result;

-}

-

-static stbi__uint16 *stbi__load_and_postprocess_16bit(stbi__context *s, int *x, int *y, int *comp, int req_comp)

-{

-   stbi__result_info ri;

-   void *result = stbi__load_main(s, x, y, comp, req_comp, &ri, 16);

-

-   if (result == NULL)

-      return NULL;

-

-   if (ri.bits_per_channel != 16) {

-      STBI_ASSERT(ri.bits_per_channel == 8);

-      result = stbi__convert_8_to_16((stbi_uc *) result, *x, *y, req_comp == 0 ? *comp : req_comp);

-      ri.bits_per_channel = 16;

-   }

-

-   // @TODO: move stbi__convert_format16 to here

-   // @TODO: special case RGB-to-Y (and RGBA-to-YA) for 8-bit-to-16-bit case to keep more precision

-

-   if (stbi__vertically_flip_on_load) {

-      int channels = req_comp ? req_comp : *comp;

-      stbi__vertical_flip(result, *x, *y, channels * sizeof(stbi__uint16));

-   }

-

-   return (stbi__uint16 *) result;

-}

-

-#if !defined(STBI_NO_HDR) && !defined(STBI_NO_LINEAR)

-static void stbi__float_postprocess(float *result, int *x, int *y, int *comp, int req_comp)

-{

-   if (stbi__vertically_flip_on_load && result != NULL) {

-      int channels = req_comp ? req_comp : *comp;

-      stbi__vertical_flip(result, *x, *y, channels * sizeof(float));

-   }

-}

-#endif

-

-#ifndef STBI_NO_STDIO

-

-#if defined(_MSC_VER) && defined(STBI_WINDOWS_UTF8)

-STBI_EXTERN __declspec(dllimport) int __stdcall MultiByteToWideChar(unsigned int cp, unsigned long flags, const char *str, int cbmb, wchar_t *widestr, int cchwide);

-STBI_EXTERN __declspec(dllimport) int __stdcall WideCharToMultiByte(unsigned int cp, unsigned long flags, const wchar_t *widestr, int cchwide, char *str, int cbmb, const char *defchar, int *used_default);

-#endif

-

-#if defined(_MSC_VER) && defined(STBI_WINDOWS_UTF8)

-STBIDEF int stbi_convert_wchar_to_utf8(char *buffer, size_t bufferlen, const wchar_t* input)

-{

-	return WideCharToMultiByte(65001 /* UTF8 */, 0, input, -1, buffer, (int) bufferlen, NULL, NULL);

-}

-#endif

-

-static FILE *stbi__fopen(char const *filename, char const *mode)

-{

-   FILE *f;

-#if defined(_MSC_VER) && defined(STBI_WINDOWS_UTF8)

-   wchar_t wMode[64];

-   wchar_t wFilename[1024];

-	if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, filename, -1, wFilename, sizeof(wFilename)))

-      return 0;

-	

-	if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, mode, -1, wMode, sizeof(wMode)))

-      return 0;

-

-#if _MSC_VER >= 1400

-	if (0 != _wfopen_s(&f, wFilename, wMode))

-		f = 0;

-#else

-   f = _wfopen(wFilename, wMode);

-#endif

-

-#elif defined(_MSC_VER) && _MSC_VER >= 1400

-   if (0 != fopen_s(&f, filename, mode))

-      f=0;

-#else

-   f = fopen(filename, mode);

-#endif

-   return f;

-}

-

-

-STBIDEF stbi_uc *stbi_load(char const *filename, int *x, int *y, int *comp, int req_comp)

-{

-   FILE *f = stbi__fopen(filename, "rb");

-   unsigned char *result;

-   if (!f) return stbi__errpuc("can't fopen", "Unable to open file");

-   result = stbi_load_from_file(f,x,y,comp,req_comp);

-   fclose(f);

-   return result;

-}

-

-STBIDEF stbi_uc *stbi_load_from_file(FILE *f, int *x, int *y, int *comp, int req_comp)

-{

-   unsigned char *result;

-   stbi__context s;

-   stbi__start_file(&s,f);

-   result = stbi__load_and_postprocess_8bit(&s,x,y,comp,req_comp);

-   if (result) {

-      // need to 'unget' all the characters in the IO buffer

-      fseek(f, - (int) (s.img_buffer_end - s.img_buffer), SEEK_CUR);

-   }

-   return result;

-}

-

-STBIDEF stbi__uint16 *stbi_load_from_file_16(FILE *f, int *x, int *y, int *comp, int req_comp)

-{

-   stbi__uint16 *result;

-   stbi__context s;

-   stbi__start_file(&s,f);

-   result = stbi__load_and_postprocess_16bit(&s,x,y,comp,req_comp);

-   if (result) {

-      // need to 'unget' all the characters in the IO buffer

-      fseek(f, - (int) (s.img_buffer_end - s.img_buffer), SEEK_CUR);

-   }

-   return result;

-}

-

-STBIDEF stbi_us *stbi_load_16(char const *filename, int *x, int *y, int *comp, int req_comp)

-{

-   FILE *f = stbi__fopen(filename, "rb");

-   stbi__uint16 *result;

-   if (!f) return (stbi_us *) stbi__errpuc("can't fopen", "Unable to open file");

-   result = stbi_load_from_file_16(f,x,y,comp,req_comp);

-   fclose(f);

-   return result;

-}

-

-

-#endif //!STBI_NO_STDIO

-

-STBIDEF stbi_us *stbi_load_16_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *channels_in_file, int desired_channels)

-{

-   stbi__context s;

-   stbi__start_mem(&s,buffer,len);

-   return stbi__load_and_postprocess_16bit(&s,x,y,channels_in_file,desired_channels);

-}

-

-STBIDEF stbi_us *stbi_load_16_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *channels_in_file, int desired_channels)

-{

-   stbi__context s;

-   stbi__start_callbacks(&s, (stbi_io_callbacks *)clbk, user);

-   return stbi__load_and_postprocess_16bit(&s,x,y,channels_in_file,desired_channels);

-}

-

-STBIDEF stbi_uc *stbi_load_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp, int req_comp)

-{

-   stbi__context s;

-   stbi__start_mem(&s,buffer,len);

-   return stbi__load_and_postprocess_8bit(&s,x,y,comp,req_comp);

-}

-

-STBIDEF stbi_uc *stbi_load_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *comp, int req_comp)

-{

-   stbi__context s;

-   stbi__start_callbacks(&s, (stbi_io_callbacks *) clbk, user);

-   return stbi__load_and_postprocess_8bit(&s,x,y,comp,req_comp);

-}

-

-#ifndef STBI_NO_GIF

-STBIDEF stbi_uc *stbi_load_gif_from_memory(stbi_uc const *buffer, int len, int **delays, int *x, int *y, int *z, int *comp, int req_comp)

-{

-   unsigned char *result;

-   stbi__context s; 

-   stbi__start_mem(&s,buffer,len); 

-   

-   result = (unsigned char*) stbi__load_gif_main(&s, delays, x, y, z, comp, req_comp);

-   if (stbi__vertically_flip_on_load) {

-      stbi__vertical_flip_slices( result, *x, *y, *z, *comp ); 

-   }

-

-   return result; 

-}

-#endif

-

-#ifndef STBI_NO_LINEAR

-static float *stbi__loadf_main(stbi__context *s, int *x, int *y, int *comp, int req_comp)

-{

-   unsigned char *data;

-   #ifndef STBI_NO_HDR

-   if (stbi__hdr_test(s)) {

-      stbi__result_info ri;

-      float *hdr_data = stbi__hdr_load(s,x,y,comp,req_comp, &ri);

-      if (hdr_data)

-         stbi__float_postprocess(hdr_data,x,y,comp,req_comp);

-      return hdr_data;

-   }

-   #endif

-   data = stbi__load_and_postprocess_8bit(s, x, y, comp, req_comp);

-   if (data)

-      return stbi__ldr_to_hdr(data, *x, *y, req_comp ? req_comp : *comp);

-   return stbi__errpf("unknown image type", "Image not of any known type, or corrupt");

-}

-

-STBIDEF float *stbi_loadf_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp, int req_comp)

-{

-   stbi__context s;

-   stbi__start_mem(&s,buffer,len);

-   return stbi__loadf_main(&s,x,y,comp,req_comp);

-}

-

-STBIDEF float *stbi_loadf_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *comp, int req_comp)

-{

-   stbi__context s;

-   stbi__start_callbacks(&s, (stbi_io_callbacks *) clbk, user);

-   return stbi__loadf_main(&s,x,y,comp,req_comp);

-}

-

-#ifndef STBI_NO_STDIO

-STBIDEF float *stbi_loadf(char const *filename, int *x, int *y, int *comp, int req_comp)

-{

-   float *result;

-   FILE *f = stbi__fopen(filename, "rb");

-   if (!f) return stbi__errpf("can't fopen", "Unable to open file");

-   result = stbi_loadf_from_file(f,x,y,comp,req_comp);

-   fclose(f);

-   return result;

-}

-

-STBIDEF float *stbi_loadf_from_file(FILE *f, int *x, int *y, int *comp, int req_comp)

-{

-   stbi__context s;

-   stbi__start_file(&s,f);

-   return stbi__loadf_main(&s,x,y,comp,req_comp);

-}

-#endif // !STBI_NO_STDIO

-

-#endif // !STBI_NO_LINEAR

-

-// these is-hdr-or-not is defined independent of whether STBI_NO_LINEAR is

-// defined, for API simplicity; if STBI_NO_LINEAR is defined, it always

-// reports false!

-

-STBIDEF int stbi_is_hdr_from_memory(stbi_uc const *buffer, int len)

-{

-   #ifndef STBI_NO_HDR

-   stbi__context s;

-   stbi__start_mem(&s,buffer,len);

-   return stbi__hdr_test(&s);

-   #else

-   STBI_NOTUSED(buffer);

-   STBI_NOTUSED(len);

-   return 0;

-   #endif

-}

-

-#ifndef STBI_NO_STDIO

-STBIDEF int      stbi_is_hdr          (char const *filename)

-{

-   FILE *f = stbi__fopen(filename, "rb");

-   int result=0;

-   if (f) {

-      result = stbi_is_hdr_from_file(f);

-      fclose(f);

-   }

-   return result;

-}

-

-STBIDEF int stbi_is_hdr_from_file(FILE *f)

-{

-   #ifndef STBI_NO_HDR

-   long pos = ftell(f);

-   int res;

-   stbi__context s;

-   stbi__start_file(&s,f);

-   res = stbi__hdr_test(&s);

-   fseek(f, pos, SEEK_SET);

-   return res;

-   #else

-   STBI_NOTUSED(f);

-   return 0;

-   #endif

-}

-#endif // !STBI_NO_STDIO

-

-STBIDEF int      stbi_is_hdr_from_callbacks(stbi_io_callbacks const *clbk, void *user)

-{

-   #ifndef STBI_NO_HDR

-   stbi__context s;

-   stbi__start_callbacks(&s, (stbi_io_callbacks *) clbk, user);

-   return stbi__hdr_test(&s);

-   #else

-   STBI_NOTUSED(clbk);

-   STBI_NOTUSED(user);

-   return 0;

-   #endif

-}

-

-#ifndef STBI_NO_LINEAR

-static float stbi__l2h_gamma=2.2f, stbi__l2h_scale=1.0f;

-

-STBIDEF void   stbi_ldr_to_hdr_gamma(float gamma) { stbi__l2h_gamma = gamma; }

-STBIDEF void   stbi_ldr_to_hdr_scale(float scale) { stbi__l2h_scale = scale; }

-#endif

-

-static float stbi__h2l_gamma_i=1.0f/2.2f, stbi__h2l_scale_i=1.0f;

-

-STBIDEF void   stbi_hdr_to_ldr_gamma(float gamma) { stbi__h2l_gamma_i = 1/gamma; }

-STBIDEF void   stbi_hdr_to_ldr_scale(float scale) { stbi__h2l_scale_i = 1/scale; }

-

-

-//////////////////////////////////////////////////////////////////////////////

-//

-// Common code used by all image loaders

-//

-

-enum

-{

-   STBI__SCAN_load=0,

-   STBI__SCAN_type,

-   STBI__SCAN_header

-};

-

-static void stbi__refill_buffer(stbi__context *s)

-{

-   int n = (s->io.read)(s->io_user_data,(char*)s->buffer_start,s->buflen);

-   if (n == 0) {

-      // at end of file, treat same as if from memory, but need to handle case

-      // where s->img_buffer isn't pointing to safe memory, e.g. 0-byte file

-      s->read_from_callbacks = 0;

-      s->img_buffer = s->buffer_start;

-      s->img_buffer_end = s->buffer_start+1;

-      *s->img_buffer = 0;

-   } else {

-      s->img_buffer = s->buffer_start;

-      s->img_buffer_end = s->buffer_start + n;

-   }

-}

-

-stbi_inline static stbi_uc stbi__get8(stbi__context *s)

-{

-   if (s->img_buffer < s->img_buffer_end)

-      return *s->img_buffer++;

-   if (s->read_from_callbacks) {

-      stbi__refill_buffer(s);

-      return *s->img_buffer++;

-   }

-   return 0;

-}

-

-stbi_inline static int stbi__at_eof(stbi__context *s)

-{

-   if (s->io.read) {

-      if (!(s->io.eof)(s->io_user_data)) return 0;

-      // if feof() is true, check if buffer = end

-      // special case: we've only got the special 0 character at the end

-      if (s->read_from_callbacks == 0) return 1;

-   }

-

-   return s->img_buffer >= s->img_buffer_end;

-}

-

-static void stbi__skip(stbi__context *s, int n)

-{

-   if (n < 0) {

-      s->img_buffer = s->img_buffer_end;

-      return;

-   }

-   if (s->io.read) {

-      int blen = (int) (s->img_buffer_end - s->img_buffer);

-      if (blen < n) {

-         s->img_buffer = s->img_buffer_end;

-         (s->io.skip)(s->io_user_data, n - blen);

-         return;

-      }

-   }

-   s->img_buffer += n;

-}

-

-static int stbi__getn(stbi__context *s, stbi_uc *buffer, int n)

-{

-   if (s->io.read) {

-      int blen = (int) (s->img_buffer_end - s->img_buffer);

-      if (blen < n) {

-         int res, count;

-

-         memcpy(buffer, s->img_buffer, blen);

-

-         count = (s->io.read)(s->io_user_data, (char*) buffer + blen, n - blen);

-         res = (count == (n-blen));

-         s->img_buffer = s->img_buffer_end;

-         return res;

-      }

-   }

-

-   if (s->img_buffer+n <= s->img_buffer_end) {

-      memcpy(buffer, s->img_buffer, n);

-      s->img_buffer += n;

-      return 1;

-   } else

-      return 0;

-}

-

-static int stbi__get16be(stbi__context *s)

-{

-   int z = stbi__get8(s);

-   return (z << 8) + stbi__get8(s);

-}

-

-static stbi__uint32 stbi__get32be(stbi__context *s)

-{

-   stbi__uint32 z = stbi__get16be(s);

-   return (z << 16) + stbi__get16be(s);

-}

-

-#if defined(STBI_NO_BMP) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF)

-// nothing

-#else

-static int stbi__get16le(stbi__context *s)

-{

-   int z = stbi__get8(s);

-   return z + (stbi__get8(s) << 8);

-}

-#endif

-

-#ifndef STBI_NO_BMP

-static stbi__uint32 stbi__get32le(stbi__context *s)

-{

-   stbi__uint32 z = stbi__get16le(s);

-   return z + (stbi__get16le(s) << 16);

-}

-#endif

-

-#define STBI__BYTECAST(x)  ((stbi_uc) ((x) & 255))  // truncate int to byte without warnings

-

-

-//////////////////////////////////////////////////////////////////////////////

-//

-//  generic converter from built-in img_n to req_comp

-//    individual types do this automatically as much as possible (e.g. jpeg

-//    does all cases internally since it needs to colorspace convert anyway,

-//    and it never has alpha, so very few cases ). png can automatically

-//    interleave an alpha=255 channel, but falls back to this for other cases

-//

-//  assume data buffer is malloced, so malloc a new one and free that one

-//  only failure mode is malloc failing

-

-static stbi_uc stbi__compute_y(int r, int g, int b)

-{

-   return (stbi_uc) (((r*77) + (g*150) +  (29*b)) >> 8);

-}

-

-static unsigned char *stbi__convert_format(unsigned char *data, int img_n, int req_comp, unsigned int x, unsigned int y)

-{

-   int i,j;

-   unsigned char *good;

-

-   if (req_comp == img_n) return data;

-   STBI_ASSERT(req_comp >= 1 && req_comp <= 4);

-

-   good = (unsigned char *) stbi__malloc_mad3(req_comp, x, y, 0);

-   if (good == NULL) {

-      STBI_FREE(data);

-      return stbi__errpuc("outofmem", "Out of memory");

-   }

-

-   for (j=0; j < (int) y; ++j) {

-      unsigned char *src  = data + j * x * img_n   ;

-      unsigned char *dest = good + j * x * req_comp;

-

-      #define STBI__COMBO(a,b)  ((a)*8+(b))

-      #define STBI__CASE(a,b)   case STBI__COMBO(a,b): for(i=x-1; i >= 0; --i, src += a, dest += b)

-      // convert source image with img_n components to one with req_comp components;

-      // avoid switch per pixel, so use switch per scanline and massive macros

-      switch (STBI__COMBO(img_n, req_comp)) {

-         STBI__CASE(1,2) { dest[0]=src[0]; dest[1]=255;                                     } break;

-         STBI__CASE(1,3) { dest[0]=dest[1]=dest[2]=src[0];                                  } break;

-         STBI__CASE(1,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=255;                     } break;

-         STBI__CASE(2,1) { dest[0]=src[0];                                                  } break;

-         STBI__CASE(2,3) { dest[0]=dest[1]=dest[2]=src[0];                                  } break;

-         STBI__CASE(2,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=src[1];                  } break;

-         STBI__CASE(3,4) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2];dest[3]=255;        } break;

-         STBI__CASE(3,1) { dest[0]=stbi__compute_y(src[0],src[1],src[2]);                   } break;

-         STBI__CASE(3,2) { dest[0]=stbi__compute_y(src[0],src[1],src[2]); dest[1] = 255;    } break;

-         STBI__CASE(4,1) { dest[0]=stbi__compute_y(src[0],src[1],src[2]);                   } break;

-         STBI__CASE(4,2) { dest[0]=stbi__compute_y(src[0],src[1],src[2]); dest[1] = src[3]; } break;

-         STBI__CASE(4,3) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2];                    } break;

-         default: STBI_ASSERT(0);

-      }

-      #undef STBI__CASE

-   }

-

-   STBI_FREE(data);

-   return good;

-}

-

-static stbi__uint16 stbi__compute_y_16(int r, int g, int b)

-{

-   return (stbi__uint16) (((r*77) + (g*150) +  (29*b)) >> 8);

-}

-

-static stbi__uint16 *stbi__convert_format16(stbi__uint16 *data, int img_n, int req_comp, unsigned int x, unsigned int y)

-{

-   int i,j;

-   stbi__uint16 *good;

-

-   if (req_comp == img_n) return data;

-   STBI_ASSERT(req_comp >= 1 && req_comp <= 4);

-

-   good = (stbi__uint16 *) stbi__malloc(req_comp * x * y * 2);

-   if (good == NULL) {

-      STBI_FREE(data);

-      return (stbi__uint16 *) stbi__errpuc("outofmem", "Out of memory");

-   }

-

-   for (j=0; j < (int) y; ++j) {

-      stbi__uint16 *src  = data + j * x * img_n   ;

-      stbi__uint16 *dest = good + j * x * req_comp;

-

-      #define STBI__COMBO(a,b)  ((a)*8+(b))

-      #define STBI__CASE(a,b)   case STBI__COMBO(a,b): for(i=x-1; i >= 0; --i, src += a, dest += b)

-      // convert source image with img_n components to one with req_comp components;

-      // avoid switch per pixel, so use switch per scanline and massive macros

-      switch (STBI__COMBO(img_n, req_comp)) {

-         STBI__CASE(1,2) { dest[0]=src[0]; dest[1]=0xffff;                                     } break;

-         STBI__CASE(1,3) { dest[0]=dest[1]=dest[2]=src[0];                                     } break;

-         STBI__CASE(1,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=0xffff;                     } break;

-         STBI__CASE(2,1) { dest[0]=src[0];                                                     } break;

-         STBI__CASE(2,3) { dest[0]=dest[1]=dest[2]=src[0];                                     } break;

-         STBI__CASE(2,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=src[1];                     } break;

-         STBI__CASE(3,4) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2];dest[3]=0xffff;        } break;

-         STBI__CASE(3,1) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]);                   } break;

-         STBI__CASE(3,2) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]); dest[1] = 0xffff; } break;

-         STBI__CASE(4,1) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]);                   } break;

-         STBI__CASE(4,2) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]); dest[1] = src[3]; } break;

-         STBI__CASE(4,3) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2];                       } break;

-         default: STBI_ASSERT(0);

-      }

-      #undef STBI__CASE

-   }

-

-   STBI_FREE(data);

-   return good;

-}

-

-#ifndef STBI_NO_LINEAR

-static float   *stbi__ldr_to_hdr(stbi_uc *data, int x, int y, int comp)

-{

-   int i,k,n;

-   float *output;

-   if (!data) return NULL;

-   output = (float *) stbi__malloc_mad4(x, y, comp, sizeof(float), 0);

-   if (output == NULL) { STBI_FREE(data); return stbi__errpf("outofmem", "Out of memory"); }

-   // compute number of non-alpha components

-   if (comp & 1) n = comp; else n = comp-1;

-   for (i=0; i < x*y; ++i) {

-      for (k=0; k < n; ++k) {

-         output[i*comp + k] = (float) (pow(data[i*comp+k]/255.0f, stbi__l2h_gamma) * stbi__l2h_scale);

-      }

-   }

-   if (n < comp) {

-      for (i=0; i < x*y; ++i) {

-         output[i*comp + n] = data[i*comp + n]/255.0f;

-      }

-   }

-   STBI_FREE(data);

-   return output;

-}

-#endif

-

-#ifndef STBI_NO_HDR

-#define stbi__float2int(x)   ((int) (x))

-static stbi_uc *stbi__hdr_to_ldr(float   *data, int x, int y, int comp)

-{

-   int i,k,n;

-   stbi_uc *output;

-   if (!data) return NULL;

-   output = (stbi_uc *) stbi__malloc_mad3(x, y, comp, 0);

-   if (output == NULL) { STBI_FREE(data); return stbi__errpuc("outofmem", "Out of memory"); }

-   // compute number of non-alpha components

-   if (comp & 1) n = comp; else n = comp-1;

-   for (i=0; i < x*y; ++i) {

-      for (k=0; k < n; ++k) {

-         float z = (float) pow(data[i*comp+k]*stbi__h2l_scale_i, stbi__h2l_gamma_i) * 255 + 0.5f;

-         if (z < 0) z = 0;

-         if (z > 255) z = 255;

-         output[i*comp + k] = (stbi_uc) stbi__float2int(z);

-      }

-      if (k < comp) {

-         float z = data[i*comp+k] * 255 + 0.5f;

-         if (z < 0) z = 0;

-         if (z > 255) z = 255;

-         output[i*comp + k] = (stbi_uc) stbi__float2int(z);

-      }

-   }

-   STBI_FREE(data);

-   return output;

-}

-#endif

-

-//////////////////////////////////////////////////////////////////////////////

-//

-//  "baseline" JPEG/JFIF decoder

-//

-//    simple implementation

-//      - doesn't support delayed output of y-dimension

-//      - simple interface (only one output format: 8-bit interleaved RGB)

-//      - doesn't try to recover corrupt jpegs

-//      - doesn't allow partial loading, loading multiple at once

-//      - still fast on x86 (copying globals into locals doesn't help x86)

-//      - allocates lots of intermediate memory (full size of all components)

-//        - non-interleaved case requires this anyway

-//        - allows good upsampling (see next)

-//    high-quality

-//      - upsampled channels are bilinearly interpolated, even across blocks

-//      - quality integer IDCT derived from IJG's 'slow'

-//    performance

-//      - fast huffman; reasonable integer IDCT

-//      - some SIMD kernels for common paths on targets with SSE2/NEON

-//      - uses a lot of intermediate memory, could cache poorly

-

-#ifndef STBI_NO_JPEG

-

-// huffman decoding acceleration

-#define FAST_BITS   9  // larger handles more cases; smaller stomps less cache

-

-typedef struct

-{

-   stbi_uc  fast[1 << FAST_BITS];

-   // weirdly, repacking this into AoS is a 10% speed loss, instead of a win

-   stbi__uint16 code[256];

-   stbi_uc  values[256];

-   stbi_uc  size[257];

-   unsigned int maxcode[18];

-   int    delta[17];   // old 'firstsymbol' - old 'firstcode'

-} stbi__huffman;

-

-typedef struct

-{

-   stbi__context *s;

-   stbi__huffman huff_dc[4];

-   stbi__huffman huff_ac[4];

-   stbi__uint16 dequant[4][64];

-   stbi__int16 fast_ac[4][1 << FAST_BITS];

-

-// sizes for components, interleaved MCUs

-   int img_h_max, img_v_max;

-   int img_mcu_x, img_mcu_y;

-   int img_mcu_w, img_mcu_h;

-

-// definition of jpeg image component

-   struct

-   {

-      int id;

-      int h,v;

-      int tq;

-      int hd,ha;

-      int dc_pred;

-

-      int x,y,w2,h2;

-      stbi_uc *data;

-      void *raw_data, *raw_coeff;

-      stbi_uc *linebuf;

-      short   *coeff;   // progressive only

-      int      coeff_w, coeff_h; // number of 8x8 coefficient blocks

-   } img_comp[4];

-

-   stbi__uint32   code_buffer; // jpeg entropy-coded buffer

-   int            code_bits;   // number of valid bits

-   unsigned char  marker;      // marker seen while filling entropy buffer

-   int            nomore;      // flag if we saw a marker so must stop

-

-   int            progressive;

-   int            spec_start;

-   int            spec_end;

-   int            succ_high;

-   int            succ_low;

-   int            eob_run;

-   int            jfif;

-   int            app14_color_transform; // Adobe APP14 tag

-   int            rgb;

-

-   int scan_n, order[4];

-   int restart_interval, todo;

-

-// kernels

-   void (*idct_block_kernel)(stbi_uc *out, int out_stride, short data[64]);

-   void (*YCbCr_to_RGB_kernel)(stbi_uc *out, const stbi_uc *y, const stbi_uc *pcb, const stbi_uc *pcr, int count, int step);

-   stbi_uc *(*resample_row_hv_2_kernel)(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs);

-} stbi__jpeg;

-

-static int stbi__build_huffman(stbi__huffman *h, int *count)

-{

-   int i,j,k=0;

-   unsigned int code;

-   // build size list for each symbol (from JPEG spec)

-   for (i=0; i < 16; ++i)

-      for (j=0; j < count[i]; ++j)

-         h->size[k++] = (stbi_uc) (i+1);

-   h->size[k] = 0;

-

-   // compute actual symbols (from jpeg spec)

-   code = 0;

-   k = 0;

-   for(j=1; j <= 16; ++j) {

-      // compute delta to add to code to compute symbol id

-      h->delta[j] = k - code;

-      if (h->size[k] == j) {

-         while (h->size[k] == j)

-            h->code[k++] = (stbi__uint16) (code++);

-         if (code-1 >= (1u << j)) return stbi__err("bad code lengths","Corrupt JPEG");

-      }

-      // compute largest code + 1 for this size, preshifted as needed later

-      h->maxcode[j] = code << (16-j);

-      code <<= 1;

-   }

-   h->maxcode[j] = 0xffffffff;

-

-   // build non-spec acceleration table; 255 is flag for not-accelerated

-   memset(h->fast, 255, 1 << FAST_BITS);

-   for (i=0; i < k; ++i) {

-      int s = h->size[i];

-      if (s <= FAST_BITS) {

-         int c = h->code[i] << (FAST_BITS-s);

-         int m = 1 << (FAST_BITS-s);

-         for (j=0; j < m; ++j) {

-            h->fast[c+j] = (stbi_uc) i;

-         }

-      }

-   }

-   return 1;

-}

-

-// build a table that decodes both magnitude and value of small ACs in

-// one go.

-static void stbi__build_fast_ac(stbi__int16 *fast_ac, stbi__huffman *h)

-{

-   int i;

-   for (i=0; i < (1 << FAST_BITS); ++i) {

-      stbi_uc fast = h->fast[i];

-      fast_ac[i] = 0;

-      if (fast < 255) {

-         int rs = h->values[fast];

-         int run = (rs >> 4) & 15;

-         int magbits = rs & 15;

-         int len = h->size[fast];

-

-         if (magbits && len + magbits <= FAST_BITS) {

-            // magnitude code followed by receive_extend code

-            int k = ((i << len) & ((1 << FAST_BITS) - 1)) >> (FAST_BITS - magbits);

-            int m = 1 << (magbits - 1);

-            if (k < m) k += (~0U << magbits) + 1;

-            // if the result is small enough, we can fit it in fast_ac table

-            if (k >= -128 && k <= 127)

-               fast_ac[i] = (stbi__int16) ((k * 256) + (run * 16) + (len + magbits));

-         }

-      }

-   }

-}

-

-static void stbi__grow_buffer_unsafe(stbi__jpeg *j)

-{

-   do {

-      unsigned int b = j->nomore ? 0 : stbi__get8(j->s);

-      if (b == 0xff) {

-         int c = stbi__get8(j->s);

-         while (c == 0xff) c = stbi__get8(j->s); // consume fill bytes

-         if (c != 0) {

-            j->marker = (unsigned char) c;

-            j->nomore = 1;

-            return;

-         }

-      }

-      j->code_buffer |= b << (24 - j->code_bits);

-      j->code_bits += 8;

-   } while (j->code_bits <= 24);

-}

-

-// (1 << n) - 1

-static const stbi__uint32 stbi__bmask[17]={0,1,3,7,15,31,63,127,255,511,1023,2047,4095,8191,16383,32767,65535};

-

-// decode a jpeg huffman value from the bitstream

-stbi_inline static int stbi__jpeg_huff_decode(stbi__jpeg *j, stbi__huffman *h)

-{

-   unsigned int temp;

-   int c,k;

-

-   if (j->code_bits < 16) stbi__grow_buffer_unsafe(j);

-

-   // look at the top FAST_BITS and determine what symbol ID it is,

-   // if the code is <= FAST_BITS

-   c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS)-1);

-   k = h->fast[c];

-   if (k < 255) {

-      int s = h->size[k];

-      if (s > j->code_bits)

-         return -1;

-      j->code_buffer <<= s;

-      j->code_bits -= s;

-      return h->values[k];

-   }

-

-   // naive test is to shift the code_buffer down so k bits are

-   // valid, then test against maxcode. To speed this up, we've

-   // preshifted maxcode left so that it has (16-k) 0s at the

-   // end; in other words, regardless of the number of bits, it

-   // wants to be compared against something shifted to have 16;

-   // that way we don't need to shift inside the loop.

-   temp = j->code_buffer >> 16;

-   for (k=FAST_BITS+1 ; ; ++k)

-      if (temp < h->maxcode[k])

-         break;

-   if (k == 17) {

-      // error! code not found

-      j->code_bits -= 16;

-      return -1;

-   }

-

-   if (k > j->code_bits)

-      return -1;

-

-   // convert the huffman code to the symbol id

-   c = ((j->code_buffer >> (32 - k)) & stbi__bmask[k]) + h->delta[k];

-   STBI_ASSERT((((j->code_buffer) >> (32 - h->size[c])) & stbi__bmask[h->size[c]]) == h->code[c]);

-

-   // convert the id to a symbol

-   j->code_bits -= k;

-   j->code_buffer <<= k;

-   return h->values[c];

-}

-

-// bias[n] = (-1<<n) + 1

-static const int stbi__jbias[16] = {0,-1,-3,-7,-15,-31,-63,-127,-255,-511,-1023,-2047,-4095,-8191,-16383,-32767};

-

-// combined JPEG 'receive' and JPEG 'extend', since baseline

-// always extends everything it receives.

-stbi_inline static int stbi__extend_receive(stbi__jpeg *j, int n)

-{

-   unsigned int k;

-   int sgn;

-   if (j->code_bits < n) stbi__grow_buffer_unsafe(j);

-

-   sgn = (stbi__int32)j->code_buffer >> 31; // sign bit is always in MSB

-   k = stbi_lrot(j->code_buffer, n);

-   STBI_ASSERT(n >= 0 && n < (int) (sizeof(stbi__bmask)/sizeof(*stbi__bmask)));

-   j->code_buffer = k & ~stbi__bmask[n];

-   k &= stbi__bmask[n];

-   j->code_bits -= n;

-   return k + (stbi__jbias[n] & ~sgn);

-}

-

-// get some unsigned bits

-stbi_inline static int stbi__jpeg_get_bits(stbi__jpeg *j, int n)

-{

-   unsigned int k;

-   if (j->code_bits < n) stbi__grow_buffer_unsafe(j);

-   k = stbi_lrot(j->code_buffer, n);

-   j->code_buffer = k & ~stbi__bmask[n];

-   k &= stbi__bmask[n];

-   j->code_bits -= n;

-   return k;

-}

-

-stbi_inline static int stbi__jpeg_get_bit(stbi__jpeg *j)

-{

-   unsigned int k;

-   if (j->code_bits < 1) stbi__grow_buffer_unsafe(j);

-   k = j->code_buffer;

-   j->code_buffer <<= 1;

-   --j->code_bits;

-   return k & 0x80000000;

-}

-

-// given a value that's at position X in the zigzag stream,

-// where does it appear in the 8x8 matrix coded as row-major?

-static const stbi_uc stbi__jpeg_dezigzag[64+15] =

-{

-    0,  1,  8, 16,  9,  2,  3, 10,

-   17, 24, 32, 25, 18, 11,  4,  5,

-   12, 19, 26, 33, 40, 48, 41, 34,

-   27, 20, 13,  6,  7, 14, 21, 28,

-   35, 42, 49, 56, 57, 50, 43, 36,

-   29, 22, 15, 23, 30, 37, 44, 51,

-   58, 59, 52, 45, 38, 31, 39, 46,

-   53, 60, 61, 54, 47, 55, 62, 63,

-   // let corrupt input sample past end

-   63, 63, 63, 63, 63, 63, 63, 63,

-   63, 63, 63, 63, 63, 63, 63

-};

-

-// decode one 64-entry block--

-static int stbi__jpeg_decode_block(stbi__jpeg *j, short data[64], stbi__huffman *hdc, stbi__huffman *hac, stbi__int16 *fac, int b, stbi__uint16 *dequant)

-{

-   int diff,dc,k;

-   int t;

-

-   if (j->code_bits < 16) stbi__grow_buffer_unsafe(j);

-   t = stbi__jpeg_huff_decode(j, hdc);

-   if (t < 0) return stbi__err("bad huffman code","Corrupt JPEG");

-

-   // 0 all the ac values now so we can do it 32-bits at a time

-   memset(data,0,64*sizeof(data[0]));

-

-   diff = t ? stbi__extend_receive(j, t) : 0;

-   dc = j->img_comp[b].dc_pred + diff;

-   j->img_comp[b].dc_pred = dc;

-   data[0] = (short) (dc * dequant[0]);

-

-   // decode AC components, see JPEG spec

-   k = 1;

-   do {

-      unsigned int zig;

-      int c,r,s;

-      if (j->code_bits < 16) stbi__grow_buffer_unsafe(j);

-      c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS)-1);

-      r = fac[c];

-      if (r) { // fast-AC path

-         k += (r >> 4) & 15; // run

-         s = r & 15; // combined length

-         j->code_buffer <<= s;

-         j->code_bits -= s;

-         // decode into unzigzag'd location

-         zig = stbi__jpeg_dezigzag[k++];

-         data[zig] = (short) ((r >> 8) * dequant[zig]);

-      } else {

-         int rs = stbi__jpeg_huff_decode(j, hac);

-         if (rs < 0) return stbi__err("bad huffman code","Corrupt JPEG");

-         s = rs & 15;

-         r = rs >> 4;

-         if (s == 0) {

-            if (rs != 0xf0) break; // end block

-            k += 16;

-         } else {

-            k += r;

-            // decode into unzigzag'd location

-            zig = stbi__jpeg_dezigzag[k++];

-            data[zig] = (short) (stbi__extend_receive(j,s) * dequant[zig]);

-         }

-      }

-   } while (k < 64);

-   return 1;

-}

-

-static int stbi__jpeg_decode_block_prog_dc(stbi__jpeg *j, short data[64], stbi__huffman *hdc, int b)

-{

-   int diff,dc;

-   int t;

-   if (j->spec_end != 0) return stbi__err("can't merge dc and ac", "Corrupt JPEG");

-

-   if (j->code_bits < 16) stbi__grow_buffer_unsafe(j);

-

-   if (j->succ_high == 0) {

-      // first scan for DC coefficient, must be first

-      memset(data,0,64*sizeof(data[0])); // 0 all the ac values now

-      t = stbi__jpeg_huff_decode(j, hdc);

-      diff = t ? stbi__extend_receive(j, t) : 0;

-

-      dc = j->img_comp[b].dc_pred + diff;

-      j->img_comp[b].dc_pred = dc;

-      data[0] = (short) (dc << j->succ_low);

-   } else {

-      // refinement scan for DC coefficient

-      if (stbi__jpeg_get_bit(j))

-         data[0] += (short) (1 << j->succ_low);

-   }

-   return 1;

-}

-

-// @OPTIMIZE: store non-zigzagged during the decode passes,

-// and only de-zigzag when dequantizing

-static int stbi__jpeg_decode_block_prog_ac(stbi__jpeg *j, short data[64], stbi__huffman *hac, stbi__int16 *fac)

-{

-   int k;

-   if (j->spec_start == 0) return stbi__err("can't merge dc and ac", "Corrupt JPEG");

-

-   if (j->succ_high == 0) {

-      int shift = j->succ_low;

-

-      if (j->eob_run) {

-         --j->eob_run;

-         return 1;

-      }

-

-      k = j->spec_start;

-      do {

-         unsigned int zig;

-         int c,r,s;

-         if (j->code_bits < 16) stbi__grow_buffer_unsafe(j);

-         c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS)-1);

-         r = fac[c];

-         if (r) { // fast-AC path

-            k += (r >> 4) & 15; // run

-            s = r & 15; // combined length

-            j->code_buffer <<= s;

-            j->code_bits -= s;

-            zig = stbi__jpeg_dezigzag[k++];

-            data[zig] = (short) ((r >> 8) << shift);

-         } else {

-            int rs = stbi__jpeg_huff_decode(j, hac);

-            if (rs < 0) return stbi__err("bad huffman code","Corrupt JPEG");

-            s = rs & 15;

-            r = rs >> 4;

-            if (s == 0) {

-               if (r < 15) {

-                  j->eob_run = (1 << r);

-                  if (r)

-                     j->eob_run += stbi__jpeg_get_bits(j, r);

-                  --j->eob_run;

-                  break;

-               }

-               k += 16;

-            } else {

-               k += r;

-               zig = stbi__jpeg_dezigzag[k++];

-               data[zig] = (short) (stbi__extend_receive(j,s) << shift);

-            }

-         }

-      } while (k <= j->spec_end);

-   } else {

-      // refinement scan for these AC coefficients

-

-      short bit = (short) (1 << j->succ_low);

-

-      if (j->eob_run) {

-         --j->eob_run;

-         for (k = j->spec_start; k <= j->spec_end; ++k) {

-            short *p = &data[stbi__jpeg_dezigzag[k]];

-            if (*p != 0)

-               if (stbi__jpeg_get_bit(j))

-                  if ((*p & bit)==0) {

-                     if (*p > 0)

-                        *p += bit;

-                     else

-                        *p -= bit;

-                  }

-         }

-      } else {

-         k = j->spec_start;

-         do {

-            int r,s;

-            int rs = stbi__jpeg_huff_decode(j, hac); // @OPTIMIZE see if we can use the fast path here, advance-by-r is so slow, eh

-            if (rs < 0) return stbi__err("bad huffman code","Corrupt JPEG");

-            s = rs & 15;

-            r = rs >> 4;

-            if (s == 0) {

-               if (r < 15) {

-                  j->eob_run = (1 << r) - 1;

-                  if (r)

-                     j->eob_run += stbi__jpeg_get_bits(j, r);

-                  r = 64; // force end of block

-               } else {

-                  // r=15 s=0 should write 16 0s, so we just do

-                  // a run of 15 0s and then write s (which is 0),

-                  // so we don't have to do anything special here

-               }

-            } else {

-               if (s != 1) return stbi__err("bad huffman code", "Corrupt JPEG");

-               // sign bit

-               if (stbi__jpeg_get_bit(j))

-                  s = bit;

-               else

-                  s = -bit;

-            }

-

-            // advance by r

-            while (k <= j->spec_end) {

-               short *p = &data[stbi__jpeg_dezigzag[k++]];

-               if (*p != 0) {

-                  if (stbi__jpeg_get_bit(j))

-                     if ((*p & bit)==0) {

-                        if (*p > 0)

-                           *p += bit;

-                        else

-                           *p -= bit;

-                     }

-               } else {

-                  if (r == 0) {

-                     *p = (short) s;

-                     break;

-                  }

-                  --r;

-               }

-            }

-         } while (k <= j->spec_end);

-      }

-   }

-   return 1;

-}

-

-// take a -128..127 value and stbi__clamp it and convert to 0..255

-stbi_inline static stbi_uc stbi__clamp(int x)

-{

-   // trick to use a single test to catch both cases

-   if ((unsigned int) x > 255) {

-      if (x < 0) return 0;

-      if (x > 255) return 255;

-   }

-   return (stbi_uc) x;

-}

-

-#define stbi__f2f(x)  ((int) (((x) * 4096 + 0.5)))

-#define stbi__fsh(x)  ((x) * 4096)

-

-// derived from jidctint -- DCT_ISLOW

-#define STBI__IDCT_1D(s0,s1,s2,s3,s4,s5,s6,s7) \

-   int t0,t1,t2,t3,p1,p2,p3,p4,p5,x0,x1,x2,x3; \

-   p2 = s2;                                    \

-   p3 = s6;                                    \

-   p1 = (p2+p3) * stbi__f2f(0.5411961f);       \

-   t2 = p1 + p3*stbi__f2f(-1.847759065f);      \

-   t3 = p1 + p2*stbi__f2f( 0.765366865f);      \

-   p2 = s0;                                    \

-   p3 = s4;                                    \

-   t0 = stbi__fsh(p2+p3);                      \

-   t1 = stbi__fsh(p2-p3);                      \

-   x0 = t0+t3;                                 \

-   x3 = t0-t3;                                 \

-   x1 = t1+t2;                                 \

-   x2 = t1-t2;                                 \

-   t0 = s7;                                    \

-   t1 = s5;                                    \

-   t2 = s3;                                    \

-   t3 = s1;                                    \

-   p3 = t0+t2;                                 \

-   p4 = t1+t3;                                 \

-   p1 = t0+t3;                                 \

-   p2 = t1+t2;                                 \

-   p5 = (p3+p4)*stbi__f2f( 1.175875602f);      \

-   t0 = t0*stbi__f2f( 0.298631336f);           \

-   t1 = t1*stbi__f2f( 2.053119869f);           \

-   t2 = t2*stbi__f2f( 3.072711026f);           \

-   t3 = t3*stbi__f2f( 1.501321110f);           \

-   p1 = p5 + p1*stbi__f2f(-0.899976223f);      \

-   p2 = p5 + p2*stbi__f2f(-2.562915447f);      \

-   p3 = p3*stbi__f2f(-1.961570560f);           \

-   p4 = p4*stbi__f2f(-0.390180644f);           \

-   t3 += p1+p4;                                \

-   t2 += p2+p3;                                \

-   t1 += p2+p4;                                \

-   t0 += p1+p3;

-

-static void stbi__idct_block(stbi_uc *out, int out_stride, short data[64])

-{

-   int i,val[64],*v=val;

-   stbi_uc *o;

-   short *d = data;

-

-   // columns

-   for (i=0; i < 8; ++i,++d, ++v) {

-      // if all zeroes, shortcut -- this avoids dequantizing 0s and IDCTing

-      if (d[ 8]==0 && d[16]==0 && d[24]==0 && d[32]==0

-           && d[40]==0 && d[48]==0 && d[56]==0) {

-         //    no shortcut                 0     seconds

-         //    (1|2|3|4|5|6|7)==0          0     seconds

-         //    all separate               -0.047 seconds

-         //    1 && 2|3 && 4|5 && 6|7:    -0.047 seconds

-         int dcterm = d[0]*4;

-         v[0] = v[8] = v[16] = v[24] = v[32] = v[40] = v[48] = v[56] = dcterm;

-      } else {

-         STBI__IDCT_1D(d[ 0],d[ 8],d[16],d[24],d[32],d[40],d[48],d[56])

-         // constants scaled things up by 1<<12; let's bring them back

-         // down, but keep 2 extra bits of precision

-         x0 += 512; x1 += 512; x2 += 512; x3 += 512;

-         v[ 0] = (x0+t3) >> 10;

-         v[56] = (x0-t3) >> 10;

-         v[ 8] = (x1+t2) >> 10;

-         v[48] = (x1-t2) >> 10;

-         v[16] = (x2+t1) >> 10;

-         v[40] = (x2-t1) >> 10;

-         v[24] = (x3+t0) >> 10;

-         v[32] = (x3-t0) >> 10;

-      }

-   }

-

-   for (i=0, v=val, o=out; i < 8; ++i,v+=8,o+=out_stride) {

-      // no fast case since the first 1D IDCT spread components out

-      STBI__IDCT_1D(v[0],v[1],v[2],v[3],v[4],v[5],v[6],v[7])

-      // constants scaled things up by 1<<12, plus we had 1<<2 from first

-      // loop, plus horizontal and vertical each scale by sqrt(8) so together

-      // we've got an extra 1<<3, so 1<<17 total we need to remove.

-      // so we want to round that, which means adding 0.5 * 1<<17,

-      // aka 65536. Also, we'll end up with -128 to 127 that we want

-      // to encode as 0..255 by adding 128, so we'll add that before the shift

-      x0 += 65536 + (128<<17);

-      x1 += 65536 + (128<<17);

-      x2 += 65536 + (128<<17);

-      x3 += 65536 + (128<<17);

-      // tried computing the shifts into temps, or'ing the temps to see

-      // if any were out of range, but that was slower

-      o[0] = stbi__clamp((x0+t3) >> 17);

-      o[7] = stbi__clamp((x0-t3) >> 17);

-      o[1] = stbi__clamp((x1+t2) >> 17);

-      o[6] = stbi__clamp((x1-t2) >> 17);

-      o[2] = stbi__clamp((x2+t1) >> 17);

-      o[5] = stbi__clamp((x2-t1) >> 17);

-      o[3] = stbi__clamp((x3+t0) >> 17);

-      o[4] = stbi__clamp((x3-t0) >> 17);

-   }

-}

-

-#ifdef STBI_SSE2

-// sse2 integer IDCT. not the fastest possible implementation but it

-// produces bit-identical results to the generic C version so it's

-// fully "transparent".

-static void stbi__idct_simd(stbi_uc *out, int out_stride, short data[64])

-{

-   // This is constructed to match our regular (generic) integer IDCT exactly.

-   __m128i row0, row1, row2, row3, row4, row5, row6, row7;

-   __m128i tmp;

-

-   // dot product constant: even elems=x, odd elems=y

-   #define dct_const(x,y)  _mm_setr_epi16((x),(y),(x),(y),(x),(y),(x),(y))

-

-   // out(0) = c0[even]*x + c0[odd]*y   (c0, x, y 16-bit, out 32-bit)

-   // out(1) = c1[even]*x + c1[odd]*y

-   #define dct_rot(out0,out1, x,y,c0,c1) \

-      __m128i c0##lo = _mm_unpacklo_epi16((x),(y)); \

-      __m128i c0##hi = _mm_unpackhi_epi16((x),(y)); \

-      __m128i out0##_l = _mm_madd_epi16(c0##lo, c0); \

-      __m128i out0##_h = _mm_madd_epi16(c0##hi, c0); \

-      __m128i out1##_l = _mm_madd_epi16(c0##lo, c1); \

-      __m128i out1##_h = _mm_madd_epi16(c0##hi, c1)

-

-   // out = in << 12  (in 16-bit, out 32-bit)

-   #define dct_widen(out, in) \

-      __m128i out##_l = _mm_srai_epi32(_mm_unpacklo_epi16(_mm_setzero_si128(), (in)), 4); \

-      __m128i out##_h = _mm_srai_epi32(_mm_unpackhi_epi16(_mm_setzero_si128(), (in)), 4)

-

-   // wide add

-   #define dct_wadd(out, a, b) \

-      __m128i out##_l = _mm_add_epi32(a##_l, b##_l); \

-      __m128i out##_h = _mm_add_epi32(a##_h, b##_h)

-

-   // wide sub

-   #define dct_wsub(out, a, b) \

-      __m128i out##_l = _mm_sub_epi32(a##_l, b##_l); \

-      __m128i out##_h = _mm_sub_epi32(a##_h, b##_h)

-

-   // butterfly a/b, add bias, then shift by "s" and pack

-   #define dct_bfly32o(out0, out1, a,b,bias,s) \

-      { \

-         __m128i abiased_l = _mm_add_epi32(a##_l, bias); \

-         __m128i abiased_h = _mm_add_epi32(a##_h, bias); \

-         dct_wadd(sum, abiased, b); \

-         dct_wsub(dif, abiased, b); \

-         out0 = _mm_packs_epi32(_mm_srai_epi32(sum_l, s), _mm_srai_epi32(sum_h, s)); \

-         out1 = _mm_packs_epi32(_mm_srai_epi32(dif_l, s), _mm_srai_epi32(dif_h, s)); \

-      }

-

-   // 8-bit interleave step (for transposes)

-   #define dct_interleave8(a, b) \

-      tmp = a; \

-      a = _mm_unpacklo_epi8(a, b); \

-      b = _mm_unpackhi_epi8(tmp, b)

-

-   // 16-bit interleave step (for transposes)

-   #define dct_interleave16(a, b) \

-      tmp = a; \

-      a = _mm_unpacklo_epi16(a, b); \

-      b = _mm_unpackhi_epi16(tmp, b)

-

-   #define dct_pass(bias,shift) \

-      { \

-         /* even part */ \

-         dct_rot(t2e,t3e, row2,row6, rot0_0,rot0_1); \

-         __m128i sum04 = _mm_add_epi16(row0, row4); \

-         __m128i dif04 = _mm_sub_epi16(row0, row4); \

-         dct_widen(t0e, sum04); \

-         dct_widen(t1e, dif04); \

-         dct_wadd(x0, t0e, t3e); \

-         dct_wsub(x3, t0e, t3e); \

-         dct_wadd(x1, t1e, t2e); \

-         dct_wsub(x2, t1e, t2e); \

-         /* odd part */ \

-         dct_rot(y0o,y2o, row7,row3, rot2_0,rot2_1); \

-         dct_rot(y1o,y3o, row5,row1, rot3_0,rot3_1); \

-         __m128i sum17 = _mm_add_epi16(row1, row7); \

-         __m128i sum35 = _mm_add_epi16(row3, row5); \

-         dct_rot(y4o,y5o, sum17,sum35, rot1_0,rot1_1); \

-         dct_wadd(x4, y0o, y4o); \

-         dct_wadd(x5, y1o, y5o); \

-         dct_wadd(x6, y2o, y5o); \

-         dct_wadd(x7, y3o, y4o); \

-         dct_bfly32o(row0,row7, x0,x7,bias,shift); \

-         dct_bfly32o(row1,row6, x1,x6,bias,shift); \

-         dct_bfly32o(row2,row5, x2,x5,bias,shift); \

-         dct_bfly32o(row3,row4, x3,x4,bias,shift); \

-      }

-

-   __m128i rot0_0 = dct_const(stbi__f2f(0.5411961f), stbi__f2f(0.5411961f) + stbi__f2f(-1.847759065f));

-   __m128i rot0_1 = dct_const(stbi__f2f(0.5411961f) + stbi__f2f( 0.765366865f), stbi__f2f(0.5411961f));

-   __m128i rot1_0 = dct_const(stbi__f2f(1.175875602f) + stbi__f2f(-0.899976223f), stbi__f2f(1.175875602f));

-   __m128i rot1_1 = dct_const(stbi__f2f(1.175875602f), stbi__f2f(1.175875602f) + stbi__f2f(-2.562915447f));

-   __m128i rot2_0 = dct_const(stbi__f2f(-1.961570560f) + stbi__f2f( 0.298631336f), stbi__f2f(-1.961570560f));

-   __m128i rot2_1 = dct_const(stbi__f2f(-1.961570560f), stbi__f2f(-1.961570560f) + stbi__f2f( 3.072711026f));

-   __m128i rot3_0 = dct_const(stbi__f2f(-0.390180644f) + stbi__f2f( 2.053119869f), stbi__f2f(-0.390180644f));

-   __m128i rot3_1 = dct_const(stbi__f2f(-0.390180644f), stbi__f2f(-0.390180644f) + stbi__f2f( 1.501321110f));

-

-   // rounding biases in column/row passes, see stbi__idct_block for explanation.

-   __m128i bias_0 = _mm_set1_epi32(512);

-   __m128i bias_1 = _mm_set1_epi32(65536 + (128<<17));

-

-   // load

-   row0 = _mm_load_si128((const __m128i *) (data + 0*8));

-   row1 = _mm_load_si128((const __m128i *) (data + 1*8));

-   row2 = _mm_load_si128((const __m128i *) (data + 2*8));

-   row3 = _mm_load_si128((const __m128i *) (data + 3*8));

-   row4 = _mm_load_si128((const __m128i *) (data + 4*8));

-   row5 = _mm_load_si128((const __m128i *) (data + 5*8));

-   row6 = _mm_load_si128((const __m128i *) (data + 6*8));

-   row7 = _mm_load_si128((const __m128i *) (data + 7*8));

-

-   // column pass

-   dct_pass(bias_0, 10);

-

-   {

-      // 16bit 8x8 transpose pass 1

-      dct_interleave16(row0, row4);

-      dct_interleave16(row1, row5);

-      dct_interleave16(row2, row6);

-      dct_interleave16(row3, row7);

-

-      // transpose pass 2

-      dct_interleave16(row0, row2);

-      dct_interleave16(row1, row3);

-      dct_interleave16(row4, row6);

-      dct_interleave16(row5, row7);

-

-      // transpose pass 3

-      dct_interleave16(row0, row1);

-      dct_interleave16(row2, row3);

-      dct_interleave16(row4, row5);

-      dct_interleave16(row6, row7);

-   }

-

-   // row pass

-   dct_pass(bias_1, 17);

-

-   {

-      // pack

-      __m128i p0 = _mm_packus_epi16(row0, row1); // a0a1a2a3...a7b0b1b2b3...b7

-      __m128i p1 = _mm_packus_epi16(row2, row3);

-      __m128i p2 = _mm_packus_epi16(row4, row5);

-      __m128i p3 = _mm_packus_epi16(row6, row7);

-

-      // 8bit 8x8 transpose pass 1

-      dct_interleave8(p0, p2); // a0e0a1e1...

-      dct_interleave8(p1, p3); // c0g0c1g1...

-

-      // transpose pass 2

-      dct_interleave8(p0, p1); // a0c0e0g0...

-      dct_interleave8(p2, p3); // b0d0f0h0...

-

-      // transpose pass 3

-      dct_interleave8(p0, p2); // a0b0c0d0...

-      dct_interleave8(p1, p3); // a4b4c4d4...

-

-      // store

-      _mm_storel_epi64((__m128i *) out, p0); out += out_stride;

-      _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p0, 0x4e)); out += out_stride;

-      _mm_storel_epi64((__m128i *) out, p2); out += out_stride;

-      _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p2, 0x4e)); out += out_stride;

-      _mm_storel_epi64((__m128i *) out, p1); out += out_stride;

-      _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p1, 0x4e)); out += out_stride;

-      _mm_storel_epi64((__m128i *) out, p3); out += out_stride;

-      _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p3, 0x4e));

-   }

-

-#undef dct_const

-#undef dct_rot

-#undef dct_widen

-#undef dct_wadd

-#undef dct_wsub

-#undef dct_bfly32o

-#undef dct_interleave8

-#undef dct_interleave16

-#undef dct_pass

-}

-

-#endif // STBI_SSE2

-

-#ifdef STBI_NEON

-

-// NEON integer IDCT. should produce bit-identical

-// results to the generic C version.

-static void stbi__idct_simd(stbi_uc *out, int out_stride, short data[64])

-{

-   int16x8_t row0, row1, row2, row3, row4, row5, row6, row7;

-

-   int16x4_t rot0_0 = vdup_n_s16(stbi__f2f(0.5411961f));

-   int16x4_t rot0_1 = vdup_n_s16(stbi__f2f(-1.847759065f));

-   int16x4_t rot0_2 = vdup_n_s16(stbi__f2f( 0.765366865f));

-   int16x4_t rot1_0 = vdup_n_s16(stbi__f2f( 1.175875602f));

-   int16x4_t rot1_1 = vdup_n_s16(stbi__f2f(-0.899976223f));

-   int16x4_t rot1_2 = vdup_n_s16(stbi__f2f(-2.562915447f));

-   int16x4_t rot2_0 = vdup_n_s16(stbi__f2f(-1.961570560f));

-   int16x4_t rot2_1 = vdup_n_s16(stbi__f2f(-0.390180644f));

-   int16x4_t rot3_0 = vdup_n_s16(stbi__f2f( 0.298631336f));

-   int16x4_t rot3_1 = vdup_n_s16(stbi__f2f( 2.053119869f));

-   int16x4_t rot3_2 = vdup_n_s16(stbi__f2f( 3.072711026f));

-   int16x4_t rot3_3 = vdup_n_s16(stbi__f2f( 1.501321110f));

-

-#define dct_long_mul(out, inq, coeff) \

-   int32x4_t out##_l = vmull_s16(vget_low_s16(inq), coeff); \

-   int32x4_t out##_h = vmull_s16(vget_high_s16(inq), coeff)

-

-#define dct_long_mac(out, acc, inq, coeff) \

-   int32x4_t out##_l = vmlal_s16(acc##_l, vget_low_s16(inq), coeff); \

-   int32x4_t out##_h = vmlal_s16(acc##_h, vget_high_s16(inq), coeff)

-

-#define dct_widen(out, inq) \

-   int32x4_t out##_l = vshll_n_s16(vget_low_s16(inq), 12); \

-   int32x4_t out##_h = vshll_n_s16(vget_high_s16(inq), 12)

-

-// wide add

-#define dct_wadd(out, a, b) \

-   int32x4_t out##_l = vaddq_s32(a##_l, b##_l); \

-   int32x4_t out##_h = vaddq_s32(a##_h, b##_h)

-

-// wide sub

-#define dct_wsub(out, a, b) \

-   int32x4_t out##_l = vsubq_s32(a##_l, b##_l); \

-   int32x4_t out##_h = vsubq_s32(a##_h, b##_h)

-

-// butterfly a/b, then shift using "shiftop" by "s" and pack

-#define dct_bfly32o(out0,out1, a,b,shiftop,s) \

-   { \

-      dct_wadd(sum, a, b); \

-      dct_wsub(dif, a, b); \

-      out0 = vcombine_s16(shiftop(sum_l, s), shiftop(sum_h, s)); \

-      out1 = vcombine_s16(shiftop(dif_l, s), shiftop(dif_h, s)); \

-   }

-

-#define dct_pass(shiftop, shift) \

-   { \

-      /* even part */ \

-      int16x8_t sum26 = vaddq_s16(row2, row6); \

-      dct_long_mul(p1e, sum26, rot0_0); \

-      dct_long_mac(t2e, p1e, row6, rot0_1); \

-      dct_long_mac(t3e, p1e, row2, rot0_2); \

-      int16x8_t sum04 = vaddq_s16(row0, row4); \

-      int16x8_t dif04 = vsubq_s16(row0, row4); \

-      dct_widen(t0e, sum04); \

-      dct_widen(t1e, dif04); \

-      dct_wadd(x0, t0e, t3e); \

-      dct_wsub(x3, t0e, t3e); \

-      dct_wadd(x1, t1e, t2e); \

-      dct_wsub(x2, t1e, t2e); \

-      /* odd part */ \

-      int16x8_t sum15 = vaddq_s16(row1, row5); \

-      int16x8_t sum17 = vaddq_s16(row1, row7); \

-      int16x8_t sum35 = vaddq_s16(row3, row5); \

-      int16x8_t sum37 = vaddq_s16(row3, row7); \

-      int16x8_t sumodd = vaddq_s16(sum17, sum35); \

-      dct_long_mul(p5o, sumodd, rot1_0); \

-      dct_long_mac(p1o, p5o, sum17, rot1_1); \

-      dct_long_mac(p2o, p5o, sum35, rot1_2); \

-      dct_long_mul(p3o, sum37, rot2_0); \

-      dct_long_mul(p4o, sum15, rot2_1); \

-      dct_wadd(sump13o, p1o, p3o); \

-      dct_wadd(sump24o, p2o, p4o); \

-      dct_wadd(sump23o, p2o, p3o); \

-      dct_wadd(sump14o, p1o, p4o); \

-      dct_long_mac(x4, sump13o, row7, rot3_0); \

-      dct_long_mac(x5, sump24o, row5, rot3_1); \

-      dct_long_mac(x6, sump23o, row3, rot3_2); \

-      dct_long_mac(x7, sump14o, row1, rot3_3); \

-      dct_bfly32o(row0,row7, x0,x7,shiftop,shift); \

-      dct_bfly32o(row1,row6, x1,x6,shiftop,shift); \

-      dct_bfly32o(row2,row5, x2,x5,shiftop,shift); \

-      dct_bfly32o(row3,row4, x3,x4,shiftop,shift); \

-   }

-

-   // load

-   row0 = vld1q_s16(data + 0*8);

-   row1 = vld1q_s16(data + 1*8);

-   row2 = vld1q_s16(data + 2*8);

-   row3 = vld1q_s16(data + 3*8);

-   row4 = vld1q_s16(data + 4*8);

-   row5 = vld1q_s16(data + 5*8);

-   row6 = vld1q_s16(data + 6*8);

-   row7 = vld1q_s16(data + 7*8);

-

-   // add DC bias

-   row0 = vaddq_s16(row0, vsetq_lane_s16(1024, vdupq_n_s16(0), 0));

-

-   // column pass

-   dct_pass(vrshrn_n_s32, 10);

-

-   // 16bit 8x8 transpose

-   {

-// these three map to a single VTRN.16, VTRN.32, and VSWP, respectively.

-// whether compilers actually get this is another story, sadly.

-#define dct_trn16(x, y) { int16x8x2_t t = vtrnq_s16(x, y); x = t.val[0]; y = t.val[1]; }

-#define dct_trn32(x, y) { int32x4x2_t t = vtrnq_s32(vreinterpretq_s32_s16(x), vreinterpretq_s32_s16(y)); x = vreinterpretq_s16_s32(t.val[0]); y = vreinterpretq_s16_s32(t.val[1]); }

-#define dct_trn64(x, y) { int16x8_t x0 = x; int16x8_t y0 = y; x = vcombine_s16(vget_low_s16(x0), vget_low_s16(y0)); y = vcombine_s16(vget_high_s16(x0), vget_high_s16(y0)); }

-

-      // pass 1

-      dct_trn16(row0, row1); // a0b0a2b2a4b4a6b6

-      dct_trn16(row2, row3);

-      dct_trn16(row4, row5);

-      dct_trn16(row6, row7);

-

-      // pass 2

-      dct_trn32(row0, row2); // a0b0c0d0a4b4c4d4

-      dct_trn32(row1, row3);

-      dct_trn32(row4, row6);

-      dct_trn32(row5, row7);

-

-      // pass 3

-      dct_trn64(row0, row4); // a0b0c0d0e0f0g0h0

-      dct_trn64(row1, row5);

-      dct_trn64(row2, row6);

-      dct_trn64(row3, row7);

-

-#undef dct_trn16

-#undef dct_trn32

-#undef dct_trn64

-   }

-

-   // row pass

-   // vrshrn_n_s32 only supports shifts up to 16, we need

-   // 17. so do a non-rounding shift of 16 first then follow

-   // up with a rounding shift by 1.

-   dct_pass(vshrn_n_s32, 16);

-

-   {

-      // pack and round

-      uint8x8_t p0 = vqrshrun_n_s16(row0, 1);

-      uint8x8_t p1 = vqrshrun_n_s16(row1, 1);

-      uint8x8_t p2 = vqrshrun_n_s16(row2, 1);

-      uint8x8_t p3 = vqrshrun_n_s16(row3, 1);

-      uint8x8_t p4 = vqrshrun_n_s16(row4, 1);

-      uint8x8_t p5 = vqrshrun_n_s16(row5, 1);

-      uint8x8_t p6 = vqrshrun_n_s16(row6, 1);

-      uint8x8_t p7 = vqrshrun_n_s16(row7, 1);

-

-      // again, these can translate into one instruction, but often don't.

-#define dct_trn8_8(x, y) { uint8x8x2_t t = vtrn_u8(x, y); x = t.val[0]; y = t.val[1]; }

-#define dct_trn8_16(x, y) { uint16x4x2_t t = vtrn_u16(vreinterpret_u16_u8(x), vreinterpret_u16_u8(y)); x = vreinterpret_u8_u16(t.val[0]); y = vreinterpret_u8_u16(t.val[1]); }

-#define dct_trn8_32(x, y) { uint32x2x2_t t = vtrn_u32(vreinterpret_u32_u8(x), vreinterpret_u32_u8(y)); x = vreinterpret_u8_u32(t.val[0]); y = vreinterpret_u8_u32(t.val[1]); }

-

-      // sadly can't use interleaved stores here since we only write

-      // 8 bytes to each scan line!

-

-      // 8x8 8-bit transpose pass 1

-      dct_trn8_8(p0, p1);

-      dct_trn8_8(p2, p3);

-      dct_trn8_8(p4, p5);

-      dct_trn8_8(p6, p7);

-

-      // pass 2

-      dct_trn8_16(p0, p2);

-      dct_trn8_16(p1, p3);

-      dct_trn8_16(p4, p6);

-      dct_trn8_16(p5, p7);

-

-      // pass 3

-      dct_trn8_32(p0, p4);

-      dct_trn8_32(p1, p5);

-      dct_trn8_32(p2, p6);

-      dct_trn8_32(p3, p7);

-

-      // store

-      vst1_u8(out, p0); out += out_stride;

-      vst1_u8(out, p1); out += out_stride;

-      vst1_u8(out, p2); out += out_stride;

-      vst1_u8(out, p3); out += out_stride;

-      vst1_u8(out, p4); out += out_stride;

-      vst1_u8(out, p5); out += out_stride;

-      vst1_u8(out, p6); out += out_stride;

-      vst1_u8(out, p7);

-

-#undef dct_trn8_8

-#undef dct_trn8_16

-#undef dct_trn8_32

-   }

-

-#undef dct_long_mul

-#undef dct_long_mac

-#undef dct_widen

-#undef dct_wadd

-#undef dct_wsub

-#undef dct_bfly32o

-#undef dct_pass

-}

-

-#endif // STBI_NEON

-

-#define STBI__MARKER_none  0xff

-// if there's a pending marker from the entropy stream, return that

-// otherwise, fetch from the stream and get a marker. if there's no

-// marker, return 0xff, which is never a valid marker value

-static stbi_uc stbi__get_marker(stbi__jpeg *j)

-{

-   stbi_uc x;

-   if (j->marker != STBI__MARKER_none) { x = j->marker; j->marker = STBI__MARKER_none; return x; }

-   x = stbi__get8(j->s);

-   if (x != 0xff) return STBI__MARKER_none;

-   while (x == 0xff)

-      x = stbi__get8(j->s); // consume repeated 0xff fill bytes

-   return x;

-}

-

-// in each scan, we'll have scan_n components, and the order

-// of the components is specified by order[]

-#define STBI__RESTART(x)     ((x) >= 0xd0 && (x) <= 0xd7)

-

-// after a restart interval, stbi__jpeg_reset the entropy decoder and

-// the dc prediction

-static void stbi__jpeg_reset(stbi__jpeg *j)

-{

-   j->code_bits = 0;

-   j->code_buffer = 0;

-   j->nomore = 0;

-   j->img_comp[0].dc_pred = j->img_comp[1].dc_pred = j->img_comp[2].dc_pred = j->img_comp[3].dc_pred = 0;

-   j->marker = STBI__MARKER_none;

-   j->todo = j->restart_interval ? j->restart_interval : 0x7fffffff;

-   j->eob_run = 0;

-   // no more than 1<<31 MCUs if no restart_interal? that's plenty safe,

-   // since we don't even allow 1<<30 pixels

-}

-

-static int stbi__parse_entropy_coded_data(stbi__jpeg *z)

-{

-   stbi__jpeg_reset(z);

-   if (!z->progressive) {

-      if (z->scan_n == 1) {

-         int i,j;

-         STBI_SIMD_ALIGN(short, data[64]);

-         int n = z->order[0];

-         // non-interleaved data, we just need to process one block at a time,

-         // in trivial scanline order

-         // number of blocks to do just depends on how many actual "pixels" this

-         // component has, independent of interleaved MCU blocking and such

-         int w = (z->img_comp[n].x+7) >> 3;

-         int h = (z->img_comp[n].y+7) >> 3;

-         for (j=0; j < h; ++j) {

-            for (i=0; i < w; ++i) {

-               int ha = z->img_comp[n].ha;

-               if (!stbi__jpeg_decode_block(z, data, z->huff_dc+z->img_comp[n].hd, z->huff_ac+ha, z->fast_ac[ha], n, z->dequant[z->img_comp[n].tq])) return 0;

-               z->idct_block_kernel(z->img_comp[n].data+z->img_comp[n].w2*j*8+i*8, z->img_comp[n].w2, data);

-               // every data block is an MCU, so countdown the restart interval

-               if (--z->todo <= 0) {

-                  if (z->code_bits < 24) stbi__grow_buffer_unsafe(z);

-                  // if it's NOT a restart, then just bail, so we get corrupt data

-                  // rather than no data

-                  if (!STBI__RESTART(z->marker)) return 1;

-                  stbi__jpeg_reset(z);

-               }

-            }

-         }

-         return 1;

-      } else { // interleaved

-         int i,j,k,x,y;

-         STBI_SIMD_ALIGN(short, data[64]);

-         for (j=0; j < z->img_mcu_y; ++j) {

-            for (i=0; i < z->img_mcu_x; ++i) {

-               // scan an interleaved mcu... process scan_n components in order

-               for (k=0; k < z->scan_n; ++k) {

-                  int n = z->order[k];

-                  // scan out an mcu's worth of this component; that's just determined

-                  // by the basic H and V specified for the component

-                  for (y=0; y < z->img_comp[n].v; ++y) {

-                     for (x=0; x < z->img_comp[n].h; ++x) {

-                        int x2 = (i*z->img_comp[n].h + x)*8;

-                        int y2 = (j*z->img_comp[n].v + y)*8;

-                        int ha = z->img_comp[n].ha;

-                        if (!stbi__jpeg_decode_block(z, data, z->huff_dc+z->img_comp[n].hd, z->huff_ac+ha, z->fast_ac[ha], n, z->dequant[z->img_comp[n].tq])) return 0;

-                        z->idct_block_kernel(z->img_comp[n].data+z->img_comp[n].w2*y2+x2, z->img_comp[n].w2, data);

-                     }

-                  }

-               }

-               // after all interleaved components, that's an interleaved MCU,

-               // so now count down the restart interval

-               if (--z->todo <= 0) {

-                  if (z->code_bits < 24) stbi__grow_buffer_unsafe(z);

-                  if (!STBI__RESTART(z->marker)) return 1;

-                  stbi__jpeg_reset(z);

-               }

-            }

-         }

-         return 1;

-      }

-   } else {

-      if (z->scan_n == 1) {

-         int i,j;

-         int n = z->order[0];

-         // non-interleaved data, we just need to process one block at a time,

-         // in trivial scanline order

-         // number of blocks to do just depends on how many actual "pixels" this

-         // component has, independent of interleaved MCU blocking and such

-         int w = (z->img_comp[n].x+7) >> 3;

-         int h = (z->img_comp[n].y+7) >> 3;

-         for (j=0; j < h; ++j) {

-            for (i=0; i < w; ++i) {

-               short *data = z->img_comp[n].coeff + 64 * (i + j * z->img_comp[n].coeff_w);

-               if (z->spec_start == 0) {

-                  if (!stbi__jpeg_decode_block_prog_dc(z, data, &z->huff_dc[z->img_comp[n].hd], n))

-                     return 0;

-               } else {

-                  int ha = z->img_comp[n].ha;

-                  if (!stbi__jpeg_decode_block_prog_ac(z, data, &z->huff_ac[ha], z->fast_ac[ha]))

-                     return 0;

-               }

-               // every data block is an MCU, so countdown the restart interval

-               if (--z->todo <= 0) {

-                  if (z->code_bits < 24) stbi__grow_buffer_unsafe(z);

-                  if (!STBI__RESTART(z->marker)) return 1;

-                  stbi__jpeg_reset(z);

-               }

-            }

-         }

-         return 1;

-      } else { // interleaved

-         int i,j,k,x,y;

-         for (j=0; j < z->img_mcu_y; ++j) {

-            for (i=0; i < z->img_mcu_x; ++i) {

-               // scan an interleaved mcu... process scan_n components in order

-               for (k=0; k < z->scan_n; ++k) {

-                  int n = z->order[k];

-                  // scan out an mcu's worth of this component; that's just determined

-                  // by the basic H and V specified for the component

-                  for (y=0; y < z->img_comp[n].v; ++y) {

-                     for (x=0; x < z->img_comp[n].h; ++x) {

-                        int x2 = (i*z->img_comp[n].h + x);

-                        int y2 = (j*z->img_comp[n].v + y);

-                        short *data = z->img_comp[n].coeff + 64 * (x2 + y2 * z->img_comp[n].coeff_w);

-                        if (!stbi__jpeg_decode_block_prog_dc(z, data, &z->huff_dc[z->img_comp[n].hd], n))

-                           return 0;

-                     }

-                  }

-               }

-               // after all interleaved components, that's an interleaved MCU,

-               // so now count down the restart interval

-               if (--z->todo <= 0) {

-                  if (z->code_bits < 24) stbi__grow_buffer_unsafe(z);

-                  if (!STBI__RESTART(z->marker)) return 1;

-                  stbi__jpeg_reset(z);

-               }

-            }

-         }

-         return 1;

-      }

-   }

-}

-

-static void stbi__jpeg_dequantize(short *data, stbi__uint16 *dequant)

-{

-   int i;

-   for (i=0; i < 64; ++i)

-      data[i] *= dequant[i];

-}

-

-static void stbi__jpeg_finish(stbi__jpeg *z)

-{

-   if (z->progressive) {

-      // dequantize and idct the data

-      int i,j,n;

-      for (n=0; n < z->s->img_n; ++n) {

-         int w = (z->img_comp[n].x+7) >> 3;

-         int h = (z->img_comp[n].y+7) >> 3;

-         for (j=0; j < h; ++j) {

-            for (i=0; i < w; ++i) {

-               short *data = z->img_comp[n].coeff + 64 * (i + j * z->img_comp[n].coeff_w);

-               stbi__jpeg_dequantize(data, z->dequant[z->img_comp[n].tq]);

-               z->idct_block_kernel(z->img_comp[n].data+z->img_comp[n].w2*j*8+i*8, z->img_comp[n].w2, data);

-            }

-         }

-      }

-   }

-}

-

-static int stbi__process_marker(stbi__jpeg *z, int m)

-{

-   int L;

-   switch (m) {

-      case STBI__MARKER_none: // no marker found

-         return stbi__err("expected marker","Corrupt JPEG");

-

-      case 0xDD: // DRI - specify restart interval

-         if (stbi__get16be(z->s) != 4) return stbi__err("bad DRI len","Corrupt JPEG");

-         z->restart_interval = stbi__get16be(z->s);

-         return 1;

-

-      case 0xDB: // DQT - define quantization table

-         L = stbi__get16be(z->s)-2;

-         while (L > 0) {

-            int q = stbi__get8(z->s);

-            int p = q >> 4, sixteen = (p != 0);

-            int t = q & 15,i;

-            if (p != 0 && p != 1) return stbi__err("bad DQT type","Corrupt JPEG");

-            if (t > 3) return stbi__err("bad DQT table","Corrupt JPEG");

-

-            for (i=0; i < 64; ++i)

-               z->dequant[t][stbi__jpeg_dezigzag[i]] = (stbi__uint16)(sixteen ? stbi__get16be(z->s) : stbi__get8(z->s));

-            L -= (sixteen ? 129 : 65);

-         }

-         return L==0;

-

-      case 0xC4: // DHT - define huffman table

-         L = stbi__get16be(z->s)-2;

-         while (L > 0) {

-            stbi_uc *v;

-            int sizes[16],i,n=0;

-            int q = stbi__get8(z->s);

-            int tc = q >> 4;

-            int th = q & 15;

-            if (tc > 1 || th > 3) return stbi__err("bad DHT header","Corrupt JPEG");

-            for (i=0; i < 16; ++i) {

-               sizes[i] = stbi__get8(z->s);

-               n += sizes[i];

-            }

-            L -= 17;

-            if (tc == 0) {

-               if (!stbi__build_huffman(z->huff_dc+th, sizes)) return 0;

-               v = z->huff_dc[th].values;

-            } else {

-               if (!stbi__build_huffman(z->huff_ac+th, sizes)) return 0;

-               v = z->huff_ac[th].values;

-            }

-            for (i=0; i < n; ++i)

-               v[i] = stbi__get8(z->s);

-            if (tc != 0)

-               stbi__build_fast_ac(z->fast_ac[th], z->huff_ac + th);

-            L -= n;

-         }

-         return L==0;

-   }

-

-   // check for comment block or APP blocks

-   if ((m >= 0xE0 && m <= 0xEF) || m == 0xFE) {

-      L = stbi__get16be(z->s);

-      if (L < 2) {

-         if (m == 0xFE)

-            return stbi__err("bad COM len","Corrupt JPEG");

-         else

-            return stbi__err("bad APP len","Corrupt JPEG");

-      }

-      L -= 2;

-

-      if (m == 0xE0 && L >= 5) { // JFIF APP0 segment

-         static const unsigned char tag[5] = {'J','F','I','F','\0'};

-         int ok = 1;

-         int i;

-         for (i=0; i < 5; ++i)

-            if (stbi__get8(z->s) != tag[i])

-               ok = 0;

-         L -= 5;

-         if (ok)

-            z->jfif = 1;

-      } else if (m == 0xEE && L >= 12) { // Adobe APP14 segment

-         static const unsigned char tag[6] = {'A','d','o','b','e','\0'};

-         int ok = 1;

-         int i;

-         for (i=0; i < 6; ++i)

-            if (stbi__get8(z->s) != tag[i])

-               ok = 0;

-         L -= 6;

-         if (ok) {

-            stbi__get8(z->s); // version

-            stbi__get16be(z->s); // flags0

-            stbi__get16be(z->s); // flags1

-            z->app14_color_transform = stbi__get8(z->s); // color transform

-            L -= 6;

-         }

-      }

-

-      stbi__skip(z->s, L);

-      return 1;

-   }

-

-   return stbi__err("unknown marker","Corrupt JPEG");

-}

-

-// after we see SOS

-static int stbi__process_scan_header(stbi__jpeg *z)

-{

-   int i;

-   int Ls = stbi__get16be(z->s);

-   z->scan_n = stbi__get8(z->s);

-   if (z->scan_n < 1 || z->scan_n > 4 || z->scan_n > (int) z->s->img_n) return stbi__err("bad SOS component count","Corrupt JPEG");

-   if (Ls != 6+2*z->scan_n) return stbi__err("bad SOS len","Corrupt JPEG");

-   for (i=0; i < z->scan_n; ++i) {

-      int id = stbi__get8(z->s), which;

-      int q = stbi__get8(z->s);

-      for (which = 0; which < z->s->img_n; ++which)

-         if (z->img_comp[which].id == id)

-            break;

-      if (which == z->s->img_n) return 0; // no match

-      z->img_comp[which].hd = q >> 4;   if (z->img_comp[which].hd > 3) return stbi__err("bad DC huff","Corrupt JPEG");

-      z->img_comp[which].ha = q & 15;   if (z->img_comp[which].ha > 3) return stbi__err("bad AC huff","Corrupt JPEG");

-      z->order[i] = which;

-   }

-

-   {

-      int aa;

-      z->spec_start = stbi__get8(z->s);

-      z->spec_end   = stbi__get8(z->s); // should be 63, but might be 0

-      aa = stbi__get8(z->s);

-      z->succ_high = (aa >> 4);

-      z->succ_low  = (aa & 15);

-      if (z->progressive) {

-         if (z->spec_start > 63 || z->spec_end > 63  || z->spec_start > z->spec_end || z->succ_high > 13 || z->succ_low > 13)

-            return stbi__err("bad SOS", "Corrupt JPEG");

-      } else {

-         if (z->spec_start != 0) return stbi__err("bad SOS","Corrupt JPEG");

-         if (z->succ_high != 0 || z->succ_low != 0) return stbi__err("bad SOS","Corrupt JPEG");

-         z->spec_end = 63;

-      }

-   }

-

-   return 1;

-}

-

-static int stbi__free_jpeg_components(stbi__jpeg *z, int ncomp, int why)

-{

-   int i;

-   for (i=0; i < ncomp; ++i) {

-      if (z->img_comp[i].raw_data) {

-         STBI_FREE(z->img_comp[i].raw_data);

-         z->img_comp[i].raw_data = NULL;

-         z->img_comp[i].data = NULL;

-      }

-      if (z->img_comp[i].raw_coeff) {

-         STBI_FREE(z->img_comp[i].raw_coeff);

-         z->img_comp[i].raw_coeff = 0;

-         z->img_comp[i].coeff = 0;

-      }

-      if (z->img_comp[i].linebuf) {

-         STBI_FREE(z->img_comp[i].linebuf);

-         z->img_comp[i].linebuf = NULL;

-      }

-   }

-   return why;

-}

-

-static int stbi__process_frame_header(stbi__jpeg *z, int scan)

-{

-   stbi__context *s = z->s;

-   int Lf,p,i,q, h_max=1,v_max=1,c;

-   Lf = stbi__get16be(s);         if (Lf < 11) return stbi__err("bad SOF len","Corrupt JPEG"); // JPEG

-   p  = stbi__get8(s);            if (p != 8) return stbi__err("only 8-bit","JPEG format not supported: 8-bit only"); // JPEG baseline

-   s->img_y = stbi__get16be(s);   if (s->img_y == 0) return stbi__err("no header height", "JPEG format not supported: delayed height"); // Legal, but we don't handle it--but neither does IJG

-   s->img_x = stbi__get16be(s);   if (s->img_x == 0) return stbi__err("0 width","Corrupt JPEG"); // JPEG requires

-   c = stbi__get8(s);

-   if (c != 3 && c != 1 && c != 4) return stbi__err("bad component count","Corrupt JPEG");

-   s->img_n = c;

-   for (i=0; i < c; ++i) {

-      z->img_comp[i].data = NULL;

-      z->img_comp[i].linebuf = NULL;

-   }

-

-   if (Lf != 8+3*s->img_n) return stbi__err("bad SOF len","Corrupt JPEG");

-

-   z->rgb = 0;

-   for (i=0; i < s->img_n; ++i) {

-      static const unsigned char rgb[3] = { 'R', 'G', 'B' };

-      z->img_comp[i].id = stbi__get8(s);

-      if (s->img_n == 3 && z->img_comp[i].id == rgb[i])

-         ++z->rgb;

-      q = stbi__get8(s);

-      z->img_comp[i].h = (q >> 4);  if (!z->img_comp[i].h || z->img_comp[i].h > 4) return stbi__err("bad H","Corrupt JPEG");

-      z->img_comp[i].v = q & 15;    if (!z->img_comp[i].v || z->img_comp[i].v > 4) return stbi__err("bad V","Corrupt JPEG");

-      z->img_comp[i].tq = stbi__get8(s);  if (z->img_comp[i].tq > 3) return stbi__err("bad TQ","Corrupt JPEG");

-   }

-

-   if (scan != STBI__SCAN_load) return 1;

-

-   if (!stbi__mad3sizes_valid(s->img_x, s->img_y, s->img_n, 0)) return stbi__err("too large", "Image too large to decode");

-

-   for (i=0; i < s->img_n; ++i) {

-      if (z->img_comp[i].h > h_max) h_max = z->img_comp[i].h;

-      if (z->img_comp[i].v > v_max) v_max = z->img_comp[i].v;

-   }

-

-   // compute interleaved mcu info

-   z->img_h_max = h_max;

-   z->img_v_max = v_max;

-   z->img_mcu_w = h_max * 8;

-   z->img_mcu_h = v_max * 8;

-   // these sizes can't be more than 17 bits

-   z->img_mcu_x = (s->img_x + z->img_mcu_w-1) / z->img_mcu_w;

-   z->img_mcu_y = (s->img_y + z->img_mcu_h-1) / z->img_mcu_h;

-

-   for (i=0; i < s->img_n; ++i) {

-      // number of effective pixels (e.g. for non-interleaved MCU)

-      z->img_comp[i].x = (s->img_x * z->img_comp[i].h + h_max-1) / h_max;

-      z->img_comp[i].y = (s->img_y * z->img_comp[i].v + v_max-1) / v_max;

-      // to simplify generation, we'll allocate enough memory to decode

-      // the bogus oversized data from using interleaved MCUs and their

-      // big blocks (e.g. a 16x16 iMCU on an image of width 33); we won't

-      // discard the extra data until colorspace conversion

-      //

-      // img_mcu_x, img_mcu_y: <=17 bits; comp[i].h and .v are <=4 (checked earlier)

-      // so these muls can't overflow with 32-bit ints (which we require)

-      z->img_comp[i].w2 = z->img_mcu_x * z->img_comp[i].h * 8;

-      z->img_comp[i].h2 = z->img_mcu_y * z->img_comp[i].v * 8;

-      z->img_comp[i].coeff = 0;

-      z->img_comp[i].raw_coeff = 0;

-      z->img_comp[i].linebuf = NULL;

-      z->img_comp[i].raw_data = stbi__malloc_mad2(z->img_comp[i].w2, z->img_comp[i].h2, 15);

-      if (z->img_comp[i].raw_data == NULL)

-         return stbi__free_jpeg_components(z, i+1, stbi__err("outofmem", "Out of memory"));

-      // align blocks for idct using mmx/sse

-      z->img_comp[i].data = (stbi_uc*) (((size_t) z->img_comp[i].raw_data + 15) & ~15);

-      if (z->progressive) {

-         // w2, h2 are multiples of 8 (see above)

-         z->img_comp[i].coeff_w = z->img_comp[i].w2 / 8;

-         z->img_comp[i].coeff_h = z->img_comp[i].h2 / 8;

-         z->img_comp[i].raw_coeff = stbi__malloc_mad3(z->img_comp[i].w2, z->img_comp[i].h2, sizeof(short), 15);

-         if (z->img_comp[i].raw_coeff == NULL)

-            return stbi__free_jpeg_components(z, i+1, stbi__err("outofmem", "Out of memory"));

-         z->img_comp[i].coeff = (short*) (((size_t) z->img_comp[i].raw_coeff + 15) & ~15);

-      }

-   }

-

-   return 1;

-}

-

-// use comparisons since in some cases we handle more than one case (e.g. SOF)

-#define stbi__DNL(x)         ((x) == 0xdc)

-#define stbi__SOI(x)         ((x) == 0xd8)

-#define stbi__EOI(x)         ((x) == 0xd9)

-#define stbi__SOF(x)         ((x) == 0xc0 || (x) == 0xc1 || (x) == 0xc2)

-#define stbi__SOS(x)         ((x) == 0xda)

-

-#define stbi__SOF_progressive(x)   ((x) == 0xc2)

-

-static int stbi__decode_jpeg_header(stbi__jpeg *z, int scan)

-{

-   int m;

-   z->jfif = 0;

-   z->app14_color_transform = -1; // valid values are 0,1,2

-   z->marker = STBI__MARKER_none; // initialize cached marker to empty

-   m = stbi__get_marker(z);

-   if (!stbi__SOI(m)) return stbi__err("no SOI","Corrupt JPEG");

-   if (scan == STBI__SCAN_type) return 1;

-   m = stbi__get_marker(z);

-   while (!stbi__SOF(m)) {

-      if (!stbi__process_marker(z,m)) return 0;

-      m = stbi__get_marker(z);

-      while (m == STBI__MARKER_none) {

-         // some files have extra padding after their blocks, so ok, we'll scan

-         if (stbi__at_eof(z->s)) return stbi__err("no SOF", "Corrupt JPEG");

-         m = stbi__get_marker(z);

-      }

-   }

-   z->progressive = stbi__SOF_progressive(m);

-   if (!stbi__process_frame_header(z, scan)) return 0;

-   return 1;

-}

-

-// decode image to YCbCr format

-static int stbi__decode_jpeg_image(stbi__jpeg *j)

-{

-   int m;

-   for (m = 0; m < 4; m++) {

-      j->img_comp[m].raw_data = NULL;

-      j->img_comp[m].raw_coeff = NULL;

-   }

-   j->restart_interval = 0;

-   if (!stbi__decode_jpeg_header(j, STBI__SCAN_load)) return 0;

-   m = stbi__get_marker(j);

-   while (!stbi__EOI(m)) {

-      if (stbi__SOS(m)) {

-         if (!stbi__process_scan_header(j)) return 0;

-         if (!stbi__parse_entropy_coded_data(j)) return 0;

-         if (j->marker == STBI__MARKER_none ) {

-            // handle 0s at the end of image data from IP Kamera 9060

-            while (!stbi__at_eof(j->s)) {

-               int x = stbi__get8(j->s);

-               if (x == 255) {

-                  j->marker = stbi__get8(j->s);

-                  break;

-               }

-            }

-            // if we reach eof without hitting a marker, stbi__get_marker() below will fail and we'll eventually return 0

-         }

-      } else if (stbi__DNL(m)) {

-         int Ld = stbi__get16be(j->s);

-         stbi__uint32 NL = stbi__get16be(j->s);

-         if (Ld != 4) return stbi__err("bad DNL len", "Corrupt JPEG");

-         if (NL != j->s->img_y) return stbi__err("bad DNL height", "Corrupt JPEG");

-      } else {

-         if (!stbi__process_marker(j, m)) return 0;

-      }

-      m = stbi__get_marker(j);

-   }

-   if (j->progressive)

-      stbi__jpeg_finish(j);

-   return 1;

-}

-

-// static jfif-centered resampling (across block boundaries)

-

-typedef stbi_uc *(*resample_row_func)(stbi_uc *out, stbi_uc *in0, stbi_uc *in1,

-                                    int w, int hs);

-

-#define stbi__div4(x) ((stbi_uc) ((x) >> 2))

-

-static stbi_uc *resample_row_1(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs)

-{

-   STBI_NOTUSED(out);

-   STBI_NOTUSED(in_far);

-   STBI_NOTUSED(w);

-   STBI_NOTUSED(hs);

-   return in_near;

-}

-

-static stbi_uc* stbi__resample_row_v_2(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs)

-{

-   // need to generate two samples vertically for every one in input

-   int i;

-   STBI_NOTUSED(hs);

-   for (i=0; i < w; ++i)

-      out[i] = stbi__div4(3*in_near[i] + in_far[i] + 2);

-   return out;

-}

-

-static stbi_uc*  stbi__resample_row_h_2(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs)

-{

-   // need to generate two samples horizontally for every one in input

-   int i;

-   stbi_uc *input = in_near;

-

-   if (w == 1) {

-      // if only one sample, can't do any interpolation

-      out[0] = out[1] = input[0];

-      return out;

-   }

-

-   out[0] = input[0];

-   out[1] = stbi__div4(input[0]*3 + input[1] + 2);

-   for (i=1; i < w-1; ++i) {

-      int n = 3*input[i]+2;

-      out[i*2+0] = stbi__div4(n+input[i-1]);

-      out[i*2+1] = stbi__div4(n+input[i+1]);

-   }

-   out[i*2+0] = stbi__div4(input[w-2]*3 + input[w-1] + 2);

-   out[i*2+1] = input[w-1];

-

-   STBI_NOTUSED(in_far);

-   STBI_NOTUSED(hs);

-

-   return out;

-}

-

-#define stbi__div16(x) ((stbi_uc) ((x) >> 4))

-

-static stbi_uc *stbi__resample_row_hv_2(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs)

-{

-   // need to generate 2x2 samples for every one in input

-   int i,t0,t1;

-   if (w == 1) {

-      out[0] = out[1] = stbi__div4(3*in_near[0] + in_far[0] + 2);

-      return out;

-   }

-

-   t1 = 3*in_near[0] + in_far[0];

-   out[0] = stbi__div4(t1+2);

-   for (i=1; i < w; ++i) {

-      t0 = t1;

-      t1 = 3*in_near[i]+in_far[i];

-      out[i*2-1] = stbi__div16(3*t0 + t1 + 8);

-      out[i*2  ] = stbi__div16(3*t1 + t0 + 8);

-   }

-   out[w*2-1] = stbi__div4(t1+2);

-

-   STBI_NOTUSED(hs);

-

-   return out;

-}

-

-#if defined(STBI_SSE2) || defined(STBI_NEON)

-static stbi_uc *stbi__resample_row_hv_2_simd(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs)

-{

-   // need to generate 2x2 samples for every one in input

-   int i=0,t0,t1;

-

-   if (w == 1) {

-      out[0] = out[1] = stbi__div4(3*in_near[0] + in_far[0] + 2);

-      return out;

-   }

-

-   t1 = 3*in_near[0] + in_far[0];

-   // process groups of 8 pixels for as long as we can.

-   // note we can't handle the last pixel in a row in this loop

-   // because we need to handle the filter boundary conditions.

-   for (; i < ((w-1) & ~7); i += 8) {

-#if defined(STBI_SSE2)

-      // load and perform the vertical filtering pass

-      // this uses 3*x + y = 4*x + (y - x)

-      __m128i zero  = _mm_setzero_si128();

-      __m128i farb  = _mm_loadl_epi64((__m128i *) (in_far + i));

-      __m128i nearb = _mm_loadl_epi64((__m128i *) (in_near + i));

-      __m128i farw  = _mm_unpacklo_epi8(farb, zero);

-      __m128i nearw = _mm_unpacklo_epi8(nearb, zero);

-      __m128i diff  = _mm_sub_epi16(farw, nearw);

-      __m128i nears = _mm_slli_epi16(nearw, 2);

-      __m128i curr  = _mm_add_epi16(nears, diff); // current row

-

-      // horizontal filter works the same based on shifted vers of current

-      // row. "prev" is current row shifted right by 1 pixel; we need to

-      // insert the previous pixel value (from t1).

-      // "next" is current row shifted left by 1 pixel, with first pixel

-      // of next block of 8 pixels added in.

-      __m128i prv0 = _mm_slli_si128(curr, 2);

-      __m128i nxt0 = _mm_srli_si128(curr, 2);

-      __m128i prev = _mm_insert_epi16(prv0, t1, 0);

-      __m128i next = _mm_insert_epi16(nxt0, 3*in_near[i+8] + in_far[i+8], 7);

-

-      // horizontal filter, polyphase implementation since it's convenient:

-      // even pixels = 3*cur + prev = cur*4 + (prev - cur)

-      // odd  pixels = 3*cur + next = cur*4 + (next - cur)

-      // note the shared term.

-      __m128i bias  = _mm_set1_epi16(8);

-      __m128i curs = _mm_slli_epi16(curr, 2);

-      __m128i prvd = _mm_sub_epi16(prev, curr);

-      __m128i nxtd = _mm_sub_epi16(next, curr);

-      __m128i curb = _mm_add_epi16(curs, bias);

-      __m128i even = _mm_add_epi16(prvd, curb);

-      __m128i odd  = _mm_add_epi16(nxtd, curb);

-

-      // interleave even and odd pixels, then undo scaling.

-      __m128i int0 = _mm_unpacklo_epi16(even, odd);

-      __m128i int1 = _mm_unpackhi_epi16(even, odd);

-      __m128i de0  = _mm_srli_epi16(int0, 4);

-      __m128i de1  = _mm_srli_epi16(int1, 4);

-

-      // pack and write output

-      __m128i outv = _mm_packus_epi16(de0, de1);

-      _mm_storeu_si128((__m128i *) (out + i*2), outv);

-#elif defined(STBI_NEON)

-      // load and perform the vertical filtering pass

-      // this uses 3*x + y = 4*x + (y - x)

-      uint8x8_t farb  = vld1_u8(in_far + i);

-      uint8x8_t nearb = vld1_u8(in_near + i);

-      int16x8_t diff  = vreinterpretq_s16_u16(vsubl_u8(farb, nearb));

-      int16x8_t nears = vreinterpretq_s16_u16(vshll_n_u8(nearb, 2));

-      int16x8_t curr  = vaddq_s16(nears, diff); // current row

-

-      // horizontal filter works the same based on shifted vers of current

-      // row. "prev" is current row shifted right by 1 pixel; we need to

-      // insert the previous pixel value (from t1).

-      // "next" is current row shifted left by 1 pixel, with first pixel

-      // of next block of 8 pixels added in.

-      int16x8_t prv0 = vextq_s16(curr, curr, 7);

-      int16x8_t nxt0 = vextq_s16(curr, curr, 1);

-      int16x8_t prev = vsetq_lane_s16(t1, prv0, 0);

-      int16x8_t next = vsetq_lane_s16(3*in_near[i+8] + in_far[i+8], nxt0, 7);

-

-      // horizontal filter, polyphase implementation since it's convenient:

-      // even pixels = 3*cur + prev = cur*4 + (prev - cur)

-      // odd  pixels = 3*cur + next = cur*4 + (next - cur)

-      // note the shared term.

-      int16x8_t curs = vshlq_n_s16(curr, 2);

-      int16x8_t prvd = vsubq_s16(prev, curr);

-      int16x8_t nxtd = vsubq_s16(next, curr);

-      int16x8_t even = vaddq_s16(curs, prvd);

-      int16x8_t odd  = vaddq_s16(curs, nxtd);

-

-      // undo scaling and round, then store with even/odd phases interleaved

-      uint8x8x2_t o;

-      o.val[0] = vqrshrun_n_s16(even, 4);

-      o.val[1] = vqrshrun_n_s16(odd,  4);

-      vst2_u8(out + i*2, o);

-#endif

-

-      // "previous" value for next iter

-      t1 = 3*in_near[i+7] + in_far[i+7];

-   }

-

-   t0 = t1;

-   t1 = 3*in_near[i] + in_far[i];

-   out[i*2] = stbi__div16(3*t1 + t0 + 8);

-

-   for (++i; i < w; ++i) {

-      t0 = t1;

-      t1 = 3*in_near[i]+in_far[i];

-      out[i*2-1] = stbi__div16(3*t0 + t1 + 8);

-      out[i*2  ] = stbi__div16(3*t1 + t0 + 8);

-   }

-   out[w*2-1] = stbi__div4(t1+2);

-

-   STBI_NOTUSED(hs);

-

-   return out;

-}

-#endif

-

-static stbi_uc *stbi__resample_row_generic(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs)

-{

-   // resample with nearest-neighbor

-   int i,j;

-   STBI_NOTUSED(in_far);

-   for (i=0; i < w; ++i)

-      for (j=0; j < hs; ++j)

-         out[i*hs+j] = in_near[i];

-   return out;

-}

-

-// this is a reduced-precision calculation of YCbCr-to-RGB introduced

-// to make sure the code produces the same results in both SIMD and scalar

-#define stbi__float2fixed(x)  (((int) ((x) * 4096.0f + 0.5f)) << 8)

-static void stbi__YCbCr_to_RGB_row(stbi_uc *out, const stbi_uc *y, const stbi_uc *pcb, const stbi_uc *pcr, int count, int step)

-{

-   int i;

-   for (i=0; i < count; ++i) {

-      int y_fixed = (y[i] << 20) + (1<<19); // rounding

-      int r,g,b;

-      int cr = pcr[i] - 128;

-      int cb = pcb[i] - 128;

-      r = y_fixed +  cr* stbi__float2fixed(1.40200f);

-      g = y_fixed + (cr*-stbi__float2fixed(0.71414f)) + ((cb*-stbi__float2fixed(0.34414f)) & 0xffff0000);

-      b = y_fixed                                     +   cb* stbi__float2fixed(1.77200f);

-      r >>= 20;

-      g >>= 20;

-      b >>= 20;

-      if ((unsigned) r > 255) { if (r < 0) r = 0; else r = 255; }

-      if ((unsigned) g > 255) { if (g < 0) g = 0; else g = 255; }

-      if ((unsigned) b > 255) { if (b < 0) b = 0; else b = 255; }

-      out[0] = (stbi_uc)r;

-      out[1] = (stbi_uc)g;

-      out[2] = (stbi_uc)b;

-      out[3] = 255;

-      out += step;

-   }

-}

-

-#if defined(STBI_SSE2) || defined(STBI_NEON)

-static void stbi__YCbCr_to_RGB_simd(stbi_uc *out, stbi_uc const *y, stbi_uc const *pcb, stbi_uc const *pcr, int count, int step)

-{

-   int i = 0;

-

-#ifdef STBI_SSE2

-   // step == 3 is pretty ugly on the final interleave, and i'm not convinced

-   // it's useful in practice (you wouldn't use it for textures, for example).

-   // so just accelerate step == 4 case.

-   if (step == 4) {

-      // this is a fairly straightforward implementation and not super-optimized.

-      __m128i signflip  = _mm_set1_epi8(-0x80);

-      __m128i cr_const0 = _mm_set1_epi16(   (short) ( 1.40200f*4096.0f+0.5f));

-      __m128i cr_const1 = _mm_set1_epi16( - (short) ( 0.71414f*4096.0f+0.5f));

-      __m128i cb_const0 = _mm_set1_epi16( - (short) ( 0.34414f*4096.0f+0.5f));

-      __m128i cb_const1 = _mm_set1_epi16(   (short) ( 1.77200f*4096.0f+0.5f));

-      __m128i y_bias = _mm_set1_epi8((char) (unsigned char) 128);

-      __m128i xw = _mm_set1_epi16(255); // alpha channel

-

-      for (; i+7 < count; i += 8) {

-         // load

-         __m128i y_bytes = _mm_loadl_epi64((__m128i *) (y+i));

-         __m128i cr_bytes = _mm_loadl_epi64((__m128i *) (pcr+i));

-         __m128i cb_bytes = _mm_loadl_epi64((__m128i *) (pcb+i));

-         __m128i cr_biased = _mm_xor_si128(cr_bytes, signflip); // -128

-         __m128i cb_biased = _mm_xor_si128(cb_bytes, signflip); // -128

-

-         // unpack to short (and left-shift cr, cb by 8)

-         __m128i yw  = _mm_unpacklo_epi8(y_bias, y_bytes);

-         __m128i crw = _mm_unpacklo_epi8(_mm_setzero_si128(), cr_biased);

-         __m128i cbw = _mm_unpacklo_epi8(_mm_setzero_si128(), cb_biased);

-

-         // color transform

-         __m128i yws = _mm_srli_epi16(yw, 4);

-         __m128i cr0 = _mm_mulhi_epi16(cr_const0, crw);

-         __m128i cb0 = _mm_mulhi_epi16(cb_const0, cbw);

-         __m128i cb1 = _mm_mulhi_epi16(cbw, cb_const1);

-         __m128i cr1 = _mm_mulhi_epi16(crw, cr_const1);

-         __m128i rws = _mm_add_epi16(cr0, yws);

-         __m128i gwt = _mm_add_epi16(cb0, yws);

-         __m128i bws = _mm_add_epi16(yws, cb1);

-         __m128i gws = _mm_add_epi16(gwt, cr1);

-

-         // descale

-         __m128i rw = _mm_srai_epi16(rws, 4);

-         __m128i bw = _mm_srai_epi16(bws, 4);

-         __m128i gw = _mm_srai_epi16(gws, 4);

-

-         // back to byte, set up for transpose

-         __m128i brb = _mm_packus_epi16(rw, bw);

-         __m128i gxb = _mm_packus_epi16(gw, xw);

-

-         // transpose to interleave channels

-         __m128i t0 = _mm_unpacklo_epi8(brb, gxb);

-         __m128i t1 = _mm_unpackhi_epi8(brb, gxb);

-         __m128i o0 = _mm_unpacklo_epi16(t0, t1);

-         __m128i o1 = _mm_unpackhi_epi16(t0, t1);

-

-         // store

-         _mm_storeu_si128((__m128i *) (out + 0), o0);

-         _mm_storeu_si128((__m128i *) (out + 16), o1);

-         out += 32;

-      }

-   }

-#endif

-

-#ifdef STBI_NEON

-   // in this version, step=3 support would be easy to add. but is there demand?

-   if (step == 4) {

-      // this is a fairly straightforward implementation and not super-optimized.

-      uint8x8_t signflip = vdup_n_u8(0x80);

-      int16x8_t cr_const0 = vdupq_n_s16(   (short) ( 1.40200f*4096.0f+0.5f));

-      int16x8_t cr_const1 = vdupq_n_s16( - (short) ( 0.71414f*4096.0f+0.5f));

-      int16x8_t cb_const0 = vdupq_n_s16( - (short) ( 0.34414f*4096.0f+0.5f));

-      int16x8_t cb_const1 = vdupq_n_s16(   (short) ( 1.77200f*4096.0f+0.5f));

-

-      for (; i+7 < count; i += 8) {

-         // load

-         uint8x8_t y_bytes  = vld1_u8(y + i);

-         uint8x8_t cr_bytes = vld1_u8(pcr + i);

-         uint8x8_t cb_bytes = vld1_u8(pcb + i);

-         int8x8_t cr_biased = vreinterpret_s8_u8(vsub_u8(cr_bytes, signflip));

-         int8x8_t cb_biased = vreinterpret_s8_u8(vsub_u8(cb_bytes, signflip));

-

-         // expand to s16

-         int16x8_t yws = vreinterpretq_s16_u16(vshll_n_u8(y_bytes, 4));

-         int16x8_t crw = vshll_n_s8(cr_biased, 7);

-         int16x8_t cbw = vshll_n_s8(cb_biased, 7);

-

-         // color transform

-         int16x8_t cr0 = vqdmulhq_s16(crw, cr_const0);

-         int16x8_t cb0 = vqdmulhq_s16(cbw, cb_const0);

-         int16x8_t cr1 = vqdmulhq_s16(crw, cr_const1);

-         int16x8_t cb1 = vqdmulhq_s16(cbw, cb_const1);

-         int16x8_t rws = vaddq_s16(yws, cr0);

-         int16x8_t gws = vaddq_s16(vaddq_s16(yws, cb0), cr1);

-         int16x8_t bws = vaddq_s16(yws, cb1);

-

-         // undo scaling, round, convert to byte

-         uint8x8x4_t o;

-         o.val[0] = vqrshrun_n_s16(rws, 4);

-         o.val[1] = vqrshrun_n_s16(gws, 4);

-         o.val[2] = vqrshrun_n_s16(bws, 4);

-         o.val[3] = vdup_n_u8(255);

-

-         // store, interleaving r/g/b/a

-         vst4_u8(out, o);

-         out += 8*4;

-      }

-   }

-#endif

-

-   for (; i < count; ++i) {

-      int y_fixed = (y[i] << 20) + (1<<19); // rounding

-      int r,g,b;

-      int cr = pcr[i] - 128;

-      int cb = pcb[i] - 128;

-      r = y_fixed + cr* stbi__float2fixed(1.40200f);

-      g = y_fixed + cr*-stbi__float2fixed(0.71414f) + ((cb*-stbi__float2fixed(0.34414f)) & 0xffff0000);

-      b = y_fixed                                   +   cb* stbi__float2fixed(1.77200f);

-      r >>= 20;

-      g >>= 20;

-      b >>= 20;

-      if ((unsigned) r > 255) { if (r < 0) r = 0; else r = 255; }

-      if ((unsigned) g > 255) { if (g < 0) g = 0; else g = 255; }

-      if ((unsigned) b > 255) { if (b < 0) b = 0; else b = 255; }

-      out[0] = (stbi_uc)r;

-      out[1] = (stbi_uc)g;

-      out[2] = (stbi_uc)b;

-      out[3] = 255;

-      out += step;

-   }

-}

-#endif

-

-// set up the kernels

-static void stbi__setup_jpeg(stbi__jpeg *j)

-{

-   j->idct_block_kernel = stbi__idct_block;

-   j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_row;

-   j->resample_row_hv_2_kernel = stbi__resample_row_hv_2;

-

-#ifdef STBI_SSE2

-   if (stbi__sse2_available()) {

-      j->idct_block_kernel = stbi__idct_simd;

-      j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_simd;

-      j->resample_row_hv_2_kernel = stbi__resample_row_hv_2_simd;

-   }

-#endif

-

-#ifdef STBI_NEON

-   j->idct_block_kernel = stbi__idct_simd;

-   j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_simd;

-   j->resample_row_hv_2_kernel = stbi__resample_row_hv_2_simd;

-#endif

-}

-

-// clean up the temporary component buffers

-static void stbi__cleanup_jpeg(stbi__jpeg *j)

-{

-   stbi__free_jpeg_components(j, j->s->img_n, 0);

-}

-

-typedef struct

-{

-   resample_row_func resample;

-   stbi_uc *line0,*line1;

-   int hs,vs;   // expansion factor in each axis

-   int w_lores; // horizontal pixels pre-expansion

-   int ystep;   // how far through vertical expansion we are

-   int ypos;    // which pre-expansion row we're on

-} stbi__resample;

-

-// fast 0..255 * 0..255 => 0..255 rounded multiplication

-static stbi_uc stbi__blinn_8x8(stbi_uc x, stbi_uc y)

-{

-   unsigned int t = x*y + 128;

-   return (stbi_uc) ((t + (t >>8)) >> 8);

-}

-

-static stbi_uc *load_jpeg_image(stbi__jpeg *z, int *out_x, int *out_y, int *comp, int req_comp)

-{

-   int n, decode_n, is_rgb;

-   z->s->img_n = 0; // make stbi__cleanup_jpeg safe

-

-   // validate req_comp

-   if (req_comp < 0 || req_comp > 4) return stbi__errpuc("bad req_comp", "Internal error");

-

-   // load a jpeg image from whichever source, but leave in YCbCr format

-   if (!stbi__decode_jpeg_image(z)) { stbi__cleanup_jpeg(z); return NULL; }

-

-   // determine actual number of components to generate

-   n = req_comp ? req_comp : z->s->img_n >= 3 ? 3 : 1;

-

-   is_rgb = z->s->img_n == 3 && (z->rgb == 3 || (z->app14_color_transform == 0 && !z->jfif));

-

-   if (z->s->img_n == 3 && n < 3 && !is_rgb)

-      decode_n = 1;

-   else

-      decode_n = z->s->img_n;

-

-   // resample and color-convert

-   {

-      int k;

-      unsigned int i,j;

-      stbi_uc *output;

-      stbi_uc *coutput[4] = { NULL, NULL, NULL, NULL };

-

-      stbi__resample res_comp[4];

-

-      for (k=0; k < decode_n; ++k) {

-         stbi__resample *r = &res_comp[k];

-

-         // allocate line buffer big enough for upsampling off the edges

-         // with upsample factor of 4

-         z->img_comp[k].linebuf = (stbi_uc *) stbi__malloc(z->s->img_x + 3);

-         if (!z->img_comp[k].linebuf) { stbi__cleanup_jpeg(z); return stbi__errpuc("outofmem", "Out of memory"); }

-

-         r->hs      = z->img_h_max / z->img_comp[k].h;

-         r->vs      = z->img_v_max / z->img_comp[k].v;

-         r->ystep   = r->vs >> 1;

-         r->w_lores = (z->s->img_x + r->hs-1) / r->hs;

-         r->ypos    = 0;

-         r->line0   = r->line1 = z->img_comp[k].data;

-

-         if      (r->hs == 1 && r->vs == 1) r->resample = resample_row_1;

-         else if (r->hs == 1 && r->vs == 2) r->resample = stbi__resample_row_v_2;

-         else if (r->hs == 2 && r->vs == 1) r->resample = stbi__resample_row_h_2;

-         else if (r->hs == 2 && r->vs == 2) r->resample = z->resample_row_hv_2_kernel;

-         else                               r->resample = stbi__resample_row_generic;

-      }

-

-      // can't error after this so, this is safe

-      output = (stbi_uc *) stbi__malloc_mad3(n, z->s->img_x, z->s->img_y, 1);

-      if (!output) { stbi__cleanup_jpeg(z); return stbi__errpuc("outofmem", "Out of memory"); }

-

-      // now go ahead and resample

-      for (j=0; j < z->s->img_y; ++j) {

-         stbi_uc *out = output + n * z->s->img_x * j;

-         for (k=0; k < decode_n; ++k) {

-            stbi__resample *r = &res_comp[k];

-            int y_bot = r->ystep >= (r->vs >> 1);

-            coutput[k] = r->resample(z->img_comp[k].linebuf,

-                                     y_bot ? r->line1 : r->line0,

-                                     y_bot ? r->line0 : r->line1,

-                                     r->w_lores, r->hs);

-            if (++r->ystep >= r->vs) {

-               r->ystep = 0;

-               r->line0 = r->line1;

-               if (++r->ypos < z->img_comp[k].y)

-                  r->line1 += z->img_comp[k].w2;

-            }

-         }

-         if (n >= 3) {

-            stbi_uc *y = coutput[0];

-            if (z->s->img_n == 3) {

-               if (is_rgb) {

-                  for (i=0; i < z->s->img_x; ++i) {

-                     out[0] = y[i];

-                     out[1] = coutput[1][i];

-                     out[2] = coutput[2][i];

-                     out[3] = 255;

-                     out += n;

-                  }

-               } else {

-                  z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n);

-               }

-            } else if (z->s->img_n == 4) {

-               if (z->app14_color_transform == 0) { // CMYK

-                  for (i=0; i < z->s->img_x; ++i) {

-                     stbi_uc m = coutput[3][i];

-                     out[0] = stbi__blinn_8x8(coutput[0][i], m);

-                     out[1] = stbi__blinn_8x8(coutput[1][i], m);

-                     out[2] = stbi__blinn_8x8(coutput[2][i], m);

-                     out[3] = 255;

-                     out += n;

-                  }

-               } else if (z->app14_color_transform == 2) { // YCCK

-                  z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n);

-                  for (i=0; i < z->s->img_x; ++i) {

-                     stbi_uc m = coutput[3][i];

-                     out[0] = stbi__blinn_8x8(255 - out[0], m);

-                     out[1] = stbi__blinn_8x8(255 - out[1], m);

-                     out[2] = stbi__blinn_8x8(255 - out[2], m);

-                     out += n;

-                  }

-               } else { // YCbCr + alpha?  Ignore the fourth channel for now

-                  z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n);

-               }

-            } else

-               for (i=0; i < z->s->img_x; ++i) {

-                  out[0] = out[1] = out[2] = y[i];

-                  out[3] = 255; // not used if n==3

-                  out += n;

-               }

-         } else {

-            if (is_rgb) {

-               if (n == 1)

-                  for (i=0; i < z->s->img_x; ++i)

-                     *out++ = stbi__compute_y(coutput[0][i], coutput[1][i], coutput[2][i]);

-               else {

-                  for (i=0; i < z->s->img_x; ++i, out += 2) {

-                     out[0] = stbi__compute_y(coutput[0][i], coutput[1][i], coutput[2][i]);

-                     out[1] = 255;

-                  }

-               }

-            } else if (z->s->img_n == 4 && z->app14_color_transform == 0) {

-               for (i=0; i < z->s->img_x; ++i) {

-                  stbi_uc m = coutput[3][i];

-                  stbi_uc r = stbi__blinn_8x8(coutput[0][i], m);

-                  stbi_uc g = stbi__blinn_8x8(coutput[1][i], m);

-                  stbi_uc b = stbi__blinn_8x8(coutput[2][i], m);

-                  out[0] = stbi__compute_y(r, g, b);

-                  out[1] = 255;

-                  out += n;

-               }

-            } else if (z->s->img_n == 4 && z->app14_color_transform == 2) {

-               for (i=0; i < z->s->img_x; ++i) {

-                  out[0] = stbi__blinn_8x8(255 - coutput[0][i], coutput[3][i]);

-                  out[1] = 255;

-                  out += n;

-               }

-            } else {

-               stbi_uc *y = coutput[0];

-               if (n == 1)

-                  for (i=0; i < z->s->img_x; ++i) out[i] = y[i];

-               else

-                  for (i=0; i < z->s->img_x; ++i) { *out++ = y[i]; *out++ = 255; }

-            }

-         }

-      }

-      stbi__cleanup_jpeg(z);

-      *out_x = z->s->img_x;

-      *out_y = z->s->img_y;

-      if (comp) *comp = z->s->img_n >= 3 ? 3 : 1; // report original components, not output

-      return output;

-   }

-}

-

-static void *stbi__jpeg_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri)

-{

-   unsigned char* result;

-   stbi__jpeg* j = (stbi__jpeg*) stbi__malloc(sizeof(stbi__jpeg));

-   STBI_NOTUSED(ri);

-   j->s = s;

-   stbi__setup_jpeg(j);

-   result = load_jpeg_image(j, x,y,comp,req_comp);

-   STBI_FREE(j);

-   return result;

-}

-

-static int stbi__jpeg_test(stbi__context *s)

-{

-   int r;

-   stbi__jpeg* j = (stbi__jpeg*)stbi__malloc(sizeof(stbi__jpeg));

-   j->s = s;

-   stbi__setup_jpeg(j);

-   r = stbi__decode_jpeg_header(j, STBI__SCAN_type);

-   stbi__rewind(s);

-   STBI_FREE(j);

-   return r;

-}

-

-static int stbi__jpeg_info_raw(stbi__jpeg *j, int *x, int *y, int *comp)

-{

-   if (!stbi__decode_jpeg_header(j, STBI__SCAN_header)) {

-      stbi__rewind( j->s );

-      return 0;

-   }

-   if (x) *x = j->s->img_x;

-   if (y) *y = j->s->img_y;

-   if (comp) *comp = j->s->img_n >= 3 ? 3 : 1;

-   return 1;

-}

-

-static int stbi__jpeg_info(stbi__context *s, int *x, int *y, int *comp)

-{

-   int result;

-   stbi__jpeg* j = (stbi__jpeg*) (stbi__malloc(sizeof(stbi__jpeg)));

-   j->s = s;

-   result = stbi__jpeg_info_raw(j, x, y, comp);

-   STBI_FREE(j);

-   return result;

-}

-#endif

-

-// public domain zlib decode    v0.2  Sean Barrett 2006-11-18

-//    simple implementation

-//      - all input must be provided in an upfront buffer

-//      - all output is written to a single output buffer (can malloc/realloc)

-//    performance

-//      - fast huffman

-

-#ifndef STBI_NO_ZLIB

-

-// fast-way is faster to check than jpeg huffman, but slow way is slower

-#define STBI__ZFAST_BITS  9 // accelerate all cases in default tables

-#define STBI__ZFAST_MASK  ((1 << STBI__ZFAST_BITS) - 1)

-

-// zlib-style huffman encoding

-// (jpegs packs from left, zlib from right, so can't share code)

-typedef struct

-{

-   stbi__uint16 fast[1 << STBI__ZFAST_BITS];

-   stbi__uint16 firstcode[16];

-   int maxcode[17];

-   stbi__uint16 firstsymbol[16];

-   stbi_uc  size[288];

-   stbi__uint16 value[288];

-} stbi__zhuffman;

-

-stbi_inline static int stbi__bitreverse16(int n)

-{

-  n = ((n & 0xAAAA) >>  1) | ((n & 0x5555) << 1);

-  n = ((n & 0xCCCC) >>  2) | ((n & 0x3333) << 2);

-  n = ((n & 0xF0F0) >>  4) | ((n & 0x0F0F) << 4);

-  n = ((n & 0xFF00) >>  8) | ((n & 0x00FF) << 8);

-  return n;

-}

-

-stbi_inline static int stbi__bit_reverse(int v, int bits)

-{

-   STBI_ASSERT(bits <= 16);

-   // to bit reverse n bits, reverse 16 and shift

-   // e.g. 11 bits, bit reverse and shift away 5

-   return stbi__bitreverse16(v) >> (16-bits);

-}

-

-static int stbi__zbuild_huffman(stbi__zhuffman *z, const stbi_uc *sizelist, int num)

-{

-   int i,k=0;

-   int code, next_code[16], sizes[17];

-

-   // DEFLATE spec for generating codes

-   memset(sizes, 0, sizeof(sizes));

-   memset(z->fast, 0, sizeof(z->fast));

-   for (i=0; i < num; ++i)

-      ++sizes[sizelist[i]];

-   sizes[0] = 0;

-   for (i=1; i < 16; ++i)

-      if (sizes[i] > (1 << i))

-         return stbi__err("bad sizes", "Corrupt PNG");

-   code = 0;

-   for (i=1; i < 16; ++i) {

-      next_code[i] = code;

-      z->firstcode[i] = (stbi__uint16) code;

-      z->firstsymbol[i] = (stbi__uint16) k;

-      code = (code + sizes[i]);

-      if (sizes[i])

-         if (code-1 >= (1 << i)) return stbi__err("bad codelengths","Corrupt PNG");

-      z->maxcode[i] = code << (16-i); // preshift for inner loop

-      code <<= 1;

-      k += sizes[i];

-   }

-   z->maxcode[16] = 0x10000; // sentinel

-   for (i=0; i < num; ++i) {

-      int s = sizelist[i];

-      if (s) {

-         int c = next_code[s] - z->firstcode[s] + z->firstsymbol[s];

-         stbi__uint16 fastv = (stbi__uint16) ((s << 9) | i);

-         z->size [c] = (stbi_uc     ) s;

-         z->value[c] = (stbi__uint16) i;

-         if (s <= STBI__ZFAST_BITS) {

-            int j = stbi__bit_reverse(next_code[s],s);

-            while (j < (1 << STBI__ZFAST_BITS)) {

-               z->fast[j] = fastv;

-               j += (1 << s);

-            }

-         }

-         ++next_code[s];

-      }

-   }

-   return 1;

-}

-

-// zlib-from-memory implementation for PNG reading

-//    because PNG allows splitting the zlib stream arbitrarily,

-//    and it's annoying structurally to have PNG call ZLIB call PNG,

-//    we require PNG read all the IDATs and combine them into a single

-//    memory buffer

-

-typedef struct

-{

-   stbi_uc *zbuffer, *zbuffer_end;

-   int num_bits;

-   stbi__uint32 code_buffer;

-

-   char *zout;

-   char *zout_start;

-   char *zout_end;

-   int   z_expandable;

-

-   stbi__zhuffman z_length, z_distance;

-} stbi__zbuf;

-

-stbi_inline static stbi_uc stbi__zget8(stbi__zbuf *z)

-{

-   if (z->zbuffer >= z->zbuffer_end) return 0;

-   return *z->zbuffer++;

-}

-

-static void stbi__fill_bits(stbi__zbuf *z)

-{

-   do {

-      STBI_ASSERT(z->code_buffer < (1U << z->num_bits));

-      z->code_buffer |= (unsigned int) stbi__zget8(z) << z->num_bits;

-      z->num_bits += 8;

-   } while (z->num_bits <= 24);

-}

-

-stbi_inline static unsigned int stbi__zreceive(stbi__zbuf *z, int n)

-{

-   unsigned int k;

-   if (z->num_bits < n) stbi__fill_bits(z);

-   k = z->code_buffer & ((1 << n) - 1);

-   z->code_buffer >>= n;

-   z->num_bits -= n;

-   return k;

-}

-

-static int stbi__zhuffman_decode_slowpath(stbi__zbuf *a, stbi__zhuffman *z)

-{

-   int b,s,k;

-   // not resolved by fast table, so compute it the slow way

-   // use jpeg approach, which requires MSbits at top

-   k = stbi__bit_reverse(a->code_buffer, 16);

-   for (s=STBI__ZFAST_BITS+1; ; ++s)

-      if (k < z->maxcode[s])

-         break;

-   if (s == 16) return -1; // invalid code!

-   // code size is s, so:

-   b = (k >> (16-s)) - z->firstcode[s] + z->firstsymbol[s];

-   STBI_ASSERT(z->size[b] == s);

-   a->code_buffer >>= s;

-   a->num_bits -= s;

-   return z->value[b];

-}

-

-stbi_inline static int stbi__zhuffman_decode(stbi__zbuf *a, stbi__zhuffman *z)

-{

-   int b,s;

-   if (a->num_bits < 16) stbi__fill_bits(a);

-   b = z->fast[a->code_buffer & STBI__ZFAST_MASK];

-   if (b) {

-      s = b >> 9;

-      a->code_buffer >>= s;

-      a->num_bits -= s;

-      return b & 511;

-   }

-   return stbi__zhuffman_decode_slowpath(a, z);

-}

-

-static int stbi__zexpand(stbi__zbuf *z, char *zout, int n)  // need to make room for n bytes

-{

-   char *q;

-   int cur, limit, old_limit;

-   z->zout = zout;

-   if (!z->z_expandable) return stbi__err("output buffer limit","Corrupt PNG");

-   cur   = (int) (z->zout     - z->zout_start);

-   limit = old_limit = (int) (z->zout_end - z->zout_start);

-   while (cur + n > limit)

-      limit *= 2;

-   q = (char *) STBI_REALLOC_SIZED(z->zout_start, old_limit, limit);

-   STBI_NOTUSED(old_limit);

-   if (q == NULL) return stbi__err("outofmem", "Out of memory");

-   z->zout_start = q;

-   z->zout       = q + cur;

-   z->zout_end   = q + limit;

-   return 1;

-}

-

-static const int stbi__zlength_base[31] = {

-   3,4,5,6,7,8,9,10,11,13,

-   15,17,19,23,27,31,35,43,51,59,

-   67,83,99,115,131,163,195,227,258,0,0 };

-

-static const int stbi__zlength_extra[31]=

-{ 0,0,0,0,0,0,0,0,1,1,1,1,2,2,2,2,3,3,3,3,4,4,4,4,5,5,5,5,0,0,0 };

-

-static const int stbi__zdist_base[32] = { 1,2,3,4,5,7,9,13,17,25,33,49,65,97,129,193,

-257,385,513,769,1025,1537,2049,3073,4097,6145,8193,12289,16385,24577,0,0};

-

-static const int stbi__zdist_extra[32] =

-{ 0,0,0,0,1,1,2,2,3,3,4,4,5,5,6,6,7,7,8,8,9,9,10,10,11,11,12,12,13,13};

-

-static int stbi__parse_huffman_block(stbi__zbuf *a)

-{

-   char *zout = a->zout;

-   for(;;) {

-      int z = stbi__zhuffman_decode(a, &a->z_length);

-      if (z < 256) {

-         if (z < 0) return stbi__err("bad huffman code","Corrupt PNG"); // error in huffman codes

-         if (zout >= a->zout_end) {

-            if (!stbi__zexpand(a, zout, 1)) return 0;

-            zout = a->zout;

-         }

-         *zout++ = (char) z;

-      } else {

-         stbi_uc *p;

-         int len,dist;

-         if (z == 256) {

-            a->zout = zout;

-            return 1;

-         }

-         z -= 257;

-         len = stbi__zlength_base[z];

-         if (stbi__zlength_extra[z]) len += stbi__zreceive(a, stbi__zlength_extra[z]);

-         z = stbi__zhuffman_decode(a, &a->z_distance);

-         if (z < 0) return stbi__err("bad huffman code","Corrupt PNG");

-         dist = stbi__zdist_base[z];

-         if (stbi__zdist_extra[z]) dist += stbi__zreceive(a, stbi__zdist_extra[z]);

-         if (zout - a->zout_start < dist) return stbi__err("bad dist","Corrupt PNG");

-         if (zout + len > a->zout_end) {

-            if (!stbi__zexpand(a, zout, len)) return 0;

-            zout = a->zout;

-         }

-         p = (stbi_uc *) (zout - dist);

-         if (dist == 1) { // run of one byte; common in images.

-            stbi_uc v = *p;

-            if (len) { do *zout++ = v; while (--len); }

-         } else {

-            if (len) { do *zout++ = *p++; while (--len); }

-         }

-      }

-   }

-}

-

-static int stbi__compute_huffman_codes(stbi__zbuf *a)

-{

-   static const stbi_uc length_dezigzag[19] = { 16,17,18,0,8,7,9,6,10,5,11,4,12,3,13,2,14,1,15 };

-   stbi__zhuffman z_codelength;

-   stbi_uc lencodes[286+32+137];//padding for maximum single op

-   stbi_uc codelength_sizes[19];

-   int i,n;

-

-   int hlit  = stbi__zreceive(a,5) + 257;

-   int hdist = stbi__zreceive(a,5) + 1;

-   int hclen = stbi__zreceive(a,4) + 4;

-   int ntot  = hlit + hdist;

-

-   memset(codelength_sizes, 0, sizeof(codelength_sizes));

-   for (i=0; i < hclen; ++i) {

-      int s = stbi__zreceive(a,3);

-      codelength_sizes[length_dezigzag[i]] = (stbi_uc) s;

-   }

-   if (!stbi__zbuild_huffman(&z_codelength, codelength_sizes, 19)) return 0;

-

-   n = 0;

-   while (n < ntot) {

-      int c = stbi__zhuffman_decode(a, &z_codelength);

-      if (c < 0 || c >= 19) return stbi__err("bad codelengths", "Corrupt PNG");

-      if (c < 16)

-         lencodes[n++] = (stbi_uc) c;

-      else {

-         stbi_uc fill = 0;

-         if (c == 16) {

-            c = stbi__zreceive(a,2)+3;

-            if (n == 0) return stbi__err("bad codelengths", "Corrupt PNG");

-            fill = lencodes[n-1];

-         } else if (c == 17)

-            c = stbi__zreceive(a,3)+3;

-         else {

-            STBI_ASSERT(c == 18);

-            c = stbi__zreceive(a,7)+11;

-         }

-         if (ntot - n < c) return stbi__err("bad codelengths", "Corrupt PNG");

-         memset(lencodes+n, fill, c);

-         n += c;

-      }

-   }

-   if (n != ntot) return stbi__err("bad codelengths","Corrupt PNG");

-   if (!stbi__zbuild_huffman(&a->z_length, lencodes, hlit)) return 0;

-   if (!stbi__zbuild_huffman(&a->z_distance, lencodes+hlit, hdist)) return 0;

-   return 1;

-}

-

-static int stbi__parse_uncompressed_block(stbi__zbuf *a)

-{

-   stbi_uc header[4];

-   int len,nlen,k;

-   if (a->num_bits & 7)

-      stbi__zreceive(a, a->num_bits & 7); // discard

-   // drain the bit-packed data into header

-   k = 0;

-   while (a->num_bits > 0) {

-      header[k++] = (stbi_uc) (a->code_buffer & 255); // suppress MSVC run-time check

-      a->code_buffer >>= 8;

-      a->num_bits -= 8;

-   }

-   STBI_ASSERT(a->num_bits == 0);

-   // now fill header the normal way

-   while (k < 4)

-      header[k++] = stbi__zget8(a);

-   len  = header[1] * 256 + header[0];

-   nlen = header[3] * 256 + header[2];

-   if (nlen != (len ^ 0xffff)) return stbi__err("zlib corrupt","Corrupt PNG");

-   if (a->zbuffer + len > a->zbuffer_end) return stbi__err("read past buffer","Corrupt PNG");

-   if (a->zout + len > a->zout_end)

-      if (!stbi__zexpand(a, a->zout, len)) return 0;

-   memcpy(a->zout, a->zbuffer, len);

-   a->zbuffer += len;

-   a->zout += len;

-   return 1;

-}

-

-static int stbi__parse_zlib_header(stbi__zbuf *a)

-{

-   int cmf   = stbi__zget8(a);

-   int cm    = cmf & 15;

-   /* int cinfo = cmf >> 4; */

-   int flg   = stbi__zget8(a);

-   if ((cmf*256+flg) % 31 != 0) return stbi__err("bad zlib header","Corrupt PNG"); // zlib spec

-   if (flg & 32) return stbi__err("no preset dict","Corrupt PNG"); // preset dictionary not allowed in png

-   if (cm != 8) return stbi__err("bad compression","Corrupt PNG"); // DEFLATE required for png

-   // window = 1 << (8 + cinfo)... but who cares, we fully buffer output

-   return 1;

-}

-

-static const stbi_uc stbi__zdefault_length[288] =

-{

-   8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,

-   8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,

-   8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,

-   8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,

-   8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,

-   9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,

-   9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,

-   9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,

-   7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7, 7,7,7,7,7,7,7,7,8,8,8,8,8,8,8,8

-};

-static const stbi_uc stbi__zdefault_distance[32] =

-{

-   5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5

-};

-/*

-Init algorithm:

-{

-   int i;   // use <= to match clearly with spec

-   for (i=0; i <= 143; ++i)     stbi__zdefault_length[i]   = 8;

-   for (   ; i <= 255; ++i)     stbi__zdefault_length[i]   = 9;

-   for (   ; i <= 279; ++i)     stbi__zdefault_length[i]   = 7;

-   for (   ; i <= 287; ++i)     stbi__zdefault_length[i]   = 8;

-

-   for (i=0; i <=  31; ++i)     stbi__zdefault_distance[i] = 5;

-}

-*/

-

-static int stbi__parse_zlib(stbi__zbuf *a, int parse_header)

-{

-   int final, type;

-   if (parse_header)

-      if (!stbi__parse_zlib_header(a)) return 0;

-   a->num_bits = 0;

-   a->code_buffer = 0;

-   do {

-      final = stbi__zreceive(a,1);

-      type = stbi__zreceive(a,2);

-      if (type == 0) {

-         if (!stbi__parse_uncompressed_block(a)) return 0;

-      } else if (type == 3) {

-         return 0;

-      } else {

-         if (type == 1) {

-            // use fixed code lengths

-            if (!stbi__zbuild_huffman(&a->z_length  , stbi__zdefault_length  , 288)) return 0;

-            if (!stbi__zbuild_huffman(&a->z_distance, stbi__zdefault_distance,  32)) return 0;

-         } else {

-            if (!stbi__compute_huffman_codes(a)) return 0;

-         }

-         if (!stbi__parse_huffman_block(a)) return 0;

-      }

-   } while (!final);

-   return 1;

-}

-

-static int stbi__do_zlib(stbi__zbuf *a, char *obuf, int olen, int exp, int parse_header)

-{

-   a->zout_start = obuf;

-   a->zout       = obuf;

-   a->zout_end   = obuf + olen;

-   a->z_expandable = exp;

-

-   return stbi__parse_zlib(a, parse_header);

-}

-

-STBIDEF char *stbi_zlib_decode_malloc_guesssize(const char *buffer, int len, int initial_size, int *outlen)

-{

-   stbi__zbuf a;

-   char *p = (char *) stbi__malloc(initial_size);

-   if (p == NULL) return NULL;

-   a.zbuffer = (stbi_uc *) buffer;

-   a.zbuffer_end = (stbi_uc *) buffer + len;

-   if (stbi__do_zlib(&a, p, initial_size, 1, 1)) {

-      if (outlen) *outlen = (int) (a.zout - a.zout_start);

-      return a.zout_start;

-   } else {

-      STBI_FREE(a.zout_start);

-      return NULL;

-   }

-}

-

-STBIDEF char *stbi_zlib_decode_malloc(char const *buffer, int len, int *outlen)

-{

-   return stbi_zlib_decode_malloc_guesssize(buffer, len, 16384, outlen);

-}

-

-STBIDEF char *stbi_zlib_decode_malloc_guesssize_headerflag(const char *buffer, int len, int initial_size, int *outlen, int parse_header)

-{

-   stbi__zbuf a;

-   char *p = (char *) stbi__malloc(initial_size);

-   if (p == NULL) return NULL;

-   a.zbuffer = (stbi_uc *) buffer;

-   a.zbuffer_end = (stbi_uc *) buffer + len;

-   if (stbi__do_zlib(&a, p, initial_size, 1, parse_header)) {

-      if (outlen) *outlen = (int) (a.zout - a.zout_start);

-      return a.zout_start;

-   } else {

-      STBI_FREE(a.zout_start);

-      return NULL;

-   }

-}

-

-STBIDEF int stbi_zlib_decode_buffer(char *obuffer, int olen, char const *ibuffer, int ilen)

-{

-   stbi__zbuf a;

-   a.zbuffer = (stbi_uc *) ibuffer;

-   a.zbuffer_end = (stbi_uc *) ibuffer + ilen;

-   if (stbi__do_zlib(&a, obuffer, olen, 0, 1))

-      return (int) (a.zout - a.zout_start);

-   else

-      return -1;

-}

-

-STBIDEF char *stbi_zlib_decode_noheader_malloc(char const *buffer, int len, int *outlen)

-{

-   stbi__zbuf a;

-   char *p = (char *) stbi__malloc(16384);

-   if (p == NULL) return NULL;

-   a.zbuffer = (stbi_uc *) buffer;

-   a.zbuffer_end = (stbi_uc *) buffer+len;

-   if (stbi__do_zlib(&a, p, 16384, 1, 0)) {

-      if (outlen) *outlen = (int) (a.zout - a.zout_start);

-      return a.zout_start;

-   } else {

-      STBI_FREE(a.zout_start);

-      return NULL;

-   }

-}

-

-STBIDEF int stbi_zlib_decode_noheader_buffer(char *obuffer, int olen, const char *ibuffer, int ilen)

-{

-   stbi__zbuf a;

-   a.zbuffer = (stbi_uc *) ibuffer;

-   a.zbuffer_end = (stbi_uc *) ibuffer + ilen;

-   if (stbi__do_zlib(&a, obuffer, olen, 0, 0))

-      return (int) (a.zout - a.zout_start);

-   else

-      return -1;

-}

-#endif

-

-// public domain "baseline" PNG decoder   v0.10  Sean Barrett 2006-11-18

-//    simple implementation

-//      - only 8-bit samples

-//      - no CRC checking

-//      - allocates lots of intermediate memory

-//        - avoids problem of streaming data between subsystems

-//        - avoids explicit window management

-//    performance

-//      - uses stb_zlib, a PD zlib implementation with fast huffman decoding

-

-#ifndef STBI_NO_PNG

-typedef struct

-{

-   stbi__uint32 length;

-   stbi__uint32 type;

-} stbi__pngchunk;

-

-static stbi__pngchunk stbi__get_chunk_header(stbi__context *s)

-{

-   stbi__pngchunk c;

-   c.length = stbi__get32be(s);

-   c.type   = stbi__get32be(s);

-   return c;

-}

-

-static int stbi__check_png_header(stbi__context *s)

-{

-   static const stbi_uc png_sig[8] = { 137,80,78,71,13,10,26,10 };

-   int i;

-   for (i=0; i < 8; ++i)

-      if (stbi__get8(s) != png_sig[i]) return stbi__err("bad png sig","Not a PNG");

-   return 1;

-}

-

-typedef struct

-{

-   stbi__context *s;

-   stbi_uc *idata, *expanded, *out;

-   int depth;

-} stbi__png;

-

-

-enum {

-   STBI__F_none=0,

-   STBI__F_sub=1,

-   STBI__F_up=2,

-   STBI__F_avg=3,

-   STBI__F_paeth=4,

-   // synthetic filters used for first scanline to avoid needing a dummy row of 0s

-   STBI__F_avg_first,

-   STBI__F_paeth_first

-};

-

-static stbi_uc first_row_filter[5] =

-{

-   STBI__F_none,

-   STBI__F_sub,

-   STBI__F_none,

-   STBI__F_avg_first,

-   STBI__F_paeth_first

-};

-

-static int stbi__paeth(int a, int b, int c)

-{

-   int p = a + b - c;

-   int pa = abs(p-a);

-   int pb = abs(p-b);

-   int pc = abs(p-c);

-   if (pa <= pb && pa <= pc) return a;

-   if (pb <= pc) return b;

-   return c;

-}

-

-static const stbi_uc stbi__depth_scale_table[9] = { 0, 0xff, 0x55, 0, 0x11, 0,0,0, 0x01 };

-

-// create the png data from post-deflated data

-static int stbi__create_png_image_raw(stbi__png *a, stbi_uc *raw, stbi__uint32 raw_len, int out_n, stbi__uint32 x, stbi__uint32 y, int depth, int color)

-{

-   int bytes = (depth == 16? 2 : 1);

-   stbi__context *s = a->s;

-   stbi__uint32 i,j,stride = x*out_n*bytes;

-   stbi__uint32 img_len, img_width_bytes;

-   int k;

-   int img_n = s->img_n; // copy it into a local for later

-

-   int output_bytes = out_n*bytes;

-   int filter_bytes = img_n*bytes;

-   int width = x;

-

-   STBI_ASSERT(out_n == s->img_n || out_n == s->img_n+1);

-   a->out = (stbi_uc *) stbi__malloc_mad3(x, y, output_bytes, 0); // extra bytes to write off the end into

-   if (!a->out) return stbi__err("outofmem", "Out of memory");

-

-   if (!stbi__mad3sizes_valid(img_n, x, depth, 7)) return stbi__err("too large", "Corrupt PNG");

-   img_width_bytes = (((img_n * x * depth) + 7) >> 3);

-   img_len = (img_width_bytes + 1) * y;

-

-   // we used to check for exact match between raw_len and img_len on non-interlaced PNGs,

-   // but issue #276 reported a PNG in the wild that had extra data at the end (all zeros),

-   // so just check for raw_len < img_len always.

-   if (raw_len < img_len) return stbi__err("not enough pixels","Corrupt PNG");

-

-   for (j=0; j < y; ++j) {

-      stbi_uc *cur = a->out + stride*j;

-      stbi_uc *prior;

-      int filter = *raw++;

-

-      if (filter > 4)

-         return stbi__err("invalid filter","Corrupt PNG");

-

-      if (depth < 8) {

-         STBI_ASSERT(img_width_bytes <= x);

-         cur += x*out_n - img_width_bytes; // store output to the rightmost img_len bytes, so we can decode in place

-         filter_bytes = 1;

-         width = img_width_bytes;

-      }

-      prior = cur - stride; // bugfix: need to compute this after 'cur +=' computation above

-

-      // if first row, use special filter that doesn't sample previous row

-      if (j == 0) filter = first_row_filter[filter];

-

-      // handle first byte explicitly

-      for (k=0; k < filter_bytes; ++k) {

-         switch (filter) {

-            case STBI__F_none       : cur[k] = raw[k]; break;

-            case STBI__F_sub        : cur[k] = raw[k]; break;

-            case STBI__F_up         : cur[k] = STBI__BYTECAST(raw[k] + prior[k]); break;

-            case STBI__F_avg        : cur[k] = STBI__BYTECAST(raw[k] + (prior[k]>>1)); break;

-            case STBI__F_paeth      : cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(0,prior[k],0)); break;

-            case STBI__F_avg_first  : cur[k] = raw[k]; break;

-            case STBI__F_paeth_first: cur[k] = raw[k]; break;

-         }

-      }

-

-      if (depth == 8) {

-         if (img_n != out_n)

-            cur[img_n] = 255; // first pixel

-         raw += img_n;

-         cur += out_n;

-         prior += out_n;

-      } else if (depth == 16) {

-         if (img_n != out_n) {

-            cur[filter_bytes]   = 255; // first pixel top byte

-            cur[filter_bytes+1] = 255; // first pixel bottom byte

-         }

-         raw += filter_bytes;

-         cur += output_bytes;

-         prior += output_bytes;

-      } else {

-         raw += 1;

-         cur += 1;

-         prior += 1;

-      }

-

-      // this is a little gross, so that we don't switch per-pixel or per-component

-      if (depth < 8 || img_n == out_n) {

-         int nk = (width - 1)*filter_bytes;

-         #define STBI__CASE(f) \

-             case f:     \

-                for (k=0; k < nk; ++k)

-         switch (filter) {

-            // "none" filter turns into a memcpy here; make that explicit.

-            case STBI__F_none:         memcpy(cur, raw, nk); break;

-            STBI__CASE(STBI__F_sub)          { cur[k] = STBI__BYTECAST(raw[k] + cur[k-filter_bytes]); } break;

-            STBI__CASE(STBI__F_up)           { cur[k] = STBI__BYTECAST(raw[k] + prior[k]); } break;

-            STBI__CASE(STBI__F_avg)          { cur[k] = STBI__BYTECAST(raw[k] + ((prior[k] + cur[k-filter_bytes])>>1)); } break;

-            STBI__CASE(STBI__F_paeth)        { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k-filter_bytes],prior[k],prior[k-filter_bytes])); } break;

-            STBI__CASE(STBI__F_avg_first)    { cur[k] = STBI__BYTECAST(raw[k] + (cur[k-filter_bytes] >> 1)); } break;

-            STBI__CASE(STBI__F_paeth_first)  { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k-filter_bytes],0,0)); } break;

-         }

-         #undef STBI__CASE

-         raw += nk;

-      } else {

-         STBI_ASSERT(img_n+1 == out_n);

-         #define STBI__CASE(f) \

-             case f:     \

-                for (i=x-1; i >= 1; --i, cur[filter_bytes]=255,raw+=filter_bytes,cur+=output_bytes,prior+=output_bytes) \

-                   for (k=0; k < filter_bytes; ++k)

-         switch (filter) {

-            STBI__CASE(STBI__F_none)         { cur[k] = raw[k]; } break;

-            STBI__CASE(STBI__F_sub)          { cur[k] = STBI__BYTECAST(raw[k] + cur[k- output_bytes]); } break;

-            STBI__CASE(STBI__F_up)           { cur[k] = STBI__BYTECAST(raw[k] + prior[k]); } break;

-            STBI__CASE(STBI__F_avg)          { cur[k] = STBI__BYTECAST(raw[k] + ((prior[k] + cur[k- output_bytes])>>1)); } break;

-            STBI__CASE(STBI__F_paeth)        { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k- output_bytes],prior[k],prior[k- output_bytes])); } break;

-            STBI__CASE(STBI__F_avg_first)    { cur[k] = STBI__BYTECAST(raw[k] + (cur[k- output_bytes] >> 1)); } break;

-            STBI__CASE(STBI__F_paeth_first)  { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k- output_bytes],0,0)); } break;

-         }

-         #undef STBI__CASE

-

-         // the loop above sets the high byte of the pixels' alpha, but for

-         // 16 bit png files we also need the low byte set. we'll do that here.

-         if (depth == 16) {

-            cur = a->out + stride*j; // start at the beginning of the row again

-            for (i=0; i < x; ++i,cur+=output_bytes) {

-               cur[filter_bytes+1] = 255;

-            }

-         }

-      }

-   }

-

-   // we make a separate pass to expand bits to pixels; for performance,

-   // this could run two scanlines behind the above code, so it won't

-   // intefere with filtering but will still be in the cache.

-   if (depth < 8) {

-      for (j=0; j < y; ++j) {

-         stbi_uc *cur = a->out + stride*j;

-         stbi_uc *in  = a->out + stride*j + x*out_n - img_width_bytes;

-         // unpack 1/2/4-bit into a 8-bit buffer. allows us to keep the common 8-bit path optimal at minimal cost for 1/2/4-bit

-         // png guarante byte alignment, if width is not multiple of 8/4/2 we'll decode dummy trailing data that will be skipped in the later loop

-         stbi_uc scale = (color == 0) ? stbi__depth_scale_table[depth] : 1; // scale grayscale values to 0..255 range

-

-         // note that the final byte might overshoot and write more data than desired.

-         // we can allocate enough data that this never writes out of memory, but it

-         // could also overwrite the next scanline. can it overwrite non-empty data

-         // on the next scanline? yes, consider 1-pixel-wide scanlines with 1-bit-per-pixel.

-         // so we need to explicitly clamp the final ones

-

-         if (depth == 4) {

-            for (k=x*img_n; k >= 2; k-=2, ++in) {

-               *cur++ = scale * ((*in >> 4)       );

-               *cur++ = scale * ((*in     ) & 0x0f);

-            }

-            if (k > 0) *cur++ = scale * ((*in >> 4)       );

-         } else if (depth == 2) {

-            for (k=x*img_n; k >= 4; k-=4, ++in) {

-               *cur++ = scale * ((*in >> 6)       );

-               *cur++ = scale * ((*in >> 4) & 0x03);

-               *cur++ = scale * ((*in >> 2) & 0x03);

-               *cur++ = scale * ((*in     ) & 0x03);

-            }

-            if (k > 0) *cur++ = scale * ((*in >> 6)       );

-            if (k > 1) *cur++ = scale * ((*in >> 4) & 0x03);

-            if (k > 2) *cur++ = scale * ((*in >> 2) & 0x03);

-         } else if (depth == 1) {

-            for (k=x*img_n; k >= 8; k-=8, ++in) {

-               *cur++ = scale * ((*in >> 7)       );

-               *cur++ = scale * ((*in >> 6) & 0x01);

-               *cur++ = scale * ((*in >> 5) & 0x01);

-               *cur++ = scale * ((*in >> 4) & 0x01);

-               *cur++ = scale * ((*in >> 3) & 0x01);

-               *cur++ = scale * ((*in >> 2) & 0x01);

-               *cur++ = scale * ((*in >> 1) & 0x01);

-               *cur++ = scale * ((*in     ) & 0x01);

-            }

-            if (k > 0) *cur++ = scale * ((*in >> 7)       );

-            if (k > 1) *cur++ = scale * ((*in >> 6) & 0x01);

-            if (k > 2) *cur++ = scale * ((*in >> 5) & 0x01);

-            if (k > 3) *cur++ = scale * ((*in >> 4) & 0x01);

-            if (k > 4) *cur++ = scale * ((*in >> 3) & 0x01);

-            if (k > 5) *cur++ = scale * ((*in >> 2) & 0x01);

-            if (k > 6) *cur++ = scale * ((*in >> 1) & 0x01);

-         }

-         if (img_n != out_n) {

-            int q;

-            // insert alpha = 255

-            cur = a->out + stride*j;

-            if (img_n == 1) {

-               for (q=x-1; q >= 0; --q) {

-                  cur[q*2+1] = 255;

-                  cur[q*2+0] = cur[q];

-               }

-            } else {

-               STBI_ASSERT(img_n == 3);

-               for (q=x-1; q >= 0; --q) {

-                  cur[q*4+3] = 255;

-                  cur[q*4+2] = cur[q*3+2];

-                  cur[q*4+1] = cur[q*3+1];

-                  cur[q*4+0] = cur[q*3+0];

-               }

-            }

-         }

-      }

-   } else if (depth == 16) {

-      // force the image data from big-endian to platform-native.

-      // this is done in a separate pass due to the decoding relying

-      // on the data being untouched, but could probably be done

-      // per-line during decode if care is taken.

-      stbi_uc *cur = a->out;

-      stbi__uint16 *cur16 = (stbi__uint16*)cur;

-

-      for(i=0; i < x*y*out_n; ++i,cur16++,cur+=2) {

-         *cur16 = (cur[0] << 8) | cur[1];

-      }

-   }

-

-   return 1;

-}

-

-static int stbi__create_png_image(stbi__png *a, stbi_uc *image_data, stbi__uint32 image_data_len, int out_n, int depth, int color, int interlaced)

-{

-   int bytes = (depth == 16 ? 2 : 1);

-   int out_bytes = out_n * bytes;

-   stbi_uc *final;

-   int p;

-   if (!interlaced)

-      return stbi__create_png_image_raw(a, image_data, image_data_len, out_n, a->s->img_x, a->s->img_y, depth, color);

-

-   // de-interlacing

-   final = (stbi_uc *) stbi__malloc_mad3(a->s->img_x, a->s->img_y, out_bytes, 0);

-   for (p=0; p < 7; ++p) {

-      int xorig[] = { 0,4,0,2,0,1,0 };

-      int yorig[] = { 0,0,4,0,2,0,1 };

-      int xspc[]  = { 8,8,4,4,2,2,1 };

-      int yspc[]  = { 8,8,8,4,4,2,2 };

-      int i,j,x,y;

-      // pass1_x[4] = 0, pass1_x[5] = 1, pass1_x[12] = 1

-      x = (a->s->img_x - xorig[p] + xspc[p]-1) / xspc[p];

-      y = (a->s->img_y - yorig[p] + yspc[p]-1) / yspc[p];

-      if (x && y) {

-         stbi__uint32 img_len = ((((a->s->img_n * x * depth) + 7) >> 3) + 1) * y;

-         if (!stbi__create_png_image_raw(a, image_data, image_data_len, out_n, x, y, depth, color)) {

-            STBI_FREE(final);

-            return 0;

-         }

-         for (j=0; j < y; ++j) {

-            for (i=0; i < x; ++i) {

-               int out_y = j*yspc[p]+yorig[p];

-               int out_x = i*xspc[p]+xorig[p];

-               memcpy(final + out_y*a->s->img_x*out_bytes + out_x*out_bytes,

-                      a->out + (j*x+i)*out_bytes, out_bytes);

-            }

-         }

-         STBI_FREE(a->out);

-         image_data += img_len;

-         image_data_len -= img_len;

-      }

-   }

-   a->out = final;

-

-   return 1;

-}

-

-static int stbi__compute_transparency(stbi__png *z, stbi_uc tc[3], int out_n)

-{

-   stbi__context *s = z->s;

-   stbi__uint32 i, pixel_count = s->img_x * s->img_y;

-   stbi_uc *p = z->out;

-

-   // compute color-based transparency, assuming we've

-   // already got 255 as the alpha value in the output

-   STBI_ASSERT(out_n == 2 || out_n == 4);

-

-   if (out_n == 2) {

-      for (i=0; i < pixel_count; ++i) {

-         p[1] = (p[0] == tc[0] ? 0 : 255);

-         p += 2;

-      }

-   } else {

-      for (i=0; i < pixel_count; ++i) {

-         if (p[0] == tc[0] && p[1] == tc[1] && p[2] == tc[2])

-            p[3] = 0;

-         p += 4;

-      }

-   }

-   return 1;

-}

-

-static int stbi__compute_transparency16(stbi__png *z, stbi__uint16 tc[3], int out_n)

-{

-   stbi__context *s = z->s;

-   stbi__uint32 i, pixel_count = s->img_x * s->img_y;

-   stbi__uint16 *p = (stbi__uint16*) z->out;

-

-   // compute color-based transparency, assuming we've

-   // already got 65535 as the alpha value in the output

-   STBI_ASSERT(out_n == 2 || out_n == 4);

-

-   if (out_n == 2) {

-      for (i = 0; i < pixel_count; ++i) {

-         p[1] = (p[0] == tc[0] ? 0 : 65535);

-         p += 2;

-      }

-   } else {

-      for (i = 0; i < pixel_count; ++i) {

-         if (p[0] == tc[0] && p[1] == tc[1] && p[2] == tc[2])

-            p[3] = 0;

-         p += 4;

-      }

-   }

-   return 1;

-}

-

-static int stbi__expand_png_palette(stbi__png *a, stbi_uc *palette, int len, int pal_img_n)

-{

-   stbi__uint32 i, pixel_count = a->s->img_x * a->s->img_y;

-   stbi_uc *p, *temp_out, *orig = a->out;

-

-   p = (stbi_uc *) stbi__malloc_mad2(pixel_count, pal_img_n, 0);

-   if (p == NULL) return stbi__err("outofmem", "Out of memory");

-

-   // between here and free(out) below, exitting would leak

-   temp_out = p;

-

-   if (pal_img_n == 3) {

-      for (i=0; i < pixel_count; ++i) {

-         int n = orig[i]*4;

-         p[0] = palette[n  ];

-         p[1] = palette[n+1];

-         p[2] = palette[n+2];

-         p += 3;

-      }

-   } else {

-      for (i=0; i < pixel_count; ++i) {

-         int n = orig[i]*4;

-         p[0] = palette[n  ];

-         p[1] = palette[n+1];

-         p[2] = palette[n+2];

-         p[3] = palette[n+3];

-         p += 4;

-      }

-   }

-   STBI_FREE(a->out);

-   a->out = temp_out;

-

-   STBI_NOTUSED(len);

-

-   return 1;

-}

-

-static int stbi__unpremultiply_on_load = 0;

-static int stbi__de_iphone_flag = 0;

-

-STBIDEF void stbi_set_unpremultiply_on_load(int flag_true_if_should_unpremultiply)

-{

-   stbi__unpremultiply_on_load = flag_true_if_should_unpremultiply;

-}

-

-STBIDEF void stbi_convert_iphone_png_to_rgb(int flag_true_if_should_convert)

-{

-   stbi__de_iphone_flag = flag_true_if_should_convert;

-}

-

-static void stbi__de_iphone(stbi__png *z)

-{

-   stbi__context *s = z->s;

-   stbi__uint32 i, pixel_count = s->img_x * s->img_y;

-   stbi_uc *p = z->out;

-

-   if (s->img_out_n == 3) {  // convert bgr to rgb

-      for (i=0; i < pixel_count; ++i) {

-         stbi_uc t = p[0];

-         p[0] = p[2];

-         p[2] = t;

-         p += 3;

-      }

-   } else {

-      STBI_ASSERT(s->img_out_n == 4);

-      if (stbi__unpremultiply_on_load) {

-         // convert bgr to rgb and unpremultiply

-         for (i=0; i < pixel_count; ++i) {

-            stbi_uc a = p[3];

-            stbi_uc t = p[0];

-            if (a) {

-               stbi_uc half = a / 2;

-               p[0] = (p[2] * 255 + half) / a;

-               p[1] = (p[1] * 255 + half) / a;

-               p[2] = ( t   * 255 + half) / a;

-            } else {

-               p[0] = p[2];

-               p[2] = t;

-            }

-            p += 4;

-         }

-      } else {

-         // convert bgr to rgb

-         for (i=0; i < pixel_count; ++i) {

-            stbi_uc t = p[0];

-            p[0] = p[2];

-            p[2] = t;

-            p += 4;

-         }

-      }

-   }

-}

-

-#define STBI__PNG_TYPE(a,b,c,d)  (((unsigned) (a) << 24) + ((unsigned) (b) << 16) + ((unsigned) (c) << 8) + (unsigned) (d))

-

-static int stbi__parse_png_file(stbi__png *z, int scan, int req_comp)

-{

-   stbi_uc palette[1024], pal_img_n=0;

-   stbi_uc has_trans=0, tc[3]={0};

-   stbi__uint16 tc16[3];

-   stbi__uint32 ioff=0, idata_limit=0, i, pal_len=0;

-   int first=1,k,interlace=0, color=0, is_iphone=0;

-   stbi__context *s = z->s;

-

-   z->expanded = NULL;

-   z->idata = NULL;

-   z->out = NULL;

-

-   if (!stbi__check_png_header(s)) return 0;

-

-   if (scan == STBI__SCAN_type) return 1;

-

-   for (;;) {

-      stbi__pngchunk c = stbi__get_chunk_header(s);

-      switch (c.type) {

-         case STBI__PNG_TYPE('C','g','B','I'):

-            is_iphone = 1;

-            stbi__skip(s, c.length);

-            break;

-         case STBI__PNG_TYPE('I','H','D','R'): {

-            int comp,filter;

-            if (!first) return stbi__err("multiple IHDR","Corrupt PNG");

-            first = 0;

-            if (c.length != 13) return stbi__err("bad IHDR len","Corrupt PNG");

-            s->img_x = stbi__get32be(s); if (s->img_x > (1 << 24)) return stbi__err("too large","Very large image (corrupt?)");

-            s->img_y = stbi__get32be(s); if (s->img_y > (1 << 24)) return stbi__err("too large","Very large image (corrupt?)");

-            z->depth = stbi__get8(s);  if (z->depth != 1 && z->depth != 2 && z->depth != 4 && z->depth != 8 && z->depth != 16)  return stbi__err("1/2/4/8/16-bit only","PNG not supported: 1/2/4/8/16-bit only");

-            color = stbi__get8(s);  if (color > 6)         return stbi__err("bad ctype","Corrupt PNG");

-            if (color == 3 && z->depth == 16)                  return stbi__err("bad ctype","Corrupt PNG");

-            if (color == 3) pal_img_n = 3; else if (color & 1) return stbi__err("bad ctype","Corrupt PNG");

-            comp  = stbi__get8(s);  if (comp) return stbi__err("bad comp method","Corrupt PNG");

-            filter= stbi__get8(s);  if (filter) return stbi__err("bad filter method","Corrupt PNG");

-            interlace = stbi__get8(s); if (interlace>1) return stbi__err("bad interlace method","Corrupt PNG");

-            if (!s->img_x || !s->img_y) return stbi__err("0-pixel image","Corrupt PNG");

-            if (!pal_img_n) {

-               s->img_n = (color & 2 ? 3 : 1) + (color & 4 ? 1 : 0);

-               if ((1 << 30) / s->img_x / s->img_n < s->img_y) return stbi__err("too large", "Image too large to decode");

-               if (scan == STBI__SCAN_header) return 1;

-            } else {

-               // if paletted, then pal_n is our final components, and

-               // img_n is # components to decompress/filter.

-               s->img_n = 1;

-               if ((1 << 30) / s->img_x / 4 < s->img_y) return stbi__err("too large","Corrupt PNG");

-               // if SCAN_header, have to scan to see if we have a tRNS

-            }

-            break;

-         }

-

-         case STBI__PNG_TYPE('P','L','T','E'):  {

-            if (first) return stbi__err("first not IHDR", "Corrupt PNG");

-            if (c.length > 256*3) return stbi__err("invalid PLTE","Corrupt PNG");

-            pal_len = c.length / 3;

-            if (pal_len * 3 != c.length) return stbi__err("invalid PLTE","Corrupt PNG");

-            for (i=0; i < pal_len; ++i) {

-               palette[i*4+0] = stbi__get8(s);

-               palette[i*4+1] = stbi__get8(s);

-               palette[i*4+2] = stbi__get8(s);

-               palette[i*4+3] = 255;

-            }

-            break;

-         }

-

-         case STBI__PNG_TYPE('t','R','N','S'): {

-            if (first) return stbi__err("first not IHDR", "Corrupt PNG");

-            if (z->idata) return stbi__err("tRNS after IDAT","Corrupt PNG");

-            if (pal_img_n) {

-               if (scan == STBI__SCAN_header) { s->img_n = 4; return 1; }

-               if (pal_len == 0) return stbi__err("tRNS before PLTE","Corrupt PNG");

-               if (c.length > pal_len) return stbi__err("bad tRNS len","Corrupt PNG");

-               pal_img_n = 4;

-               for (i=0; i < c.length; ++i)

-                  palette[i*4+3] = stbi__get8(s);

-            } else {

-               if (!(s->img_n & 1)) return stbi__err("tRNS with alpha","Corrupt PNG");

-               if (c.length != (stbi__uint32) s->img_n*2) return stbi__err("bad tRNS len","Corrupt PNG");

-               has_trans = 1;

-               if (z->depth == 16) {

-                  for (k = 0; k < s->img_n; ++k) tc16[k] = (stbi__uint16)stbi__get16be(s); // copy the values as-is

-               } else {

-                  for (k = 0; k < s->img_n; ++k) tc[k] = (stbi_uc)(stbi__get16be(s) & 255) * stbi__depth_scale_table[z->depth]; // non 8-bit images will be larger

-               }

-            }

-            break;

-         }

-

-         case STBI__PNG_TYPE('I','D','A','T'): {

-            if (first) return stbi__err("first not IHDR", "Corrupt PNG");

-            if (pal_img_n && !pal_len) return stbi__err("no PLTE","Corrupt PNG");

-            if (scan == STBI__SCAN_header) { s->img_n = pal_img_n; return 1; }

-            if ((int)(ioff + c.length) < (int)ioff) return 0;

-            if (ioff + c.length > idata_limit) {

-               stbi__uint32 idata_limit_old = idata_limit;

-               stbi_uc *p;

-               if (idata_limit == 0) idata_limit = c.length > 4096 ? c.length : 4096;

-               while (ioff + c.length > idata_limit)

-                  idata_limit *= 2;

-               STBI_NOTUSED(idata_limit_old);

-               p = (stbi_uc *) STBI_REALLOC_SIZED(z->idata, idata_limit_old, idata_limit); if (p == NULL) return stbi__err("outofmem", "Out of memory");

-               z->idata = p;

-            }

-            if (!stbi__getn(s, z->idata+ioff,c.length)) return stbi__err("outofdata","Corrupt PNG");

-            ioff += c.length;

-            break;

-         }

-

-         case STBI__PNG_TYPE('I','E','N','D'): {

-            stbi__uint32 raw_len, bpl;

-            if (first) return stbi__err("first not IHDR", "Corrupt PNG");

-            if (scan != STBI__SCAN_load) return 1;

-            if (z->idata == NULL) return stbi__err("no IDAT","Corrupt PNG");

-            // initial guess for decoded data size to avoid unnecessary reallocs

-            bpl = (s->img_x * z->depth + 7) / 8; // bytes per line, per component

-            raw_len = bpl * s->img_y * s->img_n /* pixels */ + s->img_y /* filter mode per row */;

-            z->expanded = (stbi_uc *) stbi_zlib_decode_malloc_guesssize_headerflag((char *) z->idata, ioff, raw_len, (int *) &raw_len, !is_iphone);

-            if (z->expanded == NULL) return 0; // zlib should set error

-            STBI_FREE(z->idata); z->idata = NULL;

-            if ((req_comp == s->img_n+1 && req_comp != 3 && !pal_img_n) || has_trans)

-               s->img_out_n = s->img_n+1;

-            else

-               s->img_out_n = s->img_n;

-            if (!stbi__create_png_image(z, z->expanded, raw_len, s->img_out_n, z->depth, color, interlace)) return 0;

-            if (has_trans) {

-               if (z->depth == 16) {

-                  if (!stbi__compute_transparency16(z, tc16, s->img_out_n)) return 0;

-               } else {

-                  if (!stbi__compute_transparency(z, tc, s->img_out_n)) return 0;

-               }

-            }

-            if (is_iphone && stbi__de_iphone_flag && s->img_out_n > 2)

-               stbi__de_iphone(z);

-            if (pal_img_n) {

-               // pal_img_n == 3 or 4

-               s->img_n = pal_img_n; // record the actual colors we had

-               s->img_out_n = pal_img_n;

-               if (req_comp >= 3) s->img_out_n = req_comp;

-               if (!stbi__expand_png_palette(z, palette, pal_len, s->img_out_n))

-                  return 0;

-            } else if (has_trans) {

-               // non-paletted image with tRNS -> source image has (constant) alpha

-               ++s->img_n;

-            }

-            STBI_FREE(z->expanded); z->expanded = NULL;

-            return 1;

-         }

-

-         default:

-            // if critical, fail

-            if (first) return stbi__err("first not IHDR", "Corrupt PNG");

-            if ((c.type & (1 << 29)) == 0) {

-               #ifndef STBI_NO_FAILURE_STRINGS

-               // not threadsafe

-               static char invalid_chunk[] = "XXXX PNG chunk not known";

-               invalid_chunk[0] = STBI__BYTECAST(c.type >> 24);

-               invalid_chunk[1] = STBI__BYTECAST(c.type >> 16);

-               invalid_chunk[2] = STBI__BYTECAST(c.type >>  8);

-               invalid_chunk[3] = STBI__BYTECAST(c.type >>  0);

-               #endif

-               return stbi__err(invalid_chunk, "PNG not supported: unknown PNG chunk type");

-            }

-            stbi__skip(s, c.length);

-            break;

-      }

-      // end of PNG chunk, read and skip CRC

-      stbi__get32be(s);

-   }

-}

-

-static void *stbi__do_png(stbi__png *p, int *x, int *y, int *n, int req_comp, stbi__result_info *ri)

-{

-   void *result=NULL;

-   if (req_comp < 0 || req_comp > 4) return stbi__errpuc("bad req_comp", "Internal error");

-   if (stbi__parse_png_file(p, STBI__SCAN_load, req_comp)) {

-      if (p->depth < 8)

-         ri->bits_per_channel = 8;

-      else

-         ri->bits_per_channel = p->depth;

-      result = p->out;

-      p->out = NULL;

-      if (req_comp && req_comp != p->s->img_out_n) {

-         if (ri->bits_per_channel == 8)

-            result = stbi__convert_format((unsigned char *) result, p->s->img_out_n, req_comp, p->s->img_x, p->s->img_y);

-         else

-            result = stbi__convert_format16((stbi__uint16 *) result, p->s->img_out_n, req_comp, p->s->img_x, p->s->img_y);

-         p->s->img_out_n = req_comp;

-         if (result == NULL) return result;

-      }

-      *x = p->s->img_x;

-      *y = p->s->img_y;

-      if (n) *n = p->s->img_n;

-   }

-   STBI_FREE(p->out);      p->out      = NULL;

-   STBI_FREE(p->expanded); p->expanded = NULL;

-   STBI_FREE(p->idata);    p->idata    = NULL;

-

-   return result;

-}

-

-static void *stbi__png_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri)

-{

-   stbi__png p;

-   p.s = s;

-   return stbi__do_png(&p, x,y,comp,req_comp, ri);

-}

-

-static int stbi__png_test(stbi__context *s)

-{

-   int r;

-   r = stbi__check_png_header(s);

-   stbi__rewind(s);

-   return r;

-}

-

-static int stbi__png_info_raw(stbi__png *p, int *x, int *y, int *comp)

-{

-   if (!stbi__parse_png_file(p, STBI__SCAN_header, 0)) {

-      stbi__rewind( p->s );

-      return 0;

-   }

-   if (x) *x = p->s->img_x;

-   if (y) *y = p->s->img_y;

-   if (comp) *comp = p->s->img_n;

-   return 1;

-}

-

-static int stbi__png_info(stbi__context *s, int *x, int *y, int *comp)

-{

-   stbi__png p;

-   p.s = s;

-   return stbi__png_info_raw(&p, x, y, comp);

-}

-

-static int stbi__png_is16(stbi__context *s)

-{

-   stbi__png p;

-   p.s = s;

-   if (!stbi__png_info_raw(&p, NULL, NULL, NULL))

-	   return 0;

-   if (p.depth != 16) {

-      stbi__rewind(p.s);

-      return 0;

-   }

-   return 1;

-}

-#endif

-

-// Microsoft/Windows BMP image

-

-#ifndef STBI_NO_BMP

-static int stbi__bmp_test_raw(stbi__context *s)

-{

-   int r;

-   int sz;

-   if (stbi__get8(s) != 'B') return 0;

-   if (stbi__get8(s) != 'M') return 0;

-   stbi__get32le(s); // discard filesize

-   stbi__get16le(s); // discard reserved

-   stbi__get16le(s); // discard reserved

-   stbi__get32le(s); // discard data offset

-   sz = stbi__get32le(s);

-   r = (sz == 12 || sz == 40 || sz == 56 || sz == 108 || sz == 124);

-   return r;

-}

-

-static int stbi__bmp_test(stbi__context *s)

-{

-   int r = stbi__bmp_test_raw(s);

-   stbi__rewind(s);

-   return r;

-}

-

-

-// returns 0..31 for the highest set bit

-static int stbi__high_bit(unsigned int z)

-{

-   int n=0;

-   if (z == 0) return -1;

-   if (z >= 0x10000) { n += 16; z >>= 16; }

-   if (z >= 0x00100) { n +=  8; z >>=  8; }

-   if (z >= 0x00010) { n +=  4; z >>=  4; }

-   if (z >= 0x00004) { n +=  2; z >>=  2; }

-   if (z >= 0x00002) { n +=  1; z >>=  1; }

-   return n;

-}

-

-static int stbi__bitcount(unsigned int a)

-{

-   a = (a & 0x55555555) + ((a >>  1) & 0x55555555); // max 2

-   a = (a & 0x33333333) + ((a >>  2) & 0x33333333); // max 4

-   a = (a + (a >> 4)) & 0x0f0f0f0f; // max 8 per 4, now 8 bits

-   a = (a + (a >> 8)); // max 16 per 8 bits

-   a = (a + (a >> 16)); // max 32 per 8 bits

-   return a & 0xff;

-}

-

-// extract an arbitrarily-aligned N-bit value (N=bits)

-// from v, and then make it 8-bits long and fractionally

-// extend it to full full range.

-static int stbi__shiftsigned(unsigned int v, int shift, int bits)

-{

-   static unsigned int mul_table[9] = {

-      0,

-      0xff/*0b11111111*/, 0x55/*0b01010101*/, 0x49/*0b01001001*/, 0x11/*0b00010001*/,

-      0x21/*0b00100001*/, 0x41/*0b01000001*/, 0x81/*0b10000001*/, 0x01/*0b00000001*/,

-   };

-   static unsigned int shift_table[9] = {

-      0, 0,0,1,0,2,4,6,0,

-   };

-   if (shift < 0)

-      v <<= -shift;

-   else

-      v >>= shift;

-   STBI_ASSERT(v >= 0 && v < 256);

-   v >>= (8-bits);

-   STBI_ASSERT(bits >= 0 && bits <= 8);

-   return (int) ((unsigned) v * mul_table[bits]) >> shift_table[bits];

-}

-

-typedef struct

-{

-   int bpp, offset, hsz;

-   unsigned int mr,mg,mb,ma, all_a;

-} stbi__bmp_data;

-

-static void *stbi__bmp_parse_header(stbi__context *s, stbi__bmp_data *info)

-{

-   int hsz;

-   if (stbi__get8(s) != 'B' || stbi__get8(s) != 'M') return stbi__errpuc("not BMP", "Corrupt BMP");

-   stbi__get32le(s); // discard filesize

-   stbi__get16le(s); // discard reserved

-   stbi__get16le(s); // discard reserved

-   info->offset = stbi__get32le(s);

-   info->hsz = hsz = stbi__get32le(s);

-   info->mr = info->mg = info->mb = info->ma = 0;

-

-   if (hsz != 12 && hsz != 40 && hsz != 56 && hsz != 108 && hsz != 124) return stbi__errpuc("unknown BMP", "BMP type not supported: unknown");

-   if (hsz == 12) {

-      s->img_x = stbi__get16le(s);

-      s->img_y = stbi__get16le(s);

-   } else {

-      s->img_x = stbi__get32le(s);

-      s->img_y = stbi__get32le(s);

-   }

-   if (stbi__get16le(s) != 1) return stbi__errpuc("bad BMP", "bad BMP");

-   info->bpp = stbi__get16le(s);

-   if (hsz != 12) {

-      int compress = stbi__get32le(s);

-      if (compress == 1 || compress == 2) return stbi__errpuc("BMP RLE", "BMP type not supported: RLE");

-      stbi__get32le(s); // discard sizeof

-      stbi__get32le(s); // discard hres

-      stbi__get32le(s); // discard vres

-      stbi__get32le(s); // discard colorsused

-      stbi__get32le(s); // discard max important

-      if (hsz == 40 || hsz == 56) {

-         if (hsz == 56) {

-            stbi__get32le(s);

-            stbi__get32le(s);

-            stbi__get32le(s);

-            stbi__get32le(s);

-         }

-         if (info->bpp == 16 || info->bpp == 32) {

-            if (compress == 0) {

-               if (info->bpp == 32) {

-                  info->mr = 0xffu << 16;

-                  info->mg = 0xffu <<  8;

-                  info->mb = 0xffu <<  0;

-                  info->ma = 0xffu << 24;

-                  info->all_a = 0; // if all_a is 0 at end, then we loaded alpha channel but it was all 0

-               } else {

-                  info->mr = 31u << 10;

-                  info->mg = 31u <<  5;

-                  info->mb = 31u <<  0;

-               }

-            } else if (compress == 3) {

-               info->mr = stbi__get32le(s);

-               info->mg = stbi__get32le(s);

-               info->mb = stbi__get32le(s);

-               // not documented, but generated by photoshop and handled by mspaint

-               if (info->mr == info->mg && info->mg == info->mb) {

-                  // ?!?!?

-                  return stbi__errpuc("bad BMP", "bad BMP");

-               }

-            } else

-               return stbi__errpuc("bad BMP", "bad BMP");

-         }

-      } else {

-         int i;

-         if (hsz != 108 && hsz != 124)

-            return stbi__errpuc("bad BMP", "bad BMP");

-         info->mr = stbi__get32le(s);

-         info->mg = stbi__get32le(s);

-         info->mb = stbi__get32le(s);

-         info->ma = stbi__get32le(s);

-         stbi__get32le(s); // discard color space

-         for (i=0; i < 12; ++i)

-            stbi__get32le(s); // discard color space parameters

-         if (hsz == 124) {

-            stbi__get32le(s); // discard rendering intent

-            stbi__get32le(s); // discard offset of profile data

-            stbi__get32le(s); // discard size of profile data

-            stbi__get32le(s); // discard reserved

-         }

-      }

-   }

-   return (void *) 1;

-}

-

-

-static void *stbi__bmp_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri)

-{

-   stbi_uc *out;

-   unsigned int mr=0,mg=0,mb=0,ma=0, all_a;

-   stbi_uc pal[256][4];

-   int psize=0,i,j,width;

-   int flip_vertically, pad, target;

-   stbi__bmp_data info;

-   STBI_NOTUSED(ri);

-

-   info.all_a = 255;

-   if (stbi__bmp_parse_header(s, &info) == NULL)

-      return NULL; // error code already set

-

-   flip_vertically = ((int) s->img_y) > 0;

-   s->img_y = abs((int) s->img_y);

-

-   mr = info.mr;

-   mg = info.mg;

-   mb = info.mb;

-   ma = info.ma;

-   all_a = info.all_a;

-

-   if (info.hsz == 12) {

-      if (info.bpp < 24)

-         psize = (info.offset - 14 - 24) / 3;

-   } else {

-      if (info.bpp < 16)

-         psize = (info.offset - 14 - info.hsz) >> 2;

-   }

-

-   s->img_n = ma ? 4 : 3;

-   if (req_comp && req_comp >= 3) // we can directly decode 3 or 4

-      target = req_comp;

-   else

-      target = s->img_n; // if they want monochrome, we'll post-convert

-

-   // sanity-check size

-   if (!stbi__mad3sizes_valid(target, s->img_x, s->img_y, 0))

-      return stbi__errpuc("too large", "Corrupt BMP");

-

-   out = (stbi_uc *) stbi__malloc_mad3(target, s->img_x, s->img_y, 0);

-   if (!out) return stbi__errpuc("outofmem", "Out of memory");

-   if (info.bpp < 16) {

-      int z=0;

-      if (psize == 0 || psize > 256) { STBI_FREE(out); return stbi__errpuc("invalid", "Corrupt BMP"); }

-      for (i=0; i < psize; ++i) {

-         pal[i][2] = stbi__get8(s);

-         pal[i][1] = stbi__get8(s);

-         pal[i][0] = stbi__get8(s);

-         if (info.hsz != 12) stbi__get8(s);

-         pal[i][3] = 255;

-      }

-      stbi__skip(s, info.offset - 14 - info.hsz - psize * (info.hsz == 12 ? 3 : 4));

-      if (info.bpp == 1) width = (s->img_x + 7) >> 3;

-      else if (info.bpp == 4) width = (s->img_x + 1) >> 1;

-      else if (info.bpp == 8) width = s->img_x;

-      else { STBI_FREE(out); return stbi__errpuc("bad bpp", "Corrupt BMP"); }

-      pad = (-width)&3;

-      if (info.bpp == 1) {

-         for (j=0; j < (int) s->img_y; ++j) {

-            int bit_offset = 7, v = stbi__get8(s);

-            for (i=0; i < (int) s->img_x; ++i) {

-               int color = (v>>bit_offset)&0x1;

-               out[z++] = pal[color][0];

-               out[z++] = pal[color][1];

-               out[z++] = pal[color][2];

-               if (target == 4) out[z++] = 255;

-               if (i+1 == (int) s->img_x) break;

-               if((--bit_offset) < 0) {

-                  bit_offset = 7;

-                  v = stbi__get8(s);

-               }

-            }

-            stbi__skip(s, pad);

-         }

-      } else {

-         for (j=0; j < (int) s->img_y; ++j) {

-            for (i=0; i < (int) s->img_x; i += 2) {

-               int v=stbi__get8(s),v2=0;

-               if (info.bpp == 4) {

-                  v2 = v & 15;

-                  v >>= 4;

-               }

-               out[z++] = pal[v][0];

-               out[z++] = pal[v][1];

-               out[z++] = pal[v][2];

-               if (target == 4) out[z++] = 255;

-               if (i+1 == (int) s->img_x) break;

-               v = (info.bpp == 8) ? stbi__get8(s) : v2;

-               out[z++] = pal[v][0];

-               out[z++] = pal[v][1];

-               out[z++] = pal[v][2];

-               if (target == 4) out[z++] = 255;

-            }

-            stbi__skip(s, pad);

-         }

-      }

-   } else {

-      int rshift=0,gshift=0,bshift=0,ashift=0,rcount=0,gcount=0,bcount=0,acount=0;

-      int z = 0;

-      int easy=0;

-      stbi__skip(s, info.offset - 14 - info.hsz);

-      if (info.bpp == 24) width = 3 * s->img_x;

-      else if (info.bpp == 16) width = 2*s->img_x;

-      else /* bpp = 32 and pad = 0 */ width=0;

-      pad = (-width) & 3;

-      if (info.bpp == 24) {

-         easy = 1;

-      } else if (info.bpp == 32) {

-         if (mb == 0xff && mg == 0xff00 && mr == 0x00ff0000 && ma == 0xff000000)

-            easy = 2;

-      }

-      if (!easy) {

-         if (!mr || !mg || !mb) { STBI_FREE(out); return stbi__errpuc("bad masks", "Corrupt BMP"); }

-         // right shift amt to put high bit in position #7

-         rshift = stbi__high_bit(mr)-7; rcount = stbi__bitcount(mr);

-         gshift = stbi__high_bit(mg)-7; gcount = stbi__bitcount(mg);

-         bshift = stbi__high_bit(mb)-7; bcount = stbi__bitcount(mb);

-         ashift = stbi__high_bit(ma)-7; acount = stbi__bitcount(ma);

-      }

-      for (j=0; j < (int) s->img_y; ++j) {

-         if (easy) {

-            for (i=0; i < (int) s->img_x; ++i) {

-               unsigned char a;

-               out[z+2] = stbi__get8(s);

-               out[z+1] = stbi__get8(s);

-               out[z+0] = stbi__get8(s);

-               z += 3;

-               a = (easy == 2 ? stbi__get8(s) : 255);

-               all_a |= a;

-               if (target == 4) out[z++] = a;

-            }

-         } else {

-            int bpp = info.bpp;

-            for (i=0; i < (int) s->img_x; ++i) {

-               stbi__uint32 v = (bpp == 16 ? (stbi__uint32) stbi__get16le(s) : stbi__get32le(s));

-               unsigned int a;

-               out[z++] = STBI__BYTECAST(stbi__shiftsigned(v & mr, rshift, rcount));

-               out[z++] = STBI__BYTECAST(stbi__shiftsigned(v & mg, gshift, gcount));

-               out[z++] = STBI__BYTECAST(stbi__shiftsigned(v & mb, bshift, bcount));

-               a = (ma ? stbi__shiftsigned(v & ma, ashift, acount) : 255);

-               all_a |= a;

-               if (target == 4) out[z++] = STBI__BYTECAST(a);

-            }

-         }

-         stbi__skip(s, pad);

-      }

-   }

-

-   // if alpha channel is all 0s, replace with all 255s

-   if (target == 4 && all_a == 0)

-      for (i=4*s->img_x*s->img_y-1; i >= 0; i -= 4)

-         out[i] = 255;

-

-   if (flip_vertically) {

-      stbi_uc t;

-      for (j=0; j < (int) s->img_y>>1; ++j) {

-         stbi_uc *p1 = out +      j     *s->img_x*target;

-         stbi_uc *p2 = out + (s->img_y-1-j)*s->img_x*target;

-         for (i=0; i < (int) s->img_x*target; ++i) {

-            t = p1[i]; p1[i] = p2[i]; p2[i] = t;

-         }

-      }

-   }

-

-   if (req_comp && req_comp != target) {

-      out = stbi__convert_format(out, target, req_comp, s->img_x, s->img_y);

-      if (out == NULL) return out; // stbi__convert_format frees input on failure

-   }

-

-   *x = s->img_x;

-   *y = s->img_y;

-   if (comp) *comp = s->img_n;

-   return out;

-}

-#endif

-

-// Targa Truevision - TGA

-// by Jonathan Dummer

-#ifndef STBI_NO_TGA

-// returns STBI_rgb or whatever, 0 on error

-static int stbi__tga_get_comp(int bits_per_pixel, int is_grey, int* is_rgb16)

-{

-   // only RGB or RGBA (incl. 16bit) or grey allowed

-   if (is_rgb16) *is_rgb16 = 0;

-   switch(bits_per_pixel) {

-      case 8:  return STBI_grey;

-      case 16: if(is_grey) return STBI_grey_alpha;

-               // fallthrough

-      case 15: if(is_rgb16) *is_rgb16 = 1;

-               return STBI_rgb;

-      case 24: // fallthrough

-      case 32: return bits_per_pixel/8;

-      default: return 0;

-   }

-}

-

-static int stbi__tga_info(stbi__context *s, int *x, int *y, int *comp)

-{

-    int tga_w, tga_h, tga_comp, tga_image_type, tga_bits_per_pixel, tga_colormap_bpp;

-    int sz, tga_colormap_type;

-    stbi__get8(s);                   // discard Offset

-    tga_colormap_type = stbi__get8(s); // colormap type

-    if( tga_colormap_type > 1 ) {

-        stbi__rewind(s);

-        return 0;      // only RGB or indexed allowed

-    }

-    tga_image_type = stbi__get8(s); // image type

-    if ( tga_colormap_type == 1 ) { // colormapped (paletted) image

-        if (tga_image_type != 1 && tga_image_type != 9) {

-            stbi__rewind(s);

-            return 0;

-        }

-        stbi__skip(s,4);       // skip index of first colormap entry and number of entries

-        sz = stbi__get8(s);    //   check bits per palette color entry

-        if ( (sz != 8) && (sz != 15) && (sz != 16) && (sz != 24) && (sz != 32) ) {

-            stbi__rewind(s);

-            return 0;

-        }

-        stbi__skip(s,4);       // skip image x and y origin

-        tga_colormap_bpp = sz;

-    } else { // "normal" image w/o colormap - only RGB or grey allowed, +/- RLE

-        if ( (tga_image_type != 2) && (tga_image_type != 3) && (tga_image_type != 10) && (tga_image_type != 11) ) {

-            stbi__rewind(s);

-            return 0; // only RGB or grey allowed, +/- RLE

-        }

-        stbi__skip(s,9); // skip colormap specification and image x/y origin

-        tga_colormap_bpp = 0;

-    }

-    tga_w = stbi__get16le(s);

-    if( tga_w < 1 ) {

-        stbi__rewind(s);

-        return 0;   // test width

-    }

-    tga_h = stbi__get16le(s);

-    if( tga_h < 1 ) {

-        stbi__rewind(s);

-        return 0;   // test height

-    }

-    tga_bits_per_pixel = stbi__get8(s); // bits per pixel

-    stbi__get8(s); // ignore alpha bits

-    if (tga_colormap_bpp != 0) {

-        if((tga_bits_per_pixel != 8) && (tga_bits_per_pixel != 16)) {

-            // when using a colormap, tga_bits_per_pixel is the size of the indexes

-            // I don't think anything but 8 or 16bit indexes makes sense

-            stbi__rewind(s);

-            return 0;

-        }

-        tga_comp = stbi__tga_get_comp(tga_colormap_bpp, 0, NULL);

-    } else {

-        tga_comp = stbi__tga_get_comp(tga_bits_per_pixel, (tga_image_type == 3) || (tga_image_type == 11), NULL);

-    }

-    if(!tga_comp) {

-      stbi__rewind(s);

-      return 0;

-    }

-    if (x) *x = tga_w;

-    if (y) *y = tga_h;

-    if (comp) *comp = tga_comp;

-    return 1;                   // seems to have passed everything

-}

-

-static int stbi__tga_test(stbi__context *s)

-{

-   int res = 0;

-   int sz, tga_color_type;

-   stbi__get8(s);      //   discard Offset

-   tga_color_type = stbi__get8(s);   //   color type

-   if ( tga_color_type > 1 ) goto errorEnd;   //   only RGB or indexed allowed

-   sz = stbi__get8(s);   //   image type

-   if ( tga_color_type == 1 ) { // colormapped (paletted) image

-      if (sz != 1 && sz != 9) goto errorEnd; // colortype 1 demands image type 1 or 9

-      stbi__skip(s,4);       // skip index of first colormap entry and number of entries

-      sz = stbi__get8(s);    //   check bits per palette color entry

-      if ( (sz != 8) && (sz != 15) && (sz != 16) && (sz != 24) && (sz != 32) ) goto errorEnd;

-      stbi__skip(s,4);       // skip image x and y origin

-   } else { // "normal" image w/o colormap

-      if ( (sz != 2) && (sz != 3) && (sz != 10) && (sz != 11) ) goto errorEnd; // only RGB or grey allowed, +/- RLE

-      stbi__skip(s,9); // skip colormap specification and image x/y origin

-   }

-   if ( stbi__get16le(s) < 1 ) goto errorEnd;      //   test width

-   if ( stbi__get16le(s) < 1 ) goto errorEnd;      //   test height

-   sz = stbi__get8(s);   //   bits per pixel

-   if ( (tga_color_type == 1) && (sz != 8) && (sz != 16) ) goto errorEnd; // for colormapped images, bpp is size of an index

-   if ( (sz != 8) && (sz != 15) && (sz != 16) && (sz != 24) && (sz != 32) ) goto errorEnd;

-

-   res = 1; // if we got this far, everything's good and we can return 1 instead of 0

-

-errorEnd:

-   stbi__rewind(s);

-   return res;

-}

-

-// read 16bit value and convert to 24bit RGB

-static void stbi__tga_read_rgb16(stbi__context *s, stbi_uc* out)

-{

-   stbi__uint16 px = (stbi__uint16)stbi__get16le(s);

-   stbi__uint16 fiveBitMask = 31;

-   // we have 3 channels with 5bits each

-   int r = (px >> 10) & fiveBitMask;

-   int g = (px >> 5) & fiveBitMask;

-   int b = px & fiveBitMask;

-   // Note that this saves the data in RGB(A) order, so it doesn't need to be swapped later

-   out[0] = (stbi_uc)((r * 255)/31);

-   out[1] = (stbi_uc)((g * 255)/31);

-   out[2] = (stbi_uc)((b * 255)/31);

-

-   // some people claim that the most significant bit might be used for alpha

-   // (possibly if an alpha-bit is set in the "image descriptor byte")

-   // but that only made 16bit test images completely translucent..

-   // so let's treat all 15 and 16bit TGAs as RGB with no alpha.

-}

-

-static void *stbi__tga_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri)

-{

-   //   read in the TGA header stuff

-   int tga_offset = stbi__get8(s);

-   int tga_indexed = stbi__get8(s);

-   int tga_image_type = stbi__get8(s);

-   int tga_is_RLE = 0;

-   int tga_palette_start = stbi__get16le(s);

-   int tga_palette_len = stbi__get16le(s);

-   int tga_palette_bits = stbi__get8(s);

-   int tga_x_origin = stbi__get16le(s);

-   int tga_y_origin = stbi__get16le(s);

-   int tga_width = stbi__get16le(s);

-   int tga_height = stbi__get16le(s);

-   int tga_bits_per_pixel = stbi__get8(s);

-   int tga_comp, tga_rgb16=0;

-   int tga_inverted = stbi__get8(s);

-   // int tga_alpha_bits = tga_inverted & 15; // the 4 lowest bits - unused (useless?)

-   //   image data

-   unsigned char *tga_data;

-   unsigned char *tga_palette = NULL;

-   int i, j;

-   unsigned char raw_data[4] = {0};

-   int RLE_count = 0;

-   int RLE_repeating = 0;

-   int read_next_pixel = 1;

-   STBI_NOTUSED(ri);

-

-   //   do a tiny bit of precessing

-   if ( tga_image_type >= 8 )

-   {

-      tga_image_type -= 8;

-      tga_is_RLE = 1;

-   }

-   tga_inverted = 1 - ((tga_inverted >> 5) & 1);

-

-   //   If I'm paletted, then I'll use the number of bits from the palette

-   if ( tga_indexed ) tga_comp = stbi__tga_get_comp(tga_palette_bits, 0, &tga_rgb16);

-   else tga_comp = stbi__tga_get_comp(tga_bits_per_pixel, (tga_image_type == 3), &tga_rgb16);

-

-   if(!tga_comp) // shouldn't really happen, stbi__tga_test() should have ensured basic consistency

-      return stbi__errpuc("bad format", "Can't find out TGA pixelformat");

-

-   //   tga info

-   *x = tga_width;

-   *y = tga_height;

-   if (comp) *comp = tga_comp;

-

-   if (!stbi__mad3sizes_valid(tga_width, tga_height, tga_comp, 0))

-      return stbi__errpuc("too large", "Corrupt TGA");

-

-   tga_data = (unsigned char*)stbi__malloc_mad3(tga_width, tga_height, tga_comp, 0);

-   if (!tga_data) return stbi__errpuc("outofmem", "Out of memory");

-

-   // skip to the data's starting position (offset usually = 0)

-   stbi__skip(s, tga_offset );

-

-   if ( !tga_indexed && !tga_is_RLE && !tga_rgb16 ) {

-      for (i=0; i < tga_height; ++i) {

-         int row = tga_inverted ? tga_height -i - 1 : i;

-         stbi_uc *tga_row = tga_data + row*tga_width*tga_comp;

-         stbi__getn(s, tga_row, tga_width * tga_comp);

-      }

-   } else  {

-      //   do I need to load a palette?

-      if ( tga_indexed)

-      {

-         //   any data to skip? (offset usually = 0)

-         stbi__skip(s, tga_palette_start );

-         //   load the palette

-         tga_palette = (unsigned char*)stbi__malloc_mad2(tga_palette_len, tga_comp, 0);

-         if (!tga_palette) {

-            STBI_FREE(tga_data);

-            return stbi__errpuc("outofmem", "Out of memory");

-         }

-         if (tga_rgb16) {

-            stbi_uc *pal_entry = tga_palette;

-            STBI_ASSERT(tga_comp == STBI_rgb);

-            for (i=0; i < tga_palette_len; ++i) {

-               stbi__tga_read_rgb16(s, pal_entry);

-               pal_entry += tga_comp;

-            }

-         } else if (!stbi__getn(s, tga_palette, tga_palette_len * tga_comp)) {

-               STBI_FREE(tga_data);

-               STBI_FREE(tga_palette);

-               return stbi__errpuc("bad palette", "Corrupt TGA");

-         }

-      }

-      //   load the data

-      for (i=0; i < tga_width * tga_height; ++i)

-      {

-         //   if I'm in RLE mode, do I need to get a RLE stbi__pngchunk?

-         if ( tga_is_RLE )

-         {

-            if ( RLE_count == 0 )

-            {

-               //   yep, get the next byte as a RLE command

-               int RLE_cmd = stbi__get8(s);

-               RLE_count = 1 + (RLE_cmd & 127);

-               RLE_repeating = RLE_cmd >> 7;

-               read_next_pixel = 1;

-            } else if ( !RLE_repeating )

-            {

-               read_next_pixel = 1;

-            }

-         } else

-         {

-            read_next_pixel = 1;

-         }

-         //   OK, if I need to read a pixel, do it now

-         if ( read_next_pixel )

-         {

-            //   load however much data we did have

-            if ( tga_indexed )

-            {

-               // read in index, then perform the lookup

-               int pal_idx = (tga_bits_per_pixel == 8) ? stbi__get8(s) : stbi__get16le(s);

-               if ( pal_idx >= tga_palette_len ) {

-                  // invalid index

-                  pal_idx = 0;

-               }

-               pal_idx *= tga_comp;

-               for (j = 0; j < tga_comp; ++j) {

-                  raw_data[j] = tga_palette[pal_idx+j];

-               }

-            } else if(tga_rgb16) {

-               STBI_ASSERT(tga_comp == STBI_rgb);

-               stbi__tga_read_rgb16(s, raw_data);

-            } else {

-               //   read in the data raw

-               for (j = 0; j < tga_comp; ++j) {

-                  raw_data[j] = stbi__get8(s);

-               }

-            }

-            //   clear the reading flag for the next pixel

-            read_next_pixel = 0;

-         } // end of reading a pixel

-

-         // copy data

-         for (j = 0; j < tga_comp; ++j)

-           tga_data[i*tga_comp+j] = raw_data[j];

-

-         //   in case we're in RLE mode, keep counting down

-         --RLE_count;

-      }

-      //   do I need to invert the image?

-      if ( tga_inverted )

-      {

-         for (j = 0; j*2 < tga_height; ++j)

-         {

-            int index1 = j * tga_width * tga_comp;

-            int index2 = (tga_height - 1 - j) * tga_width * tga_comp;

-            for (i = tga_width * tga_comp; i > 0; --i)

-            {

-               unsigned char temp = tga_data[index1];

-               tga_data[index1] = tga_data[index2];

-               tga_data[index2] = temp;

-               ++index1;

-               ++index2;

-            }

-         }

-      }

-      //   clear my palette, if I had one

-      if ( tga_palette != NULL )

-      {

-         STBI_FREE( tga_palette );

-      }

-   }

-

-   // swap RGB - if the source data was RGB16, it already is in the right order

-   if (tga_comp >= 3 && !tga_rgb16)

-   {

-      unsigned char* tga_pixel = tga_data;

-      for (i=0; i < tga_width * tga_height; ++i)

-      {

-         unsigned char temp = tga_pixel[0];

-         tga_pixel[0] = tga_pixel[2];

-         tga_pixel[2] = temp;

-         tga_pixel += tga_comp;

-      }

-   }

-

-   // convert to target component count

-   if (req_comp && req_comp != tga_comp)

-      tga_data = stbi__convert_format(tga_data, tga_comp, req_comp, tga_width, tga_height);

-

-   //   the things I do to get rid of an error message, and yet keep

-   //   Microsoft's C compilers happy... [8^(

-   tga_palette_start = tga_palette_len = tga_palette_bits =

-         tga_x_origin = tga_y_origin = 0;

-   //   OK, done

-   return tga_data;

-}

-#endif

-

-// *************************************************************************************************

-// Photoshop PSD loader -- PD by Thatcher Ulrich, integration by Nicolas Schulz, tweaked by STB

-

-#ifndef STBI_NO_PSD

-static int stbi__psd_test(stbi__context *s)

-{

-   int r = (stbi__get32be(s) == 0x38425053);

-   stbi__rewind(s);

-   return r;

-}

-

-static int stbi__psd_decode_rle(stbi__context *s, stbi_uc *p, int pixelCount)

-{

-   int count, nleft, len;

-

-   count = 0;

-   while ((nleft = pixelCount - count) > 0) {

-      len = stbi__get8(s);

-      if (len == 128) {

-         // No-op.

-      } else if (len < 128) {

-         // Copy next len+1 bytes literally.

-         len++;

-         if (len > nleft) return 0; // corrupt data

-         count += len;

-         while (len) {

-            *p = stbi__get8(s);

-            p += 4;

-            len--;

-         }

-      } else if (len > 128) {

-         stbi_uc   val;

-         // Next -len+1 bytes in the dest are replicated from next source byte.

-         // (Interpret len as a negative 8-bit int.)

-         len = 257 - len;

-         if (len > nleft) return 0; // corrupt data

-         val = stbi__get8(s);

-         count += len;

-         while (len) {

-            *p = val;

-            p += 4;

-            len--;

-         }

-      }

-   }

-

-   return 1;

-}

-

-static void *stbi__psd_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri, int bpc)

-{

-   int pixelCount;

-   int channelCount, compression;

-   int channel, i;

-   int bitdepth;

-   int w,h;

-   stbi_uc *out;

-   STBI_NOTUSED(ri);

-

-   // Check identifier

-   if (stbi__get32be(s) != 0x38425053)   // "8BPS"

-      return stbi__errpuc("not PSD", "Corrupt PSD image");

-

-   // Check file type version.

-   if (stbi__get16be(s) != 1)

-      return stbi__errpuc("wrong version", "Unsupported version of PSD image");

-

-   // Skip 6 reserved bytes.

-   stbi__skip(s, 6 );

-

-   // Read the number of channels (R, G, B, A, etc).

-   channelCount = stbi__get16be(s);

-   if (channelCount < 0 || channelCount > 16)

-      return stbi__errpuc("wrong channel count", "Unsupported number of channels in PSD image");

-

-   // Read the rows and columns of the image.

-   h = stbi__get32be(s);

-   w = stbi__get32be(s);

-

-   // Make sure the depth is 8 bits.

-   bitdepth = stbi__get16be(s);

-   if (bitdepth != 8 && bitdepth != 16)

-      return stbi__errpuc("unsupported bit depth", "PSD bit depth is not 8 or 16 bit");

-

-   // Make sure the color mode is RGB.

-   // Valid options are:

-   //   0: Bitmap

-   //   1: Grayscale

-   //   2: Indexed color

-   //   3: RGB color

-   //   4: CMYK color

-   //   7: Multichannel

-   //   8: Duotone

-   //   9: Lab color

-   if (stbi__get16be(s) != 3)

-      return stbi__errpuc("wrong color format", "PSD is not in RGB color format");

-

-   // Skip the Mode Data.  (It's the palette for indexed color; other info for other modes.)

-   stbi__skip(s,stbi__get32be(s) );

-

-   // Skip the image resources.  (resolution, pen tool paths, etc)

-   stbi__skip(s, stbi__get32be(s) );

-

-   // Skip the reserved data.

-   stbi__skip(s, stbi__get32be(s) );

-

-   // Find out if the data is compressed.

-   // Known values:

-   //   0: no compression

-   //   1: RLE compressed

-   compression = stbi__get16be(s);

-   if (compression > 1)

-      return stbi__errpuc("bad compression", "PSD has an unknown compression format");

-

-   // Check size

-   if (!stbi__mad3sizes_valid(4, w, h, 0))

-      return stbi__errpuc("too large", "Corrupt PSD");

-

-   // Create the destination image.

-

-   if (!compression && bitdepth == 16 && bpc == 16) {

-      out = (stbi_uc *) stbi__malloc_mad3(8, w, h, 0);

-      ri->bits_per_channel = 16;

-   } else

-      out = (stbi_uc *) stbi__malloc(4 * w*h);

-

-   if (!out) return stbi__errpuc("outofmem", "Out of memory");

-   pixelCount = w*h;

-

-   // Initialize the data to zero.

-   //memset( out, 0, pixelCount * 4 );

-

-   // Finally, the image data.

-   if (compression) {

-      // RLE as used by .PSD and .TIFF

-      // Loop until you get the number of unpacked bytes you are expecting:

-      //     Read the next source byte into n.

-      //     If n is between 0 and 127 inclusive, copy the next n+1 bytes literally.

-      //     Else if n is between -127 and -1 inclusive, copy the next byte -n+1 times.

-      //     Else if n is 128, noop.

-      // Endloop

-

-      // The RLE-compressed data is preceded by a 2-byte data count for each row in the data,

-      // which we're going to just skip.

-      stbi__skip(s, h * channelCount * 2 );

-

-      // Read the RLE data by channel.

-      for (channel = 0; channel < 4; channel++) {

-         stbi_uc *p;

-

-         p = out+channel;

-         if (channel >= channelCount) {

-            // Fill this channel with default data.

-            for (i = 0; i < pixelCount; i++, p += 4)

-               *p = (channel == 3 ? 255 : 0);

-         } else {

-            // Read the RLE data.

-            if (!stbi__psd_decode_rle(s, p, pixelCount)) {

-               STBI_FREE(out);

-               return stbi__errpuc("corrupt", "bad RLE data");

-            }

-         }

-      }

-

-   } else {

-      // We're at the raw image data.  It's each channel in order (Red, Green, Blue, Alpha, ...)

-      // where each channel consists of an 8-bit (or 16-bit) value for each pixel in the image.

-

-      // Read the data by channel.

-      for (channel = 0; channel < 4; channel++) {

-         if (channel >= channelCount) {

-            // Fill this channel with default data.

-            if (bitdepth == 16 && bpc == 16) {

-               stbi__uint16 *q = ((stbi__uint16 *) out) + channel;

-               stbi__uint16 val = channel == 3 ? 65535 : 0;

-               for (i = 0; i < pixelCount; i++, q += 4)

-                  *q = val;

-            } else {

-               stbi_uc *p = out+channel;

-               stbi_uc val = channel == 3 ? 255 : 0;

-               for (i = 0; i < pixelCount; i++, p += 4)

-                  *p = val;

-            }

-         } else {

-            if (ri->bits_per_channel == 16) {    // output bpc

-               stbi__uint16 *q = ((stbi__uint16 *) out) + channel;

-               for (i = 0; i < pixelCount; i++, q += 4)

-                  *q = (stbi__uint16) stbi__get16be(s);

-            } else {

-               stbi_uc *p = out+channel;

-               if (bitdepth == 16) {  // input bpc

-                  for (i = 0; i < pixelCount; i++, p += 4)

-                     *p = (stbi_uc) (stbi__get16be(s) >> 8);

-               } else {

-                  for (i = 0; i < pixelCount; i++, p += 4)

-                     *p = stbi__get8(s);

-               }

-            }

-         }

-      }

-   }

-

-   // remove weird white matte from PSD

-   if (channelCount >= 4) {

-      if (ri->bits_per_channel == 16) {

-         for (i=0; i < w*h; ++i) {

-            stbi__uint16 *pixel = (stbi__uint16 *) out + 4*i;

-            if (pixel[3] != 0 && pixel[3] != 65535) {

-               float a = pixel[3] / 65535.0f;

-               float ra = 1.0f / a;

-               float inv_a = 65535.0f * (1 - ra);

-               pixel[0] = (stbi__uint16) (pixel[0]*ra + inv_a);

-               pixel[1] = (stbi__uint16) (pixel[1]*ra + inv_a);

-               pixel[2] = (stbi__uint16) (pixel[2]*ra + inv_a);

-            }

-         }

-      } else {

-         for (i=0; i < w*h; ++i) {

-            unsigned char *pixel = out + 4*i;

-            if (pixel[3] != 0 && pixel[3] != 255) {

-               float a = pixel[3] / 255.0f;

-               float ra = 1.0f / a;

-               float inv_a = 255.0f * (1 - ra);

-               pixel[0] = (unsigned char) (pixel[0]*ra + inv_a);

-               pixel[1] = (unsigned char) (pixel[1]*ra + inv_a);

-               pixel[2] = (unsigned char) (pixel[2]*ra + inv_a);

-            }

-         }

-      }

-   }

-

-   // convert to desired output format

-   if (req_comp && req_comp != 4) {

-      if (ri->bits_per_channel == 16)

-         out = (stbi_uc *) stbi__convert_format16((stbi__uint16 *) out, 4, req_comp, w, h);

-      else

-         out = stbi__convert_format(out, 4, req_comp, w, h);

-      if (out == NULL) return out; // stbi__convert_format frees input on failure

-   }

-

-   if (comp) *comp = 4;

-   *y = h;

-   *x = w;

-

-   return out;

-}

-#endif

-

-// *************************************************************************************************

-// Softimage PIC loader

-// by Tom Seddon

-//

-// See http://softimage.wiki.softimage.com/index.php/INFO:_PIC_file_format

-// See http://ozviz.wasp.uwa.edu.au/~pbourke/dataformats/softimagepic/

-

-#ifndef STBI_NO_PIC

-static int stbi__pic_is4(stbi__context *s,const char *str)

-{

-   int i;

-   for (i=0; i<4; ++i)

-      if (stbi__get8(s) != (stbi_uc)str[i])

-         return 0;

-

-   return 1;

-}

-

-static int stbi__pic_test_core(stbi__context *s)

-{

-   int i;

-

-   if (!stbi__pic_is4(s,"\x53\x80\xF6\x34"))

-      return 0;

-

-   for(i=0;i<84;++i)

-      stbi__get8(s);

-

-   if (!stbi__pic_is4(s,"PICT"))

-      return 0;

-

-   return 1;

-}

-

-typedef struct

-{

-   stbi_uc size,type,channel;

-} stbi__pic_packet;

-

-static stbi_uc *stbi__readval(stbi__context *s, int channel, stbi_uc *dest)

-{

-   int mask=0x80, i;

-

-   for (i=0; i<4; ++i, mask>>=1) {

-      if (channel & mask) {

-         if (stbi__at_eof(s)) return stbi__errpuc("bad file","PIC file too short");

-         dest[i]=stbi__get8(s);

-      }

-   }

-

-   return dest;

-}

-

-static void stbi__copyval(int channel,stbi_uc *dest,const stbi_uc *src)

-{

-   int mask=0x80,i;

-

-   for (i=0;i<4; ++i, mask>>=1)

-      if (channel&mask)

-         dest[i]=src[i];

-}

-

-static stbi_uc *stbi__pic_load_core(stbi__context *s,int width,int height,int *comp, stbi_uc *result)

-{

-   int act_comp=0,num_packets=0,y,chained;

-   stbi__pic_packet packets[10];

-

-   // this will (should...) cater for even some bizarre stuff like having data

-    // for the same channel in multiple packets.

-   do {

-      stbi__pic_packet *packet;

-

-      if (num_packets==sizeof(packets)/sizeof(packets[0]))

-         return stbi__errpuc("bad format","too many packets");

-

-      packet = &packets[num_packets++];

-

-      chained = stbi__get8(s);

-      packet->size    = stbi__get8(s);

-      packet->type    = stbi__get8(s);

-      packet->channel = stbi__get8(s);

-

-      act_comp |= packet->channel;

-

-      if (stbi__at_eof(s))          return stbi__errpuc("bad file","file too short (reading packets)");

-      if (packet->size != 8)  return stbi__errpuc("bad format","packet isn't 8bpp");

-   } while (chained);

-

-   *comp = (act_comp & 0x10 ? 4 : 3); // has alpha channel?

-

-   for(y=0; y<height; ++y) {

-      int packet_idx;

-

-      for(packet_idx=0; packet_idx < num_packets; ++packet_idx) {

-         stbi__pic_packet *packet = &packets[packet_idx];

-         stbi_uc *dest = result+y*width*4;

-

-         switch (packet->type) {

-            default:

-               return stbi__errpuc("bad format","packet has bad compression type");

-

-            case 0: {//uncompressed

-               int x;

-

-               for(x=0;x<width;++x, dest+=4)

-                  if (!stbi__readval(s,packet->channel,dest))

-                     return 0;

-               break;

-            }

-

-            case 1://Pure RLE

-               {

-                  int left=width, i;

-

-                  while (left>0) {

-                     stbi_uc count,value[4];

-

-                     count=stbi__get8(s);

-                     if (stbi__at_eof(s))   return stbi__errpuc("bad file","file too short (pure read count)");

-

-                     if (count > left)

-                        count = (stbi_uc) left;

-

-                     if (!stbi__readval(s,packet->channel,value))  return 0;

-

-                     for(i=0; i<count; ++i,dest+=4)

-                        stbi__copyval(packet->channel,dest,value);

-                     left -= count;

-                  }

-               }

-               break;

-

-            case 2: {//Mixed RLE

-               int left=width;

-               while (left>0) {

-                  int count = stbi__get8(s), i;

-                  if (stbi__at_eof(s))  return stbi__errpuc("bad file","file too short (mixed read count)");

-

-                  if (count >= 128) { // Repeated

-                     stbi_uc value[4];

-

-                     if (count==128)

-                        count = stbi__get16be(s);

-                     else

-                        count -= 127;

-                     if (count > left)

-                        return stbi__errpuc("bad file","scanline overrun");

-

-                     if (!stbi__readval(s,packet->channel,value))

-                        return 0;

-

-                     for(i=0;i<count;++i, dest += 4)

-                        stbi__copyval(packet->channel,dest,value);

-                  } else { // Raw

-                     ++count;

-                     if (count>left) return stbi__errpuc("bad file","scanline overrun");

-

-                     for(i=0;i<count;++i, dest+=4)

-                        if (!stbi__readval(s,packet->channel,dest))

-                           return 0;

-                  }

-                  left-=count;

-               }

-               break;

-            }

-         }

-      }

-   }

-

-   return result;

-}

-

-static void *stbi__pic_load(stbi__context *s,int *px,int *py,int *comp,int req_comp, stbi__result_info *ri)

-{

-   stbi_uc *result;

-   int i, x,y, internal_comp;

-   STBI_NOTUSED(ri);

-

-   if (!comp) comp = &internal_comp;

-

-   for (i=0; i<92; ++i)

-      stbi__get8(s);

-

-   x = stbi__get16be(s);

-   y = stbi__get16be(s);

-   if (stbi__at_eof(s))  return stbi__errpuc("bad file","file too short (pic header)");

-   if (!stbi__mad3sizes_valid(x, y, 4, 0)) return stbi__errpuc("too large", "PIC image too large to decode");

-

-   stbi__get32be(s); //skip `ratio'

-   stbi__get16be(s); //skip `fields'

-   stbi__get16be(s); //skip `pad'

-

-   // intermediate buffer is RGBA

-   result = (stbi_uc *) stbi__malloc_mad3(x, y, 4, 0);

-   memset(result, 0xff, x*y*4);

-

-   if (!stbi__pic_load_core(s,x,y,comp, result)) {

-      STBI_FREE(result);

-      result=0;

-   }

-   *px = x;

-   *py = y;

-   if (req_comp == 0) req_comp = *comp;

-   result=stbi__convert_format(result,4,req_comp,x,y);

-

-   return result;

-}

-

-static int stbi__pic_test(stbi__context *s)

-{

-   int r = stbi__pic_test_core(s);

-   stbi__rewind(s);

-   return r;

-}

-#endif

-

-// *************************************************************************************************

-// GIF loader -- public domain by Jean-Marc Lienher -- simplified/shrunk by stb

-

-#ifndef STBI_NO_GIF

-typedef struct

-{

-   stbi__int16 prefix;

-   stbi_uc first;

-   stbi_uc suffix;

-} stbi__gif_lzw;

-

-typedef struct

-{

-   int w,h;

-   stbi_uc *out;                 // output buffer (always 4 components)

-   stbi_uc *background;          // The current "background" as far as a gif is concerned

-   stbi_uc *history; 

-   int flags, bgindex, ratio, transparent, eflags;

-   stbi_uc  pal[256][4];

-   stbi_uc lpal[256][4];

-   stbi__gif_lzw codes[8192];

-   stbi_uc *color_table;

-   int parse, step;

-   int lflags;

-   int start_x, start_y;

-   int max_x, max_y;

-   int cur_x, cur_y;

-   int line_size;

-   int delay;

-} stbi__gif;

-

-static int stbi__gif_test_raw(stbi__context *s)

-{

-   int sz;

-   if (stbi__get8(s) != 'G' || stbi__get8(s) != 'I' || stbi__get8(s) != 'F' || stbi__get8(s) != '8') return 0;

-   sz = stbi__get8(s);

-   if (sz != '9' && sz != '7') return 0;

-   if (stbi__get8(s) != 'a') return 0;

-   return 1;

-}

-

-static int stbi__gif_test(stbi__context *s)

-{

-   int r = stbi__gif_test_raw(s);

-   stbi__rewind(s);

-   return r;

-}

-

-static void stbi__gif_parse_colortable(stbi__context *s, stbi_uc pal[256][4], int num_entries, int transp)

-{

-   int i;

-   for (i=0; i < num_entries; ++i) {

-      pal[i][2] = stbi__get8(s);

-      pal[i][1] = stbi__get8(s);

-      pal[i][0] = stbi__get8(s);

-      pal[i][3] = transp == i ? 0 : 255;

-   }

-}

-

-static int stbi__gif_header(stbi__context *s, stbi__gif *g, int *comp, int is_info)

-{

-   stbi_uc version;

-   if (stbi__get8(s) != 'G' || stbi__get8(s) != 'I' || stbi__get8(s) != 'F' || stbi__get8(s) != '8')

-      return stbi__err("not GIF", "Corrupt GIF");

-

-   version = stbi__get8(s);

-   if (version != '7' && version != '9')    return stbi__err("not GIF", "Corrupt GIF");

-   if (stbi__get8(s) != 'a')                return stbi__err("not GIF", "Corrupt GIF");

-

-   stbi__g_failure_reason = "";

-   g->w = stbi__get16le(s);

-   g->h = stbi__get16le(s);

-   g->flags = stbi__get8(s);

-   g->bgindex = stbi__get8(s);

-   g->ratio = stbi__get8(s);

-   g->transparent = -1;

-

-   if (comp != 0) *comp = 4;  // can't actually tell whether it's 3 or 4 until we parse the comments

-

-   if (is_info) return 1;

-

-   if (g->flags & 0x80)

-      stbi__gif_parse_colortable(s,g->pal, 2 << (g->flags & 7), -1);

-

-   return 1;

-}

-

-static int stbi__gif_info_raw(stbi__context *s, int *x, int *y, int *comp)

-{

-   stbi__gif* g = (stbi__gif*) stbi__malloc(sizeof(stbi__gif));

-   if (!stbi__gif_header(s, g, comp, 1)) {

-      STBI_FREE(g);

-      stbi__rewind( s );

-      return 0;

-   }

-   if (x) *x = g->w;

-   if (y) *y = g->h;

-   STBI_FREE(g);

-   return 1;

-}

-

-static void stbi__out_gif_code(stbi__gif *g, stbi__uint16 code)

-{

-   stbi_uc *p, *c;

-   int idx; 

-

-   // recurse to decode the prefixes, since the linked-list is backwards,

-   // and working backwards through an interleaved image would be nasty

-   if (g->codes[code].prefix >= 0)

-      stbi__out_gif_code(g, g->codes[code].prefix);

-

-   if (g->cur_y >= g->max_y) return;

-

-   idx = g->cur_x + g->cur_y; 

-   p = &g->out[idx];

-   g->history[idx / 4] = 1;  

-

-   c = &g->color_table[g->codes[code].suffix * 4];

-   if (c[3] > 128) { // don't render transparent pixels; 

-      p[0] = c[2];

-      p[1] = c[1];

-      p[2] = c[0];

-      p[3] = c[3];

-   }

-   g->cur_x += 4;

-

-   if (g->cur_x >= g->max_x) {

-      g->cur_x = g->start_x;

-      g->cur_y += g->step;

-

-      while (g->cur_y >= g->max_y && g->parse > 0) {

-         g->step = (1 << g->parse) * g->line_size;

-         g->cur_y = g->start_y + (g->step >> 1);

-         --g->parse;

-      }

-   }

-}

-

-static stbi_uc *stbi__process_gif_raster(stbi__context *s, stbi__gif *g)

-{

-   stbi_uc lzw_cs;

-   stbi__int32 len, init_code;

-   stbi__uint32 first;

-   stbi__int32 codesize, codemask, avail, oldcode, bits, valid_bits, clear;

-   stbi__gif_lzw *p;

-

-   lzw_cs = stbi__get8(s);

-   if (lzw_cs > 12) return NULL;

-   clear = 1 << lzw_cs;

-   first = 1;

-   codesize = lzw_cs + 1;

-   codemask = (1 << codesize) - 1;

-   bits = 0;

-   valid_bits = 0;

-   for (init_code = 0; init_code < clear; init_code++) {

-      g->codes[init_code].prefix = -1;

-      g->codes[init_code].first = (stbi_uc) init_code;

-      g->codes[init_code].suffix = (stbi_uc) init_code;

-   }

-

-   // support no starting clear code

-   avail = clear+2;

-   oldcode = -1;

-

-   len = 0;

-   for(;;) {

-      if (valid_bits < codesize) {

-         if (len == 0) {

-            len = stbi__get8(s); // start new block

-            if (len == 0)

-               return g->out;

-         }

-         --len;

-         bits |= (stbi__int32) stbi__get8(s) << valid_bits;

-         valid_bits += 8;

-      } else {

-         stbi__int32 code = bits & codemask;

-         bits >>= codesize;

-         valid_bits -= codesize;

-         // @OPTIMIZE: is there some way we can accelerate the non-clear path?

-         if (code == clear) {  // clear code

-            codesize = lzw_cs + 1;

-            codemask = (1 << codesize) - 1;

-            avail = clear + 2;

-            oldcode = -1;

-            first = 0;

-         } else if (code == clear + 1) { // end of stream code

-            stbi__skip(s, len);

-            while ((len = stbi__get8(s)) > 0)

-               stbi__skip(s,len);

-            return g->out;

-         } else if (code <= avail) {

-            if (first) {

-               return stbi__errpuc("no clear code", "Corrupt GIF");

-            }

-

-            if (oldcode >= 0) {

-               p = &g->codes[avail++];

-               if (avail > 8192) {

-                  return stbi__errpuc("too many codes", "Corrupt GIF");

-               }

-

-               p->prefix = (stbi__int16) oldcode;

-               p->first = g->codes[oldcode].first;

-               p->suffix = (code == avail) ? p->first : g->codes[code].first;

-            } else if (code == avail)

-               return stbi__errpuc("illegal code in raster", "Corrupt GIF");

-

-            stbi__out_gif_code(g, (stbi__uint16) code);

-

-            if ((avail & codemask) == 0 && avail <= 0x0FFF) {

-               codesize++;

-               codemask = (1 << codesize) - 1;

-            }

-

-            oldcode = code;

-         } else {

-            return stbi__errpuc("illegal code in raster", "Corrupt GIF");

-         }

-      }

-   }

-}

-

-// this function is designed to support animated gifs, although stb_image doesn't support it

-// two back is the image from two frames ago, used for a very specific disposal format

-static stbi_uc *stbi__gif_load_next(stbi__context *s, stbi__gif *g, int *comp, int req_comp, stbi_uc *two_back)

-{

-   int dispose; 

-   int first_frame; 

-   int pi; 

-   int pcount; 

-   STBI_NOTUSED(req_comp);

-

-   // on first frame, any non-written pixels get the background colour (non-transparent)

-   first_frame = 0; 

-   if (g->out == 0) {

-      if (!stbi__gif_header(s, g, comp,0)) return 0; // stbi__g_failure_reason set by stbi__gif_header

-      if (!stbi__mad3sizes_valid(4, g->w, g->h, 0))

-         return stbi__errpuc("too large", "GIF image is too large");

-      pcount = g->w * g->h;

-      g->out = (stbi_uc *) stbi__malloc(4 * pcount);

-      g->background = (stbi_uc *) stbi__malloc(4 * pcount);

-      g->history = (stbi_uc *) stbi__malloc(pcount);

-      if (!g->out || !g->background || !g->history)

-         return stbi__errpuc("outofmem", "Out of memory");

-

-      // image is treated as "transparent" at the start - ie, nothing overwrites the current background; 

-      // background colour is only used for pixels that are not rendered first frame, after that "background"

-      // color refers to the color that was there the previous frame. 

-      memset(g->out, 0x00, 4 * pcount);

-      memset(g->background, 0x00, 4 * pcount); // state of the background (starts transparent)

-      memset(g->history, 0x00, pcount);        // pixels that were affected previous frame

-      first_frame = 1; 

-   } else {

-      // second frame - how do we dispoase of the previous one?

-      dispose = (g->eflags & 0x1C) >> 2; 

-      pcount = g->w * g->h; 

-

-      if ((dispose == 3) && (two_back == 0)) {

-         dispose = 2; // if I don't have an image to revert back to, default to the old background

-      }

-

-      if (dispose == 3) { // use previous graphic

-         for (pi = 0; pi < pcount; ++pi) {

-            if (g->history[pi]) {

-               memcpy( &g->out[pi * 4], &two_back[pi * 4], 4 ); 

-            }

-         }

-      } else if (dispose == 2) { 

-         // restore what was changed last frame to background before that frame; 

-         for (pi = 0; pi < pcount; ++pi) {

-            if (g->history[pi]) {

-               memcpy( &g->out[pi * 4], &g->background[pi * 4], 4 ); 

-            }

-         }

-      } else {

-         // This is a non-disposal case eithe way, so just 

-         // leave the pixels as is, and they will become the new background

-         // 1: do not dispose

-         // 0:  not specified.

-      }

-

-      // background is what out is after the undoing of the previou frame; 

-      memcpy( g->background, g->out, 4 * g->w * g->h ); 

-   }

-

-   // clear my history; 

-   memset( g->history, 0x00, g->w * g->h );        // pixels that were affected previous frame

-

-   for (;;) {

-      int tag = stbi__get8(s); 

-      switch (tag) {

-         case 0x2C: /* Image Descriptor */

-         {

-            stbi__int32 x, y, w, h;

-            stbi_uc *o;

-

-            x = stbi__get16le(s);

-            y = stbi__get16le(s);

-            w = stbi__get16le(s);

-            h = stbi__get16le(s);

-            if (((x + w) > (g->w)) || ((y + h) > (g->h)))

-               return stbi__errpuc("bad Image Descriptor", "Corrupt GIF");

-

-            g->line_size = g->w * 4;

-            g->start_x = x * 4;

-            g->start_y = y * g->line_size;

-            g->max_x   = g->start_x + w * 4;

-            g->max_y   = g->start_y + h * g->line_size;

-            g->cur_x   = g->start_x;

-            g->cur_y   = g->start_y;

-

-            // if the width of the specified rectangle is 0, that means

-            // we may not see *any* pixels or the image is malformed;

-            // to make sure this is caught, move the current y down to

-            // max_y (which is what out_gif_code checks).

-            if (w == 0)

-               g->cur_y = g->max_y;

-

-            g->lflags = stbi__get8(s);

-

-            if (g->lflags & 0x40) {

-               g->step = 8 * g->line_size; // first interlaced spacing

-               g->parse = 3;

-            } else {

-               g->step = g->line_size;

-               g->parse = 0;

-            }

-

-            if (g->lflags & 0x80) {

-               stbi__gif_parse_colortable(s,g->lpal, 2 << (g->lflags & 7), g->eflags & 0x01 ? g->transparent : -1);

-               g->color_table = (stbi_uc *) g->lpal;

-            } else if (g->flags & 0x80) {

-               g->color_table = (stbi_uc *) g->pal;

-            } else

-               return stbi__errpuc("missing color table", "Corrupt GIF");            

-            

-            o = stbi__process_gif_raster(s, g);

-            if (!o) return NULL;

-

-            // if this was the first frame, 

-            pcount = g->w * g->h; 

-            if (first_frame && (g->bgindex > 0)) {

-               // if first frame, any pixel not drawn to gets the background color

-               for (pi = 0; pi < pcount; ++pi) {

-                  if (g->history[pi] == 0) {

-                     g->pal[g->bgindex][3] = 255; // just in case it was made transparent, undo that; It will be reset next frame if need be; 

-                     memcpy( &g->out[pi * 4], &g->pal[g->bgindex], 4 ); 

-                  }

-               }

-            }

-

-            return o;

-         }

-

-         case 0x21: // Comment Extension.

-         {

-            int len;

-            int ext = stbi__get8(s); 

-            if (ext == 0xF9) { // Graphic Control Extension.

-               len = stbi__get8(s);

-               if (len == 4) {

-                  g->eflags = stbi__get8(s);

-                  g->delay = 10 * stbi__get16le(s); // delay - 1/100th of a second, saving as 1/1000ths.

-

-                  // unset old transparent

-                  if (g->transparent >= 0) {

-                     g->pal[g->transparent][3] = 255; 

-                  } 

-                  if (g->eflags & 0x01) {

-                     g->transparent = stbi__get8(s);

-                     if (g->transparent >= 0) {

-                        g->pal[g->transparent][3] = 0; 

-                     }

-                  } else {

-                     // don't need transparent

-                     stbi__skip(s, 1); 

-                     g->transparent = -1; 

-                  }

-               } else {

-                  stbi__skip(s, len);

-                  break;

-               }

-            } 

-            while ((len = stbi__get8(s)) != 0) {

-               stbi__skip(s, len);

-            }

-            break;

-         }

-

-         case 0x3B: // gif stream termination code

-            return (stbi_uc *) s; // using '1' causes warning on some compilers

-

-         default:

-            return stbi__errpuc("unknown code", "Corrupt GIF");

-      }

-   }

-}

-

-static void *stbi__load_gif_main(stbi__context *s, int **delays, int *x, int *y, int *z, int *comp, int req_comp)

-{

-   if (stbi__gif_test(s)) {

-      int layers = 0; 

-      stbi_uc *u = 0;

-      stbi_uc *out = 0;

-      stbi_uc *two_back = 0; 

-      stbi__gif g;

-      int stride; 

-      memset(&g, 0, sizeof(g));

-      if (delays) {

-         *delays = 0; 

-      }

-

-      do {

-         u = stbi__gif_load_next(s, &g, comp, req_comp, two_back);

-         if (u == (stbi_uc *) s) u = 0;  // end of animated gif marker

-

-         if (u) {

-            *x = g.w;

-            *y = g.h;

-            ++layers; 

-            stride = g.w * g.h * 4; 

-         

-            if (out) {

-               out = (stbi_uc*) STBI_REALLOC( out, layers * stride ); 

-               if (delays) {

-                  *delays = (int*) STBI_REALLOC( *delays, sizeof(int) * layers ); 

-               }

-            } else {

-               out = (stbi_uc*)stbi__malloc( layers * stride ); 

-               if (delays) {

-                  *delays = (int*) stbi__malloc( layers * sizeof(int) ); 

-               }

-            }

-            memcpy( out + ((layers - 1) * stride), u, stride ); 

-            if (layers >= 2) {

-               two_back = out - 2 * stride; 

-            }

-

-            if (delays) {

-               (*delays)[layers - 1U] = g.delay; 

-            }

-         }

-      } while (u != 0); 

-

-      // free temp buffer; 

-      STBI_FREE(g.out); 

-      STBI_FREE(g.history); 

-      STBI_FREE(g.background); 

-

-      // do the final conversion after loading everything; 

-      if (req_comp && req_comp != 4)

-         out = stbi__convert_format(out, 4, req_comp, layers * g.w, g.h);

-

-      *z = layers; 

-      return out;

-   } else {

-      return stbi__errpuc("not GIF", "Image was not as a gif type."); 

-   }

-}

-

-static void *stbi__gif_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri)

-{

-   stbi_uc *u = 0;

-   stbi__gif g;

-   memset(&g, 0, sizeof(g));

-   STBI_NOTUSED(ri);

-

-   u = stbi__gif_load_next(s, &g, comp, req_comp, 0);

-   if (u == (stbi_uc *) s) u = 0;  // end of animated gif marker

-   if (u) {

-      *x = g.w;

-      *y = g.h;

-

-      // moved conversion to after successful load so that the same

-      // can be done for multiple frames. 

-      if (req_comp && req_comp != 4)

-         u = stbi__convert_format(u, 4, req_comp, g.w, g.h);

-   } else if (g.out) {

-      // if there was an error and we allocated an image buffer, free it!

-      STBI_FREE(g.out);

-   }

-

-   // free buffers needed for multiple frame loading; 

-   STBI_FREE(g.history);

-   STBI_FREE(g.background); 

-

-   return u;

-}

-

-static int stbi__gif_info(stbi__context *s, int *x, int *y, int *comp)

-{

-   return stbi__gif_info_raw(s,x,y,comp);

-}

-#endif

-

-// *************************************************************************************************

-// Radiance RGBE HDR loader

-// originally by Nicolas Schulz

-#ifndef STBI_NO_HDR

-static int stbi__hdr_test_core(stbi__context *s, const char *signature)

-{

-   int i;

-   for (i=0; signature[i]; ++i)

-      if (stbi__get8(s) != signature[i])

-          return 0;

-   stbi__rewind(s);

-   return 1;

-}

-

-static int stbi__hdr_test(stbi__context* s)

-{

-   int r = stbi__hdr_test_core(s, "#?RADIANCE\n");

-   stbi__rewind(s);

-   if(!r) {

-       r = stbi__hdr_test_core(s, "#?RGBE\n");

-       stbi__rewind(s);

-   }

-   return r;

-}

-

-#define STBI__HDR_BUFLEN  1024

-static char *stbi__hdr_gettoken(stbi__context *z, char *buffer)

-{

-   int len=0;

-   char c = '\0';

-

-   c = (char) stbi__get8(z);

-

-   while (!stbi__at_eof(z) && c != '\n') {

-      buffer[len++] = c;

-      if (len == STBI__HDR_BUFLEN-1) {

-         // flush to end of line

-         while (!stbi__at_eof(z) && stbi__get8(z) != '\n')

-            ;

-         break;

-      }

-      c = (char) stbi__get8(z);

-   }

-

-   buffer[len] = 0;

-   return buffer;

-}

-

-static void stbi__hdr_convert(float *output, stbi_uc *input, int req_comp)

-{

-   if ( input[3] != 0 ) {

-      float f1;

-      // Exponent

-      f1 = (float) ldexp(1.0f, input[3] - (int)(128 + 8));

-      if (req_comp <= 2)

-         output[0] = (input[0] + input[1] + input[2]) * f1 / 3;

-      else {

-         output[0] = input[0] * f1;

-         output[1] = input[1] * f1;

-         output[2] = input[2] * f1;

-      }

-      if (req_comp == 2) output[1] = 1;

-      if (req_comp == 4) output[3] = 1;

-   } else {

-      switch (req_comp) {

-         case 4: output[3] = 1; /* fallthrough */

-         case 3: output[0] = output[1] = output[2] = 0;

-                 break;

-         case 2: output[1] = 1; /* fallthrough */

-         case 1: output[0] = 0;

-                 break;

-      }

-   }

-}

-

-static float *stbi__hdr_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri)

-{

-   char buffer[STBI__HDR_BUFLEN];

-   char *token;

-   int valid = 0;

-   int width, height;

-   stbi_uc *scanline;

-   float *hdr_data;

-   int len;

-   unsigned char count, value;

-   int i, j, k, c1,c2, z;

-   const char *headerToken;

-   STBI_NOTUSED(ri);

-

-   // Check identifier

-   headerToken = stbi__hdr_gettoken(s,buffer);

-   if (strcmp(headerToken, "#?RADIANCE") != 0 && strcmp(headerToken, "#?RGBE") != 0)

-      return stbi__errpf("not HDR", "Corrupt HDR image");

-

-   // Parse header

-   for(;;) {

-      token = stbi__hdr_gettoken(s,buffer);

-      if (token[0] == 0) break;

-      if (strcmp(token, "FORMAT=32-bit_rle_rgbe") == 0) valid = 1;

-   }

-

-   if (!valid)    return stbi__errpf("unsupported format", "Unsupported HDR format");

-

-   // Parse width and height

-   // can't use sscanf() if we're not using stdio!

-   token = stbi__hdr_gettoken(s,buffer);

-   if (strncmp(token, "-Y ", 3))  return stbi__errpf("unsupported data layout", "Unsupported HDR format");

-   token += 3;

-   height = (int) strtol(token, &token, 10);

-   while (*token == ' ') ++token;

-   if (strncmp(token, "+X ", 3))  return stbi__errpf("unsupported data layout", "Unsupported HDR format");

-   token += 3;

-   width = (int) strtol(token, NULL, 10);

-

-   *x = width;

-   *y = height;

-

-   if (comp) *comp = 3;

-   if (req_comp == 0) req_comp = 3;

-

-   if (!stbi__mad4sizes_valid(width, height, req_comp, sizeof(float), 0))

-      return stbi__errpf("too large", "HDR image is too large");

-

-   // Read data

-   hdr_data = (float *) stbi__malloc_mad4(width, height, req_comp, sizeof(float), 0);

-   if (!hdr_data)

-      return stbi__errpf("outofmem", "Out of memory");

-

-   // Load image data

-   // image data is stored as some number of sca

-   if ( width < 8 || width >= 32768) {

-      // Read flat data

-      for (j=0; j < height; ++j) {

-         for (i=0; i < width; ++i) {

-            stbi_uc rgbe[4];

-           main_decode_loop:

-            stbi__getn(s, rgbe, 4);

-            stbi__hdr_convert(hdr_data + j * width * req_comp + i * req_comp, rgbe, req_comp);

-         }

-      }

-   } else {

-      // Read RLE-encoded data

-      scanline = NULL;

-

-      for (j = 0; j < height; ++j) {

-         c1 = stbi__get8(s);

-         c2 = stbi__get8(s);

-         len = stbi__get8(s);

-         if (c1 != 2 || c2 != 2 || (len & 0x80)) {

-            // not run-length encoded, so we have to actually use THIS data as a decoded

-            // pixel (note this can't be a valid pixel--one of RGB must be >= 128)

-            stbi_uc rgbe[4];

-            rgbe[0] = (stbi_uc) c1;

-            rgbe[1] = (stbi_uc) c2;

-            rgbe[2] = (stbi_uc) len;

-            rgbe[3] = (stbi_uc) stbi__get8(s);

-            stbi__hdr_convert(hdr_data, rgbe, req_comp);

-            i = 1;

-            j = 0;

-            STBI_FREE(scanline);

-            goto main_decode_loop; // yes, this makes no sense

-         }

-         len <<= 8;

-         len |= stbi__get8(s);

-         if (len != width) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("invalid decoded scanline length", "corrupt HDR"); }

-         if (scanline == NULL) {

-            scanline = (stbi_uc *) stbi__malloc_mad2(width, 4, 0);

-            if (!scanline) {

-               STBI_FREE(hdr_data);

-               return stbi__errpf("outofmem", "Out of memory");

-            }

-         }

-

-         for (k = 0; k < 4; ++k) {

-            int nleft;

-            i = 0;

-            while ((nleft = width - i) > 0) {

-               count = stbi__get8(s);

-               if (count > 128) {

-                  // Run

-                  value = stbi__get8(s);

-                  count -= 128;

-                  if (count > nleft) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("corrupt", "bad RLE data in HDR"); }

-                  for (z = 0; z < count; ++z)

-                     scanline[i++ * 4 + k] = value;

-               } else {

-                  // Dump

-                  if (count > nleft) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("corrupt", "bad RLE data in HDR"); }

-                  for (z = 0; z < count; ++z)

-                     scanline[i++ * 4 + k] = stbi__get8(s);

-               }

-            }

-         }

-         for (i=0; i < width; ++i)

-            stbi__hdr_convert(hdr_data+(j*width + i)*req_comp, scanline + i*4, req_comp);

-      }

-      if (scanline)

-         STBI_FREE(scanline);

-   }

-

-   return hdr_data;

-}

-

-static int stbi__hdr_info(stbi__context *s, int *x, int *y, int *comp)

-{

-   char buffer[STBI__HDR_BUFLEN];

-   char *token;

-   int valid = 0;

-   int dummy;

-

-   if (!x) x = &dummy;

-   if (!y) y = &dummy;

-   if (!comp) comp = &dummy;

-

-   if (stbi__hdr_test(s) == 0) {

-       stbi__rewind( s );

-       return 0;

-   }

-

-   for(;;) {

-      token = stbi__hdr_gettoken(s,buffer);

-      if (token[0] == 0) break;

-      if (strcmp(token, "FORMAT=32-bit_rle_rgbe") == 0) valid = 1;

-   }

-

-   if (!valid) {

-       stbi__rewind( s );

-       return 0;

-   }

-   token = stbi__hdr_gettoken(s,buffer);

-   if (strncmp(token, "-Y ", 3)) {

-       stbi__rewind( s );

-       return 0;

-   }

-   token += 3;

-   *y = (int) strtol(token, &token, 10);

-   while (*token == ' ') ++token;

-   if (strncmp(token, "+X ", 3)) {

-       stbi__rewind( s );

-       return 0;

-   }

-   token += 3;

-   *x = (int) strtol(token, NULL, 10);

-   *comp = 3;

-   return 1;

-}

-#endif // STBI_NO_HDR

-

-#ifndef STBI_NO_BMP

-static int stbi__bmp_info(stbi__context *s, int *x, int *y, int *comp)

-{

-   void *p;

-   stbi__bmp_data info;

-

-   info.all_a = 255;

-   p = stbi__bmp_parse_header(s, &info);

-   stbi__rewind( s );

-   if (p == NULL)

-      return 0;

-   if (x) *x = s->img_x;

-   if (y) *y = s->img_y;

-   if (comp) *comp = info.ma ? 4 : 3;

-   return 1;

-}

-#endif

-

-#ifndef STBI_NO_PSD

-static int stbi__psd_info(stbi__context *s, int *x, int *y, int *comp)

-{

-   int channelCount, dummy, depth;

-   if (!x) x = &dummy;

-   if (!y) y = &dummy;

-   if (!comp) comp = &dummy;

-   if (stbi__get32be(s) != 0x38425053) {

-       stbi__rewind( s );

-       return 0;

-   }

-   if (stbi__get16be(s) != 1) {

-       stbi__rewind( s );

-       return 0;

-   }

-   stbi__skip(s, 6);

-   channelCount = stbi__get16be(s);

-   if (channelCount < 0 || channelCount > 16) {

-       stbi__rewind( s );

-       return 0;

-   }

-   *y = stbi__get32be(s);

-   *x = stbi__get32be(s);

-   depth = stbi__get16be(s);

-   if (depth != 8 && depth != 16) {

-       stbi__rewind( s );

-       return 0;

-   }

-   if (stbi__get16be(s) != 3) {

-       stbi__rewind( s );

-       return 0;

-   }

-   *comp = 4;

-   return 1;

-}

-

-static int stbi__psd_is16(stbi__context *s)

-{

-   int channelCount, depth;

-   if (stbi__get32be(s) != 0x38425053) {

-       stbi__rewind( s );

-       return 0;

-   }

-   if (stbi__get16be(s) != 1) {

-       stbi__rewind( s );

-       return 0;

-   }

-   stbi__skip(s, 6);

-   channelCount = stbi__get16be(s);

-   if (channelCount < 0 || channelCount > 16) {

-       stbi__rewind( s );

-       return 0;

-   }

-   (void) stbi__get32be(s);

-   (void) stbi__get32be(s);

-   depth = stbi__get16be(s);

-   if (depth != 16) {

-       stbi__rewind( s );

-       return 0;

-   }

-   return 1;

-}

-#endif

-

-#ifndef STBI_NO_PIC

-static int stbi__pic_info(stbi__context *s, int *x, int *y, int *comp)

-{

-   int act_comp=0,num_packets=0,chained,dummy;

-   stbi__pic_packet packets[10];

-

-   if (!x) x = &dummy;

-   if (!y) y = &dummy;

-   if (!comp) comp = &dummy;

-

-   if (!stbi__pic_is4(s,"\x53\x80\xF6\x34")) {

-      stbi__rewind(s);

-      return 0;

-   }

-

-   stbi__skip(s, 88);

-

-   *x = stbi__get16be(s);

-   *y = stbi__get16be(s);

-   if (stbi__at_eof(s)) {

-      stbi__rewind( s);

-      return 0;

-   }

-   if ( (*x) != 0 && (1 << 28) / (*x) < (*y)) {

-      stbi__rewind( s );

-      return 0;

-   }

-

-   stbi__skip(s, 8);

-

-   do {

-      stbi__pic_packet *packet;

-

-      if (num_packets==sizeof(packets)/sizeof(packets[0]))

-         return 0;

-

-      packet = &packets[num_packets++];

-      chained = stbi__get8(s);

-      packet->size    = stbi__get8(s);

-      packet->type    = stbi__get8(s);

-      packet->channel = stbi__get8(s);

-      act_comp |= packet->channel;

-

-      if (stbi__at_eof(s)) {

-          stbi__rewind( s );

-          return 0;

-      }

-      if (packet->size != 8) {

-          stbi__rewind( s );

-          return 0;

-      }

-   } while (chained);

-

-   *comp = (act_comp & 0x10 ? 4 : 3);

-

-   return 1;

-}

-#endif

-

-// *************************************************************************************************

-// Portable Gray Map and Portable Pixel Map loader

-// by Ken Miller

-//

-// PGM: http://netpbm.sourceforge.net/doc/pgm.html

-// PPM: http://netpbm.sourceforge.net/doc/ppm.html

-//

-// Known limitations:

-//    Does not support comments in the header section

-//    Does not support ASCII image data (formats P2 and P3)

-//    Does not support 16-bit-per-channel

-

-#ifndef STBI_NO_PNM

-

-static int      stbi__pnm_test(stbi__context *s)

-{

-   char p, t;

-   p = (char) stbi__get8(s);

-   t = (char) stbi__get8(s);

-   if (p != 'P' || (t != '5' && t != '6')) {

-       stbi__rewind( s );

-       return 0;

-   }

-   return 1;

-}

-

-static void *stbi__pnm_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri)

-{

-   stbi_uc *out;

-   STBI_NOTUSED(ri);

-

-   if (!stbi__pnm_info(s, (int *)&s->img_x, (int *)&s->img_y, (int *)&s->img_n))

-      return 0;

-

-   *x = s->img_x;

-   *y = s->img_y;

-   if (comp) *comp = s->img_n;

-

-   if (!stbi__mad3sizes_valid(s->img_n, s->img_x, s->img_y, 0))

-      return stbi__errpuc("too large", "PNM too large");

-

-   out = (stbi_uc *) stbi__malloc_mad3(s->img_n, s->img_x, s->img_y, 0);

-   if (!out) return stbi__errpuc("outofmem", "Out of memory");

-   stbi__getn(s, out, s->img_n * s->img_x * s->img_y);

-

-   if (req_comp && req_comp != s->img_n) {

-      out = stbi__convert_format(out, s->img_n, req_comp, s->img_x, s->img_y);

-      if (out == NULL) return out; // stbi__convert_format frees input on failure

-   }

-   return out;

-}

-

-static int      stbi__pnm_isspace(char c)

-{

-   return c == ' ' || c == '\t' || c == '\n' || c == '\v' || c == '\f' || c == '\r';

-}

-

-static void     stbi__pnm_skip_whitespace(stbi__context *s, char *c)

-{

-   for (;;) {

-      while (!stbi__at_eof(s) && stbi__pnm_isspace(*c))

-         *c = (char) stbi__get8(s);

-

-      if (stbi__at_eof(s) || *c != '#')

-         break;

-

-      while (!stbi__at_eof(s) && *c != '\n' && *c != '\r' )

-         *c = (char) stbi__get8(s);

-   }

-}

-

-static int      stbi__pnm_isdigit(char c)

-{

-   return c >= '0' && c <= '9';

-}

-

-static int      stbi__pnm_getinteger(stbi__context *s, char *c)

-{

-   int value = 0;

-

-   while (!stbi__at_eof(s) && stbi__pnm_isdigit(*c)) {

-      value = value*10 + (*c - '0');

-      *c = (char) stbi__get8(s);

-   }

-

-   return value;

-}

-

-static int      stbi__pnm_info(stbi__context *s, int *x, int *y, int *comp)

-{

-   int maxv, dummy;

-   char c, p, t;

-

-   if (!x) x = &dummy;

-   if (!y) y = &dummy;

-   if (!comp) comp = &dummy;

-

-   stbi__rewind(s);

-

-   // Get identifier

-   p = (char) stbi__get8(s);

-   t = (char) stbi__get8(s);

-   if (p != 'P' || (t != '5' && t != '6')) {

-       stbi__rewind(s);

-       return 0;

-   }

-

-   *comp = (t == '6') ? 3 : 1;  // '5' is 1-component .pgm; '6' is 3-component .ppm

-

-   c = (char) stbi__get8(s);

-   stbi__pnm_skip_whitespace(s, &c);

-

-   *x = stbi__pnm_getinteger(s, &c); // read width

-   stbi__pnm_skip_whitespace(s, &c);

-

-   *y = stbi__pnm_getinteger(s, &c); // read height

-   stbi__pnm_skip_whitespace(s, &c);

-

-   maxv = stbi__pnm_getinteger(s, &c);  // read max value

-

-   if (maxv > 255)

-      return stbi__err("max value > 255", "PPM image not 8-bit");

-   else

-      return 1;

-}

-#endif

-

-static int stbi__info_main(stbi__context *s, int *x, int *y, int *comp)

-{

-   #ifndef STBI_NO_JPEG

-   if (stbi__jpeg_info(s, x, y, comp)) return 1;

-   #endif

-

-   #ifndef STBI_NO_PNG

-   if (stbi__png_info(s, x, y, comp))  return 1;

-   #endif

-

-   #ifndef STBI_NO_GIF

-   if (stbi__gif_info(s, x, y, comp))  return 1;

-   #endif

-

-   #ifndef STBI_NO_BMP

-   if (stbi__bmp_info(s, x, y, comp))  return 1;

-   #endif

-

-   #ifndef STBI_NO_PSD

-   if (stbi__psd_info(s, x, y, comp))  return 1;

-   #endif

-

-   #ifndef STBI_NO_PIC

-   if (stbi__pic_info(s, x, y, comp))  return 1;

-   #endif

-

-   #ifndef STBI_NO_PNM

-   if (stbi__pnm_info(s, x, y, comp))  return 1;

-   #endif

-

-   #ifndef STBI_NO_HDR

-   if (stbi__hdr_info(s, x, y, comp))  return 1;

-   #endif

-

-   // test tga last because it's a crappy test!

-   #ifndef STBI_NO_TGA

-   if (stbi__tga_info(s, x, y, comp))

-       return 1;

-   #endif

-   return stbi__err("unknown image type", "Image not of any known type, or corrupt");

-}

-

-static int stbi__is_16_main(stbi__context *s)

-{

-   #ifndef STBI_NO_PNG

-   if (stbi__png_is16(s))  return 1;

-   #endif

-

-   #ifndef STBI_NO_PSD

-   if (stbi__psd_is16(s))  return 1;

-   #endif

-

-   return 0;

-}

-

-#ifndef STBI_NO_STDIO

-STBIDEF int stbi_info(char const *filename, int *x, int *y, int *comp)

-{

-    FILE *f = stbi__fopen(filename, "rb");

-    int result;

-    if (!f) return stbi__err("can't fopen", "Unable to open file");

-    result = stbi_info_from_file(f, x, y, comp);

-    fclose(f);

-    return result;

-}

-

-STBIDEF int stbi_info_from_file(FILE *f, int *x, int *y, int *comp)

-{

-   int r;

-   stbi__context s;

-   long pos = ftell(f);

-   stbi__start_file(&s, f);

-   r = stbi__info_main(&s,x,y,comp);

-   fseek(f,pos,SEEK_SET);

-   return r;

-}

-

-STBIDEF int stbi_is_16_bit(char const *filename)

-{

-    FILE *f = stbi__fopen(filename, "rb");

-    int result;

-    if (!f) return stbi__err("can't fopen", "Unable to open file");

-    result = stbi_is_16_bit_from_file(f);

-    fclose(f);

-    return result;

-}

-

-STBIDEF int stbi_is_16_bit_from_file(FILE *f)

-{

-   int r;

-   stbi__context s;

-   long pos = ftell(f);

-   stbi__start_file(&s, f);

-   r = stbi__is_16_main(&s);

-   fseek(f,pos,SEEK_SET);

-   return r;

-}

-#endif // !STBI_NO_STDIO

-

-STBIDEF int stbi_info_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp)

-{

-   stbi__context s;

-   stbi__start_mem(&s,buffer,len);

-   return stbi__info_main(&s,x,y,comp);

-}

-

-STBIDEF int stbi_info_from_callbacks(stbi_io_callbacks const *c, void *user, int *x, int *y, int *comp)

-{

-   stbi__context s;

-   stbi__start_callbacks(&s, (stbi_io_callbacks *) c, user);

-   return stbi__info_main(&s,x,y,comp);

-}

-

-STBIDEF int stbi_is_16_bit_from_memory(stbi_uc const *buffer, int len)

-{

-   stbi__context s;

-   stbi__start_mem(&s,buffer,len);

-   return stbi__is_16_main(&s);

-}

-

-STBIDEF int stbi_is_16_bit_from_callbacks(stbi_io_callbacks const *c, void *user)

-{

-   stbi__context s;

-   stbi__start_callbacks(&s, (stbi_io_callbacks *) c, user);

-   return stbi__is_16_main(&s);

-}

-

-#endif // STB_IMAGE_IMPLEMENTATION

-

-/*

-   revision history:

-      2.20  (2019-02-07) support utf8 filenames in Windows; fix warnings and platform ifdefs 

-      2.19  (2018-02-11) fix warning

-      2.18  (2018-01-30) fix warnings

-      2.17  (2018-01-29) change sbti__shiftsigned to avoid clang -O2 bug

-                         1-bit BMP

-                         *_is_16_bit api

-                         avoid warnings

-      2.16  (2017-07-23) all functions have 16-bit variants;

-                         STBI_NO_STDIO works again;

-                         compilation fixes;

-                         fix rounding in unpremultiply;

-                         optimize vertical flip;

-                         disable raw_len validation;

-                         documentation fixes

-      2.15  (2017-03-18) fix png-1,2,4 bug; now all Imagenet JPGs decode;

-                         warning fixes; disable run-time SSE detection on gcc;

-                         uniform handling of optional "return" values;

-                         thread-safe initialization of zlib tables

-      2.14  (2017-03-03) remove deprecated STBI_JPEG_OLD; fixes for Imagenet JPGs

-      2.13  (2016-11-29) add 16-bit API, only supported for PNG right now

-      2.12  (2016-04-02) fix typo in 2.11 PSD fix that caused crashes

-      2.11  (2016-04-02) allocate large structures on the stack

-                         remove white matting for transparent PSD

-                         fix reported channel count for PNG & BMP

-                         re-enable SSE2 in non-gcc 64-bit

-                         support RGB-formatted JPEG

-                         read 16-bit PNGs (only as 8-bit)

-      2.10  (2016-01-22) avoid warning introduced in 2.09 by STBI_REALLOC_SIZED

-      2.09  (2016-01-16) allow comments in PNM files

-                         16-bit-per-pixel TGA (not bit-per-component)

-                         info() for TGA could break due to .hdr handling

-                         info() for BMP to shares code instead of sloppy parse

-                         can use STBI_REALLOC_SIZED if allocator doesn't support realloc

-                         code cleanup

-      2.08  (2015-09-13) fix to 2.07 cleanup, reading RGB PSD as RGBA

-      2.07  (2015-09-13) fix compiler warnings

-                         partial animated GIF support

-                         limited 16-bpc PSD support

-                         #ifdef unused functions

-                         bug with < 92 byte PIC,PNM,HDR,TGA

-      2.06  (2015-04-19) fix bug where PSD returns wrong '*comp' value

-      2.05  (2015-04-19) fix bug in progressive JPEG handling, fix warning

-      2.04  (2015-04-15) try to re-enable SIMD on MinGW 64-bit

-      2.03  (2015-04-12) extra corruption checking (mmozeiko)

-                         stbi_set_flip_vertically_on_load (nguillemot)

-                         fix NEON support; fix mingw support

-      2.02  (2015-01-19) fix incorrect assert, fix warning

-      2.01  (2015-01-17) fix various warnings; suppress SIMD on gcc 32-bit without -msse2

-      2.00b (2014-12-25) fix STBI_MALLOC in progressive JPEG

-      2.00  (2014-12-25) optimize JPG, including x86 SSE2 & NEON SIMD (ryg)

-                         progressive JPEG (stb)

-                         PGM/PPM support (Ken Miller)

-                         STBI_MALLOC,STBI_REALLOC,STBI_FREE

-                         GIF bugfix -- seemingly never worked

-                         STBI_NO_*, STBI_ONLY_*

-      1.48  (2014-12-14) fix incorrectly-named assert()

-      1.47  (2014-12-14) 1/2/4-bit PNG support, both direct and paletted (Omar Cornut & stb)

-                         optimize PNG (ryg)

-                         fix bug in interlaced PNG with user-specified channel count (stb)

-      1.46  (2014-08-26)

-              fix broken tRNS chunk (colorkey-style transparency) in non-paletted PNG

-      1.45  (2014-08-16)

-              fix MSVC-ARM internal compiler error by wrapping malloc

-      1.44  (2014-08-07)

-              various warning fixes from Ronny Chevalier

-      1.43  (2014-07-15)

-              fix MSVC-only compiler problem in code changed in 1.42

-      1.42  (2014-07-09)

-              don't define _CRT_SECURE_NO_WARNINGS (affects user code)

-              fixes to stbi__cleanup_jpeg path

-              added STBI_ASSERT to avoid requiring assert.h

-      1.41  (2014-06-25)

-              fix search&replace from 1.36 that messed up comments/error messages

-      1.40  (2014-06-22)

-              fix gcc struct-initialization warning

-      1.39  (2014-06-15)

-              fix to TGA optimization when req_comp != number of components in TGA;

-              fix to GIF loading because BMP wasn't rewinding (whoops, no GIFs in my test suite)

-              add support for BMP version 5 (more ignored fields)

-      1.38  (2014-06-06)

-              suppress MSVC warnings on integer casts truncating values

-              fix accidental rename of 'skip' field of I/O

-      1.37  (2014-06-04)

-              remove duplicate typedef

-      1.36  (2014-06-03)

-              convert to header file single-file library

-              if de-iphone isn't set, load iphone images color-swapped instead of returning NULL

-      1.35  (2014-05-27)

-              various warnings

-              fix broken STBI_SIMD path

-              fix bug where stbi_load_from_file no longer left file pointer in correct place

-              fix broken non-easy path for 32-bit BMP (possibly never used)

-              TGA optimization by Arseny Kapoulkine

-      1.34  (unknown)

-              use STBI_NOTUSED in stbi__resample_row_generic(), fix one more leak in tga failure case

-      1.33  (2011-07-14)

-              make stbi_is_hdr work in STBI_NO_HDR (as specified), minor compiler-friendly improvements

-      1.32  (2011-07-13)

-              support for "info" function for all supported filetypes (SpartanJ)

-      1.31  (2011-06-20)

-              a few more leak fixes, bug in PNG handling (SpartanJ)

-      1.30  (2011-06-11)

-              added ability to load files via callbacks to accomidate custom input streams (Ben Wenger)

-              removed deprecated format-specific test/load functions

-              removed support for installable file formats (stbi_loader) -- would have been broken for IO callbacks anyway

-              error cases in bmp and tga give messages and don't leak (Raymond Barbiero, grisha)

-              fix inefficiency in decoding 32-bit BMP (David Woo)

-      1.29  (2010-08-16)

-              various warning fixes from Aurelien Pocheville

-      1.28  (2010-08-01)

-              fix bug in GIF palette transparency (SpartanJ)

-      1.27  (2010-08-01)

-              cast-to-stbi_uc to fix warnings

-      1.26  (2010-07-24)

-              fix bug in file buffering for PNG reported by SpartanJ

-      1.25  (2010-07-17)

-              refix trans_data warning (Won Chun)

-      1.24  (2010-07-12)

-              perf improvements reading from files on platforms with lock-heavy fgetc()

-              minor perf improvements for jpeg

-              deprecated type-specific functions so we'll get feedback if they're needed

-              attempt to fix trans_data warning (Won Chun)

-      1.23    fixed bug in iPhone support

-      1.22  (2010-07-10)

-              removed image *writing* support

-              stbi_info support from Jetro Lauha

-              GIF support from Jean-Marc Lienher

-              iPhone PNG-extensions from James Brown

-              warning-fixes from Nicolas Schulz and Janez Zemva (i.stbi__err. Janez (U+017D)emva)

-      1.21    fix use of 'stbi_uc' in header (reported by jon blow)

-      1.20    added support for Softimage PIC, by Tom Seddon

-      1.19    bug in interlaced PNG corruption check (found by ryg)

-      1.18  (2008-08-02)

-              fix a threading bug (local mutable static)

-      1.17    support interlaced PNG

-      1.16    major bugfix - stbi__convert_format converted one too many pixels

-      1.15    initialize some fields for thread safety

-      1.14    fix threadsafe conversion bug

-              header-file-only version (#define STBI_HEADER_FILE_ONLY before including)

-      1.13    threadsafe

-      1.12    const qualifiers in the API

-      1.11    Support installable IDCT, colorspace conversion routines

-      1.10    Fixes for 64-bit (don't use "unsigned long")

-              optimized upsampling by Fabian "ryg" Giesen

-      1.09    Fix format-conversion for PSD code (bad global variables!)

-      1.08    Thatcher Ulrich's PSD code integrated by Nicolas Schulz

-      1.07    attempt to fix C++ warning/errors again

-      1.06    attempt to fix C++ warning/errors again

-      1.05    fix TGA loading to return correct *comp and use good luminance calc

-      1.04    default float alpha is 1, not 255; use 'void *' for stbi_image_free

-      1.03    bugfixes to STBI_NO_STDIO, STBI_NO_HDR

-      1.02    support for (subset of) HDR files, float interface for preferred access to them

-      1.01    fix bug: possible bug in handling right-side up bmps... not sure

-              fix bug: the stbi__bmp_load() and stbi__tga_load() functions didn't work at all

-      1.00    interface to zlib that skips zlib header

-      0.99    correct handling of alpha in palette

-      0.98    TGA loader by lonesock; dynamically add loaders (untested)

-      0.97    jpeg errors on too large a file; also catch another malloc failure

-      0.96    fix detection of invalid v value - particleman@mollyrocket forum

-      0.95    during header scan, seek to markers in case of padding

-      0.94    STBI_NO_STDIO to disable stdio usage; rename all #defines the same

-      0.93    handle jpegtran output; verbose errors

-      0.92    read 4,8,16,24,32-bit BMP files of several formats

-      0.91    output 24-bit Windows 3.0 BMP files

-      0.90    fix a few more warnings; bump version number to approach 1.0

-      0.61    bugfixes due to Marc LeBlanc, Christopher Lloyd

-      0.60    fix compiling as c++

-      0.59    fix warnings: merge Dave Moore's -Wall fixes

-      0.58    fix bug: zlib uncompressed mode len/nlen was wrong endian

-      0.57    fix bug: jpg last huffman symbol before marker was >9 bits but less than 16 available

-      0.56    fix bug: zlib uncompressed mode len vs. nlen

-      0.55    fix bug: restart_interval not initialized to 0

-      0.54    allow NULL for 'int *comp'

-      0.53    fix bug in png 3->4; speedup png decoding

-      0.52    png handles req_comp=3,4 directly; minor cleanup; jpeg comments

-      0.51    obey req_comp requests, 1-component jpegs return as 1-component,

-              on 'test' only check type, not whether we support this variant

-      0.50  (2006-11-19)

-              first released version

-*/

-

-

-/*

-------------------------------------------------------------------------------

-This software is available under 2 licenses -- choose whichever you prefer.

-------------------------------------------------------------------------------

-ALTERNATIVE A - MIT License

-Copyright (c) 2017 Sean Barrett

-Permission is hereby granted, free of charge, to any person obtaining a copy of

-this software and associated documentation files (the "Software"), to deal in

-the Software without restriction, including without limitation the rights to

-use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies

-of the Software, and to permit persons to whom the Software is furnished to do

-so, subject to the following conditions:

-The above copyright notice and this permission notice shall be included in all

-copies or substantial portions of the Software.

-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE

-SOFTWARE.

-------------------------------------------------------------------------------

-ALTERNATIVE B - Public Domain (www.unlicense.org)

-This is free and unencumbered software released into the public domain.

-Anyone is free to copy, modify, publish, use, compile, sell, or distribute this

-software, either in source code form or as a compiled binary, for any purpose,

-commercial or non-commercial, and by any means.

-In jurisdictions that recognize copyright laws, the author or authors of this

-software dedicate any and all copyright interest in the software to the public

-domain. We make this dedication for the benefit of the public at large and to

-the detriment of our heirs and successors. We intend this dedication to be an

-overt act of relinquishment in perpetuity of all present and future rights to

-this software under copyright law.

-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

-AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN

-ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION

-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

-------------------------------------------------------------------------------

-*/

+/* stb_image - v2.22 - public domain image loader - http://nothings.org/stb
+                                  no warranty implied; use at your own risk
+
+   Do this:
+      #define STB_IMAGE_IMPLEMENTATION
+   before you include this file in *one* C or C++ file to create the implementation.
+
+   // i.e. it should look like this:
+   #include ...
+   #include ...
+   #include ...
+   #define STB_IMAGE_IMPLEMENTATION
+   #include "stb_image.h"
+
+   You can #define STBI_ASSERT(x) before the #include to avoid using assert.h.
+   And #define STBI_MALLOC, STBI_REALLOC, and STBI_FREE to avoid using malloc,realloc,free
+
+
+   QUICK NOTES:
+      Primarily of interest to game developers and other people who can
+          avoid problematic images and only need the trivial interface
+
+      JPEG baseline & progressive (12 bpc/arithmetic not supported, same as stock IJG lib)
+      PNG 1/2/4/8/16-bit-per-channel
+
+      TGA (not sure what subset, if a subset)
+      BMP non-1bpp, non-RLE
+      PSD (composited view only, no extra channels, 8/16 bit-per-channel)
+
+      GIF (*comp always reports as 4-channel)
+      HDR (radiance rgbE format)
+      PIC (Softimage PIC)
+      PNM (PPM and PGM binary only)
+
+      Animated GIF still needs a proper API, but here's one way to do it:
+          http://gist.github.com/urraka/685d9a6340b26b830d49
+
+      - decode from memory or through FILE (define STBI_NO_STDIO to remove code)
+      - decode from arbitrary I/O callbacks
+      - SIMD acceleration on x86/x64 (SSE2) and ARM (NEON)
+
+   Full documentation under "DOCUMENTATION" below.
+
+
+LICENSE
+
+  See end of file for license information.
+
+RECENT REVISION HISTORY:
+
+      2.22  (2019-03-04) gif fixes, fix warnings
+      2.21  (2019-02-25) fix typo in comment
+      2.20  (2019-02-07) support utf8 filenames in Windows; fix warnings and platform ifdefs 
+      2.19  (2018-02-11) fix warning
+      2.18  (2018-01-30) fix warnings
+      2.17  (2018-01-29) bugfix, 1-bit BMP, 16-bitness query, fix warnings
+      2.16  (2017-07-23) all functions have 16-bit variants; optimizations; bugfixes
+      2.15  (2017-03-18) fix png-1,2,4; all Imagenet JPGs; no runtime SSE detection on GCC
+      2.14  (2017-03-03) remove deprecated STBI_JPEG_OLD; fixes for Imagenet JPGs
+      2.13  (2016-12-04) experimental 16-bit API, only for PNG so far; fixes
+      2.12  (2016-04-02) fix typo in 2.11 PSD fix that caused crashes
+      2.11  (2016-04-02) 16-bit PNGS; enable SSE2 in non-gcc x64
+                         RGB-format JPEG; remove white matting in PSD;
+                         allocate large structures on the stack;
+                         correct channel count for PNG & BMP
+      2.10  (2016-01-22) avoid warning introduced in 2.09
+      2.09  (2016-01-16) 16-bit TGA; comments in PNM files; STBI_REALLOC_SIZED
+
+   See end of file for full revision history.
+
+
+ ============================    Contributors    =========================
+
+ Image formats                          Extensions, features
+    Sean Barrett (jpeg, png, bmp)          Jetro Lauha (stbi_info)
+    Nicolas Schulz (hdr, psd)              Martin "SpartanJ" Golini (stbi_info)
+    Jonathan Dummer (tga)                  James "moose2000" Brown (iPhone PNG)
+    Jean-Marc Lienher (gif)                Ben "Disch" Wenger (io callbacks)
+    Tom Seddon (pic)                       Omar Cornut (1/2/4-bit PNG)
+    Thatcher Ulrich (psd)                  Nicolas Guillemot (vertical flip)
+    Ken Miller (pgm, ppm)                  Richard Mitton (16-bit PSD)
+    github:urraka (animated gif)           Junggon Kim (PNM comments)
+    Christopher Forseth (animated gif)     Daniel Gibson (16-bit TGA)
+                                           socks-the-fox (16-bit PNG)
+                                           Jeremy Sawicki (handle all ImageNet JPGs)
+ Optimizations & bugfixes                  Mikhail Morozov (1-bit BMP)
+    Fabian "ryg" Giesen                    Anael Seghezzi (is-16-bit query)
+    Arseny Kapoulkine
+    John-Mark Allen
+    Carmelo J Fdez-Aguera
+
+ Bug & warning fixes
+    Marc LeBlanc            David Woo          Guillaume George   Martins Mozeiko
+    Christpher Lloyd        Jerry Jansson      Joseph Thomson     Phil Jordan
+    Dave Moore              Roy Eltham         Hayaki Saito       Nathan Reed
+    Won Chun                Luke Graham        Johan Duparc       Nick Verigakis
+    the Horde3D community   Thomas Ruf         Ronny Chevalier    github:rlyeh
+    Janez Zemva             John Bartholomew   Michal Cichon      github:romigrou
+    Jonathan Blow           Ken Hamada         Tero Hanninen      github:svdijk
+    Laurent Gomila          Cort Stratton      Sergio Gonzalez    github:snagar
+    Aruelien Pocheville     Thibault Reuille   Cass Everitt       github:Zelex
+    Ryamond Barbiero        Paul Du Bois       Engin Manap        github:grim210
+    Aldo Culquicondor       Philipp Wiesemann  Dale Weiler        github:sammyhw
+    Oriol Ferrer Mesia      Josh Tobin         Matthew Gregan     github:phprus
+    Julian Raschke          Gregory Mullen     Baldur Karlsson    github:poppolopoppo
+    Christian Floisand      Kevin Schmidt      JR Smith           github:darealshinji
+    Blazej Dariusz Roszkowski                                     github:Michaelangel007
+*/
+
+#ifndef STBI_INCLUDE_STB_IMAGE_H
+#define STBI_INCLUDE_STB_IMAGE_H
+
+// DOCUMENTATION
+//
+// Limitations:
+//    - no 12-bit-per-channel JPEG
+//    - no JPEGs with arithmetic coding
+//    - GIF always returns *comp=4
+//
+// Basic usage (see HDR discussion below for HDR usage):
+//    int x,y,n;
+//    unsigned char *data = stbi_load(filename, &x, &y, &n, 0);
+//    // ... process data if not NULL ...
+//    // ... x = width, y = height, n = # 8-bit components per pixel ...
+//    // ... replace '0' with '1'..'4' to force that many components per pixel
+//    // ... but 'n' will always be the number that it would have been if you said 0
+//    stbi_image_free(data)
+//
+// Standard parameters:
+//    int *x                 -- outputs image width in pixels
+//    int *y                 -- outputs image height in pixels
+//    int *channels_in_file  -- outputs # of image components in image file
+//    int desired_channels   -- if non-zero, # of image components requested in result
+//
+// The return value from an image loader is an 'unsigned char *' which points
+// to the pixel data, or NULL on an allocation failure or if the image is
+// corrupt or invalid. The pixel data consists of *y scanlines of *x pixels,
+// with each pixel consisting of N interleaved 8-bit components; the first
+// pixel pointed to is top-left-most in the image. There is no padding between
+// image scanlines or between pixels, regardless of format. The number of
+// components N is 'desired_channels' if desired_channels is non-zero, or
+// *channels_in_file otherwise. If desired_channels is non-zero,
+// *channels_in_file has the number of components that _would_ have been
+// output otherwise. E.g. if you set desired_channels to 4, you will always
+// get RGBA output, but you can check *channels_in_file to see if it's trivially
+// opaque because e.g. there were only 3 channels in the source image.
+//
+// An output image with N components has the following components interleaved
+// in this order in each pixel:
+//
+//     N=#comp     components
+//       1           grey
+//       2           grey, alpha
+//       3           red, green, blue
+//       4           red, green, blue, alpha
+//
+// If image loading fails for any reason, the return value will be NULL,
+// and *x, *y, *channels_in_file will be unchanged. The function
+// stbi_failure_reason() can be queried for an extremely brief, end-user
+// unfriendly explanation of why the load failed. Define STBI_NO_FAILURE_STRINGS
+// to avoid compiling these strings at all, and STBI_FAILURE_USERMSG to get slightly
+// more user-friendly ones.
+//
+// Paletted PNG, BMP, GIF, and PIC images are automatically depalettized.
+//
+// ===========================================================================
+//
+// UNICODE:
+//
+//   If compiling for Windows and you wish to use Unicode filenames, compile
+//   with
+//       #define STBI_WINDOWS_UTF8
+//   and pass utf8-encoded filenames. Call stbi_convert_wchar_to_utf8 to convert
+//   Windows wchar_t filenames to utf8.
+//
+// ===========================================================================
+//
+// Philosophy
+//
+// stb libraries are designed with the following priorities:
+//
+//    1. easy to use
+//    2. easy to maintain
+//    3. good performance
+//
+// Sometimes I let "good performance" creep up in priority over "easy to maintain",
+// and for best performance I may provide less-easy-to-use APIs that give higher
+// performance, in addition to the easy-to-use ones. Nevertheless, it's important
+// to keep in mind that from the standpoint of you, a client of this library,
+// all you care about is #1 and #3, and stb libraries DO NOT emphasize #3 above all.
+//
+// Some secondary priorities arise directly from the first two, some of which
+// provide more explicit reasons why performance can't be emphasized.
+//
+//    - Portable ("ease of use")
+//    - Small source code footprint ("easy to maintain")
+//    - No dependencies ("ease of use")
+//
+// ===========================================================================
+//
+// I/O callbacks
+//
+// I/O callbacks allow you to read from arbitrary sources, like packaged
+// files or some other source. Data read from callbacks are processed
+// through a small internal buffer (currently 128 bytes) to try to reduce
+// overhead.
+//
+// The three functions you must define are "read" (reads some bytes of data),
+// "skip" (skips some bytes of data), "eof" (reports if the stream is at the end).
+//
+// ===========================================================================
+//
+// SIMD support
+//
+// The JPEG decoder will try to automatically use SIMD kernels on x86 when
+// supported by the compiler. For ARM Neon support, you must explicitly
+// request it.
+//
+// (The old do-it-yourself SIMD API is no longer supported in the current
+// code.)
+//
+// On x86, SSE2 will automatically be used when available based on a run-time
+// test; if not, the generic C versions are used as a fall-back. On ARM targets,
+// the typical path is to have separate builds for NEON and non-NEON devices
+// (at least this is true for iOS and Android). Therefore, the NEON support is
+// toggled by a build flag: define STBI_NEON to get NEON loops.
+//
+// If for some reason you do not want to use any of SIMD code, or if
+// you have issues compiling it, you can disable it entirely by
+// defining STBI_NO_SIMD.
+//
+// ===========================================================================
+//
+// HDR image support   (disable by defining STBI_NO_HDR)
+//
+// stb_image supports loading HDR images in general, and currently the Radiance
+// .HDR file format specifically. You can still load any file through the existing
+// interface; if you attempt to load an HDR file, it will be automatically remapped
+// to LDR, assuming gamma 2.2 and an arbitrary scale factor defaulting to 1;
+// both of these constants can be reconfigured through this interface:
+//
+//     stbi_hdr_to_ldr_gamma(2.2f);
+//     stbi_hdr_to_ldr_scale(1.0f);
+//
+// (note, do not use _inverse_ constants; stbi_image will invert them
+// appropriately).
+//
+// Additionally, there is a new, parallel interface for loading files as
+// (linear) floats to preserve the full dynamic range:
+//
+//    float *data = stbi_loadf(filename, &x, &y, &n, 0);
+//
+// If you load LDR images through this interface, those images will
+// be promoted to floating point values, run through the inverse of
+// constants corresponding to the above:
+//
+//     stbi_ldr_to_hdr_scale(1.0f);
+//     stbi_ldr_to_hdr_gamma(2.2f);
+//
+// Finally, given a filename (or an open file or memory block--see header
+// file for details) containing image data, you can query for the "most
+// appropriate" interface to use (that is, whether the image is HDR or
+// not), using:
+//
+//     stbi_is_hdr(char *filename);
+//
+// ===========================================================================
+//
+// iPhone PNG support:
+//
+// By default we convert iphone-formatted PNGs back to RGB, even though
+// they are internally encoded differently. You can disable this conversion
+// by calling stbi_convert_iphone_png_to_rgb(0), in which case
+// you will always just get the native iphone "format" through (which
+// is BGR stored in RGB).
+//
+// Call stbi_set_unpremultiply_on_load(1) as well to force a divide per
+// pixel to remove any premultiplied alpha *only* if the image file explicitly
+// says there's premultiplied data (currently only happens in iPhone images,
+// and only if iPhone convert-to-rgb processing is on).
+//
+// ===========================================================================
+//
+// ADDITIONAL CONFIGURATION
+//
+//  - You can suppress implementation of any of the decoders to reduce
+//    your code footprint by #defining one or more of the following
+//    symbols before creating the implementation.
+//
+//        STBI_NO_JPEG
+//        STBI_NO_PNG
+//        STBI_NO_BMP
+//        STBI_NO_PSD
+//        STBI_NO_TGA
+//        STBI_NO_GIF
+//        STBI_NO_HDR
+//        STBI_NO_PIC
+//        STBI_NO_PNM   (.ppm and .pgm)
+//
+//  - You can request *only* certain decoders and suppress all other ones
+//    (this will be more forward-compatible, as addition of new decoders
+//    doesn't require you to disable them explicitly):
+//
+//        STBI_ONLY_JPEG
+//        STBI_ONLY_PNG
+//        STBI_ONLY_BMP
+//        STBI_ONLY_PSD
+//        STBI_ONLY_TGA
+//        STBI_ONLY_GIF
+//        STBI_ONLY_HDR
+//        STBI_ONLY_PIC
+//        STBI_ONLY_PNM   (.ppm and .pgm)
+//
+//   - If you use STBI_NO_PNG (or _ONLY_ without PNG), and you still
+//     want the zlib decoder to be available, #define STBI_SUPPORT_ZLIB
+//
+
+
+#ifndef STBI_NO_STDIO
+#include <stdio.h>
+#endif // STBI_NO_STDIO
+
+#define STBI_VERSION 1
+
+enum
+{
+   STBI_default = 0, // only used for desired_channels
+
+   STBI_grey       = 1,
+   STBI_grey_alpha = 2,
+   STBI_rgb        = 3,
+   STBI_rgb_alpha  = 4
+};
+
+#include <stdlib.h>
+typedef unsigned char stbi_uc;
+typedef unsigned short stbi_us;
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#ifndef STBIDEF
+#ifdef STB_IMAGE_STATIC
+#define STBIDEF static
+#else
+#define STBIDEF extern
+#endif
+#endif
+
+//////////////////////////////////////////////////////////////////////////////
+//
+// PRIMARY API - works on images of any type
+//
+
+//
+// load image by filename, open file, or memory buffer
+//
+
+typedef struct
+{
+   int      (*read)  (void *user,char *data,int size);   // fill 'data' with 'size' bytes.  return number of bytes actually read
+   void     (*skip)  (void *user,int n);                 // skip the next 'n' bytes, or 'unget' the last -n bytes if negative
+   int      (*eof)   (void *user);                       // returns nonzero if we are at end of file/data
+} stbi_io_callbacks;
+
+////////////////////////////////////
+//
+// 8-bits-per-channel interface
+//
+
+STBIDEF stbi_uc *stbi_load_from_memory   (stbi_uc           const *buffer, int len   , int *x, int *y, int *channels_in_file, int desired_channels);
+STBIDEF stbi_uc *stbi_load_from_callbacks(stbi_io_callbacks const *clbk  , void *user, int *x, int *y, int *channels_in_file, int desired_channels);
+
+#ifndef STBI_NO_STDIO
+STBIDEF stbi_uc *stbi_load            (char const *filename, int *x, int *y, int *channels_in_file, int desired_channels);
+STBIDEF stbi_uc *stbi_load_from_file  (FILE *f, int *x, int *y, int *channels_in_file, int desired_channels);
+// for stbi_load_from_file, file pointer is left pointing immediately after image
+#endif
+
+#ifndef STBI_NO_GIF
+STBIDEF stbi_uc *stbi_load_gif_from_memory(stbi_uc const *buffer, int len, int **delays, int *x, int *y, int *z, int *comp, int req_comp);
+#endif
+
+#ifdef STBI_WINDOWS_UTF8
+STBIDEF int stbi_convert_wchar_to_utf8(char *buffer, size_t bufferlen, const wchar_t* input);
+#endif
+
+////////////////////////////////////
+//
+// 16-bits-per-channel interface
+//
+
+STBIDEF stbi_us *stbi_load_16_from_memory   (stbi_uc const *buffer, int len, int *x, int *y, int *channels_in_file, int desired_channels);
+STBIDEF stbi_us *stbi_load_16_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *channels_in_file, int desired_channels);
+
+#ifndef STBI_NO_STDIO
+STBIDEF stbi_us *stbi_load_16          (char const *filename, int *x, int *y, int *channels_in_file, int desired_channels);
+STBIDEF stbi_us *stbi_load_from_file_16(FILE *f, int *x, int *y, int *channels_in_file, int desired_channels);
+#endif
+
+////////////////////////////////////
+//
+// float-per-channel interface
+//
+#ifndef STBI_NO_LINEAR
+   STBIDEF float *stbi_loadf_from_memory     (stbi_uc const *buffer, int len, int *x, int *y, int *channels_in_file, int desired_channels);
+   STBIDEF float *stbi_loadf_from_callbacks  (stbi_io_callbacks const *clbk, void *user, int *x, int *y,  int *channels_in_file, int desired_channels);
+
+   #ifndef STBI_NO_STDIO
+   STBIDEF float *stbi_loadf            (char const *filename, int *x, int *y, int *channels_in_file, int desired_channels);
+   STBIDEF float *stbi_loadf_from_file  (FILE *f, int *x, int *y, int *channels_in_file, int desired_channels);
+   #endif
+#endif
+
+#ifndef STBI_NO_HDR
+   STBIDEF void   stbi_hdr_to_ldr_gamma(float gamma);
+   STBIDEF void   stbi_hdr_to_ldr_scale(float scale);
+#endif // STBI_NO_HDR
+
+#ifndef STBI_NO_LINEAR
+   STBIDEF void   stbi_ldr_to_hdr_gamma(float gamma);
+   STBIDEF void   stbi_ldr_to_hdr_scale(float scale);
+#endif // STBI_NO_LINEAR
+
+// stbi_is_hdr is always defined, but always returns false if STBI_NO_HDR
+STBIDEF int    stbi_is_hdr_from_callbacks(stbi_io_callbacks const *clbk, void *user);
+STBIDEF int    stbi_is_hdr_from_memory(stbi_uc const *buffer, int len);
+#ifndef STBI_NO_STDIO
+STBIDEF int      stbi_is_hdr          (char const *filename);
+STBIDEF int      stbi_is_hdr_from_file(FILE *f);
+#endif // STBI_NO_STDIO
+
+
+// get a VERY brief reason for failure
+// NOT THREADSAFE
+STBIDEF const char *stbi_failure_reason  (void);
+
+// free the loaded image -- this is just free()
+STBIDEF void     stbi_image_free      (void *retval_from_stbi_load);
+
+// get image dimensions & components without fully decoding
+STBIDEF int      stbi_info_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp);
+STBIDEF int      stbi_info_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *comp);
+STBIDEF int      stbi_is_16_bit_from_memory(stbi_uc const *buffer, int len);
+STBIDEF int      stbi_is_16_bit_from_callbacks(stbi_io_callbacks const *clbk, void *user);
+
+#ifndef STBI_NO_STDIO
+STBIDEF int      stbi_info               (char const *filename,     int *x, int *y, int *comp);
+STBIDEF int      stbi_info_from_file     (FILE *f,                  int *x, int *y, int *comp);
+STBIDEF int      stbi_is_16_bit          (char const *filename);
+STBIDEF int      stbi_is_16_bit_from_file(FILE *f);
+#endif
+
+
+
+// for image formats that explicitly notate that they have premultiplied alpha,
+// we just return the colors as stored in the file. set this flag to force
+// unpremultiplication. results are undefined if the unpremultiply overflow.
+STBIDEF void stbi_set_unpremultiply_on_load(int flag_true_if_should_unpremultiply);
+
+// indicate whether we should process iphone images back to canonical format,
+// or just pass them through "as-is"
+STBIDEF void stbi_convert_iphone_png_to_rgb(int flag_true_if_should_convert);
+
+// flip the image vertically, so the first pixel in the output array is the bottom left
+STBIDEF void stbi_set_flip_vertically_on_load(int flag_true_if_should_flip);
+
+// ZLIB client - used by PNG, available for other purposes
+
+STBIDEF char *stbi_zlib_decode_malloc_guesssize(const char *buffer, int len, int initial_size, int *outlen);
+STBIDEF char *stbi_zlib_decode_malloc_guesssize_headerflag(const char *buffer, int len, int initial_size, int *outlen, int parse_header);
+STBIDEF char *stbi_zlib_decode_malloc(const char *buffer, int len, int *outlen);
+STBIDEF int   stbi_zlib_decode_buffer(char *obuffer, int olen, const char *ibuffer, int ilen);
+
+STBIDEF char *stbi_zlib_decode_noheader_malloc(const char *buffer, int len, int *outlen);
+STBIDEF int   stbi_zlib_decode_noheader_buffer(char *obuffer, int olen, const char *ibuffer, int ilen);
+
+
+#ifdef __cplusplus
+}
+#endif
+
+//
+//
+////   end header file   /////////////////////////////////////////////////////
+#endif // STBI_INCLUDE_STB_IMAGE_H
+
+#ifdef STB_IMAGE_IMPLEMENTATION
+
+#if defined(STBI_ONLY_JPEG) || defined(STBI_ONLY_PNG) || defined(STBI_ONLY_BMP) \
+  || defined(STBI_ONLY_TGA) || defined(STBI_ONLY_GIF) || defined(STBI_ONLY_PSD) \
+  || defined(STBI_ONLY_HDR) || defined(STBI_ONLY_PIC) || defined(STBI_ONLY_PNM) \
+  || defined(STBI_ONLY_ZLIB)
+   #ifndef STBI_ONLY_JPEG
+   #define STBI_NO_JPEG
+   #endif
+   #ifndef STBI_ONLY_PNG
+   #define STBI_NO_PNG
+   #endif
+   #ifndef STBI_ONLY_BMP
+   #define STBI_NO_BMP
+   #endif
+   #ifndef STBI_ONLY_PSD
+   #define STBI_NO_PSD
+   #endif
+   #ifndef STBI_ONLY_TGA
+   #define STBI_NO_TGA
+   #endif
+   #ifndef STBI_ONLY_GIF
+   #define STBI_NO_GIF
+   #endif
+   #ifndef STBI_ONLY_HDR
+   #define STBI_NO_HDR
+   #endif
+   #ifndef STBI_ONLY_PIC
+   #define STBI_NO_PIC
+   #endif
+   #ifndef STBI_ONLY_PNM
+   #define STBI_NO_PNM
+   #endif
+#endif
+
+#if defined(STBI_NO_PNG) && !defined(STBI_SUPPORT_ZLIB) && !defined(STBI_NO_ZLIB)
+#define STBI_NO_ZLIB
+#endif
+
+
+#include <stdarg.h>
+#include <stddef.h> // ptrdiff_t on osx
+#include <stdlib.h>
+#include <string.h>
+#include <limits.h>
+
+#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR)
+#include <math.h>  // ldexp, pow
+#endif
+
+#ifndef STBI_NO_STDIO
+#include <stdio.h>
+#endif
+
+#ifndef STBI_ASSERT
+#include <assert.h>
+#define STBI_ASSERT(x) assert(x)
+#endif
+
+#ifdef __cplusplus
+#define STBI_EXTERN extern "C"
+#else
+#define STBI_EXTERN extern
+#endif
+
+
+#ifndef _MSC_VER
+   #ifdef __cplusplus
+   #define stbi_inline inline
+   #else
+   #define stbi_inline
+   #endif
+#else
+   #define stbi_inline __forceinline
+#endif
+
+
+#ifdef _MSC_VER
+typedef unsigned short stbi__uint16;
+typedef   signed short stbi__int16;
+typedef unsigned int   stbi__uint32;
+typedef   signed int   stbi__int32;
+#else
+#include <stdint.h>
+typedef uint16_t stbi__uint16;
+typedef int16_t  stbi__int16;
+typedef uint32_t stbi__uint32;
+typedef int32_t  stbi__int32;
+#endif
+
+// should produce compiler error if size is wrong
+typedef unsigned char validate_uint32[sizeof(stbi__uint32)==4 ? 1 : -1];
+
+#ifdef _MSC_VER
+#define STBI_NOTUSED(v)  (void)(v)
+#else
+#define STBI_NOTUSED(v)  (void)sizeof(v)
+#endif
+
+#ifdef _MSC_VER
+#define STBI_HAS_LROTL
+#endif
+
+#ifdef STBI_HAS_LROTL
+   #define stbi_lrot(x,y)  _lrotl(x,y)
+#else
+   #define stbi_lrot(x,y)  (((x) << (y)) | ((x) >> (32 - (y))))
+#endif
+
+#if defined(STBI_MALLOC) && defined(STBI_FREE) && (defined(STBI_REALLOC) || defined(STBI_REALLOC_SIZED))
+// ok
+#elif !defined(STBI_MALLOC) && !defined(STBI_FREE) && !defined(STBI_REALLOC) && !defined(STBI_REALLOC_SIZED)
+// ok
+#else
+#error "Must define all or none of STBI_MALLOC, STBI_FREE, and STBI_REALLOC (or STBI_REALLOC_SIZED)."
+#endif
+
+#ifndef STBI_MALLOC
+#define STBI_MALLOC(sz)           malloc(sz)
+#define STBI_REALLOC(p,newsz)     realloc(p,newsz)
+#define STBI_FREE(p)              free(p)
+#endif
+
+#ifndef STBI_REALLOC_SIZED
+#define STBI_REALLOC_SIZED(p,oldsz,newsz) STBI_REALLOC(p,newsz)
+#endif
+
+// x86/x64 detection
+#if defined(__x86_64__) || defined(_M_X64)
+#define STBI__X64_TARGET
+#elif defined(__i386) || defined(_M_IX86)
+#define STBI__X86_TARGET
+#endif
+
+#if defined(__GNUC__) && defined(STBI__X86_TARGET) && !defined(__SSE2__) && !defined(STBI_NO_SIMD)
+// gcc doesn't support sse2 intrinsics unless you compile with -msse2,
+// which in turn means it gets to use SSE2 everywhere. This is unfortunate,
+// but previous attempts to provide the SSE2 functions with runtime
+// detection caused numerous issues. The way architecture extensions are
+// exposed in GCC/Clang is, sadly, not really suited for one-file libs.
+// New behavior: if compiled with -msse2, we use SSE2 without any
+// detection; if not, we don't use it at all.
+#define STBI_NO_SIMD
+#endif
+
+#if defined(__MINGW32__) && defined(STBI__X86_TARGET) && !defined(STBI_MINGW_ENABLE_SSE2) && !defined(STBI_NO_SIMD)
+// Note that __MINGW32__ doesn't actually mean 32-bit, so we have to avoid STBI__X64_TARGET
+//
+// 32-bit MinGW wants ESP to be 16-byte aligned, but this is not in the
+// Windows ABI and VC++ as well as Windows DLLs don't maintain that invariant.
+// As a result, enabling SSE2 on 32-bit MinGW is dangerous when not
+// simultaneously enabling "-mstackrealign".
+//
+// See https://github.com/nothings/stb/issues/81 for more information.
+//
+// So default to no SSE2 on 32-bit MinGW. If you've read this far and added
+// -mstackrealign to your build settings, feel free to #define STBI_MINGW_ENABLE_SSE2.
+#define STBI_NO_SIMD
+#endif
+
+#if !defined(STBI_NO_SIMD) && (defined(STBI__X86_TARGET) || defined(STBI__X64_TARGET))
+#define STBI_SSE2
+#include <emmintrin.h>
+
+#ifdef _MSC_VER
+
+#if _MSC_VER >= 1400  // not VC6
+#include <intrin.h> // __cpuid
+static int stbi__cpuid3(void)
+{
+   int info[4];
+   __cpuid(info,1);
+   return info[3];
+}
+#else
+static int stbi__cpuid3(void)
+{
+   int res;
+   __asm {
+      mov  eax,1
+      cpuid
+      mov  res,edx
+   }
+   return res;
+}
+#endif
+
+#define STBI_SIMD_ALIGN(type, name) __declspec(align(16)) type name
+
+#if !defined(STBI_NO_JPEG) && defined(STBI_SSE2)
+static int stbi__sse2_available(void)
+{
+   int info3 = stbi__cpuid3();
+   return ((info3 >> 26) & 1) != 0;
+}
+#endif
+
+#else // assume GCC-style if not VC++
+#define STBI_SIMD_ALIGN(type, name) type name __attribute__((aligned(16)))
+
+#if !defined(STBI_NO_JPEG) && defined(STBI_SSE2)
+static int stbi__sse2_available(void)
+{
+   // If we're even attempting to compile this on GCC/Clang, that means
+   // -msse2 is on, which means the compiler is allowed to use SSE2
+   // instructions at will, and so are we.
+   return 1;
+}
+#endif
+
+#endif
+#endif
+
+// ARM NEON
+#if defined(STBI_NO_SIMD) && defined(STBI_NEON)
+#undef STBI_NEON
+#endif
+
+#ifdef STBI_NEON
+#include <arm_neon.h>
+// assume GCC or Clang on ARM targets
+#define STBI_SIMD_ALIGN(type, name) type name __attribute__((aligned(16)))
+#endif
+
+#ifndef STBI_SIMD_ALIGN
+#define STBI_SIMD_ALIGN(type, name) type name
+#endif
+
+///////////////////////////////////////////////
+//
+//  stbi__context struct and start_xxx functions
+
+// stbi__context structure is our basic context used by all images, so it
+// contains all the IO context, plus some basic image information
+typedef struct
+{
+   stbi__uint32 img_x, img_y;
+   int img_n, img_out_n;
+
+   stbi_io_callbacks io;
+   void *io_user_data;
+
+   int read_from_callbacks;
+   int buflen;
+   stbi_uc buffer_start[128];
+
+   stbi_uc *img_buffer, *img_buffer_end;
+   stbi_uc *img_buffer_original, *img_buffer_original_end;
+} stbi__context;
+
+
+static void stbi__refill_buffer(stbi__context *s);
+
+// initialize a memory-decode context
+static void stbi__start_mem(stbi__context *s, stbi_uc const *buffer, int len)
+{
+   s->io.read = NULL;
+   s->read_from_callbacks = 0;
+   s->img_buffer = s->img_buffer_original = (stbi_uc *) buffer;
+   s->img_buffer_end = s->img_buffer_original_end = (stbi_uc *) buffer+len;
+}
+
+// initialize a callback-based context
+static void stbi__start_callbacks(stbi__context *s, stbi_io_callbacks *c, void *user)
+{
+   s->io = *c;
+   s->io_user_data = user;
+   s->buflen = sizeof(s->buffer_start);
+   s->read_from_callbacks = 1;
+   s->img_buffer_original = s->buffer_start;
+   stbi__refill_buffer(s);
+   s->img_buffer_original_end = s->img_buffer_end;
+}
+
+#ifndef STBI_NO_STDIO
+
+static int stbi__stdio_read(void *user, char *data, int size)
+{
+   return (int) fread(data,1,size,(FILE*) user);
+}
+
+static void stbi__stdio_skip(void *user, int n)
+{
+   fseek((FILE*) user, n, SEEK_CUR);
+}
+
+static int stbi__stdio_eof(void *user)
+{
+   return feof((FILE*) user);
+}
+
+static stbi_io_callbacks stbi__stdio_callbacks =
+{
+   stbi__stdio_read,
+   stbi__stdio_skip,
+   stbi__stdio_eof,
+};
+
+static void stbi__start_file(stbi__context *s, FILE *f)
+{
+   stbi__start_callbacks(s, &stbi__stdio_callbacks, (void *) f);
+}
+
+//static void stop_file(stbi__context *s) { }
+
+#endif // !STBI_NO_STDIO
+
+static void stbi__rewind(stbi__context *s)
+{
+   // conceptually rewind SHOULD rewind to the beginning of the stream,
+   // but we just rewind to the beginning of the initial buffer, because
+   // we only use it after doing 'test', which only ever looks at at most 92 bytes
+   s->img_buffer = s->img_buffer_original;
+   s->img_buffer_end = s->img_buffer_original_end;
+}
+
+enum
+{
+   STBI_ORDER_RGB,
+   STBI_ORDER_BGR
+};
+
+typedef struct
+{
+   int bits_per_channel;
+   int num_channels;
+   int channel_order;
+} stbi__result_info;
+
+#ifndef STBI_NO_JPEG
+static int      stbi__jpeg_test(stbi__context *s);
+static void    *stbi__jpeg_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri);
+static int      stbi__jpeg_info(stbi__context *s, int *x, int *y, int *comp);
+#endif
+
+#ifndef STBI_NO_PNG
+static int      stbi__png_test(stbi__context *s);
+static void    *stbi__png_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri);
+static int      stbi__png_info(stbi__context *s, int *x, int *y, int *comp);
+static int      stbi__png_is16(stbi__context *s);
+#endif
+
+#ifndef STBI_NO_BMP
+static int      stbi__bmp_test(stbi__context *s);
+static void    *stbi__bmp_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri);
+static int      stbi__bmp_info(stbi__context *s, int *x, int *y, int *comp);
+#endif
+
+#ifndef STBI_NO_TGA
+static int      stbi__tga_test(stbi__context *s);
+static void    *stbi__tga_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri);
+static int      stbi__tga_info(stbi__context *s, int *x, int *y, int *comp);
+#endif
+
+#ifndef STBI_NO_PSD
+static int      stbi__psd_test(stbi__context *s);
+static void    *stbi__psd_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri, int bpc);
+static int      stbi__psd_info(stbi__context *s, int *x, int *y, int *comp);
+static int      stbi__psd_is16(stbi__context *s);
+#endif
+
+#ifndef STBI_NO_HDR
+static int      stbi__hdr_test(stbi__context *s);
+static float   *stbi__hdr_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri);
+static int      stbi__hdr_info(stbi__context *s, int *x, int *y, int *comp);
+#endif
+
+#ifndef STBI_NO_PIC
+static int      stbi__pic_test(stbi__context *s);
+static void    *stbi__pic_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri);
+static int      stbi__pic_info(stbi__context *s, int *x, int *y, int *comp);
+#endif
+
+#ifndef STBI_NO_GIF
+static int      stbi__gif_test(stbi__context *s);
+static void    *stbi__gif_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri);
+static void    *stbi__load_gif_main(stbi__context *s, int **delays, int *x, int *y, int *z, int *comp, int req_comp);
+static int      stbi__gif_info(stbi__context *s, int *x, int *y, int *comp);
+#endif
+
+#ifndef STBI_NO_PNM
+static int      stbi__pnm_test(stbi__context *s);
+static void    *stbi__pnm_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri);
+static int      stbi__pnm_info(stbi__context *s, int *x, int *y, int *comp);
+#endif
+
+// this is not threadsafe
+static const char *stbi__g_failure_reason;
+
+STBIDEF const char *stbi_failure_reason(void)
+{
+   return stbi__g_failure_reason;
+}
+
+static int stbi__err(const char *str)
+{
+   stbi__g_failure_reason = str;
+   return 0;
+}
+
+static void *stbi__malloc(size_t size)
+{
+    return STBI_MALLOC(size);
+}
+
+// stb_image uses ints pervasively, including for offset calculations.
+// therefore the largest decoded image size we can support with the
+// current code, even on 64-bit targets, is INT_MAX. this is not a
+// significant limitation for the intended use case.
+//
+// we do, however, need to make sure our size calculations don't
+// overflow. hence a few helper functions for size calculations that
+// multiply integers together, making sure that they're non-negative
+// and no overflow occurs.
+
+// return 1 if the sum is valid, 0 on overflow.
+// negative terms are considered invalid.
+static int stbi__addsizes_valid(int a, int b)
+{
+   if (b < 0) return 0;
+   // now 0 <= b <= INT_MAX, hence also
+   // 0 <= INT_MAX - b <= INTMAX.
+   // And "a + b <= INT_MAX" (which might overflow) is the
+   // same as a <= INT_MAX - b (no overflow)
+   return a <= INT_MAX - b;
+}
+
+// returns 1 if the product is valid, 0 on overflow.
+// negative factors are considered invalid.
+static int stbi__mul2sizes_valid(int a, int b)
+{
+   if (a < 0 || b < 0) return 0;
+   if (b == 0) return 1; // mul-by-0 is always safe
+   // portable way to check for no overflows in a*b
+   return a <= INT_MAX/b;
+}
+
+// returns 1 if "a*b + add" has no negative terms/factors and doesn't overflow
+static int stbi__mad2sizes_valid(int a, int b, int add)
+{
+   return stbi__mul2sizes_valid(a, b) && stbi__addsizes_valid(a*b, add);
+}
+
+// returns 1 if "a*b*c + add" has no negative terms/factors and doesn't overflow
+static int stbi__mad3sizes_valid(int a, int b, int c, int add)
+{
+   return stbi__mul2sizes_valid(a, b) && stbi__mul2sizes_valid(a*b, c) &&
+      stbi__addsizes_valid(a*b*c, add);
+}
+
+// returns 1 if "a*b*c*d + add" has no negative terms/factors and doesn't overflow
+#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR)
+static int stbi__mad4sizes_valid(int a, int b, int c, int d, int add)
+{
+   return stbi__mul2sizes_valid(a, b) && stbi__mul2sizes_valid(a*b, c) &&
+      stbi__mul2sizes_valid(a*b*c, d) && stbi__addsizes_valid(a*b*c*d, add);
+}
+#endif
+
+// mallocs with size overflow checking
+static void *stbi__malloc_mad2(int a, int b, int add)
+{
+   if (!stbi__mad2sizes_valid(a, b, add)) return NULL;
+   return stbi__malloc(a*b + add);
+}
+
+static void *stbi__malloc_mad3(int a, int b, int c, int add)
+{
+   if (!stbi__mad3sizes_valid(a, b, c, add)) return NULL;
+   return stbi__malloc(a*b*c + add);
+}
+
+#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR)
+static void *stbi__malloc_mad4(int a, int b, int c, int d, int add)
+{
+   if (!stbi__mad4sizes_valid(a, b, c, d, add)) return NULL;
+   return stbi__malloc(a*b*c*d + add);
+}
+#endif
+
+// stbi__err - error
+// stbi__errpf - error returning pointer to float
+// stbi__errpuc - error returning pointer to unsigned char
+
+#ifdef STBI_NO_FAILURE_STRINGS
+   #define stbi__err(x,y)  0
+#elif defined(STBI_FAILURE_USERMSG)
+   #define stbi__err(x,y)  stbi__err(y)
+#else
+   #define stbi__err(x,y)  stbi__err(x)
+#endif
+
+#define stbi__errpf(x,y)   ((float *)(size_t) (stbi__err(x,y)?NULL:NULL))
+#define stbi__errpuc(x,y)  ((unsigned char *)(size_t) (stbi__err(x,y)?NULL:NULL))
+
+STBIDEF void stbi_image_free(void *retval_from_stbi_load)
+{
+   STBI_FREE(retval_from_stbi_load);
+}
+
+#ifndef STBI_NO_LINEAR
+static float   *stbi__ldr_to_hdr(stbi_uc *data, int x, int y, int comp);
+#endif
+
+#ifndef STBI_NO_HDR
+static stbi_uc *stbi__hdr_to_ldr(float   *data, int x, int y, int comp);
+#endif
+
+static int stbi__vertically_flip_on_load = 0;
+
+STBIDEF void stbi_set_flip_vertically_on_load(int flag_true_if_should_flip)
+{
+    stbi__vertically_flip_on_load = flag_true_if_should_flip;
+}
+
+static void *stbi__load_main(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri, int bpc)
+{
+   memset(ri, 0, sizeof(*ri)); // make sure it's initialized if we add new fields
+   ri->bits_per_channel = 8; // default is 8 so most paths don't have to be changed
+   ri->channel_order = STBI_ORDER_RGB; // all current input & output are this, but this is here so we can add BGR order
+   ri->num_channels = 0;
+
+   #ifndef STBI_NO_JPEG
+   if (stbi__jpeg_test(s)) return stbi__jpeg_load(s,x,y,comp,req_comp, ri);
+   #endif
+   #ifndef STBI_NO_PNG
+   if (stbi__png_test(s))  return stbi__png_load(s,x,y,comp,req_comp, ri);
+   #endif
+   #ifndef STBI_NO_BMP
+   if (stbi__bmp_test(s))  return stbi__bmp_load(s,x,y,comp,req_comp, ri);
+   #endif
+   #ifndef STBI_NO_GIF
+   if (stbi__gif_test(s))  return stbi__gif_load(s,x,y,comp,req_comp, ri);
+   #endif
+   #ifndef STBI_NO_PSD
+   if (stbi__psd_test(s))  return stbi__psd_load(s,x,y,comp,req_comp, ri, bpc);
+   #endif
+   #ifndef STBI_NO_PIC
+   if (stbi__pic_test(s))  return stbi__pic_load(s,x,y,comp,req_comp, ri);
+   #endif
+   #ifndef STBI_NO_PNM
+   if (stbi__pnm_test(s))  return stbi__pnm_load(s,x,y,comp,req_comp, ri);
+   #endif
+
+   #ifndef STBI_NO_HDR
+   if (stbi__hdr_test(s)) {
+      float *hdr = stbi__hdr_load(s, x,y,comp,req_comp, ri);
+      return stbi__hdr_to_ldr(hdr, *x, *y, req_comp ? req_comp : *comp);
+   }
+   #endif
+
+   #ifndef STBI_NO_TGA
+   // test tga last because it's a crappy test!
+   if (stbi__tga_test(s))
+      return stbi__tga_load(s,x,y,comp,req_comp, ri);
+   #endif
+
+   return stbi__errpuc("unknown image type", "Image not of any known type, or corrupt");
+}
+
+static stbi_uc *stbi__convert_16_to_8(stbi__uint16 *orig, int w, int h, int channels)
+{
+   int i;
+   int img_len = w * h * channels;
+   stbi_uc *reduced;
+
+   reduced = (stbi_uc *) stbi__malloc(img_len);
+   if (reduced == NULL) return stbi__errpuc("outofmem", "Out of memory");
+
+   for (i = 0; i < img_len; ++i)
+      reduced[i] = (stbi_uc)((orig[i] >> 8) & 0xFF); // top half of each byte is sufficient approx of 16->8 bit scaling
+
+   STBI_FREE(orig);
+   return reduced;
+}
+
+static stbi__uint16 *stbi__convert_8_to_16(stbi_uc *orig, int w, int h, int channels)
+{
+   int i;
+   int img_len = w * h * channels;
+   stbi__uint16 *enlarged;
+
+   enlarged = (stbi__uint16 *) stbi__malloc(img_len*2);
+   if (enlarged == NULL) return (stbi__uint16 *) stbi__errpuc("outofmem", "Out of memory");
+
+   for (i = 0; i < img_len; ++i)
+      enlarged[i] = (stbi__uint16)((orig[i] << 8) + orig[i]); // replicate to high and low byte, maps 0->0, 255->0xffff
+
+   STBI_FREE(orig);
+   return enlarged;
+}
+
+static void stbi__vertical_flip(void *image, int w, int h, int bytes_per_pixel)
+{
+   int row;
+   size_t bytes_per_row = (size_t)w * bytes_per_pixel;
+   stbi_uc temp[2048];
+   stbi_uc *bytes = (stbi_uc *)image;
+
+   for (row = 0; row < (h>>1); row++) {
+      stbi_uc *row0 = bytes + row*bytes_per_row;
+      stbi_uc *row1 = bytes + (h - row - 1)*bytes_per_row;
+      // swap row0 with row1
+      size_t bytes_left = bytes_per_row;
+      while (bytes_left) {
+         size_t bytes_copy = (bytes_left < sizeof(temp)) ? bytes_left : sizeof(temp);
+         memcpy(temp, row0, bytes_copy);
+         memcpy(row0, row1, bytes_copy);
+         memcpy(row1, temp, bytes_copy);
+         row0 += bytes_copy;
+         row1 += bytes_copy;
+         bytes_left -= bytes_copy;
+      }
+   }
+}
+
+#ifndef STBI_NO_GIF
+static void stbi__vertical_flip_slices(void *image, int w, int h, int z, int bytes_per_pixel)
+{
+   int slice;
+   int slice_size = w * h * bytes_per_pixel;
+
+   stbi_uc *bytes = (stbi_uc *)image;
+   for (slice = 0; slice < z; ++slice) {
+      stbi__vertical_flip(bytes, w, h, bytes_per_pixel); 
+      bytes += slice_size; 
+   }
+}
+#endif
+
+static unsigned char *stbi__load_and_postprocess_8bit(stbi__context *s, int *x, int *y, int *comp, int req_comp)
+{
+   stbi__result_info ri;
+   void *result = stbi__load_main(s, x, y, comp, req_comp, &ri, 8);
+
+   if (result == NULL)
+      return NULL;
+
+   if (ri.bits_per_channel != 8) {
+      STBI_ASSERT(ri.bits_per_channel == 16);
+      result = stbi__convert_16_to_8((stbi__uint16 *) result, *x, *y, req_comp == 0 ? *comp : req_comp);
+      ri.bits_per_channel = 8;
+   }
+
+   // @TODO: move stbi__convert_format to here
+
+   if (stbi__vertically_flip_on_load) {
+      int channels = req_comp ? req_comp : *comp;
+      stbi__vertical_flip(result, *x, *y, channels * sizeof(stbi_uc));
+   }
+
+   return (unsigned char *) result;
+}
+
+static stbi__uint16 *stbi__load_and_postprocess_16bit(stbi__context *s, int *x, int *y, int *comp, int req_comp)
+{
+   stbi__result_info ri;
+   void *result = stbi__load_main(s, x, y, comp, req_comp, &ri, 16);
+
+   if (result == NULL)
+      return NULL;
+
+   if (ri.bits_per_channel != 16) {
+      STBI_ASSERT(ri.bits_per_channel == 8);
+      result = stbi__convert_8_to_16((stbi_uc *) result, *x, *y, req_comp == 0 ? *comp : req_comp);
+      ri.bits_per_channel = 16;
+   }
+
+   // @TODO: move stbi__convert_format16 to here
+   // @TODO: special case RGB-to-Y (and RGBA-to-YA) for 8-bit-to-16-bit case to keep more precision
+
+   if (stbi__vertically_flip_on_load) {
+      int channels = req_comp ? req_comp : *comp;
+      stbi__vertical_flip(result, *x, *y, channels * sizeof(stbi__uint16));
+   }
+
+   return (stbi__uint16 *) result;
+}
+
+#if !defined(STBI_NO_HDR) && !defined(STBI_NO_LINEAR)
+static void stbi__float_postprocess(float *result, int *x, int *y, int *comp, int req_comp)
+{
+   if (stbi__vertically_flip_on_load && result != NULL) {
+      int channels = req_comp ? req_comp : *comp;
+      stbi__vertical_flip(result, *x, *y, channels * sizeof(float));
+   }
+}
+#endif
+
+#ifndef STBI_NO_STDIO
+
+#if defined(_MSC_VER) && defined(STBI_WINDOWS_UTF8)
+STBI_EXTERN __declspec(dllimport) int __stdcall MultiByteToWideChar(unsigned int cp, unsigned long flags, const char *str, int cbmb, wchar_t *widestr, int cchwide);
+STBI_EXTERN __declspec(dllimport) int __stdcall WideCharToMultiByte(unsigned int cp, unsigned long flags, const wchar_t *widestr, int cchwide, char *str, int cbmb, const char *defchar, int *used_default);
+#endif
+
+#if defined(_MSC_VER) && defined(STBI_WINDOWS_UTF8)
+STBIDEF int stbi_convert_wchar_to_utf8(char *buffer, size_t bufferlen, const wchar_t* input)
+{
+	return WideCharToMultiByte(65001 /* UTF8 */, 0, input, -1, buffer, (int) bufferlen, NULL, NULL);
+}
+#endif
+
+static FILE *stbi__fopen(char const *filename, char const *mode)
+{
+   FILE *f;
+#if defined(_MSC_VER) && defined(STBI_WINDOWS_UTF8)
+   wchar_t wMode[64];
+   wchar_t wFilename[1024];
+	if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, filename, -1, wFilename, sizeof(wFilename)))
+      return 0;
+	
+	if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, mode, -1, wMode, sizeof(wMode)))
+      return 0;
+
+#if _MSC_VER >= 1400
+	if (0 != _wfopen_s(&f, wFilename, wMode))
+		f = 0;
+#else
+   f = _wfopen(wFilename, wMode);
+#endif
+
+#elif defined(_MSC_VER) && _MSC_VER >= 1400
+   if (0 != fopen_s(&f, filename, mode))
+      f=0;
+#else
+   f = fopen(filename, mode);
+#endif
+   return f;
+}
+
+
+STBIDEF stbi_uc *stbi_load(char const *filename, int *x, int *y, int *comp, int req_comp)
+{
+   FILE *f = stbi__fopen(filename, "rb");
+   unsigned char *result;
+   if (!f) return stbi__errpuc("can't fopen", "Unable to open file");
+   result = stbi_load_from_file(f,x,y,comp,req_comp);
+   fclose(f);
+   return result;
+}
+
+STBIDEF stbi_uc *stbi_load_from_file(FILE *f, int *x, int *y, int *comp, int req_comp)
+{
+   unsigned char *result;
+   stbi__context s;
+   stbi__start_file(&s,f);
+   result = stbi__load_and_postprocess_8bit(&s,x,y,comp,req_comp);
+   if (result) {
+      // need to 'unget' all the characters in the IO buffer
+      fseek(f, - (int) (s.img_buffer_end - s.img_buffer), SEEK_CUR);
+   }
+   return result;
+}
+
+STBIDEF stbi__uint16 *stbi_load_from_file_16(FILE *f, int *x, int *y, int *comp, int req_comp)
+{
+   stbi__uint16 *result;
+   stbi__context s;
+   stbi__start_file(&s,f);
+   result = stbi__load_and_postprocess_16bit(&s,x,y,comp,req_comp);
+   if (result) {
+      // need to 'unget' all the characters in the IO buffer
+      fseek(f, - (int) (s.img_buffer_end - s.img_buffer), SEEK_CUR);
+   }
+   return result;
+}
+
+STBIDEF stbi_us *stbi_load_16(char const *filename, int *x, int *y, int *comp, int req_comp)
+{
+   FILE *f = stbi__fopen(filename, "rb");
+   stbi__uint16 *result;
+   if (!f) return (stbi_us *) stbi__errpuc("can't fopen", "Unable to open file");
+   result = stbi_load_from_file_16(f,x,y,comp,req_comp);
+   fclose(f);
+   return result;
+}
+
+
+#endif //!STBI_NO_STDIO
+
+STBIDEF stbi_us *stbi_load_16_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *channels_in_file, int desired_channels)
+{
+   stbi__context s;
+   stbi__start_mem(&s,buffer,len);
+   return stbi__load_and_postprocess_16bit(&s,x,y,channels_in_file,desired_channels);
+}
+
+STBIDEF stbi_us *stbi_load_16_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *channels_in_file, int desired_channels)
+{
+   stbi__context s;
+   stbi__start_callbacks(&s, (stbi_io_callbacks *)clbk, user);
+   return stbi__load_and_postprocess_16bit(&s,x,y,channels_in_file,desired_channels);
+}
+
+STBIDEF stbi_uc *stbi_load_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp, int req_comp)
+{
+   stbi__context s;
+   stbi__start_mem(&s,buffer,len);
+   return stbi__load_and_postprocess_8bit(&s,x,y,comp,req_comp);
+}
+
+STBIDEF stbi_uc *stbi_load_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *comp, int req_comp)
+{
+   stbi__context s;
+   stbi__start_callbacks(&s, (stbi_io_callbacks *) clbk, user);
+   return stbi__load_and_postprocess_8bit(&s,x,y,comp,req_comp);
+}
+
+#ifndef STBI_NO_GIF
+STBIDEF stbi_uc *stbi_load_gif_from_memory(stbi_uc const *buffer, int len, int **delays, int *x, int *y, int *z, int *comp, int req_comp)
+{
+   unsigned char *result;
+   stbi__context s; 
+   stbi__start_mem(&s,buffer,len); 
+   
+   result = (unsigned char*) stbi__load_gif_main(&s, delays, x, y, z, comp, req_comp);
+   if (stbi__vertically_flip_on_load) {
+      stbi__vertical_flip_slices( result, *x, *y, *z, *comp ); 
+   }
+
+   return result; 
+}
+#endif
+
+#ifndef STBI_NO_LINEAR
+static float *stbi__loadf_main(stbi__context *s, int *x, int *y, int *comp, int req_comp)
+{
+   unsigned char *data;
+   #ifndef STBI_NO_HDR
+   if (stbi__hdr_test(s)) {
+      stbi__result_info ri;
+      float *hdr_data = stbi__hdr_load(s,x,y,comp,req_comp, &ri);
+      if (hdr_data)
+         stbi__float_postprocess(hdr_data,x,y,comp,req_comp);
+      return hdr_data;
+   }
+   #endif
+   data = stbi__load_and_postprocess_8bit(s, x, y, comp, req_comp);
+   if (data)
+      return stbi__ldr_to_hdr(data, *x, *y, req_comp ? req_comp : *comp);
+   return stbi__errpf("unknown image type", "Image not of any known type, or corrupt");
+}
+
+STBIDEF float *stbi_loadf_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp, int req_comp)
+{
+   stbi__context s;
+   stbi__start_mem(&s,buffer,len);
+   return stbi__loadf_main(&s,x,y,comp,req_comp);
+}
+
+STBIDEF float *stbi_loadf_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *comp, int req_comp)
+{
+   stbi__context s;
+   stbi__start_callbacks(&s, (stbi_io_callbacks *) clbk, user);
+   return stbi__loadf_main(&s,x,y,comp,req_comp);
+}
+
+#ifndef STBI_NO_STDIO
+STBIDEF float *stbi_loadf(char const *filename, int *x, int *y, int *comp, int req_comp)
+{
+   float *result;
+   FILE *f = stbi__fopen(filename, "rb");
+   if (!f) return stbi__errpf("can't fopen", "Unable to open file");
+   result = stbi_loadf_from_file(f,x,y,comp,req_comp);
+   fclose(f);
+   return result;
+}
+
+STBIDEF float *stbi_loadf_from_file(FILE *f, int *x, int *y, int *comp, int req_comp)
+{
+   stbi__context s;
+   stbi__start_file(&s,f);
+   return stbi__loadf_main(&s,x,y,comp,req_comp);
+}
+#endif // !STBI_NO_STDIO
+
+#endif // !STBI_NO_LINEAR
+
+// these is-hdr-or-not is defined independent of whether STBI_NO_LINEAR is
+// defined, for API simplicity; if STBI_NO_LINEAR is defined, it always
+// reports false!
+
+STBIDEF int stbi_is_hdr_from_memory(stbi_uc const *buffer, int len)
+{
+   #ifndef STBI_NO_HDR
+   stbi__context s;
+   stbi__start_mem(&s,buffer,len);
+   return stbi__hdr_test(&s);
+   #else
+   STBI_NOTUSED(buffer);
+   STBI_NOTUSED(len);
+   return 0;
+   #endif
+}
+
+#ifndef STBI_NO_STDIO
+STBIDEF int      stbi_is_hdr          (char const *filename)
+{
+   FILE *f = stbi__fopen(filename, "rb");
+   int result=0;
+   if (f) {
+      result = stbi_is_hdr_from_file(f);
+      fclose(f);
+   }
+   return result;
+}
+
+STBIDEF int stbi_is_hdr_from_file(FILE *f)
+{
+   #ifndef STBI_NO_HDR
+   long pos = ftell(f);
+   int res;
+   stbi__context s;
+   stbi__start_file(&s,f);
+   res = stbi__hdr_test(&s);
+   fseek(f, pos, SEEK_SET);
+   return res;
+   #else
+   STBI_NOTUSED(f);
+   return 0;
+   #endif
+}
+#endif // !STBI_NO_STDIO
+
+STBIDEF int      stbi_is_hdr_from_callbacks(stbi_io_callbacks const *clbk, void *user)
+{
+   #ifndef STBI_NO_HDR
+   stbi__context s;
+   stbi__start_callbacks(&s, (stbi_io_callbacks *) clbk, user);
+   return stbi__hdr_test(&s);
+   #else
+   STBI_NOTUSED(clbk);
+   STBI_NOTUSED(user);
+   return 0;
+   #endif
+}
+
+#ifndef STBI_NO_LINEAR
+static float stbi__l2h_gamma=2.2f, stbi__l2h_scale=1.0f;
+
+STBIDEF void   stbi_ldr_to_hdr_gamma(float gamma) { stbi__l2h_gamma = gamma; }
+STBIDEF void   stbi_ldr_to_hdr_scale(float scale) { stbi__l2h_scale = scale; }
+#endif
+
+static float stbi__h2l_gamma_i=1.0f/2.2f, stbi__h2l_scale_i=1.0f;
+
+STBIDEF void   stbi_hdr_to_ldr_gamma(float gamma) { stbi__h2l_gamma_i = 1/gamma; }
+STBIDEF void   stbi_hdr_to_ldr_scale(float scale) { stbi__h2l_scale_i = 1/scale; }
+
+
+//////////////////////////////////////////////////////////////////////////////
+//
+// Common code used by all image loaders
+//
+
+enum
+{
+   STBI__SCAN_load=0,
+   STBI__SCAN_type,
+   STBI__SCAN_header
+};
+
+static void stbi__refill_buffer(stbi__context *s)
+{
+   int n = (s->io.read)(s->io_user_data,(char*)s->buffer_start,s->buflen);
+   if (n == 0) {
+      // at end of file, treat same as if from memory, but need to handle case
+      // where s->img_buffer isn't pointing to safe memory, e.g. 0-byte file
+      s->read_from_callbacks = 0;
+      s->img_buffer = s->buffer_start;
+      s->img_buffer_end = s->buffer_start+1;
+      *s->img_buffer = 0;
+   } else {
+      s->img_buffer = s->buffer_start;
+      s->img_buffer_end = s->buffer_start + n;
+   }
+}
+
+stbi_inline static stbi_uc stbi__get8(stbi__context *s)
+{
+   if (s->img_buffer < s->img_buffer_end)
+      return *s->img_buffer++;
+   if (s->read_from_callbacks) {
+      stbi__refill_buffer(s);
+      return *s->img_buffer++;
+   }
+   return 0;
+}
+
+stbi_inline static int stbi__at_eof(stbi__context *s)
+{
+   if (s->io.read) {
+      if (!(s->io.eof)(s->io_user_data)) return 0;
+      // if feof() is true, check if buffer = end
+      // special case: we've only got the special 0 character at the end
+      if (s->read_from_callbacks == 0) return 1;
+   }
+
+   return s->img_buffer >= s->img_buffer_end;
+}
+
+static void stbi__skip(stbi__context *s, int n)
+{
+   if (n < 0) {
+      s->img_buffer = s->img_buffer_end;
+      return;
+   }
+   if (s->io.read) {
+      int blen = (int) (s->img_buffer_end - s->img_buffer);
+      if (blen < n) {
+         s->img_buffer = s->img_buffer_end;
+         (s->io.skip)(s->io_user_data, n - blen);
+         return;
+      }
+   }
+   s->img_buffer += n;
+}
+
+static int stbi__getn(stbi__context *s, stbi_uc *buffer, int n)
+{
+   if (s->io.read) {
+      int blen = (int) (s->img_buffer_end - s->img_buffer);
+      if (blen < n) {
+         int res, count;
+
+         memcpy(buffer, s->img_buffer, blen);
+
+         count = (s->io.read)(s->io_user_data, (char*) buffer + blen, n - blen);
+         res = (count == (n-blen));
+         s->img_buffer = s->img_buffer_end;
+         return res;
+      }
+   }
+
+   if (s->img_buffer+n <= s->img_buffer_end) {
+      memcpy(buffer, s->img_buffer, n);
+      s->img_buffer += n;
+      return 1;
+   } else
+      return 0;
+}
+
+static int stbi__get16be(stbi__context *s)
+{
+   int z = stbi__get8(s);
+   return (z << 8) + stbi__get8(s);
+}
+
+static stbi__uint32 stbi__get32be(stbi__context *s)
+{
+   stbi__uint32 z = stbi__get16be(s);
+   return (z << 16) + stbi__get16be(s);
+}
+
+#if defined(STBI_NO_BMP) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF)
+// nothing
+#else
+static int stbi__get16le(stbi__context *s)
+{
+   int z = stbi__get8(s);
+   return z + (stbi__get8(s) << 8);
+}
+#endif
+
+#ifndef STBI_NO_BMP
+static stbi__uint32 stbi__get32le(stbi__context *s)
+{
+   stbi__uint32 z = stbi__get16le(s);
+   return z + (stbi__get16le(s) << 16);
+}
+#endif
+
+#define STBI__BYTECAST(x)  ((stbi_uc) ((x) & 255))  // truncate int to byte without warnings
+
+
+//////////////////////////////////////////////////////////////////////////////
+//
+//  generic converter from built-in img_n to req_comp
+//    individual types do this automatically as much as possible (e.g. jpeg
+//    does all cases internally since it needs to colorspace convert anyway,
+//    and it never has alpha, so very few cases ). png can automatically
+//    interleave an alpha=255 channel, but falls back to this for other cases
+//
+//  assume data buffer is malloced, so malloc a new one and free that one
+//  only failure mode is malloc failing
+
+static stbi_uc stbi__compute_y(int r, int g, int b)
+{
+   return (stbi_uc) (((r*77) + (g*150) +  (29*b)) >> 8);
+}
+
+static unsigned char *stbi__convert_format(unsigned char *data, int img_n, int req_comp, unsigned int x, unsigned int y)
+{
+   int i,j;
+   unsigned char *good;
+
+   if (req_comp == img_n) return data;
+   STBI_ASSERT(req_comp >= 1 && req_comp <= 4);
+
+   good = (unsigned char *) stbi__malloc_mad3(req_comp, x, y, 0);
+   if (good == NULL) {
+      STBI_FREE(data);
+      return stbi__errpuc("outofmem", "Out of memory");
+   }
+
+   for (j=0; j < (int) y; ++j) {
+      unsigned char *src  = data + j * x * img_n   ;
+      unsigned char *dest = good + j * x * req_comp;
+
+      #define STBI__COMBO(a,b)  ((a)*8+(b))
+      #define STBI__CASE(a,b)   case STBI__COMBO(a,b): for(i=x-1; i >= 0; --i, src += a, dest += b)
+      // convert source image with img_n components to one with req_comp components;
+      // avoid switch per pixel, so use switch per scanline and massive macros
+      switch (STBI__COMBO(img_n, req_comp)) {
+         STBI__CASE(1,2) { dest[0]=src[0]; dest[1]=255;                                     } break;
+         STBI__CASE(1,3) { dest[0]=dest[1]=dest[2]=src[0];                                  } break;
+         STBI__CASE(1,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=255;                     } break;
+         STBI__CASE(2,1) { dest[0]=src[0];                                                  } break;
+         STBI__CASE(2,3) { dest[0]=dest[1]=dest[2]=src[0];                                  } break;
+         STBI__CASE(2,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=src[1];                  } break;
+         STBI__CASE(3,4) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2];dest[3]=255;        } break;
+         STBI__CASE(3,1) { dest[0]=stbi__compute_y(src[0],src[1],src[2]);                   } break;
+         STBI__CASE(3,2) { dest[0]=stbi__compute_y(src[0],src[1],src[2]); dest[1] = 255;    } break;
+         STBI__CASE(4,1) { dest[0]=stbi__compute_y(src[0],src[1],src[2]);                   } break;
+         STBI__CASE(4,2) { dest[0]=stbi__compute_y(src[0],src[1],src[2]); dest[1] = src[3]; } break;
+         STBI__CASE(4,3) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2];                    } break;
+         default: STBI_ASSERT(0);
+      }
+      #undef STBI__CASE
+   }
+
+   STBI_FREE(data);
+   return good;
+}
+
+static stbi__uint16 stbi__compute_y_16(int r, int g, int b)
+{
+   return (stbi__uint16) (((r*77) + (g*150) +  (29*b)) >> 8);
+}
+
+static stbi__uint16 *stbi__convert_format16(stbi__uint16 *data, int img_n, int req_comp, unsigned int x, unsigned int y)
+{
+   int i,j;
+   stbi__uint16 *good;
+
+   if (req_comp == img_n) return data;
+   STBI_ASSERT(req_comp >= 1 && req_comp <= 4);
+
+   good = (stbi__uint16 *) stbi__malloc(req_comp * x * y * 2);
+   if (good == NULL) {
+      STBI_FREE(data);
+      return (stbi__uint16 *) stbi__errpuc("outofmem", "Out of memory");
+   }
+
+   for (j=0; j < (int) y; ++j) {
+      stbi__uint16 *src  = data + j * x * img_n   ;
+      stbi__uint16 *dest = good + j * x * req_comp;
+
+      #define STBI__COMBO(a,b)  ((a)*8+(b))
+      #define STBI__CASE(a,b)   case STBI__COMBO(a,b): for(i=x-1; i >= 0; --i, src += a, dest += b)
+      // convert source image with img_n components to one with req_comp components;
+      // avoid switch per pixel, so use switch per scanline and massive macros
+      switch (STBI__COMBO(img_n, req_comp)) {
+         STBI__CASE(1,2) { dest[0]=src[0]; dest[1]=0xffff;                                     } break;
+         STBI__CASE(1,3) { dest[0]=dest[1]=dest[2]=src[0];                                     } break;
+         STBI__CASE(1,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=0xffff;                     } break;
+         STBI__CASE(2,1) { dest[0]=src[0];                                                     } break;
+         STBI__CASE(2,3) { dest[0]=dest[1]=dest[2]=src[0];                                     } break;
+         STBI__CASE(2,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=src[1];                     } break;
+         STBI__CASE(3,4) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2];dest[3]=0xffff;        } break;
+         STBI__CASE(3,1) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]);                   } break;
+         STBI__CASE(3,2) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]); dest[1] = 0xffff; } break;
+         STBI__CASE(4,1) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]);                   } break;
+         STBI__CASE(4,2) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]); dest[1] = src[3]; } break;
+         STBI__CASE(4,3) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2];                       } break;
+         default: STBI_ASSERT(0);
+      }
+      #undef STBI__CASE
+   }
+
+   STBI_FREE(data);
+   return good;
+}
+
+#ifndef STBI_NO_LINEAR
+static float   *stbi__ldr_to_hdr(stbi_uc *data, int x, int y, int comp)
+{
+   int i,k,n;
+   float *output;
+   if (!data) return NULL;
+   output = (float *) stbi__malloc_mad4(x, y, comp, sizeof(float), 0);
+   if (output == NULL) { STBI_FREE(data); return stbi__errpf("outofmem", "Out of memory"); }
+   // compute number of non-alpha components
+   if (comp & 1) n = comp; else n = comp-1;
+   for (i=0; i < x*y; ++i) {
+      for (k=0; k < n; ++k) {
+         output[i*comp + k] = (float) (pow(data[i*comp+k]/255.0f, stbi__l2h_gamma) * stbi__l2h_scale);
+      }
+   }
+   if (n < comp) {
+      for (i=0; i < x*y; ++i) {
+         output[i*comp + n] = data[i*comp + n]/255.0f;
+      }
+   }
+   STBI_FREE(data);
+   return output;
+}
+#endif
+
+#ifndef STBI_NO_HDR
+#define stbi__float2int(x)   ((int) (x))
+static stbi_uc *stbi__hdr_to_ldr(float   *data, int x, int y, int comp)
+{
+   int i,k,n;
+   stbi_uc *output;
+   if (!data) return NULL;
+   output = (stbi_uc *) stbi__malloc_mad3(x, y, comp, 0);
+   if (output == NULL) { STBI_FREE(data); return stbi__errpuc("outofmem", "Out of memory"); }
+   // compute number of non-alpha components
+   if (comp & 1) n = comp; else n = comp-1;
+   for (i=0; i < x*y; ++i) {
+      for (k=0; k < n; ++k) {
+         float z = (float) pow(data[i*comp+k]*stbi__h2l_scale_i, stbi__h2l_gamma_i) * 255 + 0.5f;
+         if (z < 0) z = 0;
+         if (z > 255) z = 255;
+         output[i*comp + k] = (stbi_uc) stbi__float2int(z);
+      }
+      if (k < comp) {
+         float z = data[i*comp+k] * 255 + 0.5f;
+         if (z < 0) z = 0;
+         if (z > 255) z = 255;
+         output[i*comp + k] = (stbi_uc) stbi__float2int(z);
+      }
+   }
+   STBI_FREE(data);
+   return output;
+}
+#endif
+
+//////////////////////////////////////////////////////////////////////////////
+//
+//  "baseline" JPEG/JFIF decoder
+//
+//    simple implementation
+//      - doesn't support delayed output of y-dimension
+//      - simple interface (only one output format: 8-bit interleaved RGB)
+//      - doesn't try to recover corrupt jpegs
+//      - doesn't allow partial loading, loading multiple at once
+//      - still fast on x86 (copying globals into locals doesn't help x86)
+//      - allocates lots of intermediate memory (full size of all components)
+//        - non-interleaved case requires this anyway
+//        - allows good upsampling (see next)
+//    high-quality
+//      - upsampled channels are bilinearly interpolated, even across blocks
+//      - quality integer IDCT derived from IJG's 'slow'
+//    performance
+//      - fast huffman; reasonable integer IDCT
+//      - some SIMD kernels for common paths on targets with SSE2/NEON
+//      - uses a lot of intermediate memory, could cache poorly
+
+#ifndef STBI_NO_JPEG
+
+// huffman decoding acceleration
+#define FAST_BITS   9  // larger handles more cases; smaller stomps less cache
+
+typedef struct
+{
+   stbi_uc  fast[1 << FAST_BITS];
+   // weirdly, repacking this into AoS is a 10% speed loss, instead of a win
+   stbi__uint16 code[256];
+   stbi_uc  values[256];
+   stbi_uc  size[257];
+   unsigned int maxcode[18];
+   int    delta[17];   // old 'firstsymbol' - old 'firstcode'
+} stbi__huffman;
+
+typedef struct
+{
+   stbi__context *s;
+   stbi__huffman huff_dc[4];
+   stbi__huffman huff_ac[4];
+   stbi__uint16 dequant[4][64];
+   stbi__int16 fast_ac[4][1 << FAST_BITS];
+
+// sizes for components, interleaved MCUs
+   int img_h_max, img_v_max;
+   int img_mcu_x, img_mcu_y;
+   int img_mcu_w, img_mcu_h;
+
+// definition of jpeg image component
+   struct
+   {
+      int id;
+      int h,v;
+      int tq;
+      int hd,ha;
+      int dc_pred;
+
+      int x,y,w2,h2;
+      stbi_uc *data;
+      void *raw_data, *raw_coeff;
+      stbi_uc *linebuf;
+      short   *coeff;   // progressive only
+      int      coeff_w, coeff_h; // number of 8x8 coefficient blocks
+   } img_comp[4];
+
+   stbi__uint32   code_buffer; // jpeg entropy-coded buffer
+   int            code_bits;   // number of valid bits
+   unsigned char  marker;      // marker seen while filling entropy buffer
+   int            nomore;      // flag if we saw a marker so must stop
+
+   int            progressive;
+   int            spec_start;
+   int            spec_end;
+   int            succ_high;
+   int            succ_low;
+   int            eob_run;
+   int            jfif;
+   int            app14_color_transform; // Adobe APP14 tag
+   int            rgb;
+
+   int scan_n, order[4];
+   int restart_interval, todo;
+
+// kernels
+   void (*idct_block_kernel)(stbi_uc *out, int out_stride, short data[64]);
+   void (*YCbCr_to_RGB_kernel)(stbi_uc *out, const stbi_uc *y, const stbi_uc *pcb, const stbi_uc *pcr, int count, int step);
+   stbi_uc *(*resample_row_hv_2_kernel)(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs);
+} stbi__jpeg;
+
+static int stbi__build_huffman(stbi__huffman *h, int *count)
+{
+   int i,j,k=0;
+   unsigned int code;
+   // build size list for each symbol (from JPEG spec)
+   for (i=0; i < 16; ++i)
+      for (j=0; j < count[i]; ++j)
+         h->size[k++] = (stbi_uc) (i+1);
+   h->size[k] = 0;
+
+   // compute actual symbols (from jpeg spec)
+   code = 0;
+   k = 0;
+   for(j=1; j <= 16; ++j) {
+      // compute delta to add to code to compute symbol id
+      h->delta[j] = k - code;
+      if (h->size[k] == j) {
+         while (h->size[k] == j)
+            h->code[k++] = (stbi__uint16) (code++);
+         if (code-1 >= (1u << j)) return stbi__err("bad code lengths","Corrupt JPEG");
+      }
+      // compute largest code + 1 for this size, preshifted as needed later
+      h->maxcode[j] = code << (16-j);
+      code <<= 1;
+   }
+   h->maxcode[j] = 0xffffffff;
+
+   // build non-spec acceleration table; 255 is flag for not-accelerated
+   memset(h->fast, 255, 1 << FAST_BITS);
+   for (i=0; i < k; ++i) {
+      int s = h->size[i];
+      if (s <= FAST_BITS) {
+         int c = h->code[i] << (FAST_BITS-s);
+         int m = 1 << (FAST_BITS-s);
+         for (j=0; j < m; ++j) {
+            h->fast[c+j] = (stbi_uc) i;
+         }
+      }
+   }
+   return 1;
+}
+
+// build a table that decodes both magnitude and value of small ACs in
+// one go.
+static void stbi__build_fast_ac(stbi__int16 *fast_ac, stbi__huffman *h)
+{
+   int i;
+   for (i=0; i < (1 << FAST_BITS); ++i) {
+      stbi_uc fast = h->fast[i];
+      fast_ac[i] = 0;
+      if (fast < 255) {
+         int rs = h->values[fast];
+         int run = (rs >> 4) & 15;
+         int magbits = rs & 15;
+         int len = h->size[fast];
+
+         if (magbits && len + magbits <= FAST_BITS) {
+            // magnitude code followed by receive_extend code
+            int k = ((i << len) & ((1 << FAST_BITS) - 1)) >> (FAST_BITS - magbits);
+            int m = 1 << (magbits - 1);
+            if (k < m) k += (~0U << magbits) + 1;
+            // if the result is small enough, we can fit it in fast_ac table
+            if (k >= -128 && k <= 127)
+               fast_ac[i] = (stbi__int16) ((k * 256) + (run * 16) + (len + magbits));
+         }
+      }
+   }
+}
+
+static void stbi__grow_buffer_unsafe(stbi__jpeg *j)
+{
+   do {
+      unsigned int b = j->nomore ? 0 : stbi__get8(j->s);
+      if (b == 0xff) {
+         int c = stbi__get8(j->s);
+         while (c == 0xff) c = stbi__get8(j->s); // consume fill bytes
+         if (c != 0) {
+            j->marker = (unsigned char) c;
+            j->nomore = 1;
+            return;
+         }
+      }
+      j->code_buffer |= b << (24 - j->code_bits);
+      j->code_bits += 8;
+   } while (j->code_bits <= 24);
+}
+
+// (1 << n) - 1
+static const stbi__uint32 stbi__bmask[17]={0,1,3,7,15,31,63,127,255,511,1023,2047,4095,8191,16383,32767,65535};
+
+// decode a jpeg huffman value from the bitstream
+stbi_inline static int stbi__jpeg_huff_decode(stbi__jpeg *j, stbi__huffman *h)
+{
+   unsigned int temp;
+   int c,k;
+
+   if (j->code_bits < 16) stbi__grow_buffer_unsafe(j);
+
+   // look at the top FAST_BITS and determine what symbol ID it is,
+   // if the code is <= FAST_BITS
+   c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS)-1);
+   k = h->fast[c];
+   if (k < 255) {
+      int s = h->size[k];
+      if (s > j->code_bits)
+         return -1;
+      j->code_buffer <<= s;
+      j->code_bits -= s;
+      return h->values[k];
+   }
+
+   // naive test is to shift the code_buffer down so k bits are
+   // valid, then test against maxcode. To speed this up, we've
+   // preshifted maxcode left so that it has (16-k) 0s at the
+   // end; in other words, regardless of the number of bits, it
+   // wants to be compared against something shifted to have 16;
+   // that way we don't need to shift inside the loop.
+   temp = j->code_buffer >> 16;
+   for (k=FAST_BITS+1 ; ; ++k)
+      if (temp < h->maxcode[k])
+         break;
+   if (k == 17) {
+      // error! code not found
+      j->code_bits -= 16;
+      return -1;
+   }
+
+   if (k > j->code_bits)
+      return -1;
+
+   // convert the huffman code to the symbol id
+   c = ((j->code_buffer >> (32 - k)) & stbi__bmask[k]) + h->delta[k];
+   STBI_ASSERT((((j->code_buffer) >> (32 - h->size[c])) & stbi__bmask[h->size[c]]) == h->code[c]);
+
+   // convert the id to a symbol
+   j->code_bits -= k;
+   j->code_buffer <<= k;
+   return h->values[c];
+}
+
+// bias[n] = (-1<<n) + 1
+static const int stbi__jbias[16] = {0,-1,-3,-7,-15,-31,-63,-127,-255,-511,-1023,-2047,-4095,-8191,-16383,-32767};
+
+// combined JPEG 'receive' and JPEG 'extend', since baseline
+// always extends everything it receives.
+stbi_inline static int stbi__extend_receive(stbi__jpeg *j, int n)
+{
+   unsigned int k;
+   int sgn;
+   if (j->code_bits < n) stbi__grow_buffer_unsafe(j);
+
+   sgn = (stbi__int32)j->code_buffer >> 31; // sign bit is always in MSB
+   k = stbi_lrot(j->code_buffer, n);
+   STBI_ASSERT(n >= 0 && n < (int) (sizeof(stbi__bmask)/sizeof(*stbi__bmask)));
+   j->code_buffer = k & ~stbi__bmask[n];
+   k &= stbi__bmask[n];
+   j->code_bits -= n;
+   return k + (stbi__jbias[n] & ~sgn);
+}
+
+// get some unsigned bits
+stbi_inline static int stbi__jpeg_get_bits(stbi__jpeg *j, int n)
+{
+   unsigned int k;
+   if (j->code_bits < n) stbi__grow_buffer_unsafe(j);
+   k = stbi_lrot(j->code_buffer, n);
+   j->code_buffer = k & ~stbi__bmask[n];
+   k &= stbi__bmask[n];
+   j->code_bits -= n;
+   return k;
+}
+
+stbi_inline static int stbi__jpeg_get_bit(stbi__jpeg *j)
+{
+   unsigned int k;
+   if (j->code_bits < 1) stbi__grow_buffer_unsafe(j);
+   k = j->code_buffer;
+   j->code_buffer <<= 1;
+   --j->code_bits;
+   return k & 0x80000000;
+}
+
+// given a value that's at position X in the zigzag stream,
+// where does it appear in the 8x8 matrix coded as row-major?
+static const stbi_uc stbi__jpeg_dezigzag[64+15] =
+{
+    0,  1,  8, 16,  9,  2,  3, 10,
+   17, 24, 32, 25, 18, 11,  4,  5,
+   12, 19, 26, 33, 40, 48, 41, 34,
+   27, 20, 13,  6,  7, 14, 21, 28,
+   35, 42, 49, 56, 57, 50, 43, 36,
+   29, 22, 15, 23, 30, 37, 44, 51,
+   58, 59, 52, 45, 38, 31, 39, 46,
+   53, 60, 61, 54, 47, 55, 62, 63,
+   // let corrupt input sample past end
+   63, 63, 63, 63, 63, 63, 63, 63,
+   63, 63, 63, 63, 63, 63, 63
+};
+
+// decode one 64-entry block--
+static int stbi__jpeg_decode_block(stbi__jpeg *j, short data[64], stbi__huffman *hdc, stbi__huffman *hac, stbi__int16 *fac, int b, stbi__uint16 *dequant)
+{
+   int diff,dc,k;
+   int t;
+
+   if (j->code_bits < 16) stbi__grow_buffer_unsafe(j);
+   t = stbi__jpeg_huff_decode(j, hdc);
+   if (t < 0) return stbi__err("bad huffman code","Corrupt JPEG");
+
+   // 0 all the ac values now so we can do it 32-bits at a time
+   memset(data,0,64*sizeof(data[0]));
+
+   diff = t ? stbi__extend_receive(j, t) : 0;
+   dc = j->img_comp[b].dc_pred + diff;
+   j->img_comp[b].dc_pred = dc;
+   data[0] = (short) (dc * dequant[0]);
+
+   // decode AC components, see JPEG spec
+   k = 1;
+   do {
+      unsigned int zig;
+      int c,r,s;
+      if (j->code_bits < 16) stbi__grow_buffer_unsafe(j);
+      c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS)-1);
+      r = fac[c];
+      if (r) { // fast-AC path
+         k += (r >> 4) & 15; // run
+         s = r & 15; // combined length
+         j->code_buffer <<= s;
+         j->code_bits -= s;
+         // decode into unzigzag'd location
+         zig = stbi__jpeg_dezigzag[k++];
+         data[zig] = (short) ((r >> 8) * dequant[zig]);
+      } else {
+         int rs = stbi__jpeg_huff_decode(j, hac);
+         if (rs < 0) return stbi__err("bad huffman code","Corrupt JPEG");
+         s = rs & 15;
+         r = rs >> 4;
+         if (s == 0) {
+            if (rs != 0xf0) break; // end block
+            k += 16;
+         } else {
+            k += r;
+            // decode into unzigzag'd location
+            zig = stbi__jpeg_dezigzag[k++];
+            data[zig] = (short) (stbi__extend_receive(j,s) * dequant[zig]);
+         }
+      }
+   } while (k < 64);
+   return 1;
+}
+
+static int stbi__jpeg_decode_block_prog_dc(stbi__jpeg *j, short data[64], stbi__huffman *hdc, int b)
+{
+   int diff,dc;
+   int t;
+   if (j->spec_end != 0) return stbi__err("can't merge dc and ac", "Corrupt JPEG");
+
+   if (j->code_bits < 16) stbi__grow_buffer_unsafe(j);
+
+   if (j->succ_high == 0) {
+      // first scan for DC coefficient, must be first
+      memset(data,0,64*sizeof(data[0])); // 0 all the ac values now
+      t = stbi__jpeg_huff_decode(j, hdc);
+      diff = t ? stbi__extend_receive(j, t) : 0;
+
+      dc = j->img_comp[b].dc_pred + diff;
+      j->img_comp[b].dc_pred = dc;
+      data[0] = (short) (dc << j->succ_low);
+   } else {
+      // refinement scan for DC coefficient
+      if (stbi__jpeg_get_bit(j))
+         data[0] += (short) (1 << j->succ_low);
+   }
+   return 1;
+}
+
+// @OPTIMIZE: store non-zigzagged during the decode passes,
+// and only de-zigzag when dequantizing
+static int stbi__jpeg_decode_block_prog_ac(stbi__jpeg *j, short data[64], stbi__huffman *hac, stbi__int16 *fac)
+{
+   int k;
+   if (j->spec_start == 0) return stbi__err("can't merge dc and ac", "Corrupt JPEG");
+
+   if (j->succ_high == 0) {
+      int shift = j->succ_low;
+
+      if (j->eob_run) {
+         --j->eob_run;
+         return 1;
+      }
+
+      k = j->spec_start;
+      do {
+         unsigned int zig;
+         int c,r,s;
+         if (j->code_bits < 16) stbi__grow_buffer_unsafe(j);
+         c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS)-1);
+         r = fac[c];
+         if (r) { // fast-AC path
+            k += (r >> 4) & 15; // run
+            s = r & 15; // combined length
+            j->code_buffer <<= s;
+            j->code_bits -= s;
+            zig = stbi__jpeg_dezigzag[k++];
+            data[zig] = (short) ((r >> 8) << shift);
+         } else {
+            int rs = stbi__jpeg_huff_decode(j, hac);
+            if (rs < 0) return stbi__err("bad huffman code","Corrupt JPEG");
+            s = rs & 15;
+            r = rs >> 4;
+            if (s == 0) {
+               if (r < 15) {
+                  j->eob_run = (1 << r);
+                  if (r)
+                     j->eob_run += stbi__jpeg_get_bits(j, r);
+                  --j->eob_run;
+                  break;
+               }
+               k += 16;
+            } else {
+               k += r;
+               zig = stbi__jpeg_dezigzag[k++];
+               data[zig] = (short) (stbi__extend_receive(j,s) << shift);
+            }
+         }
+      } while (k <= j->spec_end);
+   } else {
+      // refinement scan for these AC coefficients
+
+      short bit = (short) (1 << j->succ_low);
+
+      if (j->eob_run) {
+         --j->eob_run;
+         for (k = j->spec_start; k <= j->spec_end; ++k) {
+            short *p = &data[stbi__jpeg_dezigzag[k]];
+            if (*p != 0)
+               if (stbi__jpeg_get_bit(j))
+                  if ((*p & bit)==0) {
+                     if (*p > 0)
+                        *p += bit;
+                     else
+                        *p -= bit;
+                  }
+         }
+      } else {
+         k = j->spec_start;
+         do {
+            int r,s;
+            int rs = stbi__jpeg_huff_decode(j, hac); // @OPTIMIZE see if we can use the fast path here, advance-by-r is so slow, eh
+            if (rs < 0) return stbi__err("bad huffman code","Corrupt JPEG");
+            s = rs & 15;
+            r = rs >> 4;
+            if (s == 0) {
+               if (r < 15) {
+                  j->eob_run = (1 << r) - 1;
+                  if (r)
+                     j->eob_run += stbi__jpeg_get_bits(j, r);
+                  r = 64; // force end of block
+               } else {
+                  // r=15 s=0 should write 16 0s, so we just do
+                  // a run of 15 0s and then write s (which is 0),
+                  // so we don't have to do anything special here
+               }
+            } else {
+               if (s != 1) return stbi__err("bad huffman code", "Corrupt JPEG");
+               // sign bit
+               if (stbi__jpeg_get_bit(j))
+                  s = bit;
+               else
+                  s = -bit;
+            }
+
+            // advance by r
+            while (k <= j->spec_end) {
+               short *p = &data[stbi__jpeg_dezigzag[k++]];
+               if (*p != 0) {
+                  if (stbi__jpeg_get_bit(j))
+                     if ((*p & bit)==0) {
+                        if (*p > 0)
+                           *p += bit;
+                        else
+                           *p -= bit;
+                     }
+               } else {
+                  if (r == 0) {
+                     *p = (short) s;
+                     break;
+                  }
+                  --r;
+               }
+            }
+         } while (k <= j->spec_end);
+      }
+   }
+   return 1;
+}
+
+// take a -128..127 value and stbi__clamp it and convert to 0..255
+stbi_inline static stbi_uc stbi__clamp(int x)
+{
+   // trick to use a single test to catch both cases
+   if ((unsigned int) x > 255) {
+      if (x < 0) return 0;
+      if (x > 255) return 255;
+   }
+   return (stbi_uc) x;
+}
+
+#define stbi__f2f(x)  ((int) (((x) * 4096 + 0.5)))
+#define stbi__fsh(x)  ((x) * 4096)
+
+// derived from jidctint -- DCT_ISLOW
+#define STBI__IDCT_1D(s0,s1,s2,s3,s4,s5,s6,s7) \
+   int t0,t1,t2,t3,p1,p2,p3,p4,p5,x0,x1,x2,x3; \
+   p2 = s2;                                    \
+   p3 = s6;                                    \
+   p1 = (p2+p3) * stbi__f2f(0.5411961f);       \
+   t2 = p1 + p3*stbi__f2f(-1.847759065f);      \
+   t3 = p1 + p2*stbi__f2f( 0.765366865f);      \
+   p2 = s0;                                    \
+   p3 = s4;                                    \
+   t0 = stbi__fsh(p2+p3);                      \
+   t1 = stbi__fsh(p2-p3);                      \
+   x0 = t0+t3;                                 \
+   x3 = t0-t3;                                 \
+   x1 = t1+t2;                                 \
+   x2 = t1-t2;                                 \
+   t0 = s7;                                    \
+   t1 = s5;                                    \
+   t2 = s3;                                    \
+   t3 = s1;                                    \
+   p3 = t0+t2;                                 \
+   p4 = t1+t3;                                 \
+   p1 = t0+t3;                                 \
+   p2 = t1+t2;                                 \
+   p5 = (p3+p4)*stbi__f2f( 1.175875602f);      \
+   t0 = t0*stbi__f2f( 0.298631336f);           \
+   t1 = t1*stbi__f2f( 2.053119869f);           \
+   t2 = t2*stbi__f2f( 3.072711026f);           \
+   t3 = t3*stbi__f2f( 1.501321110f);           \
+   p1 = p5 + p1*stbi__f2f(-0.899976223f);      \
+   p2 = p5 + p2*stbi__f2f(-2.562915447f);      \
+   p3 = p3*stbi__f2f(-1.961570560f);           \
+   p4 = p4*stbi__f2f(-0.390180644f);           \
+   t3 += p1+p4;                                \
+   t2 += p2+p3;                                \
+   t1 += p2+p4;                                \
+   t0 += p1+p3;
+
+static void stbi__idct_block(stbi_uc *out, int out_stride, short data[64])
+{
+   int i,val[64],*v=val;
+   stbi_uc *o;
+   short *d = data;
+
+   // columns
+   for (i=0; i < 8; ++i,++d, ++v) {
+      // if all zeroes, shortcut -- this avoids dequantizing 0s and IDCTing
+      if (d[ 8]==0 && d[16]==0 && d[24]==0 && d[32]==0
+           && d[40]==0 && d[48]==0 && d[56]==0) {
+         //    no shortcut                 0     seconds
+         //    (1|2|3|4|5|6|7)==0          0     seconds
+         //    all separate               -0.047 seconds
+         //    1 && 2|3 && 4|5 && 6|7:    -0.047 seconds
+         int dcterm = d[0]*4;
+         v[0] = v[8] = v[16] = v[24] = v[32] = v[40] = v[48] = v[56] = dcterm;
+      } else {
+         STBI__IDCT_1D(d[ 0],d[ 8],d[16],d[24],d[32],d[40],d[48],d[56])
+         // constants scaled things up by 1<<12; let's bring them back
+         // down, but keep 2 extra bits of precision
+         x0 += 512; x1 += 512; x2 += 512; x3 += 512;
+         v[ 0] = (x0+t3) >> 10;
+         v[56] = (x0-t3) >> 10;
+         v[ 8] = (x1+t2) >> 10;
+         v[48] = (x1-t2) >> 10;
+         v[16] = (x2+t1) >> 10;
+         v[40] = (x2-t1) >> 10;
+         v[24] = (x3+t0) >> 10;
+         v[32] = (x3-t0) >> 10;
+      }
+   }
+
+   for (i=0, v=val, o=out; i < 8; ++i,v+=8,o+=out_stride) {
+      // no fast case since the first 1D IDCT spread components out
+      STBI__IDCT_1D(v[0],v[1],v[2],v[3],v[4],v[5],v[6],v[7])
+      // constants scaled things up by 1<<12, plus we had 1<<2 from first
+      // loop, plus horizontal and vertical each scale by sqrt(8) so together
+      // we've got an extra 1<<3, so 1<<17 total we need to remove.
+      // so we want to round that, which means adding 0.5 * 1<<17,
+      // aka 65536. Also, we'll end up with -128 to 127 that we want
+      // to encode as 0..255 by adding 128, so we'll add that before the shift
+      x0 += 65536 + (128<<17);
+      x1 += 65536 + (128<<17);
+      x2 += 65536 + (128<<17);
+      x3 += 65536 + (128<<17);
+      // tried computing the shifts into temps, or'ing the temps to see
+      // if any were out of range, but that was slower
+      o[0] = stbi__clamp((x0+t3) >> 17);
+      o[7] = stbi__clamp((x0-t3) >> 17);
+      o[1] = stbi__clamp((x1+t2) >> 17);
+      o[6] = stbi__clamp((x1-t2) >> 17);
+      o[2] = stbi__clamp((x2+t1) >> 17);
+      o[5] = stbi__clamp((x2-t1) >> 17);
+      o[3] = stbi__clamp((x3+t0) >> 17);
+      o[4] = stbi__clamp((x3-t0) >> 17);
+   }
+}
+
+#ifdef STBI_SSE2
+// sse2 integer IDCT. not the fastest possible implementation but it
+// produces bit-identical results to the generic C version so it's
+// fully "transparent".
+static void stbi__idct_simd(stbi_uc *out, int out_stride, short data[64])
+{
+   // This is constructed to match our regular (generic) integer IDCT exactly.
+   __m128i row0, row1, row2, row3, row4, row5, row6, row7;
+   __m128i tmp;
+
+   // dot product constant: even elems=x, odd elems=y
+   #define dct_const(x,y)  _mm_setr_epi16((x),(y),(x),(y),(x),(y),(x),(y))
+
+   // out(0) = c0[even]*x + c0[odd]*y   (c0, x, y 16-bit, out 32-bit)
+   // out(1) = c1[even]*x + c1[odd]*y
+   #define dct_rot(out0,out1, x,y,c0,c1) \
+      __m128i c0##lo = _mm_unpacklo_epi16((x),(y)); \
+      __m128i c0##hi = _mm_unpackhi_epi16((x),(y)); \
+      __m128i out0##_l = _mm_madd_epi16(c0##lo, c0); \
+      __m128i out0##_h = _mm_madd_epi16(c0##hi, c0); \
+      __m128i out1##_l = _mm_madd_epi16(c0##lo, c1); \
+      __m128i out1##_h = _mm_madd_epi16(c0##hi, c1)
+
+   // out = in << 12  (in 16-bit, out 32-bit)
+   #define dct_widen(out, in) \
+      __m128i out##_l = _mm_srai_epi32(_mm_unpacklo_epi16(_mm_setzero_si128(), (in)), 4); \
+      __m128i out##_h = _mm_srai_epi32(_mm_unpackhi_epi16(_mm_setzero_si128(), (in)), 4)
+
+   // wide add
+   #define dct_wadd(out, a, b) \
+      __m128i out##_l = _mm_add_epi32(a##_l, b##_l); \
+      __m128i out##_h = _mm_add_epi32(a##_h, b##_h)
+
+   // wide sub
+   #define dct_wsub(out, a, b) \
+      __m128i out##_l = _mm_sub_epi32(a##_l, b##_l); \
+      __m128i out##_h = _mm_sub_epi32(a##_h, b##_h)
+
+   // butterfly a/b, add bias, then shift by "s" and pack
+   #define dct_bfly32o(out0, out1, a,b,bias,s) \
+      { \
+         __m128i abiased_l = _mm_add_epi32(a##_l, bias); \
+         __m128i abiased_h = _mm_add_epi32(a##_h, bias); \
+         dct_wadd(sum, abiased, b); \
+         dct_wsub(dif, abiased, b); \
+         out0 = _mm_packs_epi32(_mm_srai_epi32(sum_l, s), _mm_srai_epi32(sum_h, s)); \
+         out1 = _mm_packs_epi32(_mm_srai_epi32(dif_l, s), _mm_srai_epi32(dif_h, s)); \
+      }
+
+   // 8-bit interleave step (for transposes)
+   #define dct_interleave8(a, b) \
+      tmp = a; \
+      a = _mm_unpacklo_epi8(a, b); \
+      b = _mm_unpackhi_epi8(tmp, b)
+
+   // 16-bit interleave step (for transposes)
+   #define dct_interleave16(a, b) \
+      tmp = a; \
+      a = _mm_unpacklo_epi16(a, b); \
+      b = _mm_unpackhi_epi16(tmp, b)
+
+   #define dct_pass(bias,shift) \
+      { \
+         /* even part */ \
+         dct_rot(t2e,t3e, row2,row6, rot0_0,rot0_1); \
+         __m128i sum04 = _mm_add_epi16(row0, row4); \
+         __m128i dif04 = _mm_sub_epi16(row0, row4); \
+         dct_widen(t0e, sum04); \
+         dct_widen(t1e, dif04); \
+         dct_wadd(x0, t0e, t3e); \
+         dct_wsub(x3, t0e, t3e); \
+         dct_wadd(x1, t1e, t2e); \
+         dct_wsub(x2, t1e, t2e); \
+         /* odd part */ \
+         dct_rot(y0o,y2o, row7,row3, rot2_0,rot2_1); \
+         dct_rot(y1o,y3o, row5,row1, rot3_0,rot3_1); \
+         __m128i sum17 = _mm_add_epi16(row1, row7); \
+         __m128i sum35 = _mm_add_epi16(row3, row5); \
+         dct_rot(y4o,y5o, sum17,sum35, rot1_0,rot1_1); \
+         dct_wadd(x4, y0o, y4o); \
+         dct_wadd(x5, y1o, y5o); \
+         dct_wadd(x6, y2o, y5o); \
+         dct_wadd(x7, y3o, y4o); \
+         dct_bfly32o(row0,row7, x0,x7,bias,shift); \
+         dct_bfly32o(row1,row6, x1,x6,bias,shift); \
+         dct_bfly32o(row2,row5, x2,x5,bias,shift); \
+         dct_bfly32o(row3,row4, x3,x4,bias,shift); \
+      }
+
+   __m128i rot0_0 = dct_const(stbi__f2f(0.5411961f), stbi__f2f(0.5411961f) + stbi__f2f(-1.847759065f));
+   __m128i rot0_1 = dct_const(stbi__f2f(0.5411961f) + stbi__f2f( 0.765366865f), stbi__f2f(0.5411961f));
+   __m128i rot1_0 = dct_const(stbi__f2f(1.175875602f) + stbi__f2f(-0.899976223f), stbi__f2f(1.175875602f));
+   __m128i rot1_1 = dct_const(stbi__f2f(1.175875602f), stbi__f2f(1.175875602f) + stbi__f2f(-2.562915447f));
+   __m128i rot2_0 = dct_const(stbi__f2f(-1.961570560f) + stbi__f2f( 0.298631336f), stbi__f2f(-1.961570560f));
+   __m128i rot2_1 = dct_const(stbi__f2f(-1.961570560f), stbi__f2f(-1.961570560f) + stbi__f2f( 3.072711026f));
+   __m128i rot3_0 = dct_const(stbi__f2f(-0.390180644f) + stbi__f2f( 2.053119869f), stbi__f2f(-0.390180644f));
+   __m128i rot3_1 = dct_const(stbi__f2f(-0.390180644f), stbi__f2f(-0.390180644f) + stbi__f2f( 1.501321110f));
+
+   // rounding biases in column/row passes, see stbi__idct_block for explanation.
+   __m128i bias_0 = _mm_set1_epi32(512);
+   __m128i bias_1 = _mm_set1_epi32(65536 + (128<<17));
+
+   // load
+   row0 = _mm_load_si128((const __m128i *) (data + 0*8));
+   row1 = _mm_load_si128((const __m128i *) (data + 1*8));
+   row2 = _mm_load_si128((const __m128i *) (data + 2*8));
+   row3 = _mm_load_si128((const __m128i *) (data + 3*8));
+   row4 = _mm_load_si128((const __m128i *) (data + 4*8));
+   row5 = _mm_load_si128((const __m128i *) (data + 5*8));
+   row6 = _mm_load_si128((const __m128i *) (data + 6*8));
+   row7 = _mm_load_si128((const __m128i *) (data + 7*8));
+
+   // column pass
+   dct_pass(bias_0, 10);
+
+   {
+      // 16bit 8x8 transpose pass 1
+      dct_interleave16(row0, row4);
+      dct_interleave16(row1, row5);
+      dct_interleave16(row2, row6);
+      dct_interleave16(row3, row7);
+
+      // transpose pass 2
+      dct_interleave16(row0, row2);
+      dct_interleave16(row1, row3);
+      dct_interleave16(row4, row6);
+      dct_interleave16(row5, row7);
+
+      // transpose pass 3
+      dct_interleave16(row0, row1);
+      dct_interleave16(row2, row3);
+      dct_interleave16(row4, row5);
+      dct_interleave16(row6, row7);
+   }
+
+   // row pass
+   dct_pass(bias_1, 17);
+
+   {
+      // pack
+      __m128i p0 = _mm_packus_epi16(row0, row1); // a0a1a2a3...a7b0b1b2b3...b7
+      __m128i p1 = _mm_packus_epi16(row2, row3);
+      __m128i p2 = _mm_packus_epi16(row4, row5);
+      __m128i p3 = _mm_packus_epi16(row6, row7);
+
+      // 8bit 8x8 transpose pass 1
+      dct_interleave8(p0, p2); // a0e0a1e1...
+      dct_interleave8(p1, p3); // c0g0c1g1...
+
+      // transpose pass 2
+      dct_interleave8(p0, p1); // a0c0e0g0...
+      dct_interleave8(p2, p3); // b0d0f0h0...
+
+      // transpose pass 3
+      dct_interleave8(p0, p2); // a0b0c0d0...
+      dct_interleave8(p1, p3); // a4b4c4d4...
+
+      // store
+      _mm_storel_epi64((__m128i *) out, p0); out += out_stride;
+      _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p0, 0x4e)); out += out_stride;
+      _mm_storel_epi64((__m128i *) out, p2); out += out_stride;
+      _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p2, 0x4e)); out += out_stride;
+      _mm_storel_epi64((__m128i *) out, p1); out += out_stride;
+      _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p1, 0x4e)); out += out_stride;
+      _mm_storel_epi64((__m128i *) out, p3); out += out_stride;
+      _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p3, 0x4e));
+   }
+
+#undef dct_const
+#undef dct_rot
+#undef dct_widen
+#undef dct_wadd
+#undef dct_wsub
+#undef dct_bfly32o
+#undef dct_interleave8
+#undef dct_interleave16
+#undef dct_pass
+}
+
+#endif // STBI_SSE2
+
+#ifdef STBI_NEON
+
+// NEON integer IDCT. should produce bit-identical
+// results to the generic C version.
+static void stbi__idct_simd(stbi_uc *out, int out_stride, short data[64])
+{
+   int16x8_t row0, row1, row2, row3, row4, row5, row6, row7;
+
+   int16x4_t rot0_0 = vdup_n_s16(stbi__f2f(0.5411961f));
+   int16x4_t rot0_1 = vdup_n_s16(stbi__f2f(-1.847759065f));
+   int16x4_t rot0_2 = vdup_n_s16(stbi__f2f( 0.765366865f));
+   int16x4_t rot1_0 = vdup_n_s16(stbi__f2f( 1.175875602f));
+   int16x4_t rot1_1 = vdup_n_s16(stbi__f2f(-0.899976223f));
+   int16x4_t rot1_2 = vdup_n_s16(stbi__f2f(-2.562915447f));
+   int16x4_t rot2_0 = vdup_n_s16(stbi__f2f(-1.961570560f));
+   int16x4_t rot2_1 = vdup_n_s16(stbi__f2f(-0.390180644f));
+   int16x4_t rot3_0 = vdup_n_s16(stbi__f2f( 0.298631336f));
+   int16x4_t rot3_1 = vdup_n_s16(stbi__f2f( 2.053119869f));
+   int16x4_t rot3_2 = vdup_n_s16(stbi__f2f( 3.072711026f));
+   int16x4_t rot3_3 = vdup_n_s16(stbi__f2f( 1.501321110f));
+
+#define dct_long_mul(out, inq, coeff) \
+   int32x4_t out##_l = vmull_s16(vget_low_s16(inq), coeff); \
+   int32x4_t out##_h = vmull_s16(vget_high_s16(inq), coeff)
+
+#define dct_long_mac(out, acc, inq, coeff) \
+   int32x4_t out##_l = vmlal_s16(acc##_l, vget_low_s16(inq), coeff); \
+   int32x4_t out##_h = vmlal_s16(acc##_h, vget_high_s16(inq), coeff)
+
+#define dct_widen(out, inq) \
+   int32x4_t out##_l = vshll_n_s16(vget_low_s16(inq), 12); \
+   int32x4_t out##_h = vshll_n_s16(vget_high_s16(inq), 12)
+
+// wide add
+#define dct_wadd(out, a, b) \
+   int32x4_t out##_l = vaddq_s32(a##_l, b##_l); \
+   int32x4_t out##_h = vaddq_s32(a##_h, b##_h)
+
+// wide sub
+#define dct_wsub(out, a, b) \
+   int32x4_t out##_l = vsubq_s32(a##_l, b##_l); \
+   int32x4_t out##_h = vsubq_s32(a##_h, b##_h)
+
+// butterfly a/b, then shift using "shiftop" by "s" and pack
+#define dct_bfly32o(out0,out1, a,b,shiftop,s) \
+   { \
+      dct_wadd(sum, a, b); \
+      dct_wsub(dif, a, b); \
+      out0 = vcombine_s16(shiftop(sum_l, s), shiftop(sum_h, s)); \
+      out1 = vcombine_s16(shiftop(dif_l, s), shiftop(dif_h, s)); \
+   }
+
+#define dct_pass(shiftop, shift) \
+   { \
+      /* even part */ \
+      int16x8_t sum26 = vaddq_s16(row2, row6); \
+      dct_long_mul(p1e, sum26, rot0_0); \
+      dct_long_mac(t2e, p1e, row6, rot0_1); \
+      dct_long_mac(t3e, p1e, row2, rot0_2); \
+      int16x8_t sum04 = vaddq_s16(row0, row4); \
+      int16x8_t dif04 = vsubq_s16(row0, row4); \
+      dct_widen(t0e, sum04); \
+      dct_widen(t1e, dif04); \
+      dct_wadd(x0, t0e, t3e); \
+      dct_wsub(x3, t0e, t3e); \
+      dct_wadd(x1, t1e, t2e); \
+      dct_wsub(x2, t1e, t2e); \
+      /* odd part */ \
+      int16x8_t sum15 = vaddq_s16(row1, row5); \
+      int16x8_t sum17 = vaddq_s16(row1, row7); \
+      int16x8_t sum35 = vaddq_s16(row3, row5); \
+      int16x8_t sum37 = vaddq_s16(row3, row7); \
+      int16x8_t sumodd = vaddq_s16(sum17, sum35); \
+      dct_long_mul(p5o, sumodd, rot1_0); \
+      dct_long_mac(p1o, p5o, sum17, rot1_1); \
+      dct_long_mac(p2o, p5o, sum35, rot1_2); \
+      dct_long_mul(p3o, sum37, rot2_0); \
+      dct_long_mul(p4o, sum15, rot2_1); \
+      dct_wadd(sump13o, p1o, p3o); \
+      dct_wadd(sump24o, p2o, p4o); \
+      dct_wadd(sump23o, p2o, p3o); \
+      dct_wadd(sump14o, p1o, p4o); \
+      dct_long_mac(x4, sump13o, row7, rot3_0); \
+      dct_long_mac(x5, sump24o, row5, rot3_1); \
+      dct_long_mac(x6, sump23o, row3, rot3_2); \
+      dct_long_mac(x7, sump14o, row1, rot3_3); \
+      dct_bfly32o(row0,row7, x0,x7,shiftop,shift); \
+      dct_bfly32o(row1,row6, x1,x6,shiftop,shift); \
+      dct_bfly32o(row2,row5, x2,x5,shiftop,shift); \
+      dct_bfly32o(row3,row4, x3,x4,shiftop,shift); \
+   }
+
+   // load
+   row0 = vld1q_s16(data + 0*8);
+   row1 = vld1q_s16(data + 1*8);
+   row2 = vld1q_s16(data + 2*8);
+   row3 = vld1q_s16(data + 3*8);
+   row4 = vld1q_s16(data + 4*8);
+   row5 = vld1q_s16(data + 5*8);
+   row6 = vld1q_s16(data + 6*8);
+   row7 = vld1q_s16(data + 7*8);
+
+   // add DC bias
+   row0 = vaddq_s16(row0, vsetq_lane_s16(1024, vdupq_n_s16(0), 0));
+
+   // column pass
+   dct_pass(vrshrn_n_s32, 10);
+
+   // 16bit 8x8 transpose
+   {
+// these three map to a single VTRN.16, VTRN.32, and VSWP, respectively.
+// whether compilers actually get this is another story, sadly.
+#define dct_trn16(x, y) { int16x8x2_t t = vtrnq_s16(x, y); x = t.val[0]; y = t.val[1]; }
+#define dct_trn32(x, y) { int32x4x2_t t = vtrnq_s32(vreinterpretq_s32_s16(x), vreinterpretq_s32_s16(y)); x = vreinterpretq_s16_s32(t.val[0]); y = vreinterpretq_s16_s32(t.val[1]); }
+#define dct_trn64(x, y) { int16x8_t x0 = x; int16x8_t y0 = y; x = vcombine_s16(vget_low_s16(x0), vget_low_s16(y0)); y = vcombine_s16(vget_high_s16(x0), vget_high_s16(y0)); }
+
+      // pass 1
+      dct_trn16(row0, row1); // a0b0a2b2a4b4a6b6
+      dct_trn16(row2, row3);
+      dct_trn16(row4, row5);
+      dct_trn16(row6, row7);
+
+      // pass 2
+      dct_trn32(row0, row2); // a0b0c0d0a4b4c4d4
+      dct_trn32(row1, row3);
+      dct_trn32(row4, row6);
+      dct_trn32(row5, row7);
+
+      // pass 3
+      dct_trn64(row0, row4); // a0b0c0d0e0f0g0h0
+      dct_trn64(row1, row5);
+      dct_trn64(row2, row6);
+      dct_trn64(row3, row7);
+
+#undef dct_trn16
+#undef dct_trn32
+#undef dct_trn64
+   }
+
+   // row pass
+   // vrshrn_n_s32 only supports shifts up to 16, we need
+   // 17. so do a non-rounding shift of 16 first then follow
+   // up with a rounding shift by 1.
+   dct_pass(vshrn_n_s32, 16);
+
+   {
+      // pack and round
+      uint8x8_t p0 = vqrshrun_n_s16(row0, 1);
+      uint8x8_t p1 = vqrshrun_n_s16(row1, 1);
+      uint8x8_t p2 = vqrshrun_n_s16(row2, 1);
+      uint8x8_t p3 = vqrshrun_n_s16(row3, 1);
+      uint8x8_t p4 = vqrshrun_n_s16(row4, 1);
+      uint8x8_t p5 = vqrshrun_n_s16(row5, 1);
+      uint8x8_t p6 = vqrshrun_n_s16(row6, 1);
+      uint8x8_t p7 = vqrshrun_n_s16(row7, 1);
+
+      // again, these can translate into one instruction, but often don't.
+#define dct_trn8_8(x, y) { uint8x8x2_t t = vtrn_u8(x, y); x = t.val[0]; y = t.val[1]; }
+#define dct_trn8_16(x, y) { uint16x4x2_t t = vtrn_u16(vreinterpret_u16_u8(x), vreinterpret_u16_u8(y)); x = vreinterpret_u8_u16(t.val[0]); y = vreinterpret_u8_u16(t.val[1]); }
+#define dct_trn8_32(x, y) { uint32x2x2_t t = vtrn_u32(vreinterpret_u32_u8(x), vreinterpret_u32_u8(y)); x = vreinterpret_u8_u32(t.val[0]); y = vreinterpret_u8_u32(t.val[1]); }
+
+      // sadly can't use interleaved stores here since we only write
+      // 8 bytes to each scan line!
+
+      // 8x8 8-bit transpose pass 1
+      dct_trn8_8(p0, p1);
+      dct_trn8_8(p2, p3);
+      dct_trn8_8(p4, p5);
+      dct_trn8_8(p6, p7);
+
+      // pass 2
+      dct_trn8_16(p0, p2);
+      dct_trn8_16(p1, p3);
+      dct_trn8_16(p4, p6);
+      dct_trn8_16(p5, p7);
+
+      // pass 3
+      dct_trn8_32(p0, p4);
+      dct_trn8_32(p1, p5);
+      dct_trn8_32(p2, p6);
+      dct_trn8_32(p3, p7);
+
+      // store
+      vst1_u8(out, p0); out += out_stride;
+      vst1_u8(out, p1); out += out_stride;
+      vst1_u8(out, p2); out += out_stride;
+      vst1_u8(out, p3); out += out_stride;
+      vst1_u8(out, p4); out += out_stride;
+      vst1_u8(out, p5); out += out_stride;
+      vst1_u8(out, p6); out += out_stride;
+      vst1_u8(out, p7);
+
+#undef dct_trn8_8
+#undef dct_trn8_16
+#undef dct_trn8_32
+   }
+
+#undef dct_long_mul
+#undef dct_long_mac
+#undef dct_widen
+#undef dct_wadd
+#undef dct_wsub
+#undef dct_bfly32o
+#undef dct_pass
+}
+
+#endif // STBI_NEON
+
+#define STBI__MARKER_none  0xff
+// if there's a pending marker from the entropy stream, return that
+// otherwise, fetch from the stream and get a marker. if there's no
+// marker, return 0xff, which is never a valid marker value
+static stbi_uc stbi__get_marker(stbi__jpeg *j)
+{
+   stbi_uc x;
+   if (j->marker != STBI__MARKER_none) { x = j->marker; j->marker = STBI__MARKER_none; return x; }
+   x = stbi__get8(j->s);
+   if (x != 0xff) return STBI__MARKER_none;
+   while (x == 0xff)
+      x = stbi__get8(j->s); // consume repeated 0xff fill bytes
+   return x;
+}
+
+// in each scan, we'll have scan_n components, and the order
+// of the components is specified by order[]
+#define STBI__RESTART(x)     ((x) >= 0xd0 && (x) <= 0xd7)
+
+// after a restart interval, stbi__jpeg_reset the entropy decoder and
+// the dc prediction
+static void stbi__jpeg_reset(stbi__jpeg *j)
+{
+   j->code_bits = 0;
+   j->code_buffer = 0;
+   j->nomore = 0;
+   j->img_comp[0].dc_pred = j->img_comp[1].dc_pred = j->img_comp[2].dc_pred = j->img_comp[3].dc_pred = 0;
+   j->marker = STBI__MARKER_none;
+   j->todo = j->restart_interval ? j->restart_interval : 0x7fffffff;
+   j->eob_run = 0;
+   // no more than 1<<31 MCUs if no restart_interal? that's plenty safe,
+   // since we don't even allow 1<<30 pixels
+}
+
+static int stbi__parse_entropy_coded_data(stbi__jpeg *z)
+{
+   stbi__jpeg_reset(z);
+   if (!z->progressive) {
+      if (z->scan_n == 1) {
+         int i,j;
+         STBI_SIMD_ALIGN(short, data[64]);
+         int n = z->order[0];
+         // non-interleaved data, we just need to process one block at a time,
+         // in trivial scanline order
+         // number of blocks to do just depends on how many actual "pixels" this
+         // component has, independent of interleaved MCU blocking and such
+         int w = (z->img_comp[n].x+7) >> 3;
+         int h = (z->img_comp[n].y+7) >> 3;
+         for (j=0; j < h; ++j) {
+            for (i=0; i < w; ++i) {
+               int ha = z->img_comp[n].ha;
+               if (!stbi__jpeg_decode_block(z, data, z->huff_dc+z->img_comp[n].hd, z->huff_ac+ha, z->fast_ac[ha], n, z->dequant[z->img_comp[n].tq])) return 0;
+               z->idct_block_kernel(z->img_comp[n].data+z->img_comp[n].w2*j*8+i*8, z->img_comp[n].w2, data);
+               // every data block is an MCU, so countdown the restart interval
+               if (--z->todo <= 0) {
+                  if (z->code_bits < 24) stbi__grow_buffer_unsafe(z);
+                  // if it's NOT a restart, then just bail, so we get corrupt data
+                  // rather than no data
+                  if (!STBI__RESTART(z->marker)) return 1;
+                  stbi__jpeg_reset(z);
+               }
+            }
+         }
+         return 1;
+      } else { // interleaved
+         int i,j,k,x,y;
+         STBI_SIMD_ALIGN(short, data[64]);
+         for (j=0; j < z->img_mcu_y; ++j) {
+            for (i=0; i < z->img_mcu_x; ++i) {
+               // scan an interleaved mcu... process scan_n components in order
+               for (k=0; k < z->scan_n; ++k) {
+                  int n = z->order[k];
+                  // scan out an mcu's worth of this component; that's just determined
+                  // by the basic H and V specified for the component
+                  for (y=0; y < z->img_comp[n].v; ++y) {
+                     for (x=0; x < z->img_comp[n].h; ++x) {
+                        int x2 = (i*z->img_comp[n].h + x)*8;
+                        int y2 = (j*z->img_comp[n].v + y)*8;
+                        int ha = z->img_comp[n].ha;
+                        if (!stbi__jpeg_decode_block(z, data, z->huff_dc+z->img_comp[n].hd, z->huff_ac+ha, z->fast_ac[ha], n, z->dequant[z->img_comp[n].tq])) return 0;
+                        z->idct_block_kernel(z->img_comp[n].data+z->img_comp[n].w2*y2+x2, z->img_comp[n].w2, data);
+                     }
+                  }
+               }
+               // after all interleaved components, that's an interleaved MCU,
+               // so now count down the restart interval
+               if (--z->todo <= 0) {
+                  if (z->code_bits < 24) stbi__grow_buffer_unsafe(z);
+                  if (!STBI__RESTART(z->marker)) return 1;
+                  stbi__jpeg_reset(z);
+               }
+            }
+         }
+         return 1;
+      }
+   } else {
+      if (z->scan_n == 1) {
+         int i,j;
+         int n = z->order[0];
+         // non-interleaved data, we just need to process one block at a time,
+         // in trivial scanline order
+         // number of blocks to do just depends on how many actual "pixels" this
+         // component has, independent of interleaved MCU blocking and such
+         int w = (z->img_comp[n].x+7) >> 3;
+         int h = (z->img_comp[n].y+7) >> 3;
+         for (j=0; j < h; ++j) {
+            for (i=0; i < w; ++i) {
+               short *data = z->img_comp[n].coeff + 64 * (i + j * z->img_comp[n].coeff_w);
+               if (z->spec_start == 0) {
+                  if (!stbi__jpeg_decode_block_prog_dc(z, data, &z->huff_dc[z->img_comp[n].hd], n))
+                     return 0;
+               } else {
+                  int ha = z->img_comp[n].ha;
+                  if (!stbi__jpeg_decode_block_prog_ac(z, data, &z->huff_ac[ha], z->fast_ac[ha]))
+                     return 0;
+               }
+               // every data block is an MCU, so countdown the restart interval
+               if (--z->todo <= 0) {
+                  if (z->code_bits < 24) stbi__grow_buffer_unsafe(z);
+                  if (!STBI__RESTART(z->marker)) return 1;
+                  stbi__jpeg_reset(z);
+               }
+            }
+         }
+         return 1;
+      } else { // interleaved
+         int i,j,k,x,y;
+         for (j=0; j < z->img_mcu_y; ++j) {
+            for (i=0; i < z->img_mcu_x; ++i) {
+               // scan an interleaved mcu... process scan_n components in order
+               for (k=0; k < z->scan_n; ++k) {
+                  int n = z->order[k];
+                  // scan out an mcu's worth of this component; that's just determined
+                  // by the basic H and V specified for the component
+                  for (y=0; y < z->img_comp[n].v; ++y) {
+                     for (x=0; x < z->img_comp[n].h; ++x) {
+                        int x2 = (i*z->img_comp[n].h + x);
+                        int y2 = (j*z->img_comp[n].v + y);
+                        short *data = z->img_comp[n].coeff + 64 * (x2 + y2 * z->img_comp[n].coeff_w);
+                        if (!stbi__jpeg_decode_block_prog_dc(z, data, &z->huff_dc[z->img_comp[n].hd], n))
+                           return 0;
+                     }
+                  }
+               }
+               // after all interleaved components, that's an interleaved MCU,
+               // so now count down the restart interval
+               if (--z->todo <= 0) {
+                  if (z->code_bits < 24) stbi__grow_buffer_unsafe(z);
+                  if (!STBI__RESTART(z->marker)) return 1;
+                  stbi__jpeg_reset(z);
+               }
+            }
+         }
+         return 1;
+      }
+   }
+}
+
+static void stbi__jpeg_dequantize(short *data, stbi__uint16 *dequant)
+{
+   int i;
+   for (i=0; i < 64; ++i)
+      data[i] *= dequant[i];
+}
+
+static void stbi__jpeg_finish(stbi__jpeg *z)
+{
+   if (z->progressive) {
+      // dequantize and idct the data
+      int i,j,n;
+      for (n=0; n < z->s->img_n; ++n) {
+         int w = (z->img_comp[n].x+7) >> 3;
+         int h = (z->img_comp[n].y+7) >> 3;
+         for (j=0; j < h; ++j) {
+            for (i=0; i < w; ++i) {
+               short *data = z->img_comp[n].coeff + 64 * (i + j * z->img_comp[n].coeff_w);
+               stbi__jpeg_dequantize(data, z->dequant[z->img_comp[n].tq]);
+               z->idct_block_kernel(z->img_comp[n].data+z->img_comp[n].w2*j*8+i*8, z->img_comp[n].w2, data);
+            }
+         }
+      }
+   }
+}
+
+static int stbi__process_marker(stbi__jpeg *z, int m)
+{
+   int L;
+   switch (m) {
+      case STBI__MARKER_none: // no marker found
+         return stbi__err("expected marker","Corrupt JPEG");
+
+      case 0xDD: // DRI - specify restart interval
+         if (stbi__get16be(z->s) != 4) return stbi__err("bad DRI len","Corrupt JPEG");
+         z->restart_interval = stbi__get16be(z->s);
+         return 1;
+
+      case 0xDB: // DQT - define quantization table
+         L = stbi__get16be(z->s)-2;
+         while (L > 0) {
+            int q = stbi__get8(z->s);
+            int p = q >> 4, sixteen = (p != 0);
+            int t = q & 15,i;
+            if (p != 0 && p != 1) return stbi__err("bad DQT type","Corrupt JPEG");
+            if (t > 3) return stbi__err("bad DQT table","Corrupt JPEG");
+
+            for (i=0; i < 64; ++i)
+               z->dequant[t][stbi__jpeg_dezigzag[i]] = (stbi__uint16)(sixteen ? stbi__get16be(z->s) : stbi__get8(z->s));
+            L -= (sixteen ? 129 : 65);
+         }
+         return L==0;
+
+      case 0xC4: // DHT - define huffman table
+         L = stbi__get16be(z->s)-2;
+         while (L > 0) {
+            stbi_uc *v;
+            int sizes[16],i,n=0;
+            int q = stbi__get8(z->s);
+            int tc = q >> 4;
+            int th = q & 15;
+            if (tc > 1 || th > 3) return stbi__err("bad DHT header","Corrupt JPEG");
+            for (i=0; i < 16; ++i) {
+               sizes[i] = stbi__get8(z->s);
+               n += sizes[i];
+            }
+            L -= 17;
+            if (tc == 0) {
+               if (!stbi__build_huffman(z->huff_dc+th, sizes)) return 0;
+               v = z->huff_dc[th].values;
+            } else {
+               if (!stbi__build_huffman(z->huff_ac+th, sizes)) return 0;
+               v = z->huff_ac[th].values;
+            }
+            for (i=0; i < n; ++i)
+               v[i] = stbi__get8(z->s);
+            if (tc != 0)
+               stbi__build_fast_ac(z->fast_ac[th], z->huff_ac + th);
+            L -= n;
+         }
+         return L==0;
+   }
+
+   // check for comment block or APP blocks
+   if ((m >= 0xE0 && m <= 0xEF) || m == 0xFE) {
+      L = stbi__get16be(z->s);
+      if (L < 2) {
+         if (m == 0xFE)
+            return stbi__err("bad COM len","Corrupt JPEG");
+         else
+            return stbi__err("bad APP len","Corrupt JPEG");
+      }
+      L -= 2;
+
+      if (m == 0xE0 && L >= 5) { // JFIF APP0 segment
+         static const unsigned char tag[5] = {'J','F','I','F','\0'};
+         int ok = 1;
+         int i;
+         for (i=0; i < 5; ++i)
+            if (stbi__get8(z->s) != tag[i])
+               ok = 0;
+         L -= 5;
+         if (ok)
+            z->jfif = 1;
+      } else if (m == 0xEE && L >= 12) { // Adobe APP14 segment
+         static const unsigned char tag[6] = {'A','d','o','b','e','\0'};
+         int ok = 1;
+         int i;
+         for (i=0; i < 6; ++i)
+            if (stbi__get8(z->s) != tag[i])
+               ok = 0;
+         L -= 6;
+         if (ok) {
+            stbi__get8(z->s); // version
+            stbi__get16be(z->s); // flags0
+            stbi__get16be(z->s); // flags1
+            z->app14_color_transform = stbi__get8(z->s); // color transform
+            L -= 6;
+         }
+      }
+
+      stbi__skip(z->s, L);
+      return 1;
+   }
+
+   return stbi__err("unknown marker","Corrupt JPEG");
+}
+
+// after we see SOS
+static int stbi__process_scan_header(stbi__jpeg *z)
+{
+   int i;
+   int Ls = stbi__get16be(z->s);
+   z->scan_n = stbi__get8(z->s);
+   if (z->scan_n < 1 || z->scan_n > 4 || z->scan_n > (int) z->s->img_n) return stbi__err("bad SOS component count","Corrupt JPEG");
+   if (Ls != 6+2*z->scan_n) return stbi__err("bad SOS len","Corrupt JPEG");
+   for (i=0; i < z->scan_n; ++i) {
+      int id = stbi__get8(z->s), which;
+      int q = stbi__get8(z->s);
+      for (which = 0; which < z->s->img_n; ++which)
+         if (z->img_comp[which].id == id)
+            break;
+      if (which == z->s->img_n) return 0; // no match
+      z->img_comp[which].hd = q >> 4;   if (z->img_comp[which].hd > 3) return stbi__err("bad DC huff","Corrupt JPEG");
+      z->img_comp[which].ha = q & 15;   if (z->img_comp[which].ha > 3) return stbi__err("bad AC huff","Corrupt JPEG");
+      z->order[i] = which;
+   }
+
+   {
+      int aa;
+      z->spec_start = stbi__get8(z->s);
+      z->spec_end   = stbi__get8(z->s); // should be 63, but might be 0
+      aa = stbi__get8(z->s);
+      z->succ_high = (aa >> 4);
+      z->succ_low  = (aa & 15);
+      if (z->progressive) {
+         if (z->spec_start > 63 || z->spec_end > 63  || z->spec_start > z->spec_end || z->succ_high > 13 || z->succ_low > 13)
+            return stbi__err("bad SOS", "Corrupt JPEG");
+      } else {
+         if (z->spec_start != 0) return stbi__err("bad SOS","Corrupt JPEG");
+         if (z->succ_high != 0 || z->succ_low != 0) return stbi__err("bad SOS","Corrupt JPEG");
+         z->spec_end = 63;
+      }
+   }
+
+   return 1;
+}
+
+static int stbi__free_jpeg_components(stbi__jpeg *z, int ncomp, int why)
+{
+   int i;
+   for (i=0; i < ncomp; ++i) {
+      if (z->img_comp[i].raw_data) {
+         STBI_FREE(z->img_comp[i].raw_data);
+         z->img_comp[i].raw_data = NULL;
+         z->img_comp[i].data = NULL;
+      }
+      if (z->img_comp[i].raw_coeff) {
+         STBI_FREE(z->img_comp[i].raw_coeff);
+         z->img_comp[i].raw_coeff = 0;
+         z->img_comp[i].coeff = 0;
+      }
+      if (z->img_comp[i].linebuf) {
+         STBI_FREE(z->img_comp[i].linebuf);
+         z->img_comp[i].linebuf = NULL;
+      }
+   }
+   return why;
+}
+
+static int stbi__process_frame_header(stbi__jpeg *z, int scan)
+{
+   stbi__context *s = z->s;
+   int Lf,p,i,q, h_max=1,v_max=1,c;
+   Lf = stbi__get16be(s);         if (Lf < 11) return stbi__err("bad SOF len","Corrupt JPEG"); // JPEG
+   p  = stbi__get8(s);            if (p != 8) return stbi__err("only 8-bit","JPEG format not supported: 8-bit only"); // JPEG baseline
+   s->img_y = stbi__get16be(s);   if (s->img_y == 0) return stbi__err("no header height", "JPEG format not supported: delayed height"); // Legal, but we don't handle it--but neither does IJG
+   s->img_x = stbi__get16be(s);   if (s->img_x == 0) return stbi__err("0 width","Corrupt JPEG"); // JPEG requires
+   c = stbi__get8(s);
+   if (c != 3 && c != 1 && c != 4) return stbi__err("bad component count","Corrupt JPEG");
+   s->img_n = c;
+   for (i=0; i < c; ++i) {
+      z->img_comp[i].data = NULL;
+      z->img_comp[i].linebuf = NULL;
+   }
+
+   if (Lf != 8+3*s->img_n) return stbi__err("bad SOF len","Corrupt JPEG");
+
+   z->rgb = 0;
+   for (i=0; i < s->img_n; ++i) {
+      static const unsigned char rgb[3] = { 'R', 'G', 'B' };
+      z->img_comp[i].id = stbi__get8(s);
+      if (s->img_n == 3 && z->img_comp[i].id == rgb[i])
+         ++z->rgb;
+      q = stbi__get8(s);
+      z->img_comp[i].h = (q >> 4);  if (!z->img_comp[i].h || z->img_comp[i].h > 4) return stbi__err("bad H","Corrupt JPEG");
+      z->img_comp[i].v = q & 15;    if (!z->img_comp[i].v || z->img_comp[i].v > 4) return stbi__err("bad V","Corrupt JPEG");
+      z->img_comp[i].tq = stbi__get8(s);  if (z->img_comp[i].tq > 3) return stbi__err("bad TQ","Corrupt JPEG");
+   }
+
+   if (scan != STBI__SCAN_load) return 1;
+
+   if (!stbi__mad3sizes_valid(s->img_x, s->img_y, s->img_n, 0)) return stbi__err("too large", "Image too large to decode");
+
+   for (i=0; i < s->img_n; ++i) {
+      if (z->img_comp[i].h > h_max) h_max = z->img_comp[i].h;
+      if (z->img_comp[i].v > v_max) v_max = z->img_comp[i].v;
+   }
+
+   // compute interleaved mcu info
+   z->img_h_max = h_max;
+   z->img_v_max = v_max;
+   z->img_mcu_w = h_max * 8;
+   z->img_mcu_h = v_max * 8;
+   // these sizes can't be more than 17 bits
+   z->img_mcu_x = (s->img_x + z->img_mcu_w-1) / z->img_mcu_w;
+   z->img_mcu_y = (s->img_y + z->img_mcu_h-1) / z->img_mcu_h;
+
+   for (i=0; i < s->img_n; ++i) {
+      // number of effective pixels (e.g. for non-interleaved MCU)
+      z->img_comp[i].x = (s->img_x * z->img_comp[i].h + h_max-1) / h_max;
+      z->img_comp[i].y = (s->img_y * z->img_comp[i].v + v_max-1) / v_max;
+      // to simplify generation, we'll allocate enough memory to decode
+      // the bogus oversized data from using interleaved MCUs and their
+      // big blocks (e.g. a 16x16 iMCU on an image of width 33); we won't
+      // discard the extra data until colorspace conversion
+      //
+      // img_mcu_x, img_mcu_y: <=17 bits; comp[i].h and .v are <=4 (checked earlier)
+      // so these muls can't overflow with 32-bit ints (which we require)
+      z->img_comp[i].w2 = z->img_mcu_x * z->img_comp[i].h * 8;
+      z->img_comp[i].h2 = z->img_mcu_y * z->img_comp[i].v * 8;
+      z->img_comp[i].coeff = 0;
+      z->img_comp[i].raw_coeff = 0;
+      z->img_comp[i].linebuf = NULL;
+      z->img_comp[i].raw_data = stbi__malloc_mad2(z->img_comp[i].w2, z->img_comp[i].h2, 15);
+      if (z->img_comp[i].raw_data == NULL)
+         return stbi__free_jpeg_components(z, i+1, stbi__err("outofmem", "Out of memory"));
+      // align blocks for idct using mmx/sse
+      z->img_comp[i].data = (stbi_uc*) (((size_t) z->img_comp[i].raw_data + 15) & ~15);
+      if (z->progressive) {
+         // w2, h2 are multiples of 8 (see above)
+         z->img_comp[i].coeff_w = z->img_comp[i].w2 / 8;
+         z->img_comp[i].coeff_h = z->img_comp[i].h2 / 8;
+         z->img_comp[i].raw_coeff = stbi__malloc_mad3(z->img_comp[i].w2, z->img_comp[i].h2, sizeof(short), 15);
+         if (z->img_comp[i].raw_coeff == NULL)
+            return stbi__free_jpeg_components(z, i+1, stbi__err("outofmem", "Out of memory"));
+         z->img_comp[i].coeff = (short*) (((size_t) z->img_comp[i].raw_coeff + 15) & ~15);
+      }
+   }
+
+   return 1;
+}
+
+// use comparisons since in some cases we handle more than one case (e.g. SOF)
+#define stbi__DNL(x)         ((x) == 0xdc)
+#define stbi__SOI(x)         ((x) == 0xd8)
+#define stbi__EOI(x)         ((x) == 0xd9)
+#define stbi__SOF(x)         ((x) == 0xc0 || (x) == 0xc1 || (x) == 0xc2)
+#define stbi__SOS(x)         ((x) == 0xda)
+
+#define stbi__SOF_progressive(x)   ((x) == 0xc2)
+
+static int stbi__decode_jpeg_header(stbi__jpeg *z, int scan)
+{
+   int m;
+   z->jfif = 0;
+   z->app14_color_transform = -1; // valid values are 0,1,2
+   z->marker = STBI__MARKER_none; // initialize cached marker to empty
+   m = stbi__get_marker(z);
+   if (!stbi__SOI(m)) return stbi__err("no SOI","Corrupt JPEG");
+   if (scan == STBI__SCAN_type) return 1;
+   m = stbi__get_marker(z);
+   while (!stbi__SOF(m)) {
+      if (!stbi__process_marker(z,m)) return 0;
+      m = stbi__get_marker(z);
+      while (m == STBI__MARKER_none) {
+         // some files have extra padding after their blocks, so ok, we'll scan
+         if (stbi__at_eof(z->s)) return stbi__err("no SOF", "Corrupt JPEG");
+         m = stbi__get_marker(z);
+      }
+   }
+   z->progressive = stbi__SOF_progressive(m);
+   if (!stbi__process_frame_header(z, scan)) return 0;
+   return 1;
+}
+
+// decode image to YCbCr format
+static int stbi__decode_jpeg_image(stbi__jpeg *j)
+{
+   int m;
+   for (m = 0; m < 4; m++) {
+      j->img_comp[m].raw_data = NULL;
+      j->img_comp[m].raw_coeff = NULL;
+   }
+   j->restart_interval = 0;
+   if (!stbi__decode_jpeg_header(j, STBI__SCAN_load)) return 0;
+   m = stbi__get_marker(j);
+   while (!stbi__EOI(m)) {
+      if (stbi__SOS(m)) {
+         if (!stbi__process_scan_header(j)) return 0;
+         if (!stbi__parse_entropy_coded_data(j)) return 0;
+         if (j->marker == STBI__MARKER_none ) {
+            // handle 0s at the end of image data from IP Kamera 9060
+            while (!stbi__at_eof(j->s)) {
+               int x = stbi__get8(j->s);
+               if (x == 255) {
+                  j->marker = stbi__get8(j->s);
+                  break;
+               }
+            }
+            // if we reach eof without hitting a marker, stbi__get_marker() below will fail and we'll eventually return 0
+         }
+      } else if (stbi__DNL(m)) {
+         int Ld = stbi__get16be(j->s);
+         stbi__uint32 NL = stbi__get16be(j->s);
+         if (Ld != 4) return stbi__err("bad DNL len", "Corrupt JPEG");
+         if (NL != j->s->img_y) return stbi__err("bad DNL height", "Corrupt JPEG");
+      } else {
+         if (!stbi__process_marker(j, m)) return 0;
+      }
+      m = stbi__get_marker(j);
+   }
+   if (j->progressive)
+      stbi__jpeg_finish(j);
+   return 1;
+}
+
+// static jfif-centered resampling (across block boundaries)
+
+typedef stbi_uc *(*resample_row_func)(stbi_uc *out, stbi_uc *in0, stbi_uc *in1,
+                                    int w, int hs);
+
+#define stbi__div4(x) ((stbi_uc) ((x) >> 2))
+
+static stbi_uc *resample_row_1(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs)
+{
+   STBI_NOTUSED(out);
+   STBI_NOTUSED(in_far);
+   STBI_NOTUSED(w);
+   STBI_NOTUSED(hs);
+   return in_near;
+}
+
+static stbi_uc* stbi__resample_row_v_2(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs)
+{
+   // need to generate two samples vertically for every one in input
+   int i;
+   STBI_NOTUSED(hs);
+   for (i=0; i < w; ++i)
+      out[i] = stbi__div4(3*in_near[i] + in_far[i] + 2);
+   return out;
+}
+
+static stbi_uc*  stbi__resample_row_h_2(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs)
+{
+   // need to generate two samples horizontally for every one in input
+   int i;
+   stbi_uc *input = in_near;
+
+   if (w == 1) {
+      // if only one sample, can't do any interpolation
+      out[0] = out[1] = input[0];
+      return out;
+   }
+
+   out[0] = input[0];
+   out[1] = stbi__div4(input[0]*3 + input[1] + 2);
+   for (i=1; i < w-1; ++i) {
+      int n = 3*input[i]+2;
+      out[i*2+0] = stbi__div4(n+input[i-1]);
+      out[i*2+1] = stbi__div4(n+input[i+1]);
+   }
+   out[i*2+0] = stbi__div4(input[w-2]*3 + input[w-1] + 2);
+   out[i*2+1] = input[w-1];
+
+   STBI_NOTUSED(in_far);
+   STBI_NOTUSED(hs);
+
+   return out;
+}
+
+#define stbi__div16(x) ((stbi_uc) ((x) >> 4))
+
+static stbi_uc *stbi__resample_row_hv_2(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs)
+{
+   // need to generate 2x2 samples for every one in input
+   int i,t0,t1;
+   if (w == 1) {
+      out[0] = out[1] = stbi__div4(3*in_near[0] + in_far[0] + 2);
+      return out;
+   }
+
+   t1 = 3*in_near[0] + in_far[0];
+   out[0] = stbi__div4(t1+2);
+   for (i=1; i < w; ++i) {
+      t0 = t1;
+      t1 = 3*in_near[i]+in_far[i];
+      out[i*2-1] = stbi__div16(3*t0 + t1 + 8);
+      out[i*2  ] = stbi__div16(3*t1 + t0 + 8);
+   }
+   out[w*2-1] = stbi__div4(t1+2);
+
+   STBI_NOTUSED(hs);
+
+   return out;
+}
+
+#if defined(STBI_SSE2) || defined(STBI_NEON)
+static stbi_uc *stbi__resample_row_hv_2_simd(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs)
+{
+   // need to generate 2x2 samples for every one in input
+   int i=0,t0,t1;
+
+   if (w == 1) {
+      out[0] = out[1] = stbi__div4(3*in_near[0] + in_far[0] + 2);
+      return out;
+   }
+
+   t1 = 3*in_near[0] + in_far[0];
+   // process groups of 8 pixels for as long as we can.
+   // note we can't handle the last pixel in a row in this loop
+   // because we need to handle the filter boundary conditions.
+   for (; i < ((w-1) & ~7); i += 8) {
+#if defined(STBI_SSE2)
+      // load and perform the vertical filtering pass
+      // this uses 3*x + y = 4*x + (y - x)
+      __m128i zero  = _mm_setzero_si128();
+      __m128i farb  = _mm_loadl_epi64((__m128i *) (in_far + i));
+      __m128i nearb = _mm_loadl_epi64((__m128i *) (in_near + i));
+      __m128i farw  = _mm_unpacklo_epi8(farb, zero);
+      __m128i nearw = _mm_unpacklo_epi8(nearb, zero);
+      __m128i diff  = _mm_sub_epi16(farw, nearw);
+      __m128i nears = _mm_slli_epi16(nearw, 2);
+      __m128i curr  = _mm_add_epi16(nears, diff); // current row
+
+      // horizontal filter works the same based on shifted vers of current
+      // row. "prev" is current row shifted right by 1 pixel; we need to
+      // insert the previous pixel value (from t1).
+      // "next" is current row shifted left by 1 pixel, with first pixel
+      // of next block of 8 pixels added in.
+      __m128i prv0 = _mm_slli_si128(curr, 2);
+      __m128i nxt0 = _mm_srli_si128(curr, 2);
+      __m128i prev = _mm_insert_epi16(prv0, t1, 0);
+      __m128i next = _mm_insert_epi16(nxt0, 3*in_near[i+8] + in_far[i+8], 7);
+
+      // horizontal filter, polyphase implementation since it's convenient:
+      // even pixels = 3*cur + prev = cur*4 + (prev - cur)
+      // odd  pixels = 3*cur + next = cur*4 + (next - cur)
+      // note the shared term.
+      __m128i bias  = _mm_set1_epi16(8);
+      __m128i curs = _mm_slli_epi16(curr, 2);
+      __m128i prvd = _mm_sub_epi16(prev, curr);
+      __m128i nxtd = _mm_sub_epi16(next, curr);
+      __m128i curb = _mm_add_epi16(curs, bias);
+      __m128i even = _mm_add_epi16(prvd, curb);
+      __m128i odd  = _mm_add_epi16(nxtd, curb);
+
+      // interleave even and odd pixels, then undo scaling.
+      __m128i int0 = _mm_unpacklo_epi16(even, odd);
+      __m128i int1 = _mm_unpackhi_epi16(even, odd);
+      __m128i de0  = _mm_srli_epi16(int0, 4);
+      __m128i de1  = _mm_srli_epi16(int1, 4);
+
+      // pack and write output
+      __m128i outv = _mm_packus_epi16(de0, de1);
+      _mm_storeu_si128((__m128i *) (out + i*2), outv);
+#elif defined(STBI_NEON)
+      // load and perform the vertical filtering pass
+      // this uses 3*x + y = 4*x + (y - x)
+      uint8x8_t farb  = vld1_u8(in_far + i);
+      uint8x8_t nearb = vld1_u8(in_near + i);
+      int16x8_t diff  = vreinterpretq_s16_u16(vsubl_u8(farb, nearb));
+      int16x8_t nears = vreinterpretq_s16_u16(vshll_n_u8(nearb, 2));
+      int16x8_t curr  = vaddq_s16(nears, diff); // current row
+
+      // horizontal filter works the same based on shifted vers of current
+      // row. "prev" is current row shifted right by 1 pixel; we need to
+      // insert the previous pixel value (from t1).
+      // "next" is current row shifted left by 1 pixel, with first pixel
+      // of next block of 8 pixels added in.
+      int16x8_t prv0 = vextq_s16(curr, curr, 7);
+      int16x8_t nxt0 = vextq_s16(curr, curr, 1);
+      int16x8_t prev = vsetq_lane_s16(t1, prv0, 0);
+      int16x8_t next = vsetq_lane_s16(3*in_near[i+8] + in_far[i+8], nxt0, 7);
+
+      // horizontal filter, polyphase implementation since it's convenient:
+      // even pixels = 3*cur + prev = cur*4 + (prev - cur)
+      // odd  pixels = 3*cur + next = cur*4 + (next - cur)
+      // note the shared term.
+      int16x8_t curs = vshlq_n_s16(curr, 2);
+      int16x8_t prvd = vsubq_s16(prev, curr);
+      int16x8_t nxtd = vsubq_s16(next, curr);
+      int16x8_t even = vaddq_s16(curs, prvd);
+      int16x8_t odd  = vaddq_s16(curs, nxtd);
+
+      // undo scaling and round, then store with even/odd phases interleaved
+      uint8x8x2_t o;
+      o.val[0] = vqrshrun_n_s16(even, 4);
+      o.val[1] = vqrshrun_n_s16(odd,  4);
+      vst2_u8(out + i*2, o);
+#endif
+
+      // "previous" value for next iter
+      t1 = 3*in_near[i+7] + in_far[i+7];
+   }
+
+   t0 = t1;
+   t1 = 3*in_near[i] + in_far[i];
+   out[i*2] = stbi__div16(3*t1 + t0 + 8);
+
+   for (++i; i < w; ++i) {
+      t0 = t1;
+      t1 = 3*in_near[i]+in_far[i];
+      out[i*2-1] = stbi__div16(3*t0 + t1 + 8);
+      out[i*2  ] = stbi__div16(3*t1 + t0 + 8);
+   }
+   out[w*2-1] = stbi__div4(t1+2);
+
+   STBI_NOTUSED(hs);
+
+   return out;
+}
+#endif
+
+static stbi_uc *stbi__resample_row_generic(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs)
+{
+   // resample with nearest-neighbor
+   int i,j;
+   STBI_NOTUSED(in_far);
+   for (i=0; i < w; ++i)
+      for (j=0; j < hs; ++j)
+         out[i*hs+j] = in_near[i];
+   return out;
+}
+
+// this is a reduced-precision calculation of YCbCr-to-RGB introduced
+// to make sure the code produces the same results in both SIMD and scalar
+#define stbi__float2fixed(x)  (((int) ((x) * 4096.0f + 0.5f)) << 8)
+static void stbi__YCbCr_to_RGB_row(stbi_uc *out, const stbi_uc *y, const stbi_uc *pcb, const stbi_uc *pcr, int count, int step)
+{
+   int i;
+   for (i=0; i < count; ++i) {
+      int y_fixed = (y[i] << 20) + (1<<19); // rounding
+      int r,g,b;
+      int cr = pcr[i] - 128;
+      int cb = pcb[i] - 128;
+      r = y_fixed +  cr* stbi__float2fixed(1.40200f);
+      g = y_fixed + (cr*-stbi__float2fixed(0.71414f)) + ((cb*-stbi__float2fixed(0.34414f)) & 0xffff0000);
+      b = y_fixed                                     +   cb* stbi__float2fixed(1.77200f);
+      r >>= 20;
+      g >>= 20;
+      b >>= 20;
+      if ((unsigned) r > 255) { if (r < 0) r = 0; else r = 255; }
+      if ((unsigned) g > 255) { if (g < 0) g = 0; else g = 255; }
+      if ((unsigned) b > 255) { if (b < 0) b = 0; else b = 255; }
+      out[0] = (stbi_uc)r;
+      out[1] = (stbi_uc)g;
+      out[2] = (stbi_uc)b;
+      out[3] = 255;
+      out += step;
+   }
+}
+
+#if defined(STBI_SSE2) || defined(STBI_NEON)
+static void stbi__YCbCr_to_RGB_simd(stbi_uc *out, stbi_uc const *y, stbi_uc const *pcb, stbi_uc const *pcr, int count, int step)
+{
+   int i = 0;
+
+#ifdef STBI_SSE2
+   // step == 3 is pretty ugly on the final interleave, and i'm not convinced
+   // it's useful in practice (you wouldn't use it for textures, for example).
+   // so just accelerate step == 4 case.
+   if (step == 4) {
+      // this is a fairly straightforward implementation and not super-optimized.
+      __m128i signflip  = _mm_set1_epi8(-0x80);
+      __m128i cr_const0 = _mm_set1_epi16(   (short) ( 1.40200f*4096.0f+0.5f));
+      __m128i cr_const1 = _mm_set1_epi16( - (short) ( 0.71414f*4096.0f+0.5f));
+      __m128i cb_const0 = _mm_set1_epi16( - (short) ( 0.34414f*4096.0f+0.5f));
+      __m128i cb_const1 = _mm_set1_epi16(   (short) ( 1.77200f*4096.0f+0.5f));
+      __m128i y_bias = _mm_set1_epi8((char) (unsigned char) 128);
+      __m128i xw = _mm_set1_epi16(255); // alpha channel
+
+      for (; i+7 < count; i += 8) {
+         // load
+         __m128i y_bytes = _mm_loadl_epi64((__m128i *) (y+i));
+         __m128i cr_bytes = _mm_loadl_epi64((__m128i *) (pcr+i));
+         __m128i cb_bytes = _mm_loadl_epi64((__m128i *) (pcb+i));
+         __m128i cr_biased = _mm_xor_si128(cr_bytes, signflip); // -128
+         __m128i cb_biased = _mm_xor_si128(cb_bytes, signflip); // -128
+
+         // unpack to short (and left-shift cr, cb by 8)
+         __m128i yw  = _mm_unpacklo_epi8(y_bias, y_bytes);
+         __m128i crw = _mm_unpacklo_epi8(_mm_setzero_si128(), cr_biased);
+         __m128i cbw = _mm_unpacklo_epi8(_mm_setzero_si128(), cb_biased);
+
+         // color transform
+         __m128i yws = _mm_srli_epi16(yw, 4);
+         __m128i cr0 = _mm_mulhi_epi16(cr_const0, crw);
+         __m128i cb0 = _mm_mulhi_epi16(cb_const0, cbw);
+         __m128i cb1 = _mm_mulhi_epi16(cbw, cb_const1);
+         __m128i cr1 = _mm_mulhi_epi16(crw, cr_const1);
+         __m128i rws = _mm_add_epi16(cr0, yws);
+         __m128i gwt = _mm_add_epi16(cb0, yws);
+         __m128i bws = _mm_add_epi16(yws, cb1);
+         __m128i gws = _mm_add_epi16(gwt, cr1);
+
+         // descale
+         __m128i rw = _mm_srai_epi16(rws, 4);
+         __m128i bw = _mm_srai_epi16(bws, 4);
+         __m128i gw = _mm_srai_epi16(gws, 4);
+
+         // back to byte, set up for transpose
+         __m128i brb = _mm_packus_epi16(rw, bw);
+         __m128i gxb = _mm_packus_epi16(gw, xw);
+
+         // transpose to interleave channels
+         __m128i t0 = _mm_unpacklo_epi8(brb, gxb);
+         __m128i t1 = _mm_unpackhi_epi8(brb, gxb);
+         __m128i o0 = _mm_unpacklo_epi16(t0, t1);
+         __m128i o1 = _mm_unpackhi_epi16(t0, t1);
+
+         // store
+         _mm_storeu_si128((__m128i *) (out + 0), o0);
+         _mm_storeu_si128((__m128i *) (out + 16), o1);
+         out += 32;
+      }
+   }
+#endif
+
+#ifdef STBI_NEON
+   // in this version, step=3 support would be easy to add. but is there demand?
+   if (step == 4) {
+      // this is a fairly straightforward implementation and not super-optimized.
+      uint8x8_t signflip = vdup_n_u8(0x80);
+      int16x8_t cr_const0 = vdupq_n_s16(   (short) ( 1.40200f*4096.0f+0.5f));
+      int16x8_t cr_const1 = vdupq_n_s16( - (short) ( 0.71414f*4096.0f+0.5f));
+      int16x8_t cb_const0 = vdupq_n_s16( - (short) ( 0.34414f*4096.0f+0.5f));
+      int16x8_t cb_const1 = vdupq_n_s16(   (short) ( 1.77200f*4096.0f+0.5f));
+
+      for (; i+7 < count; i += 8) {
+         // load
+         uint8x8_t y_bytes  = vld1_u8(y + i);
+         uint8x8_t cr_bytes = vld1_u8(pcr + i);
+         uint8x8_t cb_bytes = vld1_u8(pcb + i);
+         int8x8_t cr_biased = vreinterpret_s8_u8(vsub_u8(cr_bytes, signflip));
+         int8x8_t cb_biased = vreinterpret_s8_u8(vsub_u8(cb_bytes, signflip));
+
+         // expand to s16
+         int16x8_t yws = vreinterpretq_s16_u16(vshll_n_u8(y_bytes, 4));
+         int16x8_t crw = vshll_n_s8(cr_biased, 7);
+         int16x8_t cbw = vshll_n_s8(cb_biased, 7);
+
+         // color transform
+         int16x8_t cr0 = vqdmulhq_s16(crw, cr_const0);
+         int16x8_t cb0 = vqdmulhq_s16(cbw, cb_const0);
+         int16x8_t cr1 = vqdmulhq_s16(crw, cr_const1);
+         int16x8_t cb1 = vqdmulhq_s16(cbw, cb_const1);
+         int16x8_t rws = vaddq_s16(yws, cr0);
+         int16x8_t gws = vaddq_s16(vaddq_s16(yws, cb0), cr1);
+         int16x8_t bws = vaddq_s16(yws, cb1);
+
+         // undo scaling, round, convert to byte
+         uint8x8x4_t o;
+         o.val[0] = vqrshrun_n_s16(rws, 4);
+         o.val[1] = vqrshrun_n_s16(gws, 4);
+         o.val[2] = vqrshrun_n_s16(bws, 4);
+         o.val[3] = vdup_n_u8(255);
+
+         // store, interleaving r/g/b/a
+         vst4_u8(out, o);
+         out += 8*4;
+      }
+   }
+#endif
+
+   for (; i < count; ++i) {
+      int y_fixed = (y[i] << 20) + (1<<19); // rounding
+      int r,g,b;
+      int cr = pcr[i] - 128;
+      int cb = pcb[i] - 128;
+      r = y_fixed + cr* stbi__float2fixed(1.40200f);
+      g = y_fixed + cr*-stbi__float2fixed(0.71414f) + ((cb*-stbi__float2fixed(0.34414f)) & 0xffff0000);
+      b = y_fixed                                   +   cb* stbi__float2fixed(1.77200f);
+      r >>= 20;
+      g >>= 20;
+      b >>= 20;
+      if ((unsigned) r > 255) { if (r < 0) r = 0; else r = 255; }
+      if ((unsigned) g > 255) { if (g < 0) g = 0; else g = 255; }
+      if ((unsigned) b > 255) { if (b < 0) b = 0; else b = 255; }
+      out[0] = (stbi_uc)r;
+      out[1] = (stbi_uc)g;
+      out[2] = (stbi_uc)b;
+      out[3] = 255;
+      out += step;
+   }
+}
+#endif
+
+// set up the kernels
+static void stbi__setup_jpeg(stbi__jpeg *j)
+{
+   j->idct_block_kernel = stbi__idct_block;
+   j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_row;
+   j->resample_row_hv_2_kernel = stbi__resample_row_hv_2;
+
+#ifdef STBI_SSE2
+   if (stbi__sse2_available()) {
+      j->idct_block_kernel = stbi__idct_simd;
+      j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_simd;
+      j->resample_row_hv_2_kernel = stbi__resample_row_hv_2_simd;
+   }
+#endif
+
+#ifdef STBI_NEON
+   j->idct_block_kernel = stbi__idct_simd;
+   j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_simd;
+   j->resample_row_hv_2_kernel = stbi__resample_row_hv_2_simd;
+#endif
+}
+
+// clean up the temporary component buffers
+static void stbi__cleanup_jpeg(stbi__jpeg *j)
+{
+   stbi__free_jpeg_components(j, j->s->img_n, 0);
+}
+
+typedef struct
+{
+   resample_row_func resample;
+   stbi_uc *line0,*line1;
+   int hs,vs;   // expansion factor in each axis
+   int w_lores; // horizontal pixels pre-expansion
+   int ystep;   // how far through vertical expansion we are
+   int ypos;    // which pre-expansion row we're on
+} stbi__resample;
+
+// fast 0..255 * 0..255 => 0..255 rounded multiplication
+static stbi_uc stbi__blinn_8x8(stbi_uc x, stbi_uc y)
+{
+   unsigned int t = x*y + 128;
+   return (stbi_uc) ((t + (t >>8)) >> 8);
+}
+
+static stbi_uc *load_jpeg_image(stbi__jpeg *z, int *out_x, int *out_y, int *comp, int req_comp)
+{
+   int n, decode_n, is_rgb;
+   z->s->img_n = 0; // make stbi__cleanup_jpeg safe
+
+   // validate req_comp
+   if (req_comp < 0 || req_comp > 4) return stbi__errpuc("bad req_comp", "Internal error");
+
+   // load a jpeg image from whichever source, but leave in YCbCr format
+   if (!stbi__decode_jpeg_image(z)) { stbi__cleanup_jpeg(z); return NULL; }
+
+   // determine actual number of components to generate
+   n = req_comp ? req_comp : z->s->img_n >= 3 ? 3 : 1;
+
+   is_rgb = z->s->img_n == 3 && (z->rgb == 3 || (z->app14_color_transform == 0 && !z->jfif));
+
+   if (z->s->img_n == 3 && n < 3 && !is_rgb)
+      decode_n = 1;
+   else
+      decode_n = z->s->img_n;
+
+   // resample and color-convert
+   {
+      int k;
+      unsigned int i,j;
+      stbi_uc *output;
+      stbi_uc *coutput[4] = { NULL, NULL, NULL, NULL };
+
+      stbi__resample res_comp[4];
+
+      for (k=0; k < decode_n; ++k) {
+         stbi__resample *r = &res_comp[k];
+
+         // allocate line buffer big enough for upsampling off the edges
+         // with upsample factor of 4
+         z->img_comp[k].linebuf = (stbi_uc *) stbi__malloc(z->s->img_x + 3);
+         if (!z->img_comp[k].linebuf) { stbi__cleanup_jpeg(z); return stbi__errpuc("outofmem", "Out of memory"); }
+
+         r->hs      = z->img_h_max / z->img_comp[k].h;
+         r->vs      = z->img_v_max / z->img_comp[k].v;
+         r->ystep   = r->vs >> 1;
+         r->w_lores = (z->s->img_x + r->hs-1) / r->hs;
+         r->ypos    = 0;
+         r->line0   = r->line1 = z->img_comp[k].data;
+
+         if      (r->hs == 1 && r->vs == 1) r->resample = resample_row_1;
+         else if (r->hs == 1 && r->vs == 2) r->resample = stbi__resample_row_v_2;
+         else if (r->hs == 2 && r->vs == 1) r->resample = stbi__resample_row_h_2;
+         else if (r->hs == 2 && r->vs == 2) r->resample = z->resample_row_hv_2_kernel;
+         else                               r->resample = stbi__resample_row_generic;
+      }
+
+      // can't error after this so, this is safe
+      output = (stbi_uc *) stbi__malloc_mad3(n, z->s->img_x, z->s->img_y, 1);
+      if (!output) { stbi__cleanup_jpeg(z); return stbi__errpuc("outofmem", "Out of memory"); }
+
+      // now go ahead and resample
+      for (j=0; j < z->s->img_y; ++j) {
+         stbi_uc *out = output + n * z->s->img_x * j;
+         for (k=0; k < decode_n; ++k) {
+            stbi__resample *r = &res_comp[k];
+            int y_bot = r->ystep >= (r->vs >> 1);
+            coutput[k] = r->resample(z->img_comp[k].linebuf,
+                                     y_bot ? r->line1 : r->line0,
+                                     y_bot ? r->line0 : r->line1,
+                                     r->w_lores, r->hs);
+            if (++r->ystep >= r->vs) {
+               r->ystep = 0;
+               r->line0 = r->line1;
+               if (++r->ypos < z->img_comp[k].y)
+                  r->line1 += z->img_comp[k].w2;
+            }
+         }
+         if (n >= 3) {
+            stbi_uc *y = coutput[0];
+            if (z->s->img_n == 3) {
+               if (is_rgb) {
+                  for (i=0; i < z->s->img_x; ++i) {
+                     out[0] = y[i];
+                     out[1] = coutput[1][i];
+                     out[2] = coutput[2][i];
+                     out[3] = 255;
+                     out += n;
+                  }
+               } else {
+                  z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n);
+               }
+            } else if (z->s->img_n == 4) {
+               if (z->app14_color_transform == 0) { // CMYK
+                  for (i=0; i < z->s->img_x; ++i) {
+                     stbi_uc m = coutput[3][i];
+                     out[0] = stbi__blinn_8x8(coutput[0][i], m);
+                     out[1] = stbi__blinn_8x8(coutput[1][i], m);
+                     out[2] = stbi__blinn_8x8(coutput[2][i], m);
+                     out[3] = 255;
+                     out += n;
+                  }
+               } else if (z->app14_color_transform == 2) { // YCCK
+                  z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n);
+                  for (i=0; i < z->s->img_x; ++i) {
+                     stbi_uc m = coutput[3][i];
+                     out[0] = stbi__blinn_8x8(255 - out[0], m);
+                     out[1] = stbi__blinn_8x8(255 - out[1], m);
+                     out[2] = stbi__blinn_8x8(255 - out[2], m);
+                     out += n;
+                  }
+               } else { // YCbCr + alpha?  Ignore the fourth channel for now
+                  z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n);
+               }
+            } else
+               for (i=0; i < z->s->img_x; ++i) {
+                  out[0] = out[1] = out[2] = y[i];
+                  out[3] = 255; // not used if n==3
+                  out += n;
+               }
+         } else {
+            if (is_rgb) {
+               if (n == 1)
+                  for (i=0; i < z->s->img_x; ++i)
+                     *out++ = stbi__compute_y(coutput[0][i], coutput[1][i], coutput[2][i]);
+               else {
+                  for (i=0; i < z->s->img_x; ++i, out += 2) {
+                     out[0] = stbi__compute_y(coutput[0][i], coutput[1][i], coutput[2][i]);
+                     out[1] = 255;
+                  }
+               }
+            } else if (z->s->img_n == 4 && z->app14_color_transform == 0) {
+               for (i=0; i < z->s->img_x; ++i) {
+                  stbi_uc m = coutput[3][i];
+                  stbi_uc r = stbi__blinn_8x8(coutput[0][i], m);
+                  stbi_uc g = stbi__blinn_8x8(coutput[1][i], m);
+                  stbi_uc b = stbi__blinn_8x8(coutput[2][i], m);
+                  out[0] = stbi__compute_y(r, g, b);
+                  out[1] = 255;
+                  out += n;
+               }
+            } else if (z->s->img_n == 4 && z->app14_color_transform == 2) {
+               for (i=0; i < z->s->img_x; ++i) {
+                  out[0] = stbi__blinn_8x8(255 - coutput[0][i], coutput[3][i]);
+                  out[1] = 255;
+                  out += n;
+               }
+            } else {
+               stbi_uc *y = coutput[0];
+               if (n == 1)
+                  for (i=0; i < z->s->img_x; ++i) out[i] = y[i];
+               else
+                  for (i=0; i < z->s->img_x; ++i) { *out++ = y[i]; *out++ = 255; }
+            }
+         }
+      }
+      stbi__cleanup_jpeg(z);
+      *out_x = z->s->img_x;
+      *out_y = z->s->img_y;
+      if (comp) *comp = z->s->img_n >= 3 ? 3 : 1; // report original components, not output
+      return output;
+   }
+}
+
+static void *stbi__jpeg_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri)
+{
+   unsigned char* result;
+   stbi__jpeg* j = (stbi__jpeg*) stbi__malloc(sizeof(stbi__jpeg));
+   STBI_NOTUSED(ri);
+   j->s = s;
+   stbi__setup_jpeg(j);
+   result = load_jpeg_image(j, x,y,comp,req_comp);
+   STBI_FREE(j);
+   return result;
+}
+
+static int stbi__jpeg_test(stbi__context *s)
+{
+   int r;
+   stbi__jpeg* j = (stbi__jpeg*)stbi__malloc(sizeof(stbi__jpeg));
+   j->s = s;
+   stbi__setup_jpeg(j);
+   r = stbi__decode_jpeg_header(j, STBI__SCAN_type);
+   stbi__rewind(s);
+   STBI_FREE(j);
+   return r;
+}
+
+static int stbi__jpeg_info_raw(stbi__jpeg *j, int *x, int *y, int *comp)
+{
+   if (!stbi__decode_jpeg_header(j, STBI__SCAN_header)) {
+      stbi__rewind( j->s );
+      return 0;
+   }
+   if (x) *x = j->s->img_x;
+   if (y) *y = j->s->img_y;
+   if (comp) *comp = j->s->img_n >= 3 ? 3 : 1;
+   return 1;
+}
+
+static int stbi__jpeg_info(stbi__context *s, int *x, int *y, int *comp)
+{
+   int result;
+   stbi__jpeg* j = (stbi__jpeg*) (stbi__malloc(sizeof(stbi__jpeg)));
+   j->s = s;
+   result = stbi__jpeg_info_raw(j, x, y, comp);
+   STBI_FREE(j);
+   return result;
+}
+#endif
+
+// public domain zlib decode    v0.2  Sean Barrett 2006-11-18
+//    simple implementation
+//      - all input must be provided in an upfront buffer
+//      - all output is written to a single output buffer (can malloc/realloc)
+//    performance
+//      - fast huffman
+
+#ifndef STBI_NO_ZLIB
+
+// fast-way is faster to check than jpeg huffman, but slow way is slower
+#define STBI__ZFAST_BITS  9 // accelerate all cases in default tables
+#define STBI__ZFAST_MASK  ((1 << STBI__ZFAST_BITS) - 1)
+
+// zlib-style huffman encoding
+// (jpegs packs from left, zlib from right, so can't share code)
+typedef struct
+{
+   stbi__uint16 fast[1 << STBI__ZFAST_BITS];
+   stbi__uint16 firstcode[16];
+   int maxcode[17];
+   stbi__uint16 firstsymbol[16];
+   stbi_uc  size[288];
+   stbi__uint16 value[288];
+} stbi__zhuffman;
+
+stbi_inline static int stbi__bitreverse16(int n)
+{
+  n = ((n & 0xAAAA) >>  1) | ((n & 0x5555) << 1);
+  n = ((n & 0xCCCC) >>  2) | ((n & 0x3333) << 2);
+  n = ((n & 0xF0F0) >>  4) | ((n & 0x0F0F) << 4);
+  n = ((n & 0xFF00) >>  8) | ((n & 0x00FF) << 8);
+  return n;
+}
+
+stbi_inline static int stbi__bit_reverse(int v, int bits)
+{
+   STBI_ASSERT(bits <= 16);
+   // to bit reverse n bits, reverse 16 and shift
+   // e.g. 11 bits, bit reverse and shift away 5
+   return stbi__bitreverse16(v) >> (16-bits);
+}
+
+static int stbi__zbuild_huffman(stbi__zhuffman *z, const stbi_uc *sizelist, int num)
+{
+   int i,k=0;
+   int code, next_code[16], sizes[17];
+
+   // DEFLATE spec for generating codes
+   memset(sizes, 0, sizeof(sizes));
+   memset(z->fast, 0, sizeof(z->fast));
+   for (i=0; i < num; ++i)
+      ++sizes[sizelist[i]];
+   sizes[0] = 0;
+   for (i=1; i < 16; ++i)
+      if (sizes[i] > (1 << i))
+         return stbi__err("bad sizes", "Corrupt PNG");
+   code = 0;
+   for (i=1; i < 16; ++i) {
+      next_code[i] = code;
+      z->firstcode[i] = (stbi__uint16) code;
+      z->firstsymbol[i] = (stbi__uint16) k;
+      code = (code + sizes[i]);
+      if (sizes[i])
+         if (code-1 >= (1 << i)) return stbi__err("bad codelengths","Corrupt PNG");
+      z->maxcode[i] = code << (16-i); // preshift for inner loop
+      code <<= 1;
+      k += sizes[i];
+   }
+   z->maxcode[16] = 0x10000; // sentinel
+   for (i=0; i < num; ++i) {
+      int s = sizelist[i];
+      if (s) {
+         int c = next_code[s] - z->firstcode[s] + z->firstsymbol[s];
+         stbi__uint16 fastv = (stbi__uint16) ((s << 9) | i);
+         z->size [c] = (stbi_uc     ) s;
+         z->value[c] = (stbi__uint16) i;
+         if (s <= STBI__ZFAST_BITS) {
+            int j = stbi__bit_reverse(next_code[s],s);
+            while (j < (1 << STBI__ZFAST_BITS)) {
+               z->fast[j] = fastv;
+               j += (1 << s);
+            }
+         }
+         ++next_code[s];
+      }
+   }
+   return 1;
+}
+
+// zlib-from-memory implementation for PNG reading
+//    because PNG allows splitting the zlib stream arbitrarily,
+//    and it's annoying structurally to have PNG call ZLIB call PNG,
+//    we require PNG read all the IDATs and combine them into a single
+//    memory buffer
+
+typedef struct
+{
+   stbi_uc *zbuffer, *zbuffer_end;
+   int num_bits;
+   stbi__uint32 code_buffer;
+
+   char *zout;
+   char *zout_start;
+   char *zout_end;
+   int   z_expandable;
+
+   stbi__zhuffman z_length, z_distance;
+} stbi__zbuf;
+
+stbi_inline static stbi_uc stbi__zget8(stbi__zbuf *z)
+{
+   if (z->zbuffer >= z->zbuffer_end) return 0;
+   return *z->zbuffer++;
+}
+
+static void stbi__fill_bits(stbi__zbuf *z)
+{
+   do {
+      STBI_ASSERT(z->code_buffer < (1U << z->num_bits));
+      z->code_buffer |= (unsigned int) stbi__zget8(z) << z->num_bits;
+      z->num_bits += 8;
+   } while (z->num_bits <= 24);
+}
+
+stbi_inline static unsigned int stbi__zreceive(stbi__zbuf *z, int n)
+{
+   unsigned int k;
+   if (z->num_bits < n) stbi__fill_bits(z);
+   k = z->code_buffer & ((1 << n) - 1);
+   z->code_buffer >>= n;
+   z->num_bits -= n;
+   return k;
+}
+
+static int stbi__zhuffman_decode_slowpath(stbi__zbuf *a, stbi__zhuffman *z)
+{
+   int b,s,k;
+   // not resolved by fast table, so compute it the slow way
+   // use jpeg approach, which requires MSbits at top
+   k = stbi__bit_reverse(a->code_buffer, 16);
+   for (s=STBI__ZFAST_BITS+1; ; ++s)
+      if (k < z->maxcode[s])
+         break;
+   if (s == 16) return -1; // invalid code!
+   // code size is s, so:
+   b = (k >> (16-s)) - z->firstcode[s] + z->firstsymbol[s];
+   STBI_ASSERT(z->size[b] == s);
+   a->code_buffer >>= s;
+   a->num_bits -= s;
+   return z->value[b];
+}
+
+stbi_inline static int stbi__zhuffman_decode(stbi__zbuf *a, stbi__zhuffman *z)
+{
+   int b,s;
+   if (a->num_bits < 16) stbi__fill_bits(a);
+   b = z->fast[a->code_buffer & STBI__ZFAST_MASK];
+   if (b) {
+      s = b >> 9;
+      a->code_buffer >>= s;
+      a->num_bits -= s;
+      return b & 511;
+   }
+   return stbi__zhuffman_decode_slowpath(a, z);
+}
+
+static int stbi__zexpand(stbi__zbuf *z, char *zout, int n)  // need to make room for n bytes
+{
+   char *q;
+   int cur, limit, old_limit;
+   z->zout = zout;
+   if (!z->z_expandable) return stbi__err("output buffer limit","Corrupt PNG");
+   cur   = (int) (z->zout     - z->zout_start);
+   limit = old_limit = (int) (z->zout_end - z->zout_start);
+   while (cur + n > limit)
+      limit *= 2;
+   q = (char *) STBI_REALLOC_SIZED(z->zout_start, old_limit, limit);
+   STBI_NOTUSED(old_limit);
+   if (q == NULL) return stbi__err("outofmem", "Out of memory");
+   z->zout_start = q;
+   z->zout       = q + cur;
+   z->zout_end   = q + limit;
+   return 1;
+}
+
+static const int stbi__zlength_base[31] = {
+   3,4,5,6,7,8,9,10,11,13,
+   15,17,19,23,27,31,35,43,51,59,
+   67,83,99,115,131,163,195,227,258,0,0 };
+
+static const int stbi__zlength_extra[31]=
+{ 0,0,0,0,0,0,0,0,1,1,1,1,2,2,2,2,3,3,3,3,4,4,4,4,5,5,5,5,0,0,0 };
+
+static const int stbi__zdist_base[32] = { 1,2,3,4,5,7,9,13,17,25,33,49,65,97,129,193,
+257,385,513,769,1025,1537,2049,3073,4097,6145,8193,12289,16385,24577,0,0};
+
+static const int stbi__zdist_extra[32] =
+{ 0,0,0,0,1,1,2,2,3,3,4,4,5,5,6,6,7,7,8,8,9,9,10,10,11,11,12,12,13,13};
+
+static int stbi__parse_huffman_block(stbi__zbuf *a)
+{
+   char *zout = a->zout;
+   for(;;) {
+      int z = stbi__zhuffman_decode(a, &a->z_length);
+      if (z < 256) {
+         if (z < 0) return stbi__err("bad huffman code","Corrupt PNG"); // error in huffman codes
+         if (zout >= a->zout_end) {
+            if (!stbi__zexpand(a, zout, 1)) return 0;
+            zout = a->zout;
+         }
+         *zout++ = (char) z;
+      } else {
+         stbi_uc *p;
+         int len,dist;
+         if (z == 256) {
+            a->zout = zout;
+            return 1;
+         }
+         z -= 257;
+         len = stbi__zlength_base[z];
+         if (stbi__zlength_extra[z]) len += stbi__zreceive(a, stbi__zlength_extra[z]);
+         z = stbi__zhuffman_decode(a, &a->z_distance);
+         if (z < 0) return stbi__err("bad huffman code","Corrupt PNG");
+         dist = stbi__zdist_base[z];
+         if (stbi__zdist_extra[z]) dist += stbi__zreceive(a, stbi__zdist_extra[z]);
+         if (zout - a->zout_start < dist) return stbi__err("bad dist","Corrupt PNG");
+         if (zout + len > a->zout_end) {
+            if (!stbi__zexpand(a, zout, len)) return 0;
+            zout = a->zout;
+         }
+         p = (stbi_uc *) (zout - dist);
+         if (dist == 1) { // run of one byte; common in images.
+            stbi_uc v = *p;
+            if (len) { do *zout++ = v; while (--len); }
+         } else {
+            if (len) { do *zout++ = *p++; while (--len); }
+         }
+      }
+   }
+}
+
+static int stbi__compute_huffman_codes(stbi__zbuf *a)
+{
+   static const stbi_uc length_dezigzag[19] = { 16,17,18,0,8,7,9,6,10,5,11,4,12,3,13,2,14,1,15 };
+   stbi__zhuffman z_codelength;
+   stbi_uc lencodes[286+32+137];//padding for maximum single op
+   stbi_uc codelength_sizes[19];
+   int i,n;
+
+   int hlit  = stbi__zreceive(a,5) + 257;
+   int hdist = stbi__zreceive(a,5) + 1;
+   int hclen = stbi__zreceive(a,4) + 4;
+   int ntot  = hlit + hdist;
+
+   memset(codelength_sizes, 0, sizeof(codelength_sizes));
+   for (i=0; i < hclen; ++i) {
+      int s = stbi__zreceive(a,3);
+      codelength_sizes[length_dezigzag[i]] = (stbi_uc) s;
+   }
+   if (!stbi__zbuild_huffman(&z_codelength, codelength_sizes, 19)) return 0;
+
+   n = 0;
+   while (n < ntot) {
+      int c = stbi__zhuffman_decode(a, &z_codelength);
+      if (c < 0 || c >= 19) return stbi__err("bad codelengths", "Corrupt PNG");
+      if (c < 16)
+         lencodes[n++] = (stbi_uc) c;
+      else {
+         stbi_uc fill = 0;
+         if (c == 16) {
+            c = stbi__zreceive(a,2)+3;
+            if (n == 0) return stbi__err("bad codelengths", "Corrupt PNG");
+            fill = lencodes[n-1];
+         } else if (c == 17)
+            c = stbi__zreceive(a,3)+3;
+         else {
+            STBI_ASSERT(c == 18);
+            c = stbi__zreceive(a,7)+11;
+         }
+         if (ntot - n < c) return stbi__err("bad codelengths", "Corrupt PNG");
+         memset(lencodes+n, fill, c);
+         n += c;
+      }
+   }
+   if (n != ntot) return stbi__err("bad codelengths","Corrupt PNG");
+   if (!stbi__zbuild_huffman(&a->z_length, lencodes, hlit)) return 0;
+   if (!stbi__zbuild_huffman(&a->z_distance, lencodes+hlit, hdist)) return 0;
+   return 1;
+}
+
+static int stbi__parse_uncompressed_block(stbi__zbuf *a)
+{
+   stbi_uc header[4];
+   int len,nlen,k;
+   if (a->num_bits & 7)
+      stbi__zreceive(a, a->num_bits & 7); // discard
+   // drain the bit-packed data into header
+   k = 0;
+   while (a->num_bits > 0) {
+      header[k++] = (stbi_uc) (a->code_buffer & 255); // suppress MSVC run-time check
+      a->code_buffer >>= 8;
+      a->num_bits -= 8;
+   }
+   STBI_ASSERT(a->num_bits == 0);
+   // now fill header the normal way
+   while (k < 4)
+      header[k++] = stbi__zget8(a);
+   len  = header[1] * 256 + header[0];
+   nlen = header[3] * 256 + header[2];
+   if (nlen != (len ^ 0xffff)) return stbi__err("zlib corrupt","Corrupt PNG");
+   if (a->zbuffer + len > a->zbuffer_end) return stbi__err("read past buffer","Corrupt PNG");
+   if (a->zout + len > a->zout_end)
+      if (!stbi__zexpand(a, a->zout, len)) return 0;
+   memcpy(a->zout, a->zbuffer, len);
+   a->zbuffer += len;
+   a->zout += len;
+   return 1;
+}
+
+static int stbi__parse_zlib_header(stbi__zbuf *a)
+{
+   int cmf   = stbi__zget8(a);
+   int cm    = cmf & 15;
+   /* int cinfo = cmf >> 4; */
+   int flg   = stbi__zget8(a);
+   if ((cmf*256+flg) % 31 != 0) return stbi__err("bad zlib header","Corrupt PNG"); // zlib spec
+   if (flg & 32) return stbi__err("no preset dict","Corrupt PNG"); // preset dictionary not allowed in png
+   if (cm != 8) return stbi__err("bad compression","Corrupt PNG"); // DEFLATE required for png
+   // window = 1 << (8 + cinfo)... but who cares, we fully buffer output
+   return 1;
+}
+
+static const stbi_uc stbi__zdefault_length[288] =
+{
+   8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,
+   8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,
+   8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,
+   8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,
+   8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,
+   9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,
+   9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,
+   9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,
+   7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7, 7,7,7,7,7,7,7,7,8,8,8,8,8,8,8,8
+};
+static const stbi_uc stbi__zdefault_distance[32] =
+{
+   5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5
+};
+/*
+Init algorithm:
+{
+   int i;   // use <= to match clearly with spec
+   for (i=0; i <= 143; ++i)     stbi__zdefault_length[i]   = 8;
+   for (   ; i <= 255; ++i)     stbi__zdefault_length[i]   = 9;
+   for (   ; i <= 279; ++i)     stbi__zdefault_length[i]   = 7;
+   for (   ; i <= 287; ++i)     stbi__zdefault_length[i]   = 8;
+
+   for (i=0; i <=  31; ++i)     stbi__zdefault_distance[i] = 5;
+}
+*/
+
+static int stbi__parse_zlib(stbi__zbuf *a, int parse_header)
+{
+   int final, type;
+   if (parse_header)
+      if (!stbi__parse_zlib_header(a)) return 0;
+   a->num_bits = 0;
+   a->code_buffer = 0;
+   do {
+      final = stbi__zreceive(a,1);
+      type = stbi__zreceive(a,2);
+      if (type == 0) {
+         if (!stbi__parse_uncompressed_block(a)) return 0;
+      } else if (type == 3) {
+         return 0;
+      } else {
+         if (type == 1) {
+            // use fixed code lengths
+            if (!stbi__zbuild_huffman(&a->z_length  , stbi__zdefault_length  , 288)) return 0;
+            if (!stbi__zbuild_huffman(&a->z_distance, stbi__zdefault_distance,  32)) return 0;
+         } else {
+            if (!stbi__compute_huffman_codes(a)) return 0;
+         }
+         if (!stbi__parse_huffman_block(a)) return 0;
+      }
+   } while (!final);
+   return 1;
+}
+
+static int stbi__do_zlib(stbi__zbuf *a, char *obuf, int olen, int exp, int parse_header)
+{
+   a->zout_start = obuf;
+   a->zout       = obuf;
+   a->zout_end   = obuf + olen;
+   a->z_expandable = exp;
+
+   return stbi__parse_zlib(a, parse_header);
+}
+
+STBIDEF char *stbi_zlib_decode_malloc_guesssize(const char *buffer, int len, int initial_size, int *outlen)
+{
+   stbi__zbuf a;
+   char *p = (char *) stbi__malloc(initial_size);
+   if (p == NULL) return NULL;
+   a.zbuffer = (stbi_uc *) buffer;
+   a.zbuffer_end = (stbi_uc *) buffer + len;
+   if (stbi__do_zlib(&a, p, initial_size, 1, 1)) {
+      if (outlen) *outlen = (int) (a.zout - a.zout_start);
+      return a.zout_start;
+   } else {
+      STBI_FREE(a.zout_start);
+      return NULL;
+   }
+}
+
+STBIDEF char *stbi_zlib_decode_malloc(char const *buffer, int len, int *outlen)
+{
+   return stbi_zlib_decode_malloc_guesssize(buffer, len, 16384, outlen);
+}
+
+STBIDEF char *stbi_zlib_decode_malloc_guesssize_headerflag(const char *buffer, int len, int initial_size, int *outlen, int parse_header)
+{
+   stbi__zbuf a;
+   char *p = (char *) stbi__malloc(initial_size);
+   if (p == NULL) return NULL;
+   a.zbuffer = (stbi_uc *) buffer;
+   a.zbuffer_end = (stbi_uc *) buffer + len;
+   if (stbi__do_zlib(&a, p, initial_size, 1, parse_header)) {
+      if (outlen) *outlen = (int) (a.zout - a.zout_start);
+      return a.zout_start;
+   } else {
+      STBI_FREE(a.zout_start);
+      return NULL;
+   }
+}
+
+STBIDEF int stbi_zlib_decode_buffer(char *obuffer, int olen, char const *ibuffer, int ilen)
+{
+   stbi__zbuf a;
+   a.zbuffer = (stbi_uc *) ibuffer;
+   a.zbuffer_end = (stbi_uc *) ibuffer + ilen;
+   if (stbi__do_zlib(&a, obuffer, olen, 0, 1))
+      return (int) (a.zout - a.zout_start);
+   else
+      return -1;
+}
+
+STBIDEF char *stbi_zlib_decode_noheader_malloc(char const *buffer, int len, int *outlen)
+{
+   stbi__zbuf a;
+   char *p = (char *) stbi__malloc(16384);
+   if (p == NULL) return NULL;
+   a.zbuffer = (stbi_uc *) buffer;
+   a.zbuffer_end = (stbi_uc *) buffer+len;
+   if (stbi__do_zlib(&a, p, 16384, 1, 0)) {
+      if (outlen) *outlen = (int) (a.zout - a.zout_start);
+      return a.zout_start;
+   } else {
+      STBI_FREE(a.zout_start);
+      return NULL;
+   }
+}
+
+STBIDEF int stbi_zlib_decode_noheader_buffer(char *obuffer, int olen, const char *ibuffer, int ilen)
+{
+   stbi__zbuf a;
+   a.zbuffer = (stbi_uc *) ibuffer;
+   a.zbuffer_end = (stbi_uc *) ibuffer + ilen;
+   if (stbi__do_zlib(&a, obuffer, olen, 0, 0))
+      return (int) (a.zout - a.zout_start);
+   else
+      return -1;
+}
+#endif
+
+// public domain "baseline" PNG decoder   v0.10  Sean Barrett 2006-11-18
+//    simple implementation
+//      - only 8-bit samples
+//      - no CRC checking
+//      - allocates lots of intermediate memory
+//        - avoids problem of streaming data between subsystems
+//        - avoids explicit window management
+//    performance
+//      - uses stb_zlib, a PD zlib implementation with fast huffman decoding
+
+#ifndef STBI_NO_PNG
+typedef struct
+{
+   stbi__uint32 length;
+   stbi__uint32 type;
+} stbi__pngchunk;
+
+static stbi__pngchunk stbi__get_chunk_header(stbi__context *s)
+{
+   stbi__pngchunk c;
+   c.length = stbi__get32be(s);
+   c.type   = stbi__get32be(s);
+   return c;
+}
+
+static int stbi__check_png_header(stbi__context *s)
+{
+   static const stbi_uc png_sig[8] = { 137,80,78,71,13,10,26,10 };
+   int i;
+   for (i=0; i < 8; ++i)
+      if (stbi__get8(s) != png_sig[i]) return stbi__err("bad png sig","Not a PNG");
+   return 1;
+}
+
+typedef struct
+{
+   stbi__context *s;
+   stbi_uc *idata, *expanded, *out;
+   int depth;
+} stbi__png;
+
+
+enum {
+   STBI__F_none=0,
+   STBI__F_sub=1,
+   STBI__F_up=2,
+   STBI__F_avg=3,
+   STBI__F_paeth=4,
+   // synthetic filters used for first scanline to avoid needing a dummy row of 0s
+   STBI__F_avg_first,
+   STBI__F_paeth_first
+};
+
+static stbi_uc first_row_filter[5] =
+{
+   STBI__F_none,
+   STBI__F_sub,
+   STBI__F_none,
+   STBI__F_avg_first,
+   STBI__F_paeth_first
+};
+
+static int stbi__paeth(int a, int b, int c)
+{
+   int p = a + b - c;
+   int pa = abs(p-a);
+   int pb = abs(p-b);
+   int pc = abs(p-c);
+   if (pa <= pb && pa <= pc) return a;
+   if (pb <= pc) return b;
+   return c;
+}
+
+static const stbi_uc stbi__depth_scale_table[9] = { 0, 0xff, 0x55, 0, 0x11, 0,0,0, 0x01 };
+
+// create the png data from post-deflated data
+static int stbi__create_png_image_raw(stbi__png *a, stbi_uc *raw, stbi__uint32 raw_len, int out_n, stbi__uint32 x, stbi__uint32 y, int depth, int color)
+{
+   int bytes = (depth == 16? 2 : 1);
+   stbi__context *s = a->s;
+   stbi__uint32 i,j,stride = x*out_n*bytes;
+   stbi__uint32 img_len, img_width_bytes;
+   int k;
+   int img_n = s->img_n; // copy it into a local for later
+
+   int output_bytes = out_n*bytes;
+   int filter_bytes = img_n*bytes;
+   int width = x;
+
+   STBI_ASSERT(out_n == s->img_n || out_n == s->img_n+1);
+   a->out = (stbi_uc *) stbi__malloc_mad3(x, y, output_bytes, 0); // extra bytes to write off the end into
+   if (!a->out) return stbi__err("outofmem", "Out of memory");
+
+   if (!stbi__mad3sizes_valid(img_n, x, depth, 7)) return stbi__err("too large", "Corrupt PNG");
+   img_width_bytes = (((img_n * x * depth) + 7) >> 3);
+   img_len = (img_width_bytes + 1) * y;
+
+   // we used to check for exact match between raw_len and img_len on non-interlaced PNGs,
+   // but issue #276 reported a PNG in the wild that had extra data at the end (all zeros),
+   // so just check for raw_len < img_len always.
+   if (raw_len < img_len) return stbi__err("not enough pixels","Corrupt PNG");
+
+   for (j=0; j < y; ++j) {
+      stbi_uc *cur = a->out + stride*j;
+      stbi_uc *prior;
+      int filter = *raw++;
+
+      if (filter > 4)
+         return stbi__err("invalid filter","Corrupt PNG");
+
+      if (depth < 8) {
+         STBI_ASSERT(img_width_bytes <= x);
+         cur += x*out_n - img_width_bytes; // store output to the rightmost img_len bytes, so we can decode in place
+         filter_bytes = 1;
+         width = img_width_bytes;
+      }
+      prior = cur - stride; // bugfix: need to compute this after 'cur +=' computation above
+
+      // if first row, use special filter that doesn't sample previous row
+      if (j == 0) filter = first_row_filter[filter];
+
+      // handle first byte explicitly
+      for (k=0; k < filter_bytes; ++k) {
+         switch (filter) {
+            case STBI__F_none       : cur[k] = raw[k]; break;
+            case STBI__F_sub        : cur[k] = raw[k]; break;
+            case STBI__F_up         : cur[k] = STBI__BYTECAST(raw[k] + prior[k]); break;
+            case STBI__F_avg        : cur[k] = STBI__BYTECAST(raw[k] + (prior[k]>>1)); break;
+            case STBI__F_paeth      : cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(0,prior[k],0)); break;
+            case STBI__F_avg_first  : cur[k] = raw[k]; break;
+            case STBI__F_paeth_first: cur[k] = raw[k]; break;
+         }
+      }
+
+      if (depth == 8) {
+         if (img_n != out_n)
+            cur[img_n] = 255; // first pixel
+         raw += img_n;
+         cur += out_n;
+         prior += out_n;
+      } else if (depth == 16) {
+         if (img_n != out_n) {
+            cur[filter_bytes]   = 255; // first pixel top byte
+            cur[filter_bytes+1] = 255; // first pixel bottom byte
+         }
+         raw += filter_bytes;
+         cur += output_bytes;
+         prior += output_bytes;
+      } else {
+         raw += 1;
+         cur += 1;
+         prior += 1;
+      }
+
+      // this is a little gross, so that we don't switch per-pixel or per-component
+      if (depth < 8 || img_n == out_n) {
+         int nk = (width - 1)*filter_bytes;
+         #define STBI__CASE(f) \
+             case f:     \
+                for (k=0; k < nk; ++k)
+         switch (filter) {
+            // "none" filter turns into a memcpy here; make that explicit.
+            case STBI__F_none:         memcpy(cur, raw, nk); break;
+            STBI__CASE(STBI__F_sub)          { cur[k] = STBI__BYTECAST(raw[k] + cur[k-filter_bytes]); } break;
+            STBI__CASE(STBI__F_up)           { cur[k] = STBI__BYTECAST(raw[k] + prior[k]); } break;
+            STBI__CASE(STBI__F_avg)          { cur[k] = STBI__BYTECAST(raw[k] + ((prior[k] + cur[k-filter_bytes])>>1)); } break;
+            STBI__CASE(STBI__F_paeth)        { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k-filter_bytes],prior[k],prior[k-filter_bytes])); } break;
+            STBI__CASE(STBI__F_avg_first)    { cur[k] = STBI__BYTECAST(raw[k] + (cur[k-filter_bytes] >> 1)); } break;
+            STBI__CASE(STBI__F_paeth_first)  { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k-filter_bytes],0,0)); } break;
+         }
+         #undef STBI__CASE
+         raw += nk;
+      } else {
+         STBI_ASSERT(img_n+1 == out_n);
+         #define STBI__CASE(f) \
+             case f:     \
+                for (i=x-1; i >= 1; --i, cur[filter_bytes]=255,raw+=filter_bytes,cur+=output_bytes,prior+=output_bytes) \
+                   for (k=0; k < filter_bytes; ++k)
+         switch (filter) {
+            STBI__CASE(STBI__F_none)         { cur[k] = raw[k]; } break;
+            STBI__CASE(STBI__F_sub)          { cur[k] = STBI__BYTECAST(raw[k] + cur[k- output_bytes]); } break;
+            STBI__CASE(STBI__F_up)           { cur[k] = STBI__BYTECAST(raw[k] + prior[k]); } break;
+            STBI__CASE(STBI__F_avg)          { cur[k] = STBI__BYTECAST(raw[k] + ((prior[k] + cur[k- output_bytes])>>1)); } break;
+            STBI__CASE(STBI__F_paeth)        { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k- output_bytes],prior[k],prior[k- output_bytes])); } break;
+            STBI__CASE(STBI__F_avg_first)    { cur[k] = STBI__BYTECAST(raw[k] + (cur[k- output_bytes] >> 1)); } break;
+            STBI__CASE(STBI__F_paeth_first)  { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k- output_bytes],0,0)); } break;
+         }
+         #undef STBI__CASE
+
+         // the loop above sets the high byte of the pixels' alpha, but for
+         // 16 bit png files we also need the low byte set. we'll do that here.
+         if (depth == 16) {
+            cur = a->out + stride*j; // start at the beginning of the row again
+            for (i=0; i < x; ++i,cur+=output_bytes) {
+               cur[filter_bytes+1] = 255;
+            }
+         }
+      }
+   }
+
+   // we make a separate pass to expand bits to pixels; for performance,
+   // this could run two scanlines behind the above code, so it won't
+   // intefere with filtering but will still be in the cache.
+   if (depth < 8) {
+      for (j=0; j < y; ++j) {
+         stbi_uc *cur = a->out + stride*j;
+         stbi_uc *in  = a->out + stride*j + x*out_n - img_width_bytes;
+         // unpack 1/2/4-bit into a 8-bit buffer. allows us to keep the common 8-bit path optimal at minimal cost for 1/2/4-bit
+         // png guarante byte alignment, if width is not multiple of 8/4/2 we'll decode dummy trailing data that will be skipped in the later loop
+         stbi_uc scale = (color == 0) ? stbi__depth_scale_table[depth] : 1; // scale grayscale values to 0..255 range
+
+         // note that the final byte might overshoot and write more data than desired.
+         // we can allocate enough data that this never writes out of memory, but it
+         // could also overwrite the next scanline. can it overwrite non-empty data
+         // on the next scanline? yes, consider 1-pixel-wide scanlines with 1-bit-per-pixel.
+         // so we need to explicitly clamp the final ones
+
+         if (depth == 4) {
+            for (k=x*img_n; k >= 2; k-=2, ++in) {
+               *cur++ = scale * ((*in >> 4)       );
+               *cur++ = scale * ((*in     ) & 0x0f);
+            }
+            if (k > 0) *cur++ = scale * ((*in >> 4)       );
+         } else if (depth == 2) {
+            for (k=x*img_n; k >= 4; k-=4, ++in) {
+               *cur++ = scale * ((*in >> 6)       );
+               *cur++ = scale * ((*in >> 4) & 0x03);
+               *cur++ = scale * ((*in >> 2) & 0x03);
+               *cur++ = scale * ((*in     ) & 0x03);
+            }
+            if (k > 0) *cur++ = scale * ((*in >> 6)       );
+            if (k > 1) *cur++ = scale * ((*in >> 4) & 0x03);
+            if (k > 2) *cur++ = scale * ((*in >> 2) & 0x03);
+         } else if (depth == 1) {
+            for (k=x*img_n; k >= 8; k-=8, ++in) {
+               *cur++ = scale * ((*in >> 7)       );
+               *cur++ = scale * ((*in >> 6) & 0x01);
+               *cur++ = scale * ((*in >> 5) & 0x01);
+               *cur++ = scale * ((*in >> 4) & 0x01);
+               *cur++ = scale * ((*in >> 3) & 0x01);
+               *cur++ = scale * ((*in >> 2) & 0x01);
+               *cur++ = scale * ((*in >> 1) & 0x01);
+               *cur++ = scale * ((*in     ) & 0x01);
+            }
+            if (k > 0) *cur++ = scale * ((*in >> 7)       );
+            if (k > 1) *cur++ = scale * ((*in >> 6) & 0x01);
+            if (k > 2) *cur++ = scale * ((*in >> 5) & 0x01);
+            if (k > 3) *cur++ = scale * ((*in >> 4) & 0x01);
+            if (k > 4) *cur++ = scale * ((*in >> 3) & 0x01);
+            if (k > 5) *cur++ = scale * ((*in >> 2) & 0x01);
+            if (k > 6) *cur++ = scale * ((*in >> 1) & 0x01);
+         }
+         if (img_n != out_n) {
+            int q;
+            // insert alpha = 255
+            cur = a->out + stride*j;
+            if (img_n == 1) {
+               for (q=x-1; q >= 0; --q) {
+                  cur[q*2+1] = 255;
+                  cur[q*2+0] = cur[q];
+               }
+            } else {
+               STBI_ASSERT(img_n == 3);
+               for (q=x-1; q >= 0; --q) {
+                  cur[q*4+3] = 255;
+                  cur[q*4+2] = cur[q*3+2];
+                  cur[q*4+1] = cur[q*3+1];
+                  cur[q*4+0] = cur[q*3+0];
+               }
+            }
+         }
+      }
+   } else if (depth == 16) {
+      // force the image data from big-endian to platform-native.
+      // this is done in a separate pass due to the decoding relying
+      // on the data being untouched, but could probably be done
+      // per-line during decode if care is taken.
+      stbi_uc *cur = a->out;
+      stbi__uint16 *cur16 = (stbi__uint16*)cur;
+
+      for(i=0; i < x*y*out_n; ++i,cur16++,cur+=2) {
+         *cur16 = (cur[0] << 8) | cur[1];
+      }
+   }
+
+   return 1;
+}
+
+static int stbi__create_png_image(stbi__png *a, stbi_uc *image_data, stbi__uint32 image_data_len, int out_n, int depth, int color, int interlaced)
+{
+   int bytes = (depth == 16 ? 2 : 1);
+   int out_bytes = out_n * bytes;
+   stbi_uc *final;
+   int p;
+   if (!interlaced)
+      return stbi__create_png_image_raw(a, image_data, image_data_len, out_n, a->s->img_x, a->s->img_y, depth, color);
+
+   // de-interlacing
+   final = (stbi_uc *) stbi__malloc_mad3(a->s->img_x, a->s->img_y, out_bytes, 0);
+   for (p=0; p < 7; ++p) {
+      int xorig[] = { 0,4,0,2,0,1,0 };
+      int yorig[] = { 0,0,4,0,2,0,1 };
+      int xspc[]  = { 8,8,4,4,2,2,1 };
+      int yspc[]  = { 8,8,8,4,4,2,2 };
+      int i,j,x,y;
+      // pass1_x[4] = 0, pass1_x[5] = 1, pass1_x[12] = 1
+      x = (a->s->img_x - xorig[p] + xspc[p]-1) / xspc[p];
+      y = (a->s->img_y - yorig[p] + yspc[p]-1) / yspc[p];
+      if (x && y) {
+         stbi__uint32 img_len = ((((a->s->img_n * x * depth) + 7) >> 3) + 1) * y;
+         if (!stbi__create_png_image_raw(a, image_data, image_data_len, out_n, x, y, depth, color)) {
+            STBI_FREE(final);
+            return 0;
+         }
+         for (j=0; j < y; ++j) {
+            for (i=0; i < x; ++i) {
+               int out_y = j*yspc[p]+yorig[p];
+               int out_x = i*xspc[p]+xorig[p];
+               memcpy(final + out_y*a->s->img_x*out_bytes + out_x*out_bytes,
+                      a->out + (j*x+i)*out_bytes, out_bytes);
+            }
+         }
+         STBI_FREE(a->out);
+         image_data += img_len;
+         image_data_len -= img_len;
+      }
+   }
+   a->out = final;
+
+   return 1;
+}
+
+static int stbi__compute_transparency(stbi__png *z, stbi_uc tc[3], int out_n)
+{
+   stbi__context *s = z->s;
+   stbi__uint32 i, pixel_count = s->img_x * s->img_y;
+   stbi_uc *p = z->out;
+
+   // compute color-based transparency, assuming we've
+   // already got 255 as the alpha value in the output
+   STBI_ASSERT(out_n == 2 || out_n == 4);
+
+   if (out_n == 2) {
+      for (i=0; i < pixel_count; ++i) {
+         p[1] = (p[0] == tc[0] ? 0 : 255);
+         p += 2;
+      }
+   } else {
+      for (i=0; i < pixel_count; ++i) {
+         if (p[0] == tc[0] && p[1] == tc[1] && p[2] == tc[2])
+            p[3] = 0;
+         p += 4;
+      }
+   }
+   return 1;
+}
+
+static int stbi__compute_transparency16(stbi__png *z, stbi__uint16 tc[3], int out_n)
+{
+   stbi__context *s = z->s;
+   stbi__uint32 i, pixel_count = s->img_x * s->img_y;
+   stbi__uint16 *p = (stbi__uint16*) z->out;
+
+   // compute color-based transparency, assuming we've
+   // already got 65535 as the alpha value in the output
+   STBI_ASSERT(out_n == 2 || out_n == 4);
+
+   if (out_n == 2) {
+      for (i = 0; i < pixel_count; ++i) {
+         p[1] = (p[0] == tc[0] ? 0 : 65535);
+         p += 2;
+      }
+   } else {
+      for (i = 0; i < pixel_count; ++i) {
+         if (p[0] == tc[0] && p[1] == tc[1] && p[2] == tc[2])
+            p[3] = 0;
+         p += 4;
+      }
+   }
+   return 1;
+}
+
+static int stbi__expand_png_palette(stbi__png *a, stbi_uc *palette, int len, int pal_img_n)
+{
+   stbi__uint32 i, pixel_count = a->s->img_x * a->s->img_y;
+   stbi_uc *p, *temp_out, *orig = a->out;
+
+   p = (stbi_uc *) stbi__malloc_mad2(pixel_count, pal_img_n, 0);
+   if (p == NULL) return stbi__err("outofmem", "Out of memory");
+
+   // between here and free(out) below, exitting would leak
+   temp_out = p;
+
+   if (pal_img_n == 3) {
+      for (i=0; i < pixel_count; ++i) {
+         int n = orig[i]*4;
+         p[0] = palette[n  ];
+         p[1] = palette[n+1];
+         p[2] = palette[n+2];
+         p += 3;
+      }
+   } else {
+      for (i=0; i < pixel_count; ++i) {
+         int n = orig[i]*4;
+         p[0] = palette[n  ];
+         p[1] = palette[n+1];
+         p[2] = palette[n+2];
+         p[3] = palette[n+3];
+         p += 4;
+      }
+   }
+   STBI_FREE(a->out);
+   a->out = temp_out;
+
+   STBI_NOTUSED(len);
+
+   return 1;
+}
+
+static int stbi__unpremultiply_on_load = 0;
+static int stbi__de_iphone_flag = 0;
+
+STBIDEF void stbi_set_unpremultiply_on_load(int flag_true_if_should_unpremultiply)
+{
+   stbi__unpremultiply_on_load = flag_true_if_should_unpremultiply;
+}
+
+STBIDEF void stbi_convert_iphone_png_to_rgb(int flag_true_if_should_convert)
+{
+   stbi__de_iphone_flag = flag_true_if_should_convert;
+}
+
+static void stbi__de_iphone(stbi__png *z)
+{
+   stbi__context *s = z->s;
+   stbi__uint32 i, pixel_count = s->img_x * s->img_y;
+   stbi_uc *p = z->out;
+
+   if (s->img_out_n == 3) {  // convert bgr to rgb
+      for (i=0; i < pixel_count; ++i) {
+         stbi_uc t = p[0];
+         p[0] = p[2];
+         p[2] = t;
+         p += 3;
+      }
+   } else {
+      STBI_ASSERT(s->img_out_n == 4);
+      if (stbi__unpremultiply_on_load) {
+         // convert bgr to rgb and unpremultiply
+         for (i=0; i < pixel_count; ++i) {
+            stbi_uc a = p[3];
+            stbi_uc t = p[0];
+            if (a) {
+               stbi_uc half = a / 2;
+               p[0] = (p[2] * 255 + half) / a;
+               p[1] = (p[1] * 255 + half) / a;
+               p[2] = ( t   * 255 + half) / a;
+            } else {
+               p[0] = p[2];
+               p[2] = t;
+            }
+            p += 4;
+         }
+      } else {
+         // convert bgr to rgb
+         for (i=0; i < pixel_count; ++i) {
+            stbi_uc t = p[0];
+            p[0] = p[2];
+            p[2] = t;
+            p += 4;
+         }
+      }
+   }
+}
+
+#define STBI__PNG_TYPE(a,b,c,d)  (((unsigned) (a) << 24) + ((unsigned) (b) << 16) + ((unsigned) (c) << 8) + (unsigned) (d))
+
+static int stbi__parse_png_file(stbi__png *z, int scan, int req_comp)
+{
+   stbi_uc palette[1024], pal_img_n=0;
+   stbi_uc has_trans=0, tc[3]={0};
+   stbi__uint16 tc16[3];
+   stbi__uint32 ioff=0, idata_limit=0, i, pal_len=0;
+   int first=1,k,interlace=0, color=0, is_iphone=0;
+   stbi__context *s = z->s;
+
+   z->expanded = NULL;
+   z->idata = NULL;
+   z->out = NULL;
+
+   if (!stbi__check_png_header(s)) return 0;
+
+   if (scan == STBI__SCAN_type) return 1;
+
+   for (;;) {
+      stbi__pngchunk c = stbi__get_chunk_header(s);
+      switch (c.type) {
+         case STBI__PNG_TYPE('C','g','B','I'):
+            is_iphone = 1;
+            stbi__skip(s, c.length);
+            break;
+         case STBI__PNG_TYPE('I','H','D','R'): {
+            int comp,filter;
+            if (!first) return stbi__err("multiple IHDR","Corrupt PNG");
+            first = 0;
+            if (c.length != 13) return stbi__err("bad IHDR len","Corrupt PNG");
+            s->img_x = stbi__get32be(s); if (s->img_x > (1 << 24)) return stbi__err("too large","Very large image (corrupt?)");
+            s->img_y = stbi__get32be(s); if (s->img_y > (1 << 24)) return stbi__err("too large","Very large image (corrupt?)");
+            z->depth = stbi__get8(s);  if (z->depth != 1 && z->depth != 2 && z->depth != 4 && z->depth != 8 && z->depth != 16)  return stbi__err("1/2/4/8/16-bit only","PNG not supported: 1/2/4/8/16-bit only");
+            color = stbi__get8(s);  if (color > 6)         return stbi__err("bad ctype","Corrupt PNG");
+            if (color == 3 && z->depth == 16)                  return stbi__err("bad ctype","Corrupt PNG");
+            if (color == 3) pal_img_n = 3; else if (color & 1) return stbi__err("bad ctype","Corrupt PNG");
+            comp  = stbi__get8(s);  if (comp) return stbi__err("bad comp method","Corrupt PNG");
+            filter= stbi__get8(s);  if (filter) return stbi__err("bad filter method","Corrupt PNG");
+            interlace = stbi__get8(s); if (interlace>1) return stbi__err("bad interlace method","Corrupt PNG");
+            if (!s->img_x || !s->img_y) return stbi__err("0-pixel image","Corrupt PNG");
+            if (!pal_img_n) {
+               s->img_n = (color & 2 ? 3 : 1) + (color & 4 ? 1 : 0);
+               if ((1 << 30) / s->img_x / s->img_n < s->img_y) return stbi__err("too large", "Image too large to decode");
+               if (scan == STBI__SCAN_header) return 1;
+            } else {
+               // if paletted, then pal_n is our final components, and
+               // img_n is # components to decompress/filter.
+               s->img_n = 1;
+               if ((1 << 30) / s->img_x / 4 < s->img_y) return stbi__err("too large","Corrupt PNG");
+               // if SCAN_header, have to scan to see if we have a tRNS
+            }
+            break;
+         }
+
+         case STBI__PNG_TYPE('P','L','T','E'):  {
+            if (first) return stbi__err("first not IHDR", "Corrupt PNG");
+            if (c.length > 256*3) return stbi__err("invalid PLTE","Corrupt PNG");
+            pal_len = c.length / 3;
+            if (pal_len * 3 != c.length) return stbi__err("invalid PLTE","Corrupt PNG");
+            for (i=0; i < pal_len; ++i) {
+               palette[i*4+0] = stbi__get8(s);
+               palette[i*4+1] = stbi__get8(s);
+               palette[i*4+2] = stbi__get8(s);
+               palette[i*4+3] = 255;
+            }
+            break;
+         }
+
+         case STBI__PNG_TYPE('t','R','N','S'): {
+            if (first) return stbi__err("first not IHDR", "Corrupt PNG");
+            if (z->idata) return stbi__err("tRNS after IDAT","Corrupt PNG");
+            if (pal_img_n) {
+               if (scan == STBI__SCAN_header) { s->img_n = 4; return 1; }
+               if (pal_len == 0) return stbi__err("tRNS before PLTE","Corrupt PNG");
+               if (c.length > pal_len) return stbi__err("bad tRNS len","Corrupt PNG");
+               pal_img_n = 4;
+               for (i=0; i < c.length; ++i)
+                  palette[i*4+3] = stbi__get8(s);
+            } else {
+               if (!(s->img_n & 1)) return stbi__err("tRNS with alpha","Corrupt PNG");
+               if (c.length != (stbi__uint32) s->img_n*2) return stbi__err("bad tRNS len","Corrupt PNG");
+               has_trans = 1;
+               if (z->depth == 16) {
+                  for (k = 0; k < s->img_n; ++k) tc16[k] = (stbi__uint16)stbi__get16be(s); // copy the values as-is
+               } else {
+                  for (k = 0; k < s->img_n; ++k) tc[k] = (stbi_uc)(stbi__get16be(s) & 255) * stbi__depth_scale_table[z->depth]; // non 8-bit images will be larger
+               }
+            }
+            break;
+         }
+
+         case STBI__PNG_TYPE('I','D','A','T'): {
+            if (first) return stbi__err("first not IHDR", "Corrupt PNG");
+            if (pal_img_n && !pal_len) return stbi__err("no PLTE","Corrupt PNG");
+            if (scan == STBI__SCAN_header) { s->img_n = pal_img_n; return 1; }
+            if ((int)(ioff + c.length) < (int)ioff) return 0;
+            if (ioff + c.length > idata_limit) {
+               stbi__uint32 idata_limit_old = idata_limit;
+               stbi_uc *p;
+               if (idata_limit == 0) idata_limit = c.length > 4096 ? c.length : 4096;
+               while (ioff + c.length > idata_limit)
+                  idata_limit *= 2;
+               STBI_NOTUSED(idata_limit_old);
+               p = (stbi_uc *) STBI_REALLOC_SIZED(z->idata, idata_limit_old, idata_limit); if (p == NULL) return stbi__err("outofmem", "Out of memory");
+               z->idata = p;
+            }
+            if (!stbi__getn(s, z->idata+ioff,c.length)) return stbi__err("outofdata","Corrupt PNG");
+            ioff += c.length;
+            break;
+         }
+
+         case STBI__PNG_TYPE('I','E','N','D'): {
+            stbi__uint32 raw_len, bpl;
+            if (first) return stbi__err("first not IHDR", "Corrupt PNG");
+            if (scan != STBI__SCAN_load) return 1;
+            if (z->idata == NULL) return stbi__err("no IDAT","Corrupt PNG");
+            // initial guess for decoded data size to avoid unnecessary reallocs
+            bpl = (s->img_x * z->depth + 7) / 8; // bytes per line, per component
+            raw_len = bpl * s->img_y * s->img_n /* pixels */ + s->img_y /* filter mode per row */;
+            z->expanded = (stbi_uc *) stbi_zlib_decode_malloc_guesssize_headerflag((char *) z->idata, ioff, raw_len, (int *) &raw_len, !is_iphone);
+            if (z->expanded == NULL) return 0; // zlib should set error
+            STBI_FREE(z->idata); z->idata = NULL;
+            if ((req_comp == s->img_n+1 && req_comp != 3 && !pal_img_n) || has_trans)
+               s->img_out_n = s->img_n+1;
+            else
+               s->img_out_n = s->img_n;
+            if (!stbi__create_png_image(z, z->expanded, raw_len, s->img_out_n, z->depth, color, interlace)) return 0;
+            if (has_trans) {
+               if (z->depth == 16) {
+                  if (!stbi__compute_transparency16(z, tc16, s->img_out_n)) return 0;
+               } else {
+                  if (!stbi__compute_transparency(z, tc, s->img_out_n)) return 0;
+               }
+            }
+            if (is_iphone && stbi__de_iphone_flag && s->img_out_n > 2)
+               stbi__de_iphone(z);
+            if (pal_img_n) {
+               // pal_img_n == 3 or 4
+               s->img_n = pal_img_n; // record the actual colors we had
+               s->img_out_n = pal_img_n;
+               if (req_comp >= 3) s->img_out_n = req_comp;
+               if (!stbi__expand_png_palette(z, palette, pal_len, s->img_out_n))
+                  return 0;
+            } else if (has_trans) {
+               // non-paletted image with tRNS -> source image has (constant) alpha
+               ++s->img_n;
+            }
+            STBI_FREE(z->expanded); z->expanded = NULL;
+            return 1;
+         }
+
+         default:
+            // if critical, fail
+            if (first) return stbi__err("first not IHDR", "Corrupt PNG");
+            if ((c.type & (1 << 29)) == 0) {
+               #ifndef STBI_NO_FAILURE_STRINGS
+               // not threadsafe
+               static char invalid_chunk[] = "XXXX PNG chunk not known";
+               invalid_chunk[0] = STBI__BYTECAST(c.type >> 24);
+               invalid_chunk[1] = STBI__BYTECAST(c.type >> 16);
+               invalid_chunk[2] = STBI__BYTECAST(c.type >>  8);
+               invalid_chunk[3] = STBI__BYTECAST(c.type >>  0);
+               #endif
+               return stbi__err(invalid_chunk, "PNG not supported: unknown PNG chunk type");
+            }
+            stbi__skip(s, c.length);
+            break;
+      }
+      // end of PNG chunk, read and skip CRC
+      stbi__get32be(s);
+   }
+}
+
+static void *stbi__do_png(stbi__png *p, int *x, int *y, int *n, int req_comp, stbi__result_info *ri)
+{
+   void *result=NULL;
+   if (req_comp < 0 || req_comp > 4) return stbi__errpuc("bad req_comp", "Internal error");
+   if (stbi__parse_png_file(p, STBI__SCAN_load, req_comp)) {
+      if (p->depth < 8)
+         ri->bits_per_channel = 8;
+      else
+         ri->bits_per_channel = p->depth;
+      result = p->out;
+      p->out = NULL;
+      if (req_comp && req_comp != p->s->img_out_n) {
+         if (ri->bits_per_channel == 8)
+            result = stbi__convert_format((unsigned char *) result, p->s->img_out_n, req_comp, p->s->img_x, p->s->img_y);
+         else
+            result = stbi__convert_format16((stbi__uint16 *) result, p->s->img_out_n, req_comp, p->s->img_x, p->s->img_y);
+         p->s->img_out_n = req_comp;
+         if (result == NULL) return result;
+      }
+      *x = p->s->img_x;
+      *y = p->s->img_y;
+      if (n) *n = p->s->img_n;
+   }
+   STBI_FREE(p->out);      p->out      = NULL;
+   STBI_FREE(p->expanded); p->expanded = NULL;
+   STBI_FREE(p->idata);    p->idata    = NULL;
+
+   return result;
+}
+
+static void *stbi__png_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri)
+{
+   stbi__png p;
+   p.s = s;
+   return stbi__do_png(&p, x,y,comp,req_comp, ri);
+}
+
+static int stbi__png_test(stbi__context *s)
+{
+   int r;
+   r = stbi__check_png_header(s);
+   stbi__rewind(s);
+   return r;
+}
+
+static int stbi__png_info_raw(stbi__png *p, int *x, int *y, int *comp)
+{
+   if (!stbi__parse_png_file(p, STBI__SCAN_header, 0)) {
+      stbi__rewind( p->s );
+      return 0;
+   }
+   if (x) *x = p->s->img_x;
+   if (y) *y = p->s->img_y;
+   if (comp) *comp = p->s->img_n;
+   return 1;
+}
+
+static int stbi__png_info(stbi__context *s, int *x, int *y, int *comp)
+{
+   stbi__png p;
+   p.s = s;
+   return stbi__png_info_raw(&p, x, y, comp);
+}
+
+static int stbi__png_is16(stbi__context *s)
+{
+   stbi__png p;
+   p.s = s;
+   if (!stbi__png_info_raw(&p, NULL, NULL, NULL))
+	   return 0;
+   if (p.depth != 16) {
+      stbi__rewind(p.s);
+      return 0;
+   }
+   return 1;
+}
+#endif
+
+// Microsoft/Windows BMP image
+
+#ifndef STBI_NO_BMP
+static int stbi__bmp_test_raw(stbi__context *s)
+{
+   int r;
+   int sz;
+   if (stbi__get8(s) != 'B') return 0;
+   if (stbi__get8(s) != 'M') return 0;
+   stbi__get32le(s); // discard filesize
+   stbi__get16le(s); // discard reserved
+   stbi__get16le(s); // discard reserved
+   stbi__get32le(s); // discard data offset
+   sz = stbi__get32le(s);
+   r = (sz == 12 || sz == 40 || sz == 56 || sz == 108 || sz == 124);
+   return r;
+}
+
+static int stbi__bmp_test(stbi__context *s)
+{
+   int r = stbi__bmp_test_raw(s);
+   stbi__rewind(s);
+   return r;
+}
+
+
+// returns 0..31 for the highest set bit
+static int stbi__high_bit(unsigned int z)
+{
+   int n=0;
+   if (z == 0) return -1;
+   if (z >= 0x10000) { n += 16; z >>= 16; }
+   if (z >= 0x00100) { n +=  8; z >>=  8; }
+   if (z >= 0x00010) { n +=  4; z >>=  4; }
+   if (z >= 0x00004) { n +=  2; z >>=  2; }
+   if (z >= 0x00002) { n +=  1; z >>=  1; }
+   return n;
+}
+
+static int stbi__bitcount(unsigned int a)
+{
+   a = (a & 0x55555555) + ((a >>  1) & 0x55555555); // max 2
+   a = (a & 0x33333333) + ((a >>  2) & 0x33333333); // max 4
+   a = (a + (a >> 4)) & 0x0f0f0f0f; // max 8 per 4, now 8 bits
+   a = (a + (a >> 8)); // max 16 per 8 bits
+   a = (a + (a >> 16)); // max 32 per 8 bits
+   return a & 0xff;
+}
+
+// extract an arbitrarily-aligned N-bit value (N=bits)
+// from v, and then make it 8-bits long and fractionally
+// extend it to full full range.
+static int stbi__shiftsigned(unsigned int v, int shift, int bits)
+{
+   static unsigned int mul_table[9] = {
+      0,
+      0xff/*0b11111111*/, 0x55/*0b01010101*/, 0x49/*0b01001001*/, 0x11/*0b00010001*/,
+      0x21/*0b00100001*/, 0x41/*0b01000001*/, 0x81/*0b10000001*/, 0x01/*0b00000001*/,
+   };
+   static unsigned int shift_table[9] = {
+      0, 0,0,1,0,2,4,6,0,
+   };
+   if (shift < 0)
+      v <<= -shift;
+   else
+      v >>= shift;
+   STBI_ASSERT(v >= 0 && v < 256);
+   v >>= (8-bits);
+   STBI_ASSERT(bits >= 0 && bits <= 8);
+   return (int) ((unsigned) v * mul_table[bits]) >> shift_table[bits];
+}
+
+typedef struct
+{
+   int bpp, offset, hsz;
+   unsigned int mr,mg,mb,ma, all_a;
+} stbi__bmp_data;
+
+static void *stbi__bmp_parse_header(stbi__context *s, stbi__bmp_data *info)
+{
+   int hsz;
+   if (stbi__get8(s) != 'B' || stbi__get8(s) != 'M') return stbi__errpuc("not BMP", "Corrupt BMP");
+   stbi__get32le(s); // discard filesize
+   stbi__get16le(s); // discard reserved
+   stbi__get16le(s); // discard reserved
+   info->offset = stbi__get32le(s);
+   info->hsz = hsz = stbi__get32le(s);
+   info->mr = info->mg = info->mb = info->ma = 0;
+
+   if (hsz != 12 && hsz != 40 && hsz != 56 && hsz != 108 && hsz != 124) return stbi__errpuc("unknown BMP", "BMP type not supported: unknown");
+   if (hsz == 12) {
+      s->img_x = stbi__get16le(s);
+      s->img_y = stbi__get16le(s);
+   } else {
+      s->img_x = stbi__get32le(s);
+      s->img_y = stbi__get32le(s);
+   }
+   if (stbi__get16le(s) != 1) return stbi__errpuc("bad BMP", "bad BMP");
+   info->bpp = stbi__get16le(s);
+   if (hsz != 12) {
+      int compress = stbi__get32le(s);
+      if (compress == 1 || compress == 2) return stbi__errpuc("BMP RLE", "BMP type not supported: RLE");
+      stbi__get32le(s); // discard sizeof
+      stbi__get32le(s); // discard hres
+      stbi__get32le(s); // discard vres
+      stbi__get32le(s); // discard colorsused
+      stbi__get32le(s); // discard max important
+      if (hsz == 40 || hsz == 56) {
+         if (hsz == 56) {
+            stbi__get32le(s);
+            stbi__get32le(s);
+            stbi__get32le(s);
+            stbi__get32le(s);
+         }
+         if (info->bpp == 16 || info->bpp == 32) {
+            if (compress == 0) {
+               if (info->bpp == 32) {
+                  info->mr = 0xffu << 16;
+                  info->mg = 0xffu <<  8;
+                  info->mb = 0xffu <<  0;
+                  info->ma = 0xffu << 24;
+                  info->all_a = 0; // if all_a is 0 at end, then we loaded alpha channel but it was all 0
+               } else {
+                  info->mr = 31u << 10;
+                  info->mg = 31u <<  5;
+                  info->mb = 31u <<  0;
+               }
+            } else if (compress == 3) {
+               info->mr = stbi__get32le(s);
+               info->mg = stbi__get32le(s);
+               info->mb = stbi__get32le(s);
+               // not documented, but generated by photoshop and handled by mspaint
+               if (info->mr == info->mg && info->mg == info->mb) {
+                  // ?!?!?
+                  return stbi__errpuc("bad BMP", "bad BMP");
+               }
+            } else
+               return stbi__errpuc("bad BMP", "bad BMP");
+         }
+      } else {
+         int i;
+         if (hsz != 108 && hsz != 124)
+            return stbi__errpuc("bad BMP", "bad BMP");
+         info->mr = stbi__get32le(s);
+         info->mg = stbi__get32le(s);
+         info->mb = stbi__get32le(s);
+         info->ma = stbi__get32le(s);
+         stbi__get32le(s); // discard color space
+         for (i=0; i < 12; ++i)
+            stbi__get32le(s); // discard color space parameters
+         if (hsz == 124) {
+            stbi__get32le(s); // discard rendering intent
+            stbi__get32le(s); // discard offset of profile data
+            stbi__get32le(s); // discard size of profile data
+            stbi__get32le(s); // discard reserved
+         }
+      }
+   }
+   return (void *) 1;
+}
+
+
+static void *stbi__bmp_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri)
+{
+   stbi_uc *out;
+   unsigned int mr=0,mg=0,mb=0,ma=0, all_a;
+   stbi_uc pal[256][4];
+   int psize=0,i,j,width;
+   int flip_vertically, pad, target;
+   stbi__bmp_data info;
+   STBI_NOTUSED(ri);
+
+   info.all_a = 255;
+   if (stbi__bmp_parse_header(s, &info) == NULL)
+      return NULL; // error code already set
+
+   flip_vertically = ((int) s->img_y) > 0;
+   s->img_y = abs((int) s->img_y);
+
+   mr = info.mr;
+   mg = info.mg;
+   mb = info.mb;
+   ma = info.ma;
+   all_a = info.all_a;
+
+   if (info.hsz == 12) {
+      if (info.bpp < 24)
+         psize = (info.offset - 14 - 24) / 3;
+   } else {
+      if (info.bpp < 16)
+         psize = (info.offset - 14 - info.hsz) >> 2;
+   }
+
+   s->img_n = ma ? 4 : 3;
+   if (req_comp && req_comp >= 3) // we can directly decode 3 or 4
+      target = req_comp;
+   else
+      target = s->img_n; // if they want monochrome, we'll post-convert
+
+   // sanity-check size
+   if (!stbi__mad3sizes_valid(target, s->img_x, s->img_y, 0))
+      return stbi__errpuc("too large", "Corrupt BMP");
+
+   out = (stbi_uc *) stbi__malloc_mad3(target, s->img_x, s->img_y, 0);
+   if (!out) return stbi__errpuc("outofmem", "Out of memory");
+   if (info.bpp < 16) {
+      int z=0;
+      if (psize == 0 || psize > 256) { STBI_FREE(out); return stbi__errpuc("invalid", "Corrupt BMP"); }
+      for (i=0; i < psize; ++i) {
+         pal[i][2] = stbi__get8(s);
+         pal[i][1] = stbi__get8(s);
+         pal[i][0] = stbi__get8(s);
+         if (info.hsz != 12) stbi__get8(s);
+         pal[i][3] = 255;
+      }
+      stbi__skip(s, info.offset - 14 - info.hsz - psize * (info.hsz == 12 ? 3 : 4));
+      if (info.bpp == 1) width = (s->img_x + 7) >> 3;
+      else if (info.bpp == 4) width = (s->img_x + 1) >> 1;
+      else if (info.bpp == 8) width = s->img_x;
+      else { STBI_FREE(out); return stbi__errpuc("bad bpp", "Corrupt BMP"); }
+      pad = (-width)&3;
+      if (info.bpp == 1) {
+         for (j=0; j < (int) s->img_y; ++j) {
+            int bit_offset = 7, v = stbi__get8(s);
+            for (i=0; i < (int) s->img_x; ++i) {
+               int color = (v>>bit_offset)&0x1;
+               out[z++] = pal[color][0];
+               out[z++] = pal[color][1];
+               out[z++] = pal[color][2];
+               if (target == 4) out[z++] = 255;
+               if (i+1 == (int) s->img_x) break;
+               if((--bit_offset) < 0) {
+                  bit_offset = 7;
+                  v = stbi__get8(s);
+               }
+            }
+            stbi__skip(s, pad);
+         }
+      } else {
+         for (j=0; j < (int) s->img_y; ++j) {
+            for (i=0; i < (int) s->img_x; i += 2) {
+               int v=stbi__get8(s),v2=0;
+               if (info.bpp == 4) {
+                  v2 = v & 15;
+                  v >>= 4;
+               }
+               out[z++] = pal[v][0];
+               out[z++] = pal[v][1];
+               out[z++] = pal[v][2];
+               if (target == 4) out[z++] = 255;
+               if (i+1 == (int) s->img_x) break;
+               v = (info.bpp == 8) ? stbi__get8(s) : v2;
+               out[z++] = pal[v][0];
+               out[z++] = pal[v][1];
+               out[z++] = pal[v][2];
+               if (target == 4) out[z++] = 255;
+            }
+            stbi__skip(s, pad);
+         }
+      }
+   } else {
+      int rshift=0,gshift=0,bshift=0,ashift=0,rcount=0,gcount=0,bcount=0,acount=0;
+      int z = 0;
+      int easy=0;
+      stbi__skip(s, info.offset - 14 - info.hsz);
+      if (info.bpp == 24) width = 3 * s->img_x;
+      else if (info.bpp == 16) width = 2*s->img_x;
+      else /* bpp = 32 and pad = 0 */ width=0;
+      pad = (-width) & 3;
+      if (info.bpp == 24) {
+         easy = 1;
+      } else if (info.bpp == 32) {
+         if (mb == 0xff && mg == 0xff00 && mr == 0x00ff0000 && ma == 0xff000000)
+            easy = 2;
+      }
+      if (!easy) {
+         if (!mr || !mg || !mb) { STBI_FREE(out); return stbi__errpuc("bad masks", "Corrupt BMP"); }
+         // right shift amt to put high bit in position #7
+         rshift = stbi__high_bit(mr)-7; rcount = stbi__bitcount(mr);
+         gshift = stbi__high_bit(mg)-7; gcount = stbi__bitcount(mg);
+         bshift = stbi__high_bit(mb)-7; bcount = stbi__bitcount(mb);
+         ashift = stbi__high_bit(ma)-7; acount = stbi__bitcount(ma);
+      }
+      for (j=0; j < (int) s->img_y; ++j) {
+         if (easy) {
+            for (i=0; i < (int) s->img_x; ++i) {
+               unsigned char a;
+               out[z+2] = stbi__get8(s);
+               out[z+1] = stbi__get8(s);
+               out[z+0] = stbi__get8(s);
+               z += 3;
+               a = (easy == 2 ? stbi__get8(s) : 255);
+               all_a |= a;
+               if (target == 4) out[z++] = a;
+            }
+         } else {
+            int bpp = info.bpp;
+            for (i=0; i < (int) s->img_x; ++i) {
+               stbi__uint32 v = (bpp == 16 ? (stbi__uint32) stbi__get16le(s) : stbi__get32le(s));
+               unsigned int a;
+               out[z++] = STBI__BYTECAST(stbi__shiftsigned(v & mr, rshift, rcount));
+               out[z++] = STBI__BYTECAST(stbi__shiftsigned(v & mg, gshift, gcount));
+               out[z++] = STBI__BYTECAST(stbi__shiftsigned(v & mb, bshift, bcount));
+               a = (ma ? stbi__shiftsigned(v & ma, ashift, acount) : 255);
+               all_a |= a;
+               if (target == 4) out[z++] = STBI__BYTECAST(a);
+            }
+         }
+         stbi__skip(s, pad);
+      }
+   }
+
+   // if alpha channel is all 0s, replace with all 255s
+   if (target == 4 && all_a == 0)
+      for (i=4*s->img_x*s->img_y-1; i >= 0; i -= 4)
+         out[i] = 255;
+
+   if (flip_vertically) {
+      stbi_uc t;
+      for (j=0; j < (int) s->img_y>>1; ++j) {
+         stbi_uc *p1 = out +      j     *s->img_x*target;
+         stbi_uc *p2 = out + (s->img_y-1-j)*s->img_x*target;
+         for (i=0; i < (int) s->img_x*target; ++i) {
+            t = p1[i]; p1[i] = p2[i]; p2[i] = t;
+         }
+      }
+   }
+
+   if (req_comp && req_comp != target) {
+      out = stbi__convert_format(out, target, req_comp, s->img_x, s->img_y);
+      if (out == NULL) return out; // stbi__convert_format frees input on failure
+   }
+
+   *x = s->img_x;
+   *y = s->img_y;
+   if (comp) *comp = s->img_n;
+   return out;
+}
+#endif
+
+// Targa Truevision - TGA
+// by Jonathan Dummer
+#ifndef STBI_NO_TGA
+// returns STBI_rgb or whatever, 0 on error
+static int stbi__tga_get_comp(int bits_per_pixel, int is_grey, int* is_rgb16)
+{
+   // only RGB or RGBA (incl. 16bit) or grey allowed
+   if (is_rgb16) *is_rgb16 = 0;
+   switch(bits_per_pixel) {
+      case 8:  return STBI_grey;
+      case 16: if(is_grey) return STBI_grey_alpha;
+               // fallthrough
+      case 15: if(is_rgb16) *is_rgb16 = 1;
+               return STBI_rgb;
+      case 24: // fallthrough
+      case 32: return bits_per_pixel/8;
+      default: return 0;
+   }
+}
+
+static int stbi__tga_info(stbi__context *s, int *x, int *y, int *comp)
+{
+    int tga_w, tga_h, tga_comp, tga_image_type, tga_bits_per_pixel, tga_colormap_bpp;
+    int sz, tga_colormap_type;
+    stbi__get8(s);                   // discard Offset
+    tga_colormap_type = stbi__get8(s); // colormap type
+    if( tga_colormap_type > 1 ) {
+        stbi__rewind(s);
+        return 0;      // only RGB or indexed allowed
+    }
+    tga_image_type = stbi__get8(s); // image type
+    if ( tga_colormap_type == 1 ) { // colormapped (paletted) image
+        if (tga_image_type != 1 && tga_image_type != 9) {
+            stbi__rewind(s);
+            return 0;
+        }
+        stbi__skip(s,4);       // skip index of first colormap entry and number of entries
+        sz = stbi__get8(s);    //   check bits per palette color entry
+        if ( (sz != 8) && (sz != 15) && (sz != 16) && (sz != 24) && (sz != 32) ) {
+            stbi__rewind(s);
+            return 0;
+        }
+        stbi__skip(s,4);       // skip image x and y origin
+        tga_colormap_bpp = sz;
+    } else { // "normal" image w/o colormap - only RGB or grey allowed, +/- RLE
+        if ( (tga_image_type != 2) && (tga_image_type != 3) && (tga_image_type != 10) && (tga_image_type != 11) ) {
+            stbi__rewind(s);
+            return 0; // only RGB or grey allowed, +/- RLE
+        }
+        stbi__skip(s,9); // skip colormap specification and image x/y origin
+        tga_colormap_bpp = 0;
+    }
+    tga_w = stbi__get16le(s);
+    if( tga_w < 1 ) {
+        stbi__rewind(s);
+        return 0;   // test width
+    }
+    tga_h = stbi__get16le(s);
+    if( tga_h < 1 ) {
+        stbi__rewind(s);
+        return 0;   // test height
+    }
+    tga_bits_per_pixel = stbi__get8(s); // bits per pixel
+    stbi__get8(s); // ignore alpha bits
+    if (tga_colormap_bpp != 0) {
+        if((tga_bits_per_pixel != 8) && (tga_bits_per_pixel != 16)) {
+            // when using a colormap, tga_bits_per_pixel is the size of the indexes
+            // I don't think anything but 8 or 16bit indexes makes sense
+            stbi__rewind(s);
+            return 0;
+        }
+        tga_comp = stbi__tga_get_comp(tga_colormap_bpp, 0, NULL);
+    } else {
+        tga_comp = stbi__tga_get_comp(tga_bits_per_pixel, (tga_image_type == 3) || (tga_image_type == 11), NULL);
+    }
+    if(!tga_comp) {
+      stbi__rewind(s);
+      return 0;
+    }
+    if (x) *x = tga_w;
+    if (y) *y = tga_h;
+    if (comp) *comp = tga_comp;
+    return 1;                   // seems to have passed everything
+}
+
+static int stbi__tga_test(stbi__context *s)
+{
+   int res = 0;
+   int sz, tga_color_type;
+   stbi__get8(s);      //   discard Offset
+   tga_color_type = stbi__get8(s);   //   color type
+   if ( tga_color_type > 1 ) goto errorEnd;   //   only RGB or indexed allowed
+   sz = stbi__get8(s);   //   image type
+   if ( tga_color_type == 1 ) { // colormapped (paletted) image
+      if (sz != 1 && sz != 9) goto errorEnd; // colortype 1 demands image type 1 or 9
+      stbi__skip(s,4);       // skip index of first colormap entry and number of entries
+      sz = stbi__get8(s);    //   check bits per palette color entry
+      if ( (sz != 8) && (sz != 15) && (sz != 16) && (sz != 24) && (sz != 32) ) goto errorEnd;
+      stbi__skip(s,4);       // skip image x and y origin
+   } else { // "normal" image w/o colormap
+      if ( (sz != 2) && (sz != 3) && (sz != 10) && (sz != 11) ) goto errorEnd; // only RGB or grey allowed, +/- RLE
+      stbi__skip(s,9); // skip colormap specification and image x/y origin
+   }
+   if ( stbi__get16le(s) < 1 ) goto errorEnd;      //   test width
+   if ( stbi__get16le(s) < 1 ) goto errorEnd;      //   test height
+   sz = stbi__get8(s);   //   bits per pixel
+   if ( (tga_color_type == 1) && (sz != 8) && (sz != 16) ) goto errorEnd; // for colormapped images, bpp is size of an index
+   if ( (sz != 8) && (sz != 15) && (sz != 16) && (sz != 24) && (sz != 32) ) goto errorEnd;
+
+   res = 1; // if we got this far, everything's good and we can return 1 instead of 0
+
+errorEnd:
+   stbi__rewind(s);
+   return res;
+}
+
+// read 16bit value and convert to 24bit RGB
+static void stbi__tga_read_rgb16(stbi__context *s, stbi_uc* out)
+{
+   stbi__uint16 px = (stbi__uint16)stbi__get16le(s);
+   stbi__uint16 fiveBitMask = 31;
+   // we have 3 channels with 5bits each
+   int r = (px >> 10) & fiveBitMask;
+   int g = (px >> 5) & fiveBitMask;
+   int b = px & fiveBitMask;
+   // Note that this saves the data in RGB(A) order, so it doesn't need to be swapped later
+   out[0] = (stbi_uc)((r * 255)/31);
+   out[1] = (stbi_uc)((g * 255)/31);
+   out[2] = (stbi_uc)((b * 255)/31);
+
+   // some people claim that the most significant bit might be used for alpha
+   // (possibly if an alpha-bit is set in the "image descriptor byte")
+   // but that only made 16bit test images completely translucent..
+   // so let's treat all 15 and 16bit TGAs as RGB with no alpha.
+}
+
+static void *stbi__tga_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri)
+{
+   //   read in the TGA header stuff
+   int tga_offset = stbi__get8(s);
+   int tga_indexed = stbi__get8(s);
+   int tga_image_type = stbi__get8(s);
+   int tga_is_RLE = 0;
+   int tga_palette_start = stbi__get16le(s);
+   int tga_palette_len = stbi__get16le(s);
+   int tga_palette_bits = stbi__get8(s);
+   int tga_x_origin = stbi__get16le(s);
+   int tga_y_origin = stbi__get16le(s);
+   int tga_width = stbi__get16le(s);
+   int tga_height = stbi__get16le(s);
+   int tga_bits_per_pixel = stbi__get8(s);
+   int tga_comp, tga_rgb16=0;
+   int tga_inverted = stbi__get8(s);
+   // int tga_alpha_bits = tga_inverted & 15; // the 4 lowest bits - unused (useless?)
+   //   image data
+   unsigned char *tga_data;
+   unsigned char *tga_palette = NULL;
+   int i, j;
+   unsigned char raw_data[4] = {0};
+   int RLE_count = 0;
+   int RLE_repeating = 0;
+   int read_next_pixel = 1;
+   STBI_NOTUSED(ri);
+
+   //   do a tiny bit of precessing
+   if ( tga_image_type >= 8 )
+   {
+      tga_image_type -= 8;
+      tga_is_RLE = 1;
+   }
+   tga_inverted = 1 - ((tga_inverted >> 5) & 1);
+
+   //   If I'm paletted, then I'll use the number of bits from the palette
+   if ( tga_indexed ) tga_comp = stbi__tga_get_comp(tga_palette_bits, 0, &tga_rgb16);
+   else tga_comp = stbi__tga_get_comp(tga_bits_per_pixel, (tga_image_type == 3), &tga_rgb16);
+
+   if(!tga_comp) // shouldn't really happen, stbi__tga_test() should have ensured basic consistency
+      return stbi__errpuc("bad format", "Can't find out TGA pixelformat");
+
+   //   tga info
+   *x = tga_width;
+   *y = tga_height;
+   if (comp) *comp = tga_comp;
+
+   if (!stbi__mad3sizes_valid(tga_width, tga_height, tga_comp, 0))
+      return stbi__errpuc("too large", "Corrupt TGA");
+
+   tga_data = (unsigned char*)stbi__malloc_mad3(tga_width, tga_height, tga_comp, 0);
+   if (!tga_data) return stbi__errpuc("outofmem", "Out of memory");
+
+   // skip to the data's starting position (offset usually = 0)
+   stbi__skip(s, tga_offset );
+
+   if ( !tga_indexed && !tga_is_RLE && !tga_rgb16 ) {
+      for (i=0; i < tga_height; ++i) {
+         int row = tga_inverted ? tga_height -i - 1 : i;
+         stbi_uc *tga_row = tga_data + row*tga_width*tga_comp;
+         stbi__getn(s, tga_row, tga_width * tga_comp);
+      }
+   } else  {
+      //   do I need to load a palette?
+      if ( tga_indexed)
+      {
+         //   any data to skip? (offset usually = 0)
+         stbi__skip(s, tga_palette_start );
+         //   load the palette
+         tga_palette = (unsigned char*)stbi__malloc_mad2(tga_palette_len, tga_comp, 0);
+         if (!tga_palette) {
+            STBI_FREE(tga_data);
+            return stbi__errpuc("outofmem", "Out of memory");
+         }
+         if (tga_rgb16) {
+            stbi_uc *pal_entry = tga_palette;
+            STBI_ASSERT(tga_comp == STBI_rgb);
+            for (i=0; i < tga_palette_len; ++i) {
+               stbi__tga_read_rgb16(s, pal_entry);
+               pal_entry += tga_comp;
+            }
+         } else if (!stbi__getn(s, tga_palette, tga_palette_len * tga_comp)) {
+               STBI_FREE(tga_data);
+               STBI_FREE(tga_palette);
+               return stbi__errpuc("bad palette", "Corrupt TGA");
+         }
+      }
+      //   load the data
+      for (i=0; i < tga_width * tga_height; ++i)
+      {
+         //   if I'm in RLE mode, do I need to get a RLE stbi__pngchunk?
+         if ( tga_is_RLE )
+         {
+            if ( RLE_count == 0 )
+            {
+               //   yep, get the next byte as a RLE command
+               int RLE_cmd = stbi__get8(s);
+               RLE_count = 1 + (RLE_cmd & 127);
+               RLE_repeating = RLE_cmd >> 7;
+               read_next_pixel = 1;
+            } else if ( !RLE_repeating )
+            {
+               read_next_pixel = 1;
+            }
+         } else
+         {
+            read_next_pixel = 1;
+         }
+         //   OK, if I need to read a pixel, do it now
+         if ( read_next_pixel )
+         {
+            //   load however much data we did have
+            if ( tga_indexed )
+            {
+               // read in index, then perform the lookup
+               int pal_idx = (tga_bits_per_pixel == 8) ? stbi__get8(s) : stbi__get16le(s);
+               if ( pal_idx >= tga_palette_len ) {
+                  // invalid index
+                  pal_idx = 0;
+               }
+               pal_idx *= tga_comp;
+               for (j = 0; j < tga_comp; ++j) {
+                  raw_data[j] = tga_palette[pal_idx+j];
+               }
+            } else if(tga_rgb16) {
+               STBI_ASSERT(tga_comp == STBI_rgb);
+               stbi__tga_read_rgb16(s, raw_data);
+            } else {
+               //   read in the data raw
+               for (j = 0; j < tga_comp; ++j) {
+                  raw_data[j] = stbi__get8(s);
+               }
+            }
+            //   clear the reading flag for the next pixel
+            read_next_pixel = 0;
+         } // end of reading a pixel
+
+         // copy data
+         for (j = 0; j < tga_comp; ++j)
+           tga_data[i*tga_comp+j] = raw_data[j];
+
+         //   in case we're in RLE mode, keep counting down
+         --RLE_count;
+      }
+      //   do I need to invert the image?
+      if ( tga_inverted )
+      {
+         for (j = 0; j*2 < tga_height; ++j)
+         {
+            int index1 = j * tga_width * tga_comp;
+            int index2 = (tga_height - 1 - j) * tga_width * tga_comp;
+            for (i = tga_width * tga_comp; i > 0; --i)
+            {
+               unsigned char temp = tga_data[index1];
+               tga_data[index1] = tga_data[index2];
+               tga_data[index2] = temp;
+               ++index1;
+               ++index2;
+            }
+         }
+      }
+      //   clear my palette, if I had one
+      if ( tga_palette != NULL )
+      {
+         STBI_FREE( tga_palette );
+      }
+   }
+
+   // swap RGB - if the source data was RGB16, it already is in the right order
+   if (tga_comp >= 3 && !tga_rgb16)
+   {
+      unsigned char* tga_pixel = tga_data;
+      for (i=0; i < tga_width * tga_height; ++i)
+      {
+         unsigned char temp = tga_pixel[0];
+         tga_pixel[0] = tga_pixel[2];
+         tga_pixel[2] = temp;
+         tga_pixel += tga_comp;
+      }
+   }
+
+   // convert to target component count
+   if (req_comp && req_comp != tga_comp)
+      tga_data = stbi__convert_format(tga_data, tga_comp, req_comp, tga_width, tga_height);
+
+   //   the things I do to get rid of an error message, and yet keep
+   //   Microsoft's C compilers happy... [8^(
+   tga_palette_start = tga_palette_len = tga_palette_bits =
+         tga_x_origin = tga_y_origin = 0;
+   //   OK, done
+   return tga_data;
+}
+#endif
+
+// *************************************************************************************************
+// Photoshop PSD loader -- PD by Thatcher Ulrich, integration by Nicolas Schulz, tweaked by STB
+
+#ifndef STBI_NO_PSD
+static int stbi__psd_test(stbi__context *s)
+{
+   int r = (stbi__get32be(s) == 0x38425053);
+   stbi__rewind(s);
+   return r;
+}
+
+static int stbi__psd_decode_rle(stbi__context *s, stbi_uc *p, int pixelCount)
+{
+   int count, nleft, len;
+
+   count = 0;
+   while ((nleft = pixelCount - count) > 0) {
+      len = stbi__get8(s);
+      if (len == 128) {
+         // No-op.
+      } else if (len < 128) {
+         // Copy next len+1 bytes literally.
+         len++;
+         if (len > nleft) return 0; // corrupt data
+         count += len;
+         while (len) {
+            *p = stbi__get8(s);
+            p += 4;
+            len--;
+         }
+      } else if (len > 128) {
+         stbi_uc   val;
+         // Next -len+1 bytes in the dest are replicated from next source byte.
+         // (Interpret len as a negative 8-bit int.)
+         len = 257 - len;
+         if (len > nleft) return 0; // corrupt data
+         val = stbi__get8(s);
+         count += len;
+         while (len) {
+            *p = val;
+            p += 4;
+            len--;
+         }
+      }
+   }
+
+   return 1;
+}
+
+static void *stbi__psd_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri, int bpc)
+{
+   int pixelCount;
+   int channelCount, compression;
+   int channel, i;
+   int bitdepth;
+   int w,h;
+   stbi_uc *out;
+   STBI_NOTUSED(ri);
+
+   // Check identifier
+   if (stbi__get32be(s) != 0x38425053)   // "8BPS"
+      return stbi__errpuc("not PSD", "Corrupt PSD image");
+
+   // Check file type version.
+   if (stbi__get16be(s) != 1)
+      return stbi__errpuc("wrong version", "Unsupported version of PSD image");
+
+   // Skip 6 reserved bytes.
+   stbi__skip(s, 6 );
+
+   // Read the number of channels (R, G, B, A, etc).
+   channelCount = stbi__get16be(s);
+   if (channelCount < 0 || channelCount > 16)
+      return stbi__errpuc("wrong channel count", "Unsupported number of channels in PSD image");
+
+   // Read the rows and columns of the image.
+   h = stbi__get32be(s);
+   w = stbi__get32be(s);
+
+   // Make sure the depth is 8 bits.
+   bitdepth = stbi__get16be(s);
+   if (bitdepth != 8 && bitdepth != 16)
+      return stbi__errpuc("unsupported bit depth", "PSD bit depth is not 8 or 16 bit");
+
+   // Make sure the color mode is RGB.
+   // Valid options are:
+   //   0: Bitmap
+   //   1: Grayscale
+   //   2: Indexed color
+   //   3: RGB color
+   //   4: CMYK color
+   //   7: Multichannel
+   //   8: Duotone
+   //   9: Lab color
+   if (stbi__get16be(s) != 3)
+      return stbi__errpuc("wrong color format", "PSD is not in RGB color format");
+
+   // Skip the Mode Data.  (It's the palette for indexed color; other info for other modes.)
+   stbi__skip(s,stbi__get32be(s) );
+
+   // Skip the image resources.  (resolution, pen tool paths, etc)
+   stbi__skip(s, stbi__get32be(s) );
+
+   // Skip the reserved data.
+   stbi__skip(s, stbi__get32be(s) );
+
+   // Find out if the data is compressed.
+   // Known values:
+   //   0: no compression
+   //   1: RLE compressed
+   compression = stbi__get16be(s);
+   if (compression > 1)
+      return stbi__errpuc("bad compression", "PSD has an unknown compression format");
+
+   // Check size
+   if (!stbi__mad3sizes_valid(4, w, h, 0))
+      return stbi__errpuc("too large", "Corrupt PSD");
+
+   // Create the destination image.
+
+   if (!compression && bitdepth == 16 && bpc == 16) {
+      out = (stbi_uc *) stbi__malloc_mad3(8, w, h, 0);
+      ri->bits_per_channel = 16;
+   } else
+      out = (stbi_uc *) stbi__malloc(4 * w*h);
+
+   if (!out) return stbi__errpuc("outofmem", "Out of memory");
+   pixelCount = w*h;
+
+   // Initialize the data to zero.
+   //memset( out, 0, pixelCount * 4 );
+
+   // Finally, the image data.
+   if (compression) {
+      // RLE as used by .PSD and .TIFF
+      // Loop until you get the number of unpacked bytes you are expecting:
+      //     Read the next source byte into n.
+      //     If n is between 0 and 127 inclusive, copy the next n+1 bytes literally.
+      //     Else if n is between -127 and -1 inclusive, copy the next byte -n+1 times.
+      //     Else if n is 128, noop.
+      // Endloop
+
+      // The RLE-compressed data is preceded by a 2-byte data count for each row in the data,
+      // which we're going to just skip.
+      stbi__skip(s, h * channelCount * 2 );
+
+      // Read the RLE data by channel.
+      for (channel = 0; channel < 4; channel++) {
+         stbi_uc *p;
+
+         p = out+channel;
+         if (channel >= channelCount) {
+            // Fill this channel with default data.
+            for (i = 0; i < pixelCount; i++, p += 4)
+               *p = (channel == 3 ? 255 : 0);
+         } else {
+            // Read the RLE data.
+            if (!stbi__psd_decode_rle(s, p, pixelCount)) {
+               STBI_FREE(out);
+               return stbi__errpuc("corrupt", "bad RLE data");
+            }
+         }
+      }
+
+   } else {
+      // We're at the raw image data.  It's each channel in order (Red, Green, Blue, Alpha, ...)
+      // where each channel consists of an 8-bit (or 16-bit) value for each pixel in the image.
+
+      // Read the data by channel.
+      for (channel = 0; channel < 4; channel++) {
+         if (channel >= channelCount) {
+            // Fill this channel with default data.
+            if (bitdepth == 16 && bpc == 16) {
+               stbi__uint16 *q = ((stbi__uint16 *) out) + channel;
+               stbi__uint16 val = channel == 3 ? 65535 : 0;
+               for (i = 0; i < pixelCount; i++, q += 4)
+                  *q = val;
+            } else {
+               stbi_uc *p = out+channel;
+               stbi_uc val = channel == 3 ? 255 : 0;
+               for (i = 0; i < pixelCount; i++, p += 4)
+                  *p = val;
+            }
+         } else {
+            if (ri->bits_per_channel == 16) {    // output bpc
+               stbi__uint16 *q = ((stbi__uint16 *) out) + channel;
+               for (i = 0; i < pixelCount; i++, q += 4)
+                  *q = (stbi__uint16) stbi__get16be(s);
+            } else {
+               stbi_uc *p = out+channel;
+               if (bitdepth == 16) {  // input bpc
+                  for (i = 0; i < pixelCount; i++, p += 4)
+                     *p = (stbi_uc) (stbi__get16be(s) >> 8);
+               } else {
+                  for (i = 0; i < pixelCount; i++, p += 4)
+                     *p = stbi__get8(s);
+               }
+            }
+         }
+      }
+   }
+
+   // remove weird white matte from PSD
+   if (channelCount >= 4) {
+      if (ri->bits_per_channel == 16) {
+         for (i=0; i < w*h; ++i) {
+            stbi__uint16 *pixel = (stbi__uint16 *) out + 4*i;
+            if (pixel[3] != 0 && pixel[3] != 65535) {
+               float a = pixel[3] / 65535.0f;
+               float ra = 1.0f / a;
+               float inv_a = 65535.0f * (1 - ra);
+               pixel[0] = (stbi__uint16) (pixel[0]*ra + inv_a);
+               pixel[1] = (stbi__uint16) (pixel[1]*ra + inv_a);
+               pixel[2] = (stbi__uint16) (pixel[2]*ra + inv_a);
+            }
+         }
+      } else {
+         for (i=0; i < w*h; ++i) {
+            unsigned char *pixel = out + 4*i;
+            if (pixel[3] != 0 && pixel[3] != 255) {
+               float a = pixel[3] / 255.0f;
+               float ra = 1.0f / a;
+               float inv_a = 255.0f * (1 - ra);
+               pixel[0] = (unsigned char) (pixel[0]*ra + inv_a);
+               pixel[1] = (unsigned char) (pixel[1]*ra + inv_a);
+               pixel[2] = (unsigned char) (pixel[2]*ra + inv_a);
+            }
+         }
+      }
+   }
+
+   // convert to desired output format
+   if (req_comp && req_comp != 4) {
+      if (ri->bits_per_channel == 16)
+         out = (stbi_uc *) stbi__convert_format16((stbi__uint16 *) out, 4, req_comp, w, h);
+      else
+         out = stbi__convert_format(out, 4, req_comp, w, h);
+      if (out == NULL) return out; // stbi__convert_format frees input on failure
+   }
+
+   if (comp) *comp = 4;
+   *y = h;
+   *x = w;
+
+   return out;
+}
+#endif
+
+// *************************************************************************************************
+// Softimage PIC loader
+// by Tom Seddon
+//
+// See http://softimage.wiki.softimage.com/index.php/INFO:_PIC_file_format
+// See http://ozviz.wasp.uwa.edu.au/~pbourke/dataformats/softimagepic/
+
+#ifndef STBI_NO_PIC
+static int stbi__pic_is4(stbi__context *s,const char *str)
+{
+   int i;
+   for (i=0; i<4; ++i)
+      if (stbi__get8(s) != (stbi_uc)str[i])
+         return 0;
+
+   return 1;
+}
+
+static int stbi__pic_test_core(stbi__context *s)
+{
+   int i;
+
+   if (!stbi__pic_is4(s,"\x53\x80\xF6\x34"))
+      return 0;
+
+   for(i=0;i<84;++i)
+      stbi__get8(s);
+
+   if (!stbi__pic_is4(s,"PICT"))
+      return 0;
+
+   return 1;
+}
+
+typedef struct
+{
+   stbi_uc size,type,channel;
+} stbi__pic_packet;
+
+static stbi_uc *stbi__readval(stbi__context *s, int channel, stbi_uc *dest)
+{
+   int mask=0x80, i;
+
+   for (i=0; i<4; ++i, mask>>=1) {
+      if (channel & mask) {
+         if (stbi__at_eof(s)) return stbi__errpuc("bad file","PIC file too short");
+         dest[i]=stbi__get8(s);
+      }
+   }
+
+   return dest;
+}
+
+static void stbi__copyval(int channel,stbi_uc *dest,const stbi_uc *src)
+{
+   int mask=0x80,i;
+
+   for (i=0;i<4; ++i, mask>>=1)
+      if (channel&mask)
+         dest[i]=src[i];
+}
+
+static stbi_uc *stbi__pic_load_core(stbi__context *s,int width,int height,int *comp, stbi_uc *result)
+{
+   int act_comp=0,num_packets=0,y,chained;
+   stbi__pic_packet packets[10];
+
+   // this will (should...) cater for even some bizarre stuff like having data
+    // for the same channel in multiple packets.
+   do {
+      stbi__pic_packet *packet;
+
+      if (num_packets==sizeof(packets)/sizeof(packets[0]))
+         return stbi__errpuc("bad format","too many packets");
+
+      packet = &packets[num_packets++];
+
+      chained = stbi__get8(s);
+      packet->size    = stbi__get8(s);
+      packet->type    = stbi__get8(s);
+      packet->channel = stbi__get8(s);
+
+      act_comp |= packet->channel;
+
+      if (stbi__at_eof(s))          return stbi__errpuc("bad file","file too short (reading packets)");
+      if (packet->size != 8)  return stbi__errpuc("bad format","packet isn't 8bpp");
+   } while (chained);
+
+   *comp = (act_comp & 0x10 ? 4 : 3); // has alpha channel?
+
+   for(y=0; y<height; ++y) {
+      int packet_idx;
+
+      for(packet_idx=0; packet_idx < num_packets; ++packet_idx) {
+         stbi__pic_packet *packet = &packets[packet_idx];
+         stbi_uc *dest = result+y*width*4;
+
+         switch (packet->type) {
+            default:
+               return stbi__errpuc("bad format","packet has bad compression type");
+
+            case 0: {//uncompressed
+               int x;
+
+               for(x=0;x<width;++x, dest+=4)
+                  if (!stbi__readval(s,packet->channel,dest))
+                     return 0;
+               break;
+            }
+
+            case 1://Pure RLE
+               {
+                  int left=width, i;
+
+                  while (left>0) {
+                     stbi_uc count,value[4];
+
+                     count=stbi__get8(s);
+                     if (stbi__at_eof(s))   return stbi__errpuc("bad file","file too short (pure read count)");
+
+                     if (count > left)
+                        count = (stbi_uc) left;
+
+                     if (!stbi__readval(s,packet->channel,value))  return 0;
+
+                     for(i=0; i<count; ++i,dest+=4)
+                        stbi__copyval(packet->channel,dest,value);
+                     left -= count;
+                  }
+               }
+               break;
+
+            case 2: {//Mixed RLE
+               int left=width;
+               while (left>0) {
+                  int count = stbi__get8(s), i;
+                  if (stbi__at_eof(s))  return stbi__errpuc("bad file","file too short (mixed read count)");
+
+                  if (count >= 128) { // Repeated
+                     stbi_uc value[4];
+
+                     if (count==128)
+                        count = stbi__get16be(s);
+                     else
+                        count -= 127;
+                     if (count > left)
+                        return stbi__errpuc("bad file","scanline overrun");
+
+                     if (!stbi__readval(s,packet->channel,value))
+                        return 0;
+
+                     for(i=0;i<count;++i, dest += 4)
+                        stbi__copyval(packet->channel,dest,value);
+                  } else { // Raw
+                     ++count;
+                     if (count>left) return stbi__errpuc("bad file","scanline overrun");
+
+                     for(i=0;i<count;++i, dest+=4)
+                        if (!stbi__readval(s,packet->channel,dest))
+                           return 0;
+                  }
+                  left-=count;
+               }
+               break;
+            }
+         }
+      }
+   }
+
+   return result;
+}
+
+static void *stbi__pic_load(stbi__context *s,int *px,int *py,int *comp,int req_comp, stbi__result_info *ri)
+{
+   stbi_uc *result;
+   int i, x,y, internal_comp;
+   STBI_NOTUSED(ri);
+
+   if (!comp) comp = &internal_comp;
+
+   for (i=0; i<92; ++i)
+      stbi__get8(s);
+
+   x = stbi__get16be(s);
+   y = stbi__get16be(s);
+   if (stbi__at_eof(s))  return stbi__errpuc("bad file","file too short (pic header)");
+   if (!stbi__mad3sizes_valid(x, y, 4, 0)) return stbi__errpuc("too large", "PIC image too large to decode");
+
+   stbi__get32be(s); //skip `ratio'
+   stbi__get16be(s); //skip `fields'
+   stbi__get16be(s); //skip `pad'
+
+   // intermediate buffer is RGBA
+   result = (stbi_uc *) stbi__malloc_mad3(x, y, 4, 0);
+   memset(result, 0xff, x*y*4);
+
+   if (!stbi__pic_load_core(s,x,y,comp, result)) {
+      STBI_FREE(result);
+      result=0;
+   }
+   *px = x;
+   *py = y;
+   if (req_comp == 0) req_comp = *comp;
+   result=stbi__convert_format(result,4,req_comp,x,y);
+
+   return result;
+}
+
+static int stbi__pic_test(stbi__context *s)
+{
+   int r = stbi__pic_test_core(s);
+   stbi__rewind(s);
+   return r;
+}
+#endif
+
+// *************************************************************************************************
+// GIF loader -- public domain by Jean-Marc Lienher -- simplified/shrunk by stb
+
+#ifndef STBI_NO_GIF
+typedef struct
+{
+   stbi__int16 prefix;
+   stbi_uc first;
+   stbi_uc suffix;
+} stbi__gif_lzw;
+
+typedef struct
+{
+   int w,h;
+   stbi_uc *out;                 // output buffer (always 4 components)
+   stbi_uc *background;          // The current "background" as far as a gif is concerned
+   stbi_uc *history; 
+   int flags, bgindex, ratio, transparent, eflags;
+   stbi_uc  pal[256][4];
+   stbi_uc lpal[256][4];
+   stbi__gif_lzw codes[8192];
+   stbi_uc *color_table;
+   int parse, step;
+   int lflags;
+   int start_x, start_y;
+   int max_x, max_y;
+   int cur_x, cur_y;
+   int line_size;
+   int delay;
+} stbi__gif;
+
+static int stbi__gif_test_raw(stbi__context *s)
+{
+   int sz;
+   if (stbi__get8(s) != 'G' || stbi__get8(s) != 'I' || stbi__get8(s) != 'F' || stbi__get8(s) != '8') return 0;
+   sz = stbi__get8(s);
+   if (sz != '9' && sz != '7') return 0;
+   if (stbi__get8(s) != 'a') return 0;
+   return 1;
+}
+
+static int stbi__gif_test(stbi__context *s)
+{
+   int r = stbi__gif_test_raw(s);
+   stbi__rewind(s);
+   return r;
+}
+
+static void stbi__gif_parse_colortable(stbi__context *s, stbi_uc pal[256][4], int num_entries, int transp)
+{
+   int i;
+   for (i=0; i < num_entries; ++i) {
+      pal[i][2] = stbi__get8(s);
+      pal[i][1] = stbi__get8(s);
+      pal[i][0] = stbi__get8(s);
+      pal[i][3] = transp == i ? 0 : 255;
+   }
+}
+
+static int stbi__gif_header(stbi__context *s, stbi__gif *g, int *comp, int is_info)
+{
+   stbi_uc version;
+   if (stbi__get8(s) != 'G' || stbi__get8(s) != 'I' || stbi__get8(s) != 'F' || stbi__get8(s) != '8')
+      return stbi__err("not GIF", "Corrupt GIF");
+
+   version = stbi__get8(s);
+   if (version != '7' && version != '9')    return stbi__err("not GIF", "Corrupt GIF");
+   if (stbi__get8(s) != 'a')                return stbi__err("not GIF", "Corrupt GIF");
+
+   stbi__g_failure_reason = "";
+   g->w = stbi__get16le(s);
+   g->h = stbi__get16le(s);
+   g->flags = stbi__get8(s);
+   g->bgindex = stbi__get8(s);
+   g->ratio = stbi__get8(s);
+   g->transparent = -1;
+
+   if (comp != 0) *comp = 4;  // can't actually tell whether it's 3 or 4 until we parse the comments
+
+   if (is_info) return 1;
+
+   if (g->flags & 0x80)
+      stbi__gif_parse_colortable(s,g->pal, 2 << (g->flags & 7), -1);
+
+   return 1;
+}
+
+static int stbi__gif_info_raw(stbi__context *s, int *x, int *y, int *comp)
+{
+   stbi__gif* g = (stbi__gif*) stbi__malloc(sizeof(stbi__gif));
+   if (!stbi__gif_header(s, g, comp, 1)) {
+      STBI_FREE(g);
+      stbi__rewind( s );
+      return 0;
+   }
+   if (x) *x = g->w;
+   if (y) *y = g->h;
+   STBI_FREE(g);
+   return 1;
+}
+
+static void stbi__out_gif_code(stbi__gif *g, stbi__uint16 code)
+{
+   stbi_uc *p, *c;
+   int idx; 
+
+   // recurse to decode the prefixes, since the linked-list is backwards,
+   // and working backwards through an interleaved image would be nasty
+   if (g->codes[code].prefix >= 0)
+      stbi__out_gif_code(g, g->codes[code].prefix);
+
+   if (g->cur_y >= g->max_y) return;
+
+   idx = g->cur_x + g->cur_y; 
+   p = &g->out[idx];
+   g->history[idx / 4] = 1;  
+
+   c = &g->color_table[g->codes[code].suffix * 4];
+   if (c[3] > 128) { // don't render transparent pixels; 
+      p[0] = c[2];
+      p[1] = c[1];
+      p[2] = c[0];
+      p[3] = c[3];
+   }
+   g->cur_x += 4;
+
+   if (g->cur_x >= g->max_x) {
+      g->cur_x = g->start_x;
+      g->cur_y += g->step;
+
+      while (g->cur_y >= g->max_y && g->parse > 0) {
+         g->step = (1 << g->parse) * g->line_size;
+         g->cur_y = g->start_y + (g->step >> 1);
+         --g->parse;
+      }
+   }
+}
+
+static stbi_uc *stbi__process_gif_raster(stbi__context *s, stbi__gif *g)
+{
+   stbi_uc lzw_cs;
+   stbi__int32 len, init_code;
+   stbi__uint32 first;
+   stbi__int32 codesize, codemask, avail, oldcode, bits, valid_bits, clear;
+   stbi__gif_lzw *p;
+
+   lzw_cs = stbi__get8(s);
+   if (lzw_cs > 12) return NULL;
+   clear = 1 << lzw_cs;
+   first = 1;
+   codesize = lzw_cs + 1;
+   codemask = (1 << codesize) - 1;
+   bits = 0;
+   valid_bits = 0;
+   for (init_code = 0; init_code < clear; init_code++) {
+      g->codes[init_code].prefix = -1;
+      g->codes[init_code].first = (stbi_uc) init_code;
+      g->codes[init_code].suffix = (stbi_uc) init_code;
+   }
+
+   // support no starting clear code
+   avail = clear+2;
+   oldcode = -1;
+
+   len = 0;
+   for(;;) {
+      if (valid_bits < codesize) {
+         if (len == 0) {
+            len = stbi__get8(s); // start new block
+            if (len == 0)
+               return g->out;
+         }
+         --len;
+         bits |= (stbi__int32) stbi__get8(s) << valid_bits;
+         valid_bits += 8;
+      } else {
+         stbi__int32 code = bits & codemask;
+         bits >>= codesize;
+         valid_bits -= codesize;
+         // @OPTIMIZE: is there some way we can accelerate the non-clear path?
+         if (code == clear) {  // clear code
+            codesize = lzw_cs + 1;
+            codemask = (1 << codesize) - 1;
+            avail = clear + 2;
+            oldcode = -1;
+            first = 0;
+         } else if (code == clear + 1) { // end of stream code
+            stbi__skip(s, len);
+            while ((len = stbi__get8(s)) > 0)
+               stbi__skip(s,len);
+            return g->out;
+         } else if (code <= avail) {
+            if (first) {
+               return stbi__errpuc("no clear code", "Corrupt GIF");
+            }
+
+            if (oldcode >= 0) {
+               p = &g->codes[avail++];
+               if (avail > 8192) {
+                  return stbi__errpuc("too many codes", "Corrupt GIF");
+               }
+
+               p->prefix = (stbi__int16) oldcode;
+               p->first = g->codes[oldcode].first;
+               p->suffix = (code == avail) ? p->first : g->codes[code].first;
+            } else if (code == avail)
+               return stbi__errpuc("illegal code in raster", "Corrupt GIF");
+
+            stbi__out_gif_code(g, (stbi__uint16) code);
+
+            if ((avail & codemask) == 0 && avail <= 0x0FFF) {
+               codesize++;
+               codemask = (1 << codesize) - 1;
+            }
+
+            oldcode = code;
+         } else {
+            return stbi__errpuc("illegal code in raster", "Corrupt GIF");
+         }
+      }
+   }
+}
+
+// this function is designed to support animated gifs, although stb_image doesn't support it
+// two back is the image from two frames ago, used for a very specific disposal format
+static stbi_uc *stbi__gif_load_next(stbi__context *s, stbi__gif *g, int *comp, int req_comp, stbi_uc *two_back)
+{
+   int dispose; 
+   int first_frame; 
+   int pi; 
+   int pcount; 
+   STBI_NOTUSED(req_comp);
+
+   // on first frame, any non-written pixels get the background colour (non-transparent)
+   first_frame = 0; 
+   if (g->out == 0) {
+      if (!stbi__gif_header(s, g, comp,0)) return 0; // stbi__g_failure_reason set by stbi__gif_header
+      if (!stbi__mad3sizes_valid(4, g->w, g->h, 0))
+         return stbi__errpuc("too large", "GIF image is too large");
+      pcount = g->w * g->h;
+      g->out = (stbi_uc *) stbi__malloc(4 * pcount);
+      g->background = (stbi_uc *) stbi__malloc(4 * pcount);
+      g->history = (stbi_uc *) stbi__malloc(pcount);
+      if (!g->out || !g->background || !g->history)
+         return stbi__errpuc("outofmem", "Out of memory");
+
+      // image is treated as "transparent" at the start - ie, nothing overwrites the current background; 
+      // background colour is only used for pixels that are not rendered first frame, after that "background"
+      // color refers to the color that was there the previous frame. 
+      memset(g->out, 0x00, 4 * pcount);
+      memset(g->background, 0x00, 4 * pcount); // state of the background (starts transparent)
+      memset(g->history, 0x00, pcount);        // pixels that were affected previous frame
+      first_frame = 1; 
+   } else {
+      // second frame - how do we dispoase of the previous one?
+      dispose = (g->eflags & 0x1C) >> 2; 
+      pcount = g->w * g->h; 
+
+      if ((dispose == 3) && (two_back == 0)) {
+         dispose = 2; // if I don't have an image to revert back to, default to the old background
+      }
+
+      if (dispose == 3) { // use previous graphic
+         for (pi = 0; pi < pcount; ++pi) {
+            if (g->history[pi]) {
+               memcpy( &g->out[pi * 4], &two_back[pi * 4], 4 ); 
+            }
+         }
+      } else if (dispose == 2) { 
+         // restore what was changed last frame to background before that frame; 
+         for (pi = 0; pi < pcount; ++pi) {
+            if (g->history[pi]) {
+               memcpy( &g->out[pi * 4], &g->background[pi * 4], 4 ); 
+            }
+         }
+      } else {
+         // This is a non-disposal case eithe way, so just 
+         // leave the pixels as is, and they will become the new background
+         // 1: do not dispose
+         // 0:  not specified.
+      }
+
+      // background is what out is after the undoing of the previou frame; 
+      memcpy( g->background, g->out, 4 * g->w * g->h ); 
+   }
+
+   // clear my history; 
+   memset( g->history, 0x00, g->w * g->h );        // pixels that were affected previous frame
+
+   for (;;) {
+      int tag = stbi__get8(s); 
+      switch (tag) {
+         case 0x2C: /* Image Descriptor */
+         {
+            stbi__int32 x, y, w, h;
+            stbi_uc *o;
+
+            x = stbi__get16le(s);
+            y = stbi__get16le(s);
+            w = stbi__get16le(s);
+            h = stbi__get16le(s);
+            if (((x + w) > (g->w)) || ((y + h) > (g->h)))
+               return stbi__errpuc("bad Image Descriptor", "Corrupt GIF");
+
+            g->line_size = g->w * 4;
+            g->start_x = x * 4;
+            g->start_y = y * g->line_size;
+            g->max_x   = g->start_x + w * 4;
+            g->max_y   = g->start_y + h * g->line_size;
+            g->cur_x   = g->start_x;
+            g->cur_y   = g->start_y;
+
+            // if the width of the specified rectangle is 0, that means
+            // we may not see *any* pixels or the image is malformed;
+            // to make sure this is caught, move the current y down to
+            // max_y (which is what out_gif_code checks).
+            if (w == 0)
+               g->cur_y = g->max_y;
+
+            g->lflags = stbi__get8(s);
+
+            if (g->lflags & 0x40) {
+               g->step = 8 * g->line_size; // first interlaced spacing
+               g->parse = 3;
+            } else {
+               g->step = g->line_size;
+               g->parse = 0;
+            }
+
+            if (g->lflags & 0x80) {
+               stbi__gif_parse_colortable(s,g->lpal, 2 << (g->lflags & 7), g->eflags & 0x01 ? g->transparent : -1);
+               g->color_table = (stbi_uc *) g->lpal;
+            } else if (g->flags & 0x80) {
+               g->color_table = (stbi_uc *) g->pal;
+            } else
+               return stbi__errpuc("missing color table", "Corrupt GIF");            
+            
+            o = stbi__process_gif_raster(s, g);
+            if (!o) return NULL;
+
+            // if this was the first frame, 
+            pcount = g->w * g->h; 
+            if (first_frame && (g->bgindex > 0)) {
+               // if first frame, any pixel not drawn to gets the background color
+               for (pi = 0; pi < pcount; ++pi) {
+                  if (g->history[pi] == 0) {
+                     g->pal[g->bgindex][3] = 255; // just in case it was made transparent, undo that; It will be reset next frame if need be; 
+                     memcpy( &g->out[pi * 4], &g->pal[g->bgindex], 4 ); 
+                  }
+               }
+            }
+
+            return o;
+         }
+
+         case 0x21: // Comment Extension.
+         {
+            int len;
+            int ext = stbi__get8(s); 
+            if (ext == 0xF9) { // Graphic Control Extension.
+               len = stbi__get8(s);
+               if (len == 4) {
+                  g->eflags = stbi__get8(s);
+                  g->delay = 10 * stbi__get16le(s); // delay - 1/100th of a second, saving as 1/1000ths.
+
+                  // unset old transparent
+                  if (g->transparent >= 0) {
+                     g->pal[g->transparent][3] = 255; 
+                  } 
+                  if (g->eflags & 0x01) {
+                     g->transparent = stbi__get8(s);
+                     if (g->transparent >= 0) {
+                        g->pal[g->transparent][3] = 0; 
+                     }
+                  } else {
+                     // don't need transparent
+                     stbi__skip(s, 1); 
+                     g->transparent = -1; 
+                  }
+               } else {
+                  stbi__skip(s, len);
+                  break;
+               }
+            } 
+            while ((len = stbi__get8(s)) != 0) {
+               stbi__skip(s, len);
+            }
+            break;
+         }
+
+         case 0x3B: // gif stream termination code
+            return (stbi_uc *) s; // using '1' causes warning on some compilers
+
+         default:
+            return stbi__errpuc("unknown code", "Corrupt GIF");
+      }
+   }
+}
+
+static void *stbi__load_gif_main(stbi__context *s, int **delays, int *x, int *y, int *z, int *comp, int req_comp)
+{
+   if (stbi__gif_test(s)) {
+      int layers = 0; 
+      stbi_uc *u = 0;
+      stbi_uc *out = 0;
+      stbi_uc *two_back = 0; 
+      stbi__gif g;
+      int stride; 
+      memset(&g, 0, sizeof(g));
+      if (delays) {
+         *delays = 0; 
+      }
+
+      do {
+         u = stbi__gif_load_next(s, &g, comp, req_comp, two_back);
+         if (u == (stbi_uc *) s) u = 0;  // end of animated gif marker
+
+         if (u) {
+            *x = g.w;
+            *y = g.h;
+            ++layers; 
+            stride = g.w * g.h * 4; 
+         
+            if (out) {
+               out = (stbi_uc*) STBI_REALLOC( out, layers * stride ); 
+               if (delays) {
+                  *delays = (int*) STBI_REALLOC( *delays, sizeof(int) * layers ); 
+               }
+            } else {
+               out = (stbi_uc*)stbi__malloc( layers * stride ); 
+               if (delays) {
+                  *delays = (int*) stbi__malloc( layers * sizeof(int) ); 
+               }
+            }
+            memcpy( out + ((layers - 1) * stride), u, stride ); 
+            if (layers >= 2) {
+               two_back = out - 2 * stride; 
+            }
+
+            if (delays) {
+               (*delays)[layers - 1U] = g.delay; 
+            }
+         }
+      } while (u != 0); 
+
+      // free temp buffer; 
+      STBI_FREE(g.out); 
+      STBI_FREE(g.history); 
+      STBI_FREE(g.background); 
+
+      // do the final conversion after loading everything; 
+      if (req_comp && req_comp != 4)
+         out = stbi__convert_format(out, 4, req_comp, layers * g.w, g.h);
+
+      *z = layers; 
+      return out;
+   } else {
+      return stbi__errpuc("not GIF", "Image was not as a gif type."); 
+   }
+}
+
+static void *stbi__gif_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri)
+{
+   stbi_uc *u = 0;
+   stbi__gif g;
+   memset(&g, 0, sizeof(g));
+   STBI_NOTUSED(ri);
+
+   u = stbi__gif_load_next(s, &g, comp, req_comp, 0);
+   if (u == (stbi_uc *) s) u = 0;  // end of animated gif marker
+   if (u) {
+      *x = g.w;
+      *y = g.h;
+
+      // moved conversion to after successful load so that the same
+      // can be done for multiple frames. 
+      if (req_comp && req_comp != 4)
+         u = stbi__convert_format(u, 4, req_comp, g.w, g.h);
+   } else if (g.out) {
+      // if there was an error and we allocated an image buffer, free it!
+      STBI_FREE(g.out);
+   }
+
+   // free buffers needed for multiple frame loading; 
+   STBI_FREE(g.history);
+   STBI_FREE(g.background); 
+
+   return u;
+}
+
+static int stbi__gif_info(stbi__context *s, int *x, int *y, int *comp)
+{
+   return stbi__gif_info_raw(s,x,y,comp);
+}
+#endif
+
+// *************************************************************************************************
+// Radiance RGBE HDR loader
+// originally by Nicolas Schulz
+#ifndef STBI_NO_HDR
+static int stbi__hdr_test_core(stbi__context *s, const char *signature)
+{
+   int i;
+   for (i=0; signature[i]; ++i)
+      if (stbi__get8(s) != signature[i])
+          return 0;
+   stbi__rewind(s);
+   return 1;
+}
+
+static int stbi__hdr_test(stbi__context* s)
+{
+   int r = stbi__hdr_test_core(s, "#?RADIANCE\n");
+   stbi__rewind(s);
+   if(!r) {
+       r = stbi__hdr_test_core(s, "#?RGBE\n");
+       stbi__rewind(s);
+   }
+   return r;
+}
+
+#define STBI__HDR_BUFLEN  1024
+static char *stbi__hdr_gettoken(stbi__context *z, char *buffer)
+{
+   int len=0;
+   char c = '\0';
+
+   c = (char) stbi__get8(z);
+
+   while (!stbi__at_eof(z) && c != '\n') {
+      buffer[len++] = c;
+      if (len == STBI__HDR_BUFLEN-1) {
+         // flush to end of line
+         while (!stbi__at_eof(z) && stbi__get8(z) != '\n')
+            ;
+         break;
+      }
+      c = (char) stbi__get8(z);
+   }
+
+   buffer[len] = 0;
+   return buffer;
+}
+
+static void stbi__hdr_convert(float *output, stbi_uc *input, int req_comp)
+{
+   if ( input[3] != 0 ) {
+      float f1;
+      // Exponent
+      f1 = (float) ldexp(1.0f, input[3] - (int)(128 + 8));
+      if (req_comp <= 2)
+         output[0] = (input[0] + input[1] + input[2]) * f1 / 3;
+      else {
+         output[0] = input[0] * f1;
+         output[1] = input[1] * f1;
+         output[2] = input[2] * f1;
+      }
+      if (req_comp == 2) output[1] = 1;
+      if (req_comp == 4) output[3] = 1;
+   } else {
+      switch (req_comp) {
+         case 4: output[3] = 1; /* fallthrough */
+         case 3: output[0] = output[1] = output[2] = 0;
+                 break;
+         case 2: output[1] = 1; /* fallthrough */
+         case 1: output[0] = 0;
+                 break;
+      }
+   }
+}
+
+static float *stbi__hdr_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri)
+{
+   char buffer[STBI__HDR_BUFLEN];
+   char *token;
+   int valid = 0;
+   int width, height;
+   stbi_uc *scanline;
+   float *hdr_data;
+   int len;
+   unsigned char count, value;
+   int i, j, k, c1,c2, z;
+   const char *headerToken;
+   STBI_NOTUSED(ri);
+
+   // Check identifier
+   headerToken = stbi__hdr_gettoken(s,buffer);
+   if (strcmp(headerToken, "#?RADIANCE") != 0 && strcmp(headerToken, "#?RGBE") != 0)
+      return stbi__errpf("not HDR", "Corrupt HDR image");
+
+   // Parse header
+   for(;;) {
+      token = stbi__hdr_gettoken(s,buffer);
+      if (token[0] == 0) break;
+      if (strcmp(token, "FORMAT=32-bit_rle_rgbe") == 0) valid = 1;
+   }
+
+   if (!valid)    return stbi__errpf("unsupported format", "Unsupported HDR format");
+
+   // Parse width and height
+   // can't use sscanf() if we're not using stdio!
+   token = stbi__hdr_gettoken(s,buffer);
+   if (strncmp(token, "-Y ", 3))  return stbi__errpf("unsupported data layout", "Unsupported HDR format");
+   token += 3;
+   height = (int) strtol(token, &token, 10);
+   while (*token == ' ') ++token;
+   if (strncmp(token, "+X ", 3))  return stbi__errpf("unsupported data layout", "Unsupported HDR format");
+   token += 3;
+   width = (int) strtol(token, NULL, 10);
+
+   *x = width;
+   *y = height;
+
+   if (comp) *comp = 3;
+   if (req_comp == 0) req_comp = 3;
+
+   if (!stbi__mad4sizes_valid(width, height, req_comp, sizeof(float), 0))
+      return stbi__errpf("too large", "HDR image is too large");
+
+   // Read data
+   hdr_data = (float *) stbi__malloc_mad4(width, height, req_comp, sizeof(float), 0);
+   if (!hdr_data)
+      return stbi__errpf("outofmem", "Out of memory");
+
+   // Load image data
+   // image data is stored as some number of sca
+   if ( width < 8 || width >= 32768) {
+      // Read flat data
+      for (j=0; j < height; ++j) {
+         for (i=0; i < width; ++i) {
+            stbi_uc rgbe[4];
+           main_decode_loop:
+            stbi__getn(s, rgbe, 4);
+            stbi__hdr_convert(hdr_data + j * width * req_comp + i * req_comp, rgbe, req_comp);
+         }
+      }
+   } else {
+      // Read RLE-encoded data
+      scanline = NULL;
+
+      for (j = 0; j < height; ++j) {
+         c1 = stbi__get8(s);
+         c2 = stbi__get8(s);
+         len = stbi__get8(s);
+         if (c1 != 2 || c2 != 2 || (len & 0x80)) {
+            // not run-length encoded, so we have to actually use THIS data as a decoded
+            // pixel (note this can't be a valid pixel--one of RGB must be >= 128)
+            stbi_uc rgbe[4];
+            rgbe[0] = (stbi_uc) c1;
+            rgbe[1] = (stbi_uc) c2;
+            rgbe[2] = (stbi_uc) len;
+            rgbe[3] = (stbi_uc) stbi__get8(s);
+            stbi__hdr_convert(hdr_data, rgbe, req_comp);
+            i = 1;
+            j = 0;
+            STBI_FREE(scanline);
+            goto main_decode_loop; // yes, this makes no sense
+         }
+         len <<= 8;
+         len |= stbi__get8(s);
+         if (len != width) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("invalid decoded scanline length", "corrupt HDR"); }
+         if (scanline == NULL) {
+            scanline = (stbi_uc *) stbi__malloc_mad2(width, 4, 0);
+            if (!scanline) {
+               STBI_FREE(hdr_data);
+               return stbi__errpf("outofmem", "Out of memory");
+            }
+         }
+
+         for (k = 0; k < 4; ++k) {
+            int nleft;
+            i = 0;
+            while ((nleft = width - i) > 0) {
+               count = stbi__get8(s);
+               if (count > 128) {
+                  // Run
+                  value = stbi__get8(s);
+                  count -= 128;
+                  if (count > nleft) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("corrupt", "bad RLE data in HDR"); }
+                  for (z = 0; z < count; ++z)
+                     scanline[i++ * 4 + k] = value;
+               } else {
+                  // Dump
+                  if (count > nleft) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("corrupt", "bad RLE data in HDR"); }
+                  for (z = 0; z < count; ++z)
+                     scanline[i++ * 4 + k] = stbi__get8(s);
+               }
+            }
+         }
+         for (i=0; i < width; ++i)
+            stbi__hdr_convert(hdr_data+(j*width + i)*req_comp, scanline + i*4, req_comp);
+      }
+      if (scanline)
+         STBI_FREE(scanline);
+   }
+
+   return hdr_data;
+}
+
+static int stbi__hdr_info(stbi__context *s, int *x, int *y, int *comp)
+{
+   char buffer[STBI__HDR_BUFLEN];
+   char *token;
+   int valid = 0;
+   int dummy;
+
+   if (!x) x = &dummy;
+   if (!y) y = &dummy;
+   if (!comp) comp = &dummy;
+
+   if (stbi__hdr_test(s) == 0) {
+       stbi__rewind( s );
+       return 0;
+   }
+
+   for(;;) {
+      token = stbi__hdr_gettoken(s,buffer);
+      if (token[0] == 0) break;
+      if (strcmp(token, "FORMAT=32-bit_rle_rgbe") == 0) valid = 1;
+   }
+
+   if (!valid) {
+       stbi__rewind( s );
+       return 0;
+   }
+   token = stbi__hdr_gettoken(s,buffer);
+   if (strncmp(token, "-Y ", 3)) {
+       stbi__rewind( s );
+       return 0;
+   }
+   token += 3;
+   *y = (int) strtol(token, &token, 10);
+   while (*token == ' ') ++token;
+   if (strncmp(token, "+X ", 3)) {
+       stbi__rewind( s );
+       return 0;
+   }
+   token += 3;
+   *x = (int) strtol(token, NULL, 10);
+   *comp = 3;
+   return 1;
+}
+#endif // STBI_NO_HDR
+
+#ifndef STBI_NO_BMP
+static int stbi__bmp_info(stbi__context *s, int *x, int *y, int *comp)
+{
+   void *p;
+   stbi__bmp_data info;
+
+   info.all_a = 255;
+   p = stbi__bmp_parse_header(s, &info);
+   stbi__rewind( s );
+   if (p == NULL)
+      return 0;
+   if (x) *x = s->img_x;
+   if (y) *y = s->img_y;
+   if (comp) *comp = info.ma ? 4 : 3;
+   return 1;
+}
+#endif
+
+#ifndef STBI_NO_PSD
+static int stbi__psd_info(stbi__context *s, int *x, int *y, int *comp)
+{
+   int channelCount, dummy, depth;
+   if (!x) x = &dummy;
+   if (!y) y = &dummy;
+   if (!comp) comp = &dummy;
+   if (stbi__get32be(s) != 0x38425053) {
+       stbi__rewind( s );
+       return 0;
+   }
+   if (stbi__get16be(s) != 1) {
+       stbi__rewind( s );
+       return 0;
+   }
+   stbi__skip(s, 6);
+   channelCount = stbi__get16be(s);
+   if (channelCount < 0 || channelCount > 16) {
+       stbi__rewind( s );
+       return 0;
+   }
+   *y = stbi__get32be(s);
+   *x = stbi__get32be(s);
+   depth = stbi__get16be(s);
+   if (depth != 8 && depth != 16) {
+       stbi__rewind( s );
+       return 0;
+   }
+   if (stbi__get16be(s) != 3) {
+       stbi__rewind( s );
+       return 0;
+   }
+   *comp = 4;
+   return 1;
+}
+
+static int stbi__psd_is16(stbi__context *s)
+{
+   int channelCount, depth;
+   if (stbi__get32be(s) != 0x38425053) {
+       stbi__rewind( s );
+       return 0;
+   }
+   if (stbi__get16be(s) != 1) {
+       stbi__rewind( s );
+       return 0;
+   }
+   stbi__skip(s, 6);
+   channelCount = stbi__get16be(s);
+   if (channelCount < 0 || channelCount > 16) {
+       stbi__rewind( s );
+       return 0;
+   }
+   (void) stbi__get32be(s);
+   (void) stbi__get32be(s);
+   depth = stbi__get16be(s);
+   if (depth != 16) {
+       stbi__rewind( s );
+       return 0;
+   }
+   return 1;
+}
+#endif
+
+#ifndef STBI_NO_PIC
+static int stbi__pic_info(stbi__context *s, int *x, int *y, int *comp)
+{
+   int act_comp=0,num_packets=0,chained,dummy;
+   stbi__pic_packet packets[10];
+
+   if (!x) x = &dummy;
+   if (!y) y = &dummy;
+   if (!comp) comp = &dummy;
+
+   if (!stbi__pic_is4(s,"\x53\x80\xF6\x34")) {
+      stbi__rewind(s);
+      return 0;
+   }
+
+   stbi__skip(s, 88);
+
+   *x = stbi__get16be(s);
+   *y = stbi__get16be(s);
+   if (stbi__at_eof(s)) {
+      stbi__rewind( s);
+      return 0;
+   }
+   if ( (*x) != 0 && (1 << 28) / (*x) < (*y)) {
+      stbi__rewind( s );
+      return 0;
+   }
+
+   stbi__skip(s, 8);
+
+   do {
+      stbi__pic_packet *packet;
+
+      if (num_packets==sizeof(packets)/sizeof(packets[0]))
+         return 0;
+
+      packet = &packets[num_packets++];
+      chained = stbi__get8(s);
+      packet->size    = stbi__get8(s);
+      packet->type    = stbi__get8(s);
+      packet->channel = stbi__get8(s);
+      act_comp |= packet->channel;
+
+      if (stbi__at_eof(s)) {
+          stbi__rewind( s );
+          return 0;
+      }
+      if (packet->size != 8) {
+          stbi__rewind( s );
+          return 0;
+      }
+   } while (chained);
+
+   *comp = (act_comp & 0x10 ? 4 : 3);
+
+   return 1;
+}
+#endif
+
+// *************************************************************************************************
+// Portable Gray Map and Portable Pixel Map loader
+// by Ken Miller
+//
+// PGM: http://netpbm.sourceforge.net/doc/pgm.html
+// PPM: http://netpbm.sourceforge.net/doc/ppm.html
+//
+// Known limitations:
+//    Does not support comments in the header section
+//    Does not support ASCII image data (formats P2 and P3)
+//    Does not support 16-bit-per-channel
+
+#ifndef STBI_NO_PNM
+
+static int      stbi__pnm_test(stbi__context *s)
+{
+   char p, t;
+   p = (char) stbi__get8(s);
+   t = (char) stbi__get8(s);
+   if (p != 'P' || (t != '5' && t != '6')) {
+       stbi__rewind( s );
+       return 0;
+   }
+   return 1;
+}
+
+static void *stbi__pnm_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri)
+{
+   stbi_uc *out;
+   STBI_NOTUSED(ri);
+
+   if (!stbi__pnm_info(s, (int *)&s->img_x, (int *)&s->img_y, (int *)&s->img_n))
+      return 0;
+
+   *x = s->img_x;
+   *y = s->img_y;
+   if (comp) *comp = s->img_n;
+
+   if (!stbi__mad3sizes_valid(s->img_n, s->img_x, s->img_y, 0))
+      return stbi__errpuc("too large", "PNM too large");
+
+   out = (stbi_uc *) stbi__malloc_mad3(s->img_n, s->img_x, s->img_y, 0);
+   if (!out) return stbi__errpuc("outofmem", "Out of memory");
+   stbi__getn(s, out, s->img_n * s->img_x * s->img_y);
+
+   if (req_comp && req_comp != s->img_n) {
+      out = stbi__convert_format(out, s->img_n, req_comp, s->img_x, s->img_y);
+      if (out == NULL) return out; // stbi__convert_format frees input on failure
+   }
+   return out;
+}
+
+static int      stbi__pnm_isspace(char c)
+{
+   return c == ' ' || c == '\t' || c == '\n' || c == '\v' || c == '\f' || c == '\r';
+}
+
+static void     stbi__pnm_skip_whitespace(stbi__context *s, char *c)
+{
+   for (;;) {
+      while (!stbi__at_eof(s) && stbi__pnm_isspace(*c))
+         *c = (char) stbi__get8(s);
+
+      if (stbi__at_eof(s) || *c != '#')
+         break;
+
+      while (!stbi__at_eof(s) && *c != '\n' && *c != '\r' )
+         *c = (char) stbi__get8(s);
+   }
+}
+
+static int      stbi__pnm_isdigit(char c)
+{
+   return c >= '0' && c <= '9';
+}
+
+static int      stbi__pnm_getinteger(stbi__context *s, char *c)
+{
+   int value = 0;
+
+   while (!stbi__at_eof(s) && stbi__pnm_isdigit(*c)) {
+      value = value*10 + (*c - '0');
+      *c = (char) stbi__get8(s);
+   }
+
+   return value;
+}
+
+static int      stbi__pnm_info(stbi__context *s, int *x, int *y, int *comp)
+{
+   int maxv, dummy;
+   char c, p, t;
+
+   if (!x) x = &dummy;
+   if (!y) y = &dummy;
+   if (!comp) comp = &dummy;
+
+   stbi__rewind(s);
+
+   // Get identifier
+   p = (char) stbi__get8(s);
+   t = (char) stbi__get8(s);
+   if (p != 'P' || (t != '5' && t != '6')) {
+       stbi__rewind(s);
+       return 0;
+   }
+
+   *comp = (t == '6') ? 3 : 1;  // '5' is 1-component .pgm; '6' is 3-component .ppm
+
+   c = (char) stbi__get8(s);
+   stbi__pnm_skip_whitespace(s, &c);
+
+   *x = stbi__pnm_getinteger(s, &c); // read width
+   stbi__pnm_skip_whitespace(s, &c);
+
+   *y = stbi__pnm_getinteger(s, &c); // read height
+   stbi__pnm_skip_whitespace(s, &c);
+
+   maxv = stbi__pnm_getinteger(s, &c);  // read max value
+
+   if (maxv > 255)
+      return stbi__err("max value > 255", "PPM image not 8-bit");
+   else
+      return 1;
+}
+#endif
+
+static int stbi__info_main(stbi__context *s, int *x, int *y, int *comp)
+{
+   #ifndef STBI_NO_JPEG
+   if (stbi__jpeg_info(s, x, y, comp)) return 1;
+   #endif
+
+   #ifndef STBI_NO_PNG
+   if (stbi__png_info(s, x, y, comp))  return 1;
+   #endif
+
+   #ifndef STBI_NO_GIF
+   if (stbi__gif_info(s, x, y, comp))  return 1;
+   #endif
+
+   #ifndef STBI_NO_BMP
+   if (stbi__bmp_info(s, x, y, comp))  return 1;
+   #endif
+
+   #ifndef STBI_NO_PSD
+   if (stbi__psd_info(s, x, y, comp))  return 1;
+   #endif
+
+   #ifndef STBI_NO_PIC
+   if (stbi__pic_info(s, x, y, comp))  return 1;
+   #endif
+
+   #ifndef STBI_NO_PNM
+   if (stbi__pnm_info(s, x, y, comp))  return 1;
+   #endif
+
+   #ifndef STBI_NO_HDR
+   if (stbi__hdr_info(s, x, y, comp))  return 1;
+   #endif
+
+   // test tga last because it's a crappy test!
+   #ifndef STBI_NO_TGA
+   if (stbi__tga_info(s, x, y, comp))
+       return 1;
+   #endif
+   return stbi__err("unknown image type", "Image not of any known type, or corrupt");
+}
+
+static int stbi__is_16_main(stbi__context *s)
+{
+   #ifndef STBI_NO_PNG
+   if (stbi__png_is16(s))  return 1;
+   #endif
+
+   #ifndef STBI_NO_PSD
+   if (stbi__psd_is16(s))  return 1;
+   #endif
+
+   return 0;
+}
+
+#ifndef STBI_NO_STDIO
+STBIDEF int stbi_info(char const *filename, int *x, int *y, int *comp)
+{
+    FILE *f = stbi__fopen(filename, "rb");
+    int result;
+    if (!f) return stbi__err("can't fopen", "Unable to open file");
+    result = stbi_info_from_file(f, x, y, comp);
+    fclose(f);
+    return result;
+}
+
+STBIDEF int stbi_info_from_file(FILE *f, int *x, int *y, int *comp)
+{
+   int r;
+   stbi__context s;
+   long pos = ftell(f);
+   stbi__start_file(&s, f);
+   r = stbi__info_main(&s,x,y,comp);
+   fseek(f,pos,SEEK_SET);
+   return r;
+}
+
+STBIDEF int stbi_is_16_bit(char const *filename)
+{
+    FILE *f = stbi__fopen(filename, "rb");
+    int result;
+    if (!f) return stbi__err("can't fopen", "Unable to open file");
+    result = stbi_is_16_bit_from_file(f);
+    fclose(f);
+    return result;
+}
+
+STBIDEF int stbi_is_16_bit_from_file(FILE *f)
+{
+   int r;
+   stbi__context s;
+   long pos = ftell(f);
+   stbi__start_file(&s, f);
+   r = stbi__is_16_main(&s);
+   fseek(f,pos,SEEK_SET);
+   return r;
+}
+#endif // !STBI_NO_STDIO
+
+STBIDEF int stbi_info_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp)
+{
+   stbi__context s;
+   stbi__start_mem(&s,buffer,len);
+   return stbi__info_main(&s,x,y,comp);
+}
+
+STBIDEF int stbi_info_from_callbacks(stbi_io_callbacks const *c, void *user, int *x, int *y, int *comp)
+{
+   stbi__context s;
+   stbi__start_callbacks(&s, (stbi_io_callbacks *) c, user);
+   return stbi__info_main(&s,x,y,comp);
+}
+
+STBIDEF int stbi_is_16_bit_from_memory(stbi_uc const *buffer, int len)
+{
+   stbi__context s;
+   stbi__start_mem(&s,buffer,len);
+   return stbi__is_16_main(&s);
+}
+
+STBIDEF int stbi_is_16_bit_from_callbacks(stbi_io_callbacks const *c, void *user)
+{
+   stbi__context s;
+   stbi__start_callbacks(&s, (stbi_io_callbacks *) c, user);
+   return stbi__is_16_main(&s);
+}
+
+#endif // STB_IMAGE_IMPLEMENTATION
+
+/*
+   revision history:
+      2.20  (2019-02-07) support utf8 filenames in Windows; fix warnings and platform ifdefs 
+      2.19  (2018-02-11) fix warning
+      2.18  (2018-01-30) fix warnings
+      2.17  (2018-01-29) change sbti__shiftsigned to avoid clang -O2 bug
+                         1-bit BMP
+                         *_is_16_bit api
+                         avoid warnings
+      2.16  (2017-07-23) all functions have 16-bit variants;
+                         STBI_NO_STDIO works again;
+                         compilation fixes;
+                         fix rounding in unpremultiply;
+                         optimize vertical flip;
+                         disable raw_len validation;
+                         documentation fixes
+      2.15  (2017-03-18) fix png-1,2,4 bug; now all Imagenet JPGs decode;
+                         warning fixes; disable run-time SSE detection on gcc;
+                         uniform handling of optional "return" values;
+                         thread-safe initialization of zlib tables
+      2.14  (2017-03-03) remove deprecated STBI_JPEG_OLD; fixes for Imagenet JPGs
+      2.13  (2016-11-29) add 16-bit API, only supported for PNG right now
+      2.12  (2016-04-02) fix typo in 2.11 PSD fix that caused crashes
+      2.11  (2016-04-02) allocate large structures on the stack
+                         remove white matting for transparent PSD
+                         fix reported channel count for PNG & BMP
+                         re-enable SSE2 in non-gcc 64-bit
+                         support RGB-formatted JPEG
+                         read 16-bit PNGs (only as 8-bit)
+      2.10  (2016-01-22) avoid warning introduced in 2.09 by STBI_REALLOC_SIZED
+      2.09  (2016-01-16) allow comments in PNM files
+                         16-bit-per-pixel TGA (not bit-per-component)
+                         info() for TGA could break due to .hdr handling
+                         info() for BMP to shares code instead of sloppy parse
+                         can use STBI_REALLOC_SIZED if allocator doesn't support realloc
+                         code cleanup
+      2.08  (2015-09-13) fix to 2.07 cleanup, reading RGB PSD as RGBA
+      2.07  (2015-09-13) fix compiler warnings
+                         partial animated GIF support
+                         limited 16-bpc PSD support
+                         #ifdef unused functions
+                         bug with < 92 byte PIC,PNM,HDR,TGA
+      2.06  (2015-04-19) fix bug where PSD returns wrong '*comp' value
+      2.05  (2015-04-19) fix bug in progressive JPEG handling, fix warning
+      2.04  (2015-04-15) try to re-enable SIMD on MinGW 64-bit
+      2.03  (2015-04-12) extra corruption checking (mmozeiko)
+                         stbi_set_flip_vertically_on_load (nguillemot)
+                         fix NEON support; fix mingw support
+      2.02  (2015-01-19) fix incorrect assert, fix warning
+      2.01  (2015-01-17) fix various warnings; suppress SIMD on gcc 32-bit without -msse2
+      2.00b (2014-12-25) fix STBI_MALLOC in progressive JPEG
+      2.00  (2014-12-25) optimize JPG, including x86 SSE2 & NEON SIMD (ryg)
+                         progressive JPEG (stb)
+                         PGM/PPM support (Ken Miller)
+                         STBI_MALLOC,STBI_REALLOC,STBI_FREE
+                         GIF bugfix -- seemingly never worked
+                         STBI_NO_*, STBI_ONLY_*
+      1.48  (2014-12-14) fix incorrectly-named assert()
+      1.47  (2014-12-14) 1/2/4-bit PNG support, both direct and paletted (Omar Cornut & stb)
+                         optimize PNG (ryg)
+                         fix bug in interlaced PNG with user-specified channel count (stb)
+      1.46  (2014-08-26)
+              fix broken tRNS chunk (colorkey-style transparency) in non-paletted PNG
+      1.45  (2014-08-16)
+              fix MSVC-ARM internal compiler error by wrapping malloc
+      1.44  (2014-08-07)
+              various warning fixes from Ronny Chevalier
+      1.43  (2014-07-15)
+              fix MSVC-only compiler problem in code changed in 1.42
+      1.42  (2014-07-09)
+              don't define _CRT_SECURE_NO_WARNINGS (affects user code)
+              fixes to stbi__cleanup_jpeg path
+              added STBI_ASSERT to avoid requiring assert.h
+      1.41  (2014-06-25)
+              fix search&replace from 1.36 that messed up comments/error messages
+      1.40  (2014-06-22)
+              fix gcc struct-initialization warning
+      1.39  (2014-06-15)
+              fix to TGA optimization when req_comp != number of components in TGA;
+              fix to GIF loading because BMP wasn't rewinding (whoops, no GIFs in my test suite)
+              add support for BMP version 5 (more ignored fields)
+      1.38  (2014-06-06)
+              suppress MSVC warnings on integer casts truncating values
+              fix accidental rename of 'skip' field of I/O
+      1.37  (2014-06-04)
+              remove duplicate typedef
+      1.36  (2014-06-03)
+              convert to header file single-file library
+              if de-iphone isn't set, load iphone images color-swapped instead of returning NULL
+      1.35  (2014-05-27)
+              various warnings
+              fix broken STBI_SIMD path
+              fix bug where stbi_load_from_file no longer left file pointer in correct place
+              fix broken non-easy path for 32-bit BMP (possibly never used)
+              TGA optimization by Arseny Kapoulkine
+      1.34  (unknown)
+              use STBI_NOTUSED in stbi__resample_row_generic(), fix one more leak in tga failure case
+      1.33  (2011-07-14)
+              make stbi_is_hdr work in STBI_NO_HDR (as specified), minor compiler-friendly improvements
+      1.32  (2011-07-13)
+              support for "info" function for all supported filetypes (SpartanJ)
+      1.31  (2011-06-20)
+              a few more leak fixes, bug in PNG handling (SpartanJ)
+      1.30  (2011-06-11)
+              added ability to load files via callbacks to accomidate custom input streams (Ben Wenger)
+              removed deprecated format-specific test/load functions
+              removed support for installable file formats (stbi_loader) -- would have been broken for IO callbacks anyway
+              error cases in bmp and tga give messages and don't leak (Raymond Barbiero, grisha)
+              fix inefficiency in decoding 32-bit BMP (David Woo)
+      1.29  (2010-08-16)
+              various warning fixes from Aurelien Pocheville
+      1.28  (2010-08-01)
+              fix bug in GIF palette transparency (SpartanJ)
+      1.27  (2010-08-01)
+              cast-to-stbi_uc to fix warnings
+      1.26  (2010-07-24)
+              fix bug in file buffering for PNG reported by SpartanJ
+      1.25  (2010-07-17)
+              refix trans_data warning (Won Chun)
+      1.24  (2010-07-12)
+              perf improvements reading from files on platforms with lock-heavy fgetc()
+              minor perf improvements for jpeg
+              deprecated type-specific functions so we'll get feedback if they're needed
+              attempt to fix trans_data warning (Won Chun)
+      1.23    fixed bug in iPhone support
+      1.22  (2010-07-10)
+              removed image *writing* support
+              stbi_info support from Jetro Lauha
+              GIF support from Jean-Marc Lienher
+              iPhone PNG-extensions from James Brown
+              warning-fixes from Nicolas Schulz and Janez Zemva (i.stbi__err. Janez (U+017D)emva)
+      1.21    fix use of 'stbi_uc' in header (reported by jon blow)
+      1.20    added support for Softimage PIC, by Tom Seddon
+      1.19    bug in interlaced PNG corruption check (found by ryg)
+      1.18  (2008-08-02)
+              fix a threading bug (local mutable static)
+      1.17    support interlaced PNG
+      1.16    major bugfix - stbi__convert_format converted one too many pixels
+      1.15    initialize some fields for thread safety
+      1.14    fix threadsafe conversion bug
+              header-file-only version (#define STBI_HEADER_FILE_ONLY before including)
+      1.13    threadsafe
+      1.12    const qualifiers in the API
+      1.11    Support installable IDCT, colorspace conversion routines
+      1.10    Fixes for 64-bit (don't use "unsigned long")
+              optimized upsampling by Fabian "ryg" Giesen
+      1.09    Fix format-conversion for PSD code (bad global variables!)
+      1.08    Thatcher Ulrich's PSD code integrated by Nicolas Schulz
+      1.07    attempt to fix C++ warning/errors again
+      1.06    attempt to fix C++ warning/errors again
+      1.05    fix TGA loading to return correct *comp and use good luminance calc
+      1.04    default float alpha is 1, not 255; use 'void *' for stbi_image_free
+      1.03    bugfixes to STBI_NO_STDIO, STBI_NO_HDR
+      1.02    support for (subset of) HDR files, float interface for preferred access to them
+      1.01    fix bug: possible bug in handling right-side up bmps... not sure
+              fix bug: the stbi__bmp_load() and stbi__tga_load() functions didn't work at all
+      1.00    interface to zlib that skips zlib header
+      0.99    correct handling of alpha in palette
+      0.98    TGA loader by lonesock; dynamically add loaders (untested)
+      0.97    jpeg errors on too large a file; also catch another malloc failure
+      0.96    fix detection of invalid v value - particleman@mollyrocket forum
+      0.95    during header scan, seek to markers in case of padding
+      0.94    STBI_NO_STDIO to disable stdio usage; rename all #defines the same
+      0.93    handle jpegtran output; verbose errors
+      0.92    read 4,8,16,24,32-bit BMP files of several formats
+      0.91    output 24-bit Windows 3.0 BMP files
+      0.90    fix a few more warnings; bump version number to approach 1.0
+      0.61    bugfixes due to Marc LeBlanc, Christopher Lloyd
+      0.60    fix compiling as c++
+      0.59    fix warnings: merge Dave Moore's -Wall fixes
+      0.58    fix bug: zlib uncompressed mode len/nlen was wrong endian
+      0.57    fix bug: jpg last huffman symbol before marker was >9 bits but less than 16 available
+      0.56    fix bug: zlib uncompressed mode len vs. nlen
+      0.55    fix bug: restart_interval not initialized to 0
+      0.54    allow NULL for 'int *comp'
+      0.53    fix bug in png 3->4; speedup png decoding
+      0.52    png handles req_comp=3,4 directly; minor cleanup; jpeg comments
+      0.51    obey req_comp requests, 1-component jpegs return as 1-component,
+              on 'test' only check type, not whether we support this variant
+      0.50  (2006-11-19)
+              first released version
+*/
+
+
+/*
+------------------------------------------------------------------------------
+This software is available under 2 licenses -- choose whichever you prefer.
+------------------------------------------------------------------------------
+ALTERNATIVE A - MIT License
+Copyright (c) 2017 Sean Barrett
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+------------------------------------------------------------------------------
+ALTERNATIVE B - Public Domain (www.unlicense.org)
+This is free and unencumbered software released into the public domain.
+Anyone is free to copy, modify, publish, use, compile, sell, or distribute this
+software, either in source code form or as a compiled binary, for any purpose,
+commercial or non-commercial, and by any means.
+In jurisdictions that recognize copyright laws, the author or authors of this
+software dedicate any and all copyright interest in the software to the public
+domain. We make this dedication for the benefit of the public at large and to
+the detriment of our heirs and successors. We intend this dedication to be an
+overt act of relinquishment in perpetuity of all present and future rights to
+this software under copyright law.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+------------------------------------------------------------------------------
+*/
diff --git a/frontends/gl/win/glfw/include/GLFW/glfw3.h b/frontends/gl/win/glfw/include/GLFW/glfw3.h
index c1e6145..1fc8fe5 100644
--- a/frontends/gl/win/glfw/include/GLFW/glfw3.h
+++ b/frontends/gl/win/glfw/include/GLFW/glfw3.h
@@ -1,5544 +1,5544 @@
-/*************************************************************************

- * GLFW 3.3 - www.glfw.org

- * A library for OpenGL, window and input

- *------------------------------------------------------------------------

- * Copyright (c) 2002-2006 Marcus Geelnard

- * Copyright (c) 2006-2016 Camilla Löwy <elmindreda@glfw.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.

- *

- *************************************************************************/

-

-#ifndef _glfw3_h_

-#define _glfw3_h_

-

-#ifdef __cplusplus

-extern "C" {

-#endif

-

-

-/*************************************************************************

- * Doxygen documentation

- *************************************************************************/

-

-/*! @file glfw3.h

- *  @brief The header of the GLFW 3 API.

- *

- *  This is the header file of the GLFW 3 API.  It defines all its types and

- *  declares all its functions.

- *

- *  For more information about how to use this file, see @ref build_include.

- */

-/*! @defgroup context Context reference

- *  @brief Functions and types related to OpenGL and OpenGL ES contexts.

- *

- *  This is the reference documentation for OpenGL and OpenGL ES context related

- *  functions.  For more task-oriented information, see the @ref context_guide.

- */

-/*! @defgroup vulkan Vulkan reference

- *  @brief Functions and types related to Vulkan.

- *

- *  This is the reference documentation for Vulkan related functions and types.

- *  For more task-oriented information, see the @ref vulkan_guide.

- */

-/*! @defgroup init Initialization, version and error reference

- *  @brief Functions and types related to initialization and error handling.

- *

- *  This is the reference documentation for initialization and termination of

- *  the library, version management and error handling.  For more task-oriented

- *  information, see the @ref intro_guide.

- */

-/*! @defgroup input Input reference

- *  @brief Functions and types related to input handling.

- *

- *  This is the reference documentation for input related functions and types.

- *  For more task-oriented information, see the @ref input_guide.

- */

-/*! @defgroup monitor Monitor reference

- *  @brief Functions and types related to monitors.

- *

- *  This is the reference documentation for monitor related functions and types.

- *  For more task-oriented information, see the @ref monitor_guide.

- */

-/*! @defgroup window Window reference

- *  @brief Functions and types related to windows.

- *

- *  This is the reference documentation for window related functions and types,

- *  including creation, deletion and event polling.  For more task-oriented

- *  information, see the @ref window_guide.

- */

-

-

-/*************************************************************************

- * Compiler- and platform-specific preprocessor work

- *************************************************************************/

-

-/* If we are we on Windows, we want a single define for it.

- */

-#if !defined(_WIN32) && (defined(__WIN32__) || defined(WIN32) || defined(__MINGW32__))

- #define _WIN32

-#endif /* _WIN32 */

-

-/* It is customary to use APIENTRY for OpenGL function pointer declarations on

- * all platforms.  Additionally, the Windows OpenGL header needs APIENTRY.

- */

-#ifndef APIENTRY

- #ifdef _WIN32

-  #define APIENTRY __stdcall

- #else

-  #define APIENTRY

- #endif

- #define GLFW_APIENTRY_DEFINED

-#endif /* APIENTRY */

-

-/* Some Windows OpenGL headers need this.

- */

-#if !defined(WINGDIAPI) && defined(_WIN32)

- #define WINGDIAPI __declspec(dllimport)

- #define GLFW_WINGDIAPI_DEFINED

-#endif /* WINGDIAPI */

-

-/* Some Windows GLU headers need this.

- */

-#if !defined(CALLBACK) && defined(_WIN32)

- #define CALLBACK __stdcall

- #define GLFW_CALLBACK_DEFINED

-#endif /* CALLBACK */

-

-/* Include because most Windows GLU headers need wchar_t and

- * the macOS OpenGL header blocks the definition of ptrdiff_t by glext.h.

- * Include it unconditionally to avoid surprising side-effects.

- */

-#include <stddef.h>

-

-/* Include because it is needed by Vulkan and related functions.

- * Include it unconditionally to avoid surprising side-effects.

- */

-#include <stdint.h>

-

-/* Include the chosen OpenGL or OpenGL ES headers.

- */

-#if defined(GLFW_INCLUDE_ES1)

-

- #include <GLES/gl.h>

- #if defined(GLFW_INCLUDE_GLEXT)

-  #include <GLES/glext.h>

- #endif

-

-#elif defined(GLFW_INCLUDE_ES2)

-

- #include <GLES2/gl2.h>

- #if defined(GLFW_INCLUDE_GLEXT)

-  #include <GLES2/gl2ext.h>

- #endif

-

-#elif defined(GLFW_INCLUDE_ES3)

-

- #include <GLES3/gl3.h>

- #if defined(GLFW_INCLUDE_GLEXT)

-  #include <GLES2/gl2ext.h>

- #endif

-

-#elif defined(GLFW_INCLUDE_ES31)

-

- #include <GLES3/gl31.h>

- #if defined(GLFW_INCLUDE_GLEXT)

-  #include <GLES2/gl2ext.h>

- #endif

-

-#elif defined(GLFW_INCLUDE_ES32)

-

- #include <GLES3/gl32.h>

- #if defined(GLFW_INCLUDE_GLEXT)

-  #include <GLES2/gl2ext.h>

- #endif

-

-#elif defined(GLFW_INCLUDE_GLCOREARB)

-

- #if defined(__APPLE__)

-

-  #include <OpenGL/gl3.h>

-  #if defined(GLFW_INCLUDE_GLEXT)

-   #include <OpenGL/gl3ext.h>

-  #endif /*GLFW_INCLUDE_GLEXT*/

-

- #else /*__APPLE__*/

-

-  #include <GL/glcorearb.h>

-

- #endif /*__APPLE__*/

-

-#elif !defined(GLFW_INCLUDE_NONE)

-

- #if defined(__APPLE__)

-

-  #if !defined(GLFW_INCLUDE_GLEXT)

-   #define GL_GLEXT_LEGACY

-  #endif

-  #include <OpenGL/gl.h>

-  #if defined(GLFW_INCLUDE_GLU)

-   #include <OpenGL/glu.h>

-  #endif

-

- #else /*__APPLE__*/

-

-  #include <GL/gl.h>

-  #if defined(GLFW_INCLUDE_GLEXT)

-   #include <GL/glext.h>

-  #endif

-  #if defined(GLFW_INCLUDE_GLU)

-   #include <GL/glu.h>

-  #endif

-

- #endif /*__APPLE__*/

-

-#endif /* OpenGL and OpenGL ES headers */

-

-#if defined(GLFW_INCLUDE_VULKAN)

-  #include <vulkan/vulkan.h>

-#endif /* Vulkan header */

-

-#if defined(GLFW_DLL) && defined(_GLFW_BUILD_DLL)

- /* GLFW_DLL must be defined by applications that are linking against the DLL

-  * version of the GLFW library.  _GLFW_BUILD_DLL is defined by the GLFW

-  * configuration header when compiling the DLL version of the library.

-  */

- #error "You must not have both GLFW_DLL and _GLFW_BUILD_DLL defined"

-#endif

-

-/* GLFWAPI is used to declare public API functions for export

- * from the DLL / shared library / dynamic library.

- */

-#if defined(_WIN32) && defined(_GLFW_BUILD_DLL)

- /* We are building GLFW as a Win32 DLL */

- #define GLFWAPI __declspec(dllexport)

-#elif defined(_WIN32) && defined(GLFW_DLL)

- /* We are calling GLFW as a Win32 DLL */

- #define GLFWAPI __declspec(dllimport)

-#elif defined(__GNUC__) && defined(_GLFW_BUILD_DLL)

- /* We are building GLFW as a shared / dynamic library */

- #define GLFWAPI __attribute__((visibility("default")))

-#else

- /* We are building or calling GLFW as a static library */

- #define GLFWAPI

-#endif

-

-

-/*************************************************************************

- * GLFW API tokens

- *************************************************************************/

-

-/*! @name GLFW version macros

- *  @{ */

-/*! @brief The major version number of the GLFW library.

- *

- *  This is incremented when the API is changed in non-compatible ways.

- *  @ingroup init

- */

-#define GLFW_VERSION_MAJOR          3

-/*! @brief The minor version number of the GLFW library.

- *

- *  This is incremented when features are added to the API but it remains

- *  backward-compatible.

- *  @ingroup init

- */

-#define GLFW_VERSION_MINOR          3

-/*! @brief The revision number of the GLFW library.

- *

- *  This is incremented when a bug fix release is made that does not contain any

- *  API changes.

- *  @ingroup init

- */

-#define GLFW_VERSION_REVISION       0

-/*! @} */

-

-/*! @name Boolean values

- *  @{ */

-/*! @brief One.

- *

- *  One.  Seriously.  You don't _need_ to use this symbol in your code.  It's

- *  semantic sugar for the number 1.  You can also use `1` or `true` or `_True`

- *  or `GL_TRUE` or whatever you want.

- */

-#define GLFW_TRUE                   1

-/*! @brief Zero.

- *

- *  Zero.  Seriously.  You don't _need_ to use this symbol in your code.  It's

- *  semantic sugar for the number 0.  You can also use `0` or `false` or

- *  `_False` or `GL_FALSE` or whatever you want.

- */

-#define GLFW_FALSE                  0

-/*! @} */

-

-/*! @name Key and button actions

- *  @{ */

-/*! @brief The key or mouse button was released.

- *

- *  The key or mouse button was released.

- *

- *  @ingroup input

- */

-#define GLFW_RELEASE                0

-/*! @brief The key or mouse button was pressed.

- *

- *  The key or mouse button was pressed.

- *

- *  @ingroup input

- */

-#define GLFW_PRESS                  1

-/*! @brief The key was held down until it repeated.

- *

- *  The key was held down until it repeated.

- *

- *  @ingroup input

- */

-#define GLFW_REPEAT                 2

-/*! @} */

-

-/*! @defgroup hat_state Joystick hat states

- *

- *  See [joystick hat input](@ref joystick_hat) for how these are used.

- *

- *  @ingroup input

- *  @{ */

-#define GLFW_HAT_CENTERED           0

-#define GLFW_HAT_UP                 1

-#define GLFW_HAT_RIGHT              2

-#define GLFW_HAT_DOWN               4

-#define GLFW_HAT_LEFT               8

-#define GLFW_HAT_RIGHT_UP           (GLFW_HAT_RIGHT | GLFW_HAT_UP)

-#define GLFW_HAT_RIGHT_DOWN         (GLFW_HAT_RIGHT | GLFW_HAT_DOWN)

-#define GLFW_HAT_LEFT_UP            (GLFW_HAT_LEFT  | GLFW_HAT_UP)

-#define GLFW_HAT_LEFT_DOWN          (GLFW_HAT_LEFT  | GLFW_HAT_DOWN)

-/*! @} */

-

-/*! @defgroup keys Keyboard keys

- *  @brief Keyboard key IDs.

- *

- *  See [key input](@ref input_key) for how these are used.

- *

- *  These key codes are inspired by the _USB HID Usage Tables v1.12_ (p. 53-60),

- *  but re-arranged to map to 7-bit ASCII for printable keys (function keys are

- *  put in the 256+ range).

- *

- *  The naming of the key codes follow these rules:

- *   - The US keyboard layout is used

- *   - Names of printable alpha-numeric characters are used (e.g. "A", "R",

- *     "3", etc.)

- *   - For non-alphanumeric characters, Unicode:ish names are used (e.g.

- *     "COMMA", "LEFT_SQUARE_BRACKET", etc.). Note that some names do not

- *     correspond to the Unicode standard (usually for brevity)

- *   - Keys that lack a clear US mapping are named "WORLD_x"

- *   - For non-printable keys, custom names are used (e.g. "F4",

- *     "BACKSPACE", etc.)

- *

- *  @ingroup input

- *  @{

- */

-

-/* The unknown key */

-#define GLFW_KEY_UNKNOWN            -1

-

-/* Printable keys */

-#define GLFW_KEY_SPACE              32

-#define GLFW_KEY_APOSTROPHE         39  /* ' */

-#define GLFW_KEY_COMMA              44  /* , */

-#define GLFW_KEY_MINUS              45  /* - */

-#define GLFW_KEY_PERIOD             46  /* . */

-#define GLFW_KEY_SLASH              47  /* / */

-#define GLFW_KEY_0                  48

-#define GLFW_KEY_1                  49

-#define GLFW_KEY_2                  50

-#define GLFW_KEY_3                  51

-#define GLFW_KEY_4                  52

-#define GLFW_KEY_5                  53

-#define GLFW_KEY_6                  54

-#define GLFW_KEY_7                  55

-#define GLFW_KEY_8                  56

-#define GLFW_KEY_9                  57

-#define GLFW_KEY_SEMICOLON          59  /* ; */

-#define GLFW_KEY_EQUAL              61  /* = */

-#define GLFW_KEY_A                  65

-#define GLFW_KEY_B                  66

-#define GLFW_KEY_C                  67

-#define GLFW_KEY_D                  68

-#define GLFW_KEY_E                  69

-#define GLFW_KEY_F                  70

-#define GLFW_KEY_G                  71

-#define GLFW_KEY_H                  72

-#define GLFW_KEY_I                  73

-#define GLFW_KEY_J                  74

-#define GLFW_KEY_K                  75

-#define GLFW_KEY_L                  76

-#define GLFW_KEY_M                  77

-#define GLFW_KEY_N                  78

-#define GLFW_KEY_O                  79

-#define GLFW_KEY_P                  80

-#define GLFW_KEY_Q                  81

-#define GLFW_KEY_R                  82

-#define GLFW_KEY_S                  83

-#define GLFW_KEY_T                  84

-#define GLFW_KEY_U                  85

-#define GLFW_KEY_V                  86

-#define GLFW_KEY_W                  87

-#define GLFW_KEY_X                  88

-#define GLFW_KEY_Y                  89

-#define GLFW_KEY_Z                  90

-#define GLFW_KEY_LEFT_BRACKET       91  /* [ */

-#define GLFW_KEY_BACKSLASH          92  /* \ */

-#define GLFW_KEY_RIGHT_BRACKET      93  /* ] */

-#define GLFW_KEY_GRAVE_ACCENT       96  /* ` */

-#define GLFW_KEY_WORLD_1            161 /* non-US #1 */

-#define GLFW_KEY_WORLD_2            162 /* non-US #2 */

-

-/* Function keys */

-#define GLFW_KEY_ESCAPE             256

-#define GLFW_KEY_ENTER              257

-#define GLFW_KEY_TAB                258

-#define GLFW_KEY_BACKSPACE          259

-#define GLFW_KEY_INSERT             260

-#define GLFW_KEY_DELETE             261

-#define GLFW_KEY_RIGHT              262

-#define GLFW_KEY_LEFT               263

-#define GLFW_KEY_DOWN               264

-#define GLFW_KEY_UP                 265

-#define GLFW_KEY_PAGE_UP            266

-#define GLFW_KEY_PAGE_DOWN          267

-#define GLFW_KEY_HOME               268

-#define GLFW_KEY_END                269

-#define GLFW_KEY_CAPS_LOCK          280

-#define GLFW_KEY_SCROLL_LOCK        281

-#define GLFW_KEY_NUM_LOCK           282

-#define GLFW_KEY_PRINT_SCREEN       283

-#define GLFW_KEY_PAUSE              284

-#define GLFW_KEY_F1                 290

-#define GLFW_KEY_F2                 291

-#define GLFW_KEY_F3                 292

-#define GLFW_KEY_F4                 293

-#define GLFW_KEY_F5                 294

-#define GLFW_KEY_F6                 295

-#define GLFW_KEY_F7                 296

-#define GLFW_KEY_F8                 297

-#define GLFW_KEY_F9                 298

-#define GLFW_KEY_F10                299

-#define GLFW_KEY_F11                300

-#define GLFW_KEY_F12                301

-#define GLFW_KEY_F13                302

-#define GLFW_KEY_F14                303

-#define GLFW_KEY_F15                304

-#define GLFW_KEY_F16                305

-#define GLFW_KEY_F17                306

-#define GLFW_KEY_F18                307

-#define GLFW_KEY_F19                308

-#define GLFW_KEY_F20                309

-#define GLFW_KEY_F21                310

-#define GLFW_KEY_F22                311

-#define GLFW_KEY_F23                312

-#define GLFW_KEY_F24                313

-#define GLFW_KEY_F25                314

-#define GLFW_KEY_KP_0               320

-#define GLFW_KEY_KP_1               321

-#define GLFW_KEY_KP_2               322

-#define GLFW_KEY_KP_3               323

-#define GLFW_KEY_KP_4               324

-#define GLFW_KEY_KP_5               325

-#define GLFW_KEY_KP_6               326

-#define GLFW_KEY_KP_7               327

-#define GLFW_KEY_KP_8               328

-#define GLFW_KEY_KP_9               329

-#define GLFW_KEY_KP_DECIMAL         330

-#define GLFW_KEY_KP_DIVIDE          331

-#define GLFW_KEY_KP_MULTIPLY        332

-#define GLFW_KEY_KP_SUBTRACT        333

-#define GLFW_KEY_KP_ADD             334

-#define GLFW_KEY_KP_ENTER           335

-#define GLFW_KEY_KP_EQUAL           336

-#define GLFW_KEY_LEFT_SHIFT         340

-#define GLFW_KEY_LEFT_CONTROL       341

-#define GLFW_KEY_LEFT_ALT           342

-#define GLFW_KEY_LEFT_SUPER         343

-#define GLFW_KEY_RIGHT_SHIFT        344

-#define GLFW_KEY_RIGHT_CONTROL      345

-#define GLFW_KEY_RIGHT_ALT          346

-#define GLFW_KEY_RIGHT_SUPER        347

-#define GLFW_KEY_MENU               348

-

-#define GLFW_KEY_LAST               GLFW_KEY_MENU

-

-/*! @} */

-

-/*! @defgroup mods Modifier key flags

- *  @brief Modifier key flags.

- *

- *  See [key input](@ref input_key) for how these are used.

- *

- *  @ingroup input

- *  @{ */

-

-/*! @brief If this bit is set one or more Shift keys were held down.

- *

- *  If this bit is set one or more Shift keys were held down.

- */

-#define GLFW_MOD_SHIFT           0x0001

-/*! @brief If this bit is set one or more Control keys were held down.

- *

- *  If this bit is set one or more Control keys were held down.

- */

-#define GLFW_MOD_CONTROL         0x0002

-/*! @brief If this bit is set one or more Alt keys were held down.

- *

- *  If this bit is set one or more Alt keys were held down.

- */

-#define GLFW_MOD_ALT             0x0004

-/*! @brief If this bit is set one or more Super keys were held down.

- *

- *  If this bit is set one or more Super keys were held down.

- */

-#define GLFW_MOD_SUPER           0x0008

-/*! @brief If this bit is set the Caps Lock key is enabled.

- *

- *  If this bit is set the Caps Lock key is enabled and the @ref

- *  GLFW_LOCK_KEY_MODS input mode is set.

- */

-#define GLFW_MOD_CAPS_LOCK       0x0010

-/*! @brief If this bit is set the Num Lock key is enabled.

- *

- *  If this bit is set the Num Lock key is enabled and the @ref

- *  GLFW_LOCK_KEY_MODS input mode is set.

- */

-#define GLFW_MOD_NUM_LOCK        0x0020

-

-/*! @} */

-

-/*! @defgroup buttons Mouse buttons

- *  @brief Mouse button IDs.

- *

- *  See [mouse button input](@ref input_mouse_button) for how these are used.

- *

- *  @ingroup input

- *  @{ */

-#define GLFW_MOUSE_BUTTON_1         0

-#define GLFW_MOUSE_BUTTON_2         1

-#define GLFW_MOUSE_BUTTON_3         2

-#define GLFW_MOUSE_BUTTON_4         3

-#define GLFW_MOUSE_BUTTON_5         4

-#define GLFW_MOUSE_BUTTON_6         5

-#define GLFW_MOUSE_BUTTON_7         6

-#define GLFW_MOUSE_BUTTON_8         7

-#define GLFW_MOUSE_BUTTON_LAST      GLFW_MOUSE_BUTTON_8

-#define GLFW_MOUSE_BUTTON_LEFT      GLFW_MOUSE_BUTTON_1

-#define GLFW_MOUSE_BUTTON_RIGHT     GLFW_MOUSE_BUTTON_2

-#define GLFW_MOUSE_BUTTON_MIDDLE    GLFW_MOUSE_BUTTON_3

-/*! @} */

-

-/*! @defgroup joysticks Joysticks

- *  @brief Joystick IDs.

- *

- *  See [joystick input](@ref joystick) for how these are used.

- *

- *  @ingroup input

- *  @{ */

-#define GLFW_JOYSTICK_1             0

-#define GLFW_JOYSTICK_2             1

-#define GLFW_JOYSTICK_3             2

-#define GLFW_JOYSTICK_4             3

-#define GLFW_JOYSTICK_5             4

-#define GLFW_JOYSTICK_6             5

-#define GLFW_JOYSTICK_7             6

-#define GLFW_JOYSTICK_8             7

-#define GLFW_JOYSTICK_9             8

-#define GLFW_JOYSTICK_10            9

-#define GLFW_JOYSTICK_11            10

-#define GLFW_JOYSTICK_12            11

-#define GLFW_JOYSTICK_13            12

-#define GLFW_JOYSTICK_14            13

-#define GLFW_JOYSTICK_15            14

-#define GLFW_JOYSTICK_16            15

-#define GLFW_JOYSTICK_LAST          GLFW_JOYSTICK_16

-/*! @} */

-

-/*! @defgroup gamepad_buttons Gamepad buttons

- *  @brief Gamepad buttons.

- *

- *  See @ref gamepad for how these are used.

- *

- *  @ingroup input

- *  @{ */

-#define GLFW_GAMEPAD_BUTTON_A               0

-#define GLFW_GAMEPAD_BUTTON_B               1

-#define GLFW_GAMEPAD_BUTTON_X               2

-#define GLFW_GAMEPAD_BUTTON_Y               3

-#define GLFW_GAMEPAD_BUTTON_LEFT_BUMPER     4

-#define GLFW_GAMEPAD_BUTTON_RIGHT_BUMPER    5

-#define GLFW_GAMEPAD_BUTTON_BACK            6

-#define GLFW_GAMEPAD_BUTTON_START           7

-#define GLFW_GAMEPAD_BUTTON_GUIDE           8

-#define GLFW_GAMEPAD_BUTTON_LEFT_THUMB      9

-#define GLFW_GAMEPAD_BUTTON_RIGHT_THUMB     10

-#define GLFW_GAMEPAD_BUTTON_DPAD_UP         11

-#define GLFW_GAMEPAD_BUTTON_DPAD_RIGHT      12

-#define GLFW_GAMEPAD_BUTTON_DPAD_DOWN       13

-#define GLFW_GAMEPAD_BUTTON_DPAD_LEFT       14

-#define GLFW_GAMEPAD_BUTTON_LAST            GLFW_GAMEPAD_BUTTON_DPAD_LEFT

-

-#define GLFW_GAMEPAD_BUTTON_CROSS       GLFW_GAMEPAD_BUTTON_A

-#define GLFW_GAMEPAD_BUTTON_CIRCLE      GLFW_GAMEPAD_BUTTON_B

-#define GLFW_GAMEPAD_BUTTON_SQUARE      GLFW_GAMEPAD_BUTTON_X

-#define GLFW_GAMEPAD_BUTTON_TRIANGLE    GLFW_GAMEPAD_BUTTON_Y

-/*! @} */

-

-/*! @defgroup gamepad_axes Gamepad axes

- *  @brief Gamepad axes.

- *

- *  See @ref gamepad for how these are used.

- *

- *  @ingroup input

- *  @{ */

-#define GLFW_GAMEPAD_AXIS_LEFT_X        0

-#define GLFW_GAMEPAD_AXIS_LEFT_Y        1

-#define GLFW_GAMEPAD_AXIS_RIGHT_X       2

-#define GLFW_GAMEPAD_AXIS_RIGHT_Y       3

-#define GLFW_GAMEPAD_AXIS_LEFT_TRIGGER  4

-#define GLFW_GAMEPAD_AXIS_RIGHT_TRIGGER 5

-#define GLFW_GAMEPAD_AXIS_LAST          GLFW_GAMEPAD_AXIS_RIGHT_TRIGGER

-/*! @} */

-

-/*! @defgroup errors Error codes

- *  @brief Error codes.

- *

- *  See [error handling](@ref error_handling) for how these are used.

- *

- *  @ingroup init

- *  @{ */

-/*! @brief No error has occurred.

- *

- *  No error has occurred.

- *

- *  @analysis Yay.

- */

-#define GLFW_NO_ERROR               0

-/*! @brief GLFW has not been initialized.

- *

- *  This occurs if a GLFW function was called that must not be called unless the

- *  library is [initialized](@ref intro_init).

- *

- *  @analysis Application programmer error.  Initialize GLFW before calling any

- *  function that requires initialization.

- */

-#define GLFW_NOT_INITIALIZED        0x00010001

-/*! @brief No context is current for this thread.

- *

- *  This occurs if a GLFW function was called that needs and operates on the

- *  current OpenGL or OpenGL ES context but no context is current on the calling

- *  thread.  One such function is @ref glfwSwapInterval.

- *

- *  @analysis Application programmer error.  Ensure a context is current before

- *  calling functions that require a current context.

- */

-#define GLFW_NO_CURRENT_CONTEXT     0x00010002

-/*! @brief One of the arguments to the function was an invalid enum value.

- *

- *  One of the arguments to the function was an invalid enum value, for example

- *  requesting @ref GLFW_RED_BITS with @ref glfwGetWindowAttrib.

- *

- *  @analysis Application programmer error.  Fix the offending call.

- */

-#define GLFW_INVALID_ENUM           0x00010003

-/*! @brief One of the arguments to the function was an invalid value.

- *

- *  One of the arguments to the function was an invalid value, for example

- *  requesting a non-existent OpenGL or OpenGL ES version like 2.7.

- *

- *  Requesting a valid but unavailable OpenGL or OpenGL ES version will instead

- *  result in a @ref GLFW_VERSION_UNAVAILABLE error.

- *

- *  @analysis Application programmer error.  Fix the offending call.

- */

-#define GLFW_INVALID_VALUE          0x00010004

-/*! @brief A memory allocation failed.

- *

- *  A memory allocation failed.

- *

- *  @analysis A bug in GLFW or the underlying operating system.  Report the bug

- *  to our [issue tracker](https://github.com/glfw/glfw/issues).

- */

-#define GLFW_OUT_OF_MEMORY          0x00010005

-/*! @brief GLFW could not find support for the requested API on the system.

- *

- *  GLFW could not find support for the requested API on the system.

- *

- *  @analysis The installed graphics driver does not support the requested

- *  API, or does not support it via the chosen context creation backend.

- *  Below are a few examples.

- *

- *  @par

- *  Some pre-installed Windows graphics drivers do not support OpenGL.  AMD only

- *  supports OpenGL ES via EGL, while Nvidia and Intel only support it via

- *  a WGL or GLX extension.  macOS does not provide OpenGL ES at all.  The Mesa

- *  EGL, OpenGL and OpenGL ES libraries do not interface with the Nvidia binary

- *  driver.  Older graphics drivers do not support Vulkan.

- */

-#define GLFW_API_UNAVAILABLE        0x00010006

-/*! @brief The requested OpenGL or OpenGL ES version is not available.

- *

- *  The requested OpenGL or OpenGL ES version (including any requested context

- *  or framebuffer hints) is not available on this machine.

- *

- *  @analysis The machine does not support your requirements.  If your

- *  application is sufficiently flexible, downgrade your requirements and try

- *  again.  Otherwise, inform the user that their machine does not match your

- *  requirements.

- *

- *  @par

- *  Future invalid OpenGL and OpenGL ES versions, for example OpenGL 4.8 if 5.0

- *  comes out before the 4.x series gets that far, also fail with this error and

- *  not @ref GLFW_INVALID_VALUE, because GLFW cannot know what future versions

- *  will exist.

- */

-#define GLFW_VERSION_UNAVAILABLE    0x00010007

-/*! @brief A platform-specific error occurred that does not match any of the

- *  more specific categories.

- *

- *  A platform-specific error occurred that does not match any of the more

- *  specific categories.

- *

- *  @analysis A bug or configuration error in GLFW, the underlying operating

- *  system or its drivers, or a lack of required resources.  Report the issue to

- *  our [issue tracker](https://github.com/glfw/glfw/issues).

- */

-#define GLFW_PLATFORM_ERROR         0x00010008

-/*! @brief The requested format is not supported or available.

- *

- *  If emitted during window creation, the requested pixel format is not

- *  supported.

- *

- *  If emitted when querying the clipboard, the contents of the clipboard could

- *  not be converted to the requested format.

- *

- *  @analysis If emitted during window creation, one or more

- *  [hard constraints](@ref window_hints_hard) did not match any of the

- *  available pixel formats.  If your application is sufficiently flexible,

- *  downgrade your requirements and try again.  Otherwise, inform the user that

- *  their machine does not match your requirements.

- *

- *  @par

- *  If emitted when querying the clipboard, ignore the error or report it to

- *  the user, as appropriate.

- */

-#define GLFW_FORMAT_UNAVAILABLE     0x00010009

-/*! @brief The specified window does not have an OpenGL or OpenGL ES context.

- *

- *  A window that does not have an OpenGL or OpenGL ES context was passed to

- *  a function that requires it to have one.

- *

- *  @analysis Application programmer error.  Fix the offending call.

- */

-#define GLFW_NO_WINDOW_CONTEXT      0x0001000A

-/*! @} */

-

-/*! @addtogroup window

- *  @{ */

-/*! @brief Input focus window hint and attribute

- *

- *  Input focus [window hint](@ref GLFW_FOCUSED_hint) or

- *  [window attribute](@ref GLFW_FOCUSED_attrib).

- */

-#define GLFW_FOCUSED                0x00020001

-/*! @brief Window iconification window attribute

- *

- *  Window iconification [window attribute](@ref GLFW_ICONIFIED_attrib).

- */

-#define GLFW_ICONIFIED              0x00020002

-/*! @brief Window resize-ability window hint and attribute

- *

- *  Window resize-ability [window hint](@ref GLFW_RESIZABLE_hint) and

- *  [window attribute](@ref GLFW_RESIZABLE_attrib).

- */

-#define GLFW_RESIZABLE              0x00020003

-/*! @brief Window visibility window hint and attribute

- *

- *  Window visibility [window hint](@ref GLFW_VISIBLE_hint) and

- *  [window attribute](@ref GLFW_VISIBLE_attrib).

- */

-#define GLFW_VISIBLE                0x00020004

-/*! @brief Window decoration window hint and attribute

- *

- *  Window decoration [window hint](@ref GLFW_DECORATED_hint) and

- *  [window attribute](@ref GLFW_DECORATED_attrib).

- */

-#define GLFW_DECORATED              0x00020005

-/*! @brief Window auto-iconification window hint and attribute

- *

- *  Window auto-iconification [window hint](@ref GLFW_AUTO_ICONIFY_hint) and

- *  [window attribute](@ref GLFW_AUTO_ICONIFY_attrib).

- */

-#define GLFW_AUTO_ICONIFY           0x00020006

-/*! @brief Window decoration window hint and attribute

- *

- *  Window decoration [window hint](@ref GLFW_FLOATING_hint) and

- *  [window attribute](@ref GLFW_FLOATING_attrib).

- */

-#define GLFW_FLOATING               0x00020007

-/*! @brief Window maximization window hint and attribute

- *

- *  Window maximization [window hint](@ref GLFW_MAXIMIZED_hint) and

- *  [window attribute](@ref GLFW_MAXIMIZED_attrib).

- */

-#define GLFW_MAXIMIZED              0x00020008

-/*! @brief Cursor centering window hint

- *

- *  Cursor centering [window hint](@ref GLFW_CENTER_CURSOR_hint).

- */

-#define GLFW_CENTER_CURSOR          0x00020009

-/*! @brief Window framebuffer transparency hint and attribute

- *

- *  Window framebuffer transparency

- *  [window hint](@ref GLFW_TRANSPARENT_FRAMEBUFFER_hint) and

- *  [window attribute](@ref GLFW_TRANSPARENT_FRAMEBUFFER_attrib).

- */

-#define GLFW_TRANSPARENT_FRAMEBUFFER 0x0002000A

-/*! @brief Mouse cursor hover window attribute.

- *

- *  Mouse cursor hover [window attribute](@ref GLFW_HOVERED_attrib).

- */

-#define GLFW_HOVERED                0x0002000B

-/*! @brief Input focus on calling show window hint and attribute

- *

- *  Input focus [window hint](@ref GLFW_FOCUS_ON_SHOW_hint) or

- *  [window attribute](@ref GLFW_FOCUS_ON_SHOW_attrib).

- */

-#define GLFW_FOCUS_ON_SHOW          0x0002000C

-

-/*! @brief Framebuffer bit depth hint.

- *

- *  Framebuffer bit depth [hint](@ref GLFW_RED_BITS).

- */

-#define GLFW_RED_BITS               0x00021001

-/*! @brief Framebuffer bit depth hint.

- *

- *  Framebuffer bit depth [hint](@ref GLFW_GREEN_BITS).

- */

-#define GLFW_GREEN_BITS             0x00021002

-/*! @brief Framebuffer bit depth hint.

- *

- *  Framebuffer bit depth [hint](@ref GLFW_BLUE_BITS).

- */

-#define GLFW_BLUE_BITS              0x00021003

-/*! @brief Framebuffer bit depth hint.

- *

- *  Framebuffer bit depth [hint](@ref GLFW_ALPHA_BITS).

- */

-#define GLFW_ALPHA_BITS             0x00021004

-/*! @brief Framebuffer bit depth hint.

- *

- *  Framebuffer bit depth [hint](@ref GLFW_DEPTH_BITS).

- */

-#define GLFW_DEPTH_BITS             0x00021005

-/*! @brief Framebuffer bit depth hint.

- *

- *  Framebuffer bit depth [hint](@ref GLFW_STENCIL_BITS).

- */

-#define GLFW_STENCIL_BITS           0x00021006

-/*! @brief Framebuffer bit depth hint.

- *

- *  Framebuffer bit depth [hint](@ref GLFW_ACCUM_RED_BITS).

- */

-#define GLFW_ACCUM_RED_BITS         0x00021007

-/*! @brief Framebuffer bit depth hint.

- *

- *  Framebuffer bit depth [hint](@ref GLFW_ACCUM_GREEN_BITS).

- */

-#define GLFW_ACCUM_GREEN_BITS       0x00021008

-/*! @brief Framebuffer bit depth hint.

- *

- *  Framebuffer bit depth [hint](@ref GLFW_ACCUM_BLUE_BITS).

- */

-#define GLFW_ACCUM_BLUE_BITS        0x00021009

-/*! @brief Framebuffer bit depth hint.

- *

- *  Framebuffer bit depth [hint](@ref GLFW_ACCUM_ALPHA_BITS).

- */

-#define GLFW_ACCUM_ALPHA_BITS       0x0002100A

-/*! @brief Framebuffer auxiliary buffer hint.

- *

- *  Framebuffer auxiliary buffer [hint](@ref GLFW_AUX_BUFFERS).

- */

-#define GLFW_AUX_BUFFERS            0x0002100B

-/*! @brief OpenGL stereoscopic rendering hint.

- *

- *  OpenGL stereoscopic rendering [hint](@ref GLFW_STEREO).

- */

-#define GLFW_STEREO                 0x0002100C

-/*! @brief Framebuffer MSAA samples hint.

- *

- *  Framebuffer MSAA samples [hint](@ref GLFW_SAMPLES).

- */

-#define GLFW_SAMPLES                0x0002100D

-/*! @brief Framebuffer sRGB hint.

- *

- *  Framebuffer sRGB [hint](@ref GLFW_SRGB_CAPABLE).

- */

-#define GLFW_SRGB_CAPABLE           0x0002100E

-/*! @brief Monitor refresh rate hint.

- *

- *  Monitor refresh rate [hint](@ref GLFW_REFRESH_RATE).

- */

-#define GLFW_REFRESH_RATE           0x0002100F

-/*! @brief Framebuffer double buffering hint.

- *

- *  Framebuffer double buffering [hint](@ref GLFW_DOUBLEBUFFER).

- */

-#define GLFW_DOUBLEBUFFER           0x00021010

-

-/*! @brief Context client API hint and attribute.

- *

- *  Context client API [hint](@ref GLFW_CLIENT_API_hint) and

- *  [attribute](@ref GLFW_CLIENT_API_attrib).

- */

-#define GLFW_CLIENT_API             0x00022001

-/*! @brief Context client API major version hint and attribute.

- *

- *  Context client API major version [hint](@ref GLFW_CLIENT_API_hint) and

- *  [attribute](@ref GLFW_CLIENT_API_attrib).

- */

-#define GLFW_CONTEXT_VERSION_MAJOR  0x00022002

-/*! @brief Context client API minor version hint and attribute.

- *

- *  Context client API minor version [hint](@ref GLFW_CLIENT_API_hint) and

- *  [attribute](@ref GLFW_CLIENT_API_attrib).

- */

-#define GLFW_CONTEXT_VERSION_MINOR  0x00022003

-/*! @brief Context client API revision number hint and attribute.

- *

- *  Context client API revision number [hint](@ref GLFW_CLIENT_API_hint) and

- *  [attribute](@ref GLFW_CLIENT_API_attrib).

- */

-#define GLFW_CONTEXT_REVISION       0x00022004

-/*! @brief Context robustness hint and attribute.

- *

- *  Context client API revision number [hint](@ref GLFW_CLIENT_API_hint) and

- *  [attribute](@ref GLFW_CLIENT_API_attrib).

- */

-#define GLFW_CONTEXT_ROBUSTNESS     0x00022005

-/*! @brief OpenGL forward-compatibility hint and attribute.

- *

- *  OpenGL forward-compatibility [hint](@ref GLFW_CLIENT_API_hint) and

- *  [attribute](@ref GLFW_CLIENT_API_attrib).

- */

-#define GLFW_OPENGL_FORWARD_COMPAT  0x00022006

-/*! @brief OpenGL debug context hint and attribute.

- *

- *  OpenGL debug context [hint](@ref GLFW_CLIENT_API_hint) and

- *  [attribute](@ref GLFW_CLIENT_API_attrib).

- */

-#define GLFW_OPENGL_DEBUG_CONTEXT   0x00022007

-/*! @brief OpenGL profile hint and attribute.

- *

- *  OpenGL profile [hint](@ref GLFW_CLIENT_API_hint) and

- *  [attribute](@ref GLFW_CLIENT_API_attrib).

- */

-#define GLFW_OPENGL_PROFILE         0x00022008

-/*! @brief Context flush-on-release hint and attribute.

- *

- *  Context flush-on-release [hint](@ref GLFW_CLIENT_API_hint) and

- *  [attribute](@ref GLFW_CLIENT_API_attrib).

- */

-#define GLFW_CONTEXT_RELEASE_BEHAVIOR 0x00022009

-/*! @brief Context error suppression hint and attribute.

- *

- *  Context error suppression [hint](@ref GLFW_CLIENT_API_hint) and

- *  [attribute](@ref GLFW_CLIENT_API_attrib).

- */

-#define GLFW_CONTEXT_NO_ERROR       0x0002200A

-/*! @brief Context creation API hint and attribute.

- *

- *  Context creation API [hint](@ref GLFW_CLIENT_API_hint) and

- *  [attribute](@ref GLFW_CLIENT_API_attrib).

- */

-#define GLFW_CONTEXT_CREATION_API   0x0002200B

-/*! @brief Window content area scaling window

- *  [window hint](@ref GLFW_SCALE_TO_MONITOR).

- */

-#define GLFW_SCALE_TO_MONITOR       0x0002200C

-

-#define GLFW_COCOA_RETINA_FRAMEBUFFER 0x00023001

-#define GLFW_COCOA_FRAME_NAME         0x00023002

-#define GLFW_COCOA_GRAPHICS_SWITCHING 0x00023003

-

-#define GLFW_X11_CLASS_NAME         0x00024001

-#define GLFW_X11_INSTANCE_NAME      0x00024002

-/*! @} */

-

-#define GLFW_NO_API                          0

-#define GLFW_OPENGL_API             0x00030001

-#define GLFW_OPENGL_ES_API          0x00030002

-

-#define GLFW_NO_ROBUSTNESS                   0

-#define GLFW_NO_RESET_NOTIFICATION  0x00031001

-#define GLFW_LOSE_CONTEXT_ON_RESET  0x00031002

-

-#define GLFW_OPENGL_ANY_PROFILE              0

-#define GLFW_OPENGL_CORE_PROFILE    0x00032001

-#define GLFW_OPENGL_COMPAT_PROFILE  0x00032002

-

-#define GLFW_CURSOR                 0x00033001

-#define GLFW_STICKY_KEYS            0x00033002

-#define GLFW_STICKY_MOUSE_BUTTONS   0x00033003

-#define GLFW_LOCK_KEY_MODS          0x00033004

-

-#define GLFW_CURSOR_NORMAL          0x00034001

-#define GLFW_CURSOR_HIDDEN          0x00034002

-#define GLFW_CURSOR_DISABLED        0x00034003

-

-#define GLFW_ANY_RELEASE_BEHAVIOR            0

-#define GLFW_RELEASE_BEHAVIOR_FLUSH 0x00035001

-#define GLFW_RELEASE_BEHAVIOR_NONE  0x00035002

-

-#define GLFW_NATIVE_CONTEXT_API     0x00036001

-#define GLFW_EGL_CONTEXT_API        0x00036002

-#define GLFW_OSMESA_CONTEXT_API     0x00036003

-

-/*! @defgroup shapes Standard cursor shapes

- *  @brief Standard system cursor shapes.

- *

- *  See [standard cursor creation](@ref cursor_standard) for how these are used.

- *

- *  @ingroup input

- *  @{ */

-

-/*! @brief The regular arrow cursor shape.

- *

- *  The regular arrow cursor.

- */

-#define GLFW_ARROW_CURSOR           0x00036001

-/*! @brief The text input I-beam cursor shape.

- *

- *  The text input I-beam cursor shape.

- */

-#define GLFW_IBEAM_CURSOR           0x00036002

-/*! @brief The crosshair shape.

- *

- *  The crosshair shape.

- */

-#define GLFW_CROSSHAIR_CURSOR       0x00036003

-/*! @brief The hand shape.

- *

- *  The hand shape.

- */

-#define GLFW_HAND_CURSOR            0x00036004

-/*! @brief The horizontal resize arrow shape.

- *

- *  The horizontal resize arrow shape.

- */

-#define GLFW_HRESIZE_CURSOR         0x00036005

-/*! @brief The vertical resize arrow shape.

- *

- *  The vertical resize arrow shape.

- */

-#define GLFW_VRESIZE_CURSOR         0x00036006

-/*! @} */

-

-#define GLFW_CONNECTED              0x00040001

-#define GLFW_DISCONNECTED           0x00040002

-

-/*! @addtogroup init

- *  @{ */

-#define GLFW_JOYSTICK_HAT_BUTTONS   0x00050001

-

-#define GLFW_COCOA_CHDIR_RESOURCES  0x00051001

-#define GLFW_COCOA_MENUBAR          0x00051002

-/*! @} */

-

-#define GLFW_DONT_CARE              -1

-

-

-/*************************************************************************

- * GLFW API types

- *************************************************************************/

-

-/*! @brief Client API function pointer type.

- *

- *  Generic function pointer used for returning client API function pointers

- *  without forcing a cast from a regular pointer.

- *

- *  @sa @ref context_glext

- *  @sa @ref glfwGetProcAddress

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup context

- */

-typedef void (*GLFWglproc)(void);

-

-/*! @brief Vulkan API function pointer type.

- *

- *  Generic function pointer used for returning Vulkan API function pointers

- *  without forcing a cast from a regular pointer.

- *

- *  @sa @ref vulkan_proc

- *  @sa @ref glfwGetInstanceProcAddress

- *

- *  @since Added in version 3.2.

- *

- *  @ingroup vulkan

- */

-typedef void (*GLFWvkproc)(void);

-

-/*! @brief Opaque monitor object.

- *

- *  Opaque monitor object.

- *

- *  @see @ref monitor_object

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup monitor

- */

-typedef struct GLFWmonitor GLFWmonitor;

-

-/*! @brief Opaque window object.

- *

- *  Opaque window object.

- *

- *  @see @ref window_object

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup window

- */

-typedef struct GLFWwindow GLFWwindow;

-

-/*! @brief Opaque cursor object.

- *

- *  Opaque cursor object.

- *

- *  @see @ref cursor_object

- *

- *  @since Added in version 3.1.

- *

- *  @ingroup cursor

- */

-typedef struct GLFWcursor GLFWcursor;

-

-/*! @brief The function signature for error callbacks.

- *

- *  This is the function signature for error callback functions.

- *

- *  @param[in] error An [error code](@ref errors).

- *  @param[in] description A UTF-8 encoded string describing the error.

- *

- *  @sa @ref error_handling

- *  @sa @ref glfwSetErrorCallback

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup init

- */

-typedef void (* GLFWerrorfun)(int,const char*);

-

-/*! @brief The function signature for window position callbacks.

- *

- *  This is the function signature for window position callback functions.

- *

- *  @param[in] window The window that was moved.

- *  @param[in] xpos The new x-coordinate, in screen coordinates, of the

- *  upper-left corner of the client area of the window.

- *  @param[in] ypos The new y-coordinate, in screen coordinates, of the

- *  upper-left corner of the client area of the window.

- *

- *  @sa @ref window_pos

- *  @sa @ref glfwSetWindowPosCallback

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup window

- */

-typedef void (* GLFWwindowposfun)(GLFWwindow*,int,int);

-

-/*! @brief The function signature for window resize callbacks.

- *

- *  This is the function signature for window size callback functions.

- *

- *  @param[in] window The window that was resized.

- *  @param[in] width The new width, in screen coordinates, of the window.

- *  @param[in] height The new height, in screen coordinates, of the window.

- *

- *  @sa @ref window_size

- *  @sa @ref glfwSetWindowSizeCallback

- *

- *  @since Added in version 1.0.

- *  @glfw3 Added window handle parameter.

- *

- *  @ingroup window

- */

-typedef void (* GLFWwindowsizefun)(GLFWwindow*,int,int);

-

-/*! @brief The function signature for window close callbacks.

- *

- *  This is the function signature for window close callback functions.

- *

- *  @param[in] window The window that the user attempted to close.

- *

- *  @sa @ref window_close

- *  @sa @ref glfwSetWindowCloseCallback

- *

- *  @since Added in version 2.5.

- *  @glfw3 Added window handle parameter.

- *

- *  @ingroup window

- */

-typedef void (* GLFWwindowclosefun)(GLFWwindow*);

-

-/*! @brief The function signature for window content refresh callbacks.

- *

- *  This is the function signature for window refresh callback functions.

- *

- *  @param[in] window The window whose content needs to be refreshed.

- *

- *  @sa @ref window_refresh

- *  @sa @ref glfwSetWindowRefreshCallback

- *

- *  @since Added in version 2.5.

- *  @glfw3 Added window handle parameter.

- *

- *  @ingroup window

- */

-typedef void (* GLFWwindowrefreshfun)(GLFWwindow*);

-

-/*! @brief The function signature for window focus/defocus callbacks.

- *

- *  This is the function signature for window focus callback functions.

- *

- *  @param[in] window The window that gained or lost input focus.

- *  @param[in] focused `GLFW_TRUE` if the window was given input focus, or

- *  `GLFW_FALSE` if it lost it.

- *

- *  @sa @ref window_focus

- *  @sa @ref glfwSetWindowFocusCallback

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup window

- */

-typedef void (* GLFWwindowfocusfun)(GLFWwindow*,int);

-

-/*! @brief The function signature for window iconify/restore callbacks.

- *

- *  This is the function signature for window iconify/restore callback

- *  functions.

- *

- *  @param[in] window The window that was iconified or restored.

- *  @param[in] iconified `GLFW_TRUE` if the window was iconified, or

- *  `GLFW_FALSE` if it was restored.

- *

- *  @sa @ref window_iconify

- *  @sa @ref glfwSetWindowIconifyCallback

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup window

- */

-typedef void (* GLFWwindowiconifyfun)(GLFWwindow*,int);

-

-/*! @brief The function signature for window maximize/restore callbacks.

- *

- *  This is the function signature for window maximize/restore callback

- *  functions.

- *

- *  @param[in] window The window that was maximized or restored.

- *  @param[in] iconified `GLFW_TRUE` if the window was maximized, or

- *  `GLFW_FALSE` if it was restored.

- *

- *  @sa @ref window_maximize

- *  @sa glfwSetWindowMaximizeCallback

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup window

- */

-typedef void (* GLFWwindowmaximizefun)(GLFWwindow*,int);

-

-/*! @brief The function signature for framebuffer resize callbacks.

- *

- *  This is the function signature for framebuffer resize callback

- *  functions.

- *

- *  @param[in] window The window whose framebuffer was resized.

- *  @param[in] width The new width, in pixels, of the framebuffer.

- *  @param[in] height The new height, in pixels, of the framebuffer.

- *

- *  @sa @ref window_fbsize

- *  @sa @ref glfwSetFramebufferSizeCallback

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup window

- */

-typedef void (* GLFWframebuffersizefun)(GLFWwindow*,int,int);

-

-/*! @brief The function signature for window content scale callbacks.

- *

- *  This is the function signature for window content scale callback

- *  functions.

- *

- *  @param[in] window The window whose content scale changed.

- *  @param[in] xscale The new x-axis content scale of the window.

- *  @param[in] yscale The new y-axis content scale of the window.

- *

- *  @sa @ref window_scale

- *  @sa @ref glfwSetWindowContentScaleCallback

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup window

- */

-typedef void (* GLFWwindowcontentscalefun)(GLFWwindow*,float,float);

-

-/*! @brief The function signature for mouse button callbacks.

- *

- *  This is the function signature for mouse button callback functions.

- *

- *  @param[in] window The window that received the event.

- *  @param[in] button The [mouse button](@ref buttons) that was pressed or

- *  released.

- *  @param[in] action One of `GLFW_PRESS` or `GLFW_RELEASE`.

- *  @param[in] mods Bit field describing which [modifier keys](@ref mods) were

- *  held down.

- *

- *  @sa @ref input_mouse_button

- *  @sa @ref glfwSetMouseButtonCallback

- *

- *  @since Added in version 1.0.

- *  @glfw3 Added window handle and modifier mask parameters.

- *

- *  @ingroup input

- */

-typedef void (* GLFWmousebuttonfun)(GLFWwindow*,int,int,int);

-

-/*! @brief The function signature for cursor position callbacks.

- *

- *  This is the function signature for cursor position callback functions.

- *

- *  @param[in] window The window that received the event.

- *  @param[in] xpos The new cursor x-coordinate, relative to the left edge of

- *  the client area.

- *  @param[in] ypos The new cursor y-coordinate, relative to the top edge of the

- *  client area.

- *

- *  @sa @ref cursor_pos

- *  @sa @ref glfwSetCursorPosCallback

- *

- *  @since Added in version 3.0.  Replaces `GLFWmouseposfun`.

- *

- *  @ingroup input

- */

-typedef void (* GLFWcursorposfun)(GLFWwindow*,double,double);

-

-/*! @brief The function signature for cursor enter/leave callbacks.

- *

- *  This is the function signature for cursor enter/leave callback functions.

- *

- *  @param[in] window The window that received the event.

- *  @param[in] entered `GLFW_TRUE` if the cursor entered the window's client

- *  area, or `GLFW_FALSE` if it left it.

- *

- *  @sa @ref cursor_enter

- *  @sa @ref glfwSetCursorEnterCallback

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup input

- */

-typedef void (* GLFWcursorenterfun)(GLFWwindow*,int);

-

-/*! @brief The function signature for scroll callbacks.

- *

- *  This is the function signature for scroll callback functions.

- *

- *  @param[in] window The window that received the event.

- *  @param[in] xoffset The scroll offset along the x-axis.

- *  @param[in] yoffset The scroll offset along the y-axis.

- *

- *  @sa @ref scrolling

- *  @sa @ref glfwSetScrollCallback

- *

- *  @since Added in version 3.0.  Replaces `GLFWmousewheelfun`.

- *

- *  @ingroup input

- */

-typedef void (* GLFWscrollfun)(GLFWwindow*,double,double);

-

-/*! @brief The function signature for keyboard key callbacks.

- *

- *  This is the function signature for keyboard key callback functions.

- *

- *  @param[in] window The window that received the event.

- *  @param[in] key The [keyboard key](@ref keys) that was pressed or released.

- *  @param[in] scancode The system-specific scancode of the key.

- *  @param[in] action `GLFW_PRESS`, `GLFW_RELEASE` or `GLFW_REPEAT`.

- *  @param[in] mods Bit field describing which [modifier keys](@ref mods) were

- *  held down.

- *

- *  @sa @ref input_key

- *  @sa @ref glfwSetKeyCallback

- *

- *  @since Added in version 1.0.

- *  @glfw3 Added window handle, scancode and modifier mask parameters.

- *

- *  @ingroup input

- */

-typedef void (* GLFWkeyfun)(GLFWwindow*,int,int,int,int);

-

-/*! @brief The function signature for Unicode character callbacks.

- *

- *  This is the function signature for Unicode character callback functions.

- *

- *  @param[in] window The window that received the event.

- *  @param[in] codepoint The Unicode code point of the character.

- *

- *  @sa @ref input_char

- *  @sa @ref glfwSetCharCallback

- *

- *  @since Added in version 2.4.

- *  @glfw3 Added window handle parameter.

- *

- *  @ingroup input

- */

-typedef void (* GLFWcharfun)(GLFWwindow*,unsigned int);

-

-/*! @brief The function signature for Unicode character with modifiers

- *  callbacks.

- *

- *  This is the function signature for Unicode character with modifiers callback

- *  functions.  It is called for each input character, regardless of what

- *  modifier keys are held down.

- *

- *  @param[in] window The window that received the event.

- *  @param[in] codepoint The Unicode code point of the character.

- *  @param[in] mods Bit field describing which [modifier keys](@ref mods) were

- *  held down.

- *

- *  @sa @ref input_char

- *  @sa @ref glfwSetCharModsCallback

- *

- *  @deprecated Scheduled for removal in version 4.0.

- *

- *  @since Added in version 3.1.

- *

- *  @ingroup input

- */

-typedef void (* GLFWcharmodsfun)(GLFWwindow*,unsigned int,int);

-

-/*! @brief The function signature for file drop callbacks.

- *

- *  This is the function signature for file drop callbacks.

- *

- *  @param[in] window The window that received the event.

- *  @param[in] count The number of dropped files.

- *  @param[in] paths The UTF-8 encoded file and/or directory path names.

- *

- *  @sa @ref path_drop

- *  @sa @ref glfwSetDropCallback

- *

- *  @since Added in version 3.1.

- *

- *  @ingroup input

- */

-typedef void (* GLFWdropfun)(GLFWwindow*,int,const char**);

-

-/*! @brief The function signature for monitor configuration callbacks.

- *

- *  This is the function signature for monitor configuration callback functions.

- *

- *  @param[in] monitor The monitor that was connected or disconnected.

- *  @param[in] event One of `GLFW_CONNECTED` or `GLFW_DISCONNECTED`.  Remaining

- *  values reserved for future use.

- *

- *  @sa @ref monitor_event

- *  @sa @ref glfwSetMonitorCallback

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup monitor

- */

-typedef void (* GLFWmonitorfun)(GLFWmonitor*,int);

-

-/*! @brief The function signature for joystick configuration callbacks.

- *

- *  This is the function signature for joystick configuration callback

- *  functions.

- *

- *  @param[in] jid The joystick that was connected or disconnected.

- *  @param[in] event One of `GLFW_CONNECTED` or `GLFW_DISCONNECTED`.  Remaining

- *  values reserved for future use.

- *

- *  @sa @ref joystick_event

- *  @sa @ref glfwSetJoystickCallback

- *

- *  @since Added in version 3.2.

- *

- *  @ingroup input

- */

-typedef void (* GLFWjoystickfun)(int,int);

-

-/*! @brief Video mode type.

- *

- *  This describes a single video mode.

- *

- *  @sa @ref monitor_modes

- *  @sa @ref glfwGetVideoMode

- *  @sa @ref glfwGetVideoModes

- *

- *  @since Added in version 1.0.

- *  @glfw3 Added refresh rate member.

- *

- *  @ingroup monitor

- */

-typedef struct GLFWvidmode

-{

-    /*! The width, in screen coordinates, of the video mode.

-     */

-    int width;

-    /*! The height, in screen coordinates, of the video mode.

-     */

-    int height;

-    /*! The bit depth of the red channel of the video mode.

-     */

-    int redBits;

-    /*! The bit depth of the green channel of the video mode.

-     */

-    int greenBits;

-    /*! The bit depth of the blue channel of the video mode.

-     */

-    int blueBits;

-    /*! The refresh rate, in Hz, of the video mode.

-     */

-    int refreshRate;

-} GLFWvidmode;

-

-/*! @brief Gamma ramp.

- *

- *  This describes the gamma ramp for a monitor.

- *

- *  @sa @ref monitor_gamma

- *  @sa @ref glfwGetGammaRamp

- *  @sa @ref glfwSetGammaRamp

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup monitor

- */

-typedef struct GLFWgammaramp

-{

-    /*! An array of value describing the response of the red channel.

-     */

-    unsigned short* red;

-    /*! An array of value describing the response of the green channel.

-     */

-    unsigned short* green;

-    /*! An array of value describing the response of the blue channel.

-     */

-    unsigned short* blue;

-    /*! The number of elements in each array.

-     */

-    unsigned int size;

-} GLFWgammaramp;

-

-/*! @brief Image data.

- *

- *  This describes a single 2D image.  See the documentation for each related

- *  function what the expected pixel format is.

- *

- *  @sa @ref cursor_custom

- *  @sa @ref window_icon

- *

- *  @since Added in version 2.1.

- *  @glfw3 Removed format and bytes-per-pixel members.

- */

-typedef struct GLFWimage

-{

-    /*! The width, in pixels, of this image.

-     */

-    int width;

-    /*! The height, in pixels, of this image.

-     */

-    int height;

-    /*! The pixel data of this image, arranged left-to-right, top-to-bottom.

-     */

-    unsigned char* pixels;

-} GLFWimage;

-

-/*! @brief Gamepad input state

- *

- *  This describes the input state of a gamepad.

- *

- *  @sa @ref gamepad

- *  @sa @ref glfwGetGamepadState

- *

- *  @since Added in version 3.3.

- */

-typedef struct GLFWgamepadstate

-{

-    /*! The states of each [gamepad button](@ref gamepad_buttons), `GLFW_PRESS`

-     *  or `GLFW_RELEASE`.

-     */

-    unsigned char buttons[15];

-    /*! The states of each [gamepad axis](@ref gamepad_axes), in the range -1.0

-     *  to 1.0 inclusive.

-     */

-    float axes[6];

-} GLFWgamepadstate;

-

-

-/*************************************************************************

- * GLFW API functions

- *************************************************************************/

-

-/*! @brief Initializes the GLFW library.

- *

- *  This function initializes the GLFW library.  Before most GLFW functions can

- *  be used, GLFW must be initialized, and before an application terminates GLFW

- *  should be terminated in order to free any resources allocated during or

- *  after initialization.

- *

- *  If this function fails, it calls @ref glfwTerminate before returning.  If it

- *  succeeds, you should call @ref glfwTerminate before the application exits.

- *

- *  Additional calls to this function after successful initialization but before

- *  termination will return `GLFW_TRUE` immediately.

- *

- *  @return `GLFW_TRUE` if successful, or `GLFW_FALSE` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_PLATFORM_ERROR.

- *

- *  @remark @macos This function will change the current directory of the

- *  application to the `Contents/Resources` subdirectory of the application's

- *  bundle, if present.  This can be disabled with the @ref

- *  GLFW_COCOA_CHDIR_RESOURCES init hint.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref intro_init

- *  @sa @ref glfwTerminate

- *

- *  @since Added in version 1.0.

- *

- *  @ingroup init

- */

-GLFWAPI int glfwInit(void);

-

-/*! @brief Terminates the GLFW library.

- *

- *  This function destroys all remaining windows and cursors, restores any

- *  modified gamma ramps and frees any other allocated resources.  Once this

- *  function is called, you must again call @ref glfwInit successfully before

- *  you will be able to use most GLFW functions.

- *

- *  If GLFW has been successfully initialized, this function should be called

- *  before the application exits.  If initialization fails, there is no need to

- *  call this function, as it is called by @ref glfwInit before it returns

- *  failure.

- *

- *  @errors Possible errors include @ref GLFW_PLATFORM_ERROR.

- *

- *  @remark This function may be called before @ref glfwInit.

- *

- *  @warning The contexts of any remaining windows must not be current on any

- *  other thread when this function is called.

- *

- *  @reentrancy This function must not be called from a callback.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref intro_init

- *  @sa @ref glfwInit

- *

- *  @since Added in version 1.0.

- *

- *  @ingroup init

- */

-GLFWAPI void glfwTerminate(void);

-

-/*! @brief Sets the specified init hint to the desired value.

- *

- *  This function sets hints for the next initialization of GLFW.

- *

- *  The values you set hints to are never reset by GLFW, but they only take

- *  effect during initialization.  Once GLFW has been initialized, any values

- *  you set will be ignored until the library is terminated and initialized

- *  again.

- *

- *  Some hints are platform specific.  These may be set on any platform but they

- *  will only affect their specific platform.  Other platforms will ignore them.

- *  Setting these hints requires no platform specific headers or functions.

- *

- *  @param[in] hint The [init hint](@ref init_hints) to set.

- *  @param[in] value The new value of the init hint.

- *

- *  @errors Possible errors include @ref GLFW_INVALID_ENUM and @ref

- *  GLFW_INVALID_VALUE.

- *

- *  @remarks This function may be called before @ref glfwInit.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa init_hints

- *  @sa glfwInit

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup init

- */

-GLFWAPI void glfwInitHint(int hint, int value);

-

-/*! @brief Retrieves the version of the GLFW library.

- *

- *  This function retrieves the major, minor and revision numbers of the GLFW

- *  library.  It is intended for when you are using GLFW as a shared library and

- *  want to ensure that you are using the minimum required version.

- *

- *  Any or all of the version arguments may be `NULL`.

- *

- *  @param[out] major Where to store the major version number, or `NULL`.

- *  @param[out] minor Where to store the minor version number, or `NULL`.

- *  @param[out] rev Where to store the revision number, or `NULL`.

- *

- *  @errors None.

- *

- *  @remark This function may be called before @ref glfwInit.

- *

- *  @thread_safety This function may be called from any thread.

- *

- *  @sa @ref intro_version

- *  @sa @ref glfwGetVersionString

- *

- *  @since Added in version 1.0.

- *

- *  @ingroup init

- */

-GLFWAPI void glfwGetVersion(int* major, int* minor, int* rev);

-

-/*! @brief Returns a string describing the compile-time configuration.

- *

- *  This function returns the compile-time generated

- *  [version string](@ref intro_version_string) of the GLFW library binary.  It

- *  describes the version, platform, compiler and any platform-specific

- *  compile-time options.  It should not be confused with the OpenGL or OpenGL

- *  ES version string, queried with `glGetString`.

- *

- *  __Do not use the version string__ to parse the GLFW library version.  The

- *  @ref glfwGetVersion function provides the version of the running library

- *  binary in numerical format.

- *

- *  @return The ASCII encoded GLFW version string.

- *

- *  @errors None.

- *

- *  @remark This function may be called before @ref glfwInit.

- *

- *  @pointer_lifetime The returned string is static and compile-time generated.

- *

- *  @thread_safety This function may be called from any thread.

- *

- *  @sa @ref intro_version

- *  @sa @ref glfwGetVersion

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup init

- */

-GLFWAPI const char* glfwGetVersionString(void);

-

-/*! @brief Returns and clears the last error for the calling thread.

- *

- *  This function returns and clears the [error code](@ref errors) of the last

- *  error that occurred on the calling thread, and optionally a UTF-8 encoded

- *  human-readable description of it.  If no error has occurred since the last

- *  call, it returns @ref GLFW_NO_ERROR (zero) and the description pointer is

- *  set to `NULL`.

- *

- *  @param[in] description Where to store the error description pointer, or `NULL`.

- *  @return The last error code for the calling thread, or @ref GLFW_NO_ERROR

- *  (zero).

- *

- *  @errors None.

- *

- *  @pointer_lifetime The returned string is allocated and freed by GLFW.  You

- *  should not free it yourself.  It is guaranteed to be valid only until the

- *  next error occurs or the library is terminated.

- *

- *  @remark This function may be called before @ref glfwInit.

- *

- *  @thread_safety This function may be called from any thread.

- *

- *  @sa @ref error_handling

- *  @sa @ref glfwSetErrorCallback

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup init

- */

-GLFWAPI int glfwGetError(const char** description);

-

-/*! @brief Sets the error callback.

- *

- *  This function sets the error callback, which is called with an error code

- *  and a human-readable description each time a GLFW error occurs.

- *

- *  The error code is set before the callback is called.  Calling @ref

- *  glfwGetError from the error callback will return the same value as the error

- *  code argument.

- *

- *  The error callback is called on the thread where the error occurred.  If you

- *  are using GLFW from multiple threads, your error callback needs to be

- *  written accordingly.

- *

- *  Because the description string may have been generated specifically for that

- *  error, it is not guaranteed to be valid after the callback has returned.  If

- *  you wish to use it after the callback returns, you need to make a copy.

- *

- *  Once set, the error callback remains set even after the library has been

- *  terminated.

- *

- *  @param[in] cbfun The new callback, or `NULL` to remove the currently set

- *  callback.

- *  @return The previously set callback, or `NULL` if no callback was set.

- *

- *  @errors None.

- *

- *  @remark This function may be called before @ref glfwInit.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref error_handling

- *  @sa @ref glfwGetError

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup init

- */

-GLFWAPI GLFWerrorfun glfwSetErrorCallback(GLFWerrorfun cbfun);

-

-/*! @brief Returns the currently connected monitors.

- *

- *  This function returns an array of handles for all currently connected

- *  monitors.  The primary monitor is always first in the returned array.  If no

- *  monitors were found, this function returns `NULL`.

- *

- *  @param[out] count Where to store the number of monitors in the returned

- *  array.  This is set to zero if an error occurred.

- *  @return An array of monitor handles, or `NULL` if no monitors were found or

- *  if an [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @pointer_lifetime The returned array is allocated and freed by GLFW.  You

- *  should not free it yourself.  It is guaranteed to be valid only until the

- *  monitor configuration changes or the library is terminated.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref monitor_monitors

- *  @sa @ref monitor_event

- *  @sa @ref glfwGetPrimaryMonitor

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup monitor

- */

-GLFWAPI GLFWmonitor** glfwGetMonitors(int* count);

-

-/*! @brief Returns the primary monitor.

- *

- *  This function returns the primary monitor.  This is usually the monitor

- *  where elements like the task bar or global menu bar are located.

- *

- *  @return The primary monitor, or `NULL` if no monitors were found or if an

- *  [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @remark The primary monitor is always first in the array returned by @ref

- *  glfwGetMonitors.

- *

- *  @sa @ref monitor_monitors

- *  @sa @ref glfwGetMonitors

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup monitor

- */

-GLFWAPI GLFWmonitor* glfwGetPrimaryMonitor(void);

-

-/*! @brief Returns the position of the monitor's viewport on the virtual screen.

- *

- *  This function returns the position, in screen coordinates, of the upper-left

- *  corner of the specified monitor.

- *

- *  Any or all of the position arguments may be `NULL`.  If an error occurs, all

- *  non-`NULL` position arguments will be set to zero.

- *

- *  @param[in] monitor The monitor to query.

- *  @param[out] xpos Where to store the monitor x-coordinate, or `NULL`.

- *  @param[out] ypos Where to store the monitor y-coordinate, or `NULL`.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref monitor_properties

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup monitor

- */

-GLFWAPI void glfwGetMonitorPos(GLFWmonitor* monitor, int* xpos, int* ypos);

-

-/*! @brief Returns the physical size of the monitor.

- *

- *  This function returns the size, in millimetres, of the display area of the

- *  specified monitor.

- *

- *  Some systems do not provide accurate monitor size information, either

- *  because the monitor

- *  [EDID](https://en.wikipedia.org/wiki/Extended_display_identification_data)

- *  data is incorrect or because the driver does not report it accurately.

- *

- *  Any or all of the size arguments may be `NULL`.  If an error occurs, all

- *  non-`NULL` size arguments will be set to zero.

- *

- *  @param[in] monitor The monitor to query.

- *  @param[out] widthMM Where to store the width, in millimetres, of the

- *  monitor's display area, or `NULL`.

- *  @param[out] heightMM Where to store the height, in millimetres, of the

- *  monitor's display area, or `NULL`.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @remark @win32 calculates the returned physical size from the

- *  current resolution and system DPI instead of querying the monitor EDID data.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref monitor_properties

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup monitor

- */

-GLFWAPI void glfwGetMonitorPhysicalSize(GLFWmonitor* monitor, int* widthMM, int* heightMM);

-

-/*! @brief Retrieves the content scale for the specified monitor.

- *

- *  This function retrieves the content scale for the specified monitor.  The

- *  content scale is the ratio between the current DPI and the platform's

- *  default DPI.  If you scale all pixel dimensions by this scale then your

- *  content should appear at an appropriate size.  This is especially important

- *  for text and any UI elements.

- *

- *  The content scale may depend on both the monitor resolution and pixel

- *  density and on user settings.  It may be very different from the raw DPI

- *  calculated from the physical size and current resolution.

- *

- *  @param[in] monitor The monitor to query.

- *  @param[out] xscale Where to store the x-axis content scale, or `NULL`.

- *  @param[out] yscale Where to store the y-axis content scale, or `NULL`.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref monitor_scale

- *  @sa @ref glfwGetWindowContentScale

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup monitor

- */

-GLFWAPI void glfwGetMonitorContentScale(GLFWmonitor* monitor, float* xscale, float* yscale);

-

-/*! @brief Returns the name of the specified monitor.

- *

- *  This function returns a human-readable name, encoded as UTF-8, of the

- *  specified monitor.  The name typically reflects the make and model of the

- *  monitor and is not guaranteed to be unique among the connected monitors.

- *

- *  @param[in] monitor The monitor to query.

- *  @return The UTF-8 encoded name of the monitor, or `NULL` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @pointer_lifetime The returned string is allocated and freed by GLFW.  You

- *  should not free it yourself.  It is valid until the specified monitor is

- *  disconnected or the library is terminated.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref monitor_properties

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup monitor

- */

-GLFWAPI const char* glfwGetMonitorName(GLFWmonitor* monitor);

-

-/*! @brief Sets the user pointer of the specified monitor.

- *

- *  This function sets the user-defined pointer of the specified monitor.  The

- *  current value is retained until the monitor is disconnected.  The initial

- *  value is `NULL`.

- *

- *  This function may be called from the monitor callback, even for a monitor

- *  that is being disconnected.

- *

- *  @param[in] monitor The monitor whose pointer to set.

- *  @param[in] pointer The new value.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @sa @ref monitor_userptr

- *  @sa @ref glfwGetMonitorUserPointer

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup monitor

- */

-GLFWAPI void glfwSetMonitorUserPointer(GLFWmonitor* monitor, void* pointer);

-

-/*! @brief Returns the user pointer of the specified monitor.

- *

- *  This function returns the current value of the user-defined pointer of the

- *  specified monitor.  The initial value is `NULL`.

- *

- *  This function may be called from the monitor callback, even for a monitor

- *  that is being disconnected.

- *

- *  @param[in] monitor The monitor whose pointer to return.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @sa @ref monitor_userptr

- *  @sa @ref glfwSetMonitorUserPointer

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup monitor

- */

-GLFWAPI void* glfwGetMonitorUserPointer(GLFWmonitor* monitor);

-

-/*! @brief Sets the monitor configuration callback.

- *

- *  This function sets the monitor configuration callback, or removes the

- *  currently set callback.  This is called when a monitor is connected to or

- *  disconnected from the system.

- *

- *  @param[in] cbfun The new callback, or `NULL` to remove the currently set

- *  callback.

- *  @return The previously set callback, or `NULL` if no callback was set or the

- *  library had not been [initialized](@ref intro_init).

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref monitor_event

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup monitor

- */

-GLFWAPI GLFWmonitorfun glfwSetMonitorCallback(GLFWmonitorfun cbfun);

-

-/*! @brief Returns the available video modes for the specified monitor.

- *

- *  This function returns an array of all video modes supported by the specified

- *  monitor.  The returned array is sorted in ascending order, first by color

- *  bit depth (the sum of all channel depths) and then by resolution area (the

- *  product of width and height).

- *

- *  @param[in] monitor The monitor to query.

- *  @param[out] count Where to store the number of video modes in the returned

- *  array.  This is set to zero if an error occurred.

- *  @return An array of video modes, or `NULL` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @pointer_lifetime The returned array is allocated and freed by GLFW.  You

- *  should not free it yourself.  It is valid until the specified monitor is

- *  disconnected, this function is called again for that monitor or the library

- *  is terminated.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref monitor_modes

- *  @sa @ref glfwGetVideoMode

- *

- *  @since Added in version 1.0.

- *  @glfw3 Changed to return an array of modes for a specific monitor.

- *

- *  @ingroup monitor

- */

-GLFWAPI const GLFWvidmode* glfwGetVideoModes(GLFWmonitor* monitor, int* count);

-

-/*! @brief Returns the current mode of the specified monitor.

- *

- *  This function returns the current video mode of the specified monitor.  If

- *  you have created a full screen window for that monitor, the return value

- *  will depend on whether that window is iconified.

- *

- *  @param[in] monitor The monitor to query.

- *  @return The current mode of the monitor, or `NULL` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @pointer_lifetime The returned array is allocated and freed by GLFW.  You

- *  should not free it yourself.  It is valid until the specified monitor is

- *  disconnected or the library is terminated.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref monitor_modes

- *  @sa @ref glfwGetVideoModes

- *

- *  @since Added in version 3.0.  Replaces `glfwGetDesktopMode`.

- *

- *  @ingroup monitor

- */

-GLFWAPI const GLFWvidmode* glfwGetVideoMode(GLFWmonitor* monitor);

-

-/*! @brief Generates a gamma ramp and sets it for the specified monitor.

- *

- *  This function generates a 256-element gamma ramp from the specified exponent

- *  and then calls @ref glfwSetGammaRamp with it.  The value must be a finite

- *  number greater than zero.

- *

- *  The software controlled gamma ramp is applied _in addition_ to the hardware

- *  gamma correction, which today is usually an approximation of sRGB gamma.

- *  This means that setting a perfectly linear ramp, or gamma 1.0, will produce

- *  the default (usually sRGB-like) behavior.

- *

- *  For gamma correct rendering with OpenGL or OpenGL ES, see the @ref

- *  GLFW_SRGB_CAPABLE hint.

- *

- *  @param[in] monitor The monitor whose gamma ramp to set.

- *  @param[in] gamma The desired exponent.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_INVALID_VALUE and @ref GLFW_PLATFORM_ERROR.

- *

- *  @remark @wayland Gamma handling is a priviledged protocol, this function

- *  will thus never be implemented and emits @ref GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref monitor_gamma

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup monitor

- */

-GLFWAPI void glfwSetGamma(GLFWmonitor* monitor, float gamma);

-

-/*! @brief Returns the current gamma ramp for the specified monitor.

- *

- *  This function returns the current gamma ramp of the specified monitor.

- *

- *  @param[in] monitor The monitor to query.

- *  @return The current gamma ramp, or `NULL` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @remark @wayland Gamma handling is a priviledged protocol, this function

- *  will thus never be implemented and emits @ref GLFW_PLATFORM_ERROR while

- *  returning `NULL`.

- *

- *  @pointer_lifetime The returned structure and its arrays are allocated and

- *  freed by GLFW.  You should not free them yourself.  They are valid until the

- *  specified monitor is disconnected, this function is called again for that

- *  monitor or the library is terminated.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref monitor_gamma

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup monitor

- */

-GLFWAPI const GLFWgammaramp* glfwGetGammaRamp(GLFWmonitor* monitor);

-

-/*! @brief Sets the current gamma ramp for the specified monitor.

- *

- *  This function sets the current gamma ramp for the specified monitor.  The

- *  original gamma ramp for that monitor is saved by GLFW the first time this

- *  function is called and is restored by @ref glfwTerminate.

- *

- *  The software controlled gamma ramp is applied _in addition_ to the hardware

- *  gamma correction, which today is usually an approximation of sRGB gamma.

- *  This means that setting a perfectly linear ramp, or gamma 1.0, will produce

- *  the default (usually sRGB-like) behavior.

- *

- *  For gamma correct rendering with OpenGL or OpenGL ES, see the @ref

- *  GLFW_SRGB_CAPABLE hint.

- *

- *  @param[in] monitor The monitor whose gamma ramp to set.

- *  @param[in] ramp The gamma ramp to use.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @remark Gamma ramp sizes other than 256 are not supported by all platforms

- *  or graphics hardware.

- *

- *  @remark @win32 The gamma ramp size must be 256.

- *

- *  @remark @wayland Gamma handling is a priviledged protocol, this function

- *  will thus never be implemented and emits @ref GLFW_PLATFORM_ERROR.

- *

- *  @pointer_lifetime The specified gamma ramp is copied before this function

- *  returns.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref monitor_gamma

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup monitor

- */

-GLFWAPI void glfwSetGammaRamp(GLFWmonitor* monitor, const GLFWgammaramp* ramp);

-

-/*! @brief Resets all window hints to their default values.

- *

- *  This function resets all window hints to their

- *  [default values](@ref window_hints_values).

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_hints

- *  @sa @ref glfwWindowHint

- *  @sa @ref glfwWindowHintString

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwDefaultWindowHints(void);

-

-/*! @brief Sets the specified window hint to the desired value.

- *

- *  This function sets hints for the next call to @ref glfwCreateWindow.  The

- *  hints, once set, retain their values until changed by a call to this

- *  function or @ref glfwDefaultWindowHints, or until the library is terminated.

- *

- *  Only integer value hints can be set with this function.  String value hints

- *  are set with @ref glfwWindowHintString.

- *

- *  This function does not check whether the specified hint values are valid.

- *  If you set hints to invalid values this will instead be reported by the next

- *  call to @ref glfwCreateWindow.

- *

- *  Some hints are platform specific.  These may be set on any platform but they

- *  will only affect their specific platform.  Other platforms will ignore them.

- *  Setting these hints requires no platform specific headers or functions.

- *

- *  @param[in] hint The [window hint](@ref window_hints) to set.

- *  @param[in] value The new value of the window hint.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_INVALID_ENUM.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_hints

- *  @sa @ref glfwWindowHintString

- *  @sa @ref glfwDefaultWindowHints

- *

- *  @since Added in version 3.0.  Replaces `glfwOpenWindowHint`.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwWindowHint(int hint, int value);

-

-/*! @brief Sets the specified window hint to the desired value.

- *

- *  This function sets hints for the next call to @ref glfwCreateWindow.  The

- *  hints, once set, retain their values until changed by a call to this

- *  function or @ref glfwDefaultWindowHints, or until the library is terminated.

- *

- *  Only string type hints can be set with this function.  Integer value hints

- *  are set with @ref glfwWindowHint.

- *

- *  This function does not check whether the specified hint values are valid.

- *  If you set hints to invalid values this will instead be reported by the next

- *  call to @ref glfwCreateWindow.

- *

- *  Some hints are platform specific.  These may be set on any platform but they

- *  will only affect their specific platform.  Other platforms will ignore them.

- *  Setting these hints requires no platform specific headers or functions.

- *

- *  @param[in] hint The [window hint](@ref window_hints) to set.

- *  @param[in] value The new value of the window hint.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_INVALID_ENUM.

- *

- *  @pointer_lifetime The specified string is copied before this function

- *  returns.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_hints

- *  @sa @ref glfwWindowHint

- *  @sa @ref glfwDefaultWindowHints

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwWindowHintString(int hint, const char* value);

-

-/*! @brief Creates a window and its associated context.

- *

- *  This function creates a window and its associated OpenGL or OpenGL ES

- *  context.  Most of the options controlling how the window and its context

- *  should be created are specified with [window hints](@ref window_hints).

- *

- *  Successful creation does not change which context is current.  Before you

- *  can use the newly created context, you need to

- *  [make it current](@ref context_current).  For information about the `share`

- *  parameter, see @ref context_sharing.

- *

- *  The created window, framebuffer and context may differ from what you

- *  requested, as not all parameters and hints are

- *  [hard constraints](@ref window_hints_hard).  This includes the size of the

- *  window, especially for full screen windows.  To query the actual attributes

- *  of the created window, framebuffer and context, see @ref

- *  glfwGetWindowAttrib, @ref glfwGetWindowSize and @ref glfwGetFramebufferSize.

- *

- *  To create a full screen window, you need to specify the monitor the window

- *  will cover.  If no monitor is specified, the window will be windowed mode.

- *  Unless you have a way for the user to choose a specific monitor, it is

- *  recommended that you pick the primary monitor.  For more information on how

- *  to query connected monitors, see @ref monitor_monitors.

- *

- *  For full screen windows, the specified size becomes the resolution of the

- *  window's _desired video mode_.  As long as a full screen window is not

- *  iconified, the supported video mode most closely matching the desired video

- *  mode is set for the specified monitor.  For more information about full

- *  screen windows, including the creation of so called _windowed full screen_

- *  or _borderless full screen_ windows, see @ref window_windowed_full_screen.

- *

- *  Once you have created the window, you can switch it between windowed and

- *  full screen mode with @ref glfwSetWindowMonitor.  This will not affect its

- *  OpenGL or OpenGL ES context.

- *

- *  By default, newly created windows use the placement recommended by the

- *  window system.  To create the window at a specific position, make it

- *  initially invisible using the [GLFW_VISIBLE](@ref GLFW_VISIBLE_hint) window

- *  hint, set its [position](@ref window_pos) and then [show](@ref window_hide)

- *  it.

- *

- *  As long as at least one full screen window is not iconified, the screensaver

- *  is prohibited from starting.

- *

- *  Window systems put limits on window sizes.  Very large or very small window

- *  dimensions may be overridden by the window system on creation.  Check the

- *  actual [size](@ref window_size) after creation.

- *

- *  The [swap interval](@ref buffer_swap) is not set during window creation and

- *  the initial value may vary depending on driver settings and defaults.

- *

- *  @param[in] width The desired width, in screen coordinates, of the window.

- *  This must be greater than zero.

- *  @param[in] height The desired height, in screen coordinates, of the window.

- *  This must be greater than zero.

- *  @param[in] title The initial, UTF-8 encoded window title.

- *  @param[in] monitor The monitor to use for full screen mode, or `NULL` for

- *  windowed mode.

- *  @param[in] share The window whose context to share resources with, or `NULL`

- *  to not share resources.

- *  @return The handle of the created window, or `NULL` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_INVALID_ENUM, @ref GLFW_INVALID_VALUE, @ref GLFW_API_UNAVAILABLE, @ref

- *  GLFW_VERSION_UNAVAILABLE, @ref GLFW_FORMAT_UNAVAILABLE and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @remark @win32 Window creation will fail if the Microsoft GDI software

- *  OpenGL implementation is the only one available.

- *

- *  @remark @win32 If the executable has an icon resource named `GLFW_ICON,` it

- *  will be set as the initial icon for the window.  If no such icon is present,

- *  the `IDI_APPLICATION` icon will be used instead.  To set a different icon,

- *  see @ref glfwSetWindowIcon.

- *

- *  @remark @win32 The context to share resources with must not be current on

- *  any other thread.

- *

- *  @remark @macos The OS only supports forward-compatible core profile contexts

- *  for OpenGL versions 3.2 and later.  Before creating an OpenGL context of

- *  version 3.2 or later you must set the

- *  [GLFW_OPENGL_FORWARD_COMPAT](@ref GLFW_OPENGL_FORWARD_COMPAT_hint) and

- *  [GLFW_OPENGL_PROFILE](@ref GLFW_OPENGL_PROFILE_hint) hints accordingly.

- *  OpenGL 3.0 and 3.1 contexts are not supported at all on macOS.

- *

- *  @remark @macos The GLFW window has no icon, as it is not a document

- *  window, but the dock icon will be the same as the application bundle's icon.

- *  For more information on bundles, see the

- *  [Bundle Programming Guide](https://developer.apple.com/library/mac/documentation/CoreFoundation/Conceptual/CFBundles/)

- *  in the Mac Developer Library.

- *

- *  @remark @macos The first time a window is created the menu bar is created.

- *  If GLFW finds a `MainMenu.nib` it is loaded and assumed to contain a menu

- *  bar.  Otherwise a minimal menu bar is created manually with common commands

- *  like Hide, Quit and About.  The About entry opens a minimal about dialog

- *  with information from the application's bundle.  Menu bar creation can be

- *  disabled entirely with the @ref GLFW_COCOA_MENUBAR init hint.

- *

- *  @remark @macos On OS X 10.10 and later the window frame will not be rendered

- *  at full resolution on Retina displays unless the

- *  [GLFW_COCOA_RETINA_FRAMEBUFFER](@ref GLFW_COCOA_RETINA_FRAMEBUFFER_hint)

- *  hint is `GLFW_TRUE` and the `NSHighResolutionCapable` key is enabled in the

- *  application bundle's `Info.plist`.  For more information, see

- *  [High Resolution Guidelines for OS X](https://developer.apple.com/library/mac/documentation/GraphicsAnimation/Conceptual/HighResolutionOSX/Explained/Explained.html)

- *  in the Mac Developer Library.  The GLFW test and example programs use

- *  a custom `Info.plist` template for this, which can be found as

- *  `CMake/MacOSXBundleInfo.plist.in` in the source tree.

- *

- *  @remark @macos When activating frame autosaving with

- *  [GLFW_COCOA_FRAME_NAME](@ref GLFW_COCOA_FRAME_NAME_hint), the specified

- *  window size and position may be overriden by previously saved values.

- *

- *  @remark @x11 Some window managers will not respect the placement of

- *  initially hidden windows.

- *

- *  @remark @x11 Due to the asynchronous nature of X11, it may take a moment for

- *  a window to reach its requested state.  This means you may not be able to

- *  query the final size, position or other attributes directly after window

- *  creation.

- *

- *  @remark @x11 The class part of the `WM_CLASS` window property will by

- *  default be set to the window title passed to this function.  The instance

- *  part will use the contents of the `RESOURCE_NAME` environment variable, if

- *  present and not empty, or fall back to the window title.  Set the @ref

- *  GLFW_X11_CLASS_NAME and @ref GLFW_X11_INSTANCE_NAME window hints to override

- *  this.

- *

- *  @remark @wayland The window frame is currently very simple, only allowing

- *  window resize or move.  A compositor can still emit close, maximize or

- *  fullscreen events, using for example a keybind mechanism.  Additionally,

- *  the wp_viewporter protocol is required for this feature, otherwise the

- *  window will not be decorated.

- *

- *  @remark @wayland A full screen window will not attempt to change the mode,

- *  no matter what the requested size or refresh rate.

- *

- *  @remark @wayland Screensaver inhibition requires the idle-inhibit protocol

- *  to be implemented in the user's compositor.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_creation

- *  @sa @ref glfwDestroyWindow

- *

- *  @since Added in version 3.0.  Replaces `glfwOpenWindow`.

- *

- *  @ingroup window

- */

-GLFWAPI GLFWwindow* glfwCreateWindow(int width, int height, const char* title, GLFWmonitor* monitor, GLFWwindow* share);

-

-/*! @brief Destroys the specified window and its context.

- *

- *  This function destroys the specified window and its context.  On calling

- *  this function, no further callbacks will be called for that window.

- *

- *  If the context of the specified window is current on the main thread, it is

- *  detached before being destroyed.

- *

- *  @param[in] window The window to destroy.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @note The context of the specified window must not be current on any other

- *  thread when this function is called.

- *

- *  @reentrancy This function must not be called from a callback.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_creation

- *  @sa @ref glfwCreateWindow

- *

- *  @since Added in version 3.0.  Replaces `glfwCloseWindow`.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwDestroyWindow(GLFWwindow* window);

-

-/*! @brief Checks the close flag of the specified window.

- *

- *  This function returns the value of the close flag of the specified window.

- *

- *  @param[in] window The window to query.

- *  @return The value of the close flag.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @sa @ref window_close

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup window

- */

-GLFWAPI int glfwWindowShouldClose(GLFWwindow* window);

-

-/*! @brief Sets the close flag of the specified window.

- *

- *  This function sets the value of the close flag of the specified window.

- *  This can be used to override the user's attempt to close the window, or

- *  to signal that it should be closed.

- *

- *  @param[in] window The window whose flag to change.

- *  @param[in] value The new value.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @sa @ref window_close

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwSetWindowShouldClose(GLFWwindow* window, int value);

-

-/*! @brief Sets the title of the specified window.

- *

- *  This function sets the window title, encoded as UTF-8, of the specified

- *  window.

- *

- *  @param[in] window The window whose title to change.

- *  @param[in] title The UTF-8 encoded window title.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @remark @macos The window title will not be updated until the next time you

- *  process events.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_title

- *

- *  @since Added in version 1.0.

- *  @glfw3 Added window handle parameter.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwSetWindowTitle(GLFWwindow* window, const char* title);

-

-/*! @brief Sets the icon for the specified window.

- *

- *  This function sets the icon of the specified window.  If passed an array of

- *  candidate images, those of or closest to the sizes desired by the system are

- *  selected.  If no images are specified, the window reverts to its default

- *  icon.

- *

- *  The pixels are 32-bit, little-endian, non-premultiplied RGBA, i.e. eight

- *  bits per channel with the red channel first.  They are arranged canonically

- *  as packed sequential rows, starting from the top-left corner.

- *

- *  The desired image sizes varies depending on platform and system settings.

- *  The selected images will be rescaled as needed.  Good sizes include 16x16,

- *  32x32 and 48x48.

- *

- *  @param[in] window The window whose icon to set.

- *  @param[in] count The number of images in the specified array, or zero to

- *  revert to the default window icon.

- *  @param[in] images The images to create the icon from.  This is ignored if

- *  count is zero.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @pointer_lifetime The specified image data is copied before this function

- *  returns.

- *

- *  @remark @macos The GLFW window has no icon, as it is not a document

- *  window, so this function does nothing.  The dock icon will be the same as

- *  the application bundle's icon.  For more information on bundles, see the

- *  [Bundle Programming Guide](https://developer.apple.com/library/mac/documentation/CoreFoundation/Conceptual/CFBundles/)

- *  in the Mac Developer Library.

- *

- *  @remark @wayland There is no existing protocol to change an icon, the

- *  window will thus inherit the one defined in the application's desktop file.

- *  This function always emits @ref GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_icon

- *

- *  @since Added in version 3.2.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwSetWindowIcon(GLFWwindow* window, int count, const GLFWimage* images);

-

-/*! @brief Retrieves the position of the client area of the specified window.

- *

- *  This function retrieves the position, in screen coordinates, of the

- *  upper-left corner of the client area of the specified window.

- *

- *  Any or all of the position arguments may be `NULL`.  If an error occurs, all

- *  non-`NULL` position arguments will be set to zero.

- *

- *  @param[in] window The window to query.

- *  @param[out] xpos Where to store the x-coordinate of the upper-left corner of

- *  the client area, or `NULL`.

- *  @param[out] ypos Where to store the y-coordinate of the upper-left corner of

- *  the client area, or `NULL`.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @remark @wayland There is no way for an application to retrieve the global

- *  position of its windows, this function will always emit @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_pos

- *  @sa @ref glfwSetWindowPos

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwGetWindowPos(GLFWwindow* window, int* xpos, int* ypos);

-

-/*! @brief Sets the position of the client area of the specified window.

- *

- *  This function sets the position, in screen coordinates, of the upper-left

- *  corner of the client area of the specified windowed mode window.  If the

- *  window is a full screen window, this function does nothing.

- *

- *  __Do not use this function__ to move an already visible window unless you

- *  have very good reasons for doing so, as it will confuse and annoy the user.

- *

- *  The window manager may put limits on what positions are allowed.  GLFW

- *  cannot and should not override these limits.

- *

- *  @param[in] window The window to query.

- *  @param[in] xpos The x-coordinate of the upper-left corner of the client area.

- *  @param[in] ypos The y-coordinate of the upper-left corner of the client area.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @remark @wayland There is no way for an application to set the global

- *  position of its windows, this function will always emit @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_pos

- *  @sa @ref glfwGetWindowPos

- *

- *  @since Added in version 1.0.

- *  @glfw3 Added window handle parameter.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwSetWindowPos(GLFWwindow* window, int xpos, int ypos);

-

-/*! @brief Retrieves the size of the client area of the specified window.

- *

- *  This function retrieves the size, in screen coordinates, of the client area

- *  of the specified window.  If you wish to retrieve the size of the

- *  framebuffer of the window in pixels, see @ref glfwGetFramebufferSize.

- *

- *  Any or all of the size arguments may be `NULL`.  If an error occurs, all

- *  non-`NULL` size arguments will be set to zero.

- *

- *  @param[in] window The window whose size to retrieve.

- *  @param[out] width Where to store the width, in screen coordinates, of the

- *  client area, or `NULL`.

- *  @param[out] height Where to store the height, in screen coordinates, of the

- *  client area, or `NULL`.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_size

- *  @sa @ref glfwSetWindowSize

- *

- *  @since Added in version 1.0.

- *  @glfw3 Added window handle parameter.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwGetWindowSize(GLFWwindow* window, int* width, int* height);

-

-/*! @brief Sets the size limits of the specified window.

- *

- *  This function sets the size limits of the client area of the specified

- *  window.  If the window is full screen, the size limits only take effect

- *  once it is made windowed.  If the window is not resizable, this function

- *  does nothing.

- *

- *  The size limits are applied immediately to a windowed mode window and may

- *  cause it to be resized.

- *

- *  The maximum dimensions must be greater than or equal to the minimum

- *  dimensions and all must be greater than or equal to zero.

- *

- *  @param[in] window The window to set limits for.

- *  @param[in] minwidth The minimum width, in screen coordinates, of the client

- *  area, or `GLFW_DONT_CARE`.

- *  @param[in] minheight The minimum height, in screen coordinates, of the

- *  client area, or `GLFW_DONT_CARE`.

- *  @param[in] maxwidth The maximum width, in screen coordinates, of the client

- *  area, or `GLFW_DONT_CARE`.

- *  @param[in] maxheight The maximum height, in screen coordinates, of the

- *  client area, or `GLFW_DONT_CARE`.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_INVALID_VALUE and @ref GLFW_PLATFORM_ERROR.

- *

- *  @remark If you set size limits and an aspect ratio that conflict, the

- *  results are undefined.

- *

- *  @remark @wayland The size limits will not be applied until the window is

- *  actually resized, either by the user or by the compositor.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_sizelimits

- *  @sa @ref glfwSetWindowAspectRatio

- *

- *  @since Added in version 3.2.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwSetWindowSizeLimits(GLFWwindow* window, int minwidth, int minheight, int maxwidth, int maxheight);

-

-/*! @brief Sets the aspect ratio of the specified window.

- *

- *  This function sets the required aspect ratio of the client area of the

- *  specified window.  If the window is full screen, the aspect ratio only takes

- *  effect once it is made windowed.  If the window is not resizable, this

- *  function does nothing.

- *

- *  The aspect ratio is specified as a numerator and a denominator and both

- *  values must be greater than zero.  For example, the common 16:9 aspect ratio

- *  is specified as 16 and 9, respectively.

- *

- *  If the numerator and denominator is set to `GLFW_DONT_CARE` then the aspect

- *  ratio limit is disabled.

- *

- *  The aspect ratio is applied immediately to a windowed mode window and may

- *  cause it to be resized.

- *

- *  @param[in] window The window to set limits for.

- *  @param[in] numer The numerator of the desired aspect ratio, or

- *  `GLFW_DONT_CARE`.

- *  @param[in] denom The denominator of the desired aspect ratio, or

- *  `GLFW_DONT_CARE`.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_INVALID_VALUE and @ref GLFW_PLATFORM_ERROR.

- *

- *  @remark If you set size limits and an aspect ratio that conflict, the

- *  results are undefined.

- *

- *  @remark @wayland The aspect ratio will not be applied until the window is

- *  actually resized, either by the user or by the compositor.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_sizelimits

- *  @sa @ref glfwSetWindowSizeLimits

- *

- *  @since Added in version 3.2.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwSetWindowAspectRatio(GLFWwindow* window, int numer, int denom);

-

-/*! @brief Sets the size of the client area of the specified window.

- *

- *  This function sets the size, in screen coordinates, of the client area of

- *  the specified window.

- *

- *  For full screen windows, this function updates the resolution of its desired

- *  video mode and switches to the video mode closest to it, without affecting

- *  the window's context.  As the context is unaffected, the bit depths of the

- *  framebuffer remain unchanged.

- *

- *  If you wish to update the refresh rate of the desired video mode in addition

- *  to its resolution, see @ref glfwSetWindowMonitor.

- *

- *  The window manager may put limits on what sizes are allowed.  GLFW cannot

- *  and should not override these limits.

- *

- *  @param[in] window The window to resize.

- *  @param[in] width The desired width, in screen coordinates, of the window

- *  client area.

- *  @param[in] height The desired height, in screen coordinates, of the window

- *  client area.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @remark @wayland A full screen window will not attempt to change the mode,

- *  no matter what the requested size.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_size

- *  @sa @ref glfwGetWindowSize

- *  @sa @ref glfwSetWindowMonitor

- *

- *  @since Added in version 1.0.

- *  @glfw3 Added window handle parameter.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwSetWindowSize(GLFWwindow* window, int width, int height);

-

-/*! @brief Retrieves the size of the framebuffer of the specified window.

- *

- *  This function retrieves the size, in pixels, of the framebuffer of the

- *  specified window.  If you wish to retrieve the size of the window in screen

- *  coordinates, see @ref glfwGetWindowSize.

- *

- *  Any or all of the size arguments may be `NULL`.  If an error occurs, all

- *  non-`NULL` size arguments will be set to zero.

- *

- *  @param[in] window The window whose framebuffer to query.

- *  @param[out] width Where to store the width, in pixels, of the framebuffer,

- *  or `NULL`.

- *  @param[out] height Where to store the height, in pixels, of the framebuffer,

- *  or `NULL`.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_fbsize

- *  @sa @ref glfwSetFramebufferSizeCallback

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwGetFramebufferSize(GLFWwindow* window, int* width, int* height);

-

-/*! @brief Retrieves the size of the frame of the window.

- *

- *  This function retrieves the size, in screen coordinates, of each edge of the

- *  frame of the specified window.  This size includes the title bar, if the

- *  window has one.  The size of the frame may vary depending on the

- *  [window-related hints](@ref window_hints_wnd) used to create it.

- *

- *  Because this function retrieves the size of each window frame edge and not

- *  the offset along a particular coordinate axis, the retrieved values will

- *  always be zero or positive.

- *

- *  Any or all of the size arguments may be `NULL`.  If an error occurs, all

- *  non-`NULL` size arguments will be set to zero.

- *

- *  @param[in] window The window whose frame size to query.

- *  @param[out] left Where to store the size, in screen coordinates, of the left

- *  edge of the window frame, or `NULL`.

- *  @param[out] top Where to store the size, in screen coordinates, of the top

- *  edge of the window frame, or `NULL`.

- *  @param[out] right Where to store the size, in screen coordinates, of the

- *  right edge of the window frame, or `NULL`.

- *  @param[out] bottom Where to store the size, in screen coordinates, of the

- *  bottom edge of the window frame, or `NULL`.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_size

- *

- *  @since Added in version 3.1.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwGetWindowFrameSize(GLFWwindow* window, int* left, int* top, int* right, int* bottom);

-

-/*! @brief Retrieves the content scale for the specified window.

- *

- *  This function retrieves the content scale for the specified window.  The

- *  content scale is the ratio between the current DPI and the platform's

- *  default DPI.  If you scale all pixel dimensions by this scale then your

- *  content should appear at an appropriate size.  This is especially important

- *  for text and any UI elements.

- *

- *  On systems where each monitors can have its own content scale, the window

- *  content scale will depend on which monitor the system considers the window

- *  to be on.

- *

- *  @param[in] window The window to query.

- *  @param[out] xscale Where to store the x-axis content scale, or `NULL`.

- *  @param[out] yscale Where to store the y-axis content scale, or `NULL`.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_scale

- *  @sa @ref glfwSetWindowContentScaleCallback

- *  @sa @ref glfwGetMonitorContentScale

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwGetWindowContentScale(GLFWwindow* window, float* xscale, float* yscale);

-

-/*! @brief Returns the opacity of the whole window.

- *

- *  This function returns the opacity of the window, including any decorations.

- *

- *  The opacity (or alpha) value is a positive finite number between zero and

- *  one, where zero is fully transparent and one is fully opaque.  If the system

- *  does not support whole window transparency, this function always returns one.

- *

- *  The initial opacity value for newly created windows is one.

- *

- *  @param[in] window The window to query.

- *  @return The opacity value of the specified window.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_transparency

- *  @sa @ref glfwSetWindowOpacity

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup window

- */

-GLFWAPI float glfwGetWindowOpacity(GLFWwindow* window);

-

-/*! @brief Sets the opacity of the whole window.

- *

- *  This function sets the opacity of the window, including any decorations.

- *

- *  The opacity (or alpha) value is a positive finite number between zero and

- *  one, where zero is fully transparent and one is fully opaque.

- *

- *  The initial opacity value for newly created windows is one.

- *

- *  A window created with framebuffer transparency may not use whole window

- *  transparency.  The results of doing this are undefined.

- *

- *  @param[in] window The window to set the opacity for.

- *  @param[in] opacity The desired opacity of the specified window.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_transparency

- *  @sa @ref glfwGetWindowOpacity

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwSetWindowOpacity(GLFWwindow* window, float opacity);

-

-/*! @brief Iconifies the specified window.

- *

- *  This function iconifies (minimizes) the specified window if it was

- *  previously restored.  If the window is already iconified, this function does

- *  nothing.

- *

- *  If the specified window is a full screen window, the original monitor

- *  resolution is restored until the window is restored.

- *

- *  @param[in] window The window to iconify.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @remark @wayland There is no concept of iconification in wl_shell, this

- *  function will emit @ref GLFW_PLATFORM_ERROR when using this deprecated

- *  protocol.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_iconify

- *  @sa @ref glfwRestoreWindow

- *  @sa @ref glfwMaximizeWindow

- *

- *  @since Added in version 2.1.

- *  @glfw3 Added window handle parameter.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwIconifyWindow(GLFWwindow* window);

-

-/*! @brief Restores the specified window.

- *

- *  This function restores the specified window if it was previously iconified

- *  (minimized) or maximized.  If the window is already restored, this function

- *  does nothing.

- *

- *  If the specified window is a full screen window, the resolution chosen for

- *  the window is restored on the selected monitor.

- *

- *  @param[in] window The window to restore.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_iconify

- *  @sa @ref glfwIconifyWindow

- *  @sa @ref glfwMaximizeWindow

- *

- *  @since Added in version 2.1.

- *  @glfw3 Added window handle parameter.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwRestoreWindow(GLFWwindow* window);

-

-/*! @brief Maximizes the specified window.

- *

- *  This function maximizes the specified window if it was previously not

- *  maximized.  If the window is already maximized, this function does nothing.

- *

- *  If the specified window is a full screen window, this function does nothing.

- *

- *  @param[in] window The window to maximize.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @par Thread Safety

- *  This function may only be called from the main thread.

- *

- *  @sa @ref window_iconify

- *  @sa @ref glfwIconifyWindow

- *  @sa @ref glfwRestoreWindow

- *

- *  @since Added in GLFW 3.2.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwMaximizeWindow(GLFWwindow* window);

-

-/*! @brief Makes the specified window visible.

- *

- *  This function makes the specified window visible if it was previously

- *  hidden.  If the window is already visible or is in full screen mode, this

- *  function does nothing.

- *

- *  By default, windowed mode windows are focused when shown

- *  Set the [GLFW_FOCUS_ON_SHOW](@ref GLFW_FOCUS_ON_SHOW_hint) window hint

- *  to change this behavior for all newly created windows, or change the

- *  behavior for an existing window with @ref glfwSetWindowAttrib.

- *

- *  @param[in] window The window to make visible.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_hide

- *  @sa @ref glfwHideWindow

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwShowWindow(GLFWwindow* window);

-

-/*! @brief Hides the specified window.

- *

- *  This function hides the specified window if it was previously visible.  If

- *  the window is already hidden or is in full screen mode, this function does

- *  nothing.

- *

- *  @param[in] window The window to hide.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_hide

- *  @sa @ref glfwShowWindow

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwHideWindow(GLFWwindow* window);

-

-/*! @brief Brings the specified window to front and sets input focus.

- *

- *  This function brings the specified window to front and sets input focus.

- *  The window should already be visible and not iconified.

- *

- *  By default, both windowed and full screen mode windows are focused when

- *  initially created.  Set the [GLFW_FOCUSED](@ref GLFW_FOCUSED_hint) to

- *  disable this behavior.

- *

- *  Also by default, windowed mode windows are focused when shown

- *  with @ref glfwShowWindow. Set the

- *  [GLFW_FOCUS_ON_SHOW](@ref GLFW_FOCUS_ON_SHOW_hint) to disable this behavior.

- *

- *  __Do not use this function__ to steal focus from other applications unless

- *  you are certain that is what the user wants.  Focus stealing can be

- *  extremely disruptive.

- *

- *  For a less disruptive way of getting the user's attention, see

- *  [attention requests](@ref window_attention).

- *

- *  @param[in] window The window to give input focus.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @remark @wayland It is not possible for an application to bring its windows

- *  to front, this function will always emit @ref GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_focus

- *  @sa @ref window_attention

- *

- *  @since Added in version 3.2.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwFocusWindow(GLFWwindow* window);

-

-/*! @brief Requests user attention to the specified window.

- *

- *  This function requests user attention to the specified window.  On

- *  platforms where this is not supported, attention is requested to the

- *  application as a whole.

- *

- *  Once the user has given attention, usually by focusing the window or

- *  application, the system will end the request automatically.

- *

- *  @param[in] window The window to request attention to.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @remark @macos Attention is requested to the application as a whole, not the

- *  specific window.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_attention

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwRequestWindowAttention(GLFWwindow* window);

-

-/*! @brief Returns the monitor that the window uses for full screen mode.

- *

- *  This function returns the handle of the monitor that the specified window is

- *  in full screen on.

- *

- *  @param[in] window The window to query.

- *  @return The monitor, or `NULL` if the window is in windowed mode or an

- *  [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_monitor

- *  @sa @ref glfwSetWindowMonitor

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup window

- */

-GLFWAPI GLFWmonitor* glfwGetWindowMonitor(GLFWwindow* window);

-

-/*! @brief Sets the mode, monitor, video mode and placement of a window.

- *

- *  This function sets the monitor that the window uses for full screen mode or,

- *  if the monitor is `NULL`, makes it windowed mode.

- *

- *  When setting a monitor, this function updates the width, height and refresh

- *  rate of the desired video mode and switches to the video mode closest to it.

- *  The window position is ignored when setting a monitor.

- *

- *  When the monitor is `NULL`, the position, width and height are used to

- *  place the window client area.  The refresh rate is ignored when no monitor

- *  is specified.

- *

- *  If you only wish to update the resolution of a full screen window or the

- *  size of a windowed mode window, see @ref glfwSetWindowSize.

- *

- *  When a window transitions from full screen to windowed mode, this function

- *  restores any previous window settings such as whether it is decorated,

- *  floating, resizable, has size or aspect ratio limits, etc.

- *

- *  @param[in] window The window whose monitor, size or video mode to set.

- *  @param[in] monitor The desired monitor, or `NULL` to set windowed mode.

- *  @param[in] xpos The desired x-coordinate of the upper-left corner of the

- *  client area.

- *  @param[in] ypos The desired y-coordinate of the upper-left corner of the

- *  client area.

- *  @param[in] width The desired with, in screen coordinates, of the client area

- *  or video mode.

- *  @param[in] height The desired height, in screen coordinates, of the client

- *  area or video mode.

- *  @param[in] refreshRate The desired refresh rate, in Hz, of the video mode,

- *  or `GLFW_DONT_CARE`.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @remark The OpenGL or OpenGL ES context will not be destroyed or otherwise

- *  affected by any resizing or mode switching, although you may need to update

- *  your viewport if the framebuffer size has changed.

- *

- *  @remark @wayland The desired window position is ignored, as there is no way

- *  for an application to set this property.

- *

- *  @remark @wayland Setting the window to full screen will not attempt to

- *  change the mode, no matter what the requested size or refresh rate.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_monitor

- *  @sa @ref window_full_screen

- *  @sa @ref glfwGetWindowMonitor

- *  @sa @ref glfwSetWindowSize

- *

- *  @since Added in version 3.2.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwSetWindowMonitor(GLFWwindow* window, GLFWmonitor* monitor, int xpos, int ypos, int width, int height, int refreshRate);

-

-/*! @brief Returns an attribute of the specified window.

- *

- *  This function returns the value of an attribute of the specified window or

- *  its OpenGL or OpenGL ES context.

- *

- *  @param[in] window The window to query.

- *  @param[in] attrib The [window attribute](@ref window_attribs) whose value to

- *  return.

- *  @return The value of the attribute, or zero if an

- *  [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.

- *

- *  @remark Framebuffer related hints are not window attributes.  See @ref

- *  window_attribs_fb for more information.

- *

- *  @remark Zero is a valid value for many window and context related

- *  attributes so you cannot use a return value of zero as an indication of

- *  errors.  However, this function should not fail as long as it is passed

- *  valid arguments and the library has been [initialized](@ref intro_init).

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_attribs

- *  @sa @ref glfwSetWindowAttrib

- *

- *  @since Added in version 3.0.  Replaces `glfwGetWindowParam` and

- *  `glfwGetGLVersion`.

- *

- *  @ingroup window

- */

-GLFWAPI int glfwGetWindowAttrib(GLFWwindow* window, int attrib);

-

-/*! @brief Sets an attribute of the specified window.

- *

- *  This function sets the value of an attribute of the specified window.

- *

- *  The supported attributes are [GLFW_DECORATED](@ref GLFW_DECORATED_attrib),

- *  [GLFW_RESIZABLE](@ref GLFW_RESIZABLE_attrib),

- *  [GLFW_FLOATING](@ref GLFW_FLOATING_attrib),

- *  [GLFW_AUTO_ICONIFY](@ref GLFW_AUTO_ICONIFY_attrib) and

- *  [GLFW_FOCUS_ON_SHOW](@ref GLFW_FOCUS_ON_SHOW_attrib).

- *

- *  Some of these attributes are ignored for full screen windows.  The new

- *  value will take effect if the window is later made windowed.

- *

- *  Some of these attributes are ignored for windowed mode windows.  The new

- *  value will take effect if the window is later made full screen.

- *

- *  @param[in] window The window to set the attribute for.

- *  @param[in] attrib A supported window attribute.

- *  @param[in] value `GLFW_TRUE` or `GLFW_FALSE`.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_INVALID_ENUM, @ref GLFW_INVALID_VALUE and @ref GLFW_PLATFORM_ERROR.

- *

- *  @remark Calling @ref glfwGetWindowAttrib will always return the latest

- *  value, even if that value is ignored by the current mode of the window.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_attribs

- *  @sa @ref glfwGetWindowAttrib

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwSetWindowAttrib(GLFWwindow* window, int attrib, int value);

-

-/*! @brief Sets the user pointer of the specified window.

- *

- *  This function sets the user-defined pointer of the specified window.  The

- *  current value is retained until the window is destroyed.  The initial value

- *  is `NULL`.

- *

- *  @param[in] window The window whose pointer to set.

- *  @param[in] pointer The new value.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @sa @ref window_userptr

- *  @sa @ref glfwGetWindowUserPointer

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwSetWindowUserPointer(GLFWwindow* window, void* pointer);

-

-/*! @brief Returns the user pointer of the specified window.

- *

- *  This function returns the current value of the user-defined pointer of the

- *  specified window.  The initial value is `NULL`.

- *

- *  @param[in] window The window whose pointer to return.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @sa @ref window_userptr

- *  @sa @ref glfwSetWindowUserPointer

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup window

- */

-GLFWAPI void* glfwGetWindowUserPointer(GLFWwindow* window);

-

-/*! @brief Sets the position callback for the specified window.

- *

- *  This function sets the position callback of the specified window, which is

- *  called when the window is moved.  The callback is provided with the

- *  position, in screen coordinates, of the upper-left corner of the client area

- *  of the window.

- *

- *  @param[in] window The window whose callback to set.

- *  @param[in] cbfun The new callback, or `NULL` to remove the currently set

- *  callback.

- *  @return The previously set callback, or `NULL` if no callback was set or the

- *  library had not been [initialized](@ref intro_init).

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @remark @wayland This callback will never be called, as there is no way for

- *  an application to know its global position.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_pos

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup window

- */

-GLFWAPI GLFWwindowposfun glfwSetWindowPosCallback(GLFWwindow* window, GLFWwindowposfun cbfun);

-

-/*! @brief Sets the size callback for the specified window.

- *

- *  This function sets the size callback of the specified window, which is

- *  called when the window is resized.  The callback is provided with the size,

- *  in screen coordinates, of the client area of the window.

- *

- *  @param[in] window The window whose callback to set.

- *  @param[in] cbfun The new callback, or `NULL` to remove the currently set

- *  callback.

- *  @return The previously set callback, or `NULL` if no callback was set or the

- *  library had not been [initialized](@ref intro_init).

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_size

- *

- *  @since Added in version 1.0.

- *  @glfw3 Added window handle parameter and return value.

- *

- *  @ingroup window

- */

-GLFWAPI GLFWwindowsizefun glfwSetWindowSizeCallback(GLFWwindow* window, GLFWwindowsizefun cbfun);

-

-/*! @brief Sets the close callback for the specified window.

- *

- *  This function sets the close callback of the specified window, which is

- *  called when the user attempts to close the window, for example by clicking

- *  the close widget in the title bar.

- *

- *  The close flag is set before this callback is called, but you can modify it

- *  at any time with @ref glfwSetWindowShouldClose.

- *

- *  The close callback is not triggered by @ref glfwDestroyWindow.

- *

- *  @param[in] window The window whose callback to set.

- *  @param[in] cbfun The new callback, or `NULL` to remove the currently set

- *  callback.

- *  @return The previously set callback, or `NULL` if no callback was set or the

- *  library had not been [initialized](@ref intro_init).

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @remark @macos Selecting Quit from the application menu will trigger the

- *  close callback for all windows.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_close

- *

- *  @since Added in version 2.5.

- *  @glfw3 Added window handle parameter and return value.

- *

- *  @ingroup window

- */

-GLFWAPI GLFWwindowclosefun glfwSetWindowCloseCallback(GLFWwindow* window, GLFWwindowclosefun cbfun);

-

-/*! @brief Sets the refresh callback for the specified window.

- *

- *  This function sets the refresh callback of the specified window, which is

- *  called when the client area of the window needs to be redrawn, for example

- *  if the window has been exposed after having been covered by another window.

- *

- *  On compositing window systems such as Aero, Compiz, Aqua or Wayland, where

- *  the window contents are saved off-screen, this callback may be called only

- *  very infrequently or never at all.

- *

- *  @param[in] window The window whose callback to set.

- *  @param[in] cbfun The new callback, or `NULL` to remove the currently set

- *  callback.

- *  @return The previously set callback, or `NULL` if no callback was set or the

- *  library had not been [initialized](@ref intro_init).

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_refresh

- *

- *  @since Added in version 2.5.

- *  @glfw3 Added window handle parameter and return value.

- *

- *  @ingroup window

- */

-GLFWAPI GLFWwindowrefreshfun glfwSetWindowRefreshCallback(GLFWwindow* window, GLFWwindowrefreshfun cbfun);

-

-/*! @brief Sets the focus callback for the specified window.

- *

- *  This function sets the focus callback of the specified window, which is

- *  called when the window gains or loses input focus.

- *

- *  After the focus callback is called for a window that lost input focus,

- *  synthetic key and mouse button release events will be generated for all such

- *  that had been pressed.  For more information, see @ref glfwSetKeyCallback

- *  and @ref glfwSetMouseButtonCallback.

- *

- *  @param[in] window The window whose callback to set.

- *  @param[in] cbfun The new callback, or `NULL` to remove the currently set

- *  callback.

- *  @return The previously set callback, or `NULL` if no callback was set or the

- *  library had not been [initialized](@ref intro_init).

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_focus

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup window

- */

-GLFWAPI GLFWwindowfocusfun glfwSetWindowFocusCallback(GLFWwindow* window, GLFWwindowfocusfun cbfun);

-

-/*! @brief Sets the iconify callback for the specified window.

- *

- *  This function sets the iconification callback of the specified window, which

- *  is called when the window is iconified or restored.

- *

- *  @param[in] window The window whose callback to set.

- *  @param[in] cbfun The new callback, or `NULL` to remove the currently set

- *  callback.

- *  @return The previously set callback, or `NULL` if no callback was set or the

- *  library had not been [initialized](@ref intro_init).

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @remark @wayland The wl_shell protocol has no concept of iconification,

- *  this callback will never be called when using this deprecated protocol.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_iconify

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup window

- */

-GLFWAPI GLFWwindowiconifyfun glfwSetWindowIconifyCallback(GLFWwindow* window, GLFWwindowiconifyfun cbfun);

-

-/*! @brief Sets the maximize callback for the specified window.

- *

- *  This function sets the maximization callback of the specified window, which

- *  is called when the window is maximized or restored.

- *

- *  @param[in] window The window whose callback to set.

- *  @param[in] cbfun The new callback, or `NULL` to remove the currently set

- *  callback.

- *  @return The previously set callback, or `NULL` if no callback was set or the

- *  library had not been [initialized](@ref intro_init).

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_maximize

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup window

- */

-GLFWAPI GLFWwindowmaximizefun glfwSetWindowMaximizeCallback(GLFWwindow* window, GLFWwindowmaximizefun cbfun);

-

-/*! @brief Sets the framebuffer resize callback for the specified window.

- *

- *  This function sets the framebuffer resize callback of the specified window,

- *  which is called when the framebuffer of the specified window is resized.

- *

- *  @param[in] window The window whose callback to set.

- *  @param[in] cbfun The new callback, or `NULL` to remove the currently set

- *  callback.

- *  @return The previously set callback, or `NULL` if no callback was set or the

- *  library had not been [initialized](@ref intro_init).

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_fbsize

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup window

- */

-GLFWAPI GLFWframebuffersizefun glfwSetFramebufferSizeCallback(GLFWwindow* window, GLFWframebuffersizefun cbfun);

-

-/*! @brief Sets the window content scale callback for the specified window.

- *

- *  This function sets the window content scale callback of the specified window,

- *  which is called when the content scale of the specified window changes.

- *

- *  @param[in] window The window whose callback to set.

- *  @param[in] cbfun The new callback, or `NULL` to remove the currently set

- *  callback.

- *  @return The previously set callback, or `NULL` if no callback was set or the

- *  library had not been [initialized](@ref intro_init).

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref window_scale

- *  @sa @ref glfwGetWindowContentScale

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup window

- */

-GLFWAPI GLFWwindowcontentscalefun glfwSetWindowContentScaleCallback(GLFWwindow* window, GLFWwindowcontentscalefun cbfun);

-

-/*! @brief Processes all pending events.

- *

- *  This function processes only those events that are already in the event

- *  queue and then returns immediately.  Processing events will cause the window

- *  and input callbacks associated with those events to be called.

- *

- *  On some platforms, a window move, resize or menu operation will cause event

- *  processing to block.  This is due to how event processing is designed on

- *  those platforms.  You can use the

- *  [window refresh callback](@ref window_refresh) to redraw the contents of

- *  your window when necessary during such operations.

- *

- *  Do not assume that callbacks you set will _only_ be called in response to

- *  event processing functions like this one.  While it is necessary to poll for

- *  events, window systems that require GLFW to register callbacks of its own

- *  can pass events to GLFW in response to many window system function calls.

- *  GLFW will pass those events on to the application callbacks before

- *  returning.

- *

- *  Event processing is not required for joystick input to work.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @reentrancy This function must not be called from a callback.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref events

- *  @sa @ref glfwWaitEvents

- *  @sa @ref glfwWaitEventsTimeout

- *

- *  @since Added in version 1.0.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwPollEvents(void);

-

-/*! @brief Waits until events are queued and processes them.

- *

- *  This function puts the calling thread to sleep until at least one event is

- *  available in the event queue.  Once one or more events are available,

- *  it behaves exactly like @ref glfwPollEvents, i.e. the events in the queue

- *  are processed and the function then returns immediately.  Processing events

- *  will cause the window and input callbacks associated with those events to be

- *  called.

- *

- *  Since not all events are associated with callbacks, this function may return

- *  without a callback having been called even if you are monitoring all

- *  callbacks.

- *

- *  On some platforms, a window move, resize or menu operation will cause event

- *  processing to block.  This is due to how event processing is designed on

- *  those platforms.  You can use the

- *  [window refresh callback](@ref window_refresh) to redraw the contents of

- *  your window when necessary during such operations.

- *

- *  Do not assume that callbacks you set will _only_ be called in response to

- *  event processing functions like this one.  While it is necessary to poll for

- *  events, window systems that require GLFW to register callbacks of its own

- *  can pass events to GLFW in response to many window system function calls.

- *  GLFW will pass those events on to the application callbacks before

- *  returning.

- *

- *  If no windows exist, this function returns immediately.  For synchronization

- *  of threads in applications that do not create windows, use your threading

- *  library of choice.

- *

- *  Event processing is not required for joystick input to work.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @reentrancy This function must not be called from a callback.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref events

- *  @sa @ref glfwPollEvents

- *  @sa @ref glfwWaitEventsTimeout

- *

- *  @since Added in version 2.5.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwWaitEvents(void);

-

-/*! @brief Waits with timeout until events are queued and processes them.

- *

- *  This function puts the calling thread to sleep until at least one event is

- *  available in the event queue, or until the specified timeout is reached.  If

- *  one or more events are available, it behaves exactly like @ref

- *  glfwPollEvents, i.e. the events in the queue are processed and the function

- *  then returns immediately.  Processing events will cause the window and input

- *  callbacks associated with those events to be called.

- *

- *  The timeout value must be a positive finite number.

- *

- *  Since not all events are associated with callbacks, this function may return

- *  without a callback having been called even if you are monitoring all

- *  callbacks.

- *

- *  On some platforms, a window move, resize or menu operation will cause event

- *  processing to block.  This is due to how event processing is designed on

- *  those platforms.  You can use the

- *  [window refresh callback](@ref window_refresh) to redraw the contents of

- *  your window when necessary during such operations.

- *

- *  Do not assume that callbacks you set will _only_ be called in response to

- *  event processing functions like this one.  While it is necessary to poll for

- *  events, window systems that require GLFW to register callbacks of its own

- *  can pass events to GLFW in response to many window system function calls.

- *  GLFW will pass those events on to the application callbacks before

- *  returning.

- *

- *  If no windows exist, this function returns immediately.  For synchronization

- *  of threads in applications that do not create windows, use your threading

- *  library of choice.

- *

- *  Event processing is not required for joystick input to work.

- *

- *  @param[in] timeout The maximum amount of time, in seconds, to wait.

- *

- *  @reentrancy This function must not be called from a callback.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref events

- *  @sa @ref glfwPollEvents

- *  @sa @ref glfwWaitEvents

- *

- *  @since Added in version 3.2.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwWaitEventsTimeout(double timeout);

-

-/*! @brief Posts an empty event to the event queue.

- *

- *  This function posts an empty event from the current thread to the event

- *  queue, causing @ref glfwWaitEvents or @ref glfwWaitEventsTimeout to return.

- *

- *  If no windows exist, this function returns immediately.  For synchronization

- *  of threads in applications that do not create windows, use your threading

- *  library of choice.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function may be called from any thread.

- *

- *  @sa @ref events

- *  @sa @ref glfwWaitEvents

- *  @sa @ref glfwWaitEventsTimeout

- *

- *  @since Added in version 3.1.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwPostEmptyEvent(void);

-

-/*! @brief Returns the value of an input option for the specified window.

- *

- *  This function returns the value of an input option for the specified window.

- *  The mode must be one of @ref GLFW_CURSOR, @ref GLFW_STICKY_KEYS,

- *  @ref GLFW_STICKY_MOUSE_BUTTONS or @ref GLFW_LOCK_KEY_MODS.

- *

- *  @param[in] window The window to query.

- *  @param[in] mode One of `GLFW_CURSOR`, `GLFW_STICKY_KEYS`,

- *  `GLFW_STICKY_MOUSE_BUTTONS` or `GLFW_LOCK_KEY_MODS`.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_INVALID_ENUM.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref glfwSetInputMode

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup input

- */

-GLFWAPI int glfwGetInputMode(GLFWwindow* window, int mode);

-

-/*! @brief Sets an input option for the specified window.

- *

- *  This function sets an input mode option for the specified window.  The mode

- *  must be one of @ref GLFW_CURSOR, @ref GLFW_STICKY_KEYS,

- *  @ref GLFW_STICKY_MOUSE_BUTTONS or @ref GLFW_LOCK_KEY_MODS.

- *

- *  If the mode is `GLFW_CURSOR`, the value must be one of the following cursor

- *  modes:

- *  - `GLFW_CURSOR_NORMAL` makes the cursor visible and behaving normally.

- *  - `GLFW_CURSOR_HIDDEN` makes the cursor invisible when it is over the client

- *    area of the window but does not restrict the cursor from leaving.

- *  - `GLFW_CURSOR_DISABLED` hides and grabs the cursor, providing virtual

- *    and unlimited cursor movement.  This is useful for implementing for

- *    example 3D camera controls.

- *

- *  If the mode is `GLFW_STICKY_KEYS`, the value must be either `GLFW_TRUE` to

- *  enable sticky keys, or `GLFW_FALSE` to disable it.  If sticky keys are

- *  enabled, a key press will ensure that @ref glfwGetKey returns `GLFW_PRESS`

- *  the next time it is called even if the key had been released before the

- *  call.  This is useful when you are only interested in whether keys have been

- *  pressed but not when or in which order.

- *

- *  If the mode is `GLFW_STICKY_MOUSE_BUTTONS`, the value must be either

- *  `GLFW_TRUE` to enable sticky mouse buttons, or `GLFW_FALSE` to disable it.

- *  If sticky mouse buttons are enabled, a mouse button press will ensure that

- *  @ref glfwGetMouseButton returns `GLFW_PRESS` the next time it is called even

- *  if the mouse button had been released before the call.  This is useful when

- *  you are only interested in whether mouse buttons have been pressed but not

- *  when or in which order.

- *

- *  If the mode is `GLFW_LOCK_KEY_MODS`, the value must be either `GLFW_TRUE` to

- *  enable lock key modifier bits, or `GLFW_FALSE` to disable them.  If enabled,

- *  callbacks that receive modifier bits will also have the @ref

- *  GLFW_MOD_CAPS_LOCK bit set when the event was generated with Caps Lock on,

- *  and the @ref GLFW_MOD_NUM_LOCK bit when Num Lock was on.

- *

- *  @param[in] window The window whose input mode to set.

- *  @param[in] mode One of `GLFW_CURSOR`, `GLFW_STICKY_KEYS`,

- *  `GLFW_STICKY_MOUSE_BUTTONS` or `GLFW_LOCK_KEY_MODS`.

- *  @param[in] value The new value of the specified input mode.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref glfwGetInputMode

- *

- *  @since Added in version 3.0.  Replaces `glfwEnable` and `glfwDisable`.

- *

- *  @ingroup input

- */

-GLFWAPI void glfwSetInputMode(GLFWwindow* window, int mode, int value);

-

-/*! @brief Returns the layout-specific name of the specified printable key.

- *

- *  This function returns the name of the specified printable key, encoded as

- *  UTF-8.  This is typically the character that key would produce without any

- *  modifier keys, intended for displaying key bindings to the user.  For dead

- *  keys, it is typically the diacritic it would add to a character.

- *

- *  __Do not use this function__ for [text input](@ref input_char).  You will

- *  break text input for many languages even if it happens to work for yours.

- *

- *  If the key is `GLFW_KEY_UNKNOWN`, the scancode is used to identify the key,

- *  otherwise the scancode is ignored.  If you specify a non-printable key, or

- *  `GLFW_KEY_UNKNOWN` and a scancode that maps to a non-printable key, this

- *  function returns `NULL` but does not emit an error.

- *

- *  This behavior allows you to always pass in the arguments in the

- *  [key callback](@ref input_key) without modification.

- *

- *  The printable keys are:

- *  - `GLFW_KEY_APOSTROPHE`

- *  - `GLFW_KEY_COMMA`

- *  - `GLFW_KEY_MINUS`

- *  - `GLFW_KEY_PERIOD`

- *  - `GLFW_KEY_SLASH`

- *  - `GLFW_KEY_SEMICOLON`

- *  - `GLFW_KEY_EQUAL`

- *  - `GLFW_KEY_LEFT_BRACKET`

- *  - `GLFW_KEY_RIGHT_BRACKET`

- *  - `GLFW_KEY_BACKSLASH`

- *  - `GLFW_KEY_WORLD_1`

- *  - `GLFW_KEY_WORLD_2`

- *  - `GLFW_KEY_0` to `GLFW_KEY_9`

- *  - `GLFW_KEY_A` to `GLFW_KEY_Z`

- *  - `GLFW_KEY_KP_0` to `GLFW_KEY_KP_9`

- *  - `GLFW_KEY_KP_DECIMAL`

- *  - `GLFW_KEY_KP_DIVIDE`

- *  - `GLFW_KEY_KP_MULTIPLY`

- *  - `GLFW_KEY_KP_SUBTRACT`

- *  - `GLFW_KEY_KP_ADD`

- *  - `GLFW_KEY_KP_EQUAL`

- *

- *  Names for printable keys depend on keyboard layout, while names for

- *  non-printable keys are the same across layouts but depend on the application

- *  language and should be localized along with other user interface text.

- *

- *  @param[in] key The key to query, or `GLFW_KEY_UNKNOWN`.

- *  @param[in] scancode The scancode of the key to query.

- *  @return The UTF-8 encoded, layout-specific name of the key, or `NULL`.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @pointer_lifetime The returned string is allocated and freed by GLFW.  You

- *  should not free it yourself.  It is valid until the next call to @ref

- *  glfwGetKeyName, or until the library is terminated.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref input_key_name

- *

- *  @since Added in version 3.2.

- *

- *  @ingroup input

- */

-GLFWAPI const char* glfwGetKeyName(int key, int scancode);

-

-/*! @brief Returns the platform-specific scancode of the specified key.

- *

- *  This function returns the platform-specific scancode of the specified key.

- *

- *  If the key is `GLFW_KEY_UNKNOWN` or does not exist on the keyboard this

- *  method will return `-1`.

- *

- *  @param[in] key Any [named key](@ref keys).

- *  @return The platform-specific scancode for the key, or `-1` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function may be called from any thread.

- *

- *  @sa @ref input_key

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup input

- */

-GLFWAPI int glfwGetKeyScancode(int key);

-

-/*! @brief Returns the last reported state of a keyboard key for the specified

- *  window.

- *

- *  This function returns the last state reported for the specified key to the

- *  specified window.  The returned state is one of `GLFW_PRESS` or

- *  `GLFW_RELEASE`.  The higher-level action `GLFW_REPEAT` is only reported to

- *  the key callback.

- *

- *  If the @ref GLFW_STICKY_KEYS input mode is enabled, this function returns

- *  `GLFW_PRESS` the first time you call it for a key that was pressed, even if

- *  that key has already been released.

- *

- *  The key functions deal with physical keys, with [key tokens](@ref keys)

- *  named after their use on the standard US keyboard layout.  If you want to

- *  input text, use the Unicode character callback instead.

- *

- *  The [modifier key bit masks](@ref mods) are not key tokens and cannot be

- *  used with this function.

- *

- *  __Do not use this function__ to implement [text input](@ref input_char).

- *

- *  @param[in] window The desired window.

- *  @param[in] key The desired [keyboard key](@ref keys).  `GLFW_KEY_UNKNOWN` is

- *  not a valid key for this function.

- *  @return One of `GLFW_PRESS` or `GLFW_RELEASE`.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_INVALID_ENUM.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref input_key

- *

- *  @since Added in version 1.0.

- *  @glfw3 Added window handle parameter.

- *

- *  @ingroup input

- */

-GLFWAPI int glfwGetKey(GLFWwindow* window, int key);

-

-/*! @brief Returns the last reported state of a mouse button for the specified

- *  window.

- *

- *  This function returns the last state reported for the specified mouse button

- *  to the specified window.  The returned state is one of `GLFW_PRESS` or

- *  `GLFW_RELEASE`.

- *

- *  If the @ref GLFW_STICKY_MOUSE_BUTTONS input mode is enabled, this function

- *  returns `GLFW_PRESS` the first time you call it for a mouse button that was

- *  pressed, even if that mouse button has already been released.

- *

- *  @param[in] window The desired window.

- *  @param[in] button The desired [mouse button](@ref buttons).

- *  @return One of `GLFW_PRESS` or `GLFW_RELEASE`.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_INVALID_ENUM.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref input_mouse_button

- *

- *  @since Added in version 1.0.

- *  @glfw3 Added window handle parameter.

- *

- *  @ingroup input

- */

-GLFWAPI int glfwGetMouseButton(GLFWwindow* window, int button);

-

-/*! @brief Retrieves the position of the cursor relative to the client area of

- *  the window.

- *

- *  This function returns the position of the cursor, in screen coordinates,

- *  relative to the upper-left corner of the client area of the specified

- *  window.

- *

- *  If the cursor is disabled (with `GLFW_CURSOR_DISABLED`) then the cursor

- *  position is unbounded and limited only by the minimum and maximum values of

- *  a `double`.

- *

- *  The coordinate can be converted to their integer equivalents with the

- *  `floor` function.  Casting directly to an integer type works for positive

- *  coordinates, but fails for negative ones.

- *

- *  Any or all of the position arguments may be `NULL`.  If an error occurs, all

- *  non-`NULL` position arguments will be set to zero.

- *

- *  @param[in] window The desired window.

- *  @param[out] xpos Where to store the cursor x-coordinate, relative to the

- *  left edge of the client area, or `NULL`.

- *  @param[out] ypos Where to store the cursor y-coordinate, relative to the to

- *  top edge of the client area, or `NULL`.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref cursor_pos

- *  @sa @ref glfwSetCursorPos

- *

- *  @since Added in version 3.0.  Replaces `glfwGetMousePos`.

- *

- *  @ingroup input

- */

-GLFWAPI void glfwGetCursorPos(GLFWwindow* window, double* xpos, double* ypos);

-

-/*! @brief Sets the position of the cursor, relative to the client area of the

- *  window.

- *

- *  This function sets the position, in screen coordinates, of the cursor

- *  relative to the upper-left corner of the client area of the specified

- *  window.  The window must have input focus.  If the window does not have

- *  input focus when this function is called, it fails silently.

- *

- *  __Do not use this function__ to implement things like camera controls.  GLFW

- *  already provides the `GLFW_CURSOR_DISABLED` cursor mode that hides the

- *  cursor, transparently re-centers it and provides unconstrained cursor

- *  motion.  See @ref glfwSetInputMode for more information.

- *

- *  If the cursor mode is `GLFW_CURSOR_DISABLED` then the cursor position is

- *  unconstrained and limited only by the minimum and maximum values of

- *  a `double`.

- *

- *  @param[in] window The desired window.

- *  @param[in] xpos The desired x-coordinate, relative to the left edge of the

- *  client area.

- *  @param[in] ypos The desired y-coordinate, relative to the top edge of the

- *  client area.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @remark @wayland This function will only work when the cursor mode is

- *  `GLFW_CURSOR_DISABLED`, otherwise it will do nothing.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref cursor_pos

- *  @sa @ref glfwGetCursorPos

- *

- *  @since Added in version 3.0.  Replaces `glfwSetMousePos`.

- *

- *  @ingroup input

- */

-GLFWAPI void glfwSetCursorPos(GLFWwindow* window, double xpos, double ypos);

-

-/*! @brief Creates a custom cursor.

- *

- *  Creates a new custom cursor image that can be set for a window with @ref

- *  glfwSetCursor.  The cursor can be destroyed with @ref glfwDestroyCursor.

- *  Any remaining cursors are destroyed by @ref glfwTerminate.

- *

- *  The pixels are 32-bit, little-endian, non-premultiplied RGBA, i.e. eight

- *  bits per channel with the red channel first.  They are arranged canonically

- *  as packed sequential rows, starting from the top-left corner.

- *

- *  The cursor hotspot is specified in pixels, relative to the upper-left corner

- *  of the cursor image.  Like all other coordinate systems in GLFW, the X-axis

- *  points to the right and the Y-axis points down.

- *

- *  @param[in] image The desired cursor image.

- *  @param[in] xhot The desired x-coordinate, in pixels, of the cursor hotspot.

- *  @param[in] yhot The desired y-coordinate, in pixels, of the cursor hotspot.

- *  @return The handle of the created cursor, or `NULL` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @pointer_lifetime The specified image data is copied before this function

- *  returns.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref cursor_object

- *  @sa @ref glfwDestroyCursor

- *  @sa @ref glfwCreateStandardCursor

- *

- *  @since Added in version 3.1.

- *

- *  @ingroup input

- */

-GLFWAPI GLFWcursor* glfwCreateCursor(const GLFWimage* image, int xhot, int yhot);

-

-/*! @brief Creates a cursor with a standard shape.

- *

- *  Returns a cursor with a [standard shape](@ref shapes), that can be set for

- *  a window with @ref glfwSetCursor.

- *

- *  @param[in] shape One of the [standard shapes](@ref shapes).

- *  @return A new cursor ready to use or `NULL` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref cursor_object

- *  @sa @ref glfwCreateCursor

- *

- *  @since Added in version 3.1.

- *

- *  @ingroup input

- */

-GLFWAPI GLFWcursor* glfwCreateStandardCursor(int shape);

-

-/*! @brief Destroys a cursor.

- *

- *  This function destroys a cursor previously created with @ref

- *  glfwCreateCursor.  Any remaining cursors will be destroyed by @ref

- *  glfwTerminate.

- *

- *  If the specified cursor is current for any window, that window will be

- *  reverted to the default cursor.  This does not affect the cursor mode.

- *

- *  @param[in] cursor The cursor object to destroy.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @reentrancy This function must not be called from a callback.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref cursor_object

- *  @sa @ref glfwCreateCursor

- *

- *  @since Added in version 3.1.

- *

- *  @ingroup input

- */

-GLFWAPI void glfwDestroyCursor(GLFWcursor* cursor);

-

-/*! @brief Sets the cursor for the window.

- *

- *  This function sets the cursor image to be used when the cursor is over the

- *  client area of the specified window.  The set cursor will only be visible

- *  when the [cursor mode](@ref cursor_mode) of the window is

- *  `GLFW_CURSOR_NORMAL`.

- *

- *  On some platforms, the set cursor may not be visible unless the window also

- *  has input focus.

- *

- *  @param[in] window The window to set the cursor for.

- *  @param[in] cursor The cursor to set, or `NULL` to switch back to the default

- *  arrow cursor.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref cursor_object

- *

- *  @since Added in version 3.1.

- *

- *  @ingroup input

- */

-GLFWAPI void glfwSetCursor(GLFWwindow* window, GLFWcursor* cursor);

-

-/*! @brief Sets the key callback.

- *

- *  This function sets the key callback of the specified window, which is called

- *  when a key is pressed, repeated or released.

- *

- *  The key functions deal with physical keys, with layout independent

- *  [key tokens](@ref keys) named after their values in the standard US keyboard

- *  layout.  If you want to input text, use the

- *  [character callback](@ref glfwSetCharCallback) instead.

- *

- *  When a window loses input focus, it will generate synthetic key release

- *  events for all pressed keys.  You can tell these events from user-generated

- *  events by the fact that the synthetic ones are generated after the focus

- *  loss event has been processed, i.e. after the

- *  [window focus callback](@ref glfwSetWindowFocusCallback) has been called.

- *

- *  The scancode of a key is specific to that platform or sometimes even to that

- *  machine.  Scancodes are intended to allow users to bind keys that don't have

- *  a GLFW key token.  Such keys have `key` set to `GLFW_KEY_UNKNOWN`, their

- *  state is not saved and so it cannot be queried with @ref glfwGetKey.

- *

- *  Sometimes GLFW needs to generate synthetic key events, in which case the

- *  scancode may be zero.

- *

- *  @param[in] window The window whose callback to set.

- *  @param[in] cbfun The new key callback, or `NULL` to remove the currently

- *  set callback.

- *  @return The previously set callback, or `NULL` if no callback was set or the

- *  library had not been [initialized](@ref intro_init).

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref input_key

- *

- *  @since Added in version 1.0.

- *  @glfw3 Added window handle parameter and return value.

- *

- *  @ingroup input

- */

-GLFWAPI GLFWkeyfun glfwSetKeyCallback(GLFWwindow* window, GLFWkeyfun cbfun);

-

-/*! @brief Sets the Unicode character callback.

- *

- *  This function sets the character callback of the specified window, which is

- *  called when a Unicode character is input.

- *

- *  The character callback is intended for Unicode text input.  As it deals with

- *  characters, it is keyboard layout dependent, whereas the

- *  [key callback](@ref glfwSetKeyCallback) is not.  Characters do not map 1:1

- *  to physical keys, as a key may produce zero, one or more characters.  If you

- *  want to know whether a specific physical key was pressed or released, see

- *  the key callback instead.

- *

- *  The character callback behaves as system text input normally does and will

- *  not be called if modifier keys are held down that would prevent normal text

- *  input on that platform, for example a Super (Command) key on macOS or Alt key

- *  on Windows.  There is a

- *  [character with modifiers callback](@ref glfwSetCharModsCallback) that

- *  receives these events.

- *

- *  @param[in] window The window whose callback to set.

- *  @param[in] cbfun The new callback, or `NULL` to remove the currently set

- *  callback.

- *  @return The previously set callback, or `NULL` if no callback was set or the

- *  library had not been [initialized](@ref intro_init).

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref input_char

- *

- *  @since Added in version 2.4.

- *  @glfw3 Added window handle parameter and return value.

- *

- *  @ingroup input

- */

-GLFWAPI GLFWcharfun glfwSetCharCallback(GLFWwindow* window, GLFWcharfun cbfun);

-

-/*! @brief Sets the Unicode character with modifiers callback.

- *

- *  This function sets the character with modifiers callback of the specified

- *  window, which is called when a Unicode character is input regardless of what

- *  modifier keys are used.

- *

- *  The character with modifiers callback is intended for implementing custom

- *  Unicode character input.  For regular Unicode text input, see the

- *  [character callback](@ref glfwSetCharCallback).  Like the character

- *  callback, the character with modifiers callback deals with characters and is

- *  keyboard layout dependent.  Characters do not map 1:1 to physical keys, as

- *  a key may produce zero, one or more characters.  If you want to know whether

- *  a specific physical key was pressed or released, see the

- *  [key callback](@ref glfwSetKeyCallback) instead.

- *

- *  @param[in] window The window whose callback to set.

- *  @param[in] cbfun The new callback, or `NULL` to remove the currently set

- *  callback.

- *  @return The previously set callback, or `NULL` if no callback was set or an

- *  [error](@ref error_handling) occurred.

- *

- *  @deprecated Scheduled for removal in version 4.0.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref input_char

- *

- *  @since Added in version 3.1.

- *

- *  @ingroup input

- */

-GLFWAPI GLFWcharmodsfun glfwSetCharModsCallback(GLFWwindow* window, GLFWcharmodsfun cbfun);

-

-/*! @brief Sets the mouse button callback.

- *

- *  This function sets the mouse button callback of the specified window, which

- *  is called when a mouse button is pressed or released.

- *

- *  When a window loses input focus, it will generate synthetic mouse button

- *  release events for all pressed mouse buttons.  You can tell these events

- *  from user-generated events by the fact that the synthetic ones are generated

- *  after the focus loss event has been processed, i.e. after the

- *  [window focus callback](@ref glfwSetWindowFocusCallback) has been called.

- *

- *  @param[in] window The window whose callback to set.

- *  @param[in] cbfun The new callback, or `NULL` to remove the currently set

- *  callback.

- *  @return The previously set callback, or `NULL` if no callback was set or the

- *  library had not been [initialized](@ref intro_init).

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref input_mouse_button

- *

- *  @since Added in version 1.0.

- *  @glfw3 Added window handle parameter and return value.

- *

- *  @ingroup input

- */

-GLFWAPI GLFWmousebuttonfun glfwSetMouseButtonCallback(GLFWwindow* window, GLFWmousebuttonfun cbfun);

-

-/*! @brief Sets the cursor position callback.

- *

- *  This function sets the cursor position callback of the specified window,

- *  which is called when the cursor is moved.  The callback is provided with the

- *  position, in screen coordinates, relative to the upper-left corner of the

- *  client area of the window.

- *

- *  @param[in] window The window whose callback to set.

- *  @param[in] cbfun The new callback, or `NULL` to remove the currently set

- *  callback.

- *  @return The previously set callback, or `NULL` if no callback was set or the

- *  library had not been [initialized](@ref intro_init).

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref cursor_pos

- *

- *  @since Added in version 3.0.  Replaces `glfwSetMousePosCallback`.

- *

- *  @ingroup input

- */

-GLFWAPI GLFWcursorposfun glfwSetCursorPosCallback(GLFWwindow* window, GLFWcursorposfun cbfun);

-

-/*! @brief Sets the cursor enter/exit callback.

- *

- *  This function sets the cursor boundary crossing callback of the specified

- *  window, which is called when the cursor enters or leaves the client area of

- *  the window.

- *

- *  @param[in] window The window whose callback to set.

- *  @param[in] cbfun The new callback, or `NULL` to remove the currently set

- *  callback.

- *  @return The previously set callback, or `NULL` if no callback was set or the

- *  library had not been [initialized](@ref intro_init).

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref cursor_enter

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup input

- */

-GLFWAPI GLFWcursorenterfun glfwSetCursorEnterCallback(GLFWwindow* window, GLFWcursorenterfun cbfun);

-

-/*! @brief Sets the scroll callback.

- *

- *  This function sets the scroll callback of the specified window, which is

- *  called when a scrolling device is used, such as a mouse wheel or scrolling

- *  area of a touchpad.

- *

- *  The scroll callback receives all scrolling input, like that from a mouse

- *  wheel or a touchpad scrolling area.

- *

- *  @param[in] window The window whose callback to set.

- *  @param[in] cbfun The new scroll callback, or `NULL` to remove the currently

- *  set callback.

- *  @return The previously set callback, or `NULL` if no callback was set or the

- *  library had not been [initialized](@ref intro_init).

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref scrolling

- *

- *  @since Added in version 3.0.  Replaces `glfwSetMouseWheelCallback`.

- *

- *  @ingroup input

- */

-GLFWAPI GLFWscrollfun glfwSetScrollCallback(GLFWwindow* window, GLFWscrollfun cbfun);

-

-/*! @brief Sets the file drop callback.

- *

- *  This function sets the file drop callback of the specified window, which is

- *  called when one or more dragged files are dropped on the window.

- *

- *  Because the path array and its strings may have been generated specifically

- *  for that event, they are not guaranteed to be valid after the callback has

- *  returned.  If you wish to use them after the callback returns, you need to

- *  make a deep copy.

- *

- *  @param[in] window The window whose callback to set.

- *  @param[in] cbfun The new file drop callback, or `NULL` to remove the

- *  currently set callback.

- *  @return The previously set callback, or `NULL` if no callback was set or the

- *  library had not been [initialized](@ref intro_init).

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @remark @wayland File drop is currently unimplemented.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref path_drop

- *

- *  @since Added in version 3.1.

- *

- *  @ingroup input

- */

-GLFWAPI GLFWdropfun glfwSetDropCallback(GLFWwindow* window, GLFWdropfun cbfun);

-

-/*! @brief Returns whether the specified joystick is present.

- *

- *  This function returns whether the specified joystick is present.

- *

- *  There is no need to call this function before other functions that accept

- *  a joystick ID, as they all check for presence before performing any other

- *  work.

- *

- *  @param[in] jid The [joystick](@ref joysticks) to query.

- *  @return `GLFW_TRUE` if the joystick is present, or `GLFW_FALSE` otherwise.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref joystick

- *

- *  @since Added in version 3.0.  Replaces `glfwGetJoystickParam`.

- *

- *  @ingroup input

- */

-GLFWAPI int glfwJoystickPresent(int jid);

-

-/*! @brief Returns the values of all axes of the specified joystick.

- *

- *  This function returns the values of all axes of the specified joystick.

- *  Each element in the array is a value between -1.0 and 1.0.

- *

- *  If the specified joystick is not present this function will return `NULL`

- *  but will not generate an error.  This can be used instead of first calling

- *  @ref glfwJoystickPresent.

- *

- *  @param[in] jid The [joystick](@ref joysticks) to query.

- *  @param[out] count Where to store the number of axis values in the returned

- *  array.  This is set to zero if the joystick is not present or an error

- *  occurred.

- *  @return An array of axis values, or `NULL` if the joystick is not present or

- *  an [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.

- *

- *  @pointer_lifetime The returned array is allocated and freed by GLFW.  You

- *  should not free it yourself.  It is valid until the specified joystick is

- *  disconnected or the library is terminated.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref joystick_axis

- *

- *  @since Added in version 3.0.  Replaces `glfwGetJoystickPos`.

- *

- *  @ingroup input

- */

-GLFWAPI const float* glfwGetJoystickAxes(int jid, int* count);

-

-/*! @brief Returns the state of all buttons of the specified joystick.

- *

- *  This function returns the state of all buttons of the specified joystick.

- *  Each element in the array is either `GLFW_PRESS` or `GLFW_RELEASE`.

- *

- *  For backward compatibility with earlier versions that did not have @ref

- *  glfwGetJoystickHats, the button array also includes all hats, each

- *  represented as four buttons.  The hats are in the same order as returned by

- *  __glfwGetJoystickHats__ and are in the order _up_, _right_, _down_ and

- *  _left_.  To disable these extra buttons, set the @ref

- *  GLFW_JOYSTICK_HAT_BUTTONS init hint before initialization.

- *

- *  If the specified joystick is not present this function will return `NULL`

- *  but will not generate an error.  This can be used instead of first calling

- *  @ref glfwJoystickPresent.

- *

- *  @param[in] jid The [joystick](@ref joysticks) to query.

- *  @param[out] count Where to store the number of button states in the returned

- *  array.  This is set to zero if the joystick is not present or an error

- *  occurred.

- *  @return An array of button states, or `NULL` if the joystick is not present

- *  or an [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.

- *

- *  @pointer_lifetime The returned array is allocated and freed by GLFW.  You

- *  should not free it yourself.  It is valid until the specified joystick is

- *  disconnected or the library is terminated.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref joystick_button

- *

- *  @since Added in version 2.2.

- *  @glfw3 Changed to return a dynamic array.

- *

- *  @ingroup input

- */

-GLFWAPI const unsigned char* glfwGetJoystickButtons(int jid, int* count);

-

-/*! @brief Returns the state of all hats of the specified joystick.

- *

- *  This function returns the state of all hats of the specified joystick.

- *  Each element in the array is one of the following values:

- *

- *  Name                  | Value

- *  --------------------- | --------------------------------

- *  `GLFW_HAT_CENTERED`   | 0

- *  `GLFW_HAT_UP`         | 1

- *  `GLFW_HAT_RIGHT`      | 2

- *  `GLFW_HAT_DOWN`       | 4

- *  `GLFW_HAT_LEFT`       | 8

- *  `GLFW_HAT_RIGHT_UP`   | `GLFW_HAT_RIGHT` \| `GLFW_HAT_UP`

- *  `GLFW_HAT_RIGHT_DOWN` | `GLFW_HAT_RIGHT` \| `GLFW_HAT_DOWN`

- *  `GLFW_HAT_LEFT_UP`    | `GLFW_HAT_LEFT` \| `GLFW_HAT_UP`

- *  `GLFW_HAT_LEFT_DOWN`  | `GLFW_HAT_LEFT` \| `GLFW_HAT_DOWN`

- *

- *  The diagonal directions are bitwise combinations of the primary (up, right,

- *  down and left) directions and you can test for these individually by ANDing

- *  it with the corresponding direction.

- *

- *  @code

- *  if (hats[2] & GLFW_HAT_RIGHT)

- *  {

- *      // State of hat 2 could be right-up, right or right-down

- *  }

- *  @endcode

- *

- *  If the specified joystick is not present this function will return `NULL`

- *  but will not generate an error.  This can be used instead of first calling

- *  @ref glfwJoystickPresent.

- *

- *  @param[in] jid The [joystick](@ref joysticks) to query.

- *  @param[out] count Where to store the number of hat states in the returned

- *  array.  This is set to zero if the joystick is not present or an error

- *  occurred.

- *  @return An array of hat states, or `NULL` if the joystick is not present

- *  or an [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.

- *

- *  @pointer_lifetime The returned array is allocated and freed by GLFW.  You

- *  should not free it yourself.  It is valid until the specified joystick is

- *  disconnected, this function is called again for that joystick or the library

- *  is terminated.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref joystick_hat

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup input

- */

-GLFWAPI const unsigned char* glfwGetJoystickHats(int jid, int* count);

-

-/*! @brief Returns the name of the specified joystick.

- *

- *  This function returns the name, encoded as UTF-8, of the specified joystick.

- *  The returned string is allocated and freed by GLFW.  You should not free it

- *  yourself.

- *

- *  If the specified joystick is not present this function will return `NULL`

- *  but will not generate an error.  This can be used instead of first calling

- *  @ref glfwJoystickPresent.

- *

- *  @param[in] jid The [joystick](@ref joysticks) to query.

- *  @return The UTF-8 encoded name of the joystick, or `NULL` if the joystick

- *  is not present or an [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.

- *

- *  @pointer_lifetime The returned string is allocated and freed by GLFW.  You

- *  should not free it yourself.  It is valid until the specified joystick is

- *  disconnected or the library is terminated.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref joystick_name

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup input

- */

-GLFWAPI const char* glfwGetJoystickName(int jid);

-

-/*! @brief Returns the SDL comaptible GUID of the specified joystick.

- *

- *  This function returns the SDL compatible GUID, as a UTF-8 encoded

- *  hexadecimal string, of the specified joystick.  The returned string is

- *  allocated and freed by GLFW.  You should not free it yourself.

- *

- *  The GUID is what connects a joystick to a gamepad mapping.  A connected

- *  joystick will always have a GUID even if there is no gamepad mapping

- *  assigned to it.

- *

- *  If the specified joystick is not present this function will return `NULL`

- *  but will not generate an error.  This can be used instead of first calling

- *  @ref glfwJoystickPresent.

- *

- *  The GUID uses the format introduced in SDL 2.0.5.  This GUID tries to

- *  uniquely identify the make and model of a joystick but does not identify

- *  a specific unit, e.g. all wired Xbox 360 controllers will have the same

- *  GUID on that platform.  The GUID for a unit may vary between platforms

- *  depending on what hardware information the platform specific APIs provide.

- *

- *  @param[in] jid The [joystick](@ref joysticks) to query.

- *  @return The UTF-8 encoded GUID of the joystick, or `NULL` if the joystick

- *  is not present or an [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.

- *

- *  @pointer_lifetime The returned string is allocated and freed by GLFW.  You

- *  should not free it yourself.  It is valid until the specified joystick is

- *  disconnected or the library is terminated.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref gamepad

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup input

- */

-GLFWAPI const char* glfwGetJoystickGUID(int jid);

-

-/*! @brief Sets the user pointer of the specified joystick.

- *

- *  This function sets the user-defined pointer of the specified joystick.  The

- *  current value is retained until the joystick is disconnected.  The initial

- *  value is `NULL`.

- *

- *  This function may be called from the joystick callback, even for a joystick

- *  that is being disconnected.

- *

- *  @param[in] jid The joystick whose pointer to set.

- *  @param[in] pointer The new value.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @sa @ref joystick_userptr

- *  @sa @ref glfwGetJoystickUserPointer

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup input

- */

-GLFWAPI void glfwSetJoystickUserPointer(int jid, void* pointer);

-

-/*! @brief Returns the user pointer of the specified joystick.

- *

- *  This function returns the current value of the user-defined pointer of the

- *  specified joystick.  The initial value is `NULL`.

- *

- *  This function may be called from the joystick callback, even for a joystick

- *  that is being disconnected.

- *

- *  @param[in] jid The joystick whose pointer to return.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @sa @ref joystick_userptr

- *  @sa @ref glfwSetJoystickUserPointer

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup input

- */

-GLFWAPI void* glfwGetJoystickUserPointer(int jid);

-

-/*! @brief Returns whether the specified joystick has a gamepad mapping.

- *

- *  This function returns whether the specified joystick is both present and has

- *  a gamepad mapping.

- *

- *  If the specified joystick is present but does not have a gamepad mapping

- *  this function will return `GLFW_FALSE` but will not generate an error.  Call

- *  @ref glfwJoystickPresent to check if a joystick is present regardless of

- *  whether it has a mapping.

- *

- *  @param[in] jid The [joystick](@ref joysticks) to query.

- *  @return `GLFW_TRUE` if a joystick is both present and has a gamepad mapping,

- *  or `GLFW_FALSE` otherwise.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_INVALID_ENUM.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref gamepad

- *  @sa @ref glfwGetGamepadState

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup input

- */

-GLFWAPI int glfwJoystickIsGamepad(int jid);

-

-/*! @brief Sets the joystick configuration callback.

- *

- *  This function sets the joystick configuration callback, or removes the

- *  currently set callback.  This is called when a joystick is connected to or

- *  disconnected from the system.

- *

- *  For joystick connection and disconnection events to be delivered on all

- *  platforms, you need to call one of the [event processing](@ref events)

- *  functions.  Joystick disconnection may also be detected and the callback

- *  called by joystick functions.  The function will then return whatever it

- *  returns if the joystick is not present.

- *

- *  @param[in] cbfun The new callback, or `NULL` to remove the currently set

- *  callback.

- *  @return The previously set callback, or `NULL` if no callback was set or the

- *  library had not been [initialized](@ref intro_init).

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref joystick_event

- *

- *  @since Added in version 3.2.

- *

- *  @ingroup input

- */

-GLFWAPI GLFWjoystickfun glfwSetJoystickCallback(GLFWjoystickfun cbfun);

-

-/*! @brief Adds the specified SDL_GameControllerDB gamepad mappings.

- *

- *  This function parses the specified ASCII encoded string and updates the

- *  internal list with any gamepad mappings it finds.  This string may

- *  contain either a single gamepad mapping or many mappings separated by

- *  newlines.  The parser supports the full format of the `gamecontrollerdb.txt`

- *  source file including empty lines and comments.

- *

- *  See @ref gamepad_mapping for a description of the format.

- *

- *  If there is already a gamepad mapping for a given GUID in the internal list,

- *  it will be replaced by the one passed to this function.  If the library is

- *  terminated and re-initialized the internal list will revert to the built-in

- *  default.

- *

- *  @param[in] string The string containing the gamepad mappings.

- *  @return `GLFW_TRUE` if successful, or `GLFW_FALSE` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_INVALID_VALUE.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref gamepad

- *  @sa @ref glfwJoystickIsGamepad

- *  @sa @ref glfwGetGamepadName

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup input

- */

-GLFWAPI int glfwUpdateGamepadMappings(const char* string);

-

-/*! @brief Returns the human-readable gamepad name for the specified joystick.

- *

- *  This function returns the human-readable name of the gamepad from the

- *  gamepad mapping assigned to the specified joystick.

- *

- *  If the specified joystick is not present or does not have a gamepad mapping

- *  this function will return `NULL` but will not generate an error.  Call

- *  @ref glfwJoystickPresent to check whether it is present regardless of

- *  whether it has a mapping.

- *

- *  @param[in] jid The [joystick](@ref joysticks) to query.

- *  @return The UTF-8 encoded name of the gamepad, or `NULL` if the

- *  joystick is not present, does not have a mapping or an

- *  [error](@ref error_handling) occurred.

- *

- *  @pointer_lifetime The returned string is allocated and freed by GLFW.  You

- *  should not free it yourself.  It is valid until the specified joystick is

- *  disconnected, the gamepad mappings are updated or the library is terminated.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref gamepad

- *  @sa @ref glfwJoystickIsGamepad

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup input

- */

-GLFWAPI const char* glfwGetGamepadName(int jid);

-

-/*! @brief Retrieves the state of the specified joystick remapped as a gamepad.

- *

- *  This function retrives the state of the specified joystick remapped to

- *  an Xbox-like gamepad.

- *

- *  If the specified joystick is not present or does not have a gamepad mapping

- *  this function will return `GLFW_FALSE` but will not generate an error.  Call

- *  @ref glfwJoystickPresent to check whether it is present regardless of

- *  whether it has a mapping.

- *

- *  The Guide button may not be available for input as it is often hooked by the

- *  system or the Steam client.

- *

- *  Not all devices have all the buttons or axes provided by @ref

- *  GLFWgamepadstate.  Unavailable buttons and axes will always report

- *  `GLFW_RELEASE` and 0.0 respectively.

- *

- *  @param[in] jid The [joystick](@ref joysticks) to query.

- *  @param[out] state The gamepad input state of the joystick.

- *  @return `GLFW_TRUE` if successful, or `GLFW_FALSE` if no joystick is

- *  connected, it has no gamepad mapping or an [error](@ref error_handling)

- *  occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_INVALID_ENUM.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref gamepad

- *  @sa @ref glfwUpdateGamepadMappings

- *  @sa @ref glfwJoystickIsGamepad

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup input

- */

-GLFWAPI int glfwGetGamepadState(int jid, GLFWgamepadstate* state);

-

-/*! @brief Sets the clipboard to the specified string.

- *

- *  This function sets the system clipboard to the specified, UTF-8 encoded

- *  string.

- *

- *  @param[in] window Deprecated.  Any valid window or `NULL`.

- *  @param[in] string A UTF-8 encoded string.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @remark @wayland Clipboard is currently unimplemented.

- *

- *  @pointer_lifetime The specified string is copied before this function

- *  returns.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref clipboard

- *  @sa @ref glfwGetClipboardString

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup input

- */

-GLFWAPI void glfwSetClipboardString(GLFWwindow* window, const char* string);

-

-/*! @brief Returns the contents of the clipboard as a string.

- *

- *  This function returns the contents of the system clipboard, if it contains

- *  or is convertible to a UTF-8 encoded string.  If the clipboard is empty or

- *  if its contents cannot be converted, `NULL` is returned and a @ref

- *  GLFW_FORMAT_UNAVAILABLE error is generated.

- *

- *  @param[in] window Deprecated.  Any valid window or `NULL`.

- *  @return The contents of the clipboard as a UTF-8 encoded string, or `NULL`

- *  if an [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @remark @wayland Clipboard is currently unimplemented.

- *

- *  @pointer_lifetime The returned string is allocated and freed by GLFW.  You

- *  should not free it yourself.  It is valid until the next call to @ref

- *  glfwGetClipboardString or @ref glfwSetClipboardString, or until the library

- *  is terminated.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref clipboard

- *  @sa @ref glfwSetClipboardString

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup input

- */

-GLFWAPI const char* glfwGetClipboardString(GLFWwindow* window);

-

-/*! @brief Returns the value of the GLFW timer.

- *

- *  This function returns the value of the GLFW timer.  Unless the timer has

- *  been set using @ref glfwSetTime, the timer measures time elapsed since GLFW

- *  was initialized.

- *

- *  The resolution of the timer is system dependent, but is usually on the order

- *  of a few micro- or nanoseconds.  It uses the highest-resolution monotonic

- *  time source on each supported platform.

- *

- *  @return The current value, in seconds, or zero if an

- *  [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function may be called from any thread.  Reading and

- *  writing of the internal timer offset is not atomic, so it needs to be

- *  externally synchronized with calls to @ref glfwSetTime.

- *

- *  @sa @ref time

- *

- *  @since Added in version 1.0.

- *

- *  @ingroup input

- */

-GLFWAPI double glfwGetTime(void);

-

-/*! @brief Sets the GLFW timer.

- *

- *  This function sets the value of the GLFW timer.  It then continues to count

- *  up from that value.  The value must be a positive finite number less than

- *  or equal to 18446744073.0, which is approximately 584.5 years.

- *

- *  @param[in] time The new value, in seconds.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_INVALID_VALUE.

- *

- *  @remark The upper limit of the timer is calculated as

- *  floor((2<sup>64</sup> - 1) / 10<sup>9</sup>) and is due to implementations

- *  storing nanoseconds in 64 bits.  The limit may be increased in the future.

- *

- *  @thread_safety This function may be called from any thread.  Reading and

- *  writing of the internal timer offset is not atomic, so it needs to be

- *  externally synchronized with calls to @ref glfwGetTime.

- *

- *  @sa @ref time

- *

- *  @since Added in version 2.2.

- *

- *  @ingroup input

- */

-GLFWAPI void glfwSetTime(double time);

-

-/*! @brief Returns the current value of the raw timer.

- *

- *  This function returns the current value of the raw timer, measured in

- *  1&nbsp;/&nbsp;frequency seconds.  To get the frequency, call @ref

- *  glfwGetTimerFrequency.

- *

- *  @return The value of the timer, or zero if an

- *  [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function may be called from any thread.

- *

- *  @sa @ref time

- *  @sa @ref glfwGetTimerFrequency

- *

- *  @since Added in version 3.2.

- *

- *  @ingroup input

- */

-GLFWAPI uint64_t glfwGetTimerValue(void);

-

-/*! @brief Returns the frequency, in Hz, of the raw timer.

- *

- *  This function returns the frequency, in Hz, of the raw timer.

- *

- *  @return The frequency of the timer, in Hz, or zero if an

- *  [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function may be called from any thread.

- *

- *  @sa @ref time

- *  @sa @ref glfwGetTimerValue

- *

- *  @since Added in version 3.2.

- *

- *  @ingroup input

- */

-GLFWAPI uint64_t glfwGetTimerFrequency(void);

-

-/*! @brief Makes the context of the specified window current for the calling

- *  thread.

- *

- *  This function makes the OpenGL or OpenGL ES context of the specified window

- *  current on the calling thread.  A context must only be made current on

- *  a single thread at a time and each thread can have only a single current

- *  context at a time.

- *

- *  When moving a context between threads, you must make it non-current on the

- *  old thread before making it current on the new one.

- *

- *  By default, making a context non-current implicitly forces a pipeline flush.

- *  On machines that support `GL_KHR_context_flush_control`, you can control

- *  whether a context performs this flush by setting the

- *  [GLFW_CONTEXT_RELEASE_BEHAVIOR](@ref GLFW_CONTEXT_RELEASE_BEHAVIOR_hint)

- *  hint.

- *

- *  The specified window must have an OpenGL or OpenGL ES context.  Specifying

- *  a window without a context will generate a @ref GLFW_NO_WINDOW_CONTEXT

- *  error.

- *

- *  @param[in] window The window whose context to make current, or `NULL` to

- *  detach the current context.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_NO_WINDOW_CONTEXT and @ref GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function may be called from any thread.

- *

- *  @sa @ref context_current

- *  @sa @ref glfwGetCurrentContext

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup context

- */

-GLFWAPI void glfwMakeContextCurrent(GLFWwindow* window);

-

-/*! @brief Returns the window whose context is current on the calling thread.

- *

- *  This function returns the window whose OpenGL or OpenGL ES context is

- *  current on the calling thread.

- *

- *  @return The window whose context is current, or `NULL` if no window's

- *  context is current.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function may be called from any thread.

- *

- *  @sa @ref context_current

- *  @sa @ref glfwMakeContextCurrent

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup context

- */

-GLFWAPI GLFWwindow* glfwGetCurrentContext(void);

-

-/*! @brief Swaps the front and back buffers of the specified window.

- *

- *  This function swaps the front and back buffers of the specified window when

- *  rendering with OpenGL or OpenGL ES.  If the swap interval is greater than

- *  zero, the GPU driver waits the specified number of screen updates before

- *  swapping the buffers.

- *

- *  The specified window must have an OpenGL or OpenGL ES context.  Specifying

- *  a window without a context will generate a @ref GLFW_NO_WINDOW_CONTEXT

- *  error.

- *

- *  This function does not apply to Vulkan.  If you are rendering with Vulkan,

- *  see `vkQueuePresentKHR` instead.

- *

- *  @param[in] window The window whose buffers to swap.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_NO_WINDOW_CONTEXT and @ref GLFW_PLATFORM_ERROR.

- *

- *  @remark __EGL:__ The context of the specified window must be current on the

- *  calling thread.

- *

- *  @thread_safety This function may be called from any thread.

- *

- *  @sa @ref buffer_swap

- *  @sa @ref glfwSwapInterval

- *

- *  @since Added in version 1.0.

- *  @glfw3 Added window handle parameter.

- *

- *  @ingroup window

- */

-GLFWAPI void glfwSwapBuffers(GLFWwindow* window);

-

-/*! @brief Sets the swap interval for the current context.

- *

- *  This function sets the swap interval for the current OpenGL or OpenGL ES

- *  context, i.e. the number of screen updates to wait from the time @ref

- *  glfwSwapBuffers was called before swapping the buffers and returning.  This

- *  is sometimes called _vertical synchronization_, _vertical retrace

- *  synchronization_ or just _vsync_.

- *

- *  A context that supports either of the `WGL_EXT_swap_control_tear` and

- *  `GLX_EXT_swap_control_tear` extensions also accepts _negative_ swap

- *  intervals, which allows the driver to swap immediately even if a frame

- *  arrives a little bit late.  You can check for these extensions with @ref

- *  glfwExtensionSupported.

- *

- *  A context must be current on the calling thread.  Calling this function

- *  without a current context will cause a @ref GLFW_NO_CURRENT_CONTEXT error.

- *

- *  This function does not apply to Vulkan.  If you are rendering with Vulkan,

- *  see the present mode of your swapchain instead.

- *

- *  @param[in] interval The minimum number of screen updates to wait for

- *  until the buffers are swapped by @ref glfwSwapBuffers.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_NO_CURRENT_CONTEXT and @ref GLFW_PLATFORM_ERROR.

- *

- *  @remark This function is not called during context creation, leaving the

- *  swap interval set to whatever is the default on that platform.  This is done

- *  because some swap interval extensions used by GLFW do not allow the swap

- *  interval to be reset to zero once it has been set to a non-zero value.

- *

- *  @remark Some GPU drivers do not honor the requested swap interval, either

- *  because of a user setting that overrides the application's request or due to

- *  bugs in the driver.

- *

- *  @thread_safety This function may be called from any thread.

- *

- *  @sa @ref buffer_swap

- *  @sa @ref glfwSwapBuffers

- *

- *  @since Added in version 1.0.

- *

- *  @ingroup context

- */

-GLFWAPI void glfwSwapInterval(int interval);

-

-/*! @brief Returns whether the specified extension is available.

- *

- *  This function returns whether the specified

- *  [API extension](@ref context_glext) is supported by the current OpenGL or

- *  OpenGL ES context.  It searches both for client API extension and context

- *  creation API extensions.

- *

- *  A context must be current on the calling thread.  Calling this function

- *  without a current context will cause a @ref GLFW_NO_CURRENT_CONTEXT error.

- *

- *  As this functions retrieves and searches one or more extension strings each

- *  call, it is recommended that you cache its results if it is going to be used

- *  frequently.  The extension strings will not change during the lifetime of

- *  a context, so there is no danger in doing this.

- *

- *  This function does not apply to Vulkan.  If you are using Vulkan, see @ref

- *  glfwGetRequiredInstanceExtensions, `vkEnumerateInstanceExtensionProperties`

- *  and `vkEnumerateDeviceExtensionProperties` instead.

- *

- *  @param[in] extension The ASCII encoded name of the extension.

- *  @return `GLFW_TRUE` if the extension is available, or `GLFW_FALSE`

- *  otherwise.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_NO_CURRENT_CONTEXT, @ref GLFW_INVALID_VALUE and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @thread_safety This function may be called from any thread.

- *

- *  @sa @ref context_glext

- *  @sa @ref glfwGetProcAddress

- *

- *  @since Added in version 1.0.

- *

- *  @ingroup context

- */

-GLFWAPI int glfwExtensionSupported(const char* extension);

-

-/*! @brief Returns the address of the specified function for the current

- *  context.

- *

- *  This function returns the address of the specified OpenGL or OpenGL ES

- *  [core or extension function](@ref context_glext), if it is supported

- *  by the current context.

- *

- *  A context must be current on the calling thread.  Calling this function

- *  without a current context will cause a @ref GLFW_NO_CURRENT_CONTEXT error.

- *

- *  This function does not apply to Vulkan.  If you are rendering with Vulkan,

- *  see @ref glfwGetInstanceProcAddress, `vkGetInstanceProcAddr` and

- *  `vkGetDeviceProcAddr` instead.

- *

- *  @param[in] procname The ASCII encoded name of the function.

- *  @return The address of the function, or `NULL` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_NO_CURRENT_CONTEXT and @ref GLFW_PLATFORM_ERROR.

- *

- *  @remark The address of a given function is not guaranteed to be the same

- *  between contexts.

- *

- *  @remark This function may return a non-`NULL` address despite the

- *  associated version or extension not being available.  Always check the

- *  context version or extension string first.

- *

- *  @pointer_lifetime The returned function pointer is valid until the context

- *  is destroyed or the library is terminated.

- *

- *  @thread_safety This function may be called from any thread.

- *

- *  @sa @ref context_glext

- *  @sa @ref glfwExtensionSupported

- *

- *  @since Added in version 1.0.

- *

- *  @ingroup context

- */

-GLFWAPI GLFWglproc glfwGetProcAddress(const char* procname);

-

-/*! @brief Returns whether the Vulkan loader and an ICD have been found.

- *

- *  This function returns whether the Vulkan loader and any minimally functional

- *  ICD have been found.

- *

- *  The availability of a Vulkan loader and even an ICD does not by itself

- *  guarantee that surface creation or even instance creation is possible.

- *  For example, on Fermi systems Nvidia will install an ICD that provides no

- *  actual Vulkan support.  Call @ref glfwGetRequiredInstanceExtensions to check

- *  whether the extensions necessary for Vulkan surface creation are available

- *  and @ref glfwGetPhysicalDevicePresentationSupport to check whether a queue

- *  family of a physical device supports image presentation.

- *

- *  @return `GLFW_TRUE` if Vulkan is minimally available, or `GLFW_FALSE`

- *  otherwise.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.

- *

- *  @thread_safety This function may be called from any thread.

- *

- *  @sa @ref vulkan_support

- *

- *  @since Added in version 3.2.

- *

- *  @ingroup vulkan

- */

-GLFWAPI int glfwVulkanSupported(void);

-

-/*! @brief Returns the Vulkan instance extensions required by GLFW.

- *

- *  This function returns an array of names of Vulkan instance extensions required

- *  by GLFW for creating Vulkan surfaces for GLFW windows.  If successful, the

- *  list will always contains `VK_KHR_surface`, so if you don't require any

- *  additional extensions you can pass this list directly to the

- *  `VkInstanceCreateInfo` struct.

- *

- *  If Vulkan is not available on the machine, this function returns `NULL` and

- *  generates a @ref GLFW_API_UNAVAILABLE error.  Call @ref glfwVulkanSupported

- *  to check whether Vulkan is at least minimally available.

- *

- *  If Vulkan is available but no set of extensions allowing window surface

- *  creation was found, this function returns `NULL`.  You may still use Vulkan

- *  for off-screen rendering and compute work.

- *

- *  @param[out] count Where to store the number of extensions in the returned

- *  array.  This is set to zero if an error occurred.

- *  @return An array of ASCII encoded extension names, or `NULL` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_API_UNAVAILABLE.

- *

- *  @remark Additional extensions may be required by future versions of GLFW.

- *  You should check if any extensions you wish to enable are already in the

- *  returned array, as it is an error to specify an extension more than once in

- *  the `VkInstanceCreateInfo` struct.

- *

- *  @remark @macos This function currently only supports the

- *  `VK_MVK_macos_surface` extension from MoltenVK.

- *

- *  @pointer_lifetime The returned array is allocated and freed by GLFW.  You

- *  should not free it yourself.  It is guaranteed to be valid only until the

- *  library is terminated.

- *

- *  @thread_safety This function may be called from any thread.

- *

- *  @sa @ref vulkan_ext

- *  @sa @ref glfwCreateWindowSurface

- *

- *  @since Added in version 3.2.

- *

- *  @ingroup vulkan

- */

-GLFWAPI const char** glfwGetRequiredInstanceExtensions(uint32_t* count);

-

-#if defined(VK_VERSION_1_0)

-

-/*! @brief Returns the address of the specified Vulkan instance function.

- *

- *  This function returns the address of the specified Vulkan core or extension

- *  function for the specified instance.  If instance is set to `NULL` it can

- *  return any function exported from the Vulkan loader, including at least the

- *  following functions:

- *

- *  - `vkEnumerateInstanceExtensionProperties`

- *  - `vkEnumerateInstanceLayerProperties`

- *  - `vkCreateInstance`

- *  - `vkGetInstanceProcAddr`

- *

- *  If Vulkan is not available on the machine, this function returns `NULL` and

- *  generates a @ref GLFW_API_UNAVAILABLE error.  Call @ref glfwVulkanSupported

- *  to check whether Vulkan is at least minimally available.

- *

- *  This function is equivalent to calling `vkGetInstanceProcAddr` with

- *  a platform-specific query of the Vulkan loader as a fallback.

- *

- *  @param[in] instance The Vulkan instance to query, or `NULL` to retrieve

- *  functions related to instance creation.

- *  @param[in] procname The ASCII encoded name of the function.

- *  @return The address of the function, or `NULL` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_API_UNAVAILABLE.

- *

- *  @pointer_lifetime The returned function pointer is valid until the library

- *  is terminated.

- *

- *  @thread_safety This function may be called from any thread.

- *

- *  @sa @ref vulkan_proc

- *

- *  @since Added in version 3.2.

- *

- *  @ingroup vulkan

- */

-GLFWAPI GLFWvkproc glfwGetInstanceProcAddress(VkInstance instance, const char* procname);

-

-/*! @brief Returns whether the specified queue family can present images.

- *

- *  This function returns whether the specified queue family of the specified

- *  physical device supports presentation to the platform GLFW was built for.

- *

- *  If Vulkan or the required window surface creation instance extensions are

- *  not available on the machine, or if the specified instance was not created

- *  with the required extensions, this function returns `GLFW_FALSE` and

- *  generates a @ref GLFW_API_UNAVAILABLE error.  Call @ref glfwVulkanSupported

- *  to check whether Vulkan is at least minimally available and @ref

- *  glfwGetRequiredInstanceExtensions to check what instance extensions are

- *  required.

- *

- *  @param[in] instance The instance that the physical device belongs to.

- *  @param[in] device The physical device that the queue family belongs to.

- *  @param[in] queuefamily The index of the queue family to query.

- *  @return `GLFW_TRUE` if the queue family supports presentation, or

- *  `GLFW_FALSE` otherwise.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_API_UNAVAILABLE and @ref GLFW_PLATFORM_ERROR.

- *

- *  @remark @macos This function currently always returns `GLFW_TRUE`, as the

- *  `VK_MVK_macos_surface` extension does not provide

- *  a `vkGetPhysicalDevice*PresentationSupport` type function.

- *

- *  @thread_safety This function may be called from any thread.  For

- *  synchronization details of Vulkan objects, see the Vulkan specification.

- *

- *  @sa @ref vulkan_present

- *

- *  @since Added in version 3.2.

- *

- *  @ingroup vulkan

- */

-GLFWAPI int glfwGetPhysicalDevicePresentationSupport(VkInstance instance, VkPhysicalDevice device, uint32_t queuefamily);

-

-/*! @brief Creates a Vulkan surface for the specified window.

- *

- *  This function creates a Vulkan surface for the specified window.

- *

- *  If the Vulkan loader or at least one minimally functional ICD were not found,

- *  this function returns `VK_ERROR_INITIALIZATION_FAILED` and generates a @ref

- *  GLFW_API_UNAVAILABLE error.  Call @ref glfwVulkanSupported to check whether

- *  Vulkan is at least minimally available.

- *

- *  If the required window surface creation instance extensions are not

- *  available or if the specified instance was not created with these extensions

- *  enabled, this function returns `VK_ERROR_EXTENSION_NOT_PRESENT` and

- *  generates a @ref GLFW_API_UNAVAILABLE error.  Call @ref

- *  glfwGetRequiredInstanceExtensions to check what instance extensions are

- *  required.

- *

- *  The window surface cannot be shared with another API so the window must

- *  have been created with the [client api hint](@ref GLFW_CLIENT_API_attrib)

- *  set to `GLFW_NO_API` otherwise it generates a @ref GLFW_INVALID_VALUE error

- *  and returns `VK_ERROR_NATIVE_WINDOW_IN_USE_KHR`.

- *

- *  The window surface must be destroyed before the specified Vulkan instance.

- *  It is the responsibility of the caller to destroy the window surface.  GLFW

- *  does not destroy it for you.  Call `vkDestroySurfaceKHR` to destroy the

- *  surface.

- *

- *  @param[in] instance The Vulkan instance to create the surface in.

- *  @param[in] window The window to create the surface for.

- *  @param[in] allocator The allocator to use, or `NULL` to use the default

- *  allocator.

- *  @param[out] surface Where to store the handle of the surface.  This is set

- *  to `VK_NULL_HANDLE` if an error occurred.

- *  @return `VK_SUCCESS` if successful, or a Vulkan error code if an

- *  [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref

- *  GLFW_API_UNAVAILABLE, @ref GLFW_PLATFORM_ERROR and @ref GLFW_INVALID_VALUE

- *

- *  @remark If an error occurs before the creation call is made, GLFW returns

- *  the Vulkan error code most appropriate for the error.  Appropriate use of

- *  @ref glfwVulkanSupported and @ref glfwGetRequiredInstanceExtensions should

- *  eliminate almost all occurrences of these errors.

- *

- *  @remark @macos This function currently only supports the

- *  `VK_MVK_macos_surface` extension from MoltenVK.

- *

- *  @remark @macos This function creates and sets a `CAMetalLayer` instance for

- *  the window content view, which is required for MoltenVK to function.

- *

- *  @thread_safety This function may be called from any thread.  For

- *  synchronization details of Vulkan objects, see the Vulkan specification.

- *

- *  @sa @ref vulkan_surface

- *  @sa @ref glfwGetRequiredInstanceExtensions

- *

- *  @since Added in version 3.2.

- *

- *  @ingroup vulkan

- */

-GLFWAPI VkResult glfwCreateWindowSurface(VkInstance instance, GLFWwindow* window, const VkAllocationCallbacks* allocator, VkSurfaceKHR* surface);

-

-#endif /*VK_VERSION_1_0*/

-

-

-/*************************************************************************

- * Global definition cleanup

- *************************************************************************/

-

-/* ------------------- BEGIN SYSTEM/COMPILER SPECIFIC -------------------- */

-

-#ifdef GLFW_WINGDIAPI_DEFINED

- #undef WINGDIAPI

- #undef GLFW_WINGDIAPI_DEFINED

-#endif

-

-#ifdef GLFW_CALLBACK_DEFINED

- #undef CALLBACK

- #undef GLFW_CALLBACK_DEFINED

-#endif

-

-/* Some OpenGL related headers need GLAPIENTRY, but it is unconditionally

- * defined by some gl.h variants (OpenBSD) so define it after if needed.

- */

-#ifndef GLAPIENTRY

- #define GLAPIENTRY APIENTRY

-#endif

-

-/* -------------------- END SYSTEM/COMPILER SPECIFIC --------------------- */

-

-

-#ifdef __cplusplus

-}

-#endif

-

-#endif /* _glfw3_h_ */

-

+/*************************************************************************
+ * GLFW 3.3 - www.glfw.org
+ * A library for OpenGL, window and input
+ *------------------------------------------------------------------------
+ * Copyright (c) 2002-2006 Marcus Geelnard
+ * Copyright (c) 2006-2016 Camilla Löwy <elmindreda@glfw.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.
+ *
+ *************************************************************************/
+
+#ifndef _glfw3_h_
+#define _glfw3_h_
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+
+/*************************************************************************
+ * Doxygen documentation
+ *************************************************************************/
+
+/*! @file glfw3.h
+ *  @brief The header of the GLFW 3 API.
+ *
+ *  This is the header file of the GLFW 3 API.  It defines all its types and
+ *  declares all its functions.
+ *
+ *  For more information about how to use this file, see @ref build_include.
+ */
+/*! @defgroup context Context reference
+ *  @brief Functions and types related to OpenGL and OpenGL ES contexts.
+ *
+ *  This is the reference documentation for OpenGL and OpenGL ES context related
+ *  functions.  For more task-oriented information, see the @ref context_guide.
+ */
+/*! @defgroup vulkan Vulkan reference
+ *  @brief Functions and types related to Vulkan.
+ *
+ *  This is the reference documentation for Vulkan related functions and types.
+ *  For more task-oriented information, see the @ref vulkan_guide.
+ */
+/*! @defgroup init Initialization, version and error reference
+ *  @brief Functions and types related to initialization and error handling.
+ *
+ *  This is the reference documentation for initialization and termination of
+ *  the library, version management and error handling.  For more task-oriented
+ *  information, see the @ref intro_guide.
+ */
+/*! @defgroup input Input reference
+ *  @brief Functions and types related to input handling.
+ *
+ *  This is the reference documentation for input related functions and types.
+ *  For more task-oriented information, see the @ref input_guide.
+ */
+/*! @defgroup monitor Monitor reference
+ *  @brief Functions and types related to monitors.
+ *
+ *  This is the reference documentation for monitor related functions and types.
+ *  For more task-oriented information, see the @ref monitor_guide.
+ */
+/*! @defgroup window Window reference
+ *  @brief Functions and types related to windows.
+ *
+ *  This is the reference documentation for window related functions and types,
+ *  including creation, deletion and event polling.  For more task-oriented
+ *  information, see the @ref window_guide.
+ */
+
+
+/*************************************************************************
+ * Compiler- and platform-specific preprocessor work
+ *************************************************************************/
+
+/* If we are we on Windows, we want a single define for it.
+ */
+#if !defined(_WIN32) && (defined(__WIN32__) || defined(WIN32) || defined(__MINGW32__))
+ #define _WIN32
+#endif /* _WIN32 */
+
+/* It is customary to use APIENTRY for OpenGL function pointer declarations on
+ * all platforms.  Additionally, the Windows OpenGL header needs APIENTRY.
+ */
+#ifndef APIENTRY
+ #ifdef _WIN32
+  #define APIENTRY __stdcall
+ #else
+  #define APIENTRY
+ #endif
+ #define GLFW_APIENTRY_DEFINED
+#endif /* APIENTRY */
+
+/* Some Windows OpenGL headers need this.
+ */
+#if !defined(WINGDIAPI) && defined(_WIN32)
+ #define WINGDIAPI __declspec(dllimport)
+ #define GLFW_WINGDIAPI_DEFINED
+#endif /* WINGDIAPI */
+
+/* Some Windows GLU headers need this.
+ */
+#if !defined(CALLBACK) && defined(_WIN32)
+ #define CALLBACK __stdcall
+ #define GLFW_CALLBACK_DEFINED
+#endif /* CALLBACK */
+
+/* Include because most Windows GLU headers need wchar_t and
+ * the macOS OpenGL header blocks the definition of ptrdiff_t by glext.h.
+ * Include it unconditionally to avoid surprising side-effects.
+ */
+#include <stddef.h>
+
+/* Include because it is needed by Vulkan and related functions.
+ * Include it unconditionally to avoid surprising side-effects.
+ */
+#include <stdint.h>
+
+/* Include the chosen OpenGL or OpenGL ES headers.
+ */
+#if defined(GLFW_INCLUDE_ES1)
+
+ #include <GLES/gl.h>
+ #if defined(GLFW_INCLUDE_GLEXT)
+  #include <GLES/glext.h>
+ #endif
+
+#elif defined(GLFW_INCLUDE_ES2)
+
+ #include <GLES2/gl2.h>
+ #if defined(GLFW_INCLUDE_GLEXT)
+  #include <GLES2/gl2ext.h>
+ #endif
+
+#elif defined(GLFW_INCLUDE_ES3)
+
+ #include <GLES3/gl3.h>
+ #if defined(GLFW_INCLUDE_GLEXT)
+  #include <GLES2/gl2ext.h>
+ #endif
+
+#elif defined(GLFW_INCLUDE_ES31)
+
+ #include <GLES3/gl31.h>
+ #if defined(GLFW_INCLUDE_GLEXT)
+  #include <GLES2/gl2ext.h>
+ #endif
+
+#elif defined(GLFW_INCLUDE_ES32)
+
+ #include <GLES3/gl32.h>
+ #if defined(GLFW_INCLUDE_GLEXT)
+  #include <GLES2/gl2ext.h>
+ #endif
+
+#elif defined(GLFW_INCLUDE_GLCOREARB)
+
+ #if defined(__APPLE__)
+
+  #include <OpenGL/gl3.h>
+  #if defined(GLFW_INCLUDE_GLEXT)
+   #include <OpenGL/gl3ext.h>
+  #endif /*GLFW_INCLUDE_GLEXT*/
+
+ #else /*__APPLE__*/
+
+  #include <GL/glcorearb.h>
+
+ #endif /*__APPLE__*/
+
+#elif !defined(GLFW_INCLUDE_NONE)
+
+ #if defined(__APPLE__)
+
+  #if !defined(GLFW_INCLUDE_GLEXT)
+   #define GL_GLEXT_LEGACY
+  #endif
+  #include <OpenGL/gl.h>
+  #if defined(GLFW_INCLUDE_GLU)
+   #include <OpenGL/glu.h>
+  #endif
+
+ #else /*__APPLE__*/
+
+  #include <GL/gl.h>
+  #if defined(GLFW_INCLUDE_GLEXT)
+   #include <GL/glext.h>
+  #endif
+  #if defined(GLFW_INCLUDE_GLU)
+   #include <GL/glu.h>
+  #endif
+
+ #endif /*__APPLE__*/
+
+#endif /* OpenGL and OpenGL ES headers */
+
+#if defined(GLFW_INCLUDE_VULKAN)
+  #include <vulkan/vulkan.h>
+#endif /* Vulkan header */
+
+#if defined(GLFW_DLL) && defined(_GLFW_BUILD_DLL)
+ /* GLFW_DLL must be defined by applications that are linking against the DLL
+  * version of the GLFW library.  _GLFW_BUILD_DLL is defined by the GLFW
+  * configuration header when compiling the DLL version of the library.
+  */
+ #error "You must not have both GLFW_DLL and _GLFW_BUILD_DLL defined"
+#endif
+
+/* GLFWAPI is used to declare public API functions for export
+ * from the DLL / shared library / dynamic library.
+ */
+#if defined(_WIN32) && defined(_GLFW_BUILD_DLL)
+ /* We are building GLFW as a Win32 DLL */
+ #define GLFWAPI __declspec(dllexport)
+#elif defined(_WIN32) && defined(GLFW_DLL)
+ /* We are calling GLFW as a Win32 DLL */
+ #define GLFWAPI __declspec(dllimport)
+#elif defined(__GNUC__) && defined(_GLFW_BUILD_DLL)
+ /* We are building GLFW as a shared / dynamic library */
+ #define GLFWAPI __attribute__((visibility("default")))
+#else
+ /* We are building or calling GLFW as a static library */
+ #define GLFWAPI
+#endif
+
+
+/*************************************************************************
+ * GLFW API tokens
+ *************************************************************************/
+
+/*! @name GLFW version macros
+ *  @{ */
+/*! @brief The major version number of the GLFW library.
+ *
+ *  This is incremented when the API is changed in non-compatible ways.
+ *  @ingroup init
+ */
+#define GLFW_VERSION_MAJOR          3
+/*! @brief The minor version number of the GLFW library.
+ *
+ *  This is incremented when features are added to the API but it remains
+ *  backward-compatible.
+ *  @ingroup init
+ */
+#define GLFW_VERSION_MINOR          3
+/*! @brief The revision number of the GLFW library.
+ *
+ *  This is incremented when a bug fix release is made that does not contain any
+ *  API changes.
+ *  @ingroup init
+ */
+#define GLFW_VERSION_REVISION       0
+/*! @} */
+
+/*! @name Boolean values
+ *  @{ */
+/*! @brief One.
+ *
+ *  One.  Seriously.  You don't _need_ to use this symbol in your code.  It's
+ *  semantic sugar for the number 1.  You can also use `1` or `true` or `_True`
+ *  or `GL_TRUE` or whatever you want.
+ */
+#define GLFW_TRUE                   1
+/*! @brief Zero.
+ *
+ *  Zero.  Seriously.  You don't _need_ to use this symbol in your code.  It's
+ *  semantic sugar for the number 0.  You can also use `0` or `false` or
+ *  `_False` or `GL_FALSE` or whatever you want.
+ */
+#define GLFW_FALSE                  0
+/*! @} */
+
+/*! @name Key and button actions
+ *  @{ */
+/*! @brief The key or mouse button was released.
+ *
+ *  The key or mouse button was released.
+ *
+ *  @ingroup input
+ */
+#define GLFW_RELEASE                0
+/*! @brief The key or mouse button was pressed.
+ *
+ *  The key or mouse button was pressed.
+ *
+ *  @ingroup input
+ */
+#define GLFW_PRESS                  1
+/*! @brief The key was held down until it repeated.
+ *
+ *  The key was held down until it repeated.
+ *
+ *  @ingroup input
+ */
+#define GLFW_REPEAT                 2
+/*! @} */
+
+/*! @defgroup hat_state Joystick hat states
+ *
+ *  See [joystick hat input](@ref joystick_hat) for how these are used.
+ *
+ *  @ingroup input
+ *  @{ */
+#define GLFW_HAT_CENTERED           0
+#define GLFW_HAT_UP                 1
+#define GLFW_HAT_RIGHT              2
+#define GLFW_HAT_DOWN               4
+#define GLFW_HAT_LEFT               8
+#define GLFW_HAT_RIGHT_UP           (GLFW_HAT_RIGHT | GLFW_HAT_UP)
+#define GLFW_HAT_RIGHT_DOWN         (GLFW_HAT_RIGHT | GLFW_HAT_DOWN)
+#define GLFW_HAT_LEFT_UP            (GLFW_HAT_LEFT  | GLFW_HAT_UP)
+#define GLFW_HAT_LEFT_DOWN          (GLFW_HAT_LEFT  | GLFW_HAT_DOWN)
+/*! @} */
+
+/*! @defgroup keys Keyboard keys
+ *  @brief Keyboard key IDs.
+ *
+ *  See [key input](@ref input_key) for how these are used.
+ *
+ *  These key codes are inspired by the _USB HID Usage Tables v1.12_ (p. 53-60),
+ *  but re-arranged to map to 7-bit ASCII for printable keys (function keys are
+ *  put in the 256+ range).
+ *
+ *  The naming of the key codes follow these rules:
+ *   - The US keyboard layout is used
+ *   - Names of printable alpha-numeric characters are used (e.g. "A", "R",
+ *     "3", etc.)
+ *   - For non-alphanumeric characters, Unicode:ish names are used (e.g.
+ *     "COMMA", "LEFT_SQUARE_BRACKET", etc.). Note that some names do not
+ *     correspond to the Unicode standard (usually for brevity)
+ *   - Keys that lack a clear US mapping are named "WORLD_x"
+ *   - For non-printable keys, custom names are used (e.g. "F4",
+ *     "BACKSPACE", etc.)
+ *
+ *  @ingroup input
+ *  @{
+ */
+
+/* The unknown key */
+#define GLFW_KEY_UNKNOWN            -1
+
+/* Printable keys */
+#define GLFW_KEY_SPACE              32
+#define GLFW_KEY_APOSTROPHE         39  /* ' */
+#define GLFW_KEY_COMMA              44  /* , */
+#define GLFW_KEY_MINUS              45  /* - */
+#define GLFW_KEY_PERIOD             46  /* . */
+#define GLFW_KEY_SLASH              47  /* / */
+#define GLFW_KEY_0                  48
+#define GLFW_KEY_1                  49
+#define GLFW_KEY_2                  50
+#define GLFW_KEY_3                  51
+#define GLFW_KEY_4                  52
+#define GLFW_KEY_5                  53
+#define GLFW_KEY_6                  54
+#define GLFW_KEY_7                  55
+#define GLFW_KEY_8                  56
+#define GLFW_KEY_9                  57
+#define GLFW_KEY_SEMICOLON          59  /* ; */
+#define GLFW_KEY_EQUAL              61  /* = */
+#define GLFW_KEY_A                  65
+#define GLFW_KEY_B                  66
+#define GLFW_KEY_C                  67
+#define GLFW_KEY_D                  68
+#define GLFW_KEY_E                  69
+#define GLFW_KEY_F                  70
+#define GLFW_KEY_G                  71
+#define GLFW_KEY_H                  72
+#define GLFW_KEY_I                  73
+#define GLFW_KEY_J                  74
+#define GLFW_KEY_K                  75
+#define GLFW_KEY_L                  76
+#define GLFW_KEY_M                  77
+#define GLFW_KEY_N                  78
+#define GLFW_KEY_O                  79
+#define GLFW_KEY_P                  80
+#define GLFW_KEY_Q                  81
+#define GLFW_KEY_R                  82
+#define GLFW_KEY_S                  83
+#define GLFW_KEY_T                  84
+#define GLFW_KEY_U                  85
+#define GLFW_KEY_V                  86
+#define GLFW_KEY_W                  87
+#define GLFW_KEY_X                  88
+#define GLFW_KEY_Y                  89
+#define GLFW_KEY_Z                  90
+#define GLFW_KEY_LEFT_BRACKET       91  /* [ */
+#define GLFW_KEY_BACKSLASH          92  /* \ */
+#define GLFW_KEY_RIGHT_BRACKET      93  /* ] */
+#define GLFW_KEY_GRAVE_ACCENT       96  /* ` */
+#define GLFW_KEY_WORLD_1            161 /* non-US #1 */
+#define GLFW_KEY_WORLD_2            162 /* non-US #2 */
+
+/* Function keys */
+#define GLFW_KEY_ESCAPE             256
+#define GLFW_KEY_ENTER              257
+#define GLFW_KEY_TAB                258
+#define GLFW_KEY_BACKSPACE          259
+#define GLFW_KEY_INSERT             260
+#define GLFW_KEY_DELETE             261
+#define GLFW_KEY_RIGHT              262
+#define GLFW_KEY_LEFT               263
+#define GLFW_KEY_DOWN               264
+#define GLFW_KEY_UP                 265
+#define GLFW_KEY_PAGE_UP            266
+#define GLFW_KEY_PAGE_DOWN          267
+#define GLFW_KEY_HOME               268
+#define GLFW_KEY_END                269
+#define GLFW_KEY_CAPS_LOCK          280
+#define GLFW_KEY_SCROLL_LOCK        281
+#define GLFW_KEY_NUM_LOCK           282
+#define GLFW_KEY_PRINT_SCREEN       283
+#define GLFW_KEY_PAUSE              284
+#define GLFW_KEY_F1                 290
+#define GLFW_KEY_F2                 291
+#define GLFW_KEY_F3                 292
+#define GLFW_KEY_F4                 293
+#define GLFW_KEY_F5                 294
+#define GLFW_KEY_F6                 295
+#define GLFW_KEY_F7                 296
+#define GLFW_KEY_F8                 297
+#define GLFW_KEY_F9                 298
+#define GLFW_KEY_F10                299
+#define GLFW_KEY_F11                300
+#define GLFW_KEY_F12                301
+#define GLFW_KEY_F13                302
+#define GLFW_KEY_F14                303
+#define GLFW_KEY_F15                304
+#define GLFW_KEY_F16                305
+#define GLFW_KEY_F17                306
+#define GLFW_KEY_F18                307
+#define GLFW_KEY_F19                308
+#define GLFW_KEY_F20                309
+#define GLFW_KEY_F21                310
+#define GLFW_KEY_F22                311
+#define GLFW_KEY_F23                312
+#define GLFW_KEY_F24                313
+#define GLFW_KEY_F25                314
+#define GLFW_KEY_KP_0               320
+#define GLFW_KEY_KP_1               321
+#define GLFW_KEY_KP_2               322
+#define GLFW_KEY_KP_3               323
+#define GLFW_KEY_KP_4               324
+#define GLFW_KEY_KP_5               325
+#define GLFW_KEY_KP_6               326
+#define GLFW_KEY_KP_7               327
+#define GLFW_KEY_KP_8               328
+#define GLFW_KEY_KP_9               329
+#define GLFW_KEY_KP_DECIMAL         330
+#define GLFW_KEY_KP_DIVIDE          331
+#define GLFW_KEY_KP_MULTIPLY        332
+#define GLFW_KEY_KP_SUBTRACT        333
+#define GLFW_KEY_KP_ADD             334
+#define GLFW_KEY_KP_ENTER           335
+#define GLFW_KEY_KP_EQUAL           336
+#define GLFW_KEY_LEFT_SHIFT         340
+#define GLFW_KEY_LEFT_CONTROL       341
+#define GLFW_KEY_LEFT_ALT           342
+#define GLFW_KEY_LEFT_SUPER         343
+#define GLFW_KEY_RIGHT_SHIFT        344
+#define GLFW_KEY_RIGHT_CONTROL      345
+#define GLFW_KEY_RIGHT_ALT          346
+#define GLFW_KEY_RIGHT_SUPER        347
+#define GLFW_KEY_MENU               348
+
+#define GLFW_KEY_LAST               GLFW_KEY_MENU
+
+/*! @} */
+
+/*! @defgroup mods Modifier key flags
+ *  @brief Modifier key flags.
+ *
+ *  See [key input](@ref input_key) for how these are used.
+ *
+ *  @ingroup input
+ *  @{ */
+
+/*! @brief If this bit is set one or more Shift keys were held down.
+ *
+ *  If this bit is set one or more Shift keys were held down.
+ */
+#define GLFW_MOD_SHIFT           0x0001
+/*! @brief If this bit is set one or more Control keys were held down.
+ *
+ *  If this bit is set one or more Control keys were held down.
+ */
+#define GLFW_MOD_CONTROL         0x0002
+/*! @brief If this bit is set one or more Alt keys were held down.
+ *
+ *  If this bit is set one or more Alt keys were held down.
+ */
+#define GLFW_MOD_ALT             0x0004
+/*! @brief If this bit is set one or more Super keys were held down.
+ *
+ *  If this bit is set one or more Super keys were held down.
+ */
+#define GLFW_MOD_SUPER           0x0008
+/*! @brief If this bit is set the Caps Lock key is enabled.
+ *
+ *  If this bit is set the Caps Lock key is enabled and the @ref
+ *  GLFW_LOCK_KEY_MODS input mode is set.
+ */
+#define GLFW_MOD_CAPS_LOCK       0x0010
+/*! @brief If this bit is set the Num Lock key is enabled.
+ *
+ *  If this bit is set the Num Lock key is enabled and the @ref
+ *  GLFW_LOCK_KEY_MODS input mode is set.
+ */
+#define GLFW_MOD_NUM_LOCK        0x0020
+
+/*! @} */
+
+/*! @defgroup buttons Mouse buttons
+ *  @brief Mouse button IDs.
+ *
+ *  See [mouse button input](@ref input_mouse_button) for how these are used.
+ *
+ *  @ingroup input
+ *  @{ */
+#define GLFW_MOUSE_BUTTON_1         0
+#define GLFW_MOUSE_BUTTON_2         1
+#define GLFW_MOUSE_BUTTON_3         2
+#define GLFW_MOUSE_BUTTON_4         3
+#define GLFW_MOUSE_BUTTON_5         4
+#define GLFW_MOUSE_BUTTON_6         5
+#define GLFW_MOUSE_BUTTON_7         6
+#define GLFW_MOUSE_BUTTON_8         7
+#define GLFW_MOUSE_BUTTON_LAST      GLFW_MOUSE_BUTTON_8
+#define GLFW_MOUSE_BUTTON_LEFT      GLFW_MOUSE_BUTTON_1
+#define GLFW_MOUSE_BUTTON_RIGHT     GLFW_MOUSE_BUTTON_2
+#define GLFW_MOUSE_BUTTON_MIDDLE    GLFW_MOUSE_BUTTON_3
+/*! @} */
+
+/*! @defgroup joysticks Joysticks
+ *  @brief Joystick IDs.
+ *
+ *  See [joystick input](@ref joystick) for how these are used.
+ *
+ *  @ingroup input
+ *  @{ */
+#define GLFW_JOYSTICK_1             0
+#define GLFW_JOYSTICK_2             1
+#define GLFW_JOYSTICK_3             2
+#define GLFW_JOYSTICK_4             3
+#define GLFW_JOYSTICK_5             4
+#define GLFW_JOYSTICK_6             5
+#define GLFW_JOYSTICK_7             6
+#define GLFW_JOYSTICK_8             7
+#define GLFW_JOYSTICK_9             8
+#define GLFW_JOYSTICK_10            9
+#define GLFW_JOYSTICK_11            10
+#define GLFW_JOYSTICK_12            11
+#define GLFW_JOYSTICK_13            12
+#define GLFW_JOYSTICK_14            13
+#define GLFW_JOYSTICK_15            14
+#define GLFW_JOYSTICK_16            15
+#define GLFW_JOYSTICK_LAST          GLFW_JOYSTICK_16
+/*! @} */
+
+/*! @defgroup gamepad_buttons Gamepad buttons
+ *  @brief Gamepad buttons.
+ *
+ *  See @ref gamepad for how these are used.
+ *
+ *  @ingroup input
+ *  @{ */
+#define GLFW_GAMEPAD_BUTTON_A               0
+#define GLFW_GAMEPAD_BUTTON_B               1
+#define GLFW_GAMEPAD_BUTTON_X               2
+#define GLFW_GAMEPAD_BUTTON_Y               3
+#define GLFW_GAMEPAD_BUTTON_LEFT_BUMPER     4
+#define GLFW_GAMEPAD_BUTTON_RIGHT_BUMPER    5
+#define GLFW_GAMEPAD_BUTTON_BACK            6
+#define GLFW_GAMEPAD_BUTTON_START           7
+#define GLFW_GAMEPAD_BUTTON_GUIDE           8
+#define GLFW_GAMEPAD_BUTTON_LEFT_THUMB      9
+#define GLFW_GAMEPAD_BUTTON_RIGHT_THUMB     10
+#define GLFW_GAMEPAD_BUTTON_DPAD_UP         11
+#define GLFW_GAMEPAD_BUTTON_DPAD_RIGHT      12
+#define GLFW_GAMEPAD_BUTTON_DPAD_DOWN       13
+#define GLFW_GAMEPAD_BUTTON_DPAD_LEFT       14
+#define GLFW_GAMEPAD_BUTTON_LAST            GLFW_GAMEPAD_BUTTON_DPAD_LEFT
+
+#define GLFW_GAMEPAD_BUTTON_CROSS       GLFW_GAMEPAD_BUTTON_A
+#define GLFW_GAMEPAD_BUTTON_CIRCLE      GLFW_GAMEPAD_BUTTON_B
+#define GLFW_GAMEPAD_BUTTON_SQUARE      GLFW_GAMEPAD_BUTTON_X
+#define GLFW_GAMEPAD_BUTTON_TRIANGLE    GLFW_GAMEPAD_BUTTON_Y
+/*! @} */
+
+/*! @defgroup gamepad_axes Gamepad axes
+ *  @brief Gamepad axes.
+ *
+ *  See @ref gamepad for how these are used.
+ *
+ *  @ingroup input
+ *  @{ */
+#define GLFW_GAMEPAD_AXIS_LEFT_X        0
+#define GLFW_GAMEPAD_AXIS_LEFT_Y        1
+#define GLFW_GAMEPAD_AXIS_RIGHT_X       2
+#define GLFW_GAMEPAD_AXIS_RIGHT_Y       3
+#define GLFW_GAMEPAD_AXIS_LEFT_TRIGGER  4
+#define GLFW_GAMEPAD_AXIS_RIGHT_TRIGGER 5
+#define GLFW_GAMEPAD_AXIS_LAST          GLFW_GAMEPAD_AXIS_RIGHT_TRIGGER
+/*! @} */
+
+/*! @defgroup errors Error codes
+ *  @brief Error codes.
+ *
+ *  See [error handling](@ref error_handling) for how these are used.
+ *
+ *  @ingroup init
+ *  @{ */
+/*! @brief No error has occurred.
+ *
+ *  No error has occurred.
+ *
+ *  @analysis Yay.
+ */
+#define GLFW_NO_ERROR               0
+/*! @brief GLFW has not been initialized.
+ *
+ *  This occurs if a GLFW function was called that must not be called unless the
+ *  library is [initialized](@ref intro_init).
+ *
+ *  @analysis Application programmer error.  Initialize GLFW before calling any
+ *  function that requires initialization.
+ */
+#define GLFW_NOT_INITIALIZED        0x00010001
+/*! @brief No context is current for this thread.
+ *
+ *  This occurs if a GLFW function was called that needs and operates on the
+ *  current OpenGL or OpenGL ES context but no context is current on the calling
+ *  thread.  One such function is @ref glfwSwapInterval.
+ *
+ *  @analysis Application programmer error.  Ensure a context is current before
+ *  calling functions that require a current context.
+ */
+#define GLFW_NO_CURRENT_CONTEXT     0x00010002
+/*! @brief One of the arguments to the function was an invalid enum value.
+ *
+ *  One of the arguments to the function was an invalid enum value, for example
+ *  requesting @ref GLFW_RED_BITS with @ref glfwGetWindowAttrib.
+ *
+ *  @analysis Application programmer error.  Fix the offending call.
+ */
+#define GLFW_INVALID_ENUM           0x00010003
+/*! @brief One of the arguments to the function was an invalid value.
+ *
+ *  One of the arguments to the function was an invalid value, for example
+ *  requesting a non-existent OpenGL or OpenGL ES version like 2.7.
+ *
+ *  Requesting a valid but unavailable OpenGL or OpenGL ES version will instead
+ *  result in a @ref GLFW_VERSION_UNAVAILABLE error.
+ *
+ *  @analysis Application programmer error.  Fix the offending call.
+ */
+#define GLFW_INVALID_VALUE          0x00010004
+/*! @brief A memory allocation failed.
+ *
+ *  A memory allocation failed.
+ *
+ *  @analysis A bug in GLFW or the underlying operating system.  Report the bug
+ *  to our [issue tracker](https://github.com/glfw/glfw/issues).
+ */
+#define GLFW_OUT_OF_MEMORY          0x00010005
+/*! @brief GLFW could not find support for the requested API on the system.
+ *
+ *  GLFW could not find support for the requested API on the system.
+ *
+ *  @analysis The installed graphics driver does not support the requested
+ *  API, or does not support it via the chosen context creation backend.
+ *  Below are a few examples.
+ *
+ *  @par
+ *  Some pre-installed Windows graphics drivers do not support OpenGL.  AMD only
+ *  supports OpenGL ES via EGL, while Nvidia and Intel only support it via
+ *  a WGL or GLX extension.  macOS does not provide OpenGL ES at all.  The Mesa
+ *  EGL, OpenGL and OpenGL ES libraries do not interface with the Nvidia binary
+ *  driver.  Older graphics drivers do not support Vulkan.
+ */
+#define GLFW_API_UNAVAILABLE        0x00010006
+/*! @brief The requested OpenGL or OpenGL ES version is not available.
+ *
+ *  The requested OpenGL or OpenGL ES version (including any requested context
+ *  or framebuffer hints) is not available on this machine.
+ *
+ *  @analysis The machine does not support your requirements.  If your
+ *  application is sufficiently flexible, downgrade your requirements and try
+ *  again.  Otherwise, inform the user that their machine does not match your
+ *  requirements.
+ *
+ *  @par
+ *  Future invalid OpenGL and OpenGL ES versions, for example OpenGL 4.8 if 5.0
+ *  comes out before the 4.x series gets that far, also fail with this error and
+ *  not @ref GLFW_INVALID_VALUE, because GLFW cannot know what future versions
+ *  will exist.
+ */
+#define GLFW_VERSION_UNAVAILABLE    0x00010007
+/*! @brief A platform-specific error occurred that does not match any of the
+ *  more specific categories.
+ *
+ *  A platform-specific error occurred that does not match any of the more
+ *  specific categories.
+ *
+ *  @analysis A bug or configuration error in GLFW, the underlying operating
+ *  system or its drivers, or a lack of required resources.  Report the issue to
+ *  our [issue tracker](https://github.com/glfw/glfw/issues).
+ */
+#define GLFW_PLATFORM_ERROR         0x00010008
+/*! @brief The requested format is not supported or available.
+ *
+ *  If emitted during window creation, the requested pixel format is not
+ *  supported.
+ *
+ *  If emitted when querying the clipboard, the contents of the clipboard could
+ *  not be converted to the requested format.
+ *
+ *  @analysis If emitted during window creation, one or more
+ *  [hard constraints](@ref window_hints_hard) did not match any of the
+ *  available pixel formats.  If your application is sufficiently flexible,
+ *  downgrade your requirements and try again.  Otherwise, inform the user that
+ *  their machine does not match your requirements.
+ *
+ *  @par
+ *  If emitted when querying the clipboard, ignore the error or report it to
+ *  the user, as appropriate.
+ */
+#define GLFW_FORMAT_UNAVAILABLE     0x00010009
+/*! @brief The specified window does not have an OpenGL or OpenGL ES context.
+ *
+ *  A window that does not have an OpenGL or OpenGL ES context was passed to
+ *  a function that requires it to have one.
+ *
+ *  @analysis Application programmer error.  Fix the offending call.
+ */
+#define GLFW_NO_WINDOW_CONTEXT      0x0001000A
+/*! @} */
+
+/*! @addtogroup window
+ *  @{ */
+/*! @brief Input focus window hint and attribute
+ *
+ *  Input focus [window hint](@ref GLFW_FOCUSED_hint) or
+ *  [window attribute](@ref GLFW_FOCUSED_attrib).
+ */
+#define GLFW_FOCUSED                0x00020001
+/*! @brief Window iconification window attribute
+ *
+ *  Window iconification [window attribute](@ref GLFW_ICONIFIED_attrib).
+ */
+#define GLFW_ICONIFIED              0x00020002
+/*! @brief Window resize-ability window hint and attribute
+ *
+ *  Window resize-ability [window hint](@ref GLFW_RESIZABLE_hint) and
+ *  [window attribute](@ref GLFW_RESIZABLE_attrib).
+ */
+#define GLFW_RESIZABLE              0x00020003
+/*! @brief Window visibility window hint and attribute
+ *
+ *  Window visibility [window hint](@ref GLFW_VISIBLE_hint) and
+ *  [window attribute](@ref GLFW_VISIBLE_attrib).
+ */
+#define GLFW_VISIBLE                0x00020004
+/*! @brief Window decoration window hint and attribute
+ *
+ *  Window decoration [window hint](@ref GLFW_DECORATED_hint) and
+ *  [window attribute](@ref GLFW_DECORATED_attrib).
+ */
+#define GLFW_DECORATED              0x00020005
+/*! @brief Window auto-iconification window hint and attribute
+ *
+ *  Window auto-iconification [window hint](@ref GLFW_AUTO_ICONIFY_hint) and
+ *  [window attribute](@ref GLFW_AUTO_ICONIFY_attrib).
+ */
+#define GLFW_AUTO_ICONIFY           0x00020006
+/*! @brief Window decoration window hint and attribute
+ *
+ *  Window decoration [window hint](@ref GLFW_FLOATING_hint) and
+ *  [window attribute](@ref GLFW_FLOATING_attrib).
+ */
+#define GLFW_FLOATING               0x00020007
+/*! @brief Window maximization window hint and attribute
+ *
+ *  Window maximization [window hint](@ref GLFW_MAXIMIZED_hint) and
+ *  [window attribute](@ref GLFW_MAXIMIZED_attrib).
+ */
+#define GLFW_MAXIMIZED              0x00020008
+/*! @brief Cursor centering window hint
+ *
+ *  Cursor centering [window hint](@ref GLFW_CENTER_CURSOR_hint).
+ */
+#define GLFW_CENTER_CURSOR          0x00020009
+/*! @brief Window framebuffer transparency hint and attribute
+ *
+ *  Window framebuffer transparency
+ *  [window hint](@ref GLFW_TRANSPARENT_FRAMEBUFFER_hint) and
+ *  [window attribute](@ref GLFW_TRANSPARENT_FRAMEBUFFER_attrib).
+ */
+#define GLFW_TRANSPARENT_FRAMEBUFFER 0x0002000A
+/*! @brief Mouse cursor hover window attribute.
+ *
+ *  Mouse cursor hover [window attribute](@ref GLFW_HOVERED_attrib).
+ */
+#define GLFW_HOVERED                0x0002000B
+/*! @brief Input focus on calling show window hint and attribute
+ *
+ *  Input focus [window hint](@ref GLFW_FOCUS_ON_SHOW_hint) or
+ *  [window attribute](@ref GLFW_FOCUS_ON_SHOW_attrib).
+ */
+#define GLFW_FOCUS_ON_SHOW          0x0002000C
+
+/*! @brief Framebuffer bit depth hint.
+ *
+ *  Framebuffer bit depth [hint](@ref GLFW_RED_BITS).
+ */
+#define GLFW_RED_BITS               0x00021001
+/*! @brief Framebuffer bit depth hint.
+ *
+ *  Framebuffer bit depth [hint](@ref GLFW_GREEN_BITS).
+ */
+#define GLFW_GREEN_BITS             0x00021002
+/*! @brief Framebuffer bit depth hint.
+ *
+ *  Framebuffer bit depth [hint](@ref GLFW_BLUE_BITS).
+ */
+#define GLFW_BLUE_BITS              0x00021003
+/*! @brief Framebuffer bit depth hint.
+ *
+ *  Framebuffer bit depth [hint](@ref GLFW_ALPHA_BITS).
+ */
+#define GLFW_ALPHA_BITS             0x00021004
+/*! @brief Framebuffer bit depth hint.
+ *
+ *  Framebuffer bit depth [hint](@ref GLFW_DEPTH_BITS).
+ */
+#define GLFW_DEPTH_BITS             0x00021005
+/*! @brief Framebuffer bit depth hint.
+ *
+ *  Framebuffer bit depth [hint](@ref GLFW_STENCIL_BITS).
+ */
+#define GLFW_STENCIL_BITS           0x00021006
+/*! @brief Framebuffer bit depth hint.
+ *
+ *  Framebuffer bit depth [hint](@ref GLFW_ACCUM_RED_BITS).
+ */
+#define GLFW_ACCUM_RED_BITS         0x00021007
+/*! @brief Framebuffer bit depth hint.
+ *
+ *  Framebuffer bit depth [hint](@ref GLFW_ACCUM_GREEN_BITS).
+ */
+#define GLFW_ACCUM_GREEN_BITS       0x00021008
+/*! @brief Framebuffer bit depth hint.
+ *
+ *  Framebuffer bit depth [hint](@ref GLFW_ACCUM_BLUE_BITS).
+ */
+#define GLFW_ACCUM_BLUE_BITS        0x00021009
+/*! @brief Framebuffer bit depth hint.
+ *
+ *  Framebuffer bit depth [hint](@ref GLFW_ACCUM_ALPHA_BITS).
+ */
+#define GLFW_ACCUM_ALPHA_BITS       0x0002100A
+/*! @brief Framebuffer auxiliary buffer hint.
+ *
+ *  Framebuffer auxiliary buffer [hint](@ref GLFW_AUX_BUFFERS).
+ */
+#define GLFW_AUX_BUFFERS            0x0002100B
+/*! @brief OpenGL stereoscopic rendering hint.
+ *
+ *  OpenGL stereoscopic rendering [hint](@ref GLFW_STEREO).
+ */
+#define GLFW_STEREO                 0x0002100C
+/*! @brief Framebuffer MSAA samples hint.
+ *
+ *  Framebuffer MSAA samples [hint](@ref GLFW_SAMPLES).
+ */
+#define GLFW_SAMPLES                0x0002100D
+/*! @brief Framebuffer sRGB hint.
+ *
+ *  Framebuffer sRGB [hint](@ref GLFW_SRGB_CAPABLE).
+ */
+#define GLFW_SRGB_CAPABLE           0x0002100E
+/*! @brief Monitor refresh rate hint.
+ *
+ *  Monitor refresh rate [hint](@ref GLFW_REFRESH_RATE).
+ */
+#define GLFW_REFRESH_RATE           0x0002100F
+/*! @brief Framebuffer double buffering hint.
+ *
+ *  Framebuffer double buffering [hint](@ref GLFW_DOUBLEBUFFER).
+ */
+#define GLFW_DOUBLEBUFFER           0x00021010
+
+/*! @brief Context client API hint and attribute.
+ *
+ *  Context client API [hint](@ref GLFW_CLIENT_API_hint) and
+ *  [attribute](@ref GLFW_CLIENT_API_attrib).
+ */
+#define GLFW_CLIENT_API             0x00022001
+/*! @brief Context client API major version hint and attribute.
+ *
+ *  Context client API major version [hint](@ref GLFW_CLIENT_API_hint) and
+ *  [attribute](@ref GLFW_CLIENT_API_attrib).
+ */
+#define GLFW_CONTEXT_VERSION_MAJOR  0x00022002
+/*! @brief Context client API minor version hint and attribute.
+ *
+ *  Context client API minor version [hint](@ref GLFW_CLIENT_API_hint) and
+ *  [attribute](@ref GLFW_CLIENT_API_attrib).
+ */
+#define GLFW_CONTEXT_VERSION_MINOR  0x00022003
+/*! @brief Context client API revision number hint and attribute.
+ *
+ *  Context client API revision number [hint](@ref GLFW_CLIENT_API_hint) and
+ *  [attribute](@ref GLFW_CLIENT_API_attrib).
+ */
+#define GLFW_CONTEXT_REVISION       0x00022004
+/*! @brief Context robustness hint and attribute.
+ *
+ *  Context client API revision number [hint](@ref GLFW_CLIENT_API_hint) and
+ *  [attribute](@ref GLFW_CLIENT_API_attrib).
+ */
+#define GLFW_CONTEXT_ROBUSTNESS     0x00022005
+/*! @brief OpenGL forward-compatibility hint and attribute.
+ *
+ *  OpenGL forward-compatibility [hint](@ref GLFW_CLIENT_API_hint) and
+ *  [attribute](@ref GLFW_CLIENT_API_attrib).
+ */
+#define GLFW_OPENGL_FORWARD_COMPAT  0x00022006
+/*! @brief OpenGL debug context hint and attribute.
+ *
+ *  OpenGL debug context [hint](@ref GLFW_CLIENT_API_hint) and
+ *  [attribute](@ref GLFW_CLIENT_API_attrib).
+ */
+#define GLFW_OPENGL_DEBUG_CONTEXT   0x00022007
+/*! @brief OpenGL profile hint and attribute.
+ *
+ *  OpenGL profile [hint](@ref GLFW_CLIENT_API_hint) and
+ *  [attribute](@ref GLFW_CLIENT_API_attrib).
+ */
+#define GLFW_OPENGL_PROFILE         0x00022008
+/*! @brief Context flush-on-release hint and attribute.
+ *
+ *  Context flush-on-release [hint](@ref GLFW_CLIENT_API_hint) and
+ *  [attribute](@ref GLFW_CLIENT_API_attrib).
+ */
+#define GLFW_CONTEXT_RELEASE_BEHAVIOR 0x00022009
+/*! @brief Context error suppression hint and attribute.
+ *
+ *  Context error suppression [hint](@ref GLFW_CLIENT_API_hint) and
+ *  [attribute](@ref GLFW_CLIENT_API_attrib).
+ */
+#define GLFW_CONTEXT_NO_ERROR       0x0002200A
+/*! @brief Context creation API hint and attribute.
+ *
+ *  Context creation API [hint](@ref GLFW_CLIENT_API_hint) and
+ *  [attribute](@ref GLFW_CLIENT_API_attrib).
+ */
+#define GLFW_CONTEXT_CREATION_API   0x0002200B
+/*! @brief Window content area scaling window
+ *  [window hint](@ref GLFW_SCALE_TO_MONITOR).
+ */
+#define GLFW_SCALE_TO_MONITOR       0x0002200C
+
+#define GLFW_COCOA_RETINA_FRAMEBUFFER 0x00023001
+#define GLFW_COCOA_FRAME_NAME         0x00023002
+#define GLFW_COCOA_GRAPHICS_SWITCHING 0x00023003
+
+#define GLFW_X11_CLASS_NAME         0x00024001
+#define GLFW_X11_INSTANCE_NAME      0x00024002
+/*! @} */
+
+#define GLFW_NO_API                          0
+#define GLFW_OPENGL_API             0x00030001
+#define GLFW_OPENGL_ES_API          0x00030002
+
+#define GLFW_NO_ROBUSTNESS                   0
+#define GLFW_NO_RESET_NOTIFICATION  0x00031001
+#define GLFW_LOSE_CONTEXT_ON_RESET  0x00031002
+
+#define GLFW_OPENGL_ANY_PROFILE              0
+#define GLFW_OPENGL_CORE_PROFILE    0x00032001
+#define GLFW_OPENGL_COMPAT_PROFILE  0x00032002
+
+#define GLFW_CURSOR                 0x00033001
+#define GLFW_STICKY_KEYS            0x00033002
+#define GLFW_STICKY_MOUSE_BUTTONS   0x00033003
+#define GLFW_LOCK_KEY_MODS          0x00033004
+
+#define GLFW_CURSOR_NORMAL          0x00034001
+#define GLFW_CURSOR_HIDDEN          0x00034002
+#define GLFW_CURSOR_DISABLED        0x00034003
+
+#define GLFW_ANY_RELEASE_BEHAVIOR            0
+#define GLFW_RELEASE_BEHAVIOR_FLUSH 0x00035001
+#define GLFW_RELEASE_BEHAVIOR_NONE  0x00035002
+
+#define GLFW_NATIVE_CONTEXT_API     0x00036001
+#define GLFW_EGL_CONTEXT_API        0x00036002
+#define GLFW_OSMESA_CONTEXT_API     0x00036003
+
+/*! @defgroup shapes Standard cursor shapes
+ *  @brief Standard system cursor shapes.
+ *
+ *  See [standard cursor creation](@ref cursor_standard) for how these are used.
+ *
+ *  @ingroup input
+ *  @{ */
+
+/*! @brief The regular arrow cursor shape.
+ *
+ *  The regular arrow cursor.
+ */
+#define GLFW_ARROW_CURSOR           0x00036001
+/*! @brief The text input I-beam cursor shape.
+ *
+ *  The text input I-beam cursor shape.
+ */
+#define GLFW_IBEAM_CURSOR           0x00036002
+/*! @brief The crosshair shape.
+ *
+ *  The crosshair shape.
+ */
+#define GLFW_CROSSHAIR_CURSOR       0x00036003
+/*! @brief The hand shape.
+ *
+ *  The hand shape.
+ */
+#define GLFW_HAND_CURSOR            0x00036004
+/*! @brief The horizontal resize arrow shape.
+ *
+ *  The horizontal resize arrow shape.
+ */
+#define GLFW_HRESIZE_CURSOR         0x00036005
+/*! @brief The vertical resize arrow shape.
+ *
+ *  The vertical resize arrow shape.
+ */
+#define GLFW_VRESIZE_CURSOR         0x00036006
+/*! @} */
+
+#define GLFW_CONNECTED              0x00040001
+#define GLFW_DISCONNECTED           0x00040002
+
+/*! @addtogroup init
+ *  @{ */
+#define GLFW_JOYSTICK_HAT_BUTTONS   0x00050001
+
+#define GLFW_COCOA_CHDIR_RESOURCES  0x00051001
+#define GLFW_COCOA_MENUBAR          0x00051002
+/*! @} */
+
+#define GLFW_DONT_CARE              -1
+
+
+/*************************************************************************
+ * GLFW API types
+ *************************************************************************/
+
+/*! @brief Client API function pointer type.
+ *
+ *  Generic function pointer used for returning client API function pointers
+ *  without forcing a cast from a regular pointer.
+ *
+ *  @sa @ref context_glext
+ *  @sa @ref glfwGetProcAddress
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup context
+ */
+typedef void (*GLFWglproc)(void);
+
+/*! @brief Vulkan API function pointer type.
+ *
+ *  Generic function pointer used for returning Vulkan API function pointers
+ *  without forcing a cast from a regular pointer.
+ *
+ *  @sa @ref vulkan_proc
+ *  @sa @ref glfwGetInstanceProcAddress
+ *
+ *  @since Added in version 3.2.
+ *
+ *  @ingroup vulkan
+ */
+typedef void (*GLFWvkproc)(void);
+
+/*! @brief Opaque monitor object.
+ *
+ *  Opaque monitor object.
+ *
+ *  @see @ref monitor_object
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup monitor
+ */
+typedef struct GLFWmonitor GLFWmonitor;
+
+/*! @brief Opaque window object.
+ *
+ *  Opaque window object.
+ *
+ *  @see @ref window_object
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup window
+ */
+typedef struct GLFWwindow GLFWwindow;
+
+/*! @brief Opaque cursor object.
+ *
+ *  Opaque cursor object.
+ *
+ *  @see @ref cursor_object
+ *
+ *  @since Added in version 3.1.
+ *
+ *  @ingroup cursor
+ */
+typedef struct GLFWcursor GLFWcursor;
+
+/*! @brief The function signature for error callbacks.
+ *
+ *  This is the function signature for error callback functions.
+ *
+ *  @param[in] error An [error code](@ref errors).
+ *  @param[in] description A UTF-8 encoded string describing the error.
+ *
+ *  @sa @ref error_handling
+ *  @sa @ref glfwSetErrorCallback
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup init
+ */
+typedef void (* GLFWerrorfun)(int,const char*);
+
+/*! @brief The function signature for window position callbacks.
+ *
+ *  This is the function signature for window position callback functions.
+ *
+ *  @param[in] window The window that was moved.
+ *  @param[in] xpos The new x-coordinate, in screen coordinates, of the
+ *  upper-left corner of the client area of the window.
+ *  @param[in] ypos The new y-coordinate, in screen coordinates, of the
+ *  upper-left corner of the client area of the window.
+ *
+ *  @sa @ref window_pos
+ *  @sa @ref glfwSetWindowPosCallback
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup window
+ */
+typedef void (* GLFWwindowposfun)(GLFWwindow*,int,int);
+
+/*! @brief The function signature for window resize callbacks.
+ *
+ *  This is the function signature for window size callback functions.
+ *
+ *  @param[in] window The window that was resized.
+ *  @param[in] width The new width, in screen coordinates, of the window.
+ *  @param[in] height The new height, in screen coordinates, of the window.
+ *
+ *  @sa @ref window_size
+ *  @sa @ref glfwSetWindowSizeCallback
+ *
+ *  @since Added in version 1.0.
+ *  @glfw3 Added window handle parameter.
+ *
+ *  @ingroup window
+ */
+typedef void (* GLFWwindowsizefun)(GLFWwindow*,int,int);
+
+/*! @brief The function signature for window close callbacks.
+ *
+ *  This is the function signature for window close callback functions.
+ *
+ *  @param[in] window The window that the user attempted to close.
+ *
+ *  @sa @ref window_close
+ *  @sa @ref glfwSetWindowCloseCallback
+ *
+ *  @since Added in version 2.5.
+ *  @glfw3 Added window handle parameter.
+ *
+ *  @ingroup window
+ */
+typedef void (* GLFWwindowclosefun)(GLFWwindow*);
+
+/*! @brief The function signature for window content refresh callbacks.
+ *
+ *  This is the function signature for window refresh callback functions.
+ *
+ *  @param[in] window The window whose content needs to be refreshed.
+ *
+ *  @sa @ref window_refresh
+ *  @sa @ref glfwSetWindowRefreshCallback
+ *
+ *  @since Added in version 2.5.
+ *  @glfw3 Added window handle parameter.
+ *
+ *  @ingroup window
+ */
+typedef void (* GLFWwindowrefreshfun)(GLFWwindow*);
+
+/*! @brief The function signature for window focus/defocus callbacks.
+ *
+ *  This is the function signature for window focus callback functions.
+ *
+ *  @param[in] window The window that gained or lost input focus.
+ *  @param[in] focused `GLFW_TRUE` if the window was given input focus, or
+ *  `GLFW_FALSE` if it lost it.
+ *
+ *  @sa @ref window_focus
+ *  @sa @ref glfwSetWindowFocusCallback
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup window
+ */
+typedef void (* GLFWwindowfocusfun)(GLFWwindow*,int);
+
+/*! @brief The function signature for window iconify/restore callbacks.
+ *
+ *  This is the function signature for window iconify/restore callback
+ *  functions.
+ *
+ *  @param[in] window The window that was iconified or restored.
+ *  @param[in] iconified `GLFW_TRUE` if the window was iconified, or
+ *  `GLFW_FALSE` if it was restored.
+ *
+ *  @sa @ref window_iconify
+ *  @sa @ref glfwSetWindowIconifyCallback
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup window
+ */
+typedef void (* GLFWwindowiconifyfun)(GLFWwindow*,int);
+
+/*! @brief The function signature for window maximize/restore callbacks.
+ *
+ *  This is the function signature for window maximize/restore callback
+ *  functions.
+ *
+ *  @param[in] window The window that was maximized or restored.
+ *  @param[in] iconified `GLFW_TRUE` if the window was maximized, or
+ *  `GLFW_FALSE` if it was restored.
+ *
+ *  @sa @ref window_maximize
+ *  @sa glfwSetWindowMaximizeCallback
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup window
+ */
+typedef void (* GLFWwindowmaximizefun)(GLFWwindow*,int);
+
+/*! @brief The function signature for framebuffer resize callbacks.
+ *
+ *  This is the function signature for framebuffer resize callback
+ *  functions.
+ *
+ *  @param[in] window The window whose framebuffer was resized.
+ *  @param[in] width The new width, in pixels, of the framebuffer.
+ *  @param[in] height The new height, in pixels, of the framebuffer.
+ *
+ *  @sa @ref window_fbsize
+ *  @sa @ref glfwSetFramebufferSizeCallback
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup window
+ */
+typedef void (* GLFWframebuffersizefun)(GLFWwindow*,int,int);
+
+/*! @brief The function signature for window content scale callbacks.
+ *
+ *  This is the function signature for window content scale callback
+ *  functions.
+ *
+ *  @param[in] window The window whose content scale changed.
+ *  @param[in] xscale The new x-axis content scale of the window.
+ *  @param[in] yscale The new y-axis content scale of the window.
+ *
+ *  @sa @ref window_scale
+ *  @sa @ref glfwSetWindowContentScaleCallback
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup window
+ */
+typedef void (* GLFWwindowcontentscalefun)(GLFWwindow*,float,float);
+
+/*! @brief The function signature for mouse button callbacks.
+ *
+ *  This is the function signature for mouse button callback functions.
+ *
+ *  @param[in] window The window that received the event.
+ *  @param[in] button The [mouse button](@ref buttons) that was pressed or
+ *  released.
+ *  @param[in] action One of `GLFW_PRESS` or `GLFW_RELEASE`.
+ *  @param[in] mods Bit field describing which [modifier keys](@ref mods) were
+ *  held down.
+ *
+ *  @sa @ref input_mouse_button
+ *  @sa @ref glfwSetMouseButtonCallback
+ *
+ *  @since Added in version 1.0.
+ *  @glfw3 Added window handle and modifier mask parameters.
+ *
+ *  @ingroup input
+ */
+typedef void (* GLFWmousebuttonfun)(GLFWwindow*,int,int,int);
+
+/*! @brief The function signature for cursor position callbacks.
+ *
+ *  This is the function signature for cursor position callback functions.
+ *
+ *  @param[in] window The window that received the event.
+ *  @param[in] xpos The new cursor x-coordinate, relative to the left edge of
+ *  the client area.
+ *  @param[in] ypos The new cursor y-coordinate, relative to the top edge of the
+ *  client area.
+ *
+ *  @sa @ref cursor_pos
+ *  @sa @ref glfwSetCursorPosCallback
+ *
+ *  @since Added in version 3.0.  Replaces `GLFWmouseposfun`.
+ *
+ *  @ingroup input
+ */
+typedef void (* GLFWcursorposfun)(GLFWwindow*,double,double);
+
+/*! @brief The function signature for cursor enter/leave callbacks.
+ *
+ *  This is the function signature for cursor enter/leave callback functions.
+ *
+ *  @param[in] window The window that received the event.
+ *  @param[in] entered `GLFW_TRUE` if the cursor entered the window's client
+ *  area, or `GLFW_FALSE` if it left it.
+ *
+ *  @sa @ref cursor_enter
+ *  @sa @ref glfwSetCursorEnterCallback
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup input
+ */
+typedef void (* GLFWcursorenterfun)(GLFWwindow*,int);
+
+/*! @brief The function signature for scroll callbacks.
+ *
+ *  This is the function signature for scroll callback functions.
+ *
+ *  @param[in] window The window that received the event.
+ *  @param[in] xoffset The scroll offset along the x-axis.
+ *  @param[in] yoffset The scroll offset along the y-axis.
+ *
+ *  @sa @ref scrolling
+ *  @sa @ref glfwSetScrollCallback
+ *
+ *  @since Added in version 3.0.  Replaces `GLFWmousewheelfun`.
+ *
+ *  @ingroup input
+ */
+typedef void (* GLFWscrollfun)(GLFWwindow*,double,double);
+
+/*! @brief The function signature for keyboard key callbacks.
+ *
+ *  This is the function signature for keyboard key callback functions.
+ *
+ *  @param[in] window The window that received the event.
+ *  @param[in] key The [keyboard key](@ref keys) that was pressed or released.
+ *  @param[in] scancode The system-specific scancode of the key.
+ *  @param[in] action `GLFW_PRESS`, `GLFW_RELEASE` or `GLFW_REPEAT`.
+ *  @param[in] mods Bit field describing which [modifier keys](@ref mods) were
+ *  held down.
+ *
+ *  @sa @ref input_key
+ *  @sa @ref glfwSetKeyCallback
+ *
+ *  @since Added in version 1.0.
+ *  @glfw3 Added window handle, scancode and modifier mask parameters.
+ *
+ *  @ingroup input
+ */
+typedef void (* GLFWkeyfun)(GLFWwindow*,int,int,int,int);
+
+/*! @brief The function signature for Unicode character callbacks.
+ *
+ *  This is the function signature for Unicode character callback functions.
+ *
+ *  @param[in] window The window that received the event.
+ *  @param[in] codepoint The Unicode code point of the character.
+ *
+ *  @sa @ref input_char
+ *  @sa @ref glfwSetCharCallback
+ *
+ *  @since Added in version 2.4.
+ *  @glfw3 Added window handle parameter.
+ *
+ *  @ingroup input
+ */
+typedef void (* GLFWcharfun)(GLFWwindow*,unsigned int);
+
+/*! @brief The function signature for Unicode character with modifiers
+ *  callbacks.
+ *
+ *  This is the function signature for Unicode character with modifiers callback
+ *  functions.  It is called for each input character, regardless of what
+ *  modifier keys are held down.
+ *
+ *  @param[in] window The window that received the event.
+ *  @param[in] codepoint The Unicode code point of the character.
+ *  @param[in] mods Bit field describing which [modifier keys](@ref mods) were
+ *  held down.
+ *
+ *  @sa @ref input_char
+ *  @sa @ref glfwSetCharModsCallback
+ *
+ *  @deprecated Scheduled for removal in version 4.0.
+ *
+ *  @since Added in version 3.1.
+ *
+ *  @ingroup input
+ */
+typedef void (* GLFWcharmodsfun)(GLFWwindow*,unsigned int,int);
+
+/*! @brief The function signature for file drop callbacks.
+ *
+ *  This is the function signature for file drop callbacks.
+ *
+ *  @param[in] window The window that received the event.
+ *  @param[in] count The number of dropped files.
+ *  @param[in] paths The UTF-8 encoded file and/or directory path names.
+ *
+ *  @sa @ref path_drop
+ *  @sa @ref glfwSetDropCallback
+ *
+ *  @since Added in version 3.1.
+ *
+ *  @ingroup input
+ */
+typedef void (* GLFWdropfun)(GLFWwindow*,int,const char**);
+
+/*! @brief The function signature for monitor configuration callbacks.
+ *
+ *  This is the function signature for monitor configuration callback functions.
+ *
+ *  @param[in] monitor The monitor that was connected or disconnected.
+ *  @param[in] event One of `GLFW_CONNECTED` or `GLFW_DISCONNECTED`.  Remaining
+ *  values reserved for future use.
+ *
+ *  @sa @ref monitor_event
+ *  @sa @ref glfwSetMonitorCallback
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup monitor
+ */
+typedef void (* GLFWmonitorfun)(GLFWmonitor*,int);
+
+/*! @brief The function signature for joystick configuration callbacks.
+ *
+ *  This is the function signature for joystick configuration callback
+ *  functions.
+ *
+ *  @param[in] jid The joystick that was connected or disconnected.
+ *  @param[in] event One of `GLFW_CONNECTED` or `GLFW_DISCONNECTED`.  Remaining
+ *  values reserved for future use.
+ *
+ *  @sa @ref joystick_event
+ *  @sa @ref glfwSetJoystickCallback
+ *
+ *  @since Added in version 3.2.
+ *
+ *  @ingroup input
+ */
+typedef void (* GLFWjoystickfun)(int,int);
+
+/*! @brief Video mode type.
+ *
+ *  This describes a single video mode.
+ *
+ *  @sa @ref monitor_modes
+ *  @sa @ref glfwGetVideoMode
+ *  @sa @ref glfwGetVideoModes
+ *
+ *  @since Added in version 1.0.
+ *  @glfw3 Added refresh rate member.
+ *
+ *  @ingroup monitor
+ */
+typedef struct GLFWvidmode
+{
+    /*! The width, in screen coordinates, of the video mode.
+     */
+    int width;
+    /*! The height, in screen coordinates, of the video mode.
+     */
+    int height;
+    /*! The bit depth of the red channel of the video mode.
+     */
+    int redBits;
+    /*! The bit depth of the green channel of the video mode.
+     */
+    int greenBits;
+    /*! The bit depth of the blue channel of the video mode.
+     */
+    int blueBits;
+    /*! The refresh rate, in Hz, of the video mode.
+     */
+    int refreshRate;
+} GLFWvidmode;
+
+/*! @brief Gamma ramp.
+ *
+ *  This describes the gamma ramp for a monitor.
+ *
+ *  @sa @ref monitor_gamma
+ *  @sa @ref glfwGetGammaRamp
+ *  @sa @ref glfwSetGammaRamp
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup monitor
+ */
+typedef struct GLFWgammaramp
+{
+    /*! An array of value describing the response of the red channel.
+     */
+    unsigned short* red;
+    /*! An array of value describing the response of the green channel.
+     */
+    unsigned short* green;
+    /*! An array of value describing the response of the blue channel.
+     */
+    unsigned short* blue;
+    /*! The number of elements in each array.
+     */
+    unsigned int size;
+} GLFWgammaramp;
+
+/*! @brief Image data.
+ *
+ *  This describes a single 2D image.  See the documentation for each related
+ *  function what the expected pixel format is.
+ *
+ *  @sa @ref cursor_custom
+ *  @sa @ref window_icon
+ *
+ *  @since Added in version 2.1.
+ *  @glfw3 Removed format and bytes-per-pixel members.
+ */
+typedef struct GLFWimage
+{
+    /*! The width, in pixels, of this image.
+     */
+    int width;
+    /*! The height, in pixels, of this image.
+     */
+    int height;
+    /*! The pixel data of this image, arranged left-to-right, top-to-bottom.
+     */
+    unsigned char* pixels;
+} GLFWimage;
+
+/*! @brief Gamepad input state
+ *
+ *  This describes the input state of a gamepad.
+ *
+ *  @sa @ref gamepad
+ *  @sa @ref glfwGetGamepadState
+ *
+ *  @since Added in version 3.3.
+ */
+typedef struct GLFWgamepadstate
+{
+    /*! The states of each [gamepad button](@ref gamepad_buttons), `GLFW_PRESS`
+     *  or `GLFW_RELEASE`.
+     */
+    unsigned char buttons[15];
+    /*! The states of each [gamepad axis](@ref gamepad_axes), in the range -1.0
+     *  to 1.0 inclusive.
+     */
+    float axes[6];
+} GLFWgamepadstate;
+
+
+/*************************************************************************
+ * GLFW API functions
+ *************************************************************************/
+
+/*! @brief Initializes the GLFW library.
+ *
+ *  This function initializes the GLFW library.  Before most GLFW functions can
+ *  be used, GLFW must be initialized, and before an application terminates GLFW
+ *  should be terminated in order to free any resources allocated during or
+ *  after initialization.
+ *
+ *  If this function fails, it calls @ref glfwTerminate before returning.  If it
+ *  succeeds, you should call @ref glfwTerminate before the application exits.
+ *
+ *  Additional calls to this function after successful initialization but before
+ *  termination will return `GLFW_TRUE` immediately.
+ *
+ *  @return `GLFW_TRUE` if successful, or `GLFW_FALSE` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @remark @macos This function will change the current directory of the
+ *  application to the `Contents/Resources` subdirectory of the application's
+ *  bundle, if present.  This can be disabled with the @ref
+ *  GLFW_COCOA_CHDIR_RESOURCES init hint.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref intro_init
+ *  @sa @ref glfwTerminate
+ *
+ *  @since Added in version 1.0.
+ *
+ *  @ingroup init
+ */
+GLFWAPI int glfwInit(void);
+
+/*! @brief Terminates the GLFW library.
+ *
+ *  This function destroys all remaining windows and cursors, restores any
+ *  modified gamma ramps and frees any other allocated resources.  Once this
+ *  function is called, you must again call @ref glfwInit successfully before
+ *  you will be able to use most GLFW functions.
+ *
+ *  If GLFW has been successfully initialized, this function should be called
+ *  before the application exits.  If initialization fails, there is no need to
+ *  call this function, as it is called by @ref glfwInit before it returns
+ *  failure.
+ *
+ *  @errors Possible errors include @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @remark This function may be called before @ref glfwInit.
+ *
+ *  @warning The contexts of any remaining windows must not be current on any
+ *  other thread when this function is called.
+ *
+ *  @reentrancy This function must not be called from a callback.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref intro_init
+ *  @sa @ref glfwInit
+ *
+ *  @since Added in version 1.0.
+ *
+ *  @ingroup init
+ */
+GLFWAPI void glfwTerminate(void);
+
+/*! @brief Sets the specified init hint to the desired value.
+ *
+ *  This function sets hints for the next initialization of GLFW.
+ *
+ *  The values you set hints to are never reset by GLFW, but they only take
+ *  effect during initialization.  Once GLFW has been initialized, any values
+ *  you set will be ignored until the library is terminated and initialized
+ *  again.
+ *
+ *  Some hints are platform specific.  These may be set on any platform but they
+ *  will only affect their specific platform.  Other platforms will ignore them.
+ *  Setting these hints requires no platform specific headers or functions.
+ *
+ *  @param[in] hint The [init hint](@ref init_hints) to set.
+ *  @param[in] value The new value of the init hint.
+ *
+ *  @errors Possible errors include @ref GLFW_INVALID_ENUM and @ref
+ *  GLFW_INVALID_VALUE.
+ *
+ *  @remarks This function may be called before @ref glfwInit.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa init_hints
+ *  @sa glfwInit
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup init
+ */
+GLFWAPI void glfwInitHint(int hint, int value);
+
+/*! @brief Retrieves the version of the GLFW library.
+ *
+ *  This function retrieves the major, minor and revision numbers of the GLFW
+ *  library.  It is intended for when you are using GLFW as a shared library and
+ *  want to ensure that you are using the minimum required version.
+ *
+ *  Any or all of the version arguments may be `NULL`.
+ *
+ *  @param[out] major Where to store the major version number, or `NULL`.
+ *  @param[out] minor Where to store the minor version number, or `NULL`.
+ *  @param[out] rev Where to store the revision number, or `NULL`.
+ *
+ *  @errors None.
+ *
+ *  @remark This function may be called before @ref glfwInit.
+ *
+ *  @thread_safety This function may be called from any thread.
+ *
+ *  @sa @ref intro_version
+ *  @sa @ref glfwGetVersionString
+ *
+ *  @since Added in version 1.0.
+ *
+ *  @ingroup init
+ */
+GLFWAPI void glfwGetVersion(int* major, int* minor, int* rev);
+
+/*! @brief Returns a string describing the compile-time configuration.
+ *
+ *  This function returns the compile-time generated
+ *  [version string](@ref intro_version_string) of the GLFW library binary.  It
+ *  describes the version, platform, compiler and any platform-specific
+ *  compile-time options.  It should not be confused with the OpenGL or OpenGL
+ *  ES version string, queried with `glGetString`.
+ *
+ *  __Do not use the version string__ to parse the GLFW library version.  The
+ *  @ref glfwGetVersion function provides the version of the running library
+ *  binary in numerical format.
+ *
+ *  @return The ASCII encoded GLFW version string.
+ *
+ *  @errors None.
+ *
+ *  @remark This function may be called before @ref glfwInit.
+ *
+ *  @pointer_lifetime The returned string is static and compile-time generated.
+ *
+ *  @thread_safety This function may be called from any thread.
+ *
+ *  @sa @ref intro_version
+ *  @sa @ref glfwGetVersion
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup init
+ */
+GLFWAPI const char* glfwGetVersionString(void);
+
+/*! @brief Returns and clears the last error for the calling thread.
+ *
+ *  This function returns and clears the [error code](@ref errors) of the last
+ *  error that occurred on the calling thread, and optionally a UTF-8 encoded
+ *  human-readable description of it.  If no error has occurred since the last
+ *  call, it returns @ref GLFW_NO_ERROR (zero) and the description pointer is
+ *  set to `NULL`.
+ *
+ *  @param[in] description Where to store the error description pointer, or `NULL`.
+ *  @return The last error code for the calling thread, or @ref GLFW_NO_ERROR
+ *  (zero).
+ *
+ *  @errors None.
+ *
+ *  @pointer_lifetime The returned string is allocated and freed by GLFW.  You
+ *  should not free it yourself.  It is guaranteed to be valid only until the
+ *  next error occurs or the library is terminated.
+ *
+ *  @remark This function may be called before @ref glfwInit.
+ *
+ *  @thread_safety This function may be called from any thread.
+ *
+ *  @sa @ref error_handling
+ *  @sa @ref glfwSetErrorCallback
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup init
+ */
+GLFWAPI int glfwGetError(const char** description);
+
+/*! @brief Sets the error callback.
+ *
+ *  This function sets the error callback, which is called with an error code
+ *  and a human-readable description each time a GLFW error occurs.
+ *
+ *  The error code is set before the callback is called.  Calling @ref
+ *  glfwGetError from the error callback will return the same value as the error
+ *  code argument.
+ *
+ *  The error callback is called on the thread where the error occurred.  If you
+ *  are using GLFW from multiple threads, your error callback needs to be
+ *  written accordingly.
+ *
+ *  Because the description string may have been generated specifically for that
+ *  error, it is not guaranteed to be valid after the callback has returned.  If
+ *  you wish to use it after the callback returns, you need to make a copy.
+ *
+ *  Once set, the error callback remains set even after the library has been
+ *  terminated.
+ *
+ *  @param[in] cbfun The new callback, or `NULL` to remove the currently set
+ *  callback.
+ *  @return The previously set callback, or `NULL` if no callback was set.
+ *
+ *  @errors None.
+ *
+ *  @remark This function may be called before @ref glfwInit.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref error_handling
+ *  @sa @ref glfwGetError
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup init
+ */
+GLFWAPI GLFWerrorfun glfwSetErrorCallback(GLFWerrorfun cbfun);
+
+/*! @brief Returns the currently connected monitors.
+ *
+ *  This function returns an array of handles for all currently connected
+ *  monitors.  The primary monitor is always first in the returned array.  If no
+ *  monitors were found, this function returns `NULL`.
+ *
+ *  @param[out] count Where to store the number of monitors in the returned
+ *  array.  This is set to zero if an error occurred.
+ *  @return An array of monitor handles, or `NULL` if no monitors were found or
+ *  if an [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @pointer_lifetime The returned array is allocated and freed by GLFW.  You
+ *  should not free it yourself.  It is guaranteed to be valid only until the
+ *  monitor configuration changes or the library is terminated.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref monitor_monitors
+ *  @sa @ref monitor_event
+ *  @sa @ref glfwGetPrimaryMonitor
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup monitor
+ */
+GLFWAPI GLFWmonitor** glfwGetMonitors(int* count);
+
+/*! @brief Returns the primary monitor.
+ *
+ *  This function returns the primary monitor.  This is usually the monitor
+ *  where elements like the task bar or global menu bar are located.
+ *
+ *  @return The primary monitor, or `NULL` if no monitors were found or if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @remark The primary monitor is always first in the array returned by @ref
+ *  glfwGetMonitors.
+ *
+ *  @sa @ref monitor_monitors
+ *  @sa @ref glfwGetMonitors
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup monitor
+ */
+GLFWAPI GLFWmonitor* glfwGetPrimaryMonitor(void);
+
+/*! @brief Returns the position of the monitor's viewport on the virtual screen.
+ *
+ *  This function returns the position, in screen coordinates, of the upper-left
+ *  corner of the specified monitor.
+ *
+ *  Any or all of the position arguments may be `NULL`.  If an error occurs, all
+ *  non-`NULL` position arguments will be set to zero.
+ *
+ *  @param[in] monitor The monitor to query.
+ *  @param[out] xpos Where to store the monitor x-coordinate, or `NULL`.
+ *  @param[out] ypos Where to store the monitor y-coordinate, or `NULL`.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref monitor_properties
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup monitor
+ */
+GLFWAPI void glfwGetMonitorPos(GLFWmonitor* monitor, int* xpos, int* ypos);
+
+/*! @brief Returns the physical size of the monitor.
+ *
+ *  This function returns the size, in millimetres, of the display area of the
+ *  specified monitor.
+ *
+ *  Some systems do not provide accurate monitor size information, either
+ *  because the monitor
+ *  [EDID](https://en.wikipedia.org/wiki/Extended_display_identification_data)
+ *  data is incorrect or because the driver does not report it accurately.
+ *
+ *  Any or all of the size arguments may be `NULL`.  If an error occurs, all
+ *  non-`NULL` size arguments will be set to zero.
+ *
+ *  @param[in] monitor The monitor to query.
+ *  @param[out] widthMM Where to store the width, in millimetres, of the
+ *  monitor's display area, or `NULL`.
+ *  @param[out] heightMM Where to store the height, in millimetres, of the
+ *  monitor's display area, or `NULL`.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @remark @win32 calculates the returned physical size from the
+ *  current resolution and system DPI instead of querying the monitor EDID data.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref monitor_properties
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup monitor
+ */
+GLFWAPI void glfwGetMonitorPhysicalSize(GLFWmonitor* monitor, int* widthMM, int* heightMM);
+
+/*! @brief Retrieves the content scale for the specified monitor.
+ *
+ *  This function retrieves the content scale for the specified monitor.  The
+ *  content scale is the ratio between the current DPI and the platform's
+ *  default DPI.  If you scale all pixel dimensions by this scale then your
+ *  content should appear at an appropriate size.  This is especially important
+ *  for text and any UI elements.
+ *
+ *  The content scale may depend on both the monitor resolution and pixel
+ *  density and on user settings.  It may be very different from the raw DPI
+ *  calculated from the physical size and current resolution.
+ *
+ *  @param[in] monitor The monitor to query.
+ *  @param[out] xscale Where to store the x-axis content scale, or `NULL`.
+ *  @param[out] yscale Where to store the y-axis content scale, or `NULL`.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref monitor_scale
+ *  @sa @ref glfwGetWindowContentScale
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup monitor
+ */
+GLFWAPI void glfwGetMonitorContentScale(GLFWmonitor* monitor, float* xscale, float* yscale);
+
+/*! @brief Returns the name of the specified monitor.
+ *
+ *  This function returns a human-readable name, encoded as UTF-8, of the
+ *  specified monitor.  The name typically reflects the make and model of the
+ *  monitor and is not guaranteed to be unique among the connected monitors.
+ *
+ *  @param[in] monitor The monitor to query.
+ *  @return The UTF-8 encoded name of the monitor, or `NULL` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @pointer_lifetime The returned string is allocated and freed by GLFW.  You
+ *  should not free it yourself.  It is valid until the specified monitor is
+ *  disconnected or the library is terminated.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref monitor_properties
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup monitor
+ */
+GLFWAPI const char* glfwGetMonitorName(GLFWmonitor* monitor);
+
+/*! @brief Sets the user pointer of the specified monitor.
+ *
+ *  This function sets the user-defined pointer of the specified monitor.  The
+ *  current value is retained until the monitor is disconnected.  The initial
+ *  value is `NULL`.
+ *
+ *  This function may be called from the monitor callback, even for a monitor
+ *  that is being disconnected.
+ *
+ *  @param[in] monitor The monitor whose pointer to set.
+ *  @param[in] pointer The new value.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @sa @ref monitor_userptr
+ *  @sa @ref glfwGetMonitorUserPointer
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup monitor
+ */
+GLFWAPI void glfwSetMonitorUserPointer(GLFWmonitor* monitor, void* pointer);
+
+/*! @brief Returns the user pointer of the specified monitor.
+ *
+ *  This function returns the current value of the user-defined pointer of the
+ *  specified monitor.  The initial value is `NULL`.
+ *
+ *  This function may be called from the monitor callback, even for a monitor
+ *  that is being disconnected.
+ *
+ *  @param[in] monitor The monitor whose pointer to return.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @sa @ref monitor_userptr
+ *  @sa @ref glfwSetMonitorUserPointer
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup monitor
+ */
+GLFWAPI void* glfwGetMonitorUserPointer(GLFWmonitor* monitor);
+
+/*! @brief Sets the monitor configuration callback.
+ *
+ *  This function sets the monitor configuration callback, or removes the
+ *  currently set callback.  This is called when a monitor is connected to or
+ *  disconnected from the system.
+ *
+ *  @param[in] cbfun The new callback, or `NULL` to remove the currently set
+ *  callback.
+ *  @return The previously set callback, or `NULL` if no callback was set or the
+ *  library had not been [initialized](@ref intro_init).
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref monitor_event
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup monitor
+ */
+GLFWAPI GLFWmonitorfun glfwSetMonitorCallback(GLFWmonitorfun cbfun);
+
+/*! @brief Returns the available video modes for the specified monitor.
+ *
+ *  This function returns an array of all video modes supported by the specified
+ *  monitor.  The returned array is sorted in ascending order, first by color
+ *  bit depth (the sum of all channel depths) and then by resolution area (the
+ *  product of width and height).
+ *
+ *  @param[in] monitor The monitor to query.
+ *  @param[out] count Where to store the number of video modes in the returned
+ *  array.  This is set to zero if an error occurred.
+ *  @return An array of video modes, or `NULL` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @pointer_lifetime The returned array is allocated and freed by GLFW.  You
+ *  should not free it yourself.  It is valid until the specified monitor is
+ *  disconnected, this function is called again for that monitor or the library
+ *  is terminated.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref monitor_modes
+ *  @sa @ref glfwGetVideoMode
+ *
+ *  @since Added in version 1.0.
+ *  @glfw3 Changed to return an array of modes for a specific monitor.
+ *
+ *  @ingroup monitor
+ */
+GLFWAPI const GLFWvidmode* glfwGetVideoModes(GLFWmonitor* monitor, int* count);
+
+/*! @brief Returns the current mode of the specified monitor.
+ *
+ *  This function returns the current video mode of the specified monitor.  If
+ *  you have created a full screen window for that monitor, the return value
+ *  will depend on whether that window is iconified.
+ *
+ *  @param[in] monitor The monitor to query.
+ *  @return The current mode of the monitor, or `NULL` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @pointer_lifetime The returned array is allocated and freed by GLFW.  You
+ *  should not free it yourself.  It is valid until the specified monitor is
+ *  disconnected or the library is terminated.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref monitor_modes
+ *  @sa @ref glfwGetVideoModes
+ *
+ *  @since Added in version 3.0.  Replaces `glfwGetDesktopMode`.
+ *
+ *  @ingroup monitor
+ */
+GLFWAPI const GLFWvidmode* glfwGetVideoMode(GLFWmonitor* monitor);
+
+/*! @brief Generates a gamma ramp and sets it for the specified monitor.
+ *
+ *  This function generates a 256-element gamma ramp from the specified exponent
+ *  and then calls @ref glfwSetGammaRamp with it.  The value must be a finite
+ *  number greater than zero.
+ *
+ *  The software controlled gamma ramp is applied _in addition_ to the hardware
+ *  gamma correction, which today is usually an approximation of sRGB gamma.
+ *  This means that setting a perfectly linear ramp, or gamma 1.0, will produce
+ *  the default (usually sRGB-like) behavior.
+ *
+ *  For gamma correct rendering with OpenGL or OpenGL ES, see the @ref
+ *  GLFW_SRGB_CAPABLE hint.
+ *
+ *  @param[in] monitor The monitor whose gamma ramp to set.
+ *  @param[in] gamma The desired exponent.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_INVALID_VALUE and @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @remark @wayland Gamma handling is a priviledged protocol, this function
+ *  will thus never be implemented and emits @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref monitor_gamma
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup monitor
+ */
+GLFWAPI void glfwSetGamma(GLFWmonitor* monitor, float gamma);
+
+/*! @brief Returns the current gamma ramp for the specified monitor.
+ *
+ *  This function returns the current gamma ramp of the specified monitor.
+ *
+ *  @param[in] monitor The monitor to query.
+ *  @return The current gamma ramp, or `NULL` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @remark @wayland Gamma handling is a priviledged protocol, this function
+ *  will thus never be implemented and emits @ref GLFW_PLATFORM_ERROR while
+ *  returning `NULL`.
+ *
+ *  @pointer_lifetime The returned structure and its arrays are allocated and
+ *  freed by GLFW.  You should not free them yourself.  They are valid until the
+ *  specified monitor is disconnected, this function is called again for that
+ *  monitor or the library is terminated.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref monitor_gamma
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup monitor
+ */
+GLFWAPI const GLFWgammaramp* glfwGetGammaRamp(GLFWmonitor* monitor);
+
+/*! @brief Sets the current gamma ramp for the specified monitor.
+ *
+ *  This function sets the current gamma ramp for the specified monitor.  The
+ *  original gamma ramp for that monitor is saved by GLFW the first time this
+ *  function is called and is restored by @ref glfwTerminate.
+ *
+ *  The software controlled gamma ramp is applied _in addition_ to the hardware
+ *  gamma correction, which today is usually an approximation of sRGB gamma.
+ *  This means that setting a perfectly linear ramp, or gamma 1.0, will produce
+ *  the default (usually sRGB-like) behavior.
+ *
+ *  For gamma correct rendering with OpenGL or OpenGL ES, see the @ref
+ *  GLFW_SRGB_CAPABLE hint.
+ *
+ *  @param[in] monitor The monitor whose gamma ramp to set.
+ *  @param[in] ramp The gamma ramp to use.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @remark Gamma ramp sizes other than 256 are not supported by all platforms
+ *  or graphics hardware.
+ *
+ *  @remark @win32 The gamma ramp size must be 256.
+ *
+ *  @remark @wayland Gamma handling is a priviledged protocol, this function
+ *  will thus never be implemented and emits @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @pointer_lifetime The specified gamma ramp is copied before this function
+ *  returns.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref monitor_gamma
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup monitor
+ */
+GLFWAPI void glfwSetGammaRamp(GLFWmonitor* monitor, const GLFWgammaramp* ramp);
+
+/*! @brief Resets all window hints to their default values.
+ *
+ *  This function resets all window hints to their
+ *  [default values](@ref window_hints_values).
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_hints
+ *  @sa @ref glfwWindowHint
+ *  @sa @ref glfwWindowHintString
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwDefaultWindowHints(void);
+
+/*! @brief Sets the specified window hint to the desired value.
+ *
+ *  This function sets hints for the next call to @ref glfwCreateWindow.  The
+ *  hints, once set, retain their values until changed by a call to this
+ *  function or @ref glfwDefaultWindowHints, or until the library is terminated.
+ *
+ *  Only integer value hints can be set with this function.  String value hints
+ *  are set with @ref glfwWindowHintString.
+ *
+ *  This function does not check whether the specified hint values are valid.
+ *  If you set hints to invalid values this will instead be reported by the next
+ *  call to @ref glfwCreateWindow.
+ *
+ *  Some hints are platform specific.  These may be set on any platform but they
+ *  will only affect their specific platform.  Other platforms will ignore them.
+ *  Setting these hints requires no platform specific headers or functions.
+ *
+ *  @param[in] hint The [window hint](@ref window_hints) to set.
+ *  @param[in] value The new value of the window hint.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_INVALID_ENUM.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_hints
+ *  @sa @ref glfwWindowHintString
+ *  @sa @ref glfwDefaultWindowHints
+ *
+ *  @since Added in version 3.0.  Replaces `glfwOpenWindowHint`.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwWindowHint(int hint, int value);
+
+/*! @brief Sets the specified window hint to the desired value.
+ *
+ *  This function sets hints for the next call to @ref glfwCreateWindow.  The
+ *  hints, once set, retain their values until changed by a call to this
+ *  function or @ref glfwDefaultWindowHints, or until the library is terminated.
+ *
+ *  Only string type hints can be set with this function.  Integer value hints
+ *  are set with @ref glfwWindowHint.
+ *
+ *  This function does not check whether the specified hint values are valid.
+ *  If you set hints to invalid values this will instead be reported by the next
+ *  call to @ref glfwCreateWindow.
+ *
+ *  Some hints are platform specific.  These may be set on any platform but they
+ *  will only affect their specific platform.  Other platforms will ignore them.
+ *  Setting these hints requires no platform specific headers or functions.
+ *
+ *  @param[in] hint The [window hint](@ref window_hints) to set.
+ *  @param[in] value The new value of the window hint.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_INVALID_ENUM.
+ *
+ *  @pointer_lifetime The specified string is copied before this function
+ *  returns.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_hints
+ *  @sa @ref glfwWindowHint
+ *  @sa @ref glfwDefaultWindowHints
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwWindowHintString(int hint, const char* value);
+
+/*! @brief Creates a window and its associated context.
+ *
+ *  This function creates a window and its associated OpenGL or OpenGL ES
+ *  context.  Most of the options controlling how the window and its context
+ *  should be created are specified with [window hints](@ref window_hints).
+ *
+ *  Successful creation does not change which context is current.  Before you
+ *  can use the newly created context, you need to
+ *  [make it current](@ref context_current).  For information about the `share`
+ *  parameter, see @ref context_sharing.
+ *
+ *  The created window, framebuffer and context may differ from what you
+ *  requested, as not all parameters and hints are
+ *  [hard constraints](@ref window_hints_hard).  This includes the size of the
+ *  window, especially for full screen windows.  To query the actual attributes
+ *  of the created window, framebuffer and context, see @ref
+ *  glfwGetWindowAttrib, @ref glfwGetWindowSize and @ref glfwGetFramebufferSize.
+ *
+ *  To create a full screen window, you need to specify the monitor the window
+ *  will cover.  If no monitor is specified, the window will be windowed mode.
+ *  Unless you have a way for the user to choose a specific monitor, it is
+ *  recommended that you pick the primary monitor.  For more information on how
+ *  to query connected monitors, see @ref monitor_monitors.
+ *
+ *  For full screen windows, the specified size becomes the resolution of the
+ *  window's _desired video mode_.  As long as a full screen window is not
+ *  iconified, the supported video mode most closely matching the desired video
+ *  mode is set for the specified monitor.  For more information about full
+ *  screen windows, including the creation of so called _windowed full screen_
+ *  or _borderless full screen_ windows, see @ref window_windowed_full_screen.
+ *
+ *  Once you have created the window, you can switch it between windowed and
+ *  full screen mode with @ref glfwSetWindowMonitor.  This will not affect its
+ *  OpenGL or OpenGL ES context.
+ *
+ *  By default, newly created windows use the placement recommended by the
+ *  window system.  To create the window at a specific position, make it
+ *  initially invisible using the [GLFW_VISIBLE](@ref GLFW_VISIBLE_hint) window
+ *  hint, set its [position](@ref window_pos) and then [show](@ref window_hide)
+ *  it.
+ *
+ *  As long as at least one full screen window is not iconified, the screensaver
+ *  is prohibited from starting.
+ *
+ *  Window systems put limits on window sizes.  Very large or very small window
+ *  dimensions may be overridden by the window system on creation.  Check the
+ *  actual [size](@ref window_size) after creation.
+ *
+ *  The [swap interval](@ref buffer_swap) is not set during window creation and
+ *  the initial value may vary depending on driver settings and defaults.
+ *
+ *  @param[in] width The desired width, in screen coordinates, of the window.
+ *  This must be greater than zero.
+ *  @param[in] height The desired height, in screen coordinates, of the window.
+ *  This must be greater than zero.
+ *  @param[in] title The initial, UTF-8 encoded window title.
+ *  @param[in] monitor The monitor to use for full screen mode, or `NULL` for
+ *  windowed mode.
+ *  @param[in] share The window whose context to share resources with, or `NULL`
+ *  to not share resources.
+ *  @return The handle of the created window, or `NULL` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_INVALID_ENUM, @ref GLFW_INVALID_VALUE, @ref GLFW_API_UNAVAILABLE, @ref
+ *  GLFW_VERSION_UNAVAILABLE, @ref GLFW_FORMAT_UNAVAILABLE and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @remark @win32 Window creation will fail if the Microsoft GDI software
+ *  OpenGL implementation is the only one available.
+ *
+ *  @remark @win32 If the executable has an icon resource named `GLFW_ICON,` it
+ *  will be set as the initial icon for the window.  If no such icon is present,
+ *  the `IDI_APPLICATION` icon will be used instead.  To set a different icon,
+ *  see @ref glfwSetWindowIcon.
+ *
+ *  @remark @win32 The context to share resources with must not be current on
+ *  any other thread.
+ *
+ *  @remark @macos The OS only supports forward-compatible core profile contexts
+ *  for OpenGL versions 3.2 and later.  Before creating an OpenGL context of
+ *  version 3.2 or later you must set the
+ *  [GLFW_OPENGL_FORWARD_COMPAT](@ref GLFW_OPENGL_FORWARD_COMPAT_hint) and
+ *  [GLFW_OPENGL_PROFILE](@ref GLFW_OPENGL_PROFILE_hint) hints accordingly.
+ *  OpenGL 3.0 and 3.1 contexts are not supported at all on macOS.
+ *
+ *  @remark @macos The GLFW window has no icon, as it is not a document
+ *  window, but the dock icon will be the same as the application bundle's icon.
+ *  For more information on bundles, see the
+ *  [Bundle Programming Guide](https://developer.apple.com/library/mac/documentation/CoreFoundation/Conceptual/CFBundles/)
+ *  in the Mac Developer Library.
+ *
+ *  @remark @macos The first time a window is created the menu bar is created.
+ *  If GLFW finds a `MainMenu.nib` it is loaded and assumed to contain a menu
+ *  bar.  Otherwise a minimal menu bar is created manually with common commands
+ *  like Hide, Quit and About.  The About entry opens a minimal about dialog
+ *  with information from the application's bundle.  Menu bar creation can be
+ *  disabled entirely with the @ref GLFW_COCOA_MENUBAR init hint.
+ *
+ *  @remark @macos On OS X 10.10 and later the window frame will not be rendered
+ *  at full resolution on Retina displays unless the
+ *  [GLFW_COCOA_RETINA_FRAMEBUFFER](@ref GLFW_COCOA_RETINA_FRAMEBUFFER_hint)
+ *  hint is `GLFW_TRUE` and the `NSHighResolutionCapable` key is enabled in the
+ *  application bundle's `Info.plist`.  For more information, see
+ *  [High Resolution Guidelines for OS X](https://developer.apple.com/library/mac/documentation/GraphicsAnimation/Conceptual/HighResolutionOSX/Explained/Explained.html)
+ *  in the Mac Developer Library.  The GLFW test and example programs use
+ *  a custom `Info.plist` template for this, which can be found as
+ *  `CMake/MacOSXBundleInfo.plist.in` in the source tree.
+ *
+ *  @remark @macos When activating frame autosaving with
+ *  [GLFW_COCOA_FRAME_NAME](@ref GLFW_COCOA_FRAME_NAME_hint), the specified
+ *  window size and position may be overriden by previously saved values.
+ *
+ *  @remark @x11 Some window managers will not respect the placement of
+ *  initially hidden windows.
+ *
+ *  @remark @x11 Due to the asynchronous nature of X11, it may take a moment for
+ *  a window to reach its requested state.  This means you may not be able to
+ *  query the final size, position or other attributes directly after window
+ *  creation.
+ *
+ *  @remark @x11 The class part of the `WM_CLASS` window property will by
+ *  default be set to the window title passed to this function.  The instance
+ *  part will use the contents of the `RESOURCE_NAME` environment variable, if
+ *  present and not empty, or fall back to the window title.  Set the @ref
+ *  GLFW_X11_CLASS_NAME and @ref GLFW_X11_INSTANCE_NAME window hints to override
+ *  this.
+ *
+ *  @remark @wayland The window frame is currently very simple, only allowing
+ *  window resize or move.  A compositor can still emit close, maximize or
+ *  fullscreen events, using for example a keybind mechanism.  Additionally,
+ *  the wp_viewporter protocol is required for this feature, otherwise the
+ *  window will not be decorated.
+ *
+ *  @remark @wayland A full screen window will not attempt to change the mode,
+ *  no matter what the requested size or refresh rate.
+ *
+ *  @remark @wayland Screensaver inhibition requires the idle-inhibit protocol
+ *  to be implemented in the user's compositor.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_creation
+ *  @sa @ref glfwDestroyWindow
+ *
+ *  @since Added in version 3.0.  Replaces `glfwOpenWindow`.
+ *
+ *  @ingroup window
+ */
+GLFWAPI GLFWwindow* glfwCreateWindow(int width, int height, const char* title, GLFWmonitor* monitor, GLFWwindow* share);
+
+/*! @brief Destroys the specified window and its context.
+ *
+ *  This function destroys the specified window and its context.  On calling
+ *  this function, no further callbacks will be called for that window.
+ *
+ *  If the context of the specified window is current on the main thread, it is
+ *  detached before being destroyed.
+ *
+ *  @param[in] window The window to destroy.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @note The context of the specified window must not be current on any other
+ *  thread when this function is called.
+ *
+ *  @reentrancy This function must not be called from a callback.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_creation
+ *  @sa @ref glfwCreateWindow
+ *
+ *  @since Added in version 3.0.  Replaces `glfwCloseWindow`.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwDestroyWindow(GLFWwindow* window);
+
+/*! @brief Checks the close flag of the specified window.
+ *
+ *  This function returns the value of the close flag of the specified window.
+ *
+ *  @param[in] window The window to query.
+ *  @return The value of the close flag.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @sa @ref window_close
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup window
+ */
+GLFWAPI int glfwWindowShouldClose(GLFWwindow* window);
+
+/*! @brief Sets the close flag of the specified window.
+ *
+ *  This function sets the value of the close flag of the specified window.
+ *  This can be used to override the user's attempt to close the window, or
+ *  to signal that it should be closed.
+ *
+ *  @param[in] window The window whose flag to change.
+ *  @param[in] value The new value.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @sa @ref window_close
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwSetWindowShouldClose(GLFWwindow* window, int value);
+
+/*! @brief Sets the title of the specified window.
+ *
+ *  This function sets the window title, encoded as UTF-8, of the specified
+ *  window.
+ *
+ *  @param[in] window The window whose title to change.
+ *  @param[in] title The UTF-8 encoded window title.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @remark @macos The window title will not be updated until the next time you
+ *  process events.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_title
+ *
+ *  @since Added in version 1.0.
+ *  @glfw3 Added window handle parameter.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwSetWindowTitle(GLFWwindow* window, const char* title);
+
+/*! @brief Sets the icon for the specified window.
+ *
+ *  This function sets the icon of the specified window.  If passed an array of
+ *  candidate images, those of or closest to the sizes desired by the system are
+ *  selected.  If no images are specified, the window reverts to its default
+ *  icon.
+ *
+ *  The pixels are 32-bit, little-endian, non-premultiplied RGBA, i.e. eight
+ *  bits per channel with the red channel first.  They are arranged canonically
+ *  as packed sequential rows, starting from the top-left corner.
+ *
+ *  The desired image sizes varies depending on platform and system settings.
+ *  The selected images will be rescaled as needed.  Good sizes include 16x16,
+ *  32x32 and 48x48.
+ *
+ *  @param[in] window The window whose icon to set.
+ *  @param[in] count The number of images in the specified array, or zero to
+ *  revert to the default window icon.
+ *  @param[in] images The images to create the icon from.  This is ignored if
+ *  count is zero.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @pointer_lifetime The specified image data is copied before this function
+ *  returns.
+ *
+ *  @remark @macos The GLFW window has no icon, as it is not a document
+ *  window, so this function does nothing.  The dock icon will be the same as
+ *  the application bundle's icon.  For more information on bundles, see the
+ *  [Bundle Programming Guide](https://developer.apple.com/library/mac/documentation/CoreFoundation/Conceptual/CFBundles/)
+ *  in the Mac Developer Library.
+ *
+ *  @remark @wayland There is no existing protocol to change an icon, the
+ *  window will thus inherit the one defined in the application's desktop file.
+ *  This function always emits @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_icon
+ *
+ *  @since Added in version 3.2.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwSetWindowIcon(GLFWwindow* window, int count, const GLFWimage* images);
+
+/*! @brief Retrieves the position of the client area of the specified window.
+ *
+ *  This function retrieves the position, in screen coordinates, of the
+ *  upper-left corner of the client area of the specified window.
+ *
+ *  Any or all of the position arguments may be `NULL`.  If an error occurs, all
+ *  non-`NULL` position arguments will be set to zero.
+ *
+ *  @param[in] window The window to query.
+ *  @param[out] xpos Where to store the x-coordinate of the upper-left corner of
+ *  the client area, or `NULL`.
+ *  @param[out] ypos Where to store the y-coordinate of the upper-left corner of
+ *  the client area, or `NULL`.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @remark @wayland There is no way for an application to retrieve the global
+ *  position of its windows, this function will always emit @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_pos
+ *  @sa @ref glfwSetWindowPos
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwGetWindowPos(GLFWwindow* window, int* xpos, int* ypos);
+
+/*! @brief Sets the position of the client area of the specified window.
+ *
+ *  This function sets the position, in screen coordinates, of the upper-left
+ *  corner of the client area of the specified windowed mode window.  If the
+ *  window is a full screen window, this function does nothing.
+ *
+ *  __Do not use this function__ to move an already visible window unless you
+ *  have very good reasons for doing so, as it will confuse and annoy the user.
+ *
+ *  The window manager may put limits on what positions are allowed.  GLFW
+ *  cannot and should not override these limits.
+ *
+ *  @param[in] window The window to query.
+ *  @param[in] xpos The x-coordinate of the upper-left corner of the client area.
+ *  @param[in] ypos The y-coordinate of the upper-left corner of the client area.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @remark @wayland There is no way for an application to set the global
+ *  position of its windows, this function will always emit @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_pos
+ *  @sa @ref glfwGetWindowPos
+ *
+ *  @since Added in version 1.0.
+ *  @glfw3 Added window handle parameter.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwSetWindowPos(GLFWwindow* window, int xpos, int ypos);
+
+/*! @brief Retrieves the size of the client area of the specified window.
+ *
+ *  This function retrieves the size, in screen coordinates, of the client area
+ *  of the specified window.  If you wish to retrieve the size of the
+ *  framebuffer of the window in pixels, see @ref glfwGetFramebufferSize.
+ *
+ *  Any or all of the size arguments may be `NULL`.  If an error occurs, all
+ *  non-`NULL` size arguments will be set to zero.
+ *
+ *  @param[in] window The window whose size to retrieve.
+ *  @param[out] width Where to store the width, in screen coordinates, of the
+ *  client area, or `NULL`.
+ *  @param[out] height Where to store the height, in screen coordinates, of the
+ *  client area, or `NULL`.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_size
+ *  @sa @ref glfwSetWindowSize
+ *
+ *  @since Added in version 1.0.
+ *  @glfw3 Added window handle parameter.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwGetWindowSize(GLFWwindow* window, int* width, int* height);
+
+/*! @brief Sets the size limits of the specified window.
+ *
+ *  This function sets the size limits of the client area of the specified
+ *  window.  If the window is full screen, the size limits only take effect
+ *  once it is made windowed.  If the window is not resizable, this function
+ *  does nothing.
+ *
+ *  The size limits are applied immediately to a windowed mode window and may
+ *  cause it to be resized.
+ *
+ *  The maximum dimensions must be greater than or equal to the minimum
+ *  dimensions and all must be greater than or equal to zero.
+ *
+ *  @param[in] window The window to set limits for.
+ *  @param[in] minwidth The minimum width, in screen coordinates, of the client
+ *  area, or `GLFW_DONT_CARE`.
+ *  @param[in] minheight The minimum height, in screen coordinates, of the
+ *  client area, or `GLFW_DONT_CARE`.
+ *  @param[in] maxwidth The maximum width, in screen coordinates, of the client
+ *  area, or `GLFW_DONT_CARE`.
+ *  @param[in] maxheight The maximum height, in screen coordinates, of the
+ *  client area, or `GLFW_DONT_CARE`.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_INVALID_VALUE and @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @remark If you set size limits and an aspect ratio that conflict, the
+ *  results are undefined.
+ *
+ *  @remark @wayland The size limits will not be applied until the window is
+ *  actually resized, either by the user or by the compositor.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_sizelimits
+ *  @sa @ref glfwSetWindowAspectRatio
+ *
+ *  @since Added in version 3.2.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwSetWindowSizeLimits(GLFWwindow* window, int minwidth, int minheight, int maxwidth, int maxheight);
+
+/*! @brief Sets the aspect ratio of the specified window.
+ *
+ *  This function sets the required aspect ratio of the client area of the
+ *  specified window.  If the window is full screen, the aspect ratio only takes
+ *  effect once it is made windowed.  If the window is not resizable, this
+ *  function does nothing.
+ *
+ *  The aspect ratio is specified as a numerator and a denominator and both
+ *  values must be greater than zero.  For example, the common 16:9 aspect ratio
+ *  is specified as 16 and 9, respectively.
+ *
+ *  If the numerator and denominator is set to `GLFW_DONT_CARE` then the aspect
+ *  ratio limit is disabled.
+ *
+ *  The aspect ratio is applied immediately to a windowed mode window and may
+ *  cause it to be resized.
+ *
+ *  @param[in] window The window to set limits for.
+ *  @param[in] numer The numerator of the desired aspect ratio, or
+ *  `GLFW_DONT_CARE`.
+ *  @param[in] denom The denominator of the desired aspect ratio, or
+ *  `GLFW_DONT_CARE`.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_INVALID_VALUE and @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @remark If you set size limits and an aspect ratio that conflict, the
+ *  results are undefined.
+ *
+ *  @remark @wayland The aspect ratio will not be applied until the window is
+ *  actually resized, either by the user or by the compositor.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_sizelimits
+ *  @sa @ref glfwSetWindowSizeLimits
+ *
+ *  @since Added in version 3.2.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwSetWindowAspectRatio(GLFWwindow* window, int numer, int denom);
+
+/*! @brief Sets the size of the client area of the specified window.
+ *
+ *  This function sets the size, in screen coordinates, of the client area of
+ *  the specified window.
+ *
+ *  For full screen windows, this function updates the resolution of its desired
+ *  video mode and switches to the video mode closest to it, without affecting
+ *  the window's context.  As the context is unaffected, the bit depths of the
+ *  framebuffer remain unchanged.
+ *
+ *  If you wish to update the refresh rate of the desired video mode in addition
+ *  to its resolution, see @ref glfwSetWindowMonitor.
+ *
+ *  The window manager may put limits on what sizes are allowed.  GLFW cannot
+ *  and should not override these limits.
+ *
+ *  @param[in] window The window to resize.
+ *  @param[in] width The desired width, in screen coordinates, of the window
+ *  client area.
+ *  @param[in] height The desired height, in screen coordinates, of the window
+ *  client area.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @remark @wayland A full screen window will not attempt to change the mode,
+ *  no matter what the requested size.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_size
+ *  @sa @ref glfwGetWindowSize
+ *  @sa @ref glfwSetWindowMonitor
+ *
+ *  @since Added in version 1.0.
+ *  @glfw3 Added window handle parameter.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwSetWindowSize(GLFWwindow* window, int width, int height);
+
+/*! @brief Retrieves the size of the framebuffer of the specified window.
+ *
+ *  This function retrieves the size, in pixels, of the framebuffer of the
+ *  specified window.  If you wish to retrieve the size of the window in screen
+ *  coordinates, see @ref glfwGetWindowSize.
+ *
+ *  Any or all of the size arguments may be `NULL`.  If an error occurs, all
+ *  non-`NULL` size arguments will be set to zero.
+ *
+ *  @param[in] window The window whose framebuffer to query.
+ *  @param[out] width Where to store the width, in pixels, of the framebuffer,
+ *  or `NULL`.
+ *  @param[out] height Where to store the height, in pixels, of the framebuffer,
+ *  or `NULL`.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_fbsize
+ *  @sa @ref glfwSetFramebufferSizeCallback
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwGetFramebufferSize(GLFWwindow* window, int* width, int* height);
+
+/*! @brief Retrieves the size of the frame of the window.
+ *
+ *  This function retrieves the size, in screen coordinates, of each edge of the
+ *  frame of the specified window.  This size includes the title bar, if the
+ *  window has one.  The size of the frame may vary depending on the
+ *  [window-related hints](@ref window_hints_wnd) used to create it.
+ *
+ *  Because this function retrieves the size of each window frame edge and not
+ *  the offset along a particular coordinate axis, the retrieved values will
+ *  always be zero or positive.
+ *
+ *  Any or all of the size arguments may be `NULL`.  If an error occurs, all
+ *  non-`NULL` size arguments will be set to zero.
+ *
+ *  @param[in] window The window whose frame size to query.
+ *  @param[out] left Where to store the size, in screen coordinates, of the left
+ *  edge of the window frame, or `NULL`.
+ *  @param[out] top Where to store the size, in screen coordinates, of the top
+ *  edge of the window frame, or `NULL`.
+ *  @param[out] right Where to store the size, in screen coordinates, of the
+ *  right edge of the window frame, or `NULL`.
+ *  @param[out] bottom Where to store the size, in screen coordinates, of the
+ *  bottom edge of the window frame, or `NULL`.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_size
+ *
+ *  @since Added in version 3.1.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwGetWindowFrameSize(GLFWwindow* window, int* left, int* top, int* right, int* bottom);
+
+/*! @brief Retrieves the content scale for the specified window.
+ *
+ *  This function retrieves the content scale for the specified window.  The
+ *  content scale is the ratio between the current DPI and the platform's
+ *  default DPI.  If you scale all pixel dimensions by this scale then your
+ *  content should appear at an appropriate size.  This is especially important
+ *  for text and any UI elements.
+ *
+ *  On systems where each monitors can have its own content scale, the window
+ *  content scale will depend on which monitor the system considers the window
+ *  to be on.
+ *
+ *  @param[in] window The window to query.
+ *  @param[out] xscale Where to store the x-axis content scale, or `NULL`.
+ *  @param[out] yscale Where to store the y-axis content scale, or `NULL`.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_scale
+ *  @sa @ref glfwSetWindowContentScaleCallback
+ *  @sa @ref glfwGetMonitorContentScale
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwGetWindowContentScale(GLFWwindow* window, float* xscale, float* yscale);
+
+/*! @brief Returns the opacity of the whole window.
+ *
+ *  This function returns the opacity of the window, including any decorations.
+ *
+ *  The opacity (or alpha) value is a positive finite number between zero and
+ *  one, where zero is fully transparent and one is fully opaque.  If the system
+ *  does not support whole window transparency, this function always returns one.
+ *
+ *  The initial opacity value for newly created windows is one.
+ *
+ *  @param[in] window The window to query.
+ *  @return The opacity value of the specified window.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_transparency
+ *  @sa @ref glfwSetWindowOpacity
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup window
+ */
+GLFWAPI float glfwGetWindowOpacity(GLFWwindow* window);
+
+/*! @brief Sets the opacity of the whole window.
+ *
+ *  This function sets the opacity of the window, including any decorations.
+ *
+ *  The opacity (or alpha) value is a positive finite number between zero and
+ *  one, where zero is fully transparent and one is fully opaque.
+ *
+ *  The initial opacity value for newly created windows is one.
+ *
+ *  A window created with framebuffer transparency may not use whole window
+ *  transparency.  The results of doing this are undefined.
+ *
+ *  @param[in] window The window to set the opacity for.
+ *  @param[in] opacity The desired opacity of the specified window.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_transparency
+ *  @sa @ref glfwGetWindowOpacity
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwSetWindowOpacity(GLFWwindow* window, float opacity);
+
+/*! @brief Iconifies the specified window.
+ *
+ *  This function iconifies (minimizes) the specified window if it was
+ *  previously restored.  If the window is already iconified, this function does
+ *  nothing.
+ *
+ *  If the specified window is a full screen window, the original monitor
+ *  resolution is restored until the window is restored.
+ *
+ *  @param[in] window The window to iconify.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @remark @wayland There is no concept of iconification in wl_shell, this
+ *  function will emit @ref GLFW_PLATFORM_ERROR when using this deprecated
+ *  protocol.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_iconify
+ *  @sa @ref glfwRestoreWindow
+ *  @sa @ref glfwMaximizeWindow
+ *
+ *  @since Added in version 2.1.
+ *  @glfw3 Added window handle parameter.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwIconifyWindow(GLFWwindow* window);
+
+/*! @brief Restores the specified window.
+ *
+ *  This function restores the specified window if it was previously iconified
+ *  (minimized) or maximized.  If the window is already restored, this function
+ *  does nothing.
+ *
+ *  If the specified window is a full screen window, the resolution chosen for
+ *  the window is restored on the selected monitor.
+ *
+ *  @param[in] window The window to restore.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_iconify
+ *  @sa @ref glfwIconifyWindow
+ *  @sa @ref glfwMaximizeWindow
+ *
+ *  @since Added in version 2.1.
+ *  @glfw3 Added window handle parameter.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwRestoreWindow(GLFWwindow* window);
+
+/*! @brief Maximizes the specified window.
+ *
+ *  This function maximizes the specified window if it was previously not
+ *  maximized.  If the window is already maximized, this function does nothing.
+ *
+ *  If the specified window is a full screen window, this function does nothing.
+ *
+ *  @param[in] window The window to maximize.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @par Thread Safety
+ *  This function may only be called from the main thread.
+ *
+ *  @sa @ref window_iconify
+ *  @sa @ref glfwIconifyWindow
+ *  @sa @ref glfwRestoreWindow
+ *
+ *  @since Added in GLFW 3.2.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwMaximizeWindow(GLFWwindow* window);
+
+/*! @brief Makes the specified window visible.
+ *
+ *  This function makes the specified window visible if it was previously
+ *  hidden.  If the window is already visible or is in full screen mode, this
+ *  function does nothing.
+ *
+ *  By default, windowed mode windows are focused when shown
+ *  Set the [GLFW_FOCUS_ON_SHOW](@ref GLFW_FOCUS_ON_SHOW_hint) window hint
+ *  to change this behavior for all newly created windows, or change the
+ *  behavior for an existing window with @ref glfwSetWindowAttrib.
+ *
+ *  @param[in] window The window to make visible.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_hide
+ *  @sa @ref glfwHideWindow
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwShowWindow(GLFWwindow* window);
+
+/*! @brief Hides the specified window.
+ *
+ *  This function hides the specified window if it was previously visible.  If
+ *  the window is already hidden or is in full screen mode, this function does
+ *  nothing.
+ *
+ *  @param[in] window The window to hide.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_hide
+ *  @sa @ref glfwShowWindow
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwHideWindow(GLFWwindow* window);
+
+/*! @brief Brings the specified window to front and sets input focus.
+ *
+ *  This function brings the specified window to front and sets input focus.
+ *  The window should already be visible and not iconified.
+ *
+ *  By default, both windowed and full screen mode windows are focused when
+ *  initially created.  Set the [GLFW_FOCUSED](@ref GLFW_FOCUSED_hint) to
+ *  disable this behavior.
+ *
+ *  Also by default, windowed mode windows are focused when shown
+ *  with @ref glfwShowWindow. Set the
+ *  [GLFW_FOCUS_ON_SHOW](@ref GLFW_FOCUS_ON_SHOW_hint) to disable this behavior.
+ *
+ *  __Do not use this function__ to steal focus from other applications unless
+ *  you are certain that is what the user wants.  Focus stealing can be
+ *  extremely disruptive.
+ *
+ *  For a less disruptive way of getting the user's attention, see
+ *  [attention requests](@ref window_attention).
+ *
+ *  @param[in] window The window to give input focus.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @remark @wayland It is not possible for an application to bring its windows
+ *  to front, this function will always emit @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_focus
+ *  @sa @ref window_attention
+ *
+ *  @since Added in version 3.2.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwFocusWindow(GLFWwindow* window);
+
+/*! @brief Requests user attention to the specified window.
+ *
+ *  This function requests user attention to the specified window.  On
+ *  platforms where this is not supported, attention is requested to the
+ *  application as a whole.
+ *
+ *  Once the user has given attention, usually by focusing the window or
+ *  application, the system will end the request automatically.
+ *
+ *  @param[in] window The window to request attention to.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @remark @macos Attention is requested to the application as a whole, not the
+ *  specific window.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_attention
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwRequestWindowAttention(GLFWwindow* window);
+
+/*! @brief Returns the monitor that the window uses for full screen mode.
+ *
+ *  This function returns the handle of the monitor that the specified window is
+ *  in full screen on.
+ *
+ *  @param[in] window The window to query.
+ *  @return The monitor, or `NULL` if the window is in windowed mode or an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_monitor
+ *  @sa @ref glfwSetWindowMonitor
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup window
+ */
+GLFWAPI GLFWmonitor* glfwGetWindowMonitor(GLFWwindow* window);
+
+/*! @brief Sets the mode, monitor, video mode and placement of a window.
+ *
+ *  This function sets the monitor that the window uses for full screen mode or,
+ *  if the monitor is `NULL`, makes it windowed mode.
+ *
+ *  When setting a monitor, this function updates the width, height and refresh
+ *  rate of the desired video mode and switches to the video mode closest to it.
+ *  The window position is ignored when setting a monitor.
+ *
+ *  When the monitor is `NULL`, the position, width and height are used to
+ *  place the window client area.  The refresh rate is ignored when no monitor
+ *  is specified.
+ *
+ *  If you only wish to update the resolution of a full screen window or the
+ *  size of a windowed mode window, see @ref glfwSetWindowSize.
+ *
+ *  When a window transitions from full screen to windowed mode, this function
+ *  restores any previous window settings such as whether it is decorated,
+ *  floating, resizable, has size or aspect ratio limits, etc.
+ *
+ *  @param[in] window The window whose monitor, size or video mode to set.
+ *  @param[in] monitor The desired monitor, or `NULL` to set windowed mode.
+ *  @param[in] xpos The desired x-coordinate of the upper-left corner of the
+ *  client area.
+ *  @param[in] ypos The desired y-coordinate of the upper-left corner of the
+ *  client area.
+ *  @param[in] width The desired with, in screen coordinates, of the client area
+ *  or video mode.
+ *  @param[in] height The desired height, in screen coordinates, of the client
+ *  area or video mode.
+ *  @param[in] refreshRate The desired refresh rate, in Hz, of the video mode,
+ *  or `GLFW_DONT_CARE`.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @remark The OpenGL or OpenGL ES context will not be destroyed or otherwise
+ *  affected by any resizing or mode switching, although you may need to update
+ *  your viewport if the framebuffer size has changed.
+ *
+ *  @remark @wayland The desired window position is ignored, as there is no way
+ *  for an application to set this property.
+ *
+ *  @remark @wayland Setting the window to full screen will not attempt to
+ *  change the mode, no matter what the requested size or refresh rate.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_monitor
+ *  @sa @ref window_full_screen
+ *  @sa @ref glfwGetWindowMonitor
+ *  @sa @ref glfwSetWindowSize
+ *
+ *  @since Added in version 3.2.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwSetWindowMonitor(GLFWwindow* window, GLFWmonitor* monitor, int xpos, int ypos, int width, int height, int refreshRate);
+
+/*! @brief Returns an attribute of the specified window.
+ *
+ *  This function returns the value of an attribute of the specified window or
+ *  its OpenGL or OpenGL ES context.
+ *
+ *  @param[in] window The window to query.
+ *  @param[in] attrib The [window attribute](@ref window_attribs) whose value to
+ *  return.
+ *  @return The value of the attribute, or zero if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @remark Framebuffer related hints are not window attributes.  See @ref
+ *  window_attribs_fb for more information.
+ *
+ *  @remark Zero is a valid value for many window and context related
+ *  attributes so you cannot use a return value of zero as an indication of
+ *  errors.  However, this function should not fail as long as it is passed
+ *  valid arguments and the library has been [initialized](@ref intro_init).
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_attribs
+ *  @sa @ref glfwSetWindowAttrib
+ *
+ *  @since Added in version 3.0.  Replaces `glfwGetWindowParam` and
+ *  `glfwGetGLVersion`.
+ *
+ *  @ingroup window
+ */
+GLFWAPI int glfwGetWindowAttrib(GLFWwindow* window, int attrib);
+
+/*! @brief Sets an attribute of the specified window.
+ *
+ *  This function sets the value of an attribute of the specified window.
+ *
+ *  The supported attributes are [GLFW_DECORATED](@ref GLFW_DECORATED_attrib),
+ *  [GLFW_RESIZABLE](@ref GLFW_RESIZABLE_attrib),
+ *  [GLFW_FLOATING](@ref GLFW_FLOATING_attrib),
+ *  [GLFW_AUTO_ICONIFY](@ref GLFW_AUTO_ICONIFY_attrib) and
+ *  [GLFW_FOCUS_ON_SHOW](@ref GLFW_FOCUS_ON_SHOW_attrib).
+ *
+ *  Some of these attributes are ignored for full screen windows.  The new
+ *  value will take effect if the window is later made windowed.
+ *
+ *  Some of these attributes are ignored for windowed mode windows.  The new
+ *  value will take effect if the window is later made full screen.
+ *
+ *  @param[in] window The window to set the attribute for.
+ *  @param[in] attrib A supported window attribute.
+ *  @param[in] value `GLFW_TRUE` or `GLFW_FALSE`.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_INVALID_ENUM, @ref GLFW_INVALID_VALUE and @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @remark Calling @ref glfwGetWindowAttrib will always return the latest
+ *  value, even if that value is ignored by the current mode of the window.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_attribs
+ *  @sa @ref glfwGetWindowAttrib
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwSetWindowAttrib(GLFWwindow* window, int attrib, int value);
+
+/*! @brief Sets the user pointer of the specified window.
+ *
+ *  This function sets the user-defined pointer of the specified window.  The
+ *  current value is retained until the window is destroyed.  The initial value
+ *  is `NULL`.
+ *
+ *  @param[in] window The window whose pointer to set.
+ *  @param[in] pointer The new value.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @sa @ref window_userptr
+ *  @sa @ref glfwGetWindowUserPointer
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwSetWindowUserPointer(GLFWwindow* window, void* pointer);
+
+/*! @brief Returns the user pointer of the specified window.
+ *
+ *  This function returns the current value of the user-defined pointer of the
+ *  specified window.  The initial value is `NULL`.
+ *
+ *  @param[in] window The window whose pointer to return.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @sa @ref window_userptr
+ *  @sa @ref glfwSetWindowUserPointer
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void* glfwGetWindowUserPointer(GLFWwindow* window);
+
+/*! @brief Sets the position callback for the specified window.
+ *
+ *  This function sets the position callback of the specified window, which is
+ *  called when the window is moved.  The callback is provided with the
+ *  position, in screen coordinates, of the upper-left corner of the client area
+ *  of the window.
+ *
+ *  @param[in] window The window whose callback to set.
+ *  @param[in] cbfun The new callback, or `NULL` to remove the currently set
+ *  callback.
+ *  @return The previously set callback, or `NULL` if no callback was set or the
+ *  library had not been [initialized](@ref intro_init).
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @remark @wayland This callback will never be called, as there is no way for
+ *  an application to know its global position.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_pos
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup window
+ */
+GLFWAPI GLFWwindowposfun glfwSetWindowPosCallback(GLFWwindow* window, GLFWwindowposfun cbfun);
+
+/*! @brief Sets the size callback for the specified window.
+ *
+ *  This function sets the size callback of the specified window, which is
+ *  called when the window is resized.  The callback is provided with the size,
+ *  in screen coordinates, of the client area of the window.
+ *
+ *  @param[in] window The window whose callback to set.
+ *  @param[in] cbfun The new callback, or `NULL` to remove the currently set
+ *  callback.
+ *  @return The previously set callback, or `NULL` if no callback was set or the
+ *  library had not been [initialized](@ref intro_init).
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_size
+ *
+ *  @since Added in version 1.0.
+ *  @glfw3 Added window handle parameter and return value.
+ *
+ *  @ingroup window
+ */
+GLFWAPI GLFWwindowsizefun glfwSetWindowSizeCallback(GLFWwindow* window, GLFWwindowsizefun cbfun);
+
+/*! @brief Sets the close callback for the specified window.
+ *
+ *  This function sets the close callback of the specified window, which is
+ *  called when the user attempts to close the window, for example by clicking
+ *  the close widget in the title bar.
+ *
+ *  The close flag is set before this callback is called, but you can modify it
+ *  at any time with @ref glfwSetWindowShouldClose.
+ *
+ *  The close callback is not triggered by @ref glfwDestroyWindow.
+ *
+ *  @param[in] window The window whose callback to set.
+ *  @param[in] cbfun The new callback, or `NULL` to remove the currently set
+ *  callback.
+ *  @return The previously set callback, or `NULL` if no callback was set or the
+ *  library had not been [initialized](@ref intro_init).
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @remark @macos Selecting Quit from the application menu will trigger the
+ *  close callback for all windows.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_close
+ *
+ *  @since Added in version 2.5.
+ *  @glfw3 Added window handle parameter and return value.
+ *
+ *  @ingroup window
+ */
+GLFWAPI GLFWwindowclosefun glfwSetWindowCloseCallback(GLFWwindow* window, GLFWwindowclosefun cbfun);
+
+/*! @brief Sets the refresh callback for the specified window.
+ *
+ *  This function sets the refresh callback of the specified window, which is
+ *  called when the client area of the window needs to be redrawn, for example
+ *  if the window has been exposed after having been covered by another window.
+ *
+ *  On compositing window systems such as Aero, Compiz, Aqua or Wayland, where
+ *  the window contents are saved off-screen, this callback may be called only
+ *  very infrequently or never at all.
+ *
+ *  @param[in] window The window whose callback to set.
+ *  @param[in] cbfun The new callback, or `NULL` to remove the currently set
+ *  callback.
+ *  @return The previously set callback, or `NULL` if no callback was set or the
+ *  library had not been [initialized](@ref intro_init).
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_refresh
+ *
+ *  @since Added in version 2.5.
+ *  @glfw3 Added window handle parameter and return value.
+ *
+ *  @ingroup window
+ */
+GLFWAPI GLFWwindowrefreshfun glfwSetWindowRefreshCallback(GLFWwindow* window, GLFWwindowrefreshfun cbfun);
+
+/*! @brief Sets the focus callback for the specified window.
+ *
+ *  This function sets the focus callback of the specified window, which is
+ *  called when the window gains or loses input focus.
+ *
+ *  After the focus callback is called for a window that lost input focus,
+ *  synthetic key and mouse button release events will be generated for all such
+ *  that had been pressed.  For more information, see @ref glfwSetKeyCallback
+ *  and @ref glfwSetMouseButtonCallback.
+ *
+ *  @param[in] window The window whose callback to set.
+ *  @param[in] cbfun The new callback, or `NULL` to remove the currently set
+ *  callback.
+ *  @return The previously set callback, or `NULL` if no callback was set or the
+ *  library had not been [initialized](@ref intro_init).
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_focus
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup window
+ */
+GLFWAPI GLFWwindowfocusfun glfwSetWindowFocusCallback(GLFWwindow* window, GLFWwindowfocusfun cbfun);
+
+/*! @brief Sets the iconify callback for the specified window.
+ *
+ *  This function sets the iconification callback of the specified window, which
+ *  is called when the window is iconified or restored.
+ *
+ *  @param[in] window The window whose callback to set.
+ *  @param[in] cbfun The new callback, or `NULL` to remove the currently set
+ *  callback.
+ *  @return The previously set callback, or `NULL` if no callback was set or the
+ *  library had not been [initialized](@ref intro_init).
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @remark @wayland The wl_shell protocol has no concept of iconification,
+ *  this callback will never be called when using this deprecated protocol.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_iconify
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup window
+ */
+GLFWAPI GLFWwindowiconifyfun glfwSetWindowIconifyCallback(GLFWwindow* window, GLFWwindowiconifyfun cbfun);
+
+/*! @brief Sets the maximize callback for the specified window.
+ *
+ *  This function sets the maximization callback of the specified window, which
+ *  is called when the window is maximized or restored.
+ *
+ *  @param[in] window The window whose callback to set.
+ *  @param[in] cbfun The new callback, or `NULL` to remove the currently set
+ *  callback.
+ *  @return The previously set callback, or `NULL` if no callback was set or the
+ *  library had not been [initialized](@ref intro_init).
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_maximize
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup window
+ */
+GLFWAPI GLFWwindowmaximizefun glfwSetWindowMaximizeCallback(GLFWwindow* window, GLFWwindowmaximizefun cbfun);
+
+/*! @brief Sets the framebuffer resize callback for the specified window.
+ *
+ *  This function sets the framebuffer resize callback of the specified window,
+ *  which is called when the framebuffer of the specified window is resized.
+ *
+ *  @param[in] window The window whose callback to set.
+ *  @param[in] cbfun The new callback, or `NULL` to remove the currently set
+ *  callback.
+ *  @return The previously set callback, or `NULL` if no callback was set or the
+ *  library had not been [initialized](@ref intro_init).
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_fbsize
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup window
+ */
+GLFWAPI GLFWframebuffersizefun glfwSetFramebufferSizeCallback(GLFWwindow* window, GLFWframebuffersizefun cbfun);
+
+/*! @brief Sets the window content scale callback for the specified window.
+ *
+ *  This function sets the window content scale callback of the specified window,
+ *  which is called when the content scale of the specified window changes.
+ *
+ *  @param[in] window The window whose callback to set.
+ *  @param[in] cbfun The new callback, or `NULL` to remove the currently set
+ *  callback.
+ *  @return The previously set callback, or `NULL` if no callback was set or the
+ *  library had not been [initialized](@ref intro_init).
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref window_scale
+ *  @sa @ref glfwGetWindowContentScale
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup window
+ */
+GLFWAPI GLFWwindowcontentscalefun glfwSetWindowContentScaleCallback(GLFWwindow* window, GLFWwindowcontentscalefun cbfun);
+
+/*! @brief Processes all pending events.
+ *
+ *  This function processes only those events that are already in the event
+ *  queue and then returns immediately.  Processing events will cause the window
+ *  and input callbacks associated with those events to be called.
+ *
+ *  On some platforms, a window move, resize or menu operation will cause event
+ *  processing to block.  This is due to how event processing is designed on
+ *  those platforms.  You can use the
+ *  [window refresh callback](@ref window_refresh) to redraw the contents of
+ *  your window when necessary during such operations.
+ *
+ *  Do not assume that callbacks you set will _only_ be called in response to
+ *  event processing functions like this one.  While it is necessary to poll for
+ *  events, window systems that require GLFW to register callbacks of its own
+ *  can pass events to GLFW in response to many window system function calls.
+ *  GLFW will pass those events on to the application callbacks before
+ *  returning.
+ *
+ *  Event processing is not required for joystick input to work.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @reentrancy This function must not be called from a callback.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref events
+ *  @sa @ref glfwWaitEvents
+ *  @sa @ref glfwWaitEventsTimeout
+ *
+ *  @since Added in version 1.0.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwPollEvents(void);
+
+/*! @brief Waits until events are queued and processes them.
+ *
+ *  This function puts the calling thread to sleep until at least one event is
+ *  available in the event queue.  Once one or more events are available,
+ *  it behaves exactly like @ref glfwPollEvents, i.e. the events in the queue
+ *  are processed and the function then returns immediately.  Processing events
+ *  will cause the window and input callbacks associated with those events to be
+ *  called.
+ *
+ *  Since not all events are associated with callbacks, this function may return
+ *  without a callback having been called even if you are monitoring all
+ *  callbacks.
+ *
+ *  On some platforms, a window move, resize or menu operation will cause event
+ *  processing to block.  This is due to how event processing is designed on
+ *  those platforms.  You can use the
+ *  [window refresh callback](@ref window_refresh) to redraw the contents of
+ *  your window when necessary during such operations.
+ *
+ *  Do not assume that callbacks you set will _only_ be called in response to
+ *  event processing functions like this one.  While it is necessary to poll for
+ *  events, window systems that require GLFW to register callbacks of its own
+ *  can pass events to GLFW in response to many window system function calls.
+ *  GLFW will pass those events on to the application callbacks before
+ *  returning.
+ *
+ *  If no windows exist, this function returns immediately.  For synchronization
+ *  of threads in applications that do not create windows, use your threading
+ *  library of choice.
+ *
+ *  Event processing is not required for joystick input to work.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @reentrancy This function must not be called from a callback.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref events
+ *  @sa @ref glfwPollEvents
+ *  @sa @ref glfwWaitEventsTimeout
+ *
+ *  @since Added in version 2.5.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwWaitEvents(void);
+
+/*! @brief Waits with timeout until events are queued and processes them.
+ *
+ *  This function puts the calling thread to sleep until at least one event is
+ *  available in the event queue, or until the specified timeout is reached.  If
+ *  one or more events are available, it behaves exactly like @ref
+ *  glfwPollEvents, i.e. the events in the queue are processed and the function
+ *  then returns immediately.  Processing events will cause the window and input
+ *  callbacks associated with those events to be called.
+ *
+ *  The timeout value must be a positive finite number.
+ *
+ *  Since not all events are associated with callbacks, this function may return
+ *  without a callback having been called even if you are monitoring all
+ *  callbacks.
+ *
+ *  On some platforms, a window move, resize or menu operation will cause event
+ *  processing to block.  This is due to how event processing is designed on
+ *  those platforms.  You can use the
+ *  [window refresh callback](@ref window_refresh) to redraw the contents of
+ *  your window when necessary during such operations.
+ *
+ *  Do not assume that callbacks you set will _only_ be called in response to
+ *  event processing functions like this one.  While it is necessary to poll for
+ *  events, window systems that require GLFW to register callbacks of its own
+ *  can pass events to GLFW in response to many window system function calls.
+ *  GLFW will pass those events on to the application callbacks before
+ *  returning.
+ *
+ *  If no windows exist, this function returns immediately.  For synchronization
+ *  of threads in applications that do not create windows, use your threading
+ *  library of choice.
+ *
+ *  Event processing is not required for joystick input to work.
+ *
+ *  @param[in] timeout The maximum amount of time, in seconds, to wait.
+ *
+ *  @reentrancy This function must not be called from a callback.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref events
+ *  @sa @ref glfwPollEvents
+ *  @sa @ref glfwWaitEvents
+ *
+ *  @since Added in version 3.2.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwWaitEventsTimeout(double timeout);
+
+/*! @brief Posts an empty event to the event queue.
+ *
+ *  This function posts an empty event from the current thread to the event
+ *  queue, causing @ref glfwWaitEvents or @ref glfwWaitEventsTimeout to return.
+ *
+ *  If no windows exist, this function returns immediately.  For synchronization
+ *  of threads in applications that do not create windows, use your threading
+ *  library of choice.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function may be called from any thread.
+ *
+ *  @sa @ref events
+ *  @sa @ref glfwWaitEvents
+ *  @sa @ref glfwWaitEventsTimeout
+ *
+ *  @since Added in version 3.1.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwPostEmptyEvent(void);
+
+/*! @brief Returns the value of an input option for the specified window.
+ *
+ *  This function returns the value of an input option for the specified window.
+ *  The mode must be one of @ref GLFW_CURSOR, @ref GLFW_STICKY_KEYS,
+ *  @ref GLFW_STICKY_MOUSE_BUTTONS or @ref GLFW_LOCK_KEY_MODS.
+ *
+ *  @param[in] window The window to query.
+ *  @param[in] mode One of `GLFW_CURSOR`, `GLFW_STICKY_KEYS`,
+ *  `GLFW_STICKY_MOUSE_BUTTONS` or `GLFW_LOCK_KEY_MODS`.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_INVALID_ENUM.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref glfwSetInputMode
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup input
+ */
+GLFWAPI int glfwGetInputMode(GLFWwindow* window, int mode);
+
+/*! @brief Sets an input option for the specified window.
+ *
+ *  This function sets an input mode option for the specified window.  The mode
+ *  must be one of @ref GLFW_CURSOR, @ref GLFW_STICKY_KEYS,
+ *  @ref GLFW_STICKY_MOUSE_BUTTONS or @ref GLFW_LOCK_KEY_MODS.
+ *
+ *  If the mode is `GLFW_CURSOR`, the value must be one of the following cursor
+ *  modes:
+ *  - `GLFW_CURSOR_NORMAL` makes the cursor visible and behaving normally.
+ *  - `GLFW_CURSOR_HIDDEN` makes the cursor invisible when it is over the client
+ *    area of the window but does not restrict the cursor from leaving.
+ *  - `GLFW_CURSOR_DISABLED` hides and grabs the cursor, providing virtual
+ *    and unlimited cursor movement.  This is useful for implementing for
+ *    example 3D camera controls.
+ *
+ *  If the mode is `GLFW_STICKY_KEYS`, the value must be either `GLFW_TRUE` to
+ *  enable sticky keys, or `GLFW_FALSE` to disable it.  If sticky keys are
+ *  enabled, a key press will ensure that @ref glfwGetKey returns `GLFW_PRESS`
+ *  the next time it is called even if the key had been released before the
+ *  call.  This is useful when you are only interested in whether keys have been
+ *  pressed but not when or in which order.
+ *
+ *  If the mode is `GLFW_STICKY_MOUSE_BUTTONS`, the value must be either
+ *  `GLFW_TRUE` to enable sticky mouse buttons, or `GLFW_FALSE` to disable it.
+ *  If sticky mouse buttons are enabled, a mouse button press will ensure that
+ *  @ref glfwGetMouseButton returns `GLFW_PRESS` the next time it is called even
+ *  if the mouse button had been released before the call.  This is useful when
+ *  you are only interested in whether mouse buttons have been pressed but not
+ *  when or in which order.
+ *
+ *  If the mode is `GLFW_LOCK_KEY_MODS`, the value must be either `GLFW_TRUE` to
+ *  enable lock key modifier bits, or `GLFW_FALSE` to disable them.  If enabled,
+ *  callbacks that receive modifier bits will also have the @ref
+ *  GLFW_MOD_CAPS_LOCK bit set when the event was generated with Caps Lock on,
+ *  and the @ref GLFW_MOD_NUM_LOCK bit when Num Lock was on.
+ *
+ *  @param[in] window The window whose input mode to set.
+ *  @param[in] mode One of `GLFW_CURSOR`, `GLFW_STICKY_KEYS`,
+ *  `GLFW_STICKY_MOUSE_BUTTONS` or `GLFW_LOCK_KEY_MODS`.
+ *  @param[in] value The new value of the specified input mode.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref glfwGetInputMode
+ *
+ *  @since Added in version 3.0.  Replaces `glfwEnable` and `glfwDisable`.
+ *
+ *  @ingroup input
+ */
+GLFWAPI void glfwSetInputMode(GLFWwindow* window, int mode, int value);
+
+/*! @brief Returns the layout-specific name of the specified printable key.
+ *
+ *  This function returns the name of the specified printable key, encoded as
+ *  UTF-8.  This is typically the character that key would produce without any
+ *  modifier keys, intended for displaying key bindings to the user.  For dead
+ *  keys, it is typically the diacritic it would add to a character.
+ *
+ *  __Do not use this function__ for [text input](@ref input_char).  You will
+ *  break text input for many languages even if it happens to work for yours.
+ *
+ *  If the key is `GLFW_KEY_UNKNOWN`, the scancode is used to identify the key,
+ *  otherwise the scancode is ignored.  If you specify a non-printable key, or
+ *  `GLFW_KEY_UNKNOWN` and a scancode that maps to a non-printable key, this
+ *  function returns `NULL` but does not emit an error.
+ *
+ *  This behavior allows you to always pass in the arguments in the
+ *  [key callback](@ref input_key) without modification.
+ *
+ *  The printable keys are:
+ *  - `GLFW_KEY_APOSTROPHE`
+ *  - `GLFW_KEY_COMMA`
+ *  - `GLFW_KEY_MINUS`
+ *  - `GLFW_KEY_PERIOD`
+ *  - `GLFW_KEY_SLASH`
+ *  - `GLFW_KEY_SEMICOLON`
+ *  - `GLFW_KEY_EQUAL`
+ *  - `GLFW_KEY_LEFT_BRACKET`
+ *  - `GLFW_KEY_RIGHT_BRACKET`
+ *  - `GLFW_KEY_BACKSLASH`
+ *  - `GLFW_KEY_WORLD_1`
+ *  - `GLFW_KEY_WORLD_2`
+ *  - `GLFW_KEY_0` to `GLFW_KEY_9`
+ *  - `GLFW_KEY_A` to `GLFW_KEY_Z`
+ *  - `GLFW_KEY_KP_0` to `GLFW_KEY_KP_9`
+ *  - `GLFW_KEY_KP_DECIMAL`
+ *  - `GLFW_KEY_KP_DIVIDE`
+ *  - `GLFW_KEY_KP_MULTIPLY`
+ *  - `GLFW_KEY_KP_SUBTRACT`
+ *  - `GLFW_KEY_KP_ADD`
+ *  - `GLFW_KEY_KP_EQUAL`
+ *
+ *  Names for printable keys depend on keyboard layout, while names for
+ *  non-printable keys are the same across layouts but depend on the application
+ *  language and should be localized along with other user interface text.
+ *
+ *  @param[in] key The key to query, or `GLFW_KEY_UNKNOWN`.
+ *  @param[in] scancode The scancode of the key to query.
+ *  @return The UTF-8 encoded, layout-specific name of the key, or `NULL`.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @pointer_lifetime The returned string is allocated and freed by GLFW.  You
+ *  should not free it yourself.  It is valid until the next call to @ref
+ *  glfwGetKeyName, or until the library is terminated.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref input_key_name
+ *
+ *  @since Added in version 3.2.
+ *
+ *  @ingroup input
+ */
+GLFWAPI const char* glfwGetKeyName(int key, int scancode);
+
+/*! @brief Returns the platform-specific scancode of the specified key.
+ *
+ *  This function returns the platform-specific scancode of the specified key.
+ *
+ *  If the key is `GLFW_KEY_UNKNOWN` or does not exist on the keyboard this
+ *  method will return `-1`.
+ *
+ *  @param[in] key Any [named key](@ref keys).
+ *  @return The platform-specific scancode for the key, or `-1` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function may be called from any thread.
+ *
+ *  @sa @ref input_key
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup input
+ */
+GLFWAPI int glfwGetKeyScancode(int key);
+
+/*! @brief Returns the last reported state of a keyboard key for the specified
+ *  window.
+ *
+ *  This function returns the last state reported for the specified key to the
+ *  specified window.  The returned state is one of `GLFW_PRESS` or
+ *  `GLFW_RELEASE`.  The higher-level action `GLFW_REPEAT` is only reported to
+ *  the key callback.
+ *
+ *  If the @ref GLFW_STICKY_KEYS input mode is enabled, this function returns
+ *  `GLFW_PRESS` the first time you call it for a key that was pressed, even if
+ *  that key has already been released.
+ *
+ *  The key functions deal with physical keys, with [key tokens](@ref keys)
+ *  named after their use on the standard US keyboard layout.  If you want to
+ *  input text, use the Unicode character callback instead.
+ *
+ *  The [modifier key bit masks](@ref mods) are not key tokens and cannot be
+ *  used with this function.
+ *
+ *  __Do not use this function__ to implement [text input](@ref input_char).
+ *
+ *  @param[in] window The desired window.
+ *  @param[in] key The desired [keyboard key](@ref keys).  `GLFW_KEY_UNKNOWN` is
+ *  not a valid key for this function.
+ *  @return One of `GLFW_PRESS` or `GLFW_RELEASE`.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_INVALID_ENUM.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref input_key
+ *
+ *  @since Added in version 1.0.
+ *  @glfw3 Added window handle parameter.
+ *
+ *  @ingroup input
+ */
+GLFWAPI int glfwGetKey(GLFWwindow* window, int key);
+
+/*! @brief Returns the last reported state of a mouse button for the specified
+ *  window.
+ *
+ *  This function returns the last state reported for the specified mouse button
+ *  to the specified window.  The returned state is one of `GLFW_PRESS` or
+ *  `GLFW_RELEASE`.
+ *
+ *  If the @ref GLFW_STICKY_MOUSE_BUTTONS input mode is enabled, this function
+ *  returns `GLFW_PRESS` the first time you call it for a mouse button that was
+ *  pressed, even if that mouse button has already been released.
+ *
+ *  @param[in] window The desired window.
+ *  @param[in] button The desired [mouse button](@ref buttons).
+ *  @return One of `GLFW_PRESS` or `GLFW_RELEASE`.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_INVALID_ENUM.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref input_mouse_button
+ *
+ *  @since Added in version 1.0.
+ *  @glfw3 Added window handle parameter.
+ *
+ *  @ingroup input
+ */
+GLFWAPI int glfwGetMouseButton(GLFWwindow* window, int button);
+
+/*! @brief Retrieves the position of the cursor relative to the client area of
+ *  the window.
+ *
+ *  This function returns the position of the cursor, in screen coordinates,
+ *  relative to the upper-left corner of the client area of the specified
+ *  window.
+ *
+ *  If the cursor is disabled (with `GLFW_CURSOR_DISABLED`) then the cursor
+ *  position is unbounded and limited only by the minimum and maximum values of
+ *  a `double`.
+ *
+ *  The coordinate can be converted to their integer equivalents with the
+ *  `floor` function.  Casting directly to an integer type works for positive
+ *  coordinates, but fails for negative ones.
+ *
+ *  Any or all of the position arguments may be `NULL`.  If an error occurs, all
+ *  non-`NULL` position arguments will be set to zero.
+ *
+ *  @param[in] window The desired window.
+ *  @param[out] xpos Where to store the cursor x-coordinate, relative to the
+ *  left edge of the client area, or `NULL`.
+ *  @param[out] ypos Where to store the cursor y-coordinate, relative to the to
+ *  top edge of the client area, or `NULL`.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref cursor_pos
+ *  @sa @ref glfwSetCursorPos
+ *
+ *  @since Added in version 3.0.  Replaces `glfwGetMousePos`.
+ *
+ *  @ingroup input
+ */
+GLFWAPI void glfwGetCursorPos(GLFWwindow* window, double* xpos, double* ypos);
+
+/*! @brief Sets the position of the cursor, relative to the client area of the
+ *  window.
+ *
+ *  This function sets the position, in screen coordinates, of the cursor
+ *  relative to the upper-left corner of the client area of the specified
+ *  window.  The window must have input focus.  If the window does not have
+ *  input focus when this function is called, it fails silently.
+ *
+ *  __Do not use this function__ to implement things like camera controls.  GLFW
+ *  already provides the `GLFW_CURSOR_DISABLED` cursor mode that hides the
+ *  cursor, transparently re-centers it and provides unconstrained cursor
+ *  motion.  See @ref glfwSetInputMode for more information.
+ *
+ *  If the cursor mode is `GLFW_CURSOR_DISABLED` then the cursor position is
+ *  unconstrained and limited only by the minimum and maximum values of
+ *  a `double`.
+ *
+ *  @param[in] window The desired window.
+ *  @param[in] xpos The desired x-coordinate, relative to the left edge of the
+ *  client area.
+ *  @param[in] ypos The desired y-coordinate, relative to the top edge of the
+ *  client area.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @remark @wayland This function will only work when the cursor mode is
+ *  `GLFW_CURSOR_DISABLED`, otherwise it will do nothing.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref cursor_pos
+ *  @sa @ref glfwGetCursorPos
+ *
+ *  @since Added in version 3.0.  Replaces `glfwSetMousePos`.
+ *
+ *  @ingroup input
+ */
+GLFWAPI void glfwSetCursorPos(GLFWwindow* window, double xpos, double ypos);
+
+/*! @brief Creates a custom cursor.
+ *
+ *  Creates a new custom cursor image that can be set for a window with @ref
+ *  glfwSetCursor.  The cursor can be destroyed with @ref glfwDestroyCursor.
+ *  Any remaining cursors are destroyed by @ref glfwTerminate.
+ *
+ *  The pixels are 32-bit, little-endian, non-premultiplied RGBA, i.e. eight
+ *  bits per channel with the red channel first.  They are arranged canonically
+ *  as packed sequential rows, starting from the top-left corner.
+ *
+ *  The cursor hotspot is specified in pixels, relative to the upper-left corner
+ *  of the cursor image.  Like all other coordinate systems in GLFW, the X-axis
+ *  points to the right and the Y-axis points down.
+ *
+ *  @param[in] image The desired cursor image.
+ *  @param[in] xhot The desired x-coordinate, in pixels, of the cursor hotspot.
+ *  @param[in] yhot The desired y-coordinate, in pixels, of the cursor hotspot.
+ *  @return The handle of the created cursor, or `NULL` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @pointer_lifetime The specified image data is copied before this function
+ *  returns.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref cursor_object
+ *  @sa @ref glfwDestroyCursor
+ *  @sa @ref glfwCreateStandardCursor
+ *
+ *  @since Added in version 3.1.
+ *
+ *  @ingroup input
+ */
+GLFWAPI GLFWcursor* glfwCreateCursor(const GLFWimage* image, int xhot, int yhot);
+
+/*! @brief Creates a cursor with a standard shape.
+ *
+ *  Returns a cursor with a [standard shape](@ref shapes), that can be set for
+ *  a window with @ref glfwSetCursor.
+ *
+ *  @param[in] shape One of the [standard shapes](@ref shapes).
+ *  @return A new cursor ready to use or `NULL` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref cursor_object
+ *  @sa @ref glfwCreateCursor
+ *
+ *  @since Added in version 3.1.
+ *
+ *  @ingroup input
+ */
+GLFWAPI GLFWcursor* glfwCreateStandardCursor(int shape);
+
+/*! @brief Destroys a cursor.
+ *
+ *  This function destroys a cursor previously created with @ref
+ *  glfwCreateCursor.  Any remaining cursors will be destroyed by @ref
+ *  glfwTerminate.
+ *
+ *  If the specified cursor is current for any window, that window will be
+ *  reverted to the default cursor.  This does not affect the cursor mode.
+ *
+ *  @param[in] cursor The cursor object to destroy.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @reentrancy This function must not be called from a callback.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref cursor_object
+ *  @sa @ref glfwCreateCursor
+ *
+ *  @since Added in version 3.1.
+ *
+ *  @ingroup input
+ */
+GLFWAPI void glfwDestroyCursor(GLFWcursor* cursor);
+
+/*! @brief Sets the cursor for the window.
+ *
+ *  This function sets the cursor image to be used when the cursor is over the
+ *  client area of the specified window.  The set cursor will only be visible
+ *  when the [cursor mode](@ref cursor_mode) of the window is
+ *  `GLFW_CURSOR_NORMAL`.
+ *
+ *  On some platforms, the set cursor may not be visible unless the window also
+ *  has input focus.
+ *
+ *  @param[in] window The window to set the cursor for.
+ *  @param[in] cursor The cursor to set, or `NULL` to switch back to the default
+ *  arrow cursor.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref cursor_object
+ *
+ *  @since Added in version 3.1.
+ *
+ *  @ingroup input
+ */
+GLFWAPI void glfwSetCursor(GLFWwindow* window, GLFWcursor* cursor);
+
+/*! @brief Sets the key callback.
+ *
+ *  This function sets the key callback of the specified window, which is called
+ *  when a key is pressed, repeated or released.
+ *
+ *  The key functions deal with physical keys, with layout independent
+ *  [key tokens](@ref keys) named after their values in the standard US keyboard
+ *  layout.  If you want to input text, use the
+ *  [character callback](@ref glfwSetCharCallback) instead.
+ *
+ *  When a window loses input focus, it will generate synthetic key release
+ *  events for all pressed keys.  You can tell these events from user-generated
+ *  events by the fact that the synthetic ones are generated after the focus
+ *  loss event has been processed, i.e. after the
+ *  [window focus callback](@ref glfwSetWindowFocusCallback) has been called.
+ *
+ *  The scancode of a key is specific to that platform or sometimes even to that
+ *  machine.  Scancodes are intended to allow users to bind keys that don't have
+ *  a GLFW key token.  Such keys have `key` set to `GLFW_KEY_UNKNOWN`, their
+ *  state is not saved and so it cannot be queried with @ref glfwGetKey.
+ *
+ *  Sometimes GLFW needs to generate synthetic key events, in which case the
+ *  scancode may be zero.
+ *
+ *  @param[in] window The window whose callback to set.
+ *  @param[in] cbfun The new key callback, or `NULL` to remove the currently
+ *  set callback.
+ *  @return The previously set callback, or `NULL` if no callback was set or the
+ *  library had not been [initialized](@ref intro_init).
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref input_key
+ *
+ *  @since Added in version 1.0.
+ *  @glfw3 Added window handle parameter and return value.
+ *
+ *  @ingroup input
+ */
+GLFWAPI GLFWkeyfun glfwSetKeyCallback(GLFWwindow* window, GLFWkeyfun cbfun);
+
+/*! @brief Sets the Unicode character callback.
+ *
+ *  This function sets the character callback of the specified window, which is
+ *  called when a Unicode character is input.
+ *
+ *  The character callback is intended for Unicode text input.  As it deals with
+ *  characters, it is keyboard layout dependent, whereas the
+ *  [key callback](@ref glfwSetKeyCallback) is not.  Characters do not map 1:1
+ *  to physical keys, as a key may produce zero, one or more characters.  If you
+ *  want to know whether a specific physical key was pressed or released, see
+ *  the key callback instead.
+ *
+ *  The character callback behaves as system text input normally does and will
+ *  not be called if modifier keys are held down that would prevent normal text
+ *  input on that platform, for example a Super (Command) key on macOS or Alt key
+ *  on Windows.  There is a
+ *  [character with modifiers callback](@ref glfwSetCharModsCallback) that
+ *  receives these events.
+ *
+ *  @param[in] window The window whose callback to set.
+ *  @param[in] cbfun The new callback, or `NULL` to remove the currently set
+ *  callback.
+ *  @return The previously set callback, or `NULL` if no callback was set or the
+ *  library had not been [initialized](@ref intro_init).
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref input_char
+ *
+ *  @since Added in version 2.4.
+ *  @glfw3 Added window handle parameter and return value.
+ *
+ *  @ingroup input
+ */
+GLFWAPI GLFWcharfun glfwSetCharCallback(GLFWwindow* window, GLFWcharfun cbfun);
+
+/*! @brief Sets the Unicode character with modifiers callback.
+ *
+ *  This function sets the character with modifiers callback of the specified
+ *  window, which is called when a Unicode character is input regardless of what
+ *  modifier keys are used.
+ *
+ *  The character with modifiers callback is intended for implementing custom
+ *  Unicode character input.  For regular Unicode text input, see the
+ *  [character callback](@ref glfwSetCharCallback).  Like the character
+ *  callback, the character with modifiers callback deals with characters and is
+ *  keyboard layout dependent.  Characters do not map 1:1 to physical keys, as
+ *  a key may produce zero, one or more characters.  If you want to know whether
+ *  a specific physical key was pressed or released, see the
+ *  [key callback](@ref glfwSetKeyCallback) instead.
+ *
+ *  @param[in] window The window whose callback to set.
+ *  @param[in] cbfun The new callback, or `NULL` to remove the currently set
+ *  callback.
+ *  @return The previously set callback, or `NULL` if no callback was set or an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @deprecated Scheduled for removal in version 4.0.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref input_char
+ *
+ *  @since Added in version 3.1.
+ *
+ *  @ingroup input
+ */
+GLFWAPI GLFWcharmodsfun glfwSetCharModsCallback(GLFWwindow* window, GLFWcharmodsfun cbfun);
+
+/*! @brief Sets the mouse button callback.
+ *
+ *  This function sets the mouse button callback of the specified window, which
+ *  is called when a mouse button is pressed or released.
+ *
+ *  When a window loses input focus, it will generate synthetic mouse button
+ *  release events for all pressed mouse buttons.  You can tell these events
+ *  from user-generated events by the fact that the synthetic ones are generated
+ *  after the focus loss event has been processed, i.e. after the
+ *  [window focus callback](@ref glfwSetWindowFocusCallback) has been called.
+ *
+ *  @param[in] window The window whose callback to set.
+ *  @param[in] cbfun The new callback, or `NULL` to remove the currently set
+ *  callback.
+ *  @return The previously set callback, or `NULL` if no callback was set or the
+ *  library had not been [initialized](@ref intro_init).
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref input_mouse_button
+ *
+ *  @since Added in version 1.0.
+ *  @glfw3 Added window handle parameter and return value.
+ *
+ *  @ingroup input
+ */
+GLFWAPI GLFWmousebuttonfun glfwSetMouseButtonCallback(GLFWwindow* window, GLFWmousebuttonfun cbfun);
+
+/*! @brief Sets the cursor position callback.
+ *
+ *  This function sets the cursor position callback of the specified window,
+ *  which is called when the cursor is moved.  The callback is provided with the
+ *  position, in screen coordinates, relative to the upper-left corner of the
+ *  client area of the window.
+ *
+ *  @param[in] window The window whose callback to set.
+ *  @param[in] cbfun The new callback, or `NULL` to remove the currently set
+ *  callback.
+ *  @return The previously set callback, or `NULL` if no callback was set or the
+ *  library had not been [initialized](@ref intro_init).
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref cursor_pos
+ *
+ *  @since Added in version 3.0.  Replaces `glfwSetMousePosCallback`.
+ *
+ *  @ingroup input
+ */
+GLFWAPI GLFWcursorposfun glfwSetCursorPosCallback(GLFWwindow* window, GLFWcursorposfun cbfun);
+
+/*! @brief Sets the cursor enter/exit callback.
+ *
+ *  This function sets the cursor boundary crossing callback of the specified
+ *  window, which is called when the cursor enters or leaves the client area of
+ *  the window.
+ *
+ *  @param[in] window The window whose callback to set.
+ *  @param[in] cbfun The new callback, or `NULL` to remove the currently set
+ *  callback.
+ *  @return The previously set callback, or `NULL` if no callback was set or the
+ *  library had not been [initialized](@ref intro_init).
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref cursor_enter
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup input
+ */
+GLFWAPI GLFWcursorenterfun glfwSetCursorEnterCallback(GLFWwindow* window, GLFWcursorenterfun cbfun);
+
+/*! @brief Sets the scroll callback.
+ *
+ *  This function sets the scroll callback of the specified window, which is
+ *  called when a scrolling device is used, such as a mouse wheel or scrolling
+ *  area of a touchpad.
+ *
+ *  The scroll callback receives all scrolling input, like that from a mouse
+ *  wheel or a touchpad scrolling area.
+ *
+ *  @param[in] window The window whose callback to set.
+ *  @param[in] cbfun The new scroll callback, or `NULL` to remove the currently
+ *  set callback.
+ *  @return The previously set callback, or `NULL` if no callback was set or the
+ *  library had not been [initialized](@ref intro_init).
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref scrolling
+ *
+ *  @since Added in version 3.0.  Replaces `glfwSetMouseWheelCallback`.
+ *
+ *  @ingroup input
+ */
+GLFWAPI GLFWscrollfun glfwSetScrollCallback(GLFWwindow* window, GLFWscrollfun cbfun);
+
+/*! @brief Sets the file drop callback.
+ *
+ *  This function sets the file drop callback of the specified window, which is
+ *  called when one or more dragged files are dropped on the window.
+ *
+ *  Because the path array and its strings may have been generated specifically
+ *  for that event, they are not guaranteed to be valid after the callback has
+ *  returned.  If you wish to use them after the callback returns, you need to
+ *  make a deep copy.
+ *
+ *  @param[in] window The window whose callback to set.
+ *  @param[in] cbfun The new file drop callback, or `NULL` to remove the
+ *  currently set callback.
+ *  @return The previously set callback, or `NULL` if no callback was set or the
+ *  library had not been [initialized](@ref intro_init).
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @remark @wayland File drop is currently unimplemented.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref path_drop
+ *
+ *  @since Added in version 3.1.
+ *
+ *  @ingroup input
+ */
+GLFWAPI GLFWdropfun glfwSetDropCallback(GLFWwindow* window, GLFWdropfun cbfun);
+
+/*! @brief Returns whether the specified joystick is present.
+ *
+ *  This function returns whether the specified joystick is present.
+ *
+ *  There is no need to call this function before other functions that accept
+ *  a joystick ID, as they all check for presence before performing any other
+ *  work.
+ *
+ *  @param[in] jid The [joystick](@ref joysticks) to query.
+ *  @return `GLFW_TRUE` if the joystick is present, or `GLFW_FALSE` otherwise.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref joystick
+ *
+ *  @since Added in version 3.0.  Replaces `glfwGetJoystickParam`.
+ *
+ *  @ingroup input
+ */
+GLFWAPI int glfwJoystickPresent(int jid);
+
+/*! @brief Returns the values of all axes of the specified joystick.
+ *
+ *  This function returns the values of all axes of the specified joystick.
+ *  Each element in the array is a value between -1.0 and 1.0.
+ *
+ *  If the specified joystick is not present this function will return `NULL`
+ *  but will not generate an error.  This can be used instead of first calling
+ *  @ref glfwJoystickPresent.
+ *
+ *  @param[in] jid The [joystick](@ref joysticks) to query.
+ *  @param[out] count Where to store the number of axis values in the returned
+ *  array.  This is set to zero if the joystick is not present or an error
+ *  occurred.
+ *  @return An array of axis values, or `NULL` if the joystick is not present or
+ *  an [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @pointer_lifetime The returned array is allocated and freed by GLFW.  You
+ *  should not free it yourself.  It is valid until the specified joystick is
+ *  disconnected or the library is terminated.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref joystick_axis
+ *
+ *  @since Added in version 3.0.  Replaces `glfwGetJoystickPos`.
+ *
+ *  @ingroup input
+ */
+GLFWAPI const float* glfwGetJoystickAxes(int jid, int* count);
+
+/*! @brief Returns the state of all buttons of the specified joystick.
+ *
+ *  This function returns the state of all buttons of the specified joystick.
+ *  Each element in the array is either `GLFW_PRESS` or `GLFW_RELEASE`.
+ *
+ *  For backward compatibility with earlier versions that did not have @ref
+ *  glfwGetJoystickHats, the button array also includes all hats, each
+ *  represented as four buttons.  The hats are in the same order as returned by
+ *  __glfwGetJoystickHats__ and are in the order _up_, _right_, _down_ and
+ *  _left_.  To disable these extra buttons, set the @ref
+ *  GLFW_JOYSTICK_HAT_BUTTONS init hint before initialization.
+ *
+ *  If the specified joystick is not present this function will return `NULL`
+ *  but will not generate an error.  This can be used instead of first calling
+ *  @ref glfwJoystickPresent.
+ *
+ *  @param[in] jid The [joystick](@ref joysticks) to query.
+ *  @param[out] count Where to store the number of button states in the returned
+ *  array.  This is set to zero if the joystick is not present or an error
+ *  occurred.
+ *  @return An array of button states, or `NULL` if the joystick is not present
+ *  or an [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @pointer_lifetime The returned array is allocated and freed by GLFW.  You
+ *  should not free it yourself.  It is valid until the specified joystick is
+ *  disconnected or the library is terminated.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref joystick_button
+ *
+ *  @since Added in version 2.2.
+ *  @glfw3 Changed to return a dynamic array.
+ *
+ *  @ingroup input
+ */
+GLFWAPI const unsigned char* glfwGetJoystickButtons(int jid, int* count);
+
+/*! @brief Returns the state of all hats of the specified joystick.
+ *
+ *  This function returns the state of all hats of the specified joystick.
+ *  Each element in the array is one of the following values:
+ *
+ *  Name                  | Value
+ *  --------------------- | --------------------------------
+ *  `GLFW_HAT_CENTERED`   | 0
+ *  `GLFW_HAT_UP`         | 1
+ *  `GLFW_HAT_RIGHT`      | 2
+ *  `GLFW_HAT_DOWN`       | 4
+ *  `GLFW_HAT_LEFT`       | 8
+ *  `GLFW_HAT_RIGHT_UP`   | `GLFW_HAT_RIGHT` \| `GLFW_HAT_UP`
+ *  `GLFW_HAT_RIGHT_DOWN` | `GLFW_HAT_RIGHT` \| `GLFW_HAT_DOWN`
+ *  `GLFW_HAT_LEFT_UP`    | `GLFW_HAT_LEFT` \| `GLFW_HAT_UP`
+ *  `GLFW_HAT_LEFT_DOWN`  | `GLFW_HAT_LEFT` \| `GLFW_HAT_DOWN`
+ *
+ *  The diagonal directions are bitwise combinations of the primary (up, right,
+ *  down and left) directions and you can test for these individually by ANDing
+ *  it with the corresponding direction.
+ *
+ *  @code
+ *  if (hats[2] & GLFW_HAT_RIGHT)
+ *  {
+ *      // State of hat 2 could be right-up, right or right-down
+ *  }
+ *  @endcode
+ *
+ *  If the specified joystick is not present this function will return `NULL`
+ *  but will not generate an error.  This can be used instead of first calling
+ *  @ref glfwJoystickPresent.
+ *
+ *  @param[in] jid The [joystick](@ref joysticks) to query.
+ *  @param[out] count Where to store the number of hat states in the returned
+ *  array.  This is set to zero if the joystick is not present or an error
+ *  occurred.
+ *  @return An array of hat states, or `NULL` if the joystick is not present
+ *  or an [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @pointer_lifetime The returned array is allocated and freed by GLFW.  You
+ *  should not free it yourself.  It is valid until the specified joystick is
+ *  disconnected, this function is called again for that joystick or the library
+ *  is terminated.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref joystick_hat
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup input
+ */
+GLFWAPI const unsigned char* glfwGetJoystickHats(int jid, int* count);
+
+/*! @brief Returns the name of the specified joystick.
+ *
+ *  This function returns the name, encoded as UTF-8, of the specified joystick.
+ *  The returned string is allocated and freed by GLFW.  You should not free it
+ *  yourself.
+ *
+ *  If the specified joystick is not present this function will return `NULL`
+ *  but will not generate an error.  This can be used instead of first calling
+ *  @ref glfwJoystickPresent.
+ *
+ *  @param[in] jid The [joystick](@ref joysticks) to query.
+ *  @return The UTF-8 encoded name of the joystick, or `NULL` if the joystick
+ *  is not present or an [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @pointer_lifetime The returned string is allocated and freed by GLFW.  You
+ *  should not free it yourself.  It is valid until the specified joystick is
+ *  disconnected or the library is terminated.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref joystick_name
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup input
+ */
+GLFWAPI const char* glfwGetJoystickName(int jid);
+
+/*! @brief Returns the SDL comaptible GUID of the specified joystick.
+ *
+ *  This function returns the SDL compatible GUID, as a UTF-8 encoded
+ *  hexadecimal string, of the specified joystick.  The returned string is
+ *  allocated and freed by GLFW.  You should not free it yourself.
+ *
+ *  The GUID is what connects a joystick to a gamepad mapping.  A connected
+ *  joystick will always have a GUID even if there is no gamepad mapping
+ *  assigned to it.
+ *
+ *  If the specified joystick is not present this function will return `NULL`
+ *  but will not generate an error.  This can be used instead of first calling
+ *  @ref glfwJoystickPresent.
+ *
+ *  The GUID uses the format introduced in SDL 2.0.5.  This GUID tries to
+ *  uniquely identify the make and model of a joystick but does not identify
+ *  a specific unit, e.g. all wired Xbox 360 controllers will have the same
+ *  GUID on that platform.  The GUID for a unit may vary between platforms
+ *  depending on what hardware information the platform specific APIs provide.
+ *
+ *  @param[in] jid The [joystick](@ref joysticks) to query.
+ *  @return The UTF-8 encoded GUID of the joystick, or `NULL` if the joystick
+ *  is not present or an [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @pointer_lifetime The returned string is allocated and freed by GLFW.  You
+ *  should not free it yourself.  It is valid until the specified joystick is
+ *  disconnected or the library is terminated.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref gamepad
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup input
+ */
+GLFWAPI const char* glfwGetJoystickGUID(int jid);
+
+/*! @brief Sets the user pointer of the specified joystick.
+ *
+ *  This function sets the user-defined pointer of the specified joystick.  The
+ *  current value is retained until the joystick is disconnected.  The initial
+ *  value is `NULL`.
+ *
+ *  This function may be called from the joystick callback, even for a joystick
+ *  that is being disconnected.
+ *
+ *  @param[in] jid The joystick whose pointer to set.
+ *  @param[in] pointer The new value.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @sa @ref joystick_userptr
+ *  @sa @ref glfwGetJoystickUserPointer
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup input
+ */
+GLFWAPI void glfwSetJoystickUserPointer(int jid, void* pointer);
+
+/*! @brief Returns the user pointer of the specified joystick.
+ *
+ *  This function returns the current value of the user-defined pointer of the
+ *  specified joystick.  The initial value is `NULL`.
+ *
+ *  This function may be called from the joystick callback, even for a joystick
+ *  that is being disconnected.
+ *
+ *  @param[in] jid The joystick whose pointer to return.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @sa @ref joystick_userptr
+ *  @sa @ref glfwSetJoystickUserPointer
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup input
+ */
+GLFWAPI void* glfwGetJoystickUserPointer(int jid);
+
+/*! @brief Returns whether the specified joystick has a gamepad mapping.
+ *
+ *  This function returns whether the specified joystick is both present and has
+ *  a gamepad mapping.
+ *
+ *  If the specified joystick is present but does not have a gamepad mapping
+ *  this function will return `GLFW_FALSE` but will not generate an error.  Call
+ *  @ref glfwJoystickPresent to check if a joystick is present regardless of
+ *  whether it has a mapping.
+ *
+ *  @param[in] jid The [joystick](@ref joysticks) to query.
+ *  @return `GLFW_TRUE` if a joystick is both present and has a gamepad mapping,
+ *  or `GLFW_FALSE` otherwise.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_INVALID_ENUM.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref gamepad
+ *  @sa @ref glfwGetGamepadState
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup input
+ */
+GLFWAPI int glfwJoystickIsGamepad(int jid);
+
+/*! @brief Sets the joystick configuration callback.
+ *
+ *  This function sets the joystick configuration callback, or removes the
+ *  currently set callback.  This is called when a joystick is connected to or
+ *  disconnected from the system.
+ *
+ *  For joystick connection and disconnection events to be delivered on all
+ *  platforms, you need to call one of the [event processing](@ref events)
+ *  functions.  Joystick disconnection may also be detected and the callback
+ *  called by joystick functions.  The function will then return whatever it
+ *  returns if the joystick is not present.
+ *
+ *  @param[in] cbfun The new callback, or `NULL` to remove the currently set
+ *  callback.
+ *  @return The previously set callback, or `NULL` if no callback was set or the
+ *  library had not been [initialized](@ref intro_init).
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref joystick_event
+ *
+ *  @since Added in version 3.2.
+ *
+ *  @ingroup input
+ */
+GLFWAPI GLFWjoystickfun glfwSetJoystickCallback(GLFWjoystickfun cbfun);
+
+/*! @brief Adds the specified SDL_GameControllerDB gamepad mappings.
+ *
+ *  This function parses the specified ASCII encoded string and updates the
+ *  internal list with any gamepad mappings it finds.  This string may
+ *  contain either a single gamepad mapping or many mappings separated by
+ *  newlines.  The parser supports the full format of the `gamecontrollerdb.txt`
+ *  source file including empty lines and comments.
+ *
+ *  See @ref gamepad_mapping for a description of the format.
+ *
+ *  If there is already a gamepad mapping for a given GUID in the internal list,
+ *  it will be replaced by the one passed to this function.  If the library is
+ *  terminated and re-initialized the internal list will revert to the built-in
+ *  default.
+ *
+ *  @param[in] string The string containing the gamepad mappings.
+ *  @return `GLFW_TRUE` if successful, or `GLFW_FALSE` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_INVALID_VALUE.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref gamepad
+ *  @sa @ref glfwJoystickIsGamepad
+ *  @sa @ref glfwGetGamepadName
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup input
+ */
+GLFWAPI int glfwUpdateGamepadMappings(const char* string);
+
+/*! @brief Returns the human-readable gamepad name for the specified joystick.
+ *
+ *  This function returns the human-readable name of the gamepad from the
+ *  gamepad mapping assigned to the specified joystick.
+ *
+ *  If the specified joystick is not present or does not have a gamepad mapping
+ *  this function will return `NULL` but will not generate an error.  Call
+ *  @ref glfwJoystickPresent to check whether it is present regardless of
+ *  whether it has a mapping.
+ *
+ *  @param[in] jid The [joystick](@ref joysticks) to query.
+ *  @return The UTF-8 encoded name of the gamepad, or `NULL` if the
+ *  joystick is not present, does not have a mapping or an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @pointer_lifetime The returned string is allocated and freed by GLFW.  You
+ *  should not free it yourself.  It is valid until the specified joystick is
+ *  disconnected, the gamepad mappings are updated or the library is terminated.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref gamepad
+ *  @sa @ref glfwJoystickIsGamepad
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup input
+ */
+GLFWAPI const char* glfwGetGamepadName(int jid);
+
+/*! @brief Retrieves the state of the specified joystick remapped as a gamepad.
+ *
+ *  This function retrives the state of the specified joystick remapped to
+ *  an Xbox-like gamepad.
+ *
+ *  If the specified joystick is not present or does not have a gamepad mapping
+ *  this function will return `GLFW_FALSE` but will not generate an error.  Call
+ *  @ref glfwJoystickPresent to check whether it is present regardless of
+ *  whether it has a mapping.
+ *
+ *  The Guide button may not be available for input as it is often hooked by the
+ *  system or the Steam client.
+ *
+ *  Not all devices have all the buttons or axes provided by @ref
+ *  GLFWgamepadstate.  Unavailable buttons and axes will always report
+ *  `GLFW_RELEASE` and 0.0 respectively.
+ *
+ *  @param[in] jid The [joystick](@ref joysticks) to query.
+ *  @param[out] state The gamepad input state of the joystick.
+ *  @return `GLFW_TRUE` if successful, or `GLFW_FALSE` if no joystick is
+ *  connected, it has no gamepad mapping or an [error](@ref error_handling)
+ *  occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_INVALID_ENUM.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref gamepad
+ *  @sa @ref glfwUpdateGamepadMappings
+ *  @sa @ref glfwJoystickIsGamepad
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup input
+ */
+GLFWAPI int glfwGetGamepadState(int jid, GLFWgamepadstate* state);
+
+/*! @brief Sets the clipboard to the specified string.
+ *
+ *  This function sets the system clipboard to the specified, UTF-8 encoded
+ *  string.
+ *
+ *  @param[in] window Deprecated.  Any valid window or `NULL`.
+ *  @param[in] string A UTF-8 encoded string.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @remark @wayland Clipboard is currently unimplemented.
+ *
+ *  @pointer_lifetime The specified string is copied before this function
+ *  returns.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref clipboard
+ *  @sa @ref glfwGetClipboardString
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup input
+ */
+GLFWAPI void glfwSetClipboardString(GLFWwindow* window, const char* string);
+
+/*! @brief Returns the contents of the clipboard as a string.
+ *
+ *  This function returns the contents of the system clipboard, if it contains
+ *  or is convertible to a UTF-8 encoded string.  If the clipboard is empty or
+ *  if its contents cannot be converted, `NULL` is returned and a @ref
+ *  GLFW_FORMAT_UNAVAILABLE error is generated.
+ *
+ *  @param[in] window Deprecated.  Any valid window or `NULL`.
+ *  @return The contents of the clipboard as a UTF-8 encoded string, or `NULL`
+ *  if an [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @remark @wayland Clipboard is currently unimplemented.
+ *
+ *  @pointer_lifetime The returned string is allocated and freed by GLFW.  You
+ *  should not free it yourself.  It is valid until the next call to @ref
+ *  glfwGetClipboardString or @ref glfwSetClipboardString, or until the library
+ *  is terminated.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref clipboard
+ *  @sa @ref glfwSetClipboardString
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup input
+ */
+GLFWAPI const char* glfwGetClipboardString(GLFWwindow* window);
+
+/*! @brief Returns the value of the GLFW timer.
+ *
+ *  This function returns the value of the GLFW timer.  Unless the timer has
+ *  been set using @ref glfwSetTime, the timer measures time elapsed since GLFW
+ *  was initialized.
+ *
+ *  The resolution of the timer is system dependent, but is usually on the order
+ *  of a few micro- or nanoseconds.  It uses the highest-resolution monotonic
+ *  time source on each supported platform.
+ *
+ *  @return The current value, in seconds, or zero if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function may be called from any thread.  Reading and
+ *  writing of the internal timer offset is not atomic, so it needs to be
+ *  externally synchronized with calls to @ref glfwSetTime.
+ *
+ *  @sa @ref time
+ *
+ *  @since Added in version 1.0.
+ *
+ *  @ingroup input
+ */
+GLFWAPI double glfwGetTime(void);
+
+/*! @brief Sets the GLFW timer.
+ *
+ *  This function sets the value of the GLFW timer.  It then continues to count
+ *  up from that value.  The value must be a positive finite number less than
+ *  or equal to 18446744073.0, which is approximately 584.5 years.
+ *
+ *  @param[in] time The new value, in seconds.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_INVALID_VALUE.
+ *
+ *  @remark The upper limit of the timer is calculated as
+ *  floor((2<sup>64</sup> - 1) / 10<sup>9</sup>) and is due to implementations
+ *  storing nanoseconds in 64 bits.  The limit may be increased in the future.
+ *
+ *  @thread_safety This function may be called from any thread.  Reading and
+ *  writing of the internal timer offset is not atomic, so it needs to be
+ *  externally synchronized with calls to @ref glfwGetTime.
+ *
+ *  @sa @ref time
+ *
+ *  @since Added in version 2.2.
+ *
+ *  @ingroup input
+ */
+GLFWAPI void glfwSetTime(double time);
+
+/*! @brief Returns the current value of the raw timer.
+ *
+ *  This function returns the current value of the raw timer, measured in
+ *  1&nbsp;/&nbsp;frequency seconds.  To get the frequency, call @ref
+ *  glfwGetTimerFrequency.
+ *
+ *  @return The value of the timer, or zero if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function may be called from any thread.
+ *
+ *  @sa @ref time
+ *  @sa @ref glfwGetTimerFrequency
+ *
+ *  @since Added in version 3.2.
+ *
+ *  @ingroup input
+ */
+GLFWAPI uint64_t glfwGetTimerValue(void);
+
+/*! @brief Returns the frequency, in Hz, of the raw timer.
+ *
+ *  This function returns the frequency, in Hz, of the raw timer.
+ *
+ *  @return The frequency of the timer, in Hz, or zero if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function may be called from any thread.
+ *
+ *  @sa @ref time
+ *  @sa @ref glfwGetTimerValue
+ *
+ *  @since Added in version 3.2.
+ *
+ *  @ingroup input
+ */
+GLFWAPI uint64_t glfwGetTimerFrequency(void);
+
+/*! @brief Makes the context of the specified window current for the calling
+ *  thread.
+ *
+ *  This function makes the OpenGL or OpenGL ES context of the specified window
+ *  current on the calling thread.  A context must only be made current on
+ *  a single thread at a time and each thread can have only a single current
+ *  context at a time.
+ *
+ *  When moving a context between threads, you must make it non-current on the
+ *  old thread before making it current on the new one.
+ *
+ *  By default, making a context non-current implicitly forces a pipeline flush.
+ *  On machines that support `GL_KHR_context_flush_control`, you can control
+ *  whether a context performs this flush by setting the
+ *  [GLFW_CONTEXT_RELEASE_BEHAVIOR](@ref GLFW_CONTEXT_RELEASE_BEHAVIOR_hint)
+ *  hint.
+ *
+ *  The specified window must have an OpenGL or OpenGL ES context.  Specifying
+ *  a window without a context will generate a @ref GLFW_NO_WINDOW_CONTEXT
+ *  error.
+ *
+ *  @param[in] window The window whose context to make current, or `NULL` to
+ *  detach the current context.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_NO_WINDOW_CONTEXT and @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function may be called from any thread.
+ *
+ *  @sa @ref context_current
+ *  @sa @ref glfwGetCurrentContext
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup context
+ */
+GLFWAPI void glfwMakeContextCurrent(GLFWwindow* window);
+
+/*! @brief Returns the window whose context is current on the calling thread.
+ *
+ *  This function returns the window whose OpenGL or OpenGL ES context is
+ *  current on the calling thread.
+ *
+ *  @return The window whose context is current, or `NULL` if no window's
+ *  context is current.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function may be called from any thread.
+ *
+ *  @sa @ref context_current
+ *  @sa @ref glfwMakeContextCurrent
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup context
+ */
+GLFWAPI GLFWwindow* glfwGetCurrentContext(void);
+
+/*! @brief Swaps the front and back buffers of the specified window.
+ *
+ *  This function swaps the front and back buffers of the specified window when
+ *  rendering with OpenGL or OpenGL ES.  If the swap interval is greater than
+ *  zero, the GPU driver waits the specified number of screen updates before
+ *  swapping the buffers.
+ *
+ *  The specified window must have an OpenGL or OpenGL ES context.  Specifying
+ *  a window without a context will generate a @ref GLFW_NO_WINDOW_CONTEXT
+ *  error.
+ *
+ *  This function does not apply to Vulkan.  If you are rendering with Vulkan,
+ *  see `vkQueuePresentKHR` instead.
+ *
+ *  @param[in] window The window whose buffers to swap.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_NO_WINDOW_CONTEXT and @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @remark __EGL:__ The context of the specified window must be current on the
+ *  calling thread.
+ *
+ *  @thread_safety This function may be called from any thread.
+ *
+ *  @sa @ref buffer_swap
+ *  @sa @ref glfwSwapInterval
+ *
+ *  @since Added in version 1.0.
+ *  @glfw3 Added window handle parameter.
+ *
+ *  @ingroup window
+ */
+GLFWAPI void glfwSwapBuffers(GLFWwindow* window);
+
+/*! @brief Sets the swap interval for the current context.
+ *
+ *  This function sets the swap interval for the current OpenGL or OpenGL ES
+ *  context, i.e. the number of screen updates to wait from the time @ref
+ *  glfwSwapBuffers was called before swapping the buffers and returning.  This
+ *  is sometimes called _vertical synchronization_, _vertical retrace
+ *  synchronization_ or just _vsync_.
+ *
+ *  A context that supports either of the `WGL_EXT_swap_control_tear` and
+ *  `GLX_EXT_swap_control_tear` extensions also accepts _negative_ swap
+ *  intervals, which allows the driver to swap immediately even if a frame
+ *  arrives a little bit late.  You can check for these extensions with @ref
+ *  glfwExtensionSupported.
+ *
+ *  A context must be current on the calling thread.  Calling this function
+ *  without a current context will cause a @ref GLFW_NO_CURRENT_CONTEXT error.
+ *
+ *  This function does not apply to Vulkan.  If you are rendering with Vulkan,
+ *  see the present mode of your swapchain instead.
+ *
+ *  @param[in] interval The minimum number of screen updates to wait for
+ *  until the buffers are swapped by @ref glfwSwapBuffers.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_NO_CURRENT_CONTEXT and @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @remark This function is not called during context creation, leaving the
+ *  swap interval set to whatever is the default on that platform.  This is done
+ *  because some swap interval extensions used by GLFW do not allow the swap
+ *  interval to be reset to zero once it has been set to a non-zero value.
+ *
+ *  @remark Some GPU drivers do not honor the requested swap interval, either
+ *  because of a user setting that overrides the application's request or due to
+ *  bugs in the driver.
+ *
+ *  @thread_safety This function may be called from any thread.
+ *
+ *  @sa @ref buffer_swap
+ *  @sa @ref glfwSwapBuffers
+ *
+ *  @since Added in version 1.0.
+ *
+ *  @ingroup context
+ */
+GLFWAPI void glfwSwapInterval(int interval);
+
+/*! @brief Returns whether the specified extension is available.
+ *
+ *  This function returns whether the specified
+ *  [API extension](@ref context_glext) is supported by the current OpenGL or
+ *  OpenGL ES context.  It searches both for client API extension and context
+ *  creation API extensions.
+ *
+ *  A context must be current on the calling thread.  Calling this function
+ *  without a current context will cause a @ref GLFW_NO_CURRENT_CONTEXT error.
+ *
+ *  As this functions retrieves and searches one or more extension strings each
+ *  call, it is recommended that you cache its results if it is going to be used
+ *  frequently.  The extension strings will not change during the lifetime of
+ *  a context, so there is no danger in doing this.
+ *
+ *  This function does not apply to Vulkan.  If you are using Vulkan, see @ref
+ *  glfwGetRequiredInstanceExtensions, `vkEnumerateInstanceExtensionProperties`
+ *  and `vkEnumerateDeviceExtensionProperties` instead.
+ *
+ *  @param[in] extension The ASCII encoded name of the extension.
+ *  @return `GLFW_TRUE` if the extension is available, or `GLFW_FALSE`
+ *  otherwise.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_NO_CURRENT_CONTEXT, @ref GLFW_INVALID_VALUE and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @thread_safety This function may be called from any thread.
+ *
+ *  @sa @ref context_glext
+ *  @sa @ref glfwGetProcAddress
+ *
+ *  @since Added in version 1.0.
+ *
+ *  @ingroup context
+ */
+GLFWAPI int glfwExtensionSupported(const char* extension);
+
+/*! @brief Returns the address of the specified function for the current
+ *  context.
+ *
+ *  This function returns the address of the specified OpenGL or OpenGL ES
+ *  [core or extension function](@ref context_glext), if it is supported
+ *  by the current context.
+ *
+ *  A context must be current on the calling thread.  Calling this function
+ *  without a current context will cause a @ref GLFW_NO_CURRENT_CONTEXT error.
+ *
+ *  This function does not apply to Vulkan.  If you are rendering with Vulkan,
+ *  see @ref glfwGetInstanceProcAddress, `vkGetInstanceProcAddr` and
+ *  `vkGetDeviceProcAddr` instead.
+ *
+ *  @param[in] procname The ASCII encoded name of the function.
+ *  @return The address of the function, or `NULL` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_NO_CURRENT_CONTEXT and @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @remark The address of a given function is not guaranteed to be the same
+ *  between contexts.
+ *
+ *  @remark This function may return a non-`NULL` address despite the
+ *  associated version or extension not being available.  Always check the
+ *  context version or extension string first.
+ *
+ *  @pointer_lifetime The returned function pointer is valid until the context
+ *  is destroyed or the library is terminated.
+ *
+ *  @thread_safety This function may be called from any thread.
+ *
+ *  @sa @ref context_glext
+ *  @sa @ref glfwExtensionSupported
+ *
+ *  @since Added in version 1.0.
+ *
+ *  @ingroup context
+ */
+GLFWAPI GLFWglproc glfwGetProcAddress(const char* procname);
+
+/*! @brief Returns whether the Vulkan loader and an ICD have been found.
+ *
+ *  This function returns whether the Vulkan loader and any minimally functional
+ *  ICD have been found.
+ *
+ *  The availability of a Vulkan loader and even an ICD does not by itself
+ *  guarantee that surface creation or even instance creation is possible.
+ *  For example, on Fermi systems Nvidia will install an ICD that provides no
+ *  actual Vulkan support.  Call @ref glfwGetRequiredInstanceExtensions to check
+ *  whether the extensions necessary for Vulkan surface creation are available
+ *  and @ref glfwGetPhysicalDevicePresentationSupport to check whether a queue
+ *  family of a physical device supports image presentation.
+ *
+ *  @return `GLFW_TRUE` if Vulkan is minimally available, or `GLFW_FALSE`
+ *  otherwise.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.
+ *
+ *  @thread_safety This function may be called from any thread.
+ *
+ *  @sa @ref vulkan_support
+ *
+ *  @since Added in version 3.2.
+ *
+ *  @ingroup vulkan
+ */
+GLFWAPI int glfwVulkanSupported(void);
+
+/*! @brief Returns the Vulkan instance extensions required by GLFW.
+ *
+ *  This function returns an array of names of Vulkan instance extensions required
+ *  by GLFW for creating Vulkan surfaces for GLFW windows.  If successful, the
+ *  list will always contains `VK_KHR_surface`, so if you don't require any
+ *  additional extensions you can pass this list directly to the
+ *  `VkInstanceCreateInfo` struct.
+ *
+ *  If Vulkan is not available on the machine, this function returns `NULL` and
+ *  generates a @ref GLFW_API_UNAVAILABLE error.  Call @ref glfwVulkanSupported
+ *  to check whether Vulkan is at least minimally available.
+ *
+ *  If Vulkan is available but no set of extensions allowing window surface
+ *  creation was found, this function returns `NULL`.  You may still use Vulkan
+ *  for off-screen rendering and compute work.
+ *
+ *  @param[out] count Where to store the number of extensions in the returned
+ *  array.  This is set to zero if an error occurred.
+ *  @return An array of ASCII encoded extension names, or `NULL` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_API_UNAVAILABLE.
+ *
+ *  @remark Additional extensions may be required by future versions of GLFW.
+ *  You should check if any extensions you wish to enable are already in the
+ *  returned array, as it is an error to specify an extension more than once in
+ *  the `VkInstanceCreateInfo` struct.
+ *
+ *  @remark @macos This function currently only supports the
+ *  `VK_MVK_macos_surface` extension from MoltenVK.
+ *
+ *  @pointer_lifetime The returned array is allocated and freed by GLFW.  You
+ *  should not free it yourself.  It is guaranteed to be valid only until the
+ *  library is terminated.
+ *
+ *  @thread_safety This function may be called from any thread.
+ *
+ *  @sa @ref vulkan_ext
+ *  @sa @ref glfwCreateWindowSurface
+ *
+ *  @since Added in version 3.2.
+ *
+ *  @ingroup vulkan
+ */
+GLFWAPI const char** glfwGetRequiredInstanceExtensions(uint32_t* count);
+
+#if defined(VK_VERSION_1_0)
+
+/*! @brief Returns the address of the specified Vulkan instance function.
+ *
+ *  This function returns the address of the specified Vulkan core or extension
+ *  function for the specified instance.  If instance is set to `NULL` it can
+ *  return any function exported from the Vulkan loader, including at least the
+ *  following functions:
+ *
+ *  - `vkEnumerateInstanceExtensionProperties`
+ *  - `vkEnumerateInstanceLayerProperties`
+ *  - `vkCreateInstance`
+ *  - `vkGetInstanceProcAddr`
+ *
+ *  If Vulkan is not available on the machine, this function returns `NULL` and
+ *  generates a @ref GLFW_API_UNAVAILABLE error.  Call @ref glfwVulkanSupported
+ *  to check whether Vulkan is at least minimally available.
+ *
+ *  This function is equivalent to calling `vkGetInstanceProcAddr` with
+ *  a platform-specific query of the Vulkan loader as a fallback.
+ *
+ *  @param[in] instance The Vulkan instance to query, or `NULL` to retrieve
+ *  functions related to instance creation.
+ *  @param[in] procname The ASCII encoded name of the function.
+ *  @return The address of the function, or `NULL` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_API_UNAVAILABLE.
+ *
+ *  @pointer_lifetime The returned function pointer is valid until the library
+ *  is terminated.
+ *
+ *  @thread_safety This function may be called from any thread.
+ *
+ *  @sa @ref vulkan_proc
+ *
+ *  @since Added in version 3.2.
+ *
+ *  @ingroup vulkan
+ */
+GLFWAPI GLFWvkproc glfwGetInstanceProcAddress(VkInstance instance, const char* procname);
+
+/*! @brief Returns whether the specified queue family can present images.
+ *
+ *  This function returns whether the specified queue family of the specified
+ *  physical device supports presentation to the platform GLFW was built for.
+ *
+ *  If Vulkan or the required window surface creation instance extensions are
+ *  not available on the machine, or if the specified instance was not created
+ *  with the required extensions, this function returns `GLFW_FALSE` and
+ *  generates a @ref GLFW_API_UNAVAILABLE error.  Call @ref glfwVulkanSupported
+ *  to check whether Vulkan is at least minimally available and @ref
+ *  glfwGetRequiredInstanceExtensions to check what instance extensions are
+ *  required.
+ *
+ *  @param[in] instance The instance that the physical device belongs to.
+ *  @param[in] device The physical device that the queue family belongs to.
+ *  @param[in] queuefamily The index of the queue family to query.
+ *  @return `GLFW_TRUE` if the queue family supports presentation, or
+ *  `GLFW_FALSE` otherwise.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_API_UNAVAILABLE and @ref GLFW_PLATFORM_ERROR.
+ *
+ *  @remark @macos This function currently always returns `GLFW_TRUE`, as the
+ *  `VK_MVK_macos_surface` extension does not provide
+ *  a `vkGetPhysicalDevice*PresentationSupport` type function.
+ *
+ *  @thread_safety This function may be called from any thread.  For
+ *  synchronization details of Vulkan objects, see the Vulkan specification.
+ *
+ *  @sa @ref vulkan_present
+ *
+ *  @since Added in version 3.2.
+ *
+ *  @ingroup vulkan
+ */
+GLFWAPI int glfwGetPhysicalDevicePresentationSupport(VkInstance instance, VkPhysicalDevice device, uint32_t queuefamily);
+
+/*! @brief Creates a Vulkan surface for the specified window.
+ *
+ *  This function creates a Vulkan surface for the specified window.
+ *
+ *  If the Vulkan loader or at least one minimally functional ICD were not found,
+ *  this function returns `VK_ERROR_INITIALIZATION_FAILED` and generates a @ref
+ *  GLFW_API_UNAVAILABLE error.  Call @ref glfwVulkanSupported to check whether
+ *  Vulkan is at least minimally available.
+ *
+ *  If the required window surface creation instance extensions are not
+ *  available or if the specified instance was not created with these extensions
+ *  enabled, this function returns `VK_ERROR_EXTENSION_NOT_PRESENT` and
+ *  generates a @ref GLFW_API_UNAVAILABLE error.  Call @ref
+ *  glfwGetRequiredInstanceExtensions to check what instance extensions are
+ *  required.
+ *
+ *  The window surface cannot be shared with another API so the window must
+ *  have been created with the [client api hint](@ref GLFW_CLIENT_API_attrib)
+ *  set to `GLFW_NO_API` otherwise it generates a @ref GLFW_INVALID_VALUE error
+ *  and returns `VK_ERROR_NATIVE_WINDOW_IN_USE_KHR`.
+ *
+ *  The window surface must be destroyed before the specified Vulkan instance.
+ *  It is the responsibility of the caller to destroy the window surface.  GLFW
+ *  does not destroy it for you.  Call `vkDestroySurfaceKHR` to destroy the
+ *  surface.
+ *
+ *  @param[in] instance The Vulkan instance to create the surface in.
+ *  @param[in] window The window to create the surface for.
+ *  @param[in] allocator The allocator to use, or `NULL` to use the default
+ *  allocator.
+ *  @param[out] surface Where to store the handle of the surface.  This is set
+ *  to `VK_NULL_HANDLE` if an error occurred.
+ *  @return `VK_SUCCESS` if successful, or a Vulkan error code if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref
+ *  GLFW_API_UNAVAILABLE, @ref GLFW_PLATFORM_ERROR and @ref GLFW_INVALID_VALUE
+ *
+ *  @remark If an error occurs before the creation call is made, GLFW returns
+ *  the Vulkan error code most appropriate for the error.  Appropriate use of
+ *  @ref glfwVulkanSupported and @ref glfwGetRequiredInstanceExtensions should
+ *  eliminate almost all occurrences of these errors.
+ *
+ *  @remark @macos This function currently only supports the
+ *  `VK_MVK_macos_surface` extension from MoltenVK.
+ *
+ *  @remark @macos This function creates and sets a `CAMetalLayer` instance for
+ *  the window content view, which is required for MoltenVK to function.
+ *
+ *  @thread_safety This function may be called from any thread.  For
+ *  synchronization details of Vulkan objects, see the Vulkan specification.
+ *
+ *  @sa @ref vulkan_surface
+ *  @sa @ref glfwGetRequiredInstanceExtensions
+ *
+ *  @since Added in version 3.2.
+ *
+ *  @ingroup vulkan
+ */
+GLFWAPI VkResult glfwCreateWindowSurface(VkInstance instance, GLFWwindow* window, const VkAllocationCallbacks* allocator, VkSurfaceKHR* surface);
+
+#endif /*VK_VERSION_1_0*/
+
+
+/*************************************************************************
+ * Global definition cleanup
+ *************************************************************************/
+
+/* ------------------- BEGIN SYSTEM/COMPILER SPECIFIC -------------------- */
+
+#ifdef GLFW_WINGDIAPI_DEFINED
+ #undef WINGDIAPI
+ #undef GLFW_WINGDIAPI_DEFINED
+#endif
+
+#ifdef GLFW_CALLBACK_DEFINED
+ #undef CALLBACK
+ #undef GLFW_CALLBACK_DEFINED
+#endif
+
+/* Some OpenGL related headers need GLAPIENTRY, but it is unconditionally
+ * defined by some gl.h variants (OpenBSD) so define it after if needed.
+ */
+#ifndef GLAPIENTRY
+ #define GLAPIENTRY APIENTRY
+#endif
+
+/* -------------------- END SYSTEM/COMPILER SPECIFIC --------------------- */
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* _glfw3_h_ */
+
diff --git a/frontends/gl/win/glfw/include/GLFW/glfw3native.h b/frontends/gl/win/glfw/include/GLFW/glfw3native.h
index 0630693..83d3ca4 100644
--- a/frontends/gl/win/glfw/include/GLFW/glfw3native.h
+++ b/frontends/gl/win/glfw/include/GLFW/glfw3native.h
@@ -1,525 +1,525 @@
-/*************************************************************************

- * GLFW 3.3 - www.glfw.org

- * A library for OpenGL, window and input

- *------------------------------------------------------------------------

- * Copyright (c) 2002-2006 Marcus Geelnard

- * Copyright (c) 2006-2016 Camilla Löwy <elmindreda@glfw.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.

- *

- *************************************************************************/

-

-#ifndef _glfw3_native_h_

-#define _glfw3_native_h_

-

-#ifdef __cplusplus

-extern "C" {

-#endif

-

-

-/*************************************************************************

- * Doxygen documentation

- *************************************************************************/

-

-/*! @file glfw3native.h

- *  @brief The header of the native access functions.

- *

- *  This is the header file of the native access functions.  See @ref native for

- *  more information.

- */

-/*! @defgroup native Native access

- *  @brief Functions related to accessing native handles.

- *

- *  **By using the native access functions you assert that you know what you're

- *  doing and how to fix problems caused by using them.  If you don't, you

- *  shouldn't be using them.**

- *

- *  Before the inclusion of @ref glfw3native.h, you may define zero or more

- *  window system API macro and zero or more context creation API macros.

- *

- *  The chosen backends must match those the library was compiled for.  Failure

- *  to do this will cause a link-time error.

- *

- *  The available window API macros are:

- *  * `GLFW_EXPOSE_NATIVE_WIN32`

- *  * `GLFW_EXPOSE_NATIVE_COCOA`

- *  * `GLFW_EXPOSE_NATIVE_X11`

- *  * `GLFW_EXPOSE_NATIVE_WAYLAND`

- *

- *  The available context API macros are:

- *  * `GLFW_EXPOSE_NATIVE_WGL`

- *  * `GLFW_EXPOSE_NATIVE_NSGL`

- *  * `GLFW_EXPOSE_NATIVE_GLX`

- *  * `GLFW_EXPOSE_NATIVE_EGL`

- *  * `GLFW_EXPOSE_NATIVE_OSMESA`

- *

- *  These macros select which of the native access functions that are declared

- *  and which platform-specific headers to include.  It is then up your (by

- *  definition platform-specific) code to handle which of these should be

- *  defined.

- */

-

-

-/*************************************************************************

- * System headers and types

- *************************************************************************/

-

-#if defined(GLFW_EXPOSE_NATIVE_WIN32)

- // This is a workaround for the fact that glfw3.h needs to export APIENTRY (for

- // example to allow applications to correctly declare a GL_ARB_debug_output

- // callback) but windows.h assumes no one will define APIENTRY before it does

- #if defined(GLFW_APIENTRY_DEFINED)

-  #undef APIENTRY

-  #undef GLFW_APIENTRY_DEFINED

- #endif

- #include <windows.h>

-#elif defined(GLFW_EXPOSE_NATIVE_COCOA)

- #include <ApplicationServices/ApplicationServices.h>

- #if defined(__OBJC__)

-  #import <Cocoa/Cocoa.h>

- #else

-  typedef void* id;

- #endif

-#elif defined(GLFW_EXPOSE_NATIVE_X11)

- #include <X11/Xlib.h>

- #include <X11/extensions/Xrandr.h>

-#elif defined(GLFW_EXPOSE_NATIVE_WAYLAND)

- #include <wayland-client.h>

-#endif

-

-#if defined(GLFW_EXPOSE_NATIVE_WGL)

- /* WGL is declared by windows.h */

-#endif

-#if defined(GLFW_EXPOSE_NATIVE_NSGL)

- /* NSGL is declared by Cocoa.h */

-#endif

-#if defined(GLFW_EXPOSE_NATIVE_GLX)

- #include <GL/glx.h>

-#endif

-#if defined(GLFW_EXPOSE_NATIVE_EGL)

- #include <EGL/egl.h>

-#endif

-#if defined(GLFW_EXPOSE_NATIVE_OSMESA)

- #include <GL/osmesa.h>

-#endif

-

-

-/*************************************************************************

- * Functions

- *************************************************************************/

-

-#if defined(GLFW_EXPOSE_NATIVE_WIN32)

-/*! @brief Returns the adapter device name of the specified monitor.

- *

- *  @return The UTF-8 encoded adapter device name (for example `\\.\DISPLAY1`)

- *  of the specified monitor, or `NULL` if an [error](@ref error_handling)

- *  occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.1.

- *

- *  @ingroup native

- */

-GLFWAPI const char* glfwGetWin32Adapter(GLFWmonitor* monitor);

-

-/*! @brief Returns the display device name of the specified monitor.

- *

- *  @return The UTF-8 encoded display device name (for example

- *  `\\.\DISPLAY1\Monitor0`) of the specified monitor, or `NULL` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.1.

- *

- *  @ingroup native

- */

-GLFWAPI const char* glfwGetWin32Monitor(GLFWmonitor* monitor);

-

-/*! @brief Returns the `HWND` of the specified window.

- *

- *  @return The `HWND` of the specified window, or `NULL` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup native

- */

-GLFWAPI HWND glfwGetWin32Window(GLFWwindow* window);

-#endif

-

-#if defined(GLFW_EXPOSE_NATIVE_WGL)

-/*! @brief Returns the `HGLRC` of the specified window.

- *

- *  @return The `HGLRC` of the specified window, or `NULL` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup native

- */

-GLFWAPI HGLRC glfwGetWGLContext(GLFWwindow* window);

-#endif

-

-#if defined(GLFW_EXPOSE_NATIVE_COCOA)

-/*! @brief Returns the `CGDirectDisplayID` of the specified monitor.

- *

- *  @return The `CGDirectDisplayID` of the specified monitor, or

- *  `kCGNullDirectDisplay` if an [error](@ref error_handling) occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.1.

- *

- *  @ingroup native

- */

-GLFWAPI CGDirectDisplayID glfwGetCocoaMonitor(GLFWmonitor* monitor);

-

-/*! @brief Returns the `NSWindow` of the specified window.

- *

- *  @return The `NSWindow` of the specified window, or `nil` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup native

- */

-GLFWAPI id glfwGetCocoaWindow(GLFWwindow* window);

-#endif

-

-#if defined(GLFW_EXPOSE_NATIVE_NSGL)

-/*! @brief Returns the `NSOpenGLContext` of the specified window.

- *

- *  @return The `NSOpenGLContext` of the specified window, or `nil` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup native

- */

-GLFWAPI id glfwGetNSGLContext(GLFWwindow* window);

-#endif

-

-#if defined(GLFW_EXPOSE_NATIVE_X11)

-/*! @brief Returns the `Display` used by GLFW.

- *

- *  @return The `Display` used by GLFW, or `NULL` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup native

- */

-GLFWAPI Display* glfwGetX11Display(void);

-

-/*! @brief Returns the `RRCrtc` of the specified monitor.

- *

- *  @return The `RRCrtc` of the specified monitor, or `None` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.1.

- *

- *  @ingroup native

- */

-GLFWAPI RRCrtc glfwGetX11Adapter(GLFWmonitor* monitor);

-

-/*! @brief Returns the `RROutput` of the specified monitor.

- *

- *  @return The `RROutput` of the specified monitor, or `None` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.1.

- *

- *  @ingroup native

- */

-GLFWAPI RROutput glfwGetX11Monitor(GLFWmonitor* monitor);

-

-/*! @brief Returns the `Window` of the specified window.

- *

- *  @return The `Window` of the specified window, or `None` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup native

- */

-GLFWAPI Window glfwGetX11Window(GLFWwindow* window);

-

-/*! @brief Sets the current primary selection to the specified string.

- *

- *  @param[in] string A UTF-8 encoded string.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @pointer_lifetime The specified string is copied before this function

- *  returns.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref clipboard

- *  @sa glfwGetX11SelectionString

- *  @sa glfwSetClipboardString

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup native

- */

-GLFWAPI void glfwSetX11SelectionString(const char* string);

-

-/*! @brief Returns the contents of the current primary selection as a string.

- *

- *  If the selection is empty or if its contents cannot be converted, `NULL`

- *  is returned and a @ref GLFW_FORMAT_UNAVAILABLE error is generated.

- *

- *  @return The contents of the selection as a UTF-8 encoded string, or `NULL`

- *  if an [error](@ref error_handling) occurred.

- *

- *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref

- *  GLFW_PLATFORM_ERROR.

- *

- *  @pointer_lifetime The returned string is allocated and freed by GLFW. You

- *  should not free it yourself. It is valid until the next call to @ref

- *  glfwGetX11SelectionString or @ref glfwSetX11SelectionString, or until the

- *  library is terminated.

- *

- *  @thread_safety This function must only be called from the main thread.

- *

- *  @sa @ref clipboard

- *  @sa glfwSetX11SelectionString

- *  @sa glfwGetClipboardString

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup native

- */

-GLFWAPI const char* glfwGetX11SelectionString(void);

-#endif

-

-#if defined(GLFW_EXPOSE_NATIVE_GLX)

-/*! @brief Returns the `GLXContext` of the specified window.

- *

- *  @return The `GLXContext` of the specified window, or `NULL` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup native

- */

-GLFWAPI GLXContext glfwGetGLXContext(GLFWwindow* window);

-

-/*! @brief Returns the `GLXWindow` of the specified window.

- *

- *  @return The `GLXWindow` of the specified window, or `None` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.2.

- *

- *  @ingroup native

- */

-GLFWAPI GLXWindow glfwGetGLXWindow(GLFWwindow* window);

-#endif

-

-#if defined(GLFW_EXPOSE_NATIVE_WAYLAND)

-/*! @brief Returns the `struct wl_display*` used by GLFW.

- *

- *  @return The `struct wl_display*` used by GLFW, or `NULL` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.2.

- *

- *  @ingroup native

- */

-GLFWAPI struct wl_display* glfwGetWaylandDisplay(void);

-

-/*! @brief Returns the `struct wl_output*` of the specified monitor.

- *

- *  @return The `struct wl_output*` of the specified monitor, or `NULL` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.2.

- *

- *  @ingroup native

- */

-GLFWAPI struct wl_output* glfwGetWaylandMonitor(GLFWmonitor* monitor);

-

-/*! @brief Returns the main `struct wl_surface*` of the specified window.

- *

- *  @return The main `struct wl_surface*` of the specified window, or `NULL` if

- *  an [error](@ref error_handling) occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.2.

- *

- *  @ingroup native

- */

-GLFWAPI struct wl_surface* glfwGetWaylandWindow(GLFWwindow* window);

-#endif

-

-#if defined(GLFW_EXPOSE_NATIVE_EGL)

-/*! @brief Returns the `EGLDisplay` used by GLFW.

- *

- *  @return The `EGLDisplay` used by GLFW, or `EGL_NO_DISPLAY` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup native

- */

-GLFWAPI EGLDisplay glfwGetEGLDisplay(void);

-

-/*! @brief Returns the `EGLContext` of the specified window.

- *

- *  @return The `EGLContext` of the specified window, or `EGL_NO_CONTEXT` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup native

- */

-GLFWAPI EGLContext glfwGetEGLContext(GLFWwindow* window);

-

-/*! @brief Returns the `EGLSurface` of the specified window.

- *

- *  @return The `EGLSurface` of the specified window, or `EGL_NO_SURFACE` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.0.

- *

- *  @ingroup native

- */

-GLFWAPI EGLSurface glfwGetEGLSurface(GLFWwindow* window);

-#endif

-

-#if defined(GLFW_EXPOSE_NATIVE_OSMESA)

-/*! @brief Retrieves the color buffer associated with the specified window.

- *

- *  @param[in] window The window whose color buffer to retrieve.

- *  @param[out] width Where to store the width of the color buffer, or `NULL`.

- *  @param[out] height Where to store the height of the color buffer, or `NULL`.

- *  @param[out] format Where to store the OSMesa pixel format of the color

- *  buffer, or `NULL`.

- *  @param[out] buffer Where to store the address of the color buffer, or

- *  `NULL`.

- *  @return `GLFW_TRUE` if successful, or `GLFW_FALSE` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup native

- */

-GLFWAPI int glfwGetOSMesaColorBuffer(GLFWwindow* window, int* width, int* height, int* format, void** buffer);

-

-/*! @brief Retrieves the depth buffer associated with the specified window.

- *

- *  @param[in] window The window whose depth buffer to retrieve.

- *  @param[out] width Where to store the width of the depth buffer, or `NULL`.

- *  @param[out] height Where to store the height of the depth buffer, or `NULL`.

- *  @param[out] bytesPerValue Where to store the number of bytes per depth

- *  buffer element, or `NULL`.

- *  @param[out] buffer Where to store the address of the depth buffer, or

- *  `NULL`.

- *  @return `GLFW_TRUE` if successful, or `GLFW_FALSE` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup native

- */

-GLFWAPI int glfwGetOSMesaDepthBuffer(GLFWwindow* window, int* width, int* height, int* bytesPerValue, void** buffer);

-

-/*! @brief Returns the `OSMesaContext` of the specified window.

- *

- *  @return The `OSMesaContext` of the specified window, or `NULL` if an

- *  [error](@ref error_handling) occurred.

- *

- *  @thread_safety This function may be called from any thread.  Access is not

- *  synchronized.

- *

- *  @since Added in version 3.3.

- *

- *  @ingroup native

- */

-GLFWAPI OSMesaContext glfwGetOSMesaContext(GLFWwindow* window);

-#endif

-

-#ifdef __cplusplus

-}

-#endif

-

-#endif /* _glfw3_native_h_ */

-

+/*************************************************************************
+ * GLFW 3.3 - www.glfw.org
+ * A library for OpenGL, window and input
+ *------------------------------------------------------------------------
+ * Copyright (c) 2002-2006 Marcus Geelnard
+ * Copyright (c) 2006-2016 Camilla Löwy <elmindreda@glfw.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.
+ *
+ *************************************************************************/
+
+#ifndef _glfw3_native_h_
+#define _glfw3_native_h_
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+
+/*************************************************************************
+ * Doxygen documentation
+ *************************************************************************/
+
+/*! @file glfw3native.h
+ *  @brief The header of the native access functions.
+ *
+ *  This is the header file of the native access functions.  See @ref native for
+ *  more information.
+ */
+/*! @defgroup native Native access
+ *  @brief Functions related to accessing native handles.
+ *
+ *  **By using the native access functions you assert that you know what you're
+ *  doing and how to fix problems caused by using them.  If you don't, you
+ *  shouldn't be using them.**
+ *
+ *  Before the inclusion of @ref glfw3native.h, you may define zero or more
+ *  window system API macro and zero or more context creation API macros.
+ *
+ *  The chosen backends must match those the library was compiled for.  Failure
+ *  to do this will cause a link-time error.
+ *
+ *  The available window API macros are:
+ *  * `GLFW_EXPOSE_NATIVE_WIN32`
+ *  * `GLFW_EXPOSE_NATIVE_COCOA`
+ *  * `GLFW_EXPOSE_NATIVE_X11`
+ *  * `GLFW_EXPOSE_NATIVE_WAYLAND`
+ *
+ *  The available context API macros are:
+ *  * `GLFW_EXPOSE_NATIVE_WGL`
+ *  * `GLFW_EXPOSE_NATIVE_NSGL`
+ *  * `GLFW_EXPOSE_NATIVE_GLX`
+ *  * `GLFW_EXPOSE_NATIVE_EGL`
+ *  * `GLFW_EXPOSE_NATIVE_OSMESA`
+ *
+ *  These macros select which of the native access functions that are declared
+ *  and which platform-specific headers to include.  It is then up your (by
+ *  definition platform-specific) code to handle which of these should be
+ *  defined.
+ */
+
+
+/*************************************************************************
+ * System headers and types
+ *************************************************************************/
+
+#if defined(GLFW_EXPOSE_NATIVE_WIN32)
+ // This is a workaround for the fact that glfw3.h needs to export APIENTRY (for
+ // example to allow applications to correctly declare a GL_ARB_debug_output
+ // callback) but windows.h assumes no one will define APIENTRY before it does
+ #if defined(GLFW_APIENTRY_DEFINED)
+  #undef APIENTRY
+  #undef GLFW_APIENTRY_DEFINED
+ #endif
+ #include <windows.h>
+#elif defined(GLFW_EXPOSE_NATIVE_COCOA)
+ #include <ApplicationServices/ApplicationServices.h>
+ #if defined(__OBJC__)
+  #import <Cocoa/Cocoa.h>
+ #else
+  typedef void* id;
+ #endif
+#elif defined(GLFW_EXPOSE_NATIVE_X11)
+ #include <X11/Xlib.h>
+ #include <X11/extensions/Xrandr.h>
+#elif defined(GLFW_EXPOSE_NATIVE_WAYLAND)
+ #include <wayland-client.h>
+#endif
+
+#if defined(GLFW_EXPOSE_NATIVE_WGL)
+ /* WGL is declared by windows.h */
+#endif
+#if defined(GLFW_EXPOSE_NATIVE_NSGL)
+ /* NSGL is declared by Cocoa.h */
+#endif
+#if defined(GLFW_EXPOSE_NATIVE_GLX)
+ #include <GL/glx.h>
+#endif
+#if defined(GLFW_EXPOSE_NATIVE_EGL)
+ #include <EGL/egl.h>
+#endif
+#if defined(GLFW_EXPOSE_NATIVE_OSMESA)
+ #include <GL/osmesa.h>
+#endif
+
+
+/*************************************************************************
+ * Functions
+ *************************************************************************/
+
+#if defined(GLFW_EXPOSE_NATIVE_WIN32)
+/*! @brief Returns the adapter device name of the specified monitor.
+ *
+ *  @return The UTF-8 encoded adapter device name (for example `\\.\DISPLAY1`)
+ *  of the specified monitor, or `NULL` if an [error](@ref error_handling)
+ *  occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.1.
+ *
+ *  @ingroup native
+ */
+GLFWAPI const char* glfwGetWin32Adapter(GLFWmonitor* monitor);
+
+/*! @brief Returns the display device name of the specified monitor.
+ *
+ *  @return The UTF-8 encoded display device name (for example
+ *  `\\.\DISPLAY1\Monitor0`) of the specified monitor, or `NULL` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.1.
+ *
+ *  @ingroup native
+ */
+GLFWAPI const char* glfwGetWin32Monitor(GLFWmonitor* monitor);
+
+/*! @brief Returns the `HWND` of the specified window.
+ *
+ *  @return The `HWND` of the specified window, or `NULL` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup native
+ */
+GLFWAPI HWND glfwGetWin32Window(GLFWwindow* window);
+#endif
+
+#if defined(GLFW_EXPOSE_NATIVE_WGL)
+/*! @brief Returns the `HGLRC` of the specified window.
+ *
+ *  @return The `HGLRC` of the specified window, or `NULL` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup native
+ */
+GLFWAPI HGLRC glfwGetWGLContext(GLFWwindow* window);
+#endif
+
+#if defined(GLFW_EXPOSE_NATIVE_COCOA)
+/*! @brief Returns the `CGDirectDisplayID` of the specified monitor.
+ *
+ *  @return The `CGDirectDisplayID` of the specified monitor, or
+ *  `kCGNullDirectDisplay` if an [error](@ref error_handling) occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.1.
+ *
+ *  @ingroup native
+ */
+GLFWAPI CGDirectDisplayID glfwGetCocoaMonitor(GLFWmonitor* monitor);
+
+/*! @brief Returns the `NSWindow` of the specified window.
+ *
+ *  @return The `NSWindow` of the specified window, or `nil` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup native
+ */
+GLFWAPI id glfwGetCocoaWindow(GLFWwindow* window);
+#endif
+
+#if defined(GLFW_EXPOSE_NATIVE_NSGL)
+/*! @brief Returns the `NSOpenGLContext` of the specified window.
+ *
+ *  @return The `NSOpenGLContext` of the specified window, or `nil` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup native
+ */
+GLFWAPI id glfwGetNSGLContext(GLFWwindow* window);
+#endif
+
+#if defined(GLFW_EXPOSE_NATIVE_X11)
+/*! @brief Returns the `Display` used by GLFW.
+ *
+ *  @return The `Display` used by GLFW, or `NULL` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup native
+ */
+GLFWAPI Display* glfwGetX11Display(void);
+
+/*! @brief Returns the `RRCrtc` of the specified monitor.
+ *
+ *  @return The `RRCrtc` of the specified monitor, or `None` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.1.
+ *
+ *  @ingroup native
+ */
+GLFWAPI RRCrtc glfwGetX11Adapter(GLFWmonitor* monitor);
+
+/*! @brief Returns the `RROutput` of the specified monitor.
+ *
+ *  @return The `RROutput` of the specified monitor, or `None` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.1.
+ *
+ *  @ingroup native
+ */
+GLFWAPI RROutput glfwGetX11Monitor(GLFWmonitor* monitor);
+
+/*! @brief Returns the `Window` of the specified window.
+ *
+ *  @return The `Window` of the specified window, or `None` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup native
+ */
+GLFWAPI Window glfwGetX11Window(GLFWwindow* window);
+
+/*! @brief Sets the current primary selection to the specified string.
+ *
+ *  @param[in] string A UTF-8 encoded string.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @pointer_lifetime The specified string is copied before this function
+ *  returns.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref clipboard
+ *  @sa glfwGetX11SelectionString
+ *  @sa glfwSetClipboardString
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup native
+ */
+GLFWAPI void glfwSetX11SelectionString(const char* string);
+
+/*! @brief Returns the contents of the current primary selection as a string.
+ *
+ *  If the selection is empty or if its contents cannot be converted, `NULL`
+ *  is returned and a @ref GLFW_FORMAT_UNAVAILABLE error is generated.
+ *
+ *  @return The contents of the selection as a UTF-8 encoded string, or `NULL`
+ *  if an [error](@ref error_handling) occurred.
+ *
+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref
+ *  GLFW_PLATFORM_ERROR.
+ *
+ *  @pointer_lifetime The returned string is allocated and freed by GLFW. You
+ *  should not free it yourself. It is valid until the next call to @ref
+ *  glfwGetX11SelectionString or @ref glfwSetX11SelectionString, or until the
+ *  library is terminated.
+ *
+ *  @thread_safety This function must only be called from the main thread.
+ *
+ *  @sa @ref clipboard
+ *  @sa glfwSetX11SelectionString
+ *  @sa glfwGetClipboardString
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup native
+ */
+GLFWAPI const char* glfwGetX11SelectionString(void);
+#endif
+
+#if defined(GLFW_EXPOSE_NATIVE_GLX)
+/*! @brief Returns the `GLXContext` of the specified window.
+ *
+ *  @return The `GLXContext` of the specified window, or `NULL` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup native
+ */
+GLFWAPI GLXContext glfwGetGLXContext(GLFWwindow* window);
+
+/*! @brief Returns the `GLXWindow` of the specified window.
+ *
+ *  @return The `GLXWindow` of the specified window, or `None` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.2.
+ *
+ *  @ingroup native
+ */
+GLFWAPI GLXWindow glfwGetGLXWindow(GLFWwindow* window);
+#endif
+
+#if defined(GLFW_EXPOSE_NATIVE_WAYLAND)
+/*! @brief Returns the `struct wl_display*` used by GLFW.
+ *
+ *  @return The `struct wl_display*` used by GLFW, or `NULL` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.2.
+ *
+ *  @ingroup native
+ */
+GLFWAPI struct wl_display* glfwGetWaylandDisplay(void);
+
+/*! @brief Returns the `struct wl_output*` of the specified monitor.
+ *
+ *  @return The `struct wl_output*` of the specified monitor, or `NULL` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.2.
+ *
+ *  @ingroup native
+ */
+GLFWAPI struct wl_output* glfwGetWaylandMonitor(GLFWmonitor* monitor);
+
+/*! @brief Returns the main `struct wl_surface*` of the specified window.
+ *
+ *  @return The main `struct wl_surface*` of the specified window, or `NULL` if
+ *  an [error](@ref error_handling) occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.2.
+ *
+ *  @ingroup native
+ */
+GLFWAPI struct wl_surface* glfwGetWaylandWindow(GLFWwindow* window);
+#endif
+
+#if defined(GLFW_EXPOSE_NATIVE_EGL)
+/*! @brief Returns the `EGLDisplay` used by GLFW.
+ *
+ *  @return The `EGLDisplay` used by GLFW, or `EGL_NO_DISPLAY` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup native
+ */
+GLFWAPI EGLDisplay glfwGetEGLDisplay(void);
+
+/*! @brief Returns the `EGLContext` of the specified window.
+ *
+ *  @return The `EGLContext` of the specified window, or `EGL_NO_CONTEXT` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup native
+ */
+GLFWAPI EGLContext glfwGetEGLContext(GLFWwindow* window);
+
+/*! @brief Returns the `EGLSurface` of the specified window.
+ *
+ *  @return The `EGLSurface` of the specified window, or `EGL_NO_SURFACE` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.0.
+ *
+ *  @ingroup native
+ */
+GLFWAPI EGLSurface glfwGetEGLSurface(GLFWwindow* window);
+#endif
+
+#if defined(GLFW_EXPOSE_NATIVE_OSMESA)
+/*! @brief Retrieves the color buffer associated with the specified window.
+ *
+ *  @param[in] window The window whose color buffer to retrieve.
+ *  @param[out] width Where to store the width of the color buffer, or `NULL`.
+ *  @param[out] height Where to store the height of the color buffer, or `NULL`.
+ *  @param[out] format Where to store the OSMesa pixel format of the color
+ *  buffer, or `NULL`.
+ *  @param[out] buffer Where to store the address of the color buffer, or
+ *  `NULL`.
+ *  @return `GLFW_TRUE` if successful, or `GLFW_FALSE` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup native
+ */
+GLFWAPI int glfwGetOSMesaColorBuffer(GLFWwindow* window, int* width, int* height, int* format, void** buffer);
+
+/*! @brief Retrieves the depth buffer associated with the specified window.
+ *
+ *  @param[in] window The window whose depth buffer to retrieve.
+ *  @param[out] width Where to store the width of the depth buffer, or `NULL`.
+ *  @param[out] height Where to store the height of the depth buffer, or `NULL`.
+ *  @param[out] bytesPerValue Where to store the number of bytes per depth
+ *  buffer element, or `NULL`.
+ *  @param[out] buffer Where to store the address of the depth buffer, or
+ *  `NULL`.
+ *  @return `GLFW_TRUE` if successful, or `GLFW_FALSE` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup native
+ */
+GLFWAPI int glfwGetOSMesaDepthBuffer(GLFWwindow* window, int* width, int* height, int* bytesPerValue, void** buffer);
+
+/*! @brief Returns the `OSMesaContext` of the specified window.
+ *
+ *  @return The `OSMesaContext` of the specified window, or `NULL` if an
+ *  [error](@ref error_handling) occurred.
+ *
+ *  @thread_safety This function may be called from any thread.  Access is not
+ *  synchronized.
+ *
+ *  @since Added in version 3.3.
+ *
+ *  @ingroup native
+ */
+GLFWAPI OSMesaContext glfwGetOSMesaContext(GLFWwindow* window);
+#endif
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* _glfw3_native_h_ */
+
diff --git a/frontends/sdl/sdl_ui.c b/frontends/sdl/sdl_ui.c
index c36e440..3dfc93a 100644
--- a/frontends/sdl/sdl_ui.c
+++ b/frontends/sdl/sdl_ui.c
@@ -10,6 +10,7 @@
 #include <pthread.h>
 #include <unistd.h>
 #endif
+#include <math.h>
 #include <stdlib.h>
 #include <string.h>
 #include <stdio.h>
@@ -32,6 +33,16 @@ TTF_Font* font;
 SDL_Window *window;
 SDL_Surface *screen;
 
+bool dark_mode;
+SDL_Color main_color;
+SDL_Color off;
+SDL_Color text;
+
+float count_down;
+bool game_running;
+
+long long timer;
+
 cetris_game g;
 
 uint8_t colors[7][3] = {
@@ -48,15 +59,20 @@ uint8_t colors[7][3] = {
 DWORD WINAPI game_loop(void* data) {
   LARGE_INTEGER StartingTime, EndingTime, ElapsedMicroseconds;
   LARGE_INTEGER Frequency;
-  LONGLONG nsec = (LONGLONG)(10000000L/CETRIS_HZ);
+  QueryPerformanceFrequency(&Frequency);
+  QueryPerformanceCounter(&StartingTime);
   while(1) {
-    ElapsedMicroseconds.QuadPart = 0;
-    QueryPerformanceCounter(&StartingTime);
-    while (ElapsedMicroseconds.QuadPart <= nsec) {
-        QueryPerformanceCounter(&EndingTime); 
-	ElapsedMicroseconds.QuadPart = EndingTime.QuadPart - StartingTime.QuadPart;
+    if (!game_running) break;
+    QueryPerformanceCounter(&EndingTime); 
+    ElapsedMicroseconds.QuadPart = EndingTime.QuadPart - StartingTime.QuadPart;
+    ElapsedMicroseconds.QuadPart *= 1000000;
+    ElapsedMicroseconds.QuadPart /= Frequency.QuadPart;
+    timer = ElapsedMicroseconds.QuadPart;
+    g.tick = ElapsedMicroseconds.QuadPart / 1000;
+    if (!update_game_tick(&g)) {
+	    break;
     }
-    update_game_tick(&g);
+    Sleep(1);
   }
   return 0;
 }
@@ -75,18 +91,18 @@ void setup() {
   SDL_Init(SDL_INIT_VIDEO|SDL_INIT_AUDIO);
   window = SDL_CreateWindow("cetris", SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED, W, H, SDL_WINDOW_SHOWN);
   screen = SDL_GetWindowSurface(window);
+  SDL_SetHint(SDL_HINT_RENDER_SCALE_QUALITY, "1");
   render = SDL_CreateRenderer(window, -1, SDL_RENDERER_PRESENTVSYNC|SDL_RENDERER_ACCELERATED);
   SDL_RenderSetLogicalSize(render, W, H);
   if (!render) exit(fprintf(stderr, "err: could not create SDL renderer\n")); 
-  SDL_SetRenderDrawBlendMode(render, SDL_BLENDMODE_BLEND);
 
   TTF_Init();
-  font = TTF_OpenFont("LiberationMono-Regular.ttf", 18);
+  font = TTF_OpenFont("OpenSans-Regular.ttf", 20);
+  TTF_SetFontHinting(font, TTF_HINTING_MONO);
 }
 
 void draw_text(char* string, int x, int y) {
-  SDL_Color black = {0, 0, 0, 255};
-  SDL_Surface* surface = TTF_RenderText_Solid(font, string, black);
+  SDL_Surface* surface = TTF_RenderText_Solid(font, string, text);
   SDL_Rect message;
   message.x = x;
   message.y = y;
@@ -99,17 +115,32 @@ void draw_text(char* string, int x, int y) {
   SDL_FreeSurface(surface);
 }
 
+void load_colors() {
+	if (dark_mode) {
+		main_color = (SDL_Color){100, 100, 100, 255};
+		off =  (SDL_Color){50, 50, 50, 255};
+		text = (SDL_Color){240, 240, 240, 255};
+  		SDL_SetRenderDrawBlendMode(render, SDL_BLENDMODE_ADD);
+	} else {
+		main_color = (SDL_Color){255, 255, 255, 255};
+		off =  (SDL_Color){235, 235, 235, 255};
+		text = (SDL_Color){10, 10, 10, 255};
+  		SDL_SetRenderDrawBlendMode(render, SDL_BLENDMODE_BLEND);
+	}
+}
+
+
 void draw() {
   SDL_Texture *m = SDL_CreateTexture(render, SDL_PIXELFORMAT_RGBA8888, SDL_TEXTUREACCESS_TARGET, W, H);
   SDL_SetRenderTarget(render, m);
-
-  SDL_SetRenderDrawColor(render, 255, 255, 255, 255);
+  
+  SDL_SetRenderDrawColor(render, main_color.r, main_color.g, main_color.b, 255);
   SDL_RenderClear(render);
 
-  SDL_Rect board = {X_OFFSET, Y_OFFSET, 250, 500};
+  SDL_Rect board = {X_OFFSET + 1, Y_OFFSET, 250, 500};
   SDL_Rect queue = {W - (W / 4), Y_OFFSET, (BLOCK_SIZE * 4) + 20, BLOCK_SIZE * 5 * 3};
   SDL_Rect hold = {30, Y_OFFSET, BLOCK_SIZE * 4, BLOCK_SIZE * 4};
-  SDL_SetRenderDrawColor(render, 235, 235, 235, 255);
+  SDL_SetRenderDrawColor(render, off.r - (fmod((double)count_down, (double)1.0) * 50), off.g, off.b, 255);
   SDL_RenderFillRect(render, &board);
   SDL_RenderFillRect(render, &queue);
   SDL_RenderFillRect(render, &hold);
@@ -117,7 +148,7 @@ void draw() {
   SDL_RenderDrawRect(render, &queue);
   SDL_RenderDrawRect(render, &hold);
 
-  SDL_SetRenderDrawColor(render, 255, 255, 255, 255);
+  SDL_SetRenderDrawColor(render, main_color.r, main_color.g, main_color.b, 255);
   for (int x = 0; x < CETRIS_BOARD_X + 1; x++) {
     int rx = X_OFFSET + 1 + (x * BLOCK_SIZE);
     SDL_RenderDrawLine(render, rx, Y_OFFSET + 1, rx, Y_OFFSET + 500);
@@ -127,13 +158,13 @@ void draw() {
     SDL_RenderDrawLine(render, X_OFFSET + 1, ry, X_OFFSET + 250, ry);
   }
 
-  SDL_Rect b = {0, 0, BLOCK_SIZE - 1, BLOCK_SIZE - 1}; 
+  SDL_Rect b = {0, 0, BLOCK_SIZE, BLOCK_SIZE}; 
   SDL_Rect w = {0, 0, BLOCK_SIZE + 1, BLOCK_SIZE + 1}; 
 
   for (int y = 0; y < 4; y++) {
     for (int x = 0; x < 4; x++) {
       if ((g.current.m[y]>>(3 - x))&1) {
-        b.x = X_OFFSET + ((x + g.current.pos.x) * BLOCK_SIZE);
+        b.x = X_OFFSET + ((x + g.current.pos.x) * BLOCK_SIZE) + 1;
         b.y = (Y_OFFSET + ((y + g.current.pos.y) * BLOCK_SIZE)) - (CETRIS_BOARD_VISABLE * BLOCK_SIZE);
   
         uint8_t (*color)[3] = &(colors[g.current.t]);
@@ -142,7 +173,7 @@ void draw() {
         SDL_RenderFillRect(render, &b);
         SDL_RenderDrawRect(render, &b);
 
-        SDL_SetRenderDrawColor(render, 240, 240, 240, 255);
+        SDL_SetRenderDrawColor(render, off.r, off.g, off.b, 255);
         w.y = b.y - 1;
         w.x = b.x - 1;
         SDL_RenderDrawRect(render, &w);
@@ -174,7 +205,7 @@ void draw() {
           SDL_RenderFillRect(render, &b);
           SDL_RenderDrawRect(render, &b);
 
-          SDL_SetRenderDrawColor(render, 240, 240, 240, 255);
+          SDL_SetRenderDrawColor(render, off.r, off.g, off.b, 255);
           w.y = b.y - 1;
           w.x = b.x - 1;
           SDL_RenderDrawRect(render, &w);
@@ -208,7 +239,7 @@ void draw() {
           SDL_RenderFillRect(render, &b);
           SDL_RenderDrawRect(render, &b);
 
-          SDL_SetRenderDrawColor(render, 240, 240, 240, 255);
+          SDL_SetRenderDrawColor(render, off.r, off.g, off.b, 255);
           w.y = b.y - 1;
           w.x = b.x - 1;
           SDL_RenderDrawRect(render, &w);
@@ -220,7 +251,7 @@ void draw() {
   for (int x = 0; x < CETRIS_BOARD_X; x++) {
     for (int y = g.highest_line; y < CETRIS_BOARD_Y; y++) {
       if (g.board[x][y] & SLOT_OCCUPIED) {
-        b.x = X_OFFSET + (x * BLOCK_SIZE);
+        b.x = X_OFFSET + (x * BLOCK_SIZE) + 1;
         b.y = (Y_OFFSET + (y * BLOCK_SIZE)) - (CETRIS_BOARD_VISABLE * BLOCK_SIZE);
  
         if (g.line_remove_tick[y]) {
@@ -229,7 +260,7 @@ void draw() {
           }
         }
 
-        SDL_SetRenderDrawColor(render, 240, 240, 240, 255);
+        SDL_SetRenderDrawColor(render, off.r, off.g, off.b, 255);
         w.y = b.y - 1;
         w.x = b.x - 1;
         SDL_RenderDrawRect(render, &w);
@@ -243,10 +274,20 @@ void draw() {
     }
   }
 
-  long double time = g.tick / 60.0f;
   char *buf = malloc(200);
-  sprintf(buf, "%.18Lf", time);
-  draw_text(buf, 20, 20);
+  long double second = timer / 1000000.0f;
+  if (second > 60.0f) {
+    int minute = (int)(second / 60.0f);
+    second -= (minute * 60.0f);
+    sprintf(buf, "%02d:%09.6Lf", minute, second);
+  } else {
+    sprintf(buf, "%.6Lf", second);
+  }
+  draw_text(buf, 20, H - 40);
+
+  sprintf(buf, "lines remaining: %i", 20 - g.lines);
+  draw_text(buf, 20, H - 60);
+
   free(buf);
 
   SDL_SetRenderTarget(render, NULL);
@@ -255,40 +296,50 @@ void draw() {
   SDL_RenderCopyEx(render, m, NULL, NULL, 0, &center, SDL_FLIP_NONE); 
 
   SDL_DestroyTexture(m);
-  SDL_RenderPresent(render);
+
+  if (count_down > 0) {
+	  count_down-=(1.0/144.0);
+  }
+}
+
+void start_game() {
+  g.waiting = false;
+#ifdef _WIN32
+  HANDLE thread = CreateThread(NULL, 0, game_loop, NULL, 0, NULL);
+#else
+  pthread_t thread;
+  pthread_create(&thread, NULL, (void*)game_loop, (void*)0);
+#endif
 }
 
 int main(void) {
   setup();
 
-
-  
   ini_parser p;
   load_ini_file(&p, "config.ini");
 
   cetris_config config;
   
   int das = atoi(get_ini_value(&p, "das", "das"));
-  config.das_das = das * .06f;
+  config.das_das = das;
 
   int arr = atoi(get_ini_value(&p, "das", "arr"));
-  config.das_arr = arr * .06f;
+  config.das_arr = arr;
 
-  config.drop_period = atoi(get_ini_value(&p, "game", "drop_delay")) * .06f;
+  config.drop_period = atoi(get_ini_value(&p, "game", "drop_delay"));
   config.next_piece_delay = atoi(get_ini_value(&p, "game", "next_piece_delay"));
   config.lock_delay = atoi(get_ini_value(&p, "game", "lock_delay"));
+  config.force_lock = atoi(get_ini_value(&p, "game", "force_lock"));
   config.wait_on_clear = atoi(get_ini_value(&p, "game", "wait_on_clear"));
   config.line_delay_clear = atoi(get_ini_value(&p, "game", "line_clear_delay"));
 
+  dark_mode = atoi(get_ini_value(&p, "ui", "dark_mode"));
+  load_colors();
+   
+  count_down = 3;  
   init_game(&g, &config);
-
-#ifdef _WIN32
-  HANDLE thread = CreateThread(NULL, 0, game_loop, NULL, 0, NULL);
-#else
-  pthread_t thread;
-  pthread_create(&thread, NULL, (void*)game_loop, (void*)0);
-#endif
-
+  g.waiting = true;
+   
   SDL_Event e;
   for(;;) {
     while(SDL_PollEvent(&e)) {
@@ -302,7 +353,7 @@ int main(void) {
             case SDLK_RIGHT:
               move_piece(&g, RIGHT); break;
             case SDLK_DOWN:
-              move_piece(&g, USER_DOWN); break;
+              move_piece(&g, DOWN); break;
             case SDLK_SPACE:
               move_piece(&g, HARD_DROP); break;
             case SDLK_UP:
@@ -314,7 +365,11 @@ int main(void) {
             case 'z':
               move_piece(&g, ROTATE_CCW); break;
             case 'r':
-              init_game(&g, &config); break;
+	      game_running = false;
+	      init_game(&g, &config);
+  	      g.waiting = true;
+	      count_down = 3;
+	      break;
           }
           break;
         case SDL_KEYUP:
@@ -324,7 +379,7 @@ int main(void) {
             case SDLK_RIGHT:
               unhold_piece(&g, RIGHT); break;
             case SDLK_DOWN:
-              unhold_piece(&g, USER_DOWN); break;
+              unhold_piece(&g, DOWN); break;
             case SDLK_SPACE:
               unhold_piece(&g, HARD_DROP); break;
             case SDLK_UP:
@@ -337,6 +392,12 @@ int main(void) {
       }
     }
     draw();
+
+    if (count_down < 0 && !game_running) {
+	    start_game();
+	    game_running = true;
+    }
+    SDL_RenderPresent(render);
     SDL_Delay(1000 / 144);
   }
 
diff --git a/lib/cetris.h b/lib/cetris.h
index 4d654c7..59cdf27 100644
--- a/lib/cetris.h
+++ b/lib/cetris.h
@@ -1,698 +1,711 @@
-#ifndef CETRIS_H

-#define CETRIS_H

-

-#include <assert.h>

-#include <stdbool.h>

-#include <stdint.h>

-#include <stdlib.h>

-#include <string.h>

-#include <time.h>

-

-#ifdef BUILD_TESTS

-#include "test.h"

-#endif

-

-#define CETRIS_EXPORT

-

-#define CETRIS_BOARD_X 10

-#define CETRIS_BOARD_Y 40

-#define CETRIS_BOARD_VISABLE 20

-

-#define CETRIS_HI_RES 1

-

-#if CETRIS_HI_RES

-#define CETRIS_HZ 6000

-typedef float ctick;

-#else

-#define CETRIS_HZ 60

-typedef uint16_t ctick;

-#endif

-

-#define CETRIS_ENABLE_DAS 1

-

-#define CETRIS_DROP_PERIOD 2

-#define CETRIS_NEXT_PIECE_DELAY 40

-#define CETRIS_LINE_CLEAR_DELAY 40

-#define CETRIS_LOCK_DELAY 30

-#define CETRIS_WAIT_ON_CLEAR 0

-

-#define CETRIS_STARTING_LEVEL 1

-

-typedef struct {

-  int8_t x;

-  int8_t y;

-} vec2;

-

-typedef uint8_t piece_matrix[4];

-

-enum {

-  MINO_O,

-  MINO_I,

-  MINO_S,

-  MINO_Z,

-  MINO_L,

-  MINO_J,

-  MINO_T

-};

-

-enum {

-  SLOT_OCCUPIED = 1,

-};

-

-enum { 

-  INIT, 

-  ONCE_RIGHT, 

-  TWICE, 

-  ONCE_LEFT 

-};

-

-typedef struct {

-  vec2 pos;

-  uint8_t t;

-  uint8_t r;

-  uint8_t ghost_y;

-  uint16_t lock_tick;

-  bool locked;

-  piece_matrix m;

-} tetrimino;

-

-typedef enum {

-  DOWN = 1,

-  USER_DOWN = 2,

-  RIGHT = 3,

-  LEFT = 4,

-  ROTATE_CCW = 5,

-  ROTATE_CW = 6,

-  HARD_DROP = 7

-} input_t;

-

-typedef struct {

-#if CETRIS_ENABLE_DAS

-  ctick das_arr; 

-  ctick das_das;

-#endif

-

-  ctick drop_period;

-  ctick next_piece_delay;

-  ctick line_delay_clear;

-  ctick lock_delay;

-  

-  bool wait_on_clear;

-} cetris_config;

-

-typedef struct {

-  // playfield represented by a 2d array

-  uint8_t board[CETRIS_BOARD_X][CETRIS_BOARD_Y];

-  int8_t highest_line;

-

-  // queue of all 7 possible tetrimino

-  uint8_t piece_queue[7];

-  uint8_t next_queue[7];

-  uint8_t current_index;

-

-  // current tetrimino

-  tetrimino current;

-  tetrimino held;

-  bool piece_held;

-

-  // internal game tick

-  ctick tick;

-  ctick next_drop_tick;

-  ctick next_piece_tick;

-  ctick down_move_tick;

-  ctick line_remove_tick[CETRIS_BOARD_Y];

-

-#if CETRIS_ENABLE_DAS

-  ctick das_wait;

-  ctick next_das_move;

-  uint8_t das_move;

-  uint8_t held_moves[8];

-#endif

-

-  // progress trackers 

-  uint8_t lines;

-  uint8_t level;

-  bool game_over;

-

-  // scoring flags

-  bool tspin;

-  bool mini_tspin;

-

-  // score counter

-  uint16_t score;

-  

-  // config

-  cetris_config config;

-} cetris_game;

-

-const piece_matrix default_matrices[7] = {

-    { 0b0000, 0b0110, 0b0110, 0b0000},

-    { 0b0000, 0b1111, 0b0000, 0b0000},

-    { 0b0000, 0b0110, 0b1100, 0b0000},

-    { 0b0000, 0b1100, 0b0110, 0b0000},

-    { 0b0000, 0b0010, 0b1110, 0b0000},

-    { 0b0000, 0b1000, 0b1110, 0b0000},

-    { 0b0000, 0b0100, 0b1110, 0b0000}};

-

-/* SRS WALL KICK VALUES */

-

-// https://tetris.wiki/SRS

-static const vec2 srs_wall_kicks[8][5] = {

-    {{0, 0}, {-1, 0}, {-1, 1}, {0, -2}, {-1, -2}}, // 0->R

-    {{0, 0}, {1, 0}, {1, -1}, {0, 2}, {1, 2}},     // R->0

-    {{0, 0}, {1, 0}, {1, -1}, {0, 2}, {1, 2}},     // R->2

-    {{0, 0}, {-1, 0}, {-1, 1}, {0, -2}, {-1, -2}}, // 2->R

-    {{0, 0}, {1, 0}, {1, 1}, {0, -2}, {1, -2}},    // 2->L

-    {{0, 0}, {-1, 0}, {-1, -1}, {0, 2}, {-1, 2}},  // L->2

-    {{0, 0}, {-1, 0}, {-1, -1}, {0, 2}, {-1, 2}},  // L->0

-    {{0, 0}, {1, 0}, {1, 1}, {0, -2}, {1, -2}}     // 0->L

-};

-

-static const vec2 srs_wall_kicks_i[8][5] = {

-    {{0, 0}, {-2, 0}, {1, 0}, {-2, -1}, {1, 2}}, // 0->R

-    {{0, 0}, {2, 0}, {-1, 0}, {2, 1}, {-1, -2}}, // R->0

-    {{0, 0}, {-1, 0}, {2, 0}, {-1, 2}, {2, -1}}, // R->2

-    {{0, 0}, {1, 0}, {-2, 0}, {1, -2}, {-2, 1}}, // 2->R

-    {{0, 0}, {2, 0}, {-1, 0}, {2, 1}, {-1, -2}}, // 2->L

-    {{0, 0}, {-2, 0}, {1, 0}, {-2, -1}, {1, 2}}, // L->2

-    {{0, 0}, {1, 0}, {-2, 0}, {1, -2}, {-2, 1}}, // L->0

-    {{0, 0}, {-1, 0}, {2, 0}, {-1, 2}, {2, -1}}  // 0->L

-};

-

-static const vec2 basic_movements[5] = {

-    {0, 0}, // NONE

-    {0, 1}, // DOWN

-    {0, 1}, // USER_DOWN

-    {1, 0}, // RIGHT

-    {-1, 0} // LEFT

-};

-

-// https://tetris.fandom.com/wiki/Tetris_Worlds

-// TODO: Make this more accurate

-static const int level_drop_delay[20] = {60, 48, 37, 28, 21, 16, 11, 8, 6, 4,

-                                         3,  2,  1,  1,  1,  1,  1,  1, 1, 1};

-

-static void update_board(cetris_game *g);

-

-CETRIS_EXPORT void update_game_tick(cetris_game *g);

-CETRIS_EXPORT void hold_piece(cetris_game *g);

-CETRIS_EXPORT void init_game(cetris_game *g, cetris_config *c);

-CETRIS_EXPORT void hold_piece(cetris_game *g);

-

-static void set_piece(uint8_t type, tetrimino* mino) {

-  memset(mino, 0, sizeof(tetrimino));

-

-  mino->t = type;

-  memcpy(mino->m, default_matrices[type], sizeof(piece_matrix));

-

-  /* Pieces should spawn so that on the first down

-   * tick the bottom row will show. Values here are adjusted

-   * for the default 4x4 matricies for each piece */

-  mino->pos.x = 3;

-  mino->pos.y = (type == MINO_I) ? 17 : 16;

-}

-

-static void shuffle_queue(cetris_game *g) {

-  for (int i = 0; i < 7; i++) {

-    uint8_t rand_index = rand() % 7;

-    uint8_t tmp = g->next_queue[i];

-    g->next_queue[i] = g->next_queue[rand_index];

-    g->next_queue[rand_index] = tmp;

-  }

-}

-

-static int check_matrix(cetris_game *g, piece_matrix *m) {

-  for (uint8_t y = 0; y < 4; y++) {

-    for (uint8_t x = 0; x < 4; x++) {

-      vec2 r = (vec2){x + g->current.pos.x, y + g->current.pos.y};

-      if (r.y < 0)

-        continue;

-      if (((*m)[y]>>(3 - x))&1) {

-        if (r.x >= CETRIS_BOARD_X || r.x < 0)

-          return 0;

-        if (r.y >= CETRIS_BOARD_Y)

-          return -1;

-        if (g->board[r.x][r.y] & SLOT_OCCUPIED)

-          return -1;

-      }

-    }

-  }

-  return 1;

-}

-

-// TODO: hard score

-static void add_score(cetris_game *g, int lines) {

-  if (!g->tspin && !g->mini_tspin) {

-    switch (lines) {

-    case 1:

-      g->score += 100 * g->level;

-      break;

-    case 2:

-      g->score += 300 * g->level;

-      break;

-    case 3:

-      g->score += 500 * g->level;

-      break;

-    case 4:

-      g->score += 800 * g->level;

-      break;

-    }

-  } else if (g->tspin) {

-    switch (lines) {

-    case 0:

-      g->score += 400 * g->level;

-      break;

-    case 1:

-      g->score += 800 * g->level;

-      break;

-    case 2:

-      g->score += 1200 * g->level;

-      break;

-    case 3:

-      g->score += 1600 * g->level;

-      break;

-    }

-    g->tspin = false;

-  } else if (g->mini_tspin) {

-    switch (lines) {

-    case 0:

-      g->score += 100 * g->level;

-      break;

-    case 1:

-      g->score += 200 * g->level;

-      break;

-    case 2:

-      g->score += 400 * g->level;

-      break;

-    }

-    g->mini_tspin = false;

-  }

-}

-

-static void make_ghosts(cetris_game *g) {

-  int8_t orig_y = g->current.pos.y;

-  while (check_matrix(g, &g->current.m) > 0) {

-    g->current.pos.y++;

-  }

-  if (g->current.pos.y == orig_y) {

-    g->current.ghost_y = orig_y;

-  } else {

-    g->current.ghost_y = g->current.pos.y - 1;

-  }

-  g->current.pos.y = orig_y;

-}

-

-static void move_current(cetris_game *g, uint8_t move) {

-  if (g->game_over || g->next_piece_tick)

-    return;

-

-#if CETRIS_ENABLE_DAS

-  if (move == USER_DOWN) return;

-#endif

-

-  g->current.pos.y += basic_movements[move].y;

-  g->current.pos.x += basic_movements[move].x;

-

-  int check = check_matrix(g, &g->current.m);

-  if (check <= 0) {

-    g->current.pos.y -= basic_movements[move].y;

-    g->current.pos.x -= basic_movements[move].x;

-

-    if (move == DOWN && check == -1 && !g->current.lock_tick) {

-      g->current.lock_tick = g->tick + g->config.lock_delay;

-    }

-  } else {

-    if (move == USER_DOWN)

-      g->score++;

-    if ((move == DOWN) | (move == USER_DOWN))

-      g->current.lock_tick = 0;

-  }

-

-  update_board(g);

-}

-

-static void next_piece(cetris_game *g) {

-  g->next_drop_tick = 0;

-  g->next_piece_tick = 0;

-

-  set_piece(g->piece_queue[g->current_index], &g->current);

-

-  if (check_matrix(g, &g->current.m) <= 0) {

-    g->game_over = true;

-  }

-

-  if (!g->game_over) {

-    move_current(g, DOWN);

-  }

-  

-  g->current_index++;

-  if (g->current_index == 7) {

-    memcpy(&g->piece_queue, &g->next_queue, sizeof(g->piece_queue));

-    g->current_index = 0;

-    shuffle_queue(g);

-  }

-

-  update_board(g);

-}

-

-static void lock_current(cetris_game *g) {

-  g->current.locked = true;

-  for (int y = 0; y < 4; y++) {

-    for (int x = 0; x < 4; x++) {

-      if ((g->current.m[y]>>(3 - x))&1) {

-        g->board[g->current.pos.x + x][g->current.pos.y + y] |= SLOT_OCCUPIED;

-        g->board[g->current.pos.x + x][g->current.pos.y + y] |= g->current.t << 5;

-      }

-    }

-  }

-

-  if (g->current.pos.y < g->highest_line) {

-    g->highest_line = g->current.pos.y;

-  }

-

-  update_board(g);

-}

-

-static void hard_drop(cetris_game *g) {

-  if (g->game_over || g->next_piece_tick)

-    return;

-

-  int drop_count = 0;

-  while (check_matrix(g, &g->current.m) > 0) {

-    g->current.pos.y++;

-    drop_count++;

-  }

-  g->current.pos.y--;

-  drop_count--;

-

-  g->score += 2 * drop_count; // 2 score for each hard-drop'd cell

-

-  lock_current(g);

-  update_board(g);

-}

-

-static void rotate_matrix(cetris_game *g, piece_matrix *m, bool clockwise) {

-  for (uint8_t x = 0; x < 4; x++) {

-    for (uint8_t y = 0; y < 4; y++) {

-      if ((g->current.m[y]>>(3 - x))&1) {

-        uint8_t new_x = (clockwise) ? 1 - (y - 2) : 1 + (y - 2);

-        uint8_t new_y = (clockwise) ? 2 + (x - 1) : 2 - (x - 1);

-

-        if (g->current.t == MINO_I) {

-          clockwise ? new_y-- : new_x++;

-        }

-        

-        (*m)[new_y] |= (uint8_t)0b1000 >> (new_x);

-      }

-    }

-  }

-}

-

-static void rotate_piece(cetris_game *g, bool clockwise) {

-  if (g->game_over || g->next_piece_tick)

-    return;

-  if (g->current.t == MINO_O)

-    return;

-  

-  uint8_t next = 0;

-  uint8_t wall_kick = 0;

-  if (clockwise) {

-    next = (g->current.r + 1)%4;

-    wall_kick = g->current.r * 2;

-  } else {

-    next = ((g->current.r - 1) + 4)%4;

-    wall_kick = (next * 2) + 1;

-  }

-

-  piece_matrix m;

-  memset(&m, 0, sizeof(piece_matrix));

-

-  rotate_matrix(g, &m, clockwise);

-

-  vec2 kick;

-  bool set_current = false;

-  bool did_kick = false;

-  for (int i = 0; i < 4; i++) {

-    if (g->current.t == MINO_I) {

-      kick = srs_wall_kicks_i[wall_kick][i];

-    } else {

-      kick = srs_wall_kicks[wall_kick][i];

-    }

-

-    g->current.pos.x += kick.x;

-    g->current.pos.y -= kick.y;

-

-    if (check_matrix(g, &m) > 0) {

-      set_current = true;

-      if (i > 0) did_kick = true;

-      break;

-    }

-

-    g->current.pos.x -= kick.x;

-    g->current.pos.y += kick.y;

-  }

-

-  if (set_current) {

-    /* check for tspin */

-    if (g->current.t == MINO_T) {

-      bool did_tspin = true;

-      for (int i = 1; i < 5; i++) {

-        g->current.pos.x += basic_movements[i].x;

-        g->current.pos.y += basic_movements[i].y;

-

-        if (check_matrix(g, &m) == 1)

-          did_tspin = false;

-

-        g->current.pos.x -= basic_movements[i].x;

-        g->current.pos.y -= basic_movements[i].y;

-      }

-

-      if (did_tspin) {

-        if (did_kick) g->mini_tspin = true;

-        else g->tspin = true;

-      }

-    }

-

-    g->current.r = next;

-    memcpy(g->current.m, &m, sizeof(piece_matrix));

-    update_board(g);

-  }

-}

-

-void update_board(cetris_game *g) {

-  if (g->game_over)

-    return;

-

-  int lines_cleared = 0;

-  for (int y = g->highest_line; y < CETRIS_BOARD_Y; y++) {

-    bool clear_line = true;

-    for (int x = 0; x < CETRIS_BOARD_X; x++) {

-      if (!(g->board[x][y] & SLOT_OCCUPIED) 

-          || g->line_remove_tick[y] > 0) {

-        clear_line = false;

-      }

-    }

-

-    if (g->config.wait_on_clear) {

-      // remove tick only tracked on first block of line

-      if (g->line_remove_tick[y] && g->line_remove_tick[y] <= g->tick) {

-        g->line_remove_tick[y] = 0;

-        for (int s = y - 1; s >= 0; s--) {

-          for (int x = 0; x < CETRIS_BOARD_X; x++) {

-            g->board[x][s + 1] = g->board[x][s];

-          }

-        }

-      }

-      if (clear_line) {

-        g->line_remove_tick[y] = g->tick + g->config.line_delay_clear;

-        lines_cleared++;

-      }

-    } else if (clear_line) {

-      for (int s = y - 1; s >= 0; s--) {

-        for (int x = 0; x < CETRIS_BOARD_X; x++) {

-          g->board[x][s + 1] = g->board[x][s];

-        }

-      }

-      lines_cleared++;

-    }

-  }

-

-  make_ghosts(g);

-

-  assert(lines_cleared <= 4);

-

-  if (g->current.locked && !g->next_piece_tick) {

-    if (lines_cleared > 0) {

-      g->next_piece_tick = g->tick + g->config.next_piece_delay;

-    } else {

-      next_piece(g);

-    }

-  }

-

-  if (lines_cleared > 0 || g->tspin || g->mini_tspin) {

-    add_score(g, lines_cleared);

-    if (lines_cleared > 0) {

-      g->lines += lines_cleared;

-      if (g->lines >= 20) g->game_over = true;

-      if (g->lines >= (g->level * 10))

-        g->level++;

-    }

-  }

-}

-

-CETRIS_EXPORT void hold_piece(cetris_game *g) {

-  if (g->piece_held) {

-    tetrimino tmp = g->current;

-    g->current = g->held;

-    g->held = tmp;

-  } else {

-    set_piece(g->current.t, &g->held);

-    g->piece_held = true;

-    next_piece(g);

-  }

-  update_board(g);

-}

-

-#if CETRIS_ENABLE_DAS

-CETRIS_EXPORT void unhold_piece(cetris_game* g, input_t move) {

-  if (g->das_move == move) {

-    if (move == LEFT && g->held_moves[RIGHT]) {

-      g->das_move = RIGHT;

-      g->das_wait = g->tick + g->config.das_das;

-    } else if (move == RIGHT && g->held_moves[LEFT]) {

-      g->das_move = LEFT;

-      g->das_wait = g->tick + g->config.das_das;

-    } else {

-      g->das_wait = 0;

-    }

-    g->next_das_move = 0;

-  }

-  g->held_moves[move] = 0;

-}

-#endif

-

-CETRIS_EXPORT void move_piece(cetris_game *g, uint8_t move) {

-#if CETRIS_ENABLE_DAS

-  if (g->held_moves[move]) return;

-  if (move == LEFT || move == RIGHT) {

-    if ((move != g->das_move) || !g->das_wait) {

-      g->das_move = move;

-      g->das_wait = g->tick + g->config.das_das;

-      g->next_das_move = 0;

-    }

-  }

-  if (move == USER_DOWN) 

-    g->next_drop_tick = g->tick + g->config.drop_period;

-  g->held_moves[move] = 1;

-#endif

-

-  switch (move) {

-  case LEFT:

-  case RIGHT:

-  case DOWN:

-  case USER_DOWN:

-    move_current(g, move);

-    break;

-  case HARD_DROP:

-    hard_drop(g);

-    break;

-  case ROTATE_CW:

-    rotate_piece(g, 1);

-    break;

-  case ROTATE_CCW:

-    rotate_piece(g, 0);

-    break;

-  }

-

-}

-

-CETRIS_EXPORT void init_game(cetris_game *g, cetris_config* c) {

-

-  /* check for config errors */

-  assert(CETRIS_NEXT_PIECE_DELAY >= CETRIS_LINE_CLEAR_DELAY);

-

-  srand(time(NULL));

-

-#ifdef BUILD_TESTS

-  //apply_test_board(g, TSPIN_NO_LINES);

-#endif

-

-  memset(g, 0, sizeof(cetris_game));

-  memcpy(&g->config, c, sizeof(cetris_config));

-

-  g->level = CETRIS_STARTING_LEVEL;

-  g->highest_line = CETRIS_BOARD_Y;

-

-  for (int i = 0; i < 7; i++) {

-    g->next_queue[i] = i;

-  }

-

-  shuffle_queue(g);

-  memcpy(&g->piece_queue, &g->next_queue, sizeof(g->piece_queue));

-  shuffle_queue(g);

-

-  next_piece(g);

-}

-

-CETRIS_EXPORT void update_game_tick(cetris_game *g) {

-  if (g->game_over)

-    return;

-  

-#if CETRIS_HI_RES

-  g->tick += .01f;

-#else

-  g->tick++;

-#endif

-

-  if (g->next_piece_tick && g->tick >= g->next_piece_tick) {

-    next_piece(g);

-  }

-

-  if (g->next_piece_tick)

-    return;

-

-  bool did_move = false;

-  if (g->next_drop_tick && g->tick >= g->next_drop_tick) {

-    move_current(g, DOWN);

-    g->next_drop_tick = 0;

-    did_move = true;

-  }

-

-  if (!g->next_drop_tick) {

-    if (g->held_moves[USER_DOWN]) {

-      g->next_drop_tick = g->tick + g->config.drop_period;

-    } else {

-      if (g->level <= 20) {

-        g->next_drop_tick = g->tick + level_drop_delay[g->level - 1];

-      } else {

-        g->next_drop_tick = g->tick + level_drop_delay[19];

-      }

-    }

-  }

-

-  /* lock piece if it was hovering for CETRIS_LOCK_DELAY */

-  if (!g->next_piece_tick && g->current.lock_tick &&

-      g->current.lock_tick <= g->tick) {

-    g->current.pos.y++;

-    int8_t res = check_matrix(g, &g->current.m);

-    g->current.pos.y--;

-    if (res <= 0) {

-      lock_current(g);

-      did_move = true;

-    }

-    g->current.lock_tick = 0;

-  }

-

-#if CETRIS_ENABLE_DAS

-  if (g->next_das_move && g->tick >= g->next_das_move) {

-    g->next_das_move = g->tick + g->config.das_arr;

-    move_current(g, g->das_move);

-  } else if (!g->next_das_move && g->das_wait && g->tick >= g->das_wait) {

-    g->next_das_move = g->tick + g->config.das_arr;

-  }

-#endif

-

-  if (did_move) update_board(g);

-}

-

-#endif /* CETRIS_H */

+#ifndef CETRIS_H
+#define CETRIS_H
+
+#include <assert.h>
+#include <stdbool.h>
+#include <stdint.h>
+#include <stdlib.h>
+#include <string.h>
+#include <time.h>
+
+#ifdef BUILD_TESTS
+#include "test.h"
+#endif
+
+#define CETRIS_EXPORT
+
+#define CETRIS_BOARD_X 10
+#define CETRIS_BOARD_Y 40
+#define CETRIS_BOARD_VISABLE 20
+
+#define CETRIS_HI_RES 1
+
+#if CETRIS_HI_RES
+#define CETRIS_HZ 1000
+typedef uint64_t ctick;
+#else
+#define CETRIS_HZ 60
+typedef uint16_t ctick;
+#endif
+
+#define CETRIS_ENABLE_DAS 1
+
+#define CETRIS_DROP_PERIOD 2
+#define CETRIS_NEXT_PIECE_DELAY 40
+#define CETRIS_LINE_CLEAR_DELAY 40
+#define CETRIS_LOCK_DELAY 30
+#define CETRIS_WAIT_ON_CLEAR 0
+
+#define CETRIS_STARTING_LEVEL 4
+
+typedef struct {
+  int8_t x;
+  int8_t y;
+} vec2;
+
+typedef uint8_t piece_matrix[4];
+
+enum {
+  MINO_O,
+  MINO_I,
+  MINO_S,
+  MINO_Z,
+  MINO_L,
+  MINO_J,
+  MINO_T
+};
+
+enum {
+  SLOT_OCCUPIED = 1,
+};
+
+enum { 
+  INIT, 
+  ONCE_RIGHT, 
+  TWICE, 
+  ONCE_LEFT 
+};
+
+typedef struct {
+  vec2 pos;
+  uint8_t t;
+  uint8_t r;
+  uint8_t ghost_y;
+  bool locked;
+  bool held;
+  ctick lock_tick;
+  ctick force_lock_tick;
+  piece_matrix m;
+} tetrimino;
+
+typedef enum {
+  DOWN,
+  RIGHT,
+  LEFT,
+  ROTATE_CCW,
+  ROTATE_CW,
+  HARD_DROP
+} input_t;
+
+typedef struct {
+#if CETRIS_ENABLE_DAS
+  ctick das_arr; 
+  ctick das_das;
+#endif
+
+  ctick drop_period;
+  ctick next_piece_delay;
+  ctick line_delay_clear;
+  ctick lock_delay;
+  ctick force_lock;
+  
+  bool wait_on_clear;
+} cetris_config;
+
+typedef struct {
+  // playfield represented by a 2d array
+  uint8_t board[CETRIS_BOARD_X][CETRIS_BOARD_Y];
+  int8_t highest_line;
+
+  // queue of all 7 possible tetrimino
+  uint8_t piece_queue[7];
+  uint8_t next_queue[7];
+  uint8_t current_index;
+
+  // current tetrimino
+  tetrimino current;
+  tetrimino held;
+  bool piece_held;
+
+  // waiting to start
+  bool waiting;
+
+  // internal game tick
+  ctick tick;
+  ctick next_drop_tick;
+  ctick next_piece_tick;
+  ctick down_move_tick;
+  ctick line_remove_tick[CETRIS_BOARD_Y];
+
+#if CETRIS_ENABLE_DAS
+  ctick das_wait;
+  ctick next_das_move;
+  uint8_t das_move;
+  uint8_t held_moves[8];
+#endif
+
+  // progress trackers 
+  uint8_t lines;
+  uint8_t level;
+  bool game_over;
+
+  // scoring flags
+  bool tspin;
+  bool mini_tspin;
+
+  // score counter
+  uint16_t score;
+  
+  // config
+  cetris_config config;
+} cetris_game;
+
+const piece_matrix default_matrices[7] = {
+    { 0b0000, 0b0110, 0b0110, 0b0000},
+    { 0b0000, 0b1111, 0b0000, 0b0000},
+    { 0b0000, 0b0110, 0b1100, 0b0000},
+    { 0b0000, 0b1100, 0b0110, 0b0000},
+    { 0b0000, 0b0010, 0b1110, 0b0000},
+    { 0b0000, 0b1000, 0b1110, 0b0000},
+    { 0b0000, 0b0100, 0b1110, 0b0000}};
+
+/* SRS WALL KICK VALUES */
+
+// https://tetris.wiki/SRS
+static const vec2 srs_wall_kicks[8][5] = {
+    {{0, 0}, {-1, 0}, {-1, 1}, {0, -2}, {-1, -2}}, // 0->R
+    {{0, 0}, {1, 0}, {1, -1}, {0, 2}, {1, 2}},     // R->0
+    {{0, 0}, {1, 0}, {1, -1}, {0, 2}, {1, 2}},     // R->2
+    {{0, 0}, {-1, 0}, {-1, 1}, {0, -2}, {-1, -2}}, // 2->R
+    {{0, 0}, {1, 0}, {1, 1}, {0, -2}, {1, -2}},    // 2->L
+    {{0, 0}, {-1, 0}, {-1, -1}, {0, 2}, {-1, 2}},  // L->2
+    {{0, 0}, {-1, 0}, {-1, -1}, {0, 2}, {-1, 2}},  // L->0
+    {{0, 0}, {1, 0}, {1, 1}, {0, -2}, {1, -2}}     // 0->L
+};
+
+static const vec2 srs_wall_kicks_i[8][5] = {
+    {{0, 0}, {-2, 0}, {1, 0}, {-2, -1}, {1, 2}}, // 0->R
+    {{0, 0}, {2, 0}, {-1, 0}, {2, 1}, {-1, -2}}, // R->0
+    {{0, 0}, {-1, 0}, {2, 0}, {-1, 2}, {2, -1}}, // R->2
+    {{0, 0}, {1, 0}, {-2, 0}, {1, -2}, {-2, 1}}, // 2->R
+    {{0, 0}, {2, 0}, {-1, 0}, {2, 1}, {-1, -2}}, // 2->L
+    {{0, 0}, {-2, 0}, {1, 0}, {-2, -1}, {1, 2}}, // L->2
+    {{0, 0}, {1, 0}, {-2, 0}, {1, -2}, {-2, 1}}, // L->0
+    {{0, 0}, {-1, 0}, {2, 0}, {-1, 2}, {2, -1}}  // 0->L
+};
+
+static const vec2 basic_movements[5] = {
+    {0, 1}, // DOWN
+    {1, 0}, // RIGHT
+    {-1, 0} // LEFT
+};
+
+// https://tetris.fandom.com/wiki/Tetris_Worlds
+#if CETRIS_HI_RES
+static const int level_drop_delay[20] = {1000, 793, 618, 473, 355, 262, 189, 134, 94, 64,
+                                         43,  28,  18,  11,  7,  4,  2,  1, 1, 1};
+#else
+static const int level_drop_delay[20] = {60, 48, 37, 28, 21, 16, 11, 8, 6, 4,
+                                         3,  2,  1,  1,  1,  1,  1,  1, 1, 1};
+#endif
+
+static void update_board(cetris_game *g);
+
+CETRIS_EXPORT bool update_game_tick(cetris_game *g);
+CETRIS_EXPORT void hold_piece(cetris_game *g);
+CETRIS_EXPORT void init_game(cetris_game *g, cetris_config *c);
+CETRIS_EXPORT void hold_piece(cetris_game *g);
+
+static void set_piece(uint8_t type, tetrimino* mino) {
+  memset(mino, 0, sizeof(tetrimino));
+
+  mino->t = type;
+  memcpy(mino->m, default_matrices[type], sizeof(piece_matrix));
+
+  /* Pieces should spawn so that on the first down
+   * tick the bottom row will show. Values here are adjusted
+   * for the default 4x4 matricies for each piece */
+  mino->pos.x = 3;
+  mino->pos.y = (type == MINO_I) ? 17 : 16;
+}
+
+static void shuffle_queue(cetris_game *g) {
+  for (int i = 0; i < 7; i++) {
+    uint8_t rand_index = rand() % 7;
+    uint8_t tmp = g->next_queue[i];
+    g->next_queue[i] = g->next_queue[rand_index];
+    g->next_queue[rand_index] = tmp;
+  }
+}
+
+static int check_matrix(cetris_game *g, piece_matrix *m) {
+  for (uint8_t y = 0; y < 4; y++) {
+    for (uint8_t x = 0; x < 4; x++) {
+      vec2 r = (vec2){x + g->current.pos.x, y + g->current.pos.y};
+      if (r.y < 0)
+        continue;
+      if (((*m)[y]>>(3 - x))&1) {
+        if (r.x >= CETRIS_BOARD_X || r.x < 0)
+          return 0;
+        if (r.y >= CETRIS_BOARD_Y)
+          return -1;
+        if (g->board[r.x][r.y] & SLOT_OCCUPIED)
+          return -1;
+      }
+    }
+  }
+  return 1;
+}
+
+// TODO: hard score
+static void add_score(cetris_game *g, int lines) {
+  if (!g->tspin && !g->mini_tspin) {
+    switch (lines) {
+    case 1:
+      g->score += 100 * g->level;
+      break;
+    case 2:
+      g->score += 300 * g->level;
+      break;
+    case 3:
+      g->score += 500 * g->level;
+      break;
+    case 4:
+      g->score += 800 * g->level;
+      break;
+    }
+  } else if (g->tspin) {
+    switch (lines) {
+    case 0:
+      g->score += 400 * g->level;
+      break;
+    case 1:
+      g->score += 800 * g->level;
+      break;
+    case 2:
+      g->score += 1200 * g->level;
+      break;
+    case 3:
+      g->score += 1600 * g->level;
+      break;
+    }
+    g->tspin = false;
+  } else if (g->mini_tspin) {
+    switch (lines) {
+    case 0:
+      g->score += 100 * g->level;
+      break;
+    case 1:
+      g->score += 200 * g->level;
+      break;
+    case 2:
+      g->score += 400 * g->level;
+      break;
+    }
+    g->mini_tspin = false;
+  }
+}
+
+static void make_ghosts(cetris_game *g) {
+  int8_t orig_y = g->current.pos.y;
+  while (check_matrix(g, &g->current.m) > 0) {
+    g->current.pos.y++;
+  }
+  if (g->current.pos.y == orig_y) {
+    g->current.ghost_y = orig_y;
+  } else {
+    g->current.ghost_y = g->current.pos.y - 1;
+  }
+  g->current.pos.y = orig_y;
+}
+
+static void move_current(cetris_game *g, uint8_t move) {
+  if (g->game_over || g->next_piece_tick)
+    return;
+
+  g->current.pos.y += basic_movements[move].y;
+  g->current.pos.x += basic_movements[move].x;
+
+  int check = check_matrix(g, &g->current.m);
+  if (check <= 0) {
+    g->current.pos.y -= basic_movements[move].y;
+    g->current.pos.x -= basic_movements[move].x;
+
+    if (move == DOWN && check == -1) {
+      if (!g->current.force_lock_tick)
+        g->current.force_lock_tick = g->tick + g->config.force_lock;
+      if (!g->current.lock_tick)
+        g->current.lock_tick = g->tick + g->config.lock_delay;
+    }
+  } else {
+    if (g->current.lock_tick) 
+      g->current.lock_tick = g->tick + g->config.lock_delay;
+    if (move == DOWN && g->held_moves[DOWN])
+      g->score++;
+  }
+
+  update_board(g);
+}
+
+static void next_piece(cetris_game *g) {
+  g->next_drop_tick = 0;
+  g->next_piece_tick = 0;
+
+  set_piece(g->piece_queue[g->current_index], &g->current);
+
+  if (check_matrix(g, &g->current.m) <= 0) {
+    g->game_over = true;
+  }
+
+  if (!g->game_over) {
+    move_current(g, DOWN);
+  }
+  
+  g->current_index++;
+  if (g->current_index == 7) {
+    memcpy(&g->piece_queue, &g->next_queue, sizeof(g->piece_queue));
+    g->current_index = 0;
+    shuffle_queue(g);
+  }
+
+  update_board(g);
+}
+
+static void lock_current(cetris_game *g) {
+  g->current.locked = true;
+  for (int y = 0; y < 4; y++) {
+    for (int x = 0; x < 4; x++) {
+      if ((g->current.m[y]>>(3 - x))&1) {
+        g->board[g->current.pos.x + x][g->current.pos.y + y] |= SLOT_OCCUPIED;
+        g->board[g->current.pos.x + x][g->current.pos.y + y] |= g->current.t << 5;
+      }
+    }
+  }
+
+  if (g->current.pos.y < g->highest_line) {
+    g->highest_line = g->current.pos.y;
+  }
+
+  update_board(g);
+}
+
+static void hard_drop(cetris_game *g) {
+  if (g->game_over || g->next_piece_tick)
+    return;
+
+  int drop_count = 0;
+  while (check_matrix(g, &g->current.m) > 0) {
+    g->current.pos.y++;
+    drop_count++;
+  }
+  g->current.pos.y--;
+  drop_count--;
+
+  g->score += 2 * drop_count; // 2 score for each hard-drop'd cell
+
+  lock_current(g);
+  update_board(g);
+}
+
+static void rotate_matrix(cetris_game *g, piece_matrix *m, bool clockwise) {
+  for (uint8_t x = 0; x < 4; x++) {
+    for (uint8_t y = 0; y < 4; y++) {
+      if ((g->current.m[y]>>(3 - x))&1) {
+        uint8_t new_x = (clockwise) ? 1 - (y - 2) : 1 + (y - 2);
+        uint8_t new_y = (clockwise) ? 2 + (x - 1) : 2 - (x - 1);
+
+        if (g->current.t == MINO_I) {
+          clockwise ? new_y-- : new_x++;
+        }
+        
+        (*m)[new_y] |= (uint8_t)0b1000 >> (new_x);
+      }
+    }
+  }
+}
+
+static void rotate_piece(cetris_game *g, bool clockwise) {
+  if (g->game_over || g->next_piece_tick)
+    return;
+  if (g->current.t == MINO_O)
+    return;
+  
+  uint8_t next = 0;
+  uint8_t wall_kick = 0;
+  if (clockwise) {
+    next = (g->current.r + 1)%4;
+    wall_kick = g->current.r * 2;
+  } else {
+    next = ((g->current.r - 1) + 4)%4;
+    wall_kick = (next * 2) + 1;
+  }
+
+  piece_matrix m;
+  memset(&m, 0, sizeof(piece_matrix));
+
+  rotate_matrix(g, &m, clockwise);
+
+  vec2 kick;
+  bool set_current = false;
+  bool did_kick = false;
+  for (int i = 0; i < 4; i++) {
+    if (g->current.t == MINO_I) {
+      kick = srs_wall_kicks_i[wall_kick][i];
+    } else {
+      kick = srs_wall_kicks[wall_kick][i];
+    }
+
+    g->current.pos.x += kick.x;
+    g->current.pos.y -= kick.y;
+
+    if (check_matrix(g, &m) > 0) {
+      set_current = true;
+      if (i > 0) did_kick = true;
+      break;
+    }
+
+    g->current.pos.x -= kick.x;
+    g->current.pos.y += kick.y;
+  }
+
+  if (set_current) {
+    /* check for tspin */
+    if (g->current.t == MINO_T) {
+      bool did_tspin = true;
+      for (int i = 1; i < 5; i++) {
+        g->current.pos.x += basic_movements[i].x;
+        g->current.pos.y += basic_movements[i].y;
+
+        if (check_matrix(g, &m) == 1)
+          did_tspin = false;
+
+        g->current.pos.x -= basic_movements[i].x;
+        g->current.pos.y -= basic_movements[i].y;
+      }
+
+      if (did_tspin) {
+        if (did_kick) g->mini_tspin = true;
+        else g->tspin = true;
+      }
+    }
+
+    g->current.r = next;
+    memcpy(g->current.m, &m, sizeof(piece_matrix));
+    update_board(g);
+  }
+}
+
+void update_board(cetris_game *g) {
+  if (g->game_over)
+    return;
+
+  int lines_cleared = 0;
+  for (int y = g->highest_line; y < CETRIS_BOARD_Y; y++) {
+    bool clear_line = true;
+    for (int x = 0; x < CETRIS_BOARD_X; x++) {
+      if (!(g->board[x][y] & SLOT_OCCUPIED) 
+          || g->line_remove_tick[y] > 0) {
+        clear_line = false;
+      }
+    }
+
+    if (g->config.wait_on_clear) {
+      // remove tick only tracked on first block of line
+      if (g->line_remove_tick[y] && g->line_remove_tick[y] <= g->tick) {
+        g->line_remove_tick[y] = 0;
+        for (int s = y - 1; s >= 0; s--) {
+          for (int x = 0; x < CETRIS_BOARD_X; x++) {
+            g->board[x][s + 1] = g->board[x][s];
+          }
+        }
+      }
+      if (clear_line) {
+        g->line_remove_tick[y] = g->tick + g->config.line_delay_clear;
+        lines_cleared++;
+      }
+    } else if (clear_line) {
+      for (int s = y - 1; s >= 0; s--) {
+        for (int x = 0; x < CETRIS_BOARD_X; x++) {
+          g->board[x][s + 1] = g->board[x][s];
+        }
+      }
+      lines_cleared++;
+    }
+  }
+
+  make_ghosts(g);
+
+  assert(lines_cleared <= 4);
+
+  if (g->current.locked && !g->next_piece_tick) {
+    if (lines_cleared > 0) {
+      g->next_piece_tick = g->tick + g->config.next_piece_delay;
+    } else {
+      next_piece(g);
+    }
+  }
+
+  if (lines_cleared > 0 || g->tspin || g->mini_tspin) {
+    add_score(g, lines_cleared);
+    if (lines_cleared > 0) {
+      g->lines += lines_cleared;
+      if (g->lines >= 20) g->game_over = true;
+      if (g->lines >= (g->level * 10))
+        g->level++;
+    }
+  }
+}
+
+CETRIS_EXPORT void hold_piece(cetris_game *g) {
+  if (g->current.held) return;
+  if (g->piece_held) {
+    tetrimino tmp = g->current;
+    g->current = g->held;
+    g->held = tmp;
+  } else {
+    set_piece(g->current.t, &g->held);
+    g->piece_held = true;
+    next_piece(g);
+  }
+  g->current.held = true;
+  update_board(g);
+}
+
+#if CETRIS_ENABLE_DAS
+CETRIS_EXPORT void unhold_piece(cetris_game* g, input_t move) {
+  if (g->das_move == move) {
+    if (move == LEFT && g->held_moves[RIGHT]) {
+      g->das_move = RIGHT;
+      g->das_wait = g->tick + g->config.das_das;
+    } else if (move == RIGHT && g->held_moves[LEFT]) {
+      g->das_move = LEFT;
+      g->das_wait = g->tick + g->config.das_das;
+    } else {
+      g->das_wait = 0;
+    }
+    g->next_das_move = 0;
+  }
+  g->held_moves[move] = 0;
+}
+#endif
+
+CETRIS_EXPORT void move_piece(cetris_game *g, uint8_t move) {
+#if CETRIS_ENABLE_DAS
+  if (g->held_moves[move]) return;
+  if (move == LEFT || move == RIGHT) {
+    if ((move != g->das_move) || !g->das_wait) {
+      g->das_move = move;
+      if (!g->waiting) {
+        g->das_wait = g->tick + g->config.das_das;
+        g->next_das_move = 0;
+      }
+      else g->next_das_move = 1;
+    }
+  }
+  if (move == DOWN) g->next_drop_tick = g->tick + g->config.drop_period;
+  g->held_moves[move] = 1;
+#endif
+  
+  if (g->waiting) return;
+
+  switch (move) {
+  case LEFT:
+  case RIGHT:
+  case DOWN:
+    move_current(g, move);
+    break;
+  case HARD_DROP:
+    hard_drop(g);
+    break;
+  case ROTATE_CW:
+    rotate_piece(g, 1);
+    break;
+  case ROTATE_CCW:
+    rotate_piece(g, 0);
+    break;
+  }
+
+}
+
+CETRIS_EXPORT void init_game(cetris_game *g, cetris_config* c) {
+
+  /* check for config errors */
+  assert(CETRIS_NEXT_PIECE_DELAY >= CETRIS_LINE_CLEAR_DELAY);
+
+  srand(time(NULL));
+
+#ifdef BUILD_TESTS
+  //apply_test_board(g, TSPIN_NO_LINES);
+#endif
+
+  memset(g, 0, sizeof(cetris_game));
+  memcpy(&g->config, c, sizeof(cetris_config));
+
+  g->level = CETRIS_STARTING_LEVEL;
+  g->highest_line = CETRIS_BOARD_Y;
+
+  for (int i = 0; i < 7; i++) {
+    g->next_queue[i] = i;
+  }
+
+  shuffle_queue(g);
+  memcpy(&g->piece_queue, &g->next_queue, sizeof(g->piece_queue));
+  shuffle_queue(g);
+
+  next_piece(g);
+}
+
+CETRIS_EXPORT bool update_game_tick(cetris_game *g) {
+  if (g->game_over)
+    return false;
+  
+#if CETRIS_HI_RES
+  //g->tick += .01f;
+#else
+  g->tick++;
+#endif
+
+  if (g->next_piece_tick && g->tick >= g->next_piece_tick) {
+    next_piece(g);
+  }
+
+  if (g->next_piece_tick)
+    return true;
+
+  bool did_move = false;
+  if (g->next_drop_tick && g->tick >= g->next_drop_tick) {
+    move_current(g, DOWN);
+    g->next_drop_tick = 0;
+    did_move = true;
+  }
+
+  if (!g->next_drop_tick) {
+    if (g->held_moves[DOWN]) {
+      g->next_drop_tick = g->tick + g->config.drop_period;
+    } else {
+      if (g->level <= 20) {
+        g->next_drop_tick = g->tick + level_drop_delay[g->level - 1];
+      } else {
+        g->next_drop_tick = g->tick + level_drop_delay[19];
+      }
+    }
+  }
+
+  /* lock piece if it was hovering for CETRIS_LOCK_DELAY */
+  if (!g->next_piece_tick && ((g->current.lock_tick && g->current.lock_tick <= g->tick) 
+	|| (g->current.force_lock_tick && g->current.force_lock_tick <= g->tick))) {
+    g->current.pos.y++;
+    int8_t res = check_matrix(g, &g->current.m);
+    g->current.pos.y--;
+    if (res <= 0) {
+      lock_current(g);
+      did_move = true;
+    }
+    g->current.lock_tick = 0;
+  }
+
+#if CETRIS_ENABLE_DAS
+  if ((g->next_das_move && g->tick >= g->next_das_move) || g->next_das_move == 1) {
+    if (!g->waiting) move_current(g, g->das_move);
+    g->next_das_move = g->tick + g->config.das_arr;
+  } else if (!g->next_das_move && g->das_wait && g->tick >= g->das_wait) {
+    g->next_das_move = g->tick + g->config.das_arr;
+  }
+#endif
+
+  if (did_move) update_board(g);
+
+  return true;
+}
+
+#endif /* CETRIS_H */
diff --git a/lib/test.h b/lib/test.h
index cc7d44a..67f6388 100644
--- a/lib/test.h
+++ b/lib/test.h
@@ -1,77 +1,77 @@
-#include "cetris.h"

-

-typedef enum {

-  TSPIN,

-  TSPIN_NO_LINES

-} test;

-

-int tspin_board[20][10] = {

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 1, 1, 1, 1, 0, 0, 1, 1, 1, 1 },

-  { 1, 1, 1, 0, 0, 0, 1, 1, 1, 1 },

-  { 1, 1, 1, 1, 0, 1, 1, 1, 1, 1 },

-  { 1, 1, 1, 1, 1, 1, 1, 1, 1, 0 }

-};

-

-int tspin_no_lines_board[20][10] = {

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },

-  { 1, 1, 1, 1, 0, 0, 1, 1, 1, 0 },

-  { 1, 1, 1, 0, 0, 0, 1, 1, 1, 0 },

-  { 1, 1, 1, 1, 0, 1, 1, 1, 1, 0 },

-  { 1, 1, 1, 1, 1, 1, 1, 1, 1, 0 }

-};

-

-/*

-void apply_test_board(cetris_game* g, test t) {

-  u8 (*board)[20][10];

-  switch (t) {

-    case TSPIN:

-      board = &tspin_board;

-      break;

-    case TSPIN_NO_LINES:

-      board = &tspin_no_lines_board;

-      break;

-    default:

-      return;

-  }

-  for (u8 y = 0; y < CETRIS_BOARD_Y; y++) {

-    for (u8 x = 0; x < 10; x++) {

-      if ((*board)[y][x]) {

-        g->board[x][y].occupied = 1;

-        g->board[x][y].constant = 1;

-        g->board[x][y].c = COLOR_I;

-      }

-    }

-  }

-}

-*/

+#include "cetris.h"
+
+typedef enum {
+  TSPIN,
+  TSPIN_NO_LINES
+} test;
+
+int tspin_board[20][10] = {
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 1, 1, 1, 1, 0, 0, 1, 1, 1, 1 },
+  { 1, 1, 1, 0, 0, 0, 1, 1, 1, 1 },
+  { 1, 1, 1, 1, 0, 1, 1, 1, 1, 1 },
+  { 1, 1, 1, 1, 1, 1, 1, 1, 1, 0 }
+};
+
+int tspin_no_lines_board[20][10] = {
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 },
+  { 1, 1, 1, 1, 0, 0, 1, 1, 1, 0 },
+  { 1, 1, 1, 0, 0, 0, 1, 1, 1, 0 },
+  { 1, 1, 1, 1, 0, 1, 1, 1, 1, 0 },
+  { 1, 1, 1, 1, 1, 1, 1, 1, 1, 0 }
+};
+
+/*
+void apply_test_board(cetris_game* g, test t) {
+  u8 (*board)[20][10];
+  switch (t) {
+    case TSPIN:
+      board = &tspin_board;
+      break;
+    case TSPIN_NO_LINES:
+      board = &tspin_no_lines_board;
+      break;
+    default:
+      return;
+  }
+  for (u8 y = 0; y < CETRIS_BOARD_Y; y++) {
+    for (u8 x = 0; x < 10; x++) {
+      if ((*board)[y][x]) {
+        g->board[x][y].occupied = 1;
+        g->board[x][y].constant = 1;
+        g->board[x][y].c = COLOR_I;
+      }
+    }
+  }
+}
+*/
diff --git a/meson.build b/meson.build
index 3cee4ae..10ac21f 100644
--- a/meson.build
+++ b/meson.build
@@ -1,29 +1,29 @@
-project('cetris', 'c',

-  version : '0.2',

-  default_options : ['warning_level=2', 'c_std=c99'])

-

-compiler = meson.get_compiler('c')

-

-cetris_inc = include_directories(['lib', 'ini'])

-

-if get_option('debug') == true 

-  if host_machine.system() == 'windows'

-    add_global_arguments('/DBUILD_TESTS', language : 'c') 

-  else 

-    add_global_arguments('-DBUILD_TESTS', language : 'c')

-  endif

-

-  subdir('test')

-endif

-

-if get_option('curses-frontend') == true

-  subdir('frontends/curses')

-endif

-

-if get_option('gl-frontend') == true

-  subdir('frontends/gl')

-endif

-

-if get_option('sdl-frontend') == true

-  subdir('frontends/sdl')

-endif

+project('cetris', 'c',
+  version : '0.2',
+  default_options : ['warning_level=2', 'c_std=c99'])
+
+compiler = meson.get_compiler('c')
+
+cetris_inc = include_directories(['lib', 'ini'])
+
+if get_option('debug') == true 
+  if host_machine.system() == 'windows'
+    add_global_arguments('/DBUILD_TESTS', language : 'c') 
+  else 
+    add_global_arguments('-DBUILD_TESTS', language : 'c')
+  endif
+
+  subdir('test')
+endif
+
+if get_option('curses-frontend') == true
+  subdir('frontends/curses')
+endif
+
+if get_option('gl-frontend') == true
+  subdir('frontends/gl')
+endif
+
+if get_option('sdl-frontend') == true
+  subdir('frontends/sdl')
+endif
diff --git a/meson_options.txt b/meson_options.txt
index aa1f181..b78d7fb 100644
--- a/meson_options.txt
+++ b/meson_options.txt
@@ -1,3 +1,3 @@
-option('curses-frontend', type : 'boolean', value : false)

-option('gl-frontend', type : 'boolean', value : false)

-option('sdl-frontend', type : 'boolean', value : true)

+option('curses-frontend', type : 'boolean', value : false)
+option('gl-frontend', type : 'boolean', value : false)
+option('sdl-frontend', type : 'boolean', value : true)