From 3c384cf502cb706b62db033efe1c8f8d9295acf5 Mon Sep 17 00:00:00 2001 From: Daniel Hammer Date: Fri, 27 Feb 2026 19:01:07 +0100 Subject: [PATCH] feat: jpeg image rendering, desktop backgrounds, fix memory regression --- GNUmakefile | 1 + kernel/src/Fs/Ramdisk.hpp | 2 +- programs/GNUmakefile | 20 +- programs/include/gui/desktop.hpp | 7 + programs/include/gui/stb_image.h | 7988 +++++++++++++++++ programs/include/zenith/heap.h | 10 +- programs/lib/libjpeg/Makefile | 65 + programs/lib/libjpeg/libjpeg.a | Bin 0 -> 330158 bytes programs/lib/libjpeg/obj/stb_image_impl.o | Bin 0 -> 329520 bytes programs/lib/libjpeg/stb_image_impl.c | 30 + programs/src/desktop/Makefile | 10 +- programs/src/desktop/app_filemanager.cpp | 14 +- programs/src/desktop/app_settings.cpp | 116 +- programs/src/desktop/main.cpp | 25 +- programs/src/desktop/wallpaper.hpp | 215 + programs/src/imageviewer/Makefile | 92 + programs/src/imageviewer/main.cpp | 418 + .../src/imageviewer/stb_truetype_impl.cpp | 35 + 18 files changed, 9019 insertions(+), 29 deletions(-) create mode 100644 programs/include/gui/stb_image.h create mode 100644 programs/lib/libjpeg/Makefile create mode 100644 programs/lib/libjpeg/libjpeg.a create mode 100644 programs/lib/libjpeg/obj/stb_image_impl.o create mode 100644 programs/lib/libjpeg/stb_image_impl.c create mode 100644 programs/src/desktop/wallpaper.hpp create mode 100644 programs/src/imageviewer/Makefile create mode 100644 programs/src/imageviewer/main.cpp create mode 100644 programs/src/imageviewer/stb_truetype_impl.cpp diff --git a/GNUmakefile b/GNUmakefile index 4b1aa05..5903f97 100644 --- a/GNUmakefile +++ b/GNUmakefile @@ -33,6 +33,7 @@ run-hdd: run-hdd-$(ARCH) run-x86_64: $(IMAGE_NAME).iso sudo ./scripts/net-setup.sh qemu-system-$(ARCH) \ + -enable-kvm \ -M q35 \ -bios /usr/share/ovmf/OVMF.fd \ -cdrom $(IMAGE_NAME).iso \ diff --git a/kernel/src/Fs/Ramdisk.hpp b/kernel/src/Fs/Ramdisk.hpp index 09adf88..e1f2ca8 100644 --- a/kernel/src/Fs/Ramdisk.hpp +++ b/kernel/src/Fs/Ramdisk.hpp @@ -10,7 +10,7 @@ namespace Fs::Ramdisk { - static constexpr int MaxFiles = 128; + static constexpr int MaxFiles = 256; static constexpr int MaxNameLen = 100; struct FileEntry { diff --git a/programs/GNUmakefile b/programs/GNUmakefile index 5f5b225..e19b72b 100644 --- a/programs/GNUmakefile +++ b/programs/GNUmakefile @@ -57,7 +57,7 @@ BINDIR := bin PROGRAMS := $(notdir $(wildcard src/*)) # Programs with custom Makefiles (built separately). -CUSTOM_BUILDS := doom fetch wiki wikipedia weather desktop +CUSTOM_BUILDS := doom fetch wiki wikipedia weather imageviewer desktop SYSTEM_PROGRAMS := $(filter-out $(CUSTOM_BUILDS),$(PROGRAMS)) # Build targets: system programs go to bin/os/, games are handled separately. @@ -82,9 +82,9 @@ CA_CERTS := $(BINDIR)/etc/ca-certificates.crt # Home directory placeholder. HOMEKEEP := $(BINDIR)/home/.keep -.PHONY: all clean doom fetch wiki wikipedia weather desktop icons fonts bearssl libc tls +.PHONY: all clean doom fetch wiki wikipedia weather imageviewer desktop icons fonts bearssl libc tls libjpeg -all: bearssl libc tls $(TARGETS) fetch wiki wikipedia weather doom desktop icons fonts $(GAME_DATA) $(MANDST) $(WWWDST) $(CA_CERTS) $(HOMEKEEP) +all: bearssl libc libjpeg tls $(TARGETS) fetch wiki wikipedia weather imageviewer doom desktop icons fonts $(GAME_DATA) $(MANDST) $(WWWDST) $(CA_CERTS) $(HOMEKEEP) # Build BearSSL static library. bearssl: @@ -114,8 +114,16 @@ wikipedia: bearssl libc tls weather: bearssl libc tls $(MAKE) -C src/weather -# Build desktop via its own Makefile. -desktop: +# Build libjpeg static library (JPEG decoding via stb_image). +libjpeg: libc + $(MAKE) -C lib/libjpeg + +# Build imageviewer standalone GUI client (depends on libc and libjpeg). +imageviewer: libc libjpeg + $(MAKE) -C src/imageviewer + +# Build desktop via its own Makefile (depends on libc and libjpeg for wallpaper). +desktop: libc libjpeg $(MAKE) -C src/desktop # Copy SVG icons for the desktop into bin/icons/. @@ -165,9 +173,11 @@ clean: rm -rf $(BINDIR) obj $(MAKE) -C lib/bearssl clean $(MAKE) -C lib/libc clean + $(MAKE) -C lib/libjpeg clean $(MAKE) -C lib/tls clean $(MAKE) -C src/fetch clean $(MAKE) -C src/doom clean $(MAKE) -C src/desktop clean $(MAKE) -C src/wikipedia clean $(MAKE) -C src/weather clean + $(MAKE) -C src/imageviewer clean diff --git a/programs/include/gui/desktop.hpp b/programs/include/gui/desktop.hpp index adc39c4..d83e045 100644 --- a/programs/include/gui/desktop.hpp +++ b/programs/include/gui/desktop.hpp @@ -21,10 +21,17 @@ static constexpr int PANEL_HEIGHT = 32; struct DesktopSettings { // Background bool bg_gradient; // true = gradient, false = solid + bool bg_image; // true = JPEG wallpaper Color bg_solid; // solid background color Color bg_grad_top; // gradient top color Color bg_grad_bottom; // gradient bottom color + // Wallpaper (valid when bg_image == true) + char bg_image_path[128]; // VFS path to current wallpaper + uint32_t* bg_wallpaper; // scaled ARGB pixel buffer (screen-sized) + int bg_wallpaper_w; // scaled width + int bg_wallpaper_h; // scaled height + // Panel Color panel_color; // panel background color diff --git a/programs/include/gui/stb_image.h b/programs/include/gui/stb_image.h new file mode 100644 index 0000000..9eedabe --- /dev/null +++ b/programs/include/gui/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. +------------------------------------------------------------------------------ +*/ diff --git a/programs/include/zenith/heap.h b/programs/include/zenith/heap.h index cefd9a9..3f6e7e7 100644 --- a/programs/include/zenith/heap.h +++ b/programs/include/zenith/heap.h @@ -39,13 +39,14 @@ namespace heap_detail { g_head.next = node; } - static inline void grow(uint64_t bytes) { + static inline bool grow(uint64_t bytes) { uint64_t pages = (bytes + 0xFFF) / 0x1000; if (pages < 4) pages = 4; // grow at least 16 KiB at a time void* mem = zenith::alloc(pages * 0x1000); - if (mem != nullptr) - insert_free(mem, pages * 0x1000); + if (mem == nullptr) return false; + insert_free(mem, pages * 0x1000); + return true; } } // namespace heap_detail @@ -93,7 +94,8 @@ namespace heap_detail { } // No fit — grow and retry - grow(needed); + if (!grow(needed)) + return nullptr; return malloc(size); } diff --git a/programs/lib/libjpeg/Makefile b/programs/lib/libjpeg/Makefile new file mode 100644 index 0000000..c52b694 --- /dev/null +++ b/programs/lib/libjpeg/Makefile @@ -0,0 +1,65 @@ +# Makefile for libjpeg (JPEG decoding via stb_image) on ZenithOS +# Copyright (c) 2026 Daniel Hammer + +MAKEFLAGS += -rR +.SUFFIXES: + +# ---- Toolchain ---- + +TOOLCHAIN_PREFIX := $(shell cd ../../.. && pwd)/toolchain/local/bin/x86_64-elf- +ifneq ($(wildcard $(TOOLCHAIN_PREFIX)gcc),) + CC := $(TOOLCHAIN_PREFIX)gcc + AR := $(TOOLCHAIN_PREFIX)ar +else + CC := gcc + AR := ar +endif + +# ---- Paths ---- + +LIBC_INC := ../../include/libc +PROG_INC := ../../include +OBJDIR := obj + +# ---- Compiler flags ---- + +CFLAGS := \ + -std=gnu11 \ + -g -O2 -pipe \ + -Wall \ + -Wno-unused-parameter \ + -Wno-unused-function \ + -nostdinc \ + -ffreestanding \ + -fno-stack-protector \ + -fno-stack-check \ + -fno-PIC \ + -ffunction-sections \ + -fdata-sections \ + -m64 \ + -march=x86-64 \ + -msse \ + -msse2 \ + -mno-red-zone \ + -mcmodel=small \ + -I $(PROG_INC) \ + -isystem $(LIBC_INC) \ + -isystem $(shell $(CC) -print-file-name=include) + +# ---- Target ---- + +TARGET := libjpeg.a + +.PHONY: all clean + +all: $(TARGET) + +$(TARGET): $(OBJDIR)/stb_image_impl.o + $(AR) rcs $@ $^ + +$(OBJDIR)/stb_image_impl.o: stb_image_impl.c Makefile + @mkdir -p $(OBJDIR) + $(CC) $(CFLAGS) -c $< -o $@ + +clean: + rm -rf $(OBJDIR) $(TARGET) diff --git a/programs/lib/libjpeg/libjpeg.a b/programs/lib/libjpeg/libjpeg.a new file mode 100644 index 0000000000000000000000000000000000000000..a1713dfd246ed4d1b98bfc4a8d0736a8969e326a GIT binary patch literal 330158 zcmeEvdwdkt+5b#-$%bS%6E22;Tp~mzfRYF*5l{wpaaT8r0$z&{LIROXFc$$82yPZK z4htw~tyODVZEfFL^sS_L!(BiUP%%J7tgQknu*M5`fe<12eV=n?cF*RD?fdrk`{Oqs zGJ7u1dCqg5=Q+=L&NF9*3&!M?*{m3`%vmtB^fHF9KDdOH5$67T8hBS&0j zG?n`3vV=T0A^)I9Ci4Bwf^;?5r%* zM($T!F)}@U#AP{`U&h+ZNL=pnPK=XfC=kD7>1rvOGfO2Y>kDfnGmfRkNo7*0q-u@X z&8oIX)oPtuUDxA_NBU2eUA4Knxp{f^-cwC#&er7vUH+Ym`@Kn6%TkRRr?v;pPMuaZ z?#>A<8=^IAQwCHJTL0d~-*T8{XJ#V$|y0y>M zDc->BQIp-;kNT}6z1k7CzI<@=#WwZeLJ#=Y+}+dbMB-evj4&WPJ!(vo~N*cKL(L zd$@f&WT#x?&DmZ4jaRE9`f~FRm7rV8(s@0ZeXxUg&z-32BTws3}`pFJP zDwy1eU06e%3lJPQ#+(;b=n7+A#L?~FRDHH?_qz0dIy3aS6D8 zN>bIf(r~nQ0t=f9wU@7N!a$Vjml=AuFC^zQmHh*=Yu^_x|6Zl?2FxqQm++@e&CRb$ zam1ldwlssz8lM})p}zSTa-i}|_Fnasu1InTx%{7%pC4Y1yhz?UHdye#NU7$`^fh!{ z{)JQd>xRjM9qe&w+qC_eA$8wjb>FAC`FlP2Z+qoE*9ELS-13JWZI>r=tLi%}mz`IY z!nL}#?2l3Tj;qQ-Y23J~g-juj*RNsv5*`NnK?}wjk16EVK2Wutfu7@(YMZ>(cUo2| zOTmbMr`dO?L0PjLY4x=PDFKo$RKEGFP*oPx7b*+ClGc5vEbAGMo7Lu2s;Afz3Y8gu z!{7EorTE)I<(`vqh059E$b4L=oc=rh_9G2zQv7zIQrdvZd%nYM`&Q5~B_55>{uAXN zQlo8wo;TxXt5eQr?KEWq2U@3d8^d=<6XLEv`hA6IjN%9D>4L#KrXF!v3ZPETh+PEFpTAID`duq;cW$kPi?Gsv%1%wHsxg(q452vcm_K9gYQzf+;xafME$crV>P zVyf#>iffUZQAdhz0cxg(-)yC_1FQv+_4(V#e-4F4g)*ZSEo%yu&!M!R??x>&8SM^P zac9Z105Y=M&~EllWDi2GXKx2^@g9H`?__-zDsyTnN4*tc8svqXO1CMiQj~7iRiy4% zcND)1jMM7ep(9;<2OF>iT$zrV@Hc0pibHI{HFYyLVxPNxUoHfRH_yOrd^&I!k6%dl z>#|S);)|%i;=3mycSj0(rHOd3Q2F6P!a`N2QE-C8{@|cOC9~i-@&mzuAOL zF6Y0+$CS+6IsjZZ4!6I#^Y=TI%%$rHRTCyUMt1rTN0;{n`g;fI9}1Nca7-ya26|9f za)dI#QH04tjN@h7pJMR!~1b_;(D?S74tPr>RwLkf?u#k{E+iX)3Ry`=_}5(1rKj1cSWb02U`%rc#a@ zDBpu7e+2C|*ba;bsiyT8+W^pF*Kw*pMM*B!ZwS{`g2X&++DAFec8m}u(3HlhxHbKV zKgbKTq1|o>?i6aypx}F?4+FIEJ=~f;Lv`a@klxWmlz)jol6T|Zs8zu;1o0{5!ET}x zLZ;hibmPQ>VrA~S70!kE(A-=QA$3g{@zEn_-owe68rP8KthXwXgj(mb`-yh#Me{>OOZz^ zc!FB�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%0A71)MB1og`^v8TX2_qixG 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

Jp#mg- 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 C)$-c_ literal 0 HcmV?d00001 diff --git a/programs/lib/libjpeg/stb_image_impl.c b/programs/lib/libjpeg/stb_image_impl.c new file mode 100644 index 0000000..e996aa4 --- /dev/null +++ b/programs/lib/libjpeg/stb_image_impl.c @@ -0,0 +1,30 @@ +/* + * stb_image_impl.c + * Single compilation unit for stb_image JPEG decoder on ZenithOS + * Copyright (c) 2026 Daniel Hammer + */ + +#include +#include + +/* Only enable JPEG; disable everything else. */ +#define STBI_ONLY_JPEG +#define STBI_NO_PNG +#define STBI_NO_BMP +#define STBI_NO_PSD +#define STBI_NO_TGA +#define STBI_NO_GIF +#define STBI_NO_HDR +#define STBI_NO_PIC +#define STBI_NO_PNM +#define STBI_NO_LINEAR +#define STBI_NO_STDIO +#define STBI_NO_THREAD_LOCALS + +/* Route allocations through libc (which uses ZenithOS heap). */ +#define STBI_MALLOC(sz) malloc(sz) +#define STBI_FREE(p) free(p) +#define STBI_REALLOC(p, newsz) realloc(p, newsz) + +#define STB_IMAGE_IMPLEMENTATION +#include diff --git a/programs/src/desktop/Makefile b/programs/src/desktop/Makefile index 6a3b409..25b5e3e 100644 --- a/programs/src/desktop/Makefile +++ b/programs/src/desktop/Makefile @@ -16,6 +16,8 @@ endif # ---- Paths ---- PROG_INC := ../../include +JPEG_LIB := ../../lib/libjpeg +LIBC_LIB := ../../lib/libc LINK_LD := ../../link.ld BINDIR := ../../bin OBJDIR := obj @@ -72,9 +74,13 @@ TARGET := $(BINDIR)/os/desktop.elf all: $(TARGET) -$(TARGET): $(OBJS) $(LINK_LD) Makefile +# ---- Libraries ---- + +LIBS := $(JPEG_LIB)/libjpeg.a $(LIBC_LIB)/liblibc.a + +$(TARGET): $(OBJS) $(LIBS) $(LINK_LD) Makefile mkdir -p $(BINDIR)/os - $(CXX) $(CXXFLAGS) $(LDFLAGS) $(OBJS) -o $@ + $(CXX) $(CXXFLAGS) $(LDFLAGS) $(OBJS) $(LIBS) -o $@ # C++ sources $(OBJDIR)/%.o: %.cpp Makefile diff --git a/programs/src/desktop/app_filemanager.cpp b/programs/src/desktop/app_filemanager.cpp index b50e5c7..cb48129 100644 --- a/programs/src/desktop/app_filemanager.cpp +++ b/programs/src/desktop/app_filemanager.cpp @@ -57,6 +57,10 @@ static bool str_ends_with(const char* s, const char* suffix) { return true; } +static bool is_image_file(const char* name) { + return str_ends_with(name, ".jpg") || str_ends_with(name, ".jpeg"); +} + static int detect_file_type(const char* name, bool is_dir) { if (is_dir) return 1; if (str_ends_with(name, ".elf")) return 2; @@ -545,7 +549,9 @@ static void filemanager_on_mouse(Window* win, MouseEvent& ev) { str_append(fullpath, "/", 512); } str_append(fullpath, fm->entry_names[clicked_idx], 512); - if (fm->desktop) { + if (is_image_file(fm->entry_names[clicked_idx])) { + zenith::spawn("0:/os/imageviewer.elf", fullpath); + } else if (fm->desktop) { open_texteditor_with_file(fm->desktop, fullpath); } } @@ -574,7 +580,7 @@ static void filemanager_on_mouse(Window* win, MouseEvent& ev) { if (fm->is_dir[clicked_idx]) { filemanager_navigate(fm, fm->entry_names[clicked_idx]); } else { - // Open file in text editor + // Open file in appropriate viewer char fullpath[512]; zenith::strcpy(fullpath, fm->current_path); int plen = zenith::slen(fullpath); @@ -582,7 +588,9 @@ static void filemanager_on_mouse(Window* win, MouseEvent& ev) { str_append(fullpath, "/", 512); } str_append(fullpath, fm->entry_names[clicked_idx], 512); - if (fm->desktop) { + if (is_image_file(fm->entry_names[clicked_idx])) { + zenith::spawn("0:/os/imageviewer.elf", fullpath); + } else if (fm->desktop) { open_texteditor_with_file(fm->desktop, fullpath); } } diff --git a/programs/src/desktop/app_settings.cpp b/programs/src/desktop/app_settings.cpp index ce79825..6afdc16 100644 --- a/programs/src/desktop/app_settings.cpp +++ b/programs/src/desktop/app_settings.cpp @@ -5,6 +5,7 @@ */ #include "apps_common.hpp" +#include "wallpaper.hpp" // ============================================================================ // Settings state @@ -15,6 +16,8 @@ struct SettingsState { int active_tab; // 0=Appearance, 1=Display, 2=About Zenith::SysInfo sys_info; uint64_t uptime_ms; + WallpaperFileList wp_files; + bool wp_scanned; }; // ============================================================================ @@ -130,9 +133,12 @@ static void draw_toggle_btn(Canvas& c, int x, int y, int bw, int bh, c.text(x + (bw - tw) / 2, y + (bh - fh) / 2, label, fg); } +static constexpr int WP_ITEM_H = 24; + static void settings_draw_appearance(Canvas& c, SettingsState* st) { DesktopSettings& s = st->desktop->settings; Color accent = s.accent_color; + Color dim = Color::from_rgb(0x88, 0x88, 0x88); int x = 16; int y = 12; int sfh = system_font_height(); @@ -142,27 +148,80 @@ static void settings_draw_appearance(Canvas& c, SettingsState* st) { c.text(x, y, "Background", colors::TEXT_COLOR); y += line_h; - // Radio buttons: Gradient / Solid - draw_radio(c, x, y, s.bg_gradient, accent); + // Radio buttons: Gradient / Solid Color / Image + bool mode_grad = s.bg_gradient && !s.bg_image; + bool mode_solid = !s.bg_gradient && !s.bg_image; + bool mode_image = s.bg_image; + + draw_radio(c, x, y, mode_grad, accent); c.text(x + 20, y + 2, "Gradient", colors::TEXT_COLOR); - draw_radio(c, x + 120, y, !s.bg_gradient, accent); - c.text(x + 140, y + 2, "Solid Color", colors::TEXT_COLOR); + draw_radio(c, x + 120, y, mode_solid, accent); + c.text(x + 140, y + 2, "Solid", colors::TEXT_COLOR); + + draw_radio(c, x + 220, y, mode_image, accent); + c.text(x + 240, y + 2, "Image", colors::TEXT_COLOR); y += line_h + 4; - if (s.bg_gradient) { + if (mode_image) { + // Scan for images lazily + if (!st->wp_scanned) { + wallpaper_scan_dir("0:/home", &st->wp_files); + st->wp_scanned = true; + } + + c.text(x, y, "Images in 0:/home/", dim); + y += sfh + 6; + + if (st->wp_files.count == 0) { + c.text(x + 8, y, "No .jpg files found", dim); + y += WP_ITEM_H; + } else { + for (int i = 0; i < st->wp_files.count && i < 8; i++) { + // Build full path for comparison + char fullpath[256]; + zenith::strcpy(fullpath, "0:/home/"); + str_append(fullpath, st->wp_files.names[i], 256); + + bool selected = s.bg_image && + zenith::streq(s.bg_image_path, fullpath); + + if (selected) { + c.fill_rounded_rect(x, y, c.w - 2 * x, WP_ITEM_H, 3, accent); + } + + // Truncate long filenames + char label[40]; + int nlen = zenith::slen(st->wp_files.names[i]); + if (nlen > 35) { + zenith::strncpy(label, st->wp_files.names[i], 32); + label[32] = '.'; + label[33] = '.'; + label[34] = '.'; + label[35] = '\0'; + } else { + zenith::strncpy(label, st->wp_files.names[i], 39); + } + + Color tc = selected ? colors::WHITE : colors::TEXT_COLOR; + c.text(x + 8, y + (WP_ITEM_H - sfh) / 2, label, tc); + y += WP_ITEM_H; + } + } + y += 6; + } else if (mode_grad) { // Top color swatches - c.text(x, y + 4, "Top", Color::from_rgb(0x88, 0x88, 0x88)); + c.text(x, y + 4, "Top", dim); draw_swatch_row(c, x + 70, y, bg_palette, s.bg_grad_top, accent); y += SWATCH_SIZE + 14; // Bottom color swatches - c.text(x, y + 4, "Bottom", Color::from_rgb(0x88, 0x88, 0x88)); + c.text(x, y + 4, "Bottom", dim); draw_swatch_row(c, x + 70, y, bg_palette, s.bg_grad_bottom, accent); y += SWATCH_SIZE + 14; } else { // Solid color swatches - c.text(x, y + 4, "Color", Color::from_rgb(0x88, 0x88, 0x88)); + c.text(x, y + 4, "Color", dim); draw_swatch_row(c, x + 70, y, bg_palette, s.bg_solid, accent); y += SWATCH_SIZE + 14; } @@ -363,23 +422,58 @@ static void settings_on_mouse(Window* win, MouseEvent& ev) { int line_h = sfh + 10; int y = 12; + bool mode_grad = s.bg_gradient && !s.bg_image; + bool mode_image = s.bg_image; + // "Background" label y += line_h; // Radio: Gradient if (mx >= x && mx < x + 100 && cy >= y && cy < y + 16) { s.bg_gradient = true; + s.bg_image = false; return; } // Radio: Solid - if (mx >= x + 120 && mx < x + 260 && cy >= y && cy < y + 16) { + if (mx >= x + 120 && mx < x + 210 && cy >= y && cy < y + 16) { s.bg_gradient = false; + s.bg_image = false; + return; + } + // Radio: Image + if (mx >= x + 220 && mx < x + 320 && cy >= y && cy < y + 16) { + s.bg_image = true; + s.bg_gradient = false; + if (!st->wp_scanned) { + wallpaper_scan_dir("0:/home", &st->wp_files); + st->wp_scanned = true; + } return; } y += line_h + 4; int idx; - if (s.bg_gradient) { + if (mode_image) { + // "Images in 0:/home/" label + y += sfh + 6; + + // File list clicks + for (int i = 0; i < st->wp_files.count && i < 8; i++) { + if (cy >= y && cy < y + WP_ITEM_H && + mx >= x && mx < win->content_w - x) { + // Build full path and load wallpaper + char fullpath[256]; + zenith::strcpy(fullpath, "0:/home/"); + str_append(fullpath, st->wp_files.names[i], 256); + wallpaper_load(&s, fullpath, + st->desktop->screen_w, st->desktop->screen_h); + return; + } + y += WP_ITEM_H; + } + if (st->wp_files.count == 0) y += WP_ITEM_H; + y += 6; + } else if (mode_grad) { // Top swatches if (swatch_hit(mx, cy, x + 70, y, &idx)) { s.bg_grad_top = bg_palette[idx]; @@ -504,6 +598,8 @@ void open_settings(DesktopState* ds) { st->active_tab = 0; zenith::get_info(&st->sys_info); st->uptime_ms = zenith::get_milliseconds(); + st->wp_scanned = false; + st->wp_files.count = 0; win->app_data = st; win->on_draw = settings_on_draw; diff --git a/programs/src/desktop/main.cpp b/programs/src/desktop/main.cpp index 8075563..2dbeade 100644 --- a/programs/src/desktop/main.cpp +++ b/programs/src/desktop/main.cpp @@ -5,6 +5,7 @@ */ #include "apps_common.hpp" +#include "wallpaper.hpp" // ============================================================================ // Desktop Implementation @@ -71,14 +72,23 @@ void gui::desktop_init(DesktopState* ds) { // Settings defaults ds->settings.bg_gradient = true; + ds->settings.bg_image = false; ds->settings.bg_grad_top = Color::from_rgb(0xD0, 0xD8, 0xE8); ds->settings.bg_grad_bottom = Color::from_rgb(0xA0, 0xA8, 0xB8); ds->settings.bg_solid = Color::from_rgb(0xD0, 0xD8, 0xE8); - ds->settings.panel_color = colors::PANEL_BG; + ds->settings.bg_image_path[0] = '\0'; + ds->settings.bg_wallpaper = nullptr; + ds->settings.bg_wallpaper_w = 0; + ds->settings.bg_wallpaper_h = 0; + ds->settings.panel_color = Color::from_rgb(0x10, 0x10, 0x10); ds->settings.accent_color = colors::ACCENT; ds->settings.show_shadows = true; ds->settings.clock_24h = true; ds->settings.ui_scale = 1; + + // Try to load default wallpaper + wallpaper_load(&ds->settings, "0:/home/troy-olson-MhYIwOiyZpM-unsplash.jpg", + ds->screen_w, ds->screen_h); zenith::win_setscale(1); ds->ctx_menu_open = false; @@ -299,8 +309,10 @@ void gui::desktop_draw_panel(DesktopState* ds) { fb.fill_rect(0, y, sw, 1, Color::from_rgb(r, g, b)); } - // Bottom highlight line - fb.fill_rect(0, PANEL_HEIGHT - 1, sw, 1, Color::from_rgba(0xFF, 0xFF, 0xFF, 0x10)); + // Bottom highlight line (skip when wallpaper is set — the white bleeds through) + if (!ds->settings.bg_image) { + fb.fill_rect(0, PANEL_HEIGHT - 1, sw, 1, Color::from_rgba(0xFF, 0xFF, 0xFF, 0x10)); + } // App menu button (left side) int btn_x = 4; @@ -880,7 +892,12 @@ void gui::desktop_compose(DesktopState* ds) { for (int y = 0; y < sh; y++) { uint32_t* row = (uint32_t*)((uint8_t*)buf + y * pitch); - if (y < grad_start) { + if (ds->settings.bg_image && ds->settings.bg_wallpaper) { + // Wallpaper covers the entire screen; panel draws on top + uint32_t* wp = ds->settings.bg_wallpaper + y * ds->settings.bg_wallpaper_w; + int cw = sw < ds->settings.bg_wallpaper_w ? sw : ds->settings.bg_wallpaper_w; + for (int x = 0; x < cw; x++) row[x] = wp[x]; + } else if (y < grad_start) { // Panel area - will be overwritten by panel drawing uint32_t px = ds->settings.panel_color.to_pixel(); for (int x = 0; x < sw; x++) row[x] = px; diff --git a/programs/src/desktop/wallpaper.hpp b/programs/src/desktop/wallpaper.hpp new file mode 100644 index 0000000..2ad67b9 --- /dev/null +++ b/programs/src/desktop/wallpaper.hpp @@ -0,0 +1,215 @@ +/* + * wallpaper.hpp + * ZenithOS Desktop - JPEG wallpaper loading, scaling, and directory scanning + * Copyright (c) 2026 Daniel Hammer +*/ + +#pragma once + +#include +#include +#include +#include +#include + +// Forward-declare stb_image functions (implementation in libjpeg.a). +// We avoid including stb_image.h directly because its declaration section +// pulls in which is unavailable in the desktop's freestanding build. +extern "C" { + unsigned char* stbi_load_from_memory(const unsigned char* buffer, int len, + int* x, int* y, int* channels_in_file, + int desired_channels); + void stbi_image_free(void* retval_from_stbi_load); + const char* stbi_failure_reason(void); +} + +namespace gui { + +// ============================================================================ +// Wallpaper loading +// ============================================================================ + +// Load a JPEG file and scale it to cover the given screen dimensions. +// Stores the scaled ARGB pixel buffer in settings. Returns true on success. +inline bool wallpaper_load(DesktopSettings* s, const char* path, + int screen_w, int screen_h) { + // Free existing wallpaper + if (s->bg_wallpaper) { + zenith::mfree(s->bg_wallpaper); + s->bg_wallpaper = nullptr; + s->bg_wallpaper_w = 0; + s->bg_wallpaper_h = 0; + } + + // Read file + int fd = zenith::open(path); + if (fd < 0) return false; + + uint64_t size = zenith::getsize(fd); + if (size == 0 || size > 16 * 1024 * 1024) { + zenith::close(fd); + return false; + } + + uint8_t* filedata = (uint8_t*)zenith::malloc(size); + if (!filedata) { zenith::close(fd); return false; } + + int bytes_read = zenith::read(fd, filedata, 0, size); + zenith::close(fd); + if (bytes_read <= 0) { zenith::mfree(filedata); return false; } + + // Decode JPEG + int img_w, img_h, channels; + unsigned char* rgb = stbi_load_from_memory(filedata, bytes_read, + &img_w, &img_h, &channels, 3); + zenith::mfree(filedata); + if (!rgb) return false; + + // Scale to cover screen (crop to fill, maintain aspect ratio) + int dst_w = screen_w; + int dst_h = screen_h; + + uint32_t* scaled = (uint32_t*)zenith::malloc((uint64_t)dst_w * dst_h * 4); + if (!scaled) { stbi_image_free(rgb); return false; } + + // Compute source crop region for "cover" scaling + int src_crop_w, src_crop_h, src_x0, src_y0; + if ((int64_t)img_w * dst_h > (int64_t)img_h * dst_w) { + // Image is wider — crop sides + src_crop_h = img_h; + src_crop_w = (int)((int64_t)img_h * dst_w / dst_h); + src_x0 = (img_w - src_crop_w) / 2; + src_y0 = 0; + } else { + // Image is taller — crop top/bottom + src_crop_w = img_w; + src_crop_h = (int)((int64_t)img_w * dst_h / dst_w); + src_x0 = 0; + src_y0 = (img_h - src_crop_h) / 2; + } + + // Nearest-neighbor scale from cropped region to destination + for (int y = 0; y < dst_h; y++) { + int sy = src_y0 + (int)((int64_t)y * src_crop_h / dst_h); + if (sy < 0) sy = 0; + if (sy >= img_h) sy = img_h - 1; + for (int x = 0; x < dst_w; x++) { + int sx = src_x0 + (int)((int64_t)x * src_crop_w / dst_w); + if (sx < 0) sx = 0; + if (sx >= img_w) sx = img_w - 1; + int si = (sy * img_w + sx) * 3; + scaled[y * dst_w + x] = 0xFF000000u + | ((uint32_t)rgb[si] << 16) + | ((uint32_t)rgb[si + 1] << 8) + | (uint32_t)rgb[si + 2]; + } + } + + stbi_image_free(rgb); + + s->bg_wallpaper = scaled; + s->bg_wallpaper_w = dst_w; + s->bg_wallpaper_h = dst_h; + zenith::strncpy(s->bg_image_path, path, 127); + s->bg_image = true; + s->bg_gradient = false; + + return true; +} + +inline void wallpaper_free(DesktopSettings* s) { + if (s->bg_wallpaper) { + zenith::mfree(s->bg_wallpaper); + s->bg_wallpaper = nullptr; + s->bg_wallpaper_w = 0; + s->bg_wallpaper_h = 0; + } + s->bg_image_path[0] = '\0'; + s->bg_image = false; +} + +// ============================================================================ +// Directory scanning for JPEG files +// ============================================================================ + +static constexpr int WALLPAPER_MAX_FILES = 16; + +struct WallpaperFileList { + char names[WALLPAPER_MAX_FILES][64]; + int count; +}; + +inline void wallpaper_scan_dir(const char* dir_path, WallpaperFileList* list) { + list->count = 0; + + const char* raw_names[64]; + int total = zenith::readdir(dir_path, raw_names, 64); + if (total <= 0) return; + + // Compute prefix to strip (readdir returns full paths from VFS root) + const char* after_drive = dir_path; + for (int k = 0; after_drive[k]; k++) { + if (after_drive[k] == ':' && after_drive[k + 1] == '/') { + after_drive += k + 2; + break; + } + } + char prefix[256] = {0}; + int prefix_len = 0; + if (after_drive[0] != '\0') { + zenith::strcpy(prefix, after_drive); + prefix_len = zenith::slen(prefix); + if (prefix_len > 0 && prefix[prefix_len - 1] != '/') { + prefix[prefix_len++] = '/'; + prefix[prefix_len] = '\0'; + } + } + + auto to_lower = [](char c) -> char { + return (c >= 'A' && c <= 'Z') ? (char)(c + 32) : c; + }; + + for (int i = 0; i < total && list->count < WALLPAPER_MAX_FILES; i++) { + const char* name = raw_names[i]; + + // Strip prefix + if (prefix_len > 0) { + bool match = true; + for (int k = 0; k < prefix_len; k++) { + if (name[k] != prefix[k]) { match = false; break; } + } + if (match) name += prefix_len; + } + + int nlen = zenith::slen(name); + + // Skip directories + if (nlen > 0 && name[nlen - 1] == '/') continue; + + // Check for .jpg + bool is_jpeg = false; + if (nlen >= 4 && + to_lower(name[nlen - 4]) == '.' && + to_lower(name[nlen - 3]) == 'j' && + to_lower(name[nlen - 2]) == 'p' && + to_lower(name[nlen - 1]) == 'g') { + is_jpeg = true; + } + // Check for .jpeg + if (!is_jpeg && nlen >= 5 && + to_lower(name[nlen - 5]) == '.' && + to_lower(name[nlen - 4]) == 'j' && + to_lower(name[nlen - 3]) == 'p' && + to_lower(name[nlen - 2]) == 'e' && + to_lower(name[nlen - 1]) == 'g') { + is_jpeg = true; + } + + if (is_jpeg) { + zenith::strncpy(list->names[list->count], name, 63); + list->count++; + } + } +} + +} // namespace gui diff --git a/programs/src/imageviewer/Makefile b/programs/src/imageviewer/Makefile new file mode 100644 index 0000000..058efdf --- /dev/null +++ b/programs/src/imageviewer/Makefile @@ -0,0 +1,92 @@ +# Makefile for imageviewer (standalone JPEG viewer) on ZenithOS +# Copyright (c) 2026 Daniel Hammer + +MAKEFLAGS += -rR +.SUFFIXES: + +# ---- Toolchain ---- + +TOOLCHAIN_PREFIX := $(shell cd ../../.. && pwd)/toolchain/local/bin/x86_64-elf- +ifneq ($(wildcard $(TOOLCHAIN_PREFIX)gcc),) + CXX := $(TOOLCHAIN_PREFIX)g++ +else + CXX := g++ +endif + +# ---- Paths ---- + +JPEG_LIB := ../../lib/libjpeg +LIBC_LIB := ../../lib/libc +LIBC_INC := ../../include/libc +PROG_INC := ../../include +LINK_LD := ../../link.ld +BINDIR := ../../bin +OBJDIR := obj + +# ---- Compiler flags ---- + +CXXFLAGS := \ + -std=gnu++20 \ + -g -O2 -pipe \ + -Wall \ + -Wextra \ + -Wno-unused-parameter \ + -Wno-unused-function \ + -nostdinc \ + -ffreestanding \ + -fno-stack-protector \ + -fno-stack-check \ + -fno-PIC \ + -fno-rtti \ + -fno-exceptions \ + -ffunction-sections \ + -fdata-sections \ + -m64 \ + -march=x86-64 \ + -msse \ + -msse2 \ + -mno-red-zone \ + -mcmodel=small \ + -I $(PROG_INC) \ + -isystem $(LIBC_INC) \ + -isystem ../../../kernel/freestnd-c-hdrs/x86_64/include \ + -isystem ../../../kernel/freestnd-cxx-hdrs/x86_64/include + +# ---- Linker flags ---- + +LDFLAGS := \ + -nostdlib \ + -static \ + -Wl,--build-id=none \ + -Wl,--gc-sections \ + -Wl,-m,elf_x86_64 \ + -z max-page-size=0x1000 \ + -T $(LINK_LD) + +# ---- Libraries ---- + +LIBS := $(JPEG_LIB)/libjpeg.a $(LIBC_LIB)/liblibc.a + +# ---- Source files ---- + +SRCS := main.cpp stb_truetype_impl.cpp +OBJS := $(addprefix $(OBJDIR)/,$(SRCS:.cpp=.o)) + +# ---- Target ---- + +TARGET := $(BINDIR)/os/imageviewer.elf + +.PHONY: all clean + +all: $(TARGET) + +$(TARGET): $(OBJS) $(LIBS) $(LINK_LD) Makefile + mkdir -p $(BINDIR)/os + $(CXX) $(CXXFLAGS) $(LDFLAGS) $(OBJS) $(LIBS) -o $@ + +$(OBJDIR)/%.o: %.cpp Makefile + mkdir -p $(OBJDIR) + $(CXX) $(CXXFLAGS) -c $< -o $@ + +clean: + rm -rf $(OBJDIR) $(TARGET) diff --git a/programs/src/imageviewer/main.cpp b/programs/src/imageviewer/main.cpp new file mode 100644 index 0000000..c692244 --- /dev/null +++ b/programs/src/imageviewer/main.cpp @@ -0,0 +1,418 @@ +/* + * main.cpp + * ZenithOS Image Viewer - standalone Window Server process + * Displays JPEG images with pan via mouse drag, scroll wheel, and arrow keys + * Copyright (c) 2026 Daniel Hammer + */ + +#include +#include +#include +#include +#include + +extern "C" { +#include +#include +#include +} + +using namespace gui; + +// ============================================================================ +// Constants +// ============================================================================ + +static constexpr int INIT_W = 800; +static constexpr int INIT_H = 600; +static constexpr int STATUS_H = 24; +static constexpr int PAN_STEP = 40; +static constexpr int FONT_SIZE = 13; + +static constexpr Color BG_COLOR = Color::from_rgb(0x30, 0x30, 0x30); +static constexpr Color STATUS_BG = Color::from_rgb(0x24, 0x24, 0x24); +static constexpr Color STATUS_TEXT = Color::from_rgb(0xCC, 0xCC, 0xCC); +static constexpr Color ERR_COLOR = Color::from_rgb(0xCC, 0x33, 0x33); + +// ============================================================================ +// App state +// ============================================================================ + +static int g_win_w = INIT_W; +static int g_win_h = INIT_H; + +// Image data +static uint32_t* g_image = nullptr; // ARGB pixel buffer +static int g_img_w = 0; +static int g_img_h = 0; + +// Pan offset (image position relative to viewport) +static int g_pan_x = 0; +static int g_pan_y = 0; + +// Mouse drag state +static bool g_dragging = false; +static int g_drag_start_x = 0; +static int g_drag_start_y = 0; +static int g_drag_pan_x = 0; +static int g_drag_pan_y = 0; + +// File info +static char g_filename[128] = {}; +static char g_status[256] = {}; +static bool g_load_ok = false; + +// Font +static TrueTypeFont* g_font = nullptr; + +// ============================================================================ +// Helpers +// ============================================================================ + +static void px_fill(uint32_t* px, int bw, int bh, + int x, int y, int w, int h, Color c) { + uint32_t v = c.to_pixel(); + int x0 = x < 0 ? 0 : x, y0 = y < 0 ? 0 : y; + int x1 = x + w > bw ? bw : x + w; + int y1 = y + h > bh ? bh : y + h; + for (int row = y0; row < y1; row++) + for (int col = x0; col < x1; col++) + px[row * bw + col] = v; +} + +// Extract basename from a VFS path (e.g. "0:/photos/cat.jpg" -> "cat.jpg") +static const char* basename(const char* path) { + const char* last = path; + for (const char* p = path; *p; p++) { + if (*p == '/') last = p + 1; + } + return last; +} + +// Format an integer into a decimal string +static void int_to_str(char* buf, int val) { + if (val == 0) { buf[0] = '0'; buf[1] = '\0'; return; } + bool neg = val < 0; + if (neg) val = -val; + char tmp[16]; + int i = 0; + while (val > 0 && i < 15) { + tmp[i++] = '0' + (val % 10); + val /= 10; + } + int j = 0; + if (neg) buf[j++] = '-'; + while (i > 0) buf[j++] = tmp[--i]; + buf[j] = '\0'; +} + +static void str_append(char* dst, const char* src, int maxlen) { + int len = zenith::slen(dst); + int i = 0; + while (src[i] && len + i < maxlen - 1) { + dst[len + i] = src[i]; + i++; + } + dst[len + i] = '\0'; +} + +// ============================================================================ +// Image loading +// ============================================================================ + +static bool load_image(const char* path) { + int fd = zenith::open(path); + if (fd < 0) { + zenith::strcpy(g_status, "Error: could not open file"); + return false; + } + + uint64_t size = zenith::getsize(fd); + if (size == 0 || size > 16 * 1024 * 1024) { + zenith::close(fd); + zenith::strcpy(g_status, "Error: file too large or empty"); + return false; + } + + uint8_t* filedata = (uint8_t*)zenith::malloc(size); + if (!filedata) { + zenith::close(fd); + zenith::strcpy(g_status, "Error: out of memory"); + return false; + } + + int bytes_read = zenith::read(fd, filedata, 0, size); + zenith::close(fd); + + if (bytes_read <= 0) { + zenith::mfree(filedata); + zenith::strcpy(g_status, "Error: could not read file"); + return false; + } + + int w, h, channels; + unsigned char* rgb = stbi_load_from_memory(filedata, bytes_read, &w, &h, &channels, 3); + zenith::mfree(filedata); + + if (!rgb) { + zenith::strcpy(g_status, "Error: "); + const char* reason = stbi_failure_reason(); + if (reason) str_append(g_status, reason, 256); + else str_append(g_status, "unknown decode error", 256); + return false; + } + + // Convert RGB to ARGB + g_image = (uint32_t*)zenith::malloc((uint64_t)w * h * 4); + if (!g_image) { + stbi_image_free(rgb); + zenith::strcpy(g_status, "Error: out of memory for image"); + return false; + } + + for (int i = 0; i < w * h; i++) { + uint8_t r = rgb[i * 3 + 0]; + uint8_t g = rgb[i * 3 + 1]; + uint8_t b = rgb[i * 3 + 2]; + g_image[i] = 0xFF000000u | ((uint32_t)r << 16) | ((uint32_t)g << 8) | b; + } + + stbi_image_free(rgb); + + g_img_w = w; + g_img_h = h; + + // Build status string: "filename.jpg (1920 x 1080)" + const char* name = basename(path); + zenith::strncpy(g_filename, name, 127); + + zenith::strcpy(g_status, g_filename); + str_append(g_status, " (", 256); + char num[16]; + int_to_str(num, w); + str_append(g_status, num, 256); + str_append(g_status, " x ", 256); + int_to_str(num, h); + str_append(g_status, num, 256); + str_append(g_status, ")", 256); + + return true; +} + +// ============================================================================ +// Pan clamping +// ============================================================================ + +static void clamp_pan() { + int view_h = g_win_h - STATUS_H; + + // If image fits in viewport, center it + if (g_img_w <= g_win_w) { + g_pan_x = (g_win_w - g_img_w) / 2; + } else { + // Clamp so image edges don't leave the viewport + if (g_pan_x > 0) g_pan_x = 0; + if (g_pan_x < g_win_w - g_img_w) g_pan_x = g_win_w - g_img_w; + } + + if (g_img_h <= view_h) { + g_pan_y = (view_h - g_img_h) / 2; + } else { + if (g_pan_y > 0) g_pan_y = 0; + if (g_pan_y < view_h - g_img_h) g_pan_y = view_h - g_img_h; + } +} + +static void center_image() { + int view_h = g_win_h - STATUS_H; + g_pan_x = (g_win_w - g_img_w) / 2; + g_pan_y = (view_h - g_img_h) / 2; + clamp_pan(); +} + +// ============================================================================ +// Rendering +// ============================================================================ + +static void render(uint32_t* pixels) { + int view_h = g_win_h - STATUS_H; + + // Fill background + px_fill(pixels, g_win_w, g_win_h, 0, 0, g_win_w, view_h, BG_COLOR); + + // Draw image + if (g_image && g_load_ok) { + for (int row = 0; row < g_img_h; row++) { + int dy = g_pan_y + row; + if (dy < 0 || dy >= view_h) continue; + for (int col = 0; col < g_img_w; col++) { + int dx = g_pan_x + col; + if (dx < 0 || dx >= g_win_w) continue; + pixels[dy * g_win_w + dx] = g_image[row * g_img_w + col]; + } + } + } else if (!g_load_ok && g_font) { + // Show error message centered + g_font->draw_to_buffer(pixels, g_win_w, g_win_h, + 20, view_h / 2 - 8, g_status, ERR_COLOR, 15); + } + + // Status bar + px_fill(pixels, g_win_w, g_win_h, 0, view_h, g_win_w, STATUS_H, STATUS_BG); + if (g_font) { + g_font->draw_to_buffer(pixels, g_win_w, g_win_h, + 8, view_h + (STATUS_H - FONT_SIZE) / 2, g_status, STATUS_TEXT, FONT_SIZE); + } +} + +// ============================================================================ +// Entry point +// ============================================================================ + +extern "C" void _start() { + // Get file path from arguments + char filepath[512] = {}; + int arglen = zenith::getargs(filepath, sizeof(filepath)); + if (arglen <= 0) { + zenith::strcpy(filepath, ""); + } + + // Load font + auto load_font = [](const char* path) -> TrueTypeFont* { + TrueTypeFont* f = (TrueTypeFont*)zenith::malloc(sizeof(TrueTypeFont)); + if (!f) return nullptr; + zenith::memset(f, 0, sizeof(TrueTypeFont)); + if (!f->init(path)) { zenith::mfree(f); return nullptr; } + return f; + }; + g_font = load_font("0:/fonts/Roboto-Medium.ttf"); + + // Determine window title from filename + char title[64] = "Image Viewer"; + if (filepath[0]) { + const char* name = basename(filepath); + if (name[0]) zenith::strncpy(title, name, 63); + } + + // Create window + Zenith::WinCreateResult wres; + if (zenith::win_create(title, INIT_W, INIT_H, &wres) < 0 || wres.id < 0) + zenith::exit(1); + + int win_id = wres.id; + uint32_t* pixels = (uint32_t*)(uintptr_t)wres.pixelVa; + + // Load image + if (filepath[0]) { + g_load_ok = load_image(filepath); + } else { + zenith::strcpy(g_status, "No file specified"); + g_load_ok = false; + } + + // Center image initially + if (g_load_ok) center_image(); + + // Initial render + render(pixels); + zenith::win_present(win_id); + + // Event loop + while (true) { + Zenith::WinEvent ev; + int r = zenith::win_poll(win_id, &ev); + + if (r < 0) break; + + if (r == 0) { + zenith::sleep_ms(16); + continue; + } + + // Close event + if (ev.type == 3) break; + + // Resize event + if (ev.type == 2) { + g_win_w = ev.resize.w; + g_win_h = ev.resize.h; + pixels = (uint32_t*)(uintptr_t)zenith::win_resize(win_id, g_win_w, g_win_h); + if (g_load_ok) clamp_pan(); + render(pixels); + zenith::win_present(win_id); + continue; + } + + // Key event + if (ev.type == 0 && ev.key.pressed) { + bool redraw = false; + + // Q or Escape to close + if (ev.key.ascii == 'q' || ev.key.ascii == 'Q' || ev.key.scancode == 0x01) { + break; + } + + // Arrow keys to pan + if (ev.key.scancode == 0x48) { g_pan_y += PAN_STEP; redraw = true; } // Up + if (ev.key.scancode == 0x50) { g_pan_y -= PAN_STEP; redraw = true; } // Down + if (ev.key.scancode == 0x4B) { g_pan_x += PAN_STEP; redraw = true; } // Left + if (ev.key.scancode == 0x4D) { g_pan_x -= PAN_STEP; redraw = true; } // Right + + // Home key to re-center + if (ev.key.scancode == 0x47) { center_image(); redraw = true; } + + if (redraw && g_load_ok) { + clamp_pan(); + render(pixels); + zenith::win_present(win_id); + } + continue; + } + + // Mouse event + if (ev.type == 1) { + bool redraw = false; + bool left_now = ev.mouse.buttons & 1; + bool left_prev = ev.mouse.prev_buttons & 1; + + // Start drag + if (left_now && !left_prev) { + g_dragging = true; + g_drag_start_x = ev.mouse.x; + g_drag_start_y = ev.mouse.y; + g_drag_pan_x = g_pan_x; + g_drag_pan_y = g_pan_y; + } + + // Continue drag + if (left_now && g_dragging) { + g_pan_x = g_drag_pan_x + (ev.mouse.x - g_drag_start_x); + g_pan_y = g_drag_pan_y + (ev.mouse.y - g_drag_start_y); + redraw = true; + } + + // End drag + if (!left_now && g_dragging) { + g_dragging = false; + } + + // Scroll wheel for vertical pan + if (ev.mouse.scroll != 0) { + g_pan_y += ev.mouse.scroll * PAN_STEP; + redraw = true; + } + + if (redraw && g_load_ok) { + clamp_pan(); + render(pixels); + zenith::win_present(win_id); + } + continue; + } + } + + // Cleanup + if (g_image) zenith::mfree(g_image); + zenith::win_destroy(win_id); + zenith::exit(0); +} diff --git a/programs/src/imageviewer/stb_truetype_impl.cpp b/programs/src/imageviewer/stb_truetype_impl.cpp new file mode 100644 index 0000000..bc52e9e --- /dev/null +++ b/programs/src/imageviewer/stb_truetype_impl.cpp @@ -0,0 +1,35 @@ +/* + * stb_truetype_impl.cpp + * Single compilation unit for stb_truetype in ZenithOS freestanding environment + * Copyright (c) 2026 Daniel Hammer + */ + +#include +#include +#include +#include +#include + +// Override all stb_truetype dependencies before including the implementation + +#define STBTT_ifloor(x) ((int) stb_floor(x)) +#define STBTT_iceil(x) ((int) stb_ceil(x)) +#define STBTT_sqrt(x) stb_sqrt(x) +#define STBTT_pow(x,y) stb_pow(x,y) +#define STBTT_fmod(x,y) stb_fmod(x,y) +#define STBTT_cos(x) stb_cos(x) +#define STBTT_acos(x) stb_acos(x) +#define STBTT_fabs(x) stb_fabs(x) + +#define STBTT_malloc(x,u) ((void)(u), zenith::malloc(x)) +#define STBTT_free(x,u) ((void)(u), zenith::mfree(x)) + +#define STBTT_memcpy(d,s,n) zenith::memcpy(d,s,n) +#define STBTT_memset(d,v,n) zenith::memset(d,v,n) + +#define STBTT_strlen(x) zenith::slen(x) + +#define STBTT_assert(x) ((void)(x)) + +#define STB_TRUETYPE_IMPLEMENTATION +#include