From a869ebab69f13e0b836c1343d44f8e8c04c1e4de Mon Sep 17 00:00:00 2001 From: Ed_ Date: Sun, 12 Jan 2025 14:00:43 -0500 Subject: [PATCH] Add custom stb_truetype package/lib to thirdparty for vefontcache update --- thirdparty/stb/lib/.gitkeep | 0 thirdparty/stb/lib/darwin/stb_truetype.a | Bin 0 -> 138088 bytes thirdparty/stb/lib/stb_truetype.lib | Bin 0 -> 380552 bytes thirdparty/stb/lib/stb_truetype_wasm.o | Bin 0 -> 46482 bytes thirdparty/stb/src/Makefile | 60 + thirdparty/stb/src/build.bat | 8 + thirdparty/stb/src/gb/gb.h | 10824 ++++++++++++++++ thirdparty/stb/src/stb_image.c | 2 + thirdparty/stb/src/stb_image.h | 7897 +++++++++++ thirdparty/stb/src/stb_truetype.c | 2 + thirdparty/stb/src/stb_truetype.h | 5114 ++++++++ thirdparty/stb/truetype/stb_truetype.odin | 660 + .../stb/truetype/stb_truetype_wasm.odin | 4 + 13 files changed, 24571 insertions(+) create mode 100644 thirdparty/stb/lib/.gitkeep create mode 100644 thirdparty/stb/lib/darwin/stb_truetype.a create mode 100644 thirdparty/stb/lib/stb_truetype.lib create mode 100644 thirdparty/stb/lib/stb_truetype_wasm.o create mode 100644 thirdparty/stb/src/Makefile create mode 100644 thirdparty/stb/src/build.bat create mode 100644 thirdparty/stb/src/gb/gb.h create mode 100644 thirdparty/stb/src/stb_image.c create mode 100644 thirdparty/stb/src/stb_image.h create mode 100644 thirdparty/stb/src/stb_truetype.c create mode 100644 thirdparty/stb/src/stb_truetype.h create mode 100644 thirdparty/stb/truetype/stb_truetype.odin create mode 100644 thirdparty/stb/truetype/stb_truetype_wasm.odin diff --git a/thirdparty/stb/lib/.gitkeep b/thirdparty/stb/lib/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/thirdparty/stb/lib/darwin/stb_truetype.a b/thirdparty/stb/lib/darwin/stb_truetype.a new file mode 100644 index 0000000000000000000000000000000000000000..b55fbe5d3ea3866a28687d16a21f11f6bb211a38 GIT binary patch literal 138088 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 literal 0 HcmV?d00001 diff --git a/thirdparty/stb/src/Makefile b/thirdparty/stb/src/Makefile new file mode 100644 index 0000000..194ea5e --- /dev/null +++ b/thirdparty/stb/src/Makefile @@ -0,0 +1,60 @@ +OS=$(shell uname) + +ifeq ($(OS), Darwin) +all: darwin +else +all: unix +endif + +wasm: + mkdir -p ../lib + $(CC) -c -Os --target=wasm32 --sysroot=$(shell odin root)/vendor/libc stb_image.c -o ../lib/stb_image_wasm.o -DSTBI_NO_STDIO + $(CC) -c -Os --target=wasm32 --sysroot=$(shell odin root)/vendor/libc stb_image_write.c -o ../lib/stb_image_write_wasm.o -DSTBI_WRITE_NO_STDIO + $(CC) -c -Os --target=wasm32 --sysroot=$(shell odin root)/vendor/libc stb_image_resize.c -o ../lib/stb_image_resize_wasm.o + $(CC) -c -Os --target=wasm32 --sysroot=$(shell odin root)/vendor/libc stb_truetype.c -o ../lib/stb_truetype_wasm.o + # $(CC) -c -Os --target=wasm32 --sysroot=$(shell odin root)/vendor/libc stb_vorbis.c -o ../lib/stb_vorbis_wasm.o -DSTB_VORBIS_NO_STDIO + $(CC) -c -Os --target=wasm32 --sysroot=$(shell odin root)/vendor/libc stb_rect_pack.c -o ../lib/stb_rect_pack_wasm.o + $(CC) -c -Os --target=wasm32 stb_sprintf.c -o ../lib/stb_sprintf_wasm.o + +unix: + mkdir -p ../lib + $(CC) -c -O2 -Os -fPIC stb_image.c stb_image_write.c stb_image_resize.c stb_truetype.c stb_rect_pack.c stb_vorbis.c stb_sprintf.c + $(AR) rcs ../lib/stb_image.a stb_image.o + $(AR) rcs ../lib/stb_image_write.a stb_image_write.o + $(AR) rcs ../lib/stb_image_resize.a stb_image_resize.o + $(AR) rcs ../lib/stb_truetype.a stb_truetype.o + $(AR) rcs ../lib/stb_rect_pack.a stb_rect_pack.o + $(AR) rcs ../lib/stb_vorbis.a stb_vorbis.o + $(AR) rcs ../lib/stb_sprintf.a stb_sprintf.o + #$(CC) -fPIC -shared -Wl,-soname=stb_image.so -o ../lib/stb_image.so stb_image.o + #$(CC) -fPIC -shared -Wl,-soname=stb_image_write.so -o ../lib/stb_image_write.so stb_image_write.o + #$(CC) -fPIC -shared -Wl,-soname=stb_image_resize.so -o ../lib/stb_image_resize.so stb_image_resize.o + #$(CC) -fPIC -shared -Wl,-soname=stb_truetype.so -o ../lib/stb_truetype.so stb_image_truetype.o + #$(CC) -fPIC -shared -Wl,-soname=stb_rect_pack.so -o ../lib/stb_rect_pack.so stb_rect_packl.o + #$(CC) -fPIC -shared -Wl,-soname=stb_vorbis.so -o ../lib/stb_vorbis.so stb_vorbisl.o + rm *.o + +darwin: + mkdir -p ../lib + $(CC) -arch x86_64 -c -O2 -Os -fPIC stb_image.c -o stb_image-x86_64.o -mmacosx-version-min=10.12 + $(CC) -arch arm64 -c -O2 -Os -fPIC stb_image.c -o stb_image-arm64.o -mmacosx-version-min=10.12 + lipo -create stb_image-x86_64.o stb_image-arm64.o -output ../lib/darwin/stb_image.a + $(CC) -arch x86_64 -c -O2 -Os -fPIC stb_image_write.c -o stb_image_write-x86_64.o -mmacosx-version-min=10.12 + $(CC) -arch arm64 -c -O2 -Os -fPIC stb_image_write.c -o stb_image_write-arm64.o -mmacosx-version-min=10.12 + lipo -create stb_image_write-x86_64.o stb_image_write-arm64.o -output ../lib/darwin/stb_image_write.a + $(CC) -arch x86_64 -c -O2 -Os -fPIC stb_image_resize.c -o stb_image_resize-x86_64.o -mmacosx-version-min=10.12 + $(CC) -arch arm64 -c -O2 -Os -fPIC stb_image_resize.c -o stb_image_resize-arm64.o -mmacosx-version-min=10.12 + lipo -create stb_image_resize-x86_64.o stb_image_resize-arm64.o -output ../lib/darwin/stb_image_resize.a + $(CC) -arch x86_64 -c -O2 -Os -fPIC stb_truetype.c -o stb_truetype-x86_64.o -mmacosx-version-min=10.12 + $(CC) -arch arm64 -c -O2 -Os -fPIC stb_truetype.c -o stb_truetype-arm64.o -mmacosx-version-min=10.12 + lipo -create stb_truetype-x86_64.o stb_truetype-arm64.o -output ../lib/darwin/stb_truetype.a + $(CC) -arch x86_64 -c -O2 -Os -fPIC stb_rect_pack.c -o stb_rect_pack-x86_64.o -mmacosx-version-min=10.12 + $(CC) -arch arm64 -c -O2 -Os -fPIC stb_rect_pack.c -o stb_rect_pack-arm64.o -mmacosx-version-min=10.12 + lipo -create stb_rect_pack-x86_64.o stb_rect_pack-arm64.o -output ../lib/darwin/stb_rect_pack.a + $(CC) -arch x86_64 -c -O2 -Os -fPIC stb_vorbis.c -o stb_vorbis-x86_64.o -mmacosx-version-min=10.12 + $(CC) -arch arm64 -c -O2 -Os -fPIC stb_vorbis.c -o stb_vorbis-arm64.o -mmacosx-version-min=10.12 + lipo -create stb_vorbis-x86_64.o stb_vorbis-arm64.o -output ../lib/darwin/stb_vorbis.a + $(CC) -arch x86_64 -c -O2 -Os -fPIC stb_sprintf.c -o stb_sprintf-x86_64.o -mmacosx-version-min=10.12 + $(CC) -arch arm64 -c -O2 -Os -fPIC stb_sprintf.c -o stb_sprintf-arm64.o -mmacosx-version-min=10.12 + lipo -create stb_sprintf-x86_64.o stb_sprintf-arm64.o -output ../lib/darwin/stb_sprintf.a + rm *.o diff --git a/thirdparty/stb/src/build.bat b/thirdparty/stb/src/build.bat new file mode 100644 index 0000000..e83d765 --- /dev/null +++ b/thirdparty/stb/src/build.bat @@ -0,0 +1,8 @@ +@echo off + +if not exist "..\lib" mkdir ..\lib + +cl -nologo -MT -TC -O2 -c stb_image.c stb_truetype.c +lib -nologo stb_truetype.obj -out:..\lib\stb_truetype.lib + +del *.obj diff --git a/thirdparty/stb/src/gb/gb.h b/thirdparty/stb/src/gb/gb.h new file mode 100644 index 0000000..adeb554 --- /dev/null +++ b/thirdparty/stb/src/gb/gb.h @@ -0,0 +1,10824 @@ +/* gb.h - v0.33 - Ginger Bill's C Helper Library - public domain + - no warranty implied; use at your own risk + + This is a single header file with a bunch of useful stuff + to replace the C/C++ standard library + +=========================================================================== + YOU MUST + + #define GB_IMPLEMENTATION + + in EXACTLY _one_ C or C++ file that includes this header, BEFORE the + include like this: + + #define GB_IMPLEMENTATION + #include "gb.h" + + All other files should just #include "gb.h" without #define + + + If you want the platform layer, YOU MUST + + #define GB_PLATFORM + + BEFORE the include like this: + + #define GB_PLATFORM + #include "gb.h" + +=========================================================================== + +LICENSE + This software is dual-licensed to the public domain and under the following + license: you are granted a perpetual, irrevocable license to copy, modify, + publish, and distribute this file as you see fit. + +WARNING + - This library is _slightly_ experimental and features may not work as expected. + - This also means that many functions are not documented. + +CREDITS + Written by Ginger Bill + +TODOS + - Remove CRT dependency for people who want that + - But do I really? + - Or make it only depend on the really needed stuff? + - Older compiler support? + - How old do you wanna go? + - Only support C90+extension and C99 not pure C89. + - File handling + - All files to be UTF-8 (even on windows) + - Better Virtual Memory handling + - Generic Heap Allocator (tcmalloc/dlmalloc/?) + - Fixed Heap Allocator + - Better UTF support and conversion + - Free List, best fit rather than first fit + - More date & time functions + +VERSION HISTORY + 0.33 - Minor fixes + 0.32 - Minor fixes + 0.31 - Add gb_file_remove + 0.30 - Changes to gbThread (and gbMutex on Windows) + 0.29 - Add extras for gbString + 0.28 - Handle UCS2 correctly in Win32 part + 0.27 - OSX fixes and Linux gbAffinity + 0.26d - Minor changes to how gbFile works + 0.26c - gb_str_to_f* fix + 0.26b - Minor fixes + 0.26a - gbString Fix + 0.26 - Default allocator flags and generic hash table + 0.25a - Fix UTF-8 stuff + 0.25 - OS X gbPlatform Support (missing some things) + 0.24b - Compile on OSX (excluding platform part) + 0.24a - Minor additions + 0.24 - Enum convention change + 0.23 - Optional Windows.h removal (because I'm crazy) + 0.22a - Remove gbVideoMode from gb_platform_init_* + 0.22 - gbAffinity - (Missing Linux version) + 0.21 - Platform Layer Restructuring + 0.20 - Improve file io + 0.19 - Clipboard Text + 0.18a - Controller vibration + 0.18 - Raw keyboard and mouse input for WIN32 + 0.17d - Fixed printf bug for strings + 0.17c - Compile as 32 bit + 0.17b - Change formating style because why not? + 0.17a - Dropped C90 Support (For numerous reasons) + 0.17 - Instantiated Hash Table + 0.16a - Minor code layout changes + 0.16 - New file API and improved platform layer + 0.15d - Linux Experimental Support (DON'T USE IT PLEASE) + 0.15c - Linux Experimental Support (DON'T USE IT) + 0.15b - C90 Support + 0.15a - gb_atomic(32|64)_spin_(lock|unlock) + 0.15 - Recursive "Mutex"; Key States; gbRandom + 0.14 - Better File Handling and better printf (WIN32 Only) + 0.13 - Highly experimental platform layer (WIN32 Only) + 0.12b - Fix minor file bugs + 0.12a - Compile as C++ + 0.12 - New File Handing System! No stdio or stdlib! (WIN32 Only) + 0.11a - Add string precision and width (experimental) + 0.11 - Started making stdio & stdlib optional (Not tested much) + 0.10c - Fix gb_endian_swap32() + 0.10b - Probable timing bug for gb_time_now() + 0.10a - Work on multiple compilers + 0.10 - Scratch Memory Allocator + 0.09a - Faster Mutex and the Free List is slightly improved + 0.09 - Basic Virtual Memory System and Dreadful Free List allocator + 0.08a - Fix *_appendv bug + 0.08 - Huge Overhaul! + 0.07a - Fix alignment in gb_heap_allocator_proc + 0.07 - Hash Table and Hashing Functions + 0.06c - Better Documentation + 0.06b - OS X Support + 0.06a - Linux Support + 0.06 - Windows GCC Support and MSVC x86 Support + 0.05b - Formatting + 0.05a - Minor function name changes + 0.05 - Radix Sort for unsigned integers (TODO: Other primitives) + 0.04 - Better UTF support and search/sort procs + 0.03 - Completely change procedure naming convention + 0.02a - Bug fixes + 0.02 - Change naming convention and gbArray(Type) + 0.01 - Initial Version +*/ + + +#ifndef GB_INCLUDE_GB_H +#define GB_INCLUDE_GB_H + +#if defined(__cplusplus) +extern "C" { +#endif + +#if defined(__cplusplus) + #define GB_EXTERN extern "C" +#else + #define GB_EXTERN extern +#endif + +#if defined(_WIN32) + #define GB_DLL_EXPORT GB_EXTERN __declspec(dllexport) + #define GB_DLL_IMPORT GB_EXTERN __declspec(dllimport) +#else + #define GB_DLL_EXPORT GB_EXTERN __attribute__((visibility("default"))) + #define GB_DLL_IMPORT GB_EXTERN +#endif + +// NOTE(bill): Redefine for DLL, etc. +#ifndef GB_DEF + #ifdef GB_STATIC + #define GB_DEF static + #else + #define GB_DEF extern + #endif +#endif + +#if defined(_WIN64) || defined(__x86_64__) || defined(_M_X64) || defined(__64BIT__) || defined(__powerpc64__) || defined(__ppc64__) + #ifndef GB_ARCH_64_BIT + #define GB_ARCH_64_BIT 1 + #endif +#else + // NOTE(bill): I'm only supporting 32 bit and 64 bit systems + #ifndef GB_ARCH_32_BIT + #define GB_ARCH_32_BIT 1 + #endif +#endif + + +#ifndef GB_ENDIAN_ORDER +#define GB_ENDIAN_ORDER + // TODO(bill): Is the a good way or is it better to test for certain compilers and macros? + #define GB_IS_BIG_ENDIAN (!*(u8*)&(u16){1}) + #define GB_IS_LITTLE_ENDIAN (!GB_IS_BIG_ENDIAN) +#endif + +#if defined(_WIN32) || defined(_WIN64) + #ifndef GB_SYSTEM_WINDOWS + #define GB_SYSTEM_WINDOWS 1 + #endif +#elif defined(__APPLE__) && defined(__MACH__) + #ifndef GB_SYSTEM_OSX + #define GB_SYSTEM_OSX 1 + #endif +#elif defined(__unix__) + #ifndef GB_SYSTEM_UNIX + #define GB_SYSTEM_UNIX 1 + #endif + + #if defined(__linux__) + #ifndef GB_SYSTEM_LINUX + #define GB_SYSTEM_LINUX 1 + #endif + #elif defined(__FreeBSD__) || defined(__FreeBSD_kernel__) + #ifndef GB_SYSTEM_FREEBSD + #define GB_SYSTEM_FREEBSD 1 + #endif + #else + #error This UNIX operating system is not supported + #endif +#else + #error This operating system is not supported +#endif + +#if defined(_MSC_VER) + #define GB_COMPILER_MSVC 1 +#elif defined(__GNUC__) + #define GB_COMPILER_GCC 1 +#elif defined(__clang__) + #define GB_COMPILER_CLANG 1 +#else + #error Unknown compiler +#endif + +#if defined(_M_IX86) || defined(_M_X64) || defined(__i386__) || defined(__x86_64__) + #ifndef GB_CPU_X86 + #define GB_CPU_X86 1 + #endif + #ifndef GB_CACHE_LINE_SIZE + #define GB_CACHE_LINE_SIZE 64 + #endif + +#elif defined(_M_PPC) || defined(__powerpc__) || defined(__powerpc64__) + #ifndef GB_CPU_PPC + #define GB_CPU_PPC 1 + #endif + #ifndef GB_CACHE_LINE_SIZE + #define GB_CACHE_LINE_SIZE 128 + #endif + +#elif defined(__arm__) + #ifndef GB_CPU_ARM + #define GB_CPU_ARM 1 + #endif + #ifndef GB_CACHE_LINE_SIZE + #define GB_CACHE_LINE_SIZE 64 + #endif + +#elif defined(__MIPSEL__) || defined(__mips_isa_rev) + #ifndef GB_CPU_MIPS + #define GB_CPU_MIPS 1 + #endif + #ifndef GB_CACHE_LINE_SIZE + #define GB_CACHE_LINE_SIZE 64 + #endif + +#else + #error Unknown CPU Type +#endif + + + +#ifndef GB_STATIC_ASSERT + #define GB_STATIC_ASSERT3(cond, msg) typedef char static_assertion_##msg[(!!(cond))*2-1] + // NOTE(bill): Token pasting madness!! + #define GB_STATIC_ASSERT2(cond, line) GB_STATIC_ASSERT3(cond, static_assertion_at_line_##line) + #define GB_STATIC_ASSERT1(cond, line) GB_STATIC_ASSERT2(cond, line) + #define GB_STATIC_ASSERT(cond) GB_STATIC_ASSERT1(cond, __LINE__) +#endif + + +//////////////////////////////////////////////////////////////// +// +// Headers +// +// + +#if defined(_WIN32) && !defined(__MINGW32__) + #ifndef _CRT_SECURE_NO_WARNINGS + #define _CRT_SECURE_NO_WARNINGS + #endif +#endif + +#if defined(GB_SYSTEM_UNIX) + #define _GNU_SOURCE + #define _LARGEFILE64_SOURCE +#endif + + +// TODO(bill): How many of these headers do I really need? +// #include +#if !defined(GB_SYSTEM_WINDOWS) + #include + #include +#endif + + + +#if defined(GB_SYSTEM_WINDOWS) + #if !defined(GB_NO_WINDOWS_H) + #define NOMINMAX 1 + #define WIN32_LEAN_AND_MEAN 1 + #define WIN32_MEAN_AND_LEAN 1 + #define VC_EXTRALEAN 1 + #include + #undef NOMINMAX + #undef WIN32_LEAN_AND_MEAN + #undef WIN32_MEAN_AND_LEAN + #undef VC_EXTRALEAN + #endif + + #include // NOTE(bill): _aligned_*() + #include +#else + #include + #include + #include + #include + #ifndef _IOSC11_SOURCE + #define _IOSC11_SOURCE + #endif + #include // NOTE(bill): malloc on linux + #include + #if !defined(GB_SYSTEM_OSX) + #include + #endif + #include + #include + #include + #include + #include + + #if defined(GB_CPU_X86) + #include + #endif +#endif + +#if defined(GB_SYSTEM_OSX) + #include + #include + #include + #include + #include + #include + #include + #include +#endif + +#if defined(GB_SYSTEM_UNIX) + #include +#endif + + +//////////////////////////////////////////////////////////////// +// +// Base Types +// +// + +#if defined(GB_COMPILER_MSVC) + #if _MSC_VER < 1300 + typedef unsigned char u8; + typedef signed char i8; + typedef unsigned short u16; + typedef signed short i16; + typedef unsigned int u32; + typedef signed int i32; + #else + typedef unsigned __int8 u8; + typedef signed __int8 i8; + typedef unsigned __int16 u16; + typedef signed __int16 i16; + typedef unsigned __int32 u32; + typedef signed __int32 i32; + #endif + typedef unsigned __int64 u64; + typedef signed __int64 i64; +#else + #include + typedef uint8_t u8; + typedef int8_t i8; + typedef uint16_t u16; + typedef int16_t i16; + typedef uint32_t u32; + typedef int32_t i32; + typedef uint64_t u64; + typedef int64_t i64; +#endif + +GB_STATIC_ASSERT(sizeof(u8) == sizeof(i8)); +GB_STATIC_ASSERT(sizeof(u16) == sizeof(i16)); +GB_STATIC_ASSERT(sizeof(u32) == sizeof(i32)); +GB_STATIC_ASSERT(sizeof(u64) == sizeof(i64)); + +GB_STATIC_ASSERT(sizeof(u8) == 1); +GB_STATIC_ASSERT(sizeof(u16) == 2); +GB_STATIC_ASSERT(sizeof(u32) == 4); +GB_STATIC_ASSERT(sizeof(u64) == 8); + +typedef size_t usize; +typedef ptrdiff_t isize; + +GB_STATIC_ASSERT(sizeof(usize) == sizeof(isize)); + +// NOTE(bill): (u)intptr is only here for semantic reasons really as this library will only support 32/64 bit OSes. +// NOTE(bill): Are there any modern OSes (not 16 bit) where intptr != isize ? +#if defined(_WIN64) + typedef signed __int64 intptr; + typedef unsigned __int64 uintptr; +#elif defined(_WIN32) + // NOTE(bill); To mark types changing their size, e.g. intptr + #ifndef _W64 + #if !defined(__midl) && (defined(_X86_) || defined(_M_IX86)) && _MSC_VER >= 1300 + #define _W64 __w64 + #else + #define _W64 + #endif + #endif + + typedef _W64 signed int intptr; + typedef _W64 unsigned int uintptr; +#else + typedef uintptr_t uintptr; + typedef intptr_t intptr; +#endif + +GB_STATIC_ASSERT(sizeof(uintptr) == sizeof(intptr)); + +typedef float f32; +typedef double f64; + +GB_STATIC_ASSERT(sizeof(f32) == 4); +GB_STATIC_ASSERT(sizeof(f64) == 8); + +typedef i32 Rune; // NOTE(bill): Unicode codepoint +#define GB_RUNE_INVALID cast(Rune)(0xfffd) +#define GB_RUNE_MAX cast(Rune)(0x0010ffff) +#define GB_RUNE_BOM cast(Rune)(0xfeff) +#define GB_RUNE_EOF cast(Rune)(-1) + + +typedef i8 b8; +typedef i16 b16; +typedef i32 b32; // NOTE(bill): Prefer this!!! + +// NOTE(bill): Get true and false +#if !defined(__cplusplus) + #if (defined(_MSC_VER) && _MSC_VER < 1800) || (!defined(_MSC_VER) && !defined(__STDC_VERSION__)) + #ifndef true + #define true (0 == 0) + #endif + #ifndef false + #define false (0 != 0) + #endif + typedef b8 bool; + #else + #include + #endif +#endif + +// NOTE(bill): These do are not prefixed with gb because the types are not. +#ifndef U8_MIN +#define U8_MIN 0u +#define U8_MAX 0xffu +#define I8_MIN (-0x7f - 1) +#define I8_MAX 0x7f + +#define U16_MIN 0u +#define U16_MAX 0xffffu +#define I16_MIN (-0x7fff - 1) +#define I16_MAX 0x7fff + +#define U32_MIN 0u +#define U32_MAX 0xffffffffu +#define I32_MIN (-0x7fffffff - 1) +#define I32_MAX 0x7fffffff + +#define U64_MIN 0ull +#define U64_MAX 0xffffffffffffffffull +#define I64_MIN (-0x7fffffffffffffffll - 1) +#define I64_MAX 0x7fffffffffffffffll + +#if defined(GB_ARCH_32_BIT) + #define USIZE_MIX U32_MIN + #define USIZE_MAX U32_MAX + + #define ISIZE_MIX S32_MIN + #define ISIZE_MAX S32_MAX +#elif defined(GB_ARCH_64_BIT) + #define USIZE_MIX U64_MIN + #define USIZE_MAX U64_MAX + + #define ISIZE_MIX I64_MIN + #define ISIZE_MAX I64_MAX +#else + #error Unknown architecture size. This library only supports 32 bit and 64 bit architectures. +#endif + +#define F32_MIN 1.17549435e-38f +#define F32_MAX 3.40282347e+38f + +#define F64_MIN 2.2250738585072014e-308 +#define F64_MAX 1.7976931348623157e+308 + +#endif + +#ifndef NULL + #if defined(__cplusplus) + #if __cplusplus >= 201103L + #define NULL nullptr + #else + #define NULL 0 + #endif + #else + #define NULL ((void *)0) + #endif +#endif + +// TODO(bill): Is this enough to get inline working? +#if !defined(__cplusplus) + #if defined(_MSC_VER) && _MSC_VER <= 1800 + #define inline __inline + #elif !defined(__STDC_VERSION__) + #define inline __inline__ + #else + #define inline + #endif +#endif + +#if !defined(gb_restrict) + #if defined(_MSC_VER) + #define gb_restrict __restrict + #elif defined(__STDC_VERSION__) + #define gb_restrict restrict + #else + #define gb_restrict + #endif +#endif + +// TODO(bill): Should force inline be a separate keyword and gb_inline be inline? +#if !defined(gb_inline) + #if defined(_MSC_VER) + #if _MSC_VER < 1300 + #define gb_inline + #else + #define gb_inline __forceinline + #endif + #else + #define gb_inline __attribute__ ((__always_inline__)) + #endif +#endif + +#if !defined(gb_no_inline) + #if defined(_MSC_VER) + #define gb_no_inline __declspec(noinline) + #else + #define gb_no_inline __attribute__ ((noinline)) + #endif +#endif + + +#if !defined(gb_thread_local) + #if defined(_MSC_VER) && _MSC_VER >= 1300 + #define gb_thread_local __declspec(thread) + #elif defined(__GNUC__) + #define gb_thread_local __thread + #else + #define gb_thread_local thread_local + #endif +#endif + + +// NOTE(bill): Easy to grep +// NOTE(bill): Not needed in macros +#ifndef cast +#define cast(Type) (Type) +#endif + +// NOTE(bill): Because a signed sizeof is more useful +#ifndef gb_size_of +#define gb_size_of(x) (isize)(sizeof(x)) +#endif + +#ifndef gb_count_of +#define gb_count_of(x) ((gb_size_of(x)/gb_size_of(0[x])) / ((isize)(!(gb_size_of(x) % gb_size_of(0[x]))))) +#endif + +#ifndef gb_offset_of +#define gb_offset_of(Type, element) ((isize)&(((Type *)0)->element)) +#endif + +#if defined(__cplusplus) +#ifndef gb_align_of + #if __cplusplus >= 201103L + #define gb_align_of(Type) (isize)alignof(Type) + #else +extern "C++" { + // NOTE(bill): Fucking Templates! + template struct gbAlignment_Trick { char c; T member; }; + #define gb_align_of(Type) gb_offset_of(gbAlignment_Trick, member) +} + #endif +#endif +#else + #ifndef gb_align_of + #define gb_align_of(Type) gb_offset_of(struct { char c; Type member; }, member) + #endif +#endif + +// NOTE(bill): I do wish I had a type_of that was portable +#ifndef gb_swap +#define gb_swap(Type, a, b) do { Type tmp = (a); (a) = (b); (b) = tmp; } while (0) +#endif + +// NOTE(bill): Because static means 3/4 different things in C/C++. Great design (!) +#ifndef gb_global +#define gb_global static // Global variables +#define gb_internal static // Internal linkage +#define gb_local_persist static // Local Persisting variables +#endif + + +#ifndef gb_unused + #if defined(_MSC_VER) + #define gb_unused(x) (__pragma(warning(suppress:4100))(x)) + #elif defined (__GCC__) + #define gb_unused(x) __attribute__((__unused__))(x) + #else + #define gb_unused(x) ((void)(gb_size_of(x))) + #endif +#endif + + + + +//////////////////////////////////////////////////////////////// +// +// Defer statement +// Akin to D's SCOPE_EXIT or +// similar to Go's defer but scope-based +// +// NOTE: C++11 (and above) only! +// +#if !defined(GB_NO_DEFER) && defined(__cplusplus) && ((defined(_MSC_VER) && _MSC_VER >= 1400) || (__cplusplus >= 201103L)) +extern "C++" { + // NOTE(bill): Stupid fucking templates + template struct gbRemoveReference { typedef T Type; }; + template struct gbRemoveReference { typedef T Type; }; + template struct gbRemoveReference { typedef T Type; }; + + /// NOTE(bill): "Move" semantics - invented because the C++ committee are idiots (as a collective not as indiviuals (well a least some aren't)) + template inline T &&gb_forward(typename gbRemoveReference::Type &t) { return static_cast(t); } + template inline T &&gb_forward(typename gbRemoveReference::Type &&t) { return static_cast(t); } + template inline T &&gb_move (T &&t) { return static_cast::Type &&>(t); } + template + struct gbprivDefer { + F f; + gbprivDefer(F &&f) : f(gb_forward(f)) {} + ~gbprivDefer() { f(); } + }; + template gbprivDefer gb__defer_func(F &&f) { return gbprivDefer(gb_forward(f)); } + + #define GB_DEFER_1(x, y) x##y + #define GB_DEFER_2(x, y) GB_DEFER_1(x, y) + #define GB_DEFER_3(x) GB_DEFER_2(x, __COUNTER__) + #define defer(code) auto GB_DEFER_3(_defer_) = gb__defer_func([&]()->void{code;}) +} + +// Example +#if 0 + gbMutex m; + gb_mutex_init(&m); + { + gb_mutex_lock(&m); + defer (gb_mutex_unlock(&m)); + + ... + } +#endif + +#endif + + +//////////////////////////////////////////////////////////////// +// +// Macro Fun! +// +// + +#ifndef GB_JOIN_MACROS +#define GB_JOIN_MACROS + #define GB_JOIN2_IND(a, b) a##b + + #define GB_JOIN2(a, b) GB_JOIN2_IND(a, b) + #define GB_JOIN3(a, b, c) GB_JOIN2(GB_JOIN2(a, b), c) + #define GB_JOIN4(a, b, c, d) GB_JOIN2(GB_JOIN2(GB_JOIN2(a, b), c), d) +#endif + + +#ifndef GB_BIT +#define GB_BIT(x) (1<<(x)) +#endif + +#ifndef gb_min +#define gb_min(a, b) ((a) < (b) ? (a) : (b)) +#endif + +#ifndef gb_max +#define gb_max(a, b) ((a) > (b) ? (a) : (b)) +#endif + +#ifndef gb_min3 +#define gb_min3(a, b, c) gb_min(gb_min(a, b), c) +#endif + +#ifndef gb_max3 +#define gb_max3(a, b, c) gb_max(gb_max(a, b), c) +#endif + +#ifndef gb_clamp +#define gb_clamp(x, lower, upper) gb_min(gb_max((x), (lower)), (upper)) +#endif + +#ifndef gb_clamp01 +#define gb_clamp01(x) gb_clamp((x), 0, 1) +#endif + +#ifndef gb_is_between +#define gb_is_between(x, lower, upper) (((lower) <= (x)) && ((x) <= (upper))) +#endif + +#ifndef gb_abs +#define gb_abs(x) ((x) < 0 ? -(x) : (x)) +#endif + +/* NOTE(bill): Very useful bit setting */ +#ifndef GB_MASK_SET +#define GB_MASK_SET(var, set, mask) do { \ + if (set) (var) |= (mask); \ + else (var) &= ~(mask); \ +} while (0) +#endif + + +// NOTE(bill): Some compilers support applying printf-style warnings to user functions. +#if defined(__clang__) || defined(__GNUC__) +#define GB_PRINTF_ARGS(FMT) __attribute__((format(printf, FMT, (FMT+1)))) +#else +#define GB_PRINTF_ARGS(FMT) +#endif + +//////////////////////////////////////////////////////////////// +// +// Debug +// +// + + +#ifndef GB_DEBUG_TRAP + #if defined(_MSC_VER) + #if _MSC_VER < 1300 + #define GB_DEBUG_TRAP() __asm int 3 /* Trap to debugger! */ + #else + #define GB_DEBUG_TRAP() __debugbreak() + #endif + #else + #define GB_DEBUG_TRAP() __builtin_trap() + #endif +#endif + +#ifndef GB_ASSERT_MSG +#define GB_ASSERT_MSG(cond, msg, ...) do { \ + if (!(cond)) { \ + gb_assert_handler("Assertion Failure", #cond, __FILE__, cast(i64)__LINE__, msg, ##__VA_ARGS__); \ + GB_DEBUG_TRAP(); \ + } \ +} while (0) +#endif + +#ifndef GB_ASSERT +#define GB_ASSERT(cond) GB_ASSERT_MSG(cond, NULL) +#endif + +#ifndef GB_ASSERT_NOT_NULL +#define GB_ASSERT_NOT_NULL(ptr) GB_ASSERT_MSG((ptr) != NULL, #ptr " must not be NULL") +#endif + +// NOTE(bill): Things that shouldn't happen with a message! +#ifndef GB_PANIC +#define GB_PANIC(msg, ...) do { \ + gb_assert_handler("Panic", NULL, __FILE__, cast(i64)__LINE__, msg, ##__VA_ARGS__); \ + GB_DEBUG_TRAP(); \ +} while (0) +#endif + +GB_DEF void gb_assert_handler(char const *prefix, char const *condition, char const *file, i32 line, char const *msg, ...); + + + +//////////////////////////////////////////////////////////////// +// +// Memory +// +// + + +GB_DEF b32 gb_is_power_of_two(isize x); + +GB_DEF void * gb_align_forward(void *ptr, isize alignment); + +GB_DEF void * gb_pointer_add (void *ptr, isize bytes); +GB_DEF void * gb_pointer_sub (void *ptr, isize bytes); +GB_DEF void const *gb_pointer_add_const(void const *ptr, isize bytes); +GB_DEF void const *gb_pointer_sub_const(void const *ptr, isize bytes); +GB_DEF isize gb_pointer_diff (void const *begin, void const *end); + + +GB_DEF void gb_zero_size(void *ptr, isize size); +#ifndef gb_zero_item +#define gb_zero_item(t) gb_zero_size((t), gb_size_of(*(t))) // NOTE(bill): Pass pointer of struct +#define gb_zero_array(a, count) gb_zero_size((a), gb_size_of(*(a))*count) +#endif + +GB_DEF void * gb_memcopy (void *dest, void const *source, isize size); +GB_DEF void * gb_memmove (void *dest, void const *source, isize size); +GB_DEF void * gb_memset (void *data, u8 byte_value, isize size); +GB_DEF i32 gb_memcompare(void const *s1, void const *s2, isize size); +GB_DEF void gb_memswap (void *i, void *j, isize size); +GB_DEF void const *gb_memchr (void const *data, u8 byte_value, isize size); +GB_DEF void const *gb_memrchr (void const *data, u8 byte_value, isize size); + + +#ifndef gb_memcopy_array +#define gb_memcopy_array(dst, src, count) gb_memcopy((dst), (src), gb_size_of(*(dst))*(count)) +#endif + +#ifndef gb_memmove_array +#define gb_memmove_array(dst, src, count) gb_memmove((dst), (src), gb_size_of(*(dst))*(count)) +#endif + +// NOTE(bill): Very similar to doing `*cast(T *)(&u)` +#ifndef GB_BIT_CAST +#define GB_BIT_CAST(dest, source) do { \ + GB_STATIC_ASSERT(gb_size_of(*(dest)) <= gb_size_of(source)); \ + gb_memcopy((dest), &(source), gb_size_of(*dest)); \ +} while (0) +#endif + + + + +#ifndef gb_kilobytes +#define gb_kilobytes(x) ( (x) * (i64)(1024)) +#define gb_megabytes(x) (gb_kilobytes(x) * (i64)(1024)) +#define gb_gigabytes(x) (gb_megabytes(x) * (i64)(1024)) +#define gb_terabytes(x) (gb_gigabytes(x) * (i64)(1024)) +#endif + + + + +// Atomics + +// TODO(bill): Be specific with memory order? +// e.g. relaxed, acquire, release, acquire_release + +#if defined(GB_COMPILER_MSVC) +typedef struct gbAtomic32 { i32 volatile value; } gbAtomic32; +typedef struct gbAtomic64 { i64 volatile value; } gbAtomic64; +typedef struct gbAtomicPtr { void *volatile value; } gbAtomicPtr; +#else + #if defined(GB_ARCH_32_BIT) + #define GB_ATOMIC_PTR_ALIGNMENT 4 + #elif defined(GB_ARCH_64_BIT) + #define GB_ATOMIC_PTR_ALIGNMENT 8 + #else + #error Unknown architecture + #endif + +typedef struct gbAtomic32 { i32 volatile value; } __attribute__ ((aligned(4))) gbAtomic32; +typedef struct gbAtomic64 { i64 volatile value; } __attribute__ ((aligned(8))) gbAtomic64; +typedef struct gbAtomicPtr { void *volatile value; } __attribute__ ((aligned(GB_ATOMIC_PTR_ALIGNMENT))) gbAtomicPtr; +#endif + +GB_DEF i32 gb_atomic32_load (gbAtomic32 const volatile *a); +GB_DEF void gb_atomic32_store (gbAtomic32 volatile *a, i32 value); +GB_DEF i32 gb_atomic32_compare_exchange(gbAtomic32 volatile *a, i32 expected, i32 desired); +GB_DEF i32 gb_atomic32_exchanged (gbAtomic32 volatile *a, i32 desired); +GB_DEF i32 gb_atomic32_fetch_add (gbAtomic32 volatile *a, i32 operand); +GB_DEF i32 gb_atomic32_fetch_and (gbAtomic32 volatile *a, i32 operand); +GB_DEF i32 gb_atomic32_fetch_or (gbAtomic32 volatile *a, i32 operand); +GB_DEF b32 gb_atomic32_spin_lock (gbAtomic32 volatile *a, isize time_out); // NOTE(bill): time_out = -1 as default +GB_DEF void gb_atomic32_spin_unlock (gbAtomic32 volatile *a); +GB_DEF b32 gb_atomic32_try_acquire_lock(gbAtomic32 volatile *a); + + +GB_DEF i64 gb_atomic64_load (gbAtomic64 const volatile *a); +GB_DEF void gb_atomic64_store (gbAtomic64 volatile *a, i64 value); +GB_DEF i64 gb_atomic64_compare_exchange(gbAtomic64 volatile *a, i64 expected, i64 desired); +GB_DEF i64 gb_atomic64_exchanged (gbAtomic64 volatile *a, i64 desired); +GB_DEF i64 gb_atomic64_fetch_add (gbAtomic64 volatile *a, i64 operand); +GB_DEF i64 gb_atomic64_fetch_and (gbAtomic64 volatile *a, i64 operand); +GB_DEF i64 gb_atomic64_fetch_or (gbAtomic64 volatile *a, i64 operand); +GB_DEF b32 gb_atomic64_spin_lock (gbAtomic64 volatile *a, isize time_out); // NOTE(bill): time_out = -1 as default +GB_DEF void gb_atomic64_spin_unlock (gbAtomic64 volatile *a); +GB_DEF b32 gb_atomic64_try_acquire_lock(gbAtomic64 volatile *a); + + +GB_DEF void *gb_atomic_ptr_load (gbAtomicPtr const volatile *a); +GB_DEF void gb_atomic_ptr_store (gbAtomicPtr volatile *a, void *value); +GB_DEF void *gb_atomic_ptr_compare_exchange(gbAtomicPtr volatile *a, void *expected, void *desired); +GB_DEF void *gb_atomic_ptr_exchanged (gbAtomicPtr volatile *a, void *desired); +GB_DEF void *gb_atomic_ptr_fetch_add (gbAtomicPtr volatile *a, void *operand); +GB_DEF void *gb_atomic_ptr_fetch_and (gbAtomicPtr volatile *a, void *operand); +GB_DEF void *gb_atomic_ptr_fetch_or (gbAtomicPtr volatile *a, void *operand); +GB_DEF b32 gb_atomic_ptr_spin_lock (gbAtomicPtr volatile *a, isize time_out); // NOTE(bill): time_out = -1 as default +GB_DEF void gb_atomic_ptr_spin_unlock (gbAtomicPtr volatile *a); +GB_DEF b32 gb_atomic_ptr_try_acquire_lock(gbAtomicPtr volatile *a); + + +// Fences +GB_DEF void gb_yield_thread(void); +GB_DEF void gb_mfence (void); +GB_DEF void gb_sfence (void); +GB_DEF void gb_lfence (void); + + +#if defined(GB_SYSTEM_WINDOWS) +typedef struct gbSemaphore { void *win32_handle; } gbSemaphore; +#elif defined(GB_SYSTEM_OSX) +typedef struct gbSemaphore { semaphore_t osx_handle; } gbSemaphore; +#elif defined(GB_SYSTEM_UNIX) +typedef struct gbSemaphore { sem_t unix_handle; } gbSemaphore; +#else +#error +#endif + +GB_DEF void gb_semaphore_init (gbSemaphore *s); +GB_DEF void gb_semaphore_destroy(gbSemaphore *s); +GB_DEF void gb_semaphore_post (gbSemaphore *s, i32 count); +GB_DEF void gb_semaphore_release(gbSemaphore *s); // NOTE(bill): gb_semaphore_post(s, 1) +GB_DEF void gb_semaphore_wait (gbSemaphore *s); + + +// Mutex +typedef struct gbMutex { +#if defined(GB_SYSTEM_WINDOWS) + CRITICAL_SECTION win32_critical_section; +#else + pthread_mutex_t pthread_mutex; + pthread_mutexattr_t pthread_mutexattr; +#endif +} gbMutex; + +GB_DEF void gb_mutex_init (gbMutex *m); +GB_DEF void gb_mutex_destroy (gbMutex *m); +GB_DEF void gb_mutex_lock (gbMutex *m); +GB_DEF b32 gb_mutex_try_lock(gbMutex *m); +GB_DEF void gb_mutex_unlock (gbMutex *m); + +// NOTE(bill): If you wanted a Scoped Mutex in C++, why not use the defer() construct? +// No need for a silly wrapper class and it's clear! +#if 0 +gbMutex m = {0}; +gb_mutex_init(&m); +{ + gb_mutex_lock(&m); + defer (gb_mutex_unlock(&m)); + + // Do whatever as the mutex is now scoped based! +} +#endif + + + +#define GB_THREAD_PROC(name) isize name(struct gbThread *thread) +typedef GB_THREAD_PROC(gbThreadProc); + +typedef struct gbThread { +#if defined(GB_SYSTEM_WINDOWS) + void * win32_handle; +#else + pthread_t posix_handle; +#endif + + gbThreadProc *proc; + void * user_data; + isize user_index; + isize return_value; + + gbSemaphore semaphore; + isize stack_size; + b32 volatile is_running; +} gbThread; + +GB_DEF void gb_thread_init (gbThread *t); +GB_DEF void gb_thread_destroy (gbThread *t); +GB_DEF void gb_thread_start (gbThread *t, gbThreadProc *proc, void *data); +GB_DEF void gb_thread_start_with_stack(gbThread *t, gbThreadProc *proc, void *data, isize stack_size); +GB_DEF void gb_thread_join (gbThread *t); +GB_DEF b32 gb_thread_is_running (gbThread const *t); +GB_DEF u32 gb_thread_current_id (void); +GB_DEF void gb_thread_set_name (gbThread *t, char const *name); + + +// NOTE(bill): Thread Merge Operation +// Based on Sean Barrett's stb_sync +typedef struct gbSync { + i32 target; // Target Number of threads + i32 current; // Threads to hit + i32 waiting; // Threads waiting + + gbMutex start; + gbMutex mutex; + gbSemaphore release; +} gbSync; + +GB_DEF void gb_sync_init (gbSync *s); +GB_DEF void gb_sync_destroy (gbSync *s); +GB_DEF void gb_sync_set_target (gbSync *s, i32 count); +GB_DEF void gb_sync_release (gbSync *s); +GB_DEF i32 gb_sync_reach (gbSync *s); +GB_DEF void gb_sync_reach_and_wait(gbSync *s); + + + +#if defined(GB_SYSTEM_WINDOWS) + +typedef struct gbAffinity { + b32 is_accurate; + isize core_count; + isize thread_count; + #define GB_WIN32_MAX_THREADS (8 * gb_size_of(usize)) + usize core_masks[GB_WIN32_MAX_THREADS]; + +} gbAffinity; + +#elif defined(GB_SYSTEM_OSX) +typedef struct gbAffinity { + b32 is_accurate; + isize core_count; + isize thread_count; + isize threads_per_core; +} gbAffinity; + +#elif defined(GB_SYSTEM_LINUX) +typedef struct gbAffinity { + b32 is_accurate; + isize core_count; + isize thread_count; + isize threads_per_core; +} gbAffinity; +#else +#error TODO(bill): Unknown system +#endif + +GB_DEF void gb_affinity_init (gbAffinity *a); +GB_DEF void gb_affinity_destroy(gbAffinity *a); +GB_DEF b32 gb_affinity_set (gbAffinity *a, isize core, isize thread); +GB_DEF isize gb_affinity_thread_count_for_core(gbAffinity *a, isize core); + + + + +//////////////////////////////////////////////////////////////// +// +// Virtual Memory +// +// + +typedef struct gbVirtualMemory { + void *data; + isize size; +} gbVirtualMemory; + +GB_DEF gbVirtualMemory gb_virtual_memory(void *data, isize size); +GB_DEF gbVirtualMemory gb_vm_alloc (void *addr, isize size); +GB_DEF b32 gb_vm_free (gbVirtualMemory vm); +GB_DEF gbVirtualMemory gb_vm_trim (gbVirtualMemory vm, isize lead_size, isize size); +GB_DEF b32 gb_vm_purge (gbVirtualMemory vm); +GB_DEF isize gb_virtual_memory_page_size(isize *alignment_out); + + + + +//////////////////////////////////////////////////////////////// +// +// Custom Allocation +// +// + +typedef enum gbAllocationType { + gbAllocation_Alloc, + gbAllocation_Free, + gbAllocation_FreeAll, + gbAllocation_Resize, +} gbAllocationType; + +// NOTE(bill): This is useful so you can define an allocator of the same type and parameters +#define GB_ALLOCATOR_PROC(name) \ +void *name(void *allocator_data, gbAllocationType type, \ + isize size, isize alignment, \ + void *old_memory, isize old_size, \ + u64 flags) +typedef GB_ALLOCATOR_PROC(gbAllocatorProc); + +typedef struct gbAllocator { + gbAllocatorProc *proc; + void * data; +} gbAllocator; + +typedef enum gbAllocatorFlag { + gbAllocatorFlag_ClearToZero = GB_BIT(0), +} gbAllocatorFlag; + +// TODO(bill): Is this a decent default alignment? +#ifndef GB_DEFAULT_MEMORY_ALIGNMENT +#define GB_DEFAULT_MEMORY_ALIGNMENT (2 * gb_size_of(void *)) +#endif + +#ifndef GB_DEFAULT_ALLOCATOR_FLAGS +#define GB_DEFAULT_ALLOCATOR_FLAGS (gbAllocatorFlag_ClearToZero) +#endif + +GB_DEF void *gb_alloc_align (gbAllocator a, isize size, isize alignment); +GB_DEF void *gb_alloc (gbAllocator a, isize size); +GB_DEF void gb_free (gbAllocator a, void *ptr); +GB_DEF void gb_free_all (gbAllocator a); +GB_DEF void *gb_resize (gbAllocator a, void *ptr, isize old_size, isize new_size); +GB_DEF void *gb_resize_align(gbAllocator a, void *ptr, isize old_size, isize new_size, isize alignment); +// TODO(bill): For gb_resize, should the use need to pass the old_size or only the new_size? + +GB_DEF void *gb_alloc_copy (gbAllocator a, void const *src, isize size); +GB_DEF void *gb_alloc_copy_align(gbAllocator a, void const *src, isize size, isize alignment); +GB_DEF char *gb_alloc_str (gbAllocator a, char const *str); +GB_DEF char *gb_alloc_str_len (gbAllocator a, char const *str, isize len); + + +// NOTE(bill): These are very useful and the type cast has saved me from numerous bugs +#ifndef gb_alloc_item +#define gb_alloc_item(allocator_, Type) (Type *)gb_alloc(allocator_, gb_size_of(Type)) +#define gb_alloc_array(allocator_, Type, count) (Type *)gb_alloc(allocator_, gb_size_of(Type) * (count)) +#endif + +// NOTE(bill): Use this if you don't need a "fancy" resize allocation +GB_DEF void *gb_default_resize_align(gbAllocator a, void *ptr, isize old_size, isize new_size, isize alignment); + + + +// TODO(bill): Probably use a custom heap allocator system that doesn't depend on malloc/free +// Base it off TCMalloc or something else? Or something entirely custom? +GB_DEF gbAllocator gb_heap_allocator(void); +GB_DEF GB_ALLOCATOR_PROC(gb_heap_allocator_proc); + +// NOTE(bill): Yep, I use my own allocator system! +#ifndef gb_malloc +#define gb_malloc(sz) gb_alloc(gb_heap_allocator(), sz) +#define gb_mfree(ptr) gb_free(gb_heap_allocator(), ptr) +#endif + + + +// +// Arena Allocator +// +typedef struct gbArena { + gbAllocator backing; + void * physical_start; + isize total_size; + isize total_allocated; + isize temp_count; +} gbArena; + +GB_DEF void gb_arena_init_from_memory (gbArena *arena, void *start, isize size); +GB_DEF void gb_arena_init_from_allocator(gbArena *arena, gbAllocator backing, isize size); +GB_DEF void gb_arena_init_sub (gbArena *arena, gbArena *parent_arena, isize size); +GB_DEF void gb_arena_free (gbArena *arena); + +GB_DEF isize gb_arena_alignment_of (gbArena *arena, isize alignment); +GB_DEF isize gb_arena_size_remaining(gbArena *arena, isize alignment); +GB_DEF void gb_arena_check (gbArena *arena); + + +// Allocation Types: alloc, free_all, resize +GB_DEF gbAllocator gb_arena_allocator(gbArena *arena); +GB_DEF GB_ALLOCATOR_PROC(gb_arena_allocator_proc); + + + +typedef struct gbTempArenaMemory { + gbArena *arena; + isize original_count; +} gbTempArenaMemory; + +GB_DEF gbTempArenaMemory gb_temp_arena_memory_begin(gbArena *arena); +GB_DEF void gb_temp_arena_memory_end (gbTempArenaMemory tmp_mem); + + + + + + + +// +// Pool Allocator +// + + +typedef struct gbPool { + gbAllocator backing; + void * physical_start; + void * free_list; + isize block_size; + isize block_align; + isize total_size; +} gbPool; + +GB_DEF void gb_pool_init (gbPool *pool, gbAllocator backing, isize num_blocks, isize block_size); +GB_DEF void gb_pool_init_align(gbPool *pool, gbAllocator backing, isize num_blocks, isize block_size, isize block_align); +GB_DEF void gb_pool_free (gbPool *pool); + +// Allocation Types: alloc, free +GB_DEF gbAllocator gb_pool_allocator(gbPool *pool); +GB_DEF GB_ALLOCATOR_PROC(gb_pool_allocator_proc); + + + +// NOTE(bill): Used for allocators to keep track of sizes +typedef struct gbAllocationHeader { + isize size; +} gbAllocationHeader; + +GB_DEF gbAllocationHeader *gb_allocation_header (void *data); +GB_DEF void gb_allocation_header_fill(gbAllocationHeader *header, void *data, isize size); + +// TODO(bill): Find better way of doing this without #if #elif etc. +#if defined(GB_ARCH_32_BIT) +#define GB_ISIZE_HIGH_BIT 0x80000000 +#elif defined(GB_ARCH_64_BIT) +#define GB_ISIZE_HIGH_BIT 0x8000000000000000ll +#else +#error +#endif + +// +// Free List Allocator +// + +// IMPORTANT TODO(bill): Thoroughly test the free list allocator! +// NOTE(bill): This is a very shitty free list as it just picks the first free block not the best size +// as I am just being lazy. Also, I will probably remove it later; it's only here because why not?! +// +// NOTE(bill): I may also complete remove this if I completely implement a fixed heap allocator + +typedef struct gbFreeListBlock gbFreeListBlock; +struct gbFreeListBlock { + gbFreeListBlock *next; + isize size; +}; + +typedef struct gbFreeList { + void * physical_start; + isize total_size; + + gbFreeListBlock *curr_block; + + isize total_allocated; + isize allocation_count; +} gbFreeList; + +GB_DEF void gb_free_list_init (gbFreeList *fl, void *start, isize size); +GB_DEF void gb_free_list_init_from_allocator(gbFreeList *fl, gbAllocator backing, isize size); + +// Allocation Types: alloc, free, free_all, resize +GB_DEF gbAllocator gb_free_list_allocator(gbFreeList *fl); +GB_DEF GB_ALLOCATOR_PROC(gb_free_list_allocator_proc); + + + +// +// Scratch Memory Allocator - Ring Buffer Based Arena +// + +typedef struct gbScratchMemory { + void *physical_start; + isize total_size; + void *alloc_point; + void *free_point; +} gbScratchMemory; + +GB_DEF void gb_scratch_memory_init (gbScratchMemory *s, void *start, isize size); +GB_DEF b32 gb_scratch_memory_is_in_use(gbScratchMemory *s, void *ptr); + + +// Allocation Types: alloc, free, free_all, resize +GB_DEF gbAllocator gb_scratch_allocator(gbScratchMemory *s); +GB_DEF GB_ALLOCATOR_PROC(gb_scratch_allocator_proc); + +// TODO(bill): Stack allocator +// TODO(bill): Fixed heap allocator +// TODO(bill): General heap allocator. Maybe a TCMalloc like clone? + + +//////////////////////////////////////////////////////////////// +// +// Sort & Search +// +// + +#define GB_COMPARE_PROC(name) int name(void const *a, void const *b) +typedef GB_COMPARE_PROC(gbCompareProc); + +#define GB_COMPARE_PROC_PTR(def) GB_COMPARE_PROC((*def)) + +// Producure pointers +// NOTE(bill): The offset parameter specifies the offset in the structure +// e.g. gb_i32_cmp(gb_offset_of(Thing, value)) +// Use 0 if it's just the type instead. + +GB_DEF GB_COMPARE_PROC_PTR(gb_i16_cmp (isize offset)); +GB_DEF GB_COMPARE_PROC_PTR(gb_i32_cmp (isize offset)); +GB_DEF GB_COMPARE_PROC_PTR(gb_i64_cmp (isize offset)); +GB_DEF GB_COMPARE_PROC_PTR(gb_isize_cmp(isize offset)); +GB_DEF GB_COMPARE_PROC_PTR(gb_str_cmp (isize offset)); +GB_DEF GB_COMPARE_PROC_PTR(gb_f32_cmp (isize offset)); +GB_DEF GB_COMPARE_PROC_PTR(gb_f64_cmp (isize offset)); +GB_DEF GB_COMPARE_PROC_PTR(gb_char_cmp (isize offset)); + +// TODO(bill): Better sorting algorithms +// NOTE(bill): Uses quick sort for large arrays but insertion sort for small +#define gb_sort_array(array, count, compare_proc) gb_sort(array, count, gb_size_of(*(array)), compare_proc) +GB_DEF void gb_sort(void *base, isize count, isize size, gbCompareProc compare_proc); + +// NOTE(bill): the count of temp == count of items +#define gb_radix_sort(Type) gb_radix_sort_##Type +#define GB_RADIX_SORT_PROC(Type) void gb_radix_sort(Type)(Type *items, Type *temp, isize count) + +GB_DEF GB_RADIX_SORT_PROC(u8); +GB_DEF GB_RADIX_SORT_PROC(u16); +GB_DEF GB_RADIX_SORT_PROC(u32); +GB_DEF GB_RADIX_SORT_PROC(u64); + + +// NOTE(bill): Returns index or -1 if not found +#define gb_binary_search_array(array, count, key, compare_proc) gb_binary_search(array, count, gb_size_of(*(array)), key, compare_proc) +GB_DEF isize gb_binary_search(void const *base, isize count, isize size, void const *key, gbCompareProc compare_proc); + +#define gb_shuffle_array(array, count) gb_shuffle(array, count, gb_size_of(*(array))) +GB_DEF void gb_shuffle(void *base, isize count, isize size); + +#define gb_reverse_array(array, count) gb_reverse(array, count, gb_size_of(*(array))) +GB_DEF void gb_reverse(void *base, isize count, isize size); + +//////////////////////////////////////////////////////////////// +// +// Char Functions +// +// + +GB_DEF char gb_char_to_lower (char c); +GB_DEF char gb_char_to_upper (char c); +GB_DEF b32 gb_char_is_space (char c); +GB_DEF b32 gb_char_is_digit (char c); +GB_DEF b32 gb_char_is_hex_digit (char c); +GB_DEF b32 gb_char_is_alpha (char c); +GB_DEF b32 gb_char_is_alphanumeric(char c); +GB_DEF i32 gb_digit_to_int (char c); +GB_DEF i32 gb_hex_digit_to_int (char c); + +// NOTE(bill): ASCII only +GB_DEF void gb_str_to_lower(char *str); +GB_DEF void gb_str_to_upper(char *str); + +GB_DEF isize gb_strlen (char const *str); +GB_DEF isize gb_strnlen(char const *str, isize max_len); +GB_DEF i32 gb_strcmp (char const *s1, char const *s2); +GB_DEF i32 gb_strncmp(char const *s1, char const *s2, isize len); +GB_DEF char *gb_strcpy (char *dest, char const *source); +GB_DEF char *gb_strncpy(char *dest, char const *source, isize len); +GB_DEF isize gb_strlcpy(char *dest, char const *source, isize len); +GB_DEF char *gb_strrev (char *str); // NOTE(bill): ASCII only + +// NOTE(bill): A less fucking crazy strtok! +GB_DEF char const *gb_strtok(char *output, char const *src, char const *delimit); + +GB_DEF b32 gb_str_has_prefix(char const *str, char const *prefix); +GB_DEF b32 gb_str_has_suffix(char const *str, char const *suffix); + +GB_DEF char const *gb_char_first_occurence(char const *str, char c); +GB_DEF char const *gb_char_last_occurence (char const *str, char c); + +GB_DEF void gb_str_concat(char *dest, isize dest_len, + char const *src_a, isize src_a_len, + char const *src_b, isize src_b_len); + +GB_DEF u64 gb_str_to_u64(char const *str, char **end_ptr, i32 base); // TODO(bill): Support more than just decimal and hexadecimal +GB_DEF i64 gb_str_to_i64(char const *str, char **end_ptr, i32 base); // TODO(bill): Support more than just decimal and hexadecimal +GB_DEF f32 gb_str_to_f32(char const *str, char **end_ptr); +GB_DEF f64 gb_str_to_f64(char const *str, char **end_ptr); +GB_DEF void gb_i64_to_str(i64 value, char *string, i32 base); +GB_DEF void gb_u64_to_str(u64 value, char *string, i32 base); + + +//////////////////////////////////////////////////////////////// +// +// UTF-8 Handling +// +// + +// NOTE(bill): Does not check if utf-8 string is valid +GB_DEF isize gb_utf8_strlen (u8 const *str); +GB_DEF isize gb_utf8_strnlen(u8 const *str, isize max_len); + +// NOTE(bill): Windows doesn't handle 8 bit filenames well ('cause Micro$hit) +GB_DEF u16 *gb_utf8_to_ucs2 (u16 *buffer, isize len, u8 const *str); +GB_DEF u8 * gb_ucs2_to_utf8 (u8 *buffer, isize len, u16 const *str); +GB_DEF u16 *gb_utf8_to_ucs2_buf(u8 const *str); // NOTE(bill): Uses locally persisting buffer +GB_DEF u8 * gb_ucs2_to_utf8_buf(u16 const *str); // NOTE(bill): Uses locally persisting buffer + +// NOTE(bill): Returns size of codepoint in bytes +GB_DEF isize gb_utf8_decode (u8 const *str, isize str_len, Rune *codepoint); +GB_DEF isize gb_utf8_codepoint_size(u8 const *str, isize str_len); +GB_DEF isize gb_utf8_encode_rune (u8 buf[4], Rune r); + +//////////////////////////////////////////////////////////////// +// +// gbString - C Read-Only-Compatible +// +// +/* +Reasoning: + + By default, strings in C are null terminated which means you have to count + the number of character up to the null character to calculate the length. + Many "better" C string libraries will create a struct for a string. + i.e. + + struct String { + Allocator allocator; + size_t length; + size_t capacity; + char * cstring; + }; + + This library tries to augment normal C strings in a better way that is still + compatible with C-style strings. + + +--------+-----------------------+-----------------+ + | Header | Binary C-style String | Null Terminator | + +--------+-----------------------+-----------------+ + | + +-> Pointer returned by functions + + Due to the meta-data being stored before the string pointer and every gb string + having an implicit null terminator, gb strings are full compatible with c-style + strings and read-only functions. + +Advantages: + + * gb strings can be passed to C-style string functions without accessing a struct + member of calling a function, i.e. + + gb_printf("%s\n", gb_str); + + Many other libraries do either of these: + + gb_printf("%s\n", string->cstr); + gb_printf("%s\n", get_cstring(string)); + + * You can access each character just like a C-style string: + + gb_printf("%c %c\n", str[0], str[13]); + + * gb strings are singularly allocated. The meta-data is next to the character + array which is better for the cache. + +Disadvantages: + + * In the C version of these functions, many return the new string. i.e. + str = gb_string_appendc(str, "another string"); + This could be changed to gb_string_appendc(&str, "another string"); but I'm still not sure. + + * This is incompatible with "gb_string.h" strings +*/ + +#if 0 +#define GB_IMPLEMENTATION +#include "gb.h" +int main(int argc, char **argv) { + gbString str = gb_string_make("Hello"); + gbString other_str = gb_string_make_length(", ", 2); + str = gb_string_append(str, other_str); + str = gb_string_appendc(str, "world!"); + + gb_printf("%s\n", str); // Hello, world! + + gb_printf("str length = %d\n", gb_string_length(str)); + + str = gb_string_set(str, "Potato soup"); + gb_printf("%s\n", str); // Potato soup + + str = gb_string_set(str, "Hello"); + other_str = gb_string_set(other_str, "Pizza"); + if (gb_strings_are_equal(str, other_str)) + gb_printf("Not called\n"); + else + gb_printf("Called\n"); + + str = gb_string_set(str, "Ab.;!...AHello World ??"); + str = gb_string_trim(str, "Ab.;!. ?"); + gb_printf("%s\n", str); // "Hello World" + + gb_string_free(str); + gb_string_free(other_str); + + return 0; +} +#endif + +// TODO(bill): Should this be a wrapper to gbArray(char) or this extra type safety better? +typedef char *gbString; + +// NOTE(bill): If you only need a small string, just use a standard c string or change the size from isize to u16, etc. +typedef struct gbStringHeader { + gbAllocator allocator; + isize length; + isize capacity; +} gbStringHeader; + +#define GB_STRING_HEADER(str) (cast(gbStringHeader *)(str) - 1) + +GB_DEF gbString gb_string_make_reserve (gbAllocator a, isize capacity); +GB_DEF gbString gb_string_make (gbAllocator a, char const *str); +GB_DEF gbString gb_string_make_length (gbAllocator a, void const *str, isize num_bytes); +GB_DEF void gb_string_free (gbString str); +GB_DEF gbString gb_string_duplicate (gbAllocator a, gbString const str); +GB_DEF isize gb_string_length (gbString const str); +GB_DEF isize gb_string_capacity (gbString const str); +GB_DEF isize gb_string_available_space(gbString const str); +GB_DEF void gb_string_clear (gbString str); +GB_DEF gbString gb_string_append (gbString str, gbString const other); +GB_DEF gbString gb_string_append_length (gbString str, void const *other, isize num_bytes); +GB_DEF gbString gb_string_appendc (gbString str, char const *other); +GB_DEF gbString gb_string_append_rune (gbString str, Rune r); +GB_DEF gbString gb_string_append_fmt (gbString str, char const *fmt, ...); +GB_DEF gbString gb_string_set (gbString str, char const *cstr); +GB_DEF gbString gb_string_make_space_for (gbString str, isize add_len); +GB_DEF isize gb_string_allocation_size(gbString const str); +GB_DEF b32 gb_string_are_equal (gbString const lhs, gbString const rhs); +GB_DEF gbString gb_string_trim (gbString str, char const *cut_set); +GB_DEF gbString gb_string_trim_space (gbString str); // Whitespace ` \t\r\n\v\f` + + + +//////////////////////////////////////////////////////////////// +// +// Fixed Capacity Buffer (POD Types) +// +// +// gbBuffer(Type) works like gbString or gbArray where the actual type is just a pointer to the first +// element. +// + +typedef struct gbBufferHeader { + isize count; + isize capacity; +} gbBufferHeader; + +#define gbBuffer(Type) Type * + +#define GB_BUFFER_HEADER(x) (cast(gbBufferHeader *)(x) - 1) +#define gb_buffer_count(x) (GB_BUFFER_HEADER(x)->count) +#define gb_buffer_capacity(x) (GB_BUFFER_HEADER(x)->capacity) + +#define gb_buffer_init(x, allocator, cap) do { \ + void **nx = cast(void **)&(x); \ + gbBufferHeader *gb__bh = cast(gbBufferHeader *)gb_alloc((allocator), (cap)*gb_size_of(*(x))); \ + gb__bh->count = 0; \ + gb__bh->capacity = cap; \ + *nx = cast(void *)(gb__bh+1); \ +} while (0) + + +#define gb_buffer_free(x, allocator) (gb_free(allocator, GB_BUFFER_HEADER(x))) + +#define gb_buffer_append(x, item) do { (x)[gb_buffer_count(x)++] = (item); } while (0) + +#define gb_buffer_appendv(x, items, item_count) do { \ + GB_ASSERT(gb_size_of(*(items)) == gb_size_of(*(x))); \ + GB_ASSERT(gb_buffer_count(x)+item_count <= gb_buffer_capacity(x)); \ + gb_memcopy(&(x)[gb_buffer_count(x)], (items), gb_size_of(*(x))*(item_count)); \ + gb_buffer_count(x) += (item_count); \ +} while (0) + +#define gb_buffer_pop(x) do { GB_ASSERT(gb_buffer_count(x) > 0); gb_buffer_count(x)--; } while (0) +#define gb_buffer_clear(x) do { gb_buffer_count(x) = 0; } while (0) + + + +//////////////////////////////////////////////////////////////// +// +// Dynamic Array (POD Types) +// +// NOTE(bill): I know this is a macro hell but C is an old (and shit) language with no proper arrays +// Also why the fuck not?! It fucking works! And it has custom allocation, which is already better than C++! +// +// gbArray(Type) works like gbString or gbBuffer where the actual type is just a pointer to the first +// element. +// + + + +// Available Procedures for gbArray(Type) +// gb_array_init +// gb_array_free +// gb_array_set_capacity +// gb_array_grow +// gb_array_append +// gb_array_appendv +// gb_array_pop +// gb_array_clear +// gb_array_resize +// gb_array_reserve +// + +#if 0 // Example +void foo(void) { + isize i; + int test_values[] = {4, 2, 1, 7}; + gbAllocator a = gb_heap_allocator(); + gbArray(int) items; + + gb_array_init(items, a); + + gb_array_append(items, 1); + gb_array_append(items, 4); + gb_array_append(items, 9); + gb_array_append(items, 16); + + items[1] = 3; // Manually set value + // NOTE: No array bounds checking + + for (i = 0; i < items.count; i++) + gb_printf("%d\n", items[i]); + // 1 + // 3 + // 9 + // 16 + + gb_array_clear(items); + + gb_array_appendv(items, test_values, gb_count_of(test_values)); + for (i = 0; i < items.count; i++) + gb_printf("%d\n", items[i]); + // 4 + // 2 + // 1 + // 7 + + gb_array_free(items); +} +#endif + +typedef struct gbArrayHeader { + gbAllocator allocator; + isize count; + isize capacity; +} gbArrayHeader; + +// NOTE(bill): This thing is magic! +#define gbArray(Type) Type * + +#ifndef GB_ARRAY_GROW_FORMULA +#define GB_ARRAY_GROW_FORMULA(x) (2*(x) + 8) +#endif + +GB_STATIC_ASSERT(GB_ARRAY_GROW_FORMULA(0) > 0); + +#define GB_ARRAY_HEADER(x) (cast(gbArrayHeader *)(x) - 1) +#define gb_array_allocator(x) (GB_ARRAY_HEADER(x)->allocator) +#define gb_array_count(x) (GB_ARRAY_HEADER(x)->count) +#define gb_array_capacity(x) (GB_ARRAY_HEADER(x)->capacity) + +// TODO(bill): Have proper alignment! +#define gb_array_init_reserve(x, allocator_, cap) do { \ + void **gb__array_ = cast(void **)&(x); \ + gbArrayHeader *gb__ah = cast(gbArrayHeader *)gb_alloc(allocator_, gb_size_of(gbArrayHeader)+gb_size_of(*(x))*(cap)); \ + gb__ah->allocator = allocator_; \ + gb__ah->count = 0; \ + gb__ah->capacity = cap; \ + *gb__array_ = cast(void *)(gb__ah+1); \ +} while (0) + +// NOTE(bill): Give it an initial default capacity +#define gb_array_init(x, allocator) gb_array_init_reserve(x, allocator, GB_ARRAY_GROW_FORMULA(0)) + +#define gb_array_free(x) do { \ + gbArrayHeader *gb__ah = GB_ARRAY_HEADER(x); \ + gb_free(gb__ah->allocator, gb__ah); \ +} while (0) + +#define gb_array_set_capacity(x, capacity) do { \ + if (x) { \ + void **gb__array_ = cast(void **)&(x); \ + *gb__array_ = gb__array_set_capacity((x), (capacity), gb_size_of(*(x))); \ + } \ +} while (0) + +// NOTE(bill): Do not use the thing below directly, use the macro +GB_DEF void *gb__array_set_capacity(void *array, isize capacity, isize element_size); + + +// TODO(bill): Decide on a decent growing formula for gbArray +#define gb_array_grow(x, min_capacity) do { \ + isize new_capacity = GB_ARRAY_GROW_FORMULA(gb_array_capacity(x)); \ + if (new_capacity < (min_capacity)) \ + new_capacity = (min_capacity); \ + gb_array_set_capacity(x, new_capacity); \ +} while (0) + + +#define gb_array_append(x, item) do { \ + if (gb_array_capacity(x) < gb_array_count(x)+1) \ + gb_array_grow(x, 0); \ + (x)[gb_array_count(x)++] = (item); \ +} while (0) + +#define gb_array_appendv(x, items, item_count) do { \ + gbArrayHeader *gb__ah = GB_ARRAY_HEADER(x); \ + GB_ASSERT(gb_size_of((items)[0]) == gb_size_of((x)[0])); \ + if (gb__ah->capacity < gb__ah->count+(item_count)) \ + gb_array_grow(x, gb__ah->count+(item_count)); \ + gb_memcopy(&(x)[gb__ah->count], (items), gb_size_of((x)[0])*(item_count));\ + gb__ah->count += (item_count); \ +} while (0) + + + +#define gb_array_pop(x) do { GB_ASSERT(GB_ARRAY_HEADER(x)->count > 0); GB_ARRAY_HEADER(x)->count--; } while (0) +#define gb_array_clear(x) do { GB_ARRAY_HEADER(x)->count = 0; } while (0) + +#define gb_array_resize(x, new_count) do { \ + if (GB_ARRAY_HEADER(x)->capacity < (new_count)) \ + gb_array_grow(x, (new_count)); \ + GB_ARRAY_HEADER(x)->count = (new_count); \ +} while (0) + + +#define gb_array_reserve(x, new_capacity) do { \ + if (GB_ARRAY_HEADER(x)->capacity < (new_capacity)) \ + gb_array_set_capacity(x, new_capacity); \ +} while (0) + + + + + +//////////////////////////////////////////////////////////////// +// +// Hashing and Checksum Functions +// +// + +GB_EXTERN u32 gb_adler32(void const *data, isize len); + +GB_EXTERN u32 gb_crc32(void const *data, isize len); +GB_EXTERN u64 gb_crc64(void const *data, isize len); + +GB_EXTERN u32 gb_fnv32 (void const *data, isize len); +GB_EXTERN u64 gb_fnv64 (void const *data, isize len); +GB_EXTERN u32 gb_fnv32a(void const *data, isize len); +GB_EXTERN u64 gb_fnv64a(void const *data, isize len); + +// NOTE(bill): Default seed of 0x9747b28c +// NOTE(bill): I prefer using murmur64 for most hashes +GB_EXTERN u32 gb_murmur32(void const *data, isize len); +GB_EXTERN u64 gb_murmur64(void const *data, isize len); + +GB_EXTERN u32 gb_murmur32_seed(void const *data, isize len, u32 seed); +GB_EXTERN u64 gb_murmur64_seed(void const *data, isize len, u64 seed); + + +//////////////////////////////////////////////////////////////// +// +// Instantiated Hash Table +// +// This is an attempt to implement a templated hash table +// NOTE(bill): The key is aways a u64 for simplicity and you will _probably_ _never_ need anything bigger. +// +// Hash table type and function declaration, call: GB_TABLE_DECLARE(PREFIX, NAME, N, VALUE) +// Hash table function definitions, call: GB_TABLE_DEFINE(NAME, N, VALUE) +// +// PREFIX - a prefix for function prototypes e.g. extern, static, etc. +// NAME - Name of the Hash Table +// FUNC - the name will prefix function names +// VALUE - the type of the value to be stored +// +// NOTE(bill): I really wish C had decent metaprogramming capabilities (and no I don't mean C++'s templates either) +// + +typedef struct gbHashTableFindResult { + isize hash_index; + isize entry_prev; + isize entry_index; +} gbHashTableFindResult; + +#define GB_TABLE(PREFIX, NAME, FUNC, VALUE) \ + GB_TABLE_DECLARE(PREFIX, NAME, FUNC, VALUE); \ + GB_TABLE_DEFINE(NAME, FUNC, VALUE); + +#define GB_TABLE_DECLARE(PREFIX, NAME, FUNC, VALUE) \ +typedef struct GB_JOIN2(NAME,Entry) { \ + u64 key; \ + isize next; \ + VALUE value; \ +} GB_JOIN2(NAME,Entry); \ +\ +typedef struct NAME { \ + gbArray(isize) hashes; \ + gbArray(GB_JOIN2(NAME,Entry)) entries; \ +} NAME; \ +\ +PREFIX void GB_JOIN2(FUNC,init) (NAME *h, gbAllocator a); \ +PREFIX void GB_JOIN2(FUNC,destroy) (NAME *h); \ +PREFIX VALUE * GB_JOIN2(FUNC,get) (NAME *h, u64 key); \ +PREFIX void GB_JOIN2(FUNC,set) (NAME *h, u64 key, VALUE value); \ +PREFIX void GB_JOIN2(FUNC,grow) (NAME *h); \ +PREFIX void GB_JOIN2(FUNC,rehash) (NAME *h, isize new_count); \ + + + + + +#define GB_TABLE_DEFINE(NAME, FUNC, VALUE) \ +void GB_JOIN2(FUNC,init)(NAME *h, gbAllocator a) { \ + gb_array_init(h->hashes, a); \ + gb_array_init(h->entries, a); \ +} \ +\ +void GB_JOIN2(FUNC,destroy)(NAME *h) { \ + if (h->entries) gb_array_free(h->entries); \ + if (h->hashes) gb_array_free(h->hashes); \ +} \ +\ +gb_internal isize GB_JOIN2(FUNC,_add_entry)(NAME *h, u64 key) { \ + isize index; \ + GB_JOIN2(NAME,Entry) e = {0}; \ + e.key = key; \ + e.next = -1; \ + index = gb_array_count(h->entries); \ + gb_array_append(h->entries, e); \ + return index; \ +} \ +\ +gb_internal gbHashTableFindResult GB_JOIN2(FUNC,_find)(NAME *h, u64 key) { \ + gbHashTableFindResult r = {-1, -1, -1}; \ + if (gb_array_count(h->hashes) > 0) { \ + r.hash_index = key % gb_array_count(h->hashes); \ + r.entry_index = h->hashes[r.hash_index]; \ + while (r.entry_index >= 0) { \ + if (h->entries[r.entry_index].key == key) \ + return r; \ + r.entry_prev = r.entry_index; \ + r.entry_index = h->entries[r.entry_index].next; \ + } \ + } \ + return r; \ +} \ +\ +gb_internal b32 GB_JOIN2(FUNC,_full)(NAME *h) { \ + return 0.75f * gb_array_count(h->hashes) < gb_array_count(h->entries); \ +} \ +\ +void GB_JOIN2(FUNC,grow)(NAME *h) { \ + isize new_count = GB_ARRAY_GROW_FORMULA(gb_array_count(h->entries)); \ + GB_JOIN2(FUNC,rehash)(h, new_count); \ +} \ +\ +void GB_JOIN2(FUNC,rehash)(NAME *h, isize new_count) { \ + isize i, j; \ + NAME nh = {0}; \ + GB_JOIN2(FUNC,init)(&nh, gb_array_allocator(h->hashes)); \ + gb_array_resize(nh.hashes, new_count); \ + gb_array_reserve(nh.entries, gb_array_count(h->entries)); \ + for (i = 0; i < new_count; i++) \ + nh.hashes[i] = -1; \ + for (i = 0; i < gb_array_count(h->entries); i++) { \ + GB_JOIN2(NAME,Entry) *e; \ + gbHashTableFindResult fr; \ + if (gb_array_count(nh.hashes) == 0) \ + GB_JOIN2(FUNC,grow)(&nh); \ + e = &h->entries[i]; \ + fr = GB_JOIN2(FUNC,_find)(&nh, e->key); \ + j = GB_JOIN2(FUNC,_add_entry)(&nh, e->key); \ + if (fr.entry_prev < 0) \ + nh.hashes[fr.hash_index] = j; \ + else \ + nh.entries[fr.entry_prev].next = j; \ + nh.entries[j].next = fr.entry_index; \ + nh.entries[j].value = e->value; \ + if (GB_JOIN2(FUNC,_full)(&nh)) \ + GB_JOIN2(FUNC,grow)(&nh); \ + } \ + GB_JOIN2(FUNC,destroy)(h); \ + h->hashes = nh.hashes; \ + h->entries = nh.entries; \ +} \ +\ +VALUE *GB_JOIN2(FUNC,get)(NAME *h, u64 key) { \ + isize index = GB_JOIN2(FUNC,_find)(h, key).entry_index; \ + if (index >= 0) \ + return &h->entries[index].value; \ + return NULL; \ +} \ +\ +void GB_JOIN2(FUNC,set)(NAME *h, u64 key, VALUE value) { \ + isize index; \ + gbHashTableFindResult fr; \ + if (gb_array_count(h->hashes) == 0) \ + GB_JOIN2(FUNC,grow)(h); \ + fr = GB_JOIN2(FUNC,_find)(h, key); \ + if (fr.entry_index >= 0) { \ + index = fr.entry_index; \ + } else { \ + index = GB_JOIN2(FUNC,_add_entry)(h, key); \ + if (fr.entry_prev >= 0) { \ + h->entries[fr.entry_prev].next = index; \ + } else { \ + h->hashes[fr.hash_index] = index; \ + } \ + } \ + h->entries[index].value = value; \ + if (GB_JOIN2(FUNC,_full)(h)) \ + GB_JOIN2(FUNC,grow)(h); \ +} \ + + + + +//////////////////////////////////////////////////////////////// +// +// File Handling +// + + +typedef u32 gbFileMode; +typedef enum gbFileModeFlag { + gbFileMode_Read = GB_BIT(0), + gbFileMode_Write = GB_BIT(1), + gbFileMode_Append = GB_BIT(2), + gbFileMode_Rw = GB_BIT(3), + + gbFileMode_Modes = gbFileMode_Read | gbFileMode_Write | gbFileMode_Append | gbFileMode_Rw, +} gbFileModeFlag; + +// NOTE(bill): Only used internally and for the file operations +typedef enum gbSeekWhenceType { + gbSeekWhence_Begin = 0, + gbSeekWhence_Current = 1, + gbSeekWhence_End = 2, +} gbSeekWhenceType; + +typedef enum gbFileError { + gbFileError_None, + gbFileError_Invalid, + gbFileError_InvalidFilename, + gbFileError_Exists, + gbFileError_NotExists, + gbFileError_Permission, + gbFileError_TruncationFailure, +} gbFileError; + +typedef union gbFileDescriptor { + void * p; + intptr i; + uintptr u; +} gbFileDescriptor; + +typedef struct gbFileOperations gbFileOperations; + +#define GB_FILE_OPEN_PROC(name) gbFileError name(gbFileDescriptor *fd, gbFileOperations *ops, gbFileMode mode, char const *filename) +#define GB_FILE_READ_AT_PROC(name) b32 name(gbFileDescriptor fd, void *buffer, isize size, i64 offset, isize *bytes_read) +#define GB_FILE_WRITE_AT_PROC(name) b32 name(gbFileDescriptor fd, void const *buffer, isize size, i64 offset, isize *bytes_written) +#define GB_FILE_SEEK_PROC(name) b32 name(gbFileDescriptor fd, i64 offset, gbSeekWhenceType whence, i64 *new_offset) +#define GB_FILE_CLOSE_PROC(name) void name(gbFileDescriptor fd) +typedef GB_FILE_OPEN_PROC(gbFileOpenProc); +typedef GB_FILE_READ_AT_PROC(gbFileReadProc); +typedef GB_FILE_WRITE_AT_PROC(gbFileWriteProc); +typedef GB_FILE_SEEK_PROC(gbFileSeekProc); +typedef GB_FILE_CLOSE_PROC(gbFileCloseProc); + +struct gbFileOperations { + gbFileReadProc *read_at; + gbFileWriteProc *write_at; + gbFileSeekProc *seek; + gbFileCloseProc *close; +}; + +extern gbFileOperations const gbDefaultFileOperations; + + +// typedef struct gbDirInfo { +// u8 *buf; +// isize buf_count; +// isize buf_pos; +// } gbDirInfo; + +typedef u64 gbFileTime; + +typedef struct gbFile { + gbFileOperations ops; + gbFileDescriptor fd; + char const * filename; + gbFileTime last_write_time; + // gbDirInfo * dir_info; // TODO(bill): Get directory info +} gbFile; + +// TODO(bill): gbAsyncFile + +typedef enum gbFileStandardType { + gbFileStandard_Input, + gbFileStandard_Output, + gbFileStandard_Error, + + gbFileStandard_Count, +} gbFileStandardType; + +GB_DEF gbFile *const gb_file_get_standard(gbFileStandardType std); + +GB_DEF gbFileError gb_file_create (gbFile *file, char const *filename); +GB_DEF gbFileError gb_file_open (gbFile *file, char const *filename); +GB_DEF gbFileError gb_file_open_mode (gbFile *file, gbFileMode mode, char const *filename); +GB_DEF gbFileError gb_file_new (gbFile *file, gbFileDescriptor fd, gbFileOperations ops, char const *filename); +GB_DEF b32 gb_file_read_at_check (gbFile *file, void *buffer, isize size, i64 offset, isize *bytes_read); +GB_DEF b32 gb_file_write_at_check(gbFile *file, void const *buffer, isize size, i64 offset, isize *bytes_written); +GB_DEF b32 gb_file_read_at (gbFile *file, void *buffer, isize size, i64 offset); +GB_DEF b32 gb_file_write_at (gbFile *file, void const *buffer, isize size, i64 offset); +GB_DEF i64 gb_file_seek (gbFile *file, i64 offset); +GB_DEF i64 gb_file_seek_to_end (gbFile *file); +GB_DEF i64 gb_file_skip (gbFile *file, i64 bytes); // NOTE(bill): Skips a certain amount of bytes +GB_DEF i64 gb_file_tell (gbFile *file); +GB_DEF gbFileError gb_file_close (gbFile *file); +GB_DEF b32 gb_file_read (gbFile *file, void *buffer, isize size); +GB_DEF b32 gb_file_write (gbFile *file, void const *buffer, isize size); +GB_DEF i64 gb_file_size (gbFile *file); +GB_DEF char const *gb_file_name (gbFile *file); +GB_DEF gbFileError gb_file_truncate (gbFile *file, i64 size); +GB_DEF b32 gb_file_has_changed (gbFile *file); // NOTE(bill): Changed since lasted checked +// TODO(bill): +// gbFileError gb_file_temp(gbFile *file); +// + +typedef struct gbFileContents { + gbAllocator allocator; + void * data; + isize size; +} gbFileContents; + + +GB_DEF gbFileContents gb_file_read_contents(gbAllocator a, b32 zero_terminate, char const *filepath); +GB_DEF void gb_file_free_contents(gbFileContents *fc); + + +// TODO(bill): Should these have different na,es as they do not take in a gbFile * ??? +GB_DEF b32 gb_file_exists (char const *filepath); +GB_DEF gbFileTime gb_file_last_write_time(char const *filepath); +GB_DEF b32 gb_file_copy (char const *existing_filename, char const *new_filename, b32 fail_if_exists); +GB_DEF b32 gb_file_move (char const *existing_filename, char const *new_filename); +GB_DEF b32 gb_file_remove (char const *filename); + + +#ifndef GB_PATH_SEPARATOR + #if defined(GB_SYSTEM_WINDOWS) + #define GB_PATH_SEPARATOR '\\' + #else + #define GB_PATH_SEPARATOR '/' + #endif +#endif + +GB_DEF b32 gb_path_is_absolute (char const *path); +GB_DEF b32 gb_path_is_relative (char const *path); +GB_DEF b32 gb_path_is_root (char const *path); +GB_DEF char const *gb_path_base_name (char const *path); +GB_DEF char const *gb_path_extension (char const *path); +GB_DEF char * gb_path_get_full_name(gbAllocator a, char const *path); + + +//////////////////////////////////////////////////////////////// +// +// Printing +// +// + +GB_DEF isize gb_printf (char const *fmt, ...) GB_PRINTF_ARGS(1); +GB_DEF isize gb_printf_va (char const *fmt, va_list va); +GB_DEF isize gb_printf_err (char const *fmt, ...) GB_PRINTF_ARGS(1); +GB_DEF isize gb_printf_err_va (char const *fmt, va_list va); +GB_DEF isize gb_fprintf (gbFile *f, char const *fmt, ...) GB_PRINTF_ARGS(2); +GB_DEF isize gb_fprintf_va (gbFile *f, char const *fmt, va_list va); + +GB_DEF char *gb_bprintf (char const *fmt, ...) GB_PRINTF_ARGS(1); // NOTE(bill): A locally persisting buffer is used internally +GB_DEF char *gb_bprintf_va (char const *fmt, va_list va); // NOTE(bill): A locally persisting buffer is used internally +GB_DEF isize gb_snprintf (char *str, isize n, char const *fmt, ...) GB_PRINTF_ARGS(3); +GB_DEF isize gb_snprintf_va(char *str, isize n, char const *fmt, va_list va); + +//////////////////////////////////////////////////////////////// +// +// DLL Handling +// +// + +typedef void *gbDllHandle; +typedef void (*gbDllProc)(void); + +GB_DEF gbDllHandle gb_dll_load (char const *filepath); +GB_DEF void gb_dll_unload (gbDllHandle dll); +GB_DEF gbDllProc gb_dll_proc_address(gbDllHandle dll, char const *proc_name); + + +//////////////////////////////////////////////////////////////// +// +// Time +// +// + +GB_DEF u64 gb_rdtsc (void); +GB_DEF f64 gb_time_now (void); // NOTE(bill): This is only for relative time e.g. game loops +GB_DEF u64 gb_utc_time_now(void); // NOTE(bill): Number of microseconds since 1601-01-01 UTC +GB_DEF void gb_sleep_ms (u32 ms); + + +//////////////////////////////////////////////////////////////// +// +// Miscellany +// +// + +typedef struct gbRandom { + u32 offsets[8]; + u32 value; +} gbRandom; + +// NOTE(bill): Generates from numerous sources to produce a decent pseudo-random seed +GB_DEF void gb_random_init (gbRandom *r); +GB_DEF u32 gb_random_gen_u32 (gbRandom *r); +GB_DEF u32 gb_random_gen_u32_unique(gbRandom *r); +GB_DEF u64 gb_random_gen_u64 (gbRandom *r); // NOTE(bill): (gb_random_gen_u32() << 32) | gb_random_gen_u32() +GB_DEF isize gb_random_gen_isize (gbRandom *r); +GB_DEF i64 gb_random_range_i64 (gbRandom *r, i64 lower_inc, i64 higher_inc); +GB_DEF isize gb_random_range_isize (gbRandom *r, isize lower_inc, isize higher_inc); +GB_DEF f64 gb_random_range_f64 (gbRandom *r, f64 lower_inc, f64 higher_inc); + + + + +GB_DEF void gb_exit (u32 code); +GB_DEF void gb_yield (void); +GB_DEF void gb_set_env (char const *name, char const *value); +GB_DEF void gb_unset_env(char const *name); + +GB_DEF u16 gb_endian_swap16(u16 i); +GB_DEF u32 gb_endian_swap32(u32 i); +GB_DEF u64 gb_endian_swap64(u64 i); + +GB_DEF isize gb_count_set_bits(u64 mask); + +//////////////////////////////////////////////////////////////// +// +// Platform Stuff +// +// + +#if defined(GB_PLATFORM) + +// NOTE(bill): +// Coordiate system - +ve x - left to right +// - +ve y - bottom to top +// - Relative to window + +// TODO(bill): Proper documentation for this with code examples + +// Window Support - Complete +// OS X Support - Missing: +// * Sofware framebuffer +// * (show|hide) window +// * show_cursor +// * toggle (fullscreen|borderless) +// * set window position +// * Clipboard +// * GameControllers +// Linux Support - None +// Other OS Support - None + +#ifndef GB_MAX_GAME_CONTROLLER_COUNT +#define GB_MAX_GAME_CONTROLLER_COUNT 4 +#endif + +typedef enum gbKeyType { + gbKey_Unknown = 0, // Unhandled key + + // NOTE(bill): Allow the basic printable keys to be aliased with their chars + gbKey_0 = '0', + gbKey_1, + gbKey_2, + gbKey_3, + gbKey_4, + gbKey_5, + gbKey_6, + gbKey_7, + gbKey_8, + gbKey_9, + + gbKey_A = 'A', + gbKey_B, + gbKey_C, + gbKey_D, + gbKey_E, + gbKey_F, + gbKey_G, + gbKey_H, + gbKey_I, + gbKey_J, + gbKey_K, + gbKey_L, + gbKey_M, + gbKey_N, + gbKey_O, + gbKey_P, + gbKey_Q, + gbKey_R, + gbKey_S, + gbKey_T, + gbKey_U, + gbKey_V, + gbKey_W, + gbKey_X, + gbKey_Y, + gbKey_Z, + + gbKey_Lbracket = '[', + gbKey_Rbracket = ']', + gbKey_Semicolon = ';', + gbKey_Comma = ',', + gbKey_Period = '.', + gbKey_Quote = '\'', + gbKey_Slash = '/', + gbKey_Backslash = '\\', + gbKey_Grave = '`', + gbKey_Equals = '=', + gbKey_Minus = '-', + gbKey_Space = ' ', + + gbKey__Pad = 128, // NOTE(bill): make sure ASCII is reserved + + gbKey_Escape, // Escape + gbKey_Lcontrol, // Left Control + gbKey_Lshift, // Left Shift + gbKey_Lalt, // Left Alt + gbKey_Lsystem, // Left OS specific: window (Windows and Linux), apple/cmd (MacOS X), ... + gbKey_Rcontrol, // Right Control + gbKey_Rshift, // Right Shift + gbKey_Ralt, // Right Alt + gbKey_Rsystem, // Right OS specific: window (Windows and Linux), apple/cmd (MacOS X), ... + gbKey_Menu, // Menu + gbKey_Return, // Return + gbKey_Backspace, // Backspace + gbKey_Tab, // Tabulation + gbKey_Pageup, // Page up + gbKey_Pagedown, // Page down + gbKey_End, // End + gbKey_Home, // Home + gbKey_Insert, // Insert + gbKey_Delete, // Delete + gbKey_Plus, // + + gbKey_Subtract, // - + gbKey_Multiply, // * + gbKey_Divide, // / + gbKey_Left, // Left arrow + gbKey_Right, // Right arrow + gbKey_Up, // Up arrow + gbKey_Down, // Down arrow + gbKey_Numpad0, // Numpad 0 + gbKey_Numpad1, // Numpad 1 + gbKey_Numpad2, // Numpad 2 + gbKey_Numpad3, // Numpad 3 + gbKey_Numpad4, // Numpad 4 + gbKey_Numpad5, // Numpad 5 + gbKey_Numpad6, // Numpad 6 + gbKey_Numpad7, // Numpad 7 + gbKey_Numpad8, // Numpad 8 + gbKey_Numpad9, // Numpad 9 + gbKey_NumpadDot, // Numpad . + gbKey_NumpadEnter, // Numpad Enter + gbKey_F1, // F1 + gbKey_F2, // F2 + gbKey_F3, // F3 + gbKey_F4, // F4 + gbKey_F5, // F5 + gbKey_F6, // F6 + gbKey_F7, // F7 + gbKey_F8, // F8 + gbKey_F9, // F8 + gbKey_F10, // F10 + gbKey_F11, // F11 + gbKey_F12, // F12 + gbKey_F13, // F13 + gbKey_F14, // F14 + gbKey_F15, // F15 + gbKey_Pause, // Pause + + gbKey_Count, +} gbKeyType; + +/* TODO(bill): Change name? */ +typedef u8 gbKeyState; +typedef enum gbKeyStateFlag { + gbKeyState_Down = GB_BIT(0), + gbKeyState_Pressed = GB_BIT(1), + gbKeyState_Released = GB_BIT(2) +} gbKeyStateFlag; + +GB_DEF void gb_key_state_update(gbKeyState *s, b32 is_down); + +typedef enum gbMouseButtonType { + gbMouseButton_Left, + gbMouseButton_Middle, + gbMouseButton_Right, + gbMouseButton_X1, + gbMouseButton_X2, + + gbMouseButton_Count +} gbMouseButtonType; + +typedef enum gbControllerAxisType { + gbControllerAxis_LeftX, + gbControllerAxis_LeftY, + gbControllerAxis_RightX, + gbControllerAxis_RightY, + gbControllerAxis_LeftTrigger, + gbControllerAxis_RightTrigger, + + gbControllerAxis_Count +} gbControllerAxisType; + +typedef enum gbControllerButtonType { + gbControllerButton_Up, + gbControllerButton_Down, + gbControllerButton_Left, + gbControllerButton_Right, + gbControllerButton_A, + gbControllerButton_B, + gbControllerButton_X, + gbControllerButton_Y, + gbControllerButton_LeftShoulder, + gbControllerButton_RightShoulder, + gbControllerButton_Back, + gbControllerButton_Start, + gbControllerButton_LeftThumb, + gbControllerButton_RightThumb, + + gbControllerButton_Count +} gbControllerButtonType; + +typedef struct gbGameController { + b16 is_connected, is_analog; + + f32 axes[gbControllerAxis_Count]; + gbKeyState buttons[gbControllerButton_Count]; +} gbGameController; + +#if defined(GB_SYSTEM_WINDOWS) + typedef struct _XINPUT_GAMEPAD XINPUT_GAMEPAD; + typedef struct _XINPUT_STATE XINPUT_STATE; + typedef struct _XINPUT_VIBRATION XINPUT_VIBRATION; + + #define GB_XINPUT_GET_STATE(name) unsigned long __stdcall name(unsigned long dwUserIndex, XINPUT_STATE *pState) + typedef GB_XINPUT_GET_STATE(gbXInputGetStateProc); + + #define GB_XINPUT_SET_STATE(name) unsigned long __stdcall name(unsigned long dwUserIndex, XINPUT_VIBRATION *pVibration) + typedef GB_XINPUT_SET_STATE(gbXInputSetStateProc); +#endif + + +typedef enum gbWindowFlag { + gbWindow_Fullscreen = GB_BIT(0), + gbWindow_Hidden = GB_BIT(1), + gbWindow_Borderless = GB_BIT(2), + gbWindow_Resizable = GB_BIT(3), + gbWindow_Minimized = GB_BIT(4), + gbWindow_Maximized = GB_BIT(5), + gbWindow_FullscreenDesktop = gbWindow_Fullscreen | gbWindow_Borderless, +} gbWindowFlag; + +typedef enum gbRendererType { + gbRenderer_Opengl, + gbRenderer_Software, + + gbRenderer_Count, +} gbRendererType; + + + +#if defined(GB_SYSTEM_WINDOWS) && !defined(_WINDOWS_) +typedef struct tagBITMAPINFOHEADER { + unsigned long biSize; + long biWidth; + long biHeight; + u16 biPlanes; + u16 biBitCount; + unsigned long biCompression; + unsigned long biSizeImage; + long biXPelsPerMeter; + long biYPelsPerMeter; + unsigned long biClrUsed; + unsigned long biClrImportant; +} BITMAPINFOHEADER, *PBITMAPINFOHEADER; +typedef struct tagRGBQUAD { + u8 rgbBlue; + u8 rgbGreen; + u8 rgbRed; + u8 rgbReserved; +} RGBQUAD; +typedef struct tagBITMAPINFO { + BITMAPINFOHEADER bmiHeader; + RGBQUAD bmiColors[1]; +} BITMAPINFO, *PBITMAPINFO; +#endif + +typedef struct gbPlatform { + b32 is_initialized; + + void *window_handle; + i32 window_x, window_y; + i32 window_width, window_height; + u32 window_flags; + b16 window_is_closed, window_has_focus; + +#if defined(GB_SYSTEM_WINDOWS) + void *win32_dc; +#elif defined(GB_SYSTEM_OSX) + void *osx_autorelease_pool; // TODO(bill): Is this really needed? +#endif + + gbRendererType renderer_type; + union { + struct { + void * context; + i32 major; + i32 minor; + b16 core, compatible; + gbDllHandle dll_handle; + } opengl; + + // NOTE(bill): Software rendering + struct { +#if defined(GB_SYSTEM_WINDOWS) + BITMAPINFO win32_bmi; +#endif + void * memory; + isize memory_size; + i32 pitch; + i32 bits_per_pixel; + } sw_framebuffer; + }; + + gbKeyState keys[gbKey_Count]; + struct { + gbKeyState control; + gbKeyState alt; + gbKeyState shift; + } key_modifiers; + + Rune char_buffer[256]; + isize char_buffer_count; + + b32 mouse_clip; + i32 mouse_x, mouse_y; + i32 mouse_dx, mouse_dy; // NOTE(bill): Not raw mouse movement + i32 mouse_raw_dx, mouse_raw_dy; // NOTE(bill): Raw mouse movement + f32 mouse_wheel_delta; + gbKeyState mouse_buttons[gbMouseButton_Count]; + + gbGameController game_controllers[GB_MAX_GAME_CONTROLLER_COUNT]; + + f64 curr_time; + f64 dt_for_frame; + b32 quit_requested; + +#if defined(GB_SYSTEM_WINDOWS) + struct { + gbXInputGetStateProc *get_state; + gbXInputSetStateProc *set_state; + } xinput; +#endif +} gbPlatform; + + +typedef struct gbVideoMode { + i32 width, height; + i32 bits_per_pixel; +} gbVideoMode; + +GB_DEF gbVideoMode gb_video_mode (i32 width, i32 height, i32 bits_per_pixel); +GB_DEF b32 gb_video_mode_is_valid (gbVideoMode mode); +GB_DEF gbVideoMode gb_video_mode_get_desktop (void); +GB_DEF isize gb_video_mode_get_fullscreen_modes(gbVideoMode *modes, isize max_mode_count); // NOTE(bill): returns mode count +GB_DEF GB_COMPARE_PROC(gb_video_mode_cmp); // NOTE(bill): Sort smallest to largest (Ascending) +GB_DEF GB_COMPARE_PROC(gb_video_mode_dsc_cmp); // NOTE(bill): Sort largest to smallest (Descending) + + +// NOTE(bill): Software rendering +GB_DEF b32 gb_platform_init_with_software (gbPlatform *p, char const *window_title, i32 width, i32 height, u32 window_flags); +// NOTE(bill): OpenGL Rendering +GB_DEF b32 gb_platform_init_with_opengl (gbPlatform *p, char const *window_title, i32 width, i32 height, u32 window_flags, i32 major, i32 minor, b32 core, b32 compatible); +GB_DEF void gb_platform_update (gbPlatform *p); +GB_DEF void gb_platform_display (gbPlatform *p); +GB_DEF void gb_platform_destroy (gbPlatform *p); +GB_DEF void gb_platform_show_cursor (gbPlatform *p, b32 show); +GB_DEF void gb_platform_set_mouse_position (gbPlatform *p, i32 x, i32 y); +GB_DEF void gb_platform_set_controller_vibration (gbPlatform *p, isize index, f32 left_motor, f32 right_motor); +GB_DEF b32 gb_platform_has_clipboard_text (gbPlatform *p); +GB_DEF void gb_platform_set_clipboard_text (gbPlatform *p, char const *str); +GB_DEF char *gb_platform_get_clipboard_text (gbPlatform *p, gbAllocator a); +GB_DEF void gb_platform_set_window_position (gbPlatform *p, i32 x, i32 y); +GB_DEF void gb_platform_set_window_title (gbPlatform *p, char const *title, ...) GB_PRINTF_ARGS(2); +GB_DEF void gb_platform_toggle_fullscreen (gbPlatform *p, b32 fullscreen_desktop); +GB_DEF void gb_platform_toggle_borderless (gbPlatform *p); +GB_DEF void gb_platform_make_opengl_context_current(gbPlatform *p); +GB_DEF void gb_platform_show_window (gbPlatform *p); +GB_DEF void gb_platform_hide_window (gbPlatform *p); + + +#endif // GB_PLATFORM + +#if defined(__cplusplus) +} +#endif + +#endif // GB_INCLUDE_GB_H + + + + + + +//////////////////////////////////////////////////////////////// +// +// +// +// +// +// +// +// +// +// +// +// +// +// +// +// +// +// +// +// +// +// +// Implementation +// +// +// +// +// +// +// +// +// +// +// +// +// +// +// +// +// +// +// +// +// +// It's turtles all the way down! +//////////////////////////////////////////////////////////////// +#if defined(GB_IMPLEMENTATION) && !defined(GB_IMPLEMENTATION_DONE) +#define GB_IMPLEMENTATION_DONE + +#if defined(__cplusplus) +extern "C" { +#endif + + +#if defined(GB_COMPILER_MSVC) && !defined(_WINDOWS_) + //////////////////////////////////////////////////////////////// + // + // Bill's Mini Windows.h + // + // + + #define WINAPI __stdcall + #define WINAPIV __cdecl + #define CALLBACK __stdcall + #define MAX_PATH 260 + #define CCHDEVICENAME 32 + #define CCHFORMNAME 32 + + typedef unsigned long DWORD; + typedef int WINBOOL; + #ifndef XFree86Server + #ifndef __OBJC__ + typedef WINBOOL BOOL; + #else + #define BOOL WINBOOL + #endif + typedef unsigned char BYTE; + #endif + typedef unsigned short WORD; + typedef float FLOAT; + typedef int INT; + typedef unsigned int UINT; + typedef short SHORT; + typedef long LONG; + typedef long long LONGLONG; + typedef unsigned short USHORT; + typedef unsigned long ULONG; + typedef unsigned long long ULONGLONG; + + typedef UINT WPARAM; + typedef LONG LPARAM; + typedef LONG LRESULT; + #ifndef _HRESULT_DEFINED + typedef LONG HRESULT; + #define _HRESULT_DEFINED + #endif + #ifndef XFree86Server + typedef WORD ATOM; + #endif /* XFree86Server */ + typedef void *HANDLE; + typedef HANDLE HGLOBAL; + typedef HANDLE HLOCAL; + typedef HANDLE GLOBALHANDLE; + typedef HANDLE LOCALHANDLE; + typedef void *HGDIOBJ; + + #define DECLARE_HANDLE(name) typedef HANDLE name + DECLARE_HANDLE(HACCEL); + DECLARE_HANDLE(HBITMAP); + DECLARE_HANDLE(HBRUSH); + DECLARE_HANDLE(HCOLORSPACE); + DECLARE_HANDLE(HDC); + DECLARE_HANDLE(HGLRC); + DECLARE_HANDLE(HDESK); + DECLARE_HANDLE(HENHMETAFILE); + DECLARE_HANDLE(HFONT); + DECLARE_HANDLE(HICON); + DECLARE_HANDLE(HKEY); + typedef HKEY *PHKEY; + DECLARE_HANDLE(HMENU); + DECLARE_HANDLE(HMETAFILE); + DECLARE_HANDLE(HINSTANCE); + typedef HINSTANCE HMODULE; + DECLARE_HANDLE(HPALETTE); + DECLARE_HANDLE(HPEN); + DECLARE_HANDLE(HRGN); + DECLARE_HANDLE(HRSRC); + DECLARE_HANDLE(HSTR); + DECLARE_HANDLE(HTASK); + DECLARE_HANDLE(HWND); + DECLARE_HANDLE(HWINSTA); + DECLARE_HANDLE(HKL); + DECLARE_HANDLE(HRAWINPUT); + DECLARE_HANDLE(HMONITOR); + #undef DECLARE_HANDLE + + typedef int HFILE; + typedef HICON HCURSOR; + typedef DWORD COLORREF; + typedef int (WINAPI *FARPROC)(); + typedef int (WINAPI *NEARPROC)(); + typedef int (WINAPI *PROC)(); + typedef LRESULT (CALLBACK *WNDPROC)(HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam); + + #if defined(_WIN64) + typedef unsigned __int64 ULONG_PTR; + typedef signed __int64 LONG_PTR; + #else + typedef unsigned long ULONG_PTR; + typedef signed long LONG_PTR; + #endif + typedef ULONG_PTR DWORD_PTR; + + typedef struct tagRECT { + LONG left; + LONG top; + LONG right; + LONG bottom; + } RECT; + typedef struct tagRECTL { + LONG left; + LONG top; + LONG right; + LONG bottom; + } RECTL; + typedef struct tagPOINT { + LONG x; + LONG y; + } POINT; + typedef struct tagSIZE { + LONG cx; + LONG cy; + } SIZE; + typedef struct tagPOINTS { + SHORT x; + SHORT y; + } POINTS; + typedef struct _SECURITY_ATTRIBUTES { + DWORD nLength; + HANDLE lpSecurityDescriptor; + BOOL bInheritHandle; + } SECURITY_ATTRIBUTES; + typedef enum _LOGICAL_PROCESSOR_RELATIONSHIP { + RelationProcessorCore, + RelationNumaNode, + RelationCache, + RelationProcessorPackage, + RelationGroup, + RelationAll = 0xffff + } LOGICAL_PROCESSOR_RELATIONSHIP; + typedef enum _PROCESSOR_CACHE_TYPE { + CacheUnified, + CacheInstruction, + CacheData, + CacheTrace + } PROCESSOR_CACHE_TYPE; + typedef struct _CACHE_DESCRIPTOR { + BYTE Level; + BYTE Associativity; + WORD LineSize; + DWORD Size; + PROCESSOR_CACHE_TYPE Type; + } CACHE_DESCRIPTOR; + typedef struct _SYSTEM_LOGICAL_PROCESSOR_INFORMATION { + ULONG_PTR ProcessorMask; + LOGICAL_PROCESSOR_RELATIONSHIP Relationship; + union { + struct { + BYTE Flags; + } ProcessorCore; + struct { + DWORD NodeNumber; + } NumaNode; + CACHE_DESCRIPTOR Cache; + ULONGLONG Reserved[2]; + }; + } SYSTEM_LOGICAL_PROCESSOR_INFORMATION; + typedef struct _MEMORY_BASIC_INFORMATION { + void *BaseAddress; + void *AllocationBase; + DWORD AllocationProtect; + usize RegionSize; + DWORD State; + DWORD Protect; + DWORD Type; + } MEMORY_BASIC_INFORMATION; + typedef struct _SYSTEM_INFO { + union { + DWORD dwOemId; + struct { + WORD wProcessorArchitecture; + WORD wReserved; + }; + }; + DWORD dwPageSize; + void * lpMinimumApplicationAddress; + void * lpMaximumApplicationAddress; + DWORD_PTR dwActiveProcessorMask; + DWORD dwNumberOfProcessors; + DWORD dwProcessorType; + DWORD dwAllocationGranularity; + WORD wProcessorLevel; + WORD wProcessorRevision; + } SYSTEM_INFO; + typedef union _LARGE_INTEGER { + struct { + DWORD LowPart; + LONG HighPart; + }; + struct { + DWORD LowPart; + LONG HighPart; + } u; + LONGLONG QuadPart; + } LARGE_INTEGER; + typedef union _ULARGE_INTEGER { + struct { + DWORD LowPart; + DWORD HighPart; + }; + struct { + DWORD LowPart; + DWORD HighPart; + } u; + ULONGLONG QuadPart; + } ULARGE_INTEGER; + + typedef struct _OVERLAPPED { + ULONG_PTR Internal; + ULONG_PTR InternalHigh; + union { + struct { + DWORD Offset; + DWORD OffsetHigh; + }; + void *Pointer; + }; + HANDLE hEvent; + } OVERLAPPED; + typedef struct _FILETIME { + DWORD dwLowDateTime; + DWORD dwHighDateTime; + } FILETIME; + typedef struct _WIN32_FIND_DATAW { + DWORD dwFileAttributes; + FILETIME ftCreationTime; + FILETIME ftLastAccessTime; + FILETIME ftLastWriteTime; + DWORD nFileSizeHigh; + DWORD nFileSizeLow; + DWORD dwReserved0; + DWORD dwReserved1; + wchar_t cFileName[MAX_PATH]; + wchar_t cAlternateFileName[14]; + } WIN32_FIND_DATAW; + typedef struct _WIN32_FILE_ATTRIBUTE_DATA { + DWORD dwFileAttributes; + FILETIME ftCreationTime; + FILETIME ftLastAccessTime; + FILETIME ftLastWriteTime; + DWORD nFileSizeHigh; + DWORD nFileSizeLow; + } WIN32_FILE_ATTRIBUTE_DATA; + typedef enum _GET_FILEEX_INFO_LEVELS { + GetFileExInfoStandard, + GetFileExMaxInfoLevel + } GET_FILEEX_INFO_LEVELS; + typedef struct tagRAWINPUTHEADER { + DWORD dwType; + DWORD dwSize; + HANDLE hDevice; + WPARAM wParam; + } RAWINPUTHEADER; + typedef struct tagRAWINPUTDEVICE { + USHORT usUsagePage; + USHORT usUsage; + DWORD dwFlags; + HWND hwndTarget; + } RAWINPUTDEVICE; + typedef struct tagRAWMOUSE { + WORD usFlags; + union { + ULONG ulButtons; + struct { + WORD usButtonFlags; + WORD usButtonData; + }; + }; + ULONG ulRawButtons; + LONG lLastX; + LONG lLastY; + ULONG ulExtraInformation; + } RAWMOUSE; + typedef struct tagRAWKEYBOARD { + WORD MakeCode; + WORD Flags; + WORD Reserved; + WORD VKey; + UINT Message; + ULONG ExtraInformation; + } RAWKEYBOARD; + typedef struct tagRAWHID { + DWORD dwSizeHid; + DWORD dwCount; + BYTE bRawData[1]; + } RAWHID; + typedef struct tagRAWINPUT { + RAWINPUTHEADER header; + union { + RAWMOUSE mouse; + RAWKEYBOARD keyboard; + RAWHID hid; + } data; + } RAWINPUT; + typedef struct tagWNDCLASSEXW { + UINT cbSize; + UINT style; + WNDPROC lpfnWndProc; + INT cbClsExtra; + INT cbWndExtra; + HINSTANCE hInstance; + HICON hIcon; + HCURSOR hCursor; + HANDLE hbrBackground; + wchar_t const *lpszMenuName; + wchar_t const *lpszClassName; + HICON hIconSm; + } WNDCLASSEXW; + typedef struct _POINTL { + LONG x; + LONG y; + } POINTL; + typedef struct _devicemodew { + wchar_t dmDeviceName[CCHDEVICENAME]; + WORD dmSpecVersion; + WORD dmDriverVersion; + WORD dmSize; + WORD dmDriverExtra; + DWORD dmFields; + union { + struct { + short dmOrientation; + short dmPaperSize; + short dmPaperLength; + short dmPaperWidth; + short dmScale; + short dmCopies; + short dmDefaultSource; + short dmPrintQuality; + }; + struct { + POINTL dmPosition; + DWORD dmDisplayOrientation; + DWORD dmDisplayFixedOutput; + }; + }; + short dmColor; + short dmDuplex; + short dmYResolution; + short dmTTOption; + short dmCollate; + wchar_t dmFormName[CCHFORMNAME]; + WORD dmLogPixels; + DWORD dmBitsPerPel; + DWORD dmPelsWidth; + DWORD dmPelsHeight; + union { + DWORD dmDisplayFlags; + DWORD dmNup; + }; + DWORD dmDisplayFrequency; + #if (WINVER >= 0x0400) + DWORD dmICMMethod; + DWORD dmICMIntent; + DWORD dmMediaType; + DWORD dmDitherType; + DWORD dmReserved1; + DWORD dmReserved2; + #if (WINVER >= 0x0500) || (_WIN32_WINNT >= 0x0400) + DWORD dmPanningWidth; + DWORD dmPanningHeight; + #endif + #endif + } DEVMODEW; + typedef struct tagPIXELFORMATDESCRIPTOR { + WORD nSize; + WORD nVersion; + DWORD dwFlags; + BYTE iPixelType; + BYTE cColorBits; + BYTE cRedBits; + BYTE cRedShift; + BYTE cGreenBits; + BYTE cGreenShift; + BYTE cBlueBits; + BYTE cBlueShift; + BYTE cAlphaBits; + BYTE cAlphaShift; + BYTE cAccumBits; + BYTE cAccumRedBits; + BYTE cAccumGreenBits; + BYTE cAccumBlueBits; + BYTE cAccumAlphaBits; + BYTE cDepthBits; + BYTE cStencilBits; + BYTE cAuxBuffers; + BYTE iLayerType; + BYTE bReserved; + DWORD dwLayerMask; + DWORD dwVisibleMask; + DWORD dwDamageMask; + } PIXELFORMATDESCRIPTOR; + typedef struct tagMSG { // msg + HWND hwnd; + UINT message; + WPARAM wParam; + LPARAM lParam; + DWORD time; + POINT pt; + } MSG; + typedef struct tagWINDOWPLACEMENT { + UINT length; + UINT flags; + UINT showCmd; + POINT ptMinPosition; + POINT ptMaxPosition; + RECT rcNormalPosition; + } WINDOWPLACEMENT; + typedef struct tagMONITORINFO { + DWORD cbSize; + RECT rcMonitor; + RECT rcWork; + DWORD dwFlags; + } MONITORINFO; + + #define INFINITE 0xffffffffl + #define INVALID_HANDLE_VALUE ((void *)(intptr)(-1)) + + + typedef DWORD WINAPI THREAD_START_ROUTINE(void *parameter); + + GB_DLL_IMPORT DWORD WINAPI GetLastError (void); + GB_DLL_IMPORT BOOL WINAPI CloseHandle (HANDLE object); + GB_DLL_IMPORT HANDLE WINAPI CreateSemaphoreA (SECURITY_ATTRIBUTES *semaphore_attributes, LONG initial_count, + LONG maximum_count, char const *name); + GB_DLL_IMPORT BOOL WINAPI ReleaseSemaphore (HANDLE semaphore, LONG release_count, LONG *previous_count); + GB_DLL_IMPORT DWORD WINAPI WaitForSingleObject(HANDLE handle, DWORD milliseconds); + GB_DLL_IMPORT HANDLE WINAPI CreateThread (SECURITY_ATTRIBUTES *semaphore_attributes, usize stack_size, + THREAD_START_ROUTINE *start_address, void *parameter, + DWORD creation_flags, DWORD *thread_id); + GB_DLL_IMPORT DWORD WINAPI GetThreadId (HANDLE handle); + GB_DLL_IMPORT void WINAPI RaiseException (DWORD, DWORD, DWORD, ULONG_PTR const *); + + + GB_DLL_IMPORT BOOL WINAPI GetLogicalProcessorInformation(SYSTEM_LOGICAL_PROCESSOR_INFORMATION *buffer, DWORD *return_length); + GB_DLL_IMPORT DWORD_PTR WINAPI SetThreadAffinityMask(HANDLE thread, DWORD_PTR check_mask); + GB_DLL_IMPORT HANDLE WINAPI GetCurrentThread(void); + + #define PAGE_NOACCESS 0x01 + #define PAGE_READONLY 0x02 + #define PAGE_READWRITE 0x04 + #define PAGE_WRITECOPY 0x08 + #define PAGE_EXECUTE 0x10 + #define PAGE_EXECUTE_READ 0x20 + #define PAGE_EXECUTE_READWRITE 0x40 + #define PAGE_EXECUTE_WRITECOPY 0x80 + #define PAGE_GUARD 0x100 + #define PAGE_NOCACHE 0x200 + #define PAGE_WRITECOMBINE 0x400 + + #define MEM_COMMIT 0x1000 + #define MEM_RESERVE 0x2000 + #define MEM_DECOMMIT 0x4000 + #define MEM_RELEASE 0x8000 + #define MEM_FREE 0x10000 + #define MEM_PRIVATE 0x20000 + #define MEM_MAPPED 0x40000 + #define MEM_RESET 0x80000 + #define MEM_TOP_DOWN 0x100000 + #define MEM_LARGE_PAGES 0x20000000 + #define MEM_4MB_PAGES 0x80000000 + + + + + GB_DLL_IMPORT void * WINAPI VirtualAlloc (void *addr, usize size, DWORD allocation_type, DWORD protect); + GB_DLL_IMPORT usize WINAPI VirtualQuery (void const *address, MEMORY_BASIC_INFORMATION *buffer, usize length); + GB_DLL_IMPORT BOOL WINAPI VirtualFree (void *address, usize size, DWORD free_type); + GB_DLL_IMPORT void WINAPI GetSystemInfo(SYSTEM_INFO *system_info); + + + #ifndef VK_UNKNOWN + #define VK_UNKNOWN 0 + #define VK_LBUTTON 0x01 + #define VK_RBUTTON 0x02 + #define VK_CANCEL 0x03 + #define VK_MBUTTON 0x04 + #define VK_XBUTTON1 0x05 + #define VK_XBUTTON2 0x06 + #define VK_BACK 0x08 + #define VK_TAB 0x09 + #define VK_CLEAR 0x0C + #define VK_RETURN 0x0D + #define VK_SHIFT 0x10 + #define VK_CONTROL 0x11 // CTRL key + #define VK_MENU 0x12 // ALT key + #define VK_PAUSE 0x13 // PAUSE key + #define VK_CAPITAL 0x14 // CAPS LOCK key + #define VK_KANA 0x15 // Input Method Editor (IME) Kana mode + #define VK_HANGUL 0x15 // IME Hangul mode + #define VK_JUNJA 0x17 // IME Junja mode + #define VK_FINAL 0x18 // IME final mode + #define VK_HANJA 0x19 // IME Hanja mode + #define VK_KANJI 0x19 // IME Kanji mode + #define VK_ESCAPE 0x1B // ESC key + #define VK_CONVERT 0x1C // IME convert + #define VK_NONCONVERT 0x1D // IME nonconvert + #define VK_ACCEPT 0x1E // IME accept + #define VK_MODECHANGE 0x1F // IME mode change request + #define VK_SPACE 0x20 // SPACE key + #define VK_PRIOR 0x21 // PAGE UP key + #define VK_NEXT 0x22 // PAGE DOWN key + #define VK_END 0x23 // END key + #define VK_HOME 0x24 // HOME key + #define VK_LEFT 0x25 // LEFT ARROW key + #define VK_UP 0x26 // UP ARROW key + #define VK_RIGHT 0x27 // RIGHT ARROW key + #define VK_DOWN 0x28 // DOWN ARROW key + #define VK_SELECT 0x29 // SELECT key + #define VK_PRINT 0x2A // PRINT key + #define VK_EXECUTE 0x2B // EXECUTE key + #define VK_SNAPSHOT 0x2C // PRINT SCREEN key + #define VK_INSERT 0x2D // INS key + #define VK_DELETE 0x2E // DEL key + #define VK_HELP 0x2F // HELP key + #define VK_0 0x30 + #define VK_1 0x31 + #define VK_2 0x32 + #define VK_3 0x33 + #define VK_4 0x34 + #define VK_5 0x35 + #define VK_6 0x36 + #define VK_7 0x37 + #define VK_8 0x38 + #define VK_9 0x39 + #define VK_A 0x41 + #define VK_B 0x42 + #define VK_C 0x43 + #define VK_D 0x44 + #define VK_E 0x45 + #define VK_F 0x46 + #define VK_G 0x47 + #define VK_H 0x48 + #define VK_I 0x49 + #define VK_J 0x4A + #define VK_K 0x4B + #define VK_L 0x4C + #define VK_M 0x4D + #define VK_N 0x4E + #define VK_O 0x4F + #define VK_P 0x50 + #define VK_Q 0x51 + #define VK_R 0x52 + #define VK_S 0x53 + #define VK_T 0x54 + #define VK_U 0x55 + #define VK_V 0x56 + #define VK_W 0x57 + #define VK_X 0x58 + #define VK_Y 0x59 + #define VK_Z 0x5A + #define VK_LWIN 0x5B // Left Windows key (Microsoft Natural keyboard) + #define VK_RWIN 0x5C // Right Windows key (Natural keyboard) + #define VK_APPS 0x5D // Applications key (Natural keyboard) + #define VK_SLEEP 0x5F // Computer Sleep key + // Num pad keys + #define VK_NUMPAD0 0x60 + #define VK_NUMPAD1 0x61 + #define VK_NUMPAD2 0x62 + #define VK_NUMPAD3 0x63 + #define VK_NUMPAD4 0x64 + #define VK_NUMPAD5 0x65 + #define VK_NUMPAD6 0x66 + #define VK_NUMPAD7 0x67 + #define VK_NUMPAD8 0x68 + #define VK_NUMPAD9 0x69 + #define VK_MULTIPLY 0x6A + #define VK_ADD 0x6B + #define VK_SEPARATOR 0x6C + #define VK_SUBTRACT 0x6D + #define VK_DECIMAL 0x6E + #define VK_DIVIDE 0x6F + #define VK_F1 0x70 + #define VK_F2 0x71 + #define VK_F3 0x72 + #define VK_F4 0x73 + #define VK_F5 0x74 + #define VK_F6 0x75 + #define VK_F7 0x76 + #define VK_F8 0x77 + #define VK_F9 0x78 + #define VK_F10 0x79 + #define VK_F11 0x7A + #define VK_F12 0x7B + #define VK_F13 0x7C + #define VK_F14 0x7D + #define VK_F15 0x7E + #define VK_F16 0x7F + #define VK_F17 0x80 + #define VK_F18 0x81 + #define VK_F19 0x82 + #define VK_F20 0x83 + #define VK_F21 0x84 + #define VK_F22 0x85 + #define VK_F23 0x86 + #define VK_F24 0x87 + #define VK_NUMLOCK 0x90 + #define VK_SCROLL 0x91 + #define VK_LSHIFT 0xA0 + #define VK_RSHIFT 0xA1 + #define VK_LCONTROL 0xA2 + #define VK_RCONTROL 0xA3 + #define VK_LMENU 0xA4 + #define VK_RMENU 0xA5 + #define VK_BROWSER_BACK 0xA6 // Windows 2000/XP: Browser Back key + #define VK_BROWSER_FORWARD 0xA7 // Windows 2000/XP: Browser Forward key + #define VK_BROWSER_REFRESH 0xA8 // Windows 2000/XP: Browser Refresh key + #define VK_BROWSER_STOP 0xA9 // Windows 2000/XP: Browser Stop key + #define VK_BROWSER_SEARCH 0xAA // Windows 2000/XP: Browser Search key + #define VK_BROWSER_FAVORITES 0xAB // Windows 2000/XP: Browser Favorites key + #define VK_BROWSER_HOME 0xAC // Windows 2000/XP: Browser Start and Home key + #define VK_VOLUME_MUTE 0xAD // Windows 2000/XP: Volume Mute key + #define VK_VOLUME_DOWN 0xAE // Windows 2000/XP: Volume Down key + #define VK_VOLUME_UP 0xAF // Windows 2000/XP: Volume Up key + #define VK_MEDIA_NEXT_TRACK 0xB0 // Windows 2000/XP: Next Track key + #define VK_MEDIA_PREV_TRACK 0xB1 // Windows 2000/XP: Previous Track key + #define VK_MEDIA_STOP 0xB2 // Windows 2000/XP: Stop Media key + #define VK_MEDIA_PLAY_PAUSE 0xB3 // Windows 2000/XP: Play/Pause Media key + #define VK_MEDIA_LAUNCH_MAIL 0xB4 // Windows 2000/XP: Start Mail key + #define VK_MEDIA_LAUNCH_MEDIA_SELECT 0xB5 // Windows 2000/XP: Select Media key + #define VK_MEDIA_LAUNCH_APP1 0xB6 // VK_LAUNCH_APP1 (B6) Windows 2000/XP: Start Application 1 key + #define VK_MEDIA_LAUNCH_APP2 0xB7 // VK_LAUNCH_APP2 (B7) Windows 2000/XP: Start Application 2 key + #define VK_OEM_1 0xBA + #define VK_OEM_PLUS 0xBB + #define VK_OEM_COMMA 0xBC + #define VK_OEM_MINUS 0xBD + #define VK_OEM_PERIOD 0xBE + #define VK_OEM_2 0xBF + #define VK_OEM_3 0xC0 + #define VK_OEM_4 0xDB + #define VK_OEM_5 0xDC + #define VK_OEM_6 0xDD + #define VK_OEM_7 0xDE + #define VK_OEM_8 0xDF + #define VK_OEM_102 0xE2 + #define VK_PROCESSKEY 0xE5 + #define VK_PACKET 0xE7 + #define VK_ATTN 0xF6 // Attn key + #define VK_CRSEL 0xF7 // CrSel key + #define VK_EXSEL 0xF8 // ExSel key + #define VK_EREOF 0xF9 // Erase EOF key + #define VK_PLAY 0xFA // Play key + #define VK_ZOOM 0xFB // Zoom key + #define VK_NONAME 0xFC // Reserved for future use + #define VK_PA1 0xFD // VK_PA1 (FD) PA1 key + #define VK_OEM_CLEAR 0xFE // Clear key + #endif // VK_UNKNOWN + + + + #define GENERIC_READ 0x80000000 + #define GENERIC_WRITE 0x40000000 + #define GENERIC_EXECUTE 0x20000000 + #define GENERIC_ALL 0x10000000 + #define FILE_SHARE_READ 0x00000001 + #define FILE_SHARE_WRITE 0x00000002 + #define FILE_SHARE_DELETE 0x00000004 + #define CREATE_NEW 1 + #define CREATE_ALWAYS 2 + #define OPEN_EXISTING 3 + #define OPEN_ALWAYS 4 + #define TRUNCATE_EXISTING 5 + #define FILE_ATTRIBUTE_READONLY 0x00000001 + #define FILE_ATTRIBUTE_NORMAL 0x00000080 + #define FILE_ATTRIBUTE_TEMPORARY 0x00000100 + #define ERROR_FILE_NOT_FOUND 2l + #define ERROR_ACCESS_DENIED 5L + #define ERROR_NO_MORE_FILES 18l + #define ERROR_FILE_EXISTS 80l + #define ERROR_ALREADY_EXISTS 183l + #define STD_INPUT_HANDLE ((DWORD)-10) + #define STD_OUTPUT_HANDLE ((DWORD)-11) + #define STD_ERROR_HANDLE ((DWORD)-12) + + GB_DLL_IMPORT int MultiByteToWideChar(UINT code_page, DWORD flags, char const * multi_byte_str, int multi_byte_len, wchar_t const *wide_char_str, int wide_char_len); + GB_DLL_IMPORT int WideCharToMultiByte(UINT code_page, DWORD flags, wchar_t const *wide_char_str, int wide_char_len, char const * multi_byte_str, int multi_byte_len); + GB_DLL_IMPORT BOOL WINAPI SetFilePointerEx(HANDLE file, LARGE_INTEGER distance_to_move, + LARGE_INTEGER *new_file_pointer, DWORD move_method); + GB_DLL_IMPORT BOOL WINAPI ReadFile (HANDLE file, void *buffer, DWORD bytes_to_read, DWORD *bytes_read, OVERLAPPED *overlapped); + GB_DLL_IMPORT BOOL WINAPI WriteFile (HANDLE file, void const *buffer, DWORD bytes_to_write, DWORD *bytes_written, OVERLAPPED *overlapped); + GB_DLL_IMPORT HANDLE WINAPI CreateFileW (wchar_t const *path, DWORD desired_access, DWORD share_mode, + SECURITY_ATTRIBUTES *, DWORD creation_disposition, + DWORD flags_and_attributes, HANDLE template_file); + GB_DLL_IMPORT HANDLE WINAPI GetStdHandle (DWORD std_handle); + GB_DLL_IMPORT BOOL WINAPI GetFileSizeEx (HANDLE file, LARGE_INTEGER *size); + GB_DLL_IMPORT BOOL WINAPI SetEndOfFile (HANDLE file); + GB_DLL_IMPORT HANDLE WINAPI FindFirstFileW (wchar_t const *path, WIN32_FIND_DATAW *data); + GB_DLL_IMPORT BOOL WINAPI FindClose (HANDLE find_file); + GB_DLL_IMPORT BOOL WINAPI GetFileAttributesExW(wchar_t const *path, GET_FILEEX_INFO_LEVELS info_level_id, WIN32_FILE_ATTRIBUTE_DATA *data); + GB_DLL_IMPORT BOOL WINAPI CopyFileW(wchar_t const *old_f, wchar_t const *new_f, BOOL fail_if_exists); + GB_DLL_IMPORT BOOL WINAPI MoveFileW(wchar_t const *old_f, wchar_t const *new_f); + + GB_DLL_IMPORT HMODULE WINAPI LoadLibraryA (char const *filename); + GB_DLL_IMPORT BOOL WINAPI FreeLibrary (HMODULE module); + GB_DLL_IMPORT FARPROC WINAPI GetProcAddress(HMODULE module, char const *name); + + GB_DLL_IMPORT BOOL WINAPI QueryPerformanceFrequency(LARGE_INTEGER *frequency); + GB_DLL_IMPORT BOOL WINAPI QueryPerformanceCounter (LARGE_INTEGER *counter); + GB_DLL_IMPORT void WINAPI GetSystemTimeAsFileTime (FILETIME *system_time_as_file_time); + GB_DLL_IMPORT void WINAPI Sleep(DWORD milliseconds); + GB_DLL_IMPORT void WINAPI ExitProcess(UINT exit_code); + + GB_DLL_IMPORT BOOL WINAPI SetEnvironmentVariableA(char const *name, char const *value); + + + #define WM_NULL 0x0000 + #define WM_CREATE 0x0001 + #define WM_DESTROY 0x0002 + #define WM_MOVE 0x0003 + #define WM_SIZE 0x0005 + #define WM_ACTIVATE 0x0006 + #define WM_SETFOCUS 0x0007 + #define WM_KILLFOCUS 0x0008 + #define WM_ENABLE 0x000A + #define WM_SETREDRAW 0x000B + #define WM_SETTEXT 0x000C + #define WM_GETTEXT 0x000D + #define WM_GETTEXTLENGTH 0x000E + #define WM_PAINT 0x000F + #define WM_CLOSE 0x0010 + #define WM_QUERYENDSESSION 0x0011 + #define WM_QUERYOPEN 0x0013 + #define WM_ENDSESSION 0x0016 + #define WM_QUIT 0x0012 + #define WM_ERASEBKGND 0x0014 + #define WM_SYSCOLORCHANGE 0x0015 + #define WM_SHOWWINDOW 0x0018 + #define WM_WININICHANGE 0x001A + #define WM_SETTINGCHANGE WM_WININICHANGE + #define WM_DEVMODECHANGE 0x001B + #define WM_ACTIVATEAPP 0x001C + #define WM_FONTCHANGE 0x001D + #define WM_TIMECHANGE 0x001E + #define WM_CANCELMODE 0x001F + #define WM_SETCURSOR 0x0020 + #define WM_MOUSEACTIVATE 0x0021 + #define WM_CHILDACTIVATE 0x0022 + #define WM_QUEUESYNC 0x0023 + #define WM_GETMINMAXINFO 0x0024 + #define WM_PAINTICON 0x0026 + #define WM_ICONERASEBKGND 0x0027 + #define WM_NEXTDLGCTL 0x0028 + #define WM_SPOOLERSTATUS 0x002A + #define WM_DRAWITEM 0x002B + #define WM_MEASUREITEM 0x002C + #define WM_DELETEITEM 0x002D + #define WM_VKEYTOITEM 0x002E + #define WM_CHARTOITEM 0x002F + #define WM_SETFONT 0x0030 + #define WM_GETFONT 0x0031 + #define WM_SETHOTKEY 0x0032 + #define WM_GETHOTKEY 0x0033 + #define WM_QUERYDRAGICON 0x0037 + #define WM_COMPAREITEM 0x0039 + #define WM_GETOBJECT 0x003D + #define WM_COMPACTING 0x0041 + #define WM_COMMNOTIFY 0x0044 /* no longer suported */ + #define WM_WINDOWPOSCHANGING 0x0046 + #define WM_WINDOWPOSCHANGED 0x0047 + #define WM_POWER 0x0048 + #define WM_COPYDATA 0x004A + #define WM_CANCELJOURNAL 0x004B + #define WM_NOTIFY 0x004E + #define WM_INPUTLANGCHANGEREQUEST 0x0050 + #define WM_INPUTLANGCHANGE 0x0051 + #define WM_TCARD 0x0052 + #define WM_HELP 0x0053 + #define WM_USERCHANGED 0x0054 + #define WM_NOTIFYFORMAT 0x0055 + #define WM_CONTEXTMENU 0x007B + #define WM_STYLECHANGING 0x007C + #define WM_STYLECHANGED 0x007D + #define WM_DISPLAYCHANGE 0x007E + #define WM_GETICON 0x007F + #define WM_SETICON 0x0080 + #define WM_INPUT 0x00FF + #define WM_KEYFIRST 0x0100 + #define WM_KEYDOWN 0x0100 + #define WM_KEYUP 0x0101 + #define WM_CHAR 0x0102 + #define WM_DEADCHAR 0x0103 + #define WM_SYSKEYDOWN 0x0104 + #define WM_SYSKEYUP 0x0105 + #define WM_SYSCHAR 0x0106 + #define WM_SYSDEADCHAR 0x0107 + #define WM_UNICHAR 0x0109 + #define WM_KEYLAST 0x0109 + #define WM_APP 0x8000 + + + #define RID_INPUT 0x10000003 + + #define RIM_TYPEMOUSE 0x00000000 + #define RIM_TYPEKEYBOARD 0x00000001 + #define RIM_TYPEHID 0x00000002 + + #define RI_KEY_MAKE 0x0000 + #define RI_KEY_BREAK 0x0001 + #define RI_KEY_E0 0x0002 + #define RI_KEY_E1 0x0004 + #define RI_MOUSE_WHEEL 0x0400 + + #define RIDEV_NOLEGACY 0x00000030 + + #define MAPVK_VK_TO_VSC 0 + #define MAPVK_VSC_TO_VK 1 + #define MAPVK_VK_TO_CHAR 2 + #define MAPVK_VSC_TO_VK_EX 3 + + GB_DLL_IMPORT BOOL WINAPI RegisterRawInputDevices(RAWINPUTDEVICE const *raw_input_devices, UINT num_devices, UINT size); + GB_DLL_IMPORT UINT WINAPI GetRawInputData(HRAWINPUT raw_input, UINT ui_command, void *data, UINT *size, UINT size_header); + GB_DLL_IMPORT UINT WINAPI MapVirtualKeyW(UINT code, UINT map_type); + + + #define CS_DBLCLKS 0x0008 + #define CS_VREDRAW 0x0001 + #define CS_HREDRAW 0x0002 + + #define MB_OK 0x0000l + #define MB_ICONSTOP 0x0010l + #define MB_YESNO 0x0004l + #define MB_HELP 0x4000l + #define MB_ICONEXCLAMATION 0x0030l + + GB_DLL_IMPORT LRESULT WINAPI DefWindowProcW(HWND wnd, UINT msg, WPARAM wParam, LPARAM lParam); + GB_DLL_IMPORT HGDIOBJ WINAPI GetStockObject(int object); + GB_DLL_IMPORT HMODULE WINAPI GetModuleHandleW(wchar_t const *); + GB_DLL_IMPORT ATOM WINAPI RegisterClassExW(WNDCLASSEXW const *wcx); // u16 == ATOM + GB_DLL_IMPORT int WINAPI MessageBoxW(void *wnd, wchar_t const *text, wchar_t const *caption, unsigned int type); + + + #define DM_BITSPERPEL 0x00040000l + #define DM_PELSWIDTH 0x00080000l + #define DM_PELSHEIGHT 0x00100000l + + #define CDS_FULLSCREEN 0x4 + #define DISP_CHANGE_SUCCESSFUL 0 + #define IDYES 6 + + #define WS_VISIBLE 0x10000000 + #define WS_THICKFRAME 0x00040000 + #define WS_MAXIMIZE 0x01000000 + #define WS_MAXIMIZEBOX 0x00010000 + #define WS_MINIMIZE 0x20000000 + #define WS_MINIMIZEBOX 0x00020000 + #define WS_POPUP 0x80000000 + #define WS_OVERLAPPED 0 + #define WS_OVERLAPPEDWINDOW 0xcf0000 + #define CW_USEDEFAULT 0x80000000 + #define WS_BORDER 0x800000 + #define WS_CAPTION 0xc00000 + #define WS_SYSMENU 0x80000 + + #define HWND_NOTOPMOST (HWND)(-2) + #define HWND_TOPMOST (HWND)(-1) + #define HWND_TOP (HWND)(+0) + #define HWND_BOTTOM (HWND)(+1) + #define SWP_NOSIZE 0x0001 + #define SWP_NOMOVE 0x0002 + #define SWP_NOZORDER 0x0004 + #define SWP_NOREDRAW 0x0008 + #define SWP_NOACTIVATE 0x0010 + #define SWP_FRAMECHANGED 0x0020 + #define SWP_SHOWWINDOW 0x0040 + #define SWP_HIDEWINDOW 0x0080 + #define SWP_NOCOPYBITS 0x0100 + #define SWP_NOOWNERZORDER 0x0200 + #define SWP_NOSENDCHANGING 0x0400 + + #define SW_HIDE 0 + #define SW_SHOWNORMAL 1 + #define SW_NORMAL 1 + #define SW_SHOWMINIMIZED 2 + #define SW_SHOWMAXIMIZED 3 + #define SW_MAXIMIZE 3 + #define SW_SHOWNOACTIVATE 4 + #define SW_SHOW 5 + #define SW_MINIMIZE 6 + #define SW_SHOWMINNOACTIVE 7 + #define SW_SHOWNA 8 + #define SW_RESTORE 9 + #define SW_SHOWDEFAULT 10 + #define SW_FORCEMINIMIZE 11 + #define SW_MAX 11 + + #define ENUM_CURRENT_SETTINGS cast(DWORD)-1 + #define ENUM_REGISTRY_SETTINGS cast(DWORD)-2 + + GB_DLL_IMPORT LONG WINAPI ChangeDisplaySettingsW(DEVMODEW *dev_mode, DWORD flags); + GB_DLL_IMPORT BOOL WINAPI AdjustWindowRect(RECT *rect, DWORD style, BOOL enu); + GB_DLL_IMPORT HWND WINAPI CreateWindowExW(DWORD ex_style, wchar_t const *class_name, wchar_t const *window_name, + DWORD style, int x, int y, int width, int height, HWND wnd_parent, + HMENU menu, HINSTANCE instance, void *param); + GB_DLL_IMPORT HMODULE WINAPI GetModuleHandleW(wchar_t const *); + GB_DLL_IMPORT HDC GetDC(HANDLE); + GB_DLL_IMPORT BOOL WINAPI GetWindowPlacement(HWND hWnd, WINDOWPLACEMENT *lpwndpl); + GB_DLL_IMPORT BOOL GetMonitorInfoW(HMONITOR hMonitor, MONITORINFO *lpmi); + GB_DLL_IMPORT HMONITOR MonitorFromWindow(HWND hwnd, DWORD dwFlags); + GB_DLL_IMPORT LONG WINAPI SetWindowLongW(HWND hWnd, int nIndex, LONG dwNewLong); + GB_DLL_IMPORT BOOL WINAPI SetWindowPos(HWND hWnd, HWND hWndInsertAfter, int X, int Y, int cx, int cy, UINT uFlags); + GB_DLL_IMPORT BOOL WINAPI SetWindowPlacement(HWND hWnd, WINDOWPLACEMENT const *lpwndpl); + GB_DLL_IMPORT BOOL WINAPI ShowWindow(HWND hWnd, int nCmdShow); + GB_DLL_IMPORT LONG_PTR WINAPI GetWindowLongPtrW(HWND wnd, int index); + + GB_DLL_IMPORT BOOL EnumDisplaySettingsW(wchar_t const *lpszDeviceName, DWORD iModeNum, DEVMODEW *lpDevMode); + GB_DLL_IMPORT void * WINAPI GlobalLock(HGLOBAL hMem); + GB_DLL_IMPORT BOOL WINAPI GlobalUnlock(HGLOBAL hMem); + GB_DLL_IMPORT HGLOBAL WINAPI GlobalAlloc(UINT uFlags, usize dwBytes); + GB_DLL_IMPORT HANDLE WINAPI GetClipboardData(UINT uFormat); + GB_DLL_IMPORT BOOL WINAPI IsClipboardFormatAvailable(UINT format); + GB_DLL_IMPORT BOOL WINAPI OpenClipboard(HWND hWndNewOwner); + GB_DLL_IMPORT BOOL WINAPI EmptyClipboard(void); + GB_DLL_IMPORT BOOL WINAPI CloseClipboard(void); + GB_DLL_IMPORT HANDLE WINAPI SetClipboardData(UINT uFormat, HANDLE hMem); + + #define PFD_TYPE_RGBA 0 + #define PFD_TYPE_COLORINDEX 1 + #define PFD_MAIN_PLANE 0 + #define PFD_OVERLAY_PLANE 1 + #define PFD_UNDERLAY_PLANE (-1) + #define PFD_DOUBLEBUFFER 1 + #define PFD_STEREO 2 + #define PFD_DRAW_TO_WINDOW 4 + #define PFD_DRAW_TO_BITMAP 8 + #define PFD_SUPPORT_GDI 16 + #define PFD_SUPPORT_OPENGL 32 + #define PFD_GENERIC_FORMAT 64 + #define PFD_NEED_PALETTE 128 + #define PFD_NEED_SYSTEM_PALETTE 0x00000100 + #define PFD_SWAP_EXCHANGE 0x00000200 + #define PFD_SWAP_COPY 0x00000400 + #define PFD_SWAP_LAYER_BUFFERS 0x00000800 + #define PFD_GENERIC_ACCELERATED 0x00001000 + #define PFD_DEPTH_DONTCARE 0x20000000 + #define PFD_DOUBLEBUFFER_DONTCARE 0x40000000 + #define PFD_STEREO_DONTCARE 0x80000000 + + #define GWLP_USERDATA -21 + + #define GWL_ID -12 + #define GWL_STYLE -16 + + GB_DLL_IMPORT BOOL WINAPI SetPixelFormat (HDC hdc, int pixel_format, PIXELFORMATDESCRIPTOR const *pfd); + GB_DLL_IMPORT int WINAPI ChoosePixelFormat(HDC hdc, PIXELFORMATDESCRIPTOR const *pfd); + GB_DLL_IMPORT HGLRC WINAPI wglCreateContext (HDC hdc); + GB_DLL_IMPORT BOOL WINAPI wglMakeCurrent (HDC hdc, HGLRC hglrc); + GB_DLL_IMPORT PROC WINAPI wglGetProcAddress(char const *str); + GB_DLL_IMPORT BOOL WINAPI wglDeleteContext (HGLRC hglrc); + + GB_DLL_IMPORT BOOL WINAPI SetForegroundWindow(HWND hWnd); + GB_DLL_IMPORT HWND WINAPI SetFocus(HWND hWnd); + GB_DLL_IMPORT LONG_PTR WINAPI SetWindowLongPtrW(HWND hWnd, int nIndex, LONG_PTR dwNewLong); + GB_DLL_IMPORT BOOL WINAPI GetClientRect(HWND hWnd, RECT *lpRect); + GB_DLL_IMPORT BOOL WINAPI IsIconic(HWND hWnd); + GB_DLL_IMPORT HWND WINAPI GetFocus(void); + GB_DLL_IMPORT int WINAPI ShowCursor(BOOL bShow); + GB_DLL_IMPORT SHORT WINAPI GetAsyncKeyState(int key); + GB_DLL_IMPORT BOOL WINAPI GetCursorPos(POINT *lpPoint); + GB_DLL_IMPORT BOOL WINAPI SetCursorPos(int x, int y); + GB_DLL_IMPORT BOOL ScreenToClient(HWND hWnd, POINT *lpPoint); + GB_DLL_IMPORT BOOL ClientToScreen(HWND hWnd, POINT *lpPoint); + GB_DLL_IMPORT BOOL WINAPI MoveWindow(HWND hWnd, int X, int Y, int nWidth, int nHeight, BOOL bRepaint); + GB_DLL_IMPORT BOOL WINAPI SetWindowTextW(HWND hWnd, wchar_t const *lpString); + GB_DLL_IMPORT DWORD WINAPI GetWindowLongW(HWND hWnd, int nIndex); + + + + + #define PM_NOREMOVE 0 + #define PM_REMOVE 1 + + GB_DLL_IMPORT BOOL WINAPI PeekMessageW(MSG *lpMsg, HWND hWnd, UINT wMsgFilterMin, UINT wMsgFilterMax, UINT wRemoveMsg); + GB_DLL_IMPORT BOOL WINAPI TranslateMessage(MSG const *lpMsg); + GB_DLL_IMPORT LRESULT WINAPI DispatchMessageW(MSG const *lpMsg); + + typedef enum + { + DIB_RGB_COLORS = 0x00, + DIB_PAL_COLORS = 0x01, + DIB_PAL_INDICES = 0x02 + } DIBColors; + + #define SRCCOPY (u32)0x00CC0020 + #define SRCPAINT (u32)0x00EE0086 + #define SRCAND (u32)0x008800C6 + #define SRCINVERT (u32)0x00660046 + #define SRCERASE (u32)0x00440328 + #define NOTSRCCOPY (u32)0x00330008 + #define NOTSRCERASE (u32)0x001100A6 + #define MERGECOPY (u32)0x00C000CA + #define MERGEPAINT (u32)0x00BB0226 + #define PATCOPY (u32)0x00F00021 + #define PATPAINT (u32)0x00FB0A09 + #define PATINVERT (u32)0x005A0049 + #define DSTINVERT (u32)0x00550009 + #define BLACKNESS (u32)0x00000042 + #define WHITENESS (u32)0x00FF0062 + + GB_DLL_IMPORT BOOL WINAPI SwapBuffers(HDC hdc); + GB_DLL_IMPORT BOOL WINAPI DestroyWindow(HWND hWnd); + GB_DLL_IMPORT int StretchDIBits(HDC hdc, int XDest, int YDest, int nDestWidth, int nDestHeight, + int XSrc, int YSrc, int nSrcWidth, int nSrcHeight, + void const *lpBits, /*BITMAPINFO*/void const *lpBitsInfo, UINT iUsage, DWORD dwRop); + // IMPORTANT TODO(bill): FIX THIS!!!! +#endif // Bill's Mini Windows.h + + + +#if defined(__GCC__) || defined(__GNUC__) +#pragma GCC diagnostic push +#pragma GCC diagnostic ignored "-Wattributes" +#pragma GCC diagnostic ignored "-Wmissing-braces" +#endif + +#if defined(_MSC_VER) +#pragma warning(push) +#pragma warning(disable:4201) +#pragma warning(disable:4127) // Conditional expression is constant +#endif + +void gb_assert_handler(char const *prefix, char const *condition, char const *file, i32 line, char const *msg, ...) { + gb_printf_err("%s(%d): %s: ", file, line, prefix); + if (condition) + gb_printf_err( "`%s` ", condition); + if (msg) { + va_list va; + va_start(va, msg); + gb_printf_err_va(msg, va); + va_end(va); + } + gb_printf_err("\n"); +} + +b32 gb_is_power_of_two(isize x) { + if (x <= 0) + return false; + return !(x & (x-1)); +} + +gb_inline void *gb_align_forward(void *ptr, isize alignment) { + uintptr p; + + GB_ASSERT(gb_is_power_of_two(alignment)); + + p = cast(uintptr)ptr; + return cast(void *)((p + (alignment-1)) &~ (alignment-1)); +} + + + +gb_inline void * gb_pointer_add (void *ptr, isize bytes) { return cast(void *)(cast(u8 *)ptr + bytes); } +gb_inline void * gb_pointer_sub (void *ptr, isize bytes) { return cast(void *)(cast(u8 *)ptr - bytes); } +gb_inline void const *gb_pointer_add_const(void const *ptr, isize bytes) { return cast(void const *)(cast(u8 const *)ptr + bytes); } +gb_inline void const *gb_pointer_sub_const(void const *ptr, isize bytes) { return cast(void const *)(cast(u8 const *)ptr - bytes); } +gb_inline isize gb_pointer_diff (void const *begin, void const *end) { return cast(isize)(cast(u8 const *)end - cast(u8 const *)begin); } + +gb_inline void gb_zero_size(void *ptr, isize size) { gb_memset(ptr, 0, size); } + + +#if defined(_MSC_VER) +#pragma intrinsic(__movsb) +#endif + +gb_inline void *gb_memcopy(void *dest, void const *source, isize n) { +#if defined(_MSC_VER) + if (dest == NULL) { + return NULL; + } + // TODO(bill): Is this good enough? + __movsb(cast(u8 *)dest, cast(u8 *)source, n); +// #elif defined(GB_SYSTEM_OSX) || defined(GB_SYSTEM_UNIX) + // NOTE(zangent): I assume there's a reason this isn't being used elsewhere, + // but casting pointers as arguments to an __asm__ call is considered an + // error on MacOS and (I think) Linux + // TODO(zangent): Figure out how to refactor the asm code so it works on MacOS, + // since this is probably not the way the author intended this to work. + // memcpy(dest, source, n); +#elif defined(GB_CPU_X86) + if (dest == NULL) { + return NULL; + } + + void *dest_copy = dest; + __asm__ __volatile__("rep movsb" : "+D"(dest_copy), "+S"(source), "+c"(n) : : "memory"); +#else + u8 *d = cast(u8 *)dest; + u8 const *s = cast(u8 const *)source; + u32 w, x; + + if (dest == NULL) { + return NULL; + } + + for (; cast(uintptr)s % 4 && n; n--) { + *d++ = *s++; + } + + if (cast(uintptr)d % 4 == 0) { + for (; n >= 16; + s += 16, d += 16, n -= 16) { + *cast(u32 *)(d+ 0) = *cast(u32 *)(s+ 0); + *cast(u32 *)(d+ 4) = *cast(u32 *)(s+ 4); + *cast(u32 *)(d+ 8) = *cast(u32 *)(s+ 8); + *cast(u32 *)(d+12) = *cast(u32 *)(s+12); + } + if (n & 8) { + *cast(u32 *)(d+0) = *cast(u32 *)(s+0); + *cast(u32 *)(d+4) = *cast(u32 *)(s+4); + d += 8; + s += 8; + } + if (n&4) { + *cast(u32 *)(d+0) = *cast(u32 *)(s+0); + d += 4; + s += 4; + } + if (n&2) { + *d++ = *s++; *d++ = *s++; + } + if (n&1) { + *d = *s; + } + return dest; + } + + if (n >= 32) { + #if __BYTE_ORDER == __BIG_ENDIAN + #define LS << + #define RS >> + #else + #define LS >> + #define RS << + #endif + switch (cast(uintptr)d % 4) { + case 1: { + w = *cast(u32 *)s; + *d++ = *s++; + *d++ = *s++; + *d++ = *s++; + n -= 3; + while (n > 16) { + x = *cast(u32 *)(s+1); + *cast(u32 *)(d+0) = (w LS 24) | (x RS 8); + w = *cast(u32 *)(s+5); + *cast(u32 *)(d+4) = (x LS 24) | (w RS 8); + x = *cast(u32 *)(s+9); + *cast(u32 *)(d+8) = (w LS 24) | (x RS 8); + w = *cast(u32 *)(s+13); + *cast(u32 *)(d+12) = (x LS 24) | (w RS 8); + + s += 16; + d += 16; + n -= 16; + } + } break; + case 2: { + w = *cast(u32 *)s; + *d++ = *s++; + *d++ = *s++; + n -= 2; + while (n > 17) { + x = *cast(u32 *)(s+2); + *cast(u32 *)(d+0) = (w LS 16) | (x RS 16); + w = *cast(u32 *)(s+6); + *cast(u32 *)(d+4) = (x LS 16) | (w RS 16); + x = *cast(u32 *)(s+10); + *cast(u32 *)(d+8) = (w LS 16) | (x RS 16); + w = *cast(u32 *)(s+14); + *cast(u32 *)(d+12) = (x LS 16) | (w RS 16); + + s += 16; + d += 16; + n -= 16; + } + } break; + case 3: { + w = *cast(u32 *)s; + *d++ = *s++; + n -= 1; + while (n > 18) { + x = *cast(u32 *)(s+3); + *cast(u32 *)(d+0) = (w LS 8) | (x RS 24); + w = *cast(u32 *)(s+7); + *cast(u32 *)(d+4) = (x LS 8) | (w RS 24); + x = *cast(u32 *)(s+11); + *cast(u32 *)(d+8) = (w LS 8) | (x RS 24); + w = *cast(u32 *)(s+15); + *cast(u32 *)(d+12) = (x LS 8) | (w RS 24); + + s += 16; + d += 16; + n -= 16; + } + } break; + default: break; // NOTE(bill): Do nowt! + } + #undef LS + #undef RS + if (n & 16) { + *d++ = *s++; *d++ = *s++; *d++ = *s++; *d++ = *s++; + *d++ = *s++; *d++ = *s++; *d++ = *s++; *d++ = *s++; + *d++ = *s++; *d++ = *s++; *d++ = *s++; *d++ = *s++; + *d++ = *s++; *d++ = *s++; *d++ = *s++; *d++ = *s++; + } + if (n & 8) { + *d++ = *s++; *d++ = *s++; *d++ = *s++; *d++ = *s++; + *d++ = *s++; *d++ = *s++; *d++ = *s++; *d++ = *s++; + } + if (n & 4) { + *d++ = *s++; *d++ = *s++; *d++ = *s++; *d++ = *s++; + } + if (n & 2) { + *d++ = *s++; *d++ = *s++; + } + if (n & 1) { + *d = *s; + } + } + +#endif + return dest; +} + +gb_inline void *gb_memmove(void *dest, void const *source, isize n) { + u8 *d = cast(u8 *)dest; + u8 const *s = cast(u8 const *)source; + + if (dest == NULL) { + return NULL; + } + + if (d == s) { + return d; + } + if (s+n <= d || d+n <= s) { // NOTE(bill): Non-overlapping + return gb_memcopy(d, s, n); + } + + if (d < s) { + if (cast(uintptr)s % gb_size_of(isize) == cast(uintptr)d % gb_size_of(isize)) { + while (cast(uintptr)d % gb_size_of(isize)) { + if (!n--) return dest; + *d++ = *s++; + } + while (n>=gb_size_of(isize)) { + *cast(isize *)d = *cast(isize *)s; + n -= gb_size_of(isize); + d += gb_size_of(isize); + s += gb_size_of(isize); + } + } + for (; n; n--) *d++ = *s++; + } else { + if ((cast(uintptr)s % gb_size_of(isize)) == (cast(uintptr)d % gb_size_of(isize))) { + while (cast(uintptr)(d+n) % gb_size_of(isize)) { + if (!n--) + return dest; + d[n] = s[n]; + } + while (n >= gb_size_of(isize)) { + n -= gb_size_of(isize); + *cast(isize *)(d+n) = *cast(isize *)(s+n); + } + } + while (n) n--, d[n] = s[n]; + } + + return dest; +} + +gb_inline void *gb_memset(void *dest, u8 c, isize n) { + u8 *s = cast(u8 *)dest; + isize k; + u32 c32 = ((u32)-1)/255 * c; + + if (dest == NULL) { + return NULL; + } + + if (n == 0) + return dest; + s[0] = s[n-1] = c; + if (n < 3) + return dest; + s[1] = s[n-2] = c; + s[2] = s[n-3] = c; + if (n < 7) + return dest; + s[3] = s[n-4] = c; + if (n < 9) + return dest; + + k = -cast(intptr)s & 3; + s += k; + n -= k; + n &= -4; + + *cast(u32 *)(s+0) = c32; + *cast(u32 *)(s+n-4) = c32; + if (n < 9) { + return dest; + } + *cast(u32 *)(s + 4) = c32; + *cast(u32 *)(s + 8) = c32; + *cast(u32 *)(s+n-12) = c32; + *cast(u32 *)(s+n- 8) = c32; + if (n < 25) { + return dest; + } + *cast(u32 *)(s + 12) = c32; + *cast(u32 *)(s + 16) = c32; + *cast(u32 *)(s + 20) = c32; + *cast(u32 *)(s + 24) = c32; + *cast(u32 *)(s+n-28) = c32; + *cast(u32 *)(s+n-24) = c32; + *cast(u32 *)(s+n-20) = c32; + *cast(u32 *)(s+n-16) = c32; + + k = 24 + (cast(uintptr)s & 4); + s += k; + n -= k; + + + { + u64 c64 = (cast(u64)c32 << 32) | c32; + while (n > 31) { + *cast(u64 *)(s+0) = c64; + *cast(u64 *)(s+8) = c64; + *cast(u64 *)(s+16) = c64; + *cast(u64 *)(s+24) = c64; + + n -= 32; + s += 32; + } + } + + return dest; +} + +gb_inline i32 gb_memcompare(void const *s1, void const *s2, isize size) { + // TODO(bill): Heavily optimize + u8 const *s1p8 = cast(u8 const *)s1; + u8 const *s2p8 = cast(u8 const *)s2; + + if (s1 == NULL || s2 == NULL) { + return 0; + } + + while (size--) { + if (*s1p8 != *s2p8) { + return (*s1p8 - *s2p8); + } + s1p8++, s2p8++; + } + return 0; +} + +void gb_memswap(void *i, void *j, isize size) { + if (i == j) return; + + if (size == 4) { + gb_swap(u32, *cast(u32 *)i, *cast(u32 *)j); + } else if (size == 8) { + gb_swap(u64, *cast(u64 *)i, *cast(u64 *)j); + } else if (size < 8) { + u8 *a = cast(u8 *)i; + u8 *b = cast(u8 *)j; + if (a != b) { + while (size--) { + gb_swap(u8, *a, *b); + a++, b++; + } + } + } else { + char buffer[256]; + + // TODO(bill): Is the recursion ever a problem? + while (size > gb_size_of(buffer)) { + gb_memswap(i, j, gb_size_of(buffer)); + i = gb_pointer_add(i, gb_size_of(buffer)); + j = gb_pointer_add(j, gb_size_of(buffer)); + size -= gb_size_of(buffer); + } + + gb_memcopy(buffer, i, size); + gb_memcopy(i, j, size); + gb_memcopy(j, buffer, size); + } +} + +#define GB__ONES (cast(usize)-1/U8_MAX) +#define GB__HIGHS (GB__ONES * (U8_MAX/2+1)) +#define GB__HAS_ZERO(x) ((x)-GB__ONES & ~(x) & GB__HIGHS) + + +void const *gb_memchr(void const *data, u8 c, isize n) { + u8 const *s = cast(u8 const *)data; + while ((cast(uintptr)s & (sizeof(usize)-1)) && + n && *s != c) { + s++; + n--; + } + if (n && *s != c) { + isize const *w; + isize k = GB__ONES * c; + w = cast(isize const *)s; + while (n >= gb_size_of(isize) && !GB__HAS_ZERO(*w ^ k)) { + w++; + n -= gb_size_of(isize); + } + s = cast(u8 const *)w; + while (n && *s != c) { + s++; + n--; + } + } + + return n ? cast(void const *)s : NULL; +} + + +void const *gb_memrchr(void const *data, u8 c, isize n) { + u8 const *s = cast(u8 const *)data; + while (n--) { + if (s[n] == c) + return cast(void const *)(s + n); + } + return NULL; +} + + + +gb_inline void *gb_alloc_align (gbAllocator a, isize size, isize alignment) { return a.proc(a.data, gbAllocation_Alloc, size, alignment, NULL, 0, GB_DEFAULT_ALLOCATOR_FLAGS); } +gb_inline void *gb_alloc (gbAllocator a, isize size) { return gb_alloc_align(a, size, GB_DEFAULT_MEMORY_ALIGNMENT); } +gb_inline void gb_free (gbAllocator a, void *ptr) { if (ptr != NULL) a.proc(a.data, gbAllocation_Free, 0, 0, ptr, 0, GB_DEFAULT_ALLOCATOR_FLAGS); } +gb_inline void gb_free_all (gbAllocator a) { a.proc(a.data, gbAllocation_FreeAll, 0, 0, NULL, 0, GB_DEFAULT_ALLOCATOR_FLAGS); } +gb_inline void *gb_resize (gbAllocator a, void *ptr, isize old_size, isize new_size) { return gb_resize_align(a, ptr, old_size, new_size, GB_DEFAULT_MEMORY_ALIGNMENT); } +gb_inline void *gb_resize_align(gbAllocator a, void *ptr, isize old_size, isize new_size, isize alignment) { return a.proc(a.data, gbAllocation_Resize, new_size, alignment, ptr, old_size, GB_DEFAULT_ALLOCATOR_FLAGS); } + +gb_inline void *gb_alloc_copy (gbAllocator a, void const *src, isize size) { + return gb_memcopy(gb_alloc(a, size), src, size); +} +gb_inline void *gb_alloc_copy_align(gbAllocator a, void const *src, isize size, isize alignment) { + return gb_memcopy(gb_alloc_align(a, size, alignment), src, size); +} + +gb_inline char *gb_alloc_str(gbAllocator a, char const *str) { + return gb_alloc_str_len(a, str, gb_strlen(str)); +} + +gb_inline char *gb_alloc_str_len(gbAllocator a, char const *str, isize len) { + char *result; + result = cast(char *)gb_alloc_copy(a, str, len+1); + result[len] = '\0'; + return result; +} + + +gb_inline void *gb_default_resize_align(gbAllocator a, void *old_memory, isize old_size, isize new_size, isize alignment) { + if (!old_memory) return gb_alloc_align(a, new_size, alignment); + + if (new_size == 0) { + gb_free(a, old_memory); + return NULL; + } + + if (new_size < old_size) + new_size = old_size; + + if (old_size == new_size) { + return old_memory; + } else { + void *new_memory = gb_alloc_align(a, new_size, alignment); + if (!new_memory) return NULL; + gb_memmove(new_memory, old_memory, gb_min(new_size, old_size)); + gb_free(a, old_memory); + return new_memory; + } +} + + + + +//////////////////////////////////////////////////////////////// +// +// Concurrency +// +// +// IMPORTANT TODO(bill): Use compiler intrinsics for the atomics + +#if defined(GB_COMPILER_MSVC) && !defined(GB_COMPILER_CLANG) +gb_inline i32 gb_atomic32_load (gbAtomic32 const volatile *a) { return a->value; } +gb_inline void gb_atomic32_store(gbAtomic32 volatile *a, i32 value) { a->value = value; } + +gb_inline i32 gb_atomic32_compare_exchange(gbAtomic32 volatile *a, i32 expected, i32 desired) { + return _InterlockedCompareExchange(cast(long volatile *)a, desired, expected); +} +gb_inline i32 gb_atomic32_exchanged(gbAtomic32 volatile *a, i32 desired) { + return _InterlockedExchange(cast(long volatile *)a, desired); +} +gb_inline i32 gb_atomic32_fetch_add(gbAtomic32 volatile *a, i32 operand) { + return _InterlockedExchangeAdd(cast(long volatile *)a, operand); +} +gb_inline i32 gb_atomic32_fetch_and(gbAtomic32 volatile *a, i32 operand) { + return _InterlockedAnd(cast(long volatile *)a, operand); +} +gb_inline i32 gb_atomic32_fetch_or(gbAtomic32 volatile *a, i32 operand) { + return _InterlockedOr(cast(long volatile *)a, operand); +} + +gb_inline i64 gb_atomic64_load(gbAtomic64 const volatile *a) { +#if defined(GB_ARCH_64_BIT) + return a->value; +#elif GB_CPU_X86 + // NOTE(bill): The most compatible way to get an atomic 64-bit load on x86 is with cmpxchg8b + i64 result; + __asm { + mov esi, a; + mov ebx, eax; + mov ecx, edx; + lock cmpxchg8b [esi]; + mov dword ptr result, eax; + mov dword ptr result[4], edx; + } + return result; +#else +#error TODO(bill): atomics for this CPU +#endif +} + +gb_inline void gb_atomic64_store(gbAtomic64 volatile *a, i64 value) { +#if defined(GB_ARCH_64_BIT) + a->value = value; +#elif GB_CPU_X86 + // NOTE(bill): The most compatible way to get an atomic 64-bit store on x86 is with cmpxchg8b + __asm { + mov esi, a; + mov ebx, dword ptr value; + mov ecx, dword ptr value[4]; + retry: + cmpxchg8b [esi]; + jne retry; + } +#else +#error TODO(bill): atomics for this CPU +#endif +} + +gb_inline i64 gb_atomic64_compare_exchange(gbAtomic64 volatile *a, i64 expected, i64 desired) { + return _InterlockedCompareExchange64(cast(i64 volatile *)a, desired, expected); +} + +gb_inline i64 gb_atomic64_exchanged(gbAtomic64 volatile *a, i64 desired) { +#if defined(GB_ARCH_64_BIT) + return _InterlockedExchange64(cast(i64 volatile *)a, desired); +#elif GB_CPU_X86 + i64 expected = a->value; + for (;;) { + i64 original = _InterlockedCompareExchange64(cast(i64 volatile *)a, desired, expected); + if (original == expected) + return original; + expected = original; + } +#else +#error TODO(bill): atomics for this CPU +#endif +} + +gb_inline i64 gb_atomic64_fetch_add(gbAtomic64 volatile *a, i64 operand) { +#if defined(GB_ARCH_64_BIT) + return _InterlockedExchangeAdd64(cast(i64 volatile *)a, operand); +#elif GB_CPU_X86 + i64 expected = a->value; + for (;;) { + i64 original = _InterlockedCompareExchange64(cast(i64 volatile *)a, expected + operand, expected); + if (original == expected) + return original; + expected = original; + } +#else +#error TODO(bill): atomics for this CPU +#endif +} + +gb_inline i64 gb_atomic64_fetch_and(gbAtomic64 volatile *a, i64 operand) { +#if defined(GB_ARCH_64_BIT) + return _InterlockedAnd64(cast(i64 volatile *)a, operand); +#elif GB_CPU_X86 + i64 expected = a->value; + for (;;) { + i64 original = _InterlockedCompareExchange64(cast(i64 volatile *)a, expected & operand, expected); + if (original == expected) + return original; + expected = original; + } +#else +#error TODO(bill): atomics for this CPU +#endif +} + +gb_inline i64 gb_atomic64_fetch_or(gbAtomic64 volatile *a, i64 operand) { +#if defined(GB_ARCH_64_BIT) + return _InterlockedOr64(cast(i64 volatile *)a, operand); +#elif GB_CPU_X86 + i64 expected = a->value; + for (;;) { + i64 original = _InterlockedCompareExchange64(cast(i64 volatile *)a, expected | operand, expected); + if (original == expected) + return original; + expected = original; + } +#else +#error TODO(bill): atomics for this CPU +#endif +} + + + +#elif defined(GB_CPU_X86) + +gb_inline i32 gb_atomic32_load (gbAtomic32 const volatile *a) { return a->value; } +gb_inline void gb_atomic32_store(gbAtomic32 volatile *a, i32 value) { a->value = value; } + +gb_inline i32 gb_atomic32_compare_exchange(gbAtomic32 volatile *a, i32 expected, i32 desired) { + i32 original; + __asm__ volatile( + "lock; cmpxchgl %2, %1" + : "=a"(original), "+m"(a->value) + : "q"(desired), "0"(expected) + ); + return original; +} + +gb_inline i32 gb_atomic32_exchanged(gbAtomic32 volatile *a, i32 desired) { + // NOTE(bill): No lock prefix is necessary for xchgl + i32 original; + __asm__ volatile( + "xchgl %0, %1" + : "=r"(original), "+m"(a->value) + : "0"(desired) + ); + return original; +} + +gb_inline i32 gb_atomic32_fetch_add(gbAtomic32 volatile *a, i32 operand) { + i32 original; + __asm__ volatile( + "lock; xaddl %0, %1" + : "=r"(original), "+m"(a->value) + : "0"(operand) + ); + return original; +} + +gb_inline i32 gb_atomic32_fetch_and(gbAtomic32 volatile *a, i32 operand) { + i32 original; + i32 tmp; + __asm__ volatile( + "1: movl %1, %0\n" + " movl %0, %2\n" + " andl %3, %2\n" + " lock; cmpxchgl %2, %1\n" + " jne 1b" + : "=&a"(original), "+m"(a->value), "=&r"(tmp) + : "r"(operand) + ); + return original; +} + +gb_inline i32 gb_atomic32_fetch_or(gbAtomic32 volatile *a, i32 operand) { + i32 original; + i32 temp; + __asm__ volatile( + "1: movl %1, %0\n" + " movl %0, %2\n" + " orl %3, %2\n" + " lock; cmpxchgl %2, %1\n" + " jne 1b" + : "=&a"(original), "+m"(a->value), "=&r"(temp) + : "r"(operand) + ); + return original; +} + + +gb_inline i64 gb_atomic64_load(gbAtomic64 const volatile *a) { +#if defined(GB_ARCH_64_BIT) + return a->value; +#else + i64 original; + __asm__ volatile( + "movl %%ebx, %%eax\n" + "movl %%ecx, %%edx\n" + "lock; cmpxchg8b %1" + : "=&A"(original) + : "m"(a->value) + ); + return original; +#endif +} + +gb_inline void gb_atomic64_store(gbAtomic64 volatile *a, i64 value) { +#if defined(GB_ARCH_64_BIT) + a->value = value; +#else + i64 expected = a->value; + __asm__ volatile( + "1: cmpxchg8b %0\n" + " jne 1b" + : "=m"(a->value) + : "b"((i32)value), "c"((i32)(value >> 32)), "A"(expected) + ); +#endif +} + +gb_inline i64 gb_atomic64_compare_exchange(gbAtomic64 volatile *a, i64 expected, i64 desired) { +#if defined(GB_ARCH_64_BIT) + i64 original; + __asm__ volatile( + "lock; cmpxchgq %2, %1" + : "=a"(original), "+m"(a->value) + : "q"(desired), "0"(expected) + ); + return original; +#else + i64 original; + __asm__ volatile( + "lock; cmpxchg8b %1" + : "=A"(original), "+m"(a->value) + : "b"((i32)desired), "c"((i32)(desired >> 32)), "0"(expected) + ); + return original; +#endif +} + +gb_inline i64 gb_atomic64_exchanged(gbAtomic64 volatile *a, i64 desired) { +#if defined(GB_ARCH_64_BIT) + i64 original; + __asm__ volatile( + "xchgq %0, %1" + : "=r"(original), "+m"(a->value) + : "0"(desired) + ); + return original; +#else + i64 original = a->value; + for (;;) { + i64 previous = gb_atomic64_compare_exchange(a, original, desired); + if (original == previous) + return original; + original = previous; + } +#endif +} + +gb_inline i64 gb_atomic64_fetch_add(gbAtomic64 volatile *a, i64 operand) { +#if defined(GB_ARCH_64_BIT) + i64 original; + __asm__ volatile( + "lock; xaddq %0, %1" + : "=r"(original), "+m"(a->value) + : "0"(operand) + ); + return original; +#else + for (;;) { + i64 original = a->value; + if (gb_atomic64_compare_exchange(a, original, original + operand) == original) + return original; + } +#endif +} + +gb_inline i64 gb_atomic64_fetch_and(gbAtomic64 volatile *a, i64 operand) { +#if defined(GB_ARCH_64_BIT) + i64 original; + i64 tmp; + __asm__ volatile( + "1: movq %1, %0\n" + " movq %0, %2\n" + " andq %3, %2\n" + " lock; cmpxchgq %2, %1\n" + " jne 1b" + : "=&a"(original), "+m"(a->value), "=&r"(tmp) + : "r"(operand) + ); + return original; +#else + for (;;) { + i64 original = a->value; + if (gb_atomic64_compare_exchange(a, original, original & operand) == original) + return original; + } +#endif +} + +gb_inline i64 gb_atomic64_fetch_or(gbAtomic64 volatile *a, i64 operand) { +#if defined(GB_ARCH_64_BIT) + i64 original; + i64 temp; + __asm__ volatile( + "1: movq %1, %0\n" + " movq %0, %2\n" + " orq %3, %2\n" + " lock; cmpxchgq %2, %1\n" + " jne 1b" + : "=&a"(original), "+m"(a->value), "=&r"(temp) + : "r"(operand) + ); + return original; +#else + for (;;) { + i64 original = a->value; + if (gb_atomic64_compare_exchange(a, original, original | operand) == original) + return original; + } +#endif +} + +#else +#error TODO(bill): Implement Atomics for this CPU +#endif + +gb_inline b32 gb_atomic32_spin_lock(gbAtomic32 volatile *a, isize time_out) { + i32 old_value = gb_atomic32_compare_exchange(a, 1, 0); + i32 counter = 0; + while (old_value != 0 && (time_out < 0 || counter++ < time_out)) { + gb_yield_thread(); + old_value = gb_atomic32_compare_exchange(a, 1, 0); + gb_mfence(); + } + return old_value == 0; +} +gb_inline void gb_atomic32_spin_unlock(gbAtomic32 volatile *a) { + gb_atomic32_store(a, 0); + gb_mfence(); +} + +gb_inline b32 gb_atomic64_spin_lock(gbAtomic64 volatile *a, isize time_out) { + i64 old_value = gb_atomic64_compare_exchange(a, 1, 0); + i64 counter = 0; + while (old_value != 0 && (time_out < 0 || counter++ < time_out)) { + gb_yield_thread(); + old_value = gb_atomic64_compare_exchange(a, 1, 0); + gb_mfence(); + } + return old_value == 0; +} + +gb_inline void gb_atomic64_spin_unlock(gbAtomic64 volatile *a) { + gb_atomic64_store(a, 0); + gb_mfence(); +} + +gb_inline b32 gb_atomic32_try_acquire_lock(gbAtomic32 volatile *a) { + i32 old_value; + gb_yield_thread(); + old_value = gb_atomic32_compare_exchange(a, 1, 0); + gb_mfence(); + return old_value == 0; +} + +gb_inline b32 gb_atomic64_try_acquire_lock(gbAtomic64 volatile *a) { + i64 old_value; + gb_yield_thread(); + old_value = gb_atomic64_compare_exchange(a, 1, 0); + gb_mfence(); + return old_value == 0; +} + + + +#if defined(GB_ARCH_32_BIT) + +gb_inline void *gb_atomic_ptr_load(gbAtomicPtr const volatile *a) { + return cast(void *)cast(intptr)gb_atomic32_load(cast(gbAtomic32 const volatile *)a); +} +gb_inline void gb_atomic_ptr_store(gbAtomicPtr volatile *a, void *value) { + gb_atomic32_store(cast(gbAtomic32 volatile *)a, cast(i32)cast(intptr)value); +} +gb_inline void *gb_atomic_ptr_compare_exchange(gbAtomicPtr volatile *a, void *expected, void *desired) { + return cast(void *)cast(intptr)gb_atomic32_compare_exchange(cast(gbAtomic32 volatile *)a, cast(i32)cast(intptr)expected, cast(i32)cast(intptr)desired); +} +gb_inline void *gb_atomic_ptr_exchanged(gbAtomicPtr volatile *a, void *desired) { + return cast(void *)cast(intptr)gb_atomic32_exchanged(cast(gbAtomic32 volatile *)a, cast(i32)cast(intptr)desired); +} +gb_inline void *gb_atomic_ptr_fetch_add(gbAtomicPtr volatile *a, void *operand) { + return cast(void *)cast(intptr)gb_atomic32_fetch_add(cast(gbAtomic32 volatile *)a, cast(i32)cast(intptr)operand); +} +gb_inline void *gb_atomic_ptr_fetch_and(gbAtomicPtr volatile *a, void *operand) { + return cast(void *)cast(intptr)gb_atomic32_fetch_and(cast(gbAtomic32 volatile *)a, cast(i32)cast(intptr)operand); +} +gb_inline void *gb_atomic_ptr_fetch_or(gbAtomicPtr volatile *a, void *operand) { + return cast(void *)cast(intptr)gb_atomic32_fetch_or(cast(gbAtomic32 volatile *)a, cast(i32)cast(intptr)operand); +} +gb_inline b32 gb_atomic_ptr_spin_lock(gbAtomicPtr volatile *a, isize time_out) { + return gb_atomic32_spin_lock(cast(gbAtomic32 volatile *)a, time_out); +} +gb_inline void gb_atomic_ptr_spin_unlock(gbAtomicPtr volatile *a) { + gb_atomic32_spin_unlock(cast(gbAtomic32 volatile *)a); +} +gb_inline b32 gb_atomic_ptr_try_acquire_lock(gbAtomicPtr volatile *a) { + return gb_atomic32_try_acquire_lock(cast(gbAtomic32 volatile *)a); +} + +#elif defined(GB_ARCH_64_BIT) + +gb_inline void *gb_atomic_ptr_load(gbAtomicPtr const volatile *a) { + return cast(void *)cast(intptr)gb_atomic64_load(cast(gbAtomic64 const volatile *)a); +} +gb_inline void gb_atomic_ptr_store(gbAtomicPtr volatile *a, void *value) { + gb_atomic64_store(cast(gbAtomic64 volatile *)a, cast(i64)cast(intptr)value); +} +gb_inline void *gb_atomic_ptr_compare_exchange(gbAtomicPtr volatile *a, void *expected, void *desired) { + return cast(void *)cast(intptr)gb_atomic64_compare_exchange(cast(gbAtomic64 volatile *)a, cast(i64)cast(intptr)expected, cast(i64)cast(intptr)desired); +} +gb_inline void *gb_atomic_ptr_exchanged(gbAtomicPtr volatile *a, void *desired) { + return cast(void *)cast(intptr)gb_atomic64_exchanged(cast(gbAtomic64 volatile *)a, cast(i64)cast(intptr)desired); +} +gb_inline void *gb_atomic_ptr_fetch_add(gbAtomicPtr volatile *a, void *operand) { + return cast(void *)cast(intptr)gb_atomic64_fetch_add(cast(gbAtomic64 volatile *)a, cast(i64)cast(intptr)operand); +} +gb_inline void *gb_atomic_ptr_fetch_and(gbAtomicPtr volatile *a, void *operand) { + return cast(void *)cast(intptr)gb_atomic64_fetch_and(cast(gbAtomic64 volatile *)a, cast(i64)cast(intptr)operand); +} +gb_inline void *gb_atomic_ptr_fetch_or(gbAtomicPtr volatile *a, void *operand) { + return cast(void *)cast(intptr)gb_atomic64_fetch_or(cast(gbAtomic64 volatile *)a, cast(i64)cast(intptr)operand); +} +gb_inline b32 gb_atomic_ptr_spin_lock(gbAtomicPtr volatile *a, isize time_out) { + return gb_atomic64_spin_lock(cast(gbAtomic64 volatile *)a, time_out); +} +gb_inline void gb_atomic_ptr_spin_unlock(gbAtomicPtr volatile *a) { + gb_atomic64_spin_unlock(cast(gbAtomic64 volatile *)a); +} +gb_inline b32 gb_atomic_ptr_try_acquire_lock(gbAtomicPtr volatile *a) { + return gb_atomic64_try_acquire_lock(cast(gbAtomic64 volatile *)a); +} +#endif + + +gb_inline void gb_yield_thread(void) { +#if defined(GB_SYSTEM_WINDOWS) + _mm_pause(); +#elif defined(GB_SYSTEM_OSX) + __asm__ volatile ("" : : : "memory"); +#elif defined(GB_CPU_X86) + _mm_pause(); +#else +#error Unknown architecture +#endif +} + +gb_inline void gb_mfence(void) { +#if defined(GB_SYSTEM_WINDOWS) + _ReadWriteBarrier(); +#elif defined(GB_SYSTEM_OSX) + __sync_synchronize(); +#elif defined(GB_CPU_X86) + _mm_mfence(); +#else +#error Unknown architecture +#endif +} + +gb_inline void gb_sfence(void) { +#if defined(GB_SYSTEM_WINDOWS) + _WriteBarrier(); +#elif defined(GB_SYSTEM_OSX) + __asm__ volatile ("" : : : "memory"); +#elif defined(GB_CPU_X86) + _mm_sfence(); +#else +#error Unknown architecture +#endif +} + +gb_inline void gb_lfence(void) { +#if defined(GB_SYSTEM_WINDOWS) + _ReadBarrier(); +#elif defined(GB_SYSTEM_OSX) + __asm__ volatile ("" : : : "memory"); +#elif defined(GB_CPU_X86) + _mm_lfence(); +#else +#error Unknown architecture +#endif +} + + +gb_inline void gb_semaphore_release(gbSemaphore *s) { gb_semaphore_post(s, 1); } + +#if defined(GB_SYSTEM_WINDOWS) + gb_inline void gb_semaphore_init (gbSemaphore *s) { s->win32_handle = CreateSemaphoreA(NULL, 0, I32_MAX, NULL); } + gb_inline void gb_semaphore_destroy(gbSemaphore *s) { CloseHandle(s->win32_handle); } + gb_inline void gb_semaphore_post (gbSemaphore *s, i32 count) { ReleaseSemaphore(s->win32_handle, count, NULL); } + gb_inline void gb_semaphore_wait (gbSemaphore *s) { WaitForSingleObject(s->win32_handle, INFINITE); } + +#elif defined(GB_SYSTEM_OSX) + gb_inline void gb_semaphore_init (gbSemaphore *s) { semaphore_create(mach_task_self(), &s->osx_handle, SYNC_POLICY_FIFO, 0); } + gb_inline void gb_semaphore_destroy(gbSemaphore *s) { semaphore_destroy(mach_task_self(), s->osx_handle); } + gb_inline void gb_semaphore_post (gbSemaphore *s, i32 count) { while (count --> 0) semaphore_signal(s->osx_handle); } + gb_inline void gb_semaphore_wait (gbSemaphore *s) { semaphore_wait(s->osx_handle); } + +#elif defined(GB_SYSTEM_UNIX) + gb_inline void gb_semaphore_init (gbSemaphore *s) { sem_init(&s->unix_handle, 0, 0); } + gb_inline void gb_semaphore_destroy(gbSemaphore *s) { sem_destroy(&s->unix_handle); } + gb_inline void gb_semaphore_post (gbSemaphore *s, i32 count) { while (count --> 0) sem_post(&s->unix_handle); } + gb_inline void gb_semaphore_wait (gbSemaphore *s) { int i; do { i = sem_wait(&s->unix_handle); } while (i == -1 && errno == EINTR); } + +#else +#error +#endif + +gb_inline void gb_mutex_init(gbMutex *m) { +#if defined(GB_SYSTEM_WINDOWS) + InitializeCriticalSection(&m->win32_critical_section); +#else + pthread_mutexattr_init(&m->pthread_mutexattr); + pthread_mutexattr_settype(&m->pthread_mutexattr, PTHREAD_MUTEX_RECURSIVE); + pthread_mutex_init(&m->pthread_mutex, &m->pthread_mutexattr); +#endif +} + +gb_inline void gb_mutex_destroy(gbMutex *m) { +#if defined(GB_SYSTEM_WINDOWS) + DeleteCriticalSection(&m->win32_critical_section); +#else + pthread_mutex_destroy(&m->pthread_mutex); +#endif +} + +gb_inline void gb_mutex_lock(gbMutex *m) { +#if defined(GB_SYSTEM_WINDOWS) + EnterCriticalSection(&m->win32_critical_section); +#else + pthread_mutex_lock(&m->pthread_mutex); +#endif +} + +gb_inline b32 gb_mutex_try_lock(gbMutex *m) { +#if defined(GB_SYSTEM_WINDOWS) + return TryEnterCriticalSection(&m->win32_critical_section) != 0; +#else + return pthread_mutex_trylock(&m->pthread_mutex) == 0; +#endif +} + +gb_inline void gb_mutex_unlock(gbMutex *m) { +#if defined(GB_SYSTEM_WINDOWS) + LeaveCriticalSection(&m->win32_critical_section); +#else + pthread_mutex_unlock(&m->pthread_mutex); +#endif +} + + + + + + + +void gb_thread_init(gbThread *t) { + gb_zero_item(t); +#if defined(GB_SYSTEM_WINDOWS) + t->win32_handle = INVALID_HANDLE_VALUE; +#else + t->posix_handle = 0; +#endif + gb_semaphore_init(&t->semaphore); +} + +void gb_thread_destroy(gbThread *t) { + if (t->is_running) gb_thread_join(t); + gb_semaphore_destroy(&t->semaphore); +} + + +gb_inline void gb__thread_run(gbThread *t) { + gb_semaphore_release(&t->semaphore); + t->return_value = t->proc(t); +} + +#if defined(GB_SYSTEM_WINDOWS) + gb_inline DWORD __stdcall gb__thread_proc(void *arg) { + gbThread *t = cast(gbThread *)arg; + gb__thread_run(t); + t->is_running = false; + return 0; + } +#else + gb_inline void * gb__thread_proc(void *arg) { + gbThread *t = cast(gbThread *)arg; + gb__thread_run(t); + t->is_running = false; + return NULL; + } +#endif + +gb_inline void gb_thread_start(gbThread *t, gbThreadProc *proc, void *user_data) { gb_thread_start_with_stack(t, proc, user_data, 0); } + +gb_inline void gb_thread_start_with_stack(gbThread *t, gbThreadProc *proc, void *user_data, isize stack_size) { + GB_ASSERT(!t->is_running); + GB_ASSERT(proc != NULL); + t->proc = proc; + t->user_data = user_data; + t->stack_size = stack_size; + t->is_running = true; + +#if defined(GB_SYSTEM_WINDOWS) + t->win32_handle = CreateThread(NULL, stack_size, gb__thread_proc, t, 0, NULL); + GB_ASSERT_MSG(t->win32_handle != NULL, "CreateThread: GetLastError"); +#else + { + pthread_attr_t attr; + pthread_attr_init(&attr); + pthread_attr_setdetachstate(&attr, PTHREAD_CREATE_JOINABLE); + if (stack_size != 0) { + pthread_attr_setstacksize(&attr, stack_size); + } + pthread_create(&t->posix_handle, &attr, gb__thread_proc, t); + pthread_attr_destroy(&attr); + } +#endif + + gb_semaphore_wait(&t->semaphore); +} + +gb_inline void gb_thread_join(gbThread *t) { + if (!t->is_running) return; + +#if defined(GB_SYSTEM_WINDOWS) + WaitForSingleObject(t->win32_handle, INFINITE); + CloseHandle(t->win32_handle); + t->win32_handle = INVALID_HANDLE_VALUE; +#else + pthread_join(t->posix_handle, NULL); + t->posix_handle = 0; +#endif + t->is_running = false; +} + +gb_inline b32 gb_thread_is_running(gbThread const *t) { return t->is_running != 0; } + +gb_inline u32 gb_thread_current_id(void) { + u32 thread_id; +#if defined(GB_SYSTEM_WINDOWS) + #if defined(GB_ARCH_32_BIT) && defined(GB_CPU_X86) + thread_id = (cast(u32 *)__readfsdword(24))[9]; + #elif defined(GB_ARCH_64_BIT) && defined(GB_CPU_X86) + thread_id = (cast(u32 *)__readgsqword(48))[18]; + #else + thread_id = GetCurrentThreadId(); + #endif + +#elif defined(GB_SYSTEM_OSX) && defined(GB_ARCH_64_BIT) + thread_id = pthread_mach_thread_np(pthread_self()); +#elif defined(GB_ARCH_32_BIT) && defined(GB_CPU_X86) + __asm__("mov %%gs:0x08,%0" : "=r"(thread_id)); +#elif defined(GB_ARCH_64_BIT) && defined(GB_CPU_X86) + __asm__("mov %%fs:0x10,%0" : "=r"(thread_id)); +#else + #error Unsupported architecture for gb_thread_current_id() +#endif + + return thread_id; +} + + + +void gb_thread_set_name(gbThread *t, char const *name) { +#if defined(GB_COMPILER_MSVC) + #pragma pack(push, 8) + typedef struct { + DWORD type; + char const *name; + DWORD id; + DWORD flags; + } gbprivThreadName; + #pragma pack(pop) + gbprivThreadName tn; + tn.type = 0x1000; + tn.name = name; + tn.id = GetThreadId(cast(HANDLE)t->win32_handle); + tn.flags = 0; + + __try { + RaiseException(0x406d1388, 0, gb_size_of(tn)/4, cast(ULONG_PTR *)&tn); + } __except(1 /*EXCEPTION_EXECUTE_HANDLER*/) { + } + +#elif defined(GB_SYSTEM_WINDOWS) && !defined(GB_COMPILER_MSVC) + // IMPORTANT TODO(bill): Set thread name for GCC/Clang on windows + return; +#elif defined(GB_SYSTEM_OSX) + // TODO(bill): Test if this works + pthread_setname_np(name); +#else + // TODO(bill): Test if this works + pthread_setname_np(t->posix_handle, name); +#endif +} + + + + +void gb_sync_init(gbSync *s) { + gb_zero_item(s); + gb_mutex_init(&s->mutex); + gb_mutex_init(&s->start); + gb_semaphore_init(&s->release); +} + +void gb_sync_destroy(gbSync *s) { + if (s->waiting) + GB_PANIC("Cannot destroy while threads are waiting!"); + + gb_mutex_destroy(&s->mutex); + gb_mutex_destroy(&s->start); + gb_semaphore_destroy(&s->release); +} + +void gb_sync_set_target(gbSync *s, i32 count) { + gb_mutex_lock(&s->start); + + gb_mutex_lock(&s->mutex); + GB_ASSERT(s->target == 0); + s->target = count; + s->current = 0; + s->waiting = 0; + gb_mutex_unlock(&s->mutex); +} + +void gb_sync_release(gbSync *s) { + if (s->waiting) { + gb_semaphore_release(&s->release); + } else { + s->target = 0; + gb_mutex_unlock(&s->start); + } +} + +i32 gb_sync_reach(gbSync *s) { + i32 n; + gb_mutex_lock(&s->mutex); + GB_ASSERT(s->current < s->target); + n = ++s->current; // NOTE(bill): Record this value to avoid possible race if `return s->current` was done + if (s->current == s->target) + gb_sync_release(s); + gb_mutex_unlock(&s->mutex); + return n; +} + +void gb_sync_reach_and_wait(gbSync *s) { + gb_mutex_lock(&s->mutex); + GB_ASSERT(s->current < s->target); + s->current++; + if (s->current == s->target) { + gb_sync_release(s); + gb_mutex_unlock(&s->mutex); + } else { + s->waiting++; // NOTE(bill): Waiting, so one more waiter + gb_mutex_unlock(&s->mutex); // NOTE(bill): Release the mutex to other threads + + gb_semaphore_wait(&s->release); // NOTE(bill): Wait for merge completion + + gb_mutex_lock(&s->mutex); // NOTE(bill): On merge completion, lock mutex + s->waiting--; // NOTE(bill): Done waiting + gb_sync_release(s); // NOTE(bill): Restart the next waiter + gb_mutex_unlock(&s->mutex); + } +} + + + + + + + + +gb_inline gbAllocator gb_heap_allocator(void) { + gbAllocator a; + a.proc = gb_heap_allocator_proc; + a.data = NULL; + return a; +} + +GB_ALLOCATOR_PROC(gb_heap_allocator_proc) { + void *ptr = NULL; + gb_unused(allocator_data); + gb_unused(old_size); +// TODO(bill): Throughly test! + switch (type) { +#if defined(GB_COMPILER_MSVC) + case gbAllocation_Alloc: + ptr = _aligned_malloc(size, alignment); + if (flags & gbAllocatorFlag_ClearToZero) + gb_zero_size(ptr, size); + break; + case gbAllocation_Free: + _aligned_free(old_memory); + break; + case gbAllocation_Resize: + ptr = _aligned_realloc(old_memory, size, alignment); + break; + +#elif defined(GB_SYSTEM_LINUX) + // TODO(bill): *nix version that's decent + case gbAllocation_Alloc: { + ptr = aligned_alloc(alignment, size); + // ptr = malloc(size+alignment); + + if (flags & gbAllocatorFlag_ClearToZero) { + gb_zero_size(ptr, size); + } + } break; + + case gbAllocation_Free: { + free(old_memory); + } break; + + case gbAllocation_Resize: { + // ptr = realloc(old_memory, size); + ptr = gb_default_resize_align(gb_heap_allocator(), old_memory, old_size, size, alignment); + } break; +#else + // TODO(bill): *nix version that's decent + case gbAllocation_Alloc: { + posix_memalign(&ptr, alignment, size); + + if (flags & gbAllocatorFlag_ClearToZero) { + gb_zero_size(ptr, size); + } + } break; + + case gbAllocation_Free: { + free(old_memory); + } break; + + case gbAllocation_Resize: { + ptr = gb_default_resize_align(gb_heap_allocator(), old_memory, old_size, size, alignment); + } break; +#endif + + case gbAllocation_FreeAll: + break; + } + + return ptr; +} + + +#if defined(GB_SYSTEM_WINDOWS) +void gb_affinity_init(gbAffinity *a) { + SYSTEM_LOGICAL_PROCESSOR_INFORMATION *start_processor_info = NULL; + DWORD length = 0; + b32 result = GetLogicalProcessorInformation(NULL, &length); + + gb_zero_item(a); + + if (!result && GetLastError() == 122l /*ERROR_INSUFFICIENT_BUFFER*/ && length > 0) { + start_processor_info = cast(SYSTEM_LOGICAL_PROCESSOR_INFORMATION *)gb_alloc(gb_heap_allocator(), length); + result = GetLogicalProcessorInformation(start_processor_info, &length); + if (result) { + SYSTEM_LOGICAL_PROCESSOR_INFORMATION *end_processor_info, *processor_info; + + a->is_accurate = true; + a->core_count = 0; + a->thread_count = 0; + end_processor_info = cast(SYSTEM_LOGICAL_PROCESSOR_INFORMATION *)gb_pointer_add(start_processor_info, length); + + for (processor_info = start_processor_info; + processor_info < end_processor_info; + processor_info++) { + if (processor_info->Relationship == RelationProcessorCore) { + isize thread = gb_count_set_bits(processor_info->ProcessorMask); + if (thread == 0) { + a->is_accurate = false; + } else if (a->thread_count + thread > GB_WIN32_MAX_THREADS) { + a->is_accurate = false; + } else { + GB_ASSERT(a->core_count <= a->thread_count && + a->thread_count < GB_WIN32_MAX_THREADS); + a->core_masks[a->core_count++] = processor_info->ProcessorMask; + a->thread_count += thread; + } + } + } + } + + gb_free(gb_heap_allocator(), start_processor_info); + } + + GB_ASSERT(a->core_count <= a->thread_count); + if (a->thread_count == 0) { + a->is_accurate = false; + a->core_count = 1; + a->thread_count = 1; + a->core_masks[0] = 1; + } + +} +void gb_affinity_destroy(gbAffinity *a) { + gb_unused(a); +} + + +b32 gb_affinity_set(gbAffinity *a, isize core, isize thread) { + usize available_mask, check_mask = 1; + GB_ASSERT(thread < gb_affinity_thread_count_for_core(a, core)); + + available_mask = a->core_masks[core]; + for (;;) { + if ((available_mask & check_mask) != 0) { + if (thread-- == 0) { + usize result = SetThreadAffinityMask(GetCurrentThread(), check_mask); + return result != 0; + } + } + check_mask <<= 1; // NOTE(bill): Onto the next bit + } +} + +isize gb_affinity_thread_count_for_core(gbAffinity *a, isize core) { + GB_ASSERT(core >= 0 && core < a->core_count); + return gb_count_set_bits(a->core_masks[core]); +} + +#elif defined(GB_SYSTEM_OSX) +void gb_affinity_init(gbAffinity *a) { + usize count = 0; + usize count_size = sizeof(count); + + a->is_accurate = false; + a->thread_count = 1; + a->core_count = 1; + a->threads_per_core = 1; + + if (sysctlbyname("hw.logicalcpu", &count, &count_size, NULL, 0) == 0) { + if (count > 0) { + a->thread_count = count; + // Get # of physical cores + if (sysctlbyname("hw.physicalcpu", &count, &count_size, NULL, 0) == 0) { + if (count > 0) { + a->core_count = count; + a->threads_per_core = a->thread_count / count; + if (a->threads_per_core < 1) + a->threads_per_core = 1; + else + a->is_accurate = true; + } + } + } + } + +} + +void gb_affinity_destroy(gbAffinity *a) { + gb_unused(a); +} + +b32 gb_affinity_set(gbAffinity *a, isize core, isize thread_index) { + isize index; + thread_t thread; + thread_affinity_policy_data_t info; + kern_return_t result; + + GB_ASSERT(core < a->core_count); + GB_ASSERT(thread_index < a->threads_per_core); + + index = core * a->threads_per_core + thread_index; + thread = mach_thread_self(); + info.affinity_tag = cast(integer_t)index; + result = thread_policy_set(thread, THREAD_AFFINITY_POLICY, cast(thread_policy_t)&info, THREAD_AFFINITY_POLICY_COUNT); + return result == KERN_SUCCESS; +} + +isize gb_affinity_thread_count_for_core(gbAffinity *a, isize core) { + GB_ASSERT(core >= 0 && core < a->core_count); + return a->threads_per_core; +} + +#elif defined(GB_SYSTEM_LINUX) +// IMPORTANT TODO(bill): This gbAffinity stuff for linux needs be improved a lot! +// NOTE(zangent): I have to read /proc/cpuinfo to get the number of threads per core. +#include + +void gb_affinity_init(gbAffinity *a) { + b32 accurate = true; + isize threads = 0; + + a->thread_count = 1; + a->core_count = sysconf(_SC_NPROCESSORS_ONLN); + a->threads_per_core = 1; + + + if(a->core_count <= 0) { + a->core_count = 1; + accurate = false; + } + + // Parsing /proc/cpuinfo to get the number of threads per core. + // NOTE(zangent): This calls the CPU's threads "cores", although the wording + // is kind of weird. This should be right, though. + + FILE* cpu_info = fopen("/proc/cpuinfo", "r"); + + if (cpu_info != NULL) { + for (;;) { + // The 'temporary char'. Everything goes into this char, + // so that we can check against EOF at the end of this loop. + char c; + +#define AF__CHECK(letter) ((c = getc(cpu_info)) == letter) + if (AF__CHECK('c') && AF__CHECK('p') && AF__CHECK('u') && AF__CHECK(' ') && + AF__CHECK('c') && AF__CHECK('o') && AF__CHECK('r') && AF__CHECK('e') && AF__CHECK('s')) { + // We're on a CPU info line. + while (!AF__CHECK(EOF)) { + if (c == '\n') { + break; + } else if (c < '0' || '9' > c) { + continue; + } + threads = threads * 10 + (c - '0'); + } + break; + } else { + while (!AF__CHECK('\n')) { + if (c==EOF) { + break; + } + } + } + if (c == EOF) { + break; + } +#undef AF__CHECK + } + + fclose(cpu_info); + } + + if (threads == 0) { + threads = 1; + accurate = false; + } + + a->threads_per_core = threads; + a->thread_count = a->threads_per_core * a->core_count; + a->is_accurate = accurate; + +} + +void gb_affinity_destroy(gbAffinity *a) { + gb_unused(a); +} + +b32 gb_affinity_set(gbAffinity *a, isize core, isize thread_index) { + return true; +} + +isize gb_affinity_thread_count_for_core(gbAffinity *a, isize core) { + GB_ASSERT(0 <= core && core < a->core_count); + return a->threads_per_core; +} +#else +#error TODO(bill): Unknown system +#endif + + + + + + + + + +//////////////////////////////////////////////////////////////// +// +// Virtual Memory +// +// + +gbVirtualMemory gb_virtual_memory(void *data, isize size) { + gbVirtualMemory vm; + vm.data = data; + vm.size = size; + return vm; +} + + +#if defined(GB_SYSTEM_WINDOWS) +gb_inline gbVirtualMemory gb_vm_alloc(void *addr, isize size) { + gbVirtualMemory vm; + GB_ASSERT(size > 0); + vm.data = VirtualAlloc(addr, size, MEM_COMMIT | MEM_RESERVE, PAGE_READWRITE); + vm.size = size; + return vm; +} + +gb_inline b32 gb_vm_free(gbVirtualMemory vm) { + MEMORY_BASIC_INFORMATION info; + while (vm.size > 0) { + if (VirtualQuery(vm.data, &info, gb_size_of(info)) == 0) + return false; + if (info.BaseAddress != vm.data || + info.AllocationBase != vm.data || + info.State != MEM_COMMIT || info.RegionSize > cast(usize)vm.size) { + return false; + } + if (VirtualFree(vm.data, 0, MEM_RELEASE) == 0) + return false; + vm.data = gb_pointer_add(vm.data, info.RegionSize); + vm.size -= info.RegionSize; + } + return true; +} + +gb_inline gbVirtualMemory gb_vm_trim(gbVirtualMemory vm, isize lead_size, isize size) { + gbVirtualMemory new_vm = {0}; + void *ptr; + GB_ASSERT(vm.size >= lead_size + size); + + ptr = gb_pointer_add(vm.data, lead_size); + + gb_vm_free(vm); + new_vm = gb_vm_alloc(ptr, size); + if (new_vm.data == ptr) + return new_vm; + if (new_vm.data) + gb_vm_free(new_vm); + return new_vm; +} + +gb_inline b32 gb_vm_purge(gbVirtualMemory vm) { + VirtualAlloc(vm.data, vm.size, MEM_RESET, PAGE_READWRITE); + // NOTE(bill): Can this really fail? + return true; +} + +isize gb_virtual_memory_page_size(isize *alignment_out) { + SYSTEM_INFO info; + GetSystemInfo(&info); + if (alignment_out) *alignment_out = info.dwAllocationGranularity; + return info.dwPageSize; +} + +#else + +#ifndef MAP_ANONYMOUS +#define MAP_ANONYMOUS MAP_ANON +#endif + +gb_inline gbVirtualMemory gb_vm_alloc(void *addr, isize size) { + gbVirtualMemory vm; + GB_ASSERT(size > 0); + vm.data = mmap(addr, size, PROT_READ | PROT_WRITE, MAP_ANONYMOUS | MAP_PRIVATE, -1, 0); + vm.size = size; + return vm; +} + +gb_inline b32 gb_vm_free(gbVirtualMemory vm) { + munmap(vm.data, vm.size); + return true; +} + +gb_inline gbVirtualMemory gb_vm_trim(gbVirtualMemory vm, isize lead_size, isize size) { + void *ptr; + isize trail_size; + GB_ASSERT(vm.size >= lead_size + size); + + ptr = gb_pointer_add(vm.data, lead_size); + trail_size = vm.size - lead_size - size; + + if (lead_size != 0) + gb_vm_free(gb_virtual_memory(vm.data, lead_size)); + if (trail_size != 0) + gb_vm_free(gb_virtual_memory(ptr, trail_size)); + return gb_virtual_memory(ptr, size); + +} + +gb_inline b32 gb_vm_purge(gbVirtualMemory vm) { + int err = madvise(vm.data, vm.size, MADV_DONTNEED); + return err != 0; +} + +isize gb_virtual_memory_page_size(isize *alignment_out) { + // TODO(bill): Is this always true? + isize result = cast(isize)sysconf(_SC_PAGE_SIZE); + if (alignment_out) *alignment_out = result; + return result; +} + +#endif + + + + +//////////////////////////////////////////////////////////////// +// +// Custom Allocation +// +// + + +// +// Arena Allocator +// + +gb_inline void gb_arena_init_from_memory(gbArena *arena, void *start, isize size) { + arena->backing.proc = NULL; + arena->backing.data = NULL; + arena->physical_start = start; + arena->total_size = size; + arena->total_allocated = 0; + arena->temp_count = 0; +} + +gb_inline void gb_arena_init_from_allocator(gbArena *arena, gbAllocator backing, isize size) { + arena->backing = backing; + arena->physical_start = gb_alloc(backing, size); // NOTE(bill): Uses default alignment + arena->total_size = size; + arena->total_allocated = 0; + arena->temp_count = 0; +} + +gb_inline void gb_arena_init_sub(gbArena *arena, gbArena *parent_arena, isize size) { gb_arena_init_from_allocator(arena, gb_arena_allocator(parent_arena), size); } + + +gb_inline void gb_arena_free(gbArena *arena) { + if (arena->backing.proc) { + gb_free(arena->backing, arena->physical_start); + arena->physical_start = NULL; + } +} + + +gb_inline isize gb_arena_alignment_of(gbArena *arena, isize alignment) { + isize alignment_offset, result_pointer, mask; + GB_ASSERT(gb_is_power_of_two(alignment)); + + alignment_offset = 0; + result_pointer = cast(isize)arena->physical_start + arena->total_allocated; + mask = alignment - 1; + if (result_pointer & mask) + alignment_offset = alignment - (result_pointer & mask); + + return alignment_offset; +} + +gb_inline isize gb_arena_size_remaining(gbArena *arena, isize alignment) { + isize result = arena->total_size - (arena->total_allocated + gb_arena_alignment_of(arena, alignment)); + return result; +} + +gb_inline void gb_arena_check(gbArena *arena) { GB_ASSERT(arena->temp_count == 0); } + + + + + + +gb_inline gbAllocator gb_arena_allocator(gbArena *arena) { + gbAllocator allocator; + allocator.proc = gb_arena_allocator_proc; + allocator.data = arena; + return allocator; +} + +GB_ALLOCATOR_PROC(gb_arena_allocator_proc) { + gbArena *arena = cast(gbArena *)allocator_data; + void *ptr = NULL; + + gb_unused(old_size); + + switch (type) { + case gbAllocation_Alloc: { + void *end = gb_pointer_add(arena->physical_start, arena->total_allocated); + isize total_size = size + alignment; + + // NOTE(bill): Out of memory + if (arena->total_allocated + total_size > cast(isize)arena->total_size) { + gb_printf_err("Arena out of memory\n"); + return NULL; + } + + ptr = gb_align_forward(end, alignment); + arena->total_allocated += total_size; + if (flags & gbAllocatorFlag_ClearToZero) + gb_zero_size(ptr, size); + } break; + + case gbAllocation_Free: + // NOTE(bill): Free all at once + // Use Temp_Arena_Memory if you want to free a block + break; + + case gbAllocation_FreeAll: + arena->total_allocated = 0; + break; + + case gbAllocation_Resize: { + // TODO(bill): Check if ptr is on top of stack and just extend + gbAllocator a = gb_arena_allocator(arena); + ptr = gb_default_resize_align(a, old_memory, old_size, size, alignment); + } break; + } + return ptr; +} + + +gb_inline gbTempArenaMemory gb_temp_arena_memory_begin(gbArena *arena) { + gbTempArenaMemory tmp; + tmp.arena = arena; + tmp.original_count = arena->total_allocated; + arena->temp_count++; + return tmp; +} + +gb_inline void gb_temp_arena_memory_end(gbTempArenaMemory tmp) { + GB_ASSERT_MSG(tmp.arena->total_allocated >= tmp.original_count, + "%td >= %td", tmp.arena->total_allocated, tmp.original_count); + GB_ASSERT(tmp.arena->temp_count > 0); + tmp.arena->total_allocated = tmp.original_count; + tmp.arena->temp_count--; +} + + + + +// +// Pool Allocator +// + + +gb_inline void gb_pool_init(gbPool *pool, gbAllocator backing, isize num_blocks, isize block_size) { + gb_pool_init_align(pool, backing, num_blocks, block_size, GB_DEFAULT_MEMORY_ALIGNMENT); +} + +void gb_pool_init_align(gbPool *pool, gbAllocator backing, isize num_blocks, isize block_size, isize block_align) { + isize actual_block_size, pool_size, block_index; + void *data, *curr; + uintptr *end; + + gb_zero_item(pool); + + pool->backing = backing; + pool->block_size = block_size; + pool->block_align = block_align; + + actual_block_size = block_size + block_align; + pool_size = num_blocks * actual_block_size; + + data = gb_alloc_align(backing, pool_size, block_align); + + // NOTE(bill): Init intrusive freelist + curr = data; + for (block_index = 0; block_index < num_blocks-1; block_index++) { + uintptr *next = cast(uintptr *)curr; + *next = cast(uintptr)curr + actual_block_size; + curr = gb_pointer_add(curr, actual_block_size); + } + + end = cast(uintptr *)curr; + *end = cast(uintptr)NULL; + + pool->physical_start = data; + pool->free_list = data; +} + +gb_inline void gb_pool_free(gbPool *pool) { + if (pool->backing.proc) { + gb_free(pool->backing, pool->physical_start); + } +} + + +gb_inline gbAllocator gb_pool_allocator(gbPool *pool) { + gbAllocator allocator; + allocator.proc = gb_pool_allocator_proc; + allocator.data = pool; + return allocator; +} +GB_ALLOCATOR_PROC(gb_pool_allocator_proc) { + gbPool *pool = cast(gbPool *)allocator_data; + void *ptr = NULL; + + gb_unused(old_size); + + switch (type) { + case gbAllocation_Alloc: { + uintptr next_free; + GB_ASSERT(size == pool->block_size); + GB_ASSERT(alignment == pool->block_align); + GB_ASSERT(pool->free_list != NULL); + + next_free = *cast(uintptr *)pool->free_list; + ptr = pool->free_list; + pool->free_list = cast(void *)next_free; + pool->total_size += pool->block_size; + if (flags & gbAllocatorFlag_ClearToZero) + gb_zero_size(ptr, size); + } break; + + case gbAllocation_Free: { + uintptr *next; + if (old_memory == NULL) return NULL; + + next = cast(uintptr *)old_memory; + *next = cast(uintptr)pool->free_list; + pool->free_list = old_memory; + pool->total_size -= pool->block_size; + } break; + + case gbAllocation_FreeAll: + // TODO(bill): + break; + + case gbAllocation_Resize: + // NOTE(bill): Cannot resize + GB_PANIC("You cannot resize something allocated by with a pool."); + break; + } + + return ptr; +} + + + + + +gb_inline gbAllocationHeader *gb_allocation_header(void *data) { + isize *p = cast(isize *)data; + while (p[-1] == cast(isize)(-1)) { + p--; + } + return cast(gbAllocationHeader *)p - 1; +} + +gb_inline void gb_allocation_header_fill(gbAllocationHeader *header, void *data, isize size) { + isize *ptr; + header->size = size; + ptr = cast(isize *)(header + 1); + while (cast(void *)ptr < data) { + *ptr++ = cast(isize)(-1); + } +} + + + +// +// Free List Allocator +// + +gb_inline void gb_free_list_init(gbFreeList *fl, void *start, isize size) { + GB_ASSERT(size > gb_size_of(gbFreeListBlock)); + + fl->physical_start = start; + fl->total_size = size; + fl->curr_block = cast(gbFreeListBlock *)start; + fl->curr_block->size = size; + fl->curr_block->next = NULL; +} + + +gb_inline void gb_free_list_init_from_allocator(gbFreeList *fl, gbAllocator backing, isize size) { + void *start = gb_alloc(backing, size); + gb_free_list_init(fl, start, size); +} + + + +gb_inline gbAllocator gb_free_list_allocator(gbFreeList *fl) { + gbAllocator a; + a.proc = gb_free_list_allocator_proc; + a.data = fl; + return a; +} + +GB_ALLOCATOR_PROC(gb_free_list_allocator_proc) { + gbFreeList *fl = cast(gbFreeList *)allocator_data; + void *ptr = NULL; + + GB_ASSERT_NOT_NULL(fl); + + switch (type) { + case gbAllocation_Alloc: { + gbFreeListBlock *prev_block = NULL; + gbFreeListBlock *curr_block = fl->curr_block; + + while (curr_block) { + isize total_size; + gbAllocationHeader *header; + + total_size = size + alignment + gb_size_of(gbAllocationHeader); + + if (curr_block->size < total_size) { + prev_block = curr_block; + curr_block = curr_block->next; + continue; + } + + if (curr_block->size - total_size <= gb_size_of(gbAllocationHeader)) { + total_size = curr_block->size; + + if (prev_block) + prev_block->next = curr_block->next; + else + fl->curr_block = curr_block->next; + } else { + // NOTE(bill): Create a new block for the remaining memory + gbFreeListBlock *next_block; + next_block = cast(gbFreeListBlock *)gb_pointer_add(curr_block, total_size); + + GB_ASSERT(cast(void *)next_block < gb_pointer_add(fl->physical_start, fl->total_size)); + + next_block->size = curr_block->size - total_size; + next_block->next = curr_block->next; + + if (prev_block) + prev_block->next = next_block; + else + fl->curr_block = next_block; + } + + + // TODO(bill): Set Header Info + header = cast(gbAllocationHeader *)curr_block; + ptr = gb_align_forward(header+1, alignment); + gb_allocation_header_fill(header, ptr, size); + + fl->total_allocated += total_size; + fl->allocation_count++; + + + if (flags & gbAllocatorFlag_ClearToZero) + gb_zero_size(ptr, size); + return ptr; + } + // NOTE(bill): if ptr == NULL, ran out of free list memory! FUCK! + return NULL; + } break; + + case gbAllocation_Free: { + gbAllocationHeader *header = gb_allocation_header(old_memory); + isize block_size = header->size; + uintptr block_start, block_end; + gbFreeListBlock *prev_block = NULL; + gbFreeListBlock *curr_block = fl->curr_block; + + block_start = cast(uintptr)header; + block_end = cast(uintptr)block_start + block_size; + + while (curr_block) { + if (cast(uintptr)curr_block >= block_end) + break; + prev_block = curr_block; + curr_block = curr_block->next; + } + + if (prev_block == NULL) { + prev_block = cast(gbFreeListBlock *)block_start; + prev_block->size = block_size; + prev_block->next = fl->curr_block; + + fl->curr_block = prev_block; + } else if ((cast(uintptr)prev_block + prev_block->size) == block_start) { + prev_block->size += block_size; + } else { + gbFreeListBlock *tmp = cast(gbFreeListBlock *)block_start; + tmp->size = block_size; + tmp->next = prev_block->next; + prev_block->next = tmp; + + prev_block = tmp; + } + + if (curr_block && (cast(uintptr)curr_block == block_end)) { + prev_block->size += curr_block->size; + prev_block->next = curr_block->next; + } + + fl->allocation_count--; + fl->total_allocated -= block_size; + } break; + + case gbAllocation_FreeAll: + gb_free_list_init(fl, fl->physical_start, fl->total_size); + break; + + case gbAllocation_Resize: + ptr = gb_default_resize_align(gb_free_list_allocator(fl), old_memory, old_size, size, alignment); + break; + } + + return ptr; +} + + + +void gb_scratch_memory_init(gbScratchMemory *s, void *start, isize size) { + s->physical_start = start; + s->total_size = size; + s->alloc_point = start; + s->free_point = start; +} + + +b32 gb_scratch_memory_is_in_use(gbScratchMemory *s, void *ptr) { + if (s->free_point == s->alloc_point) return false; + if (s->alloc_point > s->free_point) + return ptr >= s->free_point && ptr < s->alloc_point; + return ptr >= s->free_point || ptr < s->alloc_point; +} + + +gbAllocator gb_scratch_allocator(gbScratchMemory *s) { + gbAllocator a; + a.proc = gb_scratch_allocator_proc; + a.data = s; + return a; +} + +GB_ALLOCATOR_PROC(gb_scratch_allocator_proc) { + gbScratchMemory *s = cast(gbScratchMemory *)allocator_data; + void *ptr = NULL; + GB_ASSERT_NOT_NULL(s); + + switch (type) { + case gbAllocation_Alloc: { + void *pt = s->alloc_point; + gbAllocationHeader *header = cast(gbAllocationHeader *)pt; + void *data = gb_align_forward(header+1, alignment); + void *end = gb_pointer_add(s->physical_start, s->total_size); + + GB_ASSERT(alignment % 4 == 0); + size = ((size + 3)/4)*4; + pt = gb_pointer_add(pt, size); + + // NOTE(bill): Wrap around + if (pt > end) { + header->size = gb_pointer_diff(header, end) | GB_ISIZE_HIGH_BIT; + pt = s->physical_start; + header = cast(gbAllocationHeader *)pt; + data = gb_align_forward(header+1, alignment); + pt = gb_pointer_add(pt, size); + } + + if (!gb_scratch_memory_is_in_use(s, pt)) { + gb_allocation_header_fill(header, pt, gb_pointer_diff(header, pt)); + s->alloc_point = cast(u8 *)pt; + ptr = data; + } + + if (flags & gbAllocatorFlag_ClearToZero) + gb_zero_size(ptr, size); + } break; + + case gbAllocation_Free: { + if (old_memory) { + void *end = gb_pointer_add(s->physical_start, s->total_size); + if (old_memory < s->physical_start || old_memory >= end) { + GB_ASSERT(false); + } else { + // NOTE(bill): Mark as free + gbAllocationHeader *h = gb_allocation_header(old_memory); + GB_ASSERT((h->size & GB_ISIZE_HIGH_BIT) == 0); + h->size = h->size | GB_ISIZE_HIGH_BIT; + + while (s->free_point != s->alloc_point) { + gbAllocationHeader *header = cast(gbAllocationHeader *)s->free_point; + if ((header->size & GB_ISIZE_HIGH_BIT) == 0) + break; + + s->free_point = gb_pointer_add(s->free_point, h->size & (~GB_ISIZE_HIGH_BIT)); + if (s->free_point == end) + s->free_point = s->physical_start; + } + } + } + } break; + + case gbAllocation_FreeAll: + s->alloc_point = s->physical_start; + s->free_point = s->physical_start; + break; + + case gbAllocation_Resize: + ptr = gb_default_resize_align(gb_scratch_allocator(s), old_memory, old_size, size, alignment); + break; + } + + return ptr; +} + + + + + + +//////////////////////////////////////////////////////////////// +// +// Sorting +// +// + +// TODO(bill): Should I make all the macros local? + +#define GB__COMPARE_PROC(Type) \ +gb_global isize gb__##Type##_cmp_offset; GB_COMPARE_PROC(gb__##Type##_cmp) { \ + Type const p = *cast(Type const *)gb_pointer_add_const(a, gb__##Type##_cmp_offset); \ + Type const q = *cast(Type const *)gb_pointer_add_const(b, gb__##Type##_cmp_offset); \ + return p < q ? -1 : p > q; \ +} \ +GB_COMPARE_PROC_PTR(gb_##Type##_cmp(isize offset)) { \ + gb__##Type##_cmp_offset = offset; \ + return &gb__##Type##_cmp; \ +} + + +GB__COMPARE_PROC(i16); +GB__COMPARE_PROC(i32); +GB__COMPARE_PROC(i64); +GB__COMPARE_PROC(isize); +GB__COMPARE_PROC(f32); +GB__COMPARE_PROC(f64); +GB__COMPARE_PROC(char); + +// NOTE(bill): str_cmp is special as it requires a funny type and funny comparison +gb_global isize gb__str_cmp_offset; GB_COMPARE_PROC(gb__str_cmp) { + char const *p = *cast(char const **)gb_pointer_add_const(a, gb__str_cmp_offset); + char const *q = *cast(char const **)gb_pointer_add_const(b, gb__str_cmp_offset); + return gb_strcmp(p, q); +} +GB_COMPARE_PROC_PTR(gb_str_cmp(isize offset)) { + gb__str_cmp_offset = offset; + return &gb__str_cmp; +} + +#undef GB__COMPARE_PROC + + + + +// TODO(bill): Make user definable? +#define GB__SORT_STACK_SIZE 64 +#define GB__SORT_INSERT_SORT_THRESHOLD 8 + +#define GB__SORT_PUSH(_base, _limit) do { \ + stack_ptr[0] = (_base); \ + stack_ptr[1] = (_limit); \ + stack_ptr += 2; \ +} while (0) + + +#define GB__SORT_POP(_base, _limit) do { \ + stack_ptr -= 2; \ + (_base) = stack_ptr[0]; \ + (_limit) = stack_ptr[1]; \ +} while (0) + + + +void gb_sort(void *base_, isize count, isize size, gbCompareProc cmp) { + u8 *i, *j; + u8 *base = cast(u8 *)base_; + u8 *limit = base + count*size; + isize threshold = GB__SORT_INSERT_SORT_THRESHOLD * size; + + // NOTE(bill): Prepare the stack + u8 *stack[GB__SORT_STACK_SIZE] = {0}; + u8 **stack_ptr = stack; + + for (;;) { + if ((limit-base) > threshold) { + // NOTE(bill): Quick sort + i = base + size; + j = limit - size; + + gb_memswap(((limit-base)/size/2) * size + base, base, size); + if (cmp(i, j) > 0) gb_memswap(i, j, size); + if (cmp(base, j) > 0) gb_memswap(base, j, size); + if (cmp(i, base) > 0) gb_memswap(i, base, size); + + for (;;) { + do i += size; while (cmp(i, base) < 0); + do j -= size; while (cmp(j, base) > 0); + if (i > j) break; + gb_memswap(i, j, size); + } + + gb_memswap(base, j, size); + + if (j - base > limit - i) { + GB__SORT_PUSH(base, j); + base = i; + } else { + GB__SORT_PUSH(i, limit); + limit = j; + } + } else { + // NOTE(bill): Insertion sort + for (j = base, i = j+size; + i < limit; + j = i, i += size) { + for (; cmp(j, j+size) > 0; j -= size) { + gb_memswap(j, j+size, size); + if (j == base) break; + } + } + + if (stack_ptr == stack) break; // NOTE(bill): Sorting is done! + GB__SORT_POP(base, limit); + } + } +} + +#undef GB__SORT_PUSH +#undef GB__SORT_POP + + +#define GB_RADIX_SORT_PROC_GEN(Type) GB_RADIX_SORT_PROC(Type) { \ + Type *source = items; \ + Type *dest = temp; \ + isize byte_index, i, byte_max = 8*gb_size_of(Type); \ + for (byte_index = 0; byte_index < byte_max; byte_index += 8) { \ + isize offsets[256] = {0}; \ + isize total = 0; \ + /* NOTE(bill): First pass - count how many of each key */ \ + for (i = 0; i < count; i++) { \ + Type radix_value = source[i]; \ + Type radix_piece = (radix_value >> byte_index) & 0xff; \ + offsets[radix_piece]++; \ + } \ + /* NOTE(bill): Change counts to offsets */ \ + for (i = 0; i < gb_count_of(offsets); i++) { \ + isize skcount = offsets[i]; \ + offsets[i] = total; \ + total += skcount; \ + } \ + /* NOTE(bill): Second pass - place elements into the right location */ \ + for (i = 0; i < count; i++) { \ + Type radix_value = source[i]; \ + Type radix_piece = (radix_value >> byte_index) & 0xff; \ + dest[offsets[radix_piece]++] = source[i]; \ + } \ + gb_swap(Type *, source, dest); \ + } \ +} + +GB_RADIX_SORT_PROC_GEN(u8); +GB_RADIX_SORT_PROC_GEN(u16); +GB_RADIX_SORT_PROC_GEN(u32); +GB_RADIX_SORT_PROC_GEN(u64); + +gb_inline isize gb_binary_search(void const *base, isize count, isize size, void const *key, gbCompareProc compare_proc) { + isize start = 0; + isize end = count; + + while (start < end) { + isize mid = start + (end-start)/2; + isize result = compare_proc(key, cast(u8 *)base + mid*size); + if (result < 0) + end = mid; + else if (result > 0) + start = mid+1; + else + return mid; + } + + return -1; +} + +void gb_shuffle(void *base, isize count, isize size) { + u8 *a; + isize i, j; + gbRandom random; gb_random_init(&random); + + a = cast(u8 *)base + (count-1) * size; + for (i = count; i > 1; i--) { + j = gb_random_gen_isize(&random) % i; + gb_memswap(a, cast(u8 *)base + j*size, size); + a -= size; + } +} + +void gb_reverse(void *base, isize count, isize size) { + isize i, j = count-1; + for (i = 0; i < j; i++, j++) { + gb_memswap(cast(u8 *)base + i*size, cast(u8 *)base + j*size, size); + } +} + + + +//////////////////////////////////////////////////////////////// +// +// Char things +// +// + + + + +gb_inline char gb_char_to_lower(char c) { + if (c >= 'A' && c <= 'Z') + return 'a' + (c - 'A'); + return c; +} + +gb_inline char gb_char_to_upper(char c) { + if (c >= 'a' && c <= 'z') + return 'A' + (c - 'a'); + return c; +} + +gb_inline b32 gb_char_is_space(char c) { + if (c == ' ' || + c == '\t' || + c == '\n' || + c == '\r' || + c == '\f' || + c == '\v') + return true; + return false; +} + +gb_inline b32 gb_char_is_digit(char c) { + if (c >= '0' && c <= '9') + return true; + return false; +} + +gb_inline b32 gb_char_is_hex_digit(char c) { + if (gb_char_is_digit(c) || + (c >= 'a' && c <= 'f') || + (c >= 'A' && c <= 'F')) + return true; + return false; +} + +gb_inline b32 gb_char_is_alpha(char c) { + if ((c >= 'A' && c <= 'Z') || + (c >= 'a' && c <= 'z')) + return true; + return false; +} + +gb_inline b32 gb_char_is_alphanumeric(char c) { + return gb_char_is_alpha(c) || gb_char_is_digit(c); +} + +gb_inline i32 gb_digit_to_int(char c) { + return gb_char_is_digit(c) ? c - '0' : c - 'W'; +} + +gb_inline i32 gb_hex_digit_to_int(char c) { + if (gb_char_is_digit(c)) + return gb_digit_to_int(c); + else if (gb_is_between(c, 'a', 'f')) + return c - 'a' + 10; + else if (gb_is_between(c, 'A', 'F')) + return c - 'A' + 10; + return -1; +} + + + + +gb_inline void gb_str_to_lower(char *str) { + if (!str) return; + while (*str) { + *str = gb_char_to_lower(*str); + str++; + } +} + +gb_inline void gb_str_to_upper(char *str) { + if (!str) return; + while (*str) { + *str = gb_char_to_upper(*str); + str++; + } +} + + +gb_inline isize gb_strlen(char const *str) { + char const *begin = str; + isize const *w; + if (str == NULL) { + return 0; + } + while (cast(uintptr)str % sizeof(usize)) { + if (!*str) + return str - begin; + str++; + } + w = cast(isize const *)str; + while (!GB__HAS_ZERO(*w)) { + w++; + } + str = cast(char const *)w; + while (*str) { + str++; + } + return str - begin; +} + +gb_inline isize gb_strnlen(char const *str, isize max_len) { + char const *end = cast(char const *)gb_memchr(str, 0, max_len); + if (end) { + return end - str; + } + return max_len; +} + +gb_inline isize gb_utf8_strlen(u8 const *str) { + isize count = 0; + for (; *str; count++) { + u8 c = *str; + isize inc = 0; + if (c < 0x80) inc = 1; + else if ((c & 0xe0) == 0xc0) inc = 2; + else if ((c & 0xf0) == 0xe0) inc = 3; + else if ((c & 0xf8) == 0xf0) inc = 4; + else return -1; + + str += inc; + } + return count; +} + +gb_inline isize gb_utf8_strnlen(u8 const *str, isize max_len) { + isize count = 0; + for (; *str && max_len > 0; count++) { + u8 c = *str; + isize inc = 0; + if (c < 0x80) inc = 1; + else if ((c & 0xe0) == 0xc0) inc = 2; + else if ((c & 0xf0) == 0xe0) inc = 3; + else if ((c & 0xf8) == 0xf0) inc = 4; + else return -1; + + str += inc; + max_len -= inc; + } + return count; +} + + +gb_inline i32 gb_strcmp(char const *s1, char const *s2) { + while (*s1 && (*s1 == *s2)) { + s1++, s2++; + } + return *(u8 *)s1 - *(u8 *)s2; +} + +gb_inline char *gb_strcpy(char *dest, char const *source) { + GB_ASSERT_NOT_NULL(dest); + if (source) { + char *str = dest; + while (*source) *str++ = *source++; + } + return dest; +} + + +gb_inline char *gb_strncpy(char *dest, char const *source, isize len) { + GB_ASSERT_NOT_NULL(dest); + if (source) { + char *str = dest; + while (len > 0 && *source) { + *str++ = *source++; + len--; + } + while (len > 0) { + *str++ = '\0'; + len--; + } + } + return dest; +} + +gb_inline isize gb_strlcpy(char *dest, char const *source, isize len) { + isize result = 0; + GB_ASSERT_NOT_NULL(dest); + if (source) { + char const *source_start = source; + char *str = dest; + while (len > 0 && *source) { + *str++ = *source++; + len--; + } + while (len > 0) { + *str++ = '\0'; + len--; + } + + result = source - source_start; + } + return result; +} + +gb_inline char *gb_strrev(char *str) { + isize len = gb_strlen(str); + char *a = str + 0; + char *b = str + len-1; + len /= 2; + while (len--) { + gb_swap(char, *a, *b); + a++, b--; + } + return str; +} + + + + +gb_inline i32 gb_strncmp(char const *s1, char const *s2, isize len) { + for (; len > 0; + s1++, s2++, len--) { + if (*s1 != *s2) { + return ((s1 < s2) ? -1 : +1); + } else if (*s1 == '\0') { + return 0; + } + } + return 0; +} + + +gb_inline char const *gb_strtok(char *output, char const *src, char const *delimit) { + while (*src && gb_char_first_occurence(delimit, *src) != NULL) { + *output++ = *src++; + } + + *output = 0; + return *src ? src+1 : src; +} + +gb_inline b32 gb_str_has_prefix(char const *str, char const *prefix) { + while (*prefix) { + if (*str++ != *prefix++) { + return false; + } + } + return true; +} + +gb_inline b32 gb_str_has_suffix(char const *str, char const *suffix) { + isize i = gb_strlen(str); + isize j = gb_strlen(suffix); + if (j <= i) { + return gb_strcmp(str+i-j, suffix) == 0; + } + return false; +} + + + + +gb_inline char const *gb_char_first_occurence(char const *s, char c) { + char ch = c; + for (; *s != ch; s++) { + if (*s == '\0') { + return NULL; + } + } + return s; +} + + +gb_inline char const *gb_char_last_occurence(char const *s, char c) { + char const *result = NULL; + do { + if (*s == c) { + result = s; + } + } while (*s++); + + return result; +} + + + +gb_inline void gb_str_concat(char *dest, isize dest_len, + char const *src_a, isize src_a_len, + char const *src_b, isize src_b_len) { + GB_ASSERT(dest_len >= src_a_len+src_b_len+1); + if (dest) { + gb_memcopy(dest, src_a, src_a_len); + gb_memcopy(dest+src_a_len, src_b, src_b_len); + dest[src_a_len+src_b_len] = '\0'; + } +} + + +gb_internal isize gb__scan_i64(char const *text, i32 base, i64 *value) { + char const *text_begin = text; + i64 result = 0; + b32 negative = false; + + if (*text == '-') { + negative = true; + text++; + } + + if (base == 16 && gb_strncmp(text, "0x", 2) == 0) { + text += 2; + } + + for (;;) { + i64 v; + if (gb_char_is_digit(*text)) { + v = *text - '0'; + } else if (base == 16 && gb_char_is_hex_digit(*text)) { + v = gb_hex_digit_to_int(*text); + } else { + break; + } + + result *= base; + result += v; + text++; + } + + if (value) { + if (negative) result = -result; + *value = result; + } + + return (text - text_begin); +} + +gb_internal isize gb__scan_u64(char const *text, i32 base, u64 *value) { + char const *text_begin = text; + u64 result = 0; + + if (base == 16 && gb_strncmp(text, "0x", 2) == 0) { + text += 2; + } + + for (;;) { + u64 v; + if (gb_char_is_digit(*text)) { + v = *text - '0'; + } else if (base == 16 && gb_char_is_hex_digit(*text)) { + v = gb_hex_digit_to_int(*text); + } else { + break; + } + + result *= base; + result += v; + text++; + } + + if (value) *value = result; + return (text - text_begin); +} + + +// TODO(bill): Make better +u64 gb_str_to_u64(char const *str, char **end_ptr, i32 base) { + isize len; + u64 value = 0; + + if (!base) { + if ((gb_strlen(str) > 2) && (gb_strncmp(str, "0x", 2) == 0)) { + base = 16; + } else { + base = 10; + } + } + + len = gb__scan_u64(str, base, &value); + if (end_ptr) *end_ptr = (char *)str + len; + return value; +} + +i64 gb_str_to_i64(char const *str, char **end_ptr, i32 base) { + isize len; + i64 value; + + if (!base) { + if ((gb_strlen(str) > 2) && (gb_strncmp(str, "0x", 2) == 0)) { + base = 16; + } else { + base = 10; + } + } + + len = gb__scan_i64(str, base, &value); + if (end_ptr) *end_ptr = (char *)str + len; + return value; +} + +// TODO(bill): Are these good enough for characters? +gb_global char const gb__num_to_char_table[] = + "0123456789" + "ABCDEFGHIJKLMNOPQRSTUVWXYZ" + "abcdefghijklmnopqrstuvwxyz" + "@$"; + +gb_inline void gb_i64_to_str(i64 value, char *string, i32 base) { + char *buf = string; + b32 negative = false; + u64 v; + if (value < 0) { + negative = true; + value = -value; + } + v = cast(u64)value; + if (v != 0) { + while (v > 0) { + *buf++ = gb__num_to_char_table[v % base]; + v /= base; + } + } else { + *buf++ = '0'; + } + if (negative) { + *buf++ = '-'; + } + *buf = '\0'; + gb_strrev(string); +} + + + +gb_inline void gb_u64_to_str(u64 value, char *string, i32 base) { + char *buf = string; + + if (value) { + while (value > 0) { + *buf++ = gb__num_to_char_table[value % base]; + value /= base; + } + } else { + *buf++ = '0'; + } + *buf = '\0'; + + gb_strrev(string); +} + +gb_inline f32 gb_str_to_f32(char const *str, char **end_ptr) { + f64 f = gb_str_to_f64(str, end_ptr); + f32 r = cast(f32)f; + return r; +} + +gb_inline f64 gb_str_to_f64(char const *str, char **end_ptr) { + f64 result, value, sign, scale; + i32 frac; + + while (gb_char_is_space(*str)) { + str++; + } + + sign = 1.0; + if (*str == '-') { + sign = -1.0; + str++; + } else if (*str == '+') { + str++; + } + + for (value = 0.0; gb_char_is_digit(*str); str++) { + value = value * 10.0 + (*str-'0'); + } + + if (*str == '.') { + f64 pow10 = 10.0; + str++; + while (gb_char_is_digit(*str)) { + value += (*str-'0') / pow10; + pow10 *= 10.0; + str++; + } + } + + frac = 0; + scale = 1.0; + if ((*str == 'e') || (*str == 'E')) { + u32 exp; + + str++; + if (*str == '-') { + frac = 1; + str++; + } else if (*str == '+') { + str++; + } + + for (exp = 0; gb_char_is_digit(*str); str++) { + exp = exp * 10 + (*str-'0'); + } + if (exp > 308) exp = 308; + + while (exp >= 50) { scale *= 1e50; exp -= 50; } + while (exp >= 8) { scale *= 1e8; exp -= 8; } + while (exp > 0) { scale *= 10.0; exp -= 1; } + } + + result = sign * (frac ? (value / scale) : (value * scale)); + + if (end_ptr) *end_ptr = cast(char *)str; + + return result; +} + + + + + + + +gb_inline void gb__set_string_length (gbString str, isize len) { GB_STRING_HEADER(str)->length = len; } +gb_inline void gb__set_string_capacity(gbString str, isize cap) { GB_STRING_HEADER(str)->capacity = cap; } + + +gbString gb_string_make_reserve(gbAllocator a, isize capacity) { + isize header_size = gb_size_of(gbStringHeader); + void *ptr = gb_alloc(a, header_size + capacity + 1); + + gbString str; + gbStringHeader *header; + + if (ptr == NULL) return NULL; + gb_zero_size(ptr, header_size + capacity + 1); + + str = cast(char *)ptr + header_size; + header = GB_STRING_HEADER(str); + header->allocator = a; + header->length = 0; + header->capacity = capacity; + str[capacity] = '\0'; + + return str; +} + + +gb_inline gbString gb_string_make(gbAllocator a, char const *str) { + isize len = str ? gb_strlen(str) : 0; + return gb_string_make_length(a, str, len); +} + +gbString gb_string_make_length(gbAllocator a, void const *init_str, isize num_bytes) { + isize header_size = gb_size_of(gbStringHeader); + void *ptr = gb_alloc(a, header_size + num_bytes + 1); + + gbString str; + gbStringHeader *header; + + if (ptr == NULL) return NULL; + if (!init_str) gb_zero_size(ptr, header_size + num_bytes + 1); + + str = cast(char *)ptr + header_size; + header = GB_STRING_HEADER(str); + header->allocator = a; + header->length = num_bytes; + header->capacity = num_bytes; + if (num_bytes && init_str) { + gb_memcopy(str, init_str, num_bytes); + } + str[num_bytes] = '\0'; + + return str; +} + +gb_inline void gb_string_free(gbString str) { + if (str) { + gbStringHeader *header = GB_STRING_HEADER(str); + gb_free(header->allocator, header); + } + +} + +gb_inline gbString gb_string_duplicate(gbAllocator a, gbString const str) { return gb_string_make_length(a, str, gb_string_length(str)); } + +gb_inline isize gb_string_length (gbString const str) { return GB_STRING_HEADER(str)->length; } +gb_inline isize gb_string_capacity(gbString const str) { return GB_STRING_HEADER(str)->capacity; } + +gb_inline isize gb_string_available_space(gbString const str) { + gbStringHeader *h = GB_STRING_HEADER(str); + if (h->capacity > h->length) { + return h->capacity - h->length; + } + return 0; +} + + +gb_inline void gb_string_clear(gbString str) { gb__set_string_length(str, 0); str[0] = '\0'; } + +gb_inline gbString gb_string_append(gbString str, gbString const other) { return gb_string_append_length(str, other, gb_string_length(other)); } + +gbString gb_string_append_length(gbString str, void const *other, isize other_len) { + if (other_len > 0) { + isize curr_len = gb_string_length(str); + + str = gb_string_make_space_for(str, other_len); + if (str == NULL) { + return NULL; + } + + gb_memcopy(str + curr_len, other, other_len); + str[curr_len + other_len] = '\0'; + gb__set_string_length(str, curr_len + other_len); + } + return str; +} + +gb_inline gbString gb_string_appendc(gbString str, char const *other) { + return gb_string_append_length(str, other, gb_strlen(other)); +} + +gbString gb_string_append_rune(gbString str, Rune r) { + if (r >= 0) { + u8 buf[8] = {0}; + isize len = gb_utf8_encode_rune(buf, r); + return gb_string_append_length(str, buf, len); + } + return str; +} + +gbString gb_string_append_fmt(gbString str, char const *fmt, ...) { + isize res; + char buf[4096] = {0}; + va_list va; + va_start(va, fmt); + res = gb_snprintf_va(buf, gb_count_of(buf)-1, fmt, va)-1; + va_end(va); + return gb_string_append_length(str, buf, res); +} + + + +gbString gb_string_set(gbString str, char const *cstr) { + isize len = gb_strlen(cstr); + if (gb_string_capacity(str) < len) { + str = gb_string_make_space_for(str, len - gb_string_length(str)); + if (str == NULL) { + return NULL; + } + } + + gb_memcopy(str, cstr, len); + str[len] = '\0'; + gb__set_string_length(str, len); + + return str; +} + + + +gbString gb_string_make_space_for(gbString str, isize add_len) { + isize available = gb_string_available_space(str); + + // NOTE(bill): Return if there is enough space left + if (available >= add_len) { + return str; + } else { + isize new_len, old_size, new_size; + void *ptr, *new_ptr; + gbAllocator a = GB_STRING_HEADER(str)->allocator; + gbStringHeader *header; + + new_len = gb_string_length(str) + add_len; + ptr = GB_STRING_HEADER(str); + old_size = gb_size_of(gbStringHeader) + gb_string_length(str) + 1; + new_size = gb_size_of(gbStringHeader) + new_len + 1; + + new_ptr = gb_resize(a, ptr, old_size, new_size); + if (new_ptr == NULL) return NULL; + + header = cast(gbStringHeader *)new_ptr; + header->allocator = a; + + str = cast(gbString)(header+1); + gb__set_string_capacity(str, new_len); + + return str; + } +} + +gb_inline isize gb_string_allocation_size(gbString const str) { + isize cap = gb_string_capacity(str); + return gb_size_of(gbStringHeader) + cap; +} + + +gb_inline b32 gb_string_are_equal(gbString const lhs, gbString const rhs) { + isize lhs_len, rhs_len, i; + lhs_len = gb_string_length(lhs); + rhs_len = gb_string_length(rhs); + if (lhs_len != rhs_len) { + return false; + } + + for (i = 0; i < lhs_len; i++) { + if (lhs[i] != rhs[i]) { + return false; + } + } + + return true; +} + + +gbString gb_string_trim(gbString str, char const *cut_set) { + char *start, *end, *start_pos, *end_pos; + isize len; + + start_pos = start = str; + end_pos = end = str + gb_string_length(str) - 1; + + while (start_pos <= end && gb_char_first_occurence(cut_set, *start_pos)) { + start_pos++; + } + while (end_pos > start_pos && gb_char_first_occurence(cut_set, *end_pos)) { + end_pos--; + } + + len = cast(isize)((start_pos > end_pos) ? 0 : ((end_pos - start_pos)+1)); + + if (str != start_pos) + gb_memmove(str, start_pos, len); + str[len] = '\0'; + + gb__set_string_length(str, len); + + return str; +} + +gb_inline gbString gb_string_trim_space(gbString str) { return gb_string_trim(str, " \t\r\n\v\f"); } + + + + +//////////////////////////////////////////////////////////////// +// +// Windows UTF-8 Handling +// +// + + +u16 *gb_utf8_to_ucs2(u16 *buffer, isize len, u8 const *str) { + Rune c; + isize i = 0; + len--; + while (*str) { + if (i >= len) + return NULL; + if (!(*str & 0x80)) { + buffer[i++] = *str++; + } else if ((*str & 0xe0) == 0xc0) { + if (*str < 0xc2) + return NULL; + c = (*str++ & 0x1f) << 6; + if ((*str & 0xc0) != 0x80) + return NULL; + buffer[i++] = cast(u16)(c + (*str++ & 0x3f)); + } else if ((*str & 0xf0) == 0xe0) { + if (*str == 0xe0 && + (str[1] < 0xa0 || str[1] > 0xbf)) + return NULL; + if (*str == 0xed && str[1] > 0x9f) // str[1] < 0x80 is checked below + return NULL; + c = (*str++ & 0x0f) << 12; + if ((*str & 0xc0) != 0x80) + return NULL; + c += (*str++ & 0x3f) << 6; + if ((*str & 0xc0) != 0x80) + return NULL; + buffer[i++] = cast(u16)(c + (*str++ & 0x3f)); + } else if ((*str & 0xf8) == 0xf0) { + if (*str > 0xf4) + return NULL; + if (*str == 0xf0 && (str[1] < 0x90 || str[1] > 0xbf)) + return NULL; + if (*str == 0xf4 && str[1] > 0x8f) // str[1] < 0x80 is checked below + return NULL; + c = (*str++ & 0x07) << 18; + if ((*str & 0xc0) != 0x80) + return NULL; + c += (*str++ & 0x3f) << 12; + if ((*str & 0xc0) != 0x80) + return NULL; + c += (*str++ & 0x3f) << 6; + if ((*str & 0xc0) != 0x80) + return NULL; + c += (*str++ & 0x3f); + // UTF-8 encodings of values used in surrogate pairs are invalid + if ((c & 0xfffff800) == 0xd800) + return NULL; + if (c >= 0x10000) { + c -= 0x10000; + if (i+2 > len) + return NULL; + buffer[i++] = 0xd800 | (0x3ff & (c>>10)); + buffer[i++] = 0xdc00 | (0x3ff & (c )); + } + } else { + return NULL; + } + } + buffer[i] = 0; + return buffer; +} + +u8 *gb_ucs2_to_utf8(u8 *buffer, isize len, u16 const *str) { + isize i = 0; + len--; + while (*str) { + if (*str < 0x80) { + if (i+1 > len) + return NULL; + buffer[i++] = (char) *str++; + } else if (*str < 0x800) { + if (i+2 > len) + return NULL; + buffer[i++] = cast(char)(0xc0 + (*str >> 6)); + buffer[i++] = cast(char)(0x80 + (*str & 0x3f)); + str += 1; + } else if (*str >= 0xd800 && *str < 0xdc00) { + Rune c; + if (i+4 > len) + return NULL; + c = ((str[0] - 0xd800) << 10) + ((str[1]) - 0xdc00) + 0x10000; + buffer[i++] = cast(char)(0xf0 + (c >> 18)); + buffer[i++] = cast(char)(0x80 + ((c >> 12) & 0x3f)); + buffer[i++] = cast(char)(0x80 + ((c >> 6) & 0x3f)); + buffer[i++] = cast(char)(0x80 + ((c ) & 0x3f)); + str += 2; + } else if (*str >= 0xdc00 && *str < 0xe000) { + return NULL; + } else { + if (i+3 > len) + return NULL; + buffer[i++] = 0xe0 + (*str >> 12); + buffer[i++] = 0x80 + ((*str >> 6) & 0x3f); + buffer[i++] = 0x80 + ((*str ) & 0x3f); + str += 1; + } + } + buffer[i] = 0; + return buffer; +} + +u16 *gb_utf8_to_ucs2_buf(u8 const *str) { // NOTE(bill): Uses locally persisting buffer + gb_local_persist u16 buf[4096]; + return gb_utf8_to_ucs2(buf, gb_count_of(buf), str); +} + +u8 *gb_ucs2_to_utf8_buf(u16 const *str) { // NOTE(bill): Uses locally persisting buffer + gb_local_persist u8 buf[4096]; + return gb_ucs2_to_utf8(buf, gb_count_of(buf), str); +} + + + +gb_global u8 const gb__utf8_first[256] = { + 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, // 0x00-0x0F + 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, // 0x10-0x1F + 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, // 0x20-0x2F + 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, // 0x30-0x3F + 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, // 0x40-0x4F + 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, // 0x50-0x5F + 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, // 0x60-0x6F + 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, 0xf0, // 0x70-0x7F + 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, // 0x80-0x8F + 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, // 0x90-0x9F + 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, // 0xA0-0xAF + 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, // 0xB0-0xBF + 0xf1, 0xf1, 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, // 0xC0-0xCF + 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, 0x02, // 0xD0-0xDF + 0x13, 0x03, 0x03, 0x03, 0x03, 0x03, 0x03, 0x03, 0x03, 0x03, 0x03, 0x03, 0x03, 0x23, 0x03, 0x03, // 0xE0-0xEF + 0x34, 0x04, 0x04, 0x04, 0x44, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, 0xf1, // 0xF0-0xFF +}; + + +typedef struct gbUtf8AcceptRange { + u8 lo, hi; +} gbUtf8AcceptRange; + +gb_global gbUtf8AcceptRange const gb__utf8_accept_ranges[] = { + {0x80, 0xbf}, + {0xa0, 0xbf}, + {0x80, 0x9f}, + {0x90, 0xbf}, + {0x80, 0x8f}, +}; + + +isize gb_utf8_decode(u8 const *str, isize str_len, Rune *codepoint_out) { + isize width = 0; + Rune codepoint = GB_RUNE_INVALID; + + if (str_len > 0) { + u8 s0 = str[0]; + u8 x = gb__utf8_first[s0], sz; + u8 b1, b2, b3; + gbUtf8AcceptRange accept; + if (x >= 0xf0) { + Rune mask = (cast(Rune)x << 31) >> 31; + codepoint = (cast(Rune)s0 & (~mask)) | (GB_RUNE_INVALID & mask); + width = 1; + goto end; + } + if (s0 < 0x80) { + codepoint = s0; + width = 1; + goto end; + } + + sz = x&7; + accept = gb__utf8_accept_ranges[x>>4]; + if (str_len < gb_size_of(sz)) + goto invalid_codepoint; + + b1 = str[1]; + if (b1 < accept.lo || accept.hi < b1) + goto invalid_codepoint; + + if (sz == 2) { + codepoint = (cast(Rune)s0&0x1f)<<6 | (cast(Rune)b1&0x3f); + width = 2; + goto end; + } + + b2 = str[2]; + if (!gb_is_between(b2, 0x80, 0xbf)) + goto invalid_codepoint; + + if (sz == 3) { + codepoint = (cast(Rune)s0&0x1f)<<12 | (cast(Rune)b1&0x3f)<<6 | (cast(Rune)b2&0x3f); + width = 3; + goto end; + } + + b3 = str[3]; + if (!gb_is_between(b3, 0x80, 0xbf)) + goto invalid_codepoint; + + codepoint = (cast(Rune)s0&0x07)<<18 | (cast(Rune)b1&0x3f)<<12 | (cast(Rune)b2&0x3f)<<6 | (cast(Rune)b3&0x3f); + width = 4; + goto end; + + invalid_codepoint: + codepoint = GB_RUNE_INVALID; + width = 1; + } + +end: + if (codepoint_out) *codepoint_out = codepoint; + return width; +} + +isize gb_utf8_codepoint_size(u8 const *str, isize str_len) { + isize i = 0; + for (; i < str_len && str[i]; i++) { + if ((str[i] & 0xc0) != 0x80) + break; + } + return i+1; +} + +isize gb_utf8_encode_rune(u8 buf[4], Rune r) { + u32 i = cast(u32)r; + u8 mask = 0x3f; + if (i <= (1<<7)-1) { + buf[0] = cast(u8)r; + return 1; + } + if (i <= (1<<11)-1) { + buf[0] = 0xc0 | cast(u8)(r>>6); + buf[1] = 0x80 | (cast(u8)(r)&mask); + return 2; + } + + // Invalid or Surrogate range + if (i > GB_RUNE_MAX || + gb_is_between(i, 0xd800, 0xdfff)) { + r = GB_RUNE_INVALID; + + buf[0] = 0xe0 | cast(u8)(r>>12); + buf[1] = 0x80 | (cast(u8)(r>>6)&mask); + buf[2] = 0x80 | (cast(u8)(r)&mask); + return 3; + } + + if (i <= (1<<16)-1) { + buf[0] = 0xe0 | cast(u8)(r>>12); + buf[1] = 0x80 | (cast(u8)(r>>6)&mask); + buf[2] = 0x80 | (cast(u8)(r)&mask); + return 3; + } + + buf[0] = 0xf0 | cast(u8)(r>>18); + buf[1] = 0x80 | (cast(u8)(r>>12)&mask); + buf[2] = 0x80 | (cast(u8)(r>>6)&mask); + buf[3] = 0x80 | (cast(u8)(r)&mask); + return 4; +} + + + + +//////////////////////////////////////////////////////////////// +// +// gbArray +// +// + + +gb_no_inline void *gb__array_set_capacity(void *array, isize capacity, isize element_size) { + gbArrayHeader *h = GB_ARRAY_HEADER(array); + + GB_ASSERT(element_size > 0); + + if (capacity == h->capacity) + return array; + + if (capacity < h->count) { + if (h->capacity < capacity) { + isize new_capacity = GB_ARRAY_GROW_FORMULA(h->capacity); + if (new_capacity < capacity) + new_capacity = capacity; + gb__array_set_capacity(array, new_capacity, element_size); + } + h->count = capacity; + } + + { + isize size = gb_size_of(gbArrayHeader) + element_size*capacity; + gbArrayHeader *nh = cast(gbArrayHeader *)gb_alloc(h->allocator, size); + gb_memmove(nh, h, gb_size_of(gbArrayHeader) + element_size*h->count); + nh->allocator = h->allocator; + nh->count = h->count; + nh->capacity = capacity; + gb_free(h->allocator, h); + return nh+1; + } +} + + +//////////////////////////////////////////////////////////////// +// +// Hashing functions +// +// + +u32 gb_adler32(void const *data, isize len) { + u32 const MOD_ALDER = 65521; + u32 a = 1, b = 0; + isize i, block_len; + u8 const *bytes = cast(u8 const *)data; + + block_len = len % 5552; + + while (len) { + for (i = 0; i+7 < block_len; i += 8) { + a += bytes[0], b += a; + a += bytes[1], b += a; + a += bytes[2], b += a; + a += bytes[3], b += a; + a += bytes[4], b += a; + a += bytes[5], b += a; + a += bytes[6], b += a; + a += bytes[7], b += a; + + bytes += 8; + } + for (; i < block_len; i++) { + a += *bytes++, b += a; + } + + a %= MOD_ALDER, b %= MOD_ALDER; + len -= block_len; + block_len = 5552; + } + + return (b << 16) | a; +} + + +gb_global u32 const GB__CRC32_TABLE[256] = { + 0x00000000, 0x77073096, 0xee0e612c, 0x990951ba, + 0x076dc419, 0x706af48f, 0xe963a535, 0x9e6495a3, + 0x0edb8832, 0x79dcb8a4, 0xe0d5e91e, 0x97d2d988, + 0x09b64c2b, 0x7eb17cbd, 0xe7b82d07, 0x90bf1d91, + 0x1db71064, 0x6ab020f2, 0xf3b97148, 0x84be41de, + 0x1adad47d, 0x6ddde4eb, 0xf4d4b551, 0x83d385c7, + 0x136c9856, 0x646ba8c0, 0xfd62f97a, 0x8a65c9ec, + 0x14015c4f, 0x63066cd9, 0xfa0f3d63, 0x8d080df5, + 0x3b6e20c8, 0x4c69105e, 0xd56041e4, 0xa2677172, + 0x3c03e4d1, 0x4b04d447, 0xd20d85fd, 0xa50ab56b, + 0x35b5a8fa, 0x42b2986c, 0xdbbbc9d6, 0xacbcf940, + 0x32d86ce3, 0x45df5c75, 0xdcd60dcf, 0xabd13d59, + 0x26d930ac, 0x51de003a, 0xc8d75180, 0xbfd06116, + 0x21b4f4b5, 0x56b3c423, 0xcfba9599, 0xb8bda50f, + 0x2802b89e, 0x5f058808, 0xc60cd9b2, 0xb10be924, + 0x2f6f7c87, 0x58684c11, 0xc1611dab, 0xb6662d3d, + 0x76dc4190, 0x01db7106, 0x98d220bc, 0xefd5102a, + 0x71b18589, 0x06b6b51f, 0x9fbfe4a5, 0xe8b8d433, + 0x7807c9a2, 0x0f00f934, 0x9609a88e, 0xe10e9818, + 0x7f6a0dbb, 0x086d3d2d, 0x91646c97, 0xe6635c01, + 0x6b6b51f4, 0x1c6c6162, 0x856530d8, 0xf262004e, + 0x6c0695ed, 0x1b01a57b, 0x8208f4c1, 0xf50fc457, + 0x65b0d9c6, 0x12b7e950, 0x8bbeb8ea, 0xfcb9887c, + 0x62dd1ddf, 0x15da2d49, 0x8cd37cf3, 0xfbd44c65, + 0x4db26158, 0x3ab551ce, 0xa3bc0074, 0xd4bb30e2, + 0x4adfa541, 0x3dd895d7, 0xa4d1c46d, 0xd3d6f4fb, + 0x4369e96a, 0x346ed9fc, 0xad678846, 0xda60b8d0, + 0x44042d73, 0x33031de5, 0xaa0a4c5f, 0xdd0d7cc9, + 0x5005713c, 0x270241aa, 0xbe0b1010, 0xc90c2086, + 0x5768b525, 0x206f85b3, 0xb966d409, 0xce61e49f, + 0x5edef90e, 0x29d9c998, 0xb0d09822, 0xc7d7a8b4, + 0x59b33d17, 0x2eb40d81, 0xb7bd5c3b, 0xc0ba6cad, + 0xedb88320, 0x9abfb3b6, 0x03b6e20c, 0x74b1d29a, + 0xead54739, 0x9dd277af, 0x04db2615, 0x73dc1683, + 0xe3630b12, 0x94643b84, 0x0d6d6a3e, 0x7a6a5aa8, + 0xe40ecf0b, 0x9309ff9d, 0x0a00ae27, 0x7d079eb1, + 0xf00f9344, 0x8708a3d2, 0x1e01f268, 0x6906c2fe, + 0xf762575d, 0x806567cb, 0x196c3671, 0x6e6b06e7, + 0xfed41b76, 0x89d32be0, 0x10da7a5a, 0x67dd4acc, + 0xf9b9df6f, 0x8ebeeff9, 0x17b7be43, 0x60b08ed5, + 0xd6d6a3e8, 0xa1d1937e, 0x38d8c2c4, 0x4fdff252, + 0xd1bb67f1, 0xa6bc5767, 0x3fb506dd, 0x48b2364b, + 0xd80d2bda, 0xaf0a1b4c, 0x36034af6, 0x41047a60, + 0xdf60efc3, 0xa867df55, 0x316e8eef, 0x4669be79, + 0xcb61b38c, 0xbc66831a, 0x256fd2a0, 0x5268e236, + 0xcc0c7795, 0xbb0b4703, 0x220216b9, 0x5505262f, + 0xc5ba3bbe, 0xb2bd0b28, 0x2bb45a92, 0x5cb36a04, + 0xc2d7ffa7, 0xb5d0cf31, 0x2cd99e8b, 0x5bdeae1d, + 0x9b64c2b0, 0xec63f226, 0x756aa39c, 0x026d930a, + 0x9c0906a9, 0xeb0e363f, 0x72076785, 0x05005713, + 0x95bf4a82, 0xe2b87a14, 0x7bb12bae, 0x0cb61b38, + 0x92d28e9b, 0xe5d5be0d, 0x7cdcefb7, 0x0bdbdf21, + 0x86d3d2d4, 0xf1d4e242, 0x68ddb3f8, 0x1fda836e, + 0x81be16cd, 0xf6b9265b, 0x6fb077e1, 0x18b74777, + 0x88085ae6, 0xff0f6a70, 0x66063bca, 0x11010b5c, + 0x8f659eff, 0xf862ae69, 0x616bffd3, 0x166ccf45, + 0xa00ae278, 0xd70dd2ee, 0x4e048354, 0x3903b3c2, + 0xa7672661, 0xd06016f7, 0x4969474d, 0x3e6e77db, + 0xaed16a4a, 0xd9d65adc, 0x40df0b66, 0x37d83bf0, + 0xa9bcae53, 0xdebb9ec5, 0x47b2cf7f, 0x30b5ffe9, + 0xbdbdf21c, 0xcabac28a, 0x53b39330, 0x24b4a3a6, + 0xbad03605, 0xcdd70693, 0x54de5729, 0x23d967bf, + 0xb3667a2e, 0xc4614ab8, 0x5d681b02, 0x2a6f2b94, + 0xb40bbe37, 0xc30c8ea1, 0x5a05df1b, 0x2d02ef8d, +}; + +gb_global u64 const GB__CRC64_TABLE[256] = { + 0x0000000000000000ull, 0x42f0e1eba9ea3693ull, 0x85e1c3d753d46d26ull, 0xc711223cfa3e5bb5ull, + 0x493366450e42ecdfull, 0x0bc387aea7a8da4cull, 0xccd2a5925d9681f9ull, 0x8e224479f47cb76aull, + 0x9266cc8a1c85d9beull, 0xd0962d61b56fef2dull, 0x17870f5d4f51b498ull, 0x5577eeb6e6bb820bull, + 0xdb55aacf12c73561ull, 0x99a54b24bb2d03f2ull, 0x5eb4691841135847ull, 0x1c4488f3e8f96ed4ull, + 0x663d78ff90e185efull, 0x24cd9914390bb37cull, 0xe3dcbb28c335e8c9ull, 0xa12c5ac36adfde5aull, + 0x2f0e1eba9ea36930ull, 0x6dfeff5137495fa3ull, 0xaaefdd6dcd770416ull, 0xe81f3c86649d3285ull, + 0xf45bb4758c645c51ull, 0xb6ab559e258e6ac2ull, 0x71ba77a2dfb03177ull, 0x334a9649765a07e4ull, + 0xbd68d2308226b08eull, 0xff9833db2bcc861dull, 0x388911e7d1f2dda8ull, 0x7a79f00c7818eb3bull, + 0xcc7af1ff21c30bdeull, 0x8e8a101488293d4dull, 0x499b3228721766f8ull, 0x0b6bd3c3dbfd506bull, + 0x854997ba2f81e701ull, 0xc7b97651866bd192ull, 0x00a8546d7c558a27ull, 0x4258b586d5bfbcb4ull, + 0x5e1c3d753d46d260ull, 0x1cecdc9e94ace4f3ull, 0xdbfdfea26e92bf46ull, 0x990d1f49c77889d5ull, + 0x172f5b3033043ebfull, 0x55dfbadb9aee082cull, 0x92ce98e760d05399ull, 0xd03e790cc93a650aull, + 0xaa478900b1228e31ull, 0xe8b768eb18c8b8a2ull, 0x2fa64ad7e2f6e317ull, 0x6d56ab3c4b1cd584ull, + 0xe374ef45bf6062eeull, 0xa1840eae168a547dull, 0x66952c92ecb40fc8ull, 0x2465cd79455e395bull, + 0x3821458aada7578full, 0x7ad1a461044d611cull, 0xbdc0865dfe733aa9ull, 0xff3067b657990c3aull, + 0x711223cfa3e5bb50ull, 0x33e2c2240a0f8dc3ull, 0xf4f3e018f031d676ull, 0xb60301f359dbe0e5ull, + 0xda050215ea6c212full, 0x98f5e3fe438617bcull, 0x5fe4c1c2b9b84c09ull, 0x1d14202910527a9aull, + 0x93366450e42ecdf0ull, 0xd1c685bb4dc4fb63ull, 0x16d7a787b7faa0d6ull, 0x5427466c1e109645ull, + 0x4863ce9ff6e9f891ull, 0x0a932f745f03ce02ull, 0xcd820d48a53d95b7ull, 0x8f72eca30cd7a324ull, + 0x0150a8daf8ab144eull, 0x43a04931514122ddull, 0x84b16b0dab7f7968ull, 0xc6418ae602954ffbull, + 0xbc387aea7a8da4c0ull, 0xfec89b01d3679253ull, 0x39d9b93d2959c9e6ull, 0x7b2958d680b3ff75ull, + 0xf50b1caf74cf481full, 0xb7fbfd44dd257e8cull, 0x70eadf78271b2539ull, 0x321a3e938ef113aaull, + 0x2e5eb66066087d7eull, 0x6cae578bcfe24bedull, 0xabbf75b735dc1058ull, 0xe94f945c9c3626cbull, + 0x676dd025684a91a1ull, 0x259d31cec1a0a732ull, 0xe28c13f23b9efc87ull, 0xa07cf2199274ca14ull, + 0x167ff3eacbaf2af1ull, 0x548f120162451c62ull, 0x939e303d987b47d7ull, 0xd16ed1d631917144ull, + 0x5f4c95afc5edc62eull, 0x1dbc74446c07f0bdull, 0xdaad56789639ab08ull, 0x985db7933fd39d9bull, + 0x84193f60d72af34full, 0xc6e9de8b7ec0c5dcull, 0x01f8fcb784fe9e69ull, 0x43081d5c2d14a8faull, + 0xcd2a5925d9681f90ull, 0x8fdab8ce70822903ull, 0x48cb9af28abc72b6ull, 0x0a3b7b1923564425ull, + 0x70428b155b4eaf1eull, 0x32b26afef2a4998dull, 0xf5a348c2089ac238ull, 0xb753a929a170f4abull, + 0x3971ed50550c43c1ull, 0x7b810cbbfce67552ull, 0xbc902e8706d82ee7ull, 0xfe60cf6caf321874ull, + 0xe224479f47cb76a0ull, 0xa0d4a674ee214033ull, 0x67c58448141f1b86ull, 0x253565a3bdf52d15ull, + 0xab1721da49899a7full, 0xe9e7c031e063acecull, 0x2ef6e20d1a5df759ull, 0x6c0603e6b3b7c1caull, + 0xf6fae5c07d3274cdull, 0xb40a042bd4d8425eull, 0x731b26172ee619ebull, 0x31ebc7fc870c2f78ull, + 0xbfc9838573709812ull, 0xfd39626eda9aae81ull, 0x3a28405220a4f534ull, 0x78d8a1b9894ec3a7ull, + 0x649c294a61b7ad73ull, 0x266cc8a1c85d9be0ull, 0xe17dea9d3263c055ull, 0xa38d0b769b89f6c6ull, + 0x2daf4f0f6ff541acull, 0x6f5faee4c61f773full, 0xa84e8cd83c212c8aull, 0xeabe6d3395cb1a19ull, + 0x90c79d3fedd3f122ull, 0xd2377cd44439c7b1ull, 0x15265ee8be079c04ull, 0x57d6bf0317edaa97ull, + 0xd9f4fb7ae3911dfdull, 0x9b041a914a7b2b6eull, 0x5c1538adb04570dbull, 0x1ee5d94619af4648ull, + 0x02a151b5f156289cull, 0x4051b05e58bc1e0full, 0x87409262a28245baull, 0xc5b073890b687329ull, + 0x4b9237f0ff14c443ull, 0x0962d61b56fef2d0ull, 0xce73f427acc0a965ull, 0x8c8315cc052a9ff6ull, + 0x3a80143f5cf17f13ull, 0x7870f5d4f51b4980ull, 0xbf61d7e80f251235ull, 0xfd913603a6cf24a6ull, + 0x73b3727a52b393ccull, 0x31439391fb59a55full, 0xf652b1ad0167feeaull, 0xb4a25046a88dc879ull, + 0xa8e6d8b54074a6adull, 0xea16395ee99e903eull, 0x2d071b6213a0cb8bull, 0x6ff7fa89ba4afd18ull, + 0xe1d5bef04e364a72ull, 0xa3255f1be7dc7ce1ull, 0x64347d271de22754ull, 0x26c49cccb40811c7ull, + 0x5cbd6cc0cc10fafcull, 0x1e4d8d2b65facc6full, 0xd95caf179fc497daull, 0x9bac4efc362ea149ull, + 0x158e0a85c2521623ull, 0x577eeb6e6bb820b0ull, 0x906fc95291867b05ull, 0xd29f28b9386c4d96ull, + 0xcedba04ad0952342ull, 0x8c2b41a1797f15d1ull, 0x4b3a639d83414e64ull, 0x09ca82762aab78f7ull, + 0x87e8c60fded7cf9dull, 0xc51827e4773df90eull, 0x020905d88d03a2bbull, 0x40f9e43324e99428ull, + 0x2cffe7d5975e55e2ull, 0x6e0f063e3eb46371ull, 0xa91e2402c48a38c4ull, 0xebeec5e96d600e57ull, + 0x65cc8190991cb93dull, 0x273c607b30f68faeull, 0xe02d4247cac8d41bull, 0xa2dda3ac6322e288ull, + 0xbe992b5f8bdb8c5cull, 0xfc69cab42231bacfull, 0x3b78e888d80fe17aull, 0x7988096371e5d7e9ull, + 0xf7aa4d1a85996083ull, 0xb55aacf12c735610ull, 0x724b8ecdd64d0da5ull, 0x30bb6f267fa73b36ull, + 0x4ac29f2a07bfd00dull, 0x08327ec1ae55e69eull, 0xcf235cfd546bbd2bull, 0x8dd3bd16fd818bb8ull, + 0x03f1f96f09fd3cd2ull, 0x41011884a0170a41ull, 0x86103ab85a2951f4ull, 0xc4e0db53f3c36767ull, + 0xd8a453a01b3a09b3ull, 0x9a54b24bb2d03f20ull, 0x5d45907748ee6495ull, 0x1fb5719ce1045206ull, + 0x919735e51578e56cull, 0xd367d40ebc92d3ffull, 0x1476f63246ac884aull, 0x568617d9ef46bed9ull, + 0xe085162ab69d5e3cull, 0xa275f7c11f7768afull, 0x6564d5fde549331aull, 0x279434164ca30589ull, + 0xa9b6706fb8dfb2e3ull, 0xeb46918411358470ull, 0x2c57b3b8eb0bdfc5ull, 0x6ea7525342e1e956ull, + 0x72e3daa0aa188782ull, 0x30133b4b03f2b111ull, 0xf7021977f9cceaa4ull, 0xb5f2f89c5026dc37ull, + 0x3bd0bce5a45a6b5dull, 0x79205d0e0db05dceull, 0xbe317f32f78e067bull, 0xfcc19ed95e6430e8ull, + 0x86b86ed5267cdbd3ull, 0xc4488f3e8f96ed40ull, 0x0359ad0275a8b6f5ull, 0x41a94ce9dc428066ull, + 0xcf8b0890283e370cull, 0x8d7be97b81d4019full, 0x4a6acb477bea5a2aull, 0x089a2aacd2006cb9ull, + 0x14dea25f3af9026dull, 0x562e43b4931334feull, 0x913f6188692d6f4bull, 0xd3cf8063c0c759d8ull, + 0x5dedc41a34bbeeb2ull, 0x1f1d25f19d51d821ull, 0xd80c07cd676f8394ull, 0x9afce626ce85b507ull, +}; + +u32 gb_crc32(void const *data, isize len) { + isize remaining; + u32 result = ~(cast(u32)0); + u8 const *c = cast(u8 const *)data; + for (remaining = len; remaining--; c++) { + result = (result >> 8) ^ (GB__CRC32_TABLE[(result ^ *c) & 0xff]); + } + return ~result; +} + +u64 gb_crc64(void const *data, isize len) { + isize remaining; + u64 result = ~(cast(u64)0); + u8 const *c = cast(u8 const *)data; + for (remaining = len; remaining--; c++) { + result = (result >> 8) ^ (GB__CRC64_TABLE[(result ^ *c) & 0xff]); + } + return ~result; +} + +u32 gb_fnv32(void const *data, isize len) { + isize i; + u32 h = 0x811c9dc5; + u8 const *c = cast(u8 const *)data; + + for (i = 0; i < len; i++) { + h = (h * 0x01000193) ^ c[i]; + } + + return h; +} + +u64 gb_fnv64(void const *data, isize len) { + isize i; + u64 h = 0xcbf29ce484222325ull; + u8 const *c = cast(u8 const *)data; + + for (i = 0; i < len; i++) { + h = (h * 0x100000001b3ll) ^ c[i]; + } + + return h; +} + +u32 gb_fnv32a(void const *data, isize len) { + isize i; + u32 h = 0x811c9dc5; + u8 const *c = cast(u8 const *)data; + + for (i = 0; i < len; i++) { + h = (h ^ c[i]) * 0x01000193; + } + + return h; +} + +u64 gb_fnv64a(void const *data, isize len) { + isize i; + u64 h = 0xcbf29ce484222325ull; + u8 const *c = cast(u8 const *)data; + + for (i = 0; i < len; i++) { + h = (h ^ c[i]) * 0x100000001b3ll; + } + + return h; +} + +gb_inline u32 gb_murmur32(void const *data, isize len) { return gb_murmur32_seed(data, len, 0x9747b28c); } +gb_inline u64 gb_murmur64(void const *data, isize len) { return gb_murmur64_seed(data, len, 0x9747b28c); } + +u32 gb_murmur32_seed(void const *data, isize len, u32 seed) { + u32 const c1 = 0xcc9e2d51; + u32 const c2 = 0x1b873593; + u32 const r1 = 15; + u32 const r2 = 13; + u32 const m = 5; + u32 const n = 0xe6546b64; + + isize i, nblocks = len / 4; + u32 hash = seed, k1 = 0; + u32 const *blocks = cast(u32 const*)data; + u8 const *tail = cast(u8 const *)(data) + nblocks*4; + + for (i = 0; i < nblocks; i++) { + u32 k = blocks[i]; + k *= c1; + k = (k << r1) | (k >> (32 - r1)); + k *= c2; + + hash ^= k; + hash = ((hash << r2) | (hash >> (32 - r2))) * m + n; + } + + switch (len & 3) { + case 3: + k1 ^= tail[2] << 16; + case 2: + k1 ^= tail[1] << 8; + case 1: + k1 ^= tail[0]; + + k1 *= c1; + k1 = (k1 << r1) | (k1 >> (32 - r1)); + k1 *= c2; + hash ^= k1; + } + + hash ^= len; + hash ^= (hash >> 16); + hash *= 0x85ebca6b; + hash ^= (hash >> 13); + hash *= 0xc2b2ae35; + hash ^= (hash >> 16); + + return hash; +} + +u64 gb_murmur64_seed(void const *data_, isize len, u64 seed) { +#if defined(GB_ARCH_64_BIT) + u64 const m = 0xc6a4a7935bd1e995ULL; + i32 const r = 47; + + u64 h = seed ^ (len * m); + + u64 const *data = cast(u64 const *)data_; + u8 const *data2 = cast(u8 const *)data_; + u64 const* end = data + (len / 8); + + while (data != end) { + u64 k = *data++; + + k *= m; + k ^= k >> r; + k *= m; + + h ^= k; + h *= m; + } + + switch (len & 7) { + case 7: h ^= cast(u64)(data2[6]) << 48; + case 6: h ^= cast(u64)(data2[5]) << 40; + case 5: h ^= cast(u64)(data2[4]) << 32; + case 4: h ^= cast(u64)(data2[3]) << 24; + case 3: h ^= cast(u64)(data2[2]) << 16; + case 2: h ^= cast(u64)(data2[1]) << 8; + case 1: h ^= cast(u64)(data2[0]); + h *= m; + }; + + h ^= h >> r; + h *= m; + h ^= h >> r; + + return h; +#else + u64 h; + u32 const m = 0x5bd1e995; + i32 const r = 24; + + u32 h1 = cast(u32)(seed) ^ cast(u32)(len); + u32 h2 = cast(u32)(seed >> 32); + + u32 const *data = cast(u32 const *)data_; + + while (len >= 8) { + u32 k1, k2; + k1 = *data++; + k1 *= m; + k1 ^= k1 >> r; + k1 *= m; + h1 *= m; + h1 ^= k1; + len -= 4; + + k2 = *data++; + k2 *= m; + k2 ^= k2 >> r; + k2 *= m; + h2 *= m; + h2 ^= k2; + len -= 4; + } + + if (len >= 4) { + u32 k1 = *data++; + k1 *= m; + k1 ^= k1 >> r; + k1 *= m; + h1 *= m; + h1 ^= k1; + len -= 4; + } + + switch (len) { + case 3: h2 ^= (cast(u8 const *)data)[2] << 16; + case 2: h2 ^= (cast(u8 const *)data)[1] << 8; + case 1: h2 ^= (cast(u8 const *)data)[0] << 0; + h2 *= m; + }; + + h1 ^= h2 >> 18; + h1 *= m; + h2 ^= h1 >> 22; + h2 *= m; + h1 ^= h2 >> 17; + h1 *= m; + h2 ^= h1 >> 19; + h2 *= m; + + h = h1; + h = (h << 32) | h2; + + return h; +#endif +} + + + + + + + +//////////////////////////////////////////////////////////////// +// +// File Handling +// +// + +#if defined(GB_SYSTEM_WINDOWS) + + gb_internal wchar_t *gb__alloc_utf8_to_ucs2(gbAllocator a, char const *text, isize *w_len_) { + wchar_t *w_text = NULL; + isize len = 0, w_len = 0, w_len1 = 0; + if (text == NULL) { + if (w_len_) *w_len_ = w_len; + return NULL; + } + len = gb_strlen(text); + if (len == 0) { + if (w_len_) *w_len_ = w_len; + return NULL; + } + w_len = MultiByteToWideChar(CP_UTF8, MB_ERR_INVALID_CHARS, text, cast(int)len, NULL, 0); + if (w_len == 0) { + if (w_len_) *w_len_ = w_len; + return NULL; + } + w_text = gb_alloc_array(a, wchar_t, w_len+1); + w_len1 = MultiByteToWideChar(CP_UTF8, MB_ERR_INVALID_CHARS, text, cast(int)len, w_text, cast(int)w_len); + if (w_len1 == 0) { + gb_free(a, w_text); + if (w_len_) *w_len_ = 0; + return NULL; + } + w_text[w_len] = 0; + if (w_len_) *w_len_ = w_len; + return w_text; + } + + gb_internal GB_FILE_SEEK_PROC(gb__win32_file_seek) { + LARGE_INTEGER li_offset; + li_offset.QuadPart = offset; + if (!SetFilePointerEx(fd.p, li_offset, &li_offset, whence)) { + return false; + } + + if (new_offset) *new_offset = li_offset.QuadPart; + return true; + } + + gb_internal GB_FILE_READ_AT_PROC(gb__win32_file_read) { + b32 result = false; + DWORD size_ = cast(DWORD)(size > I32_MAX ? I32_MAX : size); + DWORD bytes_read_; + gb__win32_file_seek(fd, offset, gbSeekWhence_Begin, NULL); + if (ReadFile(fd.p, buffer, size_, &bytes_read_, NULL)) { + if (bytes_read) *bytes_read = bytes_read_; + result = true; + } + + return result; + } + + gb_internal GB_FILE_WRITE_AT_PROC(gb__win32_file_write) { + DWORD size_ = cast(DWORD)(size > I32_MAX ? I32_MAX : size); + DWORD bytes_written_; + gb__win32_file_seek(fd, offset, gbSeekWhence_Begin, NULL); + if (WriteFile(fd.p, buffer, size_, &bytes_written_, NULL)) { + if (bytes_written) *bytes_written = bytes_written_; + return true; + } + return false; + } + + gb_internal GB_FILE_CLOSE_PROC(gb__win32_file_close) { + CloseHandle(fd.p); + } + + gbFileOperations const gbDefaultFileOperations = { + gb__win32_file_read, + gb__win32_file_write, + gb__win32_file_seek, + gb__win32_file_close + }; + + gb_no_inline GB_FILE_OPEN_PROC(gb__win32_file_open) { + DWORD desired_access; + DWORD creation_disposition; + void *handle; + wchar_t *w_text; + + switch (mode & gbFileMode_Modes) { + case gbFileMode_Read: + desired_access = GENERIC_READ; + creation_disposition = OPEN_EXISTING; + break; + case gbFileMode_Write: + desired_access = GENERIC_WRITE; + creation_disposition = CREATE_ALWAYS; + break; + case gbFileMode_Append: + desired_access = GENERIC_WRITE; + creation_disposition = OPEN_ALWAYS; + break; + case gbFileMode_Read | gbFileMode_Rw: + desired_access = GENERIC_READ | GENERIC_WRITE; + creation_disposition = OPEN_EXISTING; + break; + case gbFileMode_Write | gbFileMode_Rw: + desired_access = GENERIC_READ | GENERIC_WRITE; + creation_disposition = CREATE_ALWAYS; + break; + case gbFileMode_Append | gbFileMode_Rw: + desired_access = GENERIC_READ | GENERIC_WRITE; + creation_disposition = OPEN_ALWAYS; + break; + default: + GB_PANIC("Invalid file mode"); + return gbFileError_Invalid; + } + + w_text = gb__alloc_utf8_to_ucs2(gb_heap_allocator(), filename, NULL); + if (w_text == NULL) { + return gbFileError_InvalidFilename; + } + handle = CreateFileW(w_text, + desired_access, + FILE_SHARE_READ|FILE_SHARE_DELETE, NULL, + creation_disposition, FILE_ATTRIBUTE_NORMAL, NULL); + + gb_free(gb_heap_allocator(), w_text); + + if (handle == INVALID_HANDLE_VALUE) { + DWORD err = GetLastError(); + switch (err) { + case ERROR_FILE_NOT_FOUND: return gbFileError_NotExists; + case ERROR_FILE_EXISTS: return gbFileError_Exists; + case ERROR_ALREADY_EXISTS: return gbFileError_Exists; + case ERROR_ACCESS_DENIED: return gbFileError_Permission; + } + return gbFileError_Invalid; + } + + if (mode & gbFileMode_Append) { + LARGE_INTEGER offset = {0}; + if (!SetFilePointerEx(handle, offset, NULL, gbSeekWhence_End)) { + CloseHandle(handle); + return gbFileError_Invalid; + } + } + + fd->p = handle; + *ops = gbDefaultFileOperations; + return gbFileError_None; + } + +#else // POSIX + gb_internal GB_FILE_SEEK_PROC(gb__posix_file_seek) { + #if defined(GB_SYSTEM_OSX) + i64 res = lseek(fd.i, offset, whence); + #else + i64 res = lseek64(fd.i, offset, whence); + #endif + if (res < 0) return false; + if (new_offset) *new_offset = res; + return true; + } + + gb_internal GB_FILE_READ_AT_PROC(gb__posix_file_read) { + isize res = pread(fd.i, buffer, size, offset); + if (res < 0) return false; + if (bytes_read) *bytes_read = res; + return true; + } + + gb_internal GB_FILE_WRITE_AT_PROC(gb__posix_file_write) { + isize res; + i64 curr_offset = 0; + gb__posix_file_seek(fd, 0, gbSeekWhence_Current, &curr_offset); + if (curr_offset == offset) { + // NOTE(bill): Writing to stdout et al. doesn't like pwrite for numerous reasons + res = write(cast(int)fd.i, buffer, size); + } else { + res = pwrite(cast(int)fd.i, buffer, size, offset); + } + if (res < 0) return false; + if (bytes_written) *bytes_written = res; + return true; + } + + + gb_internal GB_FILE_CLOSE_PROC(gb__posix_file_close) { + close(fd.i); + } + + gbFileOperations const gbDefaultFileOperations = { + gb__posix_file_read, + gb__posix_file_write, + gb__posix_file_seek, + gb__posix_file_close + }; + + gb_no_inline GB_FILE_OPEN_PROC(gb__posix_file_open) { + i32 os_mode; + switch (mode & gbFileMode_Modes) { + case gbFileMode_Read: + os_mode = O_RDONLY; + break; + case gbFileMode_Write: + os_mode = O_WRONLY | O_CREAT | O_TRUNC; + break; + case gbFileMode_Append: + os_mode = O_WRONLY | O_APPEND | O_CREAT; + break; + case gbFileMode_Read | gbFileMode_Rw: + os_mode = O_RDWR; + break; + case gbFileMode_Write | gbFileMode_Rw: + os_mode = O_RDWR | O_CREAT | O_TRUNC; + break; + case gbFileMode_Append | gbFileMode_Rw: + os_mode = O_RDWR | O_APPEND | O_CREAT; + break; + default: + GB_PANIC("Invalid file mode"); + return gbFileError_Invalid; + } + + fd->i = open(filename, os_mode, S_IRUSR | S_IWUSR | S_IRGRP | S_IWGRP | S_IROTH | S_IWOTH); + if (fd->i < 0) { + // TODO(bill): More file errors + return gbFileError_Invalid; + } + + *ops = gbDefaultFileOperations; + return gbFileError_None; + } + +#endif + + + +gbFileError gb_file_new(gbFile *f, gbFileDescriptor fd, gbFileOperations ops, char const *filename) { + gbFileError err = gbFileError_None; + isize len = gb_strlen(filename); + + // gb_printf_err("gb_file_new: %s\n", filename); + + f->ops = ops; + f->fd = fd; + f->filename = gb_alloc_array(gb_heap_allocator(), char, len+1); + gb_memcopy(cast(char *)f->filename, cast(char *)filename, len+1); + f->last_write_time = gb_file_last_write_time(f->filename); + + return err; +} + + + +gbFileError gb_file_open_mode(gbFile *f, gbFileMode mode, char const *filename) { + gbFileError err; +#if defined(GB_SYSTEM_WINDOWS) + err = gb__win32_file_open(&f->fd, &f->ops, mode, filename); +#else + err = gb__posix_file_open(&f->fd, &f->ops, mode, filename); +#endif + if (err == gbFileError_None) { + return gb_file_new(f, f->fd, f->ops, filename); + } + return err; +} + +gbFileError gb_file_close(gbFile *f) { + if (f == NULL) { + return gbFileError_Invalid; + } + +#if defined(GB_COMPILER_MSVC) + if (f->filename != NULL) { + gb_free(gb_heap_allocator(), cast(char *)f->filename); + } +#else + // TODO HACK(bill): Memory Leak!!! +#endif + +#if defined(GB_SYSTEM_WINDOWS) + if (f->fd.p == INVALID_HANDLE_VALUE) { + return gbFileError_Invalid; + } +#else + if (f->fd.i < 0) { + return gbFileError_Invalid; + } +#endif + + if (!f->ops.read_at) f->ops = gbDefaultFileOperations; + f->ops.close(f->fd); + + return gbFileError_None; +} + +gb_inline b32 gb_file_read_at_check(gbFile *f, void *buffer, isize size, i64 offset, isize *bytes_read) { + if (!f->ops.read_at) f->ops = gbDefaultFileOperations; + return f->ops.read_at(f->fd, buffer, size, offset, bytes_read); +} + +gb_inline b32 gb_file_write_at_check(gbFile *f, void const *buffer, isize size, i64 offset, isize *bytes_written) { + if (!f->ops.read_at) f->ops = gbDefaultFileOperations; + return f->ops.write_at(f->fd, buffer, size, offset, bytes_written); +} + + +gb_inline b32 gb_file_read_at(gbFile *f, void *buffer, isize size, i64 offset) { + return gb_file_read_at_check(f, buffer, size, offset, NULL); +} + +gb_inline b32 gb_file_write_at(gbFile *f, void const *buffer, isize size, i64 offset) { + return gb_file_write_at_check(f, buffer, size, offset, NULL); +} + +gb_inline i64 gb_file_seek(gbFile *f, i64 offset) { + i64 new_offset = 0; + if (!f->ops.read_at) f->ops = gbDefaultFileOperations; + f->ops.seek(f->fd, offset, gbSeekWhence_Begin, &new_offset); + return new_offset; +} + +gb_inline i64 gb_file_seek_to_end(gbFile *f) { + i64 new_offset = 0; + if (!f->ops.read_at) f->ops = gbDefaultFileOperations; + f->ops.seek(f->fd, 0, gbSeekWhence_End, &new_offset); + return new_offset; +} + +// NOTE(bill): Skips a certain amount of bytes +gb_inline i64 gb_file_skip(gbFile *f, i64 bytes) { + i64 new_offset = 0; + if (!f->ops.read_at) f->ops = gbDefaultFileOperations; + f->ops.seek(f->fd, bytes, gbSeekWhence_Current, &new_offset); + return new_offset; +} + +gb_inline i64 gb_file_tell(gbFile *f) { + i64 new_offset = 0; + if (!f->ops.read_at) f->ops = gbDefaultFileOperations; + f->ops.seek(f->fd, 0, gbSeekWhence_Current, &new_offset); + return new_offset; +} +gb_inline b32 gb_file_read (gbFile *f, void *buffer, isize size) { return gb_file_read_at(f, buffer, size, gb_file_tell(f)); } +gb_inline b32 gb_file_write(gbFile *f, void const *buffer, isize size) { return gb_file_write_at(f, buffer, size, gb_file_tell(f)); } + + +gbFileError gb_file_create(gbFile *f, char const *filename) { + return gb_file_open_mode(f, gbFileMode_Write|gbFileMode_Rw, filename); +} + + +gbFileError gb_file_open(gbFile *f, char const *filename) { + return gb_file_open_mode(f, gbFileMode_Read, filename); +} + + +char const *gb_file_name(gbFile *f) { return f->filename ? f->filename : ""; } + +gb_inline b32 gb_file_has_changed(gbFile *f) { + b32 result = false; + gbFileTime last_write_time = gb_file_last_write_time(f->filename); + if (f->last_write_time != last_write_time) { + result = true; + f->last_write_time = last_write_time; + } + return result; +} + +// TODO(bill): Is this a bad idea? +gb_global b32 gb__std_file_set = false; +gb_global gbFile gb__std_files[gbFileStandard_Count] = {{0}}; + + +#if defined(GB_SYSTEM_WINDOWS) + +gb_inline gbFile *const gb_file_get_standard(gbFileStandardType std) { + if (!gb__std_file_set) { + #define GB__SET_STD_FILE(type, v) gb__std_files[type].fd.p = v; gb__std_files[type].ops = gbDefaultFileOperations + GB__SET_STD_FILE(gbFileStandard_Input, GetStdHandle(STD_INPUT_HANDLE)); + GB__SET_STD_FILE(gbFileStandard_Output, GetStdHandle(STD_OUTPUT_HANDLE)); + GB__SET_STD_FILE(gbFileStandard_Error, GetStdHandle(STD_ERROR_HANDLE)); + #undef GB__SET_STD_FILE + gb__std_file_set = true; + } + return &gb__std_files[std]; +} + +gb_inline i64 gb_file_size(gbFile *f) { + LARGE_INTEGER size; + GetFileSizeEx(f->fd.p, &size); + return size.QuadPart; +} + +gbFileError gb_file_truncate(gbFile *f, i64 size) { + gbFileError err = gbFileError_None; + i64 prev_offset = gb_file_tell(f); + gb_file_seek(f, size); + if (!SetEndOfFile(f)) { + err = gbFileError_TruncationFailure; + } + gb_file_seek(f, prev_offset); + return err; +} + + +b32 gb_file_exists(char const *name) { + WIN32_FIND_DATAW data; + wchar_t *w_text; + void *handle; + b32 found = false; + gbAllocator a = gb_heap_allocator(); + + w_text = gb__alloc_utf8_to_ucs2(a, name, NULL); + if (w_text == NULL) { + return false; + } + handle = FindFirstFileW(w_text, &data); + gb_free(a, w_text); + found = handle != INVALID_HANDLE_VALUE; + if (found) FindClose(handle); + return found; +} + +#else // POSIX + +gb_inline gbFile *const gb_file_get_standard(gbFileStandardType std) { + if (!gb__std_file_set) { + #define GB__SET_STD_FILE(type, v) gb__std_files[type].fd.i = v; gb__std_files[type].ops = gbDefaultFileOperations + GB__SET_STD_FILE(gbFileStandard_Input, 0); + GB__SET_STD_FILE(gbFileStandard_Output, 1); + GB__SET_STD_FILE(gbFileStandard_Error, 2); + #undef GB__SET_STD_FILE + gb__std_file_set = true; + } + return &gb__std_files[std]; +} + +gb_inline i64 gb_file_size(gbFile *f) { + i64 size = 0; + i64 prev_offset = gb_file_tell(f); + gb_file_seek_to_end(f); + size = gb_file_tell(f); + gb_file_seek(f, prev_offset); + return size; +} + +gb_inline gbFileError gb_file_truncate(gbFile *f, i64 size) { + gbFileError err = gbFileError_None; + int i = ftruncate(f->fd.i, size); + if (i != 0) err = gbFileError_TruncationFailure; + return err; +} + +gb_inline b32 gb_file_exists(char const *name) { + return access(name, F_OK) != -1; +} +#endif + + + +#if defined(GB_SYSTEM_WINDOWS) +gbFileTime gb_file_last_write_time(char const *filepath) { + ULARGE_INTEGER li = {0}; + FILETIME last_write_time = {0}; + WIN32_FILE_ATTRIBUTE_DATA data = {0}; + gbAllocator a = gb_heap_allocator(); + + wchar_t *w_text = gb__alloc_utf8_to_ucs2(a, filepath, NULL); + if (w_text == NULL) { + return 0; + } + + if (GetFileAttributesExW(w_text, GetFileExInfoStandard, &data)) { + last_write_time = data.ftLastWriteTime; + } + gb_free(a, w_text); + + li.LowPart = last_write_time.dwLowDateTime; + li.HighPart = last_write_time.dwHighDateTime; + return cast(gbFileTime)li.QuadPart; +} + + +gb_inline b32 gb_file_copy(char const *existing_filename, char const *new_filename, b32 fail_if_exists) { + wchar_t *w_old = NULL; + wchar_t *w_new = NULL; + gbAllocator a = gb_heap_allocator(); + b32 result = false; + + w_old = gb__alloc_utf8_to_ucs2(a, existing_filename, NULL); + if (w_old == NULL) { + return false; + } + w_new = gb__alloc_utf8_to_ucs2(a, new_filename, NULL); + if (w_new != NULL) { + result = CopyFileW(w_old, w_new, fail_if_exists); + } + gb_free(a, w_new); + gb_free(a, w_old); + return result; +} + +gb_inline b32 gb_file_move(char const *existing_filename, char const *new_filename) { + wchar_t *w_old = NULL; + wchar_t *w_new = NULL; + gbAllocator a = gb_heap_allocator(); + b32 result = false; + + w_old = gb__alloc_utf8_to_ucs2(a, existing_filename, NULL); + if (w_old == NULL) { + return false; + } + w_new = gb__alloc_utf8_to_ucs2(a, new_filename, NULL); + if (w_new != NULL) { + result = MoveFileW(w_old, w_new); + } + gb_free(a, w_new); + gb_free(a, w_old); + return result; +} + +b32 gb_file_remove(char const *filename) { + wchar_t *w_filename = NULL; + gbAllocator a = gb_heap_allocator(); + b32 result = false; + w_filename = gb__alloc_utf8_to_ucs2(a, filename, NULL); + if (w_filename == NULL) { + return false; + } + result = DeleteFileW(w_filename); + gb_free(a, w_filename); + return result; +} + + + +#else + +gbFileTime gb_file_last_write_time(char const *filepath) { + time_t result = 0; + struct stat file_stat; + + if (stat(filepath, &file_stat) == 0) { + result = file_stat.st_mtime; + } + + return cast(gbFileTime)result; +} + + +gb_inline b32 gb_file_copy(char const *existing_filename, char const *new_filename, b32 fail_if_exists) { +#if defined(GB_SYSTEM_OSX) + return copyfile(existing_filename, new_filename, NULL, COPYFILE_DATA) == 0; +#else + isize size; + int existing_fd = open(existing_filename, O_RDONLY, 0); + int new_fd = open(new_filename, O_WRONLY|O_CREAT, 0666); + + struct stat stat_existing; + fstat(existing_fd, &stat_existing); + + size = sendfile(new_fd, existing_fd, 0, stat_existing.st_size); + + close(new_fd); + close(existing_fd); + + return size == stat_existing.st_size; +#endif +} + +gb_inline b32 gb_file_move(char const *existing_filename, char const *new_filename) { + if (link(existing_filename, new_filename) == 0) { + return unlink(existing_filename) != -1; + } + return false; +} + +b32 gb_file_remove(char const *filename) { +#if defined(GB_SYSTEM_OSX) + return unlink(filename) != -1; +#else + return remove(filename) == 0; +#endif +} + + +#endif + + + + + +gbFileContents gb_file_read_contents(gbAllocator a, b32 zero_terminate, char const *filepath) { + gbFileContents result = {0}; + gbFile file = {0}; + + result.allocator = a; + + if (gb_file_open(&file, filepath) == gbFileError_None) { + isize file_size = cast(isize)gb_file_size(&file); + if (file_size > 0) { + result.data = gb_alloc(a, zero_terminate ? file_size+1 : file_size); + result.size = file_size; + gb_file_read_at(&file, result.data, result.size, 0); + if (zero_terminate) { + u8 *str = cast(u8 *)result.data; + str[file_size] = '\0'; + } + } + gb_file_close(&file); + } + + return result; +} + +void gb_file_free_contents(gbFileContents *fc) { + GB_ASSERT_NOT_NULL(fc->data); + gb_free(fc->allocator, fc->data); + fc->data = NULL; + fc->size = 0; +} + + + + + +gb_inline b32 gb_path_is_absolute(char const *path) { + b32 result = false; + GB_ASSERT_NOT_NULL(path); +#if defined(GB_SYSTEM_WINDOWS) + result == (gb_strlen(path) > 2) && + gb_char_is_alpha(path[0]) && + (path[1] == ':' && path[2] == GB_PATH_SEPARATOR); +#else + result = (gb_strlen(path) > 0 && path[0] == GB_PATH_SEPARATOR); +#endif + return result; +} + +gb_inline b32 gb_path_is_relative(char const *path) { return !gb_path_is_absolute(path); } + +gb_inline b32 gb_path_is_root(char const *path) { + b32 result = false; + GB_ASSERT_NOT_NULL(path); +#if defined(GB_SYSTEM_WINDOWS) + result = gb_path_is_absolute(path) && (gb_strlen(path) == 3); +#else + result = gb_path_is_absolute(path) && (gb_strlen(path) == 1); +#endif + return result; +} + +gb_inline char const *gb_path_base_name(char const *path) { + char const *ls; + GB_ASSERT_NOT_NULL(path); + ls = gb_char_last_occurence(path, '/'); + return (ls == NULL) ? path : ls+1; +} + +gb_inline char const *gb_path_extension(char const *path) { + char const *ld; + GB_ASSERT_NOT_NULL(path); + ld = gb_char_last_occurence(path, '.'); + return (ld == NULL) ? NULL : ld+1; +} + + +#if !defined(_WINDOWS_) && defined(GB_SYSTEM_WINDOWS) +GB_DLL_IMPORT DWORD WINAPI GetFullPathNameA(char const *lpFileName, DWORD nBufferLength, char *lpBuffer, char **lpFilePart); +GB_DLL_IMPORT DWORD WINAPI GetFullPathNameW(wchar_t const *lpFileName, DWORD nBufferLength, wchar_t *lpBuffer, wchar_t **lpFilePart); +#endif + +char *gb_path_get_full_name(gbAllocator a, char const *path) { +#if defined(GB_SYSTEM_WINDOWS) +// TODO(bill): Make UTF-8 + wchar_t *w_path = NULL; + wchar_t *w_fullpath = NULL; + isize w_len = 0; + isize new_len = 0; + isize new_len1 = 0; + char *new_path = 0; + w_path = gb__alloc_utf8_to_ucs2(gb_heap_allocator(), path, NULL); + if (w_path == NULL) { + return NULL; + } + w_len = GetFullPathNameW(w_path, 0, NULL, NULL); + if (w_len == 0) { + return NULL; + } + w_fullpath = gb_alloc_array(gb_heap_allocator(), wchar_t, w_len+1); + GetFullPathNameW(w_path, cast(int)w_len, w_fullpath, NULL); + w_fullpath[w_len] = 0; + gb_free(gb_heap_allocator(), w_path); + + new_len = WideCharToMultiByte(CP_UTF8, WC_ERR_INVALID_CHARS, w_fullpath, cast(int)w_len, NULL, 0, NULL, NULL); + if (new_len == 0) { + gb_free(gb_heap_allocator(), w_fullpath); + return NULL; + } + new_path = gb_alloc_array(a, char, new_len+1); + new_len1 = WideCharToMultiByte(CP_UTF8, WC_ERR_INVALID_CHARS, w_fullpath, cast(int)w_len, new_path, cast(int)new_len, NULL, NULL); + if (new_len1 == 0) { + gb_free(gb_heap_allocator(), w_fullpath); + gb_free(a, new_path); + return NULL; + } + new_path[new_len] = 0; + return new_path; +#else + char *p, *result, *fullpath = NULL; + isize len; + p = realpath(path, NULL); + fullpath = p; + if (p == NULL) { + // NOTE(bill): File does not exist + fullpath = cast(char *)path; + } + + len = gb_strlen(fullpath); + + result = gb_alloc_array(a, char, len + 1); + gb_memmove(result, fullpath, len); + result[len] = 0; + free(p); + + return result; +#endif +} + + + + + +//////////////////////////////////////////////////////////////// +// +// Printing +// +// + + +isize gb_printf(char const *fmt, ...) { + isize res; + va_list va; + va_start(va, fmt); + res = gb_printf_va(fmt, va); + va_end(va); + return res; +} + + +isize gb_printf_err(char const *fmt, ...) { + isize res; + va_list va; + va_start(va, fmt); + res = gb_printf_err_va(fmt, va); + va_end(va); + return res; +} + +isize gb_fprintf(struct gbFile *f, char const *fmt, ...) { + isize res; + va_list va; + va_start(va, fmt); + res = gb_fprintf_va(f, fmt, va); + va_end(va); + return res; +} + +char *gb_bprintf(char const *fmt, ...) { + va_list va; + char *str; + va_start(va, fmt); + str = gb_bprintf_va(fmt, va); + va_end(va); + return str; +} + +isize gb_snprintf(char *str, isize n, char const *fmt, ...) { + isize res; + va_list va; + va_start(va, fmt); + res = gb_snprintf_va(str, n, fmt, va); + va_end(va); + return res; +} + + + +gb_inline isize gb_printf_va(char const *fmt, va_list va) { + return gb_fprintf_va(gb_file_get_standard(gbFileStandard_Output), fmt, va); +} + +gb_inline isize gb_printf_err_va(char const *fmt, va_list va) { + return gb_fprintf_va(gb_file_get_standard(gbFileStandard_Error), fmt, va); +} + +gb_inline isize gb_fprintf_va(struct gbFile *f, char const *fmt, va_list va) { + gb_local_persist char buf[4096]; + isize len = gb_snprintf_va(buf, gb_size_of(buf), fmt, va); + gb_file_write(f, buf, len-1); // NOTE(bill): prevent extra whitespace + return len; +} + + +gb_inline char *gb_bprintf_va(char const *fmt, va_list va) { + gb_local_persist char buffer[4096]; + gb_snprintf_va(buffer, gb_size_of(buffer), fmt, va); + return buffer; +} + + +enum { + gbFmt_Minus = GB_BIT(0), + gbFmt_Plus = GB_BIT(1), + gbFmt_Alt = GB_BIT(2), + gbFmt_Space = GB_BIT(3), + gbFmt_Zero = GB_BIT(4), + + gbFmt_Char = GB_BIT(5), + gbFmt_Short = GB_BIT(6), + gbFmt_Int = GB_BIT(7), + gbFmt_Long = GB_BIT(8), + gbFmt_Llong = GB_BIT(9), + gbFmt_Size = GB_BIT(10), + gbFmt_Intptr = GB_BIT(11), + + gbFmt_Unsigned = GB_BIT(12), + gbFmt_Lower = GB_BIT(13), + gbFmt_Upper = GB_BIT(14), + + + gbFmt_Done = GB_BIT(30), + + gbFmt_Ints = gbFmt_Char|gbFmt_Short|gbFmt_Int|gbFmt_Long|gbFmt_Llong|gbFmt_Size|gbFmt_Intptr +}; + +typedef struct { + i32 base; + i32 flags; + i32 width; + i32 precision; +} gbprivFmtInfo; + + +gb_internal isize gb__print_string(char *text, isize max_len, gbprivFmtInfo *info, char const *str) { + // TODO(bill): Get precision and width to work correctly. How does it actually work?! + // TODO(bill): This looks very buggy indeed. + isize res = 0, len; + isize remaining = max_len; + + if (info && info->precision >= 0) { + len = gb_strnlen(str, info->precision); + } else { + len = gb_strlen(str); + } + + if (info && (info->width == 0 || info->flags & gbFmt_Minus)) { + if (info->precision > 0) { + len = info->precision < len ? info->precision : len; + } + + res += gb_strlcpy(text, str, len); + + if (info->width > res) { + isize padding = info->width - len; + char pad = (info->flags & gbFmt_Zero) ? '0' : ' '; + while (padding --> 0 && remaining --> 0) { + *text++ = pad, res++; + } + } + } else { + if (info && (info->width > res)) { + isize padding = info->width - len; + char pad = (info->flags & gbFmt_Zero) ? '0' : ' '; + while (padding --> 0 && remaining --> 0) { + *text++ = pad, res++; + } + } + + res += gb_strlcpy(text, str, len); + } + + + if (info) { + if (info->flags & gbFmt_Upper) { + gb_str_to_upper(text); + } else if (info->flags & gbFmt_Lower) { + gb_str_to_lower(text); + } + } + + return res; +} + +gb_internal isize gb__print_char(char *text, isize max_len, gbprivFmtInfo *info, char arg) { + char str[2] = ""; + str[0] = arg; + return gb__print_string(text, max_len, info, str); +} + + +gb_internal isize gb__print_i64(char *text, isize max_len, gbprivFmtInfo *info, i64 value) { + char num[130]; + gb_i64_to_str(value, num, info ? info->base : 10); + return gb__print_string(text, max_len, info, num); +} + +gb_internal isize gb__print_u64(char *text, isize max_len, gbprivFmtInfo *info, u64 value) { + char num[130]; + gb_u64_to_str(value, num, info ? info->base : 10); + return gb__print_string(text, max_len, info, num); +} + + +gb_internal isize gb__print_f64(char *text, isize max_len, gbprivFmtInfo *info, f64 arg) { + // TODO(bill): Handle exponent notation + isize width, len, remaining = max_len; + char *text_begin = text; + + if (arg) { + u64 value; + if (arg < 0) { + if (remaining > 1) { + *text = '-', remaining--; + } + text++; + arg = -arg; + } else if (info->flags & gbFmt_Minus) { + if (remaining > 1) { + *text = '+', remaining--; + } + text++; + } + + value = cast(u64)arg; + len = gb__print_u64(text, remaining, NULL, value); + text += len; + + if (len >= remaining) { + remaining = gb_min(remaining, 1); + } else { + remaining -= len; + } + arg -= value; + + if (info->precision < 0) { + info->precision = 6; + } + + if ((info->flags & gbFmt_Alt) || info->precision > 0) { + i64 mult = 10; + if (remaining > 1) { + *text = '.', remaining--; + } + text++; + while (info->precision-- > 0) { + value = cast(u64)(arg * mult); + len = gb__print_u64(text, remaining, NULL, value); + text += len; + if (len >= remaining) { + remaining = gb_min(remaining, 1); + } else { + remaining -= len; + } + arg -= cast(f64)value / mult; + mult *= 10; + } + } + } else { + if (remaining > 1) { + *text = '0', remaining--; + } + text++; + if (info->flags & gbFmt_Alt) { + if (remaining > 1) { + *text = '.', remaining--; + } + text++; + } + } + + width = info->width - (text - text_begin); + if (width > 0) { + char fill = (info->flags & gbFmt_Zero) ? '0' : ' '; + char *end = text+remaining-1; + len = (text - text_begin); + + for (len = (text - text_begin); len--; ) { + if ((text_begin+len+width) < end) { + *(text_begin+len+width) = *(text_begin+len); + } + } + + len = width; + text += len; + if (len >= remaining) { + remaining = gb_min(remaining, 1); + } else { + remaining -= len; + } + + while (len--) { + if (text_begin+len < end) { + text_begin[len] = fill; + } + } + } + + return (text - text_begin); +} + + + +gb_no_inline isize gb_snprintf_va(char *text, isize max_len, char const *fmt, va_list va) { + char const *text_begin = text; + isize remaining = max_len, res; + + while (*fmt) { + gbprivFmtInfo info = {0}; + isize len = 0; + info.precision = -1; + + while (*fmt && *fmt != '%' && remaining) { + *text++ = *fmt++; + } + + if (*fmt == '%') { + do { + switch (*++fmt) { + case '-': info.flags |= gbFmt_Minus; break; + case '+': info.flags |= gbFmt_Plus; break; + case '#': info.flags |= gbFmt_Alt; break; + case ' ': info.flags |= gbFmt_Space; break; + case '0': info.flags |= gbFmt_Zero; break; + default: info.flags |= gbFmt_Done; break; + } + } while (!(info.flags & gbFmt_Done)); + } + + // NOTE(bill): Optional Width + if (*fmt == '*') { + int width = va_arg(va, int); + if (width < 0) { + info.flags |= gbFmt_Minus; + info.width = -width; + } else { + info.width = width; + } + fmt++; + } else { + info.width = cast(i32)gb_str_to_i64(fmt, cast(char **)&fmt, 10); + } + + // NOTE(bill): Optional Precision + if (*fmt == '.') { + fmt++; + if (*fmt == '*') { + info.precision = va_arg(va, int); + fmt++; + } else { + info.precision = cast(i32)gb_str_to_i64(fmt, cast(char **)&fmt, 10); + } + info.flags &= ~gbFmt_Zero; + } + + + switch (*fmt++) { + case 'h': + if (*fmt == 'h') { // hh => char + info.flags |= gbFmt_Char; + fmt++; + } else { // h => short + info.flags |= gbFmt_Short; + } + break; + + case 'l': + if (*fmt == 'l') { // ll => long long + info.flags |= gbFmt_Llong; + fmt++; + } else { // l => long + info.flags |= gbFmt_Long; + } + break; + + break; + + case 'z': // NOTE(bill): usize + info.flags |= gbFmt_Unsigned; + // fallthrough + case 't': // NOTE(bill): isize + info.flags |= gbFmt_Size; + break; + + default: fmt--; break; + } + + + switch (*fmt) { + case 'u': + info.flags |= gbFmt_Unsigned; + // fallthrough + case 'd': + case 'i': + info.base = 10; + break; + + case 'o': + info.base = 8; + break; + + case 'x': + info.base = 16; + info.flags |= (gbFmt_Unsigned | gbFmt_Lower); + break; + + case 'X': + info.base = 16; + info.flags |= (gbFmt_Unsigned | gbFmt_Upper); + break; + + case 'f': + case 'F': + case 'g': + case 'G': + len = gb__print_f64(text, remaining, &info, va_arg(va, f64)); + break; + + case 'a': + case 'A': + // TODO(bill): + break; + + case 'c': + len = gb__print_char(text, remaining, &info, cast(char)va_arg(va, int)); + break; + + case 's': + len = gb__print_string(text, remaining, &info, va_arg(va, char *)); + break; + + case 'p': + info.base = 16; + info.flags |= (gbFmt_Lower|gbFmt_Unsigned|gbFmt_Alt|gbFmt_Intptr); + break; + + case '%': + len = gb__print_char(text, remaining, &info, '%'); + break; + + default: fmt--; break; + } + + fmt++; + + if (info.base != 0) { + if (info.flags & gbFmt_Unsigned) { + u64 value = 0; + switch (info.flags & gbFmt_Ints) { + case gbFmt_Char: value = cast(u64)cast(u8) va_arg(va, int); break; + case gbFmt_Short: value = cast(u64)cast(u16)va_arg(va, int); break; + case gbFmt_Long: value = cast(u64)va_arg(va, unsigned long); break; + case gbFmt_Llong: value = cast(u64)va_arg(va, unsigned long long); break; + case gbFmt_Size: value = cast(u64)va_arg(va, usize); break; + case gbFmt_Intptr: value = cast(u64)va_arg(va, uintptr); break; + default: value = cast(u64)va_arg(va, unsigned int); break; + } + + len = gb__print_u64(text, remaining, &info, value); + + } else { + i64 value = 0; + switch (info.flags & gbFmt_Ints) { + case gbFmt_Char: value = cast(i64)cast(i8) va_arg(va, int); break; + case gbFmt_Short: value = cast(i64)cast(i16)va_arg(va, int); break; + case gbFmt_Long: value = cast(i64)va_arg(va, long); break; + case gbFmt_Llong: value = cast(i64)va_arg(va, long long); break; + case gbFmt_Size: value = cast(i64)va_arg(va, usize); break; + case gbFmt_Intptr: value = cast(i64)va_arg(va, uintptr); break; + default: value = cast(i64)va_arg(va, int); break; + } + + len = gb__print_i64(text, remaining, &info, value); + } + } + + + text += len; + if (len >= remaining) { + remaining = gb_min(remaining, 1); + } else { + remaining -= len; + } + } + + *text++ = '\0'; + res = (text - text_begin); + return (res >= max_len || res < 0) ? -1 : res; +} + + +//////////////////////////////////////////////////////////////// +// +// DLL Handling +// +// + +#if defined(GB_SYSTEM_WINDOWS) + +gbDllHandle gb_dll_load(char const *filepath) { + return cast(gbDllHandle)LoadLibraryA(filepath); +} +gb_inline void gb_dll_unload (gbDllHandle dll) { FreeLibrary(cast(HMODULE)dll); } +gb_inline gbDllProc gb_dll_proc_address(gbDllHandle dll, char const *proc_name) { return cast(gbDllProc)GetProcAddress(cast(HMODULE)dll, proc_name); } + +#else // POSIX + +gbDllHandle gb_dll_load(char const *filepath) { + // TODO(bill): Should this be RTLD_LOCAL? + return cast(gbDllHandle)dlopen(filepath, RTLD_LAZY|RTLD_GLOBAL); +} + +gb_inline void gb_dll_unload (gbDllHandle dll) { dlclose(dll); } +gb_inline gbDllProc gb_dll_proc_address(gbDllHandle dll, char const *proc_name) { return cast(gbDllProc)dlsym(dll, proc_name); } + +#endif + + +//////////////////////////////////////////////////////////////// +// +// Time +// +// + +#if defined(GB_COMPILER_MSVC) && !defined(__clang__) + gb_inline u64 gb_rdtsc(void) { return __rdtsc(); } +#elif defined(__i386__) + gb_inline u64 gb_rdtsc(void) { + u64 x; + __asm__ volatile (".byte 0x0f, 0x31" : "=A" (x)); + return x; + } +#elif defined(__x86_64__) + gb_inline u64 gb_rdtsc(void) { + u32 hi, lo; + __asm__ __volatile__ ("rdtsc" : "=a"(lo), "=d"(hi)); + return (cast(u64)lo) | ((cast(u64)hi)<<32); + } +#elif defined(__powerpc__) + gb_inline u64 gb_rdtsc(void) { + u64 result = 0; + u32 upper, lower,tmp; + __asm__ volatile( + "0: \n" + "\tmftbu %0 \n" + "\tmftb %1 \n" + "\tmftbu %2 \n" + "\tcmpw %2,%0 \n" + "\tbne 0b \n" + : "=r"(upper),"=r"(lower),"=r"(tmp) + ); + result = upper; + result = result<<32; + result = result|lower; + + return result; + } +#endif + +#if defined(GB_SYSTEM_WINDOWS) + + gb_inline f64 gb_time_now(void) { + gb_local_persist LARGE_INTEGER win32_perf_count_freq = {0}; + f64 result; + LARGE_INTEGER counter; + if (!win32_perf_count_freq.QuadPart) { + QueryPerformanceFrequency(&win32_perf_count_freq); + GB_ASSERT(win32_perf_count_freq.QuadPart != 0); + } + + QueryPerformanceCounter(&counter); + + result = counter.QuadPart / cast(f64)(win32_perf_count_freq.QuadPart); + return result; + } + + gb_inline u64 gb_utc_time_now(void) { + FILETIME ft; + ULARGE_INTEGER li; + + GetSystemTimeAsFileTime(&ft); + li.LowPart = ft.dwLowDateTime; + li.HighPart = ft.dwHighDateTime; + + return li.QuadPart/10; + } + + gb_inline void gb_sleep_ms(u32 ms) { Sleep(ms); } + +#else + + gb_global f64 gb__timebase = 0.0; + gb_global u64 gb__timestart = 0; + + gb_inline f64 gb_time_now(void) { +#if defined(GB_SYSTEM_OSX) + f64 result; + + if (!gb__timestart) { + mach_timebase_info_data_t tb = {0}; + mach_timebase_info(&tb); + gb__timebase = tb.numer; + gb__timebase /= tb.denom; + gb__timestart = mach_absolute_time(); + } + + // NOTE(bill): mach_absolute_time() returns things in nanoseconds + result = 1.0e-9 * (mach_absolute_time() - gb__timestart) * gb__timebase; + return result; +#else + struct timespec t; + f64 result; + + // IMPORTANT TODO(bill): THIS IS A HACK + clock_gettime(1 /*CLOCK_MONOTONIC*/, &t); + result = t.tv_sec + 1.0e-9 * t.tv_nsec; + return result; +#endif + } + + gb_inline u64 gb_utc_time_now(void) { + struct timespec t; +#if defined(GB_SYSTEM_OSX) + clock_serv_t cclock; + mach_timespec_t mts; + host_get_clock_service(mach_host_self(), CALENDAR_CLOCK, &cclock); + clock_get_time(cclock, &mts); + mach_port_deallocate(mach_task_self(), cclock); + t.tv_sec = mts.tv_sec; + t.tv_nsec = mts.tv_nsec; +#else + // IMPORTANT TODO(bill): THIS IS A HACK + clock_gettime(0 /*CLOCK_REALTIME*/, &t); +#endif + return cast(u64)t.tv_sec * 1000000ull + t.tv_nsec/1000 + 11644473600000000ull; + } + + gb_inline void gb_sleep_ms(u32 ms) { + struct timespec req = {cast(time_t)ms/1000, cast(long)((ms%1000)*1000000)}; + struct timespec rem = {0, 0}; + nanosleep(&req, &rem); + } + +#endif + + + +//////////////////////////////////////////////////////////////// +// +// Miscellany +// +// + +gb_global gbAtomic32 gb__random_shared_counter = {0}; + +gb_internal u32 gb__get_noise_from_time(void) { + u32 accum = 0; + f64 start, remaining, end, curr = 0; + u64 interval = 100000ll; + + start = gb_time_now(); + remaining = (interval - cast(u64)(interval*start)%interval) / cast(f64)interval; + end = start + remaining; + + do { + curr = gb_time_now(); + accum += cast(u32)curr; + } while (curr >= end); + return accum; +} + +// NOTE(bill): Partly from http://preshing.com/20121224/how-to-generate-a-sequence-of-unique-random-integers/ +// But the generation is even more random-er-est + +gb_internal gb_inline u32 gb__permute_qpr(u32 x) { + gb_local_persist u32 const prime = 4294967291; // 2^32 - 5 + if (x >= prime) { + return x; + } else { + u32 residue = cast(u32)(cast(u64) x * x) % prime; + if (x <= prime / 2) { + return residue; + } else { + return prime - residue; + } + } +} + +gb_internal gb_inline u32 gb__permute_with_offset(u32 x, u32 offset) { + return (gb__permute_qpr(x) + offset) ^ 0x5bf03635; +} + + +void gb_random_init(gbRandom *r) { + u64 time, tick; + isize i, j; + u32 x = 0; + r->value = 0; + + r->offsets[0] = gb__get_noise_from_time(); + r->offsets[1] = gb_atomic32_fetch_add(&gb__random_shared_counter, 1); + r->offsets[2] = gb_thread_current_id(); + r->offsets[3] = gb_thread_current_id() * 3 + 1; + time = gb_utc_time_now(); + r->offsets[4] = cast(u32)(time >> 32); + r->offsets[5] = cast(u32)time; + r->offsets[6] = gb__get_noise_from_time(); + tick = gb_rdtsc(); + r->offsets[7] = cast(u32)(tick ^ (tick >> 32)); + + for (j = 0; j < 4; j++) { + for (i = 0; i < gb_count_of(r->offsets); i++) { + r->offsets[i] = x = gb__permute_with_offset(x, r->offsets[i]); + } + } +} + +u32 gb_random_gen_u32(gbRandom *r) { + u32 x = r->value; + u32 carry = 1; + isize i; + for (i = 0; i < gb_count_of(r->offsets); i++) { + x = gb__permute_with_offset(x, r->offsets[i]); + if (carry > 0) { + carry = ++r->offsets[i] ? 0 : 1; + } + } + + r->value = x; + return x; +} + +u32 gb_random_gen_u32_unique(gbRandom *r) { + u32 x = r->value; + isize i; + r->value++; + for (i = 0; i < gb_count_of(r->offsets); i++) { + x = gb__permute_with_offset(x, r->offsets[i]); + } + + return x; +} + +u64 gb_random_gen_u64(gbRandom *r) { + return ((cast(u64)gb_random_gen_u32(r)) << 32) | gb_random_gen_u32(r); +} + + +isize gb_random_gen_isize(gbRandom *r) { + u64 u = gb_random_gen_u64(r); + return *cast(isize *)&u; +} + + + + +i64 gb_random_range_i64(gbRandom *r, i64 lower_inc, i64 higher_inc) { + u64 u = gb_random_gen_u64(r); + i64 i = *cast(i64 *)&u; + i64 diff = higher_inc-lower_inc+1; + i %= diff; + i += lower_inc; + return i; +} + +isize gb_random_range_isize(gbRandom *r, isize lower_inc, isize higher_inc) { + u64 u = gb_random_gen_u64(r); + isize i = *cast(isize *)&u; + isize diff = higher_inc-lower_inc+1; + i %= diff; + i += lower_inc; + return i; +} + +// NOTE(bill): Semi-cc'ed from gb_math to remove need for fmod and math.h +f64 gb__copy_sign64(f64 x, f64 y) { + i64 ix, iy; + ix = *(i64 *)&x; + iy = *(i64 *)&y; + + ix &= 0x7fffffffffffffff; + ix |= iy & 0x8000000000000000; + return *cast(f64 *)&ix; +} + +f64 gb__floor64 (f64 x) { return cast(f64)((x >= 0.0) ? cast(i64)x : cast(i64)(x-0.9999999999999999)); } +f64 gb__ceil64 (f64 x) { return cast(f64)((x < 0) ? cast(i64)x : (cast(i64)x)+1); } +f64 gb__round64 (f64 x) { return cast(f64)((x >= 0.0) ? gb__floor64(x + 0.5) : gb__ceil64(x - 0.5)); } +f64 gb__remainder64(f64 x, f64 y) { return x - (gb__round64(x/y)*y); } +f64 gb__abs64 (f64 x) { return x < 0 ? -x : x; } +f64 gb__sign64 (f64 x) { return x < 0 ? -1.0 : +1.0; } + +f64 gb__mod64(f64 x, f64 y) { + f64 result; + y = gb__abs64(y); + result = gb__remainder64(gb__abs64(x), y); + if (gb__sign64(result)) result += y; + return gb__copy_sign64(result, x); +} + + +f64 gb_random_range_f64(gbRandom *r, f64 lower_inc, f64 higher_inc) { + u64 u = gb_random_gen_u64(r); + f64 f = *cast(f64 *)&u; + f64 diff = higher_inc-lower_inc+1.0; + f = gb__mod64(f, diff); + f += lower_inc; + return f; +} + + + +#if defined(GB_SYSTEM_WINDOWS) +gb_inline void gb_exit(u32 code) { ExitProcess(code); } +#else +gb_inline void gb_exit(u32 code) { exit(code); } +#endif + +gb_inline void gb_yield(void) { +#if defined(GB_SYSTEM_WINDOWS) + Sleep(0); +#else + sched_yield(); +#endif +} + +gb_inline void gb_set_env(char const *name, char const *value) { +#if defined(GB_SYSTEM_WINDOWS) + // TODO(bill): Should this be a Wide version? + SetEnvironmentVariableA(name, value); +#else + setenv(name, value, 1); +#endif +} + +gb_inline void gb_unset_env(char const *name) { +#if defined(GB_SYSTEM_WINDOWS) + // TODO(bill): Should this be a Wide version? + SetEnvironmentVariableA(name, NULL); +#else + unsetenv(name); +#endif +} + + +gb_inline u16 gb_endian_swap16(u16 i) { + return (i>>8) | (i<<8); +} + +gb_inline u32 gb_endian_swap32(u32 i) { + return (i>>24) |(i<<24) | + ((i&0x00ff0000u)>>8) | ((i&0x0000ff00u)<<8); +} + +gb_inline u64 gb_endian_swap64(u64 i) { + return (i>>56) | (i<<56) | + ((i&0x00ff000000000000ull)>>40) | ((i&0x000000000000ff00ull)<<40) | + ((i&0x0000ff0000000000ull)>>24) | ((i&0x0000000000ff0000ull)<<24) | + ((i&0x000000ff00000000ull)>>8) | ((i&0x00000000ff000000ull)<<8); +} + + +gb_inline isize gb_count_set_bits(u64 mask) { + isize count = 0; + while (mask) { + count += (mask & 1); + mask >>= 1; + } + return count; +} + + + + + + +//////////////////////////////////////////////////////////////// +// +// Platform +// +// + +#if defined(GB_PLATFORM) + +gb_inline void gb_key_state_update(gbKeyState *s, b32 is_down) { + b32 was_down = (*s & gbKeyState_Down) != 0; + is_down = is_down != 0; // NOTE(bill): Make sure it's a boolean + GB_MASK_SET(*s, is_down, gbKeyState_Down); + GB_MASK_SET(*s, !was_down && is_down, gbKeyState_Pressed); + GB_MASK_SET(*s, was_down && !is_down, gbKeyState_Released); +} + +#if defined(GB_SYSTEM_WINDOWS) + +#ifndef ERROR_DEVICE_NOT_CONNECTED +#define ERROR_DEVICE_NOT_CONNECTED 1167 +#endif + +GB_XINPUT_GET_STATE(gbXInputGetState_Stub) { + gb_unused(dwUserIndex); gb_unused(pState); + return ERROR_DEVICE_NOT_CONNECTED; +} +GB_XINPUT_SET_STATE(gbXInputSetState_Stub) { + gb_unused(dwUserIndex); gb_unused(pVibration); + return ERROR_DEVICE_NOT_CONNECTED; +} + + +gb_internal gb_inline f32 gb__process_xinput_stick_value(i16 value, i16 dead_zone_threshold) { + f32 result = 0; + + if (value < -dead_zone_threshold) { + result = cast(f32) (value + dead_zone_threshold) / (32768.0f - dead_zone_threshold); + } else if (value > dead_zone_threshold) { + result = cast(f32) (value - dead_zone_threshold) / (32767.0f - dead_zone_threshold); + } + + return result; +} + +gb_internal void gb__platform_resize_dib_section(gbPlatform *p, i32 width, i32 height) { + if ((p->renderer_type == gbRenderer_Software) && + !(p->window_width == width && p->window_height == height)) { + BITMAPINFO bmi = {0}; + + if (width == 0 || height == 0) { + return; + } + + p->window_width = width; + p->window_height = height; + + // TODO(bill): Is this slow to get the desktop mode everytime? + p->sw_framebuffer.bits_per_pixel = gb_video_mode_get_desktop().bits_per_pixel; + p->sw_framebuffer.pitch = (p->sw_framebuffer.bits_per_pixel * width / 8); + + bmi.bmiHeader.biSize = gb_size_of(bmi.bmiHeader); + bmi.bmiHeader.biWidth = width; + bmi.bmiHeader.biHeight = height; // NOTE(bill): -ve is top-down, +ve is bottom-up + bmi.bmiHeader.biPlanes = 1; + bmi.bmiHeader.biBitCount = cast(u16)p->sw_framebuffer.bits_per_pixel; + bmi.bmiHeader.biCompression = 0 /*BI_RGB*/; + + p->sw_framebuffer.win32_bmi = bmi; + + + if (p->sw_framebuffer.memory) { + gb_vm_free(gb_virtual_memory(p->sw_framebuffer.memory, p->sw_framebuffer.memory_size)); + } + + { + isize memory_size = p->sw_framebuffer.pitch * height; + gbVirtualMemory vm = gb_vm_alloc(0, memory_size); + p->sw_framebuffer.memory = vm.data; + p->sw_framebuffer.memory_size = vm.size; + } + } +} + + +gb_internal gbKeyType gb__win32_from_vk(unsigned int key) { + // NOTE(bill): Letters and numbers are defined the same for VK_* and GB_* + if (key >= 'A' && key < 'Z') return cast(gbKeyType)key; + if (key >= '0' && key < '9') return cast(gbKeyType)key; + switch (key) { + case VK_ESCAPE: return gbKey_Escape; + + case VK_LCONTROL: return gbKey_Lcontrol; + case VK_LSHIFT: return gbKey_Lshift; + case VK_LMENU: return gbKey_Lalt; + case VK_LWIN: return gbKey_Lsystem; + case VK_RCONTROL: return gbKey_Rcontrol; + case VK_RSHIFT: return gbKey_Rshift; + case VK_RMENU: return gbKey_Ralt; + case VK_RWIN: return gbKey_Rsystem; + case VK_MENU: return gbKey_Menu; + + case VK_OEM_4: return gbKey_Lbracket; + case VK_OEM_6: return gbKey_Rbracket; + case VK_OEM_1: return gbKey_Semicolon; + case VK_OEM_COMMA: return gbKey_Comma; + case VK_OEM_PERIOD: return gbKey_Period; + case VK_OEM_7: return gbKey_Quote; + case VK_OEM_2: return gbKey_Slash; + case VK_OEM_5: return gbKey_Backslash; + case VK_OEM_3: return gbKey_Grave; + case VK_OEM_PLUS: return gbKey_Equals; + case VK_OEM_MINUS: return gbKey_Minus; + + case VK_SPACE: return gbKey_Space; + case VK_RETURN: return gbKey_Return; + case VK_BACK: return gbKey_Backspace; + case VK_TAB: return gbKey_Tab; + + case VK_PRIOR: return gbKey_Pageup; + case VK_NEXT: return gbKey_Pagedown; + case VK_END: return gbKey_End; + case VK_HOME: return gbKey_Home; + case VK_INSERT: return gbKey_Insert; + case VK_DELETE: return gbKey_Delete; + + case VK_ADD: return gbKey_Plus; + case VK_SUBTRACT: return gbKey_Subtract; + case VK_MULTIPLY: return gbKey_Multiply; + case VK_DIVIDE: return gbKey_Divide; + + case VK_LEFT: return gbKey_Left; + case VK_RIGHT: return gbKey_Right; + case VK_UP: return gbKey_Up; + case VK_DOWN: return gbKey_Down; + + case VK_NUMPAD0: return gbKey_Numpad0; + case VK_NUMPAD1: return gbKey_Numpad1; + case VK_NUMPAD2: return gbKey_Numpad2; + case VK_NUMPAD3: return gbKey_Numpad3; + case VK_NUMPAD4: return gbKey_Numpad4; + case VK_NUMPAD5: return gbKey_Numpad5; + case VK_NUMPAD6: return gbKey_Numpad6; + case VK_NUMPAD7: return gbKey_Numpad7; + case VK_NUMPAD8: return gbKey_Numpad8; + case VK_NUMPAD9: return gbKey_Numpad9; + case VK_SEPARATOR: return gbKey_NumpadEnter; + case VK_DECIMAL: return gbKey_NumpadDot; + + case VK_F1: return gbKey_F1; + case VK_F2: return gbKey_F2; + case VK_F3: return gbKey_F3; + case VK_F4: return gbKey_F4; + case VK_F5: return gbKey_F5; + case VK_F6: return gbKey_F6; + case VK_F7: return gbKey_F7; + case VK_F8: return gbKey_F8; + case VK_F9: return gbKey_F9; + case VK_F10: return gbKey_F10; + case VK_F11: return gbKey_F11; + case VK_F12: return gbKey_F12; + case VK_F13: return gbKey_F13; + case VK_F14: return gbKey_F14; + case VK_F15: return gbKey_F15; + + case VK_PAUSE: return gbKey_Pause; + } + return gbKey_Unknown; +} +LRESULT CALLBACK gb__win32_window_callback(HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam) { + // NOTE(bill): Silly callbacks + gbPlatform *platform = cast(gbPlatform *)GetWindowLongPtrW(hWnd, GWLP_USERDATA); + b32 window_has_focus = (platform != NULL) && platform->window_has_focus; + + if (msg == WM_CREATE) { // NOTE(bill): Doesn't need the platform + // NOTE(bill): https://msdn.microsoft.com/en-us/library/windows/desktop/ms645536(v=vs.85).aspx + RAWINPUTDEVICE rid[2] = {0}; + + // NOTE(bill): Keyboard + rid[0].usUsagePage = 0x01; + rid[0].usUsage = 0x06; + rid[0].dwFlags = 0x00000030/*RIDEV_NOLEGACY*/; // NOTE(bill): Do not generate legacy messages such as WM_KEYDOWN + rid[0].hwndTarget = hWnd; + + // NOTE(bill): Mouse + rid[1].usUsagePage = 0x01; + rid[1].usUsage = 0x02; + rid[1].dwFlags = 0; // NOTE(bill): adds HID mouse and also allows legacy mouse messages to allow for window movement etc. + rid[1].hwndTarget = hWnd; + + if (RegisterRawInputDevices(rid, gb_count_of(rid), gb_size_of(rid[0])) == false) { + DWORD err = GetLastError(); + GB_PANIC("Failed to initialize raw input device for win32." + "Err: %u", err); + } + } + + if (!platform) { + return DefWindowProcW(hWnd, msg, wParam, lParam); + } + + switch (msg) { + case WM_CLOSE: + case WM_DESTROY: + platform->window_is_closed = true; + return 0; + + case WM_QUIT: { + platform->quit_requested = true; + } break; + + case WM_UNICHAR: { + if (window_has_focus) { + if (wParam == '\r') { + wParam = '\n'; + } + // TODO(bill): Does this need to be thread-safe? + platform->char_buffer[platform->char_buffer_count++] = cast(Rune)wParam; + } + } break; + + + case WM_INPUT: { + RAWINPUT raw = {0}; + unsigned int size = gb_size_of(RAWINPUT); + + if (!GetRawInputData(cast(HRAWINPUT)lParam, RID_INPUT, &raw, &size, gb_size_of(RAWINPUTHEADER))) { + return 0; + } + switch (raw.header.dwType) { + case RIM_TYPEKEYBOARD: { + // NOTE(bill): Many thanks to https://blog.molecular-matters.com/2011/09/05/properly-handling-keyboard-input/ + // for the + RAWKEYBOARD *raw_kb = &raw.data.keyboard; + unsigned int vk = raw_kb->VKey; + unsigned int scan_code = raw_kb->MakeCode; + unsigned int flags = raw_kb->Flags; + // NOTE(bill): e0 and e1 are escape sequences used for certain special keys, such as PRINT and PAUSE/BREAK. + // NOTE(bill): http://www.win.tue.nl/~aeb/linux/kbd/scancodes-1.html + b32 is_e0 = (flags & RI_KEY_E0) != 0; + b32 is_e1 = (flags & RI_KEY_E1) != 0; + b32 is_up = (flags & RI_KEY_BREAK) != 0; + b32 is_down = !is_up; + + // TODO(bill): Should I handle scan codes? + + if (vk == 255) { + // NOTE(bill): Discard "fake keys" + return 0; + } else if (vk == VK_SHIFT) { + // NOTE(bill): Correct left/right shift + vk = MapVirtualKeyW(scan_code, MAPVK_VSC_TO_VK_EX); + } else if (vk == VK_NUMLOCK) { + // NOTE(bill): Correct PAUSE/BREAK and NUM LOCK and set the extended bit + scan_code = MapVirtualKeyW(vk, MAPVK_VK_TO_VSC) | 0x100; + } + + if (is_e1) { + // NOTE(bill): Escaped sequences, turn vk into the correct scan code + // except for VK_PAUSE (it's a bug) + if (vk == VK_PAUSE) { + scan_code = 0x45; + } else { + scan_code = MapVirtualKeyW(vk, MAPVK_VK_TO_VSC); + } + } + + switch (vk) { + case VK_CONTROL: vk = (is_e0) ? VK_RCONTROL : VK_LCONTROL; break; + case VK_MENU: vk = (is_e0) ? VK_RMENU : VK_LMENU; break; + + case VK_RETURN: if (is_e0) vk = VK_SEPARATOR; break; // NOTE(bill): Numpad return + case VK_DELETE: if (!is_e0) vk = VK_DECIMAL; break; // NOTE(bill): Numpad dot + case VK_INSERT: if (!is_e0) vk = VK_NUMPAD0; break; + case VK_HOME: if (!is_e0) vk = VK_NUMPAD7; break; + case VK_END: if (!is_e0) vk = VK_NUMPAD1; break; + case VK_PRIOR: if (!is_e0) vk = VK_NUMPAD9; break; + case VK_NEXT: if (!is_e0) vk = VK_NUMPAD3; break; + + // NOTE(bill): The standard arrow keys will always have their e0 bit set, but the + // corresponding keys on the NUMPAD will not. + case VK_LEFT: if (!is_e0) vk = VK_NUMPAD4; break; + case VK_RIGHT: if (!is_e0) vk = VK_NUMPAD6; break; + case VK_UP: if (!is_e0) vk = VK_NUMPAD8; break; + case VK_DOWN: if (!is_e0) vk = VK_NUMPAD2; break; + + // NUMPAD 5 doesn't have its e0 bit set + case VK_CLEAR: if (!is_e0) vk = VK_NUMPAD5; break; + } + + // NOTE(bill): Set appropriate key state flags + gb_key_state_update(&platform->keys[gb__win32_from_vk(vk)], is_down); + + } break; + case RIM_TYPEMOUSE: { + RAWMOUSE *raw_mouse = &raw.data.mouse; + u16 flags = raw_mouse->usButtonFlags; + long dx = +raw_mouse->lLastX; + long dy = -raw_mouse->lLastY; + + if (flags & RI_MOUSE_WHEEL) { + platform->mouse_wheel_delta = cast(i16)raw_mouse->usButtonData; + } + + platform->mouse_raw_dx = dx; + platform->mouse_raw_dy = dy; + } break; + } + } break; + + default: break; + } + + return DefWindowProcW(hWnd, msg, wParam, lParam); +} + + +typedef void *wglCreateContextAttribsARB_Proc(void *hDC, void *hshareContext, int const *attribList); + + +b32 gb__platform_init(gbPlatform *p, char const *window_title, gbVideoMode mode, gbRendererType type, u32 window_flags) { + WNDCLASSEXW wc = {gb_size_of(WNDCLASSEXW)}; + DWORD ex_style = 0, style = 0; + RECT wr; + u16 title_buffer[256] = {0}; // TODO(bill): gb_local_persist this? + + wc.style = CS_HREDRAW | CS_VREDRAW; // | CS_OWNDC + wc.lpfnWndProc = gb__win32_window_callback; + wc.hbrBackground = cast(HBRUSH)GetStockObject(0/*WHITE_BRUSH*/); + wc.lpszMenuName = NULL; + wc.lpszClassName = L"gb-win32-wndclass"; // TODO(bill): Is this enough? + wc.hInstance = GetModuleHandleW(NULL); + + if (RegisterClassExW(&wc) == 0) { + MessageBoxW(NULL, L"Failed to register the window class", L"ERROR", MB_OK | MB_ICONEXCLAMATION); + return false; + } + + if ((window_flags & gbWindow_Fullscreen) && !(window_flags & gbWindow_Borderless)) { + DEVMODEW screen_settings = {gb_size_of(DEVMODEW)}; + screen_settings.dmPelsWidth = mode.width; + screen_settings.dmPelsHeight = mode.height; + screen_settings.dmBitsPerPel = mode.bits_per_pixel; + screen_settings.dmFields = DM_BITSPERPEL|DM_PELSWIDTH|DM_PELSHEIGHT; + + if (ChangeDisplaySettingsW(&screen_settings, CDS_FULLSCREEN) != DISP_CHANGE_SUCCESSFUL) { + if (MessageBoxW(NULL, L"The requested fullscreen mode is not supported by\n" + L"your video card. Use windowed mode instead?", + L"", + MB_YESNO|MB_ICONEXCLAMATION) == IDYES) { + window_flags &= ~gbWindow_Fullscreen; + } else { + mode = gb_video_mode_get_desktop(); + screen_settings.dmPelsWidth = mode.width; + screen_settings.dmPelsHeight = mode.height; + screen_settings.dmBitsPerPel = mode.bits_per_pixel; + ChangeDisplaySettingsW(&screen_settings, CDS_FULLSCREEN); + } + } + } + + + // ex_style = WS_EX_APPWINDOW | WS_EX_WINDOWEDGE; + // style = WS_CLIPSIBLINGS | WS_CLIPCHILDREN | WS_VISIBLE | WS_THICKFRAME | WS_SYSMENU | WS_MAXIMIZEBOX | WS_MINIMIZEBOX; + + style |= WS_VISIBLE; + + if (window_flags & gbWindow_Hidden) style &= ~WS_VISIBLE; + if (window_flags & gbWindow_Resizable) style |= WS_THICKFRAME | WS_MAXIMIZEBOX; + if (window_flags & gbWindow_Maximized) style |= WS_MAXIMIZE; + if (window_flags & gbWindow_Minimized) style |= WS_MINIMIZE; + + // NOTE(bill): Completely ignore the given mode and just change it + if (window_flags & gbWindow_FullscreenDesktop) { + mode = gb_video_mode_get_desktop(); + } + + if ((window_flags & gbWindow_Fullscreen) || (window_flags & gbWindow_Borderless)) { + style |= WS_POPUP; + } else { + style |= WS_OVERLAPPED | WS_CAPTION | WS_SYSMENU | WS_MINIMIZEBOX; + } + + + wr.left = 0; + wr.top = 0; + wr.right = mode.width; + wr.bottom = mode.height; + AdjustWindowRect(&wr, style, false); + + p->window_flags = window_flags; + p->window_handle = CreateWindowExW(ex_style, + wc.lpszClassName, + cast(wchar_t const *)gb_utf8_to_ucs2(title_buffer, gb_size_of(title_buffer), window_title), + style, + CW_USEDEFAULT, CW_USEDEFAULT, + wr.right - wr.left, wr.bottom - wr.top, + 0, 0, + GetModuleHandleW(NULL), + NULL); + + if (!p->window_handle) { + MessageBoxW(NULL, L"Window creation failed", L"Error", MB_OK|MB_ICONEXCLAMATION); + return false; + } + + p->win32_dc = GetDC(cast(HWND)p->window_handle); + + p->renderer_type = type; + switch (p->renderer_type) { + case gbRenderer_Opengl: { + wglCreateContextAttribsARB_Proc *wglCreateContextAttribsARB; + i32 attribs[8] = {0}; + isize c = 0; + + PIXELFORMATDESCRIPTOR pfd = {gb_size_of(PIXELFORMATDESCRIPTOR)}; + pfd.nVersion = 1; + pfd.dwFlags = PFD_DRAW_TO_WINDOW | PFD_SUPPORT_OPENGL | PFD_DOUBLEBUFFER; + pfd.iPixelType = PFD_TYPE_RGBA; + pfd.cColorBits = 32; + pfd.cAlphaBits = 8; + pfd.cDepthBits = 24; + pfd.cStencilBits = 8; + pfd.iLayerType = PFD_MAIN_PLANE; + + SetPixelFormat(cast(HDC)p->win32_dc, ChoosePixelFormat(cast(HDC)p->win32_dc, &pfd), NULL); + p->opengl.context = cast(void *)wglCreateContext(cast(HDC)p->win32_dc); + wglMakeCurrent(cast(HDC)p->win32_dc, cast(HGLRC)p->opengl.context); + + if (p->opengl.major > 0) { + attribs[c++] = 0x2091; // WGL_CONTEXT_MAJOR_VERSION_ARB + attribs[c++] = gb_max(p->opengl.major, 1); + } + if (p->opengl.major > 0 && p->opengl.minor >= 0) { + attribs[c++] = 0x2092; // WGL_CONTEXT_MINOR_VERSION_ARB + attribs[c++] = gb_max(p->opengl.minor, 0); + } + + if (p->opengl.core) { + attribs[c++] = 0x9126; // WGL_CONTEXT_PROFILE_MASK_ARB + attribs[c++] = 0x0001; // WGL_CONTEXT_CORE_PROFILE_BIT_ARB + } else if (p->opengl.compatible) { + attribs[c++] = 0x9126; // WGL_CONTEXT_PROFILE_MASK_ARB + attribs[c++] = 0x0002; // WGL_CONTEXT_COMPATIBILITY_PROFILE_BIT_ARB + } + attribs[c++] = 0; // NOTE(bill): tells the proc that this is the end of attribs + + wglCreateContextAttribsARB = cast(wglCreateContextAttribsARB_Proc *)wglGetProcAddress("wglCreateContextAttribsARB"); + if (wglCreateContextAttribsARB) { + HGLRC rc = cast(HGLRC)wglCreateContextAttribsARB(p->win32_dc, 0, attribs); + if (rc && wglMakeCurrent(cast(HDC)p->win32_dc, rc)) { + p->opengl.context = rc; + } else { + // TODO(bill): Handle errors from GetLastError + // ERROR_INVALID_VERSION_ARB 0x2095 + // ERROR_INVALID_PROFILE_ARB 0x2096 + } + } + + } break; + + case gbRenderer_Software: + gb__platform_resize_dib_section(p, mode.width, mode.height); + break; + + default: + GB_PANIC("Unknown window type"); + break; + } + + SetForegroundWindow(cast(HWND)p->window_handle); + SetFocus(cast(HWND)p->window_handle); + SetWindowLongPtrW(cast(HWND)p->window_handle, GWLP_USERDATA, cast(LONG_PTR)p); + + p->window_width = mode.width; + p->window_height = mode.height; + + if (p->renderer_type == gbRenderer_Opengl) { + p->opengl.dll_handle = gb_dll_load("opengl32.dll"); + } + + { // Load XInput + // TODO(bill): What other dlls should I look for? + gbDllHandle xinput_library = gb_dll_load("xinput1_4.dll"); + p->xinput.get_state = gbXInputGetState_Stub; + p->xinput.set_state = gbXInputSetState_Stub; + + if (!xinput_library) xinput_library = gb_dll_load("xinput9_1_0.dll"); + if (!xinput_library) xinput_library = gb_dll_load("xinput1_3.dll"); + if (!xinput_library) { + // TODO(bill): Proper Diagnostic + gb_printf_err("XInput could not be loaded. Controllers will not work!\n"); + } else { + p->xinput.get_state = cast(gbXInputGetStateProc *)gb_dll_proc_address(xinput_library, "XInputGetState"); + p->xinput.set_state = cast(gbXInputSetStateProc *)gb_dll_proc_address(xinput_library, "XInputSetState"); + } + } + + // Init keys + gb_zero_array(p->keys, gb_count_of(p->keys)); + + p->is_initialized = true; + return true; +} + +gb_inline b32 gb_platform_init_with_software(gbPlatform *p, char const *window_title, + i32 width, i32 height, u32 window_flags) { + gbVideoMode mode; + mode.width = width; + mode.height = height; + mode.bits_per_pixel = 32; + return gb__platform_init(p, window_title, mode, gbRenderer_Software, window_flags); +} + +gb_inline b32 gb_platform_init_with_opengl(gbPlatform *p, char const *window_title, + i32 width, i32 height, u32 window_flags, i32 major, i32 minor, b32 core, b32 compatible) { + gbVideoMode mode; + mode.width = width; + mode.height = height; + mode.bits_per_pixel = 32; + p->opengl.major = major; + p->opengl.minor = minor; + p->opengl.core = cast(b16)core; + p->opengl.compatible = cast(b16)compatible; + return gb__platform_init(p, window_title, mode, gbRenderer_Opengl, window_flags); +} + +#ifndef _XINPUT_H_ +typedef struct _XINPUT_GAMEPAD { + u16 wButtons; + u8 bLeftTrigger; + u8 bRightTrigger; + u16 sThumbLX; + u16 sThumbLY; + u16 sThumbRX; + u16 sThumbRY; +} XINPUT_GAMEPAD; + +typedef struct _XINPUT_STATE { + DWORD dwPacketNumber; + XINPUT_GAMEPAD Gamepad; +} XINPUT_STATE; + +typedef struct _XINPUT_VIBRATION { + u16 wLeftMotorSpeed; + u16 wRightMotorSpeed; +} XINPUT_VIBRATION; + +#define XINPUT_GAMEPAD_DPAD_UP 0x00000001 +#define XINPUT_GAMEPAD_DPAD_DOWN 0x00000002 +#define XINPUT_GAMEPAD_DPAD_LEFT 0x00000004 +#define XINPUT_GAMEPAD_DPAD_RIGHT 0x00000008 +#define XINPUT_GAMEPAD_START 0x00000010 +#define XINPUT_GAMEPAD_BACK 0x00000020 +#define XINPUT_GAMEPAD_LEFT_THUMB 0x00000040 +#define XINPUT_GAMEPAD_RIGHT_THUMB 0x00000080 +#define XINPUT_GAMEPAD_LEFT_SHOULDER 0x0100 +#define XINPUT_GAMEPAD_RIGHT_SHOULDER 0x0200 +#define XINPUT_GAMEPAD_A 0x1000 +#define XINPUT_GAMEPAD_B 0x2000 +#define XINPUT_GAMEPAD_X 0x4000 +#define XINPUT_GAMEPAD_Y 0x8000 +#define XINPUT_GAMEPAD_LEFT_THUMB_DEADZONE 7849 +#define XINPUT_GAMEPAD_RIGHT_THUMB_DEADZONE 8689 +#define XINPUT_GAMEPAD_TRIGGER_THRESHOLD 30 +#endif + +#ifndef XUSER_MAX_COUNT +#define XUSER_MAX_COUNT 4 +#endif + +void gb_platform_update(gbPlatform *p) { + isize i; + + { // NOTE(bill): Set window state + // TODO(bill): Should this be moved to gb__win32_window_callback ? + RECT window_rect; + i32 x, y, w, h; + + GetClientRect(cast(HWND)p->window_handle, &window_rect); + x = window_rect.left; + y = window_rect.top; + w = window_rect.right - window_rect.left; + h = window_rect.bottom - window_rect.top; + + if ((p->window_width != w) || (p->window_height != h)) { + if (p->renderer_type == gbRenderer_Software) { + gb__platform_resize_dib_section(p, w, h); + } + } + + + p->window_x = x; + p->window_y = y; + p->window_width = w; + p->window_height = h; + GB_MASK_SET(p->window_flags, IsIconic(cast(HWND)p->window_handle) != 0, gbWindow_Minimized); + + p->window_has_focus = GetFocus() == cast(HWND)p->window_handle; + } + + { // NOTE(bill): Set mouse position + POINT mouse_pos; + DWORD win_button_id[gbMouseButton_Count] = { + VK_LBUTTON, + VK_MBUTTON, + VK_RBUTTON, + VK_XBUTTON1, + VK_XBUTTON2, + }; + + // NOTE(bill): This needs to be GetAsyncKeyState as RAWMOUSE doesn't aways work for some odd reason + // TODO(bill): Try and get RAWMOUSE to work for key presses + for (i = 0; i < gbMouseButton_Count; i++) { + gb_key_state_update(p->mouse_buttons+i, GetAsyncKeyState(win_button_id[i]) < 0); + } + + GetCursorPos(&mouse_pos); + ScreenToClient(cast(HWND)p->window_handle, &mouse_pos); + { + i32 x = mouse_pos.x; + i32 y = p->window_height-1 - mouse_pos.y; + p->mouse_dx = x - p->mouse_x; + p->mouse_dy = y - p->mouse_y; + p->mouse_x = x; + p->mouse_y = y; + } + + if (p->mouse_clip) { + b32 update = false; + i32 x = p->mouse_x; + i32 y = p->mouse_y; + if (p->mouse_x < 0) { + x = 0; + update = true; + } else if (p->mouse_y > p->window_height-1) { + y = p->window_height-1; + update = true; + } + + if (p->mouse_y < 0) { + y = 0; + update = true; + } else if (p->mouse_x > p->window_width-1) { + x = p->window_width-1; + update = true; + } + + if (update) { + gb_platform_set_mouse_position(p, x, y); + } + } + + + } + + + // NOTE(bill): Set Key/Button states + if (p->window_has_focus) { + p->char_buffer_count = 0; // TODO(bill): Reset buffer count here or else where? + + // NOTE(bill): Need to update as the keys only get updates on events + for (i = 0; i < gbKey_Count; i++) { + b32 is_down = (p->keys[i] & gbKeyState_Down) != 0; + gb_key_state_update(&p->keys[i], is_down); + } + + p->key_modifiers.control = p->keys[gbKey_Lcontrol] | p->keys[gbKey_Rcontrol]; + p->key_modifiers.alt = p->keys[gbKey_Lalt] | p->keys[gbKey_Ralt]; + p->key_modifiers.shift = p->keys[gbKey_Lshift] | p->keys[gbKey_Rshift]; + + } + + { // NOTE(bill): Set Controller states + isize max_controller_count = XUSER_MAX_COUNT; + if (max_controller_count > gb_count_of(p->game_controllers)) { + max_controller_count = gb_count_of(p->game_controllers); + } + + for (i = 0; i < max_controller_count; i++) { + gbGameController *controller = &p->game_controllers[i]; + XINPUT_STATE controller_state = {0}; + if (p->xinput.get_state(cast(DWORD)i, &controller_state) != 0) { + // NOTE(bill): The controller is not available + controller->is_connected = false; + } else { + // NOTE(bill): This controller is plugged in + // TODO(bill): See if ControllerState.dwPacketNumber increments too rapidly + XINPUT_GAMEPAD *pad = &controller_state.Gamepad; + + controller->is_connected = true; + + // TODO(bill): This is a square deadzone, check XInput to verify that the deadzone is "round" and do round deadzone processing. + controller->axes[gbControllerAxis_LeftX] = gb__process_xinput_stick_value(pad->sThumbLX, XINPUT_GAMEPAD_LEFT_THUMB_DEADZONE); + controller->axes[gbControllerAxis_LeftY] = gb__process_xinput_stick_value(pad->sThumbLY, XINPUT_GAMEPAD_LEFT_THUMB_DEADZONE); + controller->axes[gbControllerAxis_RightX] = gb__process_xinput_stick_value(pad->sThumbRX, XINPUT_GAMEPAD_RIGHT_THUMB_DEADZONE); + controller->axes[gbControllerAxis_RightY] = gb__process_xinput_stick_value(pad->sThumbRY, XINPUT_GAMEPAD_RIGHT_THUMB_DEADZONE); + + controller->axes[gbControllerAxis_LeftTrigger] = cast(f32)pad->bLeftTrigger / 255.0f; + controller->axes[gbControllerAxis_RightTrigger] = cast(f32)pad->bRightTrigger / 255.0f; + + + if ((controller->axes[gbControllerAxis_LeftX] != 0.0f) || + (controller->axes[gbControllerAxis_LeftY] != 0.0f)) { + controller->is_analog = true; + } + + #define GB__PROCESS_DIGITAL_BUTTON(button_type, xinput_button) \ + gb_key_state_update(&controller->buttons[button_type], (pad->wButtons & xinput_button) == xinput_button) + + GB__PROCESS_DIGITAL_BUTTON(gbControllerButton_A, XINPUT_GAMEPAD_A); + GB__PROCESS_DIGITAL_BUTTON(gbControllerButton_B, XINPUT_GAMEPAD_B); + GB__PROCESS_DIGITAL_BUTTON(gbControllerButton_X, XINPUT_GAMEPAD_X); + GB__PROCESS_DIGITAL_BUTTON(gbControllerButton_Y, XINPUT_GAMEPAD_Y); + GB__PROCESS_DIGITAL_BUTTON(gbControllerButton_LeftShoulder, XINPUT_GAMEPAD_LEFT_SHOULDER); + GB__PROCESS_DIGITAL_BUTTON(gbControllerButton_RightShoulder, XINPUT_GAMEPAD_RIGHT_SHOULDER); + GB__PROCESS_DIGITAL_BUTTON(gbControllerButton_Start, XINPUT_GAMEPAD_START); + GB__PROCESS_DIGITAL_BUTTON(gbControllerButton_Back, XINPUT_GAMEPAD_BACK); + GB__PROCESS_DIGITAL_BUTTON(gbControllerButton_Left, XINPUT_GAMEPAD_DPAD_LEFT); + GB__PROCESS_DIGITAL_BUTTON(gbControllerButton_Right, XINPUT_GAMEPAD_DPAD_RIGHT); + GB__PROCESS_DIGITAL_BUTTON(gbControllerButton_Down, XINPUT_GAMEPAD_DPAD_DOWN); + GB__PROCESS_DIGITAL_BUTTON(gbControllerButton_Up, XINPUT_GAMEPAD_DPAD_UP); + GB__PROCESS_DIGITAL_BUTTON(gbControllerButton_LeftThumb, XINPUT_GAMEPAD_LEFT_THUMB); + GB__PROCESS_DIGITAL_BUTTON(gbControllerButton_RightThumb, XINPUT_GAMEPAD_RIGHT_THUMB); + #undef GB__PROCESS_DIGITAL_BUTTON + } + } + } + + { // NOTE(bill): Process pending messages + MSG message; + for (;;) { + BOOL is_okay = PeekMessageW(&message, 0, 0, 0, PM_REMOVE); + if (!is_okay) break; + + switch (message.message) { + case WM_QUIT: + p->quit_requested = true; + break; + + default: + TranslateMessage(&message); + DispatchMessageW(&message); + break; + } + } + } +} + +void gb_platform_display(gbPlatform *p) { + if (p->renderer_type == gbRenderer_Opengl) { + SwapBuffers(cast(HDC)p->win32_dc); + } else if (p->renderer_type == gbRenderer_Software) { + StretchDIBits(cast(HDC)p->win32_dc, + 0, 0, p->window_width, p->window_height, + 0, 0, p->window_width, p->window_height, + p->sw_framebuffer.memory, + &p->sw_framebuffer.win32_bmi, + DIB_RGB_COLORS, SRCCOPY); + } else { + GB_PANIC("Invalid window rendering type"); + } + + { + f64 prev_time = p->curr_time; + f64 curr_time = gb_time_now(); + p->dt_for_frame = curr_time - prev_time; + p->curr_time = curr_time; + } +} + + +void gb_platform_destroy(gbPlatform *p) { + if (p->renderer_type == gbRenderer_Opengl) { + wglDeleteContext(cast(HGLRC)p->opengl.context); + } else if (p->renderer_type == gbRenderer_Software) { + gb_vm_free(gb_virtual_memory(p->sw_framebuffer.memory, p->sw_framebuffer.memory_size)); + } + + DestroyWindow(cast(HWND)p->window_handle); +} + +void gb_platform_show_cursor(gbPlatform *p, b32 show) { + gb_unused(p); + ShowCursor(show); +} + +void gb_platform_set_mouse_position(gbPlatform *p, i32 x, i32 y) { + POINT point; + point.x = cast(LONG)x; + point.y = cast(LONG)(p->window_height-1 - y); + ClientToScreen(cast(HWND)p->window_handle, &point); + SetCursorPos(point.x, point.y); + + p->mouse_x = point.x; + p->mouse_y = p->window_height-1 - point.y; +} + + + +void gb_platform_set_controller_vibration(gbPlatform *p, isize index, f32 left_motor, f32 right_motor) { + if (gb_is_between(index, 0, GB_MAX_GAME_CONTROLLER_COUNT-1)) { + XINPUT_VIBRATION vibration = {0}; + left_motor = gb_clamp01(left_motor); + right_motor = gb_clamp01(right_motor); + vibration.wLeftMotorSpeed = cast(WORD)(65535 * left_motor); + vibration.wRightMotorSpeed = cast(WORD)(65535 * right_motor); + + p->xinput.set_state(cast(DWORD)index, &vibration); + } +} + + +void gb_platform_set_window_position(gbPlatform *p, i32 x, i32 y) { + RECT rect; + i32 width, height; + + GetClientRect(cast(HWND)p->window_handle, &rect); + width = rect.right - rect.left; + height = rect.bottom - rect.top; + MoveWindow(cast(HWND)p->window_handle, x, y, width, height, false); +} + +void gb_platform_set_window_title(gbPlatform *p, char const *title, ...) { + u16 buffer[256] = {0}; + char str[512] = {0}; + va_list va; + va_start(va, title); + gb_snprintf_va(str, gb_size_of(str), title, va); + va_end(va); + + if (str[0] != '\0') { + SetWindowTextW(cast(HWND)p->window_handle, cast(wchar_t const *)gb_utf8_to_ucs2(buffer, gb_size_of(buffer), str)); + } +} + +void gb_platform_toggle_fullscreen(gbPlatform *p, b32 fullscreen_desktop) { + // NOTE(bill): From the man himself, Raymond Chen! (Modified for my need.) + HWND handle = cast(HWND)p->window_handle; + DWORD style = cast(DWORD)GetWindowLongW(handle, GWL_STYLE); + WINDOWPLACEMENT placement; + + if (style & WS_OVERLAPPEDWINDOW) { + MONITORINFO monitor_info = {gb_size_of(monitor_info)}; + if (GetWindowPlacement(handle, &placement) && + GetMonitorInfoW(MonitorFromWindow(handle, 1), &monitor_info)) { + style &= ~WS_OVERLAPPEDWINDOW; + if (fullscreen_desktop) { + style &= ~WS_CAPTION; + style |= WS_POPUP; + } + SetWindowLongW(handle, GWL_STYLE, style); + SetWindowPos(handle, HWND_TOP, + monitor_info.rcMonitor.left, monitor_info.rcMonitor.top, + monitor_info.rcMonitor.right - monitor_info.rcMonitor.left, + monitor_info.rcMonitor.bottom - monitor_info.rcMonitor.top, + SWP_NOOWNERZORDER | SWP_FRAMECHANGED); + + if (fullscreen_desktop) { + p->window_flags |= gbWindow_FullscreenDesktop; + } else { + p->window_flags |= gbWindow_Fullscreen; + } + } + } else { + style &= ~WS_POPUP; + style |= WS_OVERLAPPEDWINDOW | WS_CAPTION; + SetWindowLongW(handle, GWL_STYLE, style); + SetWindowPlacement(handle, &placement); + SetWindowPos(handle, 0, 0, 0, 0, 0, + SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER | + SWP_NOOWNERZORDER | SWP_FRAMECHANGED); + + p->window_flags &= ~gbWindow_Fullscreen; + } +} + +void gb_platform_toggle_borderless(gbPlatform *p) { + HWND handle = cast(HWND)p->window_handle; + DWORD style = GetWindowLongW(handle, GWL_STYLE); + b32 is_borderless = (style & WS_POPUP) != 0; + + GB_MASK_SET(style, is_borderless, WS_OVERLAPPEDWINDOW | WS_CAPTION); + GB_MASK_SET(style, !is_borderless, WS_POPUP); + + SetWindowLongW(handle, GWL_STYLE, style); + + GB_MASK_SET(p->window_flags, !is_borderless, gbWindow_Borderless); +} + + + +gb_inline void gb_platform_make_opengl_context_current(gbPlatform *p) { + if (p->renderer_type == gbRenderer_Opengl) { + wglMakeCurrent(cast(HDC)p->win32_dc, cast(HGLRC)p->opengl.context); + } +} + +gb_inline void gb_platform_show_window(gbPlatform *p) { + ShowWindow(cast(HWND)p->window_handle, SW_SHOW); + p->window_flags &= ~gbWindow_Hidden; +} + +gb_inline void gb_platform_hide_window(gbPlatform *p) { + ShowWindow(cast(HWND)p->window_handle, SW_HIDE); + p->window_flags |= gbWindow_Hidden; +} + +gb_inline gbVideoMode gb_video_mode_get_desktop(void) { + DEVMODEW win32_mode = {gb_size_of(win32_mode)}; + EnumDisplaySettingsW(NULL, ENUM_CURRENT_SETTINGS, &win32_mode); + return gb_video_mode(win32_mode.dmPelsWidth, win32_mode.dmPelsHeight, win32_mode.dmBitsPerPel); +} + +isize gb_video_mode_get_fullscreen_modes(gbVideoMode *modes, isize max_mode_count) { + DEVMODEW win32_mode = {gb_size_of(win32_mode)}; + i32 count; + for (count = 0; + count < max_mode_count && EnumDisplaySettingsW(NULL, count, &win32_mode); + count++) { + modes[count] = gb_video_mode(win32_mode.dmPelsWidth, win32_mode.dmPelsHeight, win32_mode.dmBitsPerPel); + } + + gb_sort_array(modes, count, gb_video_mode_dsc_cmp); + return count; +} + + + +b32 gb_platform_has_clipboard_text(gbPlatform *p) { + b32 result = false; + + if (IsClipboardFormatAvailable(1/*CF_TEXT*/) && + OpenClipboard(cast(HWND)p->window_handle)) { + HANDLE mem = GetClipboardData(1/*CF_TEXT*/); + if (mem) { + char *str = cast(char *)GlobalLock(mem); + if (str && str[0] != '\0') { + result = true; + } + GlobalUnlock(mem); + } else { + return false; + } + + CloseClipboard(); + } + + return result; +} + +// TODO(bill): Handle UTF-8 +void gb_platform_set_clipboard_text(gbPlatform *p, char const *str) { + if (OpenClipboard(cast(HWND)p->window_handle)) { + isize i, len = gb_strlen(str)+1; + + HANDLE mem = cast(HANDLE)GlobalAlloc(0x0002/*GMEM_MOVEABLE*/, len); + if (mem) { + char *dst = cast(char *)GlobalLock(mem); + if (dst) { + for (i = 0; str[i]; i++) { + // TODO(bill): Does this cause a buffer overflow? + // NOTE(bill): Change \n to \r\n 'cause windows + if (str[i] == '\n' && (i == 0 || str[i-1] != '\r')) { + *dst++ = '\r'; + } + *dst++ = str[i]; + } + *dst = 0; + } + GlobalUnlock(mem); + } + + EmptyClipboard(); + if (!SetClipboardData(1/*CF_TEXT*/, mem)) { + return; + } + CloseClipboard(); + } +} + +// TODO(bill): Handle UTF-8 +char *gb_platform_get_clipboard_text(gbPlatform *p, gbAllocator a) { + char *text = NULL; + + if (IsClipboardFormatAvailable(1/*CF_TEXT*/) && + OpenClipboard(cast(HWND)p->window_handle)) { + HANDLE mem = GetClipboardData(1/*CF_TEXT*/); + if (mem) { + char *str = cast(char *)GlobalLock(mem); + text = gb_alloc_str(a, str); + GlobalUnlock(mem); + } else { + return NULL; + } + + CloseClipboard(); + } + + return text; +} + +#elif defined(GB_SYSTEM_OSX) + +#include +#include +#include +#include + +#if __LP64__ || (TARGET_OS_EMBEDDED && !TARGET_OS_IPHONE) || TARGET_OS_WIN32 || NS_BUILD_32_LIKE_64 + #define NSIntegerEncoding "q" + #define NSUIntegerEncoding "L" +#else + #define NSIntegerEncoding "i" + #define NSUIntegerEncoding "I" +#endif + +#ifdef __OBJC__ + #import +#else + typedef CGPoint NSPoint; + typedef CGSize NSSize; + typedef CGRect NSRect; + + extern id NSApp; + extern id const NSDefaultRunLoopMode; +#endif + +#if defined(__OBJC__) && __has_feature(objc_arc) +#error TODO(bill): Cannot compile as objective-c code just yet! +#endif + +// ABI is a bit different between platforms +#ifdef __arm64__ +#define abi_objc_msgSend_stret objc_msgSend +#else +#define abi_objc_msgSend_stret objc_msgSend_stret +#endif +#ifdef __i386__ +#define abi_objc_msgSend_fpret objc_msgSend_fpret +#else +#define abi_objc_msgSend_fpret objc_msgSend +#endif + +#define objc_msgSend_id ((id (*)(id, SEL))objc_msgSend) +#define objc_msgSend_void ((void (*)(id, SEL))objc_msgSend) +#define objc_msgSend_void_id ((void (*)(id, SEL, id))objc_msgSend) +#define objc_msgSend_void_bool ((void (*)(id, SEL, BOOL))objc_msgSend) +#define objc_msgSend_id_char_const ((id (*)(id, SEL, char const *))objc_msgSend) + +gb_internal NSUInteger gb__osx_application_should_terminate(id self, SEL _sel, id sender) { + // NOTE(bill): Do nothing + return 0; +} + +gb_internal void gb__osx_window_will_close(id self, SEL _sel, id notification) { + NSUInteger value = true; + object_setInstanceVariable(self, "closed", cast(void *)value); +} + +gb_internal void gb__osx_window_did_become_key(id self, SEL _sel, id notification) { + gbPlatform *p = NULL; + object_getInstanceVariable(self, "gbPlatform", cast(void **)&p); + if (p) { + // TODO(bill): + } +} + +b32 gb__platform_init(gbPlatform *p, char const *window_title, gbVideoMode mode, gbRendererType type, u32 window_flags) { + if (p->is_initialized) { + return true; + } + // Init Platform + { // Initial OSX State + Class appDelegateClass; + b32 resultAddProtoc, resultAddMethod; + id dgAlloc, dg, menubarAlloc, menubar; + id appMenuItemAlloc, appMenuItem; + id appMenuAlloc, appMenu; + + #if defined(ARC_AVAILABLE) + #error TODO(bill): This code should be compiled as C for now + #else + id poolAlloc = objc_msgSend_id(cast(id)objc_getClass("NSAutoreleasePool"), sel_registerName("alloc")); + p->osx_autorelease_pool = objc_msgSend_id(poolAlloc, sel_registerName("init")); + #endif + + objc_msgSend_id(cast(id)objc_getClass("NSApplication"), sel_registerName("sharedApplication")); + ((void (*)(id, SEL, NSInteger))objc_msgSend)(NSApp, sel_registerName("setActivationPolicy:"), 0); + + appDelegateClass = objc_allocateClassPair((Class)objc_getClass("NSObject"), "AppDelegate", 0); + resultAddProtoc = class_addProtocol(appDelegateClass, objc_getProtocol("NSApplicationDelegate")); + assert(resultAddProtoc); + resultAddMethod = class_addMethod(appDelegateClass, sel_registerName("applicationShouldTerminate:"), cast(IMP)gb__osx_application_should_terminate, NSUIntegerEncoding "@:@"); + assert(resultAddMethod); + dgAlloc = objc_msgSend_id(cast(id)appDelegateClass, sel_registerName("alloc")); + dg = objc_msgSend_id(dgAlloc, sel_registerName("init")); + #ifndef ARC_AVAILABLE + objc_msgSend_void(dg, sel_registerName("autorelease")); + #endif + + objc_msgSend_void_id(NSApp, sel_registerName("setDelegate:"), dg); + objc_msgSend_void(NSApp, sel_registerName("finishLaunching")); + + menubarAlloc = objc_msgSend_id(cast(id)objc_getClass("NSMenu"), sel_registerName("alloc")); + menubar = objc_msgSend_id(menubarAlloc, sel_registerName("init")); + #ifndef ARC_AVAILABLE + objc_msgSend_void(menubar, sel_registerName("autorelease")); + #endif + + appMenuItemAlloc = objc_msgSend_id(cast(id)objc_getClass("NSMenuItem"), sel_registerName("alloc")); + appMenuItem = objc_msgSend_id(appMenuItemAlloc, sel_registerName("init")); + #ifndef ARC_AVAILABLE + objc_msgSend_void(appMenuItem, sel_registerName("autorelease")); + #endif + + objc_msgSend_void_id(menubar, sel_registerName("addItem:"), appMenuItem); + ((id (*)(id, SEL, id))objc_msgSend)(NSApp, sel_registerName("setMainMenu:"), menubar); + + appMenuAlloc = objc_msgSend_id(cast(id)objc_getClass("NSMenu"), sel_registerName("alloc")); + appMenu = objc_msgSend_id(appMenuAlloc, sel_registerName("init")); + #ifndef ARC_AVAILABLE + objc_msgSend_void(appMenu, sel_registerName("autorelease")); + #endif + + { + id processInfo = objc_msgSend_id(cast(id)objc_getClass("NSProcessInfo"), sel_registerName("processInfo")); + id appName = objc_msgSend_id(processInfo, sel_registerName("processName")); + + id quitTitlePrefixString = objc_msgSend_id_char_const(cast(id)objc_getClass("NSString"), sel_registerName("stringWithUTF8String:"), "Quit "); + id quitTitle = ((id (*)(id, SEL, id))objc_msgSend)(quitTitlePrefixString, sel_registerName("stringByAppendingString:"), appName); + + id quitMenuItemKey = objc_msgSend_id_char_const(cast(id)objc_getClass("NSString"), sel_registerName("stringWithUTF8String:"), "q"); + id quitMenuItemAlloc = objc_msgSend_id(cast(id)objc_getClass("NSMenuItem"), sel_registerName("alloc")); + id quitMenuItem = ((id (*)(id, SEL, id, SEL, id))objc_msgSend)(quitMenuItemAlloc, sel_registerName("initWithTitle:action:keyEquivalent:"), quitTitle, sel_registerName("terminate:"), quitMenuItemKey); + #ifndef ARC_AVAILABLE + objc_msgSend_void(quitMenuItem, sel_registerName("autorelease")); + #endif + + objc_msgSend_void_id(appMenu, sel_registerName("addItem:"), quitMenuItem); + objc_msgSend_void_id(appMenuItem, sel_registerName("setSubmenu:"), appMenu); + } + } + + { // Init Window + NSRect rect = {{0, 0}, {cast(CGFloat)mode.width, cast(CGFloat)mode.height}}; + id windowAlloc, window, wdgAlloc, wdg, contentView, titleString; + Class WindowDelegateClass; + b32 resultAddProtoc, resultAddIvar, resultAddMethod; + + windowAlloc = objc_msgSend_id(cast(id)objc_getClass("NSWindow"), sel_registerName("alloc")); + window = ((id (*)(id, SEL, NSRect, NSUInteger, NSUInteger, BOOL))objc_msgSend)(windowAlloc, sel_registerName("initWithContentRect:styleMask:backing:defer:"), rect, 15, 2, NO); + #ifndef ARC_AVAILABLE + objc_msgSend_void(window, sel_registerName("autorelease")); + #endif + + // when we are not using ARC, than window will be added to autorelease pool + // so if we close it by hand (pressing red button), we don't want it to be released for us + // so it will be released by autorelease pool later + objc_msgSend_void_bool(window, sel_registerName("setReleasedWhenClosed:"), NO); + + WindowDelegateClass = objc_allocateClassPair((Class)objc_getClass("NSObject"), "WindowDelegate", 0); + resultAddProtoc = class_addProtocol(WindowDelegateClass, objc_getProtocol("NSWindowDelegate")); + GB_ASSERT(resultAddProtoc); + resultAddIvar = class_addIvar(WindowDelegateClass, "closed", gb_size_of(NSUInteger), rint(log2(gb_size_of(NSUInteger))), NSUIntegerEncoding); + GB_ASSERT(resultAddIvar); + resultAddIvar = class_addIvar(WindowDelegateClass, "gbPlatform", gb_size_of(void *), rint(log2(gb_size_of(void *))), "ˆv"); + GB_ASSERT(resultAddIvar); + resultAddMethod = class_addMethod(WindowDelegateClass, sel_registerName("windowWillClose:"), cast(IMP)gb__osx_window_will_close, "v@:@"); + GB_ASSERT(resultAddMethod); + resultAddMethod = class_addMethod(WindowDelegateClass, sel_registerName("windowDidBecomeKey:"), cast(IMP)gb__osx_window_did_become_key, "v@:@"); + GB_ASSERT(resultAddMethod); + wdgAlloc = objc_msgSend_id(cast(id)WindowDelegateClass, sel_registerName("alloc")); + wdg = objc_msgSend_id(wdgAlloc, sel_registerName("init")); + #ifndef ARC_AVAILABLE + objc_msgSend_void(wdg, sel_registerName("autorelease")); + #endif + + objc_msgSend_void_id(window, sel_registerName("setDelegate:"), wdg); + + contentView = objc_msgSend_id(window, sel_registerName("contentView")); + + { + NSPoint point = {20, 20}; + ((void (*)(id, SEL, NSPoint))objc_msgSend)(window, sel_registerName("cascadeTopLeftFromPoint:"), point); + } + + titleString = objc_msgSend_id_char_const(cast(id)objc_getClass("NSString"), sel_registerName("stringWithUTF8String:"), window_title); + objc_msgSend_void_id(window, sel_registerName("setTitle:"), titleString); + + if (type == gbRenderer_Opengl) { + // TODO(bill): Make sure this works correctly + u32 opengl_hex_version = (p->opengl.major << 12) | (p->opengl.minor << 8); + u32 gl_attribs[] = { + 8, 24, // NSOpenGLPFAColorSize, 24, + 11, 8, // NSOpenGLPFAAlphaSize, 8, + 5, // NSOpenGLPFADoubleBuffer, + 73, // NSOpenGLPFAAccelerated, + //72, // NSOpenGLPFANoRecovery, + //55, 1, // NSOpenGLPFASampleBuffers, 1, + //56, 4, // NSOpenGLPFASamples, 4, + 99, opengl_hex_version, // NSOpenGLPFAOpenGLProfile, NSOpenGLProfileVersion3_2Core, + 0 + }; + + id pixel_format_alloc, pixel_format; + id opengl_context_alloc, opengl_context; + + pixel_format_alloc = objc_msgSend_id(cast(id)objc_getClass("NSOpenGLPixelFormat"), sel_registerName("alloc")); + pixel_format = ((id (*)(id, SEL, const uint32_t*))objc_msgSend)(pixel_format_alloc, sel_registerName("initWithAttributes:"), gl_attribs); + #ifndef ARC_AVAILABLE + objc_msgSend_void(pixel_format, sel_registerName("autorelease")); + #endif + + opengl_context_alloc = objc_msgSend_id(cast(id)objc_getClass("NSOpenGLContext"), sel_registerName("alloc")); + opengl_context = ((id (*)(id, SEL, id, id))objc_msgSend)(opengl_context_alloc, sel_registerName("initWithFormat:shareContext:"), pixel_format, nil); + #ifndef ARC_AVAILABLE + objc_msgSend_void(opengl_context, sel_registerName("autorelease")); + #endif + + objc_msgSend_void_id(opengl_context, sel_registerName("setView:"), contentView); + objc_msgSend_void_id(window, sel_registerName("makeKeyAndOrderFront:"), window); + objc_msgSend_void_bool(window, sel_registerName("setAcceptsMouseMovedEvents:"), YES); + + + p->window_handle = cast(void *)window; + p->opengl.context = cast(void *)opengl_context; + } else { + GB_PANIC("TODO(bill): Software rendering"); + } + + { + id blackColor = objc_msgSend_id(cast(id)objc_getClass("NSColor"), sel_registerName("blackColor")); + objc_msgSend_void_id(window, sel_registerName("setBackgroundColor:"), blackColor); + objc_msgSend_void_bool(NSApp, sel_registerName("activateIgnoringOtherApps:"), YES); + } + object_setInstanceVariable(wdg, "gbPlatform", cast(void *)p); + + p->is_initialized = true; + } + + return true; +} + +// NOTE(bill): Software rendering +b32 gb_platform_init_with_software(gbPlatform *p, char const *window_title, i32 width, i32 height, u32 window_flags) { + GB_PANIC("TODO(bill): Software rendering in not yet implemented on OS X\n"); + return gb__platform_init(p, window_title, gb_video_mode(width, height, 32), gbRenderer_Software, window_flags); +} +// NOTE(bill): OpenGL Rendering +b32 gb_platform_init_with_opengl(gbPlatform *p, char const *window_title, i32 width, i32 height, u32 window_flags, + i32 major, i32 minor, b32 core, b32 compatible) { + + p->opengl.major = major; + p->opengl.minor = minor; + p->opengl.core = core; + p->opengl.compatible = compatible; + return gb__platform_init(p, window_title, gb_video_mode(width, height, 32), gbRenderer_Opengl, window_flags); +} + +// NOTE(bill): Reverse engineering can be fun!!! +gb_internal gbKeyType gb__osx_from_key_code(u16 key_code) { + switch (key_code) { + default: return gbKey_Unknown; + // NOTE(bill): WHO THE FUCK DESIGNED THIS VIRTUAL KEY CODE SYSTEM?! + // THEY ARE FUCKING IDIOTS! + case 0x1d: return gbKey_0; + case 0x12: return gbKey_1; + case 0x13: return gbKey_2; + case 0x14: return gbKey_3; + case 0x15: return gbKey_4; + case 0x17: return gbKey_5; + case 0x16: return gbKey_6; + case 0x1a: return gbKey_7; + case 0x1c: return gbKey_8; + case 0x19: return gbKey_9; + + case 0x00: return gbKey_A; + case 0x0b: return gbKey_B; + case 0x08: return gbKey_C; + case 0x02: return gbKey_D; + case 0x0e: return gbKey_E; + case 0x03: return gbKey_F; + case 0x05: return gbKey_G; + case 0x04: return gbKey_H; + case 0x22: return gbKey_I; + case 0x26: return gbKey_J; + case 0x28: return gbKey_K; + case 0x25: return gbKey_L; + case 0x2e: return gbKey_M; + case 0x2d: return gbKey_N; + case 0x1f: return gbKey_O; + case 0x23: return gbKey_P; + case 0x0c: return gbKey_Q; + case 0x0f: return gbKey_R; + case 0x01: return gbKey_S; + case 0x11: return gbKey_T; + case 0x20: return gbKey_U; + case 0x09: return gbKey_V; + case 0x0d: return gbKey_W; + case 0x07: return gbKey_X; + case 0x10: return gbKey_Y; + case 0x06: return gbKey_Z; + + case 0x21: return gbKey_Lbracket; + case 0x1e: return gbKey_Rbracket; + case 0x29: return gbKey_Semicolon; + case 0x2b: return gbKey_Comma; + case 0x2f: return gbKey_Period; + case 0x27: return gbKey_Quote; + case 0x2c: return gbKey_Slash; + case 0x2a: return gbKey_Backslash; + case 0x32: return gbKey_Grave; + case 0x18: return gbKey_Equals; + case 0x1b: return gbKey_Minus; + case 0x31: return gbKey_Space; + + case 0x35: return gbKey_Escape; // Escape + case 0x3b: return gbKey_Lcontrol; // Left Control + case 0x38: return gbKey_Lshift; // Left Shift + case 0x3a: return gbKey_Lalt; // Left Alt + case 0x37: return gbKey_Lsystem; // Left OS specific: window (Windows and Linux), apple/cmd (MacOS X), ... + case 0x3e: return gbKey_Rcontrol; // Right Control + case 0x3c: return gbKey_Rshift; // Right Shift + case 0x3d: return gbKey_Ralt; // Right Alt + // case 0x37: return gbKey_Rsystem; // Right OS specific: window (Windows and Linux), apple/cmd (MacOS X), ... + case 0x6e: return gbKey_Menu; // Menu + case 0x24: return gbKey_Return; // Return + case 0x33: return gbKey_Backspace; // Backspace + case 0x30: return gbKey_Tab; // Tabulation + case 0x74: return gbKey_Pageup; // Page up + case 0x79: return gbKey_Pagedown; // Page down + case 0x77: return gbKey_End; // End + case 0x73: return gbKey_Home; // Home + case 0x72: return gbKey_Insert; // Insert + case 0x75: return gbKey_Delete; // Delete + case 0x45: return gbKey_Plus; // + + case 0x4e: return gbKey_Subtract; // - + case 0x43: return gbKey_Multiply; // * + case 0x4b: return gbKey_Divide; // / + case 0x7b: return gbKey_Left; // Left arrow + case 0x7c: return gbKey_Right; // Right arrow + case 0x7e: return gbKey_Up; // Up arrow + case 0x7d: return gbKey_Down; // Down arrow + case 0x52: return gbKey_Numpad0; // Numpad 0 + case 0x53: return gbKey_Numpad1; // Numpad 1 + case 0x54: return gbKey_Numpad2; // Numpad 2 + case 0x55: return gbKey_Numpad3; // Numpad 3 + case 0x56: return gbKey_Numpad4; // Numpad 4 + case 0x57: return gbKey_Numpad5; // Numpad 5 + case 0x58: return gbKey_Numpad6; // Numpad 6 + case 0x59: return gbKey_Numpad7; // Numpad 7 + case 0x5b: return gbKey_Numpad8; // Numpad 8 + case 0x5c: return gbKey_Numpad9; // Numpad 9 + case 0x41: return gbKey_NumpadDot; // Numpad . + case 0x4c: return gbKey_NumpadEnter; // Numpad Enter + case 0x7a: return gbKey_F1; // F1 + case 0x78: return gbKey_F2; // F2 + case 0x63: return gbKey_F3; // F3 + case 0x76: return gbKey_F4; // F4 + case 0x60: return gbKey_F5; // F5 + case 0x61: return gbKey_F6; // F6 + case 0x62: return gbKey_F7; // F7 + case 0x64: return gbKey_F8; // F8 + case 0x65: return gbKey_F9; // F8 + case 0x6d: return gbKey_F10; // F10 + case 0x67: return gbKey_F11; // F11 + case 0x6f: return gbKey_F12; // F12 + case 0x69: return gbKey_F13; // F13 + case 0x6b: return gbKey_F14; // F14 + case 0x71: return gbKey_F15; // F15 + // case : return gbKey_Pause; // Pause // NOTE(bill): Not possible on OS X + } +} + +gb_internal void gb__osx_on_cocoa_event(gbPlatform *p, id event, id window) { + if (!event) { + return; + } else if (objc_msgSend_id(window, sel_registerName("delegate"))) { + NSUInteger event_type = ((NSUInteger (*)(id, SEL))objc_msgSend)(event, sel_registerName("type")); + switch (event_type) { + case 1: gb_key_state_update(&p->mouse_buttons[gbMouseButton_Left], true); break; // NSLeftMouseDown + case 2: gb_key_state_update(&p->mouse_buttons[gbMouseButton_Left], false); break; // NSLeftMouseUp + case 3: gb_key_state_update(&p->mouse_buttons[gbMouseButton_Right], true); break; // NSRightMouseDown + case 4: gb_key_state_update(&p->mouse_buttons[gbMouseButton_Right], false); break; // NSRightMouseUp + case 25: { // NSOtherMouseDown + // TODO(bill): Test thoroughly + NSInteger number = ((NSInteger (*)(id, SEL))objc_msgSend)(event, sel_registerName("buttonNumber")); + if (number == 2) gb_key_state_update(&p->mouse_buttons[gbMouseButton_Middle], true); + if (number == 3) gb_key_state_update(&p->mouse_buttons[gbMouseButton_X1], true); + if (number == 4) gb_key_state_update(&p->mouse_buttons[gbMouseButton_X2], true); + } break; + case 26: { // NSOtherMouseUp + NSInteger number = ((NSInteger (*)(id, SEL))objc_msgSend)(event, sel_registerName("buttonNumber")); + if (number == 2) gb_key_state_update(&p->mouse_buttons[gbMouseButton_Middle], false); + if (number == 3) gb_key_state_update(&p->mouse_buttons[gbMouseButton_X1], false); + if (number == 4) gb_key_state_update(&p->mouse_buttons[gbMouseButton_X2], false); + + } break; + + // TODO(bill): Scroll wheel + case 22: { // NSScrollWheel + CGFloat dx = ((CGFloat (*)(id, SEL))abi_objc_msgSend_fpret)(event, sel_registerName("scrollingDeltaX")); + CGFloat dy = ((CGFloat (*)(id, SEL))abi_objc_msgSend_fpret)(event, sel_registerName("scrollingDeltaY")); + BOOL precision_scrolling = ((BOOL (*)(id, SEL))objc_msgSend)(event, sel_registerName("hasPreciseScrollingDeltas")); + if (precision_scrolling) { + dx *= 0.1f; + dy *= 0.1f; + } + // TODO(bill): Handle sideways + p->mouse_wheel_delta = dy; + // p->mouse_wheel_dy = dy; + // gb_printf("%f %f\n", dx, dy); + } break; + + case 12: { // NSFlagsChanged + #if 0 + // TODO(bill): Reverse engineer this properly + NSUInteger modifiers = ((NSUInteger (*)(id, SEL))objc_msgSend)(event, sel_registerName("modifierFlags")); + u32 upper_mask = (modifiers & 0xffff0000ul) >> 16; + b32 shift = (upper_mask & 0x02) != 0; + b32 control = (upper_mask & 0x04) != 0; + b32 alt = (upper_mask & 0x08) != 0; + b32 command = (upper_mask & 0x10) != 0; + #endif + + // gb_printf("%u\n", keys.mask); + // gb_printf("%x\n", cast(u32)modifiers); + } break; + + case 10: { // NSKeyDown + u16 key_code; + + id input_text = objc_msgSend_id(event, sel_registerName("characters")); + char const *input_text_utf8 = ((char const *(*)(id, SEL))objc_msgSend)(input_text, sel_registerName("UTF8String")); + p->char_buffer_count = gb_strnlen(input_text_utf8, gb_size_of(p->char_buffer)); + gb_memcopy(p->char_buffer, input_text_utf8, p->char_buffer_count); + + key_code = ((unsigned short (*)(id, SEL))objc_msgSend)(event, sel_registerName("keyCode")); + gb_key_state_update(&p->keys[gb__osx_from_key_code(key_code)], true); + } break; + + case 11: { // NSKeyUp + u16 key_code = ((unsigned short (*)(id, SEL))objc_msgSend)(event, sel_registerName("keyCode")); + gb_key_state_update(&p->keys[gb__osx_from_key_code(key_code)], false); + } break; + + default: break; + } + + objc_msgSend_void_id(NSApp, sel_registerName("sendEvent:"), event); + } +} + + +void gb_platform_update(gbPlatform *p) { + id window, key_window, content_view; + NSRect original_frame; + + window = cast(id)p->window_handle; + key_window = objc_msgSend_id(NSApp, sel_registerName("keyWindow")); + p->window_has_focus = key_window == window; // TODO(bill): Is this right + + + if (p->window_has_focus) { + isize i; + p->char_buffer_count = 0; // TODO(bill): Reset buffer count here or else where? + + // NOTE(bill): Need to update as the keys only get updates on events + for (i = 0; i < gbKey_Count; i++) { + b32 is_down = (p->keys[i] & gbKeyState_Down) != 0; + gb_key_state_update(&p->keys[i], is_down); + } + + for (i = 0; i < gbMouseButton_Count; i++) { + b32 is_down = (p->mouse_buttons[i] & gbKeyState_Down) != 0; + gb_key_state_update(&p->mouse_buttons[i], is_down); + } + + } + + { // Handle Events + id distant_past = objc_msgSend_id(cast(id)objc_getClass("NSDate"), sel_registerName("distantPast")); + id event = ((id (*)(id, SEL, NSUInteger, id, id, BOOL))objc_msgSend)(NSApp, sel_registerName("nextEventMatchingMask:untilDate:inMode:dequeue:"), NSUIntegerMax, distant_past, NSDefaultRunLoopMode, YES); + gb__osx_on_cocoa_event(p, event, window); + } + + if (p->window_has_focus) { + p->key_modifiers.control = p->keys[gbKey_Lcontrol] | p->keys[gbKey_Rcontrol]; + p->key_modifiers.alt = p->keys[gbKey_Lalt] | p->keys[gbKey_Ralt]; + p->key_modifiers.shift = p->keys[gbKey_Lshift] | p->keys[gbKey_Rshift]; + } + + { // Check if window is closed + id wdg = objc_msgSend_id(window, sel_registerName("delegate")); + if (!wdg) { + p->window_is_closed = false; + } else { + NSUInteger value = 0; + object_getInstanceVariable(wdg, "closed", cast(void **)&value); + p->window_is_closed = (value != 0); + } + } + + + + content_view = objc_msgSend_id(window, sel_registerName("contentView")); + original_frame = ((NSRect (*)(id, SEL))abi_objc_msgSend_stret)(content_view, sel_registerName("frame")); + + { // Window + NSRect frame = original_frame; + frame = ((NSRect (*)(id, SEL, NSRect))abi_objc_msgSend_stret)(content_view, sel_registerName("convertRectToBacking:"), frame); + p->window_width = frame.size.width; + p->window_height = frame.size.height; + frame = ((NSRect (*)(id, SEL, NSRect))abi_objc_msgSend_stret)(window, sel_registerName("convertRectToScreen:"), frame); + p->window_x = frame.origin.x; + p->window_y = frame.origin.y; + } + + { // Mouse + NSRect frame = original_frame; + NSPoint mouse_pos = ((NSPoint (*)(id, SEL))objc_msgSend)(window, sel_registerName("mouseLocationOutsideOfEventStream")); + mouse_pos.x = gb_clamp(mouse_pos.x, 0, frame.size.width-1); + mouse_pos.y = gb_clamp(mouse_pos.y, 0, frame.size.height-1); + + { + i32 x = mouse_pos.x; + i32 y = mouse_pos.y; + p->mouse_dx = x - p->mouse_x; + p->mouse_dy = y - p->mouse_y; + p->mouse_x = x; + p->mouse_y = y; + } + + if (p->mouse_clip) { + b32 update = false; + i32 x = p->mouse_x; + i32 y = p->mouse_y; + if (p->mouse_x < 0) { + x = 0; + update = true; + } else if (p->mouse_y > p->window_height-1) { + y = p->window_height-1; + update = true; + } + + if (p->mouse_y < 0) { + y = 0; + update = true; + } else if (p->mouse_x > p->window_width-1) { + x = p->window_width-1; + update = true; + } + + if (update) { + gb_platform_set_mouse_position(p, x, y); + } + } + } + + { // TODO(bill): Controllers + + } + + // TODO(bill): Is this in the correct place? + objc_msgSend_void(NSApp, sel_registerName("updateWindows")); + if (p->renderer_type == gbRenderer_Opengl) { + objc_msgSend_void(cast(id)p->opengl.context, sel_registerName("update")); + gb_platform_make_opengl_context_current(p); + } +} + +void gb_platform_display(gbPlatform *p) { + // TODO(bill): Do more + if (p->renderer_type == gbRenderer_Opengl) { + gb_platform_make_opengl_context_current(p); + objc_msgSend_void(cast(id)p->opengl.context, sel_registerName("flushBuffer")); + } else if (p->renderer_type == gbRenderer_Software) { + // TODO(bill): + } else { + GB_PANIC("Invalid window rendering type"); + } + + { + f64 prev_time = p->curr_time; + f64 curr_time = gb_time_now(); + p->dt_for_frame = curr_time - prev_time; + p->curr_time = curr_time; + } +} + +void gb_platform_destroy(gbPlatform *p) { + gb_platform_make_opengl_context_current(p); + + objc_msgSend_void(cast(id)p->window_handle, sel_registerName("close")); + + #if defined(ARC_AVAILABLE) + // TODO(bill): autorelease pool + #else + objc_msgSend_void(cast(id)p->osx_autorelease_pool, sel_registerName("drain")); + #endif +} + +void gb_platform_show_cursor(gbPlatform *p, b32 show) { + if (show ) { + // objc_msgSend_void(class_registerName("NSCursor"), sel_registerName("unhide")); + } else { + // objc_msgSend_void(class_registerName("NSCursor"), sel_registerName("hide")); + } +} + +void gb_platform_set_mouse_position(gbPlatform *p, i32 x, i32 y) { + // TODO(bill): + CGPoint pos = {cast(CGFloat)x, cast(CGFloat)y}; + pos.x += p->window_x; + pos.y += p->window_y; + CGWarpMouseCursorPosition(pos); +} + +void gb_platform_set_controller_vibration(gbPlatform *p, isize index, f32 left_motor, f32 right_motor) { + // TODO(bill): +} + +b32 gb_platform_has_clipboard_text(gbPlatform *p) { + // TODO(bill): + return false; +} + +void gb_platform_set_clipboard_text(gbPlatform *p, char const *str) { + // TODO(bill): +} + +char *gb_platform_get_clipboard_text(gbPlatform *p, gbAllocator a) { + // TODO(bill): + return NULL; +} + +void gb_platform_set_window_position(gbPlatform *p, i32 x, i32 y) { + // TODO(bill): +} + +void gb_platform_set_window_title(gbPlatform *p, char const *title, ...) { + id title_string; + char buf[256] = {0}; + va_list va; + va_start(va, title); + gb_snprintf_va(buf, gb_count_of(buf), title, va); + va_end(va); + + title_string = objc_msgSend_id_char_const(cast(id)objc_getClass("NSString"), sel_registerName("stringWithUTF8String:"), buf); + objc_msgSend_void_id(cast(id)p->window_handle, sel_registerName("setTitle:"), title_string); +} + +void gb_platform_toggle_fullscreen(gbPlatform *p, b32 fullscreen_desktop) { + // TODO(bill): +} + +void gb_platform_toggle_borderless(gbPlatform *p) { + // TODO(bill): +} + +void gb_platform_make_opengl_context_current(gbPlatform *p) { + objc_msgSend_void(cast(id)p->opengl.context, sel_registerName("makeCurrentContext")); +} + +void gb_platform_show_window(gbPlatform *p) { + // TODO(bill): +} + +void gb_platform_hide_window(gbPlatform *p) { + // TODO(bill): +} + +i32 gb__osx_mode_bits_per_pixel(CGDisplayModeRef mode) { + i32 bits_per_pixel = 0; + CFStringRef pixel_encoding = CGDisplayModeCopyPixelEncoding(mode); + if(CFStringCompare(pixel_encoding, CFSTR(IO32BitDirectPixels), kCFCompareCaseInsensitive) == kCFCompareEqualTo) { + bits_per_pixel = 32; + } else if(CFStringCompare(pixel_encoding, CFSTR(IO16BitDirectPixels), kCFCompareCaseInsensitive) == kCFCompareEqualTo) { + bits_per_pixel = 16; + } else if(CFStringCompare(pixel_encoding, CFSTR(IO8BitIndexedPixels), kCFCompareCaseInsensitive) == kCFCompareEqualTo) { + bits_per_pixel = 8; + } + CFRelease(pixel_encoding); + + return bits_per_pixel; +} + +i32 gb__osx_display_bits_per_pixel(CGDirectDisplayID display) { + CGDisplayModeRef mode = CGDisplayCopyDisplayMode(display); + i32 bits_per_pixel = gb__osx_mode_bits_per_pixel(mode); + CGDisplayModeRelease(mode); + return bits_per_pixel; +} + +gbVideoMode gb_video_mode_get_desktop(void) { + CGDirectDisplayID display = CGMainDisplayID(); + return gb_video_mode(CGDisplayPixelsWide(display), + CGDisplayPixelsHigh(display), + gb__osx_display_bits_per_pixel(display)); +} + + +isize gb_video_mode_get_fullscreen_modes(gbVideoMode *modes, isize max_mode_count) { + CFArrayRef cg_modes = CGDisplayCopyAllDisplayModes(CGMainDisplayID(), NULL); + CFIndex i, count; + if (cg_modes == NULL) { + return 0; + } + + count = gb_min(CFArrayGetCount(cg_modes), max_mode_count); + for (i = 0; i < count; i++) { + CGDisplayModeRef cg_mode = cast(CGDisplayModeRef)CFArrayGetValueAtIndex(cg_modes, i); + modes[i] = gb_video_mode(CGDisplayModeGetWidth(cg_mode), + CGDisplayModeGetHeight(cg_mode), + gb__osx_mode_bits_per_pixel(cg_mode)); + } + + CFRelease(cg_modes); + + gb_sort_array(modes, count, gb_video_mode_dsc_cmp); + return cast(isize)count; +} + +#endif + + +// TODO(bill): OSX Platform Layer +// NOTE(bill): Use this as a guide so there is no need for Obj-C https://github.com/jimon/osx_app_in_plain_c + +gb_inline gbVideoMode gb_video_mode(i32 width, i32 height, i32 bits_per_pixel) { + gbVideoMode m; + m.width = width; + m.height = height; + m.bits_per_pixel = bits_per_pixel; + return m; +} + +gb_inline b32 gb_video_mode_is_valid(gbVideoMode mode) { + gb_local_persist gbVideoMode modes[256] = {0}; + gb_local_persist isize mode_count = 0; + gb_local_persist b32 is_set = false; + isize i; + + if (!is_set) { + mode_count = gb_video_mode_get_fullscreen_modes(modes, gb_count_of(modes)); + is_set = true; + } + + for (i = 0; i < mode_count; i++) { + gb_printf("%d %d\n", modes[i].width, modes[i].height); + } + + return gb_binary_search_array(modes, mode_count, &mode, gb_video_mode_cmp) >= 0; +} + +GB_COMPARE_PROC(gb_video_mode_cmp) { + gbVideoMode const *x = cast(gbVideoMode const *)a; + gbVideoMode const *y = cast(gbVideoMode const *)b; + + if (x->bits_per_pixel == y->bits_per_pixel) { + if (x->width == y->width) { + return x->height < y->height ? -1 : x->height > y->height; + } + return x->width < y->width ? -1 : x->width > y->width; + } + return x->bits_per_pixel < y->bits_per_pixel ? -1 : +1; +} + +GB_COMPARE_PROC(gb_video_mode_dsc_cmp) { + return gb_video_mode_cmp(b, a); +} + +#endif // defined(GB_PLATFORM) + + + + +#if defined(GB_COMPILER_MSVC) +#pragma warning(pop) +#endif + +#if defined(__GCC__) || defined(__GNUC__) +#pragma GCC diagnostic pop +#endif + + +#if defined(__cplusplus) +} +#endif + +#endif // GB_IMPLEMENTATION diff --git a/thirdparty/stb/src/stb_image.c b/thirdparty/stb/src/stb_image.c new file mode 100644 index 0000000..badb3ef --- /dev/null +++ b/thirdparty/stb/src/stb_image.c @@ -0,0 +1,2 @@ +#define STB_IMAGE_IMPLEMENTATION +#include "stb_image.h" \ No newline at end of file diff --git a/thirdparty/stb/src/stb_image.h b/thirdparty/stb/src/stb_image.h new file mode 100644 index 0000000..39acae6 --- /dev/null +++ b/thirdparty/stb/src/stb_image.h @@ -0,0 +1,7897 @@ +/* stb_image - v2.27 - 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.27 (2021-07-11) document stbi_info better, 16-bit PNM support, bug fixes + 2.26 (2020-07-13) many minor fixes + 2.25 (2020-02-02) fix warnings + 2.24 (2020-02-02) fix warnings; thread-local failure_reason and flip_vertically + 2.23 (2019-08-11) fix clang static analysis warning + 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 Simon Breuss (16-bit PNM) + John-Mark Allen + Carmelo J Fdez-Aguera + + Bug & warning fixes + Marc LeBlanc David Woo Guillaume George Martins Mozeiko + Christpher Lloyd Jerry Jansson Joseph Thomson Blazej Dariusz Roszkowski + 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 + Eugene Golushkov Laurent Gomila Cort Stratton github:snagar + Aruelien Pocheville Sergio Gonzalez Thibault Reuille github:Zelex + Cass Everitt Ryamond Barbiero github:grim210 + Paul Du Bois Engin Manap Aldo Culquicondor github:sammyhw + Philipp Wiesemann Dale Weiler Oriol Ferrer Mesia github:phprus + Josh Tobin Matthew Gregan github:poppolopoppo + Julian Raschke Gregory Mullen Christian Floisand github:darealshinji + Baldur Karlsson Kevin Schmidt JR Smith github:Michaelangel007 + Brad Weinberger Matvey Cherevko github:mosra + Luca Sas Alexander Veselov Zack Middleton [reserved] + Ryan C. Gordon [reserved] [reserved] + DO NOT ADD YOUR NAME HERE + + Jacko Dirks + + To add your name to the credits, pick a random blank space in the middle and fill it. + 80% of merge conflicts on stb PRs are due to people adding their name at the end + of the credits. +*/ + +#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. +// +// To query the width, height and component count of an image without having to +// decode the full file, you can use the stbi_info family of functions: +// +// int x,y,n,ok; +// ok = stbi_info(filename, &x, &y, &n); +// // returns ok=1 and sets x, y, n if image is a supported format, +// // 0 otherwise. +// +// Note that stb_image pervasively uses ints in its public API for sizes, +// including sizes of memory buffers. This is now part of the API and thus +// hard to change without causing breakage. As a result, the various image +// loaders all have certain limits on image size; these differ somewhat +// by format but generally boil down to either just under 2GB or just under +// 1GB. When the decoded image would be larger than this, stb_image decoding +// will fail. +// +// Additionally, stb_image will reject image files that have any of their +// dimensions set to a larger value than the configurable STBI_MAX_DIMENSIONS, +// which defaults to 2**24 = 16777216 pixels. Due to the above memory limit, +// the only way to have an image with such dimensions load correctly +// is for it to have a rather extreme aspect ratio. Either way, the +// assumption here is that such larger images are likely to be malformed +// or malicious. If you do need to load an image with individual dimensions +// larger than that, and it still fits in the overall size limit, you can +// #define STBI_MAX_DIMENSIONS on your own to be something larger. +// +// =========================================================================== +// +// 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: +// +// We optionally support converting iPhone-formatted PNGs (which store +// premultiplied BGRA) back to RGB, even though they're internally encoded +// differently. To enable this conversion, call +// stbi_convert_iphone_png_to_rgb(1). +// +// 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 +// +// - If you define STBI_MAX_DIMENSIONS, stb_image will reject images greater +// than that size (in either width or height) without further processing. +// This is to let programs in the wild set an upper bound to prevent +// denial-of-service attacks on untrusted data, as one could generate a +// valid image of gigantic dimensions and force stb_image to allocate a +// huge block of memory and spend disproportionate time decoding it. By +// default this is set to (1 << 24), which is 16777216, but that's still +// very big. + +#ifndef STBI_NO_STDIO +#include +#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 +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 +// on most compilers (and ALL modern mainstream compilers) this is 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); + +// as above, but only applies to images loaded on the thread that calls the function +// this function is only available if your compiler supports thread-local variables; +// calling it will fail to link if your compiler doesn't +STBIDEF void stbi_set_unpremultiply_on_load_thread(int flag_true_if_should_unpremultiply); +STBIDEF void stbi_convert_iphone_png_to_rgb_thread(int flag_true_if_should_convert); +STBIDEF void stbi_set_flip_vertically_on_load_thread(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 +#include // ptrdiff_t on osx +#include +#include +#include + +#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR) +#include // ldexp, pow +#endif + +#ifndef STBI_NO_STDIO +#include +#endif + +#ifndef STBI_ASSERT +#include +#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 + +#ifndef STBI_NO_THREAD_LOCALS + #if defined(__cplusplus) && __cplusplus >= 201103L + #define STBI_THREAD_LOCAL thread_local + #elif defined(__GNUC__) && __GNUC__ < 5 + #define STBI_THREAD_LOCAL __thread + #elif defined(_MSC_VER) + #define STBI_THREAD_LOCAL __declspec(thread) + #elif defined (__STDC_VERSION__) && __STDC_VERSION__ >= 201112L && !defined(__STDC_NO_THREADS__) + #define STBI_THREAD_LOCAL _Thread_local + #endif + + #ifndef STBI_THREAD_LOCAL + #if defined(__GNUC__) + #define STBI_THREAD_LOCAL __thread + #endif + #endif +#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 +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) >> (-(y) & 31))) +#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 + +#ifdef _MSC_VER + +#if _MSC_VER >= 1400 // not VC6 +#include // __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 +#ifdef _MSC_VER +#define STBI_SIMD_ALIGN(type, name) __declspec(align(16)) type name +#else +#define STBI_SIMD_ALIGN(type, name) type name __attribute__((aligned(16))) +#endif +#endif + +#ifndef STBI_SIMD_ALIGN +#define STBI_SIMD_ALIGN(type, name) type name +#endif + +#ifndef STBI_MAX_DIMENSIONS +#define STBI_MAX_DIMENSIONS (1 << 24) +#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]; + int callback_already_read; + + 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->callback_already_read = 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->callback_already_read = 0; + s->img_buffer = 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) +{ + int ch; + fseek((FILE*) user, n, SEEK_CUR); + ch = fgetc((FILE*) user); /* have to read a byte to reset feof()'s flag */ + if (ch != EOF) { + ungetc(ch, (FILE *) user); /* push byte back onto stream if valid. */ + } +} + +static int stbi__stdio_eof(void *user) +{ + return feof((FILE*) user) || ferror((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); +static int stbi__pnm_is16(stbi__context *s); +#endif + +static +#ifdef STBI_THREAD_LOCAL +STBI_THREAD_LOCAL +#endif +const char *stbi__g_failure_reason; + +STBIDEF const char *stbi_failure_reason(void) +{ + return stbi__g_failure_reason; +} + +#ifndef STBI_NO_FAILURE_STRINGS +static int stbi__err(const char *str) +{ + stbi__g_failure_reason = str; + return 0; +} +#endif + +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; +} + +#if !defined(STBI_NO_JPEG) || !defined(STBI_NO_PNG) || !defined(STBI_NO_TGA) || !defined(STBI_NO_HDR) +// 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); +} +#endif + +// 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) || !defined(STBI_NO_PNM) +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 + +#if !defined(STBI_NO_JPEG) || !defined(STBI_NO_PNG) || !defined(STBI_NO_TGA) || !defined(STBI_NO_HDR) +// 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); +} +#endif + +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) || !defined(STBI_NO_PNM) +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_global = 0; + +STBIDEF void stbi_set_flip_vertically_on_load(int flag_true_if_should_flip) +{ + stbi__vertically_flip_on_load_global = flag_true_if_should_flip; +} + +#ifndef STBI_THREAD_LOCAL +#define stbi__vertically_flip_on_load stbi__vertically_flip_on_load_global +#else +static STBI_THREAD_LOCAL int stbi__vertically_flip_on_load_local, stbi__vertically_flip_on_load_set; + +STBIDEF void stbi_set_flip_vertically_on_load_thread(int flag_true_if_should_flip) +{ + stbi__vertically_flip_on_load_local = flag_true_if_should_flip; + stbi__vertically_flip_on_load_set = 1; +} + +#define stbi__vertically_flip_on_load (stbi__vertically_flip_on_load_set \ + ? stbi__vertically_flip_on_load_local \ + : stbi__vertically_flip_on_load_global) +#endif // STBI_THREAD_LOCAL + +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; + + // test the formats with a very explicit header first (at least a FOURCC + // or distinctive magic number first) + #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); + #else + STBI_NOTUSED(bpc); + #endif + #ifndef STBI_NO_PIC + if (stbi__pic_test(s)) return stbi__pic_load(s,x,y,comp,req_comp, ri); + #endif + + // then the formats that can end up attempting to load with just 1 or 2 + // bytes matching expectations; these are prone to false positives, so + // try them later + #ifndef STBI_NO_JPEG + if (stbi__jpeg_test(s)) return stbi__jpeg_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; + + // it is the responsibility of the loaders to make sure we get either 8 or 16 bit. + STBI_ASSERT(ri.bits_per_channel == 8 || ri.bits_per_channel == 16); + + if (ri.bits_per_channel != 8) { + 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; + + // it is the responsibility of the loaders to make sure we get either 8 or 16 bit. + STBI_ASSERT(ri.bits_per_channel == 8 || ri.bits_per_channel == 16); + + if (ri.bits_per_channel != 16) { + 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(_WIN32) && 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(_WIN32) && 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(_WIN32) && defined(STBI_WINDOWS_UTF8) + wchar_t wMode[64]; + wchar_t wFilename[1024]; + if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, filename, -1, wFilename, sizeof(wFilename)/sizeof(*wFilename))) + return 0; + + if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, mode, -1, wMode, sizeof(wMode)/sizeof(*wMode))) + return 0; + +#if defined(_MSC_VER) && _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); + s->callback_already_read += (int) (s->img_buffer - s->img_buffer_original); + 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; +} + +#if defined(STBI_NO_JPEG) && defined(STBI_NO_HDR) && defined(STBI_NO_PIC) && defined(STBI_NO_PNM) +// nothing +#else +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; +} +#endif + +#if defined(STBI_NO_JPEG) && defined(STBI_NO_PNG) && defined(STBI_NO_BMP) && defined(STBI_NO_PSD) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) && defined(STBI_NO_PIC) +// nothing +#else +static void stbi__skip(stbi__context *s, int n) +{ + if (n == 0) return; // already there! + 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; +} +#endif + +#if defined(STBI_NO_PNG) && defined(STBI_NO_TGA) && defined(STBI_NO_HDR) && defined(STBI_NO_PNM) +// nothing +#else +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; +} +#endif + +#if defined(STBI_NO_JPEG) && defined(STBI_NO_PNG) && defined(STBI_NO_PSD) && defined(STBI_NO_PIC) +// nothing +#else +static int stbi__get16be(stbi__context *s) +{ + int z = stbi__get8(s); + return (z << 8) + stbi__get8(s); +} +#endif + +#if defined(STBI_NO_PNG) && defined(STBI_NO_PSD) && defined(STBI_NO_PIC) +// nothing +#else +static stbi__uint32 stbi__get32be(stbi__context *s) +{ + stbi__uint32 z = stbi__get16be(s); + return (z << 16) + stbi__get16be(s); +} +#endif + +#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); + z += (stbi__uint32)stbi__get16le(s) << 16; + return z; +} +#endif + +#define STBI__BYTECAST(x) ((stbi_uc) ((x) & 255)) // truncate int to byte without warnings + +#if defined(STBI_NO_JPEG) && defined(STBI_NO_PNG) && defined(STBI_NO_BMP) && defined(STBI_NO_PSD) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) && defined(STBI_NO_PIC) && defined(STBI_NO_PNM) +// nothing +#else +////////////////////////////////////////////////////////////////////////////// +// +// 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); +} +#endif + +#if defined(STBI_NO_PNG) && defined(STBI_NO_BMP) && defined(STBI_NO_PSD) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) && defined(STBI_NO_PIC) && defined(STBI_NO_PNM) +// nothing +#else +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); STBI_FREE(data); STBI_FREE(good); return stbi__errpuc("unsupported", "Unsupported format conversion"); + } + #undef STBI__CASE + } + + STBI_FREE(data); + return good; +} +#endif + +#if defined(STBI_NO_PNG) && defined(STBI_NO_PSD) +// nothing +#else +static stbi__uint16 stbi__compute_y_16(int r, int g, int b) +{ + return (stbi__uint16) (((r*77) + (g*150) + (29*b)) >> 8); +} +#endif + +#if defined(STBI_NO_PNG) && defined(STBI_NO_PSD) +// nothing +#else +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); STBI_FREE(data); STBI_FREE(good); return (stbi__uint16*) stbi__errpuc("unsupported", "Unsupported format conversion"); + } + #undef STBI__CASE + } + + STBI_FREE(data); + return good; +} +#endif + +#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<code_bits < n) stbi__grow_buffer_unsafe(j); + + sgn = j->code_buffer >> 31; // sign bit always in MSB; 0 if MSB clear (positive), 1 if MSB set (negative) + 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__jbias[n] & (sgn - 1)); +} + +// 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 || t > 15) 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); + if (t < 0 || t > 15) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + 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 * (1 << 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) * (1 << 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) * (1 << 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 + if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + 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; + } + + // check that plane subsampling factors are integer ratios; our resamplers can't deal with fractional ratios + // and I've never seen a non-corrupted JPEG file actually use them + for (i=0; i < s->img_n; ++i) { + if (h_max % z->img_comp[i].h != 0) return stbi__err("bad H","Corrupt JPEG"); + if (v_max % z->img_comp[i].v != 0) return stbi__err("bad V","Corrupt JPEG"); + } + + // 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; + + // nothing to do if no components requested; check this now to avoid + // accessing uninitialized coutput[0] later + if (decode_n <= 0) { stbi__cleanup_jpeg(z); return NULL; } + + // 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)); + if (!j) return stbi__errpuc("outofmem", "Out of memory"); + 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)); + if (!j) return stbi__err("outofmem", "Out of memory"); + 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))); + if (!j) return stbi__err("outofmem", "Out of memory"); + 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) +#define STBI__ZNSYMS 288 // number of symbols in literal/length alphabet + +// 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[STBI__ZNSYMS]; + stbi__uint16 value[STBI__ZNSYMS]; +} 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 int stbi__zeof(stbi__zbuf *z) +{ + return (z->zbuffer >= z->zbuffer_end); +} + +stbi_inline static stbi_uc stbi__zget8(stbi__zbuf *z) +{ + return stbi__zeof(z) ? 0 : *z->zbuffer++; +} + +static void stbi__fill_bits(stbi__zbuf *z) +{ + do { + if (z->code_buffer >= (1U << z->num_bits)) { + z->zbuffer = z->zbuffer_end; /* treat this as EOF so we fail. */ + return; + } + 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]; + if (b >= STBI__ZNSYMS) return -1; // some data was corrupt somewhere! + if (z->size[b] != s) return -1; // was originally an assert, but report failure instead. + 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) { + if (stbi__zeof(a)) { + return -1; /* report error for unexpected end of data. */ + } + 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; + unsigned int cur, limit, old_limit; + z->zout = zout; + if (!z->z_expandable) return stbi__err("output buffer limit","Corrupt PNG"); + cur = (unsigned int) (z->zout - z->zout_start); + limit = old_limit = (unsigned) (z->zout_end - z->zout_start); + if (UINT_MAX - cur < (unsigned) n) return stbi__err("outofmem", "Out of memory"); + while (cur + n > limit) { + if(limit > UINT_MAX / 2) return stbi__err("outofmem", "Out of memory"); + 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 if (c == 18) { + c = stbi__zreceive(a,7)+11; + } else { + return stbi__err("bad codelengths", "Corrupt PNG"); + } + 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; + } + if (a->num_bits < 0) return stbi__err("zlib corrupt","Corrupt PNG"); + // 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 (stbi__zeof(a)) return stbi__err("bad zlib header","Corrupt PNG"); // zlib spec + 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[STBI__ZNSYMS] = +{ + 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 , STBI__ZNSYMS)) 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) { + if (img_width_bytes > x) return stbi__err("invalid width","Corrupt PNG"); + 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); + if (!final) return stbi__err("outofmem", "Out of memory"); + 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_global = 0; +static int stbi__de_iphone_flag_global = 0; + +STBIDEF void stbi_set_unpremultiply_on_load(int flag_true_if_should_unpremultiply) +{ + stbi__unpremultiply_on_load_global = flag_true_if_should_unpremultiply; +} + +STBIDEF void stbi_convert_iphone_png_to_rgb(int flag_true_if_should_convert) +{ + stbi__de_iphone_flag_global = flag_true_if_should_convert; +} + +#ifndef STBI_THREAD_LOCAL +#define stbi__unpremultiply_on_load stbi__unpremultiply_on_load_global +#define stbi__de_iphone_flag stbi__de_iphone_flag_global +#else +static STBI_THREAD_LOCAL int stbi__unpremultiply_on_load_local, stbi__unpremultiply_on_load_set; +static STBI_THREAD_LOCAL int stbi__de_iphone_flag_local, stbi__de_iphone_flag_set; + +STBIDEF void stbi__unpremultiply_on_load_thread(int flag_true_if_should_unpremultiply) +{ + stbi__unpremultiply_on_load_local = flag_true_if_should_unpremultiply; + stbi__unpremultiply_on_load_set = 1; +} + +STBIDEF void stbi_convert_iphone_png_to_rgb_thread(int flag_true_if_should_convert) +{ + stbi__de_iphone_flag_local = flag_true_if_should_convert; + stbi__de_iphone_flag_set = 1; +} + +#define stbi__unpremultiply_on_load (stbi__unpremultiply_on_load_set \ + ? stbi__unpremultiply_on_load_local \ + : stbi__unpremultiply_on_load_global) +#define stbi__de_iphone_flag (stbi__de_iphone_flag_set \ + ? stbi__de_iphone_flag_local \ + : stbi__de_iphone_flag_global) +#endif // STBI_THREAD_LOCAL + +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); + s->img_y = stbi__get32be(s); + if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + if (s->img_x > STBI_MAX_DIMENSIONS) 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; + // end of PNG chunk, read and skip CRC + stbi__get32be(s); + 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 if (p->depth == 16) + ri->bits_per_channel = 16; + else + return stbi__errpuc("bad bits_per_channel", "PNG not supported: unsupported color 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;/* >>= 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 < 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; + int extra_read; +} stbi__bmp_data; + +static int stbi__bmp_set_mask_defaults(stbi__bmp_data *info, int compress) +{ + // BI_BITFIELDS specifies masks explicitly, don't override + if (compress == 3) + return 1; + + if (compress == 0) { + if (info->bpp == 16) { + info->mr = 31u << 10; + info->mg = 31u << 5; + info->mb = 31u << 0; + } else 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 { + // otherwise, use defaults, which is all-0 + info->mr = info->mg = info->mb = info->ma = 0; + } + return 1; + } + return 0; // error +} + +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; + info->extra_read = 14; + + if (info->offset < 0) return stbi__errpuc("bad BMP", "bad BMP"); + + 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"); + if (compress >= 4) return stbi__errpuc("BMP JPEG/PNG", "BMP type not supported: unsupported compression"); // this includes PNG/JPEG modes + if (compress == 3 && info->bpp != 16 && info->bpp != 32) return stbi__errpuc("bad BMP", "bad BMP"); // bitfields requires 16 or 32 bits/pixel + 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) { + stbi__bmp_set_mask_defaults(info, compress); + } else if (compress == 3) { + info->mr = stbi__get32le(s); + info->mg = stbi__get32le(s); + info->mb = stbi__get32le(s); + info->extra_read += 12; + // 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 { + // V4/V5 header + 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); + if (compress != 3) // override mr/mg/mb unless in BI_BITFIELDS mode, as per docs + stbi__bmp_set_mask_defaults(info, compress); + 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); + + if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + + 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 - info.extra_read - 24) / 3; + } else { + if (info.bpp < 16) + psize = (info.offset - info.extra_read - info.hsz) >> 2; + } + if (psize == 0) { + if (info.offset != s->callback_already_read + (s->img_buffer - s->img_buffer_original)) { + return stbi__errpuc("bad offset", "Corrupt BMP"); + } + } + + if (info.bpp == 24 && ma == 0xff000000) + s->img_n = 3; + else + 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 - info.extra_read - 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 - info.extra_read - 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); + if (rcount > 8 || gcount > 8 || bcount > 8 || acount > 8) { STBI_FREE(out); return stbi__errpuc("bad masks", "Corrupt BMP"); } + } + 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); + STBI_NOTUSED(tga_x_origin); // @TODO + STBI_NOTUSED(tga_y_origin); // @TODO + + if (tga_height > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + if (tga_width > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + + // 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) + { + if (tga_palette_len == 0) { /* you have to have at least one entry! */ + STBI_FREE(tga_data); + return stbi__errpuc("bad palette", "Corrupt TGA"); + } + + // 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; + STBI_NOTUSED(tga_palette_start); + // 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); + + if (h > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + if (w > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + + // 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; ytype) { + default: + return stbi__errpuc("bad format","packet has bad compression type"); + + case 0: {//uncompressed + int x; + + for(x=0;xchannel,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; ichannel,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;ichannel,dest,value); + } else { // Raw + ++count; + if (count>left) return stbi__errpuc("bad file","scanline overrun"); + + for(i=0;ichannel,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 (y > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + if (x > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + + 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); + if (!result) return stbi__errpuc("outofmem", "Out of memory"); + 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 (g->w > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + if (g->h > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + + 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 (!g) return stbi__err("outofmem", "Out of memory"); + 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 dispose 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_outofmem(stbi__gif *g, stbi_uc *out, int **delays) +{ + STBI_FREE(g->out); + STBI_FREE(g->history); + STBI_FREE(g->background); + + if (out) STBI_FREE(out); + if (delays && *delays) STBI_FREE(*delays); + return stbi__errpuc("outofmem", "Out of memory"); +} + +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; + int out_size = 0; + int delays_size = 0; + + STBI_NOTUSED(out_size); + STBI_NOTUSED(delays_size); + + 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) { + void *tmp = (stbi_uc*) STBI_REALLOC_SIZED( out, out_size, layers * stride ); + if (!tmp) + return stbi__load_gif_main_outofmem(&g, out, delays); + else { + out = (stbi_uc*) tmp; + out_size = layers * stride; + } + + if (delays) { + int *new_delays = (int*) STBI_REALLOC_SIZED( *delays, delays_size, sizeof(int) * layers ); + if (!new_delays) + return stbi__load_gif_main_outofmem(&g, out, delays); + *delays = new_delays; + delays_size = layers * sizeof(int); + } + } else { + out = (stbi_uc*)stbi__malloc( layers * stride ); + if (!out) + return stbi__load_gif_main_outofmem(&g, out, delays); + out_size = layers * stride; + if (delays) { + *delays = (int*) stbi__malloc( layers * sizeof(int) ); + if (!*delays) + return stbi__load_gif_main_outofmem(&g, out, delays); + delays_size = 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); + + if (height > STBI_MAX_DIMENSIONS) return stbi__errpf("too large","Very large image (corrupt?)"); + if (width > STBI_MAX_DIMENSIONS) return stbi__errpf("too large","Very large image (corrupt?)"); + + *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); + if (p == NULL) { + stbi__rewind( s ); + return 0; + } + if (x) *x = s->img_x; + if (y) *y = s->img_y; + if (comp) { + if (info.bpp == 24 && info.ma == 0xff000000) + *comp = 3; + else + *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; + } + STBI_NOTUSED(stbi__get32be(s)); + STBI_NOTUSED(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) + +#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); + + ri->bits_per_channel = stbi__pnm_info(s, (int *)&s->img_x, (int *)&s->img_y, (int *)&s->img_n); + if (ri->bits_per_channel == 0) + return 0; + + if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + + *x = s->img_x; + *y = s->img_y; + if (comp) *comp = s->img_n; + + if (!stbi__mad4sizes_valid(s->img_n, s->img_x, s->img_y, ri->bits_per_channel / 8, 0)) + return stbi__errpuc("too large", "PNM too large"); + + out = (stbi_uc *) stbi__malloc_mad4(s->img_n, s->img_x, s->img_y, ri->bits_per_channel / 8, 0); + if (!out) return stbi__errpuc("outofmem", "Out of memory"); + stbi__getn(s, out, s->img_n * s->img_x * s->img_y * (ri->bits_per_channel / 8)); + + 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 > 65535) + return stbi__err("max value > 65535", "PPM image supports only 8-bit and 16-bit images"); + else if (maxv > 255) + return 16; + else + return 8; +} + +static int stbi__pnm_is16(stbi__context *s) +{ + if (stbi__pnm_info(s, NULL, NULL, NULL) == 16) + return 1; + return 0; +} +#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 + + #ifndef STBI_NO_PNM + if (stbi__pnm_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. +------------------------------------------------------------------------------ +*/ \ No newline at end of file diff --git a/thirdparty/stb/src/stb_truetype.c b/thirdparty/stb/src/stb_truetype.c new file mode 100644 index 0000000..05c23f5 --- /dev/null +++ b/thirdparty/stb/src/stb_truetype.c @@ -0,0 +1,2 @@ +#define STB_TRUETYPE_IMPLEMENTATION +#include "stb_truetype.h" \ No newline at end of file diff --git a/thirdparty/stb/src/stb_truetype.h b/thirdparty/stb/src/stb_truetype.h new file mode 100644 index 0000000..2ca3ff9 --- /dev/null +++ b/thirdparty/stb/src/stb_truetype.h @@ -0,0 +1,5114 @@ +// stb_truetype.h - v1.26 - public domain +// authored from 2009-2021 by Sean Barrett / RAD Game Tools +// +// ======================================================================= +// +// NO SECURITY GUARANTEE -- DO NOT USE THIS ON UNTRUSTED FONT FILES +// +// This library does no range checking of the offsets found in the file, +// meaning an attacker can use it to read arbitrary memory. +// +// ======================================================================= +// +// This library processes TrueType files: +// parse files +// extract glyph metrics +// extract glyph shapes +// render glyphs to one-channel bitmaps with antialiasing (box filter) +// render glyphs to one-channel SDF bitmaps (signed-distance field/function) +// +// Todo: +// non-MS cmaps +// crashproof on bad data +// hinting? (no longer patented) +// cleartype-style AA? +// optimize: use simple memory allocator for intermediates +// optimize: build edge-list directly from curves +// optimize: rasterize directly from curves? +// +// ADDITIONAL CONTRIBUTORS +// +// Mikko Mononen: compound shape support, more cmap formats +// Tor Andersson: kerning, subpixel rendering +// Dougall Johnson: OpenType / Type 2 font handling +// Daniel Ribeiro Maciel: basic GPOS-based kerning +// +// Misc other: +// Ryan Gordon +// Simon Glass +// github:IntellectualKitty +// Imanol Celaya +// Daniel Ribeiro Maciel +// +// Bug/warning reports/fixes: +// "Zer" on mollyrocket Fabian "ryg" Giesen github:NiLuJe +// Cass Everitt Martins Mozeiko github:aloucks +// stoiko (Haemimont Games) Cap Petschulat github:oyvindjam +// Brian Hook Omar Cornut github:vassvik +// Walter van Niftrik Ryan Griege +// David Gow Peter LaValle +// David Given Sergey Popov +// Ivan-Assen Ivanov Giumo X. Clanjor +// Anthony Pesch Higor Euripedes +// Johan Duparc Thomas Fields +// Hou Qiming Derek Vinyard +// Rob Loach Cort Stratton +// Kenney Phillis Jr. Brian Costabile +// Ken Voskuil (kaesve) +// +// VERSION HISTORY +// +// 1.26 (2021-08-28) fix broken rasterizer +// 1.25 (2021-07-11) many fixes +// 1.24 (2020-02-05) fix warning +// 1.23 (2020-02-02) query SVG data for glyphs; query whole kerning table (but only kern not GPOS) +// 1.22 (2019-08-11) minimize missing-glyph duplication; fix kerning if both 'GPOS' and 'kern' are defined +// 1.21 (2019-02-25) fix warning +// 1.20 (2019-02-07) PackFontRange skips missing codepoints; GetScaleFontVMetrics() +// 1.19 (2018-02-11) GPOS kerning, STBTT_fmod +// 1.18 (2018-01-29) add missing function +// 1.17 (2017-07-23) make more arguments const; doc fix +// 1.16 (2017-07-12) SDF support +// 1.15 (2017-03-03) make more arguments const +// 1.14 (2017-01-16) num-fonts-in-TTC function +// 1.13 (2017-01-02) support OpenType fonts, certain Apple fonts +// 1.12 (2016-10-25) suppress warnings about casting away const with -Wcast-qual +// 1.11 (2016-04-02) fix unused-variable warning +// 1.10 (2016-04-02) user-defined fabs(); rare memory leak; remove duplicate typedef +// 1.09 (2016-01-16) warning fix; avoid crash on outofmem; use allocation userdata properly +// 1.08 (2015-09-13) document stbtt_Rasterize(); fixes for vertical & horizontal edges +// 1.07 (2015-08-01) allow PackFontRanges to accept arrays of sparse codepoints; +// variant PackFontRanges to pack and render in separate phases; +// fix stbtt_GetFontOFfsetForIndex (never worked for non-0 input?); +// fixed an assert() bug in the new rasterizer +// replace assert() with STBTT_assert() in new rasterizer +// +// Full history can be found at the end of this file. +// +// LICENSE +// +// See end of file for license information. +// +// USAGE +// +// Include this file in whatever places need to refer to it. In ONE C/C++ +// file, write: +// #define STB_TRUETYPE_IMPLEMENTATION +// before the #include of this file. This expands out the actual +// implementation into that C/C++ file. +// +// To make the implementation private to the file that generates the implementation, +// #define STBTT_STATIC +// +// Simple 3D API (don't ship this, but it's fine for tools and quick start) +// stbtt_BakeFontBitmap() -- bake a font to a bitmap for use as texture +// stbtt_GetBakedQuad() -- compute quad to draw for a given char +// +// Improved 3D API (more shippable): +// #include "stb_rect_pack.h" -- optional, but you really want it +// stbtt_PackBegin() +// stbtt_PackSetOversampling() -- for improved quality on small fonts +// stbtt_PackFontRanges() -- pack and renders +// stbtt_PackEnd() +// stbtt_GetPackedQuad() +// +// "Load" a font file from a memory buffer (you have to keep the buffer loaded) +// stbtt_InitFont() +// stbtt_GetFontOffsetForIndex() -- indexing for TTC font collections +// stbtt_GetNumberOfFonts() -- number of fonts for TTC font collections +// +// Render a unicode codepoint to a bitmap +// stbtt_GetCodepointBitmap() -- allocates and returns a bitmap +// stbtt_MakeCodepointBitmap() -- renders into bitmap you provide +// stbtt_GetCodepointBitmapBox() -- how big the bitmap must be +// +// Character advance/positioning +// stbtt_GetCodepointHMetrics() +// stbtt_GetFontVMetrics() +// stbtt_GetFontVMetricsOS2() +// stbtt_GetCodepointKernAdvance() +// +// Starting with version 1.06, the rasterizer was replaced with a new, +// faster and generally-more-precise rasterizer. The new rasterizer more +// accurately measures pixel coverage for anti-aliasing, except in the case +// where multiple shapes overlap, in which case it overestimates the AA pixel +// coverage. Thus, anti-aliasing of intersecting shapes may look wrong. If +// this turns out to be a problem, you can re-enable the old rasterizer with +// #define STBTT_RASTERIZER_VERSION 1 +// which will incur about a 15% speed hit. +// +// ADDITIONAL DOCUMENTATION +// +// Immediately after this block comment are a series of sample programs. +// +// After the sample programs is the "header file" section. This section +// includes documentation for each API function. +// +// Some important concepts to understand to use this library: +// +// Codepoint +// Characters are defined by unicode codepoints, e.g. 65 is +// uppercase A, 231 is lowercase c with a cedilla, 0x7e30 is +// the hiragana for "ma". +// +// Glyph +// A visual character shape (every codepoint is rendered as +// some glyph) +// +// Glyph index +// A font-specific integer ID representing a glyph +// +// Baseline +// Glyph shapes are defined relative to a baseline, which is the +// bottom of uppercase characters. Characters extend both above +// and below the baseline. +// +// Current Point +// As you draw text to the screen, you keep track of a "current point" +// which is the origin of each character. The current point's vertical +// position is the baseline. Even "baked fonts" use this model. +// +// Vertical Font Metrics +// The vertical qualities of the font, used to vertically position +// and space the characters. See docs for stbtt_GetFontVMetrics. +// +// Font Size in Pixels or Points +// The preferred interface for specifying font sizes in stb_truetype +// is to specify how tall the font's vertical extent should be in pixels. +// If that sounds good enough, skip the next paragraph. +// +// Most font APIs instead use "points", which are a common typographic +// measurement for describing font size, defined as 72 points per inch. +// stb_truetype provides a point API for compatibility. However, true +// "per inch" conventions don't make much sense on computer displays +// since different monitors have different number of pixels per +// inch. For example, Windows traditionally uses a convention that +// there are 96 pixels per inch, thus making 'inch' measurements have +// nothing to do with inches, and thus effectively defining a point to +// be 1.333 pixels. Additionally, the TrueType font data provides +// an explicit scale factor to scale a given font's glyphs to points, +// but the author has observed that this scale factor is often wrong +// for non-commercial fonts, thus making fonts scaled in points +// according to the TrueType spec incoherently sized in practice. +// +// DETAILED USAGE: +// +// Scale: +// Select how high you want the font to be, in points or pixels. +// Call ScaleForPixelHeight or ScaleForMappingEmToPixels to compute +// a scale factor SF that will be used by all other functions. +// +// Baseline: +// You need to select a y-coordinate that is the baseline of where +// your text will appear. Call GetFontBoundingBox to get the baseline-relative +// bounding box for all characters. SF*-y0 will be the distance in pixels +// that the worst-case character could extend above the baseline, so if +// you want the top edge of characters to appear at the top of the +// screen where y=0, then you would set the baseline to SF*-y0. +// +// Current point: +// Set the current point where the first character will appear. The +// first character could extend left of the current point; this is font +// dependent. You can either choose a current point that is the leftmost +// point and hope, or add some padding, or check the bounding box or +// left-side-bearing of the first character to be displayed and set +// the current point based on that. +// +// Displaying a character: +// Compute the bounding box of the character. It will contain signed values +// relative to . I.e. if it returns x0,y0,x1,y1, +// then the character should be displayed in the rectangle from +// to = 32 && *text < 128) { + stbtt_aligned_quad q; + stbtt_GetBakedQuad(cdata, 512,512, *text-32, &x,&y,&q,1);//1=opengl & d3d10+,0=d3d9 + glTexCoord2f(q.s0,q.t0); glVertex2f(q.x0,q.y0); + glTexCoord2f(q.s1,q.t0); glVertex2f(q.x1,q.y0); + glTexCoord2f(q.s1,q.t1); glVertex2f(q.x1,q.y1); + glTexCoord2f(q.s0,q.t1); glVertex2f(q.x0,q.y1); + } + ++text; + } + glEnd(); +} +#endif +// +// +////////////////////////////////////////////////////////////////////////////// +// +// Complete program (this compiles): get a single bitmap, print as ASCII art +// +#if 0 +#include +#define STB_TRUETYPE_IMPLEMENTATION // force following include to generate implementation +#include "stb_truetype.h" + +char ttf_buffer[1<<25]; + +int main(int argc, char **argv) +{ + stbtt_fontinfo font; + unsigned char *bitmap; + int w,h,i,j,c = (argc > 1 ? atoi(argv[1]) : 'a'), s = (argc > 2 ? atoi(argv[2]) : 20); + + fread(ttf_buffer, 1, 1<<25, fopen(argc > 3 ? argv[3] : "c:/windows/fonts/arialbd.ttf", "rb")); + + stbtt_InitFont(&font, ttf_buffer, stbtt_GetFontOffsetForIndex(ttf_buffer,0)); + bitmap = stbtt_GetCodepointBitmap(&font, 0,stbtt_ScaleForPixelHeight(&font, s), c, &w, &h, 0,0); + + for (j=0; j < h; ++j) { + for (i=0; i < w; ++i) + putchar(" .:ioVM@"[bitmap[j*w+i]>>5]); + putchar('\n'); + } + return 0; +} +#endif +// +// Output: +// +// .ii. +// @@@@@@. +// V@Mio@@o +// :i. V@V +// :oM@@M +// :@@@MM@M +// @@o o@M +// :@@. M@M +// @@@o@@@@ +// :M@@V:@@. +// +////////////////////////////////////////////////////////////////////////////// +// +// Complete program: print "Hello World!" banner, with bugs +// +#if 0 +char buffer[24<<20]; +unsigned char screen[20][79]; + +int main(int arg, char **argv) +{ + stbtt_fontinfo font; + int i,j,ascent,baseline,ch=0; + float scale, xpos=2; // leave a little padding in case the character extends left + char *text = "Heljo World!"; // intentionally misspelled to show 'lj' brokenness + + fread(buffer, 1, 1000000, fopen("c:/windows/fonts/arialbd.ttf", "rb")); + stbtt_InitFont(&font, buffer, 0); + + scale = stbtt_ScaleForPixelHeight(&font, 15); + stbtt_GetFontVMetrics(&font, &ascent,0,0); + baseline = (int) (ascent*scale); + + while (text[ch]) { + int advance,lsb,x0,y0,x1,y1; + float x_shift = xpos - (float) floor(xpos); + stbtt_GetCodepointHMetrics(&font, text[ch], &advance, &lsb); + stbtt_GetCodepointBitmapBoxSubpixel(&font, text[ch], scale,scale,x_shift,0, &x0,&y0,&x1,&y1); + stbtt_MakeCodepointBitmapSubpixel(&font, &screen[baseline + y0][(int) xpos + x0], x1-x0,y1-y0, 79, scale,scale,x_shift,0, text[ch]); + // note that this stomps the old data, so where character boxes overlap (e.g. 'lj') it's wrong + // because this API is really for baking character bitmaps into textures. if you want to render + // a sequence of characters, you really need to render each bitmap to a temp buffer, then + // "alpha blend" that into the working buffer + xpos += (advance * scale); + if (text[ch+1]) + xpos += scale*stbtt_GetCodepointKernAdvance(&font, text[ch],text[ch+1]); + ++ch; + } + + for (j=0; j < 20; ++j) { + for (i=0; i < 78; ++i) + putchar(" .:ioVM@"[screen[j][i]>>5]); + putchar('\n'); + } + + return 0; +} +#endif + +#pragma region ODIN: CUSTOM ALLOCATOR + +#ifdef STB_TRUETYPE_IMPLEMENTATION +#define GB_IMPLEMENTATION +#endif +#include "gb/gb.h" + +#ifdef STBTT_STATIC +#define STBTT_DEF static +#else +#define STBTT_DEF extern +#endif + +#ifdef __cplusplus +extern "C" { +#endif + +STBTT_DEF void stbtt_SetAllocator( gbAllocator allocator ); + +#ifdef __cplusplus +} +#endif + +#ifndef STBTT_malloc +#define STBTT_malloc(x,u) ((void)(u), gb_alloc(stbtt__allocator, x)) +#define STBTT_free(x,u) ((void)(u), gb_free(stbtt__allocator, x)) +#endif + +#ifdef STB_TRUETYPE_IMPLEMENTATION +gb_global gbAllocator stbtt__allocator = { gb_heap_allocator_proc, NULL }; + +STBTT_DEF void stbtt_SetAllocator( gbAllocator allocator ) { + stbtt__allocator = allocator; +} +#endif + +#pragma endregion ODIN: CUSTOM ALLOCATOR + +////////////////////////////////////////////////////////////////////////////// +////////////////////////////////////////////////////////////////////////////// +//// +//// INTEGRATION WITH YOUR CODEBASE +//// +//// The following sections allow you to supply alternate definitions +//// of C library functions used by stb_truetype, e.g. if you don't +//// link with the C runtime library. + +#ifdef STB_TRUETYPE_IMPLEMENTATION + // #define your own (u)stbtt_int8/16/32 before including to override this + #ifndef stbtt_uint8 + typedef unsigned char stbtt_uint8; + typedef signed char stbtt_int8; + typedef unsigned short stbtt_uint16; + typedef signed short stbtt_int16; + typedef unsigned int stbtt_uint32; + typedef signed int stbtt_int32; + #endif + + typedef char stbtt__check_size32[sizeof(stbtt_int32)==4 ? 1 : -1]; + typedef char stbtt__check_size16[sizeof(stbtt_int16)==2 ? 1 : -1]; + + // e.g. #define your own STBTT_ifloor/STBTT_iceil() to avoid math.h + #ifndef STBTT_ifloor + #include + #define STBTT_ifloor(x) ((int) floor(x)) + #define STBTT_iceil(x) ((int) ceil(x)) + #endif + + #ifndef STBTT_sqrt + #include + #define STBTT_sqrt(x) sqrt(x) + #define STBTT_pow(x,y) pow(x,y) + #endif + + #ifndef STBTT_fmod + #include + #define STBTT_fmod(x,y) fmod(x,y) + #endif + + #ifndef STBTT_cos + #include + #define STBTT_cos(x) cos(x) + #define STBTT_acos(x) acos(x) + #endif + + #ifndef STBTT_fabs + #include + #define STBTT_fabs(x) fabs(x) + #endif + + // #define your own functions "STBTT_malloc" / "STBTT_free" to avoid malloc.h + #ifndef STBTT_malloc + #include + #define STBTT_malloc(x,u) ((void)(u),malloc(x)) + #define STBTT_free(x,u) ((void)(u),free(x)) + #endif + + #ifndef STBTT_assert + #include + #define STBTT_assert(x) assert(x) + #endif + + #ifndef STBTT_strlen + #include + #define STBTT_strlen(x) strlen(x) + #endif + + #ifndef STBTT_memcpy + #include + #define STBTT_memcpy memcpy + #define STBTT_memset memset + #endif +#endif + +/////////////////////////////////////////////////////////////////////////////// +/////////////////////////////////////////////////////////////////////////////// +//// +//// INTERFACE +//// +//// + +#ifndef __STB_INCLUDE_STB_TRUETYPE_H__ +#define __STB_INCLUDE_STB_TRUETYPE_H__ + +#ifdef STBTT_STATIC +#define STBTT_DEF static +#else +#define STBTT_DEF extern +#endif + +#ifdef __cplusplus +extern "C" { +#endif + +// private structure +typedef struct +{ + unsigned char *data; + int cursor; + int size; +} stbtt__buf; + +////////////////////////////////////////////////////////////////////////////// +// +// TEXTURE BAKING API +// +// If you use this API, you only have to call two functions ever. +// + +typedef struct +{ + unsigned short x0,y0,x1,y1; // coordinates of bbox in bitmap + float xoff,yoff,xadvance; +} stbtt_bakedchar; + +STBTT_DEF int stbtt_BakeFontBitmap(const unsigned char *data, int offset, // font location (use offset=0 for plain .ttf) + float pixel_height, // height of font in pixels + unsigned char *pixels, int pw, int ph, // bitmap to be filled in + int first_char, int num_chars, // characters to bake + stbtt_bakedchar *chardata); // you allocate this, it's num_chars long +// if return is positive, the first unused row of the bitmap +// if return is negative, returns the negative of the number of characters that fit +// if return is 0, no characters fit and no rows were used +// This uses a very crappy packing. + +typedef struct +{ + float x0,y0,s0,t0; // top-left + float x1,y1,s1,t1; // bottom-right +} stbtt_aligned_quad; + +STBTT_DEF void stbtt_GetBakedQuad(const stbtt_bakedchar *chardata, int pw, int ph, // same data as above + int char_index, // character to display + float *xpos, float *ypos, // pointers to current position in screen pixel space + stbtt_aligned_quad *q, // output: quad to draw + int opengl_fillrule); // true if opengl fill rule; false if DX9 or earlier +// Call GetBakedQuad with char_index = 'character - first_char', and it +// creates the quad you need to draw and advances the current position. +// +// The coordinate system used assumes y increases downwards. +// +// Characters will extend both above and below the current position; +// see discussion of "BASELINE" above. +// +// It's inefficient; you might want to c&p it and optimize it. + +STBTT_DEF void stbtt_GetScaledFontVMetrics(const unsigned char *fontdata, int index, float size, float *ascent, float *descent, float *lineGap); +// Query the font vertical metrics without having to create a font first. + + +////////////////////////////////////////////////////////////////////////////// +// +// NEW TEXTURE BAKING API +// +// This provides options for packing multiple fonts into one atlas, not +// perfectly but better than nothing. + +typedef struct +{ + unsigned short x0,y0,x1,y1; // coordinates of bbox in bitmap + float xoff,yoff,xadvance; + float xoff2,yoff2; +} stbtt_packedchar; + +typedef struct stbtt_pack_context stbtt_pack_context; +typedef struct stbtt_fontinfo stbtt_fontinfo; +#ifndef STB_RECT_PACK_VERSION +typedef struct stbrp_rect stbrp_rect; +#endif + +STBTT_DEF int stbtt_PackBegin(stbtt_pack_context *spc, unsigned char *pixels, int width, int height, int stride_in_bytes, int padding, void *alloc_context); +// Initializes a packing context stored in the passed-in stbtt_pack_context. +// Future calls using this context will pack characters into the bitmap passed +// in here: a 1-channel bitmap that is width * height. stride_in_bytes is +// the distance from one row to the next (or 0 to mean they are packed tightly +// together). "padding" is the amount of padding to leave between each +// character (normally you want '1' for bitmaps you'll use as textures with +// bilinear filtering). +// +// Returns 0 on failure, 1 on success. + +STBTT_DEF void stbtt_PackEnd (stbtt_pack_context *spc); +// Cleans up the packing context and frees all memory. + +#define STBTT_POINT_SIZE(x) (-(x)) + +STBTT_DEF int stbtt_PackFontRange(stbtt_pack_context *spc, const unsigned char *fontdata, int font_index, float font_size, + int first_unicode_char_in_range, int num_chars_in_range, stbtt_packedchar *chardata_for_range); +// Creates character bitmaps from the font_index'th font found in fontdata (use +// font_index=0 if you don't know what that is). It creates num_chars_in_range +// bitmaps for characters with unicode values starting at first_unicode_char_in_range +// and increasing. Data for how to render them is stored in chardata_for_range; +// pass these to stbtt_GetPackedQuad to get back renderable quads. +// +// font_size is the full height of the character from ascender to descender, +// as computed by stbtt_ScaleForPixelHeight. To use a point size as computed +// by stbtt_ScaleForMappingEmToPixels, wrap the point size in STBTT_POINT_SIZE() +// and pass that result as 'font_size': +// ..., 20 , ... // font max minus min y is 20 pixels tall +// ..., STBTT_POINT_SIZE(20), ... // 'M' is 20 pixels tall + +typedef struct +{ + float font_size; + int first_unicode_codepoint_in_range; // if non-zero, then the chars are continuous, and this is the first codepoint + int *array_of_unicode_codepoints; // if non-zero, then this is an array of unicode codepoints + int num_chars; + stbtt_packedchar *chardata_for_range; // output + unsigned char h_oversample, v_oversample; // don't set these, they're used internally +} stbtt_pack_range; + +STBTT_DEF int stbtt_PackFontRanges(stbtt_pack_context *spc, const unsigned char *fontdata, int font_index, stbtt_pack_range *ranges, int num_ranges); +// Creates character bitmaps from multiple ranges of characters stored in +// ranges. This will usually create a better-packed bitmap than multiple +// calls to stbtt_PackFontRange. Note that you can call this multiple +// times within a single PackBegin/PackEnd. + +STBTT_DEF void stbtt_PackSetOversampling(stbtt_pack_context *spc, unsigned int h_oversample, unsigned int v_oversample); +// Oversampling a font increases the quality by allowing higher-quality subpixel +// positioning, and is especially valuable at smaller text sizes. +// +// This function sets the amount of oversampling for all following calls to +// stbtt_PackFontRange(s) or stbtt_PackFontRangesGatherRects for a given +// pack context. The default (no oversampling) is achieved by h_oversample=1 +// and v_oversample=1. The total number of pixels required is +// h_oversample*v_oversample larger than the default; for example, 2x2 +// oversampling requires 4x the storage of 1x1. For best results, render +// oversampled textures with bilinear filtering. Look at the readme in +// stb/tests/oversample for information about oversampled fonts +// +// To use with PackFontRangesGather etc., you must set it before calls +// call to PackFontRangesGatherRects. + +STBTT_DEF void stbtt_PackSetSkipMissingCodepoints(stbtt_pack_context *spc, int skip); +// If skip != 0, this tells stb_truetype to skip any codepoints for which +// there is no corresponding glyph. If skip=0, which is the default, then +// codepoints without a glyph recived the font's "missing character" glyph, +// typically an empty box by convention. + +STBTT_DEF void stbtt_GetPackedQuad(const stbtt_packedchar *chardata, int pw, int ph, // same data as above + int char_index, // character to display + float *xpos, float *ypos, // pointers to current position in screen pixel space + stbtt_aligned_quad *q, // output: quad to draw + int align_to_integer); + +STBTT_DEF int stbtt_PackFontRangesGatherRects(stbtt_pack_context *spc, const stbtt_fontinfo *info, stbtt_pack_range *ranges, int num_ranges, stbrp_rect *rects); +STBTT_DEF void stbtt_PackFontRangesPackRects(stbtt_pack_context *spc, stbrp_rect *rects, int num_rects); +STBTT_DEF int stbtt_PackFontRangesRenderIntoRects(stbtt_pack_context *spc, const stbtt_fontinfo *info, stbtt_pack_range *ranges, int num_ranges, stbrp_rect *rects); +// Calling these functions in sequence is roughly equivalent to calling +// stbtt_PackFontRanges(). If you more control over the packing of multiple +// fonts, or if you want to pack custom data into a font texture, take a look +// at the source to of stbtt_PackFontRanges() and create a custom version +// using these functions, e.g. call GatherRects multiple times, +// building up a single array of rects, then call PackRects once, +// then call RenderIntoRects repeatedly. This may result in a +// better packing than calling PackFontRanges multiple times +// (or it may not). + +// this is an opaque structure that you shouldn't mess with which holds +// all the context needed from PackBegin to PackEnd. +struct stbtt_pack_context { + void *user_allocator_context; + void *pack_info; + int width; + int height; + int stride_in_bytes; + int padding; + int skip_missing; + unsigned int h_oversample, v_oversample; + unsigned char *pixels; + void *nodes; +}; + +////////////////////////////////////////////////////////////////////////////// +// +// FONT LOADING +// +// + +STBTT_DEF int stbtt_GetNumberOfFonts(const unsigned char *data); +// This function will determine the number of fonts in a font file. TrueType +// collection (.ttc) files may contain multiple fonts, while TrueType font +// (.ttf) files only contain one font. The number of fonts can be used for +// indexing with the previous function where the index is between zero and one +// less than the total fonts. If an error occurs, -1 is returned. + +STBTT_DEF int stbtt_GetFontOffsetForIndex(const unsigned char *data, int index); +// Each .ttf/.ttc file may have more than one font. Each font has a sequential +// index number starting from 0. Call this function to get the font offset for +// a given index; it returns -1 if the index is out of range. A regular .ttf +// file will only define one font and it always be at offset 0, so it will +// return '0' for index 0, and -1 for all other indices. + +// The following structure is defined publicly so you can declare one on +// the stack or as a global or etc, but you should treat it as opaque. +struct stbtt_fontinfo +{ + void * userdata; + unsigned char * data; // pointer to .ttf file + int fontstart; // offset of start of font + + int numGlyphs; // number of glyphs, needed for range checking + + int loca,head,glyf,hhea,hmtx,kern,gpos,svg; // table locations as offset from start of .ttf + int index_map; // a cmap mapping for our chosen character encoding + int indexToLocFormat; // format needed to map from glyph index to glyph + + stbtt__buf cff; // cff font data + stbtt__buf charstrings; // the charstring index + stbtt__buf gsubrs; // global charstring subroutines index + stbtt__buf subrs; // private charstring subroutines index + stbtt__buf fontdicts; // array of font dicts + stbtt__buf fdselect; // map from glyph to fontdict +}; + +STBTT_DEF int stbtt_InitFont(stbtt_fontinfo *info, const unsigned char *data, int offset); +// Given an offset into the file that defines a font, this function builds +// the necessary cached info for the rest of the system. You must allocate +// the stbtt_fontinfo yourself, and stbtt_InitFont will fill it out. You don't +// need to do anything special to free it, because the contents are pure +// value data with no additional data structures. Returns 0 on failure. + + +////////////////////////////////////////////////////////////////////////////// +// +// CHARACTER TO GLYPH-INDEX CONVERSIOn + +STBTT_DEF int stbtt_FindGlyphIndex(const stbtt_fontinfo *info, int unicode_codepoint); +// If you're going to perform multiple operations on the same character +// and you want a speed-up, call this function with the character you're +// going to process, then use glyph-based functions instead of the +// codepoint-based functions. +// Returns 0 if the character codepoint is not defined in the font. + + +////////////////////////////////////////////////////////////////////////////// +// +// CHARACTER PROPERTIES +// + +STBTT_DEF float stbtt_ScaleForPixelHeight(const stbtt_fontinfo *info, float pixels); +// computes a scale factor to produce a font whose "height" is 'pixels' tall. +// Height is measured as the distance from the highest ascender to the lowest +// descender; in other words, it's equivalent to calling stbtt_GetFontVMetrics +// and computing: +// scale = pixels / (ascent - descent) +// so if you prefer to measure height by the ascent only, use a similar calculation. + +STBTT_DEF float stbtt_ScaleForMappingEmToPixels(const stbtt_fontinfo *info, float pixels); +// computes a scale factor to produce a font whose EM size is mapped to +// 'pixels' tall. This is probably what traditional APIs compute, but +// I'm not positive. + +STBTT_DEF void stbtt_GetFontVMetrics(const stbtt_fontinfo *info, int *ascent, int *descent, int *lineGap); +// ascent is the coordinate above the baseline the font extends; descent +// is the coordinate below the baseline the font extends (i.e. it is typically negative) +// lineGap is the spacing between one row's descent and the next row's ascent... +// so you should advance the vertical position by "*ascent - *descent + *lineGap" +// these are expressed in unscaled coordinates, so you must multiply by +// the scale factor for a given size + +STBTT_DEF int stbtt_GetFontVMetricsOS2(const stbtt_fontinfo *info, int *typoAscent, int *typoDescent, int *typoLineGap); +// analogous to GetFontVMetrics, but returns the "typographic" values from the OS/2 +// table (specific to MS/Windows TTF files). +// +// Returns 1 on success (table present), 0 on failure. + +STBTT_DEF void stbtt_GetFontBoundingBox(const stbtt_fontinfo *info, int *x0, int *y0, int *x1, int *y1); +// the bounding box around all possible characters + +STBTT_DEF void stbtt_GetCodepointHMetrics(const stbtt_fontinfo *info, int codepoint, int *advanceWidth, int *leftSideBearing); +// leftSideBearing is the offset from the current horizontal position to the left edge of the character +// advanceWidth is the offset from the current horizontal position to the next horizontal position +// these are expressed in unscaled coordinates + +STBTT_DEF int stbtt_GetCodepointKernAdvance(const stbtt_fontinfo *info, int ch1, int ch2); +// an additional amount to add to the 'advance' value between ch1 and ch2 + +STBTT_DEF int stbtt_GetCodepointBox(const stbtt_fontinfo *info, int codepoint, int *x0, int *y0, int *x1, int *y1); +// Gets the bounding box of the visible part of the glyph, in unscaled coordinates + +STBTT_DEF void stbtt_GetGlyphHMetrics(const stbtt_fontinfo *info, int glyph_index, int *advanceWidth, int *leftSideBearing); +STBTT_DEF int stbtt_GetGlyphKernAdvance(const stbtt_fontinfo *info, int glyph1, int glyph2); +STBTT_DEF int stbtt_GetGlyphBox(const stbtt_fontinfo *info, int glyph_index, int *x0, int *y0, int *x1, int *y1); +// as above, but takes one or more glyph indices for greater efficiency + +typedef struct stbtt_kerningentry +{ + int glyph1; // use stbtt_FindGlyphIndex + int glyph2; + int advance; +} stbtt_kerningentry; + +STBTT_DEF int stbtt_GetKerningTableLength(const stbtt_fontinfo *info); +STBTT_DEF int stbtt_GetKerningTable(const stbtt_fontinfo *info, stbtt_kerningentry* table, int table_length); +// Retrieves a complete list of all of the kerning pairs provided by the font +// stbtt_GetKerningTable never writes more than table_length entries and returns how many entries it did write. +// The table will be sorted by (a.glyph1 == b.glyph1)?(a.glyph2 < b.glyph2):(a.glyph1 < b.glyph1) + +////////////////////////////////////////////////////////////////////////////// +// +// GLYPH SHAPES (you probably don't need these, but they have to go before +// the bitmaps for C declaration-order reasons) +// + +#ifndef STBTT_vmove // you can predefine these to use different values (but why?) + enum { + STBTT_vmove=1, + STBTT_vline, + STBTT_vcurve, + STBTT_vcubic + }; +#endif + +#ifndef stbtt_vertex // you can predefine this to use different values + // (we share this with other code at RAD) + #define stbtt_vertex_type short // can't use stbtt_int16 because that's not visible in the header file + typedef struct + { + stbtt_vertex_type x,y,cx,cy,cx1,cy1; + unsigned char type,padding; + } stbtt_vertex; +#endif + +STBTT_DEF int stbtt_IsGlyphEmpty(const stbtt_fontinfo *info, int glyph_index); +// returns non-zero if nothing is drawn for this glyph + +STBTT_DEF int stbtt_GetCodepointShape(const stbtt_fontinfo *info, int unicode_codepoint, stbtt_vertex **vertices); +STBTT_DEF int stbtt_GetGlyphShape(const stbtt_fontinfo *info, int glyph_index, stbtt_vertex **vertices); +// returns # of vertices and fills *vertices with the pointer to them +// these are expressed in "unscaled" coordinates +// +// The shape is a series of contours. Each one starts with +// a STBTT_moveto, then consists of a series of mixed +// STBTT_lineto and STBTT_curveto segments. A lineto +// draws a line from previous endpoint to its x,y; a curveto +// draws a quadratic bezier from previous endpoint to +// its x,y, using cx,cy as the bezier control point. + +STBTT_DEF void stbtt_FreeShape(const stbtt_fontinfo *info, stbtt_vertex *vertices); +// frees the data allocated above + +STBTT_DEF unsigned char *stbtt_FindSVGDoc(const stbtt_fontinfo *info, int gl); +STBTT_DEF int stbtt_GetCodepointSVG(const stbtt_fontinfo *info, int unicode_codepoint, const char **svg); +STBTT_DEF int stbtt_GetGlyphSVG(const stbtt_fontinfo *info, int gl, const char **svg); +// fills svg with the character's SVG data. +// returns data size or 0 if SVG not found. + +////////////////////////////////////////////////////////////////////////////// +// +// BITMAP RENDERING +// + +STBTT_DEF void stbtt_FreeBitmap(unsigned char *bitmap, void *userdata); +// frees the bitmap allocated below + +STBTT_DEF unsigned char *stbtt_GetCodepointBitmap(const stbtt_fontinfo *info, float scale_x, float scale_y, int codepoint, int *width, int *height, int *xoff, int *yoff); +// allocates a large-enough single-channel 8bpp bitmap and renders the +// specified character/glyph at the specified scale into it, with +// antialiasing. 0 is no coverage (transparent), 255 is fully covered (opaque). +// *width & *height are filled out with the width & height of the bitmap, +// which is stored left-to-right, top-to-bottom. +// +// xoff/yoff are the offset it pixel space from the glyph origin to the top-left of the bitmap + +STBTT_DEF unsigned char *stbtt_GetCodepointBitmapSubpixel(const stbtt_fontinfo *info, float scale_x, float scale_y, float shift_x, float shift_y, int codepoint, int *width, int *height, int *xoff, int *yoff); +// the same as stbtt_GetCodepoitnBitmap, but you can specify a subpixel +// shift for the character + +STBTT_DEF void stbtt_MakeCodepointBitmap(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, int codepoint); +// the same as stbtt_GetCodepointBitmap, but you pass in storage for the bitmap +// in the form of 'output', with row spacing of 'out_stride' bytes. the bitmap +// is clipped to out_w/out_h bytes. Call stbtt_GetCodepointBitmapBox to get the +// width and height and positioning info for it first. + +STBTT_DEF void stbtt_MakeCodepointBitmapSubpixel(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, float shift_x, float shift_y, int codepoint); +// same as stbtt_MakeCodepointBitmap, but you can specify a subpixel +// shift for the character + +STBTT_DEF void stbtt_MakeCodepointBitmapSubpixelPrefilter(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, float shift_x, float shift_y, int oversample_x, int oversample_y, float *sub_x, float *sub_y, int codepoint); +// same as stbtt_MakeCodepointBitmapSubpixel, but prefiltering +// is performed (see stbtt_PackSetOversampling) + +STBTT_DEF void stbtt_GetCodepointBitmapBox(const stbtt_fontinfo *font, int codepoint, float scale_x, float scale_y, int *ix0, int *iy0, int *ix1, int *iy1); +// get the bbox of the bitmap centered around the glyph origin; so the +// bitmap width is ix1-ix0, height is iy1-iy0, and location to place +// the bitmap top left is (leftSideBearing*scale,iy0). +// (Note that the bitmap uses y-increases-down, but the shape uses +// y-increases-up, so CodepointBitmapBox and CodepointBox are inverted.) + +STBTT_DEF void stbtt_GetCodepointBitmapBoxSubpixel(const stbtt_fontinfo *font, int codepoint, float scale_x, float scale_y, float shift_x, float shift_y, int *ix0, int *iy0, int *ix1, int *iy1); +// same as stbtt_GetCodepointBitmapBox, but you can specify a subpixel +// shift for the character + +// the following functions are equivalent to the above functions, but operate +// on glyph indices instead of Unicode codepoints (for efficiency) +STBTT_DEF unsigned char *stbtt_GetGlyphBitmap(const stbtt_fontinfo *info, float scale_x, float scale_y, int glyph, int *width, int *height, int *xoff, int *yoff); +STBTT_DEF unsigned char *stbtt_GetGlyphBitmapSubpixel(const stbtt_fontinfo *info, float scale_x, float scale_y, float shift_x, float shift_y, int glyph, int *width, int *height, int *xoff, int *yoff); +STBTT_DEF void stbtt_MakeGlyphBitmap(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, int glyph); +STBTT_DEF void stbtt_MakeGlyphBitmapSubpixel(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, float shift_x, float shift_y, int glyph); +STBTT_DEF void stbtt_MakeGlyphBitmapSubpixelPrefilter(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, float shift_x, float shift_y, int oversample_x, int oversample_y, float *sub_x, float *sub_y, int glyph); +STBTT_DEF void stbtt_GetGlyphBitmapBox(const stbtt_fontinfo *font, int glyph, float scale_x, float scale_y, int *ix0, int *iy0, int *ix1, int *iy1); +STBTT_DEF void stbtt_GetGlyphBitmapBoxSubpixel(const stbtt_fontinfo *font, int glyph, float scale_x, float scale_y,float shift_x, float shift_y, int *ix0, int *iy0, int *ix1, int *iy1); + + +// @TODO: don't expose this structure +typedef struct +{ + int w,h,stride; + unsigned char *pixels; +} stbtt__bitmap; + +// rasterize a shape with quadratic beziers into a bitmap +STBTT_DEF void stbtt_Rasterize(stbtt__bitmap *result, // 1-channel bitmap to draw into + float flatness_in_pixels, // allowable error of curve in pixels + stbtt_vertex *vertices, // array of vertices defining shape + int num_verts, // number of vertices in above array + float scale_x, float scale_y, // scale applied to input vertices + float shift_x, float shift_y, // translation applied to input vertices + int x_off, int y_off, // another translation applied to input + int invert, // if non-zero, vertically flip shape + void *userdata); // context for to STBTT_MALLOC + +////////////////////////////////////////////////////////////////////////////// +// +// Signed Distance Function (or Field) rendering + +STBTT_DEF void stbtt_FreeSDF(unsigned char *bitmap, void *userdata); +// frees the SDF bitmap allocated below + +STBTT_DEF unsigned char * stbtt_GetGlyphSDF(const stbtt_fontinfo *info, float scale, int glyph, int padding, unsigned char onedge_value, float pixel_dist_scale, int *width, int *height, int *xoff, int *yoff); +STBTT_DEF unsigned char * stbtt_GetCodepointSDF(const stbtt_fontinfo *info, float scale, int codepoint, int padding, unsigned char onedge_value, float pixel_dist_scale, int *width, int *height, int *xoff, int *yoff); +// These functions compute a discretized SDF field for a single character, suitable for storing +// in a single-channel texture, sampling with bilinear filtering, and testing against +// larger than some threshold to produce scalable fonts. +// info -- the font +// scale -- controls the size of the resulting SDF bitmap, same as it would be creating a regular bitmap +// glyph/codepoint -- the character to generate the SDF for +// padding -- extra "pixels" around the character which are filled with the distance to the character (not 0), +// which allows effects like bit outlines +// onedge_value -- value 0-255 to test the SDF against to reconstruct the character (i.e. the isocontour of the character) +// pixel_dist_scale -- what value the SDF should increase by when moving one SDF "pixel" away from the edge (on the 0..255 scale) +// if positive, > onedge_value is inside; if negative, < onedge_value is inside +// width,height -- output height & width of the SDF bitmap (including padding) +// xoff,yoff -- output origin of the character +// return value -- a 2D array of bytes 0..255, width*height in size +// +// pixel_dist_scale & onedge_value are a scale & bias that allows you to make +// optimal use of the limited 0..255 for your application, trading off precision +// and special effects. SDF values outside the range 0..255 are clamped to 0..255. +// +// Example: +// scale = stbtt_ScaleForPixelHeight(22) +// padding = 5 +// onedge_value = 180 +// pixel_dist_scale = 180/5.0 = 36.0 +// +// This will create an SDF bitmap in which the character is about 22 pixels +// high but the whole bitmap is about 22+5+5=32 pixels high. To produce a filled +// shape, sample the SDF at each pixel and fill the pixel if the SDF value +// is greater than or equal to 180/255. (You'll actually want to antialias, +// which is beyond the scope of this example.) Additionally, you can compute +// offset outlines (e.g. to stroke the character border inside & outside, +// or only outside). For example, to fill outside the character up to 3 SDF +// pixels, you would compare against (180-36.0*3)/255 = 72/255. The above +// choice of variables maps a range from 5 pixels outside the shape to +// 2 pixels inside the shape to 0..255; this is intended primarily for apply +// outside effects only (the interior range is needed to allow proper +// antialiasing of the font at *smaller* sizes) +// +// The function computes the SDF analytically at each SDF pixel, not by e.g. +// building a higher-res bitmap and approximating it. In theory the quality +// should be as high as possible for an SDF of this size & representation, but +// unclear if this is true in practice (perhaps building a higher-res bitmap +// and computing from that can allow drop-out prevention). +// +// The algorithm has not been optimized at all, so expect it to be slow +// if computing lots of characters or very large sizes. + + + +////////////////////////////////////////////////////////////////////////////// +// +// Finding the right font... +// +// You should really just solve this offline, keep your own tables +// of what font is what, and don't try to get it out of the .ttf file. +// That's because getting it out of the .ttf file is really hard, because +// the names in the file can appear in many possible encodings, in many +// possible languages, and e.g. if you need a case-insensitive comparison, +// the details of that depend on the encoding & language in a complex way +// (actually underspecified in truetype, but also gigantic). +// +// But you can use the provided functions in two possible ways: +// stbtt_FindMatchingFont() will use *case-sensitive* comparisons on +// unicode-encoded names to try to find the font you want; +// you can run this before calling stbtt_InitFont() +// +// stbtt_GetFontNameString() lets you get any of the various strings +// from the file yourself and do your own comparisons on them. +// You have to have called stbtt_InitFont() first. + + +STBTT_DEF int stbtt_FindMatchingFont(const unsigned char *fontdata, const char *name, int flags); +// returns the offset (not index) of the font that matches, or -1 if none +// if you use STBTT_MACSTYLE_DONTCARE, use a font name like "Arial Bold". +// if you use any other flag, use a font name like "Arial"; this checks +// the 'macStyle' header field; i don't know if fonts set this consistently +#define STBTT_MACSTYLE_DONTCARE 0 +#define STBTT_MACSTYLE_BOLD 1 +#define STBTT_MACSTYLE_ITALIC 2 +#define STBTT_MACSTYLE_UNDERSCORE 4 +#define STBTT_MACSTYLE_NONE 8 // <= not same as 0, this makes us check the bitfield is 0 + +STBTT_DEF int stbtt_CompareUTF8toUTF16_bigendian(const char *s1, int len1, const char *s2, int len2); +// returns 1/0 whether the first string interpreted as utf8 is identical to +// the second string interpreted as big-endian utf16... useful for strings from next func + +STBTT_DEF const char *stbtt_GetFontNameString(const stbtt_fontinfo *font, int *length, int platformID, int encodingID, int languageID, int nameID); +// returns the string (which may be big-endian double byte, e.g. for unicode) +// and puts the length in bytes in *length. +// +// some of the values for the IDs are below; for more see the truetype spec: +// http://developer.apple.com/textfonts/TTRefMan/RM06/Chap6name.html +// http://www.microsoft.com/typography/otspec/name.htm + +enum { // platformID + STBTT_PLATFORM_ID_UNICODE =0, + STBTT_PLATFORM_ID_MAC =1, + STBTT_PLATFORM_ID_ISO =2, + STBTT_PLATFORM_ID_MICROSOFT =3 +}; + +enum { // encodingID for STBTT_PLATFORM_ID_UNICODE + STBTT_UNICODE_EID_UNICODE_1_0 =0, + STBTT_UNICODE_EID_UNICODE_1_1 =1, + STBTT_UNICODE_EID_ISO_10646 =2, + STBTT_UNICODE_EID_UNICODE_2_0_BMP=3, + STBTT_UNICODE_EID_UNICODE_2_0_FULL=4 +}; + +enum { // encodingID for STBTT_PLATFORM_ID_MICROSOFT + STBTT_MS_EID_SYMBOL =0, + STBTT_MS_EID_UNICODE_BMP =1, + STBTT_MS_EID_SHIFTJIS =2, + STBTT_MS_EID_UNICODE_FULL =10 +}; + +enum { // encodingID for STBTT_PLATFORM_ID_MAC; same as Script Manager codes + STBTT_MAC_EID_ROMAN =0, STBTT_MAC_EID_ARABIC =4, + STBTT_MAC_EID_JAPANESE =1, STBTT_MAC_EID_HEBREW =5, + STBTT_MAC_EID_CHINESE_TRAD =2, STBTT_MAC_EID_GREEK =6, + STBTT_MAC_EID_KOREAN =3, STBTT_MAC_EID_RUSSIAN =7 +}; + +enum { // languageID for STBTT_PLATFORM_ID_MICROSOFT; same as LCID... + // problematic because there are e.g. 16 english LCIDs and 16 arabic LCIDs + STBTT_MS_LANG_ENGLISH =0x0409, STBTT_MS_LANG_ITALIAN =0x0410, + STBTT_MS_LANG_CHINESE =0x0804, STBTT_MS_LANG_JAPANESE =0x0411, + STBTT_MS_LANG_DUTCH =0x0413, STBTT_MS_LANG_KOREAN =0x0412, + STBTT_MS_LANG_FRENCH =0x040c, STBTT_MS_LANG_RUSSIAN =0x0419, + STBTT_MS_LANG_GERMAN =0x0407, STBTT_MS_LANG_SPANISH =0x0409, + STBTT_MS_LANG_HEBREW =0x040d, STBTT_MS_LANG_SWEDISH =0x041D +}; + +enum { // languageID for STBTT_PLATFORM_ID_MAC + STBTT_MAC_LANG_ENGLISH =0 , STBTT_MAC_LANG_JAPANESE =11, + STBTT_MAC_LANG_ARABIC =12, STBTT_MAC_LANG_KOREAN =23, + STBTT_MAC_LANG_DUTCH =4 , STBTT_MAC_LANG_RUSSIAN =32, + STBTT_MAC_LANG_FRENCH =1 , STBTT_MAC_LANG_SPANISH =6 , + STBTT_MAC_LANG_GERMAN =2 , STBTT_MAC_LANG_SWEDISH =5 , + STBTT_MAC_LANG_HEBREW =10, STBTT_MAC_LANG_CHINESE_SIMPLIFIED =33, + STBTT_MAC_LANG_ITALIAN =3 , STBTT_MAC_LANG_CHINESE_TRAD =19 +}; + +#ifdef __cplusplus +} +#endif + +#endif // __STB_INCLUDE_STB_TRUETYPE_H__ + +/////////////////////////////////////////////////////////////////////////////// +/////////////////////////////////////////////////////////////////////////////// +//// +//// IMPLEMENTATION +//// +//// + +#ifdef STB_TRUETYPE_IMPLEMENTATION + +#ifndef STBTT_MAX_OVERSAMPLE +#define STBTT_MAX_OVERSAMPLE 8 +#endif + +#if STBTT_MAX_OVERSAMPLE > 255 +#error "STBTT_MAX_OVERSAMPLE cannot be > 255" +#endif + +typedef int stbtt__test_oversample_pow2[(STBTT_MAX_OVERSAMPLE & (STBTT_MAX_OVERSAMPLE-1)) == 0 ? 1 : -1]; + +#ifndef STBTT_RASTERIZER_VERSION +#define STBTT_RASTERIZER_VERSION 2 +#endif + +#ifdef _MSC_VER +#define STBTT__NOTUSED(v) (void)(v) +#else +#define STBTT__NOTUSED(v) (void)sizeof(v) +#endif + +////////////////////////////////////////////////////////////////////////// +// +// stbtt__buf helpers to parse data from file +// + +static stbtt_uint8 stbtt__buf_get8(stbtt__buf *b) +{ + if (b->cursor >= b->size) + return 0; + return b->data[b->cursor++]; +} + +static stbtt_uint8 stbtt__buf_peek8(stbtt__buf *b) +{ + if (b->cursor >= b->size) + return 0; + return b->data[b->cursor]; +} + +static void stbtt__buf_seek(stbtt__buf *b, int o) +{ + STBTT_assert(!(o > b->size || o < 0)); + b->cursor = (o > b->size || o < 0) ? b->size : o; +} + +static void stbtt__buf_skip(stbtt__buf *b, int o) +{ + stbtt__buf_seek(b, b->cursor + o); +} + +static stbtt_uint32 stbtt__buf_get(stbtt__buf *b, int n) +{ + stbtt_uint32 v = 0; + int i; + STBTT_assert(n >= 1 && n <= 4); + for (i = 0; i < n; i++) + v = (v << 8) | stbtt__buf_get8(b); + return v; +} + +static stbtt__buf stbtt__new_buf(const void *p, size_t size) +{ + stbtt__buf r; + STBTT_assert(size < 0x40000000); + r.data = (stbtt_uint8*) p; + r.size = (int) size; + r.cursor = 0; + return r; +} + +#define stbtt__buf_get16(b) stbtt__buf_get((b), 2) +#define stbtt__buf_get32(b) stbtt__buf_get((b), 4) + +static stbtt__buf stbtt__buf_range(const stbtt__buf *b, int o, int s) +{ + stbtt__buf r = stbtt__new_buf(NULL, 0); + if (o < 0 || s < 0 || o > b->size || s > b->size - o) return r; + r.data = b->data + o; + r.size = s; + return r; +} + +static stbtt__buf stbtt__cff_get_index(stbtt__buf *b) +{ + int count, start, offsize; + start = b->cursor; + count = stbtt__buf_get16(b); + if (count) { + offsize = stbtt__buf_get8(b); + STBTT_assert(offsize >= 1 && offsize <= 4); + stbtt__buf_skip(b, offsize * count); + stbtt__buf_skip(b, stbtt__buf_get(b, offsize) - 1); + } + return stbtt__buf_range(b, start, b->cursor - start); +} + +static stbtt_uint32 stbtt__cff_int(stbtt__buf *b) +{ + int b0 = stbtt__buf_get8(b); + if (b0 >= 32 && b0 <= 246) return b0 - 139; + else if (b0 >= 247 && b0 <= 250) return (b0 - 247)*256 + stbtt__buf_get8(b) + 108; + else if (b0 >= 251 && b0 <= 254) return -(b0 - 251)*256 - stbtt__buf_get8(b) - 108; + else if (b0 == 28) return stbtt__buf_get16(b); + else if (b0 == 29) return stbtt__buf_get32(b); + STBTT_assert(0); + return 0; +} + +static void stbtt__cff_skip_operand(stbtt__buf *b) { + int v, b0 = stbtt__buf_peek8(b); + STBTT_assert(b0 >= 28); + if (b0 == 30) { + stbtt__buf_skip(b, 1); + while (b->cursor < b->size) { + v = stbtt__buf_get8(b); + if ((v & 0xF) == 0xF || (v >> 4) == 0xF) + break; + } + } else { + stbtt__cff_int(b); + } +} + +static stbtt__buf stbtt__dict_get(stbtt__buf *b, int key) +{ + stbtt__buf_seek(b, 0); + while (b->cursor < b->size) { + int start = b->cursor, end, op; + while (stbtt__buf_peek8(b) >= 28) + stbtt__cff_skip_operand(b); + end = b->cursor; + op = stbtt__buf_get8(b); + if (op == 12) op = stbtt__buf_get8(b) | 0x100; + if (op == key) return stbtt__buf_range(b, start, end-start); + } + return stbtt__buf_range(b, 0, 0); +} + +static void stbtt__dict_get_ints(stbtt__buf *b, int key, int outcount, stbtt_uint32 *out) +{ + int i; + stbtt__buf operands = stbtt__dict_get(b, key); + for (i = 0; i < outcount && operands.cursor < operands.size; i++) + out[i] = stbtt__cff_int(&operands); +} + +static int stbtt__cff_index_count(stbtt__buf *b) +{ + stbtt__buf_seek(b, 0); + return stbtt__buf_get16(b); +} + +static stbtt__buf stbtt__cff_index_get(stbtt__buf b, int i) +{ + int count, offsize, start, end; + stbtt__buf_seek(&b, 0); + count = stbtt__buf_get16(&b); + offsize = stbtt__buf_get8(&b); + STBTT_assert(i >= 0 && i < count); + STBTT_assert(offsize >= 1 && offsize <= 4); + stbtt__buf_skip(&b, i*offsize); + start = stbtt__buf_get(&b, offsize); + end = stbtt__buf_get(&b, offsize); + return stbtt__buf_range(&b, 2+(count+1)*offsize+start, end - start); +} + +////////////////////////////////////////////////////////////////////////// +// +// accessors to parse data from file +// + +// on platforms that don't allow misaligned reads, if we want to allow +// truetype fonts that aren't padded to alignment, define ALLOW_UNALIGNED_TRUETYPE + +#define ttBYTE(p) (* (stbtt_uint8 *) (p)) +#define ttCHAR(p) (* (stbtt_int8 *) (p)) +#define ttFixed(p) ttLONG(p) + +static stbtt_uint16 ttUSHORT(stbtt_uint8 *p) { return p[0]*256 + p[1]; } +static stbtt_int16 ttSHORT(stbtt_uint8 *p) { return p[0]*256 + p[1]; } +static stbtt_uint32 ttULONG(stbtt_uint8 *p) { return (p[0]<<24) + (p[1]<<16) + (p[2]<<8) + p[3]; } +static stbtt_int32 ttLONG(stbtt_uint8 *p) { return (p[0]<<24) + (p[1]<<16) + (p[2]<<8) + p[3]; } + +#define stbtt_tag4(p,c0,c1,c2,c3) ((p)[0] == (c0) && (p)[1] == (c1) && (p)[2] == (c2) && (p)[3] == (c3)) +#define stbtt_tag(p,str) stbtt_tag4(p,str[0],str[1],str[2],str[3]) + +static int stbtt__isfont(stbtt_uint8 *font) +{ + // check the version number + if (stbtt_tag4(font, '1',0,0,0)) return 1; // TrueType 1 + if (stbtt_tag(font, "typ1")) return 1; // TrueType with type 1 font -- we don't support this! + if (stbtt_tag(font, "OTTO")) return 1; // OpenType with CFF + if (stbtt_tag4(font, 0,1,0,0)) return 1; // OpenType 1.0 + if (stbtt_tag(font, "true")) return 1; // Apple specification for TrueType fonts + return 0; +} + +// @OPTIMIZE: binary search +static stbtt_uint32 stbtt__find_table(stbtt_uint8 *data, stbtt_uint32 fontstart, const char *tag) +{ + stbtt_int32 num_tables = ttUSHORT(data+fontstart+4); + stbtt_uint32 tabledir = fontstart + 12; + stbtt_int32 i; + for (i=0; i < num_tables; ++i) { + stbtt_uint32 loc = tabledir + 16*i; + if (stbtt_tag(data+loc+0, tag)) + return ttULONG(data+loc+8); + } + return 0; +} + +static int stbtt_GetFontOffsetForIndex_internal(unsigned char *font_collection, int index) +{ + // if it's just a font, there's only one valid index + if (stbtt__isfont(font_collection)) + return index == 0 ? 0 : -1; + + // check if it's a TTC + if (stbtt_tag(font_collection, "ttcf")) { + // version 1? + if (ttULONG(font_collection+4) == 0x00010000 || ttULONG(font_collection+4) == 0x00020000) { + stbtt_int32 n = ttLONG(font_collection+8); + if (index >= n) + return -1; + return ttULONG(font_collection+12+index*4); + } + } + return -1; +} + +static int stbtt_GetNumberOfFonts_internal(unsigned char *font_collection) +{ + // if it's just a font, there's only one valid font + if (stbtt__isfont(font_collection)) + return 1; + + // check if it's a TTC + if (stbtt_tag(font_collection, "ttcf")) { + // version 1? + if (ttULONG(font_collection+4) == 0x00010000 || ttULONG(font_collection+4) == 0x00020000) { + return ttLONG(font_collection+8); + } + } + return 0; +} + +static stbtt__buf stbtt__get_subrs(stbtt__buf cff, stbtt__buf fontdict) +{ + stbtt_uint32 subrsoff = 0, private_loc[2] = { 0, 0 }; + stbtt__buf pdict; + stbtt__dict_get_ints(&fontdict, 18, 2, private_loc); + if (!private_loc[1] || !private_loc[0]) return stbtt__new_buf(NULL, 0); + pdict = stbtt__buf_range(&cff, private_loc[1], private_loc[0]); + stbtt__dict_get_ints(&pdict, 19, 1, &subrsoff); + if (!subrsoff) return stbtt__new_buf(NULL, 0); + stbtt__buf_seek(&cff, private_loc[1]+subrsoff); + return stbtt__cff_get_index(&cff); +} + +// since most people won't use this, find this table the first time it's needed +static int stbtt__get_svg(stbtt_fontinfo *info) +{ + stbtt_uint32 t; + if (info->svg < 0) { + t = stbtt__find_table(info->data, info->fontstart, "SVG "); + if (t) { + stbtt_uint32 offset = ttULONG(info->data + t + 2); + info->svg = t + offset; + } else { + info->svg = 0; + } + } + return info->svg; +} + +static int stbtt_InitFont_internal(stbtt_fontinfo *info, unsigned char *data, int fontstart) +{ + stbtt_uint32 cmap, t; + stbtt_int32 i,numTables; + + info->data = data; + info->fontstart = fontstart; + info->cff = stbtt__new_buf(NULL, 0); + + cmap = stbtt__find_table(data, fontstart, "cmap"); // required + info->loca = stbtt__find_table(data, fontstart, "loca"); // required + info->head = stbtt__find_table(data, fontstart, "head"); // required + info->glyf = stbtt__find_table(data, fontstart, "glyf"); // required + info->hhea = stbtt__find_table(data, fontstart, "hhea"); // required + info->hmtx = stbtt__find_table(data, fontstart, "hmtx"); // required + info->kern = stbtt__find_table(data, fontstart, "kern"); // not required + info->gpos = stbtt__find_table(data, fontstart, "GPOS"); // not required + + if (!cmap || !info->head || !info->hhea || !info->hmtx) + return 0; + if (info->glyf) { + // required for truetype + if (!info->loca) return 0; + } else { + // initialization for CFF / Type2 fonts (OTF) + stbtt__buf b, topdict, topdictidx; + stbtt_uint32 cstype = 2, charstrings = 0, fdarrayoff = 0, fdselectoff = 0; + stbtt_uint32 cff; + + cff = stbtt__find_table(data, fontstart, "CFF "); + if (!cff) return 0; + + info->fontdicts = stbtt__new_buf(NULL, 0); + info->fdselect = stbtt__new_buf(NULL, 0); + + // @TODO this should use size from table (not 512MB) + info->cff = stbtt__new_buf(data+cff, 512*1024*1024); + b = info->cff; + + // read the header + stbtt__buf_skip(&b, 2); + stbtt__buf_seek(&b, stbtt__buf_get8(&b)); // hdrsize + + // @TODO the name INDEX could list multiple fonts, + // but we just use the first one. + stbtt__cff_get_index(&b); // name INDEX + topdictidx = stbtt__cff_get_index(&b); + topdict = stbtt__cff_index_get(topdictidx, 0); + stbtt__cff_get_index(&b); // string INDEX + info->gsubrs = stbtt__cff_get_index(&b); + + stbtt__dict_get_ints(&topdict, 17, 1, &charstrings); + stbtt__dict_get_ints(&topdict, 0x100 | 6, 1, &cstype); + stbtt__dict_get_ints(&topdict, 0x100 | 36, 1, &fdarrayoff); + stbtt__dict_get_ints(&topdict, 0x100 | 37, 1, &fdselectoff); + info->subrs = stbtt__get_subrs(b, topdict); + + // we only support Type 2 charstrings + if (cstype != 2) return 0; + if (charstrings == 0) return 0; + + if (fdarrayoff) { + // looks like a CID font + if (!fdselectoff) return 0; + stbtt__buf_seek(&b, fdarrayoff); + info->fontdicts = stbtt__cff_get_index(&b); + info->fdselect = stbtt__buf_range(&b, fdselectoff, b.size-fdselectoff); + } + + stbtt__buf_seek(&b, charstrings); + info->charstrings = stbtt__cff_get_index(&b); + } + + t = stbtt__find_table(data, fontstart, "maxp"); + if (t) + info->numGlyphs = ttUSHORT(data+t+4); + else + info->numGlyphs = 0xffff; + + info->svg = -1; + + // find a cmap encoding table we understand *now* to avoid searching + // later. (todo: could make this installable) + // the same regardless of glyph. + numTables = ttUSHORT(data + cmap + 2); + info->index_map = 0; + for (i=0; i < numTables; ++i) { + stbtt_uint32 encoding_record = cmap + 4 + 8 * i; + // find an encoding we understand: + switch(ttUSHORT(data+encoding_record)) { + case STBTT_PLATFORM_ID_MICROSOFT: + switch (ttUSHORT(data+encoding_record+2)) { + case STBTT_MS_EID_UNICODE_BMP: + case STBTT_MS_EID_UNICODE_FULL: + // MS/Unicode + info->index_map = cmap + ttULONG(data+encoding_record+4); + break; + } + break; + case STBTT_PLATFORM_ID_UNICODE: + // Mac/iOS has these + // all the encodingIDs are unicode, so we don't bother to check it + info->index_map = cmap + ttULONG(data+encoding_record+4); + break; + } + } + if (info->index_map == 0) + return 0; + + info->indexToLocFormat = ttUSHORT(data+info->head + 50); + return 1; +} + +STBTT_DEF int stbtt_FindGlyphIndex(const stbtt_fontinfo *info, int unicode_codepoint) +{ + stbtt_uint8 *data = info->data; + stbtt_uint32 index_map = info->index_map; + + stbtt_uint16 format = ttUSHORT(data + index_map + 0); + if (format == 0) { // apple byte encoding + stbtt_int32 bytes = ttUSHORT(data + index_map + 2); + if (unicode_codepoint < bytes-6) + return ttBYTE(data + index_map + 6 + unicode_codepoint); + return 0; + } else if (format == 6) { + stbtt_uint32 first = ttUSHORT(data + index_map + 6); + stbtt_uint32 count = ttUSHORT(data + index_map + 8); + if ((stbtt_uint32) unicode_codepoint >= first && (stbtt_uint32) unicode_codepoint < first+count) + return ttUSHORT(data + index_map + 10 + (unicode_codepoint - first)*2); + return 0; + } else if (format == 2) { + STBTT_assert(0); // @TODO: high-byte mapping for japanese/chinese/korean + return 0; + } else if (format == 4) { // standard mapping for windows fonts: binary search collection of ranges + stbtt_uint16 segcount = ttUSHORT(data+index_map+6) >> 1; + stbtt_uint16 searchRange = ttUSHORT(data+index_map+8) >> 1; + stbtt_uint16 entrySelector = ttUSHORT(data+index_map+10); + stbtt_uint16 rangeShift = ttUSHORT(data+index_map+12) >> 1; + + // do a binary search of the segments + stbtt_uint32 endCount = index_map + 14; + stbtt_uint32 search = endCount; + + if (unicode_codepoint > 0xffff) + return 0; + + // they lie from endCount .. endCount + segCount + // but searchRange is the nearest power of two, so... + if (unicode_codepoint >= ttUSHORT(data + search + rangeShift*2)) + search += rangeShift*2; + + // now decrement to bias correctly to find smallest + search -= 2; + while (entrySelector) { + stbtt_uint16 end; + searchRange >>= 1; + end = ttUSHORT(data + search + searchRange*2); + if (unicode_codepoint > end) + search += searchRange*2; + --entrySelector; + } + search += 2; + + { + stbtt_uint16 offset, start, last; + stbtt_uint16 item = (stbtt_uint16) ((search - endCount) >> 1); + + start = ttUSHORT(data + index_map + 14 + segcount*2 + 2 + 2*item); + last = ttUSHORT(data + endCount + 2*item); + if (unicode_codepoint < start || unicode_codepoint > last) + return 0; + + offset = ttUSHORT(data + index_map + 14 + segcount*6 + 2 + 2*item); + if (offset == 0) + return (stbtt_uint16) (unicode_codepoint + ttSHORT(data + index_map + 14 + segcount*4 + 2 + 2*item)); + + return ttUSHORT(data + offset + (unicode_codepoint-start)*2 + index_map + 14 + segcount*6 + 2 + 2*item); + } + } else if (format == 12 || format == 13) { + stbtt_uint32 ngroups = ttULONG(data+index_map+12); + stbtt_int32 low,high; + low = 0; high = (stbtt_int32)ngroups; + // Binary search the right group. + while (low < high) { + stbtt_int32 mid = low + ((high-low) >> 1); // rounds down, so low <= mid < high + stbtt_uint32 start_char = ttULONG(data+index_map+16+mid*12); + stbtt_uint32 end_char = ttULONG(data+index_map+16+mid*12+4); + if ((stbtt_uint32) unicode_codepoint < start_char) + high = mid; + else if ((stbtt_uint32) unicode_codepoint > end_char) + low = mid+1; + else { + stbtt_uint32 start_glyph = ttULONG(data+index_map+16+mid*12+8); + if (format == 12) + return start_glyph + unicode_codepoint-start_char; + else // format == 13 + return start_glyph; + } + } + return 0; // not found + } + // @TODO + STBTT_assert(0); + return 0; +} + +STBTT_DEF int stbtt_GetCodepointShape(const stbtt_fontinfo *info, int unicode_codepoint, stbtt_vertex **vertices) +{ + return stbtt_GetGlyphShape(info, stbtt_FindGlyphIndex(info, unicode_codepoint), vertices); +} + +static void stbtt_setvertex(stbtt_vertex *v, stbtt_uint8 type, stbtt_int32 x, stbtt_int32 y, stbtt_int32 cx, stbtt_int32 cy) +{ + v->type = type; + v->x = (stbtt_int16) x; + v->y = (stbtt_int16) y; + v->cx = (stbtt_int16) cx; + v->cy = (stbtt_int16) cy; +} + +static int stbtt__GetGlyfOffset(const stbtt_fontinfo *info, int glyph_index) +{ + int g1,g2; + + STBTT_assert(!info->cff.size); + + if (glyph_index >= info->numGlyphs) return -1; // glyph index out of range + if (info->indexToLocFormat >= 2) return -1; // unknown index->glyph map format + + if (info->indexToLocFormat == 0) { + g1 = info->glyf + ttUSHORT(info->data + info->loca + glyph_index * 2) * 2; + g2 = info->glyf + ttUSHORT(info->data + info->loca + glyph_index * 2 + 2) * 2; + } else { + g1 = info->glyf + ttULONG (info->data + info->loca + glyph_index * 4); + g2 = info->glyf + ttULONG (info->data + info->loca + glyph_index * 4 + 4); + } + + return g1==g2 ? -1 : g1; // if length is 0, return -1 +} + +static int stbtt__GetGlyphInfoT2(const stbtt_fontinfo *info, int glyph_index, int *x0, int *y0, int *x1, int *y1); + +STBTT_DEF int stbtt_GetGlyphBox(const stbtt_fontinfo *info, int glyph_index, int *x0, int *y0, int *x1, int *y1) +{ + if (info->cff.size) { + stbtt__GetGlyphInfoT2(info, glyph_index, x0, y0, x1, y1); + } else { + int g = stbtt__GetGlyfOffset(info, glyph_index); + if (g < 0) return 0; + + if (x0) *x0 = ttSHORT(info->data + g + 2); + if (y0) *y0 = ttSHORT(info->data + g + 4); + if (x1) *x1 = ttSHORT(info->data + g + 6); + if (y1) *y1 = ttSHORT(info->data + g + 8); + } + return 1; +} + +STBTT_DEF int stbtt_GetCodepointBox(const stbtt_fontinfo *info, int codepoint, int *x0, int *y0, int *x1, int *y1) +{ + return stbtt_GetGlyphBox(info, stbtt_FindGlyphIndex(info,codepoint), x0,y0,x1,y1); +} + +STBTT_DEF int stbtt_IsGlyphEmpty(const stbtt_fontinfo *info, int glyph_index) +{ + stbtt_int16 numberOfContours; + int g; + if (info->cff.size) + return stbtt__GetGlyphInfoT2(info, glyph_index, NULL, NULL, NULL, NULL) == 0; + g = stbtt__GetGlyfOffset(info, glyph_index); + if (g < 0) return 1; + numberOfContours = ttSHORT(info->data + g); + return numberOfContours == 0; +} + +static int stbtt__close_shape(stbtt_vertex *vertices, int num_vertices, int was_off, int start_off, + stbtt_int32 sx, stbtt_int32 sy, stbtt_int32 scx, stbtt_int32 scy, stbtt_int32 cx, stbtt_int32 cy) +{ + if (start_off) { + if (was_off) + stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve, (cx+scx)>>1, (cy+scy)>>1, cx,cy); + stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve, sx,sy,scx,scy); + } else { + if (was_off) + stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve,sx,sy,cx,cy); + else + stbtt_setvertex(&vertices[num_vertices++], STBTT_vline,sx,sy,0,0); + } + return num_vertices; +} + +static int stbtt__GetGlyphShapeTT(const stbtt_fontinfo *info, int glyph_index, stbtt_vertex **pvertices) +{ + stbtt_int16 numberOfContours; + stbtt_uint8 *endPtsOfContours; + stbtt_uint8 *data = info->data; + stbtt_vertex *vertices=0; + int num_vertices=0; + int g = stbtt__GetGlyfOffset(info, glyph_index); + + *pvertices = NULL; + + if (g < 0) return 0; + + numberOfContours = ttSHORT(data + g); + + if (numberOfContours > 0) { + stbtt_uint8 flags=0,flagcount; + stbtt_int32 ins, i,j=0,m,n, next_move, was_off=0, off, start_off=0; + stbtt_int32 x,y,cx,cy,sx,sy, scx,scy; + stbtt_uint8 *points; + endPtsOfContours = (data + g + 10); + ins = ttUSHORT(data + g + 10 + numberOfContours * 2); + points = data + g + 10 + numberOfContours * 2 + 2 + ins; + + n = 1+ttUSHORT(endPtsOfContours + numberOfContours*2-2); + + m = n + 2*numberOfContours; // a loose bound on how many vertices we might need + vertices = (stbtt_vertex *) STBTT_malloc(m * sizeof(vertices[0]), info->userdata); + if (vertices == 0) + return 0; + + next_move = 0; + flagcount=0; + + // in first pass, we load uninterpreted data into the allocated array + // above, shifted to the end of the array so we won't overwrite it when + // we create our final data starting from the front + + off = m - n; // starting offset for uninterpreted data, regardless of how m ends up being calculated + + // first load flags + + for (i=0; i < n; ++i) { + if (flagcount == 0) { + flags = *points++; + if (flags & 8) + flagcount = *points++; + } else + --flagcount; + vertices[off+i].type = flags; + } + + // now load x coordinates + x=0; + for (i=0; i < n; ++i) { + flags = vertices[off+i].type; + if (flags & 2) { + stbtt_int16 dx = *points++; + x += (flags & 16) ? dx : -dx; // ??? + } else { + if (!(flags & 16)) { + x = x + (stbtt_int16) (points[0]*256 + points[1]); + points += 2; + } + } + vertices[off+i].x = (stbtt_int16) x; + } + + // now load y coordinates + y=0; + for (i=0; i < n; ++i) { + flags = vertices[off+i].type; + if (flags & 4) { + stbtt_int16 dy = *points++; + y += (flags & 32) ? dy : -dy; // ??? + } else { + if (!(flags & 32)) { + y = y + (stbtt_int16) (points[0]*256 + points[1]); + points += 2; + } + } + vertices[off+i].y = (stbtt_int16) y; + } + + // now convert them to our format + num_vertices=0; + sx = sy = cx = cy = scx = scy = 0; + for (i=0; i < n; ++i) { + flags = vertices[off+i].type; + x = (stbtt_int16) vertices[off+i].x; + y = (stbtt_int16) vertices[off+i].y; + + if (next_move == i) { + if (i != 0) + num_vertices = stbtt__close_shape(vertices, num_vertices, was_off, start_off, sx,sy,scx,scy,cx,cy); + + // now start the new one + start_off = !(flags & 1); + if (start_off) { + // if we start off with an off-curve point, then when we need to find a point on the curve + // where we can start, and we need to save some state for when we wraparound. + scx = x; + scy = y; + if (!(vertices[off+i+1].type & 1)) { + // next point is also a curve point, so interpolate an on-point curve + sx = (x + (stbtt_int32) vertices[off+i+1].x) >> 1; + sy = (y + (stbtt_int32) vertices[off+i+1].y) >> 1; + } else { + // otherwise just use the next point as our start point + sx = (stbtt_int32) vertices[off+i+1].x; + sy = (stbtt_int32) vertices[off+i+1].y; + ++i; // we're using point i+1 as the starting point, so skip it + } + } else { + sx = x; + sy = y; + } + stbtt_setvertex(&vertices[num_vertices++], STBTT_vmove,sx,sy,0,0); + was_off = 0; + next_move = 1 + ttUSHORT(endPtsOfContours+j*2); + ++j; + } else { + if (!(flags & 1)) { // if it's a curve + if (was_off) // two off-curve control points in a row means interpolate an on-curve midpoint + stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve, (cx+x)>>1, (cy+y)>>1, cx, cy); + cx = x; + cy = y; + was_off = 1; + } else { + if (was_off) + stbtt_setvertex(&vertices[num_vertices++], STBTT_vcurve, x,y, cx, cy); + else + stbtt_setvertex(&vertices[num_vertices++], STBTT_vline, x,y,0,0); + was_off = 0; + } + } + } + num_vertices = stbtt__close_shape(vertices, num_vertices, was_off, start_off, sx,sy,scx,scy,cx,cy); + } else if (numberOfContours < 0) { + // Compound shapes. + int more = 1; + stbtt_uint8 *comp = data + g + 10; + num_vertices = 0; + vertices = 0; + while (more) { + stbtt_uint16 flags, gidx; + int comp_num_verts = 0, i; + stbtt_vertex *comp_verts = 0, *tmp = 0; + float mtx[6] = {1,0,0,1,0,0}, m, n; + + flags = ttSHORT(comp); comp+=2; + gidx = ttSHORT(comp); comp+=2; + + if (flags & 2) { // XY values + if (flags & 1) { // shorts + mtx[4] = ttSHORT(comp); comp+=2; + mtx[5] = ttSHORT(comp); comp+=2; + } else { + mtx[4] = ttCHAR(comp); comp+=1; + mtx[5] = ttCHAR(comp); comp+=1; + } + } + else { + // @TODO handle matching point + STBTT_assert(0); + } + if (flags & (1<<3)) { // WE_HAVE_A_SCALE + mtx[0] = mtx[3] = ttSHORT(comp)/16384.0f; comp+=2; + mtx[1] = mtx[2] = 0; + } else if (flags & (1<<6)) { // WE_HAVE_AN_X_AND_YSCALE + mtx[0] = ttSHORT(comp)/16384.0f; comp+=2; + mtx[1] = mtx[2] = 0; + mtx[3] = ttSHORT(comp)/16384.0f; comp+=2; + } else if (flags & (1<<7)) { // WE_HAVE_A_TWO_BY_TWO + mtx[0] = ttSHORT(comp)/16384.0f; comp+=2; + mtx[1] = ttSHORT(comp)/16384.0f; comp+=2; + mtx[2] = ttSHORT(comp)/16384.0f; comp+=2; + mtx[3] = ttSHORT(comp)/16384.0f; comp+=2; + } + + // Find transformation scales. + m = (float) STBTT_sqrt(mtx[0]*mtx[0] + mtx[1]*mtx[1]); + n = (float) STBTT_sqrt(mtx[2]*mtx[2] + mtx[3]*mtx[3]); + + // Get indexed glyph. + comp_num_verts = stbtt_GetGlyphShape(info, gidx, &comp_verts); + if (comp_num_verts > 0) { + // Transform vertices. + for (i = 0; i < comp_num_verts; ++i) { + stbtt_vertex* v = &comp_verts[i]; + stbtt_vertex_type x,y; + x=v->x; y=v->y; + v->x = (stbtt_vertex_type)(m * (mtx[0]*x + mtx[2]*y + mtx[4])); + v->y = (stbtt_vertex_type)(n * (mtx[1]*x + mtx[3]*y + mtx[5])); + x=v->cx; y=v->cy; + v->cx = (stbtt_vertex_type)(m * (mtx[0]*x + mtx[2]*y + mtx[4])); + v->cy = (stbtt_vertex_type)(n * (mtx[1]*x + mtx[3]*y + mtx[5])); + } + // Append vertices. + tmp = (stbtt_vertex*)STBTT_malloc((num_vertices+comp_num_verts)*sizeof(stbtt_vertex), info->userdata); + if (!tmp) { + if (vertices) STBTT_free(vertices, info->userdata); + if (comp_verts) STBTT_free(comp_verts, info->userdata); + return 0; + } + if (num_vertices > 0 && vertices) STBTT_memcpy(tmp, vertices, num_vertices*sizeof(stbtt_vertex)); + STBTT_memcpy(tmp+num_vertices, comp_verts, comp_num_verts*sizeof(stbtt_vertex)); + if (vertices) STBTT_free(vertices, info->userdata); + vertices = tmp; + STBTT_free(comp_verts, info->userdata); + num_vertices += comp_num_verts; + } + // More components ? + more = flags & (1<<5); + } + } else { + // numberOfCounters == 0, do nothing + } + + *pvertices = vertices; + return num_vertices; +} + +typedef struct +{ + int bounds; + int started; + float first_x, first_y; + float x, y; + stbtt_int32 min_x, max_x, min_y, max_y; + + stbtt_vertex *pvertices; + int num_vertices; +} stbtt__csctx; + +#define STBTT__CSCTX_INIT(bounds) {bounds,0, 0,0, 0,0, 0,0,0,0, NULL, 0} + +static void stbtt__track_vertex(stbtt__csctx *c, stbtt_int32 x, stbtt_int32 y) +{ + if (x > c->max_x || !c->started) c->max_x = x; + if (y > c->max_y || !c->started) c->max_y = y; + if (x < c->min_x || !c->started) c->min_x = x; + if (y < c->min_y || !c->started) c->min_y = y; + c->started = 1; +} + +static void stbtt__csctx_v(stbtt__csctx *c, stbtt_uint8 type, stbtt_int32 x, stbtt_int32 y, stbtt_int32 cx, stbtt_int32 cy, stbtt_int32 cx1, stbtt_int32 cy1) +{ + if (c->bounds) { + stbtt__track_vertex(c, x, y); + if (type == STBTT_vcubic) { + stbtt__track_vertex(c, cx, cy); + stbtt__track_vertex(c, cx1, cy1); + } + } else { + stbtt_setvertex(&c->pvertices[c->num_vertices], type, x, y, cx, cy); + c->pvertices[c->num_vertices].cx1 = (stbtt_int16) cx1; + c->pvertices[c->num_vertices].cy1 = (stbtt_int16) cy1; + } + c->num_vertices++; +} + +static void stbtt__csctx_close_shape(stbtt__csctx *ctx) +{ + if (ctx->first_x != ctx->x || ctx->first_y != ctx->y) + stbtt__csctx_v(ctx, STBTT_vline, (int)ctx->first_x, (int)ctx->first_y, 0, 0, 0, 0); +} + +static void stbtt__csctx_rmove_to(stbtt__csctx *ctx, float dx, float dy) +{ + stbtt__csctx_close_shape(ctx); + ctx->first_x = ctx->x = ctx->x + dx; + ctx->first_y = ctx->y = ctx->y + dy; + stbtt__csctx_v(ctx, STBTT_vmove, (int)ctx->x, (int)ctx->y, 0, 0, 0, 0); +} + +static void stbtt__csctx_rline_to(stbtt__csctx *ctx, float dx, float dy) +{ + ctx->x += dx; + ctx->y += dy; + stbtt__csctx_v(ctx, STBTT_vline, (int)ctx->x, (int)ctx->y, 0, 0, 0, 0); +} + +static void stbtt__csctx_rccurve_to(stbtt__csctx *ctx, float dx1, float dy1, float dx2, float dy2, float dx3, float dy3) +{ + float cx1 = ctx->x + dx1; + float cy1 = ctx->y + dy1; + float cx2 = cx1 + dx2; + float cy2 = cy1 + dy2; + ctx->x = cx2 + dx3; + ctx->y = cy2 + dy3; + stbtt__csctx_v(ctx, STBTT_vcubic, (int)ctx->x, (int)ctx->y, (int)cx1, (int)cy1, (int)cx2, (int)cy2); +} + +static stbtt__buf stbtt__get_subr(stbtt__buf idx, int n) +{ + int count = stbtt__cff_index_count(&idx); + int bias = 107; + if (count >= 33900) + bias = 32768; + else if (count >= 1240) + bias = 1131; + n += bias; + if (n < 0 || n >= count) + return stbtt__new_buf(NULL, 0); + return stbtt__cff_index_get(idx, n); +} + +static stbtt__buf stbtt__cid_get_glyph_subrs(const stbtt_fontinfo *info, int glyph_index) +{ + stbtt__buf fdselect = info->fdselect; + int nranges, start, end, v, fmt, fdselector = -1, i; + + stbtt__buf_seek(&fdselect, 0); + fmt = stbtt__buf_get8(&fdselect); + if (fmt == 0) { + // untested + stbtt__buf_skip(&fdselect, glyph_index); + fdselector = stbtt__buf_get8(&fdselect); + } else if (fmt == 3) { + nranges = stbtt__buf_get16(&fdselect); + start = stbtt__buf_get16(&fdselect); + for (i = 0; i < nranges; i++) { + v = stbtt__buf_get8(&fdselect); + end = stbtt__buf_get16(&fdselect); + if (glyph_index >= start && glyph_index < end) { + fdselector = v; + break; + } + start = end; + } + } + if (fdselector == -1) stbtt__new_buf(NULL, 0); + return stbtt__get_subrs(info->cff, stbtt__cff_index_get(info->fontdicts, fdselector)); +} + +static int stbtt__run_charstring(const stbtt_fontinfo *info, int glyph_index, stbtt__csctx *c) +{ + int in_header = 1, maskbits = 0, subr_stack_height = 0, sp = 0, v, i, b0; + int has_subrs = 0, clear_stack; + float s[48]; + stbtt__buf subr_stack[10], subrs = info->subrs, b; + float f; + +#define STBTT__CSERR(s) (0) + + // this currently ignores the initial width value, which isn't needed if we have hmtx + b = stbtt__cff_index_get(info->charstrings, glyph_index); + while (b.cursor < b.size) { + i = 0; + clear_stack = 1; + b0 = stbtt__buf_get8(&b); + switch (b0) { + // @TODO implement hinting + case 0x13: // hintmask + case 0x14: // cntrmask + if (in_header) + maskbits += (sp / 2); // implicit "vstem" + in_header = 0; + stbtt__buf_skip(&b, (maskbits + 7) / 8); + break; + + case 0x01: // hstem + case 0x03: // vstem + case 0x12: // hstemhm + case 0x17: // vstemhm + maskbits += (sp / 2); + break; + + case 0x15: // rmoveto + in_header = 0; + if (sp < 2) return STBTT__CSERR("rmoveto stack"); + stbtt__csctx_rmove_to(c, s[sp-2], s[sp-1]); + break; + case 0x04: // vmoveto + in_header = 0; + if (sp < 1) return STBTT__CSERR("vmoveto stack"); + stbtt__csctx_rmove_to(c, 0, s[sp-1]); + break; + case 0x16: // hmoveto + in_header = 0; + if (sp < 1) return STBTT__CSERR("hmoveto stack"); + stbtt__csctx_rmove_to(c, s[sp-1], 0); + break; + + case 0x05: // rlineto + if (sp < 2) return STBTT__CSERR("rlineto stack"); + for (; i + 1 < sp; i += 2) + stbtt__csctx_rline_to(c, s[i], s[i+1]); + break; + + // hlineto/vlineto and vhcurveto/hvcurveto alternate horizontal and vertical + // starting from a different place. + + case 0x07: // vlineto + if (sp < 1) return STBTT__CSERR("vlineto stack"); + goto vlineto; + case 0x06: // hlineto + if (sp < 1) return STBTT__CSERR("hlineto stack"); + for (;;) { + if (i >= sp) break; + stbtt__csctx_rline_to(c, s[i], 0); + i++; + vlineto: + if (i >= sp) break; + stbtt__csctx_rline_to(c, 0, s[i]); + i++; + } + break; + + case 0x1F: // hvcurveto + if (sp < 4) return STBTT__CSERR("hvcurveto stack"); + goto hvcurveto; + case 0x1E: // vhcurveto + if (sp < 4) return STBTT__CSERR("vhcurveto stack"); + for (;;) { + if (i + 3 >= sp) break; + stbtt__csctx_rccurve_to(c, 0, s[i], s[i+1], s[i+2], s[i+3], (sp - i == 5) ? s[i + 4] : 0.0f); + i += 4; + hvcurveto: + if (i + 3 >= sp) break; + stbtt__csctx_rccurve_to(c, s[i], 0, s[i+1], s[i+2], (sp - i == 5) ? s[i+4] : 0.0f, s[i+3]); + i += 4; + } + break; + + case 0x08: // rrcurveto + if (sp < 6) return STBTT__CSERR("rcurveline stack"); + for (; i + 5 < sp; i += 6) + stbtt__csctx_rccurve_to(c, s[i], s[i+1], s[i+2], s[i+3], s[i+4], s[i+5]); + break; + + case 0x18: // rcurveline + if (sp < 8) return STBTT__CSERR("rcurveline stack"); + for (; i + 5 < sp - 2; i += 6) + stbtt__csctx_rccurve_to(c, s[i], s[i+1], s[i+2], s[i+3], s[i+4], s[i+5]); + if (i + 1 >= sp) return STBTT__CSERR("rcurveline stack"); + stbtt__csctx_rline_to(c, s[i], s[i+1]); + break; + + case 0x19: // rlinecurve + if (sp < 8) return STBTT__CSERR("rlinecurve stack"); + for (; i + 1 < sp - 6; i += 2) + stbtt__csctx_rline_to(c, s[i], s[i+1]); + if (i + 5 >= sp) return STBTT__CSERR("rlinecurve stack"); + stbtt__csctx_rccurve_to(c, s[i], s[i+1], s[i+2], s[i+3], s[i+4], s[i+5]); + break; + + case 0x1A: // vvcurveto + case 0x1B: // hhcurveto + if (sp < 4) return STBTT__CSERR("(vv|hh)curveto stack"); + f = 0.0; + if (sp & 1) { f = s[i]; i++; } + for (; i + 3 < sp; i += 4) { + if (b0 == 0x1B) + stbtt__csctx_rccurve_to(c, s[i], f, s[i+1], s[i+2], s[i+3], 0.0); + else + stbtt__csctx_rccurve_to(c, f, s[i], s[i+1], s[i+2], 0.0, s[i+3]); + f = 0.0; + } + break; + + case 0x0A: // callsubr + if (!has_subrs) { + if (info->fdselect.size) + subrs = stbtt__cid_get_glyph_subrs(info, glyph_index); + has_subrs = 1; + } + // FALLTHROUGH + case 0x1D: // callgsubr + if (sp < 1) return STBTT__CSERR("call(g|)subr stack"); + v = (int) s[--sp]; + if (subr_stack_height >= 10) return STBTT__CSERR("recursion limit"); + subr_stack[subr_stack_height++] = b; + b = stbtt__get_subr(b0 == 0x0A ? subrs : info->gsubrs, v); + if (b.size == 0) return STBTT__CSERR("subr not found"); + b.cursor = 0; + clear_stack = 0; + break; + + case 0x0B: // return + if (subr_stack_height <= 0) return STBTT__CSERR("return outside subr"); + b = subr_stack[--subr_stack_height]; + clear_stack = 0; + break; + + case 0x0E: // endchar + stbtt__csctx_close_shape(c); + return 1; + + case 0x0C: { // two-byte escape + float dx1, dx2, dx3, dx4, dx5, dx6, dy1, dy2, dy3, dy4, dy5, dy6; + float dx, dy; + int b1 = stbtt__buf_get8(&b); + switch (b1) { + // @TODO These "flex" implementations ignore the flex-depth and resolution, + // and always draw beziers. + case 0x22: // hflex + if (sp < 7) return STBTT__CSERR("hflex stack"); + dx1 = s[0]; + dx2 = s[1]; + dy2 = s[2]; + dx3 = s[3]; + dx4 = s[4]; + dx5 = s[5]; + dx6 = s[6]; + stbtt__csctx_rccurve_to(c, dx1, 0, dx2, dy2, dx3, 0); + stbtt__csctx_rccurve_to(c, dx4, 0, dx5, -dy2, dx6, 0); + break; + + case 0x23: // flex + if (sp < 13) return STBTT__CSERR("flex stack"); + dx1 = s[0]; + dy1 = s[1]; + dx2 = s[2]; + dy2 = s[3]; + dx3 = s[4]; + dy3 = s[5]; + dx4 = s[6]; + dy4 = s[7]; + dx5 = s[8]; + dy5 = s[9]; + dx6 = s[10]; + dy6 = s[11]; + //fd is s[12] + stbtt__csctx_rccurve_to(c, dx1, dy1, dx2, dy2, dx3, dy3); + stbtt__csctx_rccurve_to(c, dx4, dy4, dx5, dy5, dx6, dy6); + break; + + case 0x24: // hflex1 + if (sp < 9) return STBTT__CSERR("hflex1 stack"); + dx1 = s[0]; + dy1 = s[1]; + dx2 = s[2]; + dy2 = s[3]; + dx3 = s[4]; + dx4 = s[5]; + dx5 = s[6]; + dy5 = s[7]; + dx6 = s[8]; + stbtt__csctx_rccurve_to(c, dx1, dy1, dx2, dy2, dx3, 0); + stbtt__csctx_rccurve_to(c, dx4, 0, dx5, dy5, dx6, -(dy1+dy2+dy5)); + break; + + case 0x25: // flex1 + if (sp < 11) return STBTT__CSERR("flex1 stack"); + dx1 = s[0]; + dy1 = s[1]; + dx2 = s[2]; + dy2 = s[3]; + dx3 = s[4]; + dy3 = s[5]; + dx4 = s[6]; + dy4 = s[7]; + dx5 = s[8]; + dy5 = s[9]; + dx6 = dy6 = s[10]; + dx = dx1+dx2+dx3+dx4+dx5; + dy = dy1+dy2+dy3+dy4+dy5; + if (STBTT_fabs(dx) > STBTT_fabs(dy)) + dy6 = -dy; + else + dx6 = -dx; + stbtt__csctx_rccurve_to(c, dx1, dy1, dx2, dy2, dx3, dy3); + stbtt__csctx_rccurve_to(c, dx4, dy4, dx5, dy5, dx6, dy6); + break; + + default: + return STBTT__CSERR("unimplemented"); + } + } break; + + default: + if (b0 != 255 && b0 != 28 && b0 < 32) + return STBTT__CSERR("reserved operator"); + + // push immediate + if (b0 == 255) { + f = (float)(stbtt_int32)stbtt__buf_get32(&b) / 0x10000; + } else { + stbtt__buf_skip(&b, -1); + f = (float)(stbtt_int16)stbtt__cff_int(&b); + } + if (sp >= 48) return STBTT__CSERR("push stack overflow"); + s[sp++] = f; + clear_stack = 0; + break; + } + if (clear_stack) sp = 0; + } + return STBTT__CSERR("no endchar"); + +#undef STBTT__CSERR +} + +static int stbtt__GetGlyphShapeT2(const stbtt_fontinfo *info, int glyph_index, stbtt_vertex **pvertices) +{ + // runs the charstring twice, once to count and once to output (to avoid realloc) + stbtt__csctx count_ctx = STBTT__CSCTX_INIT(1); + stbtt__csctx output_ctx = STBTT__CSCTX_INIT(0); + if (stbtt__run_charstring(info, glyph_index, &count_ctx)) { + *pvertices = (stbtt_vertex*)STBTT_malloc(count_ctx.num_vertices*sizeof(stbtt_vertex), info->userdata); + output_ctx.pvertices = *pvertices; + if (stbtt__run_charstring(info, glyph_index, &output_ctx)) { + STBTT_assert(output_ctx.num_vertices == count_ctx.num_vertices); + return output_ctx.num_vertices; + } + } + *pvertices = NULL; + return 0; +} + +static int stbtt__GetGlyphInfoT2(const stbtt_fontinfo *info, int glyph_index, int *x0, int *y0, int *x1, int *y1) +{ + stbtt__csctx c = STBTT__CSCTX_INIT(1); + int r = stbtt__run_charstring(info, glyph_index, &c); + if (x0) *x0 = r ? c.min_x : 0; + if (y0) *y0 = r ? c.min_y : 0; + if (x1) *x1 = r ? c.max_x : 0; + if (y1) *y1 = r ? c.max_y : 0; + return r ? c.num_vertices : 0; +} + +STBTT_DEF int stbtt_GetGlyphShape(const stbtt_fontinfo *info, int glyph_index, stbtt_vertex **pvertices) +{ + if (!info->cff.size) + return stbtt__GetGlyphShapeTT(info, glyph_index, pvertices); + else + return stbtt__GetGlyphShapeT2(info, glyph_index, pvertices); +} + +STBTT_DEF void stbtt_GetGlyphHMetrics(const stbtt_fontinfo *info, int glyph_index, int *advanceWidth, int *leftSideBearing) +{ + stbtt_uint16 numOfLongHorMetrics = ttUSHORT(info->data+info->hhea + 34); + if (glyph_index < numOfLongHorMetrics) { + if (advanceWidth) *advanceWidth = ttSHORT(info->data + info->hmtx + 4*glyph_index); + if (leftSideBearing) *leftSideBearing = ttSHORT(info->data + info->hmtx + 4*glyph_index + 2); + } else { + if (advanceWidth) *advanceWidth = ttSHORT(info->data + info->hmtx + 4*(numOfLongHorMetrics-1)); + if (leftSideBearing) *leftSideBearing = ttSHORT(info->data + info->hmtx + 4*numOfLongHorMetrics + 2*(glyph_index - numOfLongHorMetrics)); + } +} + +STBTT_DEF int stbtt_GetKerningTableLength(const stbtt_fontinfo *info) +{ + stbtt_uint8 *data = info->data + info->kern; + + // we only look at the first table. it must be 'horizontal' and format 0. + if (!info->kern) + return 0; + if (ttUSHORT(data+2) < 1) // number of tables, need at least 1 + return 0; + if (ttUSHORT(data+8) != 1) // horizontal flag must be set in format + return 0; + + return ttUSHORT(data+10); +} + +STBTT_DEF int stbtt_GetKerningTable(const stbtt_fontinfo *info, stbtt_kerningentry* table, int table_length) +{ + stbtt_uint8 *data = info->data + info->kern; + int k, length; + + // we only look at the first table. it must be 'horizontal' and format 0. + if (!info->kern) + return 0; + if (ttUSHORT(data+2) < 1) // number of tables, need at least 1 + return 0; + if (ttUSHORT(data+8) != 1) // horizontal flag must be set in format + return 0; + + length = ttUSHORT(data+10); + if (table_length < length) + length = table_length; + + for (k = 0; k < length; k++) + { + table[k].glyph1 = ttUSHORT(data+18+(k*6)); + table[k].glyph2 = ttUSHORT(data+20+(k*6)); + table[k].advance = ttSHORT(data+22+(k*6)); + } + + return length; +} + +static int stbtt__GetGlyphKernInfoAdvance(const stbtt_fontinfo *info, int glyph1, int glyph2) +{ + stbtt_uint8 *data = info->data + info->kern; + stbtt_uint32 needle, straw; + int l, r, m; + + // we only look at the first table. it must be 'horizontal' and format 0. + if (!info->kern) + return 0; + if (ttUSHORT(data+2) < 1) // number of tables, need at least 1 + return 0; + if (ttUSHORT(data+8) != 1) // horizontal flag must be set in format + return 0; + + l = 0; + r = ttUSHORT(data+10) - 1; + needle = glyph1 << 16 | glyph2; + while (l <= r) { + m = (l + r) >> 1; + straw = ttULONG(data+18+(m*6)); // note: unaligned read + if (needle < straw) + r = m - 1; + else if (needle > straw) + l = m + 1; + else + return ttSHORT(data+22+(m*6)); + } + return 0; +} + +static stbtt_int32 stbtt__GetCoverageIndex(stbtt_uint8 *coverageTable, int glyph) +{ + stbtt_uint16 coverageFormat = ttUSHORT(coverageTable); + switch (coverageFormat) { + case 1: { + stbtt_uint16 glyphCount = ttUSHORT(coverageTable + 2); + + // Binary search. + stbtt_int32 l=0, r=glyphCount-1, m; + int straw, needle=glyph; + while (l <= r) { + stbtt_uint8 *glyphArray = coverageTable + 4; + stbtt_uint16 glyphID; + m = (l + r) >> 1; + glyphID = ttUSHORT(glyphArray + 2 * m); + straw = glyphID; + if (needle < straw) + r = m - 1; + else if (needle > straw) + l = m + 1; + else { + return m; + } + } + break; + } + + case 2: { + stbtt_uint16 rangeCount = ttUSHORT(coverageTable + 2); + stbtt_uint8 *rangeArray = coverageTable + 4; + + // Binary search. + stbtt_int32 l=0, r=rangeCount-1, m; + int strawStart, strawEnd, needle=glyph; + while (l <= r) { + stbtt_uint8 *rangeRecord; + m = (l + r) >> 1; + rangeRecord = rangeArray + 6 * m; + strawStart = ttUSHORT(rangeRecord); + strawEnd = ttUSHORT(rangeRecord + 2); + if (needle < strawStart) + r = m - 1; + else if (needle > strawEnd) + l = m + 1; + else { + stbtt_uint16 startCoverageIndex = ttUSHORT(rangeRecord + 4); + return startCoverageIndex + glyph - strawStart; + } + } + break; + } + + default: return -1; // unsupported + } + + return -1; +} + +static stbtt_int32 stbtt__GetGlyphClass(stbtt_uint8 *classDefTable, int glyph) +{ + stbtt_uint16 classDefFormat = ttUSHORT(classDefTable); + switch (classDefFormat) + { + case 1: { + stbtt_uint16 startGlyphID = ttUSHORT(classDefTable + 2); + stbtt_uint16 glyphCount = ttUSHORT(classDefTable + 4); + stbtt_uint8 *classDef1ValueArray = classDefTable + 6; + + if (glyph >= startGlyphID && glyph < startGlyphID + glyphCount) + return (stbtt_int32)ttUSHORT(classDef1ValueArray + 2 * (glyph - startGlyphID)); + break; + } + + case 2: { + stbtt_uint16 classRangeCount = ttUSHORT(classDefTable + 2); + stbtt_uint8 *classRangeRecords = classDefTable + 4; + + // Binary search. + stbtt_int32 l=0, r=classRangeCount-1, m; + int strawStart, strawEnd, needle=glyph; + while (l <= r) { + stbtt_uint8 *classRangeRecord; + m = (l + r) >> 1; + classRangeRecord = classRangeRecords + 6 * m; + strawStart = ttUSHORT(classRangeRecord); + strawEnd = ttUSHORT(classRangeRecord + 2); + if (needle < strawStart) + r = m - 1; + else if (needle > strawEnd) + l = m + 1; + else + return (stbtt_int32)ttUSHORT(classRangeRecord + 4); + } + break; + } + + default: + return -1; // Unsupported definition type, return an error. + } + + // "All glyphs not assigned to a class fall into class 0". (OpenType spec) + return 0; +} + +// Define to STBTT_assert(x) if you want to break on unimplemented formats. +#define STBTT_GPOS_TODO_assert(x) + +static stbtt_int32 stbtt__GetGlyphGPOSInfoAdvance(const stbtt_fontinfo *info, int glyph1, int glyph2) +{ + stbtt_uint16 lookupListOffset; + stbtt_uint8 *lookupList; + stbtt_uint16 lookupCount; + stbtt_uint8 *data; + stbtt_int32 i, sti; + + if (!info->gpos) return 0; + + data = info->data + info->gpos; + + if (ttUSHORT(data+0) != 1) return 0; // Major version 1 + if (ttUSHORT(data+2) != 0) return 0; // Minor version 0 + + lookupListOffset = ttUSHORT(data+8); + lookupList = data + lookupListOffset; + lookupCount = ttUSHORT(lookupList); + + for (i=0; i= pairSetCount) return 0; + + needle=glyph2; + r=pairValueCount-1; + l=0; + + // Binary search. + while (l <= r) { + stbtt_uint16 secondGlyph; + stbtt_uint8 *pairValue; + m = (l + r) >> 1; + pairValue = pairValueArray + (2 + valueRecordPairSizeInBytes) * m; + secondGlyph = ttUSHORT(pairValue); + straw = secondGlyph; + if (needle < straw) + r = m - 1; + else if (needle > straw) + l = m + 1; + else { + stbtt_int16 xAdvance = ttSHORT(pairValue + 2); + return xAdvance; + } + } + } else + return 0; + break; + } + + case 2: { + stbtt_uint16 valueFormat1 = ttUSHORT(table + 4); + stbtt_uint16 valueFormat2 = ttUSHORT(table + 6); + if (valueFormat1 == 4 && valueFormat2 == 0) { // Support more formats? + stbtt_uint16 classDef1Offset = ttUSHORT(table + 8); + stbtt_uint16 classDef2Offset = ttUSHORT(table + 10); + int glyph1class = stbtt__GetGlyphClass(table + classDef1Offset, glyph1); + int glyph2class = stbtt__GetGlyphClass(table + classDef2Offset, glyph2); + + stbtt_uint16 class1Count = ttUSHORT(table + 12); + stbtt_uint16 class2Count = ttUSHORT(table + 14); + stbtt_uint8 *class1Records, *class2Records; + stbtt_int16 xAdvance; + + if (glyph1class < 0 || glyph1class >= class1Count) return 0; // malformed + if (glyph2class < 0 || glyph2class >= class2Count) return 0; // malformed + + class1Records = table + 16; + class2Records = class1Records + 2 * (glyph1class * class2Count); + xAdvance = ttSHORT(class2Records + 2 * glyph2class); + return xAdvance; + } else + return 0; + break; + } + + default: + return 0; // Unsupported position format + } + } + } + + return 0; +} + +STBTT_DEF int stbtt_GetGlyphKernAdvance(const stbtt_fontinfo *info, int g1, int g2) +{ + int xAdvance = 0; + + if (info->gpos) + xAdvance += stbtt__GetGlyphGPOSInfoAdvance(info, g1, g2); + else if (info->kern) + xAdvance += stbtt__GetGlyphKernInfoAdvance(info, g1, g2); + + return xAdvance; +} + +STBTT_DEF int stbtt_GetCodepointKernAdvance(const stbtt_fontinfo *info, int ch1, int ch2) +{ + if (!info->kern && !info->gpos) // if no kerning table, don't waste time looking up both codepoint->glyphs + return 0; + return stbtt_GetGlyphKernAdvance(info, stbtt_FindGlyphIndex(info,ch1), stbtt_FindGlyphIndex(info,ch2)); +} + +STBTT_DEF void stbtt_GetCodepointHMetrics(const stbtt_fontinfo *info, int codepoint, int *advanceWidth, int *leftSideBearing) +{ + stbtt_GetGlyphHMetrics(info, stbtt_FindGlyphIndex(info,codepoint), advanceWidth, leftSideBearing); +} + +STBTT_DEF void stbtt_GetFontVMetrics(const stbtt_fontinfo *info, int *ascent, int *descent, int *lineGap) +{ + if (ascent ) *ascent = ttSHORT(info->data+info->hhea + 4); + if (descent) *descent = ttSHORT(info->data+info->hhea + 6); + if (lineGap) *lineGap = ttSHORT(info->data+info->hhea + 8); +} + +STBTT_DEF int stbtt_GetFontVMetricsOS2(const stbtt_fontinfo *info, int *typoAscent, int *typoDescent, int *typoLineGap) +{ + int tab = stbtt__find_table(info->data, info->fontstart, "OS/2"); + if (!tab) + return 0; + if (typoAscent ) *typoAscent = ttSHORT(info->data+tab + 68); + if (typoDescent) *typoDescent = ttSHORT(info->data+tab + 70); + if (typoLineGap) *typoLineGap = ttSHORT(info->data+tab + 72); + return 1; +} + +STBTT_DEF void stbtt_GetFontBoundingBox(const stbtt_fontinfo *info, int *x0, int *y0, int *x1, int *y1) +{ + *x0 = ttSHORT(info->data + info->head + 36); + *y0 = ttSHORT(info->data + info->head + 38); + *x1 = ttSHORT(info->data + info->head + 40); + *y1 = ttSHORT(info->data + info->head + 42); +} + +STBTT_DEF float stbtt_ScaleForPixelHeight(const stbtt_fontinfo *info, float height) +{ + int fheight = ttSHORT(info->data + info->hhea + 4) - ttSHORT(info->data + info->hhea + 6); + return (float) height / fheight; +} + +STBTT_DEF float stbtt_ScaleForMappingEmToPixels(const stbtt_fontinfo *info, float pixels) +{ + int unitsPerEm = ttUSHORT(info->data + info->head + 18); + return pixels / unitsPerEm; +} + +STBTT_DEF void stbtt_FreeShape(const stbtt_fontinfo *info, stbtt_vertex *v) +{ + STBTT_free(v, info->userdata); +} + +STBTT_DEF stbtt_uint8 *stbtt_FindSVGDoc(const stbtt_fontinfo *info, int gl) +{ + int i; + stbtt_uint8 *data = info->data; + stbtt_uint8 *svg_doc_list = data + stbtt__get_svg((stbtt_fontinfo *) info); + + int numEntries = ttUSHORT(svg_doc_list); + stbtt_uint8 *svg_docs = svg_doc_list + 2; + + for(i=0; i= ttUSHORT(svg_doc)) && (gl <= ttUSHORT(svg_doc + 2))) + return svg_doc; + } + return 0; +} + +STBTT_DEF int stbtt_GetGlyphSVG(const stbtt_fontinfo *info, int gl, const char **svg) +{ + stbtt_uint8 *data = info->data; + stbtt_uint8 *svg_doc; + + if (info->svg == 0) + return 0; + + svg_doc = stbtt_FindSVGDoc(info, gl); + if (svg_doc != NULL) { + *svg = (char *) data + info->svg + ttULONG(svg_doc + 4); + return ttULONG(svg_doc + 8); + } else { + return 0; + } +} + +STBTT_DEF int stbtt_GetCodepointSVG(const stbtt_fontinfo *info, int unicode_codepoint, const char **svg) +{ + return stbtt_GetGlyphSVG(info, stbtt_FindGlyphIndex(info, unicode_codepoint), svg); +} + +////////////////////////////////////////////////////////////////////////////// +// +// antialiasing software rasterizer +// + +STBTT_DEF void stbtt_GetGlyphBitmapBoxSubpixel(const stbtt_fontinfo *font, int glyph, float scale_x, float scale_y,float shift_x, float shift_y, int *ix0, int *iy0, int *ix1, int *iy1) +{ + int x0=0,y0=0,x1,y1; // =0 suppresses compiler warning + if (!stbtt_GetGlyphBox(font, glyph, &x0,&y0,&x1,&y1)) { + // e.g. space character + if (ix0) *ix0 = 0; + if (iy0) *iy0 = 0; + if (ix1) *ix1 = 0; + if (iy1) *iy1 = 0; + } else { + // move to integral bboxes (treating pixels as little squares, what pixels get touched)? + if (ix0) *ix0 = STBTT_ifloor( x0 * scale_x + shift_x); + if (iy0) *iy0 = STBTT_ifloor(-y1 * scale_y + shift_y); + if (ix1) *ix1 = STBTT_iceil ( x1 * scale_x + shift_x); + if (iy1) *iy1 = STBTT_iceil (-y0 * scale_y + shift_y); + } +} + +STBTT_DEF void stbtt_GetGlyphBitmapBox(const stbtt_fontinfo *font, int glyph, float scale_x, float scale_y, int *ix0, int *iy0, int *ix1, int *iy1) +{ + stbtt_GetGlyphBitmapBoxSubpixel(font, glyph, scale_x, scale_y,0.0f,0.0f, ix0, iy0, ix1, iy1); +} + +STBTT_DEF void stbtt_GetCodepointBitmapBoxSubpixel(const stbtt_fontinfo *font, int codepoint, float scale_x, float scale_y, float shift_x, float shift_y, int *ix0, int *iy0, int *ix1, int *iy1) +{ + stbtt_GetGlyphBitmapBoxSubpixel(font, stbtt_FindGlyphIndex(font,codepoint), scale_x, scale_y,shift_x,shift_y, ix0,iy0,ix1,iy1); +} + +STBTT_DEF void stbtt_GetCodepointBitmapBox(const stbtt_fontinfo *font, int codepoint, float scale_x, float scale_y, int *ix0, int *iy0, int *ix1, int *iy1) +{ + stbtt_GetCodepointBitmapBoxSubpixel(font, codepoint, scale_x, scale_y,0.0f,0.0f, ix0,iy0,ix1,iy1); +} + +////////////////////////////////////////////////////////////////////////////// +// +// Rasterizer + +typedef struct stbtt__hheap_chunk +{ + struct stbtt__hheap_chunk *next; +} stbtt__hheap_chunk; + +typedef struct stbtt__hheap +{ + struct stbtt__hheap_chunk *head; + void *first_free; + int num_remaining_in_head_chunk; +} stbtt__hheap; + +static void *stbtt__hheap_alloc(stbtt__hheap *hh, size_t size, void *userdata) +{ + if (hh->first_free) { + void *p = hh->first_free; + hh->first_free = * (void **) p; + return p; + } else { + if (hh->num_remaining_in_head_chunk == 0) { + int count = (size < 32 ? 2000 : size < 128 ? 800 : 100); + stbtt__hheap_chunk *c = (stbtt__hheap_chunk *) STBTT_malloc(sizeof(stbtt__hheap_chunk) + size * count, userdata); + if (c == NULL) + return NULL; + c->next = hh->head; + hh->head = c; + hh->num_remaining_in_head_chunk = count; + } + --hh->num_remaining_in_head_chunk; + return (char *) (hh->head) + sizeof(stbtt__hheap_chunk) + size * hh->num_remaining_in_head_chunk; + } +} + +static void stbtt__hheap_free(stbtt__hheap *hh, void *p) +{ + *(void **) p = hh->first_free; + hh->first_free = p; +} + +static void stbtt__hheap_cleanup(stbtt__hheap *hh, void *userdata) +{ + stbtt__hheap_chunk *c = hh->head; + while (c) { + stbtt__hheap_chunk *n = c->next; + STBTT_free(c, userdata); + c = n; + } +} + +typedef struct stbtt__edge { + float x0,y0, x1,y1; + int invert; +} stbtt__edge; + + +typedef struct stbtt__active_edge +{ + struct stbtt__active_edge *next; + #if STBTT_RASTERIZER_VERSION==1 + int x,dx; + float ey; + int direction; + #elif STBTT_RASTERIZER_VERSION==2 + float fx,fdx,fdy; + float direction; + float sy; + float ey; + #else + #error "Unrecognized value of STBTT_RASTERIZER_VERSION" + #endif +} stbtt__active_edge; + +#if STBTT_RASTERIZER_VERSION == 1 +#define STBTT_FIXSHIFT 10 +#define STBTT_FIX (1 << STBTT_FIXSHIFT) +#define STBTT_FIXMASK (STBTT_FIX-1) + +static stbtt__active_edge *stbtt__new_active(stbtt__hheap *hh, stbtt__edge *e, int off_x, float start_point, void *userdata) +{ + stbtt__active_edge *z = (stbtt__active_edge *) stbtt__hheap_alloc(hh, sizeof(*z), userdata); + float dxdy = (e->x1 - e->x0) / (e->y1 - e->y0); + STBTT_assert(z != NULL); + if (!z) return z; + + // round dx down to avoid overshooting + if (dxdy < 0) + z->dx = -STBTT_ifloor(STBTT_FIX * -dxdy); + else + z->dx = STBTT_ifloor(STBTT_FIX * dxdy); + + z->x = STBTT_ifloor(STBTT_FIX * e->x0 + z->dx * (start_point - e->y0)); // use z->dx so when we offset later it's by the same amount + z->x -= off_x * STBTT_FIX; + + z->ey = e->y1; + z->next = 0; + z->direction = e->invert ? 1 : -1; + return z; +} +#elif STBTT_RASTERIZER_VERSION == 2 +static stbtt__active_edge *stbtt__new_active(stbtt__hheap *hh, stbtt__edge *e, int off_x, float start_point, void *userdata) +{ + stbtt__active_edge *z = (stbtt__active_edge *) stbtt__hheap_alloc(hh, sizeof(*z), userdata); + float dxdy = (e->x1 - e->x0) / (e->y1 - e->y0); + STBTT_assert(z != NULL); + //STBTT_assert(e->y0 <= start_point); + if (!z) return z; + z->fdx = dxdy; + z->fdy = dxdy != 0.0f ? (1.0f/dxdy) : 0.0f; + z->fx = e->x0 + dxdy * (start_point - e->y0); + z->fx -= off_x; + z->direction = e->invert ? 1.0f : -1.0f; + z->sy = e->y0; + z->ey = e->y1; + z->next = 0; + return z; +} +#else +#error "Unrecognized value of STBTT_RASTERIZER_VERSION" +#endif + +#if STBTT_RASTERIZER_VERSION == 1 +// note: this routine clips fills that extend off the edges... ideally this +// wouldn't happen, but it could happen if the truetype glyph bounding boxes +// are wrong, or if the user supplies a too-small bitmap +static void stbtt__fill_active_edges(unsigned char *scanline, int len, stbtt__active_edge *e, int max_weight) +{ + // non-zero winding fill + int x0=0, w=0; + + while (e) { + if (w == 0) { + // if we're currently at zero, we need to record the edge start point + x0 = e->x; w += e->direction; + } else { + int x1 = e->x; w += e->direction; + // if we went to zero, we need to draw + if (w == 0) { + int i = x0 >> STBTT_FIXSHIFT; + int j = x1 >> STBTT_FIXSHIFT; + + if (i < len && j >= 0) { + if (i == j) { + // x0,x1 are the same pixel, so compute combined coverage + scanline[i] = scanline[i] + (stbtt_uint8) ((x1 - x0) * max_weight >> STBTT_FIXSHIFT); + } else { + if (i >= 0) // add antialiasing for x0 + scanline[i] = scanline[i] + (stbtt_uint8) (((STBTT_FIX - (x0 & STBTT_FIXMASK)) * max_weight) >> STBTT_FIXSHIFT); + else + i = -1; // clip + + if (j < len) // add antialiasing for x1 + scanline[j] = scanline[j] + (stbtt_uint8) (((x1 & STBTT_FIXMASK) * max_weight) >> STBTT_FIXSHIFT); + else + j = len; // clip + + for (++i; i < j; ++i) // fill pixels between x0 and x1 + scanline[i] = scanline[i] + (stbtt_uint8) max_weight; + } + } + } + } + + e = e->next; + } +} + +static void stbtt__rasterize_sorted_edges(stbtt__bitmap *result, stbtt__edge *e, int n, int vsubsample, int off_x, int off_y, void *userdata) +{ + stbtt__hheap hh = { 0, 0, 0 }; + stbtt__active_edge *active = NULL; + int y,j=0; + int max_weight = (255 / vsubsample); // weight per vertical scanline + int s; // vertical subsample index + unsigned char scanline_data[512], *scanline; + + if (result->w > 512) + scanline = (unsigned char *) STBTT_malloc(result->w, userdata); + else + scanline = scanline_data; + + y = off_y * vsubsample; + e[n].y0 = (off_y + result->h) * (float) vsubsample + 1; + + while (j < result->h) { + STBTT_memset(scanline, 0, result->w); + for (s=0; s < vsubsample; ++s) { + // find center of pixel for this scanline + float scan_y = y + 0.5f; + stbtt__active_edge **step = &active; + + // update all active edges; + // remove all active edges that terminate before the center of this scanline + while (*step) { + stbtt__active_edge * z = *step; + if (z->ey <= scan_y) { + *step = z->next; // delete from list + STBTT_assert(z->direction); + z->direction = 0; + stbtt__hheap_free(&hh, z); + } else { + z->x += z->dx; // advance to position for current scanline + step = &((*step)->next); // advance through list + } + } + + // resort the list if needed + for(;;) { + int changed=0; + step = &active; + while (*step && (*step)->next) { + if ((*step)->x > (*step)->next->x) { + stbtt__active_edge *t = *step; + stbtt__active_edge *q = t->next; + + t->next = q->next; + q->next = t; + *step = q; + changed = 1; + } + step = &(*step)->next; + } + if (!changed) break; + } + + // insert all edges that start before the center of this scanline -- omit ones that also end on this scanline + while (e->y0 <= scan_y) { + if (e->y1 > scan_y) { + stbtt__active_edge *z = stbtt__new_active(&hh, e, off_x, scan_y, userdata); + if (z != NULL) { + // find insertion point + if (active == NULL) + active = z; + else if (z->x < active->x) { + // insert at front + z->next = active; + active = z; + } else { + // find thing to insert AFTER + stbtt__active_edge *p = active; + while (p->next && p->next->x < z->x) + p = p->next; + // at this point, p->next->x is NOT < z->x + z->next = p->next; + p->next = z; + } + } + } + ++e; + } + + // now process all active edges in XOR fashion + if (active) + stbtt__fill_active_edges(scanline, result->w, active, max_weight); + + ++y; + } + STBTT_memcpy(result->pixels + j * result->stride, scanline, result->w); + ++j; + } + + stbtt__hheap_cleanup(&hh, userdata); + + if (scanline != scanline_data) + STBTT_free(scanline, userdata); +} + +#elif STBTT_RASTERIZER_VERSION == 2 + +// the edge passed in here does not cross the vertical line at x or the vertical line at x+1 +// (i.e. it has already been clipped to those) +static void stbtt__handle_clipped_edge(float *scanline, int x, stbtt__active_edge *e, float x0, float y0, float x1, float y1) +{ + if (y0 == y1) return; + STBTT_assert(y0 < y1); + STBTT_assert(e->sy <= e->ey); + if (y0 > e->ey) return; + if (y1 < e->sy) return; + if (y0 < e->sy) { + x0 += (x1-x0) * (e->sy - y0) / (y1-y0); + y0 = e->sy; + } + if (y1 > e->ey) { + x1 += (x1-x0) * (e->ey - y1) / (y1-y0); + y1 = e->ey; + } + + if (x0 == x) + STBTT_assert(x1 <= x+1); + else if (x0 == x+1) + STBTT_assert(x1 >= x); + else if (x0 <= x) + STBTT_assert(x1 <= x); + else if (x0 >= x+1) + STBTT_assert(x1 >= x+1); + else + STBTT_assert(x1 >= x && x1 <= x+1); + + if (x0 <= x && x1 <= x) + scanline[x] += e->direction * (y1-y0); + else if (x0 >= x+1 && x1 >= x+1) + ; + else { + STBTT_assert(x0 >= x && x0 <= x+1 && x1 >= x && x1 <= x+1); + scanline[x] += e->direction * (y1-y0) * (1-((x0-x)+(x1-x))/2); // coverage = 1 - average x position + } +} + +static float stbtt__sized_trapezoid_area(float height, float top_width, float bottom_width) +{ + STBTT_assert(top_width >= 0); + STBTT_assert(bottom_width >= 0); + return (top_width + bottom_width) / 2.0f * height; +} + +static float stbtt__position_trapezoid_area(float height, float tx0, float tx1, float bx0, float bx1) +{ + return stbtt__sized_trapezoid_area(height, tx1 - tx0, bx1 - bx0); +} + +static float stbtt__sized_triangle_area(float height, float width) +{ + return height * width / 2; +} + +static void stbtt__fill_active_edges_new(float *scanline, float *scanline_fill, int len, stbtt__active_edge *e, float y_top) +{ + float y_bottom = y_top+1; + + while (e) { + // brute force every pixel + + // compute intersection points with top & bottom + STBTT_assert(e->ey >= y_top); + + if (e->fdx == 0) { + float x0 = e->fx; + if (x0 < len) { + if (x0 >= 0) { + stbtt__handle_clipped_edge(scanline,(int) x0,e, x0,y_top, x0,y_bottom); + stbtt__handle_clipped_edge(scanline_fill-1,(int) x0+1,e, x0,y_top, x0,y_bottom); + } else { + stbtt__handle_clipped_edge(scanline_fill-1,0,e, x0,y_top, x0,y_bottom); + } + } + } else { + float x0 = e->fx; + float dx = e->fdx; + float xb = x0 + dx; + float x_top, x_bottom; + float sy0,sy1; + float dy = e->fdy; + STBTT_assert(e->sy <= y_bottom && e->ey >= y_top); + + // compute endpoints of line segment clipped to this scanline (if the + // line segment starts on this scanline. x0 is the intersection of the + // line with y_top, but that may be off the line segment. + if (e->sy > y_top) { + x_top = x0 + dx * (e->sy - y_top); + sy0 = e->sy; + } else { + x_top = x0; + sy0 = y_top; + } + if (e->ey < y_bottom) { + x_bottom = x0 + dx * (e->ey - y_top); + sy1 = e->ey; + } else { + x_bottom = xb; + sy1 = y_bottom; + } + + if (x_top >= 0 && x_bottom >= 0 && x_top < len && x_bottom < len) { + // from here on, we don't have to range check x values + + if ((int) x_top == (int) x_bottom) { + float height; + // simple case, only spans one pixel + int x = (int) x_top; + height = (sy1 - sy0) * e->direction; + STBTT_assert(x >= 0 && x < len); + scanline[x] += stbtt__position_trapezoid_area(height, x_top, x+1.0f, x_bottom, x+1.0f); + scanline_fill[x] += height; // everything right of this pixel is filled + } else { + int x,x1,x2; + float y_crossing, y_final, step, sign, area; + // covers 2+ pixels + if (x_top > x_bottom) { + // flip scanline vertically; signed area is the same + float t; + sy0 = y_bottom - (sy0 - y_top); + sy1 = y_bottom - (sy1 - y_top); + t = sy0, sy0 = sy1, sy1 = t; + t = x_bottom, x_bottom = x_top, x_top = t; + dx = -dx; + dy = -dy; + t = x0, x0 = xb, xb = t; + } + STBTT_assert(dy >= 0); + STBTT_assert(dx >= 0); + + x1 = (int) x_top; + x2 = (int) x_bottom; + // compute intersection with y axis at x1+1 + y_crossing = y_top + dy * (x1+1 - x0); + + // compute intersection with y axis at x2 + y_final = y_top + dy * (x2 - x0); + + // x1 x_top x2 x_bottom + // y_top +------|-----+------------+------------+--------|---+------------+ + // | | | | | | + // | | | | | | + // sy0 | Txxxxx|............|............|............|............| + // y_crossing | *xxxxx.......|............|............|............| + // | | xxxxx..|............|............|............| + // | | /- xx*xxxx........|............|............| + // | | dy < | xxxxxx..|............|............| + // y_final | | \- | xx*xxx.........|............| + // sy1 | | | | xxxxxB...|............| + // | | | | | | + // | | | | | | + // y_bottom +------------+------------+------------+------------+------------+ + // + // goal is to measure the area covered by '.' in each pixel + + // if x2 is right at the right edge of x1, y_crossing can blow up, github #1057 + // @TODO: maybe test against sy1 rather than y_bottom? + if (y_crossing > y_bottom) + y_crossing = y_bottom; + + sign = e->direction; + + // area of the rectangle covered from sy0..y_crossing + area = sign * (y_crossing-sy0); + + // area of the triangle (x_top,sy0), (x1+1,sy0), (x1+1,y_crossing) + scanline[x1] += stbtt__sized_triangle_area(area, x1+1 - x_top); + + // check if final y_crossing is blown up; no test case for this + if (y_final > y_bottom) { + y_final = y_bottom; + dy = (y_final - y_crossing ) / (x2 - (x1+1)); // if denom=0, y_final = y_crossing, so y_final <= y_bottom + } + + // in second pixel, area covered by line segment found in first pixel + // is always a rectangle 1 wide * the height of that line segment; this + // is exactly what the variable 'area' stores. it also gets a contribution + // from the line segment within it. the THIRD pixel will get the first + // pixel's rectangle contribution, the second pixel's rectangle contribution, + // and its own contribution. the 'own contribution' is the same in every pixel except + // the leftmost and rightmost, a trapezoid that slides down in each pixel. + // the second pixel's contribution to the third pixel will be the + // rectangle 1 wide times the height change in the second pixel, which is dy. + + step = sign * dy * 1; // dy is dy/dx, change in y for every 1 change in x, + // which multiplied by 1-pixel-width is how much pixel area changes for each step in x + // so the area advances by 'step' every time + + for (x = x1+1; x < x2; ++x) { + scanline[x] += area + step/2; // area of trapezoid is 1*step/2 + area += step; + } + STBTT_assert(STBTT_fabs(area) <= 1.01f); // accumulated error from area += step unless we round step down + STBTT_assert(sy1 > y_final-0.01f); + + // area covered in the last pixel is the rectangle from all the pixels to the left, + // plus the trapezoid filled by the line segment in this pixel all the way to the right edge + scanline[x2] += area + sign * stbtt__position_trapezoid_area(sy1-y_final, (float) x2, x2+1.0f, x_bottom, x2+1.0f); + + // the rest of the line is filled based on the total height of the line segment in this pixel + scanline_fill[x2] += sign * (sy1-sy0); + } + } else { + // if edge goes outside of box we're drawing, we require + // clipping logic. since this does not match the intended use + // of this library, we use a different, very slow brute + // force implementation + // note though that this does happen some of the time because + // x_top and x_bottom can be extrapolated at the top & bottom of + // the shape and actually lie outside the bounding box + int x; + for (x=0; x < len; ++x) { + // cases: + // + // there can be up to two intersections with the pixel. any intersection + // with left or right edges can be handled by splitting into two (or three) + // regions. intersections with top & bottom do not necessitate case-wise logic. + // + // the old way of doing this found the intersections with the left & right edges, + // then used some simple logic to produce up to three segments in sorted order + // from top-to-bottom. however, this had a problem: if an x edge was epsilon + // across the x border, then the corresponding y position might not be distinct + // from the other y segment, and it might ignored as an empty segment. to avoid + // that, we need to explicitly produce segments based on x positions. + + // rename variables to clearly-defined pairs + float y0 = y_top; + float x1 = (float) (x); + float x2 = (float) (x+1); + float x3 = xb; + float y3 = y_bottom; + + // x = e->x + e->dx * (y-y_top) + // (y-y_top) = (x - e->x) / e->dx + // y = (x - e->x) / e->dx + y_top + float y1 = (x - x0) / dx + y_top; + float y2 = (x+1 - x0) / dx + y_top; + + if (x0 < x1 && x3 > x2) { // three segments descending down-right + stbtt__handle_clipped_edge(scanline,x,e, x0,y0, x1,y1); + stbtt__handle_clipped_edge(scanline,x,e, x1,y1, x2,y2); + stbtt__handle_clipped_edge(scanline,x,e, x2,y2, x3,y3); + } else if (x3 < x1 && x0 > x2) { // three segments descending down-left + stbtt__handle_clipped_edge(scanline,x,e, x0,y0, x2,y2); + stbtt__handle_clipped_edge(scanline,x,e, x2,y2, x1,y1); + stbtt__handle_clipped_edge(scanline,x,e, x1,y1, x3,y3); + } else if (x0 < x1 && x3 > x1) { // two segments across x, down-right + stbtt__handle_clipped_edge(scanline,x,e, x0,y0, x1,y1); + stbtt__handle_clipped_edge(scanline,x,e, x1,y1, x3,y3); + } else if (x3 < x1 && x0 > x1) { // two segments across x, down-left + stbtt__handle_clipped_edge(scanline,x,e, x0,y0, x1,y1); + stbtt__handle_clipped_edge(scanline,x,e, x1,y1, x3,y3); + } else if (x0 < x2 && x3 > x2) { // two segments across x+1, down-right + stbtt__handle_clipped_edge(scanline,x,e, x0,y0, x2,y2); + stbtt__handle_clipped_edge(scanline,x,e, x2,y2, x3,y3); + } else if (x3 < x2 && x0 > x2) { // two segments across x+1, down-left + stbtt__handle_clipped_edge(scanline,x,e, x0,y0, x2,y2); + stbtt__handle_clipped_edge(scanline,x,e, x2,y2, x3,y3); + } else { // one segment + stbtt__handle_clipped_edge(scanline,x,e, x0,y0, x3,y3); + } + } + } + } + e = e->next; + } +} + +// directly AA rasterize edges w/o supersampling +static void stbtt__rasterize_sorted_edges(stbtt__bitmap *result, stbtt__edge *e, int n, int vsubsample, int off_x, int off_y, void *userdata) +{ + stbtt__hheap hh = { 0, 0, 0 }; + stbtt__active_edge *active = NULL; + int y,j=0, i; + float scanline_data[129], *scanline, *scanline2; + + STBTT__NOTUSED(vsubsample); + + if (result->w > 64) + scanline = (float *) STBTT_malloc((result->w*2+1) * sizeof(float), userdata); + else + scanline = scanline_data; + + scanline2 = scanline + result->w; + + y = off_y; + e[n].y0 = (float) (off_y + result->h) + 1; + + while (j < result->h) { + // find center of pixel for this scanline + float scan_y_top = y + 0.0f; + float scan_y_bottom = y + 1.0f; + stbtt__active_edge **step = &active; + + STBTT_memset(scanline , 0, result->w*sizeof(scanline[0])); + STBTT_memset(scanline2, 0, (result->w+1)*sizeof(scanline[0])); + + // update all active edges; + // remove all active edges that terminate before the top of this scanline + while (*step) { + stbtt__active_edge * z = *step; + if (z->ey <= scan_y_top) { + *step = z->next; // delete from list + STBTT_assert(z->direction); + z->direction = 0; + stbtt__hheap_free(&hh, z); + } else { + step = &((*step)->next); // advance through list + } + } + + // insert all edges that start before the bottom of this scanline + while (e->y0 <= scan_y_bottom) { + if (e->y0 != e->y1) { + stbtt__active_edge *z = stbtt__new_active(&hh, e, off_x, scan_y_top, userdata); + if (z != NULL) { + if (j == 0 && off_y != 0) { + if (z->ey < scan_y_top) { + // this can happen due to subpixel positioning and some kind of fp rounding error i think + z->ey = scan_y_top; + } + } + STBTT_assert(z->ey >= scan_y_top); // if we get really unlucky a tiny bit of an edge can be out of bounds + // insert at front + z->next = active; + active = z; + } + } + ++e; + } + + // now process all active edges + if (active) + stbtt__fill_active_edges_new(scanline, scanline2+1, result->w, active, scan_y_top); + + { + float sum = 0; + for (i=0; i < result->w; ++i) { + float k; + int m; + sum += scanline2[i]; + k = scanline[i] + sum; + k = (float) STBTT_fabs(k)*255 + 0.5f; + m = (int) k; + if (m > 255) m = 255; + result->pixels[j*result->stride + i] = (unsigned char) m; + } + } + // advance all the edges + step = &active; + while (*step) { + stbtt__active_edge *z = *step; + z->fx += z->fdx; // advance to position for current scanline + step = &((*step)->next); // advance through list + } + + ++y; + ++j; + } + + stbtt__hheap_cleanup(&hh, userdata); + + if (scanline != scanline_data) + STBTT_free(scanline, userdata); +} +#else +#error "Unrecognized value of STBTT_RASTERIZER_VERSION" +#endif + +#define STBTT__COMPARE(a,b) ((a)->y0 < (b)->y0) + +static void stbtt__sort_edges_ins_sort(stbtt__edge *p, int n) +{ + int i,j; + for (i=1; i < n; ++i) { + stbtt__edge t = p[i], *a = &t; + j = i; + while (j > 0) { + stbtt__edge *b = &p[j-1]; + int c = STBTT__COMPARE(a,b); + if (!c) break; + p[j] = p[j-1]; + --j; + } + if (i != j) + p[j] = t; + } +} + +static void stbtt__sort_edges_quicksort(stbtt__edge *p, int n) +{ + /* threshold for transitioning to insertion sort */ + while (n > 12) { + stbtt__edge t; + int c01,c12,c,m,i,j; + + /* compute median of three */ + m = n >> 1; + c01 = STBTT__COMPARE(&p[0],&p[m]); + c12 = STBTT__COMPARE(&p[m],&p[n-1]); + /* if 0 >= mid >= end, or 0 < mid < end, then use mid */ + if (c01 != c12) { + /* otherwise, we'll need to swap something else to middle */ + int z; + c = STBTT__COMPARE(&p[0],&p[n-1]); + /* 0>mid && midn => n; 0 0 */ + /* 0n: 0>n => 0; 0 n */ + z = (c == c12) ? 0 : n-1; + t = p[z]; + p[z] = p[m]; + p[m] = t; + } + /* now p[m] is the median-of-three */ + /* swap it to the beginning so it won't move around */ + t = p[0]; + p[0] = p[m]; + p[m] = t; + + /* partition loop */ + i=1; + j=n-1; + for(;;) { + /* handling of equality is crucial here */ + /* for sentinels & efficiency with duplicates */ + for (;;++i) { + if (!STBTT__COMPARE(&p[i], &p[0])) break; + } + for (;;--j) { + if (!STBTT__COMPARE(&p[0], &p[j])) break; + } + /* make sure we haven't crossed */ + if (i >= j) break; + t = p[i]; + p[i] = p[j]; + p[j] = t; + + ++i; + --j; + } + /* recurse on smaller side, iterate on larger */ + if (j < (n-i)) { + stbtt__sort_edges_quicksort(p,j); + p = p+i; + n = n-i; + } else { + stbtt__sort_edges_quicksort(p+i, n-i); + n = j; + } + } +} + +static void stbtt__sort_edges(stbtt__edge *p, int n) +{ + stbtt__sort_edges_quicksort(p, n); + stbtt__sort_edges_ins_sort(p, n); +} + +typedef struct +{ + float x,y; +} stbtt__point; + +static void stbtt__rasterize(stbtt__bitmap *result, stbtt__point *pts, int *wcount, int windings, float scale_x, float scale_y, float shift_x, float shift_y, int off_x, int off_y, int invert, void *userdata) +{ + float y_scale_inv = invert ? -scale_y : scale_y; + stbtt__edge *e; + int n,i,j,k,m; +#if STBTT_RASTERIZER_VERSION == 1 + int vsubsample = result->h < 8 ? 15 : 5; +#elif STBTT_RASTERIZER_VERSION == 2 + int vsubsample = 1; +#else + #error "Unrecognized value of STBTT_RASTERIZER_VERSION" +#endif + // vsubsample should divide 255 evenly; otherwise we won't reach full opacity + + // now we have to blow out the windings into explicit edge lists + n = 0; + for (i=0; i < windings; ++i) + n += wcount[i]; + + e = (stbtt__edge *) STBTT_malloc(sizeof(*e) * (n+1), userdata); // add an extra one as a sentinel + if (e == 0) return; + n = 0; + + m=0; + for (i=0; i < windings; ++i) { + stbtt__point *p = pts + m; + m += wcount[i]; + j = wcount[i]-1; + for (k=0; k < wcount[i]; j=k++) { + int a=k,b=j; + // skip the edge if horizontal + if (p[j].y == p[k].y) + continue; + // add edge from j to k to the list + e[n].invert = 0; + if (invert ? p[j].y > p[k].y : p[j].y < p[k].y) { + e[n].invert = 1; + a=j,b=k; + } + e[n].x0 = p[a].x * scale_x + shift_x; + e[n].y0 = (p[a].y * y_scale_inv + shift_y) * vsubsample; + e[n].x1 = p[b].x * scale_x + shift_x; + e[n].y1 = (p[b].y * y_scale_inv + shift_y) * vsubsample; + ++n; + } + } + + // now sort the edges by their highest point (should snap to integer, and then by x) + //STBTT_sort(e, n, sizeof(e[0]), stbtt__edge_compare); + stbtt__sort_edges(e, n); + + // now, traverse the scanlines and find the intersections on each scanline, use xor winding rule + stbtt__rasterize_sorted_edges(result, e, n, vsubsample, off_x, off_y, userdata); + + STBTT_free(e, userdata); +} + +static void stbtt__add_point(stbtt__point *points, int n, float x, float y) +{ + if (!points) return; // during first pass, it's unallocated + points[n].x = x; + points[n].y = y; +} + +// tessellate until threshold p is happy... @TODO warped to compensate for non-linear stretching +static int stbtt__tesselate_curve(stbtt__point *points, int *num_points, float x0, float y0, float x1, float y1, float x2, float y2, float objspace_flatness_squared, int n) +{ + // midpoint + float mx = (x0 + 2*x1 + x2)/4; + float my = (y0 + 2*y1 + y2)/4; + // versus directly drawn line + float dx = (x0+x2)/2 - mx; + float dy = (y0+y2)/2 - my; + if (n > 16) // 65536 segments on one curve better be enough! + return 1; + if (dx*dx+dy*dy > objspace_flatness_squared) { // half-pixel error allowed... need to be smaller if AA + stbtt__tesselate_curve(points, num_points, x0,y0, (x0+x1)/2.0f,(y0+y1)/2.0f, mx,my, objspace_flatness_squared,n+1); + stbtt__tesselate_curve(points, num_points, mx,my, (x1+x2)/2.0f,(y1+y2)/2.0f, x2,y2, objspace_flatness_squared,n+1); + } else { + stbtt__add_point(points, *num_points,x2,y2); + *num_points = *num_points+1; + } + return 1; +} + +static void stbtt__tesselate_cubic(stbtt__point *points, int *num_points, float x0, float y0, float x1, float y1, float x2, float y2, float x3, float y3, float objspace_flatness_squared, int n) +{ + // @TODO this "flatness" calculation is just made-up nonsense that seems to work well enough + float dx0 = x1-x0; + float dy0 = y1-y0; + float dx1 = x2-x1; + float dy1 = y2-y1; + float dx2 = x3-x2; + float dy2 = y3-y2; + float dx = x3-x0; + float dy = y3-y0; + float longlen = (float) (STBTT_sqrt(dx0*dx0+dy0*dy0)+STBTT_sqrt(dx1*dx1+dy1*dy1)+STBTT_sqrt(dx2*dx2+dy2*dy2)); + float shortlen = (float) STBTT_sqrt(dx*dx+dy*dy); + float flatness_squared = longlen*longlen-shortlen*shortlen; + + if (n > 16) // 65536 segments on one curve better be enough! + return; + + if (flatness_squared > objspace_flatness_squared) { + float x01 = (x0+x1)/2; + float y01 = (y0+y1)/2; + float x12 = (x1+x2)/2; + float y12 = (y1+y2)/2; + float x23 = (x2+x3)/2; + float y23 = (y2+y3)/2; + + float xa = (x01+x12)/2; + float ya = (y01+y12)/2; + float xb = (x12+x23)/2; + float yb = (y12+y23)/2; + + float mx = (xa+xb)/2; + float my = (ya+yb)/2; + + stbtt__tesselate_cubic(points, num_points, x0,y0, x01,y01, xa,ya, mx,my, objspace_flatness_squared,n+1); + stbtt__tesselate_cubic(points, num_points, mx,my, xb,yb, x23,y23, x3,y3, objspace_flatness_squared,n+1); + } else { + stbtt__add_point(points, *num_points,x3,y3); + *num_points = *num_points+1; + } +} + +// returns number of contours +static stbtt__point *stbtt_FlattenCurves(stbtt_vertex *vertices, int num_verts, float objspace_flatness, int **contour_lengths, int *num_contours, void *userdata) +{ + stbtt__point *points=0; + int num_points=0; + + float objspace_flatness_squared = objspace_flatness * objspace_flatness; + int i,n=0,start=0, pass; + + // count how many "moves" there are to get the contour count + for (i=0; i < num_verts; ++i) + if (vertices[i].type == STBTT_vmove) + ++n; + + *num_contours = n; + if (n == 0) return 0; + + *contour_lengths = (int *) STBTT_malloc(sizeof(**contour_lengths) * n, userdata); + + if (*contour_lengths == 0) { + *num_contours = 0; + return 0; + } + + // make two passes through the points so we don't need to realloc + for (pass=0; pass < 2; ++pass) { + float x=0,y=0; + if (pass == 1) { + points = (stbtt__point *) STBTT_malloc(num_points * sizeof(points[0]), userdata); + if (points == NULL) goto error; + } + num_points = 0; + n= -1; + for (i=0; i < num_verts; ++i) { + switch (vertices[i].type) { + case STBTT_vmove: + // start the next contour + if (n >= 0) + (*contour_lengths)[n] = num_points - start; + ++n; + start = num_points; + + x = vertices[i].x, y = vertices[i].y; + stbtt__add_point(points, num_points++, x,y); + break; + case STBTT_vline: + x = vertices[i].x, y = vertices[i].y; + stbtt__add_point(points, num_points++, x, y); + break; + case STBTT_vcurve: + stbtt__tesselate_curve(points, &num_points, x,y, + vertices[i].cx, vertices[i].cy, + vertices[i].x, vertices[i].y, + objspace_flatness_squared, 0); + x = vertices[i].x, y = vertices[i].y; + break; + case STBTT_vcubic: + stbtt__tesselate_cubic(points, &num_points, x,y, + vertices[i].cx, vertices[i].cy, + vertices[i].cx1, vertices[i].cy1, + vertices[i].x, vertices[i].y, + objspace_flatness_squared, 0); + x = vertices[i].x, y = vertices[i].y; + break; + } + } + (*contour_lengths)[n] = num_points - start; + } + + return points; +error: + STBTT_free(points, userdata); + STBTT_free(*contour_lengths, userdata); + *contour_lengths = 0; + *num_contours = 0; + return NULL; +} + +STBTT_DEF void stbtt_Rasterize(stbtt__bitmap *result, float flatness_in_pixels, stbtt_vertex *vertices, int num_verts, float scale_x, float scale_y, float shift_x, float shift_y, int x_off, int y_off, int invert, void *userdata) +{ + float scale = scale_x > scale_y ? scale_y : scale_x; + int winding_count = 0; + int *winding_lengths = NULL; + stbtt__point *windings = stbtt_FlattenCurves(vertices, num_verts, flatness_in_pixels / scale, &winding_lengths, &winding_count, userdata); + if (windings) { + stbtt__rasterize(result, windings, winding_lengths, winding_count, scale_x, scale_y, shift_x, shift_y, x_off, y_off, invert, userdata); + STBTT_free(winding_lengths, userdata); + STBTT_free(windings, userdata); + } +} + +STBTT_DEF void stbtt_FreeBitmap(unsigned char *bitmap, void *userdata) +{ + STBTT_free(bitmap, userdata); +} + +STBTT_DEF unsigned char *stbtt_GetGlyphBitmapSubpixel(const stbtt_fontinfo *info, float scale_x, float scale_y, float shift_x, float shift_y, int glyph, int *width, int *height, int *xoff, int *yoff) +{ + int ix0,iy0,ix1,iy1; + stbtt__bitmap gbm; + stbtt_vertex *vertices; + int num_verts = stbtt_GetGlyphShape(info, glyph, &vertices); + + if (scale_x == 0) scale_x = scale_y; + if (scale_y == 0) { + if (scale_x == 0) { + STBTT_free(vertices, info->userdata); + return NULL; + } + scale_y = scale_x; + } + + stbtt_GetGlyphBitmapBoxSubpixel(info, glyph, scale_x, scale_y, shift_x, shift_y, &ix0,&iy0,&ix1,&iy1); + + // now we get the size + gbm.w = (ix1 - ix0); + gbm.h = (iy1 - iy0); + gbm.pixels = NULL; // in case we error + + if (width ) *width = gbm.w; + if (height) *height = gbm.h; + if (xoff ) *xoff = ix0; + if (yoff ) *yoff = iy0; + + if (gbm.w && gbm.h) { + gbm.pixels = (unsigned char *) STBTT_malloc(gbm.w * gbm.h, info->userdata); + if (gbm.pixels) { + gbm.stride = gbm.w; + + stbtt_Rasterize(&gbm, 0.35f, vertices, num_verts, scale_x, scale_y, shift_x, shift_y, ix0, iy0, 1, info->userdata); + } + } + STBTT_free(vertices, info->userdata); + return gbm.pixels; +} + +STBTT_DEF unsigned char *stbtt_GetGlyphBitmap(const stbtt_fontinfo *info, float scale_x, float scale_y, int glyph, int *width, int *height, int *xoff, int *yoff) +{ + return stbtt_GetGlyphBitmapSubpixel(info, scale_x, scale_y, 0.0f, 0.0f, glyph, width, height, xoff, yoff); +} + +STBTT_DEF void stbtt_MakeGlyphBitmapSubpixel(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, float shift_x, float shift_y, int glyph) +{ + int ix0,iy0; + stbtt_vertex *vertices; + int num_verts = stbtt_GetGlyphShape(info, glyph, &vertices); + stbtt__bitmap gbm; + + stbtt_GetGlyphBitmapBoxSubpixel(info, glyph, scale_x, scale_y, shift_x, shift_y, &ix0,&iy0,0,0); + gbm.pixels = output; + gbm.w = out_w; + gbm.h = out_h; + gbm.stride = out_stride; + + if (gbm.w && gbm.h) + stbtt_Rasterize(&gbm, 0.35f, vertices, num_verts, scale_x, scale_y, shift_x, shift_y, ix0,iy0, 1, info->userdata); + + STBTT_free(vertices, info->userdata); +} + +STBTT_DEF void stbtt_MakeGlyphBitmap(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, int glyph) +{ + stbtt_MakeGlyphBitmapSubpixel(info, output, out_w, out_h, out_stride, scale_x, scale_y, 0.0f,0.0f, glyph); +} + +STBTT_DEF unsigned char *stbtt_GetCodepointBitmapSubpixel(const stbtt_fontinfo *info, float scale_x, float scale_y, float shift_x, float shift_y, int codepoint, int *width, int *height, int *xoff, int *yoff) +{ + return stbtt_GetGlyphBitmapSubpixel(info, scale_x, scale_y,shift_x,shift_y, stbtt_FindGlyphIndex(info,codepoint), width,height,xoff,yoff); +} + +STBTT_DEF void stbtt_MakeCodepointBitmapSubpixelPrefilter(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, float shift_x, float shift_y, int oversample_x, int oversample_y, float *sub_x, float *sub_y, int codepoint) +{ + stbtt_MakeGlyphBitmapSubpixelPrefilter(info, output, out_w, out_h, out_stride, scale_x, scale_y, shift_x, shift_y, oversample_x, oversample_y, sub_x, sub_y, stbtt_FindGlyphIndex(info,codepoint)); +} + +STBTT_DEF void stbtt_MakeCodepointBitmapSubpixel(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, float shift_x, float shift_y, int codepoint) +{ + stbtt_MakeGlyphBitmapSubpixel(info, output, out_w, out_h, out_stride, scale_x, scale_y, shift_x, shift_y, stbtt_FindGlyphIndex(info,codepoint)); +} + +STBTT_DEF unsigned char *stbtt_GetCodepointBitmap(const stbtt_fontinfo *info, float scale_x, float scale_y, int codepoint, int *width, int *height, int *xoff, int *yoff) +{ + return stbtt_GetCodepointBitmapSubpixel(info, scale_x, scale_y, 0.0f,0.0f, codepoint, width,height,xoff,yoff); +} + +STBTT_DEF void stbtt_MakeCodepointBitmap(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, int codepoint) +{ + stbtt_MakeCodepointBitmapSubpixel(info, output, out_w, out_h, out_stride, scale_x, scale_y, 0.0f,0.0f, codepoint); +} + +////////////////////////////////////////////////////////////////////////////// +// +// bitmap baking +// +// This is SUPER-CRAPPY packing to keep source code small + +static int stbtt_BakeFontBitmap_internal(unsigned char *data, int offset, // font location (use offset=0 for plain .ttf) + float pixel_height, // height of font in pixels + unsigned char *pixels, int pw, int ph, // bitmap to be filled in + int first_char, int num_chars, // characters to bake + stbtt_bakedchar *chardata) +{ + float scale; + int x,y,bottom_y, i; + stbtt_fontinfo f; + f.userdata = NULL; + if (!stbtt_InitFont(&f, data, offset)) + return -1; + STBTT_memset(pixels, 0, pw*ph); // background of 0 around pixels + x=y=1; + bottom_y = 1; + + scale = stbtt_ScaleForPixelHeight(&f, pixel_height); + + for (i=0; i < num_chars; ++i) { + int advance, lsb, x0,y0,x1,y1,gw,gh; + int g = stbtt_FindGlyphIndex(&f, first_char + i); + stbtt_GetGlyphHMetrics(&f, g, &advance, &lsb); + stbtt_GetGlyphBitmapBox(&f, g, scale,scale, &x0,&y0,&x1,&y1); + gw = x1-x0; + gh = y1-y0; + if (x + gw + 1 >= pw) + y = bottom_y, x = 1; // advance to next row + if (y + gh + 1 >= ph) // check if it fits vertically AFTER potentially moving to next row + return -i; + STBTT_assert(x+gw < pw); + STBTT_assert(y+gh < ph); + stbtt_MakeGlyphBitmap(&f, pixels+x+y*pw, gw,gh,pw, scale,scale, g); + chardata[i].x0 = (stbtt_int16) x; + chardata[i].y0 = (stbtt_int16) y; + chardata[i].x1 = (stbtt_int16) (x + gw); + chardata[i].y1 = (stbtt_int16) (y + gh); + chardata[i].xadvance = scale * advance; + chardata[i].xoff = (float) x0; + chardata[i].yoff = (float) y0; + x = x + gw + 1; + if (y+gh+1 > bottom_y) + bottom_y = y+gh+1; + } + return bottom_y; +} + +STBTT_DEF void stbtt_GetBakedQuad(const stbtt_bakedchar *chardata, int pw, int ph, int char_index, float *xpos, float *ypos, stbtt_aligned_quad *q, int opengl_fillrule) +{ + float d3d_bias = opengl_fillrule ? 0 : -0.5f; + float ipw = 1.0f / pw, iph = 1.0f / ph; + const stbtt_bakedchar *b = chardata + char_index; + int round_x = STBTT_ifloor((*xpos + b->xoff) + 0.5f); + int round_y = STBTT_ifloor((*ypos + b->yoff) + 0.5f); + + q->x0 = round_x + d3d_bias; + q->y0 = round_y + d3d_bias; + q->x1 = round_x + b->x1 - b->x0 + d3d_bias; + q->y1 = round_y + b->y1 - b->y0 + d3d_bias; + + q->s0 = b->x0 * ipw; + q->t0 = b->y0 * iph; + q->s1 = b->x1 * ipw; + q->t1 = b->y1 * iph; + + *xpos += b->xadvance; +} + +////////////////////////////////////////////////////////////////////////////// +// +// rectangle packing replacement routines if you don't have stb_rect_pack.h +// + +#ifndef STB_RECT_PACK_VERSION + +typedef int stbrp_coord; + +//////////////////////////////////////////////////////////////////////////////////// +// // +// // +// COMPILER WARNING ?!?!? // +// // +// // +// if you get a compile warning due to these symbols being defined more than // +// once, move #include "stb_rect_pack.h" before #include "stb_truetype.h" // +// // +//////////////////////////////////////////////////////////////////////////////////// + +typedef struct +{ + int width,height; + int x,y,bottom_y; +} stbrp_context; + +typedef struct +{ + unsigned char x; +} stbrp_node; + +struct stbrp_rect +{ + stbrp_coord x,y; + int id,w,h,was_packed; +}; + +static void stbrp_init_target(stbrp_context *con, int pw, int ph, stbrp_node *nodes, int num_nodes) +{ + con->width = pw; + con->height = ph; + con->x = 0; + con->y = 0; + con->bottom_y = 0; + STBTT__NOTUSED(nodes); + STBTT__NOTUSED(num_nodes); +} + +static void stbrp_pack_rects(stbrp_context *con, stbrp_rect *rects, int num_rects) +{ + int i; + for (i=0; i < num_rects; ++i) { + if (con->x + rects[i].w > con->width) { + con->x = 0; + con->y = con->bottom_y; + } + if (con->y + rects[i].h > con->height) + break; + rects[i].x = con->x; + rects[i].y = con->y; + rects[i].was_packed = 1; + con->x += rects[i].w; + if (con->y + rects[i].h > con->bottom_y) + con->bottom_y = con->y + rects[i].h; + } + for ( ; i < num_rects; ++i) + rects[i].was_packed = 0; +} +#endif + +////////////////////////////////////////////////////////////////////////////// +// +// bitmap baking +// +// This is SUPER-AWESOME (tm Ryan Gordon) packing using stb_rect_pack.h. If +// stb_rect_pack.h isn't available, it uses the BakeFontBitmap strategy. + +STBTT_DEF int stbtt_PackBegin(stbtt_pack_context *spc, unsigned char *pixels, int pw, int ph, int stride_in_bytes, int padding, void *alloc_context) +{ + stbrp_context *context = (stbrp_context *) STBTT_malloc(sizeof(*context) ,alloc_context); + int num_nodes = pw - padding; + stbrp_node *nodes = (stbrp_node *) STBTT_malloc(sizeof(*nodes ) * num_nodes,alloc_context); + + if (context == NULL || nodes == NULL) { + if (context != NULL) STBTT_free(context, alloc_context); + if (nodes != NULL) STBTT_free(nodes , alloc_context); + return 0; + } + + spc->user_allocator_context = alloc_context; + spc->width = pw; + spc->height = ph; + spc->pixels = pixels; + spc->pack_info = context; + spc->nodes = nodes; + spc->padding = padding; + spc->stride_in_bytes = stride_in_bytes != 0 ? stride_in_bytes : pw; + spc->h_oversample = 1; + spc->v_oversample = 1; + spc->skip_missing = 0; + + stbrp_init_target(context, pw-padding, ph-padding, nodes, num_nodes); + + if (pixels) + STBTT_memset(pixels, 0, pw*ph); // background of 0 around pixels + + return 1; +} + +STBTT_DEF void stbtt_PackEnd (stbtt_pack_context *spc) +{ + STBTT_free(spc->nodes , spc->user_allocator_context); + STBTT_free(spc->pack_info, spc->user_allocator_context); +} + +STBTT_DEF void stbtt_PackSetOversampling(stbtt_pack_context *spc, unsigned int h_oversample, unsigned int v_oversample) +{ + STBTT_assert(h_oversample <= STBTT_MAX_OVERSAMPLE); + STBTT_assert(v_oversample <= STBTT_MAX_OVERSAMPLE); + if (h_oversample <= STBTT_MAX_OVERSAMPLE) + spc->h_oversample = h_oversample; + if (v_oversample <= STBTT_MAX_OVERSAMPLE) + spc->v_oversample = v_oversample; +} + +STBTT_DEF void stbtt_PackSetSkipMissingCodepoints(stbtt_pack_context *spc, int skip) +{ + spc->skip_missing = skip; +} + +#define STBTT__OVER_MASK (STBTT_MAX_OVERSAMPLE-1) + +static void stbtt__h_prefilter(unsigned char *pixels, int w, int h, int stride_in_bytes, unsigned int kernel_width) +{ + unsigned char buffer[STBTT_MAX_OVERSAMPLE]; + int safe_w = w - kernel_width; + int j; + STBTT_memset(buffer, 0, STBTT_MAX_OVERSAMPLE); // suppress bogus warning from VS2013 -analyze + for (j=0; j < h; ++j) { + int i; + unsigned int total; + STBTT_memset(buffer, 0, kernel_width); + + total = 0; + + // make kernel_width a constant in common cases so compiler can optimize out the divide + switch (kernel_width) { + case 2: + for (i=0; i <= safe_w; ++i) { + total += pixels[i] - buffer[i & STBTT__OVER_MASK]; + buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i]; + pixels[i] = (unsigned char) (total / 2); + } + break; + case 3: + for (i=0; i <= safe_w; ++i) { + total += pixels[i] - buffer[i & STBTT__OVER_MASK]; + buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i]; + pixels[i] = (unsigned char) (total / 3); + } + break; + case 4: + for (i=0; i <= safe_w; ++i) { + total += pixels[i] - buffer[i & STBTT__OVER_MASK]; + buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i]; + pixels[i] = (unsigned char) (total / 4); + } + break; + case 5: + for (i=0; i <= safe_w; ++i) { + total += pixels[i] - buffer[i & STBTT__OVER_MASK]; + buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i]; + pixels[i] = (unsigned char) (total / 5); + } + break; + default: + for (i=0; i <= safe_w; ++i) { + total += pixels[i] - buffer[i & STBTT__OVER_MASK]; + buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i]; + pixels[i] = (unsigned char) (total / kernel_width); + } + break; + } + + for (; i < w; ++i) { + STBTT_assert(pixels[i] == 0); + total -= buffer[i & STBTT__OVER_MASK]; + pixels[i] = (unsigned char) (total / kernel_width); + } + + pixels += stride_in_bytes; + } +} + +static void stbtt__v_prefilter(unsigned char *pixels, int w, int h, int stride_in_bytes, unsigned int kernel_width) +{ + unsigned char buffer[STBTT_MAX_OVERSAMPLE]; + int safe_h = h - kernel_width; + int j; + STBTT_memset(buffer, 0, STBTT_MAX_OVERSAMPLE); // suppress bogus warning from VS2013 -analyze + for (j=0; j < w; ++j) { + int i; + unsigned int total; + STBTT_memset(buffer, 0, kernel_width); + + total = 0; + + // make kernel_width a constant in common cases so compiler can optimize out the divide + switch (kernel_width) { + case 2: + for (i=0; i <= safe_h; ++i) { + total += pixels[i*stride_in_bytes] - buffer[i & STBTT__OVER_MASK]; + buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i*stride_in_bytes]; + pixels[i*stride_in_bytes] = (unsigned char) (total / 2); + } + break; + case 3: + for (i=0; i <= safe_h; ++i) { + total += pixels[i*stride_in_bytes] - buffer[i & STBTT__OVER_MASK]; + buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i*stride_in_bytes]; + pixels[i*stride_in_bytes] = (unsigned char) (total / 3); + } + break; + case 4: + for (i=0; i <= safe_h; ++i) { + total += pixels[i*stride_in_bytes] - buffer[i & STBTT__OVER_MASK]; + buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i*stride_in_bytes]; + pixels[i*stride_in_bytes] = (unsigned char) (total / 4); + } + break; + case 5: + for (i=0; i <= safe_h; ++i) { + total += pixels[i*stride_in_bytes] - buffer[i & STBTT__OVER_MASK]; + buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i*stride_in_bytes]; + pixels[i*stride_in_bytes] = (unsigned char) (total / 5); + } + break; + default: + for (i=0; i <= safe_h; ++i) { + total += pixels[i*stride_in_bytes] - buffer[i & STBTT__OVER_MASK]; + buffer[(i+kernel_width) & STBTT__OVER_MASK] = pixels[i*stride_in_bytes]; + pixels[i*stride_in_bytes] = (unsigned char) (total / kernel_width); + } + break; + } + + for (; i < h; ++i) { + STBTT_assert(pixels[i*stride_in_bytes] == 0); + total -= buffer[i & STBTT__OVER_MASK]; + pixels[i*stride_in_bytes] = (unsigned char) (total / kernel_width); + } + + pixels += 1; + } +} + +static float stbtt__oversample_shift(int oversample) +{ + if (!oversample) + return 0.0f; + + // The prefilter is a box filter of width "oversample", + // which shifts phase by (oversample - 1)/2 pixels in + // oversampled space. We want to shift in the opposite + // direction to counter this. + return (float)-(oversample - 1) / (2.0f * (float)oversample); +} + +// rects array must be big enough to accommodate all characters in the given ranges +STBTT_DEF int stbtt_PackFontRangesGatherRects(stbtt_pack_context *spc, const stbtt_fontinfo *info, stbtt_pack_range *ranges, int num_ranges, stbrp_rect *rects) +{ + int i,j,k; + int missing_glyph_added = 0; + + k=0; + for (i=0; i < num_ranges; ++i) { + float fh = ranges[i].font_size; + float scale = fh > 0 ? stbtt_ScaleForPixelHeight(info, fh) : stbtt_ScaleForMappingEmToPixels(info, -fh); + ranges[i].h_oversample = (unsigned char) spc->h_oversample; + ranges[i].v_oversample = (unsigned char) spc->v_oversample; + for (j=0; j < ranges[i].num_chars; ++j) { + int x0,y0,x1,y1; + int codepoint = ranges[i].array_of_unicode_codepoints == NULL ? ranges[i].first_unicode_codepoint_in_range + j : ranges[i].array_of_unicode_codepoints[j]; + int glyph = stbtt_FindGlyphIndex(info, codepoint); + if (glyph == 0 && (spc->skip_missing || missing_glyph_added)) { + rects[k].w = rects[k].h = 0; + } else { + stbtt_GetGlyphBitmapBoxSubpixel(info,glyph, + scale * spc->h_oversample, + scale * spc->v_oversample, + 0,0, + &x0,&y0,&x1,&y1); + rects[k].w = (stbrp_coord) (x1-x0 + spc->padding + spc->h_oversample-1); + rects[k].h = (stbrp_coord) (y1-y0 + spc->padding + spc->v_oversample-1); + if (glyph == 0) + missing_glyph_added = 1; + } + ++k; + } + } + + return k; +} + +STBTT_DEF void stbtt_MakeGlyphBitmapSubpixelPrefilter(const stbtt_fontinfo *info, unsigned char *output, int out_w, int out_h, int out_stride, float scale_x, float scale_y, float shift_x, float shift_y, int prefilter_x, int prefilter_y, float *sub_x, float *sub_y, int glyph) +{ + stbtt_MakeGlyphBitmapSubpixel(info, + output, + out_w - (prefilter_x - 1), + out_h - (prefilter_y - 1), + out_stride, + scale_x, + scale_y, + shift_x, + shift_y, + glyph); + + if (prefilter_x > 1) + stbtt__h_prefilter(output, out_w, out_h, out_stride, prefilter_x); + + if (prefilter_y > 1) + stbtt__v_prefilter(output, out_w, out_h, out_stride, prefilter_y); + + *sub_x = stbtt__oversample_shift(prefilter_x); + *sub_y = stbtt__oversample_shift(prefilter_y); +} + +// rects array must be big enough to accommodate all characters in the given ranges +STBTT_DEF int stbtt_PackFontRangesRenderIntoRects(stbtt_pack_context *spc, const stbtt_fontinfo *info, stbtt_pack_range *ranges, int num_ranges, stbrp_rect *rects) +{ + int i,j,k, missing_glyph = -1, return_value = 1; + + // save current values + int old_h_over = spc->h_oversample; + int old_v_over = spc->v_oversample; + + k = 0; + for (i=0; i < num_ranges; ++i) { + float fh = ranges[i].font_size; + float scale = fh > 0 ? stbtt_ScaleForPixelHeight(info, fh) : stbtt_ScaleForMappingEmToPixels(info, -fh); + float recip_h,recip_v,sub_x,sub_y; + spc->h_oversample = ranges[i].h_oversample; + spc->v_oversample = ranges[i].v_oversample; + recip_h = 1.0f / spc->h_oversample; + recip_v = 1.0f / spc->v_oversample; + sub_x = stbtt__oversample_shift(spc->h_oversample); + sub_y = stbtt__oversample_shift(spc->v_oversample); + for (j=0; j < ranges[i].num_chars; ++j) { + stbrp_rect *r = &rects[k]; + if (r->was_packed && r->w != 0 && r->h != 0) { + stbtt_packedchar *bc = &ranges[i].chardata_for_range[j]; + int advance, lsb, x0,y0,x1,y1; + int codepoint = ranges[i].array_of_unicode_codepoints == NULL ? ranges[i].first_unicode_codepoint_in_range + j : ranges[i].array_of_unicode_codepoints[j]; + int glyph = stbtt_FindGlyphIndex(info, codepoint); + stbrp_coord pad = (stbrp_coord) spc->padding; + + // pad on left and top + r->x += pad; + r->y += pad; + r->w -= pad; + r->h -= pad; + stbtt_GetGlyphHMetrics(info, glyph, &advance, &lsb); + stbtt_GetGlyphBitmapBox(info, glyph, + scale * spc->h_oversample, + scale * spc->v_oversample, + &x0,&y0,&x1,&y1); + stbtt_MakeGlyphBitmapSubpixel(info, + spc->pixels + r->x + r->y*spc->stride_in_bytes, + r->w - spc->h_oversample+1, + r->h - spc->v_oversample+1, + spc->stride_in_bytes, + scale * spc->h_oversample, + scale * spc->v_oversample, + 0,0, + glyph); + + if (spc->h_oversample > 1) + stbtt__h_prefilter(spc->pixels + r->x + r->y*spc->stride_in_bytes, + r->w, r->h, spc->stride_in_bytes, + spc->h_oversample); + + if (spc->v_oversample > 1) + stbtt__v_prefilter(spc->pixels + r->x + r->y*spc->stride_in_bytes, + r->w, r->h, spc->stride_in_bytes, + spc->v_oversample); + + bc->x0 = (stbtt_int16) r->x; + bc->y0 = (stbtt_int16) r->y; + bc->x1 = (stbtt_int16) (r->x + r->w); + bc->y1 = (stbtt_int16) (r->y + r->h); + bc->xadvance = scale * advance; + bc->xoff = (float) x0 * recip_h + sub_x; + bc->yoff = (float) y0 * recip_v + sub_y; + bc->xoff2 = (x0 + r->w) * recip_h + sub_x; + bc->yoff2 = (y0 + r->h) * recip_v + sub_y; + + if (glyph == 0) + missing_glyph = j; + } else if (spc->skip_missing) { + return_value = 0; + } else if (r->was_packed && r->w == 0 && r->h == 0 && missing_glyph >= 0) { + ranges[i].chardata_for_range[j] = ranges[i].chardata_for_range[missing_glyph]; + } else { + return_value = 0; // if any fail, report failure + } + + ++k; + } + } + + // restore original values + spc->h_oversample = old_h_over; + spc->v_oversample = old_v_over; + + return return_value; +} + +STBTT_DEF void stbtt_PackFontRangesPackRects(stbtt_pack_context *spc, stbrp_rect *rects, int num_rects) +{ + stbrp_pack_rects((stbrp_context *) spc->pack_info, rects, num_rects); +} + +STBTT_DEF int stbtt_PackFontRanges(stbtt_pack_context *spc, const unsigned char *fontdata, int font_index, stbtt_pack_range *ranges, int num_ranges) +{ + stbtt_fontinfo info; + int i,j,n, return_value = 1; + //stbrp_context *context = (stbrp_context *) spc->pack_info; + stbrp_rect *rects; + + // flag all characters as NOT packed + for (i=0; i < num_ranges; ++i) + for (j=0; j < ranges[i].num_chars; ++j) + ranges[i].chardata_for_range[j].x0 = + ranges[i].chardata_for_range[j].y0 = + ranges[i].chardata_for_range[j].x1 = + ranges[i].chardata_for_range[j].y1 = 0; + + n = 0; + for (i=0; i < num_ranges; ++i) + n += ranges[i].num_chars; + + rects = (stbrp_rect *) STBTT_malloc(sizeof(*rects) * n, spc->user_allocator_context); + if (rects == NULL) + return 0; + + info.userdata = spc->user_allocator_context; + stbtt_InitFont(&info, fontdata, stbtt_GetFontOffsetForIndex(fontdata,font_index)); + + n = stbtt_PackFontRangesGatherRects(spc, &info, ranges, num_ranges, rects); + + stbtt_PackFontRangesPackRects(spc, rects, n); + + return_value = stbtt_PackFontRangesRenderIntoRects(spc, &info, ranges, num_ranges, rects); + + STBTT_free(rects, spc->user_allocator_context); + return return_value; +} + +STBTT_DEF int stbtt_PackFontRange(stbtt_pack_context *spc, const unsigned char *fontdata, int font_index, float font_size, + int first_unicode_codepoint_in_range, int num_chars_in_range, stbtt_packedchar *chardata_for_range) +{ + stbtt_pack_range range; + range.first_unicode_codepoint_in_range = first_unicode_codepoint_in_range; + range.array_of_unicode_codepoints = NULL; + range.num_chars = num_chars_in_range; + range.chardata_for_range = chardata_for_range; + range.font_size = font_size; + return stbtt_PackFontRanges(spc, fontdata, font_index, &range, 1); +} + +STBTT_DEF void stbtt_GetScaledFontVMetrics(const unsigned char *fontdata, int index, float size, float *ascent, float *descent, float *lineGap) +{ + int i_ascent, i_descent, i_lineGap; + float scale; + stbtt_fontinfo info; + stbtt_InitFont(&info, fontdata, stbtt_GetFontOffsetForIndex(fontdata, index)); + scale = size > 0 ? stbtt_ScaleForPixelHeight(&info, size) : stbtt_ScaleForMappingEmToPixels(&info, -size); + stbtt_GetFontVMetrics(&info, &i_ascent, &i_descent, &i_lineGap); + *ascent = (float) i_ascent * scale; + *descent = (float) i_descent * scale; + *lineGap = (float) i_lineGap * scale; +} + +STBTT_DEF void stbtt_GetPackedQuad(const stbtt_packedchar *chardata, int pw, int ph, int char_index, float *xpos, float *ypos, stbtt_aligned_quad *q, int align_to_integer) +{ + float ipw = 1.0f / pw, iph = 1.0f / ph; + const stbtt_packedchar *b = chardata + char_index; + + if (align_to_integer) { + float x = (float) STBTT_ifloor((*xpos + b->xoff) + 0.5f); + float y = (float) STBTT_ifloor((*ypos + b->yoff) + 0.5f); + q->x0 = x; + q->y0 = y; + q->x1 = x + b->xoff2 - b->xoff; + q->y1 = y + b->yoff2 - b->yoff; + } else { + q->x0 = *xpos + b->xoff; + q->y0 = *ypos + b->yoff; + q->x1 = *xpos + b->xoff2; + q->y1 = *ypos + b->yoff2; + } + + q->s0 = b->x0 * ipw; + q->t0 = b->y0 * iph; + q->s1 = b->x1 * ipw; + q->t1 = b->y1 * iph; + + *xpos += b->xadvance; +} + +////////////////////////////////////////////////////////////////////////////// +// +// sdf computation +// + +#define STBTT_min(a,b) ((a) < (b) ? (a) : (b)) +#define STBTT_max(a,b) ((a) < (b) ? (b) : (a)) + +static int stbtt__ray_intersect_bezier(float orig[2], float ray[2], float q0[2], float q1[2], float q2[2], float hits[2][2]) +{ + float q0perp = q0[1]*ray[0] - q0[0]*ray[1]; + float q1perp = q1[1]*ray[0] - q1[0]*ray[1]; + float q2perp = q2[1]*ray[0] - q2[0]*ray[1]; + float roperp = orig[1]*ray[0] - orig[0]*ray[1]; + + float a = q0perp - 2*q1perp + q2perp; + float b = q1perp - q0perp; + float c = q0perp - roperp; + + float s0 = 0., s1 = 0.; + int num_s = 0; + + if (a != 0.0) { + float discr = b*b - a*c; + if (discr > 0.0) { + float rcpna = -1 / a; + float d = (float) STBTT_sqrt(discr); + s0 = (b+d) * rcpna; + s1 = (b-d) * rcpna; + if (s0 >= 0.0 && s0 <= 1.0) + num_s = 1; + if (d > 0.0 && s1 >= 0.0 && s1 <= 1.0) { + if (num_s == 0) s0 = s1; + ++num_s; + } + } + } else { + // 2*b*s + c = 0 + // s = -c / (2*b) + s0 = c / (-2 * b); + if (s0 >= 0.0 && s0 <= 1.0) + num_s = 1; + } + + if (num_s == 0) + return 0; + else { + float rcp_len2 = 1 / (ray[0]*ray[0] + ray[1]*ray[1]); + float rayn_x = ray[0] * rcp_len2, rayn_y = ray[1] * rcp_len2; + + float q0d = q0[0]*rayn_x + q0[1]*rayn_y; + float q1d = q1[0]*rayn_x + q1[1]*rayn_y; + float q2d = q2[0]*rayn_x + q2[1]*rayn_y; + float rod = orig[0]*rayn_x + orig[1]*rayn_y; + + float q10d = q1d - q0d; + float q20d = q2d - q0d; + float q0rd = q0d - rod; + + hits[0][0] = q0rd + s0*(2.0f - 2.0f*s0)*q10d + s0*s0*q20d; + hits[0][1] = a*s0+b; + + if (num_s > 1) { + hits[1][0] = q0rd + s1*(2.0f - 2.0f*s1)*q10d + s1*s1*q20d; + hits[1][1] = a*s1+b; + return 2; + } else { + return 1; + } + } +} + +static int equal(float *a, float *b) +{ + return (a[0] == b[0] && a[1] == b[1]); +} + +static int stbtt__compute_crossings_x(float x, float y, int nverts, stbtt_vertex *verts) +{ + int i; + float orig[2], ray[2] = { 1, 0 }; + float y_frac; + int winding = 0; + + // make sure y never passes through a vertex of the shape + y_frac = (float) STBTT_fmod(y, 1.0f); + if (y_frac < 0.01f) + y += 0.01f; + else if (y_frac > 0.99f) + y -= 0.01f; + + orig[0] = x; + orig[1] = y; + + // test a ray from (-infinity,y) to (x,y) + for (i=0; i < nverts; ++i) { + if (verts[i].type == STBTT_vline) { + int x0 = (int) verts[i-1].x, y0 = (int) verts[i-1].y; + int x1 = (int) verts[i ].x, y1 = (int) verts[i ].y; + if (y > STBTT_min(y0,y1) && y < STBTT_max(y0,y1) && x > STBTT_min(x0,x1)) { + float x_inter = (y - y0) / (y1 - y0) * (x1-x0) + x0; + if (x_inter < x) + winding += (y0 < y1) ? 1 : -1; + } + } + if (verts[i].type == STBTT_vcurve) { + int x0 = (int) verts[i-1].x , y0 = (int) verts[i-1].y ; + int x1 = (int) verts[i ].cx, y1 = (int) verts[i ].cy; + int x2 = (int) verts[i ].x , y2 = (int) verts[i ].y ; + int ax = STBTT_min(x0,STBTT_min(x1,x2)), ay = STBTT_min(y0,STBTT_min(y1,y2)); + int by = STBTT_max(y0,STBTT_max(y1,y2)); + if (y > ay && y < by && x > ax) { + float q0[2],q1[2],q2[2]; + float hits[2][2]; + q0[0] = (float)x0; + q0[1] = (float)y0; + q1[0] = (float)x1; + q1[1] = (float)y1; + q2[0] = (float)x2; + q2[1] = (float)y2; + if (equal(q0,q1) || equal(q1,q2)) { + x0 = (int)verts[i-1].x; + y0 = (int)verts[i-1].y; + x1 = (int)verts[i ].x; + y1 = (int)verts[i ].y; + if (y > STBTT_min(y0,y1) && y < STBTT_max(y0,y1) && x > STBTT_min(x0,x1)) { + float x_inter = (y - y0) / (y1 - y0) * (x1-x0) + x0; + if (x_inter < x) + winding += (y0 < y1) ? 1 : -1; + } + } else { + int num_hits = stbtt__ray_intersect_bezier(orig, ray, q0, q1, q2, hits); + if (num_hits >= 1) + if (hits[0][0] < 0) + winding += (hits[0][1] < 0 ? -1 : 1); + if (num_hits >= 2) + if (hits[1][0] < 0) + winding += (hits[1][1] < 0 ? -1 : 1); + } + } + } + } + return winding; +} + +static float stbtt__cuberoot( float x ) +{ + if (x<0) + return -(float) STBTT_pow(-x,1.0f/3.0f); + else + return (float) STBTT_pow( x,1.0f/3.0f); +} + +// x^3 + a*x^2 + b*x + c = 0 +static int stbtt__solve_cubic(float a, float b, float c, float* r) +{ + float s = -a / 3; + float p = b - a*a / 3; + float q = a * (2*a*a - 9*b) / 27 + c; + float p3 = p*p*p; + float d = q*q + 4*p3 / 27; + if (d >= 0) { + float z = (float) STBTT_sqrt(d); + float u = (-q + z) / 2; + float v = (-q - z) / 2; + u = stbtt__cuberoot(u); + v = stbtt__cuberoot(v); + r[0] = s + u + v; + return 1; + } else { + float u = (float) STBTT_sqrt(-p/3); + float v = (float) STBTT_acos(-STBTT_sqrt(-27/p3) * q / 2) / 3; // p3 must be negative, since d is negative + float m = (float) STBTT_cos(v); + float n = (float) STBTT_cos(v-3.141592/2)*1.732050808f; + r[0] = s + u * 2 * m; + r[1] = s - u * (m + n); + r[2] = s - u * (m - n); + + //STBTT_assert( STBTT_fabs(((r[0]+a)*r[0]+b)*r[0]+c) < 0.05f); // these asserts may not be safe at all scales, though they're in bezier t parameter units so maybe? + //STBTT_assert( STBTT_fabs(((r[1]+a)*r[1]+b)*r[1]+c) < 0.05f); + //STBTT_assert( STBTT_fabs(((r[2]+a)*r[2]+b)*r[2]+c) < 0.05f); + return 3; + } +} + +STBTT_DEF unsigned char * stbtt_GetGlyphSDF(const stbtt_fontinfo *info, float scale, int glyph, int padding, unsigned char onedge_value, float pixel_dist_scale, int *width, int *height, int *xoff, int *yoff) +{ + float scale_x = scale, scale_y = scale; + int ix0,iy0,ix1,iy1; + int w,h; + unsigned char *data; + + if (scale == 0) return NULL; + + stbtt_GetGlyphBitmapBoxSubpixel(info, glyph, scale, scale, 0.0f,0.0f, &ix0,&iy0,&ix1,&iy1); + + // if empty, return NULL + if (ix0 == ix1 || iy0 == iy1) + return NULL; + + ix0 -= padding; + iy0 -= padding; + ix1 += padding; + iy1 += padding; + + w = (ix1 - ix0); + h = (iy1 - iy0); + + if (width ) *width = w; + if (height) *height = h; + if (xoff ) *xoff = ix0; + if (yoff ) *yoff = iy0; + + // invert for y-downwards bitmaps + scale_y = -scale_y; + + { + int x,y,i,j; + float *precompute; + stbtt_vertex *verts; + int num_verts = stbtt_GetGlyphShape(info, glyph, &verts); + data = (unsigned char *) STBTT_malloc(w * h, info->userdata); + precompute = (float *) STBTT_malloc(num_verts * sizeof(float), info->userdata); + + for (i=0,j=num_verts-1; i < num_verts; j=i++) { + if (verts[i].type == STBTT_vline) { + float x0 = verts[i].x*scale_x, y0 = verts[i].y*scale_y; + float x1 = verts[j].x*scale_x, y1 = verts[j].y*scale_y; + float dist = (float) STBTT_sqrt((x1-x0)*(x1-x0) + (y1-y0)*(y1-y0)); + precompute[i] = (dist == 0) ? 0.0f : 1.0f / dist; + } else if (verts[i].type == STBTT_vcurve) { + float x2 = verts[j].x *scale_x, y2 = verts[j].y *scale_y; + float x1 = verts[i].cx*scale_x, y1 = verts[i].cy*scale_y; + float x0 = verts[i].x *scale_x, y0 = verts[i].y *scale_y; + float bx = x0 - 2*x1 + x2, by = y0 - 2*y1 + y2; + float len2 = bx*bx + by*by; + if (len2 != 0.0f) + precompute[i] = 1.0f / (bx*bx + by*by); + else + precompute[i] = 0.0f; + } else + precompute[i] = 0.0f; + } + + for (y=iy0; y < iy1; ++y) { + for (x=ix0; x < ix1; ++x) { + float val; + float min_dist = 999999.0f; + float sx = (float) x + 0.5f; + float sy = (float) y + 0.5f; + float x_gspace = (sx / scale_x); + float y_gspace = (sy / scale_y); + + int winding = stbtt__compute_crossings_x(x_gspace, y_gspace, num_verts, verts); // @OPTIMIZE: this could just be a rasterization, but needs to be line vs. non-tesselated curves so a new path + + for (i=0; i < num_verts; ++i) { + float x0 = verts[i].x*scale_x, y0 = verts[i].y*scale_y; + + if (verts[i].type == STBTT_vline && precompute[i] != 0.0f) { + float x1 = verts[i-1].x*scale_x, y1 = verts[i-1].y*scale_y; + + float dist,dist2 = (x0-sx)*(x0-sx) + (y0-sy)*(y0-sy); + if (dist2 < min_dist*min_dist) + min_dist = (float) STBTT_sqrt(dist2); + + // coarse culling against bbox + //if (sx > STBTT_min(x0,x1)-min_dist && sx < STBTT_max(x0,x1)+min_dist && + // sy > STBTT_min(y0,y1)-min_dist && sy < STBTT_max(y0,y1)+min_dist) + dist = (float) STBTT_fabs((x1-x0)*(y0-sy) - (y1-y0)*(x0-sx)) * precompute[i]; + STBTT_assert(i != 0); + if (dist < min_dist) { + // check position along line + // x' = x0 + t*(x1-x0), y' = y0 + t*(y1-y0) + // minimize (x'-sx)*(x'-sx)+(y'-sy)*(y'-sy) + float dx = x1-x0, dy = y1-y0; + float px = x0-sx, py = y0-sy; + // minimize (px+t*dx)^2 + (py+t*dy)^2 = px*px + 2*px*dx*t + t^2*dx*dx + py*py + 2*py*dy*t + t^2*dy*dy + // derivative: 2*px*dx + 2*py*dy + (2*dx*dx+2*dy*dy)*t, set to 0 and solve + float t = -(px*dx + py*dy) / (dx*dx + dy*dy); + if (t >= 0.0f && t <= 1.0f) + min_dist = dist; + } + } else if (verts[i].type == STBTT_vcurve) { + float x2 = verts[i-1].x *scale_x, y2 = verts[i-1].y *scale_y; + float x1 = verts[i ].cx*scale_x, y1 = verts[i ].cy*scale_y; + float box_x0 = STBTT_min(STBTT_min(x0,x1),x2); + float box_y0 = STBTT_min(STBTT_min(y0,y1),y2); + float box_x1 = STBTT_max(STBTT_max(x0,x1),x2); + float box_y1 = STBTT_max(STBTT_max(y0,y1),y2); + // coarse culling against bbox to avoid computing cubic unnecessarily + if (sx > box_x0-min_dist && sx < box_x1+min_dist && sy > box_y0-min_dist && sy < box_y1+min_dist) { + int num=0; + float ax = x1-x0, ay = y1-y0; + float bx = x0 - 2*x1 + x2, by = y0 - 2*y1 + y2; + float mx = x0 - sx, my = y0 - sy; + float res[3] = {0.f,0.f,0.f}; + float px,py,t,it,dist2; + float a_inv = precompute[i]; + if (a_inv == 0.0) { // if a_inv is 0, it's 2nd degree so use quadratic formula + float a = 3*(ax*bx + ay*by); + float b = 2*(ax*ax + ay*ay) + (mx*bx+my*by); + float c = mx*ax+my*ay; + if (a == 0.0) { // if a is 0, it's linear + if (b != 0.0) { + res[num++] = -c/b; + } + } else { + float discriminant = b*b - 4*a*c; + if (discriminant < 0) + num = 0; + else { + float root = (float) STBTT_sqrt(discriminant); + res[0] = (-b - root)/(2*a); + res[1] = (-b + root)/(2*a); + num = 2; // don't bother distinguishing 1-solution case, as code below will still work + } + } + } else { + float b = 3*(ax*bx + ay*by) * a_inv; // could precompute this as it doesn't depend on sample point + float c = (2*(ax*ax + ay*ay) + (mx*bx+my*by)) * a_inv; + float d = (mx*ax+my*ay) * a_inv; + num = stbtt__solve_cubic(b, c, d, res); + } + dist2 = (x0-sx)*(x0-sx) + (y0-sy)*(y0-sy); + if (dist2 < min_dist*min_dist) + min_dist = (float) STBTT_sqrt(dist2); + + if (num >= 1 && res[0] >= 0.0f && res[0] <= 1.0f) { + t = res[0], it = 1.0f - t; + px = it*it*x0 + 2*t*it*x1 + t*t*x2; + py = it*it*y0 + 2*t*it*y1 + t*t*y2; + dist2 = (px-sx)*(px-sx) + (py-sy)*(py-sy); + if (dist2 < min_dist * min_dist) + min_dist = (float) STBTT_sqrt(dist2); + } + if (num >= 2 && res[1] >= 0.0f && res[1] <= 1.0f) { + t = res[1], it = 1.0f - t; + px = it*it*x0 + 2*t*it*x1 + t*t*x2; + py = it*it*y0 + 2*t*it*y1 + t*t*y2; + dist2 = (px-sx)*(px-sx) + (py-sy)*(py-sy); + if (dist2 < min_dist * min_dist) + min_dist = (float) STBTT_sqrt(dist2); + } + if (num >= 3 && res[2] >= 0.0f && res[2] <= 1.0f) { + t = res[2], it = 1.0f - t; + px = it*it*x0 + 2*t*it*x1 + t*t*x2; + py = it*it*y0 + 2*t*it*y1 + t*t*y2; + dist2 = (px-sx)*(px-sx) + (py-sy)*(py-sy); + if (dist2 < min_dist * min_dist) + min_dist = (float) STBTT_sqrt(dist2); + } + } + } + } + if (winding == 0) + min_dist = -min_dist; // if outside the shape, value is negative + val = onedge_value + pixel_dist_scale * min_dist; + if (val < 0) + val = 0; + else if (val > 255) + val = 255; + data[(y-iy0)*w+(x-ix0)] = (unsigned char) val; + } + } + STBTT_free(precompute, info->userdata); + STBTT_free(verts, info->userdata); + } + return data; +} + +STBTT_DEF unsigned char * stbtt_GetCodepointSDF(const stbtt_fontinfo *info, float scale, int codepoint, int padding, unsigned char onedge_value, float pixel_dist_scale, int *width, int *height, int *xoff, int *yoff) +{ + return stbtt_GetGlyphSDF(info, scale, stbtt_FindGlyphIndex(info, codepoint), padding, onedge_value, pixel_dist_scale, width, height, xoff, yoff); +} + +STBTT_DEF void stbtt_FreeSDF(unsigned char *bitmap, void *userdata) +{ + STBTT_free(bitmap, userdata); +} + +////////////////////////////////////////////////////////////////////////////// +// +// font name matching -- recommended not to use this +// + +// check if a utf8 string contains a prefix which is the utf16 string; if so return length of matching utf8 string +static stbtt_int32 stbtt__CompareUTF8toUTF16_bigendian_prefix(stbtt_uint8 *s1, stbtt_int32 len1, stbtt_uint8 *s2, stbtt_int32 len2) +{ + stbtt_int32 i=0; + + // convert utf16 to utf8 and compare the results while converting + while (len2) { + stbtt_uint16 ch = s2[0]*256 + s2[1]; + if (ch < 0x80) { + if (i >= len1) return -1; + if (s1[i++] != ch) return -1; + } else if (ch < 0x800) { + if (i+1 >= len1) return -1; + if (s1[i++] != 0xc0 + (ch >> 6)) return -1; + if (s1[i++] != 0x80 + (ch & 0x3f)) return -1; + } else if (ch >= 0xd800 && ch < 0xdc00) { + stbtt_uint32 c; + stbtt_uint16 ch2 = s2[2]*256 + s2[3]; + if (i+3 >= len1) return -1; + c = ((ch - 0xd800) << 10) + (ch2 - 0xdc00) + 0x10000; + if (s1[i++] != 0xf0 + (c >> 18)) return -1; + if (s1[i++] != 0x80 + ((c >> 12) & 0x3f)) return -1; + if (s1[i++] != 0x80 + ((c >> 6) & 0x3f)) return -1; + if (s1[i++] != 0x80 + ((c ) & 0x3f)) return -1; + s2 += 2; // plus another 2 below + len2 -= 2; + } else if (ch >= 0xdc00 && ch < 0xe000) { + return -1; + } else { + if (i+2 >= len1) return -1; + if (s1[i++] != 0xe0 + (ch >> 12)) return -1; + if (s1[i++] != 0x80 + ((ch >> 6) & 0x3f)) return -1; + if (s1[i++] != 0x80 + ((ch ) & 0x3f)) return -1; + } + s2 += 2; + len2 -= 2; + } + return i; +} + +static int stbtt_CompareUTF8toUTF16_bigendian_internal(char *s1, int len1, char *s2, int len2) +{ + return len1 == stbtt__CompareUTF8toUTF16_bigendian_prefix((stbtt_uint8*) s1, len1, (stbtt_uint8*) s2, len2); +} + +// returns results in whatever encoding you request... but note that 2-byte encodings +// will be BIG-ENDIAN... use stbtt_CompareUTF8toUTF16_bigendian() to compare +STBTT_DEF const char *stbtt_GetFontNameString(const stbtt_fontinfo *font, int *length, int platformID, int encodingID, int languageID, int nameID) +{ + stbtt_int32 i,count,stringOffset; + stbtt_uint8 *fc = font->data; + stbtt_uint32 offset = font->fontstart; + stbtt_uint32 nm = stbtt__find_table(fc, offset, "name"); + if (!nm) return NULL; + + count = ttUSHORT(fc+nm+2); + stringOffset = nm + ttUSHORT(fc+nm+4); + for (i=0; i < count; ++i) { + stbtt_uint32 loc = nm + 6 + 12 * i; + if (platformID == ttUSHORT(fc+loc+0) && encodingID == ttUSHORT(fc+loc+2) + && languageID == ttUSHORT(fc+loc+4) && nameID == ttUSHORT(fc+loc+6)) { + *length = ttUSHORT(fc+loc+8); + return (const char *) (fc+stringOffset+ttUSHORT(fc+loc+10)); + } + } + return NULL; +} + +static int stbtt__matchpair(stbtt_uint8 *fc, stbtt_uint32 nm, stbtt_uint8 *name, stbtt_int32 nlen, stbtt_int32 target_id, stbtt_int32 next_id) +{ + stbtt_int32 i; + stbtt_int32 count = ttUSHORT(fc+nm+2); + stbtt_int32 stringOffset = nm + ttUSHORT(fc+nm+4); + + for (i=0; i < count; ++i) { + stbtt_uint32 loc = nm + 6 + 12 * i; + stbtt_int32 id = ttUSHORT(fc+loc+6); + if (id == target_id) { + // find the encoding + stbtt_int32 platform = ttUSHORT(fc+loc+0), encoding = ttUSHORT(fc+loc+2), language = ttUSHORT(fc+loc+4); + + // is this a Unicode encoding? + if (platform == 0 || (platform == 3 && encoding == 1) || (platform == 3 && encoding == 10)) { + stbtt_int32 slen = ttUSHORT(fc+loc+8); + stbtt_int32 off = ttUSHORT(fc+loc+10); + + // check if there's a prefix match + stbtt_int32 matchlen = stbtt__CompareUTF8toUTF16_bigendian_prefix(name, nlen, fc+stringOffset+off,slen); + if (matchlen >= 0) { + // check for target_id+1 immediately following, with same encoding & language + if (i+1 < count && ttUSHORT(fc+loc+12+6) == next_id && ttUSHORT(fc+loc+12) == platform && ttUSHORT(fc+loc+12+2) == encoding && ttUSHORT(fc+loc+12+4) == language) { + slen = ttUSHORT(fc+loc+12+8); + off = ttUSHORT(fc+loc+12+10); + if (slen == 0) { + if (matchlen == nlen) + return 1; + } else if (matchlen < nlen && name[matchlen] == ' ') { + ++matchlen; + if (stbtt_CompareUTF8toUTF16_bigendian_internal((char*) (name+matchlen), nlen-matchlen, (char*)(fc+stringOffset+off),slen)) + return 1; + } + } else { + // if nothing immediately following + if (matchlen == nlen) + return 1; + } + } + } + + // @TODO handle other encodings + } + } + return 0; +} + +static int stbtt__matches(stbtt_uint8 *fc, stbtt_uint32 offset, stbtt_uint8 *name, stbtt_int32 flags) +{ + stbtt_int32 nlen = (stbtt_int32) STBTT_strlen((char *) name); + stbtt_uint32 nm,hd; + if (!stbtt__isfont(fc+offset)) return 0; + + // check italics/bold/underline flags in macStyle... + if (flags) { + hd = stbtt__find_table(fc, offset, "head"); + if ((ttUSHORT(fc+hd+44) & 7) != (flags & 7)) return 0; + } + + nm = stbtt__find_table(fc, offset, "name"); + if (!nm) return 0; + + if (flags) { + // if we checked the macStyle flags, then just check the family and ignore the subfamily + if (stbtt__matchpair(fc, nm, name, nlen, 16, -1)) return 1; + if (stbtt__matchpair(fc, nm, name, nlen, 1, -1)) return 1; + if (stbtt__matchpair(fc, nm, name, nlen, 3, -1)) return 1; + } else { + if (stbtt__matchpair(fc, nm, name, nlen, 16, 17)) return 1; + if (stbtt__matchpair(fc, nm, name, nlen, 1, 2)) return 1; + if (stbtt__matchpair(fc, nm, name, nlen, 3, -1)) return 1; + } + + return 0; +} + +static int stbtt_FindMatchingFont_internal(unsigned char *font_collection, char *name_utf8, stbtt_int32 flags) +{ + stbtt_int32 i; + for (i=0;;++i) { + stbtt_int32 off = stbtt_GetFontOffsetForIndex(font_collection, i); + if (off < 0) return off; + if (stbtt__matches((stbtt_uint8 *) font_collection, off, (stbtt_uint8*) name_utf8, flags)) + return off; + } +} + +#if defined(__GNUC__) || defined(__clang__) +#pragma GCC diagnostic push +#pragma GCC diagnostic ignored "-Wcast-qual" +#endif + +STBTT_DEF int stbtt_BakeFontBitmap(const unsigned char *data, int offset, + float pixel_height, unsigned char *pixels, int pw, int ph, + int first_char, int num_chars, stbtt_bakedchar *chardata) +{ + return stbtt_BakeFontBitmap_internal((unsigned char *) data, offset, pixel_height, pixels, pw, ph, first_char, num_chars, chardata); +} + +STBTT_DEF int stbtt_GetFontOffsetForIndex(const unsigned char *data, int index) +{ + return stbtt_GetFontOffsetForIndex_internal((unsigned char *) data, index); +} + +STBTT_DEF int stbtt_GetNumberOfFonts(const unsigned char *data) +{ + return stbtt_GetNumberOfFonts_internal((unsigned char *) data); +} + +STBTT_DEF int stbtt_InitFont(stbtt_fontinfo *info, const unsigned char *data, int offset) +{ + return stbtt_InitFont_internal(info, (unsigned char *) data, offset); +} + +STBTT_DEF int stbtt_FindMatchingFont(const unsigned char *fontdata, const char *name, int flags) +{ + return stbtt_FindMatchingFont_internal((unsigned char *) fontdata, (char *) name, flags); +} + +STBTT_DEF int stbtt_CompareUTF8toUTF16_bigendian(const char *s1, int len1, const char *s2, int len2) +{ + return stbtt_CompareUTF8toUTF16_bigendian_internal((char *) s1, len1, (char *) s2, len2); +} + +#if defined(__GNUC__) || defined(__clang__) +#pragma GCC diagnostic pop +#endif + +#endif // STB_TRUETYPE_IMPLEMENTATION + + +// FULL VERSION HISTORY +// +// 1.25 (2021-07-11) many fixes +// 1.24 (2020-02-05) fix warning +// 1.23 (2020-02-02) query SVG data for glyphs; query whole kerning table (but only kern not GPOS) +// 1.22 (2019-08-11) minimize missing-glyph duplication; fix kerning if both 'GPOS' and 'kern' are defined +// 1.21 (2019-02-25) fix warning +// 1.20 (2019-02-07) PackFontRange skips missing codepoints; GetScaleFontVMetrics() +// 1.19 (2018-02-11) OpenType GPOS kerning (horizontal only), STBTT_fmod +// 1.18 (2018-01-29) add missing function +// 1.17 (2017-07-23) make more arguments const; doc fix +// 1.16 (2017-07-12) SDF support +// 1.15 (2017-03-03) make more arguments const +// 1.14 (2017-01-16) num-fonts-in-TTC function +// 1.13 (2017-01-02) support OpenType fonts, certain Apple fonts +// 1.12 (2016-10-25) suppress warnings about casting away const with -Wcast-qual +// 1.11 (2016-04-02) fix unused-variable warning +// 1.10 (2016-04-02) allow user-defined fabs() replacement +// fix memory leak if fontsize=0.0 +// fix warning from duplicate typedef +// 1.09 (2016-01-16) warning fix; avoid crash on outofmem; use alloc userdata for PackFontRanges +// 1.08 (2015-09-13) document stbtt_Rasterize(); fixes for vertical & horizontal edges +// 1.07 (2015-08-01) allow PackFontRanges to accept arrays of sparse codepoints; +// allow PackFontRanges to pack and render in separate phases; +// fix stbtt_GetFontOFfsetForIndex (never worked for non-0 input?); +// fixed an assert() bug in the new rasterizer +// replace assert() with STBTT_assert() in new rasterizer +// 1.06 (2015-07-14) performance improvements (~35% faster on x86 and x64 on test machine) +// also more precise AA rasterizer, except if shapes overlap +// remove need for STBTT_sort +// 1.05 (2015-04-15) fix misplaced definitions for STBTT_STATIC +// 1.04 (2015-04-15) typo in example +// 1.03 (2015-04-12) STBTT_STATIC, fix memory leak in new packing, various fixes +// 1.02 (2014-12-10) fix various warnings & compile issues w/ stb_rect_pack, C++ +// 1.01 (2014-12-08) fix subpixel position when oversampling to exactly match +// non-oversampled; STBTT_POINT_SIZE for packed case only +// 1.00 (2014-12-06) add new PackBegin etc. API, w/ support for oversampling +// 0.99 (2014-09-18) fix multiple bugs with subpixel rendering (ryg) +// 0.9 (2014-08-07) support certain mac/iOS fonts without an MS platformID +// 0.8b (2014-07-07) fix a warning +// 0.8 (2014-05-25) fix a few more warnings +// 0.7 (2013-09-25) bugfix: subpixel glyph bug fixed in 0.5 had come back +// 0.6c (2012-07-24) improve documentation +// 0.6b (2012-07-20) fix a few more warnings +// 0.6 (2012-07-17) fix warnings; added stbtt_ScaleForMappingEmToPixels, +// stbtt_GetFontBoundingBox, stbtt_IsGlyphEmpty +// 0.5 (2011-12-09) bugfixes: +// subpixel glyph renderer computed wrong bounding box +// first vertex of shape can be off-curve (FreeSans) +// 0.4b (2011-12-03) fixed an error in the font baking example +// 0.4 (2011-12-01) kerning, subpixel rendering (tor) +// bugfixes for: +// codepoint-to-glyph conversion using table fmt=12 +// codepoint-to-glyph conversion using table fmt=4 +// stbtt_GetBakedQuad with non-square texture (Zer) +// updated Hello World! sample to use kerning and subpixel +// fixed some warnings +// 0.3 (2009-06-24) cmap fmt=12, compound shapes (MM) +// userdata, malloc-from-userdata, non-zero fill (stb) +// 0.2 (2009-03-11) Fix unsigned/signed char warnings +// 0.1 (2009-03-09) First public release +// + +/* +------------------------------------------------------------------------------ +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. +------------------------------------------------------------------------------ +*/ \ No newline at end of file diff --git a/thirdparty/stb/truetype/stb_truetype.odin b/thirdparty/stb/truetype/stb_truetype.odin new file mode 100644 index 0000000..f128ad0 --- /dev/null +++ b/thirdparty/stb/truetype/stb_truetype.odin @@ -0,0 +1,660 @@ +package stb_truetype + +import c "core:c" +import stbrp "vendor:stb/rect_pack" + +@(private) +LIB :: ( + "../lib/stb_truetype.lib" when ODIN_OS == .Windows + else "../lib/stb_truetype.a" when ODIN_OS == .Linux + else "../lib/darwin/stb_truetype.a" when ODIN_OS == .Darwin + else "../lib/stb_truetype_wasm.o" when ODIN_ARCH == .wasm32 || ODIN_ARCH == .wasm64p32 + else "" +) + +when LIB != "" { + when !#exists(LIB) { + #panic("Could not find the compiled STB libraries, they can be compiled by running `make -C \"" + ODIN_ROOT + "vendor/stb/src\"`") + } +} + +when ODIN_ARCH == .wasm32 || ODIN_ARCH == .wasm64p32 { + foreign import stbtt "../lib/stb_truetype_wasm.o" +} else when LIB != "" { + foreign import stbtt { LIB } +} else { + foreign import stbtt "system:stb_truetype" +} + +/////////////////////////////////////////////////////////////////////////////// +/////////////////////////////////////////////////////////////////////////////// +//// +//// INTERFACE +//// +//// + +#assert(size_of(c.int) == size_of(rune)) +#assert(size_of(c.int) == size_of(b32)) + +//----------------------------------------------------------------------------- +// CUSTOM: ODIN COMPATIBLE ALLOCATOR +//----------------------------------------------------------------------------- + +gbAllocationType :: enum(i32) { + Alloc, + Free, + FreeAll, + Resize, +} + +gbAllocatorProc :: #type proc(allocator_data: rawptr, type: gbAllocationType, + size: c.ssize_t, alignment: c.ssize_t, + old_memory: rawptr, old_size: c.ssize_t, + flags : c.ulonglong +) -> rawptr + +gbAllocator :: struct { + procedure: gbAllocatorProc, + data: rawptr, +} + +@(default_calling_convention="c", link_prefix="stbtt_") +foreign stbtt { + SetAllocator :: proc(allocator : gbAllocator) --- +} + +//----------------------------------------------------------------------------- +// END CUSTOM: ODIN COMPATIBLE ALLOCATOR +//----------------------------------------------------------------------------- + +////////////////////////////////////////////////////////////////////////////// +// +// TEXTURE BAKING API +// +// If you use this API, you only have to call two functions ever. +// + +bakedchar :: struct { + x0, y0, x1, y1: u16, // coordinates of bbox in bitmap + xoff, yoff, xadvance: f32, +} + +aligned_quad :: struct { + x0, y0, s0, t0: f32, // top-left + x1, y1, s1, t1: f32, // bottom-right +} + + + +// bindings +@(default_calling_convention="c", link_prefix="stbtt_") +foreign stbtt { + // if return is positive, the first unused row of the bitmap + // if return is negative, returns the negative of the number of characters that fit + // if return is 0, no characters fit and no rows were used + // This uses a very crappy packing. + BakeFontBitmap :: proc(data: [^]byte, offset: c.int, // font location (use offset=0 for plain .ttf) + pixel_height: f32, // height of font in pixels + pixels: [^]byte, pw, ph: c.int, // bitmap to be filled in + first_char, num_chars: c.int, // characters to bake + chardata: [^]bakedchar, // you allocate this, it's num_chars long + ) -> c.int --- + + // Call GetBakedQuad with char_index = 'character - first_char', and it + // creates the quad you need to draw and advances the current position. + // + // The coordinate system used assumes y increases downwards. + // + // Characters will extend both above and below the current position; + // see discussion of "BASELINE" above. + // + // It's inefficient; you might want to c&p it and optimize it. + GetBakedQuad :: proc(chardata: ^bakedchar, pw, ph: c.int, // same data as above + char_index: c.int, // character to display + xpos, ypos: ^f32, // pointers to current position in screen pixel space + q: ^aligned_quad, // output: quad to draw + opengl_fillrule: b32, // true if opengl fill rule; false if DX9 or earlier + ) --- + + // Query the font vertical metrics without having to create a font first. + GetScaledFontVMetrics :: proc(fontdata: [^]byte, index: c.int, size: f32, ascent, descent, lineGap: ^f32) --- + +} + + + +////////////////////////////////////////////////////////////////////////////// +// +// NEW TEXTURE BAKING API +// +// This provides options for packing multiple fonts into one atlas, not +// perfectly but better than nothing. + +packedchar :: struct { + x0, y0, x1, y1: u16, + xoff, yoff, xadvance: f32, + xoff2, yoff2: f32, +} + +pack_range :: struct { + font_size: f32, + first_unicode_codepoint_in_range: c.int, + array_of_unicode_codepoints: [^]rune, + num_chars: c.int, + chardata_for_range: ^packedchar, + _, _: u8, // used internally to store oversample info +} + +pack_context :: struct { + user_allocator_context, pack_info: rawptr, + width, height, stride_in_bytes, padding: c.int, + skip_missing: b32, + h_oversample, v_oversample: u32, + pixels: [^]byte, + nodes: rawptr, +} + +POINT_SIZE :: #force_inline proc(x: $T) -> T { return -x } // @NOTE: this was a macro + +// bindings +@(default_calling_convention="c", link_prefix="stbtt_") +foreign stbtt { + // Initializes a packing context stored in the passed-in stbtt_pack_context. + // Future calls using this context will pack characters into the bitmap passed + // in here: a 1-channel bitmap that is width * height. stride_in_bytes is + // the distance from one row to the next (or 0 to mean they are packed tightly + // together). "padding" is the amount of padding to leave between each + // character (normally you want '1' for bitmaps you'll use as textures with + // bilinear filtering). + // + // Returns 0 on failure, 1 on success. + PackBegin :: proc(spc: ^pack_context, pixels: [^]byte, width, height, stride_in_bytes, padding: c.int, alloc_context: rawptr) -> c.int --- + + // Cleans up the packing context and frees all memory. + PackEnd :: proc(spc: ^pack_context) --- + + // Creates character bitmaps from the font_index'th font found in fontdata (use + // font_index=0 if you don't know what that is). It creates num_chars_in_range + // bitmaps for characters with unicode values starting at first_unicode_char_in_range + // and increasing. Data for how to render them is stored in chardata_for_range; + // pass these to stbtt_GetPackedQuad to get back renderable quads. + // + // font_size is the full height of the character from ascender to descender, + // as computed by stbtt_ScaleForPixelHeight. To use a point size as computed + // by stbtt_ScaleForMappingEmToPixels, wrap the point size in POINT_SIZE() + // and pass that result as 'font_size': + // ..., 20 , ... // font max minus min y is 20 pixels tall + // ..., POINT_SIZE(20), ... // 'M' is 20 pixels tall + PackFontRange :: proc(spc: ^pack_context, fontdata: [^]byte, font_index: c.int, font_size: f32, first_unicode_char_in_range, num_chars_in_range: c.int, chardata_for_range: ^packedchar) -> c.int --- + + // Creates character bitmaps from multiple ranges of characters stored in + // ranges. This will usually create a better-packed bitmap than multiple + // calls to stbtt_PackFontRange. Note that you can call this multiple + // times within a single PackBegin/PackEnd. + PackFontRanges :: proc(spc: ^pack_context, fontdata: [^]byte, font_index: c.int, ranges: [^]pack_range, num_ranges: c.int) -> c.int --- + + // Oversampling a font increases the quality by allowing higher-quality subpixel + // positioning, and is especially valuable at smaller text sizes. + // + // This function sets the amount of oversampling for all following calls to + // stbtt_PackFontRange(s) or stbtt_PackFontRangesGatherRects for a given + // pack context. The default (no oversampling) is achieved by h_oversample=1 + // and v_oversample=1. The total number of pixels required is + // h_oversample*v_oversample larger than the default; for example, 2x2 + // oversampling requires 4x the storage of 1x1. For best results, render + // oversampled textures with bilinear filtering. Look at the readme in + // stb/tests/oversample for information about oversampled fonts + // + // To use with PackFontRangesGather etc., you must set it before calls + // call to PackFontRangesGatherRects. + PackSetOversampling :: proc(spc: ^pack_context, h_oversample, v_oversample: c.uint) --- + + // If skip != false, this tells stb_truetype to skip any codepoints for which + // there is no corresponding glyph. If skip=false, which is the default, then + // codepoints without a glyph recived the font's "missing character" glyph, + // typically an empty box by convention. + PackSetSkipMissingCodepoints :: proc(spc: ^pack_context, skip: b32) --- + + GetPackedQuad :: proc(chardata: ^packedchar, pw, ph: c.int, // same data as above + char_index: c.int, // character to display + xpos, ypos: ^f32, // pointers to current position in screen pixel space + q: ^aligned_quad, // output: quad to draw + align_to_integer: b32, + ) --- + + // Calling these functions in sequence is roughly equivalent to calling + // stbtt_PackFontRanges(). If you more control over the packing of multiple + // fonts, or if you want to pack custom data into a font texture, take a look + // at the source to of stbtt_PackFontRanges() and create a custom version + // using these functions, e.g. call GatherRects multiple times, + // building up a single array of rects, then call PackRects once, + // then call RenderIntoRects repeatedly. This may result in a + // better packing than calling PackFontRanges multiple times + // (or it may not). + PackFontRangesGatherRects :: proc(spc: ^pack_context, #by_ptr info: fontinfo, ranges: ^pack_range, num_ranges: c.int, rects: [^]stbrp.Rect) -> c.int --- + PackFontRangesPackRects :: proc(spc: ^pack_context, rects: [^]stbrp.Rect, num_rects: c.int) --- + PackFontRangesRenderIntoRects :: proc(spc: ^pack_context, #by_ptr info: fontinfo, ranges: ^pack_range, num_ranges: c.int, rects: [^]stbrp.Rect) -> c.int --- +} + +////////////////////////////////////////////////////////////////////////////// +// +// FONT LOADING +// +// + +fontinfo :: struct { + userdata: rawptr, + data: [^]byte, + fontstart: c.int, + + numGlyphs: c.int, + + loca, head, glyf, hhea, hmtx, kern, gpos, svg: c.int, + index_map: c.int, + indexToLocFormat: c.int, + + cff: _buf, + charstrings: _buf, + gsubrs: _buf, + subrs: _buf, + fontdicts: _buf, + fdselect: _buf, +} + +@(default_calling_convention="c", link_prefix="stbtt_") +foreign stbtt { + // Given an offset into the file that defines a font, this function builds + // the necessary cached info for the rest of the system. You must allocate + // the stbtt_fontinfo yourself, and stbtt_InitFont will fill it out. You don't + // need to do anything special to free it, because the contents are pure + // value data with no additional data structures. Returns 0 on failure. + InitFont :: proc(info: ^fontinfo, data: [^]byte, offset: c.int) -> b32 --- + + // This function will determine the number of fonts in a font file. TrueType + // collection (.ttc) files may contain multiple fonts, while TrueType font + // (.ttf) files only contain one font. The number of fonts can be used for + // indexing with the previous function where the index is between zero and one + // less than the total fonts. If an error occurs, -1 is returned. + GetNumberOfFonts :: proc(data: [^]byte) -> c.int --- + + // Each .ttf/.ttc file may have more than one font. Each font has a sequential + // index number starting from 0. Call this function to get the font offset for + // a given index; it returns -1 if the index is out of range. A regular .ttf + // file will only define one font and it always be at offset 0, so it will + // return '0' for index 0, and -1 for all other indices. + GetFontOffsetForIndex :: proc(data: [^]byte, index: c.int) -> c.int --- +} + +////////////////////////////////////////////////////////////////////////////// +// +// CHARACTER TO GLYPH-INDEX CONVERSION + +@(default_calling_convention="c", link_prefix="stbtt_") +foreign stbtt { + // If you're going to perform multiple operations on the same character + // and you want a speed-up, call this function with the character you're + // going to process, then use glyph-based functions instead of the + // codepoint-based functions. + // Returns 0 if the character codepoint is not defined in the font. + FindGlyphIndex :: proc(#by_ptr info: fontinfo, unicode_codepoint: rune) -> c.int --- +} + +////////////////////////////////////////////////////////////////////////////// +// +// CHARACTER PROPERTIES +// + +@(default_calling_convention="c", link_prefix="stbtt_") +foreign stbtt { + // computes a scale factor to produce a font whose "height" is 'pixels' tall. + // Height is measured as the distance from the highest ascender to the lowest + // descender; in other words, it's equivalent to calling stbtt_GetFontVMetrics + // and computing: + // scale = pixels / (ascent - descent) + // so if you prefer to measure height by the ascent only, use a similar calculation. + ScaleForPixelHeight :: proc(#by_ptr info: fontinfo, pixels: f32) -> f32 --- + + // computes a scale factor to produce a font whose EM size is mapped to + // 'pixels' tall. This is probably what traditional APIs compute, but + // I'm not positive. + ScaleForMappingEmToPixels :: proc(#by_ptr info: fontinfo, pixels: f32) -> f32 --- + + // ascent is the coordinate above the baseline the font extends; descent + // is the coordinate below the baseline the font extends (i.e. it is typically negative) + // lineGap is the spacing between one row's descent and the next row's ascent... + // so you should advance the vertical position by "*ascent - *descent + *lineGap" + // these are expressed in unscaled coordinates, so you must multiply by + // the scale factor for a given size + GetFontVMetrics :: proc(#by_ptr info: fontinfo, ascent, descent, lineGap: ^c.int) --- + + // analogous to GetFontVMetrics, but returns the "typographic" values from the OS/2 + // table (specific to MS/Windows TTF files). + // + // Returns 1 on success (table present), 0 on failure. + GetFontVMetricsOS2 :: proc(#by_ptr info: fontinfo, typoAscent, typoDescent, typoLineGap: ^c.int) -> b32 --- + + // the bounding box around all possible characters + GetFontBoundingBox :: proc(#by_ptr info: fontinfo, x0, y0, x1, y1: ^c.int) --- + + // leftSideBearing is the offset from the current horizontal position to the left edge of the character + // advanceWidth is the offset from the current horizontal position to the next horizontal position + // these are expressed in unscaled coordinates + GetCodepointHMetrics :: proc(#by_ptr info: fontinfo, codepoint: rune, advanceWidth, leftSideBearing: ^c.int) --- + + // an additional amount to add to the 'advance' value between ch1 and ch2 + GetCodepointKernAdvance :: proc(#by_ptr info: fontinfo, ch1, ch2: rune) -> (advance: c.int) --- + + // Gets the bounding box of the visible part of the glyph, in unscaled coordinates + GetCodepointBox :: proc(#by_ptr info: fontinfo, codepoint: rune, x0, y0, x1, y1: ^c.int) -> c.int --- + + // as above, but takes one or more glyph indices for greater efficiency + GetGlyphHMetrics :: proc(#by_ptr info: fontinfo, glyph_index: c.int, advanceWidth, leftSideBearing: ^c.int) --- + GetGlyphKernAdvance :: proc(#by_ptr info: fontinfo, glyph1, glyph2: c.int) -> c.int --- + GetGlyphBox :: proc(#by_ptr info : fontinfo, glyph_index: c.int, x0, y0, x1, y1: ^c.int) -> c.int --- +} + +kerningentry :: struct { + glyph1: rune, // use FindGlyphIndex + glyph2: rune, + advance: c.int, +} + +@(default_calling_convention="c", link_prefix="stbtt_") +foreign stbtt { + // Retrieves a complete list of all of the kerning pairs provided by the font + // stbtt_GetKerningTable never writes more than table_length entries and returns how many entries it did write. + // The table will be sorted by (a.glyph1 == b.glyph1)?(a.glyph2 < b.glyph2):(a.glyph1 < b.glyph1) + GetKerningTableLength :: proc(#by_ptr info: fontinfo) -> c.int --- + GetKerningTable :: proc(#by_ptr info: fontinfo, table: [^]kerningentry, table_length: c.int) -> c.int --- +} + + +////////////////////////////////////////////////////////////////////////////// +// +// GLYPH SHAPES (you probably don't need these, but they have to go before +// the bitmaps for C declaration-order reasons) +// + +vmove :: enum c.int { + none, + vmove=1, + vline, + vcurve, + vcubic, +} + +vertex_type :: distinct c.short // can't use stbtt_int16 because that's not visible in the header file +vertex :: struct { + x, y, cx, cy, cx1, cy1: vertex_type, + type, padding: byte, +} + +@(default_calling_convention="c", link_prefix="stbtt_") +foreign stbtt { + // returns true if nothing is drawn for this glyph + IsGlyphEmpty :: proc(#by_ptr info: fontinfo, glyph_index: c.int) -> b32 --- + + // returns # of vertices and fills *vertices with the pointer to them + // these are expressed in "unscaled" coordinates + // + // The shape is a series of contours. Each one starts with + // a STBTT_moveto, then consists of a series of mixed + // STBTT_lineto and STBTT_curveto segments. A lineto + // draws a line from previous endpoint to its x,y; a curveto + // draws a quadratic bezier from previous endpoint to + // its x,y, using cx,cy as the bezier control point. + GetCodepointShape :: proc(#by_ptr info: fontinfo, unicode_codepoint: rune, vertices: ^[^]vertex) -> c.int --- + GetGlyphShape :: proc(#by_ptr info: fontinfo, glyph_index: c.int, vertices: ^[^]vertex) -> c.int --- + + // frees the data allocated above + FreeShape :: proc(#by_ptr info: fontinfo, vertices: [^]vertex) --- + + // fills svg with the character's SVG data. + // returns data size or 0 if SVG not found. + FindSVGDoc :: proc(#by_ptr info: fontinfo, gl: b32) -> [^]byte --- + GetCodepointSVG :: proc(#by_ptr info: fontinfo, unicode_codepoint: rune, svg: ^cstring) -> c.int --- + GetGlyphSVG :: proc(#by_ptr info: fontinfo, gl: b32, svg: ^cstring) -> c.int --- +} + + +////////////////////////////////////////////////////////////////////////////// +// +// BITMAP RENDERING +// + +_bitmap :: struct { + w, h, stride: c.int, + pixels: [^]byte, +} + +@(default_calling_convention="c", link_prefix="stbtt_") +foreign stbtt { + // frees the bitmap allocated below + FreeBitmap :: proc(bitmap: [^]byte, userdata: rawptr) --- + + // allocates a large-enough single-channel 8bpp bitmap and renders the + // specified character/glyph at the specified scale into it, with + // antialiasing. 0 is no coverage (transparent), 255 is fully covered (opaque). + // *width & *height are filled out with the width & height of the bitmap, + // which is stored left-to-right, top-to-bottom. + // + // xoff/yoff are the offset it pixel space from the glyph origin to the top-left of the bitmap + GetCodepointBitmap :: proc(#by_ptr info: fontinfo, scale_x, scale_y: f32, codepoint: rune, width, height, xoff, yoff: ^c.int) -> [^]byte --- + + // the same as stbtt_GetCodepoitnBitmap, but you can specify a subpixel + // shift for the character + GetCodepointBitmapSubpixel :: proc(#by_ptr info: fontinfo, scale_x, scale_y, shift_x, shift_y: f32, codepoint: rune, width, height, xoff, yoff: ^c.int) -> [^]byte --- + + // the same as stbtt_GetCodepointBitmap, but you pass in storage for the bitmap + // in the form of 'output', with row spacing of 'out_stride' bytes. the bitmap + // is clipped to out_w/out_h bytes. Call stbtt_GetCodepointBitmapBox to get the + // width and height and positioning info for it first. + MakeCodepointBitmap :: proc(#by_ptr info: fontinfo, output: [^]byte, out_w, out_h, out_stride: c.int, scale_x, scale_y: f32, codepoint: rune) --- + + // same as stbtt_MakeCodepointBitmap, but you can specify a subpixel + // shift for the character + MakeCodepointBitmapSubpixel :: proc(#by_ptr info: fontinfo, output: [^]byte, out_w, out_h, out_stride: c.int, scale_x, scale_y, shift_x, shift_y: f32, codepoint: rune) --- + + // same as stbtt_MakeCodepointBitmapSubpixel, but prefiltering + // is performed (see stbtt_PackSetOversampling) + MakeCodepointBitmapSubpixelPrefilter :: proc(#by_ptr info: fontinfo, output: [^]byte, out_w, out_h, out_stride: c.int, scale_x, scale_y, shift_x, shift_y: f32, oversample_x, oversample_y: b32, sub_x, sub_y: ^f32, codepoint: rune) --- + + // get the bbox of the bitmap centered around the glyph origin; so the + // bitmap width is ix1-ix0, height is iy1-iy0, and location to place + // the bitmap top left is (leftSideBearing*scale,iy0). + // (Note that the bitmap uses y-increases-down, but the shape uses + // y-increases-up, so CodepointBitmapBox and CodepointBox are inverted.) + GetCodepointBitmapBox :: proc(#by_ptr font: fontinfo, codepoint: rune, scale_x, scale_y: f32, ix0, iy0, ix1, iy1: ^c.int) --- + + // same as stbtt_GetCodepointBitmapBox, but you can specify a subpixel + // shift for the character + GetCodepointBitmapBoxSubpixel :: proc(#by_ptr font: fontinfo, codepoint: rune, scale_x, scale_y, shift_x, shift_y: f32, ix0, iy0, ix1, iy1: ^c.int) --- + + // the following functions are equivalent to the above functions, but operate + // on glyph indices instead of Unicode codepoints (for efficiency) + GetGlyphBitmap :: proc(#by_ptr info: fontinfo, scale_x, scale_y: f32, glyph: c.int, width, height, xoff, yoff: ^c.int) -> [^]byte --- + GetGlyphBitmapSubpixel :: proc(#by_ptr info: fontinfo, scale_x, scale_y, shift_x, shift_y: f32, glyph: c.int, width, height, xoff, yoff: ^c.int) -> [^]byte --- + MakeGlyphBitmap :: proc(#by_ptr info: fontinfo, output: [^]byte, out_w, out_h, out_stride: c.int, scale_x, scale_y: f32, glyph: c.int) --- + MakeGlyphBitmapSubpixel :: proc(#by_ptr info: fontinfo, output: [^]byte, out_w, out_h, out_stride: c.int, scale_x, scale_y, shift_x, shift_y: f32, glyph: c.int) --- + MakeGlyphBitmapSubpixelPrefilter :: proc(#by_ptr info: fontinfo, output: [^]byte, out_w, out_h, out_stride: c.int, scale_x, scale_y, shift_x, shift_y: f32, oversample_x, oversample_y: c.int, sub_x, sub_y: ^f32, glyph: c.int) --- + GetGlyphBitmapBox :: proc(#by_ptr font: fontinfo, glyph: c.int, scale_x, scale_y: f32, ix0, iy0, ix1, iy1: ^c.int) --- + GetGlyphBitmapBoxSubpixel :: proc(#by_ptr font: fontinfo, glyph: c.int, scale_x, scale_y, shift_x, shift_y: f32, ix0, iy0, ix1, iy1: ^c.int) --- + + // rasterize a shape with quadratic beziers into a bitmap + Rasterize :: proc(result: ^_bitmap, // 1-channel bitmap to draw into + flatness_in_pixels: f32, // allowable error of curve in pixels + vertices: [^]vertex, // array of vertices defining shape + num_verts: c.int, // number of vertices in above array + scale_x, scale_y: f32, // scale applied to input vertices + shift_x, shift_y: f32, // translation applied to input vertices + x_off, y_off: c.int, // another translation applied to input + invert: b32, // if non-zero, vertically flip shape + userdata: rawptr, // context for to STBTT_MALLOC + ) --- + +} + +////////////////////////////////////////////////////////////////////////////// +// +// Signed Distance Function (or Field) rendering +// + +@(default_calling_convention="c", link_prefix="stbtt_") +foreign stbtt { + // frees the SDF bitmap allocated below + FreeSDF :: proc(bitmap: [^]byte, userdata: rawptr) --- + + // These functions compute a discretized SDF field for a single character, suitable for storing + // in a single-channel texture, sampling with bilinear filtering, and testing against + // larger than some threshold to produce scalable fonts. + // info -- the font + // scale -- controls the size of the resulting SDF bitmap, same as it would be creating a regular bitmap + // glyph/codepoint -- the character to generate the SDF for + // padding -- extra "pixels" around the character which are filled with the distance to the character (not 0), + // which allows effects like bit outlines + // onedge_value -- value 0-255 to test the SDF against to reconstruct the character (i.e. the isocontour of the character) + // pixel_dist_scale -- what value the SDF should increase by when moving one SDF "pixel" away from the edge (on the 0..255 scale) + // if positive, > onedge_value is inside; if negative, < onedge_value is inside + // width,height -- output height & width of the SDF bitmap (including padding) + // xoff,yoff -- output origin of the character + // return value -- a 2D array of bytes 0..255, width*height in size + // + // pixel_dist_scale & onedge_value are a scale & bias that allows you to make + // optimal use of the limited 0..255 for your application, trading off precision + // and special effects. SDF values outside the range 0..255 are clamped to 0..255. + // + // Example: + // scale = stbtt_ScaleForPixelHeight(22) + // padding = 5 + // onedge_value = 180 + // pixel_dist_scale = 180/5.0 = 36.0 + // + // This will create an SDF bitmap in which the character is about 22 pixels + // high but the whole bitmap is about 22+5+5=32 pixels high. To produce a filled + // shape, sample the SDF at each pixel and fill the pixel if the SDF value + // is greater than or equal to 180/255. (You'll actually want to antialias, + // which is beyond the scope of this example.) Additionally, you can compute + // offset outlines (e.g. to stroke the character border inside & outside, + // or only outside). For example, to fill outside the character up to 3 SDF + // pixels, you would compare against (180-36.0*3)/255 = 72/255. The above + // choice of variables maps a range from 5 pixels outside the shape to + // 2 pixels inside the shape to 0..255; this is intended primarily for apply + // outside effects only (the interior range is needed to allow proper + // antialiasing of the font at *smaller* sizes) + // + // The function computes the SDF analytically at each SDF pixel, not by e.g. + // building a higher-res bitmap and approximating it. In theory the quality + // should be as high as possible for an SDF of this size & representation, but + // unclear if this is true in practice (perhaps building a higher-res bitmap + // and computing from that can allow drop-out prevention). + // + // The algorithm has not been optimized at all, so expect it to be slow + // if computing lots of characters or very large sizes. + + GetGlyphSDF :: proc(#by_ptr info: fontinfo, scale: f32, glyph, padding: c.int, onedge_value: u8, pixel_dist_scale: f32, width, height, xoff, yoff: ^c.int) -> [^]byte --- + GetCodepointSDF :: proc(#by_ptr info: fontinfo, scale: f32, codepoint, padding: c.int, onedge_value: u8, pixel_dist_scale: f32, width, height, xoff, yoff: ^c.int) -> [^]byte --- +} + + + +////////////////////////////////////////////////////////////////////////////// +// +// Finding the right font... +// +// You should really just solve this offline, keep your own tables +// of what font is what, and don't try to get it out of the .ttf file. +// That's because getting it out of the .ttf file is really hard, because +// the names in the file can appear in many possible encodings, in many +// possible languages, and e.g. if you need a case-insensitive comparison, +// the details of that depend on the encoding & language in a complex way +// (actually underspecified in truetype, but also gigantic). +// +// But you can use the provided functions in two possible ways: +// stbtt_FindMatchingFont() will use *case-sensitive* comparisons on +// unicode-encoded names to try to find the font you want; +// you can run this before calling stbtt_InitFont() +// +// stbtt_GetFontNameString() lets you get any of the various strings +// from the file yourself and do your own comparisons on them. +// You have to have called stbtt_InitFont() first. + +MACSTYLE_DONTCARE :: 0 +MACSTYLE_BOLD :: 1 +MACSTYLE_ITALIC :: 2 +MACSTYLE_UNDERSCORE :: 4 +MACSTYLE_NONE :: 8 // <= not same as 0, this makes us check the bitfield is 0 + +@(default_calling_convention="c", link_prefix="stbtt_") +foreign stbtt { + // returns the offset (not index) of the font that matches, or -1 if none + // if you use STBTT_MACSTYLE_DONTCARE, use a font name like "Arial Bold". + // if you use any other flag, use a font name like "Arial"; this checks + // the 'macStyle' header field; i don't know if fonts set this consistently + FindMatchingFont :: proc(fontdata: [^]byte, name: cstring, flags: c.int) -> c.int --- + + // returns 1/0 whether the first string interpreted as utf8 is identical to + // the second string interpreted as big-endian utf16... useful for strings from next func + CompareUTF8toUTF16_bigendian :: proc(s1: cstring, len1: c.int, s2: cstring, len2: c.int) -> c.int --- + + // returns the string (which may be big-endian double byte, e.g. for unicode) + // and puts the length in bytes in *length. + // + // some of the values for the IDs are below; for more see the truetype spec: + // http://developer.apple.com/textfonts/TTRefMan/RM06/Chap6name.html + // http://www.microsoft.com/typography/otspec/name.htm + GetFontNameString :: proc(#by_ptr font: fontinfo, length: ^c.int, platformID: PLATFORM_ID, encodingID, languageID, nameID: c.int) -> cstring --- +} + + +PLATFORM_ID :: enum c.int { // platformID + PLATFORM_ID_UNICODE = 0, + PLATFORM_ID_MAC = 1, + PLATFORM_ID_ISO = 2, + PLATFORM_ID_MICROSOFT = 3, +} + +// encodingID for PLATFORM_ID_UNICODE +UNICODE_EID_UNICODE_1_0 :: 0 +UNICODE_EID_UNICODE_1_1 :: 1 +UNICODE_EID_ISO_10646 :: 2 +UNICODE_EID_UNICODE_2_0_BMP :: 3 +UNICODE_EID_UNICODE_2_0_FULL :: 4 + +// encodingID for PLATFORM_ID_MICROSOFT +MS_EID_SYMBOL :: 0 +MS_EID_UNICODE_BMP :: 1 +MS_EID_SHIFTJIS :: 2 +MS_EID_UNICODE_FULL :: 10 + + +// encodingID for PLATFORM_ID_MAC; same as Script Manager codes +MAC_EID_ROMAN, MAC_EID_ARABIC :: 0, 4 +MAC_EID_JAPANESE, MAC_EID_HEBREW :: 1, 5 +MAC_EID_CHINESE_TRAD, MAC_EID_GREEK :: 2, 6 +MAC_EID_KOREAN, MAC_EID_RUSSIAN :: 3, 7 + +// languageID for PLATFORM_ID_MICROSOFT; same as LCID... +// problematic because there are e.g. 16 english LCIDs and 16 arabic LCIDs +MS_LANG_ENGLISH, MS_LANG_ITALIAN :: 0x0409, 0x0410 +MS_LANG_CHINESE, MS_LANG_JAPANESE :: 0x0804, 0x0411 +MS_LANG_DUTCH, MS_LANG_KOREAN :: 0x0413, 0x0412 +MS_LANG_FRENCH, MS_LANG_RUSSIAN :: 0x040c, 0x0419 +MS_LANG_GERMAN, MS_LANG_SPANISH :: 0x0407, 0x0409 +MS_LANG_HEBREW, MS_LANG_SWEDISH :: 0x040d, 0x041D + + +// languageID for PLATFORM_ID_MAC +MAC_LANG_ENGLISH, MAC_LANG_JAPANESE :: 0, 11 +MAC_LANG_ARABIC, MAC_LANG_KOREAN :: 12, 23 +MAC_LANG_DUTCH, MAC_LANG_RUSSIAN :: 4, 32 +MAC_LANG_FRENCH, MAC_LANG_SPANISH :: 1, 6 +MAC_LANG_GERMAN, MAC_LANG_SWEDISH :: 2, 5 +MAC_LANG_HEBREW, MAC_LANG_CHINESE_SIMPLIFIED :: 10, 33 +MAC_LANG_ITALIAN, MAC_LANG_CHINESE_TRAD :: 3, 19 + +// private structure +_buf :: struct { + data: [^]byte, + cursor: c.int, + size: c.int, +} diff --git a/thirdparty/stb/truetype/stb_truetype_wasm.odin b/thirdparty/stb/truetype/stb_truetype_wasm.odin new file mode 100644 index 0000000..f362390 --- /dev/null +++ b/thirdparty/stb/truetype/stb_truetype_wasm.odin @@ -0,0 +1,4 @@ +#+build wasm32, wasm64p32 +package stb_truetype + +@(require) import _ "vendor:libc"