From cb3132e6ebc513ed25f6bdac6d13c04a55799465 Mon Sep 17 00:00:00 2001 From: sam Date: Tue, 30 Apr 2024 23:02:19 +1200 Subject: [PATCH] made a mess --- Makefile | 4 +- cat.png | Bin 0 -> 126375 bytes include/shaders.h | 1 + include/slibs.h | 194 ++ include/stb_image.h | 7985 +++++++++++++++++++++++++++++++++++++++++++ include/textures.h | 8 + include/types.h | 12 + shader.frag | 8 - shader.vert | 10 - src/main.c | 143 +- src/shaders.c | 28 +- src/slibs.c | 2 + src/stb_image.c | 3 + src/textures.c | 29 + texture.frag | 16 + texture.vert | 19 + 16 files changed, 8410 insertions(+), 52 deletions(-) create mode 100644 cat.png create mode 100644 include/slibs.h create mode 100644 include/stb_image.h create mode 100644 include/textures.h delete mode 100644 shader.frag delete mode 100644 shader.vert create mode 100644 src/slibs.c create mode 100644 src/stb_image.c create mode 100644 src/textures.c create mode 100644 texture.frag create mode 100644 texture.vert diff --git a/Makefile b/Makefile index 7e09622..63c93d8 100644 --- a/Makefile +++ b/Makefile @@ -1,8 +1,8 @@ BINARY=gearlib CC=gcc -CFLAGS=-O3 -Iinclude -LDFLAGS=-lglfw +CFLAGS=-O3 -Iinclude -g +LDFLAGS=-lglfw -lm CFILES=$(shell find -L src -type f -name '*.c') OBJ=$(CFILES:.c=.o) diff --git a/cat.png b/cat.png new file mode 100644 index 0000000000000000000000000000000000000000..593c672a87d18c9d07193a3d0375a744bc855576 GIT binary patch literal 126375 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нnwL3qq1EXKr&Ffa_O7HHgJ!9qruv9}nH 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 z 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
^(M>}_gHS@X?!;(|zG(r;(LNY*G??$l9ra^Qg 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 uint32_t compile_shader(const char* path, int32_t type); +uint32_t compile_shader_text(const char* name, const char* text, int32_t type); uint32_t load_shader_program(uint32_t shader, ...); #endif diff --git a/include/slibs.h b/include/slibs.h new file mode 100644 index 0000000..c16b334 --- /dev/null +++ b/include/slibs.h @@ -0,0 +1,194 @@ +#ifndef SLIBS_H +#define SLIBS_H + +#include +#include +#include +#include +#include + +#pragma region Miscellaneous + +#define sl_auto(name, x) typeof(x) name = x + +#define sl_new(type, ...) \ + ({ \ + type *ptr = malloc(sizeof(type)); \ + *ptr = (type){__VA_ARGS__}; \ + ptr; \ + }) + +#define sl_init(type, ...) \ + (type) { __VA_ARGS__ } + +#define sl_array_len(arr) sizeof(arr) / sizeof(arr[0]) + +#define sl_fmt_spec(arg) \ + _Generic((arg), \ + int8_t: "%d", \ + int16_t: "%d", \ + int32_t: "%d", \ + int64_t: "%lld", \ + uint8_t: "%u", \ + uint16_t: "%u", \ + uint32_t: "%lu", \ + uint64_t: "%llu", \ + double: "%lf", \ + float: "%f", \ + char: "%c", \ + char *: "%s", \ + void *: "%p", \ + default: "Unknown") + +#define sl_stringify(x) #x + +#pragma endregion +#pragma region Vector + +#define sl_vec(type) \ + struct { \ + type *data; \ + size_t size; \ + size_t capacity; \ + } + +#define sl_vec_grow(vec) \ + { \ + (vec).capacity = (vec).capacity * 2 + 1; \ + void *ptr = realloc((vec).data, (vec).capacity * sizeof(*(vec).data)); \ + if (ptr) \ + (vec).data = ptr; \ + } + +#define sl_vec_push(vec, element) \ + { \ + if ((vec).size >= (vec).capacity) \ + sl_vec_grow(vec); \ + (vec).data[(vec).size++] = (element); \ + } + +#define sl_vec_shift(vec, element) \ + { \ + if ((vec).size >= (vec).capacity) \ + sl_vec_grow(vec); \ + memmove((vec).data + 1, (vec).data, (vec).size * sizeof(*(vec).data)); \ + (vec).data[0] = (element); \ + (vec).size++; \ + } + +#define sl_vec_pop(vec) \ + { \ + if ((vec).size > 0) { \ + (vec).size--; \ + } \ + } + +#define sl_vec_at(vec, index) ((vec).data[index]) + +#define sl_vec_size(vec) ((vec).size) + +#define sl_vec_capacity(vec) ((vec).capacity) + +#define sl_vec_free(vec) free((vec).data) + +#define sl_vec_begin(vec) (vec).data + +#define sl_vec_end(vec) ((vec).data + (vec).size) + +#define sl_vec_it(name, vec) \ + sl_auto((name), sl_vec_begin(vec)); \ + (name) != sl_vec_end(vec); \ + ++(name) + +#pragma endregion +#pragma region String + +typedef sl_vec(char) sl_string; + +#define sl_string(c_str) \ + ({ \ + sl_string str = {0}; \ + for (size_t i = 0; i < strlen((c_str)); i++) \ + sl_vec_push(str, (c_str)[i]); \ + str; \ + }) + +#define sl_tostring(val) \ + ({ \ + sl_auto(len, snprintf(NULL, 0, sl_fmt_spec(val), val) + 1); \ + sl_auto(buf, (char *)malloc(len)); \ + snprintf(buf, len, sl_fmt_spec(val), val); \ + sl_auto(str, sl_string(buf)); \ + free(buf); \ + str; \ + }) + +#define sl_str_free(str) sl_vec_free(str) + +#define sl_c_str(str) \ + ({ \ + sl_vec_push((str), '\0'); \ + (str).size--; \ + (str).data; \ + }) + +#pragma endregion +#pragma region Pointers + +#define sl_ptr(type) \ + struct { \ + type *ptr; \ + int ref_count; \ + } + +#define sl_ptr_make(raw_ptr) \ + { raw_ptr, 1 } + +#define sl_ptr_release(smart_ptr) \ + ({ \ + smart_ptr.ref_count--; \ + if (smart_ptr.ref_count <= 0) { \ + free(smart_ptr.ptr); \ + } \ + }) + +#define sl_ptr_get(smart_ptr, raw_ptr_name, scope) \ + ({ \ + assert(smart_ptr.ref_count > 0 && "Smart pointer already released!"); \ + sl_auto(raw_ptr_name, smart_ptr.ptr); \ + smart_ptr.ref_count++; \ + scope; \ + sl_ptr_release(smart_ptr); \ + }); + +#define sl_ptr_scope(smart_ptr, scope) \ + ({ \ + scope; \ + sl_ptr_release(smart_ptr); \ + }); + +void sl_read_file(const char *filename, sl_string *buffer); + +#ifdef SL_IMPLEMENTATION +void sl_read_file(const char *filename, sl_string *buffer) { + FILE *file = fopen(filename, "r"); + if (!file) { + fprintf(stderr, "Error: could not open file %s\n", filename); + exit(1); + } + + fseek(file, 0, SEEK_END); + size_t file_size = ftell(file); + fseek(file, 0, SEEK_SET); + + for (size_t i = 0; i < file_size; i++) { + sl_vec_push(*buffer, fgetc(file)); + } + + fclose(file); +} +#endif + +#pragma endregion + +#endif // SLIBS_H diff --git a/include/stb_image.h b/include/stb_image.h new file mode 100644 index 0000000..a632d54 --- /dev/null +++ b/include/stb_image.h @@ -0,0 +1,7985 @@ +/* stb_image - v2.29 - 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.29 (2023-05-xx) optimizations + 2.28 (2023-01-29) many error fixes, security errors, just tons of stuff + 2.27 (2021-07-11) document stbi_info better, 16-bit PNM support, bug fixes + 2.26 (2020-07-13) many minor fixes + 2.25 (2020-02-02) fix warnings + 2.24 (2020-02-02) fix warnings; thread-local failure_reason and flip_vertically + 2.23 (2019-08-11) fix clang static analysis warning + 2.22 (2019-03-04) gif fixes, fix warnings + 2.21 (2019-02-25) fix typo in comment + 2.20 (2019-02-07) support utf8 filenames in Windows; fix warnings and platform ifdefs + 2.19 (2018-02-11) fix warning + 2.18 (2018-01-30) fix warnings + 2.17 (2018-01-29) bugfix, 1-bit BMP, 16-bitness query, fix warnings + 2.16 (2017-07-23) all functions have 16-bit variants; optimizations; bugfixes + 2.15 (2017-03-18) fix png-1,2,4; all Imagenet JPGs; no runtime SSE detection on GCC + 2.14 (2017-03-03) remove deprecated STBI_JPEG_OLD; fixes for Imagenet JPGs + 2.13 (2016-12-04) experimental 16-bit API, only for PNG so far; fixes + 2.12 (2016-04-02) fix typo in 2.11 PSD fix that caused crashes + 2.11 (2016-04-02) 16-bit PNGS; enable SSE2 in non-gcc x64 + RGB-format JPEG; remove white matting in PSD; + allocate large structures on the stack; + correct channel count for PNG & BMP + 2.10 (2016-01-22) avoid warning introduced in 2.09 + 2.09 (2016-01-16) 16-bit TGA; comments in PNM files; STBI_REALLOC_SIZED + + See end of file for full revision history. + + + ============================ Contributors ========================= + + Image formats Extensions, features + Sean Barrett (jpeg, png, bmp) Jetro Lauha (stbi_info) + Nicolas Schulz (hdr, psd) Martin "SpartanJ" Golini (stbi_info) + Jonathan Dummer (tga) James "moose2000" Brown (iPhone PNG) + Jean-Marc Lienher (gif) Ben "Disch" Wenger (io callbacks) + Tom Seddon (pic) Omar Cornut (1/2/4-bit PNG) + Thatcher Ulrich (psd) Nicolas Guillemot (vertical flip) + Ken Miller (pgm, ppm) Richard Mitton (16-bit PSD) + github:urraka (animated gif) Junggon Kim (PNM comments) + Christopher Forseth (animated gif) Daniel Gibson (16-bit TGA) + socks-the-fox (16-bit PNG) + Jeremy Sawicki (handle all ImageNet JPGs) + Optimizations & bugfixes Mikhail Morozov (1-bit BMP) + Fabian "ryg" Giesen Anael Seghezzi (is-16-bit query) + Arseny Kapoulkine Simon Breuss (16-bit PNM) + John-Mark Allen + Carmelo J Fdez-Aguera + + Bug & warning fixes + Marc LeBlanc David Woo Guillaume George Martins Mozeiko + Christpher Lloyd Jerry Jansson Joseph Thomson Blazej Dariusz Roszkowski + Phil Jordan Dave Moore Roy Eltham + Hayaki Saito Nathan Reed Won Chun + Luke Graham Johan Duparc Nick Verigakis the Horde3D community + Thomas Ruf Ronny Chevalier github:rlyeh + Janez Zemva John Bartholomew Michal Cichon github:romigrou + Jonathan Blow Ken Hamada Tero Hanninen github:svdijk + Eugene Golushkov Laurent Gomila Cort Stratton github:snagar + Aruelien Pocheville Sergio Gonzalez Thibault Reuille github:Zelex + Cass Everitt Ryamond Barbiero github:grim210 + Paul Du Bois Engin Manap Aldo Culquicondor github:sammyhw + Philipp Wiesemann Dale Weiler Oriol Ferrer Mesia github:phprus + Josh Tobin Neil Bickford Matthew Gregan github:poppolopoppo + Julian Raschke Gregory Mullen Christian Floisand github:darealshinji + Baldur Karlsson Kevin Schmidt JR Smith github:Michaelangel007 + Brad Weinberger Matvey Cherevko github:mosra + Luca Sas Alexander Veselov Zack Middleton [reserved] + Ryan C. Gordon [reserved] [reserved] + DO NOT ADD YOUR NAME HERE + + Jacko Dirks + + To add your name to the credits, pick a random blank space in the middle and fill it. + 80% of merge conflicts on stb PRs are due to people adding their name at the end + of the credits. +*/ + +#ifndef STBI_INCLUDE_STB_IMAGE_H +#define STBI_INCLUDE_STB_IMAGE_H + +// DOCUMENTATION +// +// Limitations: +// - no 12-bit-per-channel JPEG +// - no JPEGs with arithmetic coding +// - GIF always returns *comp=4 +// +// Basic usage (see HDR discussion below for HDR usage): +// int x,y,n; +// unsigned char *data = stbi_load(filename, &x, &y, &n, 0); +// // ... process data if not NULL ... +// // ... x = width, y = height, n = # 8-bit components per pixel ... +// // ... replace '0' with '1'..'4' to force that many components per pixel +// // ... but 'n' will always be the number that it would have been if you said 0 +// stbi_image_free(data); +// +// Standard parameters: +// int *x -- outputs image width in pixels +// int *y -- outputs image height in pixels +// int *channels_in_file -- outputs # of image components in image file +// int desired_channels -- if non-zero, # of image components requested in result +// +// The return value from an image loader is an 'unsigned char *' which points +// to the pixel data, or NULL on an allocation failure or if the image is +// corrupt or invalid. The pixel data consists of *y scanlines of *x pixels, +// with each pixel consisting of N interleaved 8-bit components; the first +// pixel pointed to is top-left-most in the image. There is no padding between +// image scanlines or between pixels, regardless of format. The number of +// components N is 'desired_channels' if desired_channels is non-zero, or +// *channels_in_file otherwise. If desired_channels is non-zero, +// *channels_in_file has the number of components that _would_ have been +// output otherwise. E.g. if you set desired_channels to 4, you will always +// get RGBA output, but you can check *channels_in_file to see if it's trivially +// opaque because e.g. there were only 3 channels in the source image. +// +// An output image with N components has the following components interleaved +// in this order in each pixel: +// +// N=#comp components +// 1 grey +// 2 grey, alpha +// 3 red, green, blue +// 4 red, green, blue, alpha +// +// If image loading fails for any reason, the return value will be NULL, +// and *x, *y, *channels_in_file will be unchanged. The function +// stbi_failure_reason() can be queried for an extremely brief, end-user +// unfriendly explanation of why the load failed. Define STBI_NO_FAILURE_STRINGS +// to avoid compiling these strings at all, and STBI_FAILURE_USERMSG to get slightly +// more user-friendly ones. +// +// Paletted PNG, BMP, GIF, and PIC images are automatically depalettized. +// +// To query the width, height and component count of an image without having to +// decode the full file, you can use the stbi_info family of functions: +// +// int x,y,n,ok; +// ok = stbi_info(filename, &x, &y, &n); +// // returns ok=1 and sets x, y, n if image is a supported format, +// // 0 otherwise. +// +// Note that stb_image pervasively uses ints in its public API for sizes, +// including sizes of memory buffers. This is now part of the API and thus +// hard to change without causing breakage. As a result, the various image +// loaders all have certain limits on image size; these differ somewhat +// by format but generally boil down to either just under 2GB or just under +// 1GB. When the decoded image would be larger than this, stb_image decoding +// will fail. +// +// Additionally, stb_image will reject image files that have any of their +// dimensions set to a larger value than the configurable STBI_MAX_DIMENSIONS, +// which defaults to 2**24 = 16777216 pixels. Due to the above memory limit, +// the only way to have an image with such dimensions load correctly +// is for it to have a rather extreme aspect ratio. Either way, the +// assumption here is that such larger images are likely to be malformed +// or malicious. If you do need to load an image with individual dimensions +// larger than that, and it still fits in the overall size limit, you can +// #define STBI_MAX_DIMENSIONS on your own to be something larger. +// +// =========================================================================== +// +// UNICODE: +// +// If compiling for Windows and you wish to use Unicode filenames, compile +// with +// #define STBI_WINDOWS_UTF8 +// and pass utf8-encoded filenames. Call stbi_convert_wchar_to_utf8 to convert +// Windows wchar_t filenames to utf8. +// +// =========================================================================== +// +// Philosophy +// +// stb libraries are designed with the following priorities: +// +// 1. easy to use +// 2. easy to maintain +// 3. good performance +// +// Sometimes I let "good performance" creep up in priority over "easy to maintain", +// and for best performance I may provide less-easy-to-use APIs that give higher +// performance, in addition to the easy-to-use ones. Nevertheless, it's important +// to keep in mind that from the standpoint of you, a client of this library, +// all you care about is #1 and #3, and stb libraries DO NOT emphasize #3 above all. +// +// Some secondary priorities arise directly from the first two, some of which +// provide more explicit reasons why performance can't be emphasized. +// +// - Portable ("ease of use") +// - Small source code footprint ("easy to maintain") +// - No dependencies ("ease of use") +// +// =========================================================================== +// +// I/O callbacks +// +// I/O callbacks allow you to read from arbitrary sources, like packaged +// files or some other source. Data read from callbacks are processed +// through a small internal buffer (currently 128 bytes) to try to reduce +// overhead. +// +// The three functions you must define are "read" (reads some bytes of data), +// "skip" (skips some bytes of data), "eof" (reports if the stream is at the end). +// +// =========================================================================== +// +// SIMD support +// +// The JPEG decoder will try to automatically use SIMD kernels on x86 when +// supported by the compiler. For ARM Neon support, you must explicitly +// request it. +// +// (The old do-it-yourself SIMD API is no longer supported in the current +// code.) +// +// On x86, SSE2 will automatically be used when available based on a run-time +// test; if not, the generic C versions are used as a fall-back. On ARM targets, +// the typical path is to have separate builds for NEON and non-NEON devices +// (at least this is true for iOS and Android). Therefore, the NEON support is +// toggled by a build flag: define STBI_NEON to get NEON loops. +// +// If for some reason you do not want to use any of SIMD code, or if +// you have issues compiling it, you can disable it entirely by +// defining STBI_NO_SIMD. +// +// =========================================================================== +// +// HDR image support (disable by defining STBI_NO_HDR) +// +// stb_image supports loading HDR images in general, and currently the Radiance +// .HDR file format specifically. You can still load any file through the existing +// interface; if you attempt to load an HDR file, it will be automatically remapped +// to LDR, assuming gamma 2.2 and an arbitrary scale factor defaulting to 1; +// both of these constants can be reconfigured through this interface: +// +// stbi_hdr_to_ldr_gamma(2.2f); +// stbi_hdr_to_ldr_scale(1.0f); +// +// (note, do not use _inverse_ constants; stbi_image will invert them +// appropriately). +// +// Additionally, there is a new, parallel interface for loading files as +// (linear) floats to preserve the full dynamic range: +// +// float *data = stbi_loadf(filename, &x, &y, &n, 0); +// +// If you load LDR images through this interface, those images will +// be promoted to floating point values, run through the inverse of +// constants corresponding to the above: +// +// stbi_ldr_to_hdr_scale(1.0f); +// stbi_ldr_to_hdr_gamma(2.2f); +// +// Finally, given a filename (or an open file or memory block--see header +// file for details) containing image data, you can query for the "most +// appropriate" interface to use (that is, whether the image is HDR or +// not), using: +// +// stbi_is_hdr(char *filename); +// +// =========================================================================== +// +// iPhone PNG support: +// +// We optionally support converting iPhone-formatted PNGs (which store +// premultiplied BGRA) back to RGB, even though they're internally encoded +// differently. To enable this conversion, call +// stbi_convert_iphone_png_to_rgb(1). +// +// Call stbi_set_unpremultiply_on_load(1) as well to force a divide per +// pixel to remove any premultiplied alpha *only* if the image file explicitly +// says there's premultiplied data (currently only happens in iPhone images, +// and only if iPhone convert-to-rgb processing is on). +// +// =========================================================================== +// +// ADDITIONAL CONFIGURATION +// +// - You can suppress implementation of any of the decoders to reduce +// your code footprint by #defining one or more of the following +// symbols before creating the implementation. +// +// STBI_NO_JPEG +// STBI_NO_PNG +// STBI_NO_BMP +// STBI_NO_PSD +// STBI_NO_TGA +// STBI_NO_GIF +// STBI_NO_HDR +// STBI_NO_PIC +// STBI_NO_PNM (.ppm and .pgm) +// +// - You can request *only* certain decoders and suppress all other ones +// (this will be more forward-compatible, as addition of new decoders +// doesn't require you to disable them explicitly): +// +// STBI_ONLY_JPEG +// STBI_ONLY_PNG +// STBI_ONLY_BMP +// STBI_ONLY_PSD +// STBI_ONLY_TGA +// STBI_ONLY_GIF +// STBI_ONLY_HDR +// STBI_ONLY_PIC +// STBI_ONLY_PNM (.ppm and .pgm) +// +// - If you use STBI_NO_PNG (or _ONLY_ without PNG), and you still +// want the zlib decoder to be available, #define STBI_SUPPORT_ZLIB +// +// - If you define STBI_MAX_DIMENSIONS, stb_image will reject images greater +// than that size (in either width or height) without further processing. +// This is to let programs in the wild set an upper bound to prevent +// denial-of-service attacks on untrusted data, as one could generate a +// valid image of gigantic dimensions and force stb_image to allocate a +// huge block of memory and spend disproportionate time decoding it. By +// default this is set to (1 << 24), which is 16777216, but that's still +// very big. + +#ifndef STBI_NO_STDIO +#include +#endif // STBI_NO_STDIO + +#define STBI_VERSION 1 + +enum +{ + STBI_default = 0, // only used for desired_channels + + STBI_grey = 1, + STBI_grey_alpha = 2, + STBI_rgb = 3, + STBI_rgb_alpha = 4 +}; + +#include +typedef unsigned char stbi_uc; +typedef unsigned short stbi_us; + +#ifdef __cplusplus +extern "C" { +#endif + +#ifndef STBIDEF +#ifdef STB_IMAGE_STATIC +#define STBIDEF static +#else +#define STBIDEF extern +#endif +#endif + +////////////////////////////////////////////////////////////////////////////// +// +// PRIMARY API - works on images of any type +// + +// +// load image by filename, open file, or memory buffer +// + +typedef struct +{ + int (*read) (void *user,char *data,int size); // fill 'data' with 'size' bytes. return number of bytes actually read + void (*skip) (void *user,int n); // skip the next 'n' bytes, or 'unget' the last -n bytes if negative + int (*eof) (void *user); // returns nonzero if we are at end of file/data +} stbi_io_callbacks; + +//////////////////////////////////// +// +// 8-bits-per-channel interface +// + +STBIDEF stbi_uc *stbi_load_from_memory (stbi_uc const *buffer, int len , int *x, int *y, int *channels_in_file, int desired_channels); +STBIDEF stbi_uc *stbi_load_from_callbacks(stbi_io_callbacks const *clbk , void *user, int *x, int *y, int *channels_in_file, int desired_channels); + +#ifndef STBI_NO_STDIO +STBIDEF stbi_uc *stbi_load (char const *filename, int *x, int *y, int *channels_in_file, int desired_channels); +STBIDEF stbi_uc *stbi_load_from_file (FILE *f, int *x, int *y, int *channels_in_file, int desired_channels); +// for stbi_load_from_file, file pointer is left pointing immediately after image +#endif + +#ifndef STBI_NO_GIF +STBIDEF stbi_uc *stbi_load_gif_from_memory(stbi_uc const *buffer, int len, int **delays, int *x, int *y, int *z, int *comp, int req_comp); +#endif + +#ifdef STBI_WINDOWS_UTF8 +STBIDEF int stbi_convert_wchar_to_utf8(char *buffer, size_t bufferlen, const wchar_t* input); +#endif + +//////////////////////////////////// +// +// 16-bits-per-channel interface +// + +STBIDEF stbi_us *stbi_load_16_from_memory (stbi_uc const *buffer, int len, int *x, int *y, int *channels_in_file, int desired_channels); +STBIDEF stbi_us *stbi_load_16_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *channels_in_file, int desired_channels); + +#ifndef STBI_NO_STDIO +STBIDEF stbi_us *stbi_load_16 (char const *filename, int *x, int *y, int *channels_in_file, int desired_channels); +STBIDEF stbi_us *stbi_load_from_file_16(FILE *f, int *x, int *y, int *channels_in_file, int desired_channels); +#endif + +//////////////////////////////////// +// +// float-per-channel interface +// +#ifndef STBI_NO_LINEAR + STBIDEF float *stbi_loadf_from_memory (stbi_uc const *buffer, int len, int *x, int *y, int *channels_in_file, int desired_channels); + STBIDEF float *stbi_loadf_from_callbacks (stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *channels_in_file, int desired_channels); + + #ifndef STBI_NO_STDIO + STBIDEF float *stbi_loadf (char const *filename, int *x, int *y, int *channels_in_file, int desired_channels); + STBIDEF float *stbi_loadf_from_file (FILE *f, int *x, int *y, int *channels_in_file, int desired_channels); + #endif +#endif + +#ifndef STBI_NO_HDR + STBIDEF void stbi_hdr_to_ldr_gamma(float gamma); + STBIDEF void stbi_hdr_to_ldr_scale(float scale); +#endif // STBI_NO_HDR + +#ifndef STBI_NO_LINEAR + STBIDEF void stbi_ldr_to_hdr_gamma(float gamma); + STBIDEF void stbi_ldr_to_hdr_scale(float scale); +#endif // STBI_NO_LINEAR + +// stbi_is_hdr is always defined, but always returns false if STBI_NO_HDR +STBIDEF int stbi_is_hdr_from_callbacks(stbi_io_callbacks const *clbk, void *user); +STBIDEF int stbi_is_hdr_from_memory(stbi_uc const *buffer, int len); +#ifndef STBI_NO_STDIO +STBIDEF int stbi_is_hdr (char const *filename); +STBIDEF int stbi_is_hdr_from_file(FILE *f); +#endif // STBI_NO_STDIO + + +// get a VERY brief reason for failure +// on most compilers (and ALL modern mainstream compilers) this is threadsafe +STBIDEF const char *stbi_failure_reason (void); + +// free the loaded image -- this is just free() +STBIDEF void stbi_image_free (void *retval_from_stbi_load); + +// get image dimensions & components without fully decoding +STBIDEF int stbi_info_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp); +STBIDEF int stbi_info_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *comp); +STBIDEF int stbi_is_16_bit_from_memory(stbi_uc const *buffer, int len); +STBIDEF int stbi_is_16_bit_from_callbacks(stbi_io_callbacks const *clbk, void *user); + +#ifndef STBI_NO_STDIO +STBIDEF int stbi_info (char const *filename, int *x, int *y, int *comp); +STBIDEF int stbi_info_from_file (FILE *f, int *x, int *y, int *comp); +STBIDEF int stbi_is_16_bit (char const *filename); +STBIDEF int stbi_is_16_bit_from_file(FILE *f); +#endif + + + +// for image formats that explicitly notate that they have premultiplied alpha, +// we just return the colors as stored in the file. set this flag to force +// unpremultiplication. results are undefined if the unpremultiply overflow. +STBIDEF void stbi_set_unpremultiply_on_load(int flag_true_if_should_unpremultiply); + +// indicate whether we should process iphone images back to canonical format, +// or just pass them through "as-is" +STBIDEF void stbi_convert_iphone_png_to_rgb(int flag_true_if_should_convert); + +// flip the image vertically, so the first pixel in the output array is the bottom left +STBIDEF void stbi_set_flip_vertically_on_load(int flag_true_if_should_flip); + +// as above, but only applies to images loaded on the thread that calls the function +// this function is only available if your compiler supports thread-local variables; +// calling it will fail to link if your compiler doesn't +STBIDEF void stbi_set_unpremultiply_on_load_thread(int flag_true_if_should_unpremultiply); +STBIDEF void stbi_convert_iphone_png_to_rgb_thread(int flag_true_if_should_convert); +STBIDEF void stbi_set_flip_vertically_on_load_thread(int flag_true_if_should_flip); + +// ZLIB client - used by PNG, available for other purposes + +STBIDEF char *stbi_zlib_decode_malloc_guesssize(const char *buffer, int len, int initial_size, int *outlen); +STBIDEF char *stbi_zlib_decode_malloc_guesssize_headerflag(const char *buffer, int len, int initial_size, int *outlen, int parse_header); +STBIDEF char *stbi_zlib_decode_malloc(const char *buffer, int len, int *outlen); +STBIDEF int stbi_zlib_decode_buffer(char *obuffer, int olen, const char *ibuffer, int ilen); + +STBIDEF char *stbi_zlib_decode_noheader_malloc(const char *buffer, int len, int *outlen); +STBIDEF int stbi_zlib_decode_noheader_buffer(char *obuffer, int olen, const char *ibuffer, int ilen); + + +#ifdef __cplusplus +} +#endif + +// +// +//// end header file ///////////////////////////////////////////////////// +#endif // STBI_INCLUDE_STB_IMAGE_H + +#ifdef STB_IMAGE_IMPLEMENTATION + +#if defined(STBI_ONLY_JPEG) || defined(STBI_ONLY_PNG) || defined(STBI_ONLY_BMP) \ + || defined(STBI_ONLY_TGA) || defined(STBI_ONLY_GIF) || defined(STBI_ONLY_PSD) \ + || defined(STBI_ONLY_HDR) || defined(STBI_ONLY_PIC) || defined(STBI_ONLY_PNM) \ + || defined(STBI_ONLY_ZLIB) + #ifndef STBI_ONLY_JPEG + #define STBI_NO_JPEG + #endif + #ifndef STBI_ONLY_PNG + #define STBI_NO_PNG + #endif + #ifndef STBI_ONLY_BMP + #define STBI_NO_BMP + #endif + #ifndef STBI_ONLY_PSD + #define STBI_NO_PSD + #endif + #ifndef STBI_ONLY_TGA + #define STBI_NO_TGA + #endif + #ifndef STBI_ONLY_GIF + #define STBI_NO_GIF + #endif + #ifndef STBI_ONLY_HDR + #define STBI_NO_HDR + #endif + #ifndef STBI_ONLY_PIC + #define STBI_NO_PIC + #endif + #ifndef STBI_ONLY_PNM + #define STBI_NO_PNM + #endif +#endif + +#if defined(STBI_NO_PNG) && !defined(STBI_SUPPORT_ZLIB) && !defined(STBI_NO_ZLIB) +#define STBI_NO_ZLIB +#endif + + +#include +#include // ptrdiff_t on osx +#include +#include +#include + +#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR) +#include // ldexp, pow +#endif + +#ifndef STBI_NO_STDIO +#include +#endif + +#ifndef STBI_ASSERT +#include +#define STBI_ASSERT(x) assert(x) +#endif + +#ifdef __cplusplus +#define STBI_EXTERN extern "C" +#else +#define STBI_EXTERN extern +#endif + + +#ifndef _MSC_VER + #ifdef __cplusplus + #define stbi_inline inline + #else + #define stbi_inline + #endif +#else + #define stbi_inline __forceinline +#endif + +#ifndef STBI_NO_THREAD_LOCALS + #if defined(__cplusplus) && __cplusplus >= 201103L + #define STBI_THREAD_LOCAL thread_local + #elif defined(__GNUC__) && __GNUC__ < 5 + #define STBI_THREAD_LOCAL __thread + #elif defined(_MSC_VER) + #define STBI_THREAD_LOCAL __declspec(thread) + #elif defined (__STDC_VERSION__) && __STDC_VERSION__ >= 201112L && !defined(__STDC_NO_THREADS__) + #define STBI_THREAD_LOCAL _Thread_local + #endif + + #ifndef STBI_THREAD_LOCAL + #if defined(__GNUC__) + #define STBI_THREAD_LOCAL __thread + #endif + #endif +#endif + +#if defined(_MSC_VER) || defined(__SYMBIAN32__) +typedef unsigned short stbi__uint16; +typedef signed short stbi__int16; +typedef unsigned int stbi__uint32; +typedef signed int stbi__int32; +#else +#include +typedef uint16_t stbi__uint16; +typedef int16_t stbi__int16; +typedef uint32_t stbi__uint32; +typedef int32_t stbi__int32; +#endif + +// should produce compiler error if size is wrong +typedef unsigned char validate_uint32[sizeof(stbi__uint32)==4 ? 1 : -1]; + +#ifdef _MSC_VER +#define STBI_NOTUSED(v) (void)(v) +#else +#define STBI_NOTUSED(v) (void)sizeof(v) +#endif + +#ifdef _MSC_VER +#define STBI_HAS_LROTL +#endif + +#ifdef STBI_HAS_LROTL + #define stbi_lrot(x,y) _lrotl(x,y) +#else + #define stbi_lrot(x,y) (((x) << (y)) | ((x) >> (-(y) & 31))) +#endif + +#if defined(STBI_MALLOC) && defined(STBI_FREE) && (defined(STBI_REALLOC) || defined(STBI_REALLOC_SIZED)) +// ok +#elif !defined(STBI_MALLOC) && !defined(STBI_FREE) && !defined(STBI_REALLOC) && !defined(STBI_REALLOC_SIZED) +// ok +#else +#error "Must define all or none of STBI_MALLOC, STBI_FREE, and STBI_REALLOC (or STBI_REALLOC_SIZED)." +#endif + +#ifndef STBI_MALLOC +#define STBI_MALLOC(sz) malloc(sz) +#define STBI_REALLOC(p,newsz) realloc(p,newsz) +#define STBI_FREE(p) free(p) +#endif + +#ifndef STBI_REALLOC_SIZED +#define STBI_REALLOC_SIZED(p,oldsz,newsz) STBI_REALLOC(p,newsz) +#endif + +// x86/x64 detection +#if defined(__x86_64__) || defined(_M_X64) +#define STBI__X64_TARGET +#elif defined(__i386) || defined(_M_IX86) +#define STBI__X86_TARGET +#endif + +#if defined(__GNUC__) && defined(STBI__X86_TARGET) && !defined(__SSE2__) && !defined(STBI_NO_SIMD) +// gcc doesn't support sse2 intrinsics unless you compile with -msse2, +// which in turn means it gets to use SSE2 everywhere. This is unfortunate, +// but previous attempts to provide the SSE2 functions with runtime +// detection caused numerous issues. The way architecture extensions are +// exposed in GCC/Clang is, sadly, not really suited for one-file libs. +// New behavior: if compiled with -msse2, we use SSE2 without any +// detection; if not, we don't use it at all. +#define STBI_NO_SIMD +#endif + +#if defined(__MINGW32__) && defined(STBI__X86_TARGET) && !defined(STBI_MINGW_ENABLE_SSE2) && !defined(STBI_NO_SIMD) +// Note that __MINGW32__ doesn't actually mean 32-bit, so we have to avoid STBI__X64_TARGET +// +// 32-bit MinGW wants ESP to be 16-byte aligned, but this is not in the +// Windows ABI and VC++ as well as Windows DLLs don't maintain that invariant. +// As a result, enabling SSE2 on 32-bit MinGW is dangerous when not +// simultaneously enabling "-mstackrealign". +// +// See https://github.com/nothings/stb/issues/81 for more information. +// +// So default to no SSE2 on 32-bit MinGW. If you've read this far and added +// -mstackrealign to your build settings, feel free to #define STBI_MINGW_ENABLE_SSE2. +#define STBI_NO_SIMD +#endif + +#if !defined(STBI_NO_SIMD) && (defined(STBI__X86_TARGET) || defined(STBI__X64_TARGET)) +#define STBI_SSE2 +#include + +#ifdef _MSC_VER + +#if _MSC_VER >= 1400 // not VC6 +#include // __cpuid +static int stbi__cpuid3(void) +{ + int info[4]; + __cpuid(info,1); + return info[3]; +} +#else +static int stbi__cpuid3(void) +{ + int res; + __asm { + mov eax,1 + cpuid + mov res,edx + } + return res; +} +#endif + +#define STBI_SIMD_ALIGN(type, name) __declspec(align(16)) type name + +#if !defined(STBI_NO_JPEG) && defined(STBI_SSE2) +static int stbi__sse2_available(void) +{ + int info3 = stbi__cpuid3(); + return ((info3 >> 26) & 1) != 0; +} +#endif + +#else // assume GCC-style if not VC++ +#define STBI_SIMD_ALIGN(type, name) type name __attribute__((aligned(16))) + +#if !defined(STBI_NO_JPEG) && defined(STBI_SSE2) +static int stbi__sse2_available(void) +{ + // If we're even attempting to compile this on GCC/Clang, that means + // -msse2 is on, which means the compiler is allowed to use SSE2 + // instructions at will, and so are we. + return 1; +} +#endif + +#endif +#endif + +// ARM NEON +#if defined(STBI_NO_SIMD) && defined(STBI_NEON) +#undef STBI_NEON +#endif + +#ifdef STBI_NEON +#include +#ifdef _MSC_VER +#define STBI_SIMD_ALIGN(type, name) __declspec(align(16)) type name +#else +#define STBI_SIMD_ALIGN(type, name) type name __attribute__((aligned(16))) +#endif +#endif + +#ifndef STBI_SIMD_ALIGN +#define STBI_SIMD_ALIGN(type, name) type name +#endif + +#ifndef STBI_MAX_DIMENSIONS +#define STBI_MAX_DIMENSIONS (1 << 24) +#endif + +/////////////////////////////////////////////// +// +// stbi__context struct and start_xxx functions + +// stbi__context structure is our basic context used by all images, so it +// contains all the IO context, plus some basic image information +typedef struct +{ + stbi__uint32 img_x, img_y; + int img_n, img_out_n; + + stbi_io_callbacks io; + void *io_user_data; + + int read_from_callbacks; + int buflen; + stbi_uc buffer_start[128]; + int callback_already_read; + + stbi_uc *img_buffer, *img_buffer_end; + stbi_uc *img_buffer_original, *img_buffer_original_end; +} stbi__context; + + +static void stbi__refill_buffer(stbi__context *s); + +// initialize a memory-decode context +static void stbi__start_mem(stbi__context *s, stbi_uc const *buffer, int len) +{ + s->io.read = NULL; + s->read_from_callbacks = 0; + s->callback_already_read = 0; + s->img_buffer = s->img_buffer_original = (stbi_uc *) buffer; + s->img_buffer_end = s->img_buffer_original_end = (stbi_uc *) buffer+len; +} + +// initialize a callback-based context +static void stbi__start_callbacks(stbi__context *s, stbi_io_callbacks *c, void *user) +{ + s->io = *c; + s->io_user_data = user; + s->buflen = sizeof(s->buffer_start); + s->read_from_callbacks = 1; + s->callback_already_read = 0; + s->img_buffer = s->img_buffer_original = s->buffer_start; + stbi__refill_buffer(s); + s->img_buffer_original_end = s->img_buffer_end; +} + +#ifndef STBI_NO_STDIO + +static int stbi__stdio_read(void *user, char *data, int size) +{ + return (int) fread(data,1,size,(FILE*) user); +} + +static void stbi__stdio_skip(void *user, int n) +{ + int ch; + fseek((FILE*) user, n, SEEK_CUR); + ch = fgetc((FILE*) user); /* have to read a byte to reset feof()'s flag */ + if (ch != EOF) { + ungetc(ch, (FILE *) user); /* push byte back onto stream if valid. */ + } +} + +static int stbi__stdio_eof(void *user) +{ + return feof((FILE*) user) || ferror((FILE *) user); +} + +static stbi_io_callbacks stbi__stdio_callbacks = +{ + stbi__stdio_read, + stbi__stdio_skip, + stbi__stdio_eof, +}; + +static void stbi__start_file(stbi__context *s, FILE *f) +{ + stbi__start_callbacks(s, &stbi__stdio_callbacks, (void *) f); +} + +//static void stop_file(stbi__context *s) { } + +#endif // !STBI_NO_STDIO + +static void stbi__rewind(stbi__context *s) +{ + // conceptually rewind SHOULD rewind to the beginning of the stream, + // but we just rewind to the beginning of the initial buffer, because + // we only use it after doing 'test', which only ever looks at at most 92 bytes + s->img_buffer = s->img_buffer_original; + s->img_buffer_end = s->img_buffer_original_end; +} + +enum +{ + STBI_ORDER_RGB, + STBI_ORDER_BGR +}; + +typedef struct +{ + int bits_per_channel; + int num_channels; + int channel_order; +} stbi__result_info; + +#ifndef STBI_NO_JPEG +static int stbi__jpeg_test(stbi__context *s); +static void *stbi__jpeg_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static int stbi__jpeg_info(stbi__context *s, int *x, int *y, int *comp); +#endif + +#ifndef STBI_NO_PNG +static int stbi__png_test(stbi__context *s); +static void *stbi__png_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static int stbi__png_info(stbi__context *s, int *x, int *y, int *comp); +static int stbi__png_is16(stbi__context *s); +#endif + +#ifndef STBI_NO_BMP +static int stbi__bmp_test(stbi__context *s); +static void *stbi__bmp_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static int stbi__bmp_info(stbi__context *s, int *x, int *y, int *comp); +#endif + +#ifndef STBI_NO_TGA +static int stbi__tga_test(stbi__context *s); +static void *stbi__tga_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static int stbi__tga_info(stbi__context *s, int *x, int *y, int *comp); +#endif + +#ifndef STBI_NO_PSD +static int stbi__psd_test(stbi__context *s); +static void *stbi__psd_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri, int bpc); +static int stbi__psd_info(stbi__context *s, int *x, int *y, int *comp); +static int stbi__psd_is16(stbi__context *s); +#endif + +#ifndef STBI_NO_HDR +static int stbi__hdr_test(stbi__context *s); +static float *stbi__hdr_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static int stbi__hdr_info(stbi__context *s, int *x, int *y, int *comp); +#endif + +#ifndef STBI_NO_PIC +static int stbi__pic_test(stbi__context *s); +static void *stbi__pic_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static int stbi__pic_info(stbi__context *s, int *x, int *y, int *comp); +#endif + +#ifndef STBI_NO_GIF +static int stbi__gif_test(stbi__context *s); +static void *stbi__gif_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static void *stbi__load_gif_main(stbi__context *s, int **delays, int *x, int *y, int *z, int *comp, int req_comp); +static int stbi__gif_info(stbi__context *s, int *x, int *y, int *comp); +#endif + +#ifndef STBI_NO_PNM +static int stbi__pnm_test(stbi__context *s); +static void *stbi__pnm_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static int stbi__pnm_info(stbi__context *s, int *x, int *y, int *comp); +static int stbi__pnm_is16(stbi__context *s); +#endif + +static +#ifdef STBI_THREAD_LOCAL +STBI_THREAD_LOCAL +#endif +const char *stbi__g_failure_reason; + +STBIDEF const char *stbi_failure_reason(void) +{ + return stbi__g_failure_reason; +} + +#ifndef STBI_NO_FAILURE_STRINGS +static int stbi__err(const char *str) +{ + stbi__g_failure_reason = str; + return 0; +} +#endif + +static void *stbi__malloc(size_t size) +{ + return STBI_MALLOC(size); +} + +// stb_image uses ints pervasively, including for offset calculations. +// therefore the largest decoded image size we can support with the +// current code, even on 64-bit targets, is INT_MAX. this is not a +// significant limitation for the intended use case. +// +// we do, however, need to make sure our size calculations don't +// overflow. hence a few helper functions for size calculations that +// multiply integers together, making sure that they're non-negative +// and no overflow occurs. + +// return 1 if the sum is valid, 0 on overflow. +// negative terms are considered invalid. +static int stbi__addsizes_valid(int a, int b) +{ + if (b < 0) return 0; + // now 0 <= b <= INT_MAX, hence also + // 0 <= INT_MAX - b <= INTMAX. + // And "a + b <= INT_MAX" (which might overflow) is the + // same as a <= INT_MAX - b (no overflow) + return a <= INT_MAX - b; +} + +// returns 1 if the product is valid, 0 on overflow. +// negative factors are considered invalid. +static int stbi__mul2sizes_valid(int a, int b) +{ + if (a < 0 || b < 0) return 0; + if (b == 0) return 1; // mul-by-0 is always safe + // portable way to check for no overflows in a*b + return a <= INT_MAX/b; +} + +#if !defined(STBI_NO_JPEG) || !defined(STBI_NO_PNG) || !defined(STBI_NO_TGA) || !defined(STBI_NO_HDR) +// returns 1 if "a*b + add" has no negative terms/factors and doesn't overflow +static int stbi__mad2sizes_valid(int a, int b, int add) +{ + return stbi__mul2sizes_valid(a, b) && stbi__addsizes_valid(a*b, add); +} +#endif + +// returns 1 if "a*b*c + add" has no negative terms/factors and doesn't overflow +static int stbi__mad3sizes_valid(int a, int b, int c, int add) +{ + return stbi__mul2sizes_valid(a, b) && stbi__mul2sizes_valid(a*b, c) && + stbi__addsizes_valid(a*b*c, add); +} + +// returns 1 if "a*b*c*d + add" has no negative terms/factors and doesn't overflow +#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR) || !defined(STBI_NO_PNM) +static int stbi__mad4sizes_valid(int a, int b, int c, int d, int add) +{ + return stbi__mul2sizes_valid(a, b) && stbi__mul2sizes_valid(a*b, c) && + stbi__mul2sizes_valid(a*b*c, d) && stbi__addsizes_valid(a*b*c*d, add); +} +#endif + +#if !defined(STBI_NO_JPEG) || !defined(STBI_NO_PNG) || !defined(STBI_NO_TGA) || !defined(STBI_NO_HDR) +// mallocs with size overflow checking +static void *stbi__malloc_mad2(int a, int b, int add) +{ + if (!stbi__mad2sizes_valid(a, b, add)) return NULL; + return stbi__malloc(a*b + add); +} +#endif + +static void *stbi__malloc_mad3(int a, int b, int c, int add) +{ + if (!stbi__mad3sizes_valid(a, b, c, add)) return NULL; + return stbi__malloc(a*b*c + add); +} + +#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR) || !defined(STBI_NO_PNM) +static void *stbi__malloc_mad4(int a, int b, int c, int d, int add) +{ + if (!stbi__mad4sizes_valid(a, b, c, d, add)) return NULL; + return stbi__malloc(a*b*c*d + add); +} +#endif + +// returns 1 if the sum of two signed ints is valid (between -2^31 and 2^31-1 inclusive), 0 on overflow. +static int stbi__addints_valid(int a, int b) +{ + if ((a >= 0) != (b >= 0)) return 1; // a and b have different signs, so no overflow + if (a < 0 && b < 0) return a >= INT_MIN - b; // same as a + b >= INT_MIN; INT_MIN - b cannot overflow since b < 0. + return a <= INT_MAX - b; +} + +// returns 1 if the product of two ints fits in a signed short, 0 on overflow. +static int stbi__mul2shorts_valid(int a, int b) +{ + if (b == 0 || b == -1) return 1; // multiplication by 0 is always 0; check for -1 so SHRT_MIN/b doesn't overflow + if ((a >= 0) == (b >= 0)) return a <= SHRT_MAX/b; // product is positive, so similar to mul2sizes_valid + if (b < 0) return a <= SHRT_MIN / b; // same as a * b >= SHRT_MIN + return a >= SHRT_MIN / b; +} + +// stbi__err - error +// stbi__errpf - error returning pointer to float +// stbi__errpuc - error returning pointer to unsigned char + +#ifdef STBI_NO_FAILURE_STRINGS + #define stbi__err(x,y) 0 +#elif defined(STBI_FAILURE_USERMSG) + #define stbi__err(x,y) stbi__err(y) +#else + #define stbi__err(x,y) stbi__err(x) +#endif + +#define stbi__errpf(x,y) ((float *)(size_t) (stbi__err(x,y)?NULL:NULL)) +#define stbi__errpuc(x,y) ((unsigned char *)(size_t) (stbi__err(x,y)?NULL:NULL)) + +STBIDEF void stbi_image_free(void *retval_from_stbi_load) +{ + STBI_FREE(retval_from_stbi_load); +} + +#ifndef STBI_NO_LINEAR +static float *stbi__ldr_to_hdr(stbi_uc *data, int x, int y, int comp); +#endif + +#ifndef STBI_NO_HDR +static stbi_uc *stbi__hdr_to_ldr(float *data, int x, int y, int comp); +#endif + +static int stbi__vertically_flip_on_load_global = 0; + +STBIDEF void stbi_set_flip_vertically_on_load(int flag_true_if_should_flip) +{ + stbi__vertically_flip_on_load_global = flag_true_if_should_flip; +} + +#ifndef STBI_THREAD_LOCAL +#define stbi__vertically_flip_on_load stbi__vertically_flip_on_load_global +#else +static STBI_THREAD_LOCAL int stbi__vertically_flip_on_load_local, stbi__vertically_flip_on_load_set; + +STBIDEF void stbi_set_flip_vertically_on_load_thread(int flag_true_if_should_flip) +{ + stbi__vertically_flip_on_load_local = flag_true_if_should_flip; + stbi__vertically_flip_on_load_set = 1; +} + +#define stbi__vertically_flip_on_load (stbi__vertically_flip_on_load_set \ + ? stbi__vertically_flip_on_load_local \ + : stbi__vertically_flip_on_load_global) +#endif // STBI_THREAD_LOCAL + +static void *stbi__load_main(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri, int bpc) +{ + memset(ri, 0, sizeof(*ri)); // make sure it's initialized if we add new fields + ri->bits_per_channel = 8; // default is 8 so most paths don't have to be changed + ri->channel_order = STBI_ORDER_RGB; // all current input & output are this, but this is here so we can add BGR order + ri->num_channels = 0; + + // test the formats with a very explicit header first (at least a FOURCC + // or distinctive magic number first) + #ifndef STBI_NO_PNG + if (stbi__png_test(s)) return stbi__png_load(s,x,y,comp,req_comp, ri); + #endif + #ifndef STBI_NO_BMP + if (stbi__bmp_test(s)) return stbi__bmp_load(s,x,y,comp,req_comp, ri); + #endif + #ifndef STBI_NO_GIF + if (stbi__gif_test(s)) return stbi__gif_load(s,x,y,comp,req_comp, ri); + #endif + #ifndef STBI_NO_PSD + if (stbi__psd_test(s)) return stbi__psd_load(s,x,y,comp,req_comp, ri, bpc); + #else + STBI_NOTUSED(bpc); + #endif + #ifndef STBI_NO_PIC + if (stbi__pic_test(s)) return stbi__pic_load(s,x,y,comp,req_comp, ri); + #endif + + // then the formats that can end up attempting to load with just 1 or 2 + // bytes matching expectations; these are prone to false positives, so + // try them later + #ifndef STBI_NO_JPEG + if (stbi__jpeg_test(s)) return stbi__jpeg_load(s,x,y,comp,req_comp, ri); + #endif + #ifndef STBI_NO_PNM + if (stbi__pnm_test(s)) return stbi__pnm_load(s,x,y,comp,req_comp, ri); + #endif + + #ifndef STBI_NO_HDR + if (stbi__hdr_test(s)) { + float *hdr = stbi__hdr_load(s, x,y,comp,req_comp, ri); + return stbi__hdr_to_ldr(hdr, *x, *y, req_comp ? req_comp : *comp); + } + #endif + + #ifndef STBI_NO_TGA + // test tga last because it's a crappy test! + if (stbi__tga_test(s)) + return stbi__tga_load(s,x,y,comp,req_comp, ri); + #endif + + return stbi__errpuc("unknown image type", "Image not of any known type, or corrupt"); +} + +static stbi_uc *stbi__convert_16_to_8(stbi__uint16 *orig, int w, int h, int channels) +{ + int i; + int img_len = w * h * channels; + stbi_uc *reduced; + + reduced = (stbi_uc *) stbi__malloc(img_len); + if (reduced == NULL) return stbi__errpuc("outofmem", "Out of memory"); + + for (i = 0; i < img_len; ++i) + reduced[i] = (stbi_uc)((orig[i] >> 8) & 0xFF); // top half of each byte is sufficient approx of 16->8 bit scaling + + STBI_FREE(orig); + return reduced; +} + +static stbi__uint16 *stbi__convert_8_to_16(stbi_uc *orig, int w, int h, int channels) +{ + int i; + int img_len = w * h * channels; + stbi__uint16 *enlarged; + + enlarged = (stbi__uint16 *) stbi__malloc(img_len*2); + if (enlarged == NULL) return (stbi__uint16 *) stbi__errpuc("outofmem", "Out of memory"); + + for (i = 0; i < img_len; ++i) + enlarged[i] = (stbi__uint16)((orig[i] << 8) + orig[i]); // replicate to high and low byte, maps 0->0, 255->0xffff + + STBI_FREE(orig); + return enlarged; +} + +static void stbi__vertical_flip(void *image, int w, int h, int bytes_per_pixel) +{ + int row; + size_t bytes_per_row = (size_t)w * bytes_per_pixel; + stbi_uc temp[2048]; + stbi_uc *bytes = (stbi_uc *)image; + + for (row = 0; row < (h>>1); row++) { + stbi_uc *row0 = bytes + row*bytes_per_row; + stbi_uc *row1 = bytes + (h - row - 1)*bytes_per_row; + // swap row0 with row1 + size_t bytes_left = bytes_per_row; + while (bytes_left) { + size_t bytes_copy = (bytes_left < sizeof(temp)) ? bytes_left : sizeof(temp); + memcpy(temp, row0, bytes_copy); + memcpy(row0, row1, bytes_copy); + memcpy(row1, temp, bytes_copy); + row0 += bytes_copy; + row1 += bytes_copy; + bytes_left -= bytes_copy; + } + } +} + +#ifndef STBI_NO_GIF +static void stbi__vertical_flip_slices(void *image, int w, int h, int z, int bytes_per_pixel) +{ + int slice; + int slice_size = w * h * bytes_per_pixel; + + stbi_uc *bytes = (stbi_uc *)image; + for (slice = 0; slice < z; ++slice) { + stbi__vertical_flip(bytes, w, h, bytes_per_pixel); + bytes += slice_size; + } +} +#endif + +static unsigned char *stbi__load_and_postprocess_8bit(stbi__context *s, int *x, int *y, int *comp, int req_comp) +{ + stbi__result_info ri; + void *result = stbi__load_main(s, x, y, comp, req_comp, &ri, 8); + + if (result == NULL) + return NULL; + + // it is the responsibility of the loaders to make sure we get either 8 or 16 bit. + STBI_ASSERT(ri.bits_per_channel == 8 || ri.bits_per_channel == 16); + + if (ri.bits_per_channel != 8) { + result = stbi__convert_16_to_8((stbi__uint16 *) result, *x, *y, req_comp == 0 ? *comp : req_comp); + ri.bits_per_channel = 8; + } + + // @TODO: move stbi__convert_format to here + + if (stbi__vertically_flip_on_load) { + int channels = req_comp ? req_comp : *comp; + stbi__vertical_flip(result, *x, *y, channels * sizeof(stbi_uc)); + } + + return (unsigned char *) result; +} + +static stbi__uint16 *stbi__load_and_postprocess_16bit(stbi__context *s, int *x, int *y, int *comp, int req_comp) +{ + stbi__result_info ri; + void *result = stbi__load_main(s, x, y, comp, req_comp, &ri, 16); + + if (result == NULL) + return NULL; + + // it is the responsibility of the loaders to make sure we get either 8 or 16 bit. + STBI_ASSERT(ri.bits_per_channel == 8 || ri.bits_per_channel == 16); + + if (ri.bits_per_channel != 16) { + result = stbi__convert_8_to_16((stbi_uc *) result, *x, *y, req_comp == 0 ? *comp : req_comp); + ri.bits_per_channel = 16; + } + + // @TODO: move stbi__convert_format16 to here + // @TODO: special case RGB-to-Y (and RGBA-to-YA) for 8-bit-to-16-bit case to keep more precision + + if (stbi__vertically_flip_on_load) { + int channels = req_comp ? req_comp : *comp; + stbi__vertical_flip(result, *x, *y, channels * sizeof(stbi__uint16)); + } + + return (stbi__uint16 *) result; +} + +#if !defined(STBI_NO_HDR) && !defined(STBI_NO_LINEAR) +static void stbi__float_postprocess(float *result, int *x, int *y, int *comp, int req_comp) +{ + if (stbi__vertically_flip_on_load && result != NULL) { + int channels = req_comp ? req_comp : *comp; + stbi__vertical_flip(result, *x, *y, channels * sizeof(float)); + } +} +#endif + +#ifndef STBI_NO_STDIO + +#if defined(_WIN32) && defined(STBI_WINDOWS_UTF8) +STBI_EXTERN __declspec(dllimport) int __stdcall MultiByteToWideChar(unsigned int cp, unsigned long flags, const char *str, int cbmb, wchar_t *widestr, int cchwide); +STBI_EXTERN __declspec(dllimport) int __stdcall WideCharToMultiByte(unsigned int cp, unsigned long flags, const wchar_t *widestr, int cchwide, char *str, int cbmb, const char *defchar, int *used_default); +#endif + +#if defined(_WIN32) && defined(STBI_WINDOWS_UTF8) +STBIDEF int stbi_convert_wchar_to_utf8(char *buffer, size_t bufferlen, const wchar_t* input) +{ + return WideCharToMultiByte(65001 /* UTF8 */, 0, input, -1, buffer, (int) bufferlen, NULL, NULL); +} +#endif + +static FILE *stbi__fopen(char const *filename, char const *mode) +{ + FILE *f; +#if defined(_WIN32) && defined(STBI_WINDOWS_UTF8) + wchar_t wMode[64]; + wchar_t wFilename[1024]; + if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, filename, -1, wFilename, sizeof(wFilename)/sizeof(*wFilename))) + return 0; + + if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, mode, -1, wMode, sizeof(wMode)/sizeof(*wMode))) + return 0; + +#if defined(_MSC_VER) && _MSC_VER >= 1400 + if (0 != _wfopen_s(&f, wFilename, wMode)) + f = 0; +#else + f = _wfopen(wFilename, wMode); +#endif + +#elif defined(_MSC_VER) && _MSC_VER >= 1400 + if (0 != fopen_s(&f, filename, mode)) + f=0; +#else + f = fopen(filename, mode); +#endif + return f; +} + + +STBIDEF stbi_uc *stbi_load(char const *filename, int *x, int *y, int *comp, int req_comp) +{ + FILE *f = stbi__fopen(filename, "rb"); + unsigned char *result; + if (!f) return stbi__errpuc("can't fopen", "Unable to open file"); + result = stbi_load_from_file(f,x,y,comp,req_comp); + fclose(f); + return result; +} + +STBIDEF stbi_uc *stbi_load_from_file(FILE *f, int *x, int *y, int *comp, int req_comp) +{ + unsigned char *result; + stbi__context s; + stbi__start_file(&s,f); + result = stbi__load_and_postprocess_8bit(&s,x,y,comp,req_comp); + if (result) { + // need to 'unget' all the characters in the IO buffer + fseek(f, - (int) (s.img_buffer_end - s.img_buffer), SEEK_CUR); + } + return result; +} + +STBIDEF stbi__uint16 *stbi_load_from_file_16(FILE *f, int *x, int *y, int *comp, int req_comp) +{ + stbi__uint16 *result; + stbi__context s; + stbi__start_file(&s,f); + result = stbi__load_and_postprocess_16bit(&s,x,y,comp,req_comp); + if (result) { + // need to 'unget' all the characters in the IO buffer + fseek(f, - (int) (s.img_buffer_end - s.img_buffer), SEEK_CUR); + } + return result; +} + +STBIDEF stbi_us *stbi_load_16(char const *filename, int *x, int *y, int *comp, int req_comp) +{ + FILE *f = stbi__fopen(filename, "rb"); + stbi__uint16 *result; + if (!f) return (stbi_us *) stbi__errpuc("can't fopen", "Unable to open file"); + result = stbi_load_from_file_16(f,x,y,comp,req_comp); + fclose(f); + return result; +} + + +#endif //!STBI_NO_STDIO + +STBIDEF stbi_us *stbi_load_16_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *channels_in_file, int desired_channels) +{ + stbi__context s; + stbi__start_mem(&s,buffer,len); + return stbi__load_and_postprocess_16bit(&s,x,y,channels_in_file,desired_channels); +} + +STBIDEF stbi_us *stbi_load_16_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *channels_in_file, int desired_channels) +{ + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks *)clbk, user); + return stbi__load_and_postprocess_16bit(&s,x,y,channels_in_file,desired_channels); +} + +STBIDEF stbi_uc *stbi_load_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp, int req_comp) +{ + stbi__context s; + stbi__start_mem(&s,buffer,len); + return stbi__load_and_postprocess_8bit(&s,x,y,comp,req_comp); +} + +STBIDEF stbi_uc *stbi_load_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *comp, int req_comp) +{ + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks *) clbk, user); + return stbi__load_and_postprocess_8bit(&s,x,y,comp,req_comp); +} + +#ifndef STBI_NO_GIF +STBIDEF stbi_uc *stbi_load_gif_from_memory(stbi_uc const *buffer, int len, int **delays, int *x, int *y, int *z, int *comp, int req_comp) +{ + unsigned char *result; + stbi__context s; + stbi__start_mem(&s,buffer,len); + + result = (unsigned char*) stbi__load_gif_main(&s, delays, x, y, z, comp, req_comp); + if (stbi__vertically_flip_on_load) { + stbi__vertical_flip_slices( result, *x, *y, *z, *comp ); + } + + return result; +} +#endif + +#ifndef STBI_NO_LINEAR +static float *stbi__loadf_main(stbi__context *s, int *x, int *y, int *comp, int req_comp) +{ + unsigned char *data; + #ifndef STBI_NO_HDR + if (stbi__hdr_test(s)) { + stbi__result_info ri; + float *hdr_data = stbi__hdr_load(s,x,y,comp,req_comp, &ri); + if (hdr_data) + stbi__float_postprocess(hdr_data,x,y,comp,req_comp); + return hdr_data; + } + #endif + data = stbi__load_and_postprocess_8bit(s, x, y, comp, req_comp); + if (data) + return stbi__ldr_to_hdr(data, *x, *y, req_comp ? req_comp : *comp); + return stbi__errpf("unknown image type", "Image not of any known type, or corrupt"); +} + +STBIDEF float *stbi_loadf_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp, int req_comp) +{ + stbi__context s; + stbi__start_mem(&s,buffer,len); + return stbi__loadf_main(&s,x,y,comp,req_comp); +} + +STBIDEF float *stbi_loadf_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *comp, int req_comp) +{ + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks *) clbk, user); + return stbi__loadf_main(&s,x,y,comp,req_comp); +} + +#ifndef STBI_NO_STDIO +STBIDEF float *stbi_loadf(char const *filename, int *x, int *y, int *comp, int req_comp) +{ + float *result; + FILE *f = stbi__fopen(filename, "rb"); + if (!f) return stbi__errpf("can't fopen", "Unable to open file"); + result = stbi_loadf_from_file(f,x,y,comp,req_comp); + fclose(f); + return result; +} + +STBIDEF float *stbi_loadf_from_file(FILE *f, int *x, int *y, int *comp, int req_comp) +{ + stbi__context s; + stbi__start_file(&s,f); + return stbi__loadf_main(&s,x,y,comp,req_comp); +} +#endif // !STBI_NO_STDIO + +#endif // !STBI_NO_LINEAR + +// these is-hdr-or-not is defined independent of whether STBI_NO_LINEAR is +// defined, for API simplicity; if STBI_NO_LINEAR is defined, it always +// reports false! + +STBIDEF int stbi_is_hdr_from_memory(stbi_uc const *buffer, int len) +{ + #ifndef STBI_NO_HDR + stbi__context s; + stbi__start_mem(&s,buffer,len); + return stbi__hdr_test(&s); + #else + STBI_NOTUSED(buffer); + STBI_NOTUSED(len); + return 0; + #endif +} + +#ifndef STBI_NO_STDIO +STBIDEF int stbi_is_hdr (char const *filename) +{ + FILE *f = stbi__fopen(filename, "rb"); + int result=0; + if (f) { + result = stbi_is_hdr_from_file(f); + fclose(f); + } + return result; +} + +STBIDEF int stbi_is_hdr_from_file(FILE *f) +{ + #ifndef STBI_NO_HDR + long pos = ftell(f); + int res; + stbi__context s; + stbi__start_file(&s,f); + res = stbi__hdr_test(&s); + fseek(f, pos, SEEK_SET); + return res; + #else + STBI_NOTUSED(f); + return 0; + #endif +} +#endif // !STBI_NO_STDIO + +STBIDEF int stbi_is_hdr_from_callbacks(stbi_io_callbacks const *clbk, void *user) +{ + #ifndef STBI_NO_HDR + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks *) clbk, user); + return stbi__hdr_test(&s); + #else + STBI_NOTUSED(clbk); + STBI_NOTUSED(user); + return 0; + #endif +} + +#ifndef STBI_NO_LINEAR +static float stbi__l2h_gamma=2.2f, stbi__l2h_scale=1.0f; + +STBIDEF void stbi_ldr_to_hdr_gamma(float gamma) { stbi__l2h_gamma = gamma; } +STBIDEF void stbi_ldr_to_hdr_scale(float scale) { stbi__l2h_scale = scale; } +#endif + +static float stbi__h2l_gamma_i=1.0f/2.2f, stbi__h2l_scale_i=1.0f; + +STBIDEF void stbi_hdr_to_ldr_gamma(float gamma) { stbi__h2l_gamma_i = 1/gamma; } +STBIDEF void stbi_hdr_to_ldr_scale(float scale) { stbi__h2l_scale_i = 1/scale; } + + +////////////////////////////////////////////////////////////////////////////// +// +// Common code used by all image loaders +// + +enum +{ + STBI__SCAN_load=0, + STBI__SCAN_type, + STBI__SCAN_header +}; + +static void stbi__refill_buffer(stbi__context *s) +{ + int n = (s->io.read)(s->io_user_data,(char*)s->buffer_start,s->buflen); + s->callback_already_read += (int) (s->img_buffer - s->img_buffer_original); + if (n == 0) { + // at end of file, treat same as if from memory, but need to handle case + // where s->img_buffer isn't pointing to safe memory, e.g. 0-byte file + s->read_from_callbacks = 0; + s->img_buffer = s->buffer_start; + s->img_buffer_end = s->buffer_start+1; + *s->img_buffer = 0; + } else { + s->img_buffer = s->buffer_start; + s->img_buffer_end = s->buffer_start + n; + } +} + +stbi_inline static stbi_uc stbi__get8(stbi__context *s) +{ + if (s->img_buffer < s->img_buffer_end) + return *s->img_buffer++; + if (s->read_from_callbacks) { + stbi__refill_buffer(s); + return *s->img_buffer++; + } + return 0; +} + +#if defined(STBI_NO_JPEG) && defined(STBI_NO_HDR) && defined(STBI_NO_PIC) && defined(STBI_NO_PNM) +// nothing +#else +stbi_inline static int stbi__at_eof(stbi__context *s) +{ + if (s->io.read) { + if (!(s->io.eof)(s->io_user_data)) return 0; + // if feof() is true, check if buffer = end + // special case: we've only got the special 0 character at the end + if (s->read_from_callbacks == 0) return 1; + } + + return s->img_buffer >= s->img_buffer_end; +} +#endif + +#if defined(STBI_NO_JPEG) && defined(STBI_NO_PNG) && defined(STBI_NO_BMP) && defined(STBI_NO_PSD) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) && defined(STBI_NO_PIC) +// nothing +#else +static void stbi__skip(stbi__context *s, int n) +{ + if (n == 0) return; // already there! + if (n < 0) { + s->img_buffer = s->img_buffer_end; + return; + } + if (s->io.read) { + int blen = (int) (s->img_buffer_end - s->img_buffer); + if (blen < n) { + s->img_buffer = s->img_buffer_end; + (s->io.skip)(s->io_user_data, n - blen); + return; + } + } + s->img_buffer += n; +} +#endif + +#if defined(STBI_NO_PNG) && defined(STBI_NO_TGA) && defined(STBI_NO_HDR) && defined(STBI_NO_PNM) +// nothing +#else +static int stbi__getn(stbi__context *s, stbi_uc *buffer, int n) +{ + if (s->io.read) { + int blen = (int) (s->img_buffer_end - s->img_buffer); + if (blen < n) { + int res, count; + + memcpy(buffer, s->img_buffer, blen); + + count = (s->io.read)(s->io_user_data, (char*) buffer + blen, n - blen); + res = (count == (n-blen)); + s->img_buffer = s->img_buffer_end; + return res; + } + } + + if (s->img_buffer+n <= s->img_buffer_end) { + memcpy(buffer, s->img_buffer, n); + s->img_buffer += n; + return 1; + } else + return 0; +} +#endif + +#if defined(STBI_NO_JPEG) && defined(STBI_NO_PNG) && defined(STBI_NO_PSD) && defined(STBI_NO_PIC) +// nothing +#else +static int stbi__get16be(stbi__context *s) +{ + int z = stbi__get8(s); + return (z << 8) + stbi__get8(s); +} +#endif + +#if defined(STBI_NO_PNG) && defined(STBI_NO_PSD) && defined(STBI_NO_PIC) +// nothing +#else +static stbi__uint32 stbi__get32be(stbi__context *s) +{ + stbi__uint32 z = stbi__get16be(s); + return (z << 16) + stbi__get16be(s); +} +#endif + +#if defined(STBI_NO_BMP) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) +// nothing +#else +static int stbi__get16le(stbi__context *s) +{ + int z = stbi__get8(s); + return z + (stbi__get8(s) << 8); +} +#endif + +#ifndef STBI_NO_BMP +static stbi__uint32 stbi__get32le(stbi__context *s) +{ + stbi__uint32 z = stbi__get16le(s); + z += (stbi__uint32)stbi__get16le(s) << 16; + return z; +} +#endif + +#define STBI__BYTECAST(x) ((stbi_uc) ((x) & 255)) // truncate int to byte without warnings + +#if defined(STBI_NO_JPEG) && defined(STBI_NO_PNG) && defined(STBI_NO_BMP) && defined(STBI_NO_PSD) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) && defined(STBI_NO_PIC) && defined(STBI_NO_PNM) +// nothing +#else +////////////////////////////////////////////////////////////////////////////// +// +// generic converter from built-in img_n to req_comp +// individual types do this automatically as much as possible (e.g. jpeg +// does all cases internally since it needs to colorspace convert anyway, +// and it never has alpha, so very few cases ). png can automatically +// interleave an alpha=255 channel, but falls back to this for other cases +// +// assume data buffer is malloced, so malloc a new one and free that one +// only failure mode is malloc failing + +static stbi_uc stbi__compute_y(int r, int g, int b) +{ + return (stbi_uc) (((r*77) + (g*150) + (29*b)) >> 8); +} +#endif + +#if defined(STBI_NO_PNG) && defined(STBI_NO_BMP) && defined(STBI_NO_PSD) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) && defined(STBI_NO_PIC) && defined(STBI_NO_PNM) +// nothing +#else +static unsigned char *stbi__convert_format(unsigned char *data, int img_n, int req_comp, unsigned int x, unsigned int y) +{ + int i,j; + unsigned char *good; + + if (req_comp == img_n) return data; + STBI_ASSERT(req_comp >= 1 && req_comp <= 4); + + good = (unsigned char *) stbi__malloc_mad3(req_comp, x, y, 0); + if (good == NULL) { + STBI_FREE(data); + return stbi__errpuc("outofmem", "Out of memory"); + } + + for (j=0; j < (int) y; ++j) { + unsigned char *src = data + j * x * img_n ; + unsigned char *dest = good + j * x * req_comp; + + #define STBI__COMBO(a,b) ((a)*8+(b)) + #define STBI__CASE(a,b) case STBI__COMBO(a,b): for(i=x-1; i >= 0; --i, src += a, dest += b) + // convert source image with img_n components to one with req_comp components; + // avoid switch per pixel, so use switch per scanline and massive macros + switch (STBI__COMBO(img_n, req_comp)) { + STBI__CASE(1,2) { dest[0]=src[0]; dest[1]=255; } break; + STBI__CASE(1,3) { dest[0]=dest[1]=dest[2]=src[0]; } break; + STBI__CASE(1,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=255; } break; + STBI__CASE(2,1) { dest[0]=src[0]; } break; + STBI__CASE(2,3) { dest[0]=dest[1]=dest[2]=src[0]; } break; + STBI__CASE(2,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=src[1]; } break; + STBI__CASE(3,4) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2];dest[3]=255; } break; + STBI__CASE(3,1) { dest[0]=stbi__compute_y(src[0],src[1],src[2]); } break; + STBI__CASE(3,2) { dest[0]=stbi__compute_y(src[0],src[1],src[2]); dest[1] = 255; } break; + STBI__CASE(4,1) { dest[0]=stbi__compute_y(src[0],src[1],src[2]); } break; + STBI__CASE(4,2) { dest[0]=stbi__compute_y(src[0],src[1],src[2]); dest[1] = src[3]; } break; + STBI__CASE(4,3) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2]; } break; + default: STBI_ASSERT(0); STBI_FREE(data); STBI_FREE(good); return stbi__errpuc("unsupported", "Unsupported format conversion"); + } + #undef STBI__CASE + } + + STBI_FREE(data); + return good; +} +#endif + +#if defined(STBI_NO_PNG) && defined(STBI_NO_PSD) +// nothing +#else +static stbi__uint16 stbi__compute_y_16(int r, int g, int b) +{ + return (stbi__uint16) (((r*77) + (g*150) + (29*b)) >> 8); +} +#endif + +#if defined(STBI_NO_PNG) && defined(STBI_NO_PSD) +// nothing +#else +static stbi__uint16 *stbi__convert_format16(stbi__uint16 *data, int img_n, int req_comp, unsigned int x, unsigned int y) +{ + int i,j; + stbi__uint16 *good; + + if (req_comp == img_n) return data; + STBI_ASSERT(req_comp >= 1 && req_comp <= 4); + + good = (stbi__uint16 *) stbi__malloc(req_comp * x * y * 2); + if (good == NULL) { + STBI_FREE(data); + return (stbi__uint16 *) stbi__errpuc("outofmem", "Out of memory"); + } + + for (j=0; j < (int) y; ++j) { + stbi__uint16 *src = data + j * x * img_n ; + stbi__uint16 *dest = good + j * x * req_comp; + + #define STBI__COMBO(a,b) ((a)*8+(b)) + #define STBI__CASE(a,b) case STBI__COMBO(a,b): for(i=x-1; i >= 0; --i, src += a, dest += b) + // convert source image with img_n components to one with req_comp components; + // avoid switch per pixel, so use switch per scanline and massive macros + switch (STBI__COMBO(img_n, req_comp)) { + STBI__CASE(1,2) { dest[0]=src[0]; dest[1]=0xffff; } break; + STBI__CASE(1,3) { dest[0]=dest[1]=dest[2]=src[0]; } break; + STBI__CASE(1,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=0xffff; } break; + STBI__CASE(2,1) { dest[0]=src[0]; } break; + STBI__CASE(2,3) { dest[0]=dest[1]=dest[2]=src[0]; } break; + STBI__CASE(2,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=src[1]; } break; + STBI__CASE(3,4) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2];dest[3]=0xffff; } break; + STBI__CASE(3,1) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]); } break; + STBI__CASE(3,2) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]); dest[1] = 0xffff; } break; + STBI__CASE(4,1) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]); } break; + STBI__CASE(4,2) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]); dest[1] = src[3]; } break; + STBI__CASE(4,3) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2]; } break; + default: STBI_ASSERT(0); STBI_FREE(data); STBI_FREE(good); return (stbi__uint16*) stbi__errpuc("unsupported", "Unsupported format conversion"); + } + #undef STBI__CASE + } + + STBI_FREE(data); + return good; +} +#endif + +#ifndef STBI_NO_LINEAR +static float *stbi__ldr_to_hdr(stbi_uc *data, int x, int y, int comp) +{ + int i,k,n; + float *output; + if (!data) return NULL; + output = (float *) stbi__malloc_mad4(x, y, comp, sizeof(float), 0); + if (output == NULL) { STBI_FREE(data); return stbi__errpf("outofmem", "Out of memory"); } + // compute number of non-alpha components + if (comp & 1) n = comp; else n = comp-1; + for (i=0; i < x*y; ++i) { + for (k=0; k < n; ++k) { + output[i*comp + k] = (float) (pow(data[i*comp+k]/255.0f, stbi__l2h_gamma) * stbi__l2h_scale); + } + } + if (n < comp) { + for (i=0; i < x*y; ++i) { + output[i*comp + n] = data[i*comp + n]/255.0f; + } + } + STBI_FREE(data); + return output; +} +#endif + +#ifndef STBI_NO_HDR +#define stbi__float2int(x) ((int) (x)) +static stbi_uc *stbi__hdr_to_ldr(float *data, int x, int y, int comp) +{ + int i,k,n; + stbi_uc *output; + if (!data) return NULL; + output = (stbi_uc *) stbi__malloc_mad3(x, y, comp, 0); + if (output == NULL) { STBI_FREE(data); return stbi__errpuc("outofmem", "Out of memory"); } + // compute number of non-alpha components + if (comp & 1) n = comp; else n = comp-1; + for (i=0; i < x*y; ++i) { + for (k=0; k < n; ++k) { + float z = (float) pow(data[i*comp+k]*stbi__h2l_scale_i, stbi__h2l_gamma_i) * 255 + 0.5f; + if (z < 0) z = 0; + if (z > 255) z = 255; + output[i*comp + k] = (stbi_uc) stbi__float2int(z); + } + if (k < comp) { + float z = data[i*comp+k] * 255 + 0.5f; + if (z < 0) z = 0; + if (z > 255) z = 255; + output[i*comp + k] = (stbi_uc) stbi__float2int(z); + } + } + STBI_FREE(data); + return output; +} +#endif + +////////////////////////////////////////////////////////////////////////////// +// +// "baseline" JPEG/JFIF decoder +// +// simple implementation +// - doesn't support delayed output of y-dimension +// - simple interface (only one output format: 8-bit interleaved RGB) +// - doesn't try to recover corrupt jpegs +// - doesn't allow partial loading, loading multiple at once +// - still fast on x86 (copying globals into locals doesn't help x86) +// - allocates lots of intermediate memory (full size of all components) +// - non-interleaved case requires this anyway +// - allows good upsampling (see next) +// high-quality +// - upsampled channels are bilinearly interpolated, even across blocks +// - quality integer IDCT derived from IJG's 'slow' +// performance +// - fast huffman; reasonable integer IDCT +// - some SIMD kernels for common paths on targets with SSE2/NEON +// - uses a lot of intermediate memory, could cache poorly + +#ifndef STBI_NO_JPEG + +// huffman decoding acceleration +#define FAST_BITS 9 // larger handles more cases; smaller stomps less cache + +typedef struct +{ + stbi_uc fast[1 << FAST_BITS]; + // weirdly, repacking this into AoS is a 10% speed loss, instead of a win + stbi__uint16 code[256]; + stbi_uc values[256]; + stbi_uc size[257]; + unsigned int maxcode[18]; + int delta[17]; // old 'firstsymbol' - old 'firstcode' +} stbi__huffman; + +typedef struct +{ + stbi__context *s; + stbi__huffman huff_dc[4]; + stbi__huffman huff_ac[4]; + stbi__uint16 dequant[4][64]; + stbi__int16 fast_ac[4][1 << FAST_BITS]; + +// sizes for components, interleaved MCUs + int img_h_max, img_v_max; + int img_mcu_x, img_mcu_y; + int img_mcu_w, img_mcu_h; + +// definition of jpeg image component + struct + { + int id; + int h,v; + int tq; + int hd,ha; + int dc_pred; + + int x,y,w2,h2; + stbi_uc *data; + void *raw_data, *raw_coeff; + stbi_uc *linebuf; + short *coeff; // progressive only + int coeff_w, coeff_h; // number of 8x8 coefficient blocks + } img_comp[4]; + + stbi__uint32 code_buffer; // jpeg entropy-coded buffer + int code_bits; // number of valid bits + unsigned char marker; // marker seen while filling entropy buffer + int nomore; // flag if we saw a marker so must stop + + int progressive; + int spec_start; + int spec_end; + int succ_high; + int succ_low; + int eob_run; + int jfif; + int app14_color_transform; // Adobe APP14 tag + int rgb; + + int scan_n, order[4]; + int restart_interval, todo; + +// kernels + void (*idct_block_kernel)(stbi_uc *out, int out_stride, short data[64]); + void (*YCbCr_to_RGB_kernel)(stbi_uc *out, const stbi_uc *y, const stbi_uc *pcb, const stbi_uc *pcr, int count, int step); + stbi_uc *(*resample_row_hv_2_kernel)(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs); +} stbi__jpeg; + +static int stbi__build_huffman(stbi__huffman *h, int *count) +{ + int i,j,k=0; + unsigned int code; + // build size list for each symbol (from JPEG spec) + for (i=0; i < 16; ++i) { + for (j=0; j < count[i]; ++j) { + h->size[k++] = (stbi_uc) (i+1); + if(k >= 257) return stbi__err("bad size list","Corrupt JPEG"); + } + } + h->size[k] = 0; + + // compute actual symbols (from jpeg spec) + code = 0; + k = 0; + for(j=1; j <= 16; ++j) { + // compute delta to add to code to compute symbol id + h->delta[j] = k - code; + if (h->size[k] == j) { + while (h->size[k] == j) + h->code[k++] = (stbi__uint16) (code++); + if (code-1 >= (1u << j)) return stbi__err("bad code lengths","Corrupt JPEG"); + } + // compute largest code + 1 for this size, preshifted as needed later + h->maxcode[j] = code << (16-j); + code <<= 1; + } + h->maxcode[j] = 0xffffffff; + + // build non-spec acceleration table; 255 is flag for not-accelerated + memset(h->fast, 255, 1 << FAST_BITS); + for (i=0; i < k; ++i) { + int s = h->size[i]; + if (s <= FAST_BITS) { + int c = h->code[i] << (FAST_BITS-s); + int m = 1 << (FAST_BITS-s); + for (j=0; j < m; ++j) { + h->fast[c+j] = (stbi_uc) i; + } + } + } + return 1; +} + +// build a table that decodes both magnitude and value of small ACs in +// one go. +static void stbi__build_fast_ac(stbi__int16 *fast_ac, stbi__huffman *h) +{ + int i; + for (i=0; i < (1 << FAST_BITS); ++i) { + stbi_uc fast = h->fast[i]; + fast_ac[i] = 0; + if (fast < 255) { + int rs = h->values[fast]; + int run = (rs >> 4) & 15; + int magbits = rs & 15; + int len = h->size[fast]; + + if (magbits && len + magbits <= FAST_BITS) { + // magnitude code followed by receive_extend code + int k = ((i << len) & ((1 << FAST_BITS) - 1)) >> (FAST_BITS - magbits); + int m = 1 << (magbits - 1); + if (k < m) k += (~0U << magbits) + 1; + // if the result is small enough, we can fit it in fast_ac table + if (k >= -128 && k <= 127) + fast_ac[i] = (stbi__int16) ((k * 256) + (run * 16) + (len + magbits)); + } + } + } +} + +static void stbi__grow_buffer_unsafe(stbi__jpeg *j) +{ + do { + unsigned int b = j->nomore ? 0 : stbi__get8(j->s); + if (b == 0xff) { + int c = stbi__get8(j->s); + while (c == 0xff) c = stbi__get8(j->s); // consume fill bytes + if (c != 0) { + j->marker = (unsigned char) c; + j->nomore = 1; + return; + } + } + j->code_buffer |= b << (24 - j->code_bits); + j->code_bits += 8; + } while (j->code_bits <= 24); +} + +// (1 << n) - 1 +static const stbi__uint32 stbi__bmask[17]={0,1,3,7,15,31,63,127,255,511,1023,2047,4095,8191,16383,32767,65535}; + +// decode a jpeg huffman value from the bitstream +stbi_inline static int stbi__jpeg_huff_decode(stbi__jpeg *j, stbi__huffman *h) +{ + unsigned int temp; + int c,k; + + if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); + + // look at the top FAST_BITS and determine what symbol ID it is, + // if the code is <= FAST_BITS + c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS)-1); + k = h->fast[c]; + if (k < 255) { + int s = h->size[k]; + if (s > j->code_bits) + return -1; + j->code_buffer <<= s; + j->code_bits -= s; + return h->values[k]; + } + + // naive test is to shift the code_buffer down so k bits are + // valid, then test against maxcode. To speed this up, we've + // preshifted maxcode left so that it has (16-k) 0s at the + // end; in other words, regardless of the number of bits, it + // wants to be compared against something shifted to have 16; + // that way we don't need to shift inside the loop. + temp = j->code_buffer >> 16; + for (k=FAST_BITS+1 ; ; ++k) + if (temp < h->maxcode[k]) + break; + if (k == 17) { + // error! code not found + j->code_bits -= 16; + return -1; + } + + if (k > j->code_bits) + return -1; + + // convert the huffman code to the symbol id + c = ((j->code_buffer >> (32 - k)) & stbi__bmask[k]) + h->delta[k]; + if(c < 0 || c >= 256) // symbol id out of bounds! + return -1; + STBI_ASSERT((((j->code_buffer) >> (32 - h->size[c])) & stbi__bmask[h->size[c]]) == h->code[c]); + + // convert the id to a symbol + j->code_bits -= k; + j->code_buffer <<= k; + return h->values[c]; +} + +// bias[n] = (-1<code_bits < n) stbi__grow_buffer_unsafe(j); + if (j->code_bits < n) return 0; // ran out of bits from stream, return 0s intead of continuing + + sgn = j->code_buffer >> 31; // sign bit always in MSB; 0 if MSB clear (positive), 1 if MSB set (negative) + k = stbi_lrot(j->code_buffer, n); + j->code_buffer = k & ~stbi__bmask[n]; + k &= stbi__bmask[n]; + j->code_bits -= n; + return k + (stbi__jbias[n] & (sgn - 1)); +} + +// get some unsigned bits +stbi_inline static int stbi__jpeg_get_bits(stbi__jpeg *j, int n) +{ + unsigned int k; + if (j->code_bits < n) stbi__grow_buffer_unsafe(j); + if (j->code_bits < n) return 0; // ran out of bits from stream, return 0s intead of continuing + k = stbi_lrot(j->code_buffer, n); + j->code_buffer = k & ~stbi__bmask[n]; + k &= stbi__bmask[n]; + j->code_bits -= n; + return k; +} + +stbi_inline static int stbi__jpeg_get_bit(stbi__jpeg *j) +{ + unsigned int k; + if (j->code_bits < 1) stbi__grow_buffer_unsafe(j); + if (j->code_bits < 1) return 0; // ran out of bits from stream, return 0s intead of continuing + k = j->code_buffer; + j->code_buffer <<= 1; + --j->code_bits; + return k & 0x80000000; +} + +// given a value that's at position X in the zigzag stream, +// where does it appear in the 8x8 matrix coded as row-major? +static const stbi_uc stbi__jpeg_dezigzag[64+15] = +{ + 0, 1, 8, 16, 9, 2, 3, 10, + 17, 24, 32, 25, 18, 11, 4, 5, + 12, 19, 26, 33, 40, 48, 41, 34, + 27, 20, 13, 6, 7, 14, 21, 28, + 35, 42, 49, 56, 57, 50, 43, 36, + 29, 22, 15, 23, 30, 37, 44, 51, + 58, 59, 52, 45, 38, 31, 39, 46, + 53, 60, 61, 54, 47, 55, 62, 63, + // let corrupt input sample past end + 63, 63, 63, 63, 63, 63, 63, 63, + 63, 63, 63, 63, 63, 63, 63 +}; + +// decode one 64-entry block-- +static int stbi__jpeg_decode_block(stbi__jpeg *j, short data[64], stbi__huffman *hdc, stbi__huffman *hac, stbi__int16 *fac, int b, stbi__uint16 *dequant) +{ + int diff,dc,k; + int t; + + if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); + t = stbi__jpeg_huff_decode(j, hdc); + if (t < 0 || t > 15) return stbi__err("bad huffman code","Corrupt JPEG"); + + // 0 all the ac values now so we can do it 32-bits at a time + memset(data,0,64*sizeof(data[0])); + + diff = t ? stbi__extend_receive(j, t) : 0; + if (!stbi__addints_valid(j->img_comp[b].dc_pred, diff)) return stbi__err("bad delta","Corrupt JPEG"); + dc = j->img_comp[b].dc_pred + diff; + j->img_comp[b].dc_pred = dc; + if (!stbi__mul2shorts_valid(dc, dequant[0])) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + data[0] = (short) (dc * dequant[0]); + + // decode AC components, see JPEG spec + k = 1; + do { + unsigned int zig; + int c,r,s; + if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); + c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS)-1); + r = fac[c]; + if (r) { // fast-AC path + k += (r >> 4) & 15; // run + s = r & 15; // combined length + if (s > j->code_bits) return stbi__err("bad huffman code", "Combined length longer than code bits available"); + j->code_buffer <<= s; + j->code_bits -= s; + // decode into unzigzag'd location + zig = stbi__jpeg_dezigzag[k++]; + data[zig] = (short) ((r >> 8) * dequant[zig]); + } else { + int rs = stbi__jpeg_huff_decode(j, hac); + if (rs < 0) return stbi__err("bad huffman code","Corrupt JPEG"); + s = rs & 15; + r = rs >> 4; + if (s == 0) { + if (rs != 0xf0) break; // end block + k += 16; + } else { + k += r; + // decode into unzigzag'd location + zig = stbi__jpeg_dezigzag[k++]; + data[zig] = (short) (stbi__extend_receive(j,s) * dequant[zig]); + } + } + } while (k < 64); + return 1; +} + +static int stbi__jpeg_decode_block_prog_dc(stbi__jpeg *j, short data[64], stbi__huffman *hdc, int b) +{ + int diff,dc; + int t; + if (j->spec_end != 0) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + + if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); + + if (j->succ_high == 0) { + // first scan for DC coefficient, must be first + memset(data,0,64*sizeof(data[0])); // 0 all the ac values now + t = stbi__jpeg_huff_decode(j, hdc); + if (t < 0 || t > 15) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + diff = t ? stbi__extend_receive(j, t) : 0; + + if (!stbi__addints_valid(j->img_comp[b].dc_pred, diff)) return stbi__err("bad delta", "Corrupt JPEG"); + dc = j->img_comp[b].dc_pred + diff; + j->img_comp[b].dc_pred = dc; + if (!stbi__mul2shorts_valid(dc, 1 << j->succ_low)) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + data[0] = (short) (dc * (1 << j->succ_low)); + } else { + // refinement scan for DC coefficient + if (stbi__jpeg_get_bit(j)) + data[0] += (short) (1 << j->succ_low); + } + return 1; +} + +// @OPTIMIZE: store non-zigzagged during the decode passes, +// and only de-zigzag when dequantizing +static int stbi__jpeg_decode_block_prog_ac(stbi__jpeg *j, short data[64], stbi__huffman *hac, stbi__int16 *fac) +{ + int k; + if (j->spec_start == 0) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + + if (j->succ_high == 0) { + int shift = j->succ_low; + + if (j->eob_run) { + --j->eob_run; + return 1; + } + + k = j->spec_start; + do { + unsigned int zig; + int c,r,s; + if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); + c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS)-1); + r = fac[c]; + if (r) { // fast-AC path + k += (r >> 4) & 15; // run + s = r & 15; // combined length + if (s > j->code_bits) return stbi__err("bad huffman code", "Combined length longer than code bits available"); + j->code_buffer <<= s; + j->code_bits -= s; + zig = stbi__jpeg_dezigzag[k++]; + data[zig] = (short) ((r >> 8) * (1 << shift)); + } else { + int rs = stbi__jpeg_huff_decode(j, hac); + if (rs < 0) return stbi__err("bad huffman code","Corrupt JPEG"); + s = rs & 15; + r = rs >> 4; + if (s == 0) { + if (r < 15) { + j->eob_run = (1 << r); + if (r) + j->eob_run += stbi__jpeg_get_bits(j, r); + --j->eob_run; + break; + } + k += 16; + } else { + k += r; + zig = stbi__jpeg_dezigzag[k++]; + data[zig] = (short) (stbi__extend_receive(j,s) * (1 << shift)); + } + } + } while (k <= j->spec_end); + } else { + // refinement scan for these AC coefficients + + short bit = (short) (1 << j->succ_low); + + if (j->eob_run) { + --j->eob_run; + for (k = j->spec_start; k <= j->spec_end; ++k) { + short *p = &data[stbi__jpeg_dezigzag[k]]; + if (*p != 0) + if (stbi__jpeg_get_bit(j)) + if ((*p & bit)==0) { + if (*p > 0) + *p += bit; + else + *p -= bit; + } + } + } else { + k = j->spec_start; + do { + int r,s; + int rs = stbi__jpeg_huff_decode(j, hac); // @OPTIMIZE see if we can use the fast path here, advance-by-r is so slow, eh + if (rs < 0) return stbi__err("bad huffman code","Corrupt JPEG"); + s = rs & 15; + r = rs >> 4; + if (s == 0) { + if (r < 15) { + j->eob_run = (1 << r) - 1; + if (r) + j->eob_run += stbi__jpeg_get_bits(j, r); + r = 64; // force end of block + } else { + // r=15 s=0 should write 16 0s, so we just do + // a run of 15 0s and then write s (which is 0), + // so we don't have to do anything special here + } + } else { + if (s != 1) return stbi__err("bad huffman code", "Corrupt JPEG"); + // sign bit + if (stbi__jpeg_get_bit(j)) + s = bit; + else + s = -bit; + } + + // advance by r + while (k <= j->spec_end) { + short *p = &data[stbi__jpeg_dezigzag[k++]]; + if (*p != 0) { + if (stbi__jpeg_get_bit(j)) + if ((*p & bit)==0) { + if (*p > 0) + *p += bit; + else + *p -= bit; + } + } else { + if (r == 0) { + *p = (short) s; + break; + } + --r; + } + } + } while (k <= j->spec_end); + } + } + return 1; +} + +// take a -128..127 value and stbi__clamp it and convert to 0..255 +stbi_inline static stbi_uc stbi__clamp(int x) +{ + // trick to use a single test to catch both cases + if ((unsigned int) x > 255) { + if (x < 0) return 0; + if (x > 255) return 255; + } + return (stbi_uc) x; +} + +#define stbi__f2f(x) ((int) (((x) * 4096 + 0.5))) +#define stbi__fsh(x) ((x) * 4096) + +// derived from jidctint -- DCT_ISLOW +#define STBI__IDCT_1D(s0,s1,s2,s3,s4,s5,s6,s7) \ + int t0,t1,t2,t3,p1,p2,p3,p4,p5,x0,x1,x2,x3; \ + p2 = s2; \ + p3 = s6; \ + p1 = (p2+p3) * stbi__f2f(0.5411961f); \ + t2 = p1 + p3*stbi__f2f(-1.847759065f); \ + t3 = p1 + p2*stbi__f2f( 0.765366865f); \ + p2 = s0; \ + p3 = s4; \ + t0 = stbi__fsh(p2+p3); \ + t1 = stbi__fsh(p2-p3); \ + x0 = t0+t3; \ + x3 = t0-t3; \ + x1 = t1+t2; \ + x2 = t1-t2; \ + t0 = s7; \ + t1 = s5; \ + t2 = s3; \ + t3 = s1; \ + p3 = t0+t2; \ + p4 = t1+t3; \ + p1 = t0+t3; \ + p2 = t1+t2; \ + p5 = (p3+p4)*stbi__f2f( 1.175875602f); \ + t0 = t0*stbi__f2f( 0.298631336f); \ + t1 = t1*stbi__f2f( 2.053119869f); \ + t2 = t2*stbi__f2f( 3.072711026f); \ + t3 = t3*stbi__f2f( 1.501321110f); \ + p1 = p5 + p1*stbi__f2f(-0.899976223f); \ + p2 = p5 + p2*stbi__f2f(-2.562915447f); \ + p3 = p3*stbi__f2f(-1.961570560f); \ + p4 = p4*stbi__f2f(-0.390180644f); \ + t3 += p1+p4; \ + t2 += p2+p3; \ + t1 += p2+p4; \ + t0 += p1+p3; + +static void stbi__idct_block(stbi_uc *out, int out_stride, short data[64]) +{ + int i,val[64],*v=val; + stbi_uc *o; + short *d = data; + + // columns + for (i=0; i < 8; ++i,++d, ++v) { + // if all zeroes, shortcut -- this avoids dequantizing 0s and IDCTing + if (d[ 8]==0 && d[16]==0 && d[24]==0 && d[32]==0 + && d[40]==0 && d[48]==0 && d[56]==0) { + // no shortcut 0 seconds + // (1|2|3|4|5|6|7)==0 0 seconds + // all separate -0.047 seconds + // 1 && 2|3 && 4|5 && 6|7: -0.047 seconds + int dcterm = d[0]*4; + v[0] = v[8] = v[16] = v[24] = v[32] = v[40] = v[48] = v[56] = dcterm; + } else { + STBI__IDCT_1D(d[ 0],d[ 8],d[16],d[24],d[32],d[40],d[48],d[56]) + // constants scaled things up by 1<<12; let's bring them back + // down, but keep 2 extra bits of precision + x0 += 512; x1 += 512; x2 += 512; x3 += 512; + v[ 0] = (x0+t3) >> 10; + v[56] = (x0-t3) >> 10; + v[ 8] = (x1+t2) >> 10; + v[48] = (x1-t2) >> 10; + v[16] = (x2+t1) >> 10; + v[40] = (x2-t1) >> 10; + v[24] = (x3+t0) >> 10; + v[32] = (x3-t0) >> 10; + } + } + + for (i=0, v=val, o=out; i < 8; ++i,v+=8,o+=out_stride) { + // no fast case since the first 1D IDCT spread components out + STBI__IDCT_1D(v[0],v[1],v[2],v[3],v[4],v[5],v[6],v[7]) + // constants scaled things up by 1<<12, plus we had 1<<2 from first + // loop, plus horizontal and vertical each scale by sqrt(8) so together + // we've got an extra 1<<3, so 1<<17 total we need to remove. + // so we want to round that, which means adding 0.5 * 1<<17, + // aka 65536. Also, we'll end up with -128 to 127 that we want + // to encode as 0..255 by adding 128, so we'll add that before the shift + x0 += 65536 + (128<<17); + x1 += 65536 + (128<<17); + x2 += 65536 + (128<<17); + x3 += 65536 + (128<<17); + // tried computing the shifts into temps, or'ing the temps to see + // if any were out of range, but that was slower + o[0] = stbi__clamp((x0+t3) >> 17); + o[7] = stbi__clamp((x0-t3) >> 17); + o[1] = stbi__clamp((x1+t2) >> 17); + o[6] = stbi__clamp((x1-t2) >> 17); + o[2] = stbi__clamp((x2+t1) >> 17); + o[5] = stbi__clamp((x2-t1) >> 17); + o[3] = stbi__clamp((x3+t0) >> 17); + o[4] = stbi__clamp((x3-t0) >> 17); + } +} + +#ifdef STBI_SSE2 +// sse2 integer IDCT. not the fastest possible implementation but it +// produces bit-identical results to the generic C version so it's +// fully "transparent". +static void stbi__idct_simd(stbi_uc *out, int out_stride, short data[64]) +{ + // This is constructed to match our regular (generic) integer IDCT exactly. + __m128i row0, row1, row2, row3, row4, row5, row6, row7; + __m128i tmp; + + // dot product constant: even elems=x, odd elems=y + #define dct_const(x,y) _mm_setr_epi16((x),(y),(x),(y),(x),(y),(x),(y)) + + // out(0) = c0[even]*x + c0[odd]*y (c0, x, y 16-bit, out 32-bit) + // out(1) = c1[even]*x + c1[odd]*y + #define dct_rot(out0,out1, x,y,c0,c1) \ + __m128i c0##lo = _mm_unpacklo_epi16((x),(y)); \ + __m128i c0##hi = _mm_unpackhi_epi16((x),(y)); \ + __m128i out0##_l = _mm_madd_epi16(c0##lo, c0); \ + __m128i out0##_h = _mm_madd_epi16(c0##hi, c0); \ + __m128i out1##_l = _mm_madd_epi16(c0##lo, c1); \ + __m128i out1##_h = _mm_madd_epi16(c0##hi, c1) + + // out = in << 12 (in 16-bit, out 32-bit) + #define dct_widen(out, in) \ + __m128i out##_l = _mm_srai_epi32(_mm_unpacklo_epi16(_mm_setzero_si128(), (in)), 4); \ + __m128i out##_h = _mm_srai_epi32(_mm_unpackhi_epi16(_mm_setzero_si128(), (in)), 4) + + // wide add + #define dct_wadd(out, a, b) \ + __m128i out##_l = _mm_add_epi32(a##_l, b##_l); \ + __m128i out##_h = _mm_add_epi32(a##_h, b##_h) + + // wide sub + #define dct_wsub(out, a, b) \ + __m128i out##_l = _mm_sub_epi32(a##_l, b##_l); \ + __m128i out##_h = _mm_sub_epi32(a##_h, b##_h) + + // butterfly a/b, add bias, then shift by "s" and pack + #define dct_bfly32o(out0, out1, a,b,bias,s) \ + { \ + __m128i abiased_l = _mm_add_epi32(a##_l, bias); \ + __m128i abiased_h = _mm_add_epi32(a##_h, bias); \ + dct_wadd(sum, abiased, b); \ + dct_wsub(dif, abiased, b); \ + out0 = _mm_packs_epi32(_mm_srai_epi32(sum_l, s), _mm_srai_epi32(sum_h, s)); \ + out1 = _mm_packs_epi32(_mm_srai_epi32(dif_l, s), _mm_srai_epi32(dif_h, s)); \ + } + + // 8-bit interleave step (for transposes) + #define dct_interleave8(a, b) \ + tmp = a; \ + a = _mm_unpacklo_epi8(a, b); \ + b = _mm_unpackhi_epi8(tmp, b) + + // 16-bit interleave step (for transposes) + #define dct_interleave16(a, b) \ + tmp = a; \ + a = _mm_unpacklo_epi16(a, b); \ + b = _mm_unpackhi_epi16(tmp, b) + + #define dct_pass(bias,shift) \ + { \ + /* even part */ \ + dct_rot(t2e,t3e, row2,row6, rot0_0,rot0_1); \ + __m128i sum04 = _mm_add_epi16(row0, row4); \ + __m128i dif04 = _mm_sub_epi16(row0, row4); \ + dct_widen(t0e, sum04); \ + dct_widen(t1e, dif04); \ + dct_wadd(x0, t0e, t3e); \ + dct_wsub(x3, t0e, t3e); \ + dct_wadd(x1, t1e, t2e); \ + dct_wsub(x2, t1e, t2e); \ + /* odd part */ \ + dct_rot(y0o,y2o, row7,row3, rot2_0,rot2_1); \ + dct_rot(y1o,y3o, row5,row1, rot3_0,rot3_1); \ + __m128i sum17 = _mm_add_epi16(row1, row7); \ + __m128i sum35 = _mm_add_epi16(row3, row5); \ + dct_rot(y4o,y5o, sum17,sum35, rot1_0,rot1_1); \ + dct_wadd(x4, y0o, y4o); \ + dct_wadd(x5, y1o, y5o); \ + dct_wadd(x6, y2o, y5o); \ + dct_wadd(x7, y3o, y4o); \ + dct_bfly32o(row0,row7, x0,x7,bias,shift); \ + dct_bfly32o(row1,row6, x1,x6,bias,shift); \ + dct_bfly32o(row2,row5, x2,x5,bias,shift); \ + dct_bfly32o(row3,row4, x3,x4,bias,shift); \ + } + + __m128i rot0_0 = dct_const(stbi__f2f(0.5411961f), stbi__f2f(0.5411961f) + stbi__f2f(-1.847759065f)); + __m128i rot0_1 = dct_const(stbi__f2f(0.5411961f) + stbi__f2f( 0.765366865f), stbi__f2f(0.5411961f)); + __m128i rot1_0 = dct_const(stbi__f2f(1.175875602f) + stbi__f2f(-0.899976223f), stbi__f2f(1.175875602f)); + __m128i rot1_1 = dct_const(stbi__f2f(1.175875602f), stbi__f2f(1.175875602f) + stbi__f2f(-2.562915447f)); + __m128i rot2_0 = dct_const(stbi__f2f(-1.961570560f) + stbi__f2f( 0.298631336f), stbi__f2f(-1.961570560f)); + __m128i rot2_1 = dct_const(stbi__f2f(-1.961570560f), stbi__f2f(-1.961570560f) + stbi__f2f( 3.072711026f)); + __m128i rot3_0 = dct_const(stbi__f2f(-0.390180644f) + stbi__f2f( 2.053119869f), stbi__f2f(-0.390180644f)); + __m128i rot3_1 = dct_const(stbi__f2f(-0.390180644f), stbi__f2f(-0.390180644f) + stbi__f2f( 1.501321110f)); + + // rounding biases in column/row passes, see stbi__idct_block for explanation. + __m128i bias_0 = _mm_set1_epi32(512); + __m128i bias_1 = _mm_set1_epi32(65536 + (128<<17)); + + // load + row0 = _mm_load_si128((const __m128i *) (data + 0*8)); + row1 = _mm_load_si128((const __m128i *) (data + 1*8)); + row2 = _mm_load_si128((const __m128i *) (data + 2*8)); + row3 = _mm_load_si128((const __m128i *) (data + 3*8)); + row4 = _mm_load_si128((const __m128i *) (data + 4*8)); + row5 = _mm_load_si128((const __m128i *) (data + 5*8)); + row6 = _mm_load_si128((const __m128i *) (data + 6*8)); + row7 = _mm_load_si128((const __m128i *) (data + 7*8)); + + // column pass + dct_pass(bias_0, 10); + + { + // 16bit 8x8 transpose pass 1 + dct_interleave16(row0, row4); + dct_interleave16(row1, row5); + dct_interleave16(row2, row6); + dct_interleave16(row3, row7); + + // transpose pass 2 + dct_interleave16(row0, row2); + dct_interleave16(row1, row3); + dct_interleave16(row4, row6); + dct_interleave16(row5, row7); + + // transpose pass 3 + dct_interleave16(row0, row1); + dct_interleave16(row2, row3); + dct_interleave16(row4, row5); + dct_interleave16(row6, row7); + } + + // row pass + dct_pass(bias_1, 17); + + { + // pack + __m128i p0 = _mm_packus_epi16(row0, row1); // a0a1a2a3...a7b0b1b2b3...b7 + __m128i p1 = _mm_packus_epi16(row2, row3); + __m128i p2 = _mm_packus_epi16(row4, row5); + __m128i p3 = _mm_packus_epi16(row6, row7); + + // 8bit 8x8 transpose pass 1 + dct_interleave8(p0, p2); // a0e0a1e1... + dct_interleave8(p1, p3); // c0g0c1g1... + + // transpose pass 2 + dct_interleave8(p0, p1); // a0c0e0g0... + dct_interleave8(p2, p3); // b0d0f0h0... + + // transpose pass 3 + dct_interleave8(p0, p2); // a0b0c0d0... + dct_interleave8(p1, p3); // a4b4c4d4... + + // store + _mm_storel_epi64((__m128i *) out, p0); out += out_stride; + _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p0, 0x4e)); out += out_stride; + _mm_storel_epi64((__m128i *) out, p2); out += out_stride; + _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p2, 0x4e)); out += out_stride; + _mm_storel_epi64((__m128i *) out, p1); out += out_stride; + _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p1, 0x4e)); out += out_stride; + _mm_storel_epi64((__m128i *) out, p3); out += out_stride; + _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p3, 0x4e)); + } + +#undef dct_const +#undef dct_rot +#undef dct_widen +#undef dct_wadd +#undef dct_wsub +#undef dct_bfly32o +#undef dct_interleave8 +#undef dct_interleave16 +#undef dct_pass +} + +#endif // STBI_SSE2 + +#ifdef STBI_NEON + +// NEON integer IDCT. should produce bit-identical +// results to the generic C version. +static void stbi__idct_simd(stbi_uc *out, int out_stride, short data[64]) +{ + int16x8_t row0, row1, row2, row3, row4, row5, row6, row7; + + int16x4_t rot0_0 = vdup_n_s16(stbi__f2f(0.5411961f)); + int16x4_t rot0_1 = vdup_n_s16(stbi__f2f(-1.847759065f)); + int16x4_t rot0_2 = vdup_n_s16(stbi__f2f( 0.765366865f)); + int16x4_t rot1_0 = vdup_n_s16(stbi__f2f( 1.175875602f)); + int16x4_t rot1_1 = vdup_n_s16(stbi__f2f(-0.899976223f)); + int16x4_t rot1_2 = vdup_n_s16(stbi__f2f(-2.562915447f)); + int16x4_t rot2_0 = vdup_n_s16(stbi__f2f(-1.961570560f)); + int16x4_t rot2_1 = vdup_n_s16(stbi__f2f(-0.390180644f)); + int16x4_t rot3_0 = vdup_n_s16(stbi__f2f( 0.298631336f)); + int16x4_t rot3_1 = vdup_n_s16(stbi__f2f( 2.053119869f)); + int16x4_t rot3_2 = vdup_n_s16(stbi__f2f( 3.072711026f)); + int16x4_t rot3_3 = vdup_n_s16(stbi__f2f( 1.501321110f)); + +#define dct_long_mul(out, inq, coeff) \ + int32x4_t out##_l = vmull_s16(vget_low_s16(inq), coeff); \ + int32x4_t out##_h = vmull_s16(vget_high_s16(inq), coeff) + +#define dct_long_mac(out, acc, inq, coeff) \ + int32x4_t out##_l = vmlal_s16(acc##_l, vget_low_s16(inq), coeff); \ + int32x4_t out##_h = vmlal_s16(acc##_h, vget_high_s16(inq), coeff) + +#define dct_widen(out, inq) \ + int32x4_t out##_l = vshll_n_s16(vget_low_s16(inq), 12); \ + int32x4_t out##_h = vshll_n_s16(vget_high_s16(inq), 12) + +// wide add +#define dct_wadd(out, a, b) \ + int32x4_t out##_l = vaddq_s32(a##_l, b##_l); \ + int32x4_t out##_h = vaddq_s32(a##_h, b##_h) + +// wide sub +#define dct_wsub(out, a, b) \ + int32x4_t out##_l = vsubq_s32(a##_l, b##_l); \ + int32x4_t out##_h = vsubq_s32(a##_h, b##_h) + +// butterfly a/b, then shift using "shiftop" by "s" and pack +#define dct_bfly32o(out0,out1, a,b,shiftop,s) \ + { \ + dct_wadd(sum, a, b); \ + dct_wsub(dif, a, b); \ + out0 = vcombine_s16(shiftop(sum_l, s), shiftop(sum_h, s)); \ + out1 = vcombine_s16(shiftop(dif_l, s), shiftop(dif_h, s)); \ + } + +#define dct_pass(shiftop, shift) \ + { \ + /* even part */ \ + int16x8_t sum26 = vaddq_s16(row2, row6); \ + dct_long_mul(p1e, sum26, rot0_0); \ + dct_long_mac(t2e, p1e, row6, rot0_1); \ + dct_long_mac(t3e, p1e, row2, rot0_2); \ + int16x8_t sum04 = vaddq_s16(row0, row4); \ + int16x8_t dif04 = vsubq_s16(row0, row4); \ + dct_widen(t0e, sum04); \ + dct_widen(t1e, dif04); \ + dct_wadd(x0, t0e, t3e); \ + dct_wsub(x3, t0e, t3e); \ + dct_wadd(x1, t1e, t2e); \ + dct_wsub(x2, t1e, t2e); \ + /* odd part */ \ + int16x8_t sum15 = vaddq_s16(row1, row5); \ + int16x8_t sum17 = vaddq_s16(row1, row7); \ + int16x8_t sum35 = vaddq_s16(row3, row5); \ + int16x8_t sum37 = vaddq_s16(row3, row7); \ + int16x8_t sumodd = vaddq_s16(sum17, sum35); \ + dct_long_mul(p5o, sumodd, rot1_0); \ + dct_long_mac(p1o, p5o, sum17, rot1_1); \ + dct_long_mac(p2o, p5o, sum35, rot1_2); \ + dct_long_mul(p3o, sum37, rot2_0); \ + dct_long_mul(p4o, sum15, rot2_1); \ + dct_wadd(sump13o, p1o, p3o); \ + dct_wadd(sump24o, p2o, p4o); \ + dct_wadd(sump23o, p2o, p3o); \ + dct_wadd(sump14o, p1o, p4o); \ + dct_long_mac(x4, sump13o, row7, rot3_0); \ + dct_long_mac(x5, sump24o, row5, rot3_1); \ + dct_long_mac(x6, sump23o, row3, rot3_2); \ + dct_long_mac(x7, sump14o, row1, rot3_3); \ + dct_bfly32o(row0,row7, x0,x7,shiftop,shift); \ + dct_bfly32o(row1,row6, x1,x6,shiftop,shift); \ + dct_bfly32o(row2,row5, x2,x5,shiftop,shift); \ + dct_bfly32o(row3,row4, x3,x4,shiftop,shift); \ + } + + // load + row0 = vld1q_s16(data + 0*8); + row1 = vld1q_s16(data + 1*8); + row2 = vld1q_s16(data + 2*8); + row3 = vld1q_s16(data + 3*8); + row4 = vld1q_s16(data + 4*8); + row5 = vld1q_s16(data + 5*8); + row6 = vld1q_s16(data + 6*8); + row7 = vld1q_s16(data + 7*8); + + // add DC bias + row0 = vaddq_s16(row0, vsetq_lane_s16(1024, vdupq_n_s16(0), 0)); + + // column pass + dct_pass(vrshrn_n_s32, 10); + + // 16bit 8x8 transpose + { +// these three map to a single VTRN.16, VTRN.32, and VSWP, respectively. +// whether compilers actually get this is another story, sadly. +#define dct_trn16(x, y) { int16x8x2_t t = vtrnq_s16(x, y); x = t.val[0]; y = t.val[1]; } +#define dct_trn32(x, y) { int32x4x2_t t = vtrnq_s32(vreinterpretq_s32_s16(x), vreinterpretq_s32_s16(y)); x = vreinterpretq_s16_s32(t.val[0]); y = vreinterpretq_s16_s32(t.val[1]); } +#define dct_trn64(x, y) { int16x8_t x0 = x; int16x8_t y0 = y; x = vcombine_s16(vget_low_s16(x0), vget_low_s16(y0)); y = vcombine_s16(vget_high_s16(x0), vget_high_s16(y0)); } + + // pass 1 + dct_trn16(row0, row1); // a0b0a2b2a4b4a6b6 + dct_trn16(row2, row3); + dct_trn16(row4, row5); + dct_trn16(row6, row7); + + // pass 2 + dct_trn32(row0, row2); // a0b0c0d0a4b4c4d4 + dct_trn32(row1, row3); + dct_trn32(row4, row6); + dct_trn32(row5, row7); + + // pass 3 + dct_trn64(row0, row4); // a0b0c0d0e0f0g0h0 + dct_trn64(row1, row5); + dct_trn64(row2, row6); + dct_trn64(row3, row7); + +#undef dct_trn16 +#undef dct_trn32 +#undef dct_trn64 + } + + // row pass + // vrshrn_n_s32 only supports shifts up to 16, we need + // 17. so do a non-rounding shift of 16 first then follow + // up with a rounding shift by 1. + dct_pass(vshrn_n_s32, 16); + + { + // pack and round + uint8x8_t p0 = vqrshrun_n_s16(row0, 1); + uint8x8_t p1 = vqrshrun_n_s16(row1, 1); + uint8x8_t p2 = vqrshrun_n_s16(row2, 1); + uint8x8_t p3 = vqrshrun_n_s16(row3, 1); + uint8x8_t p4 = vqrshrun_n_s16(row4, 1); + uint8x8_t p5 = vqrshrun_n_s16(row5, 1); + uint8x8_t p6 = vqrshrun_n_s16(row6, 1); + uint8x8_t p7 = vqrshrun_n_s16(row7, 1); + + // again, these can translate into one instruction, but often don't. +#define dct_trn8_8(x, y) { uint8x8x2_t t = vtrn_u8(x, y); x = t.val[0]; y = t.val[1]; } +#define dct_trn8_16(x, y) { uint16x4x2_t t = vtrn_u16(vreinterpret_u16_u8(x), vreinterpret_u16_u8(y)); x = vreinterpret_u8_u16(t.val[0]); y = vreinterpret_u8_u16(t.val[1]); } +#define dct_trn8_32(x, y) { uint32x2x2_t t = vtrn_u32(vreinterpret_u32_u8(x), vreinterpret_u32_u8(y)); x = vreinterpret_u8_u32(t.val[0]); y = vreinterpret_u8_u32(t.val[1]); } + + // sadly can't use interleaved stores here since we only write + // 8 bytes to each scan line! + + // 8x8 8-bit transpose pass 1 + dct_trn8_8(p0, p1); + dct_trn8_8(p2, p3); + dct_trn8_8(p4, p5); + dct_trn8_8(p6, p7); + + // pass 2 + dct_trn8_16(p0, p2); + dct_trn8_16(p1, p3); + dct_trn8_16(p4, p6); + dct_trn8_16(p5, p7); + + // pass 3 + dct_trn8_32(p0, p4); + dct_trn8_32(p1, p5); + dct_trn8_32(p2, p6); + dct_trn8_32(p3, p7); + + // store + vst1_u8(out, p0); out += out_stride; + vst1_u8(out, p1); out += out_stride; + vst1_u8(out, p2); out += out_stride; + vst1_u8(out, p3); out += out_stride; + vst1_u8(out, p4); out += out_stride; + vst1_u8(out, p5); out += out_stride; + vst1_u8(out, p6); out += out_stride; + vst1_u8(out, p7); + +#undef dct_trn8_8 +#undef dct_trn8_16 +#undef dct_trn8_32 + } + +#undef dct_long_mul +#undef dct_long_mac +#undef dct_widen +#undef dct_wadd +#undef dct_wsub +#undef dct_bfly32o +#undef dct_pass +} + +#endif // STBI_NEON + +#define STBI__MARKER_none 0xff +// if there's a pending marker from the entropy stream, return that +// otherwise, fetch from the stream and get a marker. if there's no +// marker, return 0xff, which is never a valid marker value +static stbi_uc stbi__get_marker(stbi__jpeg *j) +{ + stbi_uc x; + if (j->marker != STBI__MARKER_none) { x = j->marker; j->marker = STBI__MARKER_none; return x; } + x = stbi__get8(j->s); + if (x != 0xff) return STBI__MARKER_none; + while (x == 0xff) + x = stbi__get8(j->s); // consume repeated 0xff fill bytes + return x; +} + +// in each scan, we'll have scan_n components, and the order +// of the components is specified by order[] +#define STBI__RESTART(x) ((x) >= 0xd0 && (x) <= 0xd7) + +// after a restart interval, stbi__jpeg_reset the entropy decoder and +// the dc prediction +static void stbi__jpeg_reset(stbi__jpeg *j) +{ + j->code_bits = 0; + j->code_buffer = 0; + j->nomore = 0; + j->img_comp[0].dc_pred = j->img_comp[1].dc_pred = j->img_comp[2].dc_pred = j->img_comp[3].dc_pred = 0; + j->marker = STBI__MARKER_none; + j->todo = j->restart_interval ? j->restart_interval : 0x7fffffff; + j->eob_run = 0; + // no more than 1<<31 MCUs if no restart_interal? that's plenty safe, + // since we don't even allow 1<<30 pixels +} + +static int stbi__parse_entropy_coded_data(stbi__jpeg *z) +{ + stbi__jpeg_reset(z); + if (!z->progressive) { + if (z->scan_n == 1) { + int i,j; + STBI_SIMD_ALIGN(short, data[64]); + int n = z->order[0]; + // non-interleaved data, we just need to process one block at a time, + // in trivial scanline order + // number of blocks to do just depends on how many actual "pixels" this + // component has, independent of interleaved MCU blocking and such + int w = (z->img_comp[n].x+7) >> 3; + int h = (z->img_comp[n].y+7) >> 3; + for (j=0; j < h; ++j) { + for (i=0; i < w; ++i) { + int ha = z->img_comp[n].ha; + if (!stbi__jpeg_decode_block(z, data, z->huff_dc+z->img_comp[n].hd, z->huff_ac+ha, z->fast_ac[ha], n, z->dequant[z->img_comp[n].tq])) return 0; + z->idct_block_kernel(z->img_comp[n].data+z->img_comp[n].w2*j*8+i*8, z->img_comp[n].w2, data); + // every data block is an MCU, so countdown the restart interval + if (--z->todo <= 0) { + if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); + // if it's NOT a restart, then just bail, so we get corrupt data + // rather than no data + if (!STBI__RESTART(z->marker)) return 1; + stbi__jpeg_reset(z); + } + } + } + return 1; + } else { // interleaved + int i,j,k,x,y; + STBI_SIMD_ALIGN(short, data[64]); + for (j=0; j < z->img_mcu_y; ++j) { + for (i=0; i < z->img_mcu_x; ++i) { + // scan an interleaved mcu... process scan_n components in order + for (k=0; k < z->scan_n; ++k) { + int n = z->order[k]; + // scan out an mcu's worth of this component; that's just determined + // by the basic H and V specified for the component + for (y=0; y < z->img_comp[n].v; ++y) { + for (x=0; x < z->img_comp[n].h; ++x) { + int x2 = (i*z->img_comp[n].h + x)*8; + int y2 = (j*z->img_comp[n].v + y)*8; + int ha = z->img_comp[n].ha; + if (!stbi__jpeg_decode_block(z, data, z->huff_dc+z->img_comp[n].hd, z->huff_ac+ha, z->fast_ac[ha], n, z->dequant[z->img_comp[n].tq])) return 0; + z->idct_block_kernel(z->img_comp[n].data+z->img_comp[n].w2*y2+x2, z->img_comp[n].w2, data); + } + } + } + // after all interleaved components, that's an interleaved MCU, + // so now count down the restart interval + if (--z->todo <= 0) { + if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); + if (!STBI__RESTART(z->marker)) return 1; + stbi__jpeg_reset(z); + } + } + } + return 1; + } + } else { + if (z->scan_n == 1) { + int i,j; + int n = z->order[0]; + // non-interleaved data, we just need to process one block at a time, + // in trivial scanline order + // number of blocks to do just depends on how many actual "pixels" this + // component has, independent of interleaved MCU blocking and such + int w = (z->img_comp[n].x+7) >> 3; + int h = (z->img_comp[n].y+7) >> 3; + for (j=0; j < h; ++j) { + for (i=0; i < w; ++i) { + short *data = z->img_comp[n].coeff + 64 * (i + j * z->img_comp[n].coeff_w); + if (z->spec_start == 0) { + if (!stbi__jpeg_decode_block_prog_dc(z, data, &z->huff_dc[z->img_comp[n].hd], n)) + return 0; + } else { + int ha = z->img_comp[n].ha; + if (!stbi__jpeg_decode_block_prog_ac(z, data, &z->huff_ac[ha], z->fast_ac[ha])) + return 0; + } + // every data block is an MCU, so countdown the restart interval + if (--z->todo <= 0) { + if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); + if (!STBI__RESTART(z->marker)) return 1; + stbi__jpeg_reset(z); + } + } + } + return 1; + } else { // interleaved + int i,j,k,x,y; + for (j=0; j < z->img_mcu_y; ++j) { + for (i=0; i < z->img_mcu_x; ++i) { + // scan an interleaved mcu... process scan_n components in order + for (k=0; k < z->scan_n; ++k) { + int n = z->order[k]; + // scan out an mcu's worth of this component; that's just determined + // by the basic H and V specified for the component + for (y=0; y < z->img_comp[n].v; ++y) { + for (x=0; x < z->img_comp[n].h; ++x) { + int x2 = (i*z->img_comp[n].h + x); + int y2 = (j*z->img_comp[n].v + y); + short *data = z->img_comp[n].coeff + 64 * (x2 + y2 * z->img_comp[n].coeff_w); + if (!stbi__jpeg_decode_block_prog_dc(z, data, &z->huff_dc[z->img_comp[n].hd], n)) + return 0; + } + } + } + // after all interleaved components, that's an interleaved MCU, + // so now count down the restart interval + if (--z->todo <= 0) { + if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); + if (!STBI__RESTART(z->marker)) return 1; + stbi__jpeg_reset(z); + } + } + } + return 1; + } + } +} + +static void stbi__jpeg_dequantize(short *data, stbi__uint16 *dequant) +{ + int i; + for (i=0; i < 64; ++i) + data[i] *= dequant[i]; +} + +static void stbi__jpeg_finish(stbi__jpeg *z) +{ + if (z->progressive) { + // dequantize and idct the data + int i,j,n; + for (n=0; n < z->s->img_n; ++n) { + int w = (z->img_comp[n].x+7) >> 3; + int h = (z->img_comp[n].y+7) >> 3; + for (j=0; j < h; ++j) { + for (i=0; i < w; ++i) { + short *data = z->img_comp[n].coeff + 64 * (i + j * z->img_comp[n].coeff_w); + stbi__jpeg_dequantize(data, z->dequant[z->img_comp[n].tq]); + z->idct_block_kernel(z->img_comp[n].data+z->img_comp[n].w2*j*8+i*8, z->img_comp[n].w2, data); + } + } + } + } +} + +static int stbi__process_marker(stbi__jpeg *z, int m) +{ + int L; + switch (m) { + case STBI__MARKER_none: // no marker found + return stbi__err("expected marker","Corrupt JPEG"); + + case 0xDD: // DRI - specify restart interval + if (stbi__get16be(z->s) != 4) return stbi__err("bad DRI len","Corrupt JPEG"); + z->restart_interval = stbi__get16be(z->s); + return 1; + + case 0xDB: // DQT - define quantization table + L = stbi__get16be(z->s)-2; + while (L > 0) { + int q = stbi__get8(z->s); + int p = q >> 4, sixteen = (p != 0); + int t = q & 15,i; + if (p != 0 && p != 1) return stbi__err("bad DQT type","Corrupt JPEG"); + if (t > 3) return stbi__err("bad DQT table","Corrupt JPEG"); + + for (i=0; i < 64; ++i) + z->dequant[t][stbi__jpeg_dezigzag[i]] = (stbi__uint16)(sixteen ? stbi__get16be(z->s) : stbi__get8(z->s)); + L -= (sixteen ? 129 : 65); + } + return L==0; + + case 0xC4: // DHT - define huffman table + L = stbi__get16be(z->s)-2; + while (L > 0) { + stbi_uc *v; + int sizes[16],i,n=0; + int q = stbi__get8(z->s); + int tc = q >> 4; + int th = q & 15; + if (tc > 1 || th > 3) return stbi__err("bad DHT header","Corrupt JPEG"); + for (i=0; i < 16; ++i) { + sizes[i] = stbi__get8(z->s); + n += sizes[i]; + } + if(n > 256) return stbi__err("bad DHT header","Corrupt JPEG"); // Loop over i < n would write past end of values! + L -= 17; + if (tc == 0) { + if (!stbi__build_huffman(z->huff_dc+th, sizes)) return 0; + v = z->huff_dc[th].values; + } else { + if (!stbi__build_huffman(z->huff_ac+th, sizes)) return 0; + v = z->huff_ac[th].values; + } + for (i=0; i < n; ++i) + v[i] = stbi__get8(z->s); + if (tc != 0) + stbi__build_fast_ac(z->fast_ac[th], z->huff_ac + th); + L -= n; + } + return L==0; + } + + // check for comment block or APP blocks + if ((m >= 0xE0 && m <= 0xEF) || m == 0xFE) { + L = stbi__get16be(z->s); + if (L < 2) { + if (m == 0xFE) + return stbi__err("bad COM len","Corrupt JPEG"); + else + return stbi__err("bad APP len","Corrupt JPEG"); + } + L -= 2; + + if (m == 0xE0 && L >= 5) { // JFIF APP0 segment + static const unsigned char tag[5] = {'J','F','I','F','\0'}; + int ok = 1; + int i; + for (i=0; i < 5; ++i) + if (stbi__get8(z->s) != tag[i]) + ok = 0; + L -= 5; + if (ok) + z->jfif = 1; + } else if (m == 0xEE && L >= 12) { // Adobe APP14 segment + static const unsigned char tag[6] = {'A','d','o','b','e','\0'}; + int ok = 1; + int i; + for (i=0; i < 6; ++i) + if (stbi__get8(z->s) != tag[i]) + ok = 0; + L -= 6; + if (ok) { + stbi__get8(z->s); // version + stbi__get16be(z->s); // flags0 + stbi__get16be(z->s); // flags1 + z->app14_color_transform = stbi__get8(z->s); // color transform + L -= 6; + } + } + + stbi__skip(z->s, L); + return 1; + } + + return stbi__err("unknown marker","Corrupt JPEG"); +} + +// after we see SOS +static int stbi__process_scan_header(stbi__jpeg *z) +{ + int i; + int Ls = stbi__get16be(z->s); + z->scan_n = stbi__get8(z->s); + if (z->scan_n < 1 || z->scan_n > 4 || z->scan_n > (int) z->s->img_n) return stbi__err("bad SOS component count","Corrupt JPEG"); + if (Ls != 6+2*z->scan_n) return stbi__err("bad SOS len","Corrupt JPEG"); + for (i=0; i < z->scan_n; ++i) { + int id = stbi__get8(z->s), which; + int q = stbi__get8(z->s); + for (which = 0; which < z->s->img_n; ++which) + if (z->img_comp[which].id == id) + break; + if (which == z->s->img_n) return 0; // no match + z->img_comp[which].hd = q >> 4; if (z->img_comp[which].hd > 3) return stbi__err("bad DC huff","Corrupt JPEG"); + z->img_comp[which].ha = q & 15; if (z->img_comp[which].ha > 3) return stbi__err("bad AC huff","Corrupt JPEG"); + z->order[i] = which; + } + + { + int aa; + z->spec_start = stbi__get8(z->s); + z->spec_end = stbi__get8(z->s); // should be 63, but might be 0 + aa = stbi__get8(z->s); + z->succ_high = (aa >> 4); + z->succ_low = (aa & 15); + if (z->progressive) { + if (z->spec_start > 63 || z->spec_end > 63 || z->spec_start > z->spec_end || z->succ_high > 13 || z->succ_low > 13) + return stbi__err("bad SOS", "Corrupt JPEG"); + } else { + if (z->spec_start != 0) return stbi__err("bad SOS","Corrupt JPEG"); + if (z->succ_high != 0 || z->succ_low != 0) return stbi__err("bad SOS","Corrupt JPEG"); + z->spec_end = 63; + } + } + + return 1; +} + +static int stbi__free_jpeg_components(stbi__jpeg *z, int ncomp, int why) +{ + int i; + for (i=0; i < ncomp; ++i) { + if (z->img_comp[i].raw_data) { + STBI_FREE(z->img_comp[i].raw_data); + z->img_comp[i].raw_data = NULL; + z->img_comp[i].data = NULL; + } + if (z->img_comp[i].raw_coeff) { + STBI_FREE(z->img_comp[i].raw_coeff); + z->img_comp[i].raw_coeff = 0; + z->img_comp[i].coeff = 0; + } + if (z->img_comp[i].linebuf) { + STBI_FREE(z->img_comp[i].linebuf); + z->img_comp[i].linebuf = NULL; + } + } + return why; +} + +static int stbi__process_frame_header(stbi__jpeg *z, int scan) +{ + stbi__context *s = z->s; + int Lf,p,i,q, h_max=1,v_max=1,c; + Lf = stbi__get16be(s); if (Lf < 11) return stbi__err("bad SOF len","Corrupt JPEG"); // JPEG + p = stbi__get8(s); if (p != 8) return stbi__err("only 8-bit","JPEG format not supported: 8-bit only"); // JPEG baseline + s->img_y = stbi__get16be(s); if (s->img_y == 0) return stbi__err("no header height", "JPEG format not supported: delayed height"); // Legal, but we don't handle it--but neither does IJG + s->img_x = stbi__get16be(s); if (s->img_x == 0) return stbi__err("0 width","Corrupt JPEG"); // JPEG requires + if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + c = stbi__get8(s); + if (c != 3 && c != 1 && c != 4) return stbi__err("bad component count","Corrupt JPEG"); + s->img_n = c; + for (i=0; i < c; ++i) { + z->img_comp[i].data = NULL; + z->img_comp[i].linebuf = NULL; + } + + if (Lf != 8+3*s->img_n) return stbi__err("bad SOF len","Corrupt JPEG"); + + z->rgb = 0; + for (i=0; i < s->img_n; ++i) { + static const unsigned char rgb[3] = { 'R', 'G', 'B' }; + z->img_comp[i].id = stbi__get8(s); + if (s->img_n == 3 && z->img_comp[i].id == rgb[i]) + ++z->rgb; + q = stbi__get8(s); + z->img_comp[i].h = (q >> 4); if (!z->img_comp[i].h || z->img_comp[i].h > 4) return stbi__err("bad H","Corrupt JPEG"); + z->img_comp[i].v = q & 15; if (!z->img_comp[i].v || z->img_comp[i].v > 4) return stbi__err("bad V","Corrupt JPEG"); + z->img_comp[i].tq = stbi__get8(s); if (z->img_comp[i].tq > 3) return stbi__err("bad TQ","Corrupt JPEG"); + } + + if (scan != STBI__SCAN_load) return 1; + + if (!stbi__mad3sizes_valid(s->img_x, s->img_y, s->img_n, 0)) return stbi__err("too large", "Image too large to decode"); + + for (i=0; i < s->img_n; ++i) { + if (z->img_comp[i].h > h_max) h_max = z->img_comp[i].h; + if (z->img_comp[i].v > v_max) v_max = z->img_comp[i].v; + } + + // check that plane subsampling factors are integer ratios; our resamplers can't deal with fractional ratios + // and I've never seen a non-corrupted JPEG file actually use them + for (i=0; i < s->img_n; ++i) { + if (h_max % z->img_comp[i].h != 0) return stbi__err("bad H","Corrupt JPEG"); + if (v_max % z->img_comp[i].v != 0) return stbi__err("bad V","Corrupt JPEG"); + } + + // compute interleaved mcu info + z->img_h_max = h_max; + z->img_v_max = v_max; + z->img_mcu_w = h_max * 8; + z->img_mcu_h = v_max * 8; + // these sizes can't be more than 17 bits + z->img_mcu_x = (s->img_x + z->img_mcu_w-1) / z->img_mcu_w; + z->img_mcu_y = (s->img_y + z->img_mcu_h-1) / z->img_mcu_h; + + for (i=0; i < s->img_n; ++i) { + // number of effective pixels (e.g. for non-interleaved MCU) + z->img_comp[i].x = (s->img_x * z->img_comp[i].h + h_max-1) / h_max; + z->img_comp[i].y = (s->img_y * z->img_comp[i].v + v_max-1) / v_max; + // to simplify generation, we'll allocate enough memory to decode + // the bogus oversized data from using interleaved MCUs and their + // big blocks (e.g. a 16x16 iMCU on an image of width 33); we won't + // discard the extra data until colorspace conversion + // + // img_mcu_x, img_mcu_y: <=17 bits; comp[i].h and .v are <=4 (checked earlier) + // so these muls can't overflow with 32-bit ints (which we require) + z->img_comp[i].w2 = z->img_mcu_x * z->img_comp[i].h * 8; + z->img_comp[i].h2 = z->img_mcu_y * z->img_comp[i].v * 8; + z->img_comp[i].coeff = 0; + z->img_comp[i].raw_coeff = 0; + z->img_comp[i].linebuf = NULL; + z->img_comp[i].raw_data = stbi__malloc_mad2(z->img_comp[i].w2, z->img_comp[i].h2, 15); + if (z->img_comp[i].raw_data == NULL) + return stbi__free_jpeg_components(z, i+1, stbi__err("outofmem", "Out of memory")); + // align blocks for idct using mmx/sse + z->img_comp[i].data = (stbi_uc*) (((size_t) z->img_comp[i].raw_data + 15) & ~15); + if (z->progressive) { + // w2, h2 are multiples of 8 (see above) + z->img_comp[i].coeff_w = z->img_comp[i].w2 / 8; + z->img_comp[i].coeff_h = z->img_comp[i].h2 / 8; + z->img_comp[i].raw_coeff = stbi__malloc_mad3(z->img_comp[i].w2, z->img_comp[i].h2, sizeof(short), 15); + if (z->img_comp[i].raw_coeff == NULL) + return stbi__free_jpeg_components(z, i+1, stbi__err("outofmem", "Out of memory")); + z->img_comp[i].coeff = (short*) (((size_t) z->img_comp[i].raw_coeff + 15) & ~15); + } + } + + return 1; +} + +// use comparisons since in some cases we handle more than one case (e.g. SOF) +#define stbi__DNL(x) ((x) == 0xdc) +#define stbi__SOI(x) ((x) == 0xd8) +#define stbi__EOI(x) ((x) == 0xd9) +#define stbi__SOF(x) ((x) == 0xc0 || (x) == 0xc1 || (x) == 0xc2) +#define stbi__SOS(x) ((x) == 0xda) + +#define stbi__SOF_progressive(x) ((x) == 0xc2) + +static int stbi__decode_jpeg_header(stbi__jpeg *z, int scan) +{ + int m; + z->jfif = 0; + z->app14_color_transform = -1; // valid values are 0,1,2 + z->marker = STBI__MARKER_none; // initialize cached marker to empty + m = stbi__get_marker(z); + if (!stbi__SOI(m)) return stbi__err("no SOI","Corrupt JPEG"); + if (scan == STBI__SCAN_type) return 1; + m = stbi__get_marker(z); + while (!stbi__SOF(m)) { + if (!stbi__process_marker(z,m)) return 0; + m = stbi__get_marker(z); + while (m == STBI__MARKER_none) { + // some files have extra padding after their blocks, so ok, we'll scan + if (stbi__at_eof(z->s)) return stbi__err("no SOF", "Corrupt JPEG"); + m = stbi__get_marker(z); + } + } + z->progressive = stbi__SOF_progressive(m); + if (!stbi__process_frame_header(z, scan)) return 0; + return 1; +} + +static stbi_uc stbi__skip_jpeg_junk_at_end(stbi__jpeg *j) +{ + // some JPEGs have junk at end, skip over it but if we find what looks + // like a valid marker, resume there + while (!stbi__at_eof(j->s)) { + stbi_uc x = stbi__get8(j->s); + while (x == 0xff) { // might be a marker + if (stbi__at_eof(j->s)) return STBI__MARKER_none; + x = stbi__get8(j->s); + if (x != 0x00 && x != 0xff) { + // not a stuffed zero or lead-in to another marker, looks + // like an actual marker, return it + return x; + } + // stuffed zero has x=0 now which ends the loop, meaning we go + // back to regular scan loop. + // repeated 0xff keeps trying to read the next byte of the marker. + } + } + return STBI__MARKER_none; +} + +// decode image to YCbCr format +static int stbi__decode_jpeg_image(stbi__jpeg *j) +{ + int m; + for (m = 0; m < 4; m++) { + j->img_comp[m].raw_data = NULL; + j->img_comp[m].raw_coeff = NULL; + } + j->restart_interval = 0; + if (!stbi__decode_jpeg_header(j, STBI__SCAN_load)) return 0; + m = stbi__get_marker(j); + while (!stbi__EOI(m)) { + if (stbi__SOS(m)) { + if (!stbi__process_scan_header(j)) return 0; + if (!stbi__parse_entropy_coded_data(j)) return 0; + if (j->marker == STBI__MARKER_none ) { + j->marker = stbi__skip_jpeg_junk_at_end(j); + // if we reach eof without hitting a marker, stbi__get_marker() below will fail and we'll eventually return 0 + } + m = stbi__get_marker(j); + if (STBI__RESTART(m)) + m = stbi__get_marker(j); + } else if (stbi__DNL(m)) { + int Ld = stbi__get16be(j->s); + stbi__uint32 NL = stbi__get16be(j->s); + if (Ld != 4) return stbi__err("bad DNL len", "Corrupt JPEG"); + if (NL != j->s->img_y) return stbi__err("bad DNL height", "Corrupt JPEG"); + m = stbi__get_marker(j); + } else { + if (!stbi__process_marker(j, m)) return 1; + m = stbi__get_marker(j); + } + } + if (j->progressive) + stbi__jpeg_finish(j); + return 1; +} + +// static jfif-centered resampling (across block boundaries) + +typedef stbi_uc *(*resample_row_func)(stbi_uc *out, stbi_uc *in0, stbi_uc *in1, + int w, int hs); + +#define stbi__div4(x) ((stbi_uc) ((x) >> 2)) + +static stbi_uc *resample_row_1(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +{ + STBI_NOTUSED(out); + STBI_NOTUSED(in_far); + STBI_NOTUSED(w); + STBI_NOTUSED(hs); + return in_near; +} + +static stbi_uc* stbi__resample_row_v_2(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +{ + // need to generate two samples vertically for every one in input + int i; + STBI_NOTUSED(hs); + for (i=0; i < w; ++i) + out[i] = stbi__div4(3*in_near[i] + in_far[i] + 2); + return out; +} + +static stbi_uc* stbi__resample_row_h_2(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +{ + // need to generate two samples horizontally for every one in input + int i; + stbi_uc *input = in_near; + + if (w == 1) { + // if only one sample, can't do any interpolation + out[0] = out[1] = input[0]; + return out; + } + + out[0] = input[0]; + out[1] = stbi__div4(input[0]*3 + input[1] + 2); + for (i=1; i < w-1; ++i) { + int n = 3*input[i]+2; + out[i*2+0] = stbi__div4(n+input[i-1]); + out[i*2+1] = stbi__div4(n+input[i+1]); + } + out[i*2+0] = stbi__div4(input[w-2]*3 + input[w-1] + 2); + out[i*2+1] = input[w-1]; + + STBI_NOTUSED(in_far); + STBI_NOTUSED(hs); + + return out; +} + +#define stbi__div16(x) ((stbi_uc) ((x) >> 4)) + +static stbi_uc *stbi__resample_row_hv_2(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +{ + // need to generate 2x2 samples for every one in input + int i,t0,t1; + if (w == 1) { + out[0] = out[1] = stbi__div4(3*in_near[0] + in_far[0] + 2); + return out; + } + + t1 = 3*in_near[0] + in_far[0]; + out[0] = stbi__div4(t1+2); + for (i=1; i < w; ++i) { + t0 = t1; + t1 = 3*in_near[i]+in_far[i]; + out[i*2-1] = stbi__div16(3*t0 + t1 + 8); + out[i*2 ] = stbi__div16(3*t1 + t0 + 8); + } + out[w*2-1] = stbi__div4(t1+2); + + STBI_NOTUSED(hs); + + return out; +} + +#if defined(STBI_SSE2) || defined(STBI_NEON) +static stbi_uc *stbi__resample_row_hv_2_simd(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +{ + // need to generate 2x2 samples for every one in input + int i=0,t0,t1; + + if (w == 1) { + out[0] = out[1] = stbi__div4(3*in_near[0] + in_far[0] + 2); + return out; + } + + t1 = 3*in_near[0] + in_far[0]; + // process groups of 8 pixels for as long as we can. + // note we can't handle the last pixel in a row in this loop + // because we need to handle the filter boundary conditions. + for (; i < ((w-1) & ~7); i += 8) { +#if defined(STBI_SSE2) + // load and perform the vertical filtering pass + // this uses 3*x + y = 4*x + (y - x) + __m128i zero = _mm_setzero_si128(); + __m128i farb = _mm_loadl_epi64((__m128i *) (in_far + i)); + __m128i nearb = _mm_loadl_epi64((__m128i *) (in_near + i)); + __m128i farw = _mm_unpacklo_epi8(farb, zero); + __m128i nearw = _mm_unpacklo_epi8(nearb, zero); + __m128i diff = _mm_sub_epi16(farw, nearw); + __m128i nears = _mm_slli_epi16(nearw, 2); + __m128i curr = _mm_add_epi16(nears, diff); // current row + + // horizontal filter works the same based on shifted vers of current + // row. "prev" is current row shifted right by 1 pixel; we need to + // insert the previous pixel value (from t1). + // "next" is current row shifted left by 1 pixel, with first pixel + // of next block of 8 pixels added in. + __m128i prv0 = _mm_slli_si128(curr, 2); + __m128i nxt0 = _mm_srli_si128(curr, 2); + __m128i prev = _mm_insert_epi16(prv0, t1, 0); + __m128i next = _mm_insert_epi16(nxt0, 3*in_near[i+8] + in_far[i+8], 7); + + // horizontal filter, polyphase implementation since it's convenient: + // even pixels = 3*cur + prev = cur*4 + (prev - cur) + // odd pixels = 3*cur + next = cur*4 + (next - cur) + // note the shared term. + __m128i bias = _mm_set1_epi16(8); + __m128i curs = _mm_slli_epi16(curr, 2); + __m128i prvd = _mm_sub_epi16(prev, curr); + __m128i nxtd = _mm_sub_epi16(next, curr); + __m128i curb = _mm_add_epi16(curs, bias); + __m128i even = _mm_add_epi16(prvd, curb); + __m128i odd = _mm_add_epi16(nxtd, curb); + + // interleave even and odd pixels, then undo scaling. + __m128i int0 = _mm_unpacklo_epi16(even, odd); + __m128i int1 = _mm_unpackhi_epi16(even, odd); + __m128i de0 = _mm_srli_epi16(int0, 4); + __m128i de1 = _mm_srli_epi16(int1, 4); + + // pack and write output + __m128i outv = _mm_packus_epi16(de0, de1); + _mm_storeu_si128((__m128i *) (out + i*2), outv); +#elif defined(STBI_NEON) + // load and perform the vertical filtering pass + // this uses 3*x + y = 4*x + (y - x) + uint8x8_t farb = vld1_u8(in_far + i); + uint8x8_t nearb = vld1_u8(in_near + i); + int16x8_t diff = vreinterpretq_s16_u16(vsubl_u8(farb, nearb)); + int16x8_t nears = vreinterpretq_s16_u16(vshll_n_u8(nearb, 2)); + int16x8_t curr = vaddq_s16(nears, diff); // current row + + // horizontal filter works the same based on shifted vers of current + // row. "prev" is current row shifted right by 1 pixel; we need to + // insert the previous pixel value (from t1). + // "next" is current row shifted left by 1 pixel, with first pixel + // of next block of 8 pixels added in. + int16x8_t prv0 = vextq_s16(curr, curr, 7); + int16x8_t nxt0 = vextq_s16(curr, curr, 1); + int16x8_t prev = vsetq_lane_s16(t1, prv0, 0); + int16x8_t next = vsetq_lane_s16(3*in_near[i+8] + in_far[i+8], nxt0, 7); + + // horizontal filter, polyphase implementation since it's convenient: + // even pixels = 3*cur + prev = cur*4 + (prev - cur) + // odd pixels = 3*cur + next = cur*4 + (next - cur) + // note the shared term. + int16x8_t curs = vshlq_n_s16(curr, 2); + int16x8_t prvd = vsubq_s16(prev, curr); + int16x8_t nxtd = vsubq_s16(next, curr); + int16x8_t even = vaddq_s16(curs, prvd); + int16x8_t odd = vaddq_s16(curs, nxtd); + + // undo scaling and round, then store with even/odd phases interleaved + uint8x8x2_t o; + o.val[0] = vqrshrun_n_s16(even, 4); + o.val[1] = vqrshrun_n_s16(odd, 4); + vst2_u8(out + i*2, o); +#endif + + // "previous" value for next iter + t1 = 3*in_near[i+7] + in_far[i+7]; + } + + t0 = t1; + t1 = 3*in_near[i] + in_far[i]; + out[i*2] = stbi__div16(3*t1 + t0 + 8); + + for (++i; i < w; ++i) { + t0 = t1; + t1 = 3*in_near[i]+in_far[i]; + out[i*2-1] = stbi__div16(3*t0 + t1 + 8); + out[i*2 ] = stbi__div16(3*t1 + t0 + 8); + } + out[w*2-1] = stbi__div4(t1+2); + + STBI_NOTUSED(hs); + + return out; +} +#endif + +static stbi_uc *stbi__resample_row_generic(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +{ + // resample with nearest-neighbor + int i,j; + STBI_NOTUSED(in_far); + for (i=0; i < w; ++i) + for (j=0; j < hs; ++j) + out[i*hs+j] = in_near[i]; + return out; +} + +// this is a reduced-precision calculation of YCbCr-to-RGB introduced +// to make sure the code produces the same results in both SIMD and scalar +#define stbi__float2fixed(x) (((int) ((x) * 4096.0f + 0.5f)) << 8) +static void stbi__YCbCr_to_RGB_row(stbi_uc *out, const stbi_uc *y, const stbi_uc *pcb, const stbi_uc *pcr, int count, int step) +{ + int i; + for (i=0; i < count; ++i) { + int y_fixed = (y[i] << 20) + (1<<19); // rounding + int r,g,b; + int cr = pcr[i] - 128; + int cb = pcb[i] - 128; + r = y_fixed + cr* stbi__float2fixed(1.40200f); + g = y_fixed + (cr*-stbi__float2fixed(0.71414f)) + ((cb*-stbi__float2fixed(0.34414f)) & 0xffff0000); + b = y_fixed + cb* stbi__float2fixed(1.77200f); + r >>= 20; + g >>= 20; + b >>= 20; + if ((unsigned) r > 255) { if (r < 0) r = 0; else r = 255; } + if ((unsigned) g > 255) { if (g < 0) g = 0; else g = 255; } + if ((unsigned) b > 255) { if (b < 0) b = 0; else b = 255; } + out[0] = (stbi_uc)r; + out[1] = (stbi_uc)g; + out[2] = (stbi_uc)b; + out[3] = 255; + out += step; + } +} + +#if defined(STBI_SSE2) || defined(STBI_NEON) +static void stbi__YCbCr_to_RGB_simd(stbi_uc *out, stbi_uc const *y, stbi_uc const *pcb, stbi_uc const *pcr, int count, int step) +{ + int i = 0; + +#ifdef STBI_SSE2 + // step == 3 is pretty ugly on the final interleave, and i'm not convinced + // it's useful in practice (you wouldn't use it for textures, for example). + // so just accelerate step == 4 case. + if (step == 4) { + // this is a fairly straightforward implementation and not super-optimized. + __m128i signflip = _mm_set1_epi8(-0x80); + __m128i cr_const0 = _mm_set1_epi16( (short) ( 1.40200f*4096.0f+0.5f)); + __m128i cr_const1 = _mm_set1_epi16( - (short) ( 0.71414f*4096.0f+0.5f)); + __m128i cb_const0 = _mm_set1_epi16( - (short) ( 0.34414f*4096.0f+0.5f)); + __m128i cb_const1 = _mm_set1_epi16( (short) ( 1.77200f*4096.0f+0.5f)); + __m128i y_bias = _mm_set1_epi8((char) (unsigned char) 128); + __m128i xw = _mm_set1_epi16(255); // alpha channel + + for (; i+7 < count; i += 8) { + // load + __m128i y_bytes = _mm_loadl_epi64((__m128i *) (y+i)); + __m128i cr_bytes = _mm_loadl_epi64((__m128i *) (pcr+i)); + __m128i cb_bytes = _mm_loadl_epi64((__m128i *) (pcb+i)); + __m128i cr_biased = _mm_xor_si128(cr_bytes, signflip); // -128 + __m128i cb_biased = _mm_xor_si128(cb_bytes, signflip); // -128 + + // unpack to short (and left-shift cr, cb by 8) + __m128i yw = _mm_unpacklo_epi8(y_bias, y_bytes); + __m128i crw = _mm_unpacklo_epi8(_mm_setzero_si128(), cr_biased); + __m128i cbw = _mm_unpacklo_epi8(_mm_setzero_si128(), cb_biased); + + // color transform + __m128i yws = _mm_srli_epi16(yw, 4); + __m128i cr0 = _mm_mulhi_epi16(cr_const0, crw); + __m128i cb0 = _mm_mulhi_epi16(cb_const0, cbw); + __m128i cb1 = _mm_mulhi_epi16(cbw, cb_const1); + __m128i cr1 = _mm_mulhi_epi16(crw, cr_const1); + __m128i rws = _mm_add_epi16(cr0, yws); + __m128i gwt = _mm_add_epi16(cb0, yws); + __m128i bws = _mm_add_epi16(yws, cb1); + __m128i gws = _mm_add_epi16(gwt, cr1); + + // descale + __m128i rw = _mm_srai_epi16(rws, 4); + __m128i bw = _mm_srai_epi16(bws, 4); + __m128i gw = _mm_srai_epi16(gws, 4); + + // back to byte, set up for transpose + __m128i brb = _mm_packus_epi16(rw, bw); + __m128i gxb = _mm_packus_epi16(gw, xw); + + // transpose to interleave channels + __m128i t0 = _mm_unpacklo_epi8(brb, gxb); + __m128i t1 = _mm_unpackhi_epi8(brb, gxb); + __m128i o0 = _mm_unpacklo_epi16(t0, t1); + __m128i o1 = _mm_unpackhi_epi16(t0, t1); + + // store + _mm_storeu_si128((__m128i *) (out + 0), o0); + _mm_storeu_si128((__m128i *) (out + 16), o1); + out += 32; + } + } +#endif + +#ifdef STBI_NEON + // in this version, step=3 support would be easy to add. but is there demand? + if (step == 4) { + // this is a fairly straightforward implementation and not super-optimized. + uint8x8_t signflip = vdup_n_u8(0x80); + int16x8_t cr_const0 = vdupq_n_s16( (short) ( 1.40200f*4096.0f+0.5f)); + int16x8_t cr_const1 = vdupq_n_s16( - (short) ( 0.71414f*4096.0f+0.5f)); + int16x8_t cb_const0 = vdupq_n_s16( - (short) ( 0.34414f*4096.0f+0.5f)); + int16x8_t cb_const1 = vdupq_n_s16( (short) ( 1.77200f*4096.0f+0.5f)); + + for (; i+7 < count; i += 8) { + // load + uint8x8_t y_bytes = vld1_u8(y + i); + uint8x8_t cr_bytes = vld1_u8(pcr + i); + uint8x8_t cb_bytes = vld1_u8(pcb + i); + int8x8_t cr_biased = vreinterpret_s8_u8(vsub_u8(cr_bytes, signflip)); + int8x8_t cb_biased = vreinterpret_s8_u8(vsub_u8(cb_bytes, signflip)); + + // expand to s16 + int16x8_t yws = vreinterpretq_s16_u16(vshll_n_u8(y_bytes, 4)); + int16x8_t crw = vshll_n_s8(cr_biased, 7); + int16x8_t cbw = vshll_n_s8(cb_biased, 7); + + // color transform + int16x8_t cr0 = vqdmulhq_s16(crw, cr_const0); + int16x8_t cb0 = vqdmulhq_s16(cbw, cb_const0); + int16x8_t cr1 = vqdmulhq_s16(crw, cr_const1); + int16x8_t cb1 = vqdmulhq_s16(cbw, cb_const1); + int16x8_t rws = vaddq_s16(yws, cr0); + int16x8_t gws = vaddq_s16(vaddq_s16(yws, cb0), cr1); + int16x8_t bws = vaddq_s16(yws, cb1); + + // undo scaling, round, convert to byte + uint8x8x4_t o; + o.val[0] = vqrshrun_n_s16(rws, 4); + o.val[1] = vqrshrun_n_s16(gws, 4); + o.val[2] = vqrshrun_n_s16(bws, 4); + o.val[3] = vdup_n_u8(255); + + // store, interleaving r/g/b/a + vst4_u8(out, o); + out += 8*4; + } + } +#endif + + for (; i < count; ++i) { + int y_fixed = (y[i] << 20) + (1<<19); // rounding + int r,g,b; + int cr = pcr[i] - 128; + int cb = pcb[i] - 128; + r = y_fixed + cr* stbi__float2fixed(1.40200f); + g = y_fixed + cr*-stbi__float2fixed(0.71414f) + ((cb*-stbi__float2fixed(0.34414f)) & 0xffff0000); + b = y_fixed + cb* stbi__float2fixed(1.77200f); + r >>= 20; + g >>= 20; + b >>= 20; + if ((unsigned) r > 255) { if (r < 0) r = 0; else r = 255; } + if ((unsigned) g > 255) { if (g < 0) g = 0; else g = 255; } + if ((unsigned) b > 255) { if (b < 0) b = 0; else b = 255; } + out[0] = (stbi_uc)r; + out[1] = (stbi_uc)g; + out[2] = (stbi_uc)b; + out[3] = 255; + out += step; + } +} +#endif + +// set up the kernels +static void stbi__setup_jpeg(stbi__jpeg *j) +{ + j->idct_block_kernel = stbi__idct_block; + j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_row; + j->resample_row_hv_2_kernel = stbi__resample_row_hv_2; + +#ifdef STBI_SSE2 + if (stbi__sse2_available()) { + j->idct_block_kernel = stbi__idct_simd; + j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_simd; + j->resample_row_hv_2_kernel = stbi__resample_row_hv_2_simd; + } +#endif + +#ifdef STBI_NEON + j->idct_block_kernel = stbi__idct_simd; + j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_simd; + j->resample_row_hv_2_kernel = stbi__resample_row_hv_2_simd; +#endif +} + +// clean up the temporary component buffers +static void stbi__cleanup_jpeg(stbi__jpeg *j) +{ + stbi__free_jpeg_components(j, j->s->img_n, 0); +} + +typedef struct +{ + resample_row_func resample; + stbi_uc *line0,*line1; + int hs,vs; // expansion factor in each axis + int w_lores; // horizontal pixels pre-expansion + int ystep; // how far through vertical expansion we are + int ypos; // which pre-expansion row we're on +} stbi__resample; + +// fast 0..255 * 0..255 => 0..255 rounded multiplication +static stbi_uc stbi__blinn_8x8(stbi_uc x, stbi_uc y) +{ + unsigned int t = x*y + 128; + return (stbi_uc) ((t + (t >>8)) >> 8); +} + +static stbi_uc *load_jpeg_image(stbi__jpeg *z, int *out_x, int *out_y, int *comp, int req_comp) +{ + int n, decode_n, is_rgb; + z->s->img_n = 0; // make stbi__cleanup_jpeg safe + + // validate req_comp + if (req_comp < 0 || req_comp > 4) return stbi__errpuc("bad req_comp", "Internal error"); + + // load a jpeg image from whichever source, but leave in YCbCr format + if (!stbi__decode_jpeg_image(z)) { stbi__cleanup_jpeg(z); return NULL; } + + // determine actual number of components to generate + n = req_comp ? req_comp : z->s->img_n >= 3 ? 3 : 1; + + is_rgb = z->s->img_n == 3 && (z->rgb == 3 || (z->app14_color_transform == 0 && !z->jfif)); + + if (z->s->img_n == 3 && n < 3 && !is_rgb) + decode_n = 1; + else + decode_n = z->s->img_n; + + // nothing to do if no components requested; check this now to avoid + // accessing uninitialized coutput[0] later + if (decode_n <= 0) { stbi__cleanup_jpeg(z); return NULL; } + + // resample and color-convert + { + int k; + unsigned int i,j; + stbi_uc *output; + stbi_uc *coutput[4] = { NULL, NULL, NULL, NULL }; + + stbi__resample res_comp[4]; + + for (k=0; k < decode_n; ++k) { + stbi__resample *r = &res_comp[k]; + + // allocate line buffer big enough for upsampling off the edges + // with upsample factor of 4 + z->img_comp[k].linebuf = (stbi_uc *) stbi__malloc(z->s->img_x + 3); + if (!z->img_comp[k].linebuf) { stbi__cleanup_jpeg(z); return stbi__errpuc("outofmem", "Out of memory"); } + + r->hs = z->img_h_max / z->img_comp[k].h; + r->vs = z->img_v_max / z->img_comp[k].v; + r->ystep = r->vs >> 1; + r->w_lores = (z->s->img_x + r->hs-1) / r->hs; + r->ypos = 0; + r->line0 = r->line1 = z->img_comp[k].data; + + if (r->hs == 1 && r->vs == 1) r->resample = resample_row_1; + else if (r->hs == 1 && r->vs == 2) r->resample = stbi__resample_row_v_2; + else if (r->hs == 2 && r->vs == 1) r->resample = stbi__resample_row_h_2; + else if (r->hs == 2 && r->vs == 2) r->resample = z->resample_row_hv_2_kernel; + else r->resample = stbi__resample_row_generic; + } + + // can't error after this so, this is safe + output = (stbi_uc *) stbi__malloc_mad3(n, z->s->img_x, z->s->img_y, 1); + if (!output) { stbi__cleanup_jpeg(z); return stbi__errpuc("outofmem", "Out of memory"); } + + // now go ahead and resample + for (j=0; j < z->s->img_y; ++j) { + stbi_uc *out = output + n * z->s->img_x * j; + for (k=0; k < decode_n; ++k) { + stbi__resample *r = &res_comp[k]; + int y_bot = r->ystep >= (r->vs >> 1); + coutput[k] = r->resample(z->img_comp[k].linebuf, + y_bot ? r->line1 : r->line0, + y_bot ? r->line0 : r->line1, + r->w_lores, r->hs); + if (++r->ystep >= r->vs) { + r->ystep = 0; + r->line0 = r->line1; + if (++r->ypos < z->img_comp[k].y) + r->line1 += z->img_comp[k].w2; + } + } + if (n >= 3) { + stbi_uc *y = coutput[0]; + if (z->s->img_n == 3) { + if (is_rgb) { + for (i=0; i < z->s->img_x; ++i) { + out[0] = y[i]; + out[1] = coutput[1][i]; + out[2] = coutput[2][i]; + out[3] = 255; + out += n; + } + } else { + z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n); + } + } else if (z->s->img_n == 4) { + if (z->app14_color_transform == 0) { // CMYK + for (i=0; i < z->s->img_x; ++i) { + stbi_uc m = coutput[3][i]; + out[0] = stbi__blinn_8x8(coutput[0][i], m); + out[1] = stbi__blinn_8x8(coutput[1][i], m); + out[2] = stbi__blinn_8x8(coutput[2][i], m); + out[3] = 255; + out += n; + } + } else if (z->app14_color_transform == 2) { // YCCK + z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n); + for (i=0; i < z->s->img_x; ++i) { + stbi_uc m = coutput[3][i]; + out[0] = stbi__blinn_8x8(255 - out[0], m); + out[1] = stbi__blinn_8x8(255 - out[1], m); + out[2] = stbi__blinn_8x8(255 - out[2], m); + out += n; + } + } else { // YCbCr + alpha? Ignore the fourth channel for now + z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n); + } + } else + for (i=0; i < z->s->img_x; ++i) { + out[0] = out[1] = out[2] = y[i]; + out[3] = 255; // not used if n==3 + out += n; + } + } else { + if (is_rgb) { + if (n == 1) + for (i=0; i < z->s->img_x; ++i) + *out++ = stbi__compute_y(coutput[0][i], coutput[1][i], coutput[2][i]); + else { + for (i=0; i < z->s->img_x; ++i, out += 2) { + out[0] = stbi__compute_y(coutput[0][i], coutput[1][i], coutput[2][i]); + out[1] = 255; + } + } + } else if (z->s->img_n == 4 && z->app14_color_transform == 0) { + for (i=0; i < z->s->img_x; ++i) { + stbi_uc m = coutput[3][i]; + stbi_uc r = stbi__blinn_8x8(coutput[0][i], m); + stbi_uc g = stbi__blinn_8x8(coutput[1][i], m); + stbi_uc b = stbi__blinn_8x8(coutput[2][i], m); + out[0] = stbi__compute_y(r, g, b); + out[1] = 255; + out += n; + } + } else if (z->s->img_n == 4 && z->app14_color_transform == 2) { + for (i=0; i < z->s->img_x; ++i) { + out[0] = stbi__blinn_8x8(255 - coutput[0][i], coutput[3][i]); + out[1] = 255; + out += n; + } + } else { + stbi_uc *y = coutput[0]; + if (n == 1) + for (i=0; i < z->s->img_x; ++i) out[i] = y[i]; + else + for (i=0; i < z->s->img_x; ++i) { *out++ = y[i]; *out++ = 255; } + } + } + } + stbi__cleanup_jpeg(z); + *out_x = z->s->img_x; + *out_y = z->s->img_y; + if (comp) *comp = z->s->img_n >= 3 ? 3 : 1; // report original components, not output + return output; + } +} + +static void *stbi__jpeg_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) +{ + unsigned char* result; + stbi__jpeg* j = (stbi__jpeg*) stbi__malloc(sizeof(stbi__jpeg)); + if (!j) return stbi__errpuc("outofmem", "Out of memory"); + memset(j, 0, sizeof(stbi__jpeg)); + STBI_NOTUSED(ri); + j->s = s; + stbi__setup_jpeg(j); + result = load_jpeg_image(j, x,y,comp,req_comp); + STBI_FREE(j); + return result; +} + +static int stbi__jpeg_test(stbi__context *s) +{ + int r; + stbi__jpeg* j = (stbi__jpeg*)stbi__malloc(sizeof(stbi__jpeg)); + if (!j) return stbi__err("outofmem", "Out of memory"); + memset(j, 0, sizeof(stbi__jpeg)); + j->s = s; + stbi__setup_jpeg(j); + r = stbi__decode_jpeg_header(j, STBI__SCAN_type); + stbi__rewind(s); + STBI_FREE(j); + return r; +} + +static int stbi__jpeg_info_raw(stbi__jpeg *j, int *x, int *y, int *comp) +{ + if (!stbi__decode_jpeg_header(j, STBI__SCAN_header)) { + stbi__rewind( j->s ); + return 0; + } + if (x) *x = j->s->img_x; + if (y) *y = j->s->img_y; + if (comp) *comp = j->s->img_n >= 3 ? 3 : 1; + return 1; +} + +static int stbi__jpeg_info(stbi__context *s, int *x, int *y, int *comp) +{ + int result; + stbi__jpeg* j = (stbi__jpeg*) (stbi__malloc(sizeof(stbi__jpeg))); + if (!j) return stbi__err("outofmem", "Out of memory"); + memset(j, 0, sizeof(stbi__jpeg)); + j->s = s; + result = stbi__jpeg_info_raw(j, x, y, comp); + STBI_FREE(j); + return result; +} +#endif + +// public domain zlib decode v0.2 Sean Barrett 2006-11-18 +// simple implementation +// - all input must be provided in an upfront buffer +// - all output is written to a single output buffer (can malloc/realloc) +// performance +// - fast huffman + +#ifndef STBI_NO_ZLIB + +// fast-way is faster to check than jpeg huffman, but slow way is slower +#define STBI__ZFAST_BITS 9 // accelerate all cases in default tables +#define STBI__ZFAST_MASK ((1 << STBI__ZFAST_BITS) - 1) +#define STBI__ZNSYMS 288 // number of symbols in literal/length alphabet + +// zlib-style huffman encoding +// (jpegs packs from left, zlib from right, so can't share code) +typedef struct +{ + stbi__uint16 fast[1 << STBI__ZFAST_BITS]; + stbi__uint16 firstcode[16]; + int maxcode[17]; + stbi__uint16 firstsymbol[16]; + stbi_uc size[STBI__ZNSYMS]; + stbi__uint16 value[STBI__ZNSYMS]; +} stbi__zhuffman; + +stbi_inline static int stbi__bitreverse16(int n) +{ + n = ((n & 0xAAAA) >> 1) | ((n & 0x5555) << 1); + n = ((n & 0xCCCC) >> 2) | ((n & 0x3333) << 2); + n = ((n & 0xF0F0) >> 4) | ((n & 0x0F0F) << 4); + n = ((n & 0xFF00) >> 8) | ((n & 0x00FF) << 8); + return n; +} + +stbi_inline static int stbi__bit_reverse(int v, int bits) +{ + STBI_ASSERT(bits <= 16); + // to bit reverse n bits, reverse 16 and shift + // e.g. 11 bits, bit reverse and shift away 5 + return stbi__bitreverse16(v) >> (16-bits); +} + +static int stbi__zbuild_huffman(stbi__zhuffman *z, const stbi_uc *sizelist, int num) +{ + int i,k=0; + int code, next_code[16], sizes[17]; + + // DEFLATE spec for generating codes + memset(sizes, 0, sizeof(sizes)); + memset(z->fast, 0, sizeof(z->fast)); + for (i=0; i < num; ++i) + ++sizes[sizelist[i]]; + sizes[0] = 0; + for (i=1; i < 16; ++i) + if (sizes[i] > (1 << i)) + return stbi__err("bad sizes", "Corrupt PNG"); + code = 0; + for (i=1; i < 16; ++i) { + next_code[i] = code; + z->firstcode[i] = (stbi__uint16) code; + z->firstsymbol[i] = (stbi__uint16) k; + code = (code + sizes[i]); + if (sizes[i]) + if (code-1 >= (1 << i)) return stbi__err("bad codelengths","Corrupt PNG"); + z->maxcode[i] = code << (16-i); // preshift for inner loop + code <<= 1; + k += sizes[i]; + } + z->maxcode[16] = 0x10000; // sentinel + for (i=0; i < num; ++i) { + int s = sizelist[i]; + if (s) { + int c = next_code[s] - z->firstcode[s] + z->firstsymbol[s]; + stbi__uint16 fastv = (stbi__uint16) ((s << 9) | i); + z->size [c] = (stbi_uc ) s; + z->value[c] = (stbi__uint16) i; + if (s <= STBI__ZFAST_BITS) { + int j = stbi__bit_reverse(next_code[s],s); + while (j < (1 << STBI__ZFAST_BITS)) { + z->fast[j] = fastv; + j += (1 << s); + } + } + ++next_code[s]; + } + } + return 1; +} + +// zlib-from-memory implementation for PNG reading +// because PNG allows splitting the zlib stream arbitrarily, +// and it's annoying structurally to have PNG call ZLIB call PNG, +// we require PNG read all the IDATs and combine them into a single +// memory buffer + +typedef struct +{ + stbi_uc *zbuffer, *zbuffer_end; + int num_bits; + int hit_zeof_once; + stbi__uint32 code_buffer; + + char *zout; + char *zout_start; + char *zout_end; + int z_expandable; + + stbi__zhuffman z_length, z_distance; +} stbi__zbuf; + +stbi_inline static int stbi__zeof(stbi__zbuf *z) +{ + return (z->zbuffer >= z->zbuffer_end); +} + +stbi_inline static stbi_uc stbi__zget8(stbi__zbuf *z) +{ + return stbi__zeof(z) ? 0 : *z->zbuffer++; +} + +static void stbi__fill_bits(stbi__zbuf *z) +{ + do { + if (z->code_buffer >= (1U << z->num_bits)) { + z->zbuffer = z->zbuffer_end; /* treat this as EOF so we fail. */ + return; + } + z->code_buffer |= (unsigned int) stbi__zget8(z) << z->num_bits; + z->num_bits += 8; + } while (z->num_bits <= 24); +} + +stbi_inline static unsigned int stbi__zreceive(stbi__zbuf *z, int n) +{ + unsigned int k; + if (z->num_bits < n) stbi__fill_bits(z); + k = z->code_buffer & ((1 << n) - 1); + z->code_buffer >>= n; + z->num_bits -= n; + return k; +} + +static int stbi__zhuffman_decode_slowpath(stbi__zbuf *a, stbi__zhuffman *z) +{ + int b,s,k; + // not resolved by fast table, so compute it the slow way + // use jpeg approach, which requires MSbits at top + k = stbi__bit_reverse(a->code_buffer, 16); + for (s=STBI__ZFAST_BITS+1; ; ++s) + if (k < z->maxcode[s]) + break; + if (s >= 16) return -1; // invalid code! + // code size is s, so: + b = (k >> (16-s)) - z->firstcode[s] + z->firstsymbol[s]; + if (b >= STBI__ZNSYMS) return -1; // some data was corrupt somewhere! + if (z->size[b] != s) return -1; // was originally an assert, but report failure instead. + a->code_buffer >>= s; + a->num_bits -= s; + return z->value[b]; +} + +stbi_inline static int stbi__zhuffman_decode(stbi__zbuf *a, stbi__zhuffman *z) +{ + int b,s; + if (a->num_bits < 16) { + if (stbi__zeof(a)) { + if (!a->hit_zeof_once) { + // This is the first time we hit eof, insert 16 extra padding btis + // to allow us to keep going; if we actually consume any of them + // though, that is invalid data. This is caught later. + a->hit_zeof_once = 1; + a->num_bits += 16; // add 16 implicit zero bits + } else { + // We already inserted our extra 16 padding bits and are again + // out, this stream is actually prematurely terminated. + return -1; + } + } else { + stbi__fill_bits(a); + } + } + b = z->fast[a->code_buffer & STBI__ZFAST_MASK]; + if (b) { + s = b >> 9; + a->code_buffer >>= s; + a->num_bits -= s; + return b & 511; + } + return stbi__zhuffman_decode_slowpath(a, z); +} + +static int stbi__zexpand(stbi__zbuf *z, char *zout, int n) // need to make room for n bytes +{ + char *q; + unsigned int cur, limit, old_limit; + z->zout = zout; + if (!z->z_expandable) return stbi__err("output buffer limit","Corrupt PNG"); + cur = (unsigned int) (z->zout - z->zout_start); + limit = old_limit = (unsigned) (z->zout_end - z->zout_start); + if (UINT_MAX - cur < (unsigned) n) return stbi__err("outofmem", "Out of memory"); + while (cur + n > limit) { + if(limit > UINT_MAX / 2) return stbi__err("outofmem", "Out of memory"); + limit *= 2; + } + q = (char *) STBI_REALLOC_SIZED(z->zout_start, old_limit, limit); + STBI_NOTUSED(old_limit); + if (q == NULL) return stbi__err("outofmem", "Out of memory"); + z->zout_start = q; + z->zout = q + cur; + z->zout_end = q + limit; + return 1; +} + +static const int stbi__zlength_base[31] = { + 3,4,5,6,7,8,9,10,11,13, + 15,17,19,23,27,31,35,43,51,59, + 67,83,99,115,131,163,195,227,258,0,0 }; + +static const int stbi__zlength_extra[31]= +{ 0,0,0,0,0,0,0,0,1,1,1,1,2,2,2,2,3,3,3,3,4,4,4,4,5,5,5,5,0,0,0 }; + +static const int stbi__zdist_base[32] = { 1,2,3,4,5,7,9,13,17,25,33,49,65,97,129,193, +257,385,513,769,1025,1537,2049,3073,4097,6145,8193,12289,16385,24577,0,0}; + +static const int stbi__zdist_extra[32] = +{ 0,0,0,0,1,1,2,2,3,3,4,4,5,5,6,6,7,7,8,8,9,9,10,10,11,11,12,12,13,13}; + +static int stbi__parse_huffman_block(stbi__zbuf *a) +{ + char *zout = a->zout; + for(;;) { + int z = stbi__zhuffman_decode(a, &a->z_length); + if (z < 256) { + if (z < 0) return stbi__err("bad huffman code","Corrupt PNG"); // error in huffman codes + if (zout >= a->zout_end) { + if (!stbi__zexpand(a, zout, 1)) return 0; + zout = a->zout; + } + *zout++ = (char) z; + } else { + stbi_uc *p; + int len,dist; + if (z == 256) { + a->zout = zout; + if (a->hit_zeof_once && a->num_bits < 16) { + // The first time we hit zeof, we inserted 16 extra zero bits into our bit + // buffer so the decoder can just do its speculative decoding. But if we + // actually consumed any of those bits (which is the case when num_bits < 16), + // the stream actually read past the end so it is malformed. + return stbi__err("unexpected end","Corrupt PNG"); + } + return 1; + } + if (z >= 286) return stbi__err("bad huffman code","Corrupt PNG"); // per DEFLATE, length codes 286 and 287 must not appear in compressed data + z -= 257; + len = stbi__zlength_base[z]; + if (stbi__zlength_extra[z]) len += stbi__zreceive(a, stbi__zlength_extra[z]); + z = stbi__zhuffman_decode(a, &a->z_distance); + if (z < 0 || z >= 30) return stbi__err("bad huffman code","Corrupt PNG"); // per DEFLATE, distance codes 30 and 31 must not appear in compressed data + dist = stbi__zdist_base[z]; + if (stbi__zdist_extra[z]) dist += stbi__zreceive(a, stbi__zdist_extra[z]); + if (zout - a->zout_start < dist) return stbi__err("bad dist","Corrupt PNG"); + if (len > a->zout_end - zout) { + if (!stbi__zexpand(a, zout, len)) return 0; + zout = a->zout; + } + p = (stbi_uc *) (zout - dist); + if (dist == 1) { // run of one byte; common in images. + stbi_uc v = *p; + if (len) { do *zout++ = v; while (--len); } + } else { + if (len) { do *zout++ = *p++; while (--len); } + } + } + } +} + +static int stbi__compute_huffman_codes(stbi__zbuf *a) +{ + static const stbi_uc length_dezigzag[19] = { 16,17,18,0,8,7,9,6,10,5,11,4,12,3,13,2,14,1,15 }; + stbi__zhuffman z_codelength; + stbi_uc lencodes[286+32+137];//padding for maximum single op + stbi_uc codelength_sizes[19]; + int i,n; + + int hlit = stbi__zreceive(a,5) + 257; + int hdist = stbi__zreceive(a,5) + 1; + int hclen = stbi__zreceive(a,4) + 4; + int ntot = hlit + hdist; + + memset(codelength_sizes, 0, sizeof(codelength_sizes)); + for (i=0; i < hclen; ++i) { + int s = stbi__zreceive(a,3); + codelength_sizes[length_dezigzag[i]] = (stbi_uc) s; + } + if (!stbi__zbuild_huffman(&z_codelength, codelength_sizes, 19)) return 0; + + n = 0; + while (n < ntot) { + int c = stbi__zhuffman_decode(a, &z_codelength); + if (c < 0 || c >= 19) return stbi__err("bad codelengths", "Corrupt PNG"); + if (c < 16) + lencodes[n++] = (stbi_uc) c; + else { + stbi_uc fill = 0; + if (c == 16) { + c = stbi__zreceive(a,2)+3; + if (n == 0) return stbi__err("bad codelengths", "Corrupt PNG"); + fill = lencodes[n-1]; + } else if (c == 17) { + c = stbi__zreceive(a,3)+3; + } else if (c == 18) { + c = stbi__zreceive(a,7)+11; + } else { + return stbi__err("bad codelengths", "Corrupt PNG"); + } + if (ntot - n < c) return stbi__err("bad codelengths", "Corrupt PNG"); + memset(lencodes+n, fill, c); + n += c; + } + } + if (n != ntot) return stbi__err("bad codelengths","Corrupt PNG"); + if (!stbi__zbuild_huffman(&a->z_length, lencodes, hlit)) return 0; + if (!stbi__zbuild_huffman(&a->z_distance, lencodes+hlit, hdist)) return 0; + return 1; +} + +static int stbi__parse_uncompressed_block(stbi__zbuf *a) +{ + stbi_uc header[4]; + int len,nlen,k; + if (a->num_bits & 7) + stbi__zreceive(a, a->num_bits & 7); // discard + // drain the bit-packed data into header + k = 0; + while (a->num_bits > 0) { + header[k++] = (stbi_uc) (a->code_buffer & 255); // suppress MSVC run-time check + a->code_buffer >>= 8; + a->num_bits -= 8; + } + if (a->num_bits < 0) return stbi__err("zlib corrupt","Corrupt PNG"); + // now fill header the normal way + while (k < 4) + header[k++] = stbi__zget8(a); + len = header[1] * 256 + header[0]; + nlen = header[3] * 256 + header[2]; + if (nlen != (len ^ 0xffff)) return stbi__err("zlib corrupt","Corrupt PNG"); + if (a->zbuffer + len > a->zbuffer_end) return stbi__err("read past buffer","Corrupt PNG"); + if (a->zout + len > a->zout_end) + if (!stbi__zexpand(a, a->zout, len)) return 0; + memcpy(a->zout, a->zbuffer, len); + a->zbuffer += len; + a->zout += len; + return 1; +} + +static int stbi__parse_zlib_header(stbi__zbuf *a) +{ + int cmf = stbi__zget8(a); + int cm = cmf & 15; + /* int cinfo = cmf >> 4; */ + int flg = stbi__zget8(a); + if (stbi__zeof(a)) return stbi__err("bad zlib header","Corrupt PNG"); // zlib spec + if ((cmf*256+flg) % 31 != 0) return stbi__err("bad zlib header","Corrupt PNG"); // zlib spec + if (flg & 32) return stbi__err("no preset dict","Corrupt PNG"); // preset dictionary not allowed in png + if (cm != 8) return stbi__err("bad compression","Corrupt PNG"); // DEFLATE required for png + // window = 1 << (8 + cinfo)... but who cares, we fully buffer output + return 1; +} + +static const stbi_uc stbi__zdefault_length[STBI__ZNSYMS] = +{ + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, + 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, + 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, + 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, + 7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7, 7,7,7,7,7,7,7,7,8,8,8,8,8,8,8,8 +}; +static const stbi_uc stbi__zdefault_distance[32] = +{ + 5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5 +}; +/* +Init algorithm: +{ + int i; // use <= to match clearly with spec + for (i=0; i <= 143; ++i) stbi__zdefault_length[i] = 8; + for ( ; i <= 255; ++i) stbi__zdefault_length[i] = 9; + for ( ; i <= 279; ++i) stbi__zdefault_length[i] = 7; + for ( ; i <= 287; ++i) stbi__zdefault_length[i] = 8; + + for (i=0; i <= 31; ++i) stbi__zdefault_distance[i] = 5; +} +*/ + +static int stbi__parse_zlib(stbi__zbuf *a, int parse_header) +{ + int final, type; + if (parse_header) + if (!stbi__parse_zlib_header(a)) return 0; + a->num_bits = 0; + a->code_buffer = 0; + a->hit_zeof_once = 0; + do { + final = stbi__zreceive(a,1); + type = stbi__zreceive(a,2); + if (type == 0) { + if (!stbi__parse_uncompressed_block(a)) return 0; + } else if (type == 3) { + return 0; + } else { + if (type == 1) { + // use fixed code lengths + if (!stbi__zbuild_huffman(&a->z_length , stbi__zdefault_length , STBI__ZNSYMS)) return 0; + if (!stbi__zbuild_huffman(&a->z_distance, stbi__zdefault_distance, 32)) return 0; + } else { + if (!stbi__compute_huffman_codes(a)) return 0; + } + if (!stbi__parse_huffman_block(a)) return 0; + } + } while (!final); + return 1; +} + +static int stbi__do_zlib(stbi__zbuf *a, char *obuf, int olen, int exp, int parse_header) +{ + a->zout_start = obuf; + a->zout = obuf; + a->zout_end = obuf + olen; + a->z_expandable = exp; + + return stbi__parse_zlib(a, parse_header); +} + +STBIDEF char *stbi_zlib_decode_malloc_guesssize(const char *buffer, int len, int initial_size, int *outlen) +{ + stbi__zbuf a; + char *p = (char *) stbi__malloc(initial_size); + if (p == NULL) return NULL; + a.zbuffer = (stbi_uc *) buffer; + a.zbuffer_end = (stbi_uc *) buffer + len; + if (stbi__do_zlib(&a, p, initial_size, 1, 1)) { + if (outlen) *outlen = (int) (a.zout - a.zout_start); + return a.zout_start; + } else { + STBI_FREE(a.zout_start); + return NULL; + } +} + +STBIDEF char *stbi_zlib_decode_malloc(char const *buffer, int len, int *outlen) +{ + return stbi_zlib_decode_malloc_guesssize(buffer, len, 16384, outlen); +} + +STBIDEF char *stbi_zlib_decode_malloc_guesssize_headerflag(const char *buffer, int len, int initial_size, int *outlen, int parse_header) +{ + stbi__zbuf a; + char *p = (char *) stbi__malloc(initial_size); + if (p == NULL) return NULL; + a.zbuffer = (stbi_uc *) buffer; + a.zbuffer_end = (stbi_uc *) buffer + len; + if (stbi__do_zlib(&a, p, initial_size, 1, parse_header)) { + if (outlen) *outlen = (int) (a.zout - a.zout_start); + return a.zout_start; + } else { + STBI_FREE(a.zout_start); + return NULL; + } +} + +STBIDEF int stbi_zlib_decode_buffer(char *obuffer, int olen, char const *ibuffer, int ilen) +{ + stbi__zbuf a; + a.zbuffer = (stbi_uc *) ibuffer; + a.zbuffer_end = (stbi_uc *) ibuffer + ilen; + if (stbi__do_zlib(&a, obuffer, olen, 0, 1)) + return (int) (a.zout - a.zout_start); + else + return -1; +} + +STBIDEF char *stbi_zlib_decode_noheader_malloc(char const *buffer, int len, int *outlen) +{ + stbi__zbuf a; + char *p = (char *) stbi__malloc(16384); + if (p == NULL) return NULL; + a.zbuffer = (stbi_uc *) buffer; + a.zbuffer_end = (stbi_uc *) buffer+len; + if (stbi__do_zlib(&a, p, 16384, 1, 0)) { + if (outlen) *outlen = (int) (a.zout - a.zout_start); + return a.zout_start; + } else { + STBI_FREE(a.zout_start); + return NULL; + } +} + +STBIDEF int stbi_zlib_decode_noheader_buffer(char *obuffer, int olen, const char *ibuffer, int ilen) +{ + stbi__zbuf a; + a.zbuffer = (stbi_uc *) ibuffer; + a.zbuffer_end = (stbi_uc *) ibuffer + ilen; + if (stbi__do_zlib(&a, obuffer, olen, 0, 0)) + return (int) (a.zout - a.zout_start); + else + return -1; +} +#endif + +// public domain "baseline" PNG decoder v0.10 Sean Barrett 2006-11-18 +// simple implementation +// - only 8-bit samples +// - no CRC checking +// - allocates lots of intermediate memory +// - avoids problem of streaming data between subsystems +// - avoids explicit window management +// performance +// - uses stb_zlib, a PD zlib implementation with fast huffman decoding + +#ifndef STBI_NO_PNG +typedef struct +{ + stbi__uint32 length; + stbi__uint32 type; +} stbi__pngchunk; + +static stbi__pngchunk stbi__get_chunk_header(stbi__context *s) +{ + stbi__pngchunk c; + c.length = stbi__get32be(s); + c.type = stbi__get32be(s); + return c; +} + +static int stbi__check_png_header(stbi__context *s) +{ + static const stbi_uc png_sig[8] = { 137,80,78,71,13,10,26,10 }; + int i; + for (i=0; i < 8; ++i) + if (stbi__get8(s) != png_sig[i]) return stbi__err("bad png sig","Not a PNG"); + return 1; +} + +typedef struct +{ + stbi__context *s; + stbi_uc *idata, *expanded, *out; + int depth; +} stbi__png; + + +enum { + STBI__F_none=0, + STBI__F_sub=1, + STBI__F_up=2, + STBI__F_avg=3, + STBI__F_paeth=4, + // synthetic filter used for first scanline to avoid needing a dummy row of 0s + STBI__F_avg_first +}; + +static stbi_uc first_row_filter[5] = +{ + STBI__F_none, + STBI__F_sub, + STBI__F_none, + STBI__F_avg_first, + STBI__F_sub // Paeth with b=c=0 turns out to be equivalent to sub +}; + +static int stbi__paeth(int a, int b, int c) +{ + // This formulation looks very different from the reference in the PNG spec, but is + // actually equivalent and has favorable data dependencies and admits straightforward + // generation of branch-free code, which helps performance significantly. + int thresh = c*3 - (a + b); + int lo = a < b ? a : b; + int hi = a < b ? b : a; + int t0 = (hi <= thresh) ? lo : c; + int t1 = (thresh <= lo) ? hi : t0; + return t1; +} + +static const stbi_uc stbi__depth_scale_table[9] = { 0, 0xff, 0x55, 0, 0x11, 0,0,0, 0x01 }; + +// adds an extra all-255 alpha channel +// dest == src is legal +// img_n must be 1 or 3 +static void stbi__create_png_alpha_expand8(stbi_uc *dest, stbi_uc *src, stbi__uint32 x, int img_n) +{ + int i; + // must process data backwards since we allow dest==src + if (img_n == 1) { + for (i=x-1; i >= 0; --i) { + dest[i*2+1] = 255; + dest[i*2+0] = src[i]; + } + } else { + STBI_ASSERT(img_n == 3); + for (i=x-1; i >= 0; --i) { + dest[i*4+3] = 255; + dest[i*4+2] = src[i*3+2]; + dest[i*4+1] = src[i*3+1]; + dest[i*4+0] = src[i*3+0]; + } + } +} + +// create the png data from post-deflated data +static int stbi__create_png_image_raw(stbi__png *a, stbi_uc *raw, stbi__uint32 raw_len, int out_n, stbi__uint32 x, stbi__uint32 y, int depth, int color) +{ + int bytes = (depth == 16 ? 2 : 1); + stbi__context *s = a->s; + stbi__uint32 i,j,stride = x*out_n*bytes; + stbi__uint32 img_len, img_width_bytes; + stbi_uc *filter_buf; + int all_ok = 1; + int k; + int img_n = s->img_n; // copy it into a local for later + + int output_bytes = out_n*bytes; + int filter_bytes = img_n*bytes; + int width = x; + + STBI_ASSERT(out_n == s->img_n || out_n == s->img_n+1); + a->out = (stbi_uc *) stbi__malloc_mad3(x, y, output_bytes, 0); // extra bytes to write off the end into + if (!a->out) return stbi__err("outofmem", "Out of memory"); + + // note: error exits here don't need to clean up a->out individually, + // stbi__do_png always does on error. + if (!stbi__mad3sizes_valid(img_n, x, depth, 7)) return stbi__err("too large", "Corrupt PNG"); + img_width_bytes = (((img_n * x * depth) + 7) >> 3); + if (!stbi__mad2sizes_valid(img_width_bytes, y, img_width_bytes)) return stbi__err("too large", "Corrupt PNG"); + img_len = (img_width_bytes + 1) * y; + + // we used to check for exact match between raw_len and img_len on non-interlaced PNGs, + // but issue #276 reported a PNG in the wild that had extra data at the end (all zeros), + // so just check for raw_len < img_len always. + if (raw_len < img_len) return stbi__err("not enough pixels","Corrupt PNG"); + + // Allocate two scan lines worth of filter workspace buffer. + filter_buf = (stbi_uc *) stbi__malloc_mad2(img_width_bytes, 2, 0); + if (!filter_buf) return stbi__err("outofmem", "Out of memory"); + + // Filtering for low-bit-depth images + if (depth < 8) { + filter_bytes = 1; + width = img_width_bytes; + } + + for (j=0; j < y; ++j) { + // cur/prior filter buffers alternate + stbi_uc *cur = filter_buf + (j & 1)*img_width_bytes; + stbi_uc *prior = filter_buf + (~j & 1)*img_width_bytes; + stbi_uc *dest = a->out + stride*j; + int nk = width * filter_bytes; + int filter = *raw++; + + // check filter type + if (filter > 4) { + all_ok = stbi__err("invalid filter","Corrupt PNG"); + break; + } + + // if first row, use special filter that doesn't sample previous row + if (j == 0) filter = first_row_filter[filter]; + + // perform actual filtering + switch (filter) { + case STBI__F_none: + memcpy(cur, raw, nk); + break; + case STBI__F_sub: + memcpy(cur, raw, filter_bytes); + for (k = filter_bytes; k < nk; ++k) + cur[k] = STBI__BYTECAST(raw[k] + cur[k-filter_bytes]); + break; + case STBI__F_up: + for (k = 0; k < nk; ++k) + cur[k] = STBI__BYTECAST(raw[k] + prior[k]); + break; + case STBI__F_avg: + for (k = 0; k < filter_bytes; ++k) + cur[k] = STBI__BYTECAST(raw[k] + (prior[k]>>1)); + for (k = filter_bytes; k < nk; ++k) + cur[k] = STBI__BYTECAST(raw[k] + ((prior[k] + cur[k-filter_bytes])>>1)); + break; + case STBI__F_paeth: + for (k = 0; k < filter_bytes; ++k) + cur[k] = STBI__BYTECAST(raw[k] + prior[k]); // prior[k] == stbi__paeth(0,prior[k],0) + for (k = filter_bytes; k < nk; ++k) + cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k-filter_bytes], prior[k], prior[k-filter_bytes])); + break; + case STBI__F_avg_first: + memcpy(cur, raw, filter_bytes); + for (k = filter_bytes; k < nk; ++k) + cur[k] = STBI__BYTECAST(raw[k] + (cur[k-filter_bytes] >> 1)); + break; + } + + raw += nk; + + // expand decoded bits in cur to dest, also adding an extra alpha channel if desired + if (depth < 8) { + stbi_uc scale = (color == 0) ? stbi__depth_scale_table[depth] : 1; // scale grayscale values to 0..255 range + stbi_uc *in = cur; + stbi_uc *out = dest; + stbi_uc inb = 0; + stbi__uint32 nsmp = x*img_n; + + // expand bits to bytes first + if (depth == 4) { + for (i=0; i < nsmp; ++i) { + if ((i & 1) == 0) inb = *in++; + *out++ = scale * (inb >> 4); + inb <<= 4; + } + } else if (depth == 2) { + for (i=0; i < nsmp; ++i) { + if ((i & 3) == 0) inb = *in++; + *out++ = scale * (inb >> 6); + inb <<= 2; + } + } else { + STBI_ASSERT(depth == 1); + for (i=0; i < nsmp; ++i) { + if ((i & 7) == 0) inb = *in++; + *out++ = scale * (inb >> 7); + inb <<= 1; + } + } + + // insert alpha=255 values if desired + if (img_n != out_n) + stbi__create_png_alpha_expand8(dest, dest, x, img_n); + } else if (depth == 8) { + if (img_n == out_n) + memcpy(dest, cur, x*img_n); + else + stbi__create_png_alpha_expand8(dest, cur, x, img_n); + } else if (depth == 16) { + // convert the image data from big-endian to platform-native + stbi__uint16 *dest16 = (stbi__uint16*)dest; + stbi__uint32 nsmp = x*img_n; + + if (img_n == out_n) { + for (i = 0; i < nsmp; ++i, ++dest16, cur += 2) + *dest16 = (cur[0] << 8) | cur[1]; + } else { + STBI_ASSERT(img_n+1 == out_n); + if (img_n == 1) { + for (i = 0; i < x; ++i, dest16 += 2, cur += 2) { + dest16[0] = (cur[0] << 8) | cur[1]; + dest16[1] = 0xffff; + } + } else { + STBI_ASSERT(img_n == 3); + for (i = 0; i < x; ++i, dest16 += 4, cur += 6) { + dest16[0] = (cur[0] << 8) | cur[1]; + dest16[1] = (cur[2] << 8) | cur[3]; + dest16[2] = (cur[4] << 8) | cur[5]; + dest16[3] = 0xffff; + } + } + } + } + } + + STBI_FREE(filter_buf); + if (!all_ok) return 0; + + return 1; +} + +static int stbi__create_png_image(stbi__png *a, stbi_uc *image_data, stbi__uint32 image_data_len, int out_n, int depth, int color, int interlaced) +{ + int bytes = (depth == 16 ? 2 : 1); + int out_bytes = out_n * bytes; + stbi_uc *final; + int p; + if (!interlaced) + return stbi__create_png_image_raw(a, image_data, image_data_len, out_n, a->s->img_x, a->s->img_y, depth, color); + + // de-interlacing + final = (stbi_uc *) stbi__malloc_mad3(a->s->img_x, a->s->img_y, out_bytes, 0); + if (!final) return stbi__err("outofmem", "Out of memory"); + for (p=0; p < 7; ++p) { + int xorig[] = { 0,4,0,2,0,1,0 }; + int yorig[] = { 0,0,4,0,2,0,1 }; + int xspc[] = { 8,8,4,4,2,2,1 }; + int yspc[] = { 8,8,8,4,4,2,2 }; + int i,j,x,y; + // pass1_x[4] = 0, pass1_x[5] = 1, pass1_x[12] = 1 + x = (a->s->img_x - xorig[p] + xspc[p]-1) / xspc[p]; + y = (a->s->img_y - yorig[p] + yspc[p]-1) / yspc[p]; + if (x && y) { + stbi__uint32 img_len = ((((a->s->img_n * x * depth) + 7) >> 3) + 1) * y; + if (!stbi__create_png_image_raw(a, image_data, image_data_len, out_n, x, y, depth, color)) { + STBI_FREE(final); + return 0; + } + for (j=0; j < y; ++j) { + for (i=0; i < x; ++i) { + int out_y = j*yspc[p]+yorig[p]; + int out_x = i*xspc[p]+xorig[p]; + memcpy(final + out_y*a->s->img_x*out_bytes + out_x*out_bytes, + a->out + (j*x+i)*out_bytes, out_bytes); + } + } + STBI_FREE(a->out); + image_data += img_len; + image_data_len -= img_len; + } + } + a->out = final; + + return 1; +} + +static int stbi__compute_transparency(stbi__png *z, stbi_uc tc[3], int out_n) +{ + stbi__context *s = z->s; + stbi__uint32 i, pixel_count = s->img_x * s->img_y; + stbi_uc *p = z->out; + + // compute color-based transparency, assuming we've + // already got 255 as the alpha value in the output + STBI_ASSERT(out_n == 2 || out_n == 4); + + if (out_n == 2) { + for (i=0; i < pixel_count; ++i) { + p[1] = (p[0] == tc[0] ? 0 : 255); + p += 2; + } + } else { + for (i=0; i < pixel_count; ++i) { + if (p[0] == tc[0] && p[1] == tc[1] && p[2] == tc[2]) + p[3] = 0; + p += 4; + } + } + return 1; +} + +static int stbi__compute_transparency16(stbi__png *z, stbi__uint16 tc[3], int out_n) +{ + stbi__context *s = z->s; + stbi__uint32 i, pixel_count = s->img_x * s->img_y; + stbi__uint16 *p = (stbi__uint16*) z->out; + + // compute color-based transparency, assuming we've + // already got 65535 as the alpha value in the output + STBI_ASSERT(out_n == 2 || out_n == 4); + + if (out_n == 2) { + for (i = 0; i < pixel_count; ++i) { + p[1] = (p[0] == tc[0] ? 0 : 65535); + p += 2; + } + } else { + for (i = 0; i < pixel_count; ++i) { + if (p[0] == tc[0] && p[1] == tc[1] && p[2] == tc[2]) + p[3] = 0; + p += 4; + } + } + return 1; +} + +static int stbi__expand_png_palette(stbi__png *a, stbi_uc *palette, int len, int pal_img_n) +{ + stbi__uint32 i, pixel_count = a->s->img_x * a->s->img_y; + stbi_uc *p, *temp_out, *orig = a->out; + + p = (stbi_uc *) stbi__malloc_mad2(pixel_count, pal_img_n, 0); + if (p == NULL) return stbi__err("outofmem", "Out of memory"); + + // between here and free(out) below, exitting would leak + temp_out = p; + + if (pal_img_n == 3) { + for (i=0; i < pixel_count; ++i) { + int n = orig[i]*4; + p[0] = palette[n ]; + p[1] = palette[n+1]; + p[2] = palette[n+2]; + p += 3; + } + } else { + for (i=0; i < pixel_count; ++i) { + int n = orig[i]*4; + p[0] = palette[n ]; + p[1] = palette[n+1]; + p[2] = palette[n+2]; + p[3] = palette[n+3]; + p += 4; + } + } + STBI_FREE(a->out); + a->out = temp_out; + + STBI_NOTUSED(len); + + return 1; +} + +static int stbi__unpremultiply_on_load_global = 0; +static int stbi__de_iphone_flag_global = 0; + +STBIDEF void stbi_set_unpremultiply_on_load(int flag_true_if_should_unpremultiply) +{ + stbi__unpremultiply_on_load_global = flag_true_if_should_unpremultiply; +} + +STBIDEF void stbi_convert_iphone_png_to_rgb(int flag_true_if_should_convert) +{ + stbi__de_iphone_flag_global = flag_true_if_should_convert; +} + +#ifndef STBI_THREAD_LOCAL +#define stbi__unpremultiply_on_load stbi__unpremultiply_on_load_global +#define stbi__de_iphone_flag stbi__de_iphone_flag_global +#else +static STBI_THREAD_LOCAL int stbi__unpremultiply_on_load_local, stbi__unpremultiply_on_load_set; +static STBI_THREAD_LOCAL int stbi__de_iphone_flag_local, stbi__de_iphone_flag_set; + +STBIDEF void stbi_set_unpremultiply_on_load_thread(int flag_true_if_should_unpremultiply) +{ + stbi__unpremultiply_on_load_local = flag_true_if_should_unpremultiply; + stbi__unpremultiply_on_load_set = 1; +} + +STBIDEF void stbi_convert_iphone_png_to_rgb_thread(int flag_true_if_should_convert) +{ + stbi__de_iphone_flag_local = flag_true_if_should_convert; + stbi__de_iphone_flag_set = 1; +} + +#define stbi__unpremultiply_on_load (stbi__unpremultiply_on_load_set \ + ? stbi__unpremultiply_on_load_local \ + : stbi__unpremultiply_on_load_global) +#define stbi__de_iphone_flag (stbi__de_iphone_flag_set \ + ? stbi__de_iphone_flag_local \ + : stbi__de_iphone_flag_global) +#endif // STBI_THREAD_LOCAL + +static void stbi__de_iphone(stbi__png *z) +{ + stbi__context *s = z->s; + stbi__uint32 i, pixel_count = s->img_x * s->img_y; + stbi_uc *p = z->out; + + if (s->img_out_n == 3) { // convert bgr to rgb + for (i=0; i < pixel_count; ++i) { + stbi_uc t = p[0]; + p[0] = p[2]; + p[2] = t; + p += 3; + } + } else { + STBI_ASSERT(s->img_out_n == 4); + if (stbi__unpremultiply_on_load) { + // convert bgr to rgb and unpremultiply + for (i=0; i < pixel_count; ++i) { + stbi_uc a = p[3]; + stbi_uc t = p[0]; + if (a) { + stbi_uc half = a / 2; + p[0] = (p[2] * 255 + half) / a; + p[1] = (p[1] * 255 + half) / a; + p[2] = ( t * 255 + half) / a; + } else { + p[0] = p[2]; + p[2] = t; + } + p += 4; + } + } else { + // convert bgr to rgb + for (i=0; i < pixel_count; ++i) { + stbi_uc t = p[0]; + p[0] = p[2]; + p[2] = t; + p += 4; + } + } + } +} + +#define STBI__PNG_TYPE(a,b,c,d) (((unsigned) (a) << 24) + ((unsigned) (b) << 16) + ((unsigned) (c) << 8) + (unsigned) (d)) + +static int stbi__parse_png_file(stbi__png *z, int scan, int req_comp) +{ + stbi_uc palette[1024], pal_img_n=0; + stbi_uc has_trans=0, tc[3]={0}; + stbi__uint16 tc16[3]; + stbi__uint32 ioff=0, idata_limit=0, i, pal_len=0; + int first=1,k,interlace=0, color=0, is_iphone=0; + stbi__context *s = z->s; + + z->expanded = NULL; + z->idata = NULL; + z->out = NULL; + + if (!stbi__check_png_header(s)) return 0; + + if (scan == STBI__SCAN_type) return 1; + + for (;;) { + stbi__pngchunk c = stbi__get_chunk_header(s); + switch (c.type) { + case STBI__PNG_TYPE('C','g','B','I'): + is_iphone = 1; + stbi__skip(s, c.length); + break; + case STBI__PNG_TYPE('I','H','D','R'): { + int comp,filter; + if (!first) return stbi__err("multiple IHDR","Corrupt PNG"); + first = 0; + if (c.length != 13) return stbi__err("bad IHDR len","Corrupt PNG"); + s->img_x = stbi__get32be(s); + s->img_y = stbi__get32be(s); + if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + z->depth = stbi__get8(s); if (z->depth != 1 && z->depth != 2 && z->depth != 4 && z->depth != 8 && z->depth != 16) return stbi__err("1/2/4/8/16-bit only","PNG not supported: 1/2/4/8/16-bit only"); + color = stbi__get8(s); if (color > 6) return stbi__err("bad ctype","Corrupt PNG"); + if (color == 3 && z->depth == 16) return stbi__err("bad ctype","Corrupt PNG"); + if (color == 3) pal_img_n = 3; else if (color & 1) return stbi__err("bad ctype","Corrupt PNG"); + comp = stbi__get8(s); if (comp) return stbi__err("bad comp method","Corrupt PNG"); + filter= stbi__get8(s); if (filter) return stbi__err("bad filter method","Corrupt PNG"); + interlace = stbi__get8(s); if (interlace>1) return stbi__err("bad interlace method","Corrupt PNG"); + if (!s->img_x || !s->img_y) return stbi__err("0-pixel image","Corrupt PNG"); + if (!pal_img_n) { + s->img_n = (color & 2 ? 3 : 1) + (color & 4 ? 1 : 0); + if ((1 << 30) / s->img_x / s->img_n < s->img_y) return stbi__err("too large", "Image too large to decode"); + } else { + // if paletted, then pal_n is our final components, and + // img_n is # components to decompress/filter. + s->img_n = 1; + if ((1 << 30) / s->img_x / 4 < s->img_y) return stbi__err("too large","Corrupt PNG"); + } + // even with SCAN_header, have to scan to see if we have a tRNS + break; + } + + case STBI__PNG_TYPE('P','L','T','E'): { + if (first) return stbi__err("first not IHDR", "Corrupt PNG"); + if (c.length > 256*3) return stbi__err("invalid PLTE","Corrupt PNG"); + pal_len = c.length / 3; + if (pal_len * 3 != c.length) return stbi__err("invalid PLTE","Corrupt PNG"); + for (i=0; i < pal_len; ++i) { + palette[i*4+0] = stbi__get8(s); + palette[i*4+1] = stbi__get8(s); + palette[i*4+2] = stbi__get8(s); + palette[i*4+3] = 255; + } + break; + } + + case STBI__PNG_TYPE('t','R','N','S'): { + if (first) return stbi__err("first not IHDR", "Corrupt PNG"); + if (z->idata) return stbi__err("tRNS after IDAT","Corrupt PNG"); + if (pal_img_n) { + if (scan == STBI__SCAN_header) { s->img_n = 4; return 1; } + if (pal_len == 0) return stbi__err("tRNS before PLTE","Corrupt PNG"); + if (c.length > pal_len) return stbi__err("bad tRNS len","Corrupt PNG"); + pal_img_n = 4; + for (i=0; i < c.length; ++i) + palette[i*4+3] = stbi__get8(s); + } else { + if (!(s->img_n & 1)) return stbi__err("tRNS with alpha","Corrupt PNG"); + if (c.length != (stbi__uint32) s->img_n*2) return stbi__err("bad tRNS len","Corrupt PNG"); + has_trans = 1; + // non-paletted with tRNS = constant alpha. if header-scanning, we can stop now. + if (scan == STBI__SCAN_header) { ++s->img_n; return 1; } + if (z->depth == 16) { + for (k = 0; k < s->img_n; ++k) 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/include/textures.h b/include/textures.h new file mode 100644 index 0000000..32b1016 --- /dev/null +++ b/include/textures.h @@ -0,0 +1,8 @@ +#ifndef __TEXTURES_H__ +#define __TEXTURES_H__ + +#include + +uint32_t load_texture(const char* path); + +#endif diff --git a/include/types.h b/include/types.h index fd4eb5d..ac33fc6 100644 --- a/include/types.h +++ b/include/types.h @@ -5,4 +5,16 @@ typedef GLFWwindow* Window; +typedef struct { + float x, y; +} float2; + +typedef struct { + float x, y, z; +} float3; + +typedef struct { + float x, y, z, w; +} float4; + #endif diff --git a/shader.frag b/shader.frag deleted file mode 100644 index e6c3540..0000000 --- a/shader.frag +++ /dev/null @@ -1,8 +0,0 @@ -#version 460 core - -in vec4 fragColor; -out vec4 finalColor; - -void main() { - finalColor = fragColor; -} diff --git a/shader.vert b/shader.vert deleted file mode 100644 index 09a1e4d..0000000 --- a/shader.vert +++ /dev/null @@ -1,10 +0,0 @@ -#version 460 core - -layout(location = 0) in vec3 aPos; - -out vec4 fragColor; - -void main() { - gl_Position = vec4(aPos, 1.0); - fragColor = vec4(1.0, 0.0, 0.0, 1.0); -} diff --git a/src/main.c b/src/main.c index 29cf349..ee45501 100644 --- a/src/main.c +++ b/src/main.c @@ -1,33 +1,130 @@ #include #include #include +#include #include +#include +#include + +#define MAX_VERTICES 1000 + +#define ARR_SIZE(arr) sizeof(arr)/sizeof(arr[0]) + +typedef struct { + int type; + size_t size; + int count; +} VertexAttrib; + +typedef struct { + float3 Position; + float4 Color; + float2 TexCoord; +} QuadVertex; + +VertexAttrib quad_attribs[] = { + { .type = GL_FLOAT, .size = sizeof(float), .count = 3 }, // position + { .type = GL_FLOAT, .size = sizeof(float), .count = 4 }, // color + { .type = GL_FLOAT, .size = sizeof(float), .count = 2 }, // texcoord +}; + +uint32_t index_count = 0; +uint32_t vertex_count = 0; +uint32_t texture_shader, quad_vbo, quad_vao; +QuadVertex* quad_vertices; +QuadVertex* current_quad_vertex; + +void load_default_shaders() { + texture_shader = load_shader_program( + compile_shader("texture.vert", GL_VERTEX_SHADER), + compile_shader("texture.frag", GL_FRAGMENT_SHADER), 0); +} + +float3 quad_vertex_positions[4] = { + { -0.5f, 0.5f, 0.0f }, + { -0.5f, -0.5f, 0.0f }, + { 0.5f, -0.5f, 0.0f }, + { 0.5f, 0.5f, 0.0f } +}; + +void draw_indexed(uint32_t vao, int count) { + glBindVertexArray(vao); + glDrawElements(GL_TRIANGLES, count, GL_UNSIGNED_INT, 0); + glBindVertexArray(0); +} + +void flush() { + glNamedBufferSubData(quad_vbo, 0, sizeof(QuadVertex) * vertex_count, quad_vertices); + draw_indexed(quad_vao, index_count); + vertex_count = 0; + index_count = 0; + current_quad_vertex = quad_vertices; +} + +void draw_texture(uint32_t texture, float4 color) { + if(vertex_count > MAX_VERTICES - 4) + flush(); + + float2 texcoords[] = { + { 0.0f, 0.0f }, + { 1.0f, 0.0f }, + { 0.0f, 1.0f }, + { 1.0f, 1.0f } + }; + + for(int i = 0; i < 4; i++) { + current_quad_vertex->Position = quad_vertex_positions[i]; + current_quad_vertex->Color = color; + current_quad_vertex->TexCoord = texcoords[i]; + current_quad_vertex++; + + vertex_count++; + } + + index_count += 6; +} int main() { init_gl(4, 6); - GLFWwindow* window = create_window(800, 600, "gearlib"); + Window window = create_window(800, 600, "gearlib"); enable_debugging(); + load_default_shaders(); - float vertices[] = { - -0.5f, -0.5f, 0.0f, // bottom left - 0.5f, -0.5f, 0.0f, // bottom right - 0.0f, 0.5f, 0.0f // top + glEnable(GL_BLEND); + glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA); + + quad_vertices = malloc(sizeof(QuadVertex) * MAX_VERTICES); + current_quad_vertex = quad_vertices; + + glCreateBuffers(1, &quad_vbo); + glNamedBufferStorage(quad_vbo, sizeof(QuadVertex) * MAX_VERTICES, NULL, GL_DYNAMIC_STORAGE_BIT); + + uint32_t quad_indices[] = { + 0, 1, 3, + 1, 2, 3 }; - uint32_t vbo; - glCreateBuffers(1, &vbo); - glNamedBufferStorage(vbo, sizeof(vertices), vertices, GL_DYNAMIC_STORAGE_BIT); + uint32_t quad_ibo; + glCreateBuffers(1, &quad_ibo); + glNamedBufferStorage(quad_ibo, sizeof(quad_indices), quad_indices, GL_DYNAMIC_STORAGE_BIT); - uint32_t vao; - glCreateVertexArrays(1, &vao); - glVertexArrayVertexBuffer(vao, 0, vbo, 0, 3 * sizeof(float)); - glEnableVertexArrayAttrib(vao, 0); - glVertexArrayAttribFormat(vao, 0, 3, GL_FLOAT, GL_FALSE, 0); - glVertexArrayAttribBinding(vao, 0, 0); + glCreateVertexArrays(1, &quad_vao); - uint32_t program = load_shader_program( - compile_shader("shader.vert", GL_VERTEX_SHADER), - compile_shader("shader.frag", GL_FRAGMENT_SHADER), 0); + size_t stride = 0; + for(int i = 0; i < ARR_SIZE(quad_attribs); i++) { + VertexAttrib attr = quad_attribs[i]; + + glEnableVertexArrayAttrib(quad_vao, i); + glVertexArrayAttribFormat(quad_vao, i, attr.count, attr.type, GL_FALSE, stride); + glVertexArrayAttribBinding(quad_vao, i, 0); + + stride += attr.size * attr.count; + } + + glVertexArrayVertexBuffer(quad_vao, 0, quad_vbo, 0, stride); + glVertexArrayElementBuffer(quad_vao, quad_ibo); + + uint32_t cat = load_texture("cat.png"); while (!glfwWindowShouldClose(window)) { process_input(window); @@ -35,11 +132,15 @@ int main() { glClearColor(0.2f, 0.3f, 0.3f, 1.0f); glClear(GL_COLOR_BUFFER_BIT); - glUseProgram(program); + glBindTextureUnit(0, cat); + glUseProgram(texture_shader); + + for(int i = 0; i < 10000; i++) { + draw_texture(cat, (float4){ 1.0f, 1.0f, 1.0f, 1.0f }); + } + + flush(); - glBindVertexArray(vao); - glDrawArrays(GL_TRIANGLES, 0, 3); - glfwSwapBuffers(window); glfwPollEvents(); } diff --git a/src/shaders.c b/src/shaders.c index b8fed4b..d2fc189 100644 --- a/src/shaders.c +++ b/src/shaders.c @@ -1,7 +1,6 @@ #include #include -#define SL_IMPLEMENTATION -#include +#include #include uint32_t compile_shader(const char* path, int32_t type) { @@ -9,26 +8,33 @@ uint32_t compile_shader(const char* path, int32_t type) { sl_read_file(path, &source); const char* source_cstr = sl_c_str(source); - uint32_t shader = glCreateShader(type); - glShaderSource(shader, 1, &source_cstr, NULL); - glCompileShader(shader); + uint32_t id = compile_shader_text(path, source_cstr, type); - sl_str_free(source); + sl_str_free(source); + + return id; +} + +uint32_t compile_shader_text(const char* name, const char* text, int32_t type) { + uint32_t id = glCreateShader(type); + glShaderSource(id, 1, &text, NULL); + glCompileShader(id); int success; char info_log[512]; - glGetShaderiv(shader, GL_COMPILE_STATUS, &success); + glGetShaderiv(id, GL_COMPILE_STATUS, &success); if(!success) { - glGetShaderInfoLog(shader, 512, NULL, info_log); - printf("[Shader %d, %s] Failed to compile: %s\n", shader, path, info_log); + glGetShaderInfoLog(id, 512, NULL, info_log); + printf("[Shader %d, %s] Failed to compile: %s\n", id, name, info_log); exit(-1); } else { - printf("[Shader %d, %s] Compiled successfully\n", shader, path); + printf("[Shader %d, %s] Compiled successfully\n", id, name); } - return shader; + return id; } + uint32_t load_shader_program(uint32_t shader, ...) { sl_vec(uint32_t) shaders = { 0 }; diff --git a/src/slibs.c b/src/slibs.c new file mode 100644 index 0000000..eeda125 --- /dev/null +++ b/src/slibs.c @@ -0,0 +1,2 @@ +#define SL_IMPLEMENTATION +#include diff --git a/src/stb_image.c b/src/stb_image.c new file mode 100644 index 0000000..8c1e337 --- /dev/null +++ b/src/stb_image.c @@ -0,0 +1,3 @@ +#define STBI_FAILURE_USERMSG +#define STB_IMAGE_IMPLEMENTATION +#include diff --git a/src/textures.c b/src/textures.c new file mode 100644 index 0000000..db21c91 --- /dev/null +++ b/src/textures.c @@ -0,0 +1,29 @@ +#include +#include +#include +#include + +uint32_t load_texture(const char* path) { + stbi_set_flip_vertically_on_load(1); + + uint32_t id; + glCreateTextures(GL_TEXTURE_2D, 1, &id); + + glTextureParameteri(id, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE); + glTextureParameteri(id, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE); + glTextureParameteri(id, GL_TEXTURE_MIN_FILTER, GL_LINEAR); + glTextureParameteri(id, GL_TEXTURE_MAG_FILTER, GL_LINEAR); + + int width, height, channels; + unsigned char* pixels = stbi_load(path, &width, &height, &channels, 0); + if(pixels) { + glTextureStorage2D(id, 1, GL_RGBA8, width, height); + glTextureSubImage2D(id, 0, 0, 0, width, height, GL_RGBA, GL_UNSIGNED_BYTE, pixels); + printf("[Texture %d, %s] Loaded successfully (%dx%d, %d channels)\n", id, path, width, height, channels); + } else { + printf("[Texture %d, %s] Failed to load image data: %s\n", id, path, stbi_failure_reason()); + exit(-1); + } + + return id; +} diff --git a/texture.frag b/texture.frag new file mode 100644 index 0000000..9b1a628 --- /dev/null +++ b/texture.frag @@ -0,0 +1,16 @@ +#version 460 core + +layout(location = 0) out vec4 color; + +struct VertexOutput { + vec4 Tint; + vec2 TexCoord; +}; + +layout(location = 0) in VertexOutput Input; + +uniform sampler2D texture0; + +void main() { + color = texture(texture0, Input.TexCoord) * Input.Tint; +} diff --git a/texture.vert b/texture.vert new file mode 100644 index 0000000..614812f --- /dev/null +++ b/texture.vert @@ -0,0 +1,19 @@ +#version 460 core + +layout(location = 0) in vec3 a_Position; +layout(location = 1) in vec4 a_Tint; +layout(location = 2) in vec2 a_TexCoord; + +struct VertexOutput { + vec4 Tint; + vec2 TexCoord; +}; + +layout(location = 0) out VertexOutput Output; + +void main() { + Output.Tint = a_Tint; + Output.TexCoord = a_TexCoord; + + gl_Position = vec4(a_Position, 1.0); +}