From 7a290b9734dcd38e614731fa6d8e7255003b7092 Mon Sep 17 00:00:00 2001 From: iridiumR Date: Tue, 23 May 2023 15:20:42 +0800 Subject: [PATCH] feat(OpenGL-hello): tex v1 --- OpenGL/hello/include/stb_image.h | 7987 ++++++++++++++++++++++++++ OpenGL/hello/resources/container.jpg | Bin 0 -> 184939 bytes OpenGL/hello/src/main.cpp | 63 +- OpenGL/hello/src/tex.fs | 12 + OpenGL/hello/src/tex.vs | 14 + 5 files changed, 8059 insertions(+), 17 deletions(-) create mode 100644 OpenGL/hello/include/stb_image.h create mode 100644 OpenGL/hello/resources/container.jpg create mode 100644 OpenGL/hello/src/tex.fs create mode 100644 OpenGL/hello/src/tex.vs diff --git a/OpenGL/hello/include/stb_image.h b/OpenGL/hello/include/stb_image.h new file mode 100644 index 0000000..5e807a0 --- /dev/null +++ b/OpenGL/hello/include/stb_image.h @@ -0,0 +1,7987 @@ +/* stb_image - v2.28 - 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.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 signed shorts is valid, 0 on overflow. +static int stbi__mul2shorts_valid(short a, short 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 int 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)) { + int x = stbi__get8(j->s); + while (x == 255) { // 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; + stbi__uint32 code_buffer; + + char *zout; + char *zout_start; + char *zout_end; + int z_expandable; + + stbi__zhuffman z_length, z_distance; +} stbi__zbuf; + +stbi_inline static int stbi__zeof(stbi__zbuf *z) +{ + return (z->zbuffer >= z->zbuffer_end); +} + +stbi_inline static stbi_uc stbi__zget8(stbi__zbuf *z) +{ + return stbi__zeof(z) ? 0 : *z->zbuffer++; +} + +static void stbi__fill_bits(stbi__zbuf *z) +{ + do { + if (z->code_buffer >= (1U << z->num_bits)) { + z->zbuffer = z->zbuffer_end; /* treat this as EOF so we fail. */ + return; + } + z->code_buffer |= (unsigned int) stbi__zget8(z) << z->num_bits; + z->num_bits += 8; + } while (z->num_bits <= 24); +} + +stbi_inline static unsigned int stbi__zreceive(stbi__zbuf *z, int n) +{ + unsigned int k; + if (z->num_bits < n) stbi__fill_bits(z); + k = z->code_buffer & ((1 << n) - 1); + z->code_buffer >>= n; + z->num_bits -= n; + return k; +} + +static int stbi__zhuffman_decode_slowpath(stbi__zbuf *a, stbi__zhuffman *z) +{ + int b,s,k; + // not resolved by fast table, so compute it the slow way + // use jpeg approach, which requires MSbits at top + k = stbi__bit_reverse(a->code_buffer, 16); + for (s=STBI__ZFAST_BITS+1; ; ++s) + if (k < z->maxcode[s]) + break; + if (s >= 16) return -1; // invalid code! + // code size is s, so: + b = (k >> (16-s)) - z->firstcode[s] + z->firstsymbol[s]; + if (b >= STBI__ZNSYMS) return -1; // some data was corrupt somewhere! + if (z->size[b] != s) return -1; // was originally an assert, but report failure instead. + a->code_buffer >>= s; + a->num_bits -= s; + return z->value[b]; +} + +stbi_inline static int stbi__zhuffman_decode(stbi__zbuf *a, stbi__zhuffman *z) +{ + int b,s; + if (a->num_bits < 16) { + if (stbi__zeof(a)) { + return -1; /* report error for unexpected end of data. */ + } + stbi__fill_bits(a); + } + b = z->fast[a->code_buffer & STBI__ZFAST_MASK]; + if (b) { + s = b >> 9; + a->code_buffer >>= s; + a->num_bits -= s; + return b & 511; + } + return stbi__zhuffman_decode_slowpath(a, z); +} + +static int stbi__zexpand(stbi__zbuf *z, char *zout, int n) // need to make room for n bytes +{ + char *q; + unsigned int cur, limit, old_limit; + z->zout = zout; + if (!z->z_expandable) return stbi__err("output buffer limit","Corrupt PNG"); + cur = (unsigned int) (z->zout - z->zout_start); + limit = old_limit = (unsigned) (z->zout_end - z->zout_start); + if (UINT_MAX - cur < (unsigned) n) return stbi__err("outofmem", "Out of memory"); + while (cur + n > limit) { + if(limit > UINT_MAX / 2) return stbi__err("outofmem", "Out of memory"); + limit *= 2; + } + q = (char *) STBI_REALLOC_SIZED(z->zout_start, old_limit, limit); + STBI_NOTUSED(old_limit); + if (q == NULL) return stbi__err("outofmem", "Out of memory"); + z->zout_start = q; + z->zout = q + cur; + z->zout_end = q + limit; + return 1; +} + +static const int stbi__zlength_base[31] = { + 3,4,5,6,7,8,9,10,11,13, + 15,17,19,23,27,31,35,43,51,59, + 67,83,99,115,131,163,195,227,258,0,0 }; + +static const int stbi__zlength_extra[31]= +{ 0,0,0,0,0,0,0,0,1,1,1,1,2,2,2,2,3,3,3,3,4,4,4,4,5,5,5,5,0,0,0 }; + +static const int stbi__zdist_base[32] = { 1,2,3,4,5,7,9,13,17,25,33,49,65,97,129,193, +257,385,513,769,1025,1537,2049,3073,4097,6145,8193,12289,16385,24577,0,0}; + +static const int stbi__zdist_extra[32] = +{ 0,0,0,0,1,1,2,2,3,3,4,4,5,5,6,6,7,7,8,8,9,9,10,10,11,11,12,12,13,13}; + +static int stbi__parse_huffman_block(stbi__zbuf *a) +{ + char *zout = a->zout; + for(;;) { + int z = stbi__zhuffman_decode(a, &a->z_length); + if (z < 256) { + if (z < 0) return stbi__err("bad huffman code","Corrupt PNG"); // error in huffman codes + if (zout >= a->zout_end) { + if (!stbi__zexpand(a, zout, 1)) return 0; + zout = a->zout; + } + *zout++ = (char) z; + } else { + stbi_uc *p; + int len,dist; + if (z == 256) { + a->zout = zout; + return 1; + } + 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 (zout + len > a->zout_end) { + if (!stbi__zexpand(a, zout, len)) return 0; + zout = a->zout; + } + p = (stbi_uc *) (zout - dist); + if (dist == 1) { // run of one byte; common in images. + stbi_uc v = *p; + if (len) { do *zout++ = v; while (--len); } + } else { + if (len) { do *zout++ = *p++; while (--len); } + } + } + } +} + +static int stbi__compute_huffman_codes(stbi__zbuf *a) +{ + static const stbi_uc length_dezigzag[19] = { 16,17,18,0,8,7,9,6,10,5,11,4,12,3,13,2,14,1,15 }; + stbi__zhuffman z_codelength; + stbi_uc lencodes[286+32+137];//padding for maximum single op + stbi_uc codelength_sizes[19]; + int i,n; + + int hlit = stbi__zreceive(a,5) + 257; + int hdist = stbi__zreceive(a,5) + 1; + int hclen = stbi__zreceive(a,4) + 4; + int ntot = hlit + hdist; + + memset(codelength_sizes, 0, sizeof(codelength_sizes)); + for (i=0; i < hclen; ++i) { + int s = stbi__zreceive(a,3); + codelength_sizes[length_dezigzag[i]] = (stbi_uc) s; + } + if (!stbi__zbuild_huffman(&z_codelength, codelength_sizes, 19)) return 0; + + n = 0; + while (n < ntot) { + int c = stbi__zhuffman_decode(a, &z_codelength); + if (c < 0 || c >= 19) return stbi__err("bad codelengths", "Corrupt PNG"); + if (c < 16) + lencodes[n++] = (stbi_uc) c; + else { + stbi_uc fill = 0; + if (c == 16) { + c = stbi__zreceive(a,2)+3; + if (n == 0) return stbi__err("bad codelengths", "Corrupt PNG"); + fill = lencodes[n-1]; + } else if (c == 17) { + c = stbi__zreceive(a,3)+3; + } else if (c == 18) { + c = stbi__zreceive(a,7)+11; + } else { + return stbi__err("bad codelengths", "Corrupt PNG"); + } + if (ntot - n < c) return stbi__err("bad codelengths", "Corrupt PNG"); + memset(lencodes+n, fill, c); + n += c; + } + } + if (n != ntot) return stbi__err("bad codelengths","Corrupt PNG"); + if (!stbi__zbuild_huffman(&a->z_length, lencodes, hlit)) return 0; + if (!stbi__zbuild_huffman(&a->z_distance, lencodes+hlit, hdist)) return 0; + return 1; +} + +static int stbi__parse_uncompressed_block(stbi__zbuf *a) +{ + stbi_uc header[4]; + int len,nlen,k; + if (a->num_bits & 7) + stbi__zreceive(a, a->num_bits & 7); // discard + // drain the bit-packed data into header + k = 0; + while (a->num_bits > 0) { + header[k++] = (stbi_uc) (a->code_buffer & 255); // suppress MSVC run-time check + a->code_buffer >>= 8; + a->num_bits -= 8; + } + if (a->num_bits < 0) return stbi__err("zlib corrupt","Corrupt PNG"); + // now fill header the normal way + while (k < 4) + header[k++] = stbi__zget8(a); + len = header[1] * 256 + header[0]; + nlen = header[3] * 256 + header[2]; + if (nlen != (len ^ 0xffff)) return stbi__err("zlib corrupt","Corrupt PNG"); + if (a->zbuffer + len > a->zbuffer_end) return stbi__err("read past buffer","Corrupt PNG"); + if (a->zout + len > a->zout_end) + if (!stbi__zexpand(a, a->zout, len)) return 0; + memcpy(a->zout, a->zbuffer, len); + a->zbuffer += len; + a->zout += len; + return 1; +} + +static int stbi__parse_zlib_header(stbi__zbuf *a) +{ + int cmf = stbi__zget8(a); + int cm = cmf & 15; + /* int cinfo = cmf >> 4; */ + int flg = stbi__zget8(a); + if (stbi__zeof(a)) return stbi__err("bad zlib header","Corrupt PNG"); // zlib spec + if ((cmf*256+flg) % 31 != 0) return stbi__err("bad zlib header","Corrupt PNG"); // zlib spec + if (flg & 32) return stbi__err("no preset dict","Corrupt PNG"); // preset dictionary not allowed in png + if (cm != 8) return stbi__err("bad compression","Corrupt PNG"); // DEFLATE required for png + // window = 1 << (8 + cinfo)... but who cares, we fully buffer output + return 1; +} + +static const stbi_uc stbi__zdefault_length[STBI__ZNSYMS] = +{ + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, + 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, + 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, + 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, + 7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7, 7,7,7,7,7,7,7,7,8,8,8,8,8,8,8,8 +}; +static const stbi_uc stbi__zdefault_distance[32] = +{ + 5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5 +}; +/* +Init algorithm: +{ + int i; // use <= to match clearly with spec + for (i=0; i <= 143; ++i) stbi__zdefault_length[i] = 8; + for ( ; i <= 255; ++i) stbi__zdefault_length[i] = 9; + for ( ; i <= 279; ++i) stbi__zdefault_length[i] = 7; + for ( ; i <= 287; ++i) stbi__zdefault_length[i] = 8; + + for (i=0; i <= 31; ++i) stbi__zdefault_distance[i] = 5; +} +*/ + +static int stbi__parse_zlib(stbi__zbuf *a, int parse_header) +{ + int final, type; + if (parse_header) + if (!stbi__parse_zlib_header(a)) return 0; + a->num_bits = 0; + a->code_buffer = 0; + do { + final = stbi__zreceive(a,1); + type = stbi__zreceive(a,2); + if (type == 0) { + if (!stbi__parse_uncompressed_block(a)) return 0; + } else if (type == 3) { + return 0; + } else { + if (type == 1) { + // use fixed code lengths + if (!stbi__zbuild_huffman(&a->z_length , stbi__zdefault_length , STBI__ZNSYMS)) return 0; + if (!stbi__zbuild_huffman(&a->z_distance, stbi__zdefault_distance, 32)) return 0; + } else { + if (!stbi__compute_huffman_codes(a)) return 0; + } + if (!stbi__parse_huffman_block(a)) return 0; + } + } while (!final); + return 1; +} + +static int stbi__do_zlib(stbi__zbuf *a, char *obuf, int olen, int exp, int parse_header) +{ + a->zout_start = obuf; + a->zout = obuf; + a->zout_end = obuf + olen; + a->z_expandable = exp; + + return stbi__parse_zlib(a, parse_header); +} + +STBIDEF char *stbi_zlib_decode_malloc_guesssize(const char *buffer, int len, int initial_size, int *outlen) +{ + stbi__zbuf a; + char *p = (char *) stbi__malloc(initial_size); + if (p == NULL) return NULL; + a.zbuffer = (stbi_uc *) buffer; + a.zbuffer_end = (stbi_uc *) buffer + len; + if (stbi__do_zlib(&a, p, initial_size, 1, 1)) { + if (outlen) *outlen = (int) (a.zout - a.zout_start); + return a.zout_start; + } else { + STBI_FREE(a.zout_start); + return NULL; + } +} + +STBIDEF char *stbi_zlib_decode_malloc(char const *buffer, int len, int *outlen) +{ + return stbi_zlib_decode_malloc_guesssize(buffer, len, 16384, outlen); +} + +STBIDEF char *stbi_zlib_decode_malloc_guesssize_headerflag(const char *buffer, int len, int initial_size, int *outlen, int parse_header) +{ + stbi__zbuf a; + char *p = (char *) stbi__malloc(initial_size); + if (p == NULL) return NULL; + a.zbuffer = (stbi_uc *) buffer; + a.zbuffer_end = (stbi_uc *) buffer + len; + if (stbi__do_zlib(&a, p, initial_size, 1, parse_header)) { + if (outlen) *outlen = (int) (a.zout - a.zout_start); + return a.zout_start; + } else { + STBI_FREE(a.zout_start); + return NULL; + } +} + +STBIDEF int stbi_zlib_decode_buffer(char *obuffer, int olen, char const *ibuffer, int ilen) +{ + stbi__zbuf a; + a.zbuffer = (stbi_uc *) ibuffer; + a.zbuffer_end = (stbi_uc *) ibuffer + ilen; + if (stbi__do_zlib(&a, obuffer, olen, 0, 1)) + return (int) (a.zout - a.zout_start); + else + return -1; +} + +STBIDEF char *stbi_zlib_decode_noheader_malloc(char const *buffer, int len, int *outlen) +{ + stbi__zbuf a; + char *p = (char *) stbi__malloc(16384); + if (p == NULL) return NULL; + a.zbuffer = (stbi_uc *) buffer; + a.zbuffer_end = (stbi_uc *) buffer+len; + if (stbi__do_zlib(&a, p, 16384, 1, 0)) { + if (outlen) *outlen = (int) (a.zout - a.zout_start); + return a.zout_start; + } else { + STBI_FREE(a.zout_start); + return NULL; + } +} + +STBIDEF int stbi_zlib_decode_noheader_buffer(char *obuffer, int olen, const char *ibuffer, int ilen) +{ + stbi__zbuf a; + a.zbuffer = (stbi_uc *) ibuffer; + a.zbuffer_end = (stbi_uc *) ibuffer + ilen; + if (stbi__do_zlib(&a, obuffer, olen, 0, 0)) + return (int) (a.zout - a.zout_start); + else + return -1; +} +#endif + +// public domain "baseline" PNG decoder v0.10 Sean Barrett 2006-11-18 +// simple implementation +// - only 8-bit samples +// - no CRC checking +// - allocates lots of intermediate memory +// - avoids problem of streaming data between subsystems +// - avoids explicit window management +// performance +// - uses stb_zlib, a PD zlib implementation with fast huffman decoding + +#ifndef STBI_NO_PNG +typedef struct +{ + stbi__uint32 length; + stbi__uint32 type; +} stbi__pngchunk; + +static stbi__pngchunk stbi__get_chunk_header(stbi__context *s) +{ + stbi__pngchunk c; + c.length = stbi__get32be(s); + c.type = stbi__get32be(s); + return c; +} + +static int stbi__check_png_header(stbi__context *s) +{ + static const stbi_uc png_sig[8] = { 137,80,78,71,13,10,26,10 }; + int i; + for (i=0; i < 8; ++i) + if (stbi__get8(s) != png_sig[i]) return stbi__err("bad png sig","Not a PNG"); + return 1; +} + +typedef struct +{ + stbi__context *s; + stbi_uc *idata, *expanded, *out; + int depth; +} stbi__png; + + +enum { + STBI__F_none=0, + STBI__F_sub=1, + STBI__F_up=2, + STBI__F_avg=3, + STBI__F_paeth=4, + // synthetic filters used for first scanline to avoid needing a dummy row of 0s + STBI__F_avg_first, + STBI__F_paeth_first +}; + +static stbi_uc first_row_filter[5] = +{ + STBI__F_none, + STBI__F_sub, + STBI__F_none, + STBI__F_avg_first, + STBI__F_paeth_first +}; + +static int stbi__paeth(int a, int b, int c) +{ + int p = a + b - c; + int pa = abs(p-a); + int pb = abs(p-b); + int pc = abs(p-c); + if (pa <= pb && pa <= pc) return a; + if (pb <= pc) return b; + return c; +} + +static const stbi_uc stbi__depth_scale_table[9] = { 0, 0xff, 0x55, 0, 0x11, 0,0,0, 0x01 }; + +// create the png data from post-deflated data +static int stbi__create_png_image_raw(stbi__png *a, stbi_uc *raw, stbi__uint32 raw_len, int out_n, stbi__uint32 x, stbi__uint32 y, int depth, int color) +{ + int bytes = (depth == 16? 2 : 1); + stbi__context *s = a->s; + stbi__uint32 i,j,stride = x*out_n*bytes; + stbi__uint32 img_len, img_width_bytes; + int k; + int img_n = s->img_n; // copy it into a local for later + + int output_bytes = out_n*bytes; + int filter_bytes = img_n*bytes; + int width = x; + + STBI_ASSERT(out_n == s->img_n || out_n == s->img_n+1); + a->out = (stbi_uc *) stbi__malloc_mad3(x, y, output_bytes, 0); // extra bytes to write off the end into + if (!a->out) return stbi__err("outofmem", "Out of memory"); + + if (!stbi__mad3sizes_valid(img_n, x, depth, 7)) return stbi__err("too large", "Corrupt PNG"); + img_width_bytes = (((img_n * x * depth) + 7) >> 3); + img_len = (img_width_bytes + 1) * y; + + // we used to check for exact match between raw_len and img_len on non-interlaced PNGs, + // but issue #276 reported a PNG in the wild that had extra data at the end (all zeros), + // so just check for raw_len < img_len always. + if (raw_len < img_len) return stbi__err("not enough pixels","Corrupt PNG"); + + for (j=0; j < y; ++j) { + stbi_uc *cur = a->out + stride*j; + stbi_uc *prior; + int filter = *raw++; + + if (filter > 4) + return stbi__err("invalid filter","Corrupt PNG"); + + if (depth < 8) { + if (img_width_bytes > x) return stbi__err("invalid width","Corrupt PNG"); + cur += x*out_n - img_width_bytes; // store output to the rightmost img_len bytes, so we can decode in place + filter_bytes = 1; + width = img_width_bytes; + } + prior = cur - stride; // bugfix: need to compute this after 'cur +=' computation above + + // if first row, use special filter that doesn't sample previous row + if (j == 0) filter = first_row_filter[filter]; + + // handle first byte explicitly + for (k=0; k < filter_bytes; ++k) { + switch (filter) { + case STBI__F_none : cur[k] = raw[k]; break; + case STBI__F_sub : cur[k] = raw[k]; break; + case STBI__F_up : cur[k] = STBI__BYTECAST(raw[k] + prior[k]); break; + case STBI__F_avg : cur[k] = STBI__BYTECAST(raw[k] + (prior[k]>>1)); break; + case STBI__F_paeth : cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(0,prior[k],0)); break; + case STBI__F_avg_first : cur[k] = raw[k]; break; + case STBI__F_paeth_first: cur[k] = raw[k]; break; + } + } + + if (depth == 8) { + if (img_n != out_n) + cur[img_n] = 255; // first pixel + raw += img_n; + cur += out_n; + prior += out_n; + } else if (depth == 16) { + if (img_n != out_n) { + cur[filter_bytes] = 255; // first pixel top byte + cur[filter_bytes+1] = 255; // first pixel bottom byte + } + raw += filter_bytes; + cur += output_bytes; + prior += output_bytes; + } else { + raw += 1; + cur += 1; + prior += 1; + } + + // this is a little gross, so that we don't switch per-pixel or per-component + if (depth < 8 || img_n == out_n) { + int nk = (width - 1)*filter_bytes; + #define STBI__CASE(f) \ + case f: \ + for (k=0; k < nk; ++k) + switch (filter) { + // "none" filter turns into a memcpy here; make that explicit. + case STBI__F_none: memcpy(cur, raw, nk); break; + STBI__CASE(STBI__F_sub) { cur[k] = STBI__BYTECAST(raw[k] + cur[k-filter_bytes]); } break; + STBI__CASE(STBI__F_up) { cur[k] = STBI__BYTECAST(raw[k] + prior[k]); } break; + STBI__CASE(STBI__F_avg) { cur[k] = STBI__BYTECAST(raw[k] + ((prior[k] + cur[k-filter_bytes])>>1)); } break; + STBI__CASE(STBI__F_paeth) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k-filter_bytes],prior[k],prior[k-filter_bytes])); } break; + STBI__CASE(STBI__F_avg_first) { cur[k] = STBI__BYTECAST(raw[k] + (cur[k-filter_bytes] >> 1)); } break; + STBI__CASE(STBI__F_paeth_first) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k-filter_bytes],0,0)); } break; + } + #undef STBI__CASE + raw += nk; + } else { + STBI_ASSERT(img_n+1 == out_n); + #define STBI__CASE(f) \ + case f: \ + for (i=x-1; i >= 1; --i, cur[filter_bytes]=255,raw+=filter_bytes,cur+=output_bytes,prior+=output_bytes) \ + for (k=0; k < filter_bytes; ++k) + switch (filter) { + STBI__CASE(STBI__F_none) { cur[k] = raw[k]; } break; + STBI__CASE(STBI__F_sub) { cur[k] = STBI__BYTECAST(raw[k] + cur[k- output_bytes]); } break; + STBI__CASE(STBI__F_up) { cur[k] = STBI__BYTECAST(raw[k] + prior[k]); } break; + STBI__CASE(STBI__F_avg) { cur[k] = STBI__BYTECAST(raw[k] + ((prior[k] + cur[k- output_bytes])>>1)); } break; + STBI__CASE(STBI__F_paeth) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k- output_bytes],prior[k],prior[k- output_bytes])); } break; + STBI__CASE(STBI__F_avg_first) { cur[k] = STBI__BYTECAST(raw[k] + (cur[k- output_bytes] >> 1)); } break; + STBI__CASE(STBI__F_paeth_first) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k- output_bytes],0,0)); } break; + } + #undef STBI__CASE + + // the loop above sets the high byte of the pixels' alpha, but for + // 16 bit png files we also need the low byte set. we'll do that here. + if (depth == 16) { + cur = a->out + stride*j; // start at the beginning of the row again + for (i=0; i < x; ++i,cur+=output_bytes) { + cur[filter_bytes+1] = 255; + } + } + } + } + + // we make a separate pass to expand bits to pixels; for performance, + // this could run two scanlines behind the above code, so it won't + // intefere with filtering but will still be in the cache. + if (depth < 8) { + for (j=0; j < y; ++j) { + stbi_uc *cur = a->out + stride*j; + stbi_uc *in = a->out + stride*j + x*out_n - img_width_bytes; + // unpack 1/2/4-bit into a 8-bit buffer. allows us to keep the common 8-bit path optimal at minimal cost for 1/2/4-bit + // png guarante byte alignment, if width is not multiple of 8/4/2 we'll decode dummy trailing data that will be skipped in the later loop + stbi_uc scale = (color == 0) ? stbi__depth_scale_table[depth] : 1; // scale grayscale values to 0..255 range + + // note that the final byte might overshoot and write more data than desired. + // we can allocate enough data that this never writes out of memory, but it + // could also overwrite the next scanline. can it overwrite non-empty data + // on the next scanline? yes, consider 1-pixel-wide scanlines with 1-bit-per-pixel. + // so we need to explicitly clamp the final ones + + if (depth == 4) { + for (k=x*img_n; k >= 2; k-=2, ++in) { + *cur++ = scale * ((*in >> 4) ); + *cur++ = scale * ((*in ) & 0x0f); + } + if (k > 0) *cur++ = scale * ((*in >> 4) ); + } else if (depth == 2) { + for (k=x*img_n; k >= 4; k-=4, ++in) { + *cur++ = scale * ((*in >> 6) ); + *cur++ = scale * ((*in >> 4) & 0x03); + *cur++ = scale * ((*in >> 2) & 0x03); + *cur++ = scale * ((*in ) & 0x03); + } + if (k > 0) *cur++ = scale * ((*in >> 6) ); + if (k > 1) *cur++ = scale * ((*in >> 4) & 0x03); + if (k > 2) *cur++ = scale * ((*in >> 2) & 0x03); + } else if (depth == 1) { + for (k=x*img_n; k >= 8; k-=8, ++in) { + *cur++ = scale * ((*in >> 7) ); + *cur++ = scale * ((*in >> 6) & 0x01); + *cur++ = scale * ((*in >> 5) & 0x01); + *cur++ = scale * ((*in >> 4) & 0x01); + *cur++ = scale * ((*in >> 3) & 0x01); + *cur++ = scale * ((*in >> 2) & 0x01); + *cur++ = scale * ((*in >> 1) & 0x01); + *cur++ = scale * ((*in ) & 0x01); + } + if (k > 0) *cur++ = scale * ((*in >> 7) ); + if (k > 1) *cur++ = scale * ((*in >> 6) & 0x01); + if (k > 2) *cur++ = scale * ((*in >> 5) & 0x01); + if (k > 3) *cur++ = scale * ((*in >> 4) & 0x01); + if (k > 4) *cur++ = scale * ((*in >> 3) & 0x01); + if (k > 5) *cur++ = scale * ((*in >> 2) & 0x01); + if (k > 6) *cur++ = scale * ((*in >> 1) & 0x01); + } + if (img_n != out_n) { + int q; + // insert alpha = 255 + cur = a->out + stride*j; + if (img_n == 1) { + for (q=x-1; q >= 0; --q) { + cur[q*2+1] = 255; + cur[q*2+0] = cur[q]; + } + } else { + STBI_ASSERT(img_n == 3); + for (q=x-1; q >= 0; --q) { + cur[q*4+3] = 255; + cur[q*4+2] = cur[q*3+2]; + cur[q*4+1] = cur[q*3+1]; + cur[q*4+0] = cur[q*3+0]; + } + } + } + } + } else if (depth == 16) { + // force the image data from big-endian to platform-native. + // this is done in a separate pass due to the decoding relying + // on the data being untouched, but could probably be done + // per-line during decode if care is taken. + stbi_uc *cur = a->out; + stbi__uint16 *cur16 = (stbi__uint16*)cur; + + for(i=0; i < x*y*out_n; ++i,cur16++,cur+=2) { + *cur16 = (cur[0] << 8) | cur[1]; + } + } + + return 1; +} + +static int stbi__create_png_image(stbi__png *a, stbi_uc *image_data, stbi__uint32 image_data_len, int out_n, int depth, int color, int interlaced) +{ + int bytes = (depth == 16 ? 2 : 1); + int out_bytes = out_n * bytes; + stbi_uc *final; + int p; + if (!interlaced) + return stbi__create_png_image_raw(a, image_data, image_data_len, out_n, a->s->img_x, a->s->img_y, depth, color); + + // de-interlacing + final = (stbi_uc *) stbi__malloc_mad3(a->s->img_x, a->s->img_y, out_bytes, 0); + if (!final) return stbi__err("outofmem", "Out of memory"); + for (p=0; p < 7; ++p) { + int xorig[] = { 0,4,0,2,0,1,0 }; + int yorig[] = { 0,0,4,0,2,0,1 }; + int xspc[] = { 8,8,4,4,2,2,1 }; + int yspc[] = { 8,8,8,4,4,2,2 }; + int i,j,x,y; + // pass1_x[4] = 0, pass1_x[5] = 1, pass1_x[12] = 1 + x = (a->s->img_x - xorig[p] + xspc[p]-1) / xspc[p]; + y = (a->s->img_y - yorig[p] + yspc[p]-1) / yspc[p]; + if (x && y) { + stbi__uint32 img_len = ((((a->s->img_n * x * depth) + 7) >> 3) + 1) * y; + if (!stbi__create_png_image_raw(a, image_data, image_data_len, out_n, x, y, depth, color)) { + STBI_FREE(final); + return 0; + } + for (j=0; j < y; ++j) { + for (i=0; i < x; ++i) { + int out_y = j*yspc[p]+yorig[p]; + int out_x = i*xspc[p]+xorig[p]; + memcpy(final + out_y*a->s->img_x*out_bytes + out_x*out_bytes, + a->out + (j*x+i)*out_bytes, out_bytes); + } + } + STBI_FREE(a->out); + image_data += img_len; + image_data_len -= img_len; + } + } + a->out = final; + + return 1; +} + +static int stbi__compute_transparency(stbi__png *z, stbi_uc tc[3], int out_n) +{ + stbi__context *s = z->s; + stbi__uint32 i, pixel_count = s->img_x * s->img_y; + stbi_uc *p = z->out; + + // compute color-based transparency, assuming we've + // already got 255 as the alpha value in the output + STBI_ASSERT(out_n == 2 || out_n == 4); + + if (out_n == 2) { + for (i=0; i < pixel_count; ++i) { + p[1] = (p[0] == tc[0] ? 0 : 255); + p += 2; + } + } else { + for (i=0; i < pixel_count; ++i) { + if (p[0] == tc[0] && p[1] == tc[1] && p[2] == tc[2]) + p[3] = 0; + p += 4; + } + } + return 1; +} + +static int stbi__compute_transparency16(stbi__png *z, stbi__uint16 tc[3], int out_n) +{ + stbi__context *s = z->s; + stbi__uint32 i, pixel_count = s->img_x * s->img_y; + stbi__uint16 *p = (stbi__uint16*) z->out; + + // compute color-based transparency, assuming we've + // already got 65535 as the alpha value in the output + STBI_ASSERT(out_n == 2 || out_n == 4); + + if (out_n == 2) { + for (i = 0; i < pixel_count; ++i) { + p[1] = (p[0] == tc[0] ? 0 : 65535); + p += 2; + } + } else { + for (i = 0; i < pixel_count; ++i) { + if (p[0] == tc[0] && p[1] == tc[1] && p[2] == tc[2]) + p[3] = 0; + p += 4; + } + } + return 1; +} + +static int stbi__expand_png_palette(stbi__png *a, stbi_uc *palette, int len, int pal_img_n) +{ + stbi__uint32 i, pixel_count = a->s->img_x * a->s->img_y; + stbi_uc *p, *temp_out, *orig = a->out; + + p = (stbi_uc *) stbi__malloc_mad2(pixel_count, pal_img_n, 0); + if (p == NULL) return stbi__err("outofmem", "Out of memory"); + + // between here and free(out) below, exitting would leak + temp_out = p; + + if (pal_img_n == 3) { + for (i=0; i < pixel_count; ++i) { + int n = orig[i]*4; + p[0] = palette[n ]; + p[1] = palette[n+1]; + p[2] = palette[n+2]; + p += 3; + } + } else { + for (i=0; i < pixel_count; ++i) { + int n = orig[i]*4; + p[0] = palette[n ]; + p[1] = palette[n+1]; + p[2] = palette[n+2]; + p[3] = palette[n+3]; + p += 4; + } + } + STBI_FREE(a->out); + a->out = temp_out; + + STBI_NOTUSED(len); + + return 1; +} + +static int stbi__unpremultiply_on_load_global = 0; +static int stbi__de_iphone_flag_global = 0; + +STBIDEF void stbi_set_unpremultiply_on_load(int flag_true_if_should_unpremultiply) +{ + stbi__unpremultiply_on_load_global = flag_true_if_should_unpremultiply; +} + +STBIDEF void stbi_convert_iphone_png_to_rgb(int flag_true_if_should_convert) +{ + stbi__de_iphone_flag_global = flag_true_if_should_convert; +} + +#ifndef STBI_THREAD_LOCAL +#define stbi__unpremultiply_on_load stbi__unpremultiply_on_load_global +#define stbi__de_iphone_flag stbi__de_iphone_flag_global +#else +static STBI_THREAD_LOCAL int stbi__unpremultiply_on_load_local, stbi__unpremultiply_on_load_set; +static STBI_THREAD_LOCAL int stbi__de_iphone_flag_local, stbi__de_iphone_flag_set; + +STBIDEF void stbi_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) tc16[k] = (stbi__uint16)stbi__get16be(s); // copy the values as-is + } else { + for (k = 0; k < s->img_n; ++k) tc[k] = (stbi_uc)(stbi__get16be(s) & 255) * stbi__depth_scale_table[z->depth]; // non 8-bit images will be larger + } + } + break; + } + + case STBI__PNG_TYPE('I','D','A','T'): { + if (first) return stbi__err("first not IHDR", "Corrupt PNG"); + if (pal_img_n && !pal_len) return stbi__err("no PLTE","Corrupt PNG"); + if (scan == STBI__SCAN_header) { + // 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/OpenGL/hello/resources/container.jpg b/OpenGL/hello/resources/container.jpg new file mode 100644 index 0000000000000000000000000000000000000000..d07bee4e3a679f5e2e4ad508ef3c4dc29a522492 GIT binary patch literal 184939 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

d`XyO#5L!x`fys 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[SQrQz8sg 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 literal 0 HcmV?d00001 diff --git a/OpenGL/hello/src/main.cpp b/OpenGL/hello/src/main.cpp index e1977cb..3548169 100644 --- a/OpenGL/hello/src/main.cpp +++ b/OpenGL/hello/src/main.cpp @@ -1,15 +1,17 @@ #include "glad/glad.h" #include "shader.h" +#include "stb_image.h" #include #include +#include -// 三角形顶点 +// 四边形顶点 float vertices[] = { - // 第一个三角形 - 0.4f, 0.4f, 0.0f, // 右上角 - 0.4f, -0.4f, 0.0f, // 右下角 - -0.4f, -0.4f, 0.0f, // 左下角 - -0.4f, 0.4f, 0.0f // 左上角 + // ---- 位置 ---- ---- 颜色 ---- - 纹理坐标 - + 0.5f, 0.5f, 0.0f, 1.0f, 0.0f, 0.0f, 1.0f, 1.0f, // 右上 + 0.5f, -0.5f, 0.0f, 0.0f, 1.0f, 0.0f, 1.0f, 0.0f, // 右下 + -0.5f, -0.5f, 0.0f, 0.0f, 0.0f, 1.0f, 0.0f, 0.0f, // 左下 + -0.5f, 0.5f, 0.0f, 1.0f, 1.0f, 0.0f, 0.0f, 1.0f // 左上 }; // 索引 @@ -53,8 +55,32 @@ int main() { glfwSetFramebufferSizeCallback(window, framebuffer_size_callback); // 创建着色器程序 - Shader shader = Shader("src/simple.vs", "src/uniformcolor.fs"); + Shader shader = Shader("src/tex.vs", "src/tex.fs"); + // 创建纹理 + unsigned int texture; + glGenTextures(1, &texture); + glBindTexture(GL_TEXTURE_2D, texture); + // 设置纹理环绕方式 + glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_REPEAT); + glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_REPEAT); + // 设置纹理过滤方式 + glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, + GL_LINEAR_MIPMAP_LINEAR); + glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR); + + // 加载并生成纹理 + int width, height, nrChannels; + unsigned char *data = + stbi_load("resources/container.jpg", &width, &height, &nrChannels, 0); + if (data) { + glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB, width, height, 0, GL_RGB, + GL_UNSIGNED_BYTE, data); + glGenerateMipmap(GL_TEXTURE_2D); + } else { + std::cout << "Failed to load texture" << std::endl; + } + stbi_image_free(data); unsigned int VAO, VBO, EBO; // 创建顶点数组对象 @@ -72,9 +98,17 @@ int main() { glBufferData(GL_ELEMENT_ARRAY_BUFFER, sizeof(indices), indices, GL_STATIC_DRAW); - // 设置顶点属性指针 - glVertexAttribPointer(0, 3, GL_FLOAT, GL_FALSE, 3 * sizeof(float), (void *)0); + // 顶点属性 + glVertexAttribPointer(0, 3, GL_FLOAT, GL_FALSE, 8 * sizeof(float), (void *)0); glEnableVertexAttribArray(0); + // 颜色属性 + glVertexAttribPointer(1, 3, GL_FLOAT, GL_FALSE, 8 * sizeof(float), + (void *)(3 * sizeof(float))); + glEnableVertexAttribArray(1); + // 纹理坐标属性 + glVertexAttribPointer(2, 2, GL_FLOAT, GL_FALSE, 8 * sizeof(float), + (void *)(6 * sizeof(float))); + glEnableVertexAttribArray(2); // 循环渲染 while (!glfwWindowShouldClose(window)) { @@ -85,19 +119,14 @@ int main() { glClearColor(1.0f, 1.0f, 1.0f, 0.0f); glClear(GL_COLOR_BUFFER_BIT); + // 绑定纹理 + glBindTexture(GL_TEXTURE_2D, texture); + // 激活着色器 shader.use(); - // 更新uniform颜色 - float timeValue = glfwGetTime(); - float greenValue = (sin(timeValue) / 2.0f) + 0.5f; - shader.setFloat4("ourColor", 1.0f, greenValue, 0.0f, 0.0f); - shader.setFloat1("xOffset", cos(timeValue) / 2.0f); - shader.setFloat1("yOffset", sin(timeValue) / 2.0f); - // 绘制三角形 glBindVertexArray(VAO); - glPolygonMode(GL_FRONT_AND_BACK, GL_FILL); glDrawElements(GL_TRIANGLES, 6, GL_UNSIGNED_INT, 0); glBindVertexArray(0); diff --git a/OpenGL/hello/src/tex.fs b/OpenGL/hello/src/tex.fs new file mode 100644 index 0000000..1b549f5 --- /dev/null +++ b/OpenGL/hello/src/tex.fs @@ -0,0 +1,12 @@ +#version 330 core +out vec4 FragColor; + +in vec3 ourColor; +in vec2 TexCoord; + +uniform sampler2D ourTexture; + +void main() +{ + FragColor = texture(ourTexture, TexCoord) * vec4(ourColor, 1.0);; +} \ No newline at end of file diff --git a/OpenGL/hello/src/tex.vs b/OpenGL/hello/src/tex.vs new file mode 100644 index 0000000..22041cd --- /dev/null +++ b/OpenGL/hello/src/tex.vs @@ -0,0 +1,14 @@ +#version 330 core +layout (location = 0) in vec3 aPos; +layout (location = 1) in vec3 aColor; +layout (location = 2) in vec2 aTexCoord; + +out vec3 ourColor; +out vec2 TexCoord; + +void main() +{ + gl_Position = vec4(aPos, 1.0); + ourColor = aColor; + TexCoord = aTexCoord; +}