From 171634ca0164ada381036aebfd15abce75c7e930 Mon Sep 17 00:00:00 2001 From: Caleb Burke Date: Fri, 25 Sep 2026 22:23:31 -0700 Subject: [PATCH 01/18] stb_image added --- engine/CMakeLists.txt | 4 + third_party/CMakeLists.txt | 12 +- third_party/stb_image/stb_image.cpp | 2 + third_party/stb_image/stb_image.h | 7988 +++++++++++++++++++++++++++ 4 files changed, 8003 insertions(+), 3 deletions(-) create mode 100644 third_party/stb_image/stb_image.cpp create mode 100644 third_party/stb_image/stb_image.h diff --git a/engine/CMakeLists.txt b/engine/CMakeLists.txt index abb899f..7b89d63 100644 --- a/engine/CMakeLists.txt +++ b/engine/CMakeLists.txt @@ -30,3 +30,7 @@ target_link_libraries(${ENGINE_NAME} PUBLIC imgui entt ) + +target_link_libraries(${ENGINE_NAME} PRIVATE + stb_image +) diff --git a/third_party/CMakeLists.txt b/third_party/CMakeLists.txt index f36368f..6e31ae1 100644 --- a/third_party/CMakeLists.txt +++ b/third_party/CMakeLists.txt @@ -4,11 +4,11 @@ add_library(vulkan INTERFACE) find_package(Vulkan REQUIRED COMPONENTS shaderc_combined) # Adding SPIRV-Reflect to vulkan interface -target_sources(vulkan INTERFACE +target_sources(vulkan INTERFACE ${Vulkan_INCLUDE_DIRS}/SPIRV-Reflect/spirv_reflect.c ) -target_include_directories(vulkan INTERFACE +target_include_directories(vulkan INTERFACE ${Vulkan_INCLUDE_DIRS}/SPIRV-Reflect ) @@ -34,13 +34,19 @@ target_include_directories(glm INTERFACE ${CMAKE_CURRENT_SOURCE_DIR}/glm) add_library(entt INTERFACE) target_include_directories(entt INTERFACE ${CMAKE_CURRENT_SOURCE_DIR}/entt) +# stb_image (static) +add_library(stb_image STATIC + ${CMAKE_CURRENT_SOURCE_DIR}/stb_image/stb_image.cpp +) +target_include_directories(stb_image PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/stb_image) + # 5. IMGUI (static) set(IMGUI_DIR ${CMAKE_CURRENT_SOURCE_DIR}/imgui) add_library(imgui STATIC ${IMGUI_DIR}/imgui.cpp ${IMGUI_DIR}/imgui_draw.cpp - ${IMGUI_DIR}/imgui_demo.cpp # remove this + ${IMGUI_DIR}/imgui_demo.cpp # remove this ${IMGUI_DIR}/imgui_tables.cpp ${IMGUI_DIR}/imgui_widgets.cpp ${IMGUI_DIR}/backends/imgui_impl_glfw.cpp diff --git a/third_party/stb_image/stb_image.cpp b/third_party/stb_image/stb_image.cpp new file mode 100644 index 0000000..8ddfd1f --- /dev/null +++ b/third_party/stb_image/stb_image.cpp @@ -0,0 +1,2 @@ +#define STB_IMAGE_IMPLEMENTATION +#include "stb_image.h" diff --git a/third_party/stb_image/stb_image.h b/third_party/stb_image/stb_image.h new file mode 100644 index 0000000..9eedabe --- /dev/null +++ b/third_party/stb_image/stb_image.h @@ -0,0 +1,7988 @@ +/* stb_image - v2.30 - 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.30 (2024-05-31) avoid erroneous gcc warning + 2.29 (2023-05-xx) optimizations + 2.28 (2023-01-29) many error fixes, security errors, just tons of stuff + 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 Neil Bickford 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 + +#if defined(_MSC_VER) || defined(__SYMBIAN32__) +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 + +// returns 1 if the sum of two signed ints is valid (between -2^31 and 2^31-1 inclusive), 0 on overflow. +static int stbi__addints_valid(int a, int b) +{ + if ((a >= 0) != (b >= 0)) return 1; // a and b have different signs, so no overflow + if (a < 0 && b < 0) return a >= INT_MIN - b; // same as a + b >= INT_MIN; INT_MIN - b cannot overflow since b < 0. + return a <= INT_MAX - b; +} + +// returns 1 if the product of two ints fits in a signed short, 0 on overflow. +static int stbi__mul2shorts_valid(int a, int b) +{ + if (b == 0 || b == -1) return 1; // multiplication by 0 is always 0; check for -1 so SHRT_MIN/b doesn't overflow + if ((a >= 0) == (b >= 0)) return a <= SHRT_MAX/b; // product is positive, so similar to mul2sizes_valid + if (b < 0) return a <= SHRT_MIN / b; // same as a * b >= SHRT_MIN + return a >= SHRT_MIN / b; +} + +// 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); + if(k >= 257) return stbi__err("bad size list","Corrupt JPEG"); + } + } + 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]; + if(c < 0 || c >= 256) // symbol id out of bounds! + return -1; + 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); + if (j->code_bits < n) return 0; // ran out of bits from stream, return 0s intead of continuing + + 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); + if (j->code_bits < n) return 0; // ran out of bits from stream, return 0s intead of continuing + 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); + if (j->code_bits < 1) return 0; // ran out of bits from stream, return 0s intead of continuing + 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; + if (!stbi__addints_valid(j->img_comp[b].dc_pred, diff)) return stbi__err("bad delta","Corrupt JPEG"); + dc = j->img_comp[b].dc_pred + diff; + j->img_comp[b].dc_pred = dc; + if (!stbi__mul2shorts_valid(dc, dequant[0])) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + 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 + if (s > j->code_bits) return stbi__err("bad huffman code", "Combined length longer than code bits available"); + 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; + + if (!stbi__addints_valid(j->img_comp[b].dc_pred, diff)) return stbi__err("bad delta", "Corrupt JPEG"); + dc = j->img_comp[b].dc_pred + diff; + j->img_comp[b].dc_pred = dc; + if (!stbi__mul2shorts_valid(dc, 1 << j->succ_low)) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + 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 + if (s > j->code_bits) return stbi__err("bad huffman code", "Combined length longer than code bits available"); + 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]; + } + if(n > 256) return stbi__err("bad DHT header","Corrupt JPEG"); // Loop over i < n would write past end of values! + 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; +} + +static stbi_uc stbi__skip_jpeg_junk_at_end(stbi__jpeg *j) +{ + // some JPEGs have junk at end, skip over it but if we find what looks + // like a valid marker, resume there + while (!stbi__at_eof(j->s)) { + stbi_uc x = stbi__get8(j->s); + while (x == 0xff) { // might be a marker + if (stbi__at_eof(j->s)) return STBI__MARKER_none; + x = stbi__get8(j->s); + if (x != 0x00 && x != 0xff) { + // not a stuffed zero or lead-in to another marker, looks + // like an actual marker, return it + return x; + } + // stuffed zero has x=0 now which ends the loop, meaning we go + // back to regular scan loop. + // repeated 0xff keeps trying to read the next byte of the marker. + } + } + return STBI__MARKER_none; +} + +// 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 ) { + j->marker = stbi__skip_jpeg_junk_at_end(j); + // if we reach eof without hitting a marker, stbi__get_marker() below will fail and we'll eventually return 0 + } + m = stbi__get_marker(j); + if (STBI__RESTART(m)) + m = stbi__get_marker(j); + } 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"); + m = stbi__get_marker(j); + } else { + if (!stbi__process_marker(j, m)) return 1; + 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"); + memset(j, 0, sizeof(stbi__jpeg)); + STBI_NOTUSED(ri); + j->s = s; + stbi__setup_jpeg(j); + result = load_jpeg_image(j, x,y,comp,req_comp); + STBI_FREE(j); + return result; +} + +static int stbi__jpeg_test(stbi__context *s) +{ + int r; + stbi__jpeg* j = (stbi__jpeg*)stbi__malloc(sizeof(stbi__jpeg)); + if (!j) return stbi__err("outofmem", "Out of memory"); + memset(j, 0, sizeof(stbi__jpeg)); + j->s = s; + stbi__setup_jpeg(j); + r = stbi__decode_jpeg_header(j, STBI__SCAN_type); + stbi__rewind(s); + STBI_FREE(j); + return r; +} + +static int stbi__jpeg_info_raw(stbi__jpeg *j, int *x, int *y, int *comp) +{ + if (!stbi__decode_jpeg_header(j, STBI__SCAN_header)) { + stbi__rewind( j->s ); + return 0; + } + if (x) *x = j->s->img_x; + if (y) *y = j->s->img_y; + if (comp) *comp = j->s->img_n >= 3 ? 3 : 1; + return 1; +} + +static int stbi__jpeg_info(stbi__context *s, int *x, int *y, int *comp) +{ + int result; + stbi__jpeg* j = (stbi__jpeg*) (stbi__malloc(sizeof(stbi__jpeg))); + if (!j) return stbi__err("outofmem", "Out of memory"); + memset(j, 0, sizeof(stbi__jpeg)); + j->s = s; + result = stbi__jpeg_info_raw(j, x, y, comp); + STBI_FREE(j); + return result; +} +#endif + +// public domain zlib decode v0.2 Sean Barrett 2006-11-18 +// simple implementation +// - all input must be provided in an upfront buffer +// - all output is written to a single output buffer (can malloc/realloc) +// performance +// - fast huffman + +#ifndef STBI_NO_ZLIB + +// fast-way is faster to check than jpeg huffman, but slow way is slower +#define STBI__ZFAST_BITS 9 // accelerate all cases in default tables +#define STBI__ZFAST_MASK ((1 << STBI__ZFAST_BITS) - 1) +#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; + int hit_zeof_once; + 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)) { + if (!a->hit_zeof_once) { + // This is the first time we hit eof, insert 16 extra padding btis + // to allow us to keep going; if we actually consume any of them + // though, that is invalid data. This is caught later. + a->hit_zeof_once = 1; + a->num_bits += 16; // add 16 implicit zero bits + } else { + // We already inserted our extra 16 padding bits and are again + // out, this stream is actually prematurely terminated. + return -1; + } + } else { + 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; + if (a->hit_zeof_once && a->num_bits < 16) { + // The first time we hit zeof, we inserted 16 extra zero bits into our bit + // buffer so the decoder can just do its speculative decoding. But if we + // actually consumed any of those bits (which is the case when num_bits < 16), + // the stream actually read past the end so it is malformed. + return stbi__err("unexpected end","Corrupt PNG"); + } + return 1; + } + if (z >= 286) return stbi__err("bad huffman code","Corrupt PNG"); // per DEFLATE, length codes 286 and 287 must not appear in compressed data + 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 || z >= 30) return stbi__err("bad huffman code","Corrupt PNG"); // per DEFLATE, distance codes 30 and 31 must not appear in compressed data + 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 (len > a->zout_end - zout) { + 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; + a->hit_zeof_once = 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 filter used for first scanline to avoid needing a dummy row of 0s + STBI__F_avg_first +}; + +static stbi_uc first_row_filter[5] = +{ + STBI__F_none, + STBI__F_sub, + STBI__F_none, + STBI__F_avg_first, + STBI__F_sub // Paeth with b=c=0 turns out to be equivalent to sub +}; + +static int stbi__paeth(int a, int b, int c) +{ + // This formulation looks very different from the reference in the PNG spec, but is + // actually equivalent and has favorable data dependencies and admits straightforward + // generation of branch-free code, which helps performance significantly. + int thresh = c*3 - (a + b); + int lo = a < b ? a : b; + int hi = a < b ? b : a; + int t0 = (hi <= thresh) ? lo : c; + int t1 = (thresh <= lo) ? hi : t0; + return t1; +} + +static const stbi_uc stbi__depth_scale_table[9] = { 0, 0xff, 0x55, 0, 0x11, 0,0,0, 0x01 }; + +// adds an extra all-255 alpha channel +// dest == src is legal +// img_n must be 1 or 3 +static void stbi__create_png_alpha_expand8(stbi_uc *dest, stbi_uc *src, stbi__uint32 x, int img_n) +{ + int i; + // must process data backwards since we allow dest==src + if (img_n == 1) { + for (i=x-1; i >= 0; --i) { + dest[i*2+1] = 255; + dest[i*2+0] = src[i]; + } + } else { + STBI_ASSERT(img_n == 3); + for (i=x-1; i >= 0; --i) { + dest[i*4+3] = 255; + dest[i*4+2] = src[i*3+2]; + dest[i*4+1] = src[i*3+1]; + dest[i*4+0] = src[i*3+0]; + } + } +} + +// 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; + stbi_uc *filter_buf; + int all_ok = 1; + 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"); + + // note: error exits here don't need to clean up a->out individually, + // stbi__do_png always does on error. + 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); + if (!stbi__mad2sizes_valid(img_width_bytes, y, img_width_bytes)) return stbi__err("too large", "Corrupt PNG"); + 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"); + + // Allocate two scan lines worth of filter workspace buffer. + filter_buf = (stbi_uc *) stbi__malloc_mad2(img_width_bytes, 2, 0); + if (!filter_buf) return stbi__err("outofmem", "Out of memory"); + + // Filtering for low-bit-depth images + if (depth < 8) { + filter_bytes = 1; + width = img_width_bytes; + } + + for (j=0; j < y; ++j) { + // cur/prior filter buffers alternate + stbi_uc *cur = filter_buf + (j & 1)*img_width_bytes; + stbi_uc *prior = filter_buf + (~j & 1)*img_width_bytes; + stbi_uc *dest = a->out + stride*j; + int nk = width * filter_bytes; + int filter = *raw++; + + // check filter type + if (filter > 4) { + all_ok = stbi__err("invalid filter","Corrupt PNG"); + break; + } + + // if first row, use special filter that doesn't sample previous row + if (j == 0) filter = first_row_filter[filter]; + + // perform actual filtering + switch (filter) { + case STBI__F_none: + memcpy(cur, raw, nk); + break; + case STBI__F_sub: + memcpy(cur, raw, filter_bytes); + for (k = filter_bytes; k < nk; ++k) + cur[k] = STBI__BYTECAST(raw[k] + cur[k-filter_bytes]); + break; + case STBI__F_up: + for (k = 0; k < nk; ++k) + cur[k] = STBI__BYTECAST(raw[k] + prior[k]); + break; + case STBI__F_avg: + for (k = 0; k < filter_bytes; ++k) + cur[k] = STBI__BYTECAST(raw[k] + (prior[k]>>1)); + for (k = filter_bytes; k < nk; ++k) + cur[k] = STBI__BYTECAST(raw[k] + ((prior[k] + cur[k-filter_bytes])>>1)); + break; + case STBI__F_paeth: + for (k = 0; k < filter_bytes; ++k) + cur[k] = STBI__BYTECAST(raw[k] + prior[k]); // prior[k] == stbi__paeth(0,prior[k],0) + for (k = filter_bytes; k < nk; ++k) + cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k-filter_bytes], prior[k], prior[k-filter_bytes])); + break; + case STBI__F_avg_first: + memcpy(cur, raw, filter_bytes); + for (k = filter_bytes; k < nk; ++k) + cur[k] = STBI__BYTECAST(raw[k] + (cur[k-filter_bytes] >> 1)); + break; + } + + raw += nk; + + // expand decoded bits in cur to dest, also adding an extra alpha channel if desired + if (depth < 8) { + stbi_uc scale = (color == 0) ? stbi__depth_scale_table[depth] : 1; // scale grayscale values to 0..255 range + stbi_uc *in = cur; + stbi_uc *out = dest; + stbi_uc inb = 0; + stbi__uint32 nsmp = x*img_n; + + // expand bits to bytes first + if (depth == 4) { + for (i=0; i < nsmp; ++i) { + if ((i & 1) == 0) inb = *in++; + *out++ = scale * (inb >> 4); + inb <<= 4; + } + } else if (depth == 2) { + for (i=0; i < nsmp; ++i) { + if ((i & 3) == 0) inb = *in++; + *out++ = scale * (inb >> 6); + inb <<= 2; + } + } else { + STBI_ASSERT(depth == 1); + for (i=0; i < nsmp; ++i) { + if ((i & 7) == 0) inb = *in++; + *out++ = scale * (inb >> 7); + inb <<= 1; + } + } + + // insert alpha=255 values if desired + if (img_n != out_n) + stbi__create_png_alpha_expand8(dest, dest, x, img_n); + } else if (depth == 8) { + if (img_n == out_n) + memcpy(dest, cur, x*img_n); + else + stbi__create_png_alpha_expand8(dest, cur, x, img_n); + } else if (depth == 16) { + // convert the image data from big-endian to platform-native + stbi__uint16 *dest16 = (stbi__uint16*)dest; + stbi__uint32 nsmp = x*img_n; + + if (img_n == out_n) { + for (i = 0; i < nsmp; ++i, ++dest16, cur += 2) + *dest16 = (cur[0] << 8) | cur[1]; + } else { + STBI_ASSERT(img_n+1 == out_n); + if (img_n == 1) { + for (i = 0; i < x; ++i, dest16 += 2, cur += 2) { + dest16[0] = (cur[0] << 8) | cur[1]; + dest16[1] = 0xffff; + } + } else { + STBI_ASSERT(img_n == 3); + for (i = 0; i < x; ++i, dest16 += 4, cur += 6) { + dest16[0] = (cur[0] << 8) | cur[1]; + dest16[1] = (cur[2] << 8) | cur[3]; + dest16[2] = (cur[4] << 8) | cur[5]; + dest16[3] = 0xffff; + } + } + } + } + } + + STBI_FREE(filter_buf); + if (!all_ok) return 0; + + 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_set_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"); + } 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"); + } + // even with 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; + // non-paletted with tRNS = constant alpha. if header-scanning, we can stop now. + if (scan == STBI__SCAN_header) { ++s->img_n; return 1; } + if (z->depth == 16) { + for (k = 0; k < s->img_n && k < 3; ++k) // extra loop test to suppress false GCC warning + tc16[k] = (stbi__uint16)stbi__get16be(s); // copy the values as-is + } else { + for (k = 0; k < s->img_n && k < 3; ++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) { + // header scan definitely stops at first IDAT + if (pal_img_n) + s->img_n = pal_img_n; + return 1; + } + if (c.length > (1u << 30)) return stbi__err("IDAT size limit", "IDAT section larger than 2^30 bytes"); + 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) { + // accept some number of extra bytes after the header, but if the offset points either to before + // the header ends or implies a large amount of extra data, reject the file as malformed + int bytes_read_so_far = s->callback_already_read + (int)(s->img_buffer - s->img_buffer_original); + int header_limit = 1024; // max we actually read is below 256 bytes currently. + int extra_data_limit = 256*4; // what ordinarily goes here is a palette; 256 entries*4 bytes is its max size. + if (bytes_read_so_far <= 0 || bytes_read_so_far > header_limit) { + return stbi__errpuc("bad header", "Corrupt BMP"); + } + // we established that bytes_read_so_far is positive and sensible. + // the first half of this test rejects offsets that are either too small positives, or + // negative, and guarantees that info.offset >= bytes_read_so_far > 0. this in turn + // ensures the number computed in the second half of the test can't overflow. + if (info.offset < bytes_read_so_far || info.offset - bytes_read_so_far > extra_data_limit) { + return stbi__errpuc("bad offset", "Corrupt BMP"); + } else { + stbi__skip(s, info.offset - bytes_read_so_far); + } + } + + 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 == 0) || (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 == 0) || (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"); + if (!stbi__getn(s, out, s->img_n * s->img_x * s->img_y * (ri->bits_per_channel / 8))) { + STBI_FREE(out); + return stbi__errpuc("bad PNM", "PNM file truncated"); + } + + if (req_comp && req_comp != s->img_n) { + if (ri->bits_per_channel == 16) { + out = (stbi_uc *) stbi__convert_format16((stbi__uint16 *) out, s->img_n, req_comp, s->img_x, s->img_y); + } else { + 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); + if((value > 214748364) || (value == 214748364 && *c > '7')) + return stbi__err("integer parse overflow", "Parsing an integer in the PPM header overflowed a 32-bit int"); + } + + 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 + if(*x == 0) + return stbi__err("invalid width", "PPM image header had zero or overflowing width"); + stbi__pnm_skip_whitespace(s, &c); + + *y = stbi__pnm_getinteger(s, &c); // read height + if (*y == 0) + return stbi__err("invalid width", "PPM image header had zero or overflowing width"); + 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. +------------------------------------------------------------------------------ +*/ -- 2.47.3 From fe516bb1ef5ce1525cff337817b7fd5fb8b4cfa0 Mon Sep 17 00:00:00 2001 From: Caleb Burke Date: Fri, 25 Sep 2026 22:23:44 -0700 Subject: [PATCH 02/18] helper for starting up editor --- bin/dev | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/bin/dev b/bin/dev index f9425eb..82b0d9d 100755 --- a/bin/dev +++ b/bin/dev @@ -50,6 +50,20 @@ class DevHelper: preset, fresh = self._parse_preset_args(args, "build") self._build_preset(preset, fresh) + ## + # Builds the debug preset (incrementally), then runs the editor from + # build/debug. Any arguments are passed through to the editor. + # dev editor [args...] + def editor(self, *args, **kwargs): + preset = self.DEFAULT_PRESET + self._build_preset(preset, fresh=False) + + preset_dir = os.path.join(self._project_root(), "build", preset) + binary = os.path.join(preset_dir, "bin", "editor") + print(f"Running: {shlex.join([binary, *args])}") + os.chdir(preset_dir) + os.execv(binary, [binary, *args]) + ## # Builds the debug preset (incrementally), then runs the testbed from # build/debug. Any arguments are passed through to the testbed. -- 2.47.3 From b44fe94d5c6e8659730ee1afa2466b4720c06cf9 Mon Sep 17 00:00:00 2001 From: Caleb Burke Date: Fri, 25 Sep 2026 22:33:30 -0700 Subject: [PATCH 03/18] image view example --- examples/image_viewer/CMakeLists.txt | 7 +++ examples/image_viewer/dog.jpeg | Bin 0 -> 8452 bytes examples/image_viewer/main.cpp | 79 +++++++++++++++++++++++++++ 3 files changed, 86 insertions(+) create mode 100644 examples/image_viewer/CMakeLists.txt create mode 100644 examples/image_viewer/dog.jpeg create mode 100644 examples/image_viewer/main.cpp diff --git a/examples/image_viewer/CMakeLists.txt b/examples/image_viewer/CMakeLists.txt new file mode 100644 index 0000000..8719d57 --- /dev/null +++ b/examples/image_viewer/CMakeLists.txt @@ -0,0 +1,7 @@ +add_executable(image_viewer main.cpp) + +target_link_libraries(image_viewer PRIVATE ${PROJECT_NAME}) + +target_compile_definitions(image_viewer PRIVATE + IMAGE_VIEWER_ASSET_DIR="${CMAKE_CURRENT_SOURCE_DIR}" +) diff --git a/examples/image_viewer/dog.jpeg b/examples/image_viewer/dog.jpeg new file mode 100644 index 0000000000000000000000000000000000000000..26e172588ac9f2e7e3aac4cf173abe20ce13ddb2 GIT binary patch literal 8452 zcmb7nbx<2l&~_lW6N)FtSQA>q&Sokytunti$igOTZ>Cd(c<>? z_s#dsy#Kz>-p$O1n{^F_yEAi!KI)8QGzHa zs3<9^Y5vK-LHBP`{#*S6B@GQDHwz6N2R$`4t1v4E51)X505!9ylqkO>H@^TM1_1#9 z2{8#B85tcv2O|gn{~C{70CGG)GsY7j1{(mA90N#>@z@7o_?II##($~)e_#PHf!H{> z7xR0h9mR$NYzX!T(=i3`}xXVURM=PzCEhmu!zq z03zW34Mz@81dKw8*HBymamEdUCWj=MjC#mz`e9cc_51=GhNVP6bYHwcS<*+O$E5B3 zgh0+=I6^Id{yx!XnNy3QNgzd7EVf84;XEw5iPy<|RTu*_+%;;66(!uvI&+~Dx`z?~ ze_m43Nr;7}AI+gHT_~6#jxO{k?DlzYKEtfJTkjHXIdtahzkcZI7cP}c{p6J2HTmSP z6TVInN`pDw)d7$7$@+j|2*WUB`L--w{?$Gl96QRpFs&!-khkn-(t>`G9~MeT@ky8g z)hj>LP{3$LV);}N0z|5#yIcOSp=FSB$&PAMUCPCIDW5a(d=uUDTFwccZw%%nMJ@FB z;yckc(x{ETb=~U-R8p!TV_VJ`Z7=P3%Q;udLfhF*{RhYQx7&|~(w3zYD4LUW<_?9= zv^h*%H0ZAIkz_fKG0dYg8D1yIri$d0*q@aLnNG5>uAGcnpjgMi?$hbS3v|hB1228| zvZEbGKDcfnEwGuNaRsc(RB0N}vp;iMs;r~8bKKrtwG9fLVac5!HPIT^Gcl)DmChp{ z9YR0%`Ca#^_6LZv%nuvgP@I(W&6@NgSoQ7a#4?G(f=Qy-DKW>ZZmucQHQTu)&7(Hy z6dzh#m~9l?j)ZucSvR*G$eyzo@m`9&$gMbEUA62WxHaFQ4Uw+2SAYOo7kNL6iVA5q zH!gG;7K_`D_YOITDms1=>z|PbGvb^+J`V{WMKb33G0vx)PPZ)jk8yOx+YbM1?*2jL zDzcw*E3D^6G%Q@VwePLF{`}KjVm%&Soa0kBq8d=lWt&a;!;=NHdOnydmp3VT=VYgX z)&TzC7MB0fE3tubQJ?qi1@ZX)UloKS(+^|VT~ZAmj4Eq$R?g^Em$(wf=Sw5ruX>|E zYj%f4i7I`Zfng96OBms=Mw1i6_4wRdq19~--+0k-wrt@*8zaf4aX@D34A?Y{u`Wz;>7a6AY z<|#HJNs`!IH{G=UowX+;b=m`q%dG!f#v7ejt0*P@hGCgGep*u9(a-6JV{y3`LofU2btz+CFs&k&lk!Roo%&aPd zYiN$aJQ<+42!npa2ShrCA6sVm<0Z9Jcym!P4PHz#XeYuX-~{4}8;fBkY#63OPBB9MTY=&x|!;pkk-5NhCU z0m>tjslJcQN)nuLs(l%*CahPV|CrHlB=(Zbbxc9qStqh4i$hdl#I93*){k_9B~`VO zuwHYu6mGuj*^ZxB`{$*cN<3v6PD`xjb)45+O;>0g2}z0eNbIl|VfNvH6Jv(doupyr zK=nFAS{*!HMz_gw(6lBN^}#VX2@fuM+Uucyow^T&U7M&xAyMNyGJs z#>XL#__(0n4PWXPg%`MZtV_JX4-2Cev80+SC4zfywN_K!s>8T$+n|OxCnIAR&QWVS zQmQQRm>9xrh}}ji5 zhK!YZ02n4l3mz~JkJ9%YBIVx0^`f=Q%rO)^Cl3s}rZZ>O@J^`7aHSWpGbV&9JY8{8 z>0CnfC23cHBgJLYyO|colurv7HAA0$@BHBJN3{$4I1r?HbGY_m^=nYu?gUS#`hr7g znsP!?^rRlr_+hOfn#=)Y6VYPzhdkbv&i=~MJf2j5zGxYL2fGK{ zPCqoA7q`1^vY8j4(%$!iNBE!s9qX!qZPOCVR=$325+6^WfYV0he?)|Y6%6KZoXu+Ky=nJy)Awq-aEOs=a;zA9o)}tM zc6=|y8pGpT`CP{J`LqYZMb&R1Y{IqGM=lk$LK}0r@Jg{<`9?rAYW?l3H60BdAS(8T z-rL4Igqu!`UURttW9f(9@bENMAt7pevkb$lBy7ig$G`z`K^X7J^#0~5_>Zcw;zbt; zZekkwndvuFOY+b5gV9*P)oS1^IU&V|(vnn6IpO2jN5JaqtiKiZ9pbM(eWySI9>y zbeA3^6I9p!Ig<@)(a{#|(G{jUP!xJei^7%IldO350(S_Xdf{nQxZbNBQlkvUp71C4Y<8dXQRO0*t%I9uX-#|8tv%)k@!^*9rY zCDCN!kc?2`UMtjcwsW>8R|C;2;Wj=9)8XsY#x^V0;*9)OW3Pz9`G#so{Xw~@LjInH z1sA8p`d`aPhGxlS`R?mRIVRq0o{V#g;@M1(gaOs@Co`9E2&8Z)!zQRU)vE34_NsjI_8TDv2cH7Eq|dy2>bvk zzqibS_4dd*u*h7FXSDt@ zCF6Kt$Hemp*!I42W0BO()(nhZM=?UZNPE`7K?KpfB^ZcIj;bv@Rx7J#mf9kZ2Ycw7E@#TJ+3UO< zD}9(SfvXxWc2jn{0U-qw_{=9A71h`?4++o(z6~$fwORI>d%&F+ zwW`tC>&YsBvc;DKkT;MR%i7o&jc&Pf%B6~QZ}Q9(@j!~EEDG8Umm0s(6Dp`>Imi#U zkDwt1uzJJT;2Uw0RI&GD>%Q5SjGuCan~_Td{XHjpweQSQq|e2T!EJ2p@0UxjB0gnk z;V`ABi^ZZ79Hu;gSo&qdn^Hyf#p`gN=q{ObqVY6|x>m7h%Wt%sxv7S3w3U~|hJh~x zHx|PCgNdC3VRkw2?HOUFgLwbmr=GVnH{JAAoWnJ)b&5}M@;5X9AdQvSd~{BB@@DPg zJl$qFno?NM+vZ0VYT{1SYV0-ItT8-8x%GrLO>taf#Z|a+4nQ&DuoYge!T5orGo7yG zZ7jyPbC}(68=iC9K3LgcPq;jB`Mcfc_;hx1q^UQp<~f6f)*A_zUtm^ld?y2cXD6zJ z!Bm{~51BS&!iKt&~)dX7l?Cv>=>A8=e; zL5ZS=PP)UBI?UJPz0M1UN*cIh< znq8Sd8*+TGn6$r%gPvMgmu=YvmaOkZvV^`#P@Z83h+$)O?lX_XYo#WVd=F&>`%w0w5-(rrM&M}THgxyY z@HOTAwt9FAZS(@hxuv>8L~AkUj{BwSZT`!G@t-!3B%pFI6pDCzY54uASR}{jn;eZJ z*IO-i<}jcEr{2Ba@(+ki?JbJEjHP^{Hniu6Q16%ycaFnk2BfTDNL5!q;#m>hEl+9( z9vzSJ_R+xgMEe?dnmBuq$mDmfUSQ&W*}yDgi4t~bF00Aa^TQfAt2qeD=t(8l*`HJY z$}pF8_a@YmO20E0=q;yI?$~}KCh^nUVg_LPJcO|JlQ_oW*T3Crknjr7KQ+z<^ zv`o{>h!aa3w|FgBHKtI(keFh%y@u^kTkAiHHuc?xe{pU;HIea{Z~E$Z#Y=38CXO#C zmkapac+Ox;)hgEQyrgs$40>_e18YW}o|=E-S>JWADbXz01RPrW5&K!W9D4rH&N`v3 zF1~@3bYrEv@^h@ICQGc&9gWc%%fqZG)ghurz-RVZW+WsG!Pxb?JK3q*abDM+<`)v^ zd2szb-n{`^*5?JfbX&zQJD&z@Rd*oop6`@*oB79z)9p6gv1r7%>1fDDIi5on^5|sq z2$#OKSNVQF9adCZm(-%*`eZ7u8`dq8pFVK7d3t8)-Fr|p&_XRG`x;ZMbrRo^ekj`` z@rSc`gm=0oi2wZ~pqH>6A#;(U51MnRM5 zby>hiuTsn0S58Vu`jBnYu!fPic&9OF{Yu{0wD6sFw0)A3e1UgD_t!vbzKybm`#)w= z7_r{b=09T`gXshd=vUP(_$*)3ZMaCv^WQZl3tb&Ak|0GSa7e3tw()-2$F`T<{2kTY z^*l46ZuLzC;dC14M2UjzgC#I=TQw^w$qdym`k3T+lMX;I^fBt5Z{d0%P2q zl;B-P6z1_&zG*2(tv!nP+J~FLjl7m&N!vFLy(^GM;{#Ys^uF&FHELaScs+3B{>EsXHm~qdF^j62P%X|8*?CK-FP>elZTu`E^CB*AzC|tonmbQ1 zk?;tJAA`SIL7^+c?Zh!y_7gYgsU{S1nJ?5qf51_}%DY}_@z1Vv2jr_f$+75}%vj>Z zgCctxCI!6pzGC(HM4c}0gwcmrKPT2VtiN8NmNO?M6;B;K!Ge^2;^^+e(2&7<8FHF& zrm|@{hj|gAm`Fdg3hXn<9M*$r%p8xgXa7M&9RQ}$Q3P{#sy6|3tp z)wxwJr0M6`OvVi=c|{mdn1HTPQ?xnNnQJ=2S23NmmKANy*C40Bh45kt#XHB!EvX}@ z>v703=%w35BAvBkh(}2@SYw>6G;h>aCh>nRrT?}IaJ(st(WNC+OJ0xOu8c4bW9ij@ z#=ckKxJF0kIOi(FU_~0tfX~|GyJicmRiAxL@7-)DN~X2{j`?5q-tq#K84mih8|rSJ_|=H(o5 zvQefVG~y8ecf5S&$)rGg*x%^RC?mkvC;kYi(g3JMWV*FUxW@`|>^zlrg^hWCB|N8B zqWUdwrf`{3`EP9HlFTxC#f~nB(TCBc!;ktzu#I8kd9suCAC!3dP z(pDls#-cl+lonGp)>z<9GgmsWBs@bJ(dZzr!OU~^2^Ou-KGADlHX4OhD@R0dCuFsxN64G7UCy#bvn1lXS8!__(=&c3Bc?k1jv$T z%=7-DQ{S}_?lEh88de<*d}+n%{6b8S5_$&Y;kh5xABbt7U2vNGUkKL#j8IJ4b#WW5)a* z|I34c$fp7!fQJC^o8-{&V?q5mx4v-va_S<92+;3iC=(Rgfx9$PCV4Hx3TvK|GMJBIYkV@qMC7? zjee!wQdZX`zYbOe&UJR zJ#lhFfn#l@^ASjpF?eOgdwJGCGGh5h#}A*IG{)i@OW)~4`5>?aJ7`!bwMERYhEV>O z_RPh=Yiag$W|ObUBCmcjcWlU8Wh{dzId=45Df4$A3yqD=ExCiu(~ZABNg1UkC)s zF6C211)8;<6SejwJA&R~*f*$55Ni{QFzhD)*yi^cI%c!&dS}Wu2yLvx6E^UPIr@~2 zTM|%`*Dm!7udXMu@(Z4uz#o{? z2fkmvWXG}CjZzR2=6Du0O&6;LizkwJEBge8E?yanyxSx&v!?d<~ z>sCkf%QP86@PcliWFD$OAGl9G-L@(!QM5Di+TJ$=w{#KMYb~lxtRYtWaSLz>|0&^^ z79LfD7o$$}4x?rthO6TlXPKnMYir)=%z60aU^Cexpogam*dA6< zSe+z~n%gJZ+ng98oy9c^lM`^ZieMcyoY#;_RRUS>Buh}=cw253`9bT6rWuCS9s#eW z0km*Z5BeMc`11-W#VkT~t(Id_oNS;$zr48#1x?2#?*4$&+L)z0wee&X0ze?zV%(i2 zlemu?jYZR5bZ-}qg={g+GnZ9vRu$ifn-WhDY1b@-KLWlo4;4?1o1gH{qS?^79pWZM zx=tql>Rh8t+r-VHHR(M$B^?dBHeJB}{n(rxr}>YblP^DwH$1({(GWwKI_FPYO>?J? z^N>T34l9R@gt?Rxg_m0a{MYwWvNgAW19Id$*{l&HvnDUXbo7=d;1MuC)59m;yAOTV zZZ*V@W0rEoI3x95m%HPL-Fcs4T+(tPZa-_>^+%b}WgH^1R!IH{l)xGYNR?Xg-HPuK zOM0&I2*^A$wN?zDg>>96b1(g!aws8yq<7Zvo&y_W%`6Ls?p zwA;yovFke8BTBt9jtLSwdcWa4)>P=%J@c4KsdDDeS^ScK;P>>=+Vi z)HGKqiO_r1cVF~zqr5c&a86xsv6nrcoC}Z1k||#cNQO9&^0Upy^}|j#tJ3cR0xQcm zqVnv7U$iQMgu6$%jxYm*6515WFlpwZBFIR0YUL0rjOsFqXHMo97H`IlS>?xO>psZ) zFhe`oRV~@A(o6uiZp0BpKMoCP7F-c)f(~lN&3fsPCY&hz9Tfz>uB0LrgeqZqbM3xN(t=_)y6g5jjOk6WDT*bT zrm_Z-jjD5mIT#LB%ify|m_66#IA)YvUFg*(v zdDR$Kb}`XfX>p<8-)oHgCa6 z13{e4SM@YHJf(&Wi&&jw&H#jpj5J-Nd4)dq z`_B_B#Z^M?bP@TpQ`q2?m+X|`y{S?dtt_OXu)pEYQ)3jEQZVXi=y&`)|6|d7;)PH; sfs+byXHq*fIg}!GJT<{sFF9Lt!3jWxq!<)FI8=1S&$b{5|8epE0923FRR910 literal 0 HcmV?d00001 diff --git a/examples/image_viewer/main.cpp b/examples/image_viewer/main.cpp new file mode 100644 index 0000000..2eae2df --- /dev/null +++ b/examples/image_viewer/main.cpp @@ -0,0 +1,79 @@ +#include + +#include +#include +#include +#include +#include +#include +#include + +// Shows a render target filling the whole panel. +class ViewportPanel : public sophia::Panel { + public: + ViewportPanel(sophia::UI& ui, sophia::RenderTargetHandle target) + : Panel{{.name = "Image", + .windowFlags = ImGuiWindowFlags_NoScrollbar | + ImGuiWindowFlags_NoScrollWithMouse}}, + ui{ui}, + target{target} {} + + void onUpdate(const sophia::FrameInfo&) override { ui.image(target); } + + private: + sophia::UI& ui; + sophia::RenderTargetHandle target; +}; + +// Displays an image file (anything stb_image reads: JPEG, PNG, BMP, ...) as a +// sprite in a 2D scene, scaled to fit the viewport. +// image_viewer [path] +class ImageViewer : public sophia::Application { + public: + ImageViewer() + : Application{{.width = 1000, .height = 750, .name = "ImageViewer"}} {} + + void onCreate() override { + std::string path = + args.size() > 1 ? args[1] : IMAGE_VIEWER_ASSET_DIR "/dog.jpeg"; + + sophia::SceneHandle sceneHandle = scenes().create(); + sophia::Scene& scene = scenes().get(sceneHandle); + + camera = scene.createEntity("Camera"); + camera.addComponent(); + + sophia::TextureHandle texture = resources().load(path); + imageSize = resources().getExtent(texture); + + // One world unit per image pixel; the camera zooms to fit. + sophia::Entity image = scene.createEntity("Image"); + image.addComponent( + sophia::SpriteComponent{.texture = texture, .size = imageSize}); + + target = resources().create(); + views().create({.scene = sceneHandle, + .target = target, + .camera = camera, + .clearColor = {0.1f, 0.1f, 0.15f, 1.f}}); + + panels().emplace(ui(), target); + // panels().setDefaultLayout({.center = {"Image"}}); + } + + void onUpdate(const sophia::FrameInfo&) override { + // Fit the whole image: show enough height that neither dimension of the + // image overflows the viewport. + glm::vec2 viewport = resources().getExtent(target); + float viewportAspect = viewport.x / viewport.y; + camera.getComponent().ortho.height = + std::max(imageSize.y, imageSize.x / viewportAspect); + } + + private: + sophia::Entity camera; + sophia::RenderTargetHandle target{}; + glm::vec2 imageSize{1.f}; +}; + +SOPHIA_MAIN(ImageViewer) -- 2.47.3 From 5644782a1f2f40208d5983083154aff64765cfd6 Mon Sep 17 00:00:00 2001 From: Caleb Burke Date: Fri, 25 Sep 2026 22:34:25 -0700 Subject: [PATCH 04/18] Adding in simple alpha blending --- .../vulkan/pipelines/graphics_pipeline.cpp | 22 +++++++++++++++++-- .../vulkan/pipelines/graphics_pipeline.hpp | 6 ++++- 2 files changed, 25 insertions(+), 3 deletions(-) diff --git a/engine/src/vulkan/pipelines/graphics_pipeline.cpp b/engine/src/vulkan/pipelines/graphics_pipeline.cpp index 5c737c8..2e578e9 100644 --- a/engine/src/vulkan/pipelines/graphics_pipeline.cpp +++ b/engine/src/vulkan/pipelines/graphics_pipeline.cpp @@ -95,6 +95,12 @@ GraphicsPipeline::Builder& GraphicsPipeline::Builder::setVertexInput( return *this; } +GraphicsPipeline::Builder& GraphicsPipeline::Builder::setAlphaBlending( + bool enabled) { + this->alphaBlending = enabled; + return *this; +} + std::unique_ptr GraphicsPipeline::Builder::build() const { if (this->vertexShader == nullptr || this->fragmentShader == nullptr) { log::fatal( @@ -128,7 +134,8 @@ std::unique_ptr GraphicsPipeline::Builder::build() const { this->device, *this->vertexShader, *this->fragmentShader, this->pipelineLayout, this->colorAttachmentFormats, this->depthAttachmentFormat, this->stencilAttachmentFormat, - this->bindingDescriptions, this->attributeDescriptions)); + this->bindingDescriptions, this->attributeDescriptions, + this->alphaBlending)); } GraphicsPipeline::GraphicsPipeline( @@ -137,10 +144,21 @@ GraphicsPipeline::GraphicsPipeline( std::vector colorAttachmentFormats, vk::Format depthAttachmentFormat, vk::Format stencilAttachmentFormat, std::vector bindingDescriptions, - std::vector attributeDescriptions) + std::vector attributeDescriptions, + bool alphaBlending) : Pipeline(device, vk::PipelineBindPoint::eGraphics) { setDefaultGraphicsPipelineConfig(); + if (alphaBlending) { + vk::PipelineColorBlendAttachmentState& blend = + this->config.colorBlendAttachment; + blend.blendEnable = vk::True; + blend.srcColorBlendFactor = vk::BlendFactor::eSrcAlpha; + blend.dstColorBlendFactor = vk::BlendFactor::eOneMinusSrcAlpha; + blend.srcAlphaBlendFactor = vk::BlendFactor::eOne; + blend.dstAlphaBlendFactor = vk::BlendFactor::eOneMinusSrcAlpha; + } + this->config.bindingDescriptions = std::move(bindingDescriptions); this->config.attributeDescriptions = std::move(attributeDescriptions); this->config.pipelineLayout = pipelineLayout; diff --git a/engine/src/vulkan/pipelines/graphics_pipeline.hpp b/engine/src/vulkan/pipelines/graphics_pipeline.hpp index 2a77943..fe0d46e 100644 --- a/engine/src/vulkan/pipelines/graphics_pipeline.hpp +++ b/engine/src/vulkan/pipelines/graphics_pipeline.hpp @@ -47,7 +47,8 @@ class GraphicsPipeline : public Pipeline { std::vector colorAttachmentFormats, vk::Format depthAttachmentFormat, vk::Format stencilAttachmentFormat, std::vector bindingDescriptions, - std::vector attributeDescriptions); + std::vector attributeDescriptions, + bool alphaBlending); void setDefaultGraphicsPipelineConfig(); @@ -69,6 +70,8 @@ class GraphicsPipeline::Builder { Builder& setVertexInput( std::vector bindingDescriptions, std::vector attributeDescriptions); + // Straight (non-premultiplied) "over" blending on every color attachment. + Builder& setAlphaBlending(bool enabled = true); std::unique_ptr build() const; @@ -83,6 +86,7 @@ class GraphicsPipeline::Builder { vk::Format stencilAttachmentFormat = vk::Format::eUndefined; std::vector bindingDescriptions{}; std::vector attributeDescriptions{}; + bool alphaBlending = false; }; } // namespace sophia -- 2.47.3 From a21a842b5ba140dcc02612bf01ffdac6f7c2af9e Mon Sep 17 00:00:00 2001 From: Caleb Burke Date: Fri, 25 Sep 2026 22:59:01 -0700 Subject: [PATCH 05/18] Initial claude dump --- editor/main.cpp | 61 +++++- editor/panels/inspector_panel.cpp | 141 +++++++++++-- editor/panels/inspector_panel.hpp | 28 ++- editor/panels/scene_hierarchy_panel.cpp | 40 ++-- editor/panels/scene_hierarchy_panel.hpp | 28 +-- engine/include/sophia/components.hpp | 21 ++ engine/include/sophia/entity.hpp | 7 + engine/include/sophia/handles.hpp | 2 + .../include/sophia/resource_registry_ref.hpp | 11 + engine/include/sophia/scene.hpp | 7 +- engine/src/application.cpp | 11 +- engine/src/rendering/render_context.hpp | 1 + engine/src/rendering/scene_renderer.cpp | 128 +++++++----- engine/src/rendering/scene_renderer.hpp | 32 ++- engine/src/rendering/sprite_render_system.cpp | 194 ++++++++++++++++++ engine/src/rendering/sprite_render_system.hpp | 94 +++++++++ engine/src/resources/resource_registry.hpp | 13 +- .../src/resources/resource_registry_ref.cpp | 50 +++++ engine/src/resources/texture.cpp | 32 +++ engine/src/resources/texture.hpp | 38 ++++ engine/src/scene/scene.cpp | 22 +- engine/src/shaders/sprite.frag | 12 ++ engine/src/shaders/sprite.frag.spv.h | 42 ++++ engine/src/shaders/sprite.vert | 31 +++ engine/src/shaders/sprite.vert.spv.h | 98 +++++++++ examples/boids_2d/main.cpp | 115 +++++++++-- 26 files changed, 1101 insertions(+), 158 deletions(-) create mode 100644 engine/src/rendering/sprite_render_system.cpp create mode 100644 engine/src/rendering/sprite_render_system.hpp create mode 100644 engine/src/resources/texture.cpp create mode 100644 engine/src/resources/texture.hpp create mode 100644 engine/src/shaders/sprite.frag create mode 100644 engine/src/shaders/sprite.frag.spv.h create mode 100644 engine/src/shaders/sprite.vert create mode 100644 engine/src/shaders/sprite.vert.spv.h diff --git a/editor/main.cpp b/editor/main.cpp index 7e0eb49..81fb414 100644 --- a/editor/main.cpp +++ b/editor/main.cpp @@ -1,5 +1,7 @@ #include #include +#include +#include #include "panels/asset_browser_panel.hpp" #include "panels/inspector_panel.hpp" @@ -15,12 +17,19 @@ class Editor : public sophia::Application { debugUI().show(); - panels().emplace(); - panels().emplace(); + textures.emplace_back("Checker", createCheckerTexture()); + + sophia::SceneHandle sceneHandle = scenes().create(); + sophia::Scene& scene = scenes().get(sceneHandle); + sophia::Entity camera = createDemoScene(scene); + + panels().emplace(scene, selected); + panels().emplace(selected, textures); panels().emplace(); sophia::RenderTargetHandle sceneTarget = resources().create(); - views().create({.scene = scenes().create(), .target = sceneTarget}); + views().create( + {.scene = sceneHandle, .target = sceneTarget, .camera = camera}); panels().emplace(ui(), sceneTarget); panels().setDefaultLayout( @@ -31,6 +40,52 @@ class Editor : public sophia::Application { } void onUpdate(const sophia::FrameInfo& frameInfo) override {} + + private: + sophia::Entity createDemoScene(sophia::Scene& scene) { + sophia::Entity camera = scene.createEntity("Main Camera"); + camera.addComponent(); + scene.setActiveCamera(camera); + + sophia::Entity checker = scene.createEntity("Checker"); + checker.getComponent().position = {-1.5f, 0.f, + 0.f}; + checker.addComponent(sophia::SpriteComponent{ + .texture = textures[0].second, .size = {2.f, 2.f}}); + + sophia::Entity red = scene.createEntity("Red"); + red.getComponent().position = {1.f, -0.5f, 0.f}; + red.addComponent(sophia::SpriteComponent{ + .color = {0.9f, 0.25f, 0.25f, 1.f}, .size = {2.f, 2.f}}); + + // Drawn over "Red" because of its higher sort order. + sophia::Entity blue = scene.createEntity("Blue (translucent)"); + blue.getComponent().position = {1.75f, 0.25f, + 0.f}; + blue.addComponent( + sophia::SpriteComponent{.color = {0.25f, 0.45f, 0.95f, 0.6f}, + .size = {2.f, 2.f}, + .sortOrder = 1}); + + return camera; + } + + sophia::TextureHandle createCheckerTexture() { + constexpr sophia::u32 SIZE = 8; + std::vector pixels(SIZE * SIZE * 4); + for (sophia::u32 y = 0; y < SIZE; y++) { + for (sophia::u32 x = 0; x < SIZE; x++) { + sophia::u8 value = ((x + y) % 2 == 0) ? 230 : 60; + sophia::u8* pixel = &pixels[(y * SIZE + x) * 4]; + pixel[0] = pixel[1] = pixel[2] = value; + pixel[3] = 255; + } + } + return resources().create(SIZE, SIZE, std::move(pixels)); + } + + sophia::Entity selected; + InspectorPanel::TextureList textures; }; SOPHIA_MAIN(Editor) diff --git a/editor/panels/inspector_panel.cpp b/editor/panels/inspector_panel.cpp index 3fe5f83..4592a5c 100644 --- a/editor/panels/inspector_panel.cpp +++ b/editor/panels/inspector_panel.cpp @@ -3,30 +3,135 @@ #include #include +#include void InspectorPanel::onUpdate(const sophia::FrameInfo&) { - char nameBuf[128]; - std::snprintf(nameBuf, sizeof(nameBuf), "%s", name.c_str()); - if (ImGui::InputText("Name", nameBuf, sizeof(nameBuf))) { - name = nameBuf; + if (!selected) { + ImGui::TextDisabled("No entity selected"); + return; } - ImGui::Text("Tag: %s", tag.c_str()); + + drawTag(); + ImGui::Separator(); + drawTransform(); + drawCamera(); + drawSprite(); ImGui::Separator(); + drawAddComponent(); +} - if (ImGui::CollapsingHeader("Transform", ImGuiTreeNodeFlags_DefaultOpen)) { - ImGui::DragFloat3("Position", &position.x, 0.1f); - ImGui::DragFloat3("Rotation", &rotation.x, 0.1f); - ImGui::DragFloat3("Scale", &scale.x, 0.1f); - } +void InspectorPanel::drawTag() { + auto& tag = selected.getComponent(); - if (ImGui::CollapsingHeader("Mesh Renderer", - ImGuiTreeNodeFlags_DefaultOpen)) { - ImGui::Text("Mesh: %s", meshName.c_str()); - ImGui::Text("Material: %s", materialName.c_str()); - } - - if (ImGui::CollapsingHeader("Script", ImGuiTreeNodeFlags_DefaultOpen)) { - ImGui::Text("%s", scriptName.c_str()); + char nameBuf[128]; + std::snprintf(nameBuf, sizeof(nameBuf), "%s", tag.tag.c_str()); + if (ImGui::InputText("Name", nameBuf, sizeof(nameBuf))) { + tag.tag = nameBuf; + } +} + +void InspectorPanel::drawTransform() { + if (!selected.hasComponent() || + !ImGui::CollapsingHeader("Transform", ImGuiTreeNodeFlags_DefaultOpen)) { + return; + } + + auto& transform = selected.getComponent(); + ImGui::DragFloat3("Position", &transform.position.x, 0.1f); + + // 2D only: edits rotation around Z and drops any X/Y rotation. + float degrees = glm::degrees(glm::eulerAngles(transform.rotation).z); + if (ImGui::DragFloat("Rotation", °rees, 1.0f)) { + transform.rotation = + glm::angleAxis(glm::radians(degrees), glm::vec3{0.f, 0.f, 1.f}); + } + + ImGui::DragFloat3("Scale", &transform.scale.x, 0.1f); +} + +void InspectorPanel::drawCamera() { + if (!selected.hasComponent() || + !ImGui::CollapsingHeader("Camera", ImGuiTreeNodeFlags_DefaultOpen)) { + return; + } + + auto& camera = selected.getComponent(); + int projection = static_cast(camera.projection); + if (ImGui::Combo("Projection", &projection, "Orthographic\0Perspective\0")) { + camera.projection = + static_cast(projection); + } + + if (camera.projection == sophia::CameraComponent::Projection::Orthographic) { + ImGui::DragFloat("Height", &camera.ortho.height, 0.1f, 0.01f, 10000.f); + } else { + float fov = glm::degrees(camera.perspective.fov); + if (ImGui::DragFloat("FOV", &fov, 0.5f, 1.f, 179.f)) { + camera.perspective.fov = glm::radians(fov); + } + } +} + +void InspectorPanel::drawSprite() { + if (!selected.hasComponent()) { + return; + } + + bool open = true; + if (!ImGui::CollapsingHeader("Sprite", &open, + ImGuiTreeNodeFlags_DefaultOpen)) { + if (!open) { + selected.removeComponent(); + } + return; + } + + auto& sprite = selected.getComponent(); + + const char* current = "None"; + for (const auto& [name, handle] : textures) { + if (handle == sprite.texture) { + current = name.c_str(); + } + } + if (ImGui::BeginCombo("Texture", current)) { + if (ImGui::Selectable("None", !sprite.texture.isValid())) { + sprite.texture = sophia::INVALID_HANDLE; + } + for (const auto& [name, handle] : textures) { + if (ImGui::Selectable(name.c_str(), handle == sprite.texture)) { + sprite.texture = handle; + } + } + ImGui::EndCombo(); + } + + ImGui::ColorEdit4("Color", &sprite.color.x); + ImGui::DragFloat2("Size", &sprite.size.x, 0.05f); + ImGui::SliderFloat2("Pivot", &sprite.pivot.x, 0.f, 1.f); + ImGui::DragFloat4("UV Rect", &sprite.uvRect.x, 0.01f); + ImGui::DragInt("Sort Order", &sprite.sortOrder); + + if (!open) { + selected.removeComponent(); + } +} + +void InspectorPanel::drawAddComponent() { + if (ImGui::Button("Add Component")) { + ImGui::OpenPopup("AddComponent"); + } + + if (ImGui::BeginPopup("AddComponent")) { + if (!selected.hasComponent() && + ImGui::MenuItem("Sprite")) { + selected.addComponent(); + } + if (!selected.hasComponent() && + ImGui::MenuItem("Camera")) { + selected.addComponent(); + } + ImGui::EndPopup(); } } diff --git a/editor/panels/inspector_panel.hpp b/editor/panels/inspector_panel.hpp index 3a080c1..429d302 100644 --- a/editor/panels/inspector_panel.hpp +++ b/editor/panels/inspector_panel.hpp @@ -1,25 +1,31 @@ #pragma once -#include +#include #include +#include #include #include +#include +#include class InspectorPanel : public sophia::Panel { public: - InspectorPanel() : Panel{{.name = "Inspector"}} {} + // Stand-in for an asset browser: the textures a sprite can pick from. + using TextureList = + std::vector>; + + InspectorPanel(sophia::Entity& selected, const TextureList& textures) + : Panel{{.name = "Inspector"}}, selected{selected}, textures{textures} {} void onUpdate(const sophia::FrameInfo& frameInfo) override; private: - std::string name = "Player"; - std::string tag = "Player"; + void drawTag(); + void drawTransform(); + void drawCamera(); + void drawSprite(); + void drawAddComponent(); - glm::vec3 position{0.0f, 1.0f, 0.0f}; - glm::vec3 rotation{0.0f, 0.0f, 0.0f}; - glm::vec3 scale{1.0f, 1.0f, 1.0f}; - - std::string meshName = "player_capsule.fbx"; - std::string materialName = "player_mat"; - std::string scriptName = "PlayerController.lua"; + sophia::Entity& selected; + const TextureList& textures; }; diff --git a/editor/panels/scene_hierarchy_panel.cpp b/editor/panels/scene_hierarchy_panel.cpp index 08cf3c4..fc22caa 100644 --- a/editor/panels/scene_hierarchy_panel.cpp +++ b/editor/panels/scene_hierarchy_panel.cpp @@ -2,31 +2,31 @@ #include -void SceneHierarchyPanel::drawNode(const Node& node) { - if (node.children.empty()) { +#include + +void SceneHierarchyPanel::onUpdate(const sophia::FrameInfo&) { + if (ImGui::Button("+ Sprite")) { + selected = scene.createEntity("Sprite"); + selected.addComponent(); + } + + ImGui::Separator(); + + // Flat for now: there is no parent/child component yet. + scene.forEachEntity([this](sophia::Entity entity) { ImGuiTreeNodeFlags flags = ImGuiTreeNodeFlags_Leaf | ImGuiTreeNodeFlags_NoTreePushOnOpen | ImGuiTreeNodeFlags_SpanAvailWidth; - if (node.name == selected) { + if (entity == selected) { flags |= ImGuiTreeNodeFlags_Selected; } - ImGui::TreeNodeEx(node.name.c_str(), flags); + + const std::string& name = entity.getComponent().tag; + ImGui::PushID(static_cast(static_cast(entity))); + ImGui::TreeNodeEx(name.c_str(), flags); if (ImGui::IsItemClicked()) { - selected = node.name; + selected = entity; } - return; - } - - if (ImGui::TreeNodeEx(node.name.c_str(), ImGuiTreeNodeFlags_SpanAvailWidth)) { - for (const Node& child : node.children) { - drawNode(child); - } - ImGui::TreePop(); - } -} - -void SceneHierarchyPanel::onUpdate(const sophia::FrameInfo&) { - for (const Node& node : nodes) { - drawNode(node); - } + ImGui::PopID(); + }); } diff --git a/editor/panels/scene_hierarchy_panel.hpp b/editor/panels/scene_hierarchy_panel.hpp index 2833b32..c732068 100644 --- a/editor/panels/scene_hierarchy_panel.hpp +++ b/editor/panels/scene_hierarchy_panel.hpp @@ -1,32 +1,20 @@ #pragma once +#include #include +#include #include -#include -#include class SceneHierarchyPanel : public sophia::Panel { public: - SceneHierarchyPanel() : Panel{{.name = "Scene Hierarchy", .locked = true}} {} + SceneHierarchyPanel(sophia::Scene& scene, sophia::Entity& selected) + : Panel{{.name = "Scene Hierarchy", .locked = true}}, + scene{scene}, + selected{selected} {} void onUpdate(const sophia::FrameInfo& frameInfo) override; private: - struct Node { - std::string name; - std::vector children; - }; - - void drawNode(const Node& node); - - std::vector nodes = { - {"Main Camera", {}}, - {"Directional Light", {}}, - {"Ground", {}}, - {"Player", {}}, - {"Enemies", {{"Enemy_01", {}}, {"Enemy_02", {}}, {"Enemy_03", {}}}}, - {"Props", {{"Crate_01", {}}, {"Crate_02", {}}}}, - }; - - std::string selected; + sophia::Scene& scene; + sophia::Entity& selected; }; diff --git a/engine/include/sophia/components.hpp b/engine/include/sophia/components.hpp index 9b39b76..eae6ebd 100644 --- a/engine/include/sophia/components.hpp +++ b/engine/include/sophia/components.hpp @@ -47,6 +47,27 @@ struct MeshComponent { MeshHandle handle; }; +/** + * A textured quad in the XY plane, placed by the entity's TransformComponent. + * Only rotation around Z is meaningful. + */ +struct SpriteComponent { + // Invalid draws a solid quad in `color`. + TextureHandle texture = INVALID_HANDLE; + glm::vec4 color{1.f, 1.f, 1.f, 1.f}; + + // Size in world units, before the transform's scale. + glm::vec2 size{1.f, 1.f}; + // Point on the sprite, from (0, 0) to (1, 1) across its size, that sits at + // the transform's position and that it rotates around. + glm::vec2 pivot{0.5f, 0.5f}; + // Region of the texture to draw, as normalized (u0, v0, u1, v1). + glm::vec4 uvRect{0.f, 0.f, 1.f, 1.f}; + + // Higher draws on top. Ties are broken by the transform's position.z. + s32 sortOrder = 0; +}; + struct CameraComponent { struct Orthographic { float height = 10.f; diff --git a/engine/include/sophia/entity.hpp b/engine/include/sophia/entity.hpp index 0c3950d..971d49f 100644 --- a/engine/include/sophia/entity.hpp +++ b/engine/include/sophia/entity.hpp @@ -59,4 +59,11 @@ class Entity { Scene* scene = nullptr; }; +template +void Scene::forEachEntity(Fn&& fn) { + for (auto [handle] : registry.storage().each()) { + fn(Entity{handle, this}); + } +} + } // namespace sophia diff --git a/engine/include/sophia/handles.hpp b/engine/include/sophia/handles.hpp index 298b51b..7855be0 100644 --- a/engine/include/sophia/handles.hpp +++ b/engine/include/sophia/handles.hpp @@ -38,11 +38,13 @@ class Panel; class RenderTarget; class Scene; struct SceneView; +class Texture; using MeshHandle = Handle; using PanelHandle = Handle; using RenderTargetHandle = Handle; using SceneHandle = Handle; using SceneViewHandle = Handle; +using TextureHandle = Handle; } // namespace sophia diff --git a/engine/include/sophia/resource_registry_ref.hpp b/engine/include/sophia/resource_registry_ref.hpp index 9ea4200..241593d 100644 --- a/engine/include/sophia/resource_registry_ref.hpp +++ b/engine/include/sophia/resource_registry_ref.hpp @@ -26,8 +26,10 @@ class ResourceRegistryRef { void requestResize(RenderTargetHandle handle, u32 width, u32 height); glm::vec2 getExtent(RenderTargetHandle handle) const; + glm::vec2 getExtent(TextureHandle handle) const; bool isAlive(RenderTargetHandle handle) const; + bool isAlive(TextureHandle handle) const; template void release(Handle handle); @@ -45,16 +47,25 @@ class ResourceRegistryRef { RenderTargetHandle createResource(std::type_identity, u32 width = 1, u32 height = 1); + TextureHandle createResource(std::type_identity, u32 width, + u32 height, std::vector pixels); + ResourceRegistry* registry; }; template <> MeshHandle ResourceRegistryRef::load(const std::string& path); +template <> +TextureHandle ResourceRegistryRef::load(const std::string& path); + template <> void ResourceRegistryRef::release(MeshHandle handle); template <> void ResourceRegistryRef::release(RenderTargetHandle handle); +template <> +void ResourceRegistryRef::release(TextureHandle handle); + } // namespace sophia diff --git a/engine/include/sophia/scene.hpp b/engine/include/sophia/scene.hpp index 687b50a..2e4af2c 100644 --- a/engine/include/sophia/scene.hpp +++ b/engine/include/sophia/scene.hpp @@ -13,9 +13,14 @@ class Scene { Scene(); ~Scene(); - void createEntity(const std::string& name = {}); + // Every entity gets a TagComponent (named `name`) and a TransformComponent. + Entity createEntity(const std::string& name = {}); void destroyEntity(Entity entity); + /** Calls `fn(Entity)` for every live entity. Defined in entity.hpp. */ + template + void forEachEntity(Fn&& fn); + // The camera a render request uses when it doesn't name one. Null until // set. entt::entity getActiveCamera() const { return activeCamera; } diff --git a/engine/src/application.cpp b/engine/src/application.cpp index 84ae53e..dadc490 100644 --- a/engine/src/application.cpp +++ b/engine/src/application.cpp @@ -65,7 +65,8 @@ class Application::Impl { void run() { ModelRenderSystem modelRenderSystem{device, renderContext}; SceneRenderer sceneRenderer{this->application.sceneRegistry, - this->resourceRegistry}; + this->resourceRegistry, device, + renderContext.getImageFormat()}; ImGuiRenderer imguiRenderer{window, device, renderContext.getImageFormat(), renderContext.getImageCount(), this->resourceRegistry}; @@ -128,6 +129,7 @@ class Application::Impl { } imguiRenderer.beginFrame(); + sceneRenderer.beginFrame(renderContext.getFrameIndex()); panelRegistry.update(frameInfo); this->application.onRender(); @@ -170,10 +172,11 @@ class Application::Impl { : vk::AttachmentLoadOp::eLoad, {color.r, color.g, color.b, color.a}); }, - [&sceneRenderer, &sceneViewRegistry, handle](vk::CommandBuffer) { - const SceneView& view = sceneViewRegistry.get(handle); + [&sceneRenderer, &sceneViewRegistryConst, + handle](vk::CommandBuffer commandBuffer) { + const SceneView& view = sceneViewRegistryConst.get(handle); if (view.camera) { - sceneRenderer.render(view); + sceneRenderer.render(commandBuffer, view); } }); } diff --git a/engine/src/rendering/render_context.hpp b/engine/src/rendering/render_context.hpp index 25001e1..d5667d1 100644 --- a/engine/src/rendering/render_context.hpp +++ b/engine/src/rendering/render_context.hpp @@ -39,6 +39,7 @@ class RenderContext { vk::Format getImageFormat() const { return this->swapchain->getImageFormat(); } + u32 getFrameIndex() const { return this->currentFrameIndex; } u32 getImageCount() const { return static_cast(this->swapchain->imageCount()); } diff --git a/engine/src/rendering/scene_renderer.cpp b/engine/src/rendering/scene_renderer.cpp index fc1e8be..71d6ee6 100644 --- a/engine/src/rendering/scene_renderer.cpp +++ b/engine/src/rendering/scene_renderer.cpp @@ -1,74 +1,102 @@ #include "rendering/scene_renderer.hpp" +#include #include #include +#include namespace sophia { -namespace { -struct PushConstantData { - glm::mat4 transform{1.f}; - glm::vec4 color{1.f}; -}; -} // namespace - SceneRenderer::SceneRenderer(const SceneRegistry& sceneRegistry, - ResourceRegistry& resources) - : sceneRegistry{sceneRegistry}, resources{resources} {} + ResourceRegistry& resources, Device& device, + vk::Format colorFormat) + : sceneRegistry{sceneRegistry}, + resources{resources}, + spriteRenderSystem{device, colorFormat, resources} {} SceneRenderer::~SceneRenderer() {} -void SceneRenderer::render(SceneView sceneView) { - auto& handle = sceneView.scene; - auto& scene = this->sceneRegistry.get(handle); +void SceneRenderer::beginFrame(u32 frameIndex) { + this->spriteRenderSystem.beginFrame(frameIndex); +} - auto& camera = sceneView.camera; - SOPHIA_ASSERT(camera.hasComponent(), +void SceneRenderer::render(vk::CommandBuffer commandBuffer, + const SceneView& sceneView) { + const Scene& scene = this->sceneRegistry.get(sceneView.scene); + const entt::registry& registry = scene.registry; + + entt::entity camera = sceneView.camera; + SOPHIA_ASSERT(registry.all_of(camera), "camera does not have camera component!"); - auto& registry = scene.registry; + vk::Extent2D extent = + this->resources.renderTargetPool.get(sceneView.target).getExtent(); + float aspect = + static_cast(extent.width) / static_cast(extent.height); - auto view = registry.view(); + // The view matrix ignores the camera's scale; zoom is the projection's job. + glm::mat4 cameraWorld{1.f}; + if (const auto* transform = registry.try_get(camera)) { + cameraWorld = glm::translate(glm::mat4{1.f}, transform->position) * + glm::mat4_cast(transform->rotation); + } + glm::mat4 viewProjection = + registry.get(camera).getProjection(aspect) * + glm::inverse(cameraWorld); - for (auto entity : view) { - auto& transform = view.get(entity); - log::info(transform); + renderSprites(commandBuffer, scene, viewProjection); + + // TODO: meshes. Group MeshComponent entities by mesh and draw each group + // (instanced), as sprites are grouped by texture. +} + +void SceneRenderer::renderSprites(vk::CommandBuffer commandBuffer, + const Scene& scene, + const glm::mat4& viewProjection) { + std::vector& items = this->spriteDrawItems; + items.clear(); + + auto view = + scene.registry.view(); + for (auto [entity, transform, sprite] : view.each()) { + TextureHandle texture = this->resources.texturePool.isAlive(sprite.texture) + ? sprite.texture + : this->resources.whiteTexture; + + // Unit quad -> sprite rectangle around its pivot -> world. + glm::mat4 model = + transform.mat4() * + glm::translate(glm::mat4{1.f}, + glm::vec3{-sprite.pivot * sprite.size, 0.f}) * + glm::scale(glm::mat4{1.f}, glm::vec3{sprite.size, 1.f}); + + items.push_back({sprite.sortOrder, + transform.position.z, + texture, + {model, sprite.color, sprite.uvRect}}); } - // Get all mesh - // For each mesh, get all entities(ES) that have a transform and that mesh - // For e in ES: add e's transform component to a list + // Texture is the last key so that sprites whose order doesn't matter + // relative to each other still end up in as few batches as possible. + std::ranges::sort(items, {}, [](const SpriteDrawItem& item) { + return std::tuple{item.sortOrder, item.depth, item.texture}; + }); - // We now have - /* - M = mesh - T = transform + this->spriteInstances.clear(); + this->spriteBatches.clear(); + for (const SpriteDrawItem& item : items) { + auto index = static_cast(this->spriteInstances.size()); + this->spriteInstances.push_back(item.instance); - Work Batch - |- M0 - | |- T0 - | \- T2 - | - |- M1 - | |- T1 - | \- T5 - | - \- M2 - |- T3 - \- T4 + if (this->spriteBatches.empty() || + this->spriteBatches.back().texture != item.texture) { + this->spriteBatches.push_back({item.texture, index, 0}); + } + this->spriteBatches.back().instanceCount++; + } - */ - - /* - for batch in Work Batch: - batch.mesh.bind() - - for transform in batch.transforms: - commandBuffer.pushConstants(transform) - batch.mesh.draw(commandBuffer) - - NOTE: Use instanced rendering? - */ + this->spriteRenderSystem.render(commandBuffer, viewProjection, + this->spriteInstances, this->spriteBatches); } } // namespace sophia diff --git a/engine/src/rendering/scene_renderer.hpp b/engine/src/rendering/scene_renderer.hpp index abaf69b..e7c50a4 100644 --- a/engine/src/rendering/scene_renderer.hpp +++ b/engine/src/rendering/scene_renderer.hpp @@ -2,28 +2,54 @@ #include #include +#include +#include "rendering/sprite_render_system.hpp" #include "resources/resource_registry.hpp" namespace sophia { /** * !TEMP to be decoupled once scene batching and rendering impl + * + * Turns a scene's components into draw calls for a SceneView. */ class SceneRenderer { public: SceneRenderer(const SceneRenderer&) = delete; SceneRenderer& operator=(const SceneRenderer&) = delete; - SceneRenderer(const SceneRegistry& sceneRegistry, - ResourceRegistry& resources); + SceneRenderer(const SceneRegistry& sceneRegistry, ResourceRegistry& resources, + Device& device, vk::Format colorFormat); ~SceneRenderer(); - void render(SceneView sceneView); + // Call once per frame, before any render(). + void beginFrame(u32 frameIndex); + + // Records `sceneView` into `commandBuffer`. Rendering into the view's + // target must already have begun. + void render(vk::CommandBuffer commandBuffer, const SceneView& sceneView); private: + struct SpriteDrawItem { + s32 sortOrder; + float depth; + TextureHandle texture; + SpriteRenderSystem::Instance instance; + }; + + void renderSprites(vk::CommandBuffer commandBuffer, const Scene& scene, + const glm::mat4& viewProjection); + const SceneRegistry& sceneRegistry; ResourceRegistry& resources; + + SpriteRenderSystem spriteRenderSystem; + + // Reused across frames to avoid reallocating. + std::vector spriteDrawItems; + std::vector spriteInstances; + std::vector spriteBatches; }; } // namespace sophia diff --git a/engine/src/rendering/sprite_render_system.cpp b/engine/src/rendering/sprite_render_system.cpp new file mode 100644 index 0000000..98fca65 --- /dev/null +++ b/engine/src/rendering/sprite_render_system.cpp @@ -0,0 +1,194 @@ +#include "rendering/sprite_render_system.hpp" + +#include +#include + +#include "shaders/sprite.frag.spv.h" +#include "shaders/sprite.vert.spv.h" +#include "vulkan/descriptors/descriptor_writer.hpp" + +namespace sophia { + +namespace { +constexpr u32 MAX_TEXTURES = 1024; +constexpr u32 VERTICES_PER_SPRITE = 6; +} // namespace + +SpriteRenderSystem::SpriteRenderSystem(Device& device, vk::Format colorFormat, + ResourceRegistry& resources) + : device{device}, resources{resources} { + createDescriptors(); + createPipelineLayout(); + createPipeline(colorFormat); + createInstanceBuffers(); +} + +SpriteRenderSystem::~SpriteRenderSystem() { + log::trace("destroyed sophia::SpriteRenderSystem"); +} + +void SpriteRenderSystem::beginFrame(u32 frameIndex) { + this->frameIndex = frameIndex; + this->instanceCursor = 0; +} + +void SpriteRenderSystem::render(vk::CommandBuffer commandBuffer, + const glm::mat4& viewProjection, + std::span instances, + std::span batches) { + if (instances.empty()) { + return; + } + + u32 available = MAX_INSTANCES_PER_FRAME - this->instanceCursor; + if (instances.size() > available) { + log::warning("SpriteRenderSystem: frame instance buffer full, dropping", + instances.size() - available, "sprites"); + } + + Buffer& buffer = *this->instanceBuffers[this->frameIndex]; + u32 base = this->instanceCursor; + u32 count = std::min(static_cast(instances.size()), available); + buffer.writeToBuffer(const_cast(instances.data()), + count * sizeof(Instance), base * sizeof(Instance)); + this->instanceCursor += count; + + this->graphicsPipeline->bind(commandBuffer); + + PushConstantData push{viewProjection}; + commandBuffer.pushConstants(this->pipelineLayout.get(), + vk::ShaderStageFlagBits::eVertex, 0, + sizeof(PushConstantData), &push); + + vk::Buffer vertexBuffer = buffer.getBuffer(); + vk::DeviceSize offset = 0; + commandBuffer.bindVertexBuffers(0, 1, &vertexBuffer, &offset); + + for (const Batch& batch : batches) { + if (batch.firstInstance >= count) { + break; + } + u32 batchCount = std::min(batch.instanceCount, count - batch.firstInstance); + + vk::DescriptorSet set = getDescriptorSet(batch.texture); + commandBuffer.bindDescriptorSets(vk::PipelineBindPoint::eGraphics, + this->pipelineLayout.get(), 0, 1, &set, 0, + nullptr); + commandBuffer.draw(VERTICES_PER_SPRITE, batchCount, 0, + base + batch.firstInstance); + } +} + +vk::DescriptorSet SpriteRenderSystem::getDescriptorSet(TextureHandle handle) { + auto it = this->descriptorSets.find(handle.index); + if (it != this->descriptorSets.end() && + it->second.generation == handle.generation) { + return it->second.set; + } + + const Texture& texture = this->resources.texturePool.get(handle); + vk::DescriptorImageInfo imageInfo = texture.descriptorInfo(); + DescriptorWriter writer{*this->setLayout, *this->descriptorPool}; + writer.writeImage(0, &imageInfo); + + if (it == this->descriptorSets.end()) { + vk::DescriptorSet set; + bool allocated = writer.build(set); + SOPHIA_ASSERT(allocated, "SpriteRenderSystem: out of texture descriptors"); + this->descriptorSets.emplace(static_cast(handle.index), + CachedDescriptorSet{handle.generation, set}); + return set; + } + + // The slot was reused by a new texture. Releasing a texture waits for the + // device to go idle, so no in-flight frame can still be using this set. + writer.overwrite(it->second.set); + it->second.generation = handle.generation; + return it->second.set; +} + +void SpriteRenderSystem::createDescriptors() { + this->setLayout = + DescriptorSetLayout::Builder(this->device) + .addBinding(0, vk::DescriptorType::eCombinedImageSampler, + vk::ShaderStageFlagBits::eFragment) + .build(); + + this->descriptorPool = + DescriptorPool::Builder(this->device) + .setMaxSets(MAX_TEXTURES) + .addPoolSize(vk::DescriptorType::eCombinedImageSampler, MAX_TEXTURES) + .build(); +} + +void SpriteRenderSystem::createPipelineLayout() { + vk::PushConstantRange pushConstantRange{}; + pushConstantRange.stageFlags = vk::ShaderStageFlagBits::eVertex; + pushConstantRange.offset = 0; + pushConstantRange.size = sizeof(PushConstantData); + + vk::DescriptorSetLayout setLayout = this->setLayout->getDescriptorSetLayout(); + + vk::PipelineLayoutCreateInfo pipelineLayoutInfo = {}; + pipelineLayoutInfo.setLayoutCount = 1; + pipelineLayoutInfo.pSetLayouts = &setLayout; + pipelineLayoutInfo.pushConstantRangeCount = 1; + pipelineLayoutInfo.pPushConstantRanges = &pushConstantRange; + + try { + this->pipelineLayout = + this->device.get()->createPipelineLayoutUnique(pipelineLayoutInfo); + log::trace("created vk::PipelineLayout"); + } catch (const vk::SystemError& err) { + log::fatal("failed to create vk::PipelineLayout"); + throw std::runtime_error("failed to create vk::PipelineLayout"); + } +} + +void SpriteRenderSystem::createPipeline(vk::Format colorFormat) { + auto vertexShader = Shader::Builder() + .fromSPIRV(shaders::sprite_vert_spv) + .setStage(ShaderStage::VERTEX) + .build(); + auto fragmentShader = Shader::Builder() + .fromSPIRV(shaders::sprite_frag_spv) + .setStage(ShaderStage::FRAGMENT) + .build(); + + std::vector bindings{ + {0, sizeof(Instance), vk::VertexInputRate::eInstance}}; + + std::vector attributes; + // A mat4 attribute takes four consecutive locations, one per column. + for (u32 column = 0; column < 4; column++) { + attributes.push_back({column, 0, vk::Format::eR32G32B32A32Sfloat, + static_cast(offsetof(Instance, model) + + column * sizeof(glm::vec4))}); + } + attributes.push_back({4, 0, vk::Format::eR32G32B32A32Sfloat, + static_cast(offsetof(Instance, color))}); + attributes.push_back({5, 0, vk::Format::eR32G32B32A32Sfloat, + static_cast(offsetof(Instance, uvRect))}); + + this->graphicsPipeline = GraphicsPipeline::Builder(this->device) + .setVertexShader(*vertexShader) + .setFragmentShader(*fragmentShader) + .setPipelineLayout(this->pipelineLayout.get()) + .setColorAttachmentFormats({colorFormat}) + .setVertexInput(bindings, attributes) + .setAlphaBlending() + .build(); +} + +void SpriteRenderSystem::createInstanceBuffers() { + for (std::unique_ptr& buffer : this->instanceBuffers) { + buffer = std::make_unique( + this->device, sizeof(Instance), MAX_INSTANCES_PER_FRAME, + vk::BufferUsageFlagBits::eVertexBuffer, + vk::MemoryPropertyFlagBits::eHostVisible | + vk::MemoryPropertyFlagBits::eHostCoherent); + buffer->map(); + } +} + +} // namespace sophia diff --git a/engine/src/rendering/sprite_render_system.hpp b/engine/src/rendering/sprite_render_system.hpp new file mode 100644 index 0000000..d3109f0 --- /dev/null +++ b/engine/src/rendering/sprite_render_system.hpp @@ -0,0 +1,94 @@ +#pragma once + +#include +#include +#include +#include +#include +#include + +#include "rendering/render_context.hpp" +#include "resources/resource_registry.hpp" +#include "vulkan/buffer.hpp" +#include "vulkan/descriptors/descriptor_pool.hpp" +#include "vulkan/descriptors/descriptor_set_layout.hpp" +#include "vulkan/device.hpp" +#include "vulkan/pipelines/graphics_pipeline.hpp" + +namespace sophia { + +/** + * Draws batches of textured quads. Knows nothing about scenes: callers hand + * it instances already in draw order, grouped into runs that share a texture. + * + * Instances are written to a per-frame host-visible buffer, so every + * render() call within one frame appends to it; call beginFrame() once per + * frame before any render(). + */ +class SpriteRenderSystem { + public: + // Layout must match the per-instance inputs in sprite.vert. + struct Instance { + glm::mat4 model{1.f}; + glm::vec4 color{1.f}; + glm::vec4 uvRect{0.f, 0.f, 1.f, 1.f}; + }; + + // A run of consecutive instances drawn with the same texture. + struct Batch { + TextureHandle texture; + u32 firstInstance; + u32 instanceCount; + }; + + static constexpr u32 MAX_INSTANCES_PER_FRAME = 32768; + + SpriteRenderSystem(const SpriteRenderSystem&) = delete; + SpriteRenderSystem& operator=(const SpriteRenderSystem&) = delete; + + SpriteRenderSystem(Device& device, vk::Format colorFormat, + ResourceRegistry& resources); + ~SpriteRenderSystem(); + + void beginFrame(u32 frameIndex); + + void render(vk::CommandBuffer commandBuffer, const glm::mat4& viewProjection, + std::span instances, + std::span batches); + + private: + struct PushConstantData { + glm::mat4 viewProjection{1.f}; + }; + + struct CachedDescriptorSet { + u32 generation; + vk::DescriptorSet set; + }; + + void createDescriptors(); + void createPipelineLayout(); + void createPipeline(vk::Format colorFormat); + void createInstanceBuffers(); + + vk::DescriptorSet getDescriptorSet(TextureHandle handle); + + Device& device; + ResourceRegistry& resources; + + std::unique_ptr setLayout; + std::unique_ptr descriptorPool; + // One set per texture slot, keyed by handle index. A generation mismatch + // means the slot was reused by a new texture, so the set is rewritten. + std::unordered_map descriptorSets; + + vk::UniquePipelineLayout pipelineLayout; + std::unique_ptr graphicsPipeline; + + std::array, RenderContext::MAX_FRAMES_IN_FLIGHT> + instanceBuffers; + u32 frameIndex = 0; + u32 instanceCursor = 0; +}; + +} // namespace sophia diff --git a/engine/src/resources/resource_registry.hpp b/engine/src/resources/resource_registry.hpp index 3912cf7..2cbca9a 100644 --- a/engine/src/resources/resource_registry.hpp +++ b/engine/src/resources/resource_registry.hpp @@ -1,10 +1,12 @@ #pragma once +#include #include #include #include "resources/mesh.hpp" #include "resources/pools/render_target_pool.hpp" +#include "resources/texture.hpp" #include "vulkan/device.hpp" namespace sophia { @@ -15,13 +17,20 @@ class ResourceRegistry { ResourceRegistry& operator=(const ResourceRegistry&) = delete; ResourceRegistry(Device& device, vk::Format renderTargetFormat) - : device{device}, renderTargetPool{device, renderTargetFormat} {} + : device{device}, renderTargetPool{device, renderTargetFormat} { + constexpr std::array WHITE{0xFF, 0xFF, 0xFF, 0xFF}; + whiteTexture = texturePool.create(device, 1, 1, WHITE); + } Device& device; Pool meshPool{"Mesh"}; RenderTargetPool renderTargetPool; - // TexturePool textures; + Pool texturePool{"Texture"}; // MaterialPool materials; + + // 1x1 white. Stands in for sprites without a texture, so they draw as a + // solid quad in their tint color. + TextureHandle whiteTexture = INVALID_HANDLE; }; } // namespace sophia diff --git a/engine/src/resources/resource_registry_ref.cpp b/engine/src/resources/resource_registry_ref.cpp index 6d963a8..346f7c8 100644 --- a/engine/src/resources/resource_registry_ref.cpp +++ b/engine/src/resources/resource_registry_ref.cpp @@ -1,5 +1,9 @@ +#include + #include #include +#include +#include #include "resources/resource_registry.hpp" @@ -14,6 +18,26 @@ MeshHandle ResourceRegistryRef::load(const std::string& path) { return MeshHandle{}; } +template <> +TextureHandle ResourceRegistryRef::load(const std::string& path) { + int width = 0; + int height = 0; + int channels = 0; + // Always decode to RGBA8, whatever the file has. + stbi_uc* pixels = stbi_load(path.c_str(), &width, &height, &channels, 4); + if (pixels == nullptr) { + log::fatal("failed to load texture", path, "-", stbi_failure_reason()); + throw std::runtime_error("failed to load texture: " + path); + } + + auto size = static_cast(width) * static_cast(height) * 4; + TextureHandle handle = registry->texturePool.create( + registry->device, static_cast(width), static_cast(height), + std::span{pixels, size}); + stbi_image_free(pixels); + return handle; +} + template <> void ResourceRegistryRef::release(MeshHandle handle) { registry->meshPool.release(handle); @@ -24,6 +48,15 @@ void ResourceRegistryRef::release(RenderTargetHandle handle) { registry->renderTargetPool.release(handle); } +template <> +void ResourceRegistryRef::release(TextureHandle handle) { + SOPHIA_ASSERT(handle != registry->whiteTexture, + "the built-in white texture cannot be released"); + // Frames in flight may still be sampling it. + registry->device.waitIdle(); + registry->texturePool.release(handle); +} + MeshHandle ResourceRegistryRef::createResource( std::type_identity, std::vector vertices, std::vector indices) { @@ -42,6 +75,13 @@ RenderTargetHandle ResourceRegistryRef::createResource( return registry->renderTargetPool.create(width, height); } +TextureHandle ResourceRegistryRef::createResource(std::type_identity, + u32 width, u32 height, + std::vector pixels) { + return registry->texturePool.create(registry->device, width, height, + std::span{pixels}); +} + void ResourceRegistryRef::requestResize(RenderTargetHandle handle, u32 width, u32 height) { registry->renderTargetPool.get(handle).requestResize(width, height); @@ -56,4 +96,14 @@ bool ResourceRegistryRef::isAlive(RenderTargetHandle handle) const { return registry->renderTargetPool.isAlive(handle); } +glm::vec2 ResourceRegistryRef::getExtent(TextureHandle handle) const { + const Texture& texture = registry->texturePool.get(handle); + return {static_cast(texture.getWidth()), + static_cast(texture.getHeight())}; +} + +bool ResourceRegistryRef::isAlive(TextureHandle handle) const { + return registry->texturePool.isAlive(handle); +} + } // namespace sophia diff --git a/engine/src/resources/texture.cpp b/engine/src/resources/texture.cpp new file mode 100644 index 0000000..0da52c1 --- /dev/null +++ b/engine/src/resources/texture.cpp @@ -0,0 +1,32 @@ +#include "resources/texture.hpp" + +#include +#include + +namespace sophia { + +Texture::Texture(Device& device, u32 width, u32 height, + std::span pixels) { + SOPHIA_ASSERT(width > 0 && height > 0, "texture must not be empty"); + SOPHIA_ASSERT(pixels.size() == static_cast(width) * height * 4, + "texture pixel data must be width * height RGBA8 texels"); + + this->image = Image::Builder(device) + .setExtent(width, height) + .setFormat(vk::Format::eR8G8B8A8Srgb) + .setUsage(vk::ImageUsageFlagBits::eSampled) + .setInitialData(pixels.data(), pixels.size()) + .withView() + .withSampler(vk::Filter::eLinear, + vk::SamplerAddressMode::eClampToEdge) + .build(); +} + +Texture::~Texture() { log::trace("destroyed sophia::Texture"); } + +vk::DescriptorImageInfo Texture::descriptorInfo() const { + return {this->image->getSampler(), this->image->getView(), + vk::ImageLayout::eShaderReadOnlyOptimal}; +} + +} // namespace sophia diff --git a/engine/src/resources/texture.hpp b/engine/src/resources/texture.hpp new file mode 100644 index 0000000..d3f1873 --- /dev/null +++ b/engine/src/resources/texture.hpp @@ -0,0 +1,38 @@ +#pragma once + +#include +#include +#include +#include + +#include "vulkan/device.hpp" +#include "vulkan/image.hpp" + +namespace sophia { + +/** + * A sampled, read-only RGBA8 (sRGB) image. + * + * Owned by the ResourceRegistry and addressed through a TextureHandle. + */ +class Texture { + public: + /** `pixels` is width * height tightly packed RGBA8 texels, top row first. */ + Texture(Device& device, u32 width, u32 height, std::span pixels); + ~Texture(); + + Texture(const Texture&) = delete; + Texture& operator=(const Texture&) = delete; + + const Image& getImage() const { return *this->image; } + + u32 getWidth() const { return this->image->getExtent().width; } + u32 getHeight() const { return this->image->getExtent().height; } + + vk::DescriptorImageInfo descriptorInfo() const; + + private: + std::unique_ptr image; +}; + +} // namespace sophia diff --git a/engine/src/scene/scene.cpp b/engine/src/scene/scene.cpp index 375424b..1dfb9db 100644 --- a/engine/src/scene/scene.cpp +++ b/engine/src/scene/scene.cpp @@ -1,16 +1,26 @@ #include +#include #include #include namespace sophia { -Scene::Scene() { - entt::entity entity = this->registry.create(); - - auto& a = this->registry.emplace(entity); - auto& b = this->registry.get(entity); -} +Scene::Scene() {} Scene::~Scene() { log::trace("destroying sophia::Scene"); } +Entity Scene::createEntity(const std::string& name) { + Entity entity{this->registry.create(), this}; + entity.addComponent(name.empty() ? "Entity" : name); + entity.addComponent(); + return entity; +} + +void Scene::destroyEntity(Entity entity) { + if (this->activeCamera == entity) { + this->activeCamera = entt::null; + } + this->registry.destroy(entity); +} + } // namespace sophia diff --git a/engine/src/shaders/sprite.frag b/engine/src/shaders/sprite.frag new file mode 100644 index 0000000..4f0972a --- /dev/null +++ b/engine/src/shaders/sprite.frag @@ -0,0 +1,12 @@ +#version 450 + +layout (location = 0) in vec4 fragColor; +layout (location = 1) in vec2 fragUv; + +layout (location = 0) out vec4 outColor; + +layout (set = 0, binding = 0) uniform sampler2D spriteTexture; + +void main() { + outColor = texture(spriteTexture, fragUv) * fragColor; +} diff --git a/engine/src/shaders/sprite.frag.spv.h b/engine/src/shaders/sprite.frag.spv.h new file mode 100644 index 0000000..be6a06c --- /dev/null +++ b/engine/src/shaders/sprite.frag.spv.h @@ -0,0 +1,42 @@ +#pragma once + +#include +#include + +namespace sophia::shaders { + +inline constexpr std::array sprite_frag_spv = { + 0x07230203, 0x00010000, 0x000d000b, 0x00000018, 0x00000000, 0x00020011, + 0x00000001, 0x0006000b, 0x00000001, 0x4c534c47, 0x6474732e, 0x3035342e, + 0x00000000, 0x0003000e, 0x00000000, 0x00000001, 0x0008000f, 0x00000004, + 0x00000004, 0x6e69616d, 0x00000000, 0x00000009, 0x00000011, 0x00000015, + 0x00030010, 0x00000004, 0x00000007, 0x00030003, 0x00000002, 0x000001c2, + 0x000a0004, 0x475f4c47, 0x4c474f4f, 0x70635f45, 0x74735f70, 0x5f656c79, + 0x656e696c, 0x7269645f, 0x69746365, 0x00006576, 0x00080004, 0x475f4c47, + 0x4c474f4f, 0x6e695f45, 0x64756c63, 0x69645f65, 0x74636572, 0x00657669, + 0x00040005, 0x00000004, 0x6e69616d, 0x00000000, 0x00050005, 0x00000009, + 0x4374756f, 0x726f6c6f, 0x00000000, 0x00060005, 0x0000000d, 0x69727073, + 0x65546574, 0x72757478, 0x00000065, 0x00040005, 0x00000011, 0x67617266, + 0x00007655, 0x00050005, 0x00000015, 0x67617266, 0x6f6c6f43, 0x00000072, + 0x00040047, 0x00000009, 0x0000001e, 0x00000000, 0x00040047, 0x0000000d, + 0x00000021, 0x00000000, 0x00040047, 0x0000000d, 0x00000022, 0x00000000, + 0x00040047, 0x00000011, 0x0000001e, 0x00000001, 0x00040047, 0x00000015, + 0x0000001e, 0x00000000, 0x00020013, 0x00000002, 0x00030021, 0x00000003, + 0x00000002, 0x00030016, 0x00000006, 0x00000020, 0x00040017, 0x00000007, + 0x00000006, 0x00000004, 0x00040020, 0x00000008, 0x00000003, 0x00000007, + 0x0004003b, 0x00000008, 0x00000009, 0x00000003, 0x00090019, 0x0000000a, + 0x00000006, 0x00000001, 0x00000000, 0x00000000, 0x00000000, 0x00000001, + 0x00000000, 0x0003001b, 0x0000000b, 0x0000000a, 0x00040020, 0x0000000c, + 0x00000000, 0x0000000b, 0x0004003b, 0x0000000c, 0x0000000d, 0x00000000, + 0x00040017, 0x0000000f, 0x00000006, 0x00000002, 0x00040020, 0x00000010, + 0x00000001, 0x0000000f, 0x0004003b, 0x00000010, 0x00000011, 0x00000001, + 0x00040020, 0x00000014, 0x00000001, 0x00000007, 0x0004003b, 0x00000014, + 0x00000015, 0x00000001, 0x00050036, 0x00000002, 0x00000004, 0x00000000, + 0x00000003, 0x000200f8, 0x00000005, 0x0004003d, 0x0000000b, 0x0000000e, + 0x0000000d, 0x0004003d, 0x0000000f, 0x00000012, 0x00000011, 0x00050057, + 0x00000007, 0x00000013, 0x0000000e, 0x00000012, 0x0004003d, 0x00000007, + 0x00000016, 0x00000015, 0x00050085, 0x00000007, 0x00000017, 0x00000013, + 0x00000016, 0x0003003e, 0x00000009, 0x00000017, 0x000100fd, 0x00010038, +}; + +} // namespace sophia::shaders diff --git a/engine/src/shaders/sprite.vert b/engine/src/shaders/sprite.vert new file mode 100644 index 0000000..d217501 --- /dev/null +++ b/engine/src/shaders/sprite.vert @@ -0,0 +1,31 @@ +#version 450 + +// Per instance; layout must match SpriteRenderSystem::Instance. +layout (location = 0) in mat4 model; // Maps the unit quad to world space. +layout (location = 4) in vec4 color; +layout (location = 5) in vec4 uvRect; + +layout (location = 0) out vec4 fragColor; +layout (location = 1) out vec2 fragUv; + +layout (push_constant) uniform Push { + mat4 viewProjection; +} push; + +// Two triangles covering the unit quad (0,0)-(1,1). +const vec2 CORNERS[6] = vec2[]( + vec2(0.0, 0.0), vec2(1.0, 0.0), vec2(1.0, 1.0), + vec2(1.0, 1.0), vec2(0.0, 1.0), vec2(0.0, 0.0) +); + +void main() { + vec2 corner = CORNERS[gl_VertexIndex]; + + gl_Position = push.viewProjection * model * vec4(corner, 0.0, 1.0); + // Draw order comes from the CPU-side sort, so flatten depth; sprites should + // never be clipped by the camera's near/far planes. + gl_Position.z = 0.0; + + fragColor = color; + fragUv = mix(uvRect.xy, uvRect.zw, corner); +} diff --git a/engine/src/shaders/sprite.vert.spv.h b/engine/src/shaders/sprite.vert.spv.h new file mode 100644 index 0000000..081edfa --- /dev/null +++ b/engine/src/shaders/sprite.vert.spv.h @@ -0,0 +1,98 @@ +#pragma once + +#include +#include + +namespace sophia::shaders { + +inline constexpr std::array sprite_vert_spv = { + 0x07230203, 0x00010000, 0x000d000b, 0x00000045, 0x00000000, 0x00020011, + 0x00000001, 0x0006000b, 0x00000001, 0x4c534c47, 0x6474732e, 0x3035342e, + 0x00000000, 0x0003000e, 0x00000000, 0x00000001, 0x000c000f, 0x00000000, + 0x00000004, 0x6e69616d, 0x00000000, 0x00000016, 0x00000021, 0x0000002b, + 0x00000038, 0x0000003a, 0x0000003d, 0x0000003e, 0x00030003, 0x00000002, + 0x000001c2, 0x000a0004, 0x475f4c47, 0x4c474f4f, 0x70635f45, 0x74735f70, + 0x5f656c79, 0x656e696c, 0x7269645f, 0x69746365, 0x00006576, 0x00080004, + 0x475f4c47, 0x4c474f4f, 0x6e695f45, 0x64756c63, 0x69645f65, 0x74636572, + 0x00657669, 0x00040005, 0x00000004, 0x6e69616d, 0x00000000, 0x00040005, + 0x00000009, 0x6e726f63, 0x00007265, 0x00060005, 0x00000016, 0x565f6c67, + 0x65747265, 0x646e4978, 0x00007865, 0x00050005, 0x00000019, 0x65646e69, + 0x6c626178, 0x00000065, 0x00060005, 0x0000001f, 0x505f6c67, 0x65567265, + 0x78657472, 0x00000000, 0x00060006, 0x0000001f, 0x00000000, 0x505f6c67, + 0x7469736f, 0x006e6f69, 0x00070006, 0x0000001f, 0x00000001, 0x505f6c67, + 0x746e696f, 0x657a6953, 0x00000000, 0x00070006, 0x0000001f, 0x00000002, + 0x435f6c67, 0x4470696c, 0x61747369, 0x0065636e, 0x00070006, 0x0000001f, + 0x00000003, 0x435f6c67, 0x446c6c75, 0x61747369, 0x0065636e, 0x00030005, + 0x00000021, 0x00000000, 0x00040005, 0x00000024, 0x68737550, 0x00000000, + 0x00070006, 0x00000024, 0x00000000, 0x77656976, 0x6a6f7250, 0x69746365, + 0x00006e6f, 0x00040005, 0x00000026, 0x68737570, 0x00000000, 0x00040005, + 0x0000002b, 0x65646f6d, 0x0000006c, 0x00050005, 0x00000038, 0x67617266, + 0x6f6c6f43, 0x00000072, 0x00040005, 0x0000003a, 0x6f6c6f63, 0x00000072, + 0x00040005, 0x0000003d, 0x67617266, 0x00007655, 0x00040005, 0x0000003e, + 0x65527675, 0x00007463, 0x00040047, 0x00000016, 0x0000000b, 0x0000002a, + 0x00030047, 0x0000001f, 0x00000002, 0x00050048, 0x0000001f, 0x00000000, + 0x0000000b, 0x00000000, 0x00050048, 0x0000001f, 0x00000001, 0x0000000b, + 0x00000001, 0x00050048, 0x0000001f, 0x00000002, 0x0000000b, 0x00000003, + 0x00050048, 0x0000001f, 0x00000003, 0x0000000b, 0x00000004, 0x00030047, + 0x00000024, 0x00000002, 0x00040048, 0x00000024, 0x00000000, 0x00000005, + 0x00050048, 0x00000024, 0x00000000, 0x00000007, 0x00000010, 0x00050048, + 0x00000024, 0x00000000, 0x00000023, 0x00000000, 0x00040047, 0x0000002b, + 0x0000001e, 0x00000000, 0x00040047, 0x00000038, 0x0000001e, 0x00000000, + 0x00040047, 0x0000003a, 0x0000001e, 0x00000004, 0x00040047, 0x0000003d, + 0x0000001e, 0x00000001, 0x00040047, 0x0000003e, 0x0000001e, 0x00000005, + 0x00020013, 0x00000002, 0x00030021, 0x00000003, 0x00000002, 0x00030016, + 0x00000006, 0x00000020, 0x00040017, 0x00000007, 0x00000006, 0x00000002, + 0x00040020, 0x00000008, 0x00000007, 0x00000007, 0x00040015, 0x0000000a, + 0x00000020, 0x00000000, 0x0004002b, 0x0000000a, 0x0000000b, 0x00000006, + 0x0004001c, 0x0000000c, 0x00000007, 0x0000000b, 0x0004002b, 0x00000006, + 0x0000000d, 0x00000000, 0x0005002c, 0x00000007, 0x0000000e, 0x0000000d, + 0x0000000d, 0x0004002b, 0x00000006, 0x0000000f, 0x3f800000, 0x0005002c, + 0x00000007, 0x00000010, 0x0000000f, 0x0000000d, 0x0005002c, 0x00000007, + 0x00000011, 0x0000000f, 0x0000000f, 0x0005002c, 0x00000007, 0x00000012, + 0x0000000d, 0x0000000f, 0x0009002c, 0x0000000c, 0x00000013, 0x0000000e, + 0x00000010, 0x00000011, 0x00000011, 0x00000012, 0x0000000e, 0x00040015, + 0x00000014, 0x00000020, 0x00000001, 0x00040020, 0x00000015, 0x00000001, + 0x00000014, 0x0004003b, 0x00000015, 0x00000016, 0x00000001, 0x00040020, + 0x00000018, 0x00000007, 0x0000000c, 0x00040017, 0x0000001c, 0x00000006, + 0x00000004, 0x0004002b, 0x0000000a, 0x0000001d, 0x00000001, 0x0004001c, + 0x0000001e, 0x00000006, 0x0000001d, 0x0006001e, 0x0000001f, 0x0000001c, + 0x00000006, 0x0000001e, 0x0000001e, 0x00040020, 0x00000020, 0x00000003, + 0x0000001f, 0x0004003b, 0x00000020, 0x00000021, 0x00000003, 0x0004002b, + 0x00000014, 0x00000022, 0x00000000, 0x00040018, 0x00000023, 0x0000001c, + 0x00000004, 0x0003001e, 0x00000024, 0x00000023, 0x00040020, 0x00000025, + 0x00000009, 0x00000024, 0x0004003b, 0x00000025, 0x00000026, 0x00000009, + 0x00040020, 0x00000027, 0x00000009, 0x00000023, 0x00040020, 0x0000002a, + 0x00000001, 0x00000023, 0x0004003b, 0x0000002a, 0x0000002b, 0x00000001, + 0x00040020, 0x00000033, 0x00000003, 0x0000001c, 0x0004002b, 0x0000000a, + 0x00000035, 0x00000002, 0x00040020, 0x00000036, 0x00000003, 0x00000006, + 0x0004003b, 0x00000033, 0x00000038, 0x00000003, 0x00040020, 0x00000039, + 0x00000001, 0x0000001c, 0x0004003b, 0x00000039, 0x0000003a, 0x00000001, + 0x00040020, 0x0000003c, 0x00000003, 0x00000007, 0x0004003b, 0x0000003c, + 0x0000003d, 0x00000003, 0x0004003b, 0x00000039, 0x0000003e, 0x00000001, + 0x00050036, 0x00000002, 0x00000004, 0x00000000, 0x00000003, 0x000200f8, + 0x00000005, 0x0004003b, 0x00000008, 0x00000009, 0x00000007, 0x0004003b, + 0x00000018, 0x00000019, 0x00000007, 0x0004003d, 0x00000014, 0x00000017, + 0x00000016, 0x0003003e, 0x00000019, 0x00000013, 0x00050041, 0x00000008, + 0x0000001a, 0x00000019, 0x00000017, 0x0004003d, 0x00000007, 0x0000001b, + 0x0000001a, 0x0003003e, 0x00000009, 0x0000001b, 0x00050041, 0x00000027, + 0x00000028, 0x00000026, 0x00000022, 0x0004003d, 0x00000023, 0x00000029, + 0x00000028, 0x0004003d, 0x00000023, 0x0000002c, 0x0000002b, 0x00050092, + 0x00000023, 0x0000002d, 0x00000029, 0x0000002c, 0x0004003d, 0x00000007, + 0x0000002e, 0x00000009, 0x00050051, 0x00000006, 0x0000002f, 0x0000002e, + 0x00000000, 0x00050051, 0x00000006, 0x00000030, 0x0000002e, 0x00000001, + 0x00070050, 0x0000001c, 0x00000031, 0x0000002f, 0x00000030, 0x0000000d, + 0x0000000f, 0x00050091, 0x0000001c, 0x00000032, 0x0000002d, 0x00000031, + 0x00050041, 0x00000033, 0x00000034, 0x00000021, 0x00000022, 0x0003003e, + 0x00000034, 0x00000032, 0x00060041, 0x00000036, 0x00000037, 0x00000021, + 0x00000022, 0x00000035, 0x0003003e, 0x00000037, 0x0000000d, 0x0004003d, + 0x0000001c, 0x0000003b, 0x0000003a, 0x0003003e, 0x00000038, 0x0000003b, + 0x0004003d, 0x0000001c, 0x0000003f, 0x0000003e, 0x0007004f, 0x00000007, + 0x00000040, 0x0000003f, 0x0000003f, 0x00000000, 0x00000001, 0x0004003d, + 0x0000001c, 0x00000041, 0x0000003e, 0x0007004f, 0x00000007, 0x00000042, + 0x00000041, 0x00000041, 0x00000002, 0x00000003, 0x0004003d, 0x00000007, + 0x00000043, 0x00000009, 0x0008000c, 0x00000007, 0x00000044, 0x00000001, + 0x0000002e, 0x00000040, 0x00000042, 0x00000043, 0x0003003e, 0x0000003d, + 0x00000044, 0x000100fd, 0x00010038, +}; + +} // namespace sophia::shaders diff --git a/examples/boids_2d/main.cpp b/examples/boids_2d/main.cpp index 8dcaa57..a3d9536 100644 --- a/examples/boids_2d/main.cpp +++ b/examples/boids_2d/main.cpp @@ -1,3 +1,5 @@ +#include + #include #include #include @@ -7,8 +9,12 @@ #include #include #include +#include +#include #include #include +#include +#include #include #include #include @@ -16,6 +22,24 @@ struct Boid { glm::vec2 position; glm::vec2 velocity; + sophia::Entity entity; +}; + +// Shows a render target filling the whole panel. +class ViewportPanel : public sophia::Panel { + public: + ViewportPanel(sophia::UI& ui, sophia::RenderTargetHandle target) + : Panel{{.name = "Boids", + .windowFlags = ImGuiWindowFlags_NoScrollbar | + ImGuiWindowFlags_NoScrollWithMouse}}, + ui{ui}, + target{target} {} + + void onUpdate(const sophia::FrameInfo&) override { ui.image(target); } + + private: + sophia::UI& ui; + sophia::RenderTargetHandle target; }; constexpr uint32_t DEFAULT_NUMBER_OF_BOIDS = 25; @@ -81,28 +105,53 @@ class Boids2D : public sophia::Application { boid.velocity = glm::vec2{std::cos(theta), std::sin(theta)} * MAX_SPEED; } - // Boid shape in local space, nose pointing along +x; each boid is drawn - // as an instance of this one mesh with a per-boid transform. - std::vector vertices{ - {{BOID_LENGTH * 0.5f, 0.0f}, {1.0f, 1.0f, 1.0f}}, - {{-BOID_LENGTH * 0.5f, BOID_WIDTH * 0.5f}, {1.0f, 1.0f, 1.0f}}, - {{-BOID_LENGTH * 0.5f, -BOID_WIDTH * 0.5f}, {1.0f, 1.0f, 1.0f}}, - }; - boidMesh = resources().create(std::move(vertices)); + boidTexture = createBoidTexture(); + + sceneHandle = scenes().create(); + sophia::Scene& scene = scenes().get(sceneHandle); + + cameraEntity = scene.createEntity("Camera"); + cameraEntity.addComponent(); + + std::uniform_real_distribution tint{0.0f, 1.0f}; + for (Boid& boid : boids) { + boid.entity = scene.createEntity("Boid"); + boid.entity.addComponent(sophia::SpriteComponent{ + .texture = boidTexture, + .color = glm::vec4{glm::mix(glm::vec3{0.55f, 0.8f, 1.0f}, + glm::vec3{1.0f, 0.85f, 0.55f}, tint(rng)), + 1.0f}, + .size = {BOID_LENGTH, BOID_WIDTH}}); + } + + target = resources().create(); + views().create({.scene = sceneHandle, + .target = target, + .camera = cameraEntity, + .clearColor = {0.01f, 0.01f, 0.02f, 1.0f}}); + + panels().emplace(ui(), target); + panels().setDefaultLayout({.center = {"Boids"}}); } void onUpdate(const sophia::FrameInfo& frameInfo) override { float scrollDistance = SCROLL_SPEED * static_cast(frameInfo.deltaTime); - if (scrollLeft) camera.position.x -= scrollDistance; - if (scrollRight) camera.position.x += scrollDistance; - if (scrollUp) camera.position.y -= scrollDistance; - if (scrollDown) camera.position.y += scrollDistance; + glm::vec3& cameraPosition = + cameraEntity.getComponent().position; + if (scrollLeft) cameraPosition.x -= scrollDistance; + if (scrollRight) cameraPosition.x += scrollDistance; + if (scrollUp) cameraPosition.y -= scrollDistance; + if (scrollDown) cameraPosition.y += scrollDistance; + + // One world unit per pixel, whatever size the viewport is. + cameraEntity.getComponent().ortho.height = + resources().getExtent(target).y; updateBoids(static_cast(frameInfo.deltaTime)); - for (const Boid& boid : boids) { - drawBoid(boid); + for (Boid& boid : boids) { + syncTransform(boid); } } @@ -212,17 +261,40 @@ class Boids2D : public sophia::Application { if (position.y < -WORLD_HALF_HEIGHT) position.y = WORLD_HALF_HEIGHT; } - void drawBoid(const Boid& boid) { + void syncTransform(Boid& boid) { glm::vec2 direction = boid.velocity; float speed = glm::length(direction); direction = speed > 1e-5f ? direction / speed : glm::vec2{0.0f, -1.0f}; float angle = std::atan2(direction.y, direction.x); - glm::mat4 transform = - glm::translate(glm::mat4{1.f}, glm::vec3(boid.position, 0.0f)) * - glm::rotate(glm::mat4{1.f}, angle, glm::vec3(0.0f, 0.0f, 1.0f)); + auto& transform = boid.entity.getComponent(); + transform.position = glm::vec3(boid.position, 0.0f); + transform.rotation = glm::angleAxis(angle, glm::vec3(0.0f, 0.0f, 1.0f)); + } - drawMesh(boidMesh, transform); + // Boid shape, nose pointing along +u, as an anti-aliased white triangle on + // a transparent background; each boid's sprite tints it. + sophia::TextureHandle createBoidTexture() { + constexpr uint32_t WIDTH = 64; + constexpr uint32_t HEIGHT = 40; + + std::vector pixels(WIDTH * HEIGHT * 4); + for (uint32_t y = 0; y < HEIGHT; ++y) { + for (uint32_t x = 0; x < WIDTH; ++x) { + float u = (static_cast(x) + 0.5f) / WIDTH; + float v = (static_cast(y) + 0.5f) / HEIGHT; + // Distance inside the triangle's edge, in pixels. + float inside = (0.5f * (1.0f - u) - std::abs(v - 0.5f)) * HEIGHT; + float alpha = std::clamp(inside + 0.5f, 0.0f, 1.0f); + + uint8_t* pixel = &pixels[(y * WIDTH + x) * 4]; + pixel[0] = pixel[1] = pixel[2] = 255; + pixel[3] = static_cast(alpha * 255.0f); + } + } + + return resources().create(WIDTH, HEIGHT, + std::move(pixels)); } void setScrollKeyHeld(sophia::KeyCode keycode, bool held) { @@ -235,7 +307,10 @@ class Boids2D : public sophia::Application { std::vector boids; std::vector> grid{ static_cast(GRID_WIDTH * GRID_HEIGHT)}; - sophia::MeshHandle boidMesh{}; + sophia::TextureHandle boidTexture{}; + sophia::SceneHandle sceneHandle{}; + sophia::RenderTargetHandle target{}; + sophia::Entity cameraEntity; bool scrollLeft = false; bool scrollRight = false; bool scrollUp = false; -- 2.47.3 From 571472a20442037170a409cb95919f5c50ce4e67 Mon Sep 17 00:00:00 2001 From: Caleb Burke Date: Fri, 25 Sep 2026 23:09:56 -0700 Subject: [PATCH 06/18] adding screenshot of using engine editor as a showcase --- README.md | 2 ++ media/showcase.png | Bin 0 -> 426210 bytes 2 files changed, 2 insertions(+) create mode 100644 media/showcase.png diff --git a/README.md b/README.md index 6e268ef..a4541c0 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@ # sophia +![showcase](./media/showcase.png) + ## Getting Started COMING SOON diff --git a/media/showcase.png b/media/showcase.png new file mode 100644 index 0000000000000000000000000000000000000000..ce3acf43caf0ab6ecc41248cdd4dbdfdda2b806b GIT binary patch literal 426210 zcmY&L%7ySux)ySoQ>2=4A092R$n;10nZ65I){3*X-RzV}!4)z;Qd z%^zFO%=9@=cb}dpWko3@1Uv))0DvSTEv^axd~yc>pi$uW;#*qE7k#Gpqkv^o6e^3yqCDrdP z#jh~be}(AQ%fgyn~MkUTj+33x%KQ25tJ=V-JQ=siUtbN z&8Tbj_-Gg`Er4pA`ifNQ?h$27VTb|5rp#e*CCbwED3H*Qp^#|e$?%9l5O5Gd7SbPz z%A!Dz5*K5*aKITQv?)1aTQj2lv_5WVB#gRbWYum3j3@*u4k@06rDo_QBaOH?Kr}Qm zC}`CHuPRamF6f85jfOCQhB%9tN=&_mmWmwUoXHIhP)1(_9#Ets3J2pN(okrLf4jkj z870gp2O>hsagLyC%UUXWncgWDR{%#$LhJb)0hE@(Q+b@Jw1whLAACiAJm$notm!ae=oqk~Le>EM02;(<^ocQ@N ztV^o*RR$4fAqy8xpHT&MubaMEu!-_aZ6Pxs+8-xb8AG?*<#8t2dQ6%k7zG*y)mz^m zM>bLvlC|enK~()vm69T2kbE9rkLD;9Gy4LCWEj6`l^kuTByk{76eWy2QXGdz=g;$P zD^qTpf<^p(7=rE5NLN$`q~F~)?`J6s5sfv~wtLq!;h>3%L}O`@sM^@;9cIWNW$7ra zw2O5O+2FDERY+p$-{wZ1@d+1$p8)!dF3=)*V z5k;+t1l}&6XC%XXZ#I(L^8li`=JFfx(&AZu*&4=#k>ZGU38>=+VI-gBYP0dtk!!?DwAi0lNOoRgWc`F5!q3M+wnw9%uEhOl zNJf-~81`x=5#`3$?J#-FM)DmrA&G=RMTLfkQx9q> zxFc_~mH!p^(9sX=1ATo*X&oTvv#L_=&$om3X*rob7NUau{ z?ZU`$62wrhgC zW9uL6GczQjgV5#!phSfuF+l5k?M{|9o(4qL0AURDe0fRLp;_F|d`J_}!pBqYWtZ-v z&=ARRxUdx8c`nN9xkDjI=lQjuN7eUk#?pyknT1)4J?(jWGEX`4;eR6v5y&M1n!898 z_k+LHp;2W(gac*OrFrjTgUwD4D}m4rfA-LpsRW8z} z1j1+tBqOmEKx|WzO#Z+Uw*HS-sISO(7-|@(Xrc{oqL3ANM71i#548rRe2=Narqyt! zL2y&b5F*vjm0Jj(>&j(8SQLYDh`4~SeY`s9se`zJ*;M*M1^J1rxR`a2mb-S-mkBvJoRxZKtMt*qSrn1D;!`CC;?l}D zM6O1WvX!D}>is6um<~&VBbQPYP_W^VHf>0-Jn))7u6Z5HrL7mlCFv$S(lcmC)s@LS zLE(A#@v8B4DK$WRv%&(|NsWni7TKn>5*2Ejf>-V2gNYL3%GLa4Q1awBsA*>#*G5L# zPbrg5FF6WMhor$}FJOr{19Nr6gTlFeyH?$W8s8Z%&WTw1@S^loMTbMvr+%pzUPszU1#a-jbU7f!iFjhpMrviX@R+>zB)Bhx1hY zsorCwWLin-QKEJ8i<>_rQZFPh&$uw{JcG>XU!+Py$u9!t1aNhNbf}WM30Gp(U~W2- zQjIVE%x@QAL?T1Nc4S#>HTRp-q_e)CISYR!Wg({T2bz%2fuv|%)=m>zxX=ItIa&mLF-Ji5PUezUvPpPun z?2%AfAXWopQ*k3%s_Zvk0BFiGKot~G6tt;mP(rB5b_cKX|xKSwqp(4LsAq$g#;861w83*zU ztqGBT^7S{)(?4ty-6aY~pJ80?-`KuC*(_z))@O)|BdX`@nyjoD z&#&-AoysaVKu9cJJby&zBSl?JZpNXN?12QY*ga}Y;m?{aS05!;{;BG3$oIyI9HSNy zxCw-$BUR7t^80b~QlcJ{2fcNNZ?)-~u#TFG83eB_G$%4E8&=y8kfYFnjfD((?#AhYm-i|_m=2|j`(t%~YrmXLVn3t0B6-6WPF=0!6q?WHO)ddl* zlDLqS&-?HHF7My#{QV13=b-;wfko>YL})2)#)_u7`r8n{$kSz>+eRaUvBTbV>I6Q; zgp`bl-VX-+iA>{c6K(*iI}PXY*tcm0j6s zL!BdOi{KqlNYHK`3|yIJrjwG)ZQ{&UeUqblHx-^31k}Uz!!KBWOF*U2Rnhb)szYtm zG3@gn1G!jMZ;F!YCaR@XL;RzvZnQ*ahbK^^Wn>x4eOt)$G!^^l`A%;J>B~FjGsoqS zAxwn#SEfu=Rq3H%{=X*}1c(4si%_EpjA@?CWf5z{S0>B%k~SDTD2@3j(`9)h)|D7H zPs}^fd7fN;&zwlRKlcQ**1D?KI_oYvy;OvH-(W@$c45(}(cuC^X;D)mWhzuR>?NtZ z{rSpXi$HX^CM2TKZ6V^3q0sV;8<4FjUWjKJWce#8`ZE|nuY9)sgwf&Af&=;P!{2{| zM~o}GZyFTQsWW8A;o37VWlXk+2ZZ71`57UW)6|@h0x-udCJ#DwXC$b(q~PhA%iA~Q zCqQp4v6(Z1FN@W|dt@;8qHE8%EM6rfnyqa`)~?=j>5X}3Us{=#BGVZ*0IP<3-Lcwg zE_M-iOOw2Z>`5AAWU$CIV>kW>e9MxL_L`4Zf~&p%V4MtQG;Qh=v*+aptEob$t2nh> zXrnZ|VSW|AcHFpjM{L@pb){7}*r2?M7HVJOu9as?*Wgb+In2L0vD5sa5Sf3V(3qGM5>w~1p>p?QTTQJ( z8|KvN=s2WxQ5#(FyxFAt zFXzODv+*x*9xp(m+kGuaH09&zHKH(6cUfcg76B@fxqhEG^hoBKaE9!IWzJ%zuu(< z=Navf>$%Q>!vnEo6Z3J?FtcWK5e=Th*zrA2#nm`h=v0a8u?0&#{HE;-OnL#w05~X< z`XZ*r_CVR>j?^_ftFkc**ldGe>)B|gn1%J+ogN;R*fuT+cG|ywD8M2SeuuL-ifFub zJWa_%iG%JRGgl8m(yVuGvDu2y0)VOCmN zb=kFi^KA--(+tg8zdxZc&0A>($&zutXoeU~9dL<=xTJ}+R%I^xjpHp@H4oJWRKF1^ zx`3E!_hP(T^7N5zwLFS6qg$p9eO#0h%G34@ZS1{P6sR|iyZenPZDy=TNZpE%Y;MVV zd`*fjJSP47(vmH&G49GIz-eCU0Mn}GOH0qNq=L`fzBL?dXc5^P{nPsaeJFo&gY;*(MLSxu z)_|s8E(b&Sj>r%wPl$DnfOmK1!P^*Edm9F*>S>b`W;{G3>5**8K6$;HRghA@O$(45 z2a*#PQ_N4-nu$ILFw9vYGnEZ%Wi7w<ozv$|a5O<&s|5;Y9yA+U z^w6mU0>jXe6VE~%Wj~ie_=lp3pg<=KPnLrq+w9 z>W*83j1;D0htwp>`QltHQ$BQMOZZ&z+1oaxf%oV_^{an7H{taN?ZO1b2cnGK(#*!g z90vBiI1FKF7cTd;c+WUAW0Z|LdRtt2O_&ZEmmvN~a1F9Pz$pj8{rHKY*2Ppr!_R}W z5>87}f)qX#ZZt#7Etql$3DAKV{p2}5-fugcB+Ll)YkkaixZi{PpG{L5iZs=|-hi8* zL{vvJfTtZ<3XI47?}!HER?@@v4B%q_945|9juuIb&I))~S3`plZ0WTxkKV+5hV0T9 z6%=Xx=&GU=PQ#BIH&0^O+`#Cha~^c!+uAgs_ynm}LDwe97iHtXLfS&jEq1O#vCOR6 zv@KJ0+W?o?Zs=J=;;@Vror!9eXSZBB9gGnaDPrs_KkD;?%0Y353j-dbr6rr zA!`c0Lb%bw1euFXHf^nzF=|ytOV`w(eMQ6$Z`g?WxB4I_$DQ{X+O>~3=XJ$MKNQuZ zE~d4L2+lGJZsoI|9SF4u&dr6VSJR}1bgAPr6ly)1(EeHU{;8JH-wsU^b2+nRTe`}q zW1m?cG0P4_QdMQ9L97HXXoGAtS;cqoZL_Ob?JykYQ5~Rx{qJ@)2nErnui)%v@4OKC z1O1EV9j?bfl$B)jtWkH%>*S-ypx5t=>K+jzjp#MqMB&m>l~T#jSSXJs=pR>^=yn9f z5yphC6Ei#o*c&y^BpEf{-95`CON@@oR&*Dqib@G+a9>g~ADP7}sI}HGn0&F6xa=i; ztQvsic=RQzr)(KP=1L-rR_Yma+r;c(L!5MT^%Os8efV@C6b>jR*f_|Tk0hDJ$8%Vl;VC7KWUz=oU0^icC-hpLx z2xv>=Zohvw>}225et3?#9BSefI8Y?tQK}I_>Mc9~?E&{S-FJ7(+^rbbviV_7nz{bL ztn&|tD#@K`2KoG5^!F=dQIT+O-N zbD%Kx3jwcu7Au9ftYrP)oMaiNOX&K(v3-bNha+!{{_%6<9s|Dtgbq!NWvoGcJ(^ds zw~ZgJSBFS)698(29@f3ZKS~a--Y!e8+LBwIn#zBRKLWo_!avB;M%WblM14yN45ooNsQzJpSR&VRzL?Ez39 ze)k8D;k|a_nKliX-)W2j7RqM_vs`EKGxT}5*l_oc(zAL#gayDa}t1u%dIZkC7_bvyZKaR z!di!fwkY>v;ic#AzAV9>6)|K6!{#x~AGX}u*#~ZP3T+5Yke*N!fNpvnR`$#yL~sd6UKf~8+5GuLkVI}3@rSleggpLK9H9&uxGzF2ZPSn@PARnL z+CRi!9mYYA!>8D&t+fV^LWT#h+G11soFUTWh{a8Y`AnX{wvjIX$9O9=r^RYwv9u-! z(fhg%42@)Rik~9l5nl*K;t4hi#UjXQvP5;FHm~jMN9!6u!`}kDuRmnBk2?ioE`ae3fK1*s|53{n`!0RH zyk7KaMDaNL%btDNbU_a6LU17Irccp;Fz0s&c>@ut^@N?BN)G#PltRpjz=AiF~Z$qjtRT{m)HX#7-NB!-?{ zw9EWUL;mBN&13mCJG@1l{^k2(jw8q=C?uFht<3FYewaL!!=*zmgK??Q=s|pr)BQlH zlrE4qE!oo{t|n8h)5Wn;1GC*$WR1t+)^~po(l#s`w6Nb$^<$cS{8Of$34GKkMmwgE)Huh{j$63T$lNI>ace$F#a(cbn zn=R-wQ>XP>^pe9yOBaWfBF6W>DGi^o8S(^<%CTX)_1T1K&jN2M zt)yc8`nF0hg!0(E`)B1S<#XLGy^pe_hYm z1bmKfMZU6q%F4p@V&#WAN4?8dt@&&xj zA50!GX#Y+44t4wa4l8eIzj|0MV{7^Tp#YnS@MZh2<+Pq3m)YTCQy_Phj9NnPz38{= zUY(}ikKJ1tCI0u-TTp)2by<#X8)w>H`_nF`*{FhctKV?<^Jk-g=d?G!4O)q=){Bw2 zoOa z-=Yc>bq(8H4o*3&a#4-WdhX^Q_Ne?i?Ir#MhsD752tGae+&4D{J`E06t<>6WcZV&- zVSnmozu35%3TSsw%T2MMmeCY4iE^t%M{ejF z#{woX_83$|95=aOmIb+k8!S~ePbeF2V2aLspuU>w6w+5tc{l4NpoUF{+4fepc+-8r zN?xY)w{x9Mq2}HA#{8C?TrXK6|3i7zP0+LS2+e(hjGHy6j6epVwL37E11@}zO&`rt zO|!bR3(DG>CQAHQ{BHc)_?gRKN#@SG-*ZnM-lu(+|4N`SZu#iv`^R#DUoHNn;|GY_ zMA^(V#%iqg6k#>Irk*pjnyD3xvzcE7d*&hSxaqZv9q?1fzS3OPPTw_O4x(@6Qg!qw zd6QiP$*}Zsn!3z7YQgN^6vC#M5;7bA1a~rT;&BTu@}IFNyCpNN_n3d^JNK7^qdvAy z7T_RcL-Cr&@_EXrbw}`Hma9>9c*>hih45M?blz&Df{5jG3U)2%R zx~}FCrHbbk@YvfA()F%-j+9DEOY7cmck15HgtVHS%7L^&Nn{b&ShY_pf$w#XgUGcy zO?a^az7LsSQZq6N+~#FusWD=P;a2s!ALDD=(1>w&0$%$#>@+e^ZL+F3;vGiIrZ>5|JE`J$V$rt2`3Ob_1r2((AAmuNDOLKYhSPb5E1ab z)9&$UStj*oV;A-IUK=qAuvw`!*zma6_5$4x$6#Y)U|64h0_e8&{;nYrlT5(7KPK}> zKtRa9+6f$rOww{cMv0N=`v^G9UaE3BTX+960Hb?&ex9qSWhCJBi#U$KVYz#lZ!lZ| zU#Rz=Yd#y!Fl2o}0PuR8E>?M7fp1?ftG7#&<+RWJNlJwkP^0PmDN$1MuI`+z2|O{?IMsv8j-{fqG1HytU?1##-eP~{&Kfl)lY}@ST-&Cs!0(@G z{lFzQSd_np)=du_j(!m7}OI)bKKU0zyurzdFRS-M=}zQmVr5hy`vDQ3g|8pDI?9N}TCz zCRw|WllUpB7Fz{r&Wq+(PNZ$c6a_D+bQ@5V5D72#Gd+@AFhokI@PKSP7Tdo&f-0jy<8`e_4Pz7a9$G zcRy+B)pxtpNK+QD^qidea{969V2PS$?bDA1jun)-(Ce3`k%AAG*+Ye#0{<5o4GoCPm8&(At2pcV=96TK zm=;8-CBf4*tNiU=|F1a3QgQfihl!o;XO8R5@IPzw__!Q5;f(i2;^?$$-RvjtmvfxD z-$!!LDHXHXPZrjiEE#mVrDbKr55Qx3@1ehc{0sbU!mwYkuNYu|RjQRclfPY$64_Yf zu-g<-PrP0wFw)UM{heY{TB$QKN=#IRTf{l){MM{jTe zgV)Iqx?7m`;c{AEY`fa?=}{75v%RZmniaGfFOmSv*v_+;gi0n58W?Jh{9I5HGWZBZ zmxf!`YbM)H32QCTO(z~`b=Yv~JxC{f+!3;vFpu~e2woGY(;f5zGPwPFQl9@}e!kjz zvF?9+uLTJ2doqc-1a0ww2g{G#toDq!m|7&V&=VkAh2_R4LPn{iXr;5P&6Eu zJQ$vsH0%d+SZIJet9oV93^V3bY9zT^M^R;36#v+0X#T5HG1u7hbj%P1nQRE3l*Q8I z-+*yafg1slyTcOOi-}laSaj&`aP&2ltJlM!kmhRq#NklO=(0YE7Ot;?jX6NHrdat| zZUCu5%DP{r><@>&Hy0fpo!NYWzV{b9J5%sM3sHD#JuUI(V@#AA`uHEA^1#=qOzQ#< zepjDP)St)`bfzF!1)Tedp5>u{5Xw}oA=Pvaim3pPTRB{;4m4)E8u9icuvA$ZJMiV> zFl;sP6lVGKU;7}o7%XA&I^Kj=9^^FNb$OyYq8}q@Foy(Vv^*so+bPD!*}Ck6p#Mk- z+LJyLxF0zBr0huNv^Tq>gBj}D1yCaFD`fPuvKUytu)92uQx)WLIT^yz95$~a-p1Xx zN8}+SA%IFoIWW-X5aRby zPByG~N`v=B-rMm|6Si}!{TXy~UvHBw4p%bq?AF^+0VoMXT!-7Q?>@t6TDG|^M>AZ0 zLav8SeGW_Xd9I30SA7MQNt1xX={)o}Nxf$7mHiCQ^VMGeSI&#uOM@=>3XQ7P5vDT- z>EA1lY*zZd?xQ)5ouz8!c7y@#k6`G9cY_YcP|1o^(%`^#=YQ8Q%4-xjIEFe1vFUa@ zZ6u#!Slque4 zQcmY^6!5x7pX|>HF{x|ZpO-0c1bA<@e@hU2c)DLP5;7ff25@crO&+CCUTinz08H8K z93Lv7R`GhUn?;S5m8KOBcf;= z^Kfh7#?r4K0U{_Eh4)yiiJWXrshn{P6vVt7e`?bi4cAM(D4;PtlOw1jH`J&l>>0iWH%@dFugi|5E@t z{QH$uRY>i<%>qfwSo>E9`6;7Tlb?Di`Q2Bx7iU3jl+#A7BzrAhsz2XPPNoL%T)o%A zw?y6!{yW-A{HATj$fWaZr?JbVb@0v{wTLbFWc1-yLqk-nf4$F%{B4<=;i*Hb?U4U( z{fNGydOJyEpI=2k_+PfWy+3ikH-0U{VY6hGR2`0OkZ^Eh%;fQ4(pQ?S6ROwAeuZIe zt*rtmtIPmMc?P7x-a36-S);EnA|Mj+RF+CrxR=z7eAYylo?id@d_jpP-ezh#9O)|- zqqg%!%ZdVyP_0PF!q)=#GABi}?XlrNCe`hET3Oy=zji~! z)MJkI2F8g~=k>_z`^$=80{_kC?Q9*G#DO=cEFmYudB@1M<8VfU+OtjEku0Q$!BKql z1Ok0S!&(Ax@6Ts2#rdP6mRIoh2C0B;zr4}mYISSPjUjlLX~rJ%H4aPQW~_Mj@v6`C zIoc}Udwq+P^_bct?{&#;`M66N??kuB_0}bZ{*OpWD#fd;?P7JMKLZ^d_$ed*hgS_n z{sH%S-APS`kL!6r%5~#I+NG=ZBd)Na_mOoN5DV@W}I z-$?s*;L>TrvOBC#17E90D4jz=#P9X@c&->CmQdg&j%)j`4lM=LSymx$=+yhQZ-Y0v z@nU%sRX`Kq=a3Ut>Qp=u2!8|g?@&@B!c0tP)FUuW_}~(m z4X!|TU;OpeLVV1Ro22HVy~^ur0T%w(7oOJF&(6R8tp1v9*xKn29&eQvvw7Pa+U*Wj zUf}drb+JwRqVnYMeKPH-0?K#2frZ6}AT()nqp}V^ln{;wABmhq{e-nKFT_ z+-q&nA+CgxhUS?kKFmko%z!QKdT%s;=OuVAp0D=yp6h(O#qOoqX-YOaCPt`$z4F#w z%d@vO1AERLa;b67iXdowt7J|7;)Wq`Vg zw`Yfkhrx8Oa{6eJDbOi1;6ZLu_V)JH8RHR=)sh!1TDcgxVtwS)(p7V zIdiU2PGp}Id?`Ghz91qTiK0TyN8dOotEg@L3QdcEnlz1bf{i8R5b#@bk}`b!Ii&_O zoFL{QJuaT(b$g)WwPxm!;wzDTdF=V}MZsE@<%_Wp+xb(U6-Y5rrR(b#o`xS!!0@V# zpTam}B%q1kQOt>-XP_b&_TqLgZjRN@5Ta+lJifJ5@Ul8ECsnLEM zt`BQ$=XPH46?@=+M5@4o*+e?QT+n`sW6%HCaVYX4YA zcep%SsDhf3we!rhanMfoTj_0f+}k=y>y2B1v#8Qt%R~E3EJ~JIV{73V9ccdddX>F& zSeJo8lu&CW;A`7;BH?^JI4G^sC#iTI&wzUnL5L)KhXFZ3WQUy6!H5J&H*T z9ow_Alk(5IF;oRUWe#0(b?r9^1p&Nsix-gE?auu+NO;wHU6OUl$0aFBYc0N7q^@7A z3o$W5q&VlEsws&Qa97G##Eec!2ylMnZsHyIM$2b|iL+6;LJrtS+FX2-f~|A^+cOeg?&Ue%;8Ba+O1}RC4<(Gp9|`Qz1pyl4CHldcb_+!F9M}>G z6HOfz{VI}LUC^=fT6T&wAR02LnHf*F+tQ&;_*0y<18WE3OL8~m_4p_;=a_}3Nr7{8 z0B9&l$(Au|hgT=JFsa}9AsM%CEI$TEIfx#)lW@H-5!HOnWpTpZ*Ejck^}9r;)wF== z#d5Nyg)ju^kLKrt#>U3~;Ll210R4Rrl`3H-*Srd)K!d97Hx)$_kATo8@g^u;VoM>D z41&M=&RbFAYO0qrN25Oq#PBxNU4$9`VY^cU3KUvl`jVxW$e^o)BVy-;mc-*Kt84K& zp5%>cam5c4Vc?g7$D(&9iv?Nv6XBc2FYT58(UT>=%aZ8`@QcxuPFhZ>-Ib;xiJ=KJ zxZDn5IsgcPn@$Hz>Xt#4eyWR)gOGMUE--7UZJvV6?E#NkXERSF6_O6$mi(pabhJ4G zeN^JQ;ow6=O(NoP;kVx?wQvxu2o?5$rOVYiP16(^Ll&XJDs$Tua)HaS7*}-fFI7xk z9zA;{DT;VpjfNgY*LAJ=Si~2#)qbrS zc$&A>>3?U!O~=<|*yB^+_l6pTNte!`&)oO%8R~SYs?F=VC^vWW3qhUWSv6&X;QZ+N z!y}k(aQL`g_xcwo72(spD#K0)M0F^G)@6HQ!~o>u5YdSlBhn6u2{MYP4(^ zct#9fSy@>vRcU<`BMbfdg5>>r!D2T0-m~LcECpWS!3HHbN&G>3VVBlrPT(M+Q(dJssM$3w!ueWc{ zHWE(aGZ3QcNh{XLswL?>o_3X7LbA$?_dF#Bk= zySAP$#e3+f8hz?yBv<-(@wZZ!#T;u(?}iKL*%TA#OlejbbOM=T6T_{azfq_oesq4x z7D*2apbj87e6m9xA3JDH{5H+{wT}Szj{LbZ{5c;f$R4E>GjL73(5aF@tX&~VPqb9c$zUwzL|Epu9C?Un_Rg$rUMKFj0!KQY)0x-Ijq+Aa1c$(N6B&wmX4N8(?byNmqZyS+W#dWJ<9 z2l+Z#f37z9&dM=8Tm@Vi)tx&pZ5M%eoPgygi}bg)*Up{Cl~<>piwDCVA{rVRolg5< zqYs}QE+c=7W)wic+jWFNmxscOy{b*6!`Ag6vf$Y4?A1ow)%E>pT6#L8cKz>KN6$+p z8Wx#Yfv(59!1w3A_X{U219uG-mATo^*x7G4^As^3ZjW33U>&hrUZA0_{&u&Z)VA%{ z6rx|-99sVe*9y`9s>fPlxUg|qdWl{v`nxqyCJH4(8E<3Ac z$r2QspTJ`!0C;rh3uf^iXC7LQzE^qIeIGr4-)_mI623$Xo_Okssu!m(Fd&8#!Wg8n zmcTs#H~OgT5ytmEGua!3o3N3xp@w3KNS7=@JkY==3HJB495g^k>P%qjePB?x%=gOWd^R zrX>B2+_yw4#TSzS^!3Njl4o1VuihHNO`}FnN3^=!tVwSg{R~ZNL+LMhMHb*VV(SWb zU9^XbQY|nnmHV$Rh+^~|DXMkg-&7uJ_@3+`R3_hJphk0wMpXdiW~HGz>ETGBvdVM5 z!r{@>cEs!2+10P1KR!o(+$Mok{?-N^Hc3{nS?EiGZ%>2xc0L6rRQ9?$?|T((1+Z6L|2bOh*x(-gkx( zt9IWw?=t19Cs=_j7gd?0sx76JZFK1IG+=b7nMj%2c>C^;A9p_X(zL+jfzd=Sce!e4 zo_nz|EvT~DZR1XZGiih^DSZ)Dh!jGeFl9XC&er|?xmf7wcY>CFgX6_|sz;(u>+Bbs zBY~<)(pEoHVsh#t6jyz2e0aL*VHV>$)%-*Hx8fMNdp=49xoj5rdUIHHSh@6YKKlt% z^rzoC|`a*G2?WF2hV*3DG)we zQyM#Qk^!ZT9#GzPCH3VCjSJ5|X$ZK)Z|Yn%e!uB}q`_SafKRY^dxs zfCubx&~Vg))eUgW>sn`lJ;qBvMz-g-d~+Xt8TD@Fi;1c>oD~#(Xw*(C>L%YQPk)dz zUv4{&@3K(`SLYu2mr7vlaEVx=LAhd{WE@`4-`${ZW}}pp84Aci*+{QsWt)Blx*T{K z-!b)Av<*q7oQRanzgr)?SK}iaSJ2F-i!~b+D#h5a)}Y*2{aV3qr49{+FI95;!Ghhm zh(qd?)R2*$z2!po_`hZay(i)XqA9IH)@-vP0bu}<>I){@sI4iFo$A!8kTRwDg7jj0 zaY^E{<0h0to4oWAQIn?0YR%~xd2B<26Vm9s6UG8Cr!ORpts78gwA+sOUSG!N*-GX} zjoNX}eUgPFV={Xfqc2%DZcz~DViX|obRg{SXT4i5z%-}9O?MCm}#m9~>^d7(53L#*OPP!6B*3JrRZ-iBd?;!OKM z6b59wWCcZ{n&YOQ)qvK&eq<)^)h^Fnrs&u1a>mxmg0jtgrQp4WN2#A~rV)9uiG^L* z?K~iY3IgB%81wy`(t!Ree0zuu=J?ETb^n>s%NHF_^w|>4$0a0*Sa&CsdCC`g+)-PX zl4dqFiFNRpEPFt(b&$r0i0K~J?i|V>jEtBvVYsl&or8w!j+H{L=XpDLV5@L)sIgLB zCyUl$wLRcnlPS4l3GsDtrN?%2a&27Ztc!e7B!CK1X|*knaC{}Rl+@Rl z+-ueHe(#YeYC0C0LG~ht5B`5o@m=y(ru1v{{|ZRWYhPD)b1^B(^`fs_V6lN!}B$|`hvJm6d=rRb>y5O0w zs!x(8En#GMU~41}R5aRBg5&BBr6bJmSchv&oba zW-+`@o;)MceW7I83$5EIJvDAf8Dv3QO&?PgT{6G-kP?_pC2Hk?P`SvmE?B`LT>BAX zKwf4Z1TBpscHB|Acx;)htCD9QUq>@E`PJs|u!zw#6XLO~XnFg3UnK=;`3YuBQ)jcR zijHR9}C&Y0%zK@Jp@k&yTjOFvyk3V`A_m`we< z4gELk`7;SNgfWtm{vN`KFmy4`)^^p;oT%Z|Rx!p1ykDyPOg%CFaUnO`?56tC_sb8oT98h@gy z=IR2XsNBfI^&78o7$9wYH947qn2Od zx*3(aBBFP+mU01_0A#vgOh86(n0RfzE~cs5(9lEp&0rL`0$tRYLeQ6Ax-4s%Vc!0a zQU25SxzR*mol489Oj}i_plLdq+0!$=T6U$*!XSTc6Zj?$MeAi0i>H9=^E zHwPe#F&3B*|FlH#ZU*E?p>Re_>fOGW^CRS*J59%o% zt+`?=&=}B#aYCf9RcN|TmX`5S8_w>ZhwYs6Ddmtj85%Dptm0Um2)X)P_?>|9X11?0gYsH6wup(fQRd&8Jws%{L=vIMYu#s8UNos6=rl%1KF?mf+{ zUyg~ZfPMYf+xYjz2x8&G>$Q^EWhd=&(Ea&ZlZ)gG_g-wv*>d;IsW48$C|ab<&!_xW z&9sVceod7^TlVz#R^DNn)vn84-{*;?L8GWcBz`%DTOOKaAaSE!asAVNK>tI^2|>WpDHChrzDa zX#?BMu<^xU5}D8M4lJ|qSk|+ETvel{tukkI_=MA`su$ua5t94NF{JLq1xlRMjSHCh zQ5Mspz-vHZ$A@%|5K|aPwm=3sR#v}Mqcgyg;>bl#U80;WszZ`gs!T3Eg|DWg!BYm3 ziI<6&1%E2>HF$t7Vb9om)`)XBeDAb($iEWsmWybmG;lRavx>9|8)Nzf zwEQXh!|0z;^Zz}rzOR0QC%50Bj3DZ*9xo?!yv`e>%os~-F8BS?Rm?}yPXE7&r6|fykx0NewUwowT|Mag>ofqQ4CDXQjOEY97pv~QjCK$ zr(P1KwZ@QdZul#TZGh0QHujCZlHO!Dby~&dbSjs}6BWJ-`! z1kdt>YnbJv-|g3SdwZ(&K-HyF6;E3kuu!vqVVH#BJ42Dc{=lEYuTRcrH|Bu#woJhy^A8 zudn>~fLrzN6S~qlSmNG`)aB3!y)pZO!re2#TnwDis5d{^#ci_m?0xr9+w&01__|zU z^f`8o~&t;&*$xM*7&nq8nff=xq4!iOA)HrpTAK3 z96hi^r&(**>oR?lRuz#DJv#b}6xiBzH;*j%;`KgIa5R(iF&hYaT{TN+>0EC$*gzI~ zH~+Is!DjXGH2d-PIE1eB3z<2*muvTysTbP0KMb3ZPQRtvdC8YdDhmd;z2@xVKQV?j z<7;HsLnLo2>xD8a-y3wW1g|bJ-_djGHNkw_279UhkF2+ViYos0zK4>K7*arx6r{Vm zkp}4w>F)0C?nb)1Q&5oZPU-Gu;5q*9z0ZBu`<%tXaXB;RIP;6Wzu(W^2Ql~Glcvxd z_q!lxlf|+V?-W@njF=FAj^++RmV;JNag&x&wlpdhPT9bQ+B#>b;N9T>*c6S zMuW!)?CTHoUhbQ{(EarxpZGk-9}i1DkEC?5IF%ad&sKZSW;h==_Wb!)!mT;mA)lMO zH(~nwAJtf;)8cX3-gECMSCa|)S#-J*oBMEB|MMrD00Ta&n_ZX3?P$Hm(h`koRrgga zp=P%4>%as>m3o`Q+!0$eK3lo!67$Em44oaSq!`Qw`zxj`yp+-M@63`bNjnbZAQTgJ z7n)QkI{e7FB(k6gIZQ1>Lo=?^s0!;L{8K0NA&F0fx zg*W~hnVaUEz{?2nc}%Y)p}ok__#3bV%7^wbbtQ7?DD!h3a)X z2f!bdx?M<7Ke2;BfSCF+;rn(RFkiJ$sWCG8`B}QL{(jxlc7yU+Raq2BGL>3v)&Lry zxjXOHnqvbn#<@*S7VEqR!tOy?&Z>#mn$1y|-(jJ-wdXE3-XJ|@jfOX+ii4j#tx76t zxPXnCe!(^7mm!GWdgJxB&lY29LC-r~Phqmos04>jQ`>iq&GYUAYI}sCgj%Z9xZ)Z( z+tXa?Hz+Iho^>n5RC*4+=lgwjn-}9zN+RG2w~s1n2-#m&V+gAkyRAE#IF^B#*qKuG zuIp}NEoJ?{VOw_M719>n^TKR0I>=@@f8uo8bRNxFV-!j=Z@VZHfXWJxaZ~liBmOm=_22*eovTnyzdLV# zKKmxeWej+9fOBgCASwIf=`7dJ>9AHy_3jU~2B7veZ;rMvNil>x5TnhJU!IW?F}Uu# zL^YjNmJ279Cxf3(w<+XhK2d+JDhQrB08BgGF3%o-%}b(6%ml8t!j;G}XOB+vKO`UG z_A~#hTh(&YyUv^GyuQGWH6I>70Cuuot1oigKQ8wDK{FG}{d6F`+zjafzI8Dn?qlQr ztDwvOdYxwbE{|=G&d3ZvK>a%lv)$&-pZ_{b>{vyYXJqx!Bvdcteq-Zcl!fpvw1>m% zR|Iwq3jS<^L@c0VzyF!T=Q;YLN=xrzK8^%nvOI3$`QhN;0P9-7YiFo}+bK-!2Xaz! zvi0hNGyn=NH(B04Z7!tJYHBM~=tqhj>d8)0>0c37Em9}3J1qG0tS60f z4&_|Z!d|N9`9t;Rc6}=`dX74hbA`gLnA8012&(=ywhxv%mV3yU)1ndo(n4E&{{1vD zz4!Dm;s|qCTotedlWGzm)4c>UZD0$NlShrdi?>A%X(b5=i;EJLYPKm-Cmf-KUo-g$ zwc9kGOwVgPCFB(a>S2k)h}l_qZ#?*+!pPW@=FY~1%>&#e6|j-r|7wrRLHFMZ4w$(2 z96>mYUdIN&i+#hyjW#B-9_Q5bl9Nv0?e@~6RV%+Vnt0ySNw}V^-kx=wt4CT|Z345) z_S~ZbY&gB2h@U(6u(x94dHJ{>UTZXn3UY6219;BE>7tQ<$M>TFTar8epZGw$3pE?h zKQ<@}fGwj|rQ+JQeK$r;?@&H(ER((K=I?vtmtBVYMysV^2H!?nM@1$9??(K5E&i2xkZxv5=WDJj% z!Dv8$3qU-jdOh6;V#+Gw^`!R#7a%`Cx_#?={tQK0urEcP_qWIMd<*C2 zntLU=9!H6FMk~$M_W)92P6a&Z0el{hRo^#Y%44>WvD8K{iy9CN8Tkq%5<9v&^GdyQ zlra{o6ED9^U@8%!UwL5*n`o`#R5_{ar>He;Zs`}MUm00y4+>8Y4;wCEF0U7&8ys2U z+CBP~RZNa(083Wa*yz+35d8S~$Y!zAWa(L! zUIi>#_#FJ#ZTmSJEj0ty-;a{0K!r&ga=GgdmA`@gSP2hFq24w(#b9yLK-B?H@Q1kR z&i(={qxX{&Xq5NbmjxJgFMDH|sVU-)jz33X7m8JvjeH@PM+-H+(0;%QJy)d#-wRk7 z+RiG2kt>aO0zTSf8EoUc4NQLL-4In8XVZlh+9^>eGUUdwTDjVbnjRb2i<<_>vbMvY zEF#}5zUOBK{@fjfEFJH$CR0}K>mn$K^hwv{v3S+VMpHcyao_&hPrN&g4VVOE)Rz}8 z5Rkmgtne6#SEyEHw3rz*{mV-{fx%S&@yd8ii&bE6(P(x5 zXSC}&UO^KhMht-D5k|edyx5UrRFyLF4181C_hYsT;l7U?)Kr@qOQ8}+yXLDOE^irxMl1!w1-N)JrdMWCu87l+Mq-K*FH55#CX zo@K`BQEku$WF8Gwx^$X5*1zC~6yPlb#`eZCYd@wVG-{ZyB+_Hg+Yt!I+=eWTmD z2VyezO;)l%quH2+bFnbxZ@n>%GF5a_1T2&{&{jk@$zIBVi(a)k!$G4iiE&BB;VK-N zLg-7Z#vfw|p-jQ$HG~7v3V7b{+v_;fg2SufL*A##A>j_fL#T*i+fy2`t_Cits=OEl zal+Fw)3YZsRw@h)a;*J~p8=PUjiQR$gaZ}Nfh&<6qD`4drg-V6hkEhs2NZu3`m$4P ziQQ* zAj=M$*$S;T0W|{U-%8F@)SOQiF9G(Z=G_Ib65RSc^qDF9PBCJk-nw1nk7aUrU%Z-y z$~jyd*UXiD+b@sFuAUyoppeh;c-#0CCPs60ece>dxvbS-B0G_@+R=jW?@HkU9}V<@ zB}G%3dUym1;i`#B`Ff8o$Lp%BAtNitnRkVPgVz!6?7{F(@V*0WJb&qb%w zKXS!1c#v}Ka2!-gzs4sqKus0|w zkNQy%chX4yZPNeNbSu~Sv`N1frHM}4!UQ~z=`uvSRlG8g5OT7{*s0Ea~yWD8v<7IQZn=U-NRGh zFDMLz;9&e+avI#^G?+ONdedo(+p-K8AFkeW7_Pw_8;lG#eC;f)^Q_e;Q<%jb^Ql+a z$h#`YClJ+EmXRF8Qu~fRw?*%f9Vvm*|2vwnaQ+?8iybX)z|z!D+gKmIa^AW zI6*dLHaa5-41-2AxW~uZxI*fNyO3J|#C614`c^1GIW$qzR`Z=mokOV+_|{$_QR}Oix2%`IbB0 zt|6LPo;D*XRW{wb^CR>pqXlD+|UYv2alQj9Ko(sclZfBd;tq{PK_J$;XG7g}__F#9jwZG)p@L~Z#Tm$o8 zXKU@d)65-eO&0EHk|?RFIE(GKEiVC@)0ZW4hEV`8|L4{AsC zY-3WK#|od{FJOe!Fb(Num~ymLE*#QY+GB-DXf+ew5vM{ukFtA=6lmW;yL(B&tEkaD zQ*BbI&%f&-77hBOs}WbM+C21|&Q!P~2C+&L>G@mNe(Gs1k$m!!_2VM}ue`H5pRjU)IYY^(KcR zD(B?(fw4bQRkYe=h|(*~meL@^_MHUje;9LWSmBQMXT>;lo2BtGNc-gi5R{qamdIza zdoMQv(|vZRqR#bP7aHId)oL`&J>c{wk8MXEeC~2zUp@#@N(@U$L%j%intmb@i@&?v zKg{_`;p*o{OsfV>E=Z3+6Nb=1T0tCuz#gm6UtrDZ6>&&?0v%R7X> z{sg38=q(v&>MtB$iCO;0xOVy8FwHH@Evma_c_dd0oGtLnu?`q1ez$-N=H#avc zp@98l_G^RfDZtof3{vjw?|#(-W_wUv7o=zL5;9yh!mQsWNP4-~z z1v!4ip||rax?gXG)&Z~Ytq%4tN07o1b{GHOiGX~f(&>BytYXK~1o!Q$NiK5<9Pvi% zq!o*k{$B<%2x=TrHK%{IQ9qmDVYSN0Y%<4!_eACXPA2H|D}mYESsT|CHsV3tagKRk z$F7FP9q3XI;FTBBM@tYbX?@a*`w{taD*WJ#Dz-nGs*PgJ5J`KP6|x+?J8XU3kPvM; zFsUTNe(m0s1=)$ODY)!LDR_u=QD5@h#@C!RY7#b+{pim#juF!7@_MWv+ghwKFQ>-C zPjYk;|MmN~DotXv)PZKn8U!@y)VqpFBtV!~d?Y@psJ!7}WN2vEUM-sV_qRD;O+KZJ zOmga_tK=OFB({Pw2N&amn(64lRKXX`IrGe{m$QyYfO1t*N)S`j?)D0P!w--Y%)1W< zdZN}W@Br1l_S=KQxOesG8)RBC6I0V7XDvr17 zqo@U-h!@bLJY%+P&Zqjf>|QrE{gslJ8rCyz@3JJ|QLEL?LrP0aW3p|!fr8~wnv_6{ z4Y$orC{RLH7PIMk!21vMt9Bxg53hW}!zJ-kTQxx8p_H`rN|U9jy82?a>m6y3)t})6 zS~Q=N%Vp;ynKVXKuqav2(7|NBX-&uU^tA74(+D1hhi5F0e_Z8QCRFeK^>_}S>xK?2Rxa@0=k?txsI9HtN&2pcC7@mRb241lpt^R8Y$uH*W*e-3 zu{k)ND?s_+RWp|5zIU?pm*$sZydp!)C&&mx&nl3z0`dX=`l8)S5TY$)UqI<6%Gyc! z62>SZ3ifup52PKBMelhbY%7!9W_V~wa$zq)x6y8jvO-lhgV%kj-k5hn0FXD11%Yo@F#y zQUZd>bdmJ&?_aX+kI67x@Xg+DT_z6YnnHbqN_|z>QN1c|1xzMd;P5~&?2VD6cLvfA zwo|t2EZjVeuQzbMUQGrZ0(0H$ws0iVfnS7W-${ja&K}2VHwTPZ!1v{Mj$=cxwMZ$* zI4Vp+s-Zwo!kl)O+G#NEs70BSUlN6b$t{PN!C)+hKRuD3))&!_~HBrOSM#IGx2Lhu>S1P3!L+S9a%sj2QQO+MoNm-l|8J zyi88&6S`fzIn%i==Q%w4*v47HyFTC5F}S_d={|GJVw%P0sTys& zn%iajyJF@OA?Lw-^;)O#I&c|cVpc|jQQVGuKo)N6>$I7tB!5_EBtaRa)oApL22!YS zIURgGzdZ5w>{(AR=0*cD9^lC`_h)>-+mx0*9Bq+FZ0NLJgj%nVm)7od{Q_!j@pvEV zI?mchPF-x*8xNZnOkRtl)H2e!&O869VnET*o6FP9$C@7dmxsE%`yp(cyMZ{8S4U_i z!@tb7OO`CADapxvK-gq77~Rq4xZfX&Dgc@N21s2WIeffgS3GGoTfyTwD(>(~Q$-d7 z)Kh(obkUlS!*Y|c3_fnV$v6^`9?0EFs$R}jU;VCJNfz3Lpxn4oAUxmO`G@&xEj3Nm zyP2~!n0LquTlL>>XXN<-s!zkkr8%kaS1~HVkh@i!Ra<4F)xCVj`MH3g@ot4$mBoDJ zQm=nt2r}W*TFXW^ukmpGu1^iWdUq#~-<6liW^zbZ-?cs4nA@e&>*X-JUwxAoSOfYP zjHEIEd}@W)<7QuAe+Vieli>haEUyEg{QwN7OeXi-G3Jh$o&^OB`WRIOLHtjsYg%|S zTw)kRoe4@Xylq}V@mQ2O6Ro2mc&wb18dNOVqVm%iiN0bkjy|qFm@LVi&77&x35`uW zKxo!M4^f>5WH{gF-X14m$Hh3>$Hf)59V_;^9&fJJPC%o0Owx`kNn#9z`ChQ0OE0f4 z?+uhq5I@bN=Q*Gq--ye$*JN+F+p?OS8yoL~;H*u*k&+gDEh{?!an7roM5Se~GQyvt zolBxWjAO+WPOG9lkW$XxXkx9+m01uiD_r^zAU;jdRSpjzV6VtAABu`!{!W+(}jm7|6 zigVEx$3gmbueB#zyGglNzG zh?YY4xUylR)pB?J;f-%PtmVWDYgtbsUt#D+HH#sVvJ4?g2wHr9J#*jbW&Uz@lW%#E zY-U3S8{qGR#pn9kq=ydFOGGM2@Z3ntiTU+j$B+%iL=&<+0etb*O4%ebu8RA*CQNy2 zqUcxh0=jBkGkUc|B$zI+?wAK@4;Cw=JSqW1%t=U463Nd_&qao(;%I1QWnmgzeC4uP z->n9#yw&L2z=hhkjXeTe(0zkU6i|CxY~Ve0)rfWW=*%3$x-{ihlpzM!d~J^IEqAEZYWn!3QiTBi zyaFb7?fgpZwI~bfRrKx%C}$S?t=~J`Zq%;Oq~9o$o3U*0^g}v29mO^cqqVqkn`jZW zp^3;>vs!X40`76S45t_6hcvt8{L5q|LS@;8 z^ntlo(jUs%lzn_?(XxN=pw+#_%zTE7ZKHO@oT)hU@S9toUB8G1(kj ztp>x^Jp~0x6Y80Tf=B8rpwJzI!zDleslVx((!;msow)9_%8%d-9gnIqTe2j1b~M)b zR^W-mCv0J#VmS*WG1ZI1Bq1;rNYj>bV1#pp`HVUgCZ#c{-d%kzrqami5$Tu^R8VRY z5^5@)C~b^2TWzKOC5E^k@Kv}WJCdRaCI$VO?PAe4;S)%4WC-GllOPxUIBb1JfIx-L_bHf;kP96a)F=1Su!$$>L z>ELgHlsEp#YFBf^vT+`0@zhr}@MQ1A!D6Hsg^qp?nHhGnyZul%SqF}WlMNz{-y3R; z*SrgQDGLmB%M{axjE~*vHlkL_te>zX@JlgCM*D)fCjXF;h++xNE>O0^{rEIhLJA7q zbRdQIXg%4VVzqw<0>v+`eN`5KKFrz%AudV|YB$;8m1EJv`{1d{_`_7tjHgB`{+^pE zG}L8+q?0G%IL0V|zHlXDVmcc6WqcksJr0`wOYPdvPp?ea%&)y}C~9`AeBOnT~N2apkfKP^Vvk>#*R3*;Kj8%FM3 z34dkKcRgjc^|w73^OpShl|2HGNm?Cndnj~OBGW#ndIcP8a=o>QvdFqMuv;ymrH;Mi z^{4cGkE0-I++--&tfvLmpbE(yhv@iSkb1g^-6if`FW7vAA0#yUS(f-npn=%-?d9un z#D4E?+@7S*#5C`FMiB@|P;|Ik{J79tTq$S`71_WtN@sp_ zGT=_>&*ie!*(={Yuq7d)=L_4lQJlZW1Y$NK#poH2jNh~kf+ocR1=Mejxsc@x%0vQE zcw$N9ktn1CVlZh0X`4q=6bmU@^3*%jq#2z#G0c@HLlyjtd6l$}9=!ZLZ&<=9VX;q_ zcURNkq_}KIYtdqvY*Gp8Z(&%3?K;&jdJIvq&X*)gqs&l>g~ua-$vwyq zGaEedxm#TBPF$Ri8A_B7k%WD6pY*T$rhlVP`m4&no-k~eSD8qZ_o%$D{G6C13-NUM zwVnETDg48{v3zsGhupDhXPl_dGQQAdepgcK_rGMh|0SH7RS%2vG>L-GilYkoL%T@(j0SEQzzXjx zgkfltHJ@lQW5OQ&xt zKSEk`%5E06F+qpOi&&b1PW~hD(PYO;uJrEox%p4gq@g1EW%|npeKGrYcz)_ zFQ7-VzrSg$)PTE8X@}-cNiTTG*d^@M4JKd~&weMGOKn!1LSrmtO@k1$9oH;5R;Bcb zbF2P$yXMRej>fjMyNEzCZN=M2{D{8)AzR+cYyU*hTqE!_ zc~p46kQ_8;t5Y*Fv+w%K!KmF`d!Kl86ZvnqeNxfXqyzzOUB}_vK{3ZdC6A2ETqzJw zX&C8M0*K}gAZ&uUzpR4}e-j#c}-F$)v^9Xd%lJGN> zGemF)RF5)G-Jj}QI`P6kqV@K5RenN{t=UOof*+kFT9$(_DG>%$(fjk`S8}CT5i=fG zQ179j4!#Mr1v8w^Pvgmn(sm0-*Hm#S*|r~c;AckLAL$+=_+jPW;dm8sPTfu zUm{g)%@9z77(exAWhKIZuw0B z6LROqb{hI!AzB9_%>(*J$dq%@bGAZvW+*r6$_iVYCGxD3WAmRt#cfnn5dT2H{Khuy zO(K6W^ikxkdv|PueT;S#GOXpctmW1Y1jj97HDz`hU+CID`B9wO>FZFUt}Nu*nkiv9 zwvnc$r~UWw3g2Y->k3HF4>4|I-KeBX4mWN}4TvNW+8lmWg!q#ff^ooK=vgmzK~*x` zBp^R^RSH(~W!|2=&EgnB#D{MNrMD;dl$0Wjfg?dzKas?UL8kbPUmGdHnxmOL zfgjs_EOa@XPtw#BCVBaD=#{f)x!3{l1c;sHG!S|X0>AQLDtXm=T_a28`h5xb5)dRB z7({1DCLV~?G#7S*?(e`XgiSxwY$kk?c)dJHL2hBTIyN!T38zgVNCX!!0$cck0(+2V z7pr#jE@(ubA6uwI;#;iGnmSt|V*Xvdaxa-EC)4<^HSoAZr~@jhC^YF5au&eaM2X)V zq$t#UJ52MF^bKR0mq&NIIz7^5QEDN%|L%7GW5)CS zs^uv(up9j6_yz`ANWJWhUzt)wL`2ACaXzm9{bf1trE7%hm7I=;jaNjY9N6XsOQ5Pa zdPBK|KGGR5xc%Od>pT6ANKQIa5VijmEQ40BF(OU`X%h9yQ@V2F7~PlG;>)l}?8Xvt zDOyDp$J8o#;UvLd5hN)Qzt)VsA-5O%ugQs+-#hZ~FA9%%gcNWZUBrvvsY4*0FZaqi z7k9r6+k>p-1ERhtS{H?z-eG#c68i;#70C%g{g7bhXf;^jGhfXagGVwnO|q0wmG9J4 zw1wg5D|UJVU^#NwzPo8u@`8?)z8~%zLD!x zo^yxPx~jQz$YtN!Soo)tk(N>)Bc()u(@h43aNXYy8davQ-}ql8!{+jC>6<2%tsa&woG~v@iG);7rCtl+yBJ zaZyt?lf5bmZbV_h?{jjBbt3gSW!`mC7)Tkp+Cn8X8%D<2xR#j-#85$rlP5|^!-(e% zji}hbIAfQtP?ma_BdC`MhSa{qY3&zHW5hp5mqMObb*I#*OFI(erR3J5x`DK|k1DF-Gu9omGh)mZat|+bUbkM|^?Vi1(}y`LCVkg!2q`d!XQ$N6vJSIeGKXrM}sXLns8Azh)qfj^1X$ZGQ}6Z{>=gG6Y1d)?3Lp0`Ky$w(@L?M{bROQyMm z+`!A%yI4%eqrzi~S1^RzT~0IF?6>28NB~zK$qI=6^`?a-MY|uc3dt!eWJ6IuwtEkb z2eyUojp@auq~xe6#3dvk34NYX5pkl1A|1Yu5uvl0Z!WGm$YY)Qv>1=2X`S%i|DmdE zBc3}B$(xjLt{hoZtALBuepjb%uQvC(;eAa|AJ&W4dh);x?8BNzH}9j3-!}~$dRI@fw$aE zT3SV7wHB2g24okKD}7WJ80JF7u|gDk=mAFWEJ~G2(Y53_IY!&B^@gB_{%$_}=Q@;Y z)$#yQp|SDimvoBP>rw{O4~e;mDmLqKr^2H(dKzWep(O&GM+wKF^xQ+oB*Qp;5OPc0uoQhYgjKCf+- z!0>E$&g5~G8-L9LK16{1NwF#{Dq+yA|2}4#8;!?C&Cc$!d~3TjB@VJR1ke+MK=JtN#aopoCkGhAvb^AVCY_)8-?*ol` z0MLsQq}}brwK!>fdopJ^Fcc3s9RDDg+1Xk22?2RMS$Szs+dm0xx!&v^H)enKf#wlF zQ9aqwfT*}QDiQz7F4Z^QPe3_#7pw2qPa7TETQ}M_&Tk^79j-mzvj75cq71>XOnd6!5UA6bFcSVkdt`Go)0YPzW-`|Mw_%7}~M}3CcL#1fucHma9|%i0O)zdWqaW z_Zg7uaX{<7Z;)T-bT*TDeKkF=_&4Rm2of;_P=3-l2XQtXHvmHFZEN544#nr~R!#I^ zX8)`|6bMjm7)?_wAO`s( zZV&p_TDdzoL?n5)YJXoMYOsQl01E?tnQk^eIup2Nej z`TCse{&ZNwZZ$bE7e@kc(fBMLjl>8Dj0P_cXekWxa$o-}^$>xU8?8rp2xw9m0CO7j z@83eA@xLCjg*8_>IWIZ9xiM&SzKu-ufO;7O-W+a*;y3&AX76)6QFnHLJ`!jkAh3&1 zN@8_dWV}7X6ba4YcD88j-q?X~aVZ72wzlTW^VTu&d<0R*X51W>t7P+RBqS#r^Lx%( zw*gQ*;7tHa4)B>HT_q+YXf|4*4=D;r%&%+FvBG^OS6x;|b8f-AsS5vP?=IFMmPC%r zjV|jvr$dTx5O)_(W}3wrr88-C0O^~n~^8VDWC@K^p z7&?F*dA0H5BUd0?Rmyp^!Ior&c-MggX{Z@Z5wy0Nypc65r z#}I9d4D`75zGkE?sP*3SIuHG%RHfn46l8q+uT1BL1csPU{vLeQ$s z1b{t3QtIpGr1Pt3Y zqtFA)!WbXGjy=9@w%mwWln&l<;{H)k@bBjb@cTy*l$3S?*p4$RUU4d33C@}uL9kUx zTU#NHAsYgWYuy?S5`Nt-pWESNU{?j;d^OR&)pC|Hb8{ZolQ=;-sKw8ZtJT>~x10Vj zX9)>t0#66=5}yE%`m4SD<(5e3?CRLR=O#7ZxCNpplg*f$PZj*?(|%hXTCZ99#3;K` zbK>}XX93r;Lf2;uTI}%^0FjfEr`=Yg*2Sn5;-zB((Oj7_c;OHqS&X6}W+AavMx1v`!7_xbPW(G?3&{Ya~e8MTakEaZ?2!uNJTy!=x% z;0A5d-OPmECd3Cl?I#Cl*xqn3=FeZjm(KmIVc;E*U{XW2B=*ZVW}pUf#)S!s?`+J0 z0~L-o>?Zi9aGZ#9rkJcqV&8%Ac9T-B8hSSTY(6gXuM`ecjUC0ExZxebtQ%5&cg)X5 z!GE)9sJ8W^_!UZEK?HPK^X*F7E^W2QFYfLCH$VMPnp(|3$nE4d8_BTlwjJ%bKjyt1 z&A|_GN`^Gsv}mab+d2_FSp1@W4>B+?uyGC7^x1lG*I`p6SF27D6APO3oS913t->NC z)KON)1(heK43}Ye@e`e5g9d*6iuQU92DY&3Z`@KTG69^zi^Q#@kRGMlV z9UTG-QPF{}`}KtqTfHW-k{Jz3divUq^7!YoF4yH7wIU-Sux8UF@s#J;jIONY1q>fF zK&>2Af`tL{M#q4@-Cb8V#~fpEC@jqLyrZUOe!tz`e)?1}le$d9*Qr=cU7OJ0L@9}g|jRii+tu&FTp*;$DaRCK|TNoj`E)?$8f zj%(V-?Fl^0&dPNYj++j|AbgUpT~PE)1tuvvjF@odI{j=_g#I*IiUbiU1NbOEsO>#= zxMTCyS7$rZA7lDm#31f0RQhTc^{Qn#zk=SmnQ3m7Ri5HEcc9Fr3%Y8t{9iBzgkyMh zxwC*qJ(nNR)uMg~wDbWgMou{1Z@V zXwkq1z%@L>-=u!T;6qWZf%X=`j>E>oE1TbOU&qGTqqm$a`?UzhR!=tQdr0f8D$}&)w*k`UIRD}7!WX4wCd~k4wjeY>Sd%|G5J2B5dviz zAEkQE)o-OILI5VEO&b{H;f>gb-A*;ZO7iAk#0rcIlP8^%(=tM-EBb4L8(t#SmoMM5 zjb!-Qr>m)!rp?)&zsr~t1aS_-E0Xid-;68TrGo$lHtoA;9=st+YSGXxGmLg~ECP&t z8g^^yFgi(6{}7ly2>w$%7<@>Gf#Uz$ginb@pH5VIo&gR$^aA&<0)HF0w4=Ak1Uvi< zXT@4++~>x22=MkM{5#P&g_EKvDN@RL-?dSYWd!!w!-7J;M34&i-lJ)#JZC~-CKA@E z4E|?haN>)E6q*3I4@Jh~Q4|kQIeGF>_vZ5oS5{bBnzmQ<6{t`lTVUmOzxp1TLgx)j zo-(~VPY-%>s!&vnhrlC$q2_(QO&JSPk3-A`-H`Lu<{)kd$|YH7A?=I-?-G3gff-+eqViE;s` z3m(H>&~gZN6MkzWBG6|^RUA6{v#taou#=NhB1N=(&I=w8o!CT&NyH2z=0!$E7#STb2xC}30wqBf7l6ZAs3s2j5K0d(&dK#jh&%}NAX<>_NwolHfv8r0Lj%lCYa$%gNm~?)J5f2{MW1 z%I;qpsYfR5K3a1rh6kDcX94)1U+u5XhgZ8Cy1rd{JwDkyBg!^!uaLSrrY_HoT|3U@ zCg~oaNl`_44G=vI4F2aB5Dg6qk{kqj?>Ek{v#_vyW^>-`^+&;HKU(O~6NgVnm@%-b ztE&T`D!Yj;7zJtxY=5e0=yzqO9q&J|TF+bkEu;d#%CFM$xpzmSK=qU9`HJOH2x?o_ z)9!-H>57E7#IN7;pLotbw+w!((d`NgL(riiXLNkJ`8krR>j^=jYIz5x-e{&+Q8*Bu zNIBSIHbu>Jxm)≈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±Q<^SK#2mb_fH0jj=q8XB6;xKQ&`(87EG3(%i{es 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

q=huQzI7_q{1}&S=-s_`e0_iT%8ocWZ8QG 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 literal 0 HcmV?d00001 -- 2.47.3 From e05926ad74f2419182999c70e45de7fb84f2ef5f Mon Sep 17 00:00:00 2001 From: Caleb Burke Date: Fri, 25 Sep 2026 23:12:04 -0700 Subject: [PATCH 07/18] simplified build --- .gitea/pull_request_template.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/.gitea/pull_request_template.md b/.gitea/pull_request_template.md index 900c085..10b79e2 100644 --- a/.gitea/pull_request_template.md +++ b/.gitea/pull_request_template.md @@ -14,5 +14,4 @@ TODO ## Testing Instructions -1. Build engine via `bin/dev build && cd build/ && make -j4` -2. Run testbed via `./testbed` +1. Build engine and run editor via `bin/dev editor` -- 2.47.3 From b24945ec9da25c34359c435775547a5e628592c6 Mon Sep 17 00:00:00 2001 From: Caleb Burke Date: Sat, 26 Sep 2026 01:49:45 -0700 Subject: [PATCH 08/18] Bunch of changes + fixes --- engine/include/sophia/scene.hpp | 9 ++++----- engine/include/sophia/scene_view.hpp | 5 +++-- engine/src/rendering/imgui_renderer.cpp | 12 +++++++----- engine/src/rendering/imgui_renderer.hpp | 2 +- engine/src/resources/render_target.cpp | 1 + engine/src/resources/render_target.hpp | 2 ++ engine/src/scene/scene.cpp | 18 ++++++++++++++++++ examples/boids_2d/main.cpp | 6 +++--- examples/image_viewer/main.cpp | 4 +--- 9 files changed, 40 insertions(+), 19 deletions(-) diff --git a/engine/include/sophia/scene.hpp b/engine/include/sophia/scene.hpp index 2e4af2c..5571a53 100644 --- a/engine/include/sophia/scene.hpp +++ b/engine/include/sophia/scene.hpp @@ -13,18 +13,17 @@ class Scene { Scene(); ~Scene(); - // Every entity gets a TagComponent (named `name`) and a TransformComponent. Entity createEntity(const std::string& name = {}); void destroyEntity(Entity entity); + Entity createCamera(const std::string& name = "Camera"); + /** Calls `fn(Entity)` for every live entity. Defined in entity.hpp. */ template void forEachEntity(Fn&& fn); - // The camera a render request uses when it doesn't name one. Null until - // set. - entt::entity getActiveCamera() const { return activeCamera; } - void setActiveCamera(entt::entity camera) { activeCamera = camera; } + Entity getActiveCamera(); + void setActiveCamera(Entity camera); private: friend class Entity; diff --git a/engine/include/sophia/scene_view.hpp b/engine/include/sophia/scene_view.hpp index 7d83da9..af5860c 100644 --- a/engine/include/sophia/scene_view.hpp +++ b/engine/include/sophia/scene_view.hpp @@ -17,8 +17,9 @@ enum class ClearFlags : u8 { struct SceneView { SceneHandle scene = INVALID_HANDLE; - RenderTargetHandle target = INVALID_HANDLE; - Entity camera; + RenderTargetHandle target = + INVALID_HANDLE; // null implies render to swapchain + Entity camera; // null implies use scene's active camera vec4 viewport{0.0f, 0.0f, 1.0f, 1.0f}; diff --git a/engine/src/rendering/imgui_renderer.cpp b/engine/src/rendering/imgui_renderer.cpp index d458938..e59aa4a 100644 --- a/engine/src/rendering/imgui_renderer.cpp +++ b/engine/src/rendering/imgui_renderer.cpp @@ -91,12 +91,13 @@ void ImGuiRenderer::beginFrame() { } ImTextureID ImGuiRenderer::getTextureId(RenderTargetHandle handle) { - vk::ImageView view = - resources.renderTargetPool.get(handle).getImage().getView(); + const RenderTarget& target = resources.renderTargetPool.get(handle); + vk::ImageView view = target.getImage().getView(); auto it = textures.find(handle.index); if (it != textures.end()) { - if (it->second.generation == handle.generation && it->second.view == view) { + if (it->second.generation == handle.generation && + it->second.version == target.getVersion()) { return (ImTextureID)it->second.descriptorSet; } ImGui_ImplVulkan_RemoveTexture(it->second.descriptorSet); @@ -107,7 +108,8 @@ ImTextureID ImGuiRenderer::getTextureId(RenderTargetHandle handle) { // left in once the scene pass has finished. VkDescriptorSet descriptorSet = ImGui_ImplVulkan_AddTexture( static_cast(view), VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL); - textures[handle.index] = {handle.generation, view, descriptorSet}; + textures[handle.index] = {handle.generation, target.getVersion(), + descriptorSet}; return (ImTextureID)descriptorSet; } @@ -120,7 +122,7 @@ void ImGuiRenderer::releaseStaleTextures() { bool stale = !renderTargetPool.isAlive(handle) || - renderTargetPool.get(handle).getImage().getView() != it->second.view; + renderTargetPool.get(handle).getVersion() != it->second.version; if (stale) { ImGui_ImplVulkan_RemoveTexture(it->second.descriptorSet); it = textures.erase(it); diff --git a/engine/src/rendering/imgui_renderer.hpp b/engine/src/rendering/imgui_renderer.hpp index 5ee558a..31c2304 100644 --- a/engine/src/rendering/imgui_renderer.hpp +++ b/engine/src/rendering/imgui_renderer.hpp @@ -37,7 +37,7 @@ class ImGuiRenderer { struct Texture { u32 generation; - vk::ImageView view; + u32 version; VkDescriptorSet descriptorSet; }; diff --git a/engine/src/resources/render_target.cpp b/engine/src/resources/render_target.cpp index b4e81e1..23cccb7 100644 --- a/engine/src/resources/render_target.cpp +++ b/engine/src/resources/render_target.cpp @@ -39,6 +39,7 @@ void RenderTarget::applyPendingResize() { } void RenderTarget::create(u32 width, u32 height) { + this->version++; this->image = Image::Builder(this->device) .setExtent(width, height) .setFormat(this->format) diff --git a/engine/src/resources/render_target.hpp b/engine/src/resources/render_target.hpp index fd4f4f8..c545c52 100644 --- a/engine/src/resources/render_target.hpp +++ b/engine/src/resources/render_target.hpp @@ -27,6 +27,7 @@ class RenderTarget { Image& getImage() const { return *this->image; } vk::Extent2D getExtent() const; + u32 getVersion() const { return this->version; } void requestResize(u32 width, u32 height); @@ -46,6 +47,7 @@ class RenderTarget { std::unique_ptr image; std::optional pendingExtent; + u32 version = 0; }; } // namespace sophia diff --git a/engine/src/scene/scene.cpp b/engine/src/scene/scene.cpp index 1dfb9db..efef623 100644 --- a/engine/src/scene/scene.cpp +++ b/engine/src/scene/scene.cpp @@ -16,6 +16,24 @@ Entity Scene::createEntity(const std::string& name) { return entity; } +Entity Scene::createCamera(const std::string& name) { + Entity camera = createEntity(name); + camera.addComponent(); + if (this->activeCamera == entt::null) { + this->activeCamera = camera; + } + return camera; +} + +Entity Scene::getActiveCamera() { + if (this->activeCamera == entt::null) { + return {}; + } + return {this->activeCamera, this}; +} + +void Scene::setActiveCamera(Entity camera) { this->activeCamera = camera; } + void Scene::destroyEntity(Entity entity) { if (this->activeCamera == entity) { this->activeCamera = entt::null; diff --git a/examples/boids_2d/main.cpp b/examples/boids_2d/main.cpp index a3d9536..9d34a50 100644 --- a/examples/boids_2d/main.cpp +++ b/examples/boids_2d/main.cpp @@ -87,6 +87,8 @@ class Boids2D : public sophia::Application { [this](sophia::KeyReleasedEvent& e) { setScrollKeyHeld(e.getKeyCode(), false); }); + + debugUI().show(); } void onCreate() override { @@ -110,8 +112,7 @@ class Boids2D : public sophia::Application { sceneHandle = scenes().create(); sophia::Scene& scene = scenes().get(sceneHandle); - cameraEntity = scene.createEntity("Camera"); - cameraEntity.addComponent(); + cameraEntity = scene.createCamera(); std::uniform_real_distribution tint{0.0f, 1.0f}; for (Boid& boid : boids) { @@ -127,7 +128,6 @@ class Boids2D : public sophia::Application { target = resources().create(); views().create({.scene = sceneHandle, .target = target, - .camera = cameraEntity, .clearColor = {0.01f, 0.01f, 0.02f, 1.0f}}); panels().emplace(ui(), target); diff --git a/examples/image_viewer/main.cpp b/examples/image_viewer/main.cpp index 2eae2df..7559565 100644 --- a/examples/image_viewer/main.cpp +++ b/examples/image_viewer/main.cpp @@ -40,8 +40,7 @@ class ImageViewer : public sophia::Application { sophia::SceneHandle sceneHandle = scenes().create(); sophia::Scene& scene = scenes().get(sceneHandle); - camera = scene.createEntity("Camera"); - camera.addComponent(); + camera = scene.createCamera(); sophia::TextureHandle texture = resources().load(path); imageSize = resources().getExtent(texture); @@ -54,7 +53,6 @@ class ImageViewer : public sophia::Application { target = resources().create(); views().create({.scene = sceneHandle, .target = target, - .camera = camera, .clearColor = {0.1f, 0.1f, 0.15f, 1.f}}); panels().emplace(ui(), target); -- 2.47.3 From 8a82df59ca3ce1a34eb76da04a93f00f35d79956 Mon Sep 17 00:00:00 2001 From: Caleb Burke Date: Sat, 26 Sep 2026 01:50:09 -0700 Subject: [PATCH 09/18] cool viewport --- editor/main.cpp | 15 +-- editor/panels/viewport_panel.cpp | 194 ++++++++++++++++++++++++++++--- editor/panels/viewport_panel.hpp | 41 ++++++- 3 files changed, 219 insertions(+), 31 deletions(-) diff --git a/editor/main.cpp b/editor/main.cpp index 81fb414..b95d944 100644 --- a/editor/main.cpp +++ b/editor/main.cpp @@ -21,16 +21,15 @@ class Editor : public sophia::Application { sophia::SceneHandle sceneHandle = scenes().create(); sophia::Scene& scene = scenes().get(sceneHandle); - sophia::Entity camera = createDemoScene(scene); + createDemoScene(scene); panels().emplace(scene, selected); panels().emplace(selected, textures); panels().emplace(); sophia::RenderTargetHandle sceneTarget = resources().create(); - views().create( - {.scene = sceneHandle, .target = sceneTarget, .camera = camera}); - panels().emplace(ui(), sceneTarget); + views().create({.scene = sceneHandle, .target = sceneTarget}); + panels().emplace(ui(), sceneTarget, scene, selected); panels().setDefaultLayout( {.left = {"Scene Hierarchy"}, @@ -42,10 +41,8 @@ class Editor : public sophia::Application { void onUpdate(const sophia::FrameInfo& frameInfo) override {} private: - sophia::Entity createDemoScene(sophia::Scene& scene) { - sophia::Entity camera = scene.createEntity("Main Camera"); - camera.addComponent(); - scene.setActiveCamera(camera); + void createDemoScene(sophia::Scene& scene) { + scene.createCamera("Main Camera"); sophia::Entity checker = scene.createEntity("Checker"); checker.getComponent().position = {-1.5f, 0.f, @@ -66,8 +63,6 @@ class Editor : public sophia::Application { sophia::SpriteComponent{.color = {0.25f, 0.45f, 0.95f, 0.6f}, .size = {2.f, 2.f}, .sortOrder = 1}); - - return camera; } sophia::TextureHandle createCheckerTexture() { diff --git a/editor/panels/viewport_panel.cpp b/editor/panels/viewport_panel.cpp index 74ec7b8..f8b793d 100644 --- a/editor/panels/viewport_panel.cpp +++ b/editor/panels/viewport_panel.cpp @@ -2,7 +2,86 @@ #include +#include +#include +#include +#include + +namespace { + +// Corners of the unit quad a SpriteComponent's model matrix maps to world. +constexpr std::array UNIT_QUAD{ + glm::vec2{0.f, 0.f}, glm::vec2{1.f, 0.f}, glm::vec2{1.f, 1.f}, + glm::vec2{0.f, 1.f}}; + +const ImU32 SELECTION_COLOR = IM_COL32(255, 170, 40, 255); + +} // namespace + +ImVec2 ViewportPanel::ViewportTransform::worldToScreen( + const glm::vec3& world) const { + glm::vec4 clip = viewProjection * glm::vec4{world, 1.f}; + glm::vec2 ndc = glm::vec2{clip} / clip.w; + // Vulkan NDC has +y pointing down, same as the screen. + return {origin.x + (ndc.x * 0.5f + 0.5f) * size.x, + origin.y + (ndc.y * 0.5f + 0.5f) * size.y}; +} + +glm::vec2 ViewportPanel::ViewportTransform::screenToWorld( + const ImVec2& screen) const { + glm::vec2 ndc{(screen.x - origin.x) / size.x * 2.f - 1.f, + (screen.y - origin.y) / size.y * 2.f - 1.f}; + glm::vec4 world = inverseViewProjection * glm::vec4{ndc, 0.f, 1.f}; + return glm::vec2{world} / world.w; +} + void ViewportPanel::onUpdate(const sophia::FrameInfo&) { + drawToolbar(); + ImGui::Separator(); + + const ImVec2 origin = ImGui::GetCursorScreenPos(); + const ImVec2 size = ImGui::GetContentRegionAvail(); + if (size.x < 1.0f || size.y < 1.0f) { + return; + } + + ui.image(target); + + // The image doesn't take mouse input, so without this, dragging in it + // would drag the window instead. + ImGui::SetCursorScreenPos(origin); + ImGui::InvisibleButton("##viewport", size); + + ImDrawList* drawList = ImGui::GetWindowDrawList(); + drawList->PushClipRect(origin, ImVec2(origin.x + size.x, origin.y + size.y), + true); + + if (showGrid) { + drawGrid(origin, size); + } + + sophia::Entity camera = scene.getActiveCamera(); + if (camera && camera.hasComponent()) { + // Use the panel's size rather than the target's: the target is resized + // a frame late, and the mouse is over the panel. + float aspect = size.x / size.y; + glm::mat4 viewProjection = + camera.getComponent().getViewProjection( + camera.getComponent(), aspect); + + ViewportTransform viewport{origin, size, viewProjection, + glm::inverse(viewProjection)}; + handleInput(viewport); + drawSelection(viewport); + } + + drawList->PopClipRect(); + + ImGui::SetCursorScreenPos(ImVec2(origin.x + 8.0f, origin.y + 8.0f)); + ImGui::TextDisabled("%.0f x %.0f", size.x, size.y); +} + +void ViewportPanel::drawToolbar() { const struct { const char* label; GizmoMode mode; @@ -17,30 +96,107 @@ void ViewportPanel::onUpdate(const sophia::FrameInfo&) { ImGui::SameLine(); } ImGui::Checkbox("Grid", &showGrid); +} - ImGui::Separator(); - - const ImVec2 origin = ImGui::GetCursorScreenPos(); - const ImVec2 size = ImGui::GetContentRegionAvail(); +void ViewportPanel::drawGrid(ImVec2 origin, ImVec2 size) { + constexpr float GRID_STEP = 40.0f; + const ImU32 gridColor = IM_COL32(255, 255, 255, 18); const ImVec2 end(origin.x + size.x, origin.y + size.y); - ui.image(target); - ImDrawList* drawList = ImGui::GetWindowDrawList(); + for (float x = GRID_STEP; x < size.x; x += GRID_STEP) { + drawList->AddLine(ImVec2(origin.x + x, origin.y), + ImVec2(origin.x + x, end.y), gridColor); + } + for (float y = GRID_STEP; y < size.y; y += GRID_STEP) { + drawList->AddLine(ImVec2(origin.x, origin.y + y), + ImVec2(end.x, origin.y + y), gridColor); + } +} - if (showGrid) { - constexpr float GRID_STEP = 40.0f; - const ImU32 gridColor = IM_COL32(255, 255, 255, 18); - for (float x = GRID_STEP; x < size.x; x += GRID_STEP) { - drawList->AddLine(ImVec2(origin.x + x, origin.y), - ImVec2(origin.x + x, end.y), gridColor); - } - for (float y = GRID_STEP; y < size.y; y += GRID_STEP) { - drawList->AddLine(ImVec2(origin.x, origin.y + y), - ImVec2(end.x, origin.y + y), gridColor); - } +void ViewportPanel::handleInput(const ViewportTransform& viewport) { + const ImGuiIO& io = ImGui::GetIO(); + + if (ImGui::IsItemActivated()) { + selected = pick(viewport.screenToWorld(io.MousePos)); + dragging = selected && gizmoMode == GizmoMode::Move; } - ImGui::SetCursorScreenPos(ImVec2(origin.x + 8.0f, origin.y + 8.0f)); - ImGui::TextDisabled("%.0f x %.0f", size.x, size.y); + if (!ImGui::IsItemActive()) { + dragging = false; + return; + } + + if (dragging && (io.MouseDelta.x != 0.f || io.MouseDelta.y != 0.f)) { + ImVec2 previous(io.MousePos.x - io.MouseDelta.x, + io.MousePos.y - io.MouseDelta.y); + glm::vec2 delta = + viewport.screenToWorld(io.MousePos) - viewport.screenToWorld(previous); + + auto& transform = selected.getComponent(); + transform.position.x += delta.x; + transform.position.y += delta.y; + } +} + +void ViewportPanel::drawSelection(const ViewportTransform& viewport) { + if (!selected) { + return; + } + + ImDrawList* drawList = ImGui::GetWindowDrawList(); + const auto& transform = selected.getComponent(); + + if (selected.hasComponent()) { + glm::mat4 model = + selected.getComponent().getModel(transform); + + std::array corners; + for (size_t i = 0; i < UNIT_QUAD.size(); i++) { + corners[i] = viewport.worldToScreen( + glm::vec3{model * glm::vec4{UNIT_QUAD[i], 0.f, 1.f}}); + } + drawList->AddQuad(corners[0], corners[1], corners[2], corners[3], + SELECTION_COLOR, 2.0f); + } + + // Mark the transform's position (the sprite's pivot), which is also all + // there is to show for entities without a sprite, such as the camera. + ImVec2 center = viewport.worldToScreen(transform.position); + drawList->AddCircle(center, 4.0f, SELECTION_COLOR, 0, 2.0f); +} + +sophia::Entity ViewportPanel::pick(glm::vec2 world) { + sophia::Entity best; + std::optional> bestOrder; + + scene.forEachEntity([&](sophia::Entity entity) { + if (!entity.hasComponent()) { + return; + } + + const auto& transform = entity.getComponent(); + const auto& sprite = entity.getComponent(); + + glm::mat4 model = sprite.getModel(transform); + // Zero size or scale; nothing to hit. + if (glm::determinant(model) == 0.f) { + return; + } + + glm::vec4 local = + glm::inverse(model) * glm::vec4{world, transform.position.z, 1.f}; + if (local.x < 0.f || local.x > 1.f || local.y < 0.f || local.y > 1.f) { + return; + } + + // Same ordering the renderer draws in, so this is the one on top. + std::tuple order{sprite.sortOrder, transform.position.z}; + if (!bestOrder || order >= *bestOrder) { + best = entity; + bestOrder = order; + } + }); + + return best; } diff --git a/editor/panels/viewport_panel.hpp b/editor/panels/viewport_panel.hpp index d470529..408b539 100644 --- a/editor/panels/viewport_panel.hpp +++ b/editor/panels/viewport_panel.hpp @@ -1,27 +1,64 @@ #pragma once +#include #include #include +#include +#include #include #include +/** + * Shows the scene through its active camera. Click a sprite to select it, + * drag it to move it (in Move mode). + * + * Picking and moving are 2D: they assume an orthographic camera rotated only + * around Z, and work in the z = 0 plane. + */ class ViewportPanel : public sophia::Panel { public: - ViewportPanel(sophia::UI& ui, sophia::RenderTargetHandle target) + ViewportPanel(sophia::UI& ui, sophia::RenderTargetHandle target, + sophia::Scene& scene, sophia::Entity& selected) : Panel{{.name = "Viewport", .windowFlags = ImGuiWindowFlags_NoScrollbar | ImGuiWindowFlags_NoScrollWithMouse}}, ui{ui}, - target{target} {} + target{target}, + scene{scene}, + selected{selected} {} void onUpdate(const sophia::FrameInfo& frameInfo) override; private: + // Where the scene image is on screen this frame, and the camera looking + // through it. + struct ViewportTransform { + ImVec2 origin; + ImVec2 size; + glm::mat4 viewProjection; + glm::mat4 inverseViewProjection; + + ImVec2 worldToScreen(const glm::vec3& world) const; + glm::vec2 screenToWorld(const ImVec2& screen) const; + }; + + void drawToolbar(); + void drawGrid(ImVec2 origin, ImVec2 size); + void handleInput(const ViewportTransform& viewport); + void drawSelection(const ViewportTransform& viewport); + + // The top-most sprite under `world`, or a null Entity. + sophia::Entity pick(glm::vec2 world); + sophia::UI& ui; sophia::RenderTargetHandle target; + sophia::Scene& scene; + sophia::Entity& selected; enum class GizmoMode { Move, Rotate, Scale }; GizmoMode gizmoMode = GizmoMode::Move; bool showGrid = true; + // Set while a drag that started on the selected entity is moving it. + bool dragging = false; }; -- 2.47.3 From 0b09aeb5d9408b891d0940939ea797a8acc03b6f Mon Sep 17 00:00:00 2001 From: Caleb Burke Date: Sat, 26 Sep 2026 02:03:11 -0700 Subject: [PATCH 10/18] More changes --- engine/include/sophia/components.hpp | 17 +++++++ engine/include/sophia/scene_registry.hpp | 2 + engine/include/sophia/scene_view_registry.hpp | 4 ++ engine/src/application.cpp | 31 +++++++++---- engine/src/rendering/scene_renderer.cpp | 46 ++++++------------- engine/src/rendering/scene_renderer.hpp | 9 ++-- 6 files changed, 64 insertions(+), 45 deletions(-) diff --git a/engine/include/sophia/components.hpp b/engine/include/sophia/components.hpp index eae6ebd..ab44893 100644 --- a/engine/include/sophia/components.hpp +++ b/engine/include/sophia/components.hpp @@ -66,6 +66,14 @@ struct SpriteComponent { // Higher draws on top. Ties are broken by the transform's position.z. s32 sortOrder = 0; + + // Maps the unit quad (0, 0)-(1, 1) to world space: to the sprite's + // rectangle around its pivot, then by `transform`. + glm::mat4 getModel(const TransformComponent& transform) const { + return transform.mat4() * + glm::translate(glm::mat4{1.f}, glm::vec3{-pivot * size, 0.f}) * + glm::scale(glm::mat4{1.f}, glm::vec3{size, 1.f}); + } }; struct CameraComponent { @@ -98,6 +106,15 @@ struct CameraComponent { return glm::ortho(-halfWidth, halfWidth, -halfHeight, halfHeight, ortho.nearPlane, ortho.farPlane); } + + // World -> clip space for this camera placed by `transform`. The view + // ignores the transform's scale; zoom is the projection's job. + glm::mat4 getViewProjection(const TransformComponent& transform, + float aspect) const { + glm::mat4 world = glm::translate(glm::mat4{1.f}, transform.position) * + glm::mat4_cast(transform.rotation); + return getProjection(aspect) * glm::inverse(world); + } }; } // namespace sophia diff --git a/engine/include/sophia/scene_registry.hpp b/engine/include/sophia/scene_registry.hpp index 2403b79..4e923ed 100644 --- a/engine/include/sophia/scene_registry.hpp +++ b/engine/include/sophia/scene_registry.hpp @@ -19,6 +19,8 @@ class SceneRegistry { const Scene& get(SceneHandle handle) const { return pool.get(handle); } Scene& get(SceneHandle handle) { return pool.get(handle); } + const Scene& peek(SceneHandle handle) const { return pool.get(handle); } + void release(SceneHandle handle) { pool.release(handle); } bool isAlive(SceneHandle handle) const { return pool.isAlive(handle); } diff --git a/engine/include/sophia/scene_view_registry.hpp b/engine/include/sophia/scene_view_registry.hpp index fc2ef54..7a6fd6d 100644 --- a/engine/include/sophia/scene_view_registry.hpp +++ b/engine/include/sophia/scene_view_registry.hpp @@ -35,6 +35,10 @@ class SceneViewRegistry { return pool.get(handle); } + const SceneView& peek(SceneViewHandle handle) const { + return pool.get(handle); + } + void release(SceneViewHandle handle) { isRenderQueueDirty = true; pool.release(handle); diff --git a/engine/src/application.cpp b/engine/src/application.cpp index dadc490..c265566 100644 --- a/engine/src/application.cpp +++ b/engine/src/application.cpp @@ -6,6 +6,7 @@ #include #include #include +#include #include #include #include @@ -87,11 +88,12 @@ class Application::Impl { PanelRegistry& panelRegistry = this->application.panelRegistry; SceneRegistry& sceneRegistry = this->application.sceneRegistry; SceneViewRegistry& sceneViewRegistry = this->application.sceneViewRegistry; - const SceneViewRegistry& sceneViewRegistryConst = - this->application.sceneViewRegistry; imguiRenderer.setDefaultLayout(panelRegistry.getDefaultLayout()); + // Views already warned about having no camera, so each warns once. + std::set viewsWithoutCamera; + auto startTime = std::chrono::high_resolution_clock::now(); auto currentTime = startTime; u32 frameIndex = 0; @@ -148,8 +150,8 @@ class Application::Impl { graph.importImage(renderContext.getCurrentImage(), Access::Present); std::map viewTargets; - for (SceneViewHandle handle : sceneViewRegistryConst.GetRenderQueue()) { - const SceneView& view = sceneViewRegistryConst.get(handle); + for (SceneViewHandle handle : sceneViewRegistry.GetRenderQueue()) { + const SceneView& view = sceneViewRegistry.peek(handle); if (!sceneRegistry.isAlive(view.scene) || !renderTargetPool.isAlive(view.target)) { continue; @@ -172,12 +174,23 @@ class Application::Impl { : vk::AttachmentLoadOp::eLoad, {color.r, color.g, color.b, color.a}); }, - [&sceneRenderer, &sceneViewRegistryConst, - handle](vk::CommandBuffer commandBuffer) { - const SceneView& view = sceneViewRegistryConst.get(handle); - if (view.camera) { - sceneRenderer.render(commandBuffer, view); + [&sceneRenderer, &sceneRegistry, &sceneViewRegistry, + &viewsWithoutCamera, handle](vk::CommandBuffer commandBuffer) { + const SceneView& view = sceneViewRegistry.peek(handle); + Entity camera = + view.camera ? view.camera + : sceneRegistry.get(view.scene).getActiveCamera(); + // No camera to look through: the target is just cleared. + if (!camera) { + if (viewsWithoutCamera.insert(handle).second) { + log::warning( + "scene view has no camera and its scene has no active " + "camera; it will only be cleared (see " + "Scene::createCamera)"); + } + return; } + sceneRenderer.render(commandBuffer, view, camera); }); } diff --git a/engine/src/rendering/scene_renderer.cpp b/engine/src/rendering/scene_renderer.cpp index 71d6ee6..5a631dd 100644 --- a/engine/src/rendering/scene_renderer.cpp +++ b/engine/src/rendering/scene_renderer.cpp @@ -14,19 +14,13 @@ SceneRenderer::SceneRenderer(const SceneRegistry& sceneRegistry, resources{resources}, spriteRenderSystem{device, colorFormat, resources} {} -SceneRenderer::~SceneRenderer() {} - void SceneRenderer::beginFrame(u32 frameIndex) { this->spriteRenderSystem.beginFrame(frameIndex); } void SceneRenderer::render(vk::CommandBuffer commandBuffer, - const SceneView& sceneView) { - const Scene& scene = this->sceneRegistry.get(sceneView.scene); - const entt::registry& registry = scene.registry; - - entt::entity camera = sceneView.camera; - SOPHIA_ASSERT(registry.all_of(camera), + const SceneView& sceneView, Entity camera) { + SOPHIA_ASSERT(camera.hasComponent(), "camera does not have camera component!"); vk::Extent2D extent = @@ -34,17 +28,12 @@ void SceneRenderer::render(vk::CommandBuffer commandBuffer, float aspect = static_cast(extent.width) / static_cast(extent.height); - // The view matrix ignores the camera's scale; zoom is the projection's job. - glm::mat4 cameraWorld{1.f}; - if (const auto* transform = registry.try_get(camera)) { - cameraWorld = glm::translate(glm::mat4{1.f}, transform->position) * - glm::mat4_cast(transform->rotation); - } glm::mat4 viewProjection = - registry.get(camera).getProjection(aspect) * - glm::inverse(cameraWorld); + camera.getComponent().getViewProjection( + camera.getComponent(), aspect); - renderSprites(commandBuffer, scene, viewProjection); + renderSprites(commandBuffer, this->sceneRegistry.get(sceneView.scene), + viewProjection); // TODO: meshes. Group MeshComponent entities by mesh and draw each group // (instanced), as sprites are grouped by texture. @@ -53,8 +42,7 @@ void SceneRenderer::render(vk::CommandBuffer commandBuffer, void SceneRenderer::renderSprites(vk::CommandBuffer commandBuffer, const Scene& scene, const glm::mat4& viewProjection) { - std::vector& items = this->spriteDrawItems; - items.clear(); + this->spriteDrawItems.clear(); auto view = scene.registry.view(); @@ -63,28 +51,22 @@ void SceneRenderer::renderSprites(vk::CommandBuffer commandBuffer, ? sprite.texture : this->resources.whiteTexture; - // Unit quad -> sprite rectangle around its pivot -> world. - glm::mat4 model = - transform.mat4() * - glm::translate(glm::mat4{1.f}, - glm::vec3{-sprite.pivot * sprite.size, 0.f}) * - glm::scale(glm::mat4{1.f}, glm::vec3{sprite.size, 1.f}); - - items.push_back({sprite.sortOrder, - transform.position.z, - texture, - {model, sprite.color, sprite.uvRect}}); + this->spriteDrawItems.push_back( + {sprite.sortOrder, + transform.position.z, + texture, + {sprite.getModel(transform), sprite.color, sprite.uvRect}}); } // Texture is the last key so that sprites whose order doesn't matter // relative to each other still end up in as few batches as possible. - std::ranges::sort(items, {}, [](const SpriteDrawItem& item) { + std::ranges::sort(this->spriteDrawItems, {}, [](const SpriteDrawItem& item) { return std::tuple{item.sortOrder, item.depth, item.texture}; }); this->spriteInstances.clear(); this->spriteBatches.clear(); - for (const SpriteDrawItem& item : items) { + for (const SpriteDrawItem& item : this->spriteDrawItems) { auto index = static_cast(this->spriteInstances.size()); this->spriteInstances.push_back(item.instance); diff --git a/engine/src/rendering/scene_renderer.hpp b/engine/src/rendering/scene_renderer.hpp index e7c50a4..fe6cf32 100644 --- a/engine/src/rendering/scene_renderer.hpp +++ b/engine/src/rendering/scene_renderer.hpp @@ -21,14 +21,15 @@ class SceneRenderer { SceneRenderer(const SceneRegistry& sceneRegistry, ResourceRegistry& resources, Device& device, vk::Format colorFormat); - ~SceneRenderer(); // Call once per frame, before any render(). void beginFrame(u32 frameIndex); - // Records `sceneView` into `commandBuffer`. Rendering into the view's - // target must already have begun. - void render(vk::CommandBuffer commandBuffer, const SceneView& sceneView); + // Records `sceneView` as seen through `camera` (an entity of the view's + // scene with a CameraComponent) into `commandBuffer`. Rendering into the + // view's target must already have begun. + void render(vk::CommandBuffer commandBuffer, const SceneView& sceneView, + Entity camera); private: struct SpriteDrawItem { -- 2.47.3 From 0f9c7ffc200ba2ef5a463b349a1eccd1453e6078 Mon Sep 17 00:00:00 2001 From: Caleb Burke Date: Sat, 26 Sep 2026 02:18:12 -0700 Subject: [PATCH 11/18] view -> sceneView in app class --- editor/main.cpp | 2 +- engine/include/sophia/application.hpp | 2 +- examples/boids_2d/main.cpp | 6 +++--- examples/image_viewer/main.cpp | 6 +++--- testbed/main.cpp | 9 +++++---- 5 files changed, 13 insertions(+), 12 deletions(-) diff --git a/editor/main.cpp b/editor/main.cpp index b95d944..98c410e 100644 --- a/editor/main.cpp +++ b/editor/main.cpp @@ -28,7 +28,7 @@ class Editor : public sophia::Application { panels().emplace(); sophia::RenderTargetHandle sceneTarget = resources().create(); - views().create({.scene = sceneHandle, .target = sceneTarget}); + sceneViews().create({.scene = sceneHandle, .target = sceneTarget}); panels().emplace(ui(), sceneTarget, scene, selected); panels().setDefaultLayout( diff --git a/engine/include/sophia/application.hpp b/engine/include/sophia/application.hpp index a1e5c6c..834f874 100644 --- a/engine/include/sophia/application.hpp +++ b/engine/include/sophia/application.hpp @@ -47,7 +47,7 @@ class Application { ResourceRegistryRef resources(); PanelRegistry& panels() { return this->panelRegistry; } SceneRegistry& scenes() { return this->sceneRegistry; } - SceneViewRegistry& views() { return this->sceneViewRegistry; } + SceneViewRegistry& sceneViews() { return this->sceneViewRegistry; } UI& ui() { return this->_ui; } DebugUI& debugUI() { return this->_debugUI; } diff --git a/examples/boids_2d/main.cpp b/examples/boids_2d/main.cpp index 9d34a50..f2f19e8 100644 --- a/examples/boids_2d/main.cpp +++ b/examples/boids_2d/main.cpp @@ -126,9 +126,9 @@ class Boids2D : public sophia::Application { } target = resources().create(); - views().create({.scene = sceneHandle, - .target = target, - .clearColor = {0.01f, 0.01f, 0.02f, 1.0f}}); + sceneViews().create({.scene = sceneHandle, + .target = target, + .clearColor = {0.01f, 0.01f, 0.02f, 1.0f}}); panels().emplace(ui(), target); panels().setDefaultLayout({.center = {"Boids"}}); diff --git a/examples/image_viewer/main.cpp b/examples/image_viewer/main.cpp index 7559565..4930fa2 100644 --- a/examples/image_viewer/main.cpp +++ b/examples/image_viewer/main.cpp @@ -51,9 +51,9 @@ class ImageViewer : public sophia::Application { sophia::SpriteComponent{.texture = texture, .size = imageSize}); target = resources().create(); - views().create({.scene = sceneHandle, - .target = target, - .clearColor = {0.1f, 0.1f, 0.15f, 1.f}}); + sceneViews().create({.scene = sceneHandle, + .target = target, + .clearColor = {0.1f, 0.1f, 0.15f, 1.f}}); panels().emplace(ui(), target); // panels().setDefaultLayout({.center = {"Image"}}); diff --git a/testbed/main.cpp b/testbed/main.cpp index 453c229..ba7c6f5 100644 --- a/testbed/main.cpp +++ b/testbed/main.cpp @@ -27,11 +27,12 @@ class Testbed : public sophia::Application { Testbed() : Application{{.width = 750, .height = 1000, .name = "Testbed"}} {} void onCreate() override { - view = views().create({.scene = scenes().create(), - .target = resources().create(), - .clearColor = {0.1f, 0.1f, 0.15f, 1.f}}); + view = sceneViews().create( + {.scene = scenes().create(), + .target = resources().create(), + .clearColor = {0.1f, 0.1f, 0.15f, 1.f}}); - panels().emplace(ui(), views().get(view).target); + panels().emplace(ui(), sceneViews().get(view).target); } private: -- 2.47.3 From fc7047553885d7fd2c200be9039b975d0f16bb7c Mon Sep 17 00:00:00 2001 From: Caleb Burke Date: Sun, 27 Sep 2026 02:02:19 -0700 Subject: [PATCH 12/18] renaming dir --- engine/src/application.cpp | 10 +++++----- engine/src/{rendering => renderer}/imgui_renderer.cpp | 2 +- engine/src/{rendering => renderer}/imgui_renderer.hpp | 0 .../{rendering => renderer}/model_render_system.cpp | 2 +- .../{rendering => renderer}/model_render_system.hpp | 2 +- engine/src/{rendering => renderer}/render_context.cpp | 2 +- engine/src/{rendering => renderer}/render_context.hpp | 0 engine/src/{rendering => renderer}/render_graph.cpp | 2 +- engine/src/{rendering => renderer}/render_graph.hpp | 0 engine/src/{rendering => renderer}/scene_renderer.cpp | 2 +- engine/src/{rendering => renderer}/scene_renderer.hpp | 2 +- .../{rendering => renderer}/sprite_render_system.cpp | 2 +- .../{rendering => renderer}/sprite_render_system.hpp | 2 +- engine/src/ui/ui.cpp | 2 +- 14 files changed, 15 insertions(+), 15 deletions(-) rename engine/src/{rendering => renderer}/imgui_renderer.cpp (99%) rename engine/src/{rendering => renderer}/imgui_renderer.hpp (100%) rename engine/src/{rendering => renderer}/model_render_system.cpp (98%) rename engine/src/{rendering => renderer}/model_render_system.hpp (96%) rename engine/src/{rendering => renderer}/render_context.cpp (99%) rename engine/src/{rendering => renderer}/render_context.hpp (100%) rename engine/src/{rendering => renderer}/render_graph.cpp (99%) rename engine/src/{rendering => renderer}/render_graph.hpp (100%) rename engine/src/{rendering => renderer}/scene_renderer.cpp (98%) rename engine/src/{rendering => renderer}/scene_renderer.hpp (97%) rename engine/src/{rendering => renderer}/sprite_render_system.cpp (99%) rename engine/src/{rendering => renderer}/sprite_render_system.hpp (98%) diff --git a/engine/src/application.cpp b/engine/src/application.cpp index c265566..b603bae 100644 --- a/engine/src/application.cpp +++ b/engine/src/application.cpp @@ -14,11 +14,11 @@ #include #include -#include "rendering/imgui_renderer.hpp" -#include "rendering/model_render_system.hpp" -#include "rendering/render_context.hpp" -#include "rendering/render_graph.hpp" -#include "rendering/scene_renderer.hpp" +#include "renderer/imgui_renderer.hpp" +#include "renderer/model_render_system.hpp" +#include "renderer/render_context.hpp" +#include "renderer/render_graph.hpp" +#include "renderer/scene_renderer.hpp" #include "resources/mesh.hpp" #include "resources/render_target.hpp" #include "resources/resource_registry.hpp" diff --git a/engine/src/rendering/imgui_renderer.cpp b/engine/src/renderer/imgui_renderer.cpp similarity index 99% rename from engine/src/rendering/imgui_renderer.cpp rename to engine/src/renderer/imgui_renderer.cpp index e59aa4a..c48a378 100644 --- a/engine/src/rendering/imgui_renderer.cpp +++ b/engine/src/renderer/imgui_renderer.cpp @@ -1,4 +1,4 @@ -#include "rendering/imgui_renderer.hpp" +#include "renderer/imgui_renderer.hpp" #include #include diff --git a/engine/src/rendering/imgui_renderer.hpp b/engine/src/renderer/imgui_renderer.hpp similarity index 100% rename from engine/src/rendering/imgui_renderer.hpp rename to engine/src/renderer/imgui_renderer.hpp diff --git a/engine/src/rendering/model_render_system.cpp b/engine/src/renderer/model_render_system.cpp similarity index 98% rename from engine/src/rendering/model_render_system.cpp rename to engine/src/renderer/model_render_system.cpp index a0a796f..47a83bb 100644 --- a/engine/src/rendering/model_render_system.cpp +++ b/engine/src/renderer/model_render_system.cpp @@ -1,4 +1,4 @@ -#include "rendering/model_render_system.hpp" +#include "renderer/model_render_system.hpp" #include diff --git a/engine/src/rendering/model_render_system.hpp b/engine/src/renderer/model_render_system.hpp similarity index 96% rename from engine/src/rendering/model_render_system.hpp rename to engine/src/renderer/model_render_system.hpp index b3d7470..7238a6f 100644 --- a/engine/src/rendering/model_render_system.hpp +++ b/engine/src/renderer/model_render_system.hpp @@ -4,7 +4,7 @@ #include #include -#include "rendering/render_context.hpp" +#include "renderer/render_context.hpp" #include "resources/mesh.hpp" #include "vulkan/device.hpp" #include "vulkan/pipelines/graphics_pipeline.hpp" diff --git a/engine/src/rendering/render_context.cpp b/engine/src/renderer/render_context.cpp similarity index 99% rename from engine/src/rendering/render_context.cpp rename to engine/src/renderer/render_context.cpp index e57ace9..b6de112 100644 --- a/engine/src/rendering/render_context.cpp +++ b/engine/src/renderer/render_context.cpp @@ -1,4 +1,4 @@ -#include "rendering/render_context.hpp" +#include "renderer/render_context.hpp" #include #include diff --git a/engine/src/rendering/render_context.hpp b/engine/src/renderer/render_context.hpp similarity index 100% rename from engine/src/rendering/render_context.hpp rename to engine/src/renderer/render_context.hpp diff --git a/engine/src/rendering/render_graph.cpp b/engine/src/renderer/render_graph.cpp similarity index 99% rename from engine/src/rendering/render_graph.cpp rename to engine/src/renderer/render_graph.cpp index b15d6b6..555e488 100644 --- a/engine/src/rendering/render_graph.cpp +++ b/engine/src/renderer/render_graph.cpp @@ -1,4 +1,4 @@ -#include "rendering/render_graph.hpp" +#include "renderer/render_graph.hpp" #include #include diff --git a/engine/src/rendering/render_graph.hpp b/engine/src/renderer/render_graph.hpp similarity index 100% rename from engine/src/rendering/render_graph.hpp rename to engine/src/renderer/render_graph.hpp diff --git a/engine/src/rendering/scene_renderer.cpp b/engine/src/renderer/scene_renderer.cpp similarity index 98% rename from engine/src/rendering/scene_renderer.cpp rename to engine/src/renderer/scene_renderer.cpp index 5a631dd..9ba3d5f 100644 --- a/engine/src/rendering/scene_renderer.cpp +++ b/engine/src/renderer/scene_renderer.cpp @@ -1,4 +1,4 @@ -#include "rendering/scene_renderer.hpp" +#include "renderer/scene_renderer.hpp" #include #include diff --git a/engine/src/rendering/scene_renderer.hpp b/engine/src/renderer/scene_renderer.hpp similarity index 97% rename from engine/src/rendering/scene_renderer.hpp rename to engine/src/renderer/scene_renderer.hpp index fe6cf32..2b1bf52 100644 --- a/engine/src/rendering/scene_renderer.hpp +++ b/engine/src/renderer/scene_renderer.hpp @@ -4,7 +4,7 @@ #include #include -#include "rendering/sprite_render_system.hpp" +#include "renderer/sprite_render_system.hpp" #include "resources/resource_registry.hpp" namespace sophia { diff --git a/engine/src/rendering/sprite_render_system.cpp b/engine/src/renderer/sprite_render_system.cpp similarity index 99% rename from engine/src/rendering/sprite_render_system.cpp rename to engine/src/renderer/sprite_render_system.cpp index 98fca65..327e717 100644 --- a/engine/src/rendering/sprite_render_system.cpp +++ b/engine/src/renderer/sprite_render_system.cpp @@ -1,4 +1,4 @@ -#include "rendering/sprite_render_system.hpp" +#include "renderer/sprite_render_system.hpp" #include #include diff --git a/engine/src/rendering/sprite_render_system.hpp b/engine/src/renderer/sprite_render_system.hpp similarity index 98% rename from engine/src/rendering/sprite_render_system.hpp rename to engine/src/renderer/sprite_render_system.hpp index d3109f0..293caae 100644 --- a/engine/src/rendering/sprite_render_system.hpp +++ b/engine/src/renderer/sprite_render_system.hpp @@ -7,7 +7,7 @@ #include #include -#include "rendering/render_context.hpp" +#include "renderer/render_context.hpp" #include "resources/resource_registry.hpp" #include "vulkan/buffer.hpp" #include "vulkan/descriptors/descriptor_pool.hpp" diff --git a/engine/src/ui/ui.cpp b/engine/src/ui/ui.cpp index 164722a..f25d003 100644 --- a/engine/src/ui/ui.cpp +++ b/engine/src/ui/ui.cpp @@ -1,7 +1,7 @@ #include #include -#include "rendering/imgui_renderer.hpp" +#include "renderer/imgui_renderer.hpp" namespace sophia { -- 2.47.3 From 97ff85ea8aca52a6936dd5217bb62a052efe404b Mon Sep 17 00:00:00 2001 From: Caleb Burke Date: Wed, 30 Sep 2026 01:31:59 -0700 Subject: [PATCH 13/18] Added VMA --- engine/CMakeLists.txt | 1 + engine/src/vulkan/buffer.cpp | 36 +++++------ engine/src/vulkan/buffer.hpp | 2 +- engine/src/vulkan/device.cpp | 115 +++++++++++++---------------------- engine/src/vulkan/device.hpp | 11 ++-- engine/src/vulkan/image.cpp | 54 ++++++++++------ engine/src/vulkan/image.hpp | 11 ++-- engine/src/vulkan/vma.cpp | 2 + third_party/CMakeLists.txt | 5 ++ 9 files changed, 118 insertions(+), 119 deletions(-) create mode 100644 engine/src/vulkan/vma.cpp diff --git a/engine/CMakeLists.txt b/engine/CMakeLists.txt index 7b89d63..dd5a483 100644 --- a/engine/CMakeLists.txt +++ b/engine/CMakeLists.txt @@ -24,6 +24,7 @@ target_compile_definitions(${ENGINE_NAME} PUBLIC target_link_libraries(${ENGINE_NAME} PUBLIC vulkan + vma shaderc glfw glm diff --git a/engine/src/vulkan/buffer.cpp b/engine/src/vulkan/buffer.cpp index 88428af..8054ee1 100644 --- a/engine/src/vulkan/buffer.cpp +++ b/engine/src/vulkan/buffer.cpp @@ -28,26 +28,32 @@ Buffer::Buffer(Device& device, vk::DeviceSize instanceSize, u32 instanceCount, alignmentSize = getAlignment(instanceSize, minOffsetAlignment); bufferSize = alignmentSize * instanceCount; device.createBuffer(bufferSize, usageFlags, memoryPropertyFlags, buffer, - memory); + allocation); } Buffer::~Buffer() { unmap(); - this->device.get()->destroyBuffer(this->buffer); - this->device.get()->freeMemory(this->memory); + vmaDestroyBuffer(this->device.getAllocator(), this->buffer, this->allocation); } +// VMA always maps the whole allocation, so `size` only exists to keep the +// interface; `offset` is applied to the returned pointer. vk::Result Buffer::map(vk::DeviceSize size, vk::DeviceSize offset) { - SOPHIA_ASSERT(buffer && memory, "Called map on buffer before create"); + SOPHIA_ASSERT(buffer && allocation, "Called map on buffer before create"); + (void)size; - vk::MemoryMapFlags emptyFlag{}; - return this->device.get()->mapMemory(this->memory, offset, size, emptyFlag, - &this->mapped); + void* base = nullptr; + vk::Result result = static_cast( + vmaMapMemory(this->device.getAllocator(), this->allocation, &base)); + if (result == vk::Result::eSuccess) { + this->mapped = static_cast(base) + offset; + } + return result; } void Buffer::unmap() { if (mapped) { - this->device.get()->unmapMemory(this->memory); + vmaUnmapMemory(this->device.getAllocator(), this->allocation); mapped = nullptr; } } @@ -66,19 +72,13 @@ void Buffer::writeToBuffer(void* data, vk::DeviceSize size, } vk::Result Buffer::flush(vk::DeviceSize size, vk::DeviceSize offset) { - vk::MappedMemoryRange mappedRange = {}; - mappedRange.memory = memory; - mappedRange.offset = offset; - mappedRange.size = size; - return this->device.get()->flushMappedMemoryRanges(1, &mappedRange); + return static_cast(vmaFlushAllocation( + this->device.getAllocator(), this->allocation, offset, size)); } vk::Result Buffer::invalidate(vk::DeviceSize size, vk::DeviceSize offset) { - vk::MappedMemoryRange mappedRange = {}; - mappedRange.memory = memory; - mappedRange.offset = offset; - mappedRange.size = size; - return this->device.get()->invalidateMappedMemoryRanges(1, &mappedRange); + return static_cast(vmaInvalidateAllocation( + this->device.getAllocator(), this->allocation, offset, size)); } vk::DescriptorBufferInfo Buffer::descriptorInfo(vk::DeviceSize size, diff --git a/engine/src/vulkan/buffer.hpp b/engine/src/vulkan/buffer.hpp index 2320ab4..f4cfbb1 100644 --- a/engine/src/vulkan/buffer.hpp +++ b/engine/src/vulkan/buffer.hpp @@ -55,7 +55,7 @@ class Buffer { Device& device; void* mapped = nullptr; vk::Buffer buffer = VK_NULL_HANDLE; - vk::DeviceMemory memory = VK_NULL_HANDLE; + VmaAllocation allocation = VK_NULL_HANDLE; vk::DeviceSize bufferSize; uint32_t instanceCount; diff --git a/engine/src/vulkan/device.cpp b/engine/src/vulkan/device.cpp index 2e8fc9c..fe1fbaa 100644 --- a/engine/src/vulkan/device.cpp +++ b/engine/src/vulkan/device.cpp @@ -69,10 +69,14 @@ Device::Device(Window* window) } pickPhysicalDevice(); createLogicalDevice(); + createAllocator(); createCommandPool(); } Device::~Device() { + vmaDestroyAllocator(this->allocator); + log::trace("destroyed VmaAllocator"); + if (this->enableValidationLayers) { destroyDebugUtilsMessengerEXT(this->instance.get(), this->debugMessenger, nullptr); @@ -88,22 +92,6 @@ Device::~Device() { } } -u32 Device::findMemoryType(u32 typeFilter, vk::MemoryPropertyFlags properties) { - vk::PhysicalDeviceMemoryProperties memoryProperties = - this->physicalDevice.getMemoryProperties(); - - for (u32 i = 0; i < memoryProperties.memoryTypeCount; i++) { - if ((typeFilter & (1 << i)) && - (memoryProperties.memoryTypes[i].propertyFlags & properties) == - properties) { - return i; - } - } - - log::fatal("failed to find suitable memory type"); - throw std::runtime_error("failed to find suitable memory type"); -} - vk::Format Device::findSupportedFormat( const std::vector& candidates, vk::ImageTiling tiling, vk::FormatFeatureFlags features) { @@ -125,35 +113,26 @@ vk::Format Device::findSupportedFormat( void Device::createBuffer(vk::DeviceSize size, vk::BufferUsageFlags usage, vk::MemoryPropertyFlags properties, - vk::Buffer& buffer, vk::DeviceMemory& bufferMemory) { + vk::Buffer& buffer, VmaAllocation& allocation) { vk::BufferCreateInfo bufferInfo = {}; bufferInfo.size = size; bufferInfo.usage = usage; bufferInfo.sharingMode = vk::SharingMode::eExclusive; - try { - buffer = this->device->createBuffer(bufferInfo); - } catch (const vk::SystemError& error) { - log::fatal("failed to create vertex buffer"); - throw std::runtime_error("failed to create vertex buffer"); + VmaAllocationCreateInfo allocInfo = {}; + allocInfo.requiredFlags = static_cast(properties); + + VkBuffer rawBuffer = VK_NULL_HANDLE; + VkResult result = vmaCreateBuffer( + this->allocator, &static_cast(bufferInfo), + &allocInfo, &rawBuffer, &allocation, nullptr); + if (result != VK_SUCCESS) { + log::fatal("failed to create buffer. Error: ", + vk::to_string(static_cast(result))); + throw std::runtime_error("failed to create buffer"); } - vk::MemoryRequirements memoryRequirements = - this->device->getBufferMemoryRequirements(buffer); - - vk::MemoryAllocateInfo allocInfo = {}; - allocInfo.allocationSize = memoryRequirements.size; - allocInfo.memoryTypeIndex = - findMemoryType(memoryRequirements.memoryTypeBits, properties); - - try { - bufferMemory = this->device->allocateMemory(allocInfo); - } catch (const vk::SystemError& error) { - log::fatal("failed to allocate vertex buffer memory"); - throw std::runtime_error("failed to allocate vertex buffer memory"); - } - - this->device->bindBufferMemory(buffer, bufferMemory, 0); + buffer = rawBuffer; } vk::CommandBuffer Device::beginSingleTimeCommands() { @@ -220,43 +199,21 @@ void Device::copyBuffer(vk::Buffer sourceBuffer, vk::Buffer destinationBuffer, void Device::createImageWithInfo(const vk::ImageCreateInfo& imageInfo, vk::MemoryPropertyFlags properties, - vk::Image& image, - vk::DeviceMemory& imageMemory) { - try { - vk::Result result = this->device->createImage(&imageInfo, nullptr, &image); - if (result != vk::Result::eSuccess) { - throw vk::SystemError(result); - } - } catch (const vk::SystemError& error) { - log::fatal("failed to create image. Error: ", error.what()); + vk::Image& image, VmaAllocation& allocation) { + VmaAllocationCreateInfo allocInfo = {}; + allocInfo.requiredFlags = static_cast(properties); + + VkImage rawImage = VK_NULL_HANDLE; + VkResult result = vmaCreateImage( + this->allocator, &static_cast(imageInfo), + &allocInfo, &rawImage, &allocation, nullptr); + if (result != VK_SUCCESS) { + log::fatal("failed to create image. Error: ", + vk::to_string(static_cast(result))); throw std::runtime_error("failed to create image"); } - vk::MemoryRequirements memoryRequirements = - this->device->getImageMemoryRequirements(image); - - vk::MemoryAllocateInfo allocateInfo{}; - allocateInfo.allocationSize = memoryRequirements.size; - allocateInfo.memoryTypeIndex = - findMemoryType(memoryRequirements.memoryTypeBits, properties); - - try { - vk::Result result = - this->device->allocateMemory(&allocateInfo, nullptr, &imageMemory); - if (result != vk::Result::eSuccess) { - throw vk::SystemError(result); - } - } catch (const vk::SystemError& error) { - log::fatal("failed to allocate image memory. Error: ", error.what()); - throw std::runtime_error("failed to allocate image memory"); - } - - try { - this->device->bindImageMemory(image, imageMemory, 0); - } catch (const vk::SystemError& error) { - log::fatal("failed to bind image memory. Error: ", error.what()); - throw std::runtime_error("failed to bind image memory"); - } + image = rawImage; } void Device::populateImGuiInitInfo(ImGui_ImplVulkan_InitInfo& initInfo) { @@ -514,6 +471,20 @@ void Device::createLogicalDevice() { } } +void Device::createAllocator() { + VmaAllocatorCreateInfo createInfo = {}; + createInfo.vulkanApiVersion = SOPHIA_VULKAN_API_VERSION; + createInfo.instance = this->instance.get(); + createInfo.physicalDevice = this->physicalDevice; + createInfo.device = this->device.get(); + + if (vmaCreateAllocator(&createInfo, &this->allocator) != VK_SUCCESS) { + log::fatal("failed to create VmaAllocator"); + throw std::runtime_error("failed to create VmaAllocator"); + } + log::trace("created VmaAllocator"); +} + SwapchainSupportDetails Device::querySwapchainSupport( vk::PhysicalDevice device) { SwapchainSupportDetails details; diff --git a/engine/src/vulkan/device.hpp b/engine/src/vulkan/device.hpp index a690f3b..9967f24 100644 --- a/engine/src/vulkan/device.hpp +++ b/engine/src/vulkan/device.hpp @@ -1,6 +1,7 @@ #pragma once #include +#include #include #include @@ -47,6 +48,7 @@ class Device { void waitIdle() { this->device->waitIdle(); } + VmaAllocator getAllocator() const { return this->allocator; } vk::CommandPool getCommandPool() const { return this->commandPool; } vk::SurfaceKHR getSurface() const { return surface; } vk::Queue getGraphicsQueue() const { return graphicsQueue; } @@ -60,15 +62,13 @@ class Device { return querySwapchainSupport(this->physicalDevice); } - u32 findMemoryType(u32 typeFilter, vk::MemoryPropertyFlags properties); - vk::Format findSupportedFormat(const std::vector& candidates, vk::ImageTiling tiling, vk::FormatFeatureFlags features); void createBuffer(vk::DeviceSize size, vk::BufferUsageFlags usage, vk::MemoryPropertyFlags properties, vk::Buffer& buffer, - vk::DeviceMemory& bufferMemory); + VmaAllocation& allocation); vk::CommandBuffer beginSingleTimeCommands(); @@ -79,7 +79,7 @@ class Device { void createImageWithInfo(const vk::ImageCreateInfo& imageInfo, vk::MemoryPropertyFlags properties, vk::Image& image, - vk::DeviceMemory& imageMemory); + VmaAllocation& allocation); void populateImGuiInitInfo(ImGui_ImplVulkan_InitInfo& initInfo); @@ -100,6 +100,7 @@ class Device { SwapchainSupportDetails querySwapchainSupport(vk::PhysicalDevice device); void createLogicalDevice(); + void createAllocator(); void createCommandPool(); vk::UniqueInstance instance; @@ -111,6 +112,8 @@ class Device { vk::PhysicalDevice physicalDevice = VK_NULL_HANDLE; vk::UniqueDevice device; + VmaAllocator allocator = VK_NULL_HANDLE; + vk::Queue graphicsQueue; vk::Queue presentQueue; diff --git a/engine/src/vulkan/image.cpp b/engine/src/vulkan/image.cpp index 5ea66c1..8d8b93c 100644 --- a/engine/src/vulkan/image.cpp +++ b/engine/src/vulkan/image.cpp @@ -3,11 +3,35 @@ #include #include #include +#include #include "vulkan/device.hpp" namespace sophia { +Image::Image(Image&& other) noexcept + : device{other.device}, + externalImage{other.externalImage}, + image{std::exchange(other.image, nullptr)}, + allocation{std::exchange(other.allocation, VK_NULL_HANDLE)}, + view{std::move(other.view)}, + sampler{std::move(other.sampler)}, + format{other.format}, + extent{other.extent}, + aspectMask{other.aspectMask}, + mipLevels{other.mipLevels}, + arrayLayers{other.arrayLayers}, + layout{other.layout} {} + +Image::~Image() { + this->sampler.reset(); + this->view.reset(); + + if (this->image) { + vmaDestroyImage(this->device.getAllocator(), this->image, this->allocation); + } +} + vk::ImageSubresourceRange Image::getSubresourceRange() const { return vk::ImageSubresourceRange{this->aspectMask, 0, this->mipLevels, 0, this->arrayLayers}; @@ -194,35 +218,26 @@ std::unique_ptr Image::Builder::build() { imageInfo.sharingMode = vk::SharingMode::eExclusive; imageInfo.samples = this->samples; - result->image = this->device.get()->createImageUnique(imageInfo); - - vk::MemoryRequirements memoryRequirements = - this->device.get()->getImageMemoryRequirements(result->image.get()); - - vk::MemoryAllocateInfo allocInfo{}; - allocInfo.allocationSize = memoryRequirements.size; - allocInfo.memoryTypeIndex = this->device.findMemoryType( - memoryRequirements.memoryTypeBits, this->memoryProperties); - - result->memory = this->device.get()->allocateMemoryUnique(allocInfo); - this->device.get()->bindImageMemory(result->image.get(), - result->memory.get(), 0); + this->device.createImageWithInfo(imageInfo, this->memoryProperties, + result->image, result->allocation); } if (!this->isExternalImage && this->initialData != nullptr) { + VmaAllocator allocator = this->device.getAllocator(); + vk::Buffer stagingBuffer; - vk::DeviceMemory stagingMemory; + VmaAllocation stagingAllocation; this->device.createBuffer(this->initialDataSize, vk::BufferUsageFlagBits::eTransferSrc, vk::MemoryPropertyFlagBits::eHostVisible | vk::MemoryPropertyFlagBits::eHostCoherent, - stagingBuffer, stagingMemory); + stagingBuffer, stagingAllocation); - void* mapped = - this->device.get()->mapMemory(stagingMemory, 0, this->initialDataSize); + void* mapped = nullptr; + vmaMapMemory(allocator, stagingAllocation, &mapped); memcpy(mapped, this->initialData, static_cast(this->initialDataSize)); - this->device.get()->unmapMemory(stagingMemory); + vmaUnmapMemory(allocator, stagingAllocation); vk::BufferImageCopy region{}; region.bufferOffset = 0; @@ -247,8 +262,7 @@ std::unique_ptr Image::Builder::build() { } this->device.endSingleTimeCommands(commandBuffer); - this->device.get()->destroyBuffer(stagingBuffer); - this->device.get()->freeMemory(stagingMemory); + vmaDestroyBuffer(allocator, stagingBuffer, stagingAllocation); } if (this->createView) { diff --git a/engine/src/vulkan/image.hpp b/engine/src/vulkan/image.hpp index 5f8647f..15e091a 100644 --- a/engine/src/vulkan/image.hpp +++ b/engine/src/vulkan/image.hpp @@ -1,5 +1,7 @@ #pragma once +#include + #include #include #include @@ -16,11 +18,12 @@ class Image { Image(const Image&) = delete; Image& operator=(const Image&) = delete; - Image(Image&&) = default; + Image(Image&& other) noexcept; Image& operator=(Image&&) = delete; + ~Image(); vk::Image get() const { - return this->image ? this->image.get() : this->externalImage; + return this->image ? this->image : this->externalImage; } vk::ImageView getView() const { return this->view.get(); } vk::Sampler getSampler() const { return this->sampler.get(); } @@ -56,8 +59,8 @@ class Image { Device& device; vk::Image externalImage; - vk::UniqueImage image; - vk::UniqueDeviceMemory memory; + vk::Image image; + VmaAllocation allocation = VK_NULL_HANDLE; vk::UniqueImageView view; vk::UniqueSampler sampler; diff --git a/engine/src/vulkan/vma.cpp b/engine/src/vulkan/vma.cpp new file mode 100644 index 0000000..7a6837c --- /dev/null +++ b/engine/src/vulkan/vma.cpp @@ -0,0 +1,2 @@ +#define VMA_IMPLEMENTATION +#include diff --git a/third_party/CMakeLists.txt b/third_party/CMakeLists.txt index 6e31ae1..6c9df76 100644 --- a/third_party/CMakeLists.txt +++ b/third_party/CMakeLists.txt @@ -17,6 +17,11 @@ target_link_libraries(vulkan INTERFACE Vulkan::shaderc_combined ) +# 2. VMA (header-only, ships with the Vulkan SDK) +add_library(vma INTERFACE) +target_include_directories(vma INTERFACE ${Vulkan_INCLUDE_DIRS}/vma) +target_link_libraries(vma INTERFACE vulkan) + # 3. GLFW (static) option(GLFW_BUILD_EXAMPLES "Build the GLFW example programs" OFF) option(GLFW_BUILD_TESTS "Build the GLFW test programs" OFF) -- 2.47.3 From 812d50127eccc9f16b1502f7776011c62ad50736 Mon Sep 17 00:00:00 2001 From: Caleb Burke Date: Wed, 30 Sep 2026 02:04:59 -0700 Subject: [PATCH 14/18] Adding in tracy profiler --- .gitmodules | 3 +++ engine/CMakeLists.txt | 1 + engine/src/application.cpp | 14 ++++++++++++-- engine/src/renderer/imgui_renderer.cpp | 4 ++++ engine/src/renderer/model_render_system.cpp | 2 ++ engine/src/renderer/render_context.cpp | 11 +++++++++-- engine/src/renderer/render_graph.cpp | 2 ++ engine/src/renderer/scene_renderer.cpp | 3 +++ engine/src/renderer/sprite_render_system.cpp | 2 ++ engine/src/resources/pools/render_target_pool.cpp | 3 +++ engine/src/ui/panel_registry.cpp | 2 ++ third_party/CMakeLists.txt | 6 ++++++ third_party/tracy | 1 + 13 files changed, 50 insertions(+), 4 deletions(-) create mode 160000 third_party/tracy diff --git a/.gitmodules b/.gitmodules index d82f3ba..0109930 100644 --- a/.gitmodules +++ b/.gitmodules @@ -8,3 +8,6 @@ path = third_party/imgui url = https://github.com/ocornut/imgui.git branch = docking +[submodule "third_party/tracy"] + path = third_party/tracy + url = https://github.com/wolfpld/tracy.git diff --git a/engine/CMakeLists.txt b/engine/CMakeLists.txt index dd5a483..f085d27 100644 --- a/engine/CMakeLists.txt +++ b/engine/CMakeLists.txt @@ -30,6 +30,7 @@ target_link_libraries(${ENGINE_NAME} PUBLIC glm imgui entt + Tracy::TracyClient ) target_link_libraries(${ENGINE_NAME} PRIVATE diff --git a/engine/src/application.cpp b/engine/src/application.cpp index b603bae..88ca4dd 100644 --- a/engine/src/application.cpp +++ b/engine/src/application.cpp @@ -10,6 +10,7 @@ #include #include #include +#include #include #include #include @@ -118,7 +119,10 @@ class Application::Impl { glm::vec2(static_cast(extent.width), static_cast(extent.height)), this->application.camera}; - this->application.onUpdate(frameInfo); + { + ZoneScopedN("Application::onUpdate"); + this->application.onUpdate(frameInfo); + } this->application.camera.setProjection( -frameInfo.currentFramebufferExtent.x / 2.f, frameInfo.currentFramebufferExtent.x / 2.f, @@ -134,7 +138,10 @@ class Application::Impl { sceneRenderer.beginFrame(renderContext.getFrameIndex()); panelRegistry.update(frameInfo); - this->application.onRender(); + { + ZoneScopedN("Application::onRender"); + this->application.onRender(); + } std::vector instances; instances.reserve(this->meshes.size() + this->drawCalls.size()); @@ -176,6 +183,7 @@ class Application::Impl { }, [&sceneRenderer, &sceneRegistry, &sceneViewRegistry, &viewsWithoutCamera, handle](vk::CommandBuffer commandBuffer) { + ZoneScopedN("scene view pass"); const SceneView& view = sceneViewRegistry.peek(handle); Entity camera = view.camera ? view.camera @@ -204,6 +212,7 @@ class Application::Impl { } }, [&](vk::CommandBuffer commandBuffer) { + ZoneScopedN("main pass"); modelRenderSystem.render(commandBuffer, instances, frameInfo); imguiRenderer.endFrame(commandBuffer); @@ -212,6 +221,7 @@ class Application::Impl { graph.execute(commandBuffer); renderContext.endFrame(); + FrameMark; frameIndex++; } diff --git a/engine/src/renderer/imgui_renderer.cpp b/engine/src/renderer/imgui_renderer.cpp index c48a378..5a28b5f 100644 --- a/engine/src/renderer/imgui_renderer.cpp +++ b/engine/src/renderer/imgui_renderer.cpp @@ -5,6 +5,8 @@ #include #include +#include + #include "resources/render_target.hpp" namespace sophia { @@ -79,6 +81,7 @@ ImGuiRenderer::~ImGuiRenderer() { } void ImGuiRenderer::beginFrame() { + ZoneScoped; releaseStaleTextures(); ImGui_ImplVulkan_NewFrame(); @@ -183,6 +186,7 @@ void ImGuiRenderer::applyLayoutIfNeeded(ImGuiID dockspaceId, } void ImGuiRenderer::endFrame(vk::CommandBuffer commandBuffer) { + ZoneScoped; ImGui::Render(); ImDrawData* mainDrawData = ImGui::GetDrawData(); diff --git a/engine/src/renderer/model_render_system.cpp b/engine/src/renderer/model_render_system.cpp index 47a83bb..0495b06 100644 --- a/engine/src/renderer/model_render_system.cpp +++ b/engine/src/renderer/model_render_system.cpp @@ -1,6 +1,7 @@ #include "renderer/model_render_system.hpp" #include +#include #include "shaders/model_render_system.frag.spv.h" #include "shaders/model_render_system.vert.spv.h" @@ -44,6 +45,7 @@ ModelRenderSystem::~ModelRenderSystem() { void ModelRenderSystem::render(vk::CommandBuffer commandBuffer, std::span instances, const FrameInfo& frameInfo) { + ZoneScoped; glm::mat4 viewProjection = frameInfo.camera.getViewProjection(); this->graphicsPipeline->bind(commandBuffer); diff --git a/engine/src/renderer/render_context.cpp b/engine/src/renderer/render_context.cpp index b6de112..67a293e 100644 --- a/engine/src/renderer/render_context.cpp +++ b/engine/src/renderer/render_context.cpp @@ -4,6 +4,7 @@ #include #include #include +#include #include "vulkan/access.hpp" @@ -18,14 +19,19 @@ RenderContext::RenderContext(Window& window, Device& device) RenderContext::~RenderContext() { this->device.waitIdle(); } vk::CommandBuffer RenderContext::beginFrame() { + ZoneScoped; SOPHIA_ASSERT(!this->isFrameStarted, "Can't call beginFrame while already in progress"); FrameData& frame = this->frames[this->currentFrameIndex]; vk::Fence inFlightFence = frame.inFlight.get(); - vk::Result fenceResult = this->device.get()->waitForFences( - inFlightFence, vk::True, std::numeric_limits::max()); + vk::Result fenceResult; + { + ZoneScopedN("wait for frame fence"); + fenceResult = this->device.get()->waitForFences( + inFlightFence, vk::True, std::numeric_limits::max()); + } if (fenceResult != vk::Result::eSuccess) { log::error("failed to wait for fence: " + vk::to_string(fenceResult)); @@ -73,6 +79,7 @@ vk::CommandBuffer RenderContext::beginFrame() { } void RenderContext::endFrame() { + ZoneScoped; SOPHIA_ASSERT(this->isFrameStarted, "Can't call endFrame while no frame is in progress"); diff --git a/engine/src/renderer/render_graph.cpp b/engine/src/renderer/render_graph.cpp index 555e488..880dd5b 100644 --- a/engine/src/renderer/render_graph.cpp +++ b/engine/src/renderer/render_graph.cpp @@ -1,6 +1,7 @@ #include "renderer/render_graph.hpp" #include +#include #include #include "vulkan/debug_label.hpp" @@ -24,6 +25,7 @@ void RenderGraph::addPass(std::string name, const SetupFn& setup, } void RenderGraph::execute(vk::CommandBuffer commandBuffer) { + ZoneScoped; for (Pass& pass : this->passes) { this->recordPass(commandBuffer, pass); } diff --git a/engine/src/renderer/scene_renderer.cpp b/engine/src/renderer/scene_renderer.cpp index 9ba3d5f..92e2563 100644 --- a/engine/src/renderer/scene_renderer.cpp +++ b/engine/src/renderer/scene_renderer.cpp @@ -3,6 +3,7 @@ #include #include #include +#include #include namespace sophia { @@ -15,11 +16,13 @@ SceneRenderer::SceneRenderer(const SceneRegistry& sceneRegistry, spriteRenderSystem{device, colorFormat, resources} {} void SceneRenderer::beginFrame(u32 frameIndex) { + ZoneScoped; this->spriteRenderSystem.beginFrame(frameIndex); } void SceneRenderer::render(vk::CommandBuffer commandBuffer, const SceneView& sceneView, Entity camera) { + ZoneScoped; SOPHIA_ASSERT(camera.hasComponent(), "camera does not have camera component!"); diff --git a/engine/src/renderer/sprite_render_system.cpp b/engine/src/renderer/sprite_render_system.cpp index 327e717..20c9aea 100644 --- a/engine/src/renderer/sprite_render_system.cpp +++ b/engine/src/renderer/sprite_render_system.cpp @@ -2,6 +2,7 @@ #include #include +#include #include "shaders/sprite.frag.spv.h" #include "shaders/sprite.vert.spv.h" @@ -36,6 +37,7 @@ void SpriteRenderSystem::render(vk::CommandBuffer commandBuffer, const glm::mat4& viewProjection, std::span instances, std::span batches) { + ZoneScoped; if (instances.empty()) { return; } diff --git a/engine/src/resources/pools/render_target_pool.cpp b/engine/src/resources/pools/render_target_pool.cpp index fb3ee70..d34817c 100644 --- a/engine/src/resources/pools/render_target_pool.cpp +++ b/engine/src/resources/pools/render_target_pool.cpp @@ -1,5 +1,7 @@ #include "resources/pools/render_target_pool.hpp" +#include + namespace sophia { RenderTargetPool::RenderTargetPool(Device& device, vk::Format format) @@ -16,6 +18,7 @@ void RenderTargetPool::release(RenderTargetHandle handle) { } void RenderTargetPool::applyPendingResizes() { + ZoneScoped; pool.forEach([](RenderTarget& target) { target.applyPendingResize(); }); } diff --git a/engine/src/ui/panel_registry.cpp b/engine/src/ui/panel_registry.cpp index f372ffd..22aedd0 100644 --- a/engine/src/ui/panel_registry.cpp +++ b/engine/src/ui/panel_registry.cpp @@ -1,4 +1,5 @@ #include +#include namespace sophia { @@ -13,6 +14,7 @@ u32 PanelRegistry::visibleCount() const { } void PanelRegistry::update(const FrameInfo& frameInfo) { + ZoneScoped; pool.forEach([&frameInfo](Panel& panel) { if (panel.isVisible()) { panel.draw(frameInfo); diff --git a/third_party/CMakeLists.txt b/third_party/CMakeLists.txt index 6c9df76..d8cb1c7 100644 --- a/third_party/CMakeLists.txt +++ b/third_party/CMakeLists.txt @@ -45,6 +45,12 @@ add_library(stb_image STATIC ) target_include_directories(stb_image PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/stb_image) +# Tracy profiler client (static). Configure with -DTRACY_ENABLE=OFF to compile +# all profiling macros out. +option(TRACY_ENABLE "Enable Tracy profiling" ON) +option(TRACY_ON_DEMAND "Only collect data while the viewer is connected" ON) +add_subdirectory(tracy) + # 5. IMGUI (static) set(IMGUI_DIR ${CMAKE_CURRENT_SOURCE_DIR}/imgui) diff --git a/third_party/tracy b/third_party/tracy new file mode 160000 index 0000000..30997d5 --- /dev/null +++ b/third_party/tracy @@ -0,0 +1 @@ +Subproject commit 30997d5ca6bb632cc10807a1da8a6d3de0aeeb3c -- 2.47.3 From 9f3ad5f372361892ed348e27d6c37c48ddb49030 Mon Sep 17 00:00:00 2001 From: Caleb Burke Date: Wed, 30 Sep 2026 02:22:55 -0700 Subject: [PATCH 15/18] Adding tracy command for ease of use --- bin/dev | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/bin/dev b/bin/dev index 82b0d9d..fc9ca41 100755 --- a/bin/dev +++ b/bin/dev @@ -138,6 +138,30 @@ class DevHelper: qrenderdoc = self._find_qrenderdoc() self._exec_in_root(qrenderdoc, replace=True) + ## + # Builds the Tracy profiler (viewer) from the third_party/tracy submodule, + # then runs it. Building from the submodule keeps the viewer's version in + # sync with the client compiled into the engine. + # dev tracy [--fresh] [args...] + # Configures only when there is no build yet (or --fresh), then builds + # incrementally. Other arguments are passed through to the profiler. + def tracy(self, *args, **kwargs): + fresh = "--fresh" in args + args = [arg for arg in args if arg != "--fresh"] + + source_dir = os.path.join("third_party", "tracy", "profiler") + build_dir = os.path.join(source_dir, "build") + if fresh or not os.path.isfile(os.path.join(self._project_root(), build_dir, "CMakeCache.txt")): + configure = ["cmake", "-B", build_dir, "-S", source_dir, "-DCMAKE_BUILD_TYPE=Release"] + if fresh: + configure.append("--fresh") + self._run_in_root(configure) + self._run_in_root(["cmake", "--build", build_dir, "--parallel"]) + + binary = os.path.join(self._project_root(), build_dir, "tracy-profiler") + print(f"Running: {shlex.join([binary, *args])}") + os.execv(binary, [binary, *args]) + def shaders(self, *args, **kwargs): shaders_dir = os.path.join(self._project_root(), "engine", "src", "shaders") if not os.path.isdir(shaders_dir): -- 2.47.3 From 7d87503eba4852e6ac8279d497f9fde7c2a28211 Mon Sep 17 00:00:00 2001 From: Caleb Burke Date: Wed, 30 Sep 2026 02:42:45 -0700 Subject: [PATCH 16/18] restructuing dev command --- .gitignore | 7 + bin/dev | 281 ++------------------------------------- bin/helpers/gitea.py | 156 ++++++++++++++++++++++ bin/helpers/renderdoc.py | 16 +++ bin/helpers/shaders.py | 92 +++++++++++++ bin/helpers/tracy.py | 85 ++++++++++++ 6 files changed, 365 insertions(+), 272 deletions(-) create mode 100644 bin/helpers/gitea.py create mode 100644 bin/helpers/renderdoc.py create mode 100644 bin/helpers/shaders.py create mode 100644 bin/helpers/tracy.py diff --git a/.gitignore b/.gitignore index 02d09c9..d3eb7d1 100644 --- a/.gitignore +++ b/.gitignore @@ -32,6 +32,13 @@ pids *.pid.lock imgui.ini +# Python bytecode (bin/dev and bin/dev_commands) +__pycache__/ + +# Tracy captures +traces/ +*.tracy + # dotenv environment variables file .envrc .env diff --git a/bin/dev b/bin/dev index fc9ca41..ccd8c2c 100755 --- a/bin/dev +++ b/bin/dev @@ -2,13 +2,16 @@ import json import os -import re import shlex import shutil -import struct import subprocess import sys +from helpers.gitea import GiteaCommand +from helpers.renderdoc import RenderDocCommand +from helpers.shaders import ShadersCommand +from helpers.tracy import TracyCommand + COMMAND_TO_METHOD = { "branch-from": "branch_from", "bash-completions": "bash_completions", @@ -17,8 +20,7 @@ METHOD_TO_COMMAND = {method: command for command, method in COMMAND_TO_METHOD.it WAIT_FOR_PROCESS = "wait_for_process" -class DevHelper: - SHADER_EXTENSIONS = (".vert", ".frag", ".comp", ".geom", ".tesc", ".tese") +class DevCommand(GiteaCommand, RenderDocCommand, ShadersCommand, TracyCommand): PROJECT_NAME = "sophia" DEFAULT_PRESET = "debug" @@ -78,111 +80,6 @@ class DevHelper: os.chdir(preset_dir) os.execv(binary, [binary, *args]) - ## - # Checks out a branch named after a Gitea issue URL. - # If the issue is from this project's repo, the branch name will be: - # issue-/ - # If the issue is from another repo (presumably upstream), the branch name will be: - # -issue-/ - def branch_from(self, *args, **kwargs): - issue_url = args[0] if args else None - if issue_url is None: - raise ValueError("Must provide a Gitea issue URL.") - - base_url, issue_repo, issue_number = self._parse_issue_url(issue_url) - issue_title = self._fetch_issue_title(base_url, issue_repo, issue_number) - branch_name = self._format_branch_name(issue_repo, issue_number, issue_title) - - exists = subprocess.run( - ["git", "-C", self._project_root(), "rev-parse", "--verify", "--quiet", f"refs/heads/{branch_name}"], - stdout=subprocess.DEVNULL, - ).returncode == 0 - flag = "" if exists else "-b " - self._exec_in_root(f"git checkout {flag}{shlex.quote(branch_name)}", replace=True) - - ## - # Creates an issue on this project's Gitea repo. - # dev issue [-b|--body <text>] [-l|--label <name>]... [-a|--assignee <user>]... [-o|--open] - # The body is read from stdin if --body is not given and stdin is piped. - # Gitea's API cannot add issues to a project (only the web UI can), so the - # issue URL is printed and --open opens it in the browser to do so. - def issue(self, *args, **kwargs): - title, body, labels, assignees, open_in_browser = self._parse_issue_args(args) - - repo = self._origin_repo() - if repo is None: - raise RuntimeError("could not determine the Gitea repo from the origin remote") - - payload = {"title": title, "body": body} - if labels: - label_ids = self._fetch_label_ids(repo) - unknown = [label for label in labels if label not in label_ids] - if unknown: - raise ValueError(f"Unknown label(s): {', '.join(unknown)} (available: {', '.join(sorted(label_ids))})") - payload["labels"] = [label_ids[label] for label in labels] - if assignees: - payload["assignees"] = assignees - - issue = self._tea_api(f"repos/{repo}/issues", payload) - print(f"Created issue #{issue['number']}: {issue['title']}") - print(issue["html_url"]) - print(f"Add it to the project from the issue sidebar: Projects > {self.PROJECT_NAME}") - - if open_in_browser: - opener = shutil.which("xdg-open") or shutil.which("open") - if opener is None: - raise RuntimeError("xdg-open not found on PATH") - subprocess.Popen([opener, issue["html_url"]], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) - - def renderdoc(self, *args, **kwargs): - qrenderdoc = self._find_qrenderdoc() - self._exec_in_root(qrenderdoc, replace=True) - - ## - # Builds the Tracy profiler (viewer) from the third_party/tracy submodule, - # then runs it. Building from the submodule keeps the viewer's version in - # sync with the client compiled into the engine. - # dev tracy [--fresh] [args...] - # Configures only when there is no build yet (or --fresh), then builds - # incrementally. Other arguments are passed through to the profiler. - def tracy(self, *args, **kwargs): - fresh = "--fresh" in args - args = [arg for arg in args if arg != "--fresh"] - - source_dir = os.path.join("third_party", "tracy", "profiler") - build_dir = os.path.join(source_dir, "build") - if fresh or not os.path.isfile(os.path.join(self._project_root(), build_dir, "CMakeCache.txt")): - configure = ["cmake", "-B", build_dir, "-S", source_dir, "-DCMAKE_BUILD_TYPE=Release"] - if fresh: - configure.append("--fresh") - self._run_in_root(configure) - self._run_in_root(["cmake", "--build", build_dir, "--parallel"]) - - binary = os.path.join(self._project_root(), build_dir, "tracy-profiler") - print(f"Running: {shlex.join([binary, *args])}") - os.execv(binary, [binary, *args]) - - def shaders(self, *args, **kwargs): - shaders_dir = os.path.join(self._project_root(), "engine", "src", "shaders") - if not os.path.isdir(shaders_dir): - raise ValueError(f"Shaders directory not found: {shaders_dir}") - - glslc = self._find_glslc() - - shader_paths = sorted( - os.path.join(root, filename) - for root, _dirs, files in os.walk(shaders_dir) - for filename in files - if filename.endswith(self.SHADER_EXTENSIONS) - ) - - if not shader_paths: - print(f"No shaders found in {shaders_dir}") - return - - for shader_path in shader_paths: - self._generate_shader_header(glslc, shader_path) - # Custom helpers def ownit(self, *args, **kwargs): @@ -204,8 +101,8 @@ class DevHelper: def _commands(self): return sorted( METHOD_TO_COMMAND.get(name, name) - for name in vars(DevHelper) - if not name.startswith("_") and name != "call" and callable(getattr(DevHelper, name)) + for name in dir(DevCommand) + if not name.startswith("_") and name != "call" and callable(getattr(DevCommand, name)) ) def _parse_preset_args(self, args, command): @@ -254,166 +151,6 @@ class DevHelper: if result.returncode != 0: sys.exit(result.returncode) - def _parse_issue_url(self, url): - match = re.match(r"^(https?://[^/]+)/([^/]+)/([^/]+)/issues/(\d+)", url) - if match is None: - raise ValueError(f"Not a Gitea issue URL: {url}") - return match[1], f"{match[2]}/{match[3]}", match[4] - - def _fetch_issue_title(self, base_url, repo, issue_number): - if shutil.which("tea") is None: - raise RuntimeError("tea not found on PATH (install gitea tea and run `tea login add`)") - - endpoint = f"{base_url}/api/v1/repos/{repo}/issues/{issue_number}" - print(f"Running: tea api {endpoint}") - result = subprocess.run(["tea", "api", endpoint], stdout=subprocess.PIPE, text=True) - if result.returncode != 0: - raise RuntimeError(f"failed to fetch issue title from {endpoint}") - return json.loads(result.stdout)["title"] - - def _parse_issue_args(self, args): - title = None - body = None - labels = [] - assignees = [] - open_in_browser = False - - args = list(args) - while args: - arg = args.pop(0) - if arg in ("-b", "--body", "-l", "--label", "-a", "--assignee"): - if not args: - raise ValueError(f"{arg} requires a value") - value = args.pop(0) - if arg in ("-b", "--body"): - body = value - elif arg in ("-l", "--label"): - labels.append(value) - else: - assignees.append(value) - elif arg in ("-o", "--open"): - open_in_browser = True - elif arg.startswith("-"): - raise ValueError(f"Unknown option: {arg}") - elif title is None: - title = arg - else: - title = f"{title} {arg}" - - if not title: - raise ValueError("Must provide an issue title. Usage: dev issue <title> [-b <body>] [-l <label>]... [-a <user>]... [-o]") - if body is None: - body = "" if sys.stdin.isatty() else sys.stdin.read() - return title, body, labels, assignees, open_in_browser - - def _tea_api(self, endpoint, payload=None): - if shutil.which("tea") is None: - raise RuntimeError("tea not found on PATH (install gitea tea and run `tea login add`)") - - command = ["tea", "api", endpoint] - if payload is not None: - command += ["-d", "@-"] - print(f"Running: {' '.join(command)}") - result = subprocess.run( - command, - input=json.dumps(payload) if payload is not None else None, - stdout=subprocess.PIPE, - text=True, - ) - if result.returncode != 0: - raise RuntimeError(f"tea api request failed: {endpoint}") - return json.loads(result.stdout) - - def _fetch_label_ids(self, repo): - labels = self._tea_api(f"repos/{repo}/labels?limit=100") - return {label["name"]: label["id"] for label in labels} - - def _format_branch_name(self, issue_repo, issue_number, issue_title): - formatted_title = re.sub(r"-+", "-", re.sub(r"[^a-z0-9\-]", "", re.sub(r"\s+", "-", issue_title.lower().strip()))) - if issue_repo == self._origin_repo(): - return f"issue-{issue_number}/{formatted_title}" - issue_owner = issue_repo.split("/")[0] - return f"{issue_owner}-issue-{issue_number}/{formatted_title}" - - def _origin_repo(self): - result = subprocess.run( - ["git", "-C", self._project_root(), "remote", "get-url", "origin"], - stdout=subprocess.PIPE, - text=True, - ) - match = re.search(r"[:/]([^/:]+/[^/]+?)(?:\.git)?$", result.stdout.strip()) - return match[1] if match else None - - def _find_glslc(self): - glslc = shutil.which("glslc") - if glslc is None: - raise RuntimeError( - "glslc not found on PATH (install the Vulkan SDK)" - ) - return glslc - - def _find_qrenderdoc(self): - qrenderdoc = shutil.which("qrenderdoc") - if qrenderdoc is None: - raise RuntimeError( - "qrenderdoc not found on PATH (install RenderDoc)" - ) - return qrenderdoc - - def _generate_shader_header(self, glslc, shader_path): - relative_path = os.path.relpath(shader_path, self._project_root()) - print(f"Compiling shader: {relative_path}") - - result = subprocess.run( - [glslc, shader_path, "-o", "-"], - stdout=subprocess.PIPE, - stderr=subprocess.PIPE, - ) - if result.returncode != 0: - raise RuntimeError( - f"failed to compile {shader_path}: {result.stderr.decode()}" - ) - - spirv = result.stdout - if len(spirv) % 4 != 0: - raise RuntimeError( - f"invalid SPIR-V output for {shader_path} (size not a multiple of 4)" - ) - - word_count = len(spirv) // 4 - words = struct.unpack(f"<{word_count}I", spirv) - - filename = os.path.basename(shader_path) - variable_name = f"{filename.replace('.', '_')}_spv" - header_path = shader_path + ".spv.h" - - body_lines = [ - " " + ", ".join(f"0x{word:08x}" for word in words[i:i + 4]) + "," - for i in range(0, len(words), 4) - ] - - header = "\n".join([ - "#pragma once", - "", - "#include <array>", - "#include <cstdint>", - "", - "namespace sophia::shaders {", - "", - f"inline constexpr std::array<uint32_t, {word_count}> {variable_name} = {{", - *body_lines, - "};", - "", - "} // namespace sophia::shaders", - "", - ]) - - with open(header_path, "w") as f: - f.write(header) - - print(f"Wrote {os.path.relpath(header_path, self._project_root())} " - f"({word_count * 4} bytes)") - def _wait_for_process_with_logging(self, command): process = self._exec(command, capture=True) for line in process.stdout: @@ -457,4 +194,4 @@ class DevHelper: if __name__ == "__main__": - DevHelper().call(*sys.argv[1:]) + DevCommand().call(*sys.argv[1:]) diff --git a/bin/helpers/gitea.py b/bin/helpers/gitea.py new file mode 100644 index 0000000..fa1d087 --- /dev/null +++ b/bin/helpers/gitea.py @@ -0,0 +1,156 @@ +import json +import re +import shlex +import shutil +import subprocess +import sys + + +# Mixed into DevCommand (bin/dev), which provides PROJECT_NAME, _project_root +# and _exec_in_root. +class GiteaCommand: + ## + # Checks out a branch named after a Gitea issue URL. + # If the issue is from this project's repo, the branch name will be: + # issue-<issue_number>/<issue_title> + # If the issue is from another repo (presumably upstream), the branch name will be: + # <issue_owner>-issue-<issue_number>/<issue_title> + def branch_from(self, *args, **kwargs): + issue_url = args[0] if args else None + if issue_url is None: + raise ValueError("Must provide a Gitea issue URL.") + + base_url, issue_repo, issue_number = self._parse_issue_url(issue_url) + issue_title = self._fetch_issue_title(base_url, issue_repo, issue_number) + branch_name = self._format_branch_name(issue_repo, issue_number, issue_title) + + exists = subprocess.run( + ["git", "-C", self._project_root(), "rev-parse", "--verify", "--quiet", f"refs/heads/{branch_name}"], + stdout=subprocess.DEVNULL, + ).returncode == 0 + flag = "" if exists else "-b " + self._exec_in_root(f"git checkout {flag}{shlex.quote(branch_name)}", replace=True) + + ## + # Creates an issue on this project's Gitea repo. + # dev issue <title> [-b|--body <text>] [-l|--label <name>]... [-a|--assignee <user>]... [-o|--open] + # The body is read from stdin if --body is not given and stdin is piped. + # Gitea's API cannot add issues to a project (only the web UI can), so the + # issue URL is printed and --open opens it in the browser to do so. + def issue(self, *args, **kwargs): + title, body, labels, assignees, open_in_browser = self._parse_issue_args(args) + + repo = self._origin_repo() + if repo is None: + raise RuntimeError("could not determine the Gitea repo from the origin remote") + + payload = {"title": title, "body": body} + if labels: + label_ids = self._fetch_label_ids(repo) + unknown = [label for label in labels if label not in label_ids] + if unknown: + raise ValueError(f"Unknown label(s): {', '.join(unknown)} (available: {', '.join(sorted(label_ids))})") + payload["labels"] = [label_ids[label] for label in labels] + if assignees: + payload["assignees"] = assignees + + issue = self._tea_api(f"repos/{repo}/issues", payload) + print(f"Created issue #{issue['number']}: {issue['title']}") + print(issue["html_url"]) + print(f"Add it to the project from the issue sidebar: Projects > {self.PROJECT_NAME}") + + if open_in_browser: + opener = shutil.which("xdg-open") or shutil.which("open") + if opener is None: + raise RuntimeError("xdg-open not found on PATH") + subprocess.Popen([opener, issue["html_url"]], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) + + def _parse_issue_url(self, url): + match = re.match(r"^(https?://[^/]+)/([^/]+)/([^/]+)/issues/(\d+)", url) + if match is None: + raise ValueError(f"Not a Gitea issue URL: {url}") + return match[1], f"{match[2]}/{match[3]}", match[4] + + def _fetch_issue_title(self, base_url, repo, issue_number): + if shutil.which("tea") is None: + raise RuntimeError("tea not found on PATH (install gitea tea and run `tea login add`)") + + endpoint = f"{base_url}/api/v1/repos/{repo}/issues/{issue_number}" + print(f"Running: tea api {endpoint}") + result = subprocess.run(["tea", "api", endpoint], stdout=subprocess.PIPE, text=True) + if result.returncode != 0: + raise RuntimeError(f"failed to fetch issue title from {endpoint}") + return json.loads(result.stdout)["title"] + + def _parse_issue_args(self, args): + title = None + body = None + labels = [] + assignees = [] + open_in_browser = False + + args = list(args) + while args: + arg = args.pop(0) + if arg in ("-b", "--body", "-l", "--label", "-a", "--assignee"): + if not args: + raise ValueError(f"{arg} requires a value") + value = args.pop(0) + if arg in ("-b", "--body"): + body = value + elif arg in ("-l", "--label"): + labels.append(value) + else: + assignees.append(value) + elif arg in ("-o", "--open"): + open_in_browser = True + elif arg.startswith("-"): + raise ValueError(f"Unknown option: {arg}") + elif title is None: + title = arg + else: + title = f"{title} {arg}" + + if not title: + raise ValueError("Must provide an issue title. Usage: dev issue <title> [-b <body>] [-l <label>]... [-a <user>]... [-o]") + if body is None: + body = "" if sys.stdin.isatty() else sys.stdin.read() + return title, body, labels, assignees, open_in_browser + + def _tea_api(self, endpoint, payload=None): + if shutil.which("tea") is None: + raise RuntimeError("tea not found on PATH (install gitea tea and run `tea login add`)") + + command = ["tea", "api", endpoint] + if payload is not None: + command += ["-d", "@-"] + print(f"Running: {' '.join(command)}") + result = subprocess.run( + command, + input=json.dumps(payload) if payload is not None else None, + stdout=subprocess.PIPE, + text=True, + ) + if result.returncode != 0: + raise RuntimeError(f"tea api request failed: {endpoint}") + return json.loads(result.stdout) + + def _fetch_label_ids(self, repo): + labels = self._tea_api(f"repos/{repo}/labels?limit=100") + return {label["name"]: label["id"] for label in labels} + + def _format_branch_name(self, issue_repo, issue_number, issue_title): + formatted_title = re.sub(r"-+", "-", re.sub(r"[^a-z0-9\-]", "", re.sub(r"\s+", "-", issue_title.lower().strip()))) + if issue_repo == self._origin_repo(): + return f"issue-{issue_number}/{formatted_title}" + issue_owner = issue_repo.split("/")[0] + return f"{issue_owner}-issue-{issue_number}/{formatted_title}" + + def _origin_repo(self): + result = subprocess.run( + ["git", "-C", self._project_root(), "remote", "get-url", "origin"], + stdout=subprocess.PIPE, + text=True, + ) + match = re.search(r"[:/]([^/:]+/[^/]+?)(?:\.git)?$", result.stdout.strip()) + return match[1] if match else None diff --git a/bin/helpers/renderdoc.py b/bin/helpers/renderdoc.py new file mode 100644 index 0000000..973a0ef --- /dev/null +++ b/bin/helpers/renderdoc.py @@ -0,0 +1,16 @@ +import shutil + + +# Mixed into DevCommand (bin/dev), which provides _exec_in_root. +class RenderDocCommand: + def renderdoc(self, *args, **kwargs): + qrenderdoc = self._find_qrenderdoc() + self._exec_in_root(qrenderdoc, replace=True) + + def _find_qrenderdoc(self): + qrenderdoc = shutil.which("qrenderdoc") + if qrenderdoc is None: + raise RuntimeError( + "qrenderdoc not found on PATH (install RenderDoc)" + ) + return qrenderdoc diff --git a/bin/helpers/shaders.py b/bin/helpers/shaders.py new file mode 100644 index 0000000..bc11e1f --- /dev/null +++ b/bin/helpers/shaders.py @@ -0,0 +1,92 @@ +import os +import shutil +import struct +import subprocess + + +# Mixed into DevCommand (bin/dev), which provides _project_root. +class ShadersCommand: + SHADER_EXTENSIONS = (".vert", ".frag", ".comp", ".geom", ".tesc", ".tese") + + def shaders(self, *args, **kwargs): + shaders_dir = os.path.join(self._project_root(), "engine", "src", "shaders") + if not os.path.isdir(shaders_dir): + raise ValueError(f"Shaders directory not found: {shaders_dir}") + + glslc = self._find_glslc() + + shader_paths = sorted( + os.path.join(root, filename) + for root, _dirs, files in os.walk(shaders_dir) + for filename in files + if filename.endswith(self.SHADER_EXTENSIONS) + ) + + if not shader_paths: + print(f"No shaders found in {shaders_dir}") + return + + for shader_path in shader_paths: + self._generate_shader_header(glslc, shader_path) + + def _find_glslc(self): + glslc = shutil.which("glslc") + if glslc is None: + raise RuntimeError( + "glslc not found on PATH (install the Vulkan SDK)" + ) + return glslc + + def _generate_shader_header(self, glslc, shader_path): + relative_path = os.path.relpath(shader_path, self._project_root()) + print(f"Compiling shader: {relative_path}") + + result = subprocess.run( + [glslc, shader_path, "-o", "-"], + stdout=subprocess.PIPE, + stderr=subprocess.PIPE, + ) + if result.returncode != 0: + raise RuntimeError( + f"failed to compile {shader_path}: {result.stderr.decode()}" + ) + + spirv = result.stdout + if len(spirv) % 4 != 0: + raise RuntimeError( + f"invalid SPIR-V output for {shader_path} (size not a multiple of 4)" + ) + + word_count = len(spirv) // 4 + words = struct.unpack(f"<{word_count}I", spirv) + + filename = os.path.basename(shader_path) + variable_name = f"{filename.replace('.', '_')}_spv" + header_path = shader_path + ".spv.h" + + body_lines = [ + " " + ", ".join(f"0x{word:08x}" for word in words[i:i + 4]) + "," + for i in range(0, len(words), 4) + ] + + header = "\n".join([ + "#pragma once", + "", + "#include <array>", + "#include <cstdint>", + "", + "namespace sophia::shaders {", + "", + f"inline constexpr std::array<uint32_t, {word_count}> {variable_name} = {{", + *body_lines, + "};", + "", + "} // namespace sophia::shaders", + "", + ]) + + with open(header_path, "w") as f: + f.write(header) + + print(f"Wrote {os.path.relpath(header_path, self._project_root())} " + f"({word_count * 4} bytes)") diff --git a/bin/helpers/tracy.py b/bin/helpers/tracy.py new file mode 100644 index 0000000..6a819d4 --- /dev/null +++ b/bin/helpers/tracy.py @@ -0,0 +1,85 @@ +import os +import re +import shlex +import time + + +# Mixed into DevCommand (bin/dev), which provides _project_root and +# _run_in_root. +class TracyCommand: + ## + # Builds a Tracy tool from the third_party/tracy submodule, then runs it. + # Building from the submodule keeps the tool's version in sync with the + # client compiled into the engine. + # dev tracy [--fresh] [args...] Opens the profiler (viewer). + # dev tracy --save [name] [--fresh] [args...] + # Captures a trace headlessly to + # traces/<name>.tracy (default + # name: a timestamp) until the app + # exits or Ctrl+C. + # The profiler uses the X11 backend unless WAYLAND_DISPLAY is set. Tools + # are configured on first use (or --fresh, or when the backend changes), + # then built incrementally. Other arguments are passed through to the tool + # (e.g. a .tracy file to open, or `-s 10` to capture for 10 seconds). + def tracy(self, *args, **kwargs): + fresh, save, name, args = self._parse_tracy_args(args) + + if save: + binary = self._build_tracy_tool("capture", "tracy-capture", {}, fresh) + traces_dir = os.path.join(self._project_root(), "traces") + os.makedirs(traces_dir, exist_ok=True) + name = name or time.strftime("%Y-%m-%d-%H%M%S") + if not name.endswith(".tracy"): + name += ".tracy" + args = ["-o", os.path.join(traces_dir, name), *args] + else: + legacy = "OFF" if os.environ.get("WAYLAND_DISPLAY") else "ON" + binary = self._build_tracy_tool("profiler", "tracy-profiler", {"LEGACY": legacy}, fresh) + + print(f"Running: {shlex.join([binary, *args])}") + os.execv(binary, [binary, *args]) + + def _parse_tracy_args(self, args): + fresh = False + save = False + name = None + rest = [] + + args = list(args) + while args: + arg = args.pop(0) + if arg == "--fresh": + fresh = True + elif arg == "--save": + save = True + if args and not args[0].startswith("-"): + name = args.pop(0) + else: + rest.append(arg) + return fresh, save, name, rest + + # Configures third_party/tracy/<tool> into <tool>/build when it has no + # build yet, --fresh is given, or a cached define differs from `defines`. + def _build_tracy_tool(self, tool, binary_name, defines, fresh): + source_dir = os.path.join("third_party", "tracy", tool) + build_dir = os.path.join(source_dir, "build") + cache_path = os.path.join(self._project_root(), build_dir, "CMakeCache.txt") + + stale = not os.path.isfile(cache_path) + if not stale: + with open(cache_path) as f: + cache = f.read() + stale = any( + re.search(rf"^{key}:BOOL={value}$", cache, re.MULTILINE) is None + for key, value in defines.items() + ) + + if fresh or stale: + configure = ["cmake", "-B", build_dir, "-S", source_dir, "-DCMAKE_BUILD_TYPE=Release"] + configure += [f"-D{key}={value}" for key, value in defines.items()] + if fresh: + configure.append("--fresh") + self._run_in_root(configure) + self._run_in_root(["cmake", "--build", build_dir, "--parallel"]) + + return os.path.join(self._project_root(), build_dir, binary_name) -- 2.47.3 From 1ba1442cc4101d4ec754e98c41a7f413c80443be Mon Sep 17 00:00:00 2001 From: Caleb Burke <calebburke91@gmail.com> Date: Wed, 30 Sep 2026 15:51:33 -0700 Subject: [PATCH 17/18] Require GPU-driven device features Enable descriptor indexing (bindless), buffer device address, scalar block layout, indirect draw count, shader draw parameters, timeline semaphores and synchronization2 alongside dynamic rendering. A single feature list drives both physical device selection and device creation. The VMA allocator is created with buffer device address support. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- engine/src/vulkan/device.cpp | 87 +++++++++++++++++++++++++++++++++--- 1 file changed, 82 insertions(+), 5 deletions(-) diff --git a/engine/src/vulkan/device.cpp b/engine/src/vulkan/device.cpp index fe1fbaa..6b25081 100644 --- a/engine/src/vulkan/device.cpp +++ b/engine/src/vulkan/device.cpp @@ -57,6 +57,76 @@ void destroyDebugUtilsMessengerEXT(VkInstance instance, } } +using DeviceFeatureChain = vk::StructureChain< + vk::PhysicalDeviceFeatures2, vk::PhysicalDeviceVulkan11Features, + vk::PhysicalDeviceVulkan12Features, vk::PhysicalDeviceVulkan13Features>; + +// Single source of truth for the device features Sophia requires. Calls +// fn(featureRef, name) for each one, so the same list drives both the +// suitability check and device creation. +template <typename Fn> +static void forEachRequiredFeature(DeviceFeatureChain& chain, Fn&& fn) { + auto& f10 = chain.get<vk::PhysicalDeviceFeatures2>().features; + auto& f11 = chain.get<vk::PhysicalDeviceVulkan11Features>(); + auto& f12 = chain.get<vk::PhysicalDeviceVulkan12Features>(); + auto& f13 = chain.get<vk::PhysicalDeviceVulkan13Features>(); + +#define SOPHIA_FEATURE(features, name) fn(features.name, #name) + // Indirect drawing + SOPHIA_FEATURE(f10, multiDrawIndirect); + SOPHIA_FEATURE(f10, drawIndirectFirstInstance); + SOPHIA_FEATURE(f11, shaderDrawParameters); + SOPHIA_FEATURE(f12, drawIndirectCount); + + // Bindless descriptors + SOPHIA_FEATURE(f12, descriptorIndexing); + SOPHIA_FEATURE(f12, runtimeDescriptorArray); + SOPHIA_FEATURE(f12, descriptorBindingPartiallyBound); + SOPHIA_FEATURE(f12, descriptorBindingVariableDescriptorCount); + SOPHIA_FEATURE(f12, descriptorBindingUpdateUnusedWhilePending); + SOPHIA_FEATURE(f12, descriptorBindingSampledImageUpdateAfterBind); + SOPHIA_FEATURE(f12, descriptorBindingStorageImageUpdateAfterBind); + SOPHIA_FEATURE(f12, descriptorBindingStorageBufferUpdateAfterBind); + SOPHIA_FEATURE(f12, shaderSampledImageArrayNonUniformIndexing); + SOPHIA_FEATURE(f12, shaderStorageImageArrayNonUniformIndexing); + SOPHIA_FEATURE(f12, shaderStorageBufferArrayNonUniformIndexing); + + // Buffer pointers + SOPHIA_FEATURE(f12, bufferDeviceAddress); + SOPHIA_FEATURE(f12, scalarBlockLayout); + + // Synchronization + SOPHIA_FEATURE(f12, timelineSemaphore); + SOPHIA_FEATURE(f13, synchronization2); + + // Rendering + SOPHIA_FEATURE(f13, dynamicRendering); +#undef SOPHIA_FEATURE +} + +static bool checkDeviceFeatureSupport(const vk::PhysicalDevice& device) { + vk::PhysicalDeviceProperties properties = device.getProperties(); + if (properties.apiVersion < SOPHIA_VULKAN_API_VERSION) { + log::verbose("Skipping ", properties.deviceName, + ": Vulkan 1.3 not supported"); + return false; + } + + auto supported = device.getFeatures2< + vk::PhysicalDeviceFeatures2, vk::PhysicalDeviceVulkan11Features, + vk::PhysicalDeviceVulkan12Features, vk::PhysicalDeviceVulkan13Features>(); + + bool allSupported = true; + forEachRequiredFeature(supported, [&](vk::Bool32 has, const char* name) { + if (!has) { + log::verbose("Skipping ", properties.deviceName, + ": missing device feature ", name); + allSupported = false; + } + }); + return allSupported; +} + Device::Device(Window* window) : headless{window == nullptr}, enabledExtensions{headless ? std::vector<const char*>{} @@ -386,6 +456,10 @@ bool Device::isPhysicalDeviceSuitable(const vk::PhysicalDevice& device) { bool extensionsSupported = checkDeviceExtensionSupport(device); + if (!checkDeviceFeatureSupport(device)) { + return false; + } + if (this->headless) { return indices.graphicsFamily.has_value() && extensionsSupported; } @@ -443,15 +517,17 @@ void Device::createLogicalDevice() { {vk::DeviceQueueCreateFlags(), queueFamily, 1, &queuePriority}); } - vk::PhysicalDeviceVulkan13Features vulkan13Features{}; - vulkan13Features.dynamicRendering = vk::True; + DeviceFeatureChain enabledFeatures; + forEachRequiredFeature(enabledFeatures, [](vk::Bool32& feature, const char*) { + feature = vk::True; + }); - auto deviceFeatures = vk::PhysicalDeviceFeatures(); auto createInfo = vk::DeviceCreateInfo( vk::DeviceCreateFlags(), static_cast<uint32_t>(queueCreateInfos.size()), queueCreateInfos.data()); - createInfo.pEnabledFeatures = &deviceFeatures; - createInfo.pNext = &vulkan13Features; + // Core features are passed through PhysicalDeviceFeatures2 in the pNext + // chain, so pEnabledFeatures must stay null. + createInfo.pNext = &enabledFeatures.get<vk::PhysicalDeviceFeatures2>(); createInfo.enabledExtensionCount = static_cast<uint32_t>(this->enabledExtensions.size()); @@ -473,6 +549,7 @@ void Device::createLogicalDevice() { void Device::createAllocator() { VmaAllocatorCreateInfo createInfo = {}; + createInfo.flags = VMA_ALLOCATOR_CREATE_BUFFER_DEVICE_ADDRESS_BIT; createInfo.vulkanApiVersion = SOPHIA_VULKAN_API_VERSION; createInfo.instance = this->instance.get(); createInfo.physicalDevice = this->physicalDevice; -- 2.47.3 From ab7c8501212f282f9b63de6e7feebb4121952834 Mon Sep 17 00:00:00 2001 From: Caleb Burke <calebburke91@gmail.com> Date: Wed, 30 Sep 2026 15:51:33 -0700 Subject: [PATCH 18/18] Move barriers and frame submit to synchronization2 Image barriers now carry their own stage masks and are recorded with pipelineBarrier2, so barriers flushed together no longer share the union of their stages. AccessState uses the 64-bit stage and access flags, and the frame submit uses submit2. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- engine/src/renderer/render_context.cpp | 30 ++++++---- engine/src/renderer/render_graph.cpp | 9 +-- engine/src/renderer/render_graph.hpp | 4 +- engine/src/vulkan/access.cpp | 79 ++++++++++++++++---------- engine/src/vulkan/access.hpp | 24 +++++--- engine/src/vulkan/image.cpp | 5 +- 6 files changed, 87 insertions(+), 64 deletions(-) diff --git a/engine/src/renderer/render_context.cpp b/engine/src/renderer/render_context.cpp index 67a293e..73d7b51 100644 --- a/engine/src/renderer/render_context.cpp +++ b/engine/src/renderer/render_context.cpp @@ -86,22 +86,28 @@ void RenderContext::endFrame() { FrameData& frame = this->frames[this->currentFrameIndex]; frame.commandBuffer.end(); - vk::Semaphore waitSemaphore = frame.imageAvailable.get(); vk::Semaphore signalSemaphore = this->renderFinishedSemaphores.at(this->currentImageIndex).get(); - vk::PipelineStageFlags waitStage = SWAPCHAIN_ACQUIRE_STAGE; - vk::CommandBuffer commandBuffer = frame.commandBuffer; - vk::SubmitInfo submitInfo{}; - submitInfo.waitSemaphoreCount = 1; - submitInfo.pWaitSemaphores = &waitSemaphore; - submitInfo.pWaitDstStageMask = &waitStage; - submitInfo.commandBufferCount = 1; - submitInfo.pCommandBuffers = &commandBuffer; - submitInfo.signalSemaphoreCount = 1; - submitInfo.pSignalSemaphores = &signalSemaphore; + vk::SemaphoreSubmitInfo waitInfo{}; + waitInfo.semaphore = frame.imageAvailable.get(); + waitInfo.stageMask = SWAPCHAIN_ACQUIRE_STAGE; - this->device.getGraphicsQueue().submit(submitInfo, frame.inFlight.get()); + // Present has no pipeline stage to wait on, so signal once everything in + // the submission is done. + vk::SemaphoreSubmitInfo signalInfo{}; + signalInfo.semaphore = signalSemaphore; + signalInfo.stageMask = vk::PipelineStageFlagBits2::eAllCommands; + + vk::CommandBufferSubmitInfo commandBufferInfo{}; + commandBufferInfo.commandBuffer = frame.commandBuffer; + + vk::SubmitInfo2 submitInfo{}; + submitInfo.setWaitSemaphoreInfos(waitInfo); + submitInfo.setCommandBufferInfos(commandBufferInfo); + submitInfo.setSignalSemaphoreInfos(signalInfo); + + this->device.getGraphicsQueue().submit2(submitInfo, frame.inFlight.get()); vk::Result result = this->swapchain->present( this->device.getPresentQueue(), this->currentImageIndex, signalSemaphore); diff --git a/engine/src/renderer/render_graph.cpp b/engine/src/renderer/render_graph.cpp index 880dd5b..af5b978 100644 --- a/engine/src/renderer/render_graph.cpp +++ b/engine/src/renderer/render_graph.cpp @@ -55,8 +55,6 @@ void RenderGraph::transitionTo(ImageRef ref, const AccessState& next, pending.barriers.push_back(makeImageBarrier( imported.image->get(), imported.image->getSubresourceRange(), imported.state, next)); - pending.srcStages |= imported.state.stage; - pending.dstStages |= next.stage; imported.state = next; } else { // Same-layout read after read. Nothing to record, but a later write has @@ -68,12 +66,7 @@ void RenderGraph::transitionTo(ImageRef ref, const AccessState& next, void RenderGraph::flush(vk::CommandBuffer commandBuffer, PendingBarriers& pending) { - if (pending.barriers.empty()) { - return; - } - - commandBuffer.pipelineBarrier(pending.srcStages, pending.dstStages, {}, - nullptr, nullptr, pending.barriers); + recordImageBarriers(commandBuffer, pending.barriers); pending = PendingBarriers{}; } diff --git a/engine/src/renderer/render_graph.hpp b/engine/src/renderer/render_graph.hpp index ff2cd32..be2e5ef 100644 --- a/engine/src/renderer/render_graph.hpp +++ b/engine/src/renderer/render_graph.hpp @@ -104,9 +104,7 @@ class RenderGraph { }; struct PendingBarriers { - std::vector<vk::ImageMemoryBarrier> barriers; - vk::PipelineStageFlags srcStages; - vk::PipelineStageFlags dstStages; + std::vector<vk::ImageMemoryBarrier2> barriers; }; void transitionTo(ImageRef ref, const AccessState& next, diff --git a/engine/src/vulkan/access.cpp b/engine/src/vulkan/access.cpp index 640e369..027d9dc 100644 --- a/engine/src/vulkan/access.cpp +++ b/engine/src/vulkan/access.cpp @@ -14,10 +14,11 @@ constexpr std::array<Access, 7> ALL_ACCESSES = { Access::Present, }; -constexpr vk::AccessFlags WRITE_ACCESSES = - vk::AccessFlagBits::eColorAttachmentWrite | - vk::AccessFlagBits::eDepthStencilAttachmentWrite | - vk::AccessFlagBits::eShaderWrite | vk::AccessFlagBits::eTransferWrite; +constexpr vk::AccessFlags2 WRITE_ACCESSES = + vk::AccessFlagBits2::eColorAttachmentWrite | + vk::AccessFlagBits2::eDepthStencilAttachmentWrite | + vk::AccessFlagBits2::eShaderStorageWrite | + vk::AccessFlagBits2::eTransferWrite; } // namespace @@ -25,34 +26,37 @@ AccessState getAccessState(Access access) { switch (access) { case Access::ColorWrite: return {vk::ImageLayout::eColorAttachmentOptimal, - vk::PipelineStageFlagBits::eColorAttachmentOutput, - vk::AccessFlagBits::eColorAttachmentRead | - vk::AccessFlagBits::eColorAttachmentWrite}; + vk::PipelineStageFlagBits2::eColorAttachmentOutput, + vk::AccessFlagBits2::eColorAttachmentRead | + vk::AccessFlagBits2::eColorAttachmentWrite}; case Access::DepthWrite: return {vk::ImageLayout::eDepthStencilAttachmentOptimal, - vk::PipelineStageFlagBits::eEarlyFragmentTests | - vk::PipelineStageFlagBits::eLateFragmentTests, - vk::AccessFlagBits::eDepthStencilAttachmentRead | - vk::AccessFlagBits::eDepthStencilAttachmentWrite}; + vk::PipelineStageFlagBits2::eEarlyFragmentTests | + vk::PipelineStageFlagBits2::eLateFragmentTests, + vk::AccessFlagBits2::eDepthStencilAttachmentRead | + vk::AccessFlagBits2::eDepthStencilAttachmentWrite}; case Access::SampledRead: return {vk::ImageLayout::eShaderReadOnlyOptimal, - vk::PipelineStageFlagBits::eFragmentShader, - vk::AccessFlagBits::eShaderRead}; + vk::PipelineStageFlagBits2::eFragmentShader, + vk::AccessFlagBits2::eShaderSampledRead}; case Access::StorageReadWrite: - return { - vk::ImageLayout::eGeneral, vk::PipelineStageFlagBits::eComputeShader, - vk::AccessFlagBits::eShaderRead | vk::AccessFlagBits::eShaderWrite}; + return {vk::ImageLayout::eGeneral, + vk::PipelineStageFlagBits2::eComputeShader, + vk::AccessFlagBits2::eShaderStorageRead | + vk::AccessFlagBits2::eShaderStorageWrite}; case Access::TransferSrc: return {vk::ImageLayout::eTransferSrcOptimal, - vk::PipelineStageFlagBits::eTransfer, - vk::AccessFlagBits::eTransferRead}; + vk::PipelineStageFlagBits2::eTransfer, + vk::AccessFlagBits2::eTransferRead}; case Access::TransferDst: return {vk::ImageLayout::eTransferDstOptimal, - vk::PipelineStageFlagBits::eTransfer, - vk::AccessFlagBits::eTransferWrite}; + vk::PipelineStageFlagBits2::eTransfer, + vk::AccessFlagBits2::eTransferWrite}; case Access::Present: + // Presentation isn't a pipeline stage; the present waits on a semaphore + // instead, so the barrier into this state has nothing to block. return {vk::ImageLayout::ePresentSrcKHR, - vk::PipelineStageFlagBits::eBottomOfPipe, vk::AccessFlags{}}; + vk::PipelineStageFlagBits2::eNone, vk::AccessFlags2{}}; } log::fatal("Unknown Access value."); @@ -83,22 +87,37 @@ bool needsBarrier(const AccessState& from, const AccessState& to) { return from.layout != to.layout || writesImage(from) || writesImage(to); } -vk::ImageMemoryBarrier makeImageBarrier(vk::Image image, - const vk::ImageSubresourceRange& range, - const AccessState& from, - const AccessState& to) { - vk::ImageMemoryBarrier barrier{}; +vk::ImageMemoryBarrier2 makeImageBarrier(vk::Image image, + const vk::ImageSubresourceRange& range, + const AccessState& from, + const AccessState& to) { + vk::ImageMemoryBarrier2 barrier{}; + barrier.srcStageMask = from.stage; + barrier.dstStageMask = to.stage; + // Only writes need to be made available; reads just need the execution + // dependency the stage masks already give. + barrier.srcAccessMask = from.access & WRITE_ACCESSES; + barrier.dstAccessMask = to.access; barrier.oldLayout = from.layout; barrier.newLayout = to.layout; barrier.srcQueueFamilyIndex = VK_QUEUE_FAMILY_IGNORED; barrier.dstQueueFamilyIndex = VK_QUEUE_FAMILY_IGNORED; barrier.image = image; barrier.subresourceRange = range; - // Only writes need to be made available; reads just need the execution - // dependency the stage masks already give. - barrier.srcAccessMask = from.access & WRITE_ACCESSES; - barrier.dstAccessMask = to.access; return barrier; } +void recordImageBarriers( + vk::CommandBuffer commandBuffer, + vk::ArrayProxy<const vk::ImageMemoryBarrier2> barriers) { + if (barriers.empty()) { + return; + } + + vk::DependencyInfo dependency{}; + dependency.imageMemoryBarrierCount = barriers.size(); + dependency.pImageMemoryBarriers = barriers.data(); + commandBuffer.pipelineBarrier2(dependency); +} + } // namespace sophia diff --git a/engine/src/vulkan/access.hpp b/engine/src/vulkan/access.hpp index 67c35f4..3f78e67 100644 --- a/engine/src/vulkan/access.hpp +++ b/engine/src/vulkan/access.hpp @@ -25,8 +25,8 @@ enum class Access { */ struct AccessState { vk::ImageLayout layout = vk::ImageLayout::eUndefined; - vk::PipelineStageFlags stage = vk::PipelineStageFlagBits::eTopOfPipe; - vk::AccessFlags access; + vk::PipelineStageFlags2 stage = vk::PipelineStageFlagBits2::eNone; + vk::AccessFlags2 access; }; /** @@ -35,8 +35,8 @@ struct AccessState { * just-acquired state has to use this as its source stage, otherwise the * layout transition isn't ordered after the acquire. */ -inline constexpr vk::PipelineStageFlags SWAPCHAIN_ACQUIRE_STAGE = - vk::PipelineStageFlagBits::eColorAttachmentOutput; +inline constexpr vk::PipelineStageFlags2 SWAPCHAIN_ACQUIRE_STAGE = + vk::PipelineStageFlagBits2::eColorAttachmentOutput; AccessState getAccessState(Access access); @@ -55,9 +55,17 @@ bool writesImage(const AccessState& state); */ bool needsBarrier(const AccessState& from, const AccessState& to); -vk::ImageMemoryBarrier makeImageBarrier(vk::Image image, - const vk::ImageSubresourceRange& range, - const AccessState& from, - const AccessState& to); +/** + * A barrier carrying its own stage masks, for recording with + * pipelineBarrier2. Barriers flushed together don't share stages. + */ +vk::ImageMemoryBarrier2 makeImageBarrier(vk::Image image, + const vk::ImageSubresourceRange& range, + const AccessState& from, + const AccessState& to); + +void recordImageBarriers( + vk::CommandBuffer commandBuffer, + vk::ArrayProxy<const vk::ImageMemoryBarrier2> barriers); } // namespace sophia diff --git a/engine/src/vulkan/image.cpp b/engine/src/vulkan/image.cpp index 8d8b93c..d1cd9a5 100644 --- a/engine/src/vulkan/image.cpp +++ b/engine/src/vulkan/image.cpp @@ -56,10 +56,9 @@ void Image::transitionLayout(vk::CommandBuffer commandBuffer, AccessState to = getStateForLayout(newLayout); if (needsBarrier(from, to)) { - vk::ImageMemoryBarrier barrier = + vk::ImageMemoryBarrier2 barrier = makeImageBarrier(this->get(), this->getSubresourceRange(), from, to); - commandBuffer.pipelineBarrier(from.stage, to.stage, {}, nullptr, nullptr, - barrier); + recordImageBarriers(commandBuffer, barrier); } this->layout = newLayout; -- 2.47.3