From 5d149d8b3c95536347ffd7b310034cd1421ada29 Mon Sep 17 00:00:00 2001 From: Daniel Date: Mon, 24 Jul 2023 20:06:59 +0200 Subject: [PATCH] finished first chapter of Textures section --- src/Engine/Engine.vcxproj | 6 + src/Engine/Engine.vcxproj.filters | 14 + src/Engine/images/container.jpg | Bin 0 -> 184939 bytes src/Engine/images/wall.jpg | Bin 0 -> 256989 bytes src/Engine/main.cpp | 49 +- src/Engine/shaders/default/default.frag | 5 +- src/Engine/shaders/default/default.vert | 3 + src/Engine/textures/Texture2D.h | 11 + src/Engine/util/stb_image.cpp | 2 + src/Engine/util/stb_image.h | 7987 +++++++++++++++++++++++ 10 files changed, 8068 insertions(+), 9 deletions(-) create mode 100644 src/Engine/images/container.jpg create mode 100644 src/Engine/images/wall.jpg create mode 100644 src/Engine/textures/Texture2D.h create mode 100644 src/Engine/util/stb_image.cpp create mode 100644 src/Engine/util/stb_image.h diff --git a/src/Engine/Engine.vcxproj b/src/Engine/Engine.vcxproj index 139897c..b9303aa 100644 --- a/src/Engine/Engine.vcxproj +++ b/src/Engine/Engine.vcxproj @@ -140,6 +140,7 @@ + @@ -156,6 +157,11 @@ + + + + + diff --git a/src/Engine/Engine.vcxproj.filters b/src/Engine/Engine.vcxproj.filters index 96dc523..5826d2c 100644 --- a/src/Engine/Engine.vcxproj.filters +++ b/src/Engine/Engine.vcxproj.filters @@ -24,6 +24,9 @@ Source Files + + Source Files + @@ -44,6 +47,9 @@ Header Files + + Header Files + @@ -51,4 +57,12 @@ Resource Files + + + Resource Files + + + Resource Files + + \ No newline at end of file diff --git a/src/Engine/images/container.jpg b/src/Engine/images/container.jpg new file mode 100644 index 0000000000000000000000000000000000000000..d07bee4e3a679f5e2e4ad508ef3c4dc29a522492 GIT binary patch literal 184939 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

d`XyO#5L!x`fys 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[SQrQz8sg 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 literal 0 HcmV?d00001 diff --git a/src/Engine/images/wall.jpg b/src/Engine/images/wall.jpg new file mode 100644 index 0000000000000000000000000000000000000000..49631987d967c1201286664f2d6032525f9fe1e8 GIT binary patch literal 256989 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࣮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

&shoeJMBBztTS9`;l|qbF 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

~DU&+q6r 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

E+m)_}JJdwsog%%AOO9eCYc*w7Is-5Z$7nDKdHi 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 #include "shaders/Shader.h" +#include "util/stb_image.h" // Continue: https://learnopengl.com/Getting-started/Textures -// Chapter: Not yet started +// Chapter: Texture Units // @@ -63,11 +64,11 @@ int main() OnWindowResize(window, WINDOW_WIDTH, WINDOW_HEIGHT); glfwSetFramebufferSizeCallback(window, OnWindowResize); - GLfloat vertices[] = { - 0.5f, 0.5f, 0.0f, 1.0f, 0.0f, 0.0f, // top right - 0.5f, -0.5f, 0.0f, 0.0f, 1.0f, 0.0f, // bottom right - -0.5f, -0.5f, 0.0f, 0.0f, 0.0f, 1.0f, // bottom left - -0.5f, 0.5f, 0.0f, 1.0f, 0.0f, 0.0f // top left + GLfloat vertices[] = { // world coordinate, colour, uv coordinates + 0.5f, 0.5f, 0.0f, 1.0f, 0.0f, 0.0f, 1.0f, 1.0f, // top right + 0.5f, -0.5f, 0.0f, 0.0f, 1.0f, 0.0f, 1.0f, 0.0f, // bottom right + -0.5f, -0.5f, 0.0f, 0.0f, 0.0f, 1.0f, 0.0f, 0.0f, // bottom left + -0.5f, 0.5f, 0.0f, 1.0f, 0.0f, 0.0f, 0.0f, 1.0f // top left }; GLuint faces[]{ 0, 1, 3, @@ -90,11 +91,14 @@ int main() glBufferData(GL_ELEMENT_ARRAY_BUFFER, sizeof(faces), faces, GL_STATIC_DRAW); // position attribute - glVertexAttribPointer(0, 3, GL_FLOAT, GL_FALSE, 6 * sizeof(float), (void*)0); + glVertexAttribPointer(0, 3, GL_FLOAT, GL_FALSE, 8 * sizeof(float), (void*)0); glEnableVertexAttribArray(0); // colour (or more general, the second vertex Attribute) - glVertexAttribPointer(1, 3, GL_FLOAT, GL_FALSE, 6 * sizeof(float), (void*)(3 * sizeof(float))); + glVertexAttribPointer(1, 3, GL_FLOAT, GL_FALSE, 8 * sizeof(float), (void*)(3 * sizeof(float))); glEnableVertexAttribArray(1); + // uv-coordinates (or more general the third vertex attribute) + glVertexAttribPointer(2, 2, GL_FLOAT, GL_FALSE, 8 * sizeof(float), (void*)(6 * sizeof(float))); + glEnableVertexAttribArray(2); // I could unbind the VAO, but this is usually not needed because when creating a new VAO we need to bind that to change it anyway, so there shouldn't be a problem std::string vertexPath = "shaders/default/default.vert"; @@ -112,6 +116,34 @@ int main() } glPolygonMode(GL_FRONT_AND_BACK, GL_FILL); + // TEXTURES + int width, height, nrChannels; + unsigned char* image = stbi_load("images/container.jpg", &width, &height, &nrChannels, 0); + if (!image) + { + std::cerr << "ERROR::IO::LOAD_TEXTURE"; + stbi_image_free(image); + return -1; // it would be better to just use a default error image instead and make the error message a warning message instead + } + unsigned int textureID; + glGenTextures(1, &textureID); + glBindTexture(GL_TEXTURE_2D, textureID); + glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB, width, height, 0, GL_RGB, GL_UNSIGNED_BYTE, image); + glGenerateMipmap(GL_TEXTURE_2D); + stbi_image_free(image); + + GLfloat texCoords[] = { + 0.0f, 0.0f, // lower-left corner + 1.0f, 0.0f, // lower-right corner + 0.5f, 1.0f // top-center corner + }; + //glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_MIRRORED_REPEAT); + //glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_REPEAT); + glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); // use nearest neighbour when zooming out + glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR); // use bilinear when zooming in + + + // main loop while(!glfwWindowShouldClose(window)) { @@ -125,6 +157,7 @@ int main() //float greenValue = (sin(time) / 2.0f) + 0.5f; //shader->setFloat("ourColour", 0.0f, greenValue, 0.0f, 0.0f); + glBindTexture(GL_TEXTURE_2D, textureID); glBindVertexArray(vertexArrayObject); glDrawElements(GL_TRIANGLES, 6, GL_UNSIGNED_INT, 0); diff --git a/src/Engine/shaders/default/default.frag b/src/Engine/shaders/default/default.frag index 35a5ffc..fff70b5 100644 --- a/src/Engine/shaders/default/default.frag +++ b/src/Engine/shaders/default/default.frag @@ -2,8 +2,11 @@ out vec4 FragColor; in vec3 ourColour; +in vec2 texCoord; + +uniform sampler2D ourTexture; void main() { - FragColor = vec4(ourColour, 1.0); + FragColor = texture(ourTexture, texCoord) * vec4(ourColour, 1.0); } \ No newline at end of file diff --git a/src/Engine/shaders/default/default.vert b/src/Engine/shaders/default/default.vert index 67ddd66..ec51c36 100644 --- a/src/Engine/shaders/default/default.vert +++ b/src/Engine/shaders/default/default.vert @@ -1,11 +1,14 @@ #version 330 core layout (location = 0) in vec3 aPos; layout (location = 1) in vec3 aColour; +layout (location = 2) in vec2 aTexCoord; out vec3 ourColour; +out vec2 texCoord; void main() { gl_Position = vec4(aPos, 1.0); ourColour = aColour; + texCoord = aTexCoord; } diff --git a/src/Engine/textures/Texture2D.h b/src/Engine/textures/Texture2D.h new file mode 100644 index 0000000..7d10415 --- /dev/null +++ b/src/Engine/textures/Texture2D.h @@ -0,0 +1,11 @@ +#pragma once +// Maybe make a base "Texture" class and make a Texture2D and Texture3D child class. look into what would make more sense +class Texture2D +{ +public: + Texture2D(); + ~Texture2D(); + +private: + +}; diff --git a/src/Engine/util/stb_image.cpp b/src/Engine/util/stb_image.cpp new file mode 100644 index 0000000..8ddfd1f --- /dev/null +++ b/src/Engine/util/stb_image.cpp @@ -0,0 +1,2 @@ +#define STB_IMAGE_IMPLEMENTATION +#include "stb_image.h" diff --git a/src/Engine/util/stb_image.h b/src/Engine/util/stb_image.h new file mode 100644 index 0000000..5e807a0 --- /dev/null +++ b/src/Engine/util/stb_image.h @@ -0,0 +1,7987 @@ +/* stb_image - v2.28 - public domain image loader - http://nothings.org/stb + no warranty implied; use at your own risk + + Do this: + #define STB_IMAGE_IMPLEMENTATION + before you include this file in *one* C or C++ file to create the implementation. + + // i.e. it should look like this: + #include ... + #include ... + #include ... + #define STB_IMAGE_IMPLEMENTATION + #include "stb_image.h" + + You can #define STBI_ASSERT(x) before the #include to avoid using assert.h. + And #define STBI_MALLOC, STBI_REALLOC, and STBI_FREE to avoid using malloc,realloc,free + + + QUICK NOTES: + Primarily of interest to game developers and other people who can + avoid problematic images and only need the trivial interface + + JPEG baseline & progressive (12 bpc/arithmetic not supported, same as stock IJG lib) + PNG 1/2/4/8/16-bit-per-channel + + TGA (not sure what subset, if a subset) + BMP non-1bpp, non-RLE + PSD (composited view only, no extra channels, 8/16 bit-per-channel) + + GIF (*comp always reports as 4-channel) + HDR (radiance rgbE format) + PIC (Softimage PIC) + PNM (PPM and PGM binary only) + + Animated GIF still needs a proper API, but here's one way to do it: + http://gist.github.com/urraka/685d9a6340b26b830d49 + + - decode from memory or through FILE (define STBI_NO_STDIO to remove code) + - decode from arbitrary I/O callbacks + - SIMD acceleration on x86/x64 (SSE2) and ARM (NEON) + + Full documentation under "DOCUMENTATION" below. + + +LICENSE + + See end of file for license information. + +RECENT REVISION HISTORY: + + 2.28 (2023-01-29) many error fixes, security errors, just tons of stuff + 2.27 (2021-07-11) document stbi_info better, 16-bit PNM support, bug fixes + 2.26 (2020-07-13) many minor fixes + 2.25 (2020-02-02) fix warnings + 2.24 (2020-02-02) fix warnings; thread-local failure_reason and flip_vertically + 2.23 (2019-08-11) fix clang static analysis warning + 2.22 (2019-03-04) gif fixes, fix warnings + 2.21 (2019-02-25) fix typo in comment + 2.20 (2019-02-07) support utf8 filenames in Windows; fix warnings and platform ifdefs + 2.19 (2018-02-11) fix warning + 2.18 (2018-01-30) fix warnings + 2.17 (2018-01-29) bugfix, 1-bit BMP, 16-bitness query, fix warnings + 2.16 (2017-07-23) all functions have 16-bit variants; optimizations; bugfixes + 2.15 (2017-03-18) fix png-1,2,4; all Imagenet JPGs; no runtime SSE detection on GCC + 2.14 (2017-03-03) remove deprecated STBI_JPEG_OLD; fixes for Imagenet JPGs + 2.13 (2016-12-04) experimental 16-bit API, only for PNG so far; fixes + 2.12 (2016-04-02) fix typo in 2.11 PSD fix that caused crashes + 2.11 (2016-04-02) 16-bit PNGS; enable SSE2 in non-gcc x64 + RGB-format JPEG; remove white matting in PSD; + allocate large structures on the stack; + correct channel count for PNG & BMP + 2.10 (2016-01-22) avoid warning introduced in 2.09 + 2.09 (2016-01-16) 16-bit TGA; comments in PNM files; STBI_REALLOC_SIZED + + See end of file for full revision history. + + + ============================ Contributors ========================= + + Image formats Extensions, features + Sean Barrett (jpeg, png, bmp) Jetro Lauha (stbi_info) + Nicolas Schulz (hdr, psd) Martin "SpartanJ" Golini (stbi_info) + Jonathan Dummer (tga) James "moose2000" Brown (iPhone PNG) + Jean-Marc Lienher (gif) Ben "Disch" Wenger (io callbacks) + Tom Seddon (pic) Omar Cornut (1/2/4-bit PNG) + Thatcher Ulrich (psd) Nicolas Guillemot (vertical flip) + Ken Miller (pgm, ppm) Richard Mitton (16-bit PSD) + github:urraka (animated gif) Junggon Kim (PNM comments) + Christopher Forseth (animated gif) Daniel Gibson (16-bit TGA) + socks-the-fox (16-bit PNG) + Jeremy Sawicki (handle all ImageNet JPGs) + Optimizations & bugfixes Mikhail Morozov (1-bit BMP) + Fabian "ryg" Giesen Anael Seghezzi (is-16-bit query) + Arseny Kapoulkine Simon Breuss (16-bit PNM) + John-Mark Allen + Carmelo J Fdez-Aguera + + Bug & warning fixes + Marc LeBlanc David Woo Guillaume George Martins Mozeiko + Christpher Lloyd Jerry Jansson Joseph Thomson Blazej Dariusz Roszkowski + Phil Jordan Dave Moore Roy Eltham + Hayaki Saito Nathan Reed Won Chun + Luke Graham Johan Duparc Nick Verigakis the Horde3D community + Thomas Ruf Ronny Chevalier github:rlyeh + Janez Zemva John Bartholomew Michal Cichon github:romigrou + Jonathan Blow Ken Hamada Tero Hanninen github:svdijk + Eugene Golushkov Laurent Gomila Cort Stratton github:snagar + Aruelien Pocheville Sergio Gonzalez Thibault Reuille github:Zelex + Cass Everitt Ryamond Barbiero github:grim210 + Paul Du Bois Engin Manap Aldo Culquicondor github:sammyhw + Philipp Wiesemann Dale Weiler Oriol Ferrer Mesia github:phprus + Josh Tobin Neil Bickford Matthew Gregan github:poppolopoppo + Julian Raschke Gregory Mullen Christian Floisand github:darealshinji + Baldur Karlsson Kevin Schmidt JR Smith github:Michaelangel007 + Brad Weinberger Matvey Cherevko github:mosra + Luca Sas Alexander Veselov Zack Middleton [reserved] + Ryan C. Gordon [reserved] [reserved] + DO NOT ADD YOUR NAME HERE + + Jacko Dirks + + To add your name to the credits, pick a random blank space in the middle and fill it. + 80% of merge conflicts on stb PRs are due to people adding their name at the end + of the credits. +*/ + +#ifndef STBI_INCLUDE_STB_IMAGE_H +#define STBI_INCLUDE_STB_IMAGE_H + +// DOCUMENTATION +// +// Limitations: +// - no 12-bit-per-channel JPEG +// - no JPEGs with arithmetic coding +// - GIF always returns *comp=4 +// +// Basic usage (see HDR discussion below for HDR usage): +// int x,y,n; +// unsigned char *data = stbi_load(filename, &x, &y, &n, 0); +// // ... process data if not NULL ... +// // ... x = width, y = height, n = # 8-bit components per pixel ... +// // ... replace '0' with '1'..'4' to force that many components per pixel +// // ... but 'n' will always be the number that it would have been if you said 0 +// stbi_image_free(data); +// +// Standard parameters: +// int *x -- outputs image width in pixels +// int *y -- outputs image height in pixels +// int *channels_in_file -- outputs # of image components in image file +// int desired_channels -- if non-zero, # of image components requested in result +// +// The return value from an image loader is an 'unsigned char *' which points +// to the pixel data, or NULL on an allocation failure or if the image is +// corrupt or invalid. The pixel data consists of *y scanlines of *x pixels, +// with each pixel consisting of N interleaved 8-bit components; the first +// pixel pointed to is top-left-most in the image. There is no padding between +// image scanlines or between pixels, regardless of format. The number of +// components N is 'desired_channels' if desired_channels is non-zero, or +// *channels_in_file otherwise. If desired_channels is non-zero, +// *channels_in_file has the number of components that _would_ have been +// output otherwise. E.g. if you set desired_channels to 4, you will always +// get RGBA output, but you can check *channels_in_file to see if it's trivially +// opaque because e.g. there were only 3 channels in the source image. +// +// An output image with N components has the following components interleaved +// in this order in each pixel: +// +// N=#comp components +// 1 grey +// 2 grey, alpha +// 3 red, green, blue +// 4 red, green, blue, alpha +// +// If image loading fails for any reason, the return value will be NULL, +// and *x, *y, *channels_in_file will be unchanged. The function +// stbi_failure_reason() can be queried for an extremely brief, end-user +// unfriendly explanation of why the load failed. Define STBI_NO_FAILURE_STRINGS +// to avoid compiling these strings at all, and STBI_FAILURE_USERMSG to get slightly +// more user-friendly ones. +// +// Paletted PNG, BMP, GIF, and PIC images are automatically depalettized. +// +// To query the width, height and component count of an image without having to +// decode the full file, you can use the stbi_info family of functions: +// +// int x,y,n,ok; +// ok = stbi_info(filename, &x, &y, &n); +// // returns ok=1 and sets x, y, n if image is a supported format, +// // 0 otherwise. +// +// Note that stb_image pervasively uses ints in its public API for sizes, +// including sizes of memory buffers. This is now part of the API and thus +// hard to change without causing breakage. As a result, the various image +// loaders all have certain limits on image size; these differ somewhat +// by format but generally boil down to either just under 2GB or just under +// 1GB. When the decoded image would be larger than this, stb_image decoding +// will fail. +// +// Additionally, stb_image will reject image files that have any of their +// dimensions set to a larger value than the configurable STBI_MAX_DIMENSIONS, +// which defaults to 2**24 = 16777216 pixels. Due to the above memory limit, +// the only way to have an image with such dimensions load correctly +// is for it to have a rather extreme aspect ratio. Either way, the +// assumption here is that such larger images are likely to be malformed +// or malicious. If you do need to load an image with individual dimensions +// larger than that, and it still fits in the overall size limit, you can +// #define STBI_MAX_DIMENSIONS on your own to be something larger. +// +// =========================================================================== +// +// UNICODE: +// +// If compiling for Windows and you wish to use Unicode filenames, compile +// with +// #define STBI_WINDOWS_UTF8 +// and pass utf8-encoded filenames. Call stbi_convert_wchar_to_utf8 to convert +// Windows wchar_t filenames to utf8. +// +// =========================================================================== +// +// Philosophy +// +// stb libraries are designed with the following priorities: +// +// 1. easy to use +// 2. easy to maintain +// 3. good performance +// +// Sometimes I let "good performance" creep up in priority over "easy to maintain", +// and for best performance I may provide less-easy-to-use APIs that give higher +// performance, in addition to the easy-to-use ones. Nevertheless, it's important +// to keep in mind that from the standpoint of you, a client of this library, +// all you care about is #1 and #3, and stb libraries DO NOT emphasize #3 above all. +// +// Some secondary priorities arise directly from the first two, some of which +// provide more explicit reasons why performance can't be emphasized. +// +// - Portable ("ease of use") +// - Small source code footprint ("easy to maintain") +// - No dependencies ("ease of use") +// +// =========================================================================== +// +// I/O callbacks +// +// I/O callbacks allow you to read from arbitrary sources, like packaged +// files or some other source. Data read from callbacks are processed +// through a small internal buffer (currently 128 bytes) to try to reduce +// overhead. +// +// The three functions you must define are "read" (reads some bytes of data), +// "skip" (skips some bytes of data), "eof" (reports if the stream is at the end). +// +// =========================================================================== +// +// SIMD support +// +// The JPEG decoder will try to automatically use SIMD kernels on x86 when +// supported by the compiler. For ARM Neon support, you must explicitly +// request it. +// +// (The old do-it-yourself SIMD API is no longer supported in the current +// code.) +// +// On x86, SSE2 will automatically be used when available based on a run-time +// test; if not, the generic C versions are used as a fall-back. On ARM targets, +// the typical path is to have separate builds for NEON and non-NEON devices +// (at least this is true for iOS and Android). Therefore, the NEON support is +// toggled by a build flag: define STBI_NEON to get NEON loops. +// +// If for some reason you do not want to use any of SIMD code, or if +// you have issues compiling it, you can disable it entirely by +// defining STBI_NO_SIMD. +// +// =========================================================================== +// +// HDR image support (disable by defining STBI_NO_HDR) +// +// stb_image supports loading HDR images in general, and currently the Radiance +// .HDR file format specifically. You can still load any file through the existing +// interface; if you attempt to load an HDR file, it will be automatically remapped +// to LDR, assuming gamma 2.2 and an arbitrary scale factor defaulting to 1; +// both of these constants can be reconfigured through this interface: +// +// stbi_hdr_to_ldr_gamma(2.2f); +// stbi_hdr_to_ldr_scale(1.0f); +// +// (note, do not use _inverse_ constants; stbi_image will invert them +// appropriately). +// +// Additionally, there is a new, parallel interface for loading files as +// (linear) floats to preserve the full dynamic range: +// +// float *data = stbi_loadf(filename, &x, &y, &n, 0); +// +// If you load LDR images through this interface, those images will +// be promoted to floating point values, run through the inverse of +// constants corresponding to the above: +// +// stbi_ldr_to_hdr_scale(1.0f); +// stbi_ldr_to_hdr_gamma(2.2f); +// +// Finally, given a filename (or an open file or memory block--see header +// file for details) containing image data, you can query for the "most +// appropriate" interface to use (that is, whether the image is HDR or +// not), using: +// +// stbi_is_hdr(char *filename); +// +// =========================================================================== +// +// iPhone PNG support: +// +// We optionally support converting iPhone-formatted PNGs (which store +// premultiplied BGRA) back to RGB, even though they're internally encoded +// differently. To enable this conversion, call +// stbi_convert_iphone_png_to_rgb(1). +// +// Call stbi_set_unpremultiply_on_load(1) as well to force a divide per +// pixel to remove any premultiplied alpha *only* if the image file explicitly +// says there's premultiplied data (currently only happens in iPhone images, +// and only if iPhone convert-to-rgb processing is on). +// +// =========================================================================== +// +// ADDITIONAL CONFIGURATION +// +// - You can suppress implementation of any of the decoders to reduce +// your code footprint by #defining one or more of the following +// symbols before creating the implementation. +// +// STBI_NO_JPEG +// STBI_NO_PNG +// STBI_NO_BMP +// STBI_NO_PSD +// STBI_NO_TGA +// STBI_NO_GIF +// STBI_NO_HDR +// STBI_NO_PIC +// STBI_NO_PNM (.ppm and .pgm) +// +// - You can request *only* certain decoders and suppress all other ones +// (this will be more forward-compatible, as addition of new decoders +// doesn't require you to disable them explicitly): +// +// STBI_ONLY_JPEG +// STBI_ONLY_PNG +// STBI_ONLY_BMP +// STBI_ONLY_PSD +// STBI_ONLY_TGA +// STBI_ONLY_GIF +// STBI_ONLY_HDR +// STBI_ONLY_PIC +// STBI_ONLY_PNM (.ppm and .pgm) +// +// - If you use STBI_NO_PNG (or _ONLY_ without PNG), and you still +// want the zlib decoder to be available, #define STBI_SUPPORT_ZLIB +// +// - If you define STBI_MAX_DIMENSIONS, stb_image will reject images greater +// than that size (in either width or height) without further processing. +// This is to let programs in the wild set an upper bound to prevent +// denial-of-service attacks on untrusted data, as one could generate a +// valid image of gigantic dimensions and force stb_image to allocate a +// huge block of memory and spend disproportionate time decoding it. By +// default this is set to (1 << 24), which is 16777216, but that's still +// very big. + +#ifndef STBI_NO_STDIO +#include +#endif // STBI_NO_STDIO + +#define STBI_VERSION 1 + +enum +{ + STBI_default = 0, // only used for desired_channels + + STBI_grey = 1, + STBI_grey_alpha = 2, + STBI_rgb = 3, + STBI_rgb_alpha = 4 +}; + +#include +typedef unsigned char stbi_uc; +typedef unsigned short stbi_us; + +#ifdef __cplusplus +extern "C" { +#endif + +#ifndef STBIDEF +#ifdef STB_IMAGE_STATIC +#define STBIDEF static +#else +#define STBIDEF extern +#endif +#endif + +////////////////////////////////////////////////////////////////////////////// +// +// PRIMARY API - works on images of any type +// + +// +// load image by filename, open file, or memory buffer +// + +typedef struct +{ + int (*read) (void *user,char *data,int size); // fill 'data' with 'size' bytes. return number of bytes actually read + void (*skip) (void *user,int n); // skip the next 'n' bytes, or 'unget' the last -n bytes if negative + int (*eof) (void *user); // returns nonzero if we are at end of file/data +} stbi_io_callbacks; + +//////////////////////////////////// +// +// 8-bits-per-channel interface +// + +STBIDEF stbi_uc *stbi_load_from_memory (stbi_uc const *buffer, int len , int *x, int *y, int *channels_in_file, int desired_channels); +STBIDEF stbi_uc *stbi_load_from_callbacks(stbi_io_callbacks const *clbk , void *user, int *x, int *y, int *channels_in_file, int desired_channels); + +#ifndef STBI_NO_STDIO +STBIDEF stbi_uc *stbi_load (char const *filename, int *x, int *y, int *channels_in_file, int desired_channels); +STBIDEF stbi_uc *stbi_load_from_file (FILE *f, int *x, int *y, int *channels_in_file, int desired_channels); +// for stbi_load_from_file, file pointer is left pointing immediately after image +#endif + +#ifndef STBI_NO_GIF +STBIDEF stbi_uc *stbi_load_gif_from_memory(stbi_uc const *buffer, int len, int **delays, int *x, int *y, int *z, int *comp, int req_comp); +#endif + +#ifdef STBI_WINDOWS_UTF8 +STBIDEF int stbi_convert_wchar_to_utf8(char *buffer, size_t bufferlen, const wchar_t* input); +#endif + +//////////////////////////////////// +// +// 16-bits-per-channel interface +// + +STBIDEF stbi_us *stbi_load_16_from_memory (stbi_uc const *buffer, int len, int *x, int *y, int *channels_in_file, int desired_channels); +STBIDEF stbi_us *stbi_load_16_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *channels_in_file, int desired_channels); + +#ifndef STBI_NO_STDIO +STBIDEF stbi_us *stbi_load_16 (char const *filename, int *x, int *y, int *channels_in_file, int desired_channels); +STBIDEF stbi_us *stbi_load_from_file_16(FILE *f, int *x, int *y, int *channels_in_file, int desired_channels); +#endif + +//////////////////////////////////// +// +// float-per-channel interface +// +#ifndef STBI_NO_LINEAR + STBIDEF float *stbi_loadf_from_memory (stbi_uc const *buffer, int len, int *x, int *y, int *channels_in_file, int desired_channels); + STBIDEF float *stbi_loadf_from_callbacks (stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *channels_in_file, int desired_channels); + + #ifndef STBI_NO_STDIO + STBIDEF float *stbi_loadf (char const *filename, int *x, int *y, int *channels_in_file, int desired_channels); + STBIDEF float *stbi_loadf_from_file (FILE *f, int *x, int *y, int *channels_in_file, int desired_channels); + #endif +#endif + +#ifndef STBI_NO_HDR + STBIDEF void stbi_hdr_to_ldr_gamma(float gamma); + STBIDEF void stbi_hdr_to_ldr_scale(float scale); +#endif // STBI_NO_HDR + +#ifndef STBI_NO_LINEAR + STBIDEF void stbi_ldr_to_hdr_gamma(float gamma); + STBIDEF void stbi_ldr_to_hdr_scale(float scale); +#endif // STBI_NO_LINEAR + +// stbi_is_hdr is always defined, but always returns false if STBI_NO_HDR +STBIDEF int stbi_is_hdr_from_callbacks(stbi_io_callbacks const *clbk, void *user); +STBIDEF int stbi_is_hdr_from_memory(stbi_uc const *buffer, int len); +#ifndef STBI_NO_STDIO +STBIDEF int stbi_is_hdr (char const *filename); +STBIDEF int stbi_is_hdr_from_file(FILE *f); +#endif // STBI_NO_STDIO + + +// get a VERY brief reason for failure +// on most compilers (and ALL modern mainstream compilers) this is threadsafe +STBIDEF const char *stbi_failure_reason (void); + +// free the loaded image -- this is just free() +STBIDEF void stbi_image_free (void *retval_from_stbi_load); + +// get image dimensions & components without fully decoding +STBIDEF int stbi_info_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp); +STBIDEF int stbi_info_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *comp); +STBIDEF int stbi_is_16_bit_from_memory(stbi_uc const *buffer, int len); +STBIDEF int stbi_is_16_bit_from_callbacks(stbi_io_callbacks const *clbk, void *user); + +#ifndef STBI_NO_STDIO +STBIDEF int stbi_info (char const *filename, int *x, int *y, int *comp); +STBIDEF int stbi_info_from_file (FILE *f, int *x, int *y, int *comp); +STBIDEF int stbi_is_16_bit (char const *filename); +STBIDEF int stbi_is_16_bit_from_file(FILE *f); +#endif + + + +// for image formats that explicitly notate that they have premultiplied alpha, +// we just return the colors as stored in the file. set this flag to force +// unpremultiplication. results are undefined if the unpremultiply overflow. +STBIDEF void stbi_set_unpremultiply_on_load(int flag_true_if_should_unpremultiply); + +// indicate whether we should process iphone images back to canonical format, +// or just pass them through "as-is" +STBIDEF void stbi_convert_iphone_png_to_rgb(int flag_true_if_should_convert); + +// flip the image vertically, so the first pixel in the output array is the bottom left +STBIDEF void stbi_set_flip_vertically_on_load(int flag_true_if_should_flip); + +// as above, but only applies to images loaded on the thread that calls the function +// this function is only available if your compiler supports thread-local variables; +// calling it will fail to link if your compiler doesn't +STBIDEF void stbi_set_unpremultiply_on_load_thread(int flag_true_if_should_unpremultiply); +STBIDEF void stbi_convert_iphone_png_to_rgb_thread(int flag_true_if_should_convert); +STBIDEF void stbi_set_flip_vertically_on_load_thread(int flag_true_if_should_flip); + +// ZLIB client - used by PNG, available for other purposes + +STBIDEF char *stbi_zlib_decode_malloc_guesssize(const char *buffer, int len, int initial_size, int *outlen); +STBIDEF char *stbi_zlib_decode_malloc_guesssize_headerflag(const char *buffer, int len, int initial_size, int *outlen, int parse_header); +STBIDEF char *stbi_zlib_decode_malloc(const char *buffer, int len, int *outlen); +STBIDEF int stbi_zlib_decode_buffer(char *obuffer, int olen, const char *ibuffer, int ilen); + +STBIDEF char *stbi_zlib_decode_noheader_malloc(const char *buffer, int len, int *outlen); +STBIDEF int stbi_zlib_decode_noheader_buffer(char *obuffer, int olen, const char *ibuffer, int ilen); + + +#ifdef __cplusplus +} +#endif + +// +// +//// end header file ///////////////////////////////////////////////////// +#endif // STBI_INCLUDE_STB_IMAGE_H + +#ifdef STB_IMAGE_IMPLEMENTATION + +#if defined(STBI_ONLY_JPEG) || defined(STBI_ONLY_PNG) || defined(STBI_ONLY_BMP) \ + || defined(STBI_ONLY_TGA) || defined(STBI_ONLY_GIF) || defined(STBI_ONLY_PSD) \ + || defined(STBI_ONLY_HDR) || defined(STBI_ONLY_PIC) || defined(STBI_ONLY_PNM) \ + || defined(STBI_ONLY_ZLIB) + #ifndef STBI_ONLY_JPEG + #define STBI_NO_JPEG + #endif + #ifndef STBI_ONLY_PNG + #define STBI_NO_PNG + #endif + #ifndef STBI_ONLY_BMP + #define STBI_NO_BMP + #endif + #ifndef STBI_ONLY_PSD + #define STBI_NO_PSD + #endif + #ifndef STBI_ONLY_TGA + #define STBI_NO_TGA + #endif + #ifndef STBI_ONLY_GIF + #define STBI_NO_GIF + #endif + #ifndef STBI_ONLY_HDR + #define STBI_NO_HDR + #endif + #ifndef STBI_ONLY_PIC + #define STBI_NO_PIC + #endif + #ifndef STBI_ONLY_PNM + #define STBI_NO_PNM + #endif +#endif + +#if defined(STBI_NO_PNG) && !defined(STBI_SUPPORT_ZLIB) && !defined(STBI_NO_ZLIB) +#define STBI_NO_ZLIB +#endif + + +#include +#include // ptrdiff_t on osx +#include +#include +#include + +#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR) +#include // ldexp, pow +#endif + +#ifndef STBI_NO_STDIO +#include +#endif + +#ifndef STBI_ASSERT +#include +#define STBI_ASSERT(x) assert(x) +#endif + +#ifdef __cplusplus +#define STBI_EXTERN extern "C" +#else +#define STBI_EXTERN extern +#endif + + +#ifndef _MSC_VER + #ifdef __cplusplus + #define stbi_inline inline + #else + #define stbi_inline + #endif +#else + #define stbi_inline __forceinline +#endif + +#ifndef STBI_NO_THREAD_LOCALS + #if defined(__cplusplus) && __cplusplus >= 201103L + #define STBI_THREAD_LOCAL thread_local + #elif defined(__GNUC__) && __GNUC__ < 5 + #define STBI_THREAD_LOCAL __thread + #elif defined(_MSC_VER) + #define STBI_THREAD_LOCAL __declspec(thread) + #elif defined (__STDC_VERSION__) && __STDC_VERSION__ >= 201112L && !defined(__STDC_NO_THREADS__) + #define STBI_THREAD_LOCAL _Thread_local + #endif + + #ifndef STBI_THREAD_LOCAL + #if defined(__GNUC__) + #define STBI_THREAD_LOCAL __thread + #endif + #endif +#endif + +#if defined(_MSC_VER) || defined(__SYMBIAN32__) +typedef unsigned short stbi__uint16; +typedef signed short stbi__int16; +typedef unsigned int stbi__uint32; +typedef signed int stbi__int32; +#else +#include +typedef uint16_t stbi__uint16; +typedef int16_t stbi__int16; +typedef uint32_t stbi__uint32; +typedef int32_t stbi__int32; +#endif + +// should produce compiler error if size is wrong +typedef unsigned char validate_uint32[sizeof(stbi__uint32)==4 ? 1 : -1]; + +#ifdef _MSC_VER +#define STBI_NOTUSED(v) (void)(v) +#else +#define STBI_NOTUSED(v) (void)sizeof(v) +#endif + +#ifdef _MSC_VER +#define STBI_HAS_LROTL +#endif + +#ifdef STBI_HAS_LROTL + #define stbi_lrot(x,y) _lrotl(x,y) +#else + #define stbi_lrot(x,y) (((x) << (y)) | ((x) >> (-(y) & 31))) +#endif + +#if defined(STBI_MALLOC) && defined(STBI_FREE) && (defined(STBI_REALLOC) || defined(STBI_REALLOC_SIZED)) +// ok +#elif !defined(STBI_MALLOC) && !defined(STBI_FREE) && !defined(STBI_REALLOC) && !defined(STBI_REALLOC_SIZED) +// ok +#else +#error "Must define all or none of STBI_MALLOC, STBI_FREE, and STBI_REALLOC (or STBI_REALLOC_SIZED)." +#endif + +#ifndef STBI_MALLOC +#define STBI_MALLOC(sz) malloc(sz) +#define STBI_REALLOC(p,newsz) realloc(p,newsz) +#define STBI_FREE(p) free(p) +#endif + +#ifndef STBI_REALLOC_SIZED +#define STBI_REALLOC_SIZED(p,oldsz,newsz) STBI_REALLOC(p,newsz) +#endif + +// x86/x64 detection +#if defined(__x86_64__) || defined(_M_X64) +#define STBI__X64_TARGET +#elif defined(__i386) || defined(_M_IX86) +#define STBI__X86_TARGET +#endif + +#if defined(__GNUC__) && defined(STBI__X86_TARGET) && !defined(__SSE2__) && !defined(STBI_NO_SIMD) +// gcc doesn't support sse2 intrinsics unless you compile with -msse2, +// which in turn means it gets to use SSE2 everywhere. This is unfortunate, +// but previous attempts to provide the SSE2 functions with runtime +// detection caused numerous issues. The way architecture extensions are +// exposed in GCC/Clang is, sadly, not really suited for one-file libs. +// New behavior: if compiled with -msse2, we use SSE2 without any +// detection; if not, we don't use it at all. +#define STBI_NO_SIMD +#endif + +#if defined(__MINGW32__) && defined(STBI__X86_TARGET) && !defined(STBI_MINGW_ENABLE_SSE2) && !defined(STBI_NO_SIMD) +// Note that __MINGW32__ doesn't actually mean 32-bit, so we have to avoid STBI__X64_TARGET +// +// 32-bit MinGW wants ESP to be 16-byte aligned, but this is not in the +// Windows ABI and VC++ as well as Windows DLLs don't maintain that invariant. +// As a result, enabling SSE2 on 32-bit MinGW is dangerous when not +// simultaneously enabling "-mstackrealign". +// +// See https://github.com/nothings/stb/issues/81 for more information. +// +// So default to no SSE2 on 32-bit MinGW. If you've read this far and added +// -mstackrealign to your build settings, feel free to #define STBI_MINGW_ENABLE_SSE2. +#define STBI_NO_SIMD +#endif + +#if !defined(STBI_NO_SIMD) && (defined(STBI__X86_TARGET) || defined(STBI__X64_TARGET)) +#define STBI_SSE2 +#include + +#ifdef _MSC_VER + +#if _MSC_VER >= 1400 // not VC6 +#include // __cpuid +static int stbi__cpuid3(void) +{ + int info[4]; + __cpuid(info,1); + return info[3]; +} +#else +static int stbi__cpuid3(void) +{ + int res; + __asm { + mov eax,1 + cpuid + mov res,edx + } + return res; +} +#endif + +#define STBI_SIMD_ALIGN(type, name) __declspec(align(16)) type name + +#if !defined(STBI_NO_JPEG) && defined(STBI_SSE2) +static int stbi__sse2_available(void) +{ + int info3 = stbi__cpuid3(); + return ((info3 >> 26) & 1) != 0; +} +#endif + +#else // assume GCC-style if not VC++ +#define STBI_SIMD_ALIGN(type, name) type name __attribute__((aligned(16))) + +#if !defined(STBI_NO_JPEG) && defined(STBI_SSE2) +static int stbi__sse2_available(void) +{ + // If we're even attempting to compile this on GCC/Clang, that means + // -msse2 is on, which means the compiler is allowed to use SSE2 + // instructions at will, and so are we. + return 1; +} +#endif + +#endif +#endif + +// ARM NEON +#if defined(STBI_NO_SIMD) && defined(STBI_NEON) +#undef STBI_NEON +#endif + +#ifdef STBI_NEON +#include +#ifdef _MSC_VER +#define STBI_SIMD_ALIGN(type, name) __declspec(align(16)) type name +#else +#define STBI_SIMD_ALIGN(type, name) type name __attribute__((aligned(16))) +#endif +#endif + +#ifndef STBI_SIMD_ALIGN +#define STBI_SIMD_ALIGN(type, name) type name +#endif + +#ifndef STBI_MAX_DIMENSIONS +#define STBI_MAX_DIMENSIONS (1 << 24) +#endif + +/////////////////////////////////////////////// +// +// stbi__context struct and start_xxx functions + +// stbi__context structure is our basic context used by all images, so it +// contains all the IO context, plus some basic image information +typedef struct +{ + stbi__uint32 img_x, img_y; + int img_n, img_out_n; + + stbi_io_callbacks io; + void *io_user_data; + + int read_from_callbacks; + int buflen; + stbi_uc buffer_start[128]; + int callback_already_read; + + stbi_uc *img_buffer, *img_buffer_end; + stbi_uc *img_buffer_original, *img_buffer_original_end; +} stbi__context; + + +static void stbi__refill_buffer(stbi__context *s); + +// initialize a memory-decode context +static void stbi__start_mem(stbi__context *s, stbi_uc const *buffer, int len) +{ + s->io.read = NULL; + s->read_from_callbacks = 0; + s->callback_already_read = 0; + s->img_buffer = s->img_buffer_original = (stbi_uc *) buffer; + s->img_buffer_end = s->img_buffer_original_end = (stbi_uc *) buffer+len; +} + +// initialize a callback-based context +static void stbi__start_callbacks(stbi__context *s, stbi_io_callbacks *c, void *user) +{ + s->io = *c; + s->io_user_data = user; + s->buflen = sizeof(s->buffer_start); + s->read_from_callbacks = 1; + s->callback_already_read = 0; + s->img_buffer = s->img_buffer_original = s->buffer_start; + stbi__refill_buffer(s); + s->img_buffer_original_end = s->img_buffer_end; +} + +#ifndef STBI_NO_STDIO + +static int stbi__stdio_read(void *user, char *data, int size) +{ + return (int) fread(data,1,size,(FILE*) user); +} + +static void stbi__stdio_skip(void *user, int n) +{ + int ch; + fseek((FILE*) user, n, SEEK_CUR); + ch = fgetc((FILE*) user); /* have to read a byte to reset feof()'s flag */ + if (ch != EOF) { + ungetc(ch, (FILE *) user); /* push byte back onto stream if valid. */ + } +} + +static int stbi__stdio_eof(void *user) +{ + return feof((FILE*) user) || ferror((FILE *) user); +} + +static stbi_io_callbacks stbi__stdio_callbacks = +{ + stbi__stdio_read, + stbi__stdio_skip, + stbi__stdio_eof, +}; + +static void stbi__start_file(stbi__context *s, FILE *f) +{ + stbi__start_callbacks(s, &stbi__stdio_callbacks, (void *) f); +} + +//static void stop_file(stbi__context *s) { } + +#endif // !STBI_NO_STDIO + +static void stbi__rewind(stbi__context *s) +{ + // conceptually rewind SHOULD rewind to the beginning of the stream, + // but we just rewind to the beginning of the initial buffer, because + // we only use it after doing 'test', which only ever looks at at most 92 bytes + s->img_buffer = s->img_buffer_original; + s->img_buffer_end = s->img_buffer_original_end; +} + +enum +{ + STBI_ORDER_RGB, + STBI_ORDER_BGR +}; + +typedef struct +{ + int bits_per_channel; + int num_channels; + int channel_order; +} stbi__result_info; + +#ifndef STBI_NO_JPEG +static int stbi__jpeg_test(stbi__context *s); +static void *stbi__jpeg_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static int stbi__jpeg_info(stbi__context *s, int *x, int *y, int *comp); +#endif + +#ifndef STBI_NO_PNG +static int stbi__png_test(stbi__context *s); +static void *stbi__png_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static int stbi__png_info(stbi__context *s, int *x, int *y, int *comp); +static int stbi__png_is16(stbi__context *s); +#endif + +#ifndef STBI_NO_BMP +static int stbi__bmp_test(stbi__context *s); +static void *stbi__bmp_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static int stbi__bmp_info(stbi__context *s, int *x, int *y, int *comp); +#endif + +#ifndef STBI_NO_TGA +static int stbi__tga_test(stbi__context *s); +static void *stbi__tga_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static int stbi__tga_info(stbi__context *s, int *x, int *y, int *comp); +#endif + +#ifndef STBI_NO_PSD +static int stbi__psd_test(stbi__context *s); +static void *stbi__psd_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri, int bpc); +static int stbi__psd_info(stbi__context *s, int *x, int *y, int *comp); +static int stbi__psd_is16(stbi__context *s); +#endif + +#ifndef STBI_NO_HDR +static int stbi__hdr_test(stbi__context *s); +static float *stbi__hdr_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static int stbi__hdr_info(stbi__context *s, int *x, int *y, int *comp); +#endif + +#ifndef STBI_NO_PIC +static int stbi__pic_test(stbi__context *s); +static void *stbi__pic_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static int stbi__pic_info(stbi__context *s, int *x, int *y, int *comp); +#endif + +#ifndef STBI_NO_GIF +static int stbi__gif_test(stbi__context *s); +static void *stbi__gif_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static void *stbi__load_gif_main(stbi__context *s, int **delays, int *x, int *y, int *z, int *comp, int req_comp); +static int stbi__gif_info(stbi__context *s, int *x, int *y, int *comp); +#endif + +#ifndef STBI_NO_PNM +static int stbi__pnm_test(stbi__context *s); +static void *stbi__pnm_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri); +static int stbi__pnm_info(stbi__context *s, int *x, int *y, int *comp); +static int stbi__pnm_is16(stbi__context *s); +#endif + +static +#ifdef STBI_THREAD_LOCAL +STBI_THREAD_LOCAL +#endif +const char *stbi__g_failure_reason; + +STBIDEF const char *stbi_failure_reason(void) +{ + return stbi__g_failure_reason; +} + +#ifndef STBI_NO_FAILURE_STRINGS +static int stbi__err(const char *str) +{ + stbi__g_failure_reason = str; + return 0; +} +#endif + +static void *stbi__malloc(size_t size) +{ + return STBI_MALLOC(size); +} + +// stb_image uses ints pervasively, including for offset calculations. +// therefore the largest decoded image size we can support with the +// current code, even on 64-bit targets, is INT_MAX. this is not a +// significant limitation for the intended use case. +// +// we do, however, need to make sure our size calculations don't +// overflow. hence a few helper functions for size calculations that +// multiply integers together, making sure that they're non-negative +// and no overflow occurs. + +// return 1 if the sum is valid, 0 on overflow. +// negative terms are considered invalid. +static int stbi__addsizes_valid(int a, int b) +{ + if (b < 0) return 0; + // now 0 <= b <= INT_MAX, hence also + // 0 <= INT_MAX - b <= INTMAX. + // And "a + b <= INT_MAX" (which might overflow) is the + // same as a <= INT_MAX - b (no overflow) + return a <= INT_MAX - b; +} + +// returns 1 if the product is valid, 0 on overflow. +// negative factors are considered invalid. +static int stbi__mul2sizes_valid(int a, int b) +{ + if (a < 0 || b < 0) return 0; + if (b == 0) return 1; // mul-by-0 is always safe + // portable way to check for no overflows in a*b + return a <= INT_MAX/b; +} + +#if !defined(STBI_NO_JPEG) || !defined(STBI_NO_PNG) || !defined(STBI_NO_TGA) || !defined(STBI_NO_HDR) +// returns 1 if "a*b + add" has no negative terms/factors and doesn't overflow +static int stbi__mad2sizes_valid(int a, int b, int add) +{ + return stbi__mul2sizes_valid(a, b) && stbi__addsizes_valid(a*b, add); +} +#endif + +// returns 1 if "a*b*c + add" has no negative terms/factors and doesn't overflow +static int stbi__mad3sizes_valid(int a, int b, int c, int add) +{ + return stbi__mul2sizes_valid(a, b) && stbi__mul2sizes_valid(a*b, c) && + stbi__addsizes_valid(a*b*c, add); +} + +// returns 1 if "a*b*c*d + add" has no negative terms/factors and doesn't overflow +#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR) || !defined(STBI_NO_PNM) +static int stbi__mad4sizes_valid(int a, int b, int c, int d, int add) +{ + return stbi__mul2sizes_valid(a, b) && stbi__mul2sizes_valid(a*b, c) && + stbi__mul2sizes_valid(a*b*c, d) && stbi__addsizes_valid(a*b*c*d, add); +} +#endif + +#if !defined(STBI_NO_JPEG) || !defined(STBI_NO_PNG) || !defined(STBI_NO_TGA) || !defined(STBI_NO_HDR) +// mallocs with size overflow checking +static void *stbi__malloc_mad2(int a, int b, int add) +{ + if (!stbi__mad2sizes_valid(a, b, add)) return NULL; + return stbi__malloc(a*b + add); +} +#endif + +static void *stbi__malloc_mad3(int a, int b, int c, int add) +{ + if (!stbi__mad3sizes_valid(a, b, c, add)) return NULL; + return stbi__malloc(a*b*c + add); +} + +#if !defined(STBI_NO_LINEAR) || !defined(STBI_NO_HDR) || !defined(STBI_NO_PNM) +static void *stbi__malloc_mad4(int a, int b, int c, int d, int add) +{ + if (!stbi__mad4sizes_valid(a, b, c, d, add)) return NULL; + return stbi__malloc(a*b*c*d + add); +} +#endif + +// returns 1 if the sum of two signed ints is valid (between -2^31 and 2^31-1 inclusive), 0 on overflow. +static int stbi__addints_valid(int a, int b) +{ + if ((a >= 0) != (b >= 0)) return 1; // a and b have different signs, so no overflow + if (a < 0 && b < 0) return a >= INT_MIN - b; // same as a + b >= INT_MIN; INT_MIN - b cannot overflow since b < 0. + return a <= INT_MAX - b; +} + +// returns 1 if the product of two signed shorts is valid, 0 on overflow. +static int stbi__mul2shorts_valid(short a, short b) +{ + if (b == 0 || b == -1) return 1; // multiplication by 0 is always 0; check for -1 so SHRT_MIN/b doesn't overflow + if ((a >= 0) == (b >= 0)) return a <= SHRT_MAX/b; // product is positive, so similar to mul2sizes_valid + if (b < 0) return a <= SHRT_MIN / b; // same as a * b >= SHRT_MIN + return a >= SHRT_MIN / b; +} + +// stbi__err - error +// stbi__errpf - error returning pointer to float +// stbi__errpuc - error returning pointer to unsigned char + +#ifdef STBI_NO_FAILURE_STRINGS + #define stbi__err(x,y) 0 +#elif defined(STBI_FAILURE_USERMSG) + #define stbi__err(x,y) stbi__err(y) +#else + #define stbi__err(x,y) stbi__err(x) +#endif + +#define stbi__errpf(x,y) ((float *)(size_t) (stbi__err(x,y)?NULL:NULL)) +#define stbi__errpuc(x,y) ((unsigned char *)(size_t) (stbi__err(x,y)?NULL:NULL)) + +STBIDEF void stbi_image_free(void *retval_from_stbi_load) +{ + STBI_FREE(retval_from_stbi_load); +} + +#ifndef STBI_NO_LINEAR +static float *stbi__ldr_to_hdr(stbi_uc *data, int x, int y, int comp); +#endif + +#ifndef STBI_NO_HDR +static stbi_uc *stbi__hdr_to_ldr(float *data, int x, int y, int comp); +#endif + +static int stbi__vertically_flip_on_load_global = 0; + +STBIDEF void stbi_set_flip_vertically_on_load(int flag_true_if_should_flip) +{ + stbi__vertically_flip_on_load_global = flag_true_if_should_flip; +} + +#ifndef STBI_THREAD_LOCAL +#define stbi__vertically_flip_on_load stbi__vertically_flip_on_load_global +#else +static STBI_THREAD_LOCAL int stbi__vertically_flip_on_load_local, stbi__vertically_flip_on_load_set; + +STBIDEF void stbi_set_flip_vertically_on_load_thread(int flag_true_if_should_flip) +{ + stbi__vertically_flip_on_load_local = flag_true_if_should_flip; + stbi__vertically_flip_on_load_set = 1; +} + +#define stbi__vertically_flip_on_load (stbi__vertically_flip_on_load_set \ + ? stbi__vertically_flip_on_load_local \ + : stbi__vertically_flip_on_load_global) +#endif // STBI_THREAD_LOCAL + +static void *stbi__load_main(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri, int bpc) +{ + memset(ri, 0, sizeof(*ri)); // make sure it's initialized if we add new fields + ri->bits_per_channel = 8; // default is 8 so most paths don't have to be changed + ri->channel_order = STBI_ORDER_RGB; // all current input & output are this, but this is here so we can add BGR order + ri->num_channels = 0; + + // test the formats with a very explicit header first (at least a FOURCC + // or distinctive magic number first) + #ifndef STBI_NO_PNG + if (stbi__png_test(s)) return stbi__png_load(s,x,y,comp,req_comp, ri); + #endif + #ifndef STBI_NO_BMP + if (stbi__bmp_test(s)) return stbi__bmp_load(s,x,y,comp,req_comp, ri); + #endif + #ifndef STBI_NO_GIF + if (stbi__gif_test(s)) return stbi__gif_load(s,x,y,comp,req_comp, ri); + #endif + #ifndef STBI_NO_PSD + if (stbi__psd_test(s)) return stbi__psd_load(s,x,y,comp,req_comp, ri, bpc); + #else + STBI_NOTUSED(bpc); + #endif + #ifndef STBI_NO_PIC + if (stbi__pic_test(s)) return stbi__pic_load(s,x,y,comp,req_comp, ri); + #endif + + // then the formats that can end up attempting to load with just 1 or 2 + // bytes matching expectations; these are prone to false positives, so + // try them later + #ifndef STBI_NO_JPEG + if (stbi__jpeg_test(s)) return stbi__jpeg_load(s,x,y,comp,req_comp, ri); + #endif + #ifndef STBI_NO_PNM + if (stbi__pnm_test(s)) return stbi__pnm_load(s,x,y,comp,req_comp, ri); + #endif + + #ifndef STBI_NO_HDR + if (stbi__hdr_test(s)) { + float *hdr = stbi__hdr_load(s, x,y,comp,req_comp, ri); + return stbi__hdr_to_ldr(hdr, *x, *y, req_comp ? req_comp : *comp); + } + #endif + + #ifndef STBI_NO_TGA + // test tga last because it's a crappy test! + if (stbi__tga_test(s)) + return stbi__tga_load(s,x,y,comp,req_comp, ri); + #endif + + return stbi__errpuc("unknown image type", "Image not of any known type, or corrupt"); +} + +static stbi_uc *stbi__convert_16_to_8(stbi__uint16 *orig, int w, int h, int channels) +{ + int i; + int img_len = w * h * channels; + stbi_uc *reduced; + + reduced = (stbi_uc *) stbi__malloc(img_len); + if (reduced == NULL) return stbi__errpuc("outofmem", "Out of memory"); + + for (i = 0; i < img_len; ++i) + reduced[i] = (stbi_uc)((orig[i] >> 8) & 0xFF); // top half of each byte is sufficient approx of 16->8 bit scaling + + STBI_FREE(orig); + return reduced; +} + +static stbi__uint16 *stbi__convert_8_to_16(stbi_uc *orig, int w, int h, int channels) +{ + int i; + int img_len = w * h * channels; + stbi__uint16 *enlarged; + + enlarged = (stbi__uint16 *) stbi__malloc(img_len*2); + if (enlarged == NULL) return (stbi__uint16 *) stbi__errpuc("outofmem", "Out of memory"); + + for (i = 0; i < img_len; ++i) + enlarged[i] = (stbi__uint16)((orig[i] << 8) + orig[i]); // replicate to high and low byte, maps 0->0, 255->0xffff + + STBI_FREE(orig); + return enlarged; +} + +static void stbi__vertical_flip(void *image, int w, int h, int bytes_per_pixel) +{ + int row; + size_t bytes_per_row = (size_t)w * bytes_per_pixel; + stbi_uc temp[2048]; + stbi_uc *bytes = (stbi_uc *)image; + + for (row = 0; row < (h>>1); row++) { + stbi_uc *row0 = bytes + row*bytes_per_row; + stbi_uc *row1 = bytes + (h - row - 1)*bytes_per_row; + // swap row0 with row1 + size_t bytes_left = bytes_per_row; + while (bytes_left) { + size_t bytes_copy = (bytes_left < sizeof(temp)) ? bytes_left : sizeof(temp); + memcpy(temp, row0, bytes_copy); + memcpy(row0, row1, bytes_copy); + memcpy(row1, temp, bytes_copy); + row0 += bytes_copy; + row1 += bytes_copy; + bytes_left -= bytes_copy; + } + } +} + +#ifndef STBI_NO_GIF +static void stbi__vertical_flip_slices(void *image, int w, int h, int z, int bytes_per_pixel) +{ + int slice; + int slice_size = w * h * bytes_per_pixel; + + stbi_uc *bytes = (stbi_uc *)image; + for (slice = 0; slice < z; ++slice) { + stbi__vertical_flip(bytes, w, h, bytes_per_pixel); + bytes += slice_size; + } +} +#endif + +static unsigned char *stbi__load_and_postprocess_8bit(stbi__context *s, int *x, int *y, int *comp, int req_comp) +{ + stbi__result_info ri; + void *result = stbi__load_main(s, x, y, comp, req_comp, &ri, 8); + + if (result == NULL) + return NULL; + + // it is the responsibility of the loaders to make sure we get either 8 or 16 bit. + STBI_ASSERT(ri.bits_per_channel == 8 || ri.bits_per_channel == 16); + + if (ri.bits_per_channel != 8) { + result = stbi__convert_16_to_8((stbi__uint16 *) result, *x, *y, req_comp == 0 ? *comp : req_comp); + ri.bits_per_channel = 8; + } + + // @TODO: move stbi__convert_format to here + + if (stbi__vertically_flip_on_load) { + int channels = req_comp ? req_comp : *comp; + stbi__vertical_flip(result, *x, *y, channels * sizeof(stbi_uc)); + } + + return (unsigned char *) result; +} + +static stbi__uint16 *stbi__load_and_postprocess_16bit(stbi__context *s, int *x, int *y, int *comp, int req_comp) +{ + stbi__result_info ri; + void *result = stbi__load_main(s, x, y, comp, req_comp, &ri, 16); + + if (result == NULL) + return NULL; + + // it is the responsibility of the loaders to make sure we get either 8 or 16 bit. + STBI_ASSERT(ri.bits_per_channel == 8 || ri.bits_per_channel == 16); + + if (ri.bits_per_channel != 16) { + result = stbi__convert_8_to_16((stbi_uc *) result, *x, *y, req_comp == 0 ? *comp : req_comp); + ri.bits_per_channel = 16; + } + + // @TODO: move stbi__convert_format16 to here + // @TODO: special case RGB-to-Y (and RGBA-to-YA) for 8-bit-to-16-bit case to keep more precision + + if (stbi__vertically_flip_on_load) { + int channels = req_comp ? req_comp : *comp; + stbi__vertical_flip(result, *x, *y, channels * sizeof(stbi__uint16)); + } + + return (stbi__uint16 *) result; +} + +#if !defined(STBI_NO_HDR) && !defined(STBI_NO_LINEAR) +static void stbi__float_postprocess(float *result, int *x, int *y, int *comp, int req_comp) +{ + if (stbi__vertically_flip_on_load && result != NULL) { + int channels = req_comp ? req_comp : *comp; + stbi__vertical_flip(result, *x, *y, channels * sizeof(float)); + } +} +#endif + +#ifndef STBI_NO_STDIO + +#if defined(_WIN32) && defined(STBI_WINDOWS_UTF8) +STBI_EXTERN __declspec(dllimport) int __stdcall MultiByteToWideChar(unsigned int cp, unsigned long flags, const char *str, int cbmb, wchar_t *widestr, int cchwide); +STBI_EXTERN __declspec(dllimport) int __stdcall WideCharToMultiByte(unsigned int cp, unsigned long flags, const wchar_t *widestr, int cchwide, char *str, int cbmb, const char *defchar, int *used_default); +#endif + +#if defined(_WIN32) && defined(STBI_WINDOWS_UTF8) +STBIDEF int stbi_convert_wchar_to_utf8(char *buffer, size_t bufferlen, const wchar_t* input) +{ + return WideCharToMultiByte(65001 /* UTF8 */, 0, input, -1, buffer, (int) bufferlen, NULL, NULL); +} +#endif + +static FILE *stbi__fopen(char const *filename, char const *mode) +{ + FILE *f; +#if defined(_WIN32) && defined(STBI_WINDOWS_UTF8) + wchar_t wMode[64]; + wchar_t wFilename[1024]; + if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, filename, -1, wFilename, sizeof(wFilename)/sizeof(*wFilename))) + return 0; + + if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, mode, -1, wMode, sizeof(wMode)/sizeof(*wMode))) + return 0; + +#if defined(_MSC_VER) && _MSC_VER >= 1400 + if (0 != _wfopen_s(&f, wFilename, wMode)) + f = 0; +#else + f = _wfopen(wFilename, wMode); +#endif + +#elif defined(_MSC_VER) && _MSC_VER >= 1400 + if (0 != fopen_s(&f, filename, mode)) + f=0; +#else + f = fopen(filename, mode); +#endif + return f; +} + + +STBIDEF stbi_uc *stbi_load(char const *filename, int *x, int *y, int *comp, int req_comp) +{ + FILE *f = stbi__fopen(filename, "rb"); + unsigned char *result; + if (!f) return stbi__errpuc("can't fopen", "Unable to open file"); + result = stbi_load_from_file(f,x,y,comp,req_comp); + fclose(f); + return result; +} + +STBIDEF stbi_uc *stbi_load_from_file(FILE *f, int *x, int *y, int *comp, int req_comp) +{ + unsigned char *result; + stbi__context s; + stbi__start_file(&s,f); + result = stbi__load_and_postprocess_8bit(&s,x,y,comp,req_comp); + if (result) { + // need to 'unget' all the characters in the IO buffer + fseek(f, - (int) (s.img_buffer_end - s.img_buffer), SEEK_CUR); + } + return result; +} + +STBIDEF stbi__uint16 *stbi_load_from_file_16(FILE *f, int *x, int *y, int *comp, int req_comp) +{ + stbi__uint16 *result; + stbi__context s; + stbi__start_file(&s,f); + result = stbi__load_and_postprocess_16bit(&s,x,y,comp,req_comp); + if (result) { + // need to 'unget' all the characters in the IO buffer + fseek(f, - (int) (s.img_buffer_end - s.img_buffer), SEEK_CUR); + } + return result; +} + +STBIDEF stbi_us *stbi_load_16(char const *filename, int *x, int *y, int *comp, int req_comp) +{ + FILE *f = stbi__fopen(filename, "rb"); + stbi__uint16 *result; + if (!f) return (stbi_us *) stbi__errpuc("can't fopen", "Unable to open file"); + result = stbi_load_from_file_16(f,x,y,comp,req_comp); + fclose(f); + return result; +} + + +#endif //!STBI_NO_STDIO + +STBIDEF stbi_us *stbi_load_16_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *channels_in_file, int desired_channels) +{ + stbi__context s; + stbi__start_mem(&s,buffer,len); + return stbi__load_and_postprocess_16bit(&s,x,y,channels_in_file,desired_channels); +} + +STBIDEF stbi_us *stbi_load_16_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *channels_in_file, int desired_channels) +{ + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks *)clbk, user); + return stbi__load_and_postprocess_16bit(&s,x,y,channels_in_file,desired_channels); +} + +STBIDEF stbi_uc *stbi_load_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp, int req_comp) +{ + stbi__context s; + stbi__start_mem(&s,buffer,len); + return stbi__load_and_postprocess_8bit(&s,x,y,comp,req_comp); +} + +STBIDEF stbi_uc *stbi_load_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *comp, int req_comp) +{ + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks *) clbk, user); + return stbi__load_and_postprocess_8bit(&s,x,y,comp,req_comp); +} + +#ifndef STBI_NO_GIF +STBIDEF stbi_uc *stbi_load_gif_from_memory(stbi_uc const *buffer, int len, int **delays, int *x, int *y, int *z, int *comp, int req_comp) +{ + unsigned char *result; + stbi__context s; + stbi__start_mem(&s,buffer,len); + + result = (unsigned char*) stbi__load_gif_main(&s, delays, x, y, z, comp, req_comp); + if (stbi__vertically_flip_on_load) { + stbi__vertical_flip_slices( result, *x, *y, *z, *comp ); + } + + return result; +} +#endif + +#ifndef STBI_NO_LINEAR +static float *stbi__loadf_main(stbi__context *s, int *x, int *y, int *comp, int req_comp) +{ + unsigned char *data; + #ifndef STBI_NO_HDR + if (stbi__hdr_test(s)) { + stbi__result_info ri; + float *hdr_data = stbi__hdr_load(s,x,y,comp,req_comp, &ri); + if (hdr_data) + stbi__float_postprocess(hdr_data,x,y,comp,req_comp); + return hdr_data; + } + #endif + data = stbi__load_and_postprocess_8bit(s, x, y, comp, req_comp); + if (data) + return stbi__ldr_to_hdr(data, *x, *y, req_comp ? req_comp : *comp); + return stbi__errpf("unknown image type", "Image not of any known type, or corrupt"); +} + +STBIDEF float *stbi_loadf_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp, int req_comp) +{ + stbi__context s; + stbi__start_mem(&s,buffer,len); + return stbi__loadf_main(&s,x,y,comp,req_comp); +} + +STBIDEF float *stbi_loadf_from_callbacks(stbi_io_callbacks const *clbk, void *user, int *x, int *y, int *comp, int req_comp) +{ + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks *) clbk, user); + return stbi__loadf_main(&s,x,y,comp,req_comp); +} + +#ifndef STBI_NO_STDIO +STBIDEF float *stbi_loadf(char const *filename, int *x, int *y, int *comp, int req_comp) +{ + float *result; + FILE *f = stbi__fopen(filename, "rb"); + if (!f) return stbi__errpf("can't fopen", "Unable to open file"); + result = stbi_loadf_from_file(f,x,y,comp,req_comp); + fclose(f); + return result; +} + +STBIDEF float *stbi_loadf_from_file(FILE *f, int *x, int *y, int *comp, int req_comp) +{ + stbi__context s; + stbi__start_file(&s,f); + return stbi__loadf_main(&s,x,y,comp,req_comp); +} +#endif // !STBI_NO_STDIO + +#endif // !STBI_NO_LINEAR + +// these is-hdr-or-not is defined independent of whether STBI_NO_LINEAR is +// defined, for API simplicity; if STBI_NO_LINEAR is defined, it always +// reports false! + +STBIDEF int stbi_is_hdr_from_memory(stbi_uc const *buffer, int len) +{ + #ifndef STBI_NO_HDR + stbi__context s; + stbi__start_mem(&s,buffer,len); + return stbi__hdr_test(&s); + #else + STBI_NOTUSED(buffer); + STBI_NOTUSED(len); + return 0; + #endif +} + +#ifndef STBI_NO_STDIO +STBIDEF int stbi_is_hdr (char const *filename) +{ + FILE *f = stbi__fopen(filename, "rb"); + int result=0; + if (f) { + result = stbi_is_hdr_from_file(f); + fclose(f); + } + return result; +} + +STBIDEF int stbi_is_hdr_from_file(FILE *f) +{ + #ifndef STBI_NO_HDR + long pos = ftell(f); + int res; + stbi__context s; + stbi__start_file(&s,f); + res = stbi__hdr_test(&s); + fseek(f, pos, SEEK_SET); + return res; + #else + STBI_NOTUSED(f); + return 0; + #endif +} +#endif // !STBI_NO_STDIO + +STBIDEF int stbi_is_hdr_from_callbacks(stbi_io_callbacks const *clbk, void *user) +{ + #ifndef STBI_NO_HDR + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks *) clbk, user); + return stbi__hdr_test(&s); + #else + STBI_NOTUSED(clbk); + STBI_NOTUSED(user); + return 0; + #endif +} + +#ifndef STBI_NO_LINEAR +static float stbi__l2h_gamma=2.2f, stbi__l2h_scale=1.0f; + +STBIDEF void stbi_ldr_to_hdr_gamma(float gamma) { stbi__l2h_gamma = gamma; } +STBIDEF void stbi_ldr_to_hdr_scale(float scale) { stbi__l2h_scale = scale; } +#endif + +static float stbi__h2l_gamma_i=1.0f/2.2f, stbi__h2l_scale_i=1.0f; + +STBIDEF void stbi_hdr_to_ldr_gamma(float gamma) { stbi__h2l_gamma_i = 1/gamma; } +STBIDEF void stbi_hdr_to_ldr_scale(float scale) { stbi__h2l_scale_i = 1/scale; } + + +////////////////////////////////////////////////////////////////////////////// +// +// Common code used by all image loaders +// + +enum +{ + STBI__SCAN_load=0, + STBI__SCAN_type, + STBI__SCAN_header +}; + +static void stbi__refill_buffer(stbi__context *s) +{ + int n = (s->io.read)(s->io_user_data,(char*)s->buffer_start,s->buflen); + s->callback_already_read += (int) (s->img_buffer - s->img_buffer_original); + if (n == 0) { + // at end of file, treat same as if from memory, but need to handle case + // where s->img_buffer isn't pointing to safe memory, e.g. 0-byte file + s->read_from_callbacks = 0; + s->img_buffer = s->buffer_start; + s->img_buffer_end = s->buffer_start+1; + *s->img_buffer = 0; + } else { + s->img_buffer = s->buffer_start; + s->img_buffer_end = s->buffer_start + n; + } +} + +stbi_inline static stbi_uc stbi__get8(stbi__context *s) +{ + if (s->img_buffer < s->img_buffer_end) + return *s->img_buffer++; + if (s->read_from_callbacks) { + stbi__refill_buffer(s); + return *s->img_buffer++; + } + return 0; +} + +#if defined(STBI_NO_JPEG) && defined(STBI_NO_HDR) && defined(STBI_NO_PIC) && defined(STBI_NO_PNM) +// nothing +#else +stbi_inline static int stbi__at_eof(stbi__context *s) +{ + if (s->io.read) { + if (!(s->io.eof)(s->io_user_data)) return 0; + // if feof() is true, check if buffer = end + // special case: we've only got the special 0 character at the end + if (s->read_from_callbacks == 0) return 1; + } + + return s->img_buffer >= s->img_buffer_end; +} +#endif + +#if defined(STBI_NO_JPEG) && defined(STBI_NO_PNG) && defined(STBI_NO_BMP) && defined(STBI_NO_PSD) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) && defined(STBI_NO_PIC) +// nothing +#else +static void stbi__skip(stbi__context *s, int n) +{ + if (n == 0) return; // already there! + if (n < 0) { + s->img_buffer = s->img_buffer_end; + return; + } + if (s->io.read) { + int blen = (int) (s->img_buffer_end - s->img_buffer); + if (blen < n) { + s->img_buffer = s->img_buffer_end; + (s->io.skip)(s->io_user_data, n - blen); + return; + } + } + s->img_buffer += n; +} +#endif + +#if defined(STBI_NO_PNG) && defined(STBI_NO_TGA) && defined(STBI_NO_HDR) && defined(STBI_NO_PNM) +// nothing +#else +static int stbi__getn(stbi__context *s, stbi_uc *buffer, int n) +{ + if (s->io.read) { + int blen = (int) (s->img_buffer_end - s->img_buffer); + if (blen < n) { + int res, count; + + memcpy(buffer, s->img_buffer, blen); + + count = (s->io.read)(s->io_user_data, (char*) buffer + blen, n - blen); + res = (count == (n-blen)); + s->img_buffer = s->img_buffer_end; + return res; + } + } + + if (s->img_buffer+n <= s->img_buffer_end) { + memcpy(buffer, s->img_buffer, n); + s->img_buffer += n; + return 1; + } else + return 0; +} +#endif + +#if defined(STBI_NO_JPEG) && defined(STBI_NO_PNG) && defined(STBI_NO_PSD) && defined(STBI_NO_PIC) +// nothing +#else +static int stbi__get16be(stbi__context *s) +{ + int z = stbi__get8(s); + return (z << 8) + stbi__get8(s); +} +#endif + +#if defined(STBI_NO_PNG) && defined(STBI_NO_PSD) && defined(STBI_NO_PIC) +// nothing +#else +static stbi__uint32 stbi__get32be(stbi__context *s) +{ + stbi__uint32 z = stbi__get16be(s); + return (z << 16) + stbi__get16be(s); +} +#endif + +#if defined(STBI_NO_BMP) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) +// nothing +#else +static int stbi__get16le(stbi__context *s) +{ + int z = stbi__get8(s); + return z + (stbi__get8(s) << 8); +} +#endif + +#ifndef STBI_NO_BMP +static stbi__uint32 stbi__get32le(stbi__context *s) +{ + stbi__uint32 z = stbi__get16le(s); + z += (stbi__uint32)stbi__get16le(s) << 16; + return z; +} +#endif + +#define STBI__BYTECAST(x) ((stbi_uc) ((x) & 255)) // truncate int to byte without warnings + +#if defined(STBI_NO_JPEG) && defined(STBI_NO_PNG) && defined(STBI_NO_BMP) && defined(STBI_NO_PSD) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) && defined(STBI_NO_PIC) && defined(STBI_NO_PNM) +// nothing +#else +////////////////////////////////////////////////////////////////////////////// +// +// generic converter from built-in img_n to req_comp +// individual types do this automatically as much as possible (e.g. jpeg +// does all cases internally since it needs to colorspace convert anyway, +// and it never has alpha, so very few cases ). png can automatically +// interleave an alpha=255 channel, but falls back to this for other cases +// +// assume data buffer is malloced, so malloc a new one and free that one +// only failure mode is malloc failing + +static stbi_uc stbi__compute_y(int r, int g, int b) +{ + return (stbi_uc) (((r*77) + (g*150) + (29*b)) >> 8); +} +#endif + +#if defined(STBI_NO_PNG) && defined(STBI_NO_BMP) && defined(STBI_NO_PSD) && defined(STBI_NO_TGA) && defined(STBI_NO_GIF) && defined(STBI_NO_PIC) && defined(STBI_NO_PNM) +// nothing +#else +static unsigned char *stbi__convert_format(unsigned char *data, int img_n, int req_comp, unsigned int x, unsigned int y) +{ + int i,j; + unsigned char *good; + + if (req_comp == img_n) return data; + STBI_ASSERT(req_comp >= 1 && req_comp <= 4); + + good = (unsigned char *) stbi__malloc_mad3(req_comp, x, y, 0); + if (good == NULL) { + STBI_FREE(data); + return stbi__errpuc("outofmem", "Out of memory"); + } + + for (j=0; j < (int) y; ++j) { + unsigned char *src = data + j * x * img_n ; + unsigned char *dest = good + j * x * req_comp; + + #define STBI__COMBO(a,b) ((a)*8+(b)) + #define STBI__CASE(a,b) case STBI__COMBO(a,b): for(i=x-1; i >= 0; --i, src += a, dest += b) + // convert source image with img_n components to one with req_comp components; + // avoid switch per pixel, so use switch per scanline and massive macros + switch (STBI__COMBO(img_n, req_comp)) { + STBI__CASE(1,2) { dest[0]=src[0]; dest[1]=255; } break; + STBI__CASE(1,3) { dest[0]=dest[1]=dest[2]=src[0]; } break; + STBI__CASE(1,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=255; } break; + STBI__CASE(2,1) { dest[0]=src[0]; } break; + STBI__CASE(2,3) { dest[0]=dest[1]=dest[2]=src[0]; } break; + STBI__CASE(2,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=src[1]; } break; + STBI__CASE(3,4) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2];dest[3]=255; } break; + STBI__CASE(3,1) { dest[0]=stbi__compute_y(src[0],src[1],src[2]); } break; + STBI__CASE(3,2) { dest[0]=stbi__compute_y(src[0],src[1],src[2]); dest[1] = 255; } break; + STBI__CASE(4,1) { dest[0]=stbi__compute_y(src[0],src[1],src[2]); } break; + STBI__CASE(4,2) { dest[0]=stbi__compute_y(src[0],src[1],src[2]); dest[1] = src[3]; } break; + STBI__CASE(4,3) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2]; } break; + default: STBI_ASSERT(0); STBI_FREE(data); STBI_FREE(good); return stbi__errpuc("unsupported", "Unsupported format conversion"); + } + #undef STBI__CASE + } + + STBI_FREE(data); + return good; +} +#endif + +#if defined(STBI_NO_PNG) && defined(STBI_NO_PSD) +// nothing +#else +static stbi__uint16 stbi__compute_y_16(int r, int g, int b) +{ + return (stbi__uint16) (((r*77) + (g*150) + (29*b)) >> 8); +} +#endif + +#if defined(STBI_NO_PNG) && defined(STBI_NO_PSD) +// nothing +#else +static stbi__uint16 *stbi__convert_format16(stbi__uint16 *data, int img_n, int req_comp, unsigned int x, unsigned int y) +{ + int i,j; + stbi__uint16 *good; + + if (req_comp == img_n) return data; + STBI_ASSERT(req_comp >= 1 && req_comp <= 4); + + good = (stbi__uint16 *) stbi__malloc(req_comp * x * y * 2); + if (good == NULL) { + STBI_FREE(data); + return (stbi__uint16 *) stbi__errpuc("outofmem", "Out of memory"); + } + + for (j=0; j < (int) y; ++j) { + stbi__uint16 *src = data + j * x * img_n ; + stbi__uint16 *dest = good + j * x * req_comp; + + #define STBI__COMBO(a,b) ((a)*8+(b)) + #define STBI__CASE(a,b) case STBI__COMBO(a,b): for(i=x-1; i >= 0; --i, src += a, dest += b) + // convert source image with img_n components to one with req_comp components; + // avoid switch per pixel, so use switch per scanline and massive macros + switch (STBI__COMBO(img_n, req_comp)) { + STBI__CASE(1,2) { dest[0]=src[0]; dest[1]=0xffff; } break; + STBI__CASE(1,3) { dest[0]=dest[1]=dest[2]=src[0]; } break; + STBI__CASE(1,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=0xffff; } break; + STBI__CASE(2,1) { dest[0]=src[0]; } break; + STBI__CASE(2,3) { dest[0]=dest[1]=dest[2]=src[0]; } break; + STBI__CASE(2,4) { dest[0]=dest[1]=dest[2]=src[0]; dest[3]=src[1]; } break; + STBI__CASE(3,4) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2];dest[3]=0xffff; } break; + STBI__CASE(3,1) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]); } break; + STBI__CASE(3,2) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]); dest[1] = 0xffff; } break; + STBI__CASE(4,1) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]); } break; + STBI__CASE(4,2) { dest[0]=stbi__compute_y_16(src[0],src[1],src[2]); dest[1] = src[3]; } break; + STBI__CASE(4,3) { dest[0]=src[0];dest[1]=src[1];dest[2]=src[2]; } break; + default: STBI_ASSERT(0); STBI_FREE(data); STBI_FREE(good); return (stbi__uint16*) stbi__errpuc("unsupported", "Unsupported format conversion"); + } + #undef STBI__CASE + } + + STBI_FREE(data); + return good; +} +#endif + +#ifndef STBI_NO_LINEAR +static float *stbi__ldr_to_hdr(stbi_uc *data, int x, int y, int comp) +{ + int i,k,n; + float *output; + if (!data) return NULL; + output = (float *) stbi__malloc_mad4(x, y, comp, sizeof(float), 0); + if (output == NULL) { STBI_FREE(data); return stbi__errpf("outofmem", "Out of memory"); } + // compute number of non-alpha components + if (comp & 1) n = comp; else n = comp-1; + for (i=0; i < x*y; ++i) { + for (k=0; k < n; ++k) { + output[i*comp + k] = (float) (pow(data[i*comp+k]/255.0f, stbi__l2h_gamma) * stbi__l2h_scale); + } + } + if (n < comp) { + for (i=0; i < x*y; ++i) { + output[i*comp + n] = data[i*comp + n]/255.0f; + } + } + STBI_FREE(data); + return output; +} +#endif + +#ifndef STBI_NO_HDR +#define stbi__float2int(x) ((int) (x)) +static stbi_uc *stbi__hdr_to_ldr(float *data, int x, int y, int comp) +{ + int i,k,n; + stbi_uc *output; + if (!data) return NULL; + output = (stbi_uc *) stbi__malloc_mad3(x, y, comp, 0); + if (output == NULL) { STBI_FREE(data); return stbi__errpuc("outofmem", "Out of memory"); } + // compute number of non-alpha components + if (comp & 1) n = comp; else n = comp-1; + for (i=0; i < x*y; ++i) { + for (k=0; k < n; ++k) { + float z = (float) pow(data[i*comp+k]*stbi__h2l_scale_i, stbi__h2l_gamma_i) * 255 + 0.5f; + if (z < 0) z = 0; + if (z > 255) z = 255; + output[i*comp + k] = (stbi_uc) stbi__float2int(z); + } + if (k < comp) { + float z = data[i*comp+k] * 255 + 0.5f; + if (z < 0) z = 0; + if (z > 255) z = 255; + output[i*comp + k] = (stbi_uc) stbi__float2int(z); + } + } + STBI_FREE(data); + return output; +} +#endif + +////////////////////////////////////////////////////////////////////////////// +// +// "baseline" JPEG/JFIF decoder +// +// simple implementation +// - doesn't support delayed output of y-dimension +// - simple interface (only one output format: 8-bit interleaved RGB) +// - doesn't try to recover corrupt jpegs +// - doesn't allow partial loading, loading multiple at once +// - still fast on x86 (copying globals into locals doesn't help x86) +// - allocates lots of intermediate memory (full size of all components) +// - non-interleaved case requires this anyway +// - allows good upsampling (see next) +// high-quality +// - upsampled channels are bilinearly interpolated, even across blocks +// - quality integer IDCT derived from IJG's 'slow' +// performance +// - fast huffman; reasonable integer IDCT +// - some SIMD kernels for common paths on targets with SSE2/NEON +// - uses a lot of intermediate memory, could cache poorly + +#ifndef STBI_NO_JPEG + +// huffman decoding acceleration +#define FAST_BITS 9 // larger handles more cases; smaller stomps less cache + +typedef struct +{ + stbi_uc fast[1 << FAST_BITS]; + // weirdly, repacking this into AoS is a 10% speed loss, instead of a win + stbi__uint16 code[256]; + stbi_uc values[256]; + stbi_uc size[257]; + unsigned int maxcode[18]; + int delta[17]; // old 'firstsymbol' - old 'firstcode' +} stbi__huffman; + +typedef struct +{ + stbi__context *s; + stbi__huffman huff_dc[4]; + stbi__huffman huff_ac[4]; + stbi__uint16 dequant[4][64]; + stbi__int16 fast_ac[4][1 << FAST_BITS]; + +// sizes for components, interleaved MCUs + int img_h_max, img_v_max; + int img_mcu_x, img_mcu_y; + int img_mcu_w, img_mcu_h; + +// definition of jpeg image component + struct + { + int id; + int h,v; + int tq; + int hd,ha; + int dc_pred; + + int x,y,w2,h2; + stbi_uc *data; + void *raw_data, *raw_coeff; + stbi_uc *linebuf; + short *coeff; // progressive only + int coeff_w, coeff_h; // number of 8x8 coefficient blocks + } img_comp[4]; + + stbi__uint32 code_buffer; // jpeg entropy-coded buffer + int code_bits; // number of valid bits + unsigned char marker; // marker seen while filling entropy buffer + int nomore; // flag if we saw a marker so must stop + + int progressive; + int spec_start; + int spec_end; + int succ_high; + int succ_low; + int eob_run; + int jfif; + int app14_color_transform; // Adobe APP14 tag + int rgb; + + int scan_n, order[4]; + int restart_interval, todo; + +// kernels + void (*idct_block_kernel)(stbi_uc *out, int out_stride, short data[64]); + void (*YCbCr_to_RGB_kernel)(stbi_uc *out, const stbi_uc *y, const stbi_uc *pcb, const stbi_uc *pcr, int count, int step); + stbi_uc *(*resample_row_hv_2_kernel)(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs); +} stbi__jpeg; + +static int stbi__build_huffman(stbi__huffman *h, int *count) +{ + int i,j,k=0; + unsigned int code; + // build size list for each symbol (from JPEG spec) + for (i=0; i < 16; ++i) { + for (j=0; j < count[i]; ++j) { + h->size[k++] = (stbi_uc) (i+1); + if(k >= 257) return stbi__err("bad size list","Corrupt JPEG"); + } + } + h->size[k] = 0; + + // compute actual symbols (from jpeg spec) + code = 0; + k = 0; + for(j=1; j <= 16; ++j) { + // compute delta to add to code to compute symbol id + h->delta[j] = k - code; + if (h->size[k] == j) { + while (h->size[k] == j) + h->code[k++] = (stbi__uint16) (code++); + if (code-1 >= (1u << j)) return stbi__err("bad code lengths","Corrupt JPEG"); + } + // compute largest code + 1 for this size, preshifted as needed later + h->maxcode[j] = code << (16-j); + code <<= 1; + } + h->maxcode[j] = 0xffffffff; + + // build non-spec acceleration table; 255 is flag for not-accelerated + memset(h->fast, 255, 1 << FAST_BITS); + for (i=0; i < k; ++i) { + int s = h->size[i]; + if (s <= FAST_BITS) { + int c = h->code[i] << (FAST_BITS-s); + int m = 1 << (FAST_BITS-s); + for (j=0; j < m; ++j) { + h->fast[c+j] = (stbi_uc) i; + } + } + } + return 1; +} + +// build a table that decodes both magnitude and value of small ACs in +// one go. +static void stbi__build_fast_ac(stbi__int16 *fast_ac, stbi__huffman *h) +{ + int i; + for (i=0; i < (1 << FAST_BITS); ++i) { + stbi_uc fast = h->fast[i]; + fast_ac[i] = 0; + if (fast < 255) { + int rs = h->values[fast]; + int run = (rs >> 4) & 15; + int magbits = rs & 15; + int len = h->size[fast]; + + if (magbits && len + magbits <= FAST_BITS) { + // magnitude code followed by receive_extend code + int k = ((i << len) & ((1 << FAST_BITS) - 1)) >> (FAST_BITS - magbits); + int m = 1 << (magbits - 1); + if (k < m) k += (~0U << magbits) + 1; + // if the result is small enough, we can fit it in fast_ac table + if (k >= -128 && k <= 127) + fast_ac[i] = (stbi__int16) ((k * 256) + (run * 16) + (len + magbits)); + } + } + } +} + +static void stbi__grow_buffer_unsafe(stbi__jpeg *j) +{ + do { + unsigned int b = j->nomore ? 0 : stbi__get8(j->s); + if (b == 0xff) { + int c = stbi__get8(j->s); + while (c == 0xff) c = stbi__get8(j->s); // consume fill bytes + if (c != 0) { + j->marker = (unsigned char) c; + j->nomore = 1; + return; + } + } + j->code_buffer |= b << (24 - j->code_bits); + j->code_bits += 8; + } while (j->code_bits <= 24); +} + +// (1 << n) - 1 +static const stbi__uint32 stbi__bmask[17]={0,1,3,7,15,31,63,127,255,511,1023,2047,4095,8191,16383,32767,65535}; + +// decode a jpeg huffman value from the bitstream +stbi_inline static int stbi__jpeg_huff_decode(stbi__jpeg *j, stbi__huffman *h) +{ + unsigned int temp; + int c,k; + + if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); + + // look at the top FAST_BITS and determine what symbol ID it is, + // if the code is <= FAST_BITS + c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS)-1); + k = h->fast[c]; + if (k < 255) { + int s = h->size[k]; + if (s > j->code_bits) + return -1; + j->code_buffer <<= s; + j->code_bits -= s; + return h->values[k]; + } + + // naive test is to shift the code_buffer down so k bits are + // valid, then test against maxcode. To speed this up, we've + // preshifted maxcode left so that it has (16-k) 0s at the + // end; in other words, regardless of the number of bits, it + // wants to be compared against something shifted to have 16; + // that way we don't need to shift inside the loop. + temp = j->code_buffer >> 16; + for (k=FAST_BITS+1 ; ; ++k) + if (temp < h->maxcode[k]) + break; + if (k == 17) { + // error! code not found + j->code_bits -= 16; + return -1; + } + + if (k > j->code_bits) + return -1; + + // convert the huffman code to the symbol id + c = ((j->code_buffer >> (32 - k)) & stbi__bmask[k]) + h->delta[k]; + if(c < 0 || c >= 256) // symbol id out of bounds! + return -1; + STBI_ASSERT((((j->code_buffer) >> (32 - h->size[c])) & stbi__bmask[h->size[c]]) == h->code[c]); + + // convert the id to a symbol + j->code_bits -= k; + j->code_buffer <<= k; + return h->values[c]; +} + +// bias[n] = (-1<code_bits < n) stbi__grow_buffer_unsafe(j); + if (j->code_bits < n) return 0; // ran out of bits from stream, return 0s intead of continuing + + sgn = j->code_buffer >> 31; // sign bit always in MSB; 0 if MSB clear (positive), 1 if MSB set (negative) + k = stbi_lrot(j->code_buffer, n); + j->code_buffer = k & ~stbi__bmask[n]; + k &= stbi__bmask[n]; + j->code_bits -= n; + return k + (stbi__jbias[n] & (sgn - 1)); +} + +// get some unsigned bits +stbi_inline static int stbi__jpeg_get_bits(stbi__jpeg *j, int n) +{ + unsigned int k; + if (j->code_bits < n) stbi__grow_buffer_unsafe(j); + if (j->code_bits < n) return 0; // ran out of bits from stream, return 0s intead of continuing + k = stbi_lrot(j->code_buffer, n); + j->code_buffer = k & ~stbi__bmask[n]; + k &= stbi__bmask[n]; + j->code_bits -= n; + return k; +} + +stbi_inline static int stbi__jpeg_get_bit(stbi__jpeg *j) +{ + unsigned int k; + if (j->code_bits < 1) stbi__grow_buffer_unsafe(j); + if (j->code_bits < 1) return 0; // ran out of bits from stream, return 0s intead of continuing + k = j->code_buffer; + j->code_buffer <<= 1; + --j->code_bits; + return k & 0x80000000; +} + +// given a value that's at position X in the zigzag stream, +// where does it appear in the 8x8 matrix coded as row-major? +static const stbi_uc stbi__jpeg_dezigzag[64+15] = +{ + 0, 1, 8, 16, 9, 2, 3, 10, + 17, 24, 32, 25, 18, 11, 4, 5, + 12, 19, 26, 33, 40, 48, 41, 34, + 27, 20, 13, 6, 7, 14, 21, 28, + 35, 42, 49, 56, 57, 50, 43, 36, + 29, 22, 15, 23, 30, 37, 44, 51, + 58, 59, 52, 45, 38, 31, 39, 46, + 53, 60, 61, 54, 47, 55, 62, 63, + // let corrupt input sample past end + 63, 63, 63, 63, 63, 63, 63, 63, + 63, 63, 63, 63, 63, 63, 63 +}; + +// decode one 64-entry block-- +static int stbi__jpeg_decode_block(stbi__jpeg *j, short data[64], stbi__huffman *hdc, stbi__huffman *hac, stbi__int16 *fac, int b, stbi__uint16 *dequant) +{ + int diff,dc,k; + int t; + + if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); + t = stbi__jpeg_huff_decode(j, hdc); + if (t < 0 || t > 15) return stbi__err("bad huffman code","Corrupt JPEG"); + + // 0 all the ac values now so we can do it 32-bits at a time + memset(data,0,64*sizeof(data[0])); + + diff = t ? stbi__extend_receive(j, t) : 0; + if (!stbi__addints_valid(j->img_comp[b].dc_pred, diff)) return stbi__err("bad delta","Corrupt JPEG"); + dc = j->img_comp[b].dc_pred + diff; + j->img_comp[b].dc_pred = dc; + if (!stbi__mul2shorts_valid(dc, dequant[0])) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + data[0] = (short) (dc * dequant[0]); + + // decode AC components, see JPEG spec + k = 1; + do { + unsigned int zig; + int c,r,s; + if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); + c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS)-1); + r = fac[c]; + if (r) { // fast-AC path + k += (r >> 4) & 15; // run + s = r & 15; // combined length + if (s > j->code_bits) return stbi__err("bad huffman code", "Combined length longer than code bits available"); + j->code_buffer <<= s; + j->code_bits -= s; + // decode into unzigzag'd location + zig = stbi__jpeg_dezigzag[k++]; + data[zig] = (short) ((r >> 8) * dequant[zig]); + } else { + int rs = stbi__jpeg_huff_decode(j, hac); + if (rs < 0) return stbi__err("bad huffman code","Corrupt JPEG"); + s = rs & 15; + r = rs >> 4; + if (s == 0) { + if (rs != 0xf0) break; // end block + k += 16; + } else { + k += r; + // decode into unzigzag'd location + zig = stbi__jpeg_dezigzag[k++]; + data[zig] = (short) (stbi__extend_receive(j,s) * dequant[zig]); + } + } + } while (k < 64); + return 1; +} + +static int stbi__jpeg_decode_block_prog_dc(stbi__jpeg *j, short data[64], stbi__huffman *hdc, int b) +{ + int diff,dc; + int t; + if (j->spec_end != 0) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + + if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); + + if (j->succ_high == 0) { + // first scan for DC coefficient, must be first + memset(data,0,64*sizeof(data[0])); // 0 all the ac values now + t = stbi__jpeg_huff_decode(j, hdc); + if (t < 0 || t > 15) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + diff = t ? stbi__extend_receive(j, t) : 0; + + if (!stbi__addints_valid(j->img_comp[b].dc_pred, diff)) return stbi__err("bad delta", "Corrupt JPEG"); + dc = j->img_comp[b].dc_pred + diff; + j->img_comp[b].dc_pred = dc; + if (!stbi__mul2shorts_valid(dc, 1 << j->succ_low)) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + data[0] = (short) (dc * (1 << j->succ_low)); + } else { + // refinement scan for DC coefficient + if (stbi__jpeg_get_bit(j)) + data[0] += (short) (1 << j->succ_low); + } + return 1; +} + +// @OPTIMIZE: store non-zigzagged during the decode passes, +// and only de-zigzag when dequantizing +static int stbi__jpeg_decode_block_prog_ac(stbi__jpeg *j, short data[64], stbi__huffman *hac, stbi__int16 *fac) +{ + int k; + if (j->spec_start == 0) return stbi__err("can't merge dc and ac", "Corrupt JPEG"); + + if (j->succ_high == 0) { + int shift = j->succ_low; + + if (j->eob_run) { + --j->eob_run; + return 1; + } + + k = j->spec_start; + do { + unsigned int zig; + int c,r,s; + if (j->code_bits < 16) stbi__grow_buffer_unsafe(j); + c = (j->code_buffer >> (32 - FAST_BITS)) & ((1 << FAST_BITS)-1); + r = fac[c]; + if (r) { // fast-AC path + k += (r >> 4) & 15; // run + s = r & 15; // combined length + if (s > j->code_bits) return stbi__err("bad huffman code", "Combined length longer than code bits available"); + j->code_buffer <<= s; + j->code_bits -= s; + zig = stbi__jpeg_dezigzag[k++]; + data[zig] = (short) ((r >> 8) * (1 << shift)); + } else { + int rs = stbi__jpeg_huff_decode(j, hac); + if (rs < 0) return stbi__err("bad huffman code","Corrupt JPEG"); + s = rs & 15; + r = rs >> 4; + if (s == 0) { + if (r < 15) { + j->eob_run = (1 << r); + if (r) + j->eob_run += stbi__jpeg_get_bits(j, r); + --j->eob_run; + break; + } + k += 16; + } else { + k += r; + zig = stbi__jpeg_dezigzag[k++]; + data[zig] = (short) (stbi__extend_receive(j,s) * (1 << shift)); + } + } + } while (k <= j->spec_end); + } else { + // refinement scan for these AC coefficients + + short bit = (short) (1 << j->succ_low); + + if (j->eob_run) { + --j->eob_run; + for (k = j->spec_start; k <= j->spec_end; ++k) { + short *p = &data[stbi__jpeg_dezigzag[k]]; + if (*p != 0) + if (stbi__jpeg_get_bit(j)) + if ((*p & bit)==0) { + if (*p > 0) + *p += bit; + else + *p -= bit; + } + } + } else { + k = j->spec_start; + do { + int r,s; + int rs = stbi__jpeg_huff_decode(j, hac); // @OPTIMIZE see if we can use the fast path here, advance-by-r is so slow, eh + if (rs < 0) return stbi__err("bad huffman code","Corrupt JPEG"); + s = rs & 15; + r = rs >> 4; + if (s == 0) { + if (r < 15) { + j->eob_run = (1 << r) - 1; + if (r) + j->eob_run += stbi__jpeg_get_bits(j, r); + r = 64; // force end of block + } else { + // r=15 s=0 should write 16 0s, so we just do + // a run of 15 0s and then write s (which is 0), + // so we don't have to do anything special here + } + } else { + if (s != 1) return stbi__err("bad huffman code", "Corrupt JPEG"); + // sign bit + if (stbi__jpeg_get_bit(j)) + s = bit; + else + s = -bit; + } + + // advance by r + while (k <= j->spec_end) { + short *p = &data[stbi__jpeg_dezigzag[k++]]; + if (*p != 0) { + if (stbi__jpeg_get_bit(j)) + if ((*p & bit)==0) { + if (*p > 0) + *p += bit; + else + *p -= bit; + } + } else { + if (r == 0) { + *p = (short) s; + break; + } + --r; + } + } + } while (k <= j->spec_end); + } + } + return 1; +} + +// take a -128..127 value and stbi__clamp it and convert to 0..255 +stbi_inline static stbi_uc stbi__clamp(int x) +{ + // trick to use a single test to catch both cases + if ((unsigned int) x > 255) { + if (x < 0) return 0; + if (x > 255) return 255; + } + return (stbi_uc) x; +} + +#define stbi__f2f(x) ((int) (((x) * 4096 + 0.5))) +#define stbi__fsh(x) ((x) * 4096) + +// derived from jidctint -- DCT_ISLOW +#define STBI__IDCT_1D(s0,s1,s2,s3,s4,s5,s6,s7) \ + int t0,t1,t2,t3,p1,p2,p3,p4,p5,x0,x1,x2,x3; \ + p2 = s2; \ + p3 = s6; \ + p1 = (p2+p3) * stbi__f2f(0.5411961f); \ + t2 = p1 + p3*stbi__f2f(-1.847759065f); \ + t3 = p1 + p2*stbi__f2f( 0.765366865f); \ + p2 = s0; \ + p3 = s4; \ + t0 = stbi__fsh(p2+p3); \ + t1 = stbi__fsh(p2-p3); \ + x0 = t0+t3; \ + x3 = t0-t3; \ + x1 = t1+t2; \ + x2 = t1-t2; \ + t0 = s7; \ + t1 = s5; \ + t2 = s3; \ + t3 = s1; \ + p3 = t0+t2; \ + p4 = t1+t3; \ + p1 = t0+t3; \ + p2 = t1+t2; \ + p5 = (p3+p4)*stbi__f2f( 1.175875602f); \ + t0 = t0*stbi__f2f( 0.298631336f); \ + t1 = t1*stbi__f2f( 2.053119869f); \ + t2 = t2*stbi__f2f( 3.072711026f); \ + t3 = t3*stbi__f2f( 1.501321110f); \ + p1 = p5 + p1*stbi__f2f(-0.899976223f); \ + p2 = p5 + p2*stbi__f2f(-2.562915447f); \ + p3 = p3*stbi__f2f(-1.961570560f); \ + p4 = p4*stbi__f2f(-0.390180644f); \ + t3 += p1+p4; \ + t2 += p2+p3; \ + t1 += p2+p4; \ + t0 += p1+p3; + +static void stbi__idct_block(stbi_uc *out, int out_stride, short data[64]) +{ + int i,val[64],*v=val; + stbi_uc *o; + short *d = data; + + // columns + for (i=0; i < 8; ++i,++d, ++v) { + // if all zeroes, shortcut -- this avoids dequantizing 0s and IDCTing + if (d[ 8]==0 && d[16]==0 && d[24]==0 && d[32]==0 + && d[40]==0 && d[48]==0 && d[56]==0) { + // no shortcut 0 seconds + // (1|2|3|4|5|6|7)==0 0 seconds + // all separate -0.047 seconds + // 1 && 2|3 && 4|5 && 6|7: -0.047 seconds + int dcterm = d[0]*4; + v[0] = v[8] = v[16] = v[24] = v[32] = v[40] = v[48] = v[56] = dcterm; + } else { + STBI__IDCT_1D(d[ 0],d[ 8],d[16],d[24],d[32],d[40],d[48],d[56]) + // constants scaled things up by 1<<12; let's bring them back + // down, but keep 2 extra bits of precision + x0 += 512; x1 += 512; x2 += 512; x3 += 512; + v[ 0] = (x0+t3) >> 10; + v[56] = (x0-t3) >> 10; + v[ 8] = (x1+t2) >> 10; + v[48] = (x1-t2) >> 10; + v[16] = (x2+t1) >> 10; + v[40] = (x2-t1) >> 10; + v[24] = (x3+t0) >> 10; + v[32] = (x3-t0) >> 10; + } + } + + for (i=0, v=val, o=out; i < 8; ++i,v+=8,o+=out_stride) { + // no fast case since the first 1D IDCT spread components out + STBI__IDCT_1D(v[0],v[1],v[2],v[3],v[4],v[5],v[6],v[7]) + // constants scaled things up by 1<<12, plus we had 1<<2 from first + // loop, plus horizontal and vertical each scale by sqrt(8) so together + // we've got an extra 1<<3, so 1<<17 total we need to remove. + // so we want to round that, which means adding 0.5 * 1<<17, + // aka 65536. Also, we'll end up with -128 to 127 that we want + // to encode as 0..255 by adding 128, so we'll add that before the shift + x0 += 65536 + (128<<17); + x1 += 65536 + (128<<17); + x2 += 65536 + (128<<17); + x3 += 65536 + (128<<17); + // tried computing the shifts into temps, or'ing the temps to see + // if any were out of range, but that was slower + o[0] = stbi__clamp((x0+t3) >> 17); + o[7] = stbi__clamp((x0-t3) >> 17); + o[1] = stbi__clamp((x1+t2) >> 17); + o[6] = stbi__clamp((x1-t2) >> 17); + o[2] = stbi__clamp((x2+t1) >> 17); + o[5] = stbi__clamp((x2-t1) >> 17); + o[3] = stbi__clamp((x3+t0) >> 17); + o[4] = stbi__clamp((x3-t0) >> 17); + } +} + +#ifdef STBI_SSE2 +// sse2 integer IDCT. not the fastest possible implementation but it +// produces bit-identical results to the generic C version so it's +// fully "transparent". +static void stbi__idct_simd(stbi_uc *out, int out_stride, short data[64]) +{ + // This is constructed to match our regular (generic) integer IDCT exactly. + __m128i row0, row1, row2, row3, row4, row5, row6, row7; + __m128i tmp; + + // dot product constant: even elems=x, odd elems=y + #define dct_const(x,y) _mm_setr_epi16((x),(y),(x),(y),(x),(y),(x),(y)) + + // out(0) = c0[even]*x + c0[odd]*y (c0, x, y 16-bit, out 32-bit) + // out(1) = c1[even]*x + c1[odd]*y + #define dct_rot(out0,out1, x,y,c0,c1) \ + __m128i c0##lo = _mm_unpacklo_epi16((x),(y)); \ + __m128i c0##hi = _mm_unpackhi_epi16((x),(y)); \ + __m128i out0##_l = _mm_madd_epi16(c0##lo, c0); \ + __m128i out0##_h = _mm_madd_epi16(c0##hi, c0); \ + __m128i out1##_l = _mm_madd_epi16(c0##lo, c1); \ + __m128i out1##_h = _mm_madd_epi16(c0##hi, c1) + + // out = in << 12 (in 16-bit, out 32-bit) + #define dct_widen(out, in) \ + __m128i out##_l = _mm_srai_epi32(_mm_unpacklo_epi16(_mm_setzero_si128(), (in)), 4); \ + __m128i out##_h = _mm_srai_epi32(_mm_unpackhi_epi16(_mm_setzero_si128(), (in)), 4) + + // wide add + #define dct_wadd(out, a, b) \ + __m128i out##_l = _mm_add_epi32(a##_l, b##_l); \ + __m128i out##_h = _mm_add_epi32(a##_h, b##_h) + + // wide sub + #define dct_wsub(out, a, b) \ + __m128i out##_l = _mm_sub_epi32(a##_l, b##_l); \ + __m128i out##_h = _mm_sub_epi32(a##_h, b##_h) + + // butterfly a/b, add bias, then shift by "s" and pack + #define dct_bfly32o(out0, out1, a,b,bias,s) \ + { \ + __m128i abiased_l = _mm_add_epi32(a##_l, bias); \ + __m128i abiased_h = _mm_add_epi32(a##_h, bias); \ + dct_wadd(sum, abiased, b); \ + dct_wsub(dif, abiased, b); \ + out0 = _mm_packs_epi32(_mm_srai_epi32(sum_l, s), _mm_srai_epi32(sum_h, s)); \ + out1 = _mm_packs_epi32(_mm_srai_epi32(dif_l, s), _mm_srai_epi32(dif_h, s)); \ + } + + // 8-bit interleave step (for transposes) + #define dct_interleave8(a, b) \ + tmp = a; \ + a = _mm_unpacklo_epi8(a, b); \ + b = _mm_unpackhi_epi8(tmp, b) + + // 16-bit interleave step (for transposes) + #define dct_interleave16(a, b) \ + tmp = a; \ + a = _mm_unpacklo_epi16(a, b); \ + b = _mm_unpackhi_epi16(tmp, b) + + #define dct_pass(bias,shift) \ + { \ + /* even part */ \ + dct_rot(t2e,t3e, row2,row6, rot0_0,rot0_1); \ + __m128i sum04 = _mm_add_epi16(row0, row4); \ + __m128i dif04 = _mm_sub_epi16(row0, row4); \ + dct_widen(t0e, sum04); \ + dct_widen(t1e, dif04); \ + dct_wadd(x0, t0e, t3e); \ + dct_wsub(x3, t0e, t3e); \ + dct_wadd(x1, t1e, t2e); \ + dct_wsub(x2, t1e, t2e); \ + /* odd part */ \ + dct_rot(y0o,y2o, row7,row3, rot2_0,rot2_1); \ + dct_rot(y1o,y3o, row5,row1, rot3_0,rot3_1); \ + __m128i sum17 = _mm_add_epi16(row1, row7); \ + __m128i sum35 = _mm_add_epi16(row3, row5); \ + dct_rot(y4o,y5o, sum17,sum35, rot1_0,rot1_1); \ + dct_wadd(x4, y0o, y4o); \ + dct_wadd(x5, y1o, y5o); \ + dct_wadd(x6, y2o, y5o); \ + dct_wadd(x7, y3o, y4o); \ + dct_bfly32o(row0,row7, x0,x7,bias,shift); \ + dct_bfly32o(row1,row6, x1,x6,bias,shift); \ + dct_bfly32o(row2,row5, x2,x5,bias,shift); \ + dct_bfly32o(row3,row4, x3,x4,bias,shift); \ + } + + __m128i rot0_0 = dct_const(stbi__f2f(0.5411961f), stbi__f2f(0.5411961f) + stbi__f2f(-1.847759065f)); + __m128i rot0_1 = dct_const(stbi__f2f(0.5411961f) + stbi__f2f( 0.765366865f), stbi__f2f(0.5411961f)); + __m128i rot1_0 = dct_const(stbi__f2f(1.175875602f) + stbi__f2f(-0.899976223f), stbi__f2f(1.175875602f)); + __m128i rot1_1 = dct_const(stbi__f2f(1.175875602f), stbi__f2f(1.175875602f) + stbi__f2f(-2.562915447f)); + __m128i rot2_0 = dct_const(stbi__f2f(-1.961570560f) + stbi__f2f( 0.298631336f), stbi__f2f(-1.961570560f)); + __m128i rot2_1 = dct_const(stbi__f2f(-1.961570560f), stbi__f2f(-1.961570560f) + stbi__f2f( 3.072711026f)); + __m128i rot3_0 = dct_const(stbi__f2f(-0.390180644f) + stbi__f2f( 2.053119869f), stbi__f2f(-0.390180644f)); + __m128i rot3_1 = dct_const(stbi__f2f(-0.390180644f), stbi__f2f(-0.390180644f) + stbi__f2f( 1.501321110f)); + + // rounding biases in column/row passes, see stbi__idct_block for explanation. + __m128i bias_0 = _mm_set1_epi32(512); + __m128i bias_1 = _mm_set1_epi32(65536 + (128<<17)); + + // load + row0 = _mm_load_si128((const __m128i *) (data + 0*8)); + row1 = _mm_load_si128((const __m128i *) (data + 1*8)); + row2 = _mm_load_si128((const __m128i *) (data + 2*8)); + row3 = _mm_load_si128((const __m128i *) (data + 3*8)); + row4 = _mm_load_si128((const __m128i *) (data + 4*8)); + row5 = _mm_load_si128((const __m128i *) (data + 5*8)); + row6 = _mm_load_si128((const __m128i *) (data + 6*8)); + row7 = _mm_load_si128((const __m128i *) (data + 7*8)); + + // column pass + dct_pass(bias_0, 10); + + { + // 16bit 8x8 transpose pass 1 + dct_interleave16(row0, row4); + dct_interleave16(row1, row5); + dct_interleave16(row2, row6); + dct_interleave16(row3, row7); + + // transpose pass 2 + dct_interleave16(row0, row2); + dct_interleave16(row1, row3); + dct_interleave16(row4, row6); + dct_interleave16(row5, row7); + + // transpose pass 3 + dct_interleave16(row0, row1); + dct_interleave16(row2, row3); + dct_interleave16(row4, row5); + dct_interleave16(row6, row7); + } + + // row pass + dct_pass(bias_1, 17); + + { + // pack + __m128i p0 = _mm_packus_epi16(row0, row1); // a0a1a2a3...a7b0b1b2b3...b7 + __m128i p1 = _mm_packus_epi16(row2, row3); + __m128i p2 = _mm_packus_epi16(row4, row5); + __m128i p3 = _mm_packus_epi16(row6, row7); + + // 8bit 8x8 transpose pass 1 + dct_interleave8(p0, p2); // a0e0a1e1... + dct_interleave8(p1, p3); // c0g0c1g1... + + // transpose pass 2 + dct_interleave8(p0, p1); // a0c0e0g0... + dct_interleave8(p2, p3); // b0d0f0h0... + + // transpose pass 3 + dct_interleave8(p0, p2); // a0b0c0d0... + dct_interleave8(p1, p3); // a4b4c4d4... + + // store + _mm_storel_epi64((__m128i *) out, p0); out += out_stride; + _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p0, 0x4e)); out += out_stride; + _mm_storel_epi64((__m128i *) out, p2); out += out_stride; + _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p2, 0x4e)); out += out_stride; + _mm_storel_epi64((__m128i *) out, p1); out += out_stride; + _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p1, 0x4e)); out += out_stride; + _mm_storel_epi64((__m128i *) out, p3); out += out_stride; + _mm_storel_epi64((__m128i *) out, _mm_shuffle_epi32(p3, 0x4e)); + } + +#undef dct_const +#undef dct_rot +#undef dct_widen +#undef dct_wadd +#undef dct_wsub +#undef dct_bfly32o +#undef dct_interleave8 +#undef dct_interleave16 +#undef dct_pass +} + +#endif // STBI_SSE2 + +#ifdef STBI_NEON + +// NEON integer IDCT. should produce bit-identical +// results to the generic C version. +static void stbi__idct_simd(stbi_uc *out, int out_stride, short data[64]) +{ + int16x8_t row0, row1, row2, row3, row4, row5, row6, row7; + + int16x4_t rot0_0 = vdup_n_s16(stbi__f2f(0.5411961f)); + int16x4_t rot0_1 = vdup_n_s16(stbi__f2f(-1.847759065f)); + int16x4_t rot0_2 = vdup_n_s16(stbi__f2f( 0.765366865f)); + int16x4_t rot1_0 = vdup_n_s16(stbi__f2f( 1.175875602f)); + int16x4_t rot1_1 = vdup_n_s16(stbi__f2f(-0.899976223f)); + int16x4_t rot1_2 = vdup_n_s16(stbi__f2f(-2.562915447f)); + int16x4_t rot2_0 = vdup_n_s16(stbi__f2f(-1.961570560f)); + int16x4_t rot2_1 = vdup_n_s16(stbi__f2f(-0.390180644f)); + int16x4_t rot3_0 = vdup_n_s16(stbi__f2f( 0.298631336f)); + int16x4_t rot3_1 = vdup_n_s16(stbi__f2f( 2.053119869f)); + int16x4_t rot3_2 = vdup_n_s16(stbi__f2f( 3.072711026f)); + int16x4_t rot3_3 = vdup_n_s16(stbi__f2f( 1.501321110f)); + +#define dct_long_mul(out, inq, coeff) \ + int32x4_t out##_l = vmull_s16(vget_low_s16(inq), coeff); \ + int32x4_t out##_h = vmull_s16(vget_high_s16(inq), coeff) + +#define dct_long_mac(out, acc, inq, coeff) \ + int32x4_t out##_l = vmlal_s16(acc##_l, vget_low_s16(inq), coeff); \ + int32x4_t out##_h = vmlal_s16(acc##_h, vget_high_s16(inq), coeff) + +#define dct_widen(out, inq) \ + int32x4_t out##_l = vshll_n_s16(vget_low_s16(inq), 12); \ + int32x4_t out##_h = vshll_n_s16(vget_high_s16(inq), 12) + +// wide add +#define dct_wadd(out, a, b) \ + int32x4_t out##_l = vaddq_s32(a##_l, b##_l); \ + int32x4_t out##_h = vaddq_s32(a##_h, b##_h) + +// wide sub +#define dct_wsub(out, a, b) \ + int32x4_t out##_l = vsubq_s32(a##_l, b##_l); \ + int32x4_t out##_h = vsubq_s32(a##_h, b##_h) + +// butterfly a/b, then shift using "shiftop" by "s" and pack +#define dct_bfly32o(out0,out1, a,b,shiftop,s) \ + { \ + dct_wadd(sum, a, b); \ + dct_wsub(dif, a, b); \ + out0 = vcombine_s16(shiftop(sum_l, s), shiftop(sum_h, s)); \ + out1 = vcombine_s16(shiftop(dif_l, s), shiftop(dif_h, s)); \ + } + +#define dct_pass(shiftop, shift) \ + { \ + /* even part */ \ + int16x8_t sum26 = vaddq_s16(row2, row6); \ + dct_long_mul(p1e, sum26, rot0_0); \ + dct_long_mac(t2e, p1e, row6, rot0_1); \ + dct_long_mac(t3e, p1e, row2, rot0_2); \ + int16x8_t sum04 = vaddq_s16(row0, row4); \ + int16x8_t dif04 = vsubq_s16(row0, row4); \ + dct_widen(t0e, sum04); \ + dct_widen(t1e, dif04); \ + dct_wadd(x0, t0e, t3e); \ + dct_wsub(x3, t0e, t3e); \ + dct_wadd(x1, t1e, t2e); \ + dct_wsub(x2, t1e, t2e); \ + /* odd part */ \ + int16x8_t sum15 = vaddq_s16(row1, row5); \ + int16x8_t sum17 = vaddq_s16(row1, row7); \ + int16x8_t sum35 = vaddq_s16(row3, row5); \ + int16x8_t sum37 = vaddq_s16(row3, row7); \ + int16x8_t sumodd = vaddq_s16(sum17, sum35); \ + dct_long_mul(p5o, sumodd, rot1_0); \ + dct_long_mac(p1o, p5o, sum17, rot1_1); \ + dct_long_mac(p2o, p5o, sum35, rot1_2); \ + dct_long_mul(p3o, sum37, rot2_0); \ + dct_long_mul(p4o, sum15, rot2_1); \ + dct_wadd(sump13o, p1o, p3o); \ + dct_wadd(sump24o, p2o, p4o); \ + dct_wadd(sump23o, p2o, p3o); \ + dct_wadd(sump14o, p1o, p4o); \ + dct_long_mac(x4, sump13o, row7, rot3_0); \ + dct_long_mac(x5, sump24o, row5, rot3_1); \ + dct_long_mac(x6, sump23o, row3, rot3_2); \ + dct_long_mac(x7, sump14o, row1, rot3_3); \ + dct_bfly32o(row0,row7, x0,x7,shiftop,shift); \ + dct_bfly32o(row1,row6, x1,x6,shiftop,shift); \ + dct_bfly32o(row2,row5, x2,x5,shiftop,shift); \ + dct_bfly32o(row3,row4, x3,x4,shiftop,shift); \ + } + + // load + row0 = vld1q_s16(data + 0*8); + row1 = vld1q_s16(data + 1*8); + row2 = vld1q_s16(data + 2*8); + row3 = vld1q_s16(data + 3*8); + row4 = vld1q_s16(data + 4*8); + row5 = vld1q_s16(data + 5*8); + row6 = vld1q_s16(data + 6*8); + row7 = vld1q_s16(data + 7*8); + + // add DC bias + row0 = vaddq_s16(row0, vsetq_lane_s16(1024, vdupq_n_s16(0), 0)); + + // column pass + dct_pass(vrshrn_n_s32, 10); + + // 16bit 8x8 transpose + { +// these three map to a single VTRN.16, VTRN.32, and VSWP, respectively. +// whether compilers actually get this is another story, sadly. +#define dct_trn16(x, y) { int16x8x2_t t = vtrnq_s16(x, y); x = t.val[0]; y = t.val[1]; } +#define dct_trn32(x, y) { int32x4x2_t t = vtrnq_s32(vreinterpretq_s32_s16(x), vreinterpretq_s32_s16(y)); x = vreinterpretq_s16_s32(t.val[0]); y = vreinterpretq_s16_s32(t.val[1]); } +#define dct_trn64(x, y) { int16x8_t x0 = x; int16x8_t y0 = y; x = vcombine_s16(vget_low_s16(x0), vget_low_s16(y0)); y = vcombine_s16(vget_high_s16(x0), vget_high_s16(y0)); } + + // pass 1 + dct_trn16(row0, row1); // a0b0a2b2a4b4a6b6 + dct_trn16(row2, row3); + dct_trn16(row4, row5); + dct_trn16(row6, row7); + + // pass 2 + dct_trn32(row0, row2); // a0b0c0d0a4b4c4d4 + dct_trn32(row1, row3); + dct_trn32(row4, row6); + dct_trn32(row5, row7); + + // pass 3 + dct_trn64(row0, row4); // a0b0c0d0e0f0g0h0 + dct_trn64(row1, row5); + dct_trn64(row2, row6); + dct_trn64(row3, row7); + +#undef dct_trn16 +#undef dct_trn32 +#undef dct_trn64 + } + + // row pass + // vrshrn_n_s32 only supports shifts up to 16, we need + // 17. so do a non-rounding shift of 16 first then follow + // up with a rounding shift by 1. + dct_pass(vshrn_n_s32, 16); + + { + // pack and round + uint8x8_t p0 = vqrshrun_n_s16(row0, 1); + uint8x8_t p1 = vqrshrun_n_s16(row1, 1); + uint8x8_t p2 = vqrshrun_n_s16(row2, 1); + uint8x8_t p3 = vqrshrun_n_s16(row3, 1); + uint8x8_t p4 = vqrshrun_n_s16(row4, 1); + uint8x8_t p5 = vqrshrun_n_s16(row5, 1); + uint8x8_t p6 = vqrshrun_n_s16(row6, 1); + uint8x8_t p7 = vqrshrun_n_s16(row7, 1); + + // again, these can translate into one instruction, but often don't. +#define dct_trn8_8(x, y) { uint8x8x2_t t = vtrn_u8(x, y); x = t.val[0]; y = t.val[1]; } +#define dct_trn8_16(x, y) { uint16x4x2_t t = vtrn_u16(vreinterpret_u16_u8(x), vreinterpret_u16_u8(y)); x = vreinterpret_u8_u16(t.val[0]); y = vreinterpret_u8_u16(t.val[1]); } +#define dct_trn8_32(x, y) { uint32x2x2_t t = vtrn_u32(vreinterpret_u32_u8(x), vreinterpret_u32_u8(y)); x = vreinterpret_u8_u32(t.val[0]); y = vreinterpret_u8_u32(t.val[1]); } + + // sadly can't use interleaved stores here since we only write + // 8 bytes to each scan line! + + // 8x8 8-bit transpose pass 1 + dct_trn8_8(p0, p1); + dct_trn8_8(p2, p3); + dct_trn8_8(p4, p5); + dct_trn8_8(p6, p7); + + // pass 2 + dct_trn8_16(p0, p2); + dct_trn8_16(p1, p3); + dct_trn8_16(p4, p6); + dct_trn8_16(p5, p7); + + // pass 3 + dct_trn8_32(p0, p4); + dct_trn8_32(p1, p5); + dct_trn8_32(p2, p6); + dct_trn8_32(p3, p7); + + // store + vst1_u8(out, p0); out += out_stride; + vst1_u8(out, p1); out += out_stride; + vst1_u8(out, p2); out += out_stride; + vst1_u8(out, p3); out += out_stride; + vst1_u8(out, p4); out += out_stride; + vst1_u8(out, p5); out += out_stride; + vst1_u8(out, p6); out += out_stride; + vst1_u8(out, p7); + +#undef dct_trn8_8 +#undef dct_trn8_16 +#undef dct_trn8_32 + } + +#undef dct_long_mul +#undef dct_long_mac +#undef dct_widen +#undef dct_wadd +#undef dct_wsub +#undef dct_bfly32o +#undef dct_pass +} + +#endif // STBI_NEON + +#define STBI__MARKER_none 0xff +// if there's a pending marker from the entropy stream, return that +// otherwise, fetch from the stream and get a marker. if there's no +// marker, return 0xff, which is never a valid marker value +static stbi_uc stbi__get_marker(stbi__jpeg *j) +{ + stbi_uc x; + if (j->marker != STBI__MARKER_none) { x = j->marker; j->marker = STBI__MARKER_none; return x; } + x = stbi__get8(j->s); + if (x != 0xff) return STBI__MARKER_none; + while (x == 0xff) + x = stbi__get8(j->s); // consume repeated 0xff fill bytes + return x; +} + +// in each scan, we'll have scan_n components, and the order +// of the components is specified by order[] +#define STBI__RESTART(x) ((x) >= 0xd0 && (x) <= 0xd7) + +// after a restart interval, stbi__jpeg_reset the entropy decoder and +// the dc prediction +static void stbi__jpeg_reset(stbi__jpeg *j) +{ + j->code_bits = 0; + j->code_buffer = 0; + j->nomore = 0; + j->img_comp[0].dc_pred = j->img_comp[1].dc_pred = j->img_comp[2].dc_pred = j->img_comp[3].dc_pred = 0; + j->marker = STBI__MARKER_none; + j->todo = j->restart_interval ? j->restart_interval : 0x7fffffff; + j->eob_run = 0; + // no more than 1<<31 MCUs if no restart_interal? that's plenty safe, + // since we don't even allow 1<<30 pixels +} + +static int stbi__parse_entropy_coded_data(stbi__jpeg *z) +{ + stbi__jpeg_reset(z); + if (!z->progressive) { + if (z->scan_n == 1) { + int i,j; + STBI_SIMD_ALIGN(short, data[64]); + int n = z->order[0]; + // non-interleaved data, we just need to process one block at a time, + // in trivial scanline order + // number of blocks to do just depends on how many actual "pixels" this + // component has, independent of interleaved MCU blocking and such + int w = (z->img_comp[n].x+7) >> 3; + int h = (z->img_comp[n].y+7) >> 3; + for (j=0; j < h; ++j) { + for (i=0; i < w; ++i) { + int ha = z->img_comp[n].ha; + if (!stbi__jpeg_decode_block(z, data, z->huff_dc+z->img_comp[n].hd, z->huff_ac+ha, z->fast_ac[ha], n, z->dequant[z->img_comp[n].tq])) return 0; + z->idct_block_kernel(z->img_comp[n].data+z->img_comp[n].w2*j*8+i*8, z->img_comp[n].w2, data); + // every data block is an MCU, so countdown the restart interval + if (--z->todo <= 0) { + if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); + // if it's NOT a restart, then just bail, so we get corrupt data + // rather than no data + if (!STBI__RESTART(z->marker)) return 1; + stbi__jpeg_reset(z); + } + } + } + return 1; + } else { // interleaved + int i,j,k,x,y; + STBI_SIMD_ALIGN(short, data[64]); + for (j=0; j < z->img_mcu_y; ++j) { + for (i=0; i < z->img_mcu_x; ++i) { + // scan an interleaved mcu... process scan_n components in order + for (k=0; k < z->scan_n; ++k) { + int n = z->order[k]; + // scan out an mcu's worth of this component; that's just determined + // by the basic H and V specified for the component + for (y=0; y < z->img_comp[n].v; ++y) { + for (x=0; x < z->img_comp[n].h; ++x) { + int x2 = (i*z->img_comp[n].h + x)*8; + int y2 = (j*z->img_comp[n].v + y)*8; + int ha = z->img_comp[n].ha; + if (!stbi__jpeg_decode_block(z, data, z->huff_dc+z->img_comp[n].hd, z->huff_ac+ha, z->fast_ac[ha], n, z->dequant[z->img_comp[n].tq])) return 0; + z->idct_block_kernel(z->img_comp[n].data+z->img_comp[n].w2*y2+x2, z->img_comp[n].w2, data); + } + } + } + // after all interleaved components, that's an interleaved MCU, + // so now count down the restart interval + if (--z->todo <= 0) { + if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); + if (!STBI__RESTART(z->marker)) return 1; + stbi__jpeg_reset(z); + } + } + } + return 1; + } + } else { + if (z->scan_n == 1) { + int i,j; + int n = z->order[0]; + // non-interleaved data, we just need to process one block at a time, + // in trivial scanline order + // number of blocks to do just depends on how many actual "pixels" this + // component has, independent of interleaved MCU blocking and such + int w = (z->img_comp[n].x+7) >> 3; + int h = (z->img_comp[n].y+7) >> 3; + for (j=0; j < h; ++j) { + for (i=0; i < w; ++i) { + short *data = z->img_comp[n].coeff + 64 * (i + j * z->img_comp[n].coeff_w); + if (z->spec_start == 0) { + if (!stbi__jpeg_decode_block_prog_dc(z, data, &z->huff_dc[z->img_comp[n].hd], n)) + return 0; + } else { + int ha = z->img_comp[n].ha; + if (!stbi__jpeg_decode_block_prog_ac(z, data, &z->huff_ac[ha], z->fast_ac[ha])) + return 0; + } + // every data block is an MCU, so countdown the restart interval + if (--z->todo <= 0) { + if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); + if (!STBI__RESTART(z->marker)) return 1; + stbi__jpeg_reset(z); + } + } + } + return 1; + } else { // interleaved + int i,j,k,x,y; + for (j=0; j < z->img_mcu_y; ++j) { + for (i=0; i < z->img_mcu_x; ++i) { + // scan an interleaved mcu... process scan_n components in order + for (k=0; k < z->scan_n; ++k) { + int n = z->order[k]; + // scan out an mcu's worth of this component; that's just determined + // by the basic H and V specified for the component + for (y=0; y < z->img_comp[n].v; ++y) { + for (x=0; x < z->img_comp[n].h; ++x) { + int x2 = (i*z->img_comp[n].h + x); + int y2 = (j*z->img_comp[n].v + y); + short *data = z->img_comp[n].coeff + 64 * (x2 + y2 * z->img_comp[n].coeff_w); + if (!stbi__jpeg_decode_block_prog_dc(z, data, &z->huff_dc[z->img_comp[n].hd], n)) + return 0; + } + } + } + // after all interleaved components, that's an interleaved MCU, + // so now count down the restart interval + if (--z->todo <= 0) { + if (z->code_bits < 24) stbi__grow_buffer_unsafe(z); + if (!STBI__RESTART(z->marker)) return 1; + stbi__jpeg_reset(z); + } + } + } + return 1; + } + } +} + +static void stbi__jpeg_dequantize(short *data, stbi__uint16 *dequant) +{ + int i; + for (i=0; i < 64; ++i) + data[i] *= dequant[i]; +} + +static void stbi__jpeg_finish(stbi__jpeg *z) +{ + if (z->progressive) { + // dequantize and idct the data + int i,j,n; + for (n=0; n < z->s->img_n; ++n) { + int w = (z->img_comp[n].x+7) >> 3; + int h = (z->img_comp[n].y+7) >> 3; + for (j=0; j < h; ++j) { + for (i=0; i < w; ++i) { + short *data = z->img_comp[n].coeff + 64 * (i + j * z->img_comp[n].coeff_w); + stbi__jpeg_dequantize(data, z->dequant[z->img_comp[n].tq]); + z->idct_block_kernel(z->img_comp[n].data+z->img_comp[n].w2*j*8+i*8, z->img_comp[n].w2, data); + } + } + } + } +} + +static int stbi__process_marker(stbi__jpeg *z, int m) +{ + int L; + switch (m) { + case STBI__MARKER_none: // no marker found + return stbi__err("expected marker","Corrupt JPEG"); + + case 0xDD: // DRI - specify restart interval + if (stbi__get16be(z->s) != 4) return stbi__err("bad DRI len","Corrupt JPEG"); + z->restart_interval = stbi__get16be(z->s); + return 1; + + case 0xDB: // DQT - define quantization table + L = stbi__get16be(z->s)-2; + while (L > 0) { + int q = stbi__get8(z->s); + int p = q >> 4, sixteen = (p != 0); + int t = q & 15,i; + if (p != 0 && p != 1) return stbi__err("bad DQT type","Corrupt JPEG"); + if (t > 3) return stbi__err("bad DQT table","Corrupt JPEG"); + + for (i=0; i < 64; ++i) + z->dequant[t][stbi__jpeg_dezigzag[i]] = (stbi__uint16)(sixteen ? stbi__get16be(z->s) : stbi__get8(z->s)); + L -= (sixteen ? 129 : 65); + } + return L==0; + + case 0xC4: // DHT - define huffman table + L = stbi__get16be(z->s)-2; + while (L > 0) { + stbi_uc *v; + int sizes[16],i,n=0; + int q = stbi__get8(z->s); + int tc = q >> 4; + int th = q & 15; + if (tc > 1 || th > 3) return stbi__err("bad DHT header","Corrupt JPEG"); + for (i=0; i < 16; ++i) { + sizes[i] = stbi__get8(z->s); + n += sizes[i]; + } + if(n > 256) return stbi__err("bad DHT header","Corrupt JPEG"); // Loop over i < n would write past end of values! + L -= 17; + if (tc == 0) { + if (!stbi__build_huffman(z->huff_dc+th, sizes)) return 0; + v = z->huff_dc[th].values; + } else { + if (!stbi__build_huffman(z->huff_ac+th, sizes)) return 0; + v = z->huff_ac[th].values; + } + for (i=0; i < n; ++i) + v[i] = stbi__get8(z->s); + if (tc != 0) + stbi__build_fast_ac(z->fast_ac[th], z->huff_ac + th); + L -= n; + } + return L==0; + } + + // check for comment block or APP blocks + if ((m >= 0xE0 && m <= 0xEF) || m == 0xFE) { + L = stbi__get16be(z->s); + if (L < 2) { + if (m == 0xFE) + return stbi__err("bad COM len","Corrupt JPEG"); + else + return stbi__err("bad APP len","Corrupt JPEG"); + } + L -= 2; + + if (m == 0xE0 && L >= 5) { // JFIF APP0 segment + static const unsigned char tag[5] = {'J','F','I','F','\0'}; + int ok = 1; + int i; + for (i=0; i < 5; ++i) + if (stbi__get8(z->s) != tag[i]) + ok = 0; + L -= 5; + if (ok) + z->jfif = 1; + } else if (m == 0xEE && L >= 12) { // Adobe APP14 segment + static const unsigned char tag[6] = {'A','d','o','b','e','\0'}; + int ok = 1; + int i; + for (i=0; i < 6; ++i) + if (stbi__get8(z->s) != tag[i]) + ok = 0; + L -= 6; + if (ok) { + stbi__get8(z->s); // version + stbi__get16be(z->s); // flags0 + stbi__get16be(z->s); // flags1 + z->app14_color_transform = stbi__get8(z->s); // color transform + L -= 6; + } + } + + stbi__skip(z->s, L); + return 1; + } + + return stbi__err("unknown marker","Corrupt JPEG"); +} + +// after we see SOS +static int stbi__process_scan_header(stbi__jpeg *z) +{ + int i; + int Ls = stbi__get16be(z->s); + z->scan_n = stbi__get8(z->s); + if (z->scan_n < 1 || z->scan_n > 4 || z->scan_n > (int) z->s->img_n) return stbi__err("bad SOS component count","Corrupt JPEG"); + if (Ls != 6+2*z->scan_n) return stbi__err("bad SOS len","Corrupt JPEG"); + for (i=0; i < z->scan_n; ++i) { + int id = stbi__get8(z->s), which; + int q = stbi__get8(z->s); + for (which = 0; which < z->s->img_n; ++which) + if (z->img_comp[which].id == id) + break; + if (which == z->s->img_n) return 0; // no match + z->img_comp[which].hd = q >> 4; if (z->img_comp[which].hd > 3) return stbi__err("bad DC huff","Corrupt JPEG"); + z->img_comp[which].ha = q & 15; if (z->img_comp[which].ha > 3) return stbi__err("bad AC huff","Corrupt JPEG"); + z->order[i] = which; + } + + { + int aa; + z->spec_start = stbi__get8(z->s); + z->spec_end = stbi__get8(z->s); // should be 63, but might be 0 + aa = stbi__get8(z->s); + z->succ_high = (aa >> 4); + z->succ_low = (aa & 15); + if (z->progressive) { + if (z->spec_start > 63 || z->spec_end > 63 || z->spec_start > z->spec_end || z->succ_high > 13 || z->succ_low > 13) + return stbi__err("bad SOS", "Corrupt JPEG"); + } else { + if (z->spec_start != 0) return stbi__err("bad SOS","Corrupt JPEG"); + if (z->succ_high != 0 || z->succ_low != 0) return stbi__err("bad SOS","Corrupt JPEG"); + z->spec_end = 63; + } + } + + return 1; +} + +static int stbi__free_jpeg_components(stbi__jpeg *z, int ncomp, int why) +{ + int i; + for (i=0; i < ncomp; ++i) { + if (z->img_comp[i].raw_data) { + STBI_FREE(z->img_comp[i].raw_data); + z->img_comp[i].raw_data = NULL; + z->img_comp[i].data = NULL; + } + if (z->img_comp[i].raw_coeff) { + STBI_FREE(z->img_comp[i].raw_coeff); + z->img_comp[i].raw_coeff = 0; + z->img_comp[i].coeff = 0; + } + if (z->img_comp[i].linebuf) { + STBI_FREE(z->img_comp[i].linebuf); + z->img_comp[i].linebuf = NULL; + } + } + return why; +} + +static int stbi__process_frame_header(stbi__jpeg *z, int scan) +{ + stbi__context *s = z->s; + int Lf,p,i,q, h_max=1,v_max=1,c; + Lf = stbi__get16be(s); if (Lf < 11) return stbi__err("bad SOF len","Corrupt JPEG"); // JPEG + p = stbi__get8(s); if (p != 8) return stbi__err("only 8-bit","JPEG format not supported: 8-bit only"); // JPEG baseline + s->img_y = stbi__get16be(s); if (s->img_y == 0) return stbi__err("no header height", "JPEG format not supported: delayed height"); // Legal, but we don't handle it--but neither does IJG + s->img_x = stbi__get16be(s); if (s->img_x == 0) return stbi__err("0 width","Corrupt JPEG"); // JPEG requires + if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + c = stbi__get8(s); + if (c != 3 && c != 1 && c != 4) return stbi__err("bad component count","Corrupt JPEG"); + s->img_n = c; + for (i=0; i < c; ++i) { + z->img_comp[i].data = NULL; + z->img_comp[i].linebuf = NULL; + } + + if (Lf != 8+3*s->img_n) return stbi__err("bad SOF len","Corrupt JPEG"); + + z->rgb = 0; + for (i=0; i < s->img_n; ++i) { + static const unsigned char rgb[3] = { 'R', 'G', 'B' }; + z->img_comp[i].id = stbi__get8(s); + if (s->img_n == 3 && z->img_comp[i].id == rgb[i]) + ++z->rgb; + q = stbi__get8(s); + z->img_comp[i].h = (q >> 4); if (!z->img_comp[i].h || z->img_comp[i].h > 4) return stbi__err("bad H","Corrupt JPEG"); + z->img_comp[i].v = q & 15; if (!z->img_comp[i].v || z->img_comp[i].v > 4) return stbi__err("bad V","Corrupt JPEG"); + z->img_comp[i].tq = stbi__get8(s); if (z->img_comp[i].tq > 3) return stbi__err("bad TQ","Corrupt JPEG"); + } + + if (scan != STBI__SCAN_load) return 1; + + if (!stbi__mad3sizes_valid(s->img_x, s->img_y, s->img_n, 0)) return stbi__err("too large", "Image too large to decode"); + + for (i=0; i < s->img_n; ++i) { + if (z->img_comp[i].h > h_max) h_max = z->img_comp[i].h; + if (z->img_comp[i].v > v_max) v_max = z->img_comp[i].v; + } + + // check that plane subsampling factors are integer ratios; our resamplers can't deal with fractional ratios + // and I've never seen a non-corrupted JPEG file actually use them + for (i=0; i < s->img_n; ++i) { + if (h_max % z->img_comp[i].h != 0) return stbi__err("bad H","Corrupt JPEG"); + if (v_max % z->img_comp[i].v != 0) return stbi__err("bad V","Corrupt JPEG"); + } + + // compute interleaved mcu info + z->img_h_max = h_max; + z->img_v_max = v_max; + z->img_mcu_w = h_max * 8; + z->img_mcu_h = v_max * 8; + // these sizes can't be more than 17 bits + z->img_mcu_x = (s->img_x + z->img_mcu_w-1) / z->img_mcu_w; + z->img_mcu_y = (s->img_y + z->img_mcu_h-1) / z->img_mcu_h; + + for (i=0; i < s->img_n; ++i) { + // number of effective pixels (e.g. for non-interleaved MCU) + z->img_comp[i].x = (s->img_x * z->img_comp[i].h + h_max-1) / h_max; + z->img_comp[i].y = (s->img_y * z->img_comp[i].v + v_max-1) / v_max; + // to simplify generation, we'll allocate enough memory to decode + // the bogus oversized data from using interleaved MCUs and their + // big blocks (e.g. a 16x16 iMCU on an image of width 33); we won't + // discard the extra data until colorspace conversion + // + // img_mcu_x, img_mcu_y: <=17 bits; comp[i].h and .v are <=4 (checked earlier) + // so these muls can't overflow with 32-bit ints (which we require) + z->img_comp[i].w2 = z->img_mcu_x * z->img_comp[i].h * 8; + z->img_comp[i].h2 = z->img_mcu_y * z->img_comp[i].v * 8; + z->img_comp[i].coeff = 0; + z->img_comp[i].raw_coeff = 0; + z->img_comp[i].linebuf = NULL; + z->img_comp[i].raw_data = stbi__malloc_mad2(z->img_comp[i].w2, z->img_comp[i].h2, 15); + if (z->img_comp[i].raw_data == NULL) + return stbi__free_jpeg_components(z, i+1, stbi__err("outofmem", "Out of memory")); + // align blocks for idct using mmx/sse + z->img_comp[i].data = (stbi_uc*) (((size_t) z->img_comp[i].raw_data + 15) & ~15); + if (z->progressive) { + // w2, h2 are multiples of 8 (see above) + z->img_comp[i].coeff_w = z->img_comp[i].w2 / 8; + z->img_comp[i].coeff_h = z->img_comp[i].h2 / 8; + z->img_comp[i].raw_coeff = stbi__malloc_mad3(z->img_comp[i].w2, z->img_comp[i].h2, sizeof(short), 15); + if (z->img_comp[i].raw_coeff == NULL) + return stbi__free_jpeg_components(z, i+1, stbi__err("outofmem", "Out of memory")); + z->img_comp[i].coeff = (short*) (((size_t) z->img_comp[i].raw_coeff + 15) & ~15); + } + } + + return 1; +} + +// use comparisons since in some cases we handle more than one case (e.g. SOF) +#define stbi__DNL(x) ((x) == 0xdc) +#define stbi__SOI(x) ((x) == 0xd8) +#define stbi__EOI(x) ((x) == 0xd9) +#define stbi__SOF(x) ((x) == 0xc0 || (x) == 0xc1 || (x) == 0xc2) +#define stbi__SOS(x) ((x) == 0xda) + +#define stbi__SOF_progressive(x) ((x) == 0xc2) + +static int stbi__decode_jpeg_header(stbi__jpeg *z, int scan) +{ + int m; + z->jfif = 0; + z->app14_color_transform = -1; // valid values are 0,1,2 + z->marker = STBI__MARKER_none; // initialize cached marker to empty + m = stbi__get_marker(z); + if (!stbi__SOI(m)) return stbi__err("no SOI","Corrupt JPEG"); + if (scan == STBI__SCAN_type) return 1; + m = stbi__get_marker(z); + while (!stbi__SOF(m)) { + if (!stbi__process_marker(z,m)) return 0; + m = stbi__get_marker(z); + while (m == STBI__MARKER_none) { + // some files have extra padding after their blocks, so ok, we'll scan + if (stbi__at_eof(z->s)) return stbi__err("no SOF", "Corrupt JPEG"); + m = stbi__get_marker(z); + } + } + z->progressive = stbi__SOF_progressive(m); + if (!stbi__process_frame_header(z, scan)) return 0; + return 1; +} + +static int stbi__skip_jpeg_junk_at_end(stbi__jpeg *j) +{ + // some JPEGs have junk at end, skip over it but if we find what looks + // like a valid marker, resume there + while (!stbi__at_eof(j->s)) { + int x = stbi__get8(j->s); + while (x == 255) { // might be a marker + if (stbi__at_eof(j->s)) return STBI__MARKER_none; + x = stbi__get8(j->s); + if (x != 0x00 && x != 0xff) { + // not a stuffed zero or lead-in to another marker, looks + // like an actual marker, return it + return x; + } + // stuffed zero has x=0 now which ends the loop, meaning we go + // back to regular scan loop. + // repeated 0xff keeps trying to read the next byte of the marker. + } + } + return STBI__MARKER_none; +} + +// decode image to YCbCr format +static int stbi__decode_jpeg_image(stbi__jpeg *j) +{ + int m; + for (m = 0; m < 4; m++) { + j->img_comp[m].raw_data = NULL; + j->img_comp[m].raw_coeff = NULL; + } + j->restart_interval = 0; + if (!stbi__decode_jpeg_header(j, STBI__SCAN_load)) return 0; + m = stbi__get_marker(j); + while (!stbi__EOI(m)) { + if (stbi__SOS(m)) { + if (!stbi__process_scan_header(j)) return 0; + if (!stbi__parse_entropy_coded_data(j)) return 0; + if (j->marker == STBI__MARKER_none ) { + j->marker = stbi__skip_jpeg_junk_at_end(j); + // if we reach eof without hitting a marker, stbi__get_marker() below will fail and we'll eventually return 0 + } + m = stbi__get_marker(j); + if (STBI__RESTART(m)) + m = stbi__get_marker(j); + } else if (stbi__DNL(m)) { + int Ld = stbi__get16be(j->s); + stbi__uint32 NL = stbi__get16be(j->s); + if (Ld != 4) return stbi__err("bad DNL len", "Corrupt JPEG"); + if (NL != j->s->img_y) return stbi__err("bad DNL height", "Corrupt JPEG"); + m = stbi__get_marker(j); + } else { + if (!stbi__process_marker(j, m)) return 1; + m = stbi__get_marker(j); + } + } + if (j->progressive) + stbi__jpeg_finish(j); + return 1; +} + +// static jfif-centered resampling (across block boundaries) + +typedef stbi_uc *(*resample_row_func)(stbi_uc *out, stbi_uc *in0, stbi_uc *in1, + int w, int hs); + +#define stbi__div4(x) ((stbi_uc) ((x) >> 2)) + +static stbi_uc *resample_row_1(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +{ + STBI_NOTUSED(out); + STBI_NOTUSED(in_far); + STBI_NOTUSED(w); + STBI_NOTUSED(hs); + return in_near; +} + +static stbi_uc* stbi__resample_row_v_2(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +{ + // need to generate two samples vertically for every one in input + int i; + STBI_NOTUSED(hs); + for (i=0; i < w; ++i) + out[i] = stbi__div4(3*in_near[i] + in_far[i] + 2); + return out; +} + +static stbi_uc* stbi__resample_row_h_2(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +{ + // need to generate two samples horizontally for every one in input + int i; + stbi_uc *input = in_near; + + if (w == 1) { + // if only one sample, can't do any interpolation + out[0] = out[1] = input[0]; + return out; + } + + out[0] = input[0]; + out[1] = stbi__div4(input[0]*3 + input[1] + 2); + for (i=1; i < w-1; ++i) { + int n = 3*input[i]+2; + out[i*2+0] = stbi__div4(n+input[i-1]); + out[i*2+1] = stbi__div4(n+input[i+1]); + } + out[i*2+0] = stbi__div4(input[w-2]*3 + input[w-1] + 2); + out[i*2+1] = input[w-1]; + + STBI_NOTUSED(in_far); + STBI_NOTUSED(hs); + + return out; +} + +#define stbi__div16(x) ((stbi_uc) ((x) >> 4)) + +static stbi_uc *stbi__resample_row_hv_2(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +{ + // need to generate 2x2 samples for every one in input + int i,t0,t1; + if (w == 1) { + out[0] = out[1] = stbi__div4(3*in_near[0] + in_far[0] + 2); + return out; + } + + t1 = 3*in_near[0] + in_far[0]; + out[0] = stbi__div4(t1+2); + for (i=1; i < w; ++i) { + t0 = t1; + t1 = 3*in_near[i]+in_far[i]; + out[i*2-1] = stbi__div16(3*t0 + t1 + 8); + out[i*2 ] = stbi__div16(3*t1 + t0 + 8); + } + out[w*2-1] = stbi__div4(t1+2); + + STBI_NOTUSED(hs); + + return out; +} + +#if defined(STBI_SSE2) || defined(STBI_NEON) +static stbi_uc *stbi__resample_row_hv_2_simd(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +{ + // need to generate 2x2 samples for every one in input + int i=0,t0,t1; + + if (w == 1) { + out[0] = out[1] = stbi__div4(3*in_near[0] + in_far[0] + 2); + return out; + } + + t1 = 3*in_near[0] + in_far[0]; + // process groups of 8 pixels for as long as we can. + // note we can't handle the last pixel in a row in this loop + // because we need to handle the filter boundary conditions. + for (; i < ((w-1) & ~7); i += 8) { +#if defined(STBI_SSE2) + // load and perform the vertical filtering pass + // this uses 3*x + y = 4*x + (y - x) + __m128i zero = _mm_setzero_si128(); + __m128i farb = _mm_loadl_epi64((__m128i *) (in_far + i)); + __m128i nearb = _mm_loadl_epi64((__m128i *) (in_near + i)); + __m128i farw = _mm_unpacklo_epi8(farb, zero); + __m128i nearw = _mm_unpacklo_epi8(nearb, zero); + __m128i diff = _mm_sub_epi16(farw, nearw); + __m128i nears = _mm_slli_epi16(nearw, 2); + __m128i curr = _mm_add_epi16(nears, diff); // current row + + // horizontal filter works the same based on shifted vers of current + // row. "prev" is current row shifted right by 1 pixel; we need to + // insert the previous pixel value (from t1). + // "next" is current row shifted left by 1 pixel, with first pixel + // of next block of 8 pixels added in. + __m128i prv0 = _mm_slli_si128(curr, 2); + __m128i nxt0 = _mm_srli_si128(curr, 2); + __m128i prev = _mm_insert_epi16(prv0, t1, 0); + __m128i next = _mm_insert_epi16(nxt0, 3*in_near[i+8] + in_far[i+8], 7); + + // horizontal filter, polyphase implementation since it's convenient: + // even pixels = 3*cur + prev = cur*4 + (prev - cur) + // odd pixels = 3*cur + next = cur*4 + (next - cur) + // note the shared term. + __m128i bias = _mm_set1_epi16(8); + __m128i curs = _mm_slli_epi16(curr, 2); + __m128i prvd = _mm_sub_epi16(prev, curr); + __m128i nxtd = _mm_sub_epi16(next, curr); + __m128i curb = _mm_add_epi16(curs, bias); + __m128i even = _mm_add_epi16(prvd, curb); + __m128i odd = _mm_add_epi16(nxtd, curb); + + // interleave even and odd pixels, then undo scaling. + __m128i int0 = _mm_unpacklo_epi16(even, odd); + __m128i int1 = _mm_unpackhi_epi16(even, odd); + __m128i de0 = _mm_srli_epi16(int0, 4); + __m128i de1 = _mm_srli_epi16(int1, 4); + + // pack and write output + __m128i outv = _mm_packus_epi16(de0, de1); + _mm_storeu_si128((__m128i *) (out + i*2), outv); +#elif defined(STBI_NEON) + // load and perform the vertical filtering pass + // this uses 3*x + y = 4*x + (y - x) + uint8x8_t farb = vld1_u8(in_far + i); + uint8x8_t nearb = vld1_u8(in_near + i); + int16x8_t diff = vreinterpretq_s16_u16(vsubl_u8(farb, nearb)); + int16x8_t nears = vreinterpretq_s16_u16(vshll_n_u8(nearb, 2)); + int16x8_t curr = vaddq_s16(nears, diff); // current row + + // horizontal filter works the same based on shifted vers of current + // row. "prev" is current row shifted right by 1 pixel; we need to + // insert the previous pixel value (from t1). + // "next" is current row shifted left by 1 pixel, with first pixel + // of next block of 8 pixels added in. + int16x8_t prv0 = vextq_s16(curr, curr, 7); + int16x8_t nxt0 = vextq_s16(curr, curr, 1); + int16x8_t prev = vsetq_lane_s16(t1, prv0, 0); + int16x8_t next = vsetq_lane_s16(3*in_near[i+8] + in_far[i+8], nxt0, 7); + + // horizontal filter, polyphase implementation since it's convenient: + // even pixels = 3*cur + prev = cur*4 + (prev - cur) + // odd pixels = 3*cur + next = cur*4 + (next - cur) + // note the shared term. + int16x8_t curs = vshlq_n_s16(curr, 2); + int16x8_t prvd = vsubq_s16(prev, curr); + int16x8_t nxtd = vsubq_s16(next, curr); + int16x8_t even = vaddq_s16(curs, prvd); + int16x8_t odd = vaddq_s16(curs, nxtd); + + // undo scaling and round, then store with even/odd phases interleaved + uint8x8x2_t o; + o.val[0] = vqrshrun_n_s16(even, 4); + o.val[1] = vqrshrun_n_s16(odd, 4); + vst2_u8(out + i*2, o); +#endif + + // "previous" value for next iter + t1 = 3*in_near[i+7] + in_far[i+7]; + } + + t0 = t1; + t1 = 3*in_near[i] + in_far[i]; + out[i*2] = stbi__div16(3*t1 + t0 + 8); + + for (++i; i < w; ++i) { + t0 = t1; + t1 = 3*in_near[i]+in_far[i]; + out[i*2-1] = stbi__div16(3*t0 + t1 + 8); + out[i*2 ] = stbi__div16(3*t1 + t0 + 8); + } + out[w*2-1] = stbi__div4(t1+2); + + STBI_NOTUSED(hs); + + return out; +} +#endif + +static stbi_uc *stbi__resample_row_generic(stbi_uc *out, stbi_uc *in_near, stbi_uc *in_far, int w, int hs) +{ + // resample with nearest-neighbor + int i,j; + STBI_NOTUSED(in_far); + for (i=0; i < w; ++i) + for (j=0; j < hs; ++j) + out[i*hs+j] = in_near[i]; + return out; +} + +// this is a reduced-precision calculation of YCbCr-to-RGB introduced +// to make sure the code produces the same results in both SIMD and scalar +#define stbi__float2fixed(x) (((int) ((x) * 4096.0f + 0.5f)) << 8) +static void stbi__YCbCr_to_RGB_row(stbi_uc *out, const stbi_uc *y, const stbi_uc *pcb, const stbi_uc *pcr, int count, int step) +{ + int i; + for (i=0; i < count; ++i) { + int y_fixed = (y[i] << 20) + (1<<19); // rounding + int r,g,b; + int cr = pcr[i] - 128; + int cb = pcb[i] - 128; + r = y_fixed + cr* stbi__float2fixed(1.40200f); + g = y_fixed + (cr*-stbi__float2fixed(0.71414f)) + ((cb*-stbi__float2fixed(0.34414f)) & 0xffff0000); + b = y_fixed + cb* stbi__float2fixed(1.77200f); + r >>= 20; + g >>= 20; + b >>= 20; + if ((unsigned) r > 255) { if (r < 0) r = 0; else r = 255; } + if ((unsigned) g > 255) { if (g < 0) g = 0; else g = 255; } + if ((unsigned) b > 255) { if (b < 0) b = 0; else b = 255; } + out[0] = (stbi_uc)r; + out[1] = (stbi_uc)g; + out[2] = (stbi_uc)b; + out[3] = 255; + out += step; + } +} + +#if defined(STBI_SSE2) || defined(STBI_NEON) +static void stbi__YCbCr_to_RGB_simd(stbi_uc *out, stbi_uc const *y, stbi_uc const *pcb, stbi_uc const *pcr, int count, int step) +{ + int i = 0; + +#ifdef STBI_SSE2 + // step == 3 is pretty ugly on the final interleave, and i'm not convinced + // it's useful in practice (you wouldn't use it for textures, for example). + // so just accelerate step == 4 case. + if (step == 4) { + // this is a fairly straightforward implementation and not super-optimized. + __m128i signflip = _mm_set1_epi8(-0x80); + __m128i cr_const0 = _mm_set1_epi16( (short) ( 1.40200f*4096.0f+0.5f)); + __m128i cr_const1 = _mm_set1_epi16( - (short) ( 0.71414f*4096.0f+0.5f)); + __m128i cb_const0 = _mm_set1_epi16( - (short) ( 0.34414f*4096.0f+0.5f)); + __m128i cb_const1 = _mm_set1_epi16( (short) ( 1.77200f*4096.0f+0.5f)); + __m128i y_bias = _mm_set1_epi8((char) (unsigned char) 128); + __m128i xw = _mm_set1_epi16(255); // alpha channel + + for (; i+7 < count; i += 8) { + // load + __m128i y_bytes = _mm_loadl_epi64((__m128i *) (y+i)); + __m128i cr_bytes = _mm_loadl_epi64((__m128i *) (pcr+i)); + __m128i cb_bytes = _mm_loadl_epi64((__m128i *) (pcb+i)); + __m128i cr_biased = _mm_xor_si128(cr_bytes, signflip); // -128 + __m128i cb_biased = _mm_xor_si128(cb_bytes, signflip); // -128 + + // unpack to short (and left-shift cr, cb by 8) + __m128i yw = _mm_unpacklo_epi8(y_bias, y_bytes); + __m128i crw = _mm_unpacklo_epi8(_mm_setzero_si128(), cr_biased); + __m128i cbw = _mm_unpacklo_epi8(_mm_setzero_si128(), cb_biased); + + // color transform + __m128i yws = _mm_srli_epi16(yw, 4); + __m128i cr0 = _mm_mulhi_epi16(cr_const0, crw); + __m128i cb0 = _mm_mulhi_epi16(cb_const0, cbw); + __m128i cb1 = _mm_mulhi_epi16(cbw, cb_const1); + __m128i cr1 = _mm_mulhi_epi16(crw, cr_const1); + __m128i rws = _mm_add_epi16(cr0, yws); + __m128i gwt = _mm_add_epi16(cb0, yws); + __m128i bws = _mm_add_epi16(yws, cb1); + __m128i gws = _mm_add_epi16(gwt, cr1); + + // descale + __m128i rw = _mm_srai_epi16(rws, 4); + __m128i bw = _mm_srai_epi16(bws, 4); + __m128i gw = _mm_srai_epi16(gws, 4); + + // back to byte, set up for transpose + __m128i brb = _mm_packus_epi16(rw, bw); + __m128i gxb = _mm_packus_epi16(gw, xw); + + // transpose to interleave channels + __m128i t0 = _mm_unpacklo_epi8(brb, gxb); + __m128i t1 = _mm_unpackhi_epi8(brb, gxb); + __m128i o0 = _mm_unpacklo_epi16(t0, t1); + __m128i o1 = _mm_unpackhi_epi16(t0, t1); + + // store + _mm_storeu_si128((__m128i *) (out + 0), o0); + _mm_storeu_si128((__m128i *) (out + 16), o1); + out += 32; + } + } +#endif + +#ifdef STBI_NEON + // in this version, step=3 support would be easy to add. but is there demand? + if (step == 4) { + // this is a fairly straightforward implementation and not super-optimized. + uint8x8_t signflip = vdup_n_u8(0x80); + int16x8_t cr_const0 = vdupq_n_s16( (short) ( 1.40200f*4096.0f+0.5f)); + int16x8_t cr_const1 = vdupq_n_s16( - (short) ( 0.71414f*4096.0f+0.5f)); + int16x8_t cb_const0 = vdupq_n_s16( - (short) ( 0.34414f*4096.0f+0.5f)); + int16x8_t cb_const1 = vdupq_n_s16( (short) ( 1.77200f*4096.0f+0.5f)); + + for (; i+7 < count; i += 8) { + // load + uint8x8_t y_bytes = vld1_u8(y + i); + uint8x8_t cr_bytes = vld1_u8(pcr + i); + uint8x8_t cb_bytes = vld1_u8(pcb + i); + int8x8_t cr_biased = vreinterpret_s8_u8(vsub_u8(cr_bytes, signflip)); + int8x8_t cb_biased = vreinterpret_s8_u8(vsub_u8(cb_bytes, signflip)); + + // expand to s16 + int16x8_t yws = vreinterpretq_s16_u16(vshll_n_u8(y_bytes, 4)); + int16x8_t crw = vshll_n_s8(cr_biased, 7); + int16x8_t cbw = vshll_n_s8(cb_biased, 7); + + // color transform + int16x8_t cr0 = vqdmulhq_s16(crw, cr_const0); + int16x8_t cb0 = vqdmulhq_s16(cbw, cb_const0); + int16x8_t cr1 = vqdmulhq_s16(crw, cr_const1); + int16x8_t cb1 = vqdmulhq_s16(cbw, cb_const1); + int16x8_t rws = vaddq_s16(yws, cr0); + int16x8_t gws = vaddq_s16(vaddq_s16(yws, cb0), cr1); + int16x8_t bws = vaddq_s16(yws, cb1); + + // undo scaling, round, convert to byte + uint8x8x4_t o; + o.val[0] = vqrshrun_n_s16(rws, 4); + o.val[1] = vqrshrun_n_s16(gws, 4); + o.val[2] = vqrshrun_n_s16(bws, 4); + o.val[3] = vdup_n_u8(255); + + // store, interleaving r/g/b/a + vst4_u8(out, o); + out += 8*4; + } + } +#endif + + for (; i < count; ++i) { + int y_fixed = (y[i] << 20) + (1<<19); // rounding + int r,g,b; + int cr = pcr[i] - 128; + int cb = pcb[i] - 128; + r = y_fixed + cr* stbi__float2fixed(1.40200f); + g = y_fixed + cr*-stbi__float2fixed(0.71414f) + ((cb*-stbi__float2fixed(0.34414f)) & 0xffff0000); + b = y_fixed + cb* stbi__float2fixed(1.77200f); + r >>= 20; + g >>= 20; + b >>= 20; + if ((unsigned) r > 255) { if (r < 0) r = 0; else r = 255; } + if ((unsigned) g > 255) { if (g < 0) g = 0; else g = 255; } + if ((unsigned) b > 255) { if (b < 0) b = 0; else b = 255; } + out[0] = (stbi_uc)r; + out[1] = (stbi_uc)g; + out[2] = (stbi_uc)b; + out[3] = 255; + out += step; + } +} +#endif + +// set up the kernels +static void stbi__setup_jpeg(stbi__jpeg *j) +{ + j->idct_block_kernel = stbi__idct_block; + j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_row; + j->resample_row_hv_2_kernel = stbi__resample_row_hv_2; + +#ifdef STBI_SSE2 + if (stbi__sse2_available()) { + j->idct_block_kernel = stbi__idct_simd; + j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_simd; + j->resample_row_hv_2_kernel = stbi__resample_row_hv_2_simd; + } +#endif + +#ifdef STBI_NEON + j->idct_block_kernel = stbi__idct_simd; + j->YCbCr_to_RGB_kernel = stbi__YCbCr_to_RGB_simd; + j->resample_row_hv_2_kernel = stbi__resample_row_hv_2_simd; +#endif +} + +// clean up the temporary component buffers +static void stbi__cleanup_jpeg(stbi__jpeg *j) +{ + stbi__free_jpeg_components(j, j->s->img_n, 0); +} + +typedef struct +{ + resample_row_func resample; + stbi_uc *line0,*line1; + int hs,vs; // expansion factor in each axis + int w_lores; // horizontal pixels pre-expansion + int ystep; // how far through vertical expansion we are + int ypos; // which pre-expansion row we're on +} stbi__resample; + +// fast 0..255 * 0..255 => 0..255 rounded multiplication +static stbi_uc stbi__blinn_8x8(stbi_uc x, stbi_uc y) +{ + unsigned int t = x*y + 128; + return (stbi_uc) ((t + (t >>8)) >> 8); +} + +static stbi_uc *load_jpeg_image(stbi__jpeg *z, int *out_x, int *out_y, int *comp, int req_comp) +{ + int n, decode_n, is_rgb; + z->s->img_n = 0; // make stbi__cleanup_jpeg safe + + // validate req_comp + if (req_comp < 0 || req_comp > 4) return stbi__errpuc("bad req_comp", "Internal error"); + + // load a jpeg image from whichever source, but leave in YCbCr format + if (!stbi__decode_jpeg_image(z)) { stbi__cleanup_jpeg(z); return NULL; } + + // determine actual number of components to generate + n = req_comp ? req_comp : z->s->img_n >= 3 ? 3 : 1; + + is_rgb = z->s->img_n == 3 && (z->rgb == 3 || (z->app14_color_transform == 0 && !z->jfif)); + + if (z->s->img_n == 3 && n < 3 && !is_rgb) + decode_n = 1; + else + decode_n = z->s->img_n; + + // nothing to do if no components requested; check this now to avoid + // accessing uninitialized coutput[0] later + if (decode_n <= 0) { stbi__cleanup_jpeg(z); return NULL; } + + // resample and color-convert + { + int k; + unsigned int i,j; + stbi_uc *output; + stbi_uc *coutput[4] = { NULL, NULL, NULL, NULL }; + + stbi__resample res_comp[4]; + + for (k=0; k < decode_n; ++k) { + stbi__resample *r = &res_comp[k]; + + // allocate line buffer big enough for upsampling off the edges + // with upsample factor of 4 + z->img_comp[k].linebuf = (stbi_uc *) stbi__malloc(z->s->img_x + 3); + if (!z->img_comp[k].linebuf) { stbi__cleanup_jpeg(z); return stbi__errpuc("outofmem", "Out of memory"); } + + r->hs = z->img_h_max / z->img_comp[k].h; + r->vs = z->img_v_max / z->img_comp[k].v; + r->ystep = r->vs >> 1; + r->w_lores = (z->s->img_x + r->hs-1) / r->hs; + r->ypos = 0; + r->line0 = r->line1 = z->img_comp[k].data; + + if (r->hs == 1 && r->vs == 1) r->resample = resample_row_1; + else if (r->hs == 1 && r->vs == 2) r->resample = stbi__resample_row_v_2; + else if (r->hs == 2 && r->vs == 1) r->resample = stbi__resample_row_h_2; + else if (r->hs == 2 && r->vs == 2) r->resample = z->resample_row_hv_2_kernel; + else r->resample = stbi__resample_row_generic; + } + + // can't error after this so, this is safe + output = (stbi_uc *) stbi__malloc_mad3(n, z->s->img_x, z->s->img_y, 1); + if (!output) { stbi__cleanup_jpeg(z); return stbi__errpuc("outofmem", "Out of memory"); } + + // now go ahead and resample + for (j=0; j < z->s->img_y; ++j) { + stbi_uc *out = output + n * z->s->img_x * j; + for (k=0; k < decode_n; ++k) { + stbi__resample *r = &res_comp[k]; + int y_bot = r->ystep >= (r->vs >> 1); + coutput[k] = r->resample(z->img_comp[k].linebuf, + y_bot ? r->line1 : r->line0, + y_bot ? r->line0 : r->line1, + r->w_lores, r->hs); + if (++r->ystep >= r->vs) { + r->ystep = 0; + r->line0 = r->line1; + if (++r->ypos < z->img_comp[k].y) + r->line1 += z->img_comp[k].w2; + } + } + if (n >= 3) { + stbi_uc *y = coutput[0]; + if (z->s->img_n == 3) { + if (is_rgb) { + for (i=0; i < z->s->img_x; ++i) { + out[0] = y[i]; + out[1] = coutput[1][i]; + out[2] = coutput[2][i]; + out[3] = 255; + out += n; + } + } else { + z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n); + } + } else if (z->s->img_n == 4) { + if (z->app14_color_transform == 0) { // CMYK + for (i=0; i < z->s->img_x; ++i) { + stbi_uc m = coutput[3][i]; + out[0] = stbi__blinn_8x8(coutput[0][i], m); + out[1] = stbi__blinn_8x8(coutput[1][i], m); + out[2] = stbi__blinn_8x8(coutput[2][i], m); + out[3] = 255; + out += n; + } + } else if (z->app14_color_transform == 2) { // YCCK + z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n); + for (i=0; i < z->s->img_x; ++i) { + stbi_uc m = coutput[3][i]; + out[0] = stbi__blinn_8x8(255 - out[0], m); + out[1] = stbi__blinn_8x8(255 - out[1], m); + out[2] = stbi__blinn_8x8(255 - out[2], m); + out += n; + } + } else { // YCbCr + alpha? Ignore the fourth channel for now + z->YCbCr_to_RGB_kernel(out, y, coutput[1], coutput[2], z->s->img_x, n); + } + } else + for (i=0; i < z->s->img_x; ++i) { + out[0] = out[1] = out[2] = y[i]; + out[3] = 255; // not used if n==3 + out += n; + } + } else { + if (is_rgb) { + if (n == 1) + for (i=0; i < z->s->img_x; ++i) + *out++ = stbi__compute_y(coutput[0][i], coutput[1][i], coutput[2][i]); + else { + for (i=0; i < z->s->img_x; ++i, out += 2) { + out[0] = stbi__compute_y(coutput[0][i], coutput[1][i], coutput[2][i]); + out[1] = 255; + } + } + } else if (z->s->img_n == 4 && z->app14_color_transform == 0) { + for (i=0; i < z->s->img_x; ++i) { + stbi_uc m = coutput[3][i]; + stbi_uc r = stbi__blinn_8x8(coutput[0][i], m); + stbi_uc g = stbi__blinn_8x8(coutput[1][i], m); + stbi_uc b = stbi__blinn_8x8(coutput[2][i], m); + out[0] = stbi__compute_y(r, g, b); + out[1] = 255; + out += n; + } + } else if (z->s->img_n == 4 && z->app14_color_transform == 2) { + for (i=0; i < z->s->img_x; ++i) { + out[0] = stbi__blinn_8x8(255 - coutput[0][i], coutput[3][i]); + out[1] = 255; + out += n; + } + } else { + stbi_uc *y = coutput[0]; + if (n == 1) + for (i=0; i < z->s->img_x; ++i) out[i] = y[i]; + else + for (i=0; i < z->s->img_x; ++i) { *out++ = y[i]; *out++ = 255; } + } + } + } + stbi__cleanup_jpeg(z); + *out_x = z->s->img_x; + *out_y = z->s->img_y; + if (comp) *comp = z->s->img_n >= 3 ? 3 : 1; // report original components, not output + return output; + } +} + +static void *stbi__jpeg_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) +{ + unsigned char* result; + stbi__jpeg* j = (stbi__jpeg*) stbi__malloc(sizeof(stbi__jpeg)); + if (!j) return stbi__errpuc("outofmem", "Out of memory"); + memset(j, 0, sizeof(stbi__jpeg)); + STBI_NOTUSED(ri); + j->s = s; + stbi__setup_jpeg(j); + result = load_jpeg_image(j, x,y,comp,req_comp); + STBI_FREE(j); + return result; +} + +static int stbi__jpeg_test(stbi__context *s) +{ + int r; + stbi__jpeg* j = (stbi__jpeg*)stbi__malloc(sizeof(stbi__jpeg)); + if (!j) return stbi__err("outofmem", "Out of memory"); + memset(j, 0, sizeof(stbi__jpeg)); + j->s = s; + stbi__setup_jpeg(j); + r = stbi__decode_jpeg_header(j, STBI__SCAN_type); + stbi__rewind(s); + STBI_FREE(j); + return r; +} + +static int stbi__jpeg_info_raw(stbi__jpeg *j, int *x, int *y, int *comp) +{ + if (!stbi__decode_jpeg_header(j, STBI__SCAN_header)) { + stbi__rewind( j->s ); + return 0; + } + if (x) *x = j->s->img_x; + if (y) *y = j->s->img_y; + if (comp) *comp = j->s->img_n >= 3 ? 3 : 1; + return 1; +} + +static int stbi__jpeg_info(stbi__context *s, int *x, int *y, int *comp) +{ + int result; + stbi__jpeg* j = (stbi__jpeg*) (stbi__malloc(sizeof(stbi__jpeg))); + if (!j) return stbi__err("outofmem", "Out of memory"); + memset(j, 0, sizeof(stbi__jpeg)); + j->s = s; + result = stbi__jpeg_info_raw(j, x, y, comp); + STBI_FREE(j); + return result; +} +#endif + +// public domain zlib decode v0.2 Sean Barrett 2006-11-18 +// simple implementation +// - all input must be provided in an upfront buffer +// - all output is written to a single output buffer (can malloc/realloc) +// performance +// - fast huffman + +#ifndef STBI_NO_ZLIB + +// fast-way is faster to check than jpeg huffman, but slow way is slower +#define STBI__ZFAST_BITS 9 // accelerate all cases in default tables +#define STBI__ZFAST_MASK ((1 << STBI__ZFAST_BITS) - 1) +#define STBI__ZNSYMS 288 // number of symbols in literal/length alphabet + +// zlib-style huffman encoding +// (jpegs packs from left, zlib from right, so can't share code) +typedef struct +{ + stbi__uint16 fast[1 << STBI__ZFAST_BITS]; + stbi__uint16 firstcode[16]; + int maxcode[17]; + stbi__uint16 firstsymbol[16]; + stbi_uc size[STBI__ZNSYMS]; + stbi__uint16 value[STBI__ZNSYMS]; +} stbi__zhuffman; + +stbi_inline static int stbi__bitreverse16(int n) +{ + n = ((n & 0xAAAA) >> 1) | ((n & 0x5555) << 1); + n = ((n & 0xCCCC) >> 2) | ((n & 0x3333) << 2); + n = ((n & 0xF0F0) >> 4) | ((n & 0x0F0F) << 4); + n = ((n & 0xFF00) >> 8) | ((n & 0x00FF) << 8); + return n; +} + +stbi_inline static int stbi__bit_reverse(int v, int bits) +{ + STBI_ASSERT(bits <= 16); + // to bit reverse n bits, reverse 16 and shift + // e.g. 11 bits, bit reverse and shift away 5 + return stbi__bitreverse16(v) >> (16-bits); +} + +static int stbi__zbuild_huffman(stbi__zhuffman *z, const stbi_uc *sizelist, int num) +{ + int i,k=0; + int code, next_code[16], sizes[17]; + + // DEFLATE spec for generating codes + memset(sizes, 0, sizeof(sizes)); + memset(z->fast, 0, sizeof(z->fast)); + for (i=0; i < num; ++i) + ++sizes[sizelist[i]]; + sizes[0] = 0; + for (i=1; i < 16; ++i) + if (sizes[i] > (1 << i)) + return stbi__err("bad sizes", "Corrupt PNG"); + code = 0; + for (i=1; i < 16; ++i) { + next_code[i] = code; + z->firstcode[i] = (stbi__uint16) code; + z->firstsymbol[i] = (stbi__uint16) k; + code = (code + sizes[i]); + if (sizes[i]) + if (code-1 >= (1 << i)) return stbi__err("bad codelengths","Corrupt PNG"); + z->maxcode[i] = code << (16-i); // preshift for inner loop + code <<= 1; + k += sizes[i]; + } + z->maxcode[16] = 0x10000; // sentinel + for (i=0; i < num; ++i) { + int s = sizelist[i]; + if (s) { + int c = next_code[s] - z->firstcode[s] + z->firstsymbol[s]; + stbi__uint16 fastv = (stbi__uint16) ((s << 9) | i); + z->size [c] = (stbi_uc ) s; + z->value[c] = (stbi__uint16) i; + if (s <= STBI__ZFAST_BITS) { + int j = stbi__bit_reverse(next_code[s],s); + while (j < (1 << STBI__ZFAST_BITS)) { + z->fast[j] = fastv; + j += (1 << s); + } + } + ++next_code[s]; + } + } + return 1; +} + +// zlib-from-memory implementation for PNG reading +// because PNG allows splitting the zlib stream arbitrarily, +// and it's annoying structurally to have PNG call ZLIB call PNG, +// we require PNG read all the IDATs and combine them into a single +// memory buffer + +typedef struct +{ + stbi_uc *zbuffer, *zbuffer_end; + int num_bits; + stbi__uint32 code_buffer; + + char *zout; + char *zout_start; + char *zout_end; + int z_expandable; + + stbi__zhuffman z_length, z_distance; +} stbi__zbuf; + +stbi_inline static int stbi__zeof(stbi__zbuf *z) +{ + return (z->zbuffer >= z->zbuffer_end); +} + +stbi_inline static stbi_uc stbi__zget8(stbi__zbuf *z) +{ + return stbi__zeof(z) ? 0 : *z->zbuffer++; +} + +static void stbi__fill_bits(stbi__zbuf *z) +{ + do { + if (z->code_buffer >= (1U << z->num_bits)) { + z->zbuffer = z->zbuffer_end; /* treat this as EOF so we fail. */ + return; + } + z->code_buffer |= (unsigned int) stbi__zget8(z) << z->num_bits; + z->num_bits += 8; + } while (z->num_bits <= 24); +} + +stbi_inline static unsigned int stbi__zreceive(stbi__zbuf *z, int n) +{ + unsigned int k; + if (z->num_bits < n) stbi__fill_bits(z); + k = z->code_buffer & ((1 << n) - 1); + z->code_buffer >>= n; + z->num_bits -= n; + return k; +} + +static int stbi__zhuffman_decode_slowpath(stbi__zbuf *a, stbi__zhuffman *z) +{ + int b,s,k; + // not resolved by fast table, so compute it the slow way + // use jpeg approach, which requires MSbits at top + k = stbi__bit_reverse(a->code_buffer, 16); + for (s=STBI__ZFAST_BITS+1; ; ++s) + if (k < z->maxcode[s]) + break; + if (s >= 16) return -1; // invalid code! + // code size is s, so: + b = (k >> (16-s)) - z->firstcode[s] + z->firstsymbol[s]; + if (b >= STBI__ZNSYMS) return -1; // some data was corrupt somewhere! + if (z->size[b] != s) return -1; // was originally an assert, but report failure instead. + a->code_buffer >>= s; + a->num_bits -= s; + return z->value[b]; +} + +stbi_inline static int stbi__zhuffman_decode(stbi__zbuf *a, stbi__zhuffman *z) +{ + int b,s; + if (a->num_bits < 16) { + if (stbi__zeof(a)) { + return -1; /* report error for unexpected end of data. */ + } + stbi__fill_bits(a); + } + b = z->fast[a->code_buffer & STBI__ZFAST_MASK]; + if (b) { + s = b >> 9; + a->code_buffer >>= s; + a->num_bits -= s; + return b & 511; + } + return stbi__zhuffman_decode_slowpath(a, z); +} + +static int stbi__zexpand(stbi__zbuf *z, char *zout, int n) // need to make room for n bytes +{ + char *q; + unsigned int cur, limit, old_limit; + z->zout = zout; + if (!z->z_expandable) return stbi__err("output buffer limit","Corrupt PNG"); + cur = (unsigned int) (z->zout - z->zout_start); + limit = old_limit = (unsigned) (z->zout_end - z->zout_start); + if (UINT_MAX - cur < (unsigned) n) return stbi__err("outofmem", "Out of memory"); + while (cur + n > limit) { + if(limit > UINT_MAX / 2) return stbi__err("outofmem", "Out of memory"); + limit *= 2; + } + q = (char *) STBI_REALLOC_SIZED(z->zout_start, old_limit, limit); + STBI_NOTUSED(old_limit); + if (q == NULL) return stbi__err("outofmem", "Out of memory"); + z->zout_start = q; + z->zout = q + cur; + z->zout_end = q + limit; + return 1; +} + +static const int stbi__zlength_base[31] = { + 3,4,5,6,7,8,9,10,11,13, + 15,17,19,23,27,31,35,43,51,59, + 67,83,99,115,131,163,195,227,258,0,0 }; + +static const int stbi__zlength_extra[31]= +{ 0,0,0,0,0,0,0,0,1,1,1,1,2,2,2,2,3,3,3,3,4,4,4,4,5,5,5,5,0,0,0 }; + +static const int stbi__zdist_base[32] = { 1,2,3,4,5,7,9,13,17,25,33,49,65,97,129,193, +257,385,513,769,1025,1537,2049,3073,4097,6145,8193,12289,16385,24577,0,0}; + +static const int stbi__zdist_extra[32] = +{ 0,0,0,0,1,1,2,2,3,3,4,4,5,5,6,6,7,7,8,8,9,9,10,10,11,11,12,12,13,13}; + +static int stbi__parse_huffman_block(stbi__zbuf *a) +{ + char *zout = a->zout; + for(;;) { + int z = stbi__zhuffman_decode(a, &a->z_length); + if (z < 256) { + if (z < 0) return stbi__err("bad huffman code","Corrupt PNG"); // error in huffman codes + if (zout >= a->zout_end) { + if (!stbi__zexpand(a, zout, 1)) return 0; + zout = a->zout; + } + *zout++ = (char) z; + } else { + stbi_uc *p; + int len,dist; + if (z == 256) { + a->zout = zout; + return 1; + } + if (z >= 286) return stbi__err("bad huffman code","Corrupt PNG"); // per DEFLATE, length codes 286 and 287 must not appear in compressed data + z -= 257; + len = stbi__zlength_base[z]; + if (stbi__zlength_extra[z]) len += stbi__zreceive(a, stbi__zlength_extra[z]); + z = stbi__zhuffman_decode(a, &a->z_distance); + if (z < 0 || z >= 30) return stbi__err("bad huffman code","Corrupt PNG"); // per DEFLATE, distance codes 30 and 31 must not appear in compressed data + dist = stbi__zdist_base[z]; + if (stbi__zdist_extra[z]) dist += stbi__zreceive(a, stbi__zdist_extra[z]); + if (zout - a->zout_start < dist) return stbi__err("bad dist","Corrupt PNG"); + if (zout + len > a->zout_end) { + if (!stbi__zexpand(a, zout, len)) return 0; + zout = a->zout; + } + p = (stbi_uc *) (zout - dist); + if (dist == 1) { // run of one byte; common in images. + stbi_uc v = *p; + if (len) { do *zout++ = v; while (--len); } + } else { + if (len) { do *zout++ = *p++; while (--len); } + } + } + } +} + +static int stbi__compute_huffman_codes(stbi__zbuf *a) +{ + static const stbi_uc length_dezigzag[19] = { 16,17,18,0,8,7,9,6,10,5,11,4,12,3,13,2,14,1,15 }; + stbi__zhuffman z_codelength; + stbi_uc lencodes[286+32+137];//padding for maximum single op + stbi_uc codelength_sizes[19]; + int i,n; + + int hlit = stbi__zreceive(a,5) + 257; + int hdist = stbi__zreceive(a,5) + 1; + int hclen = stbi__zreceive(a,4) + 4; + int ntot = hlit + hdist; + + memset(codelength_sizes, 0, sizeof(codelength_sizes)); + for (i=0; i < hclen; ++i) { + int s = stbi__zreceive(a,3); + codelength_sizes[length_dezigzag[i]] = (stbi_uc) s; + } + if (!stbi__zbuild_huffman(&z_codelength, codelength_sizes, 19)) return 0; + + n = 0; + while (n < ntot) { + int c = stbi__zhuffman_decode(a, &z_codelength); + if (c < 0 || c >= 19) return stbi__err("bad codelengths", "Corrupt PNG"); + if (c < 16) + lencodes[n++] = (stbi_uc) c; + else { + stbi_uc fill = 0; + if (c == 16) { + c = stbi__zreceive(a,2)+3; + if (n == 0) return stbi__err("bad codelengths", "Corrupt PNG"); + fill = lencodes[n-1]; + } else if (c == 17) { + c = stbi__zreceive(a,3)+3; + } else if (c == 18) { + c = stbi__zreceive(a,7)+11; + } else { + return stbi__err("bad codelengths", "Corrupt PNG"); + } + if (ntot - n < c) return stbi__err("bad codelengths", "Corrupt PNG"); + memset(lencodes+n, fill, c); + n += c; + } + } + if (n != ntot) return stbi__err("bad codelengths","Corrupt PNG"); + if (!stbi__zbuild_huffman(&a->z_length, lencodes, hlit)) return 0; + if (!stbi__zbuild_huffman(&a->z_distance, lencodes+hlit, hdist)) return 0; + return 1; +} + +static int stbi__parse_uncompressed_block(stbi__zbuf *a) +{ + stbi_uc header[4]; + int len,nlen,k; + if (a->num_bits & 7) + stbi__zreceive(a, a->num_bits & 7); // discard + // drain the bit-packed data into header + k = 0; + while (a->num_bits > 0) { + header[k++] = (stbi_uc) (a->code_buffer & 255); // suppress MSVC run-time check + a->code_buffer >>= 8; + a->num_bits -= 8; + } + if (a->num_bits < 0) return stbi__err("zlib corrupt","Corrupt PNG"); + // now fill header the normal way + while (k < 4) + header[k++] = stbi__zget8(a); + len = header[1] * 256 + header[0]; + nlen = header[3] * 256 + header[2]; + if (nlen != (len ^ 0xffff)) return stbi__err("zlib corrupt","Corrupt PNG"); + if (a->zbuffer + len > a->zbuffer_end) return stbi__err("read past buffer","Corrupt PNG"); + if (a->zout + len > a->zout_end) + if (!stbi__zexpand(a, a->zout, len)) return 0; + memcpy(a->zout, a->zbuffer, len); + a->zbuffer += len; + a->zout += len; + return 1; +} + +static int stbi__parse_zlib_header(stbi__zbuf *a) +{ + int cmf = stbi__zget8(a); + int cm = cmf & 15; + /* int cinfo = cmf >> 4; */ + int flg = stbi__zget8(a); + if (stbi__zeof(a)) return stbi__err("bad zlib header","Corrupt PNG"); // zlib spec + if ((cmf*256+flg) % 31 != 0) return stbi__err("bad zlib header","Corrupt PNG"); // zlib spec + if (flg & 32) return stbi__err("no preset dict","Corrupt PNG"); // preset dictionary not allowed in png + if (cm != 8) return stbi__err("bad compression","Corrupt PNG"); // DEFLATE required for png + // window = 1 << (8 + cinfo)... but who cares, we fully buffer output + return 1; +} + +static const stbi_uc stbi__zdefault_length[STBI__ZNSYMS] = +{ + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, + 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, + 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, + 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, 9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9, + 7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7, 7,7,7,7,7,7,7,7,8,8,8,8,8,8,8,8 +}; +static const stbi_uc stbi__zdefault_distance[32] = +{ + 5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5 +}; +/* +Init algorithm: +{ + int i; // use <= to match clearly with spec + for (i=0; i <= 143; ++i) stbi__zdefault_length[i] = 8; + for ( ; i <= 255; ++i) stbi__zdefault_length[i] = 9; + for ( ; i <= 279; ++i) stbi__zdefault_length[i] = 7; + for ( ; i <= 287; ++i) stbi__zdefault_length[i] = 8; + + for (i=0; i <= 31; ++i) stbi__zdefault_distance[i] = 5; +} +*/ + +static int stbi__parse_zlib(stbi__zbuf *a, int parse_header) +{ + int final, type; + if (parse_header) + if (!stbi__parse_zlib_header(a)) return 0; + a->num_bits = 0; + a->code_buffer = 0; + do { + final = stbi__zreceive(a,1); + type = stbi__zreceive(a,2); + if (type == 0) { + if (!stbi__parse_uncompressed_block(a)) return 0; + } else if (type == 3) { + return 0; + } else { + if (type == 1) { + // use fixed code lengths + if (!stbi__zbuild_huffman(&a->z_length , stbi__zdefault_length , STBI__ZNSYMS)) return 0; + if (!stbi__zbuild_huffman(&a->z_distance, stbi__zdefault_distance, 32)) return 0; + } else { + if (!stbi__compute_huffman_codes(a)) return 0; + } + if (!stbi__parse_huffman_block(a)) return 0; + } + } while (!final); + return 1; +} + +static int stbi__do_zlib(stbi__zbuf *a, char *obuf, int olen, int exp, int parse_header) +{ + a->zout_start = obuf; + a->zout = obuf; + a->zout_end = obuf + olen; + a->z_expandable = exp; + + return stbi__parse_zlib(a, parse_header); +} + +STBIDEF char *stbi_zlib_decode_malloc_guesssize(const char *buffer, int len, int initial_size, int *outlen) +{ + stbi__zbuf a; + char *p = (char *) stbi__malloc(initial_size); + if (p == NULL) return NULL; + a.zbuffer = (stbi_uc *) buffer; + a.zbuffer_end = (stbi_uc *) buffer + len; + if (stbi__do_zlib(&a, p, initial_size, 1, 1)) { + if (outlen) *outlen = (int) (a.zout - a.zout_start); + return a.zout_start; + } else { + STBI_FREE(a.zout_start); + return NULL; + } +} + +STBIDEF char *stbi_zlib_decode_malloc(char const *buffer, int len, int *outlen) +{ + return stbi_zlib_decode_malloc_guesssize(buffer, len, 16384, outlen); +} + +STBIDEF char *stbi_zlib_decode_malloc_guesssize_headerflag(const char *buffer, int len, int initial_size, int *outlen, int parse_header) +{ + stbi__zbuf a; + char *p = (char *) stbi__malloc(initial_size); + if (p == NULL) return NULL; + a.zbuffer = (stbi_uc *) buffer; + a.zbuffer_end = (stbi_uc *) buffer + len; + if (stbi__do_zlib(&a, p, initial_size, 1, parse_header)) { + if (outlen) *outlen = (int) (a.zout - a.zout_start); + return a.zout_start; + } else { + STBI_FREE(a.zout_start); + return NULL; + } +} + +STBIDEF int stbi_zlib_decode_buffer(char *obuffer, int olen, char const *ibuffer, int ilen) +{ + stbi__zbuf a; + a.zbuffer = (stbi_uc *) ibuffer; + a.zbuffer_end = (stbi_uc *) ibuffer + ilen; + if (stbi__do_zlib(&a, obuffer, olen, 0, 1)) + return (int) (a.zout - a.zout_start); + else + return -1; +} + +STBIDEF char *stbi_zlib_decode_noheader_malloc(char const *buffer, int len, int *outlen) +{ + stbi__zbuf a; + char *p = (char *) stbi__malloc(16384); + if (p == NULL) return NULL; + a.zbuffer = (stbi_uc *) buffer; + a.zbuffer_end = (stbi_uc *) buffer+len; + if (stbi__do_zlib(&a, p, 16384, 1, 0)) { + if (outlen) *outlen = (int) (a.zout - a.zout_start); + return a.zout_start; + } else { + STBI_FREE(a.zout_start); + return NULL; + } +} + +STBIDEF int stbi_zlib_decode_noheader_buffer(char *obuffer, int olen, const char *ibuffer, int ilen) +{ + stbi__zbuf a; + a.zbuffer = (stbi_uc *) ibuffer; + a.zbuffer_end = (stbi_uc *) ibuffer + ilen; + if (stbi__do_zlib(&a, obuffer, olen, 0, 0)) + return (int) (a.zout - a.zout_start); + else + return -1; +} +#endif + +// public domain "baseline" PNG decoder v0.10 Sean Barrett 2006-11-18 +// simple implementation +// - only 8-bit samples +// - no CRC checking +// - allocates lots of intermediate memory +// - avoids problem of streaming data between subsystems +// - avoids explicit window management +// performance +// - uses stb_zlib, a PD zlib implementation with fast huffman decoding + +#ifndef STBI_NO_PNG +typedef struct +{ + stbi__uint32 length; + stbi__uint32 type; +} stbi__pngchunk; + +static stbi__pngchunk stbi__get_chunk_header(stbi__context *s) +{ + stbi__pngchunk c; + c.length = stbi__get32be(s); + c.type = stbi__get32be(s); + return c; +} + +static int stbi__check_png_header(stbi__context *s) +{ + static const stbi_uc png_sig[8] = { 137,80,78,71,13,10,26,10 }; + int i; + for (i=0; i < 8; ++i) + if (stbi__get8(s) != png_sig[i]) return stbi__err("bad png sig","Not a PNG"); + return 1; +} + +typedef struct +{ + stbi__context *s; + stbi_uc *idata, *expanded, *out; + int depth; +} stbi__png; + + +enum { + STBI__F_none=0, + STBI__F_sub=1, + STBI__F_up=2, + STBI__F_avg=3, + STBI__F_paeth=4, + // synthetic filters used for first scanline to avoid needing a dummy row of 0s + STBI__F_avg_first, + STBI__F_paeth_first +}; + +static stbi_uc first_row_filter[5] = +{ + STBI__F_none, + STBI__F_sub, + STBI__F_none, + STBI__F_avg_first, + STBI__F_paeth_first +}; + +static int stbi__paeth(int a, int b, int c) +{ + int p = a + b - c; + int pa = abs(p-a); + int pb = abs(p-b); + int pc = abs(p-c); + if (pa <= pb && pa <= pc) return a; + if (pb <= pc) return b; + return c; +} + +static const stbi_uc stbi__depth_scale_table[9] = { 0, 0xff, 0x55, 0, 0x11, 0,0,0, 0x01 }; + +// create the png data from post-deflated data +static int stbi__create_png_image_raw(stbi__png *a, stbi_uc *raw, stbi__uint32 raw_len, int out_n, stbi__uint32 x, stbi__uint32 y, int depth, int color) +{ + int bytes = (depth == 16? 2 : 1); + stbi__context *s = a->s; + stbi__uint32 i,j,stride = x*out_n*bytes; + stbi__uint32 img_len, img_width_bytes; + int k; + int img_n = s->img_n; // copy it into a local for later + + int output_bytes = out_n*bytes; + int filter_bytes = img_n*bytes; + int width = x; + + STBI_ASSERT(out_n == s->img_n || out_n == s->img_n+1); + a->out = (stbi_uc *) stbi__malloc_mad3(x, y, output_bytes, 0); // extra bytes to write off the end into + if (!a->out) return stbi__err("outofmem", "Out of memory"); + + if (!stbi__mad3sizes_valid(img_n, x, depth, 7)) return stbi__err("too large", "Corrupt PNG"); + img_width_bytes = (((img_n * x * depth) + 7) >> 3); + img_len = (img_width_bytes + 1) * y; + + // we used to check for exact match between raw_len and img_len on non-interlaced PNGs, + // but issue #276 reported a PNG in the wild that had extra data at the end (all zeros), + // so just check for raw_len < img_len always. + if (raw_len < img_len) return stbi__err("not enough pixels","Corrupt PNG"); + + for (j=0; j < y; ++j) { + stbi_uc *cur = a->out + stride*j; + stbi_uc *prior; + int filter = *raw++; + + if (filter > 4) + return stbi__err("invalid filter","Corrupt PNG"); + + if (depth < 8) { + if (img_width_bytes > x) return stbi__err("invalid width","Corrupt PNG"); + cur += x*out_n - img_width_bytes; // store output to the rightmost img_len bytes, so we can decode in place + filter_bytes = 1; + width = img_width_bytes; + } + prior = cur - stride; // bugfix: need to compute this after 'cur +=' computation above + + // if first row, use special filter that doesn't sample previous row + if (j == 0) filter = first_row_filter[filter]; + + // handle first byte explicitly + for (k=0; k < filter_bytes; ++k) { + switch (filter) { + case STBI__F_none : cur[k] = raw[k]; break; + case STBI__F_sub : cur[k] = raw[k]; break; + case STBI__F_up : cur[k] = STBI__BYTECAST(raw[k] + prior[k]); break; + case STBI__F_avg : cur[k] = STBI__BYTECAST(raw[k] + (prior[k]>>1)); break; + case STBI__F_paeth : cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(0,prior[k],0)); break; + case STBI__F_avg_first : cur[k] = raw[k]; break; + case STBI__F_paeth_first: cur[k] = raw[k]; break; + } + } + + if (depth == 8) { + if (img_n != out_n) + cur[img_n] = 255; // first pixel + raw += img_n; + cur += out_n; + prior += out_n; + } else if (depth == 16) { + if (img_n != out_n) { + cur[filter_bytes] = 255; // first pixel top byte + cur[filter_bytes+1] = 255; // first pixel bottom byte + } + raw += filter_bytes; + cur += output_bytes; + prior += output_bytes; + } else { + raw += 1; + cur += 1; + prior += 1; + } + + // this is a little gross, so that we don't switch per-pixel or per-component + if (depth < 8 || img_n == out_n) { + int nk = (width - 1)*filter_bytes; + #define STBI__CASE(f) \ + case f: \ + for (k=0; k < nk; ++k) + switch (filter) { + // "none" filter turns into a memcpy here; make that explicit. + case STBI__F_none: memcpy(cur, raw, nk); break; + STBI__CASE(STBI__F_sub) { cur[k] = STBI__BYTECAST(raw[k] + cur[k-filter_bytes]); } break; + STBI__CASE(STBI__F_up) { cur[k] = STBI__BYTECAST(raw[k] + prior[k]); } break; + STBI__CASE(STBI__F_avg) { cur[k] = STBI__BYTECAST(raw[k] + ((prior[k] + cur[k-filter_bytes])>>1)); } break; + STBI__CASE(STBI__F_paeth) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k-filter_bytes],prior[k],prior[k-filter_bytes])); } break; + STBI__CASE(STBI__F_avg_first) { cur[k] = STBI__BYTECAST(raw[k] + (cur[k-filter_bytes] >> 1)); } break; + STBI__CASE(STBI__F_paeth_first) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k-filter_bytes],0,0)); } break; + } + #undef STBI__CASE + raw += nk; + } else { + STBI_ASSERT(img_n+1 == out_n); + #define STBI__CASE(f) \ + case f: \ + for (i=x-1; i >= 1; --i, cur[filter_bytes]=255,raw+=filter_bytes,cur+=output_bytes,prior+=output_bytes) \ + for (k=0; k < filter_bytes; ++k) + switch (filter) { + STBI__CASE(STBI__F_none) { cur[k] = raw[k]; } break; + STBI__CASE(STBI__F_sub) { cur[k] = STBI__BYTECAST(raw[k] + cur[k- output_bytes]); } break; + STBI__CASE(STBI__F_up) { cur[k] = STBI__BYTECAST(raw[k] + prior[k]); } break; + STBI__CASE(STBI__F_avg) { cur[k] = STBI__BYTECAST(raw[k] + ((prior[k] + cur[k- output_bytes])>>1)); } break; + STBI__CASE(STBI__F_paeth) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k- output_bytes],prior[k],prior[k- output_bytes])); } break; + STBI__CASE(STBI__F_avg_first) { cur[k] = STBI__BYTECAST(raw[k] + (cur[k- output_bytes] >> 1)); } break; + STBI__CASE(STBI__F_paeth_first) { cur[k] = STBI__BYTECAST(raw[k] + stbi__paeth(cur[k- output_bytes],0,0)); } break; + } + #undef STBI__CASE + + // the loop above sets the high byte of the pixels' alpha, but for + // 16 bit png files we also need the low byte set. we'll do that here. + if (depth == 16) { + cur = a->out + stride*j; // start at the beginning of the row again + for (i=0; i < x; ++i,cur+=output_bytes) { + cur[filter_bytes+1] = 255; + } + } + } + } + + // we make a separate pass to expand bits to pixels; for performance, + // this could run two scanlines behind the above code, so it won't + // intefere with filtering but will still be in the cache. + if (depth < 8) { + for (j=0; j < y; ++j) { + stbi_uc *cur = a->out + stride*j; + stbi_uc *in = a->out + stride*j + x*out_n - img_width_bytes; + // unpack 1/2/4-bit into a 8-bit buffer. allows us to keep the common 8-bit path optimal at minimal cost for 1/2/4-bit + // png guarante byte alignment, if width is not multiple of 8/4/2 we'll decode dummy trailing data that will be skipped in the later loop + stbi_uc scale = (color == 0) ? stbi__depth_scale_table[depth] : 1; // scale grayscale values to 0..255 range + + // note that the final byte might overshoot and write more data than desired. + // we can allocate enough data that this never writes out of memory, but it + // could also overwrite the next scanline. can it overwrite non-empty data + // on the next scanline? yes, consider 1-pixel-wide scanlines with 1-bit-per-pixel. + // so we need to explicitly clamp the final ones + + if (depth == 4) { + for (k=x*img_n; k >= 2; k-=2, ++in) { + *cur++ = scale * ((*in >> 4) ); + *cur++ = scale * ((*in ) & 0x0f); + } + if (k > 0) *cur++ = scale * ((*in >> 4) ); + } else if (depth == 2) { + for (k=x*img_n; k >= 4; k-=4, ++in) { + *cur++ = scale * ((*in >> 6) ); + *cur++ = scale * ((*in >> 4) & 0x03); + *cur++ = scale * ((*in >> 2) & 0x03); + *cur++ = scale * ((*in ) & 0x03); + } + if (k > 0) *cur++ = scale * ((*in >> 6) ); + if (k > 1) *cur++ = scale * ((*in >> 4) & 0x03); + if (k > 2) *cur++ = scale * ((*in >> 2) & 0x03); + } else if (depth == 1) { + for (k=x*img_n; k >= 8; k-=8, ++in) { + *cur++ = scale * ((*in >> 7) ); + *cur++ = scale * ((*in >> 6) & 0x01); + *cur++ = scale * ((*in >> 5) & 0x01); + *cur++ = scale * ((*in >> 4) & 0x01); + *cur++ = scale * ((*in >> 3) & 0x01); + *cur++ = scale * ((*in >> 2) & 0x01); + *cur++ = scale * ((*in >> 1) & 0x01); + *cur++ = scale * ((*in ) & 0x01); + } + if (k > 0) *cur++ = scale * ((*in >> 7) ); + if (k > 1) *cur++ = scale * ((*in >> 6) & 0x01); + if (k > 2) *cur++ = scale * ((*in >> 5) & 0x01); + if (k > 3) *cur++ = scale * ((*in >> 4) & 0x01); + if (k > 4) *cur++ = scale * ((*in >> 3) & 0x01); + if (k > 5) *cur++ = scale * ((*in >> 2) & 0x01); + if (k > 6) *cur++ = scale * ((*in >> 1) & 0x01); + } + if (img_n != out_n) { + int q; + // insert alpha = 255 + cur = a->out + stride*j; + if (img_n == 1) { + for (q=x-1; q >= 0; --q) { + cur[q*2+1] = 255; + cur[q*2+0] = cur[q]; + } + } else { + STBI_ASSERT(img_n == 3); + for (q=x-1; q >= 0; --q) { + cur[q*4+3] = 255; + cur[q*4+2] = cur[q*3+2]; + cur[q*4+1] = cur[q*3+1]; + cur[q*4+0] = cur[q*3+0]; + } + } + } + } + } else if (depth == 16) { + // force the image data from big-endian to platform-native. + // this is done in a separate pass due to the decoding relying + // on the data being untouched, but could probably be done + // per-line during decode if care is taken. + stbi_uc *cur = a->out; + stbi__uint16 *cur16 = (stbi__uint16*)cur; + + for(i=0; i < x*y*out_n; ++i,cur16++,cur+=2) { + *cur16 = (cur[0] << 8) | cur[1]; + } + } + + return 1; +} + +static int stbi__create_png_image(stbi__png *a, stbi_uc *image_data, stbi__uint32 image_data_len, int out_n, int depth, int color, int interlaced) +{ + int bytes = (depth == 16 ? 2 : 1); + int out_bytes = out_n * bytes; + stbi_uc *final; + int p; + if (!interlaced) + return stbi__create_png_image_raw(a, image_data, image_data_len, out_n, a->s->img_x, a->s->img_y, depth, color); + + // de-interlacing + final = (stbi_uc *) stbi__malloc_mad3(a->s->img_x, a->s->img_y, out_bytes, 0); + if (!final) return stbi__err("outofmem", "Out of memory"); + for (p=0; p < 7; ++p) { + int xorig[] = { 0,4,0,2,0,1,0 }; + int yorig[] = { 0,0,4,0,2,0,1 }; + int xspc[] = { 8,8,4,4,2,2,1 }; + int yspc[] = { 8,8,8,4,4,2,2 }; + int i,j,x,y; + // pass1_x[4] = 0, pass1_x[5] = 1, pass1_x[12] = 1 + x = (a->s->img_x - xorig[p] + xspc[p]-1) / xspc[p]; + y = (a->s->img_y - yorig[p] + yspc[p]-1) / yspc[p]; + if (x && y) { + stbi__uint32 img_len = ((((a->s->img_n * x * depth) + 7) >> 3) + 1) * y; + if (!stbi__create_png_image_raw(a, image_data, image_data_len, out_n, x, y, depth, color)) { + STBI_FREE(final); + return 0; + } + for (j=0; j < y; ++j) { + for (i=0; i < x; ++i) { + int out_y = j*yspc[p]+yorig[p]; + int out_x = i*xspc[p]+xorig[p]; + memcpy(final + out_y*a->s->img_x*out_bytes + out_x*out_bytes, + a->out + (j*x+i)*out_bytes, out_bytes); + } + } + STBI_FREE(a->out); + image_data += img_len; + image_data_len -= img_len; + } + } + a->out = final; + + return 1; +} + +static int stbi__compute_transparency(stbi__png *z, stbi_uc tc[3], int out_n) +{ + stbi__context *s = z->s; + stbi__uint32 i, pixel_count = s->img_x * s->img_y; + stbi_uc *p = z->out; + + // compute color-based transparency, assuming we've + // already got 255 as the alpha value in the output + STBI_ASSERT(out_n == 2 || out_n == 4); + + if (out_n == 2) { + for (i=0; i < pixel_count; ++i) { + p[1] = (p[0] == tc[0] ? 0 : 255); + p += 2; + } + } else { + for (i=0; i < pixel_count; ++i) { + if (p[0] == tc[0] && p[1] == tc[1] && p[2] == tc[2]) + p[3] = 0; + p += 4; + } + } + return 1; +} + +static int stbi__compute_transparency16(stbi__png *z, stbi__uint16 tc[3], int out_n) +{ + stbi__context *s = z->s; + stbi__uint32 i, pixel_count = s->img_x * s->img_y; + stbi__uint16 *p = (stbi__uint16*) z->out; + + // compute color-based transparency, assuming we've + // already got 65535 as the alpha value in the output + STBI_ASSERT(out_n == 2 || out_n == 4); + + if (out_n == 2) { + for (i = 0; i < pixel_count; ++i) { + p[1] = (p[0] == tc[0] ? 0 : 65535); + p += 2; + } + } else { + for (i = 0; i < pixel_count; ++i) { + if (p[0] == tc[0] && p[1] == tc[1] && p[2] == tc[2]) + p[3] = 0; + p += 4; + } + } + return 1; +} + +static int stbi__expand_png_palette(stbi__png *a, stbi_uc *palette, int len, int pal_img_n) +{ + stbi__uint32 i, pixel_count = a->s->img_x * a->s->img_y; + stbi_uc *p, *temp_out, *orig = a->out; + + p = (stbi_uc *) stbi__malloc_mad2(pixel_count, pal_img_n, 0); + if (p == NULL) return stbi__err("outofmem", "Out of memory"); + + // between here and free(out) below, exitting would leak + temp_out = p; + + if (pal_img_n == 3) { + for (i=0; i < pixel_count; ++i) { + int n = orig[i]*4; + p[0] = palette[n ]; + p[1] = palette[n+1]; + p[2] = palette[n+2]; + p += 3; + } + } else { + for (i=0; i < pixel_count; ++i) { + int n = orig[i]*4; + p[0] = palette[n ]; + p[1] = palette[n+1]; + p[2] = palette[n+2]; + p[3] = palette[n+3]; + p += 4; + } + } + STBI_FREE(a->out); + a->out = temp_out; + + STBI_NOTUSED(len); + + return 1; +} + +static int stbi__unpremultiply_on_load_global = 0; +static int stbi__de_iphone_flag_global = 0; + +STBIDEF void stbi_set_unpremultiply_on_load(int flag_true_if_should_unpremultiply) +{ + stbi__unpremultiply_on_load_global = flag_true_if_should_unpremultiply; +} + +STBIDEF void stbi_convert_iphone_png_to_rgb(int flag_true_if_should_convert) +{ + stbi__de_iphone_flag_global = flag_true_if_should_convert; +} + +#ifndef STBI_THREAD_LOCAL +#define stbi__unpremultiply_on_load stbi__unpremultiply_on_load_global +#define stbi__de_iphone_flag stbi__de_iphone_flag_global +#else +static STBI_THREAD_LOCAL int stbi__unpremultiply_on_load_local, stbi__unpremultiply_on_load_set; +static STBI_THREAD_LOCAL int stbi__de_iphone_flag_local, stbi__de_iphone_flag_set; + +STBIDEF void stbi_set_unpremultiply_on_load_thread(int flag_true_if_should_unpremultiply) +{ + stbi__unpremultiply_on_load_local = flag_true_if_should_unpremultiply; + stbi__unpremultiply_on_load_set = 1; +} + +STBIDEF void stbi_convert_iphone_png_to_rgb_thread(int flag_true_if_should_convert) +{ + stbi__de_iphone_flag_local = flag_true_if_should_convert; + stbi__de_iphone_flag_set = 1; +} + +#define stbi__unpremultiply_on_load (stbi__unpremultiply_on_load_set \ + ? stbi__unpremultiply_on_load_local \ + : stbi__unpremultiply_on_load_global) +#define stbi__de_iphone_flag (stbi__de_iphone_flag_set \ + ? stbi__de_iphone_flag_local \ + : stbi__de_iphone_flag_global) +#endif // STBI_THREAD_LOCAL + +static void stbi__de_iphone(stbi__png *z) +{ + stbi__context *s = z->s; + stbi__uint32 i, pixel_count = s->img_x * s->img_y; + stbi_uc *p = z->out; + + if (s->img_out_n == 3) { // convert bgr to rgb + for (i=0; i < pixel_count; ++i) { + stbi_uc t = p[0]; + p[0] = p[2]; + p[2] = t; + p += 3; + } + } else { + STBI_ASSERT(s->img_out_n == 4); + if (stbi__unpremultiply_on_load) { + // convert bgr to rgb and unpremultiply + for (i=0; i < pixel_count; ++i) { + stbi_uc a = p[3]; + stbi_uc t = p[0]; + if (a) { + stbi_uc half = a / 2; + p[0] = (p[2] * 255 + half) / a; + p[1] = (p[1] * 255 + half) / a; + p[2] = ( t * 255 + half) / a; + } else { + p[0] = p[2]; + p[2] = t; + } + p += 4; + } + } else { + // convert bgr to rgb + for (i=0; i < pixel_count; ++i) { + stbi_uc t = p[0]; + p[0] = p[2]; + p[2] = t; + p += 4; + } + } + } +} + +#define STBI__PNG_TYPE(a,b,c,d) (((unsigned) (a) << 24) + ((unsigned) (b) << 16) + ((unsigned) (c) << 8) + (unsigned) (d)) + +static int stbi__parse_png_file(stbi__png *z, int scan, int req_comp) +{ + stbi_uc palette[1024], pal_img_n=0; + stbi_uc has_trans=0, tc[3]={0}; + stbi__uint16 tc16[3]; + stbi__uint32 ioff=0, idata_limit=0, i, pal_len=0; + int first=1,k,interlace=0, color=0, is_iphone=0; + stbi__context *s = z->s; + + z->expanded = NULL; + z->idata = NULL; + z->out = NULL; + + if (!stbi__check_png_header(s)) return 0; + + if (scan == STBI__SCAN_type) return 1; + + for (;;) { + stbi__pngchunk c = stbi__get_chunk_header(s); + switch (c.type) { + case STBI__PNG_TYPE('C','g','B','I'): + is_iphone = 1; + stbi__skip(s, c.length); + break; + case STBI__PNG_TYPE('I','H','D','R'): { + int comp,filter; + if (!first) return stbi__err("multiple IHDR","Corrupt PNG"); + first = 0; + if (c.length != 13) return stbi__err("bad IHDR len","Corrupt PNG"); + s->img_x = stbi__get32be(s); + s->img_y = stbi__get32be(s); + if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + z->depth = stbi__get8(s); if (z->depth != 1 && z->depth != 2 && z->depth != 4 && z->depth != 8 && z->depth != 16) return stbi__err("1/2/4/8/16-bit only","PNG not supported: 1/2/4/8/16-bit only"); + color = stbi__get8(s); if (color > 6) return stbi__err("bad ctype","Corrupt PNG"); + if (color == 3 && z->depth == 16) return stbi__err("bad ctype","Corrupt PNG"); + if (color == 3) pal_img_n = 3; else if (color & 1) return stbi__err("bad ctype","Corrupt PNG"); + comp = stbi__get8(s); if (comp) return stbi__err("bad comp method","Corrupt PNG"); + filter= stbi__get8(s); if (filter) return stbi__err("bad filter method","Corrupt PNG"); + interlace = stbi__get8(s); if (interlace>1) return stbi__err("bad interlace method","Corrupt PNG"); + if (!s->img_x || !s->img_y) return stbi__err("0-pixel image","Corrupt PNG"); + if (!pal_img_n) { + s->img_n = (color & 2 ? 3 : 1) + (color & 4 ? 1 : 0); + if ((1 << 30) / s->img_x / s->img_n < s->img_y) return stbi__err("too large", "Image too large to decode"); + } else { + // if paletted, then pal_n is our final components, and + // img_n is # components to decompress/filter. + s->img_n = 1; + if ((1 << 30) / s->img_x / 4 < s->img_y) return stbi__err("too large","Corrupt PNG"); + } + // even with SCAN_header, have to scan to see if we have a tRNS + break; + } + + case STBI__PNG_TYPE('P','L','T','E'): { + if (first) return stbi__err("first not IHDR", "Corrupt PNG"); + if (c.length > 256*3) return stbi__err("invalid PLTE","Corrupt PNG"); + pal_len = c.length / 3; + if (pal_len * 3 != c.length) return stbi__err("invalid PLTE","Corrupt PNG"); + for (i=0; i < pal_len; ++i) { + palette[i*4+0] = stbi__get8(s); + palette[i*4+1] = stbi__get8(s); + palette[i*4+2] = stbi__get8(s); + palette[i*4+3] = 255; + } + break; + } + + case STBI__PNG_TYPE('t','R','N','S'): { + if (first) return stbi__err("first not IHDR", "Corrupt PNG"); + if (z->idata) return stbi__err("tRNS after IDAT","Corrupt PNG"); + if (pal_img_n) { + if (scan == STBI__SCAN_header) { s->img_n = 4; return 1; } + if (pal_len == 0) return stbi__err("tRNS before PLTE","Corrupt PNG"); + if (c.length > pal_len) return stbi__err("bad tRNS len","Corrupt PNG"); + pal_img_n = 4; + for (i=0; i < c.length; ++i) + palette[i*4+3] = stbi__get8(s); + } else { + if (!(s->img_n & 1)) return stbi__err("tRNS with alpha","Corrupt PNG"); + if (c.length != (stbi__uint32) s->img_n*2) return stbi__err("bad tRNS len","Corrupt PNG"); + has_trans = 1; + // non-paletted with tRNS = constant alpha. if header-scanning, we can stop now. + if (scan == STBI__SCAN_header) { ++s->img_n; return 1; } + if (z->depth == 16) { + for (k = 0; k < s->img_n; ++k) tc16[k] = (stbi__uint16)stbi__get16be(s); // copy the values as-is + } else { + for (k = 0; k < s->img_n; ++k) tc[k] = (stbi_uc)(stbi__get16be(s) & 255) * stbi__depth_scale_table[z->depth]; // non 8-bit images will be larger + } + } + break; + } + + case STBI__PNG_TYPE('I','D','A','T'): { + if (first) return stbi__err("first not IHDR", "Corrupt PNG"); + if (pal_img_n && !pal_len) return stbi__err("no PLTE","Corrupt PNG"); + if (scan == STBI__SCAN_header) { + // header scan definitely stops at first IDAT + if (pal_img_n) + s->img_n = pal_img_n; + return 1; + } + if (c.length > (1u << 30)) return stbi__err("IDAT size limit", "IDAT section larger than 2^30 bytes"); + if ((int)(ioff + c.length) < (int)ioff) return 0; + if (ioff + c.length > idata_limit) { + stbi__uint32 idata_limit_old = idata_limit; + stbi_uc *p; + if (idata_limit == 0) idata_limit = c.length > 4096 ? c.length : 4096; + while (ioff + c.length > idata_limit) + idata_limit *= 2; + STBI_NOTUSED(idata_limit_old); + p = (stbi_uc *) STBI_REALLOC_SIZED(z->idata, idata_limit_old, idata_limit); if (p == NULL) return stbi__err("outofmem", "Out of memory"); + z->idata = p; + } + if (!stbi__getn(s, z->idata+ioff,c.length)) return stbi__err("outofdata","Corrupt PNG"); + ioff += c.length; + break; + } + + case STBI__PNG_TYPE('I','E','N','D'): { + stbi__uint32 raw_len, bpl; + if (first) return stbi__err("first not IHDR", "Corrupt PNG"); + if (scan != STBI__SCAN_load) return 1; + if (z->idata == NULL) return stbi__err("no IDAT","Corrupt PNG"); + // initial guess for decoded data size to avoid unnecessary reallocs + bpl = (s->img_x * z->depth + 7) / 8; // bytes per line, per component + raw_len = bpl * s->img_y * s->img_n /* pixels */ + s->img_y /* filter mode per row */; + z->expanded = (stbi_uc *) stbi_zlib_decode_malloc_guesssize_headerflag((char *) z->idata, ioff, raw_len, (int *) &raw_len, !is_iphone); + if (z->expanded == NULL) return 0; // zlib should set error + STBI_FREE(z->idata); z->idata = NULL; + if ((req_comp == s->img_n+1 && req_comp != 3 && !pal_img_n) || has_trans) + s->img_out_n = s->img_n+1; + else + s->img_out_n = s->img_n; + if (!stbi__create_png_image(z, z->expanded, raw_len, s->img_out_n, z->depth, color, interlace)) return 0; + if (has_trans) { + if (z->depth == 16) { + if (!stbi__compute_transparency16(z, tc16, s->img_out_n)) return 0; + } else { + if (!stbi__compute_transparency(z, tc, s->img_out_n)) return 0; + } + } + if (is_iphone && stbi__de_iphone_flag && s->img_out_n > 2) + stbi__de_iphone(z); + if (pal_img_n) { + // pal_img_n == 3 or 4 + s->img_n = pal_img_n; // record the actual colors we had + s->img_out_n = pal_img_n; + if (req_comp >= 3) s->img_out_n = req_comp; + if (!stbi__expand_png_palette(z, palette, pal_len, s->img_out_n)) + return 0; + } else if (has_trans) { + // non-paletted image with tRNS -> source image has (constant) alpha + ++s->img_n; + } + STBI_FREE(z->expanded); z->expanded = NULL; + // end of PNG chunk, read and skip CRC + stbi__get32be(s); + return 1; + } + + default: + // if critical, fail + if (first) return stbi__err("first not IHDR", "Corrupt PNG"); + if ((c.type & (1 << 29)) == 0) { + #ifndef STBI_NO_FAILURE_STRINGS + // not threadsafe + static char invalid_chunk[] = "XXXX PNG chunk not known"; + invalid_chunk[0] = STBI__BYTECAST(c.type >> 24); + invalid_chunk[1] = STBI__BYTECAST(c.type >> 16); + invalid_chunk[2] = STBI__BYTECAST(c.type >> 8); + invalid_chunk[3] = STBI__BYTECAST(c.type >> 0); + #endif + return stbi__err(invalid_chunk, "PNG not supported: unknown PNG chunk type"); + } + stbi__skip(s, c.length); + break; + } + // end of PNG chunk, read and skip CRC + stbi__get32be(s); + } +} + +static void *stbi__do_png(stbi__png *p, int *x, int *y, int *n, int req_comp, stbi__result_info *ri) +{ + void *result=NULL; + if (req_comp < 0 || req_comp > 4) return stbi__errpuc("bad req_comp", "Internal error"); + if (stbi__parse_png_file(p, STBI__SCAN_load, req_comp)) { + if (p->depth <= 8) + ri->bits_per_channel = 8; + else if (p->depth == 16) + ri->bits_per_channel = 16; + else + return stbi__errpuc("bad bits_per_channel", "PNG not supported: unsupported color depth"); + result = p->out; + p->out = NULL; + if (req_comp && req_comp != p->s->img_out_n) { + if (ri->bits_per_channel == 8) + result = stbi__convert_format((unsigned char *) result, p->s->img_out_n, req_comp, p->s->img_x, p->s->img_y); + else + result = stbi__convert_format16((stbi__uint16 *) result, p->s->img_out_n, req_comp, p->s->img_x, p->s->img_y); + p->s->img_out_n = req_comp; + if (result == NULL) return result; + } + *x = p->s->img_x; + *y = p->s->img_y; + if (n) *n = p->s->img_n; + } + STBI_FREE(p->out); p->out = NULL; + STBI_FREE(p->expanded); p->expanded = NULL; + STBI_FREE(p->idata); p->idata = NULL; + + return result; +} + +static void *stbi__png_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) +{ + stbi__png p; + p.s = s; + return stbi__do_png(&p, x,y,comp,req_comp, ri); +} + +static int stbi__png_test(stbi__context *s) +{ + int r; + r = stbi__check_png_header(s); + stbi__rewind(s); + return r; +} + +static int stbi__png_info_raw(stbi__png *p, int *x, int *y, int *comp) +{ + if (!stbi__parse_png_file(p, STBI__SCAN_header, 0)) { + stbi__rewind( p->s ); + return 0; + } + if (x) *x = p->s->img_x; + if (y) *y = p->s->img_y; + if (comp) *comp = p->s->img_n; + return 1; +} + +static int stbi__png_info(stbi__context *s, int *x, int *y, int *comp) +{ + stbi__png p; + p.s = s; + return stbi__png_info_raw(&p, x, y, comp); +} + +static int stbi__png_is16(stbi__context *s) +{ + stbi__png p; + p.s = s; + if (!stbi__png_info_raw(&p, NULL, NULL, NULL)) + return 0; + if (p.depth != 16) { + stbi__rewind(p.s); + return 0; + } + return 1; +} +#endif + +// Microsoft/Windows BMP image + +#ifndef STBI_NO_BMP +static int stbi__bmp_test_raw(stbi__context *s) +{ + int r; + int sz; + if (stbi__get8(s) != 'B') return 0; + if (stbi__get8(s) != 'M') return 0; + stbi__get32le(s); // discard filesize + stbi__get16le(s); // discard reserved + stbi__get16le(s); // discard reserved + stbi__get32le(s); // discard data offset + sz = stbi__get32le(s); + r = (sz == 12 || sz == 40 || sz == 56 || sz == 108 || sz == 124); + return r; +} + +static int stbi__bmp_test(stbi__context *s) +{ + int r = stbi__bmp_test_raw(s); + stbi__rewind(s); + return r; +} + + +// returns 0..31 for the highest set bit +static int stbi__high_bit(unsigned int z) +{ + int n=0; + if (z == 0) return -1; + if (z >= 0x10000) { n += 16; z >>= 16; } + if (z >= 0x00100) { n += 8; z >>= 8; } + if (z >= 0x00010) { n += 4; z >>= 4; } + if (z >= 0x00004) { n += 2; z >>= 2; } + if (z >= 0x00002) { n += 1;/* >>= 1;*/ } + return n; +} + +static int stbi__bitcount(unsigned int a) +{ + a = (a & 0x55555555) + ((a >> 1) & 0x55555555); // max 2 + a = (a & 0x33333333) + ((a >> 2) & 0x33333333); // max 4 + a = (a + (a >> 4)) & 0x0f0f0f0f; // max 8 per 4, now 8 bits + a = (a + (a >> 8)); // max 16 per 8 bits + a = (a + (a >> 16)); // max 32 per 8 bits + return a & 0xff; +} + +// extract an arbitrarily-aligned N-bit value (N=bits) +// from v, and then make it 8-bits long and fractionally +// extend it to full full range. +static int stbi__shiftsigned(unsigned int v, int shift, int bits) +{ + static unsigned int mul_table[9] = { + 0, + 0xff/*0b11111111*/, 0x55/*0b01010101*/, 0x49/*0b01001001*/, 0x11/*0b00010001*/, + 0x21/*0b00100001*/, 0x41/*0b01000001*/, 0x81/*0b10000001*/, 0x01/*0b00000001*/, + }; + static unsigned int shift_table[9] = { + 0, 0,0,1,0,2,4,6,0, + }; + if (shift < 0) + v <<= -shift; + else + v >>= shift; + STBI_ASSERT(v < 256); + v >>= (8-bits); + STBI_ASSERT(bits >= 0 && bits <= 8); + return (int) ((unsigned) v * mul_table[bits]) >> shift_table[bits]; +} + +typedef struct +{ + int bpp, offset, hsz; + unsigned int mr,mg,mb,ma, all_a; + int extra_read; +} stbi__bmp_data; + +static int stbi__bmp_set_mask_defaults(stbi__bmp_data *info, int compress) +{ + // BI_BITFIELDS specifies masks explicitly, don't override + if (compress == 3) + return 1; + + if (compress == 0) { + if (info->bpp == 16) { + info->mr = 31u << 10; + info->mg = 31u << 5; + info->mb = 31u << 0; + } else if (info->bpp == 32) { + info->mr = 0xffu << 16; + info->mg = 0xffu << 8; + info->mb = 0xffu << 0; + info->ma = 0xffu << 24; + info->all_a = 0; // if all_a is 0 at end, then we loaded alpha channel but it was all 0 + } else { + // otherwise, use defaults, which is all-0 + info->mr = info->mg = info->mb = info->ma = 0; + } + return 1; + } + return 0; // error +} + +static void *stbi__bmp_parse_header(stbi__context *s, stbi__bmp_data *info) +{ + int hsz; + if (stbi__get8(s) != 'B' || stbi__get8(s) != 'M') return stbi__errpuc("not BMP", "Corrupt BMP"); + stbi__get32le(s); // discard filesize + stbi__get16le(s); // discard reserved + stbi__get16le(s); // discard reserved + info->offset = stbi__get32le(s); + info->hsz = hsz = stbi__get32le(s); + info->mr = info->mg = info->mb = info->ma = 0; + info->extra_read = 14; + + if (info->offset < 0) return stbi__errpuc("bad BMP", "bad BMP"); + + if (hsz != 12 && hsz != 40 && hsz != 56 && hsz != 108 && hsz != 124) return stbi__errpuc("unknown BMP", "BMP type not supported: unknown"); + if (hsz == 12) { + s->img_x = stbi__get16le(s); + s->img_y = stbi__get16le(s); + } else { + s->img_x = stbi__get32le(s); + s->img_y = stbi__get32le(s); + } + if (stbi__get16le(s) != 1) return stbi__errpuc("bad BMP", "bad BMP"); + info->bpp = stbi__get16le(s); + if (hsz != 12) { + int compress = stbi__get32le(s); + if (compress == 1 || compress == 2) return stbi__errpuc("BMP RLE", "BMP type not supported: RLE"); + if (compress >= 4) return stbi__errpuc("BMP JPEG/PNG", "BMP type not supported: unsupported compression"); // this includes PNG/JPEG modes + if (compress == 3 && info->bpp != 16 && info->bpp != 32) return stbi__errpuc("bad BMP", "bad BMP"); // bitfields requires 16 or 32 bits/pixel + stbi__get32le(s); // discard sizeof + stbi__get32le(s); // discard hres + stbi__get32le(s); // discard vres + stbi__get32le(s); // discard colorsused + stbi__get32le(s); // discard max important + if (hsz == 40 || hsz == 56) { + if (hsz == 56) { + stbi__get32le(s); + stbi__get32le(s); + stbi__get32le(s); + stbi__get32le(s); + } + if (info->bpp == 16 || info->bpp == 32) { + if (compress == 0) { + stbi__bmp_set_mask_defaults(info, compress); + } else if (compress == 3) { + info->mr = stbi__get32le(s); + info->mg = stbi__get32le(s); + info->mb = stbi__get32le(s); + info->extra_read += 12; + // not documented, but generated by photoshop and handled by mspaint + if (info->mr == info->mg && info->mg == info->mb) { + // ?!?!? + return stbi__errpuc("bad BMP", "bad BMP"); + } + } else + return stbi__errpuc("bad BMP", "bad BMP"); + } + } else { + // V4/V5 header + int i; + if (hsz != 108 && hsz != 124) + return stbi__errpuc("bad BMP", "bad BMP"); + info->mr = stbi__get32le(s); + info->mg = stbi__get32le(s); + info->mb = stbi__get32le(s); + info->ma = stbi__get32le(s); + if (compress != 3) // override mr/mg/mb unless in BI_BITFIELDS mode, as per docs + stbi__bmp_set_mask_defaults(info, compress); + stbi__get32le(s); // discard color space + for (i=0; i < 12; ++i) + stbi__get32le(s); // discard color space parameters + if (hsz == 124) { + stbi__get32le(s); // discard rendering intent + stbi__get32le(s); // discard offset of profile data + stbi__get32le(s); // discard size of profile data + stbi__get32le(s); // discard reserved + } + } + } + return (void *) 1; +} + + +static void *stbi__bmp_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) +{ + stbi_uc *out; + unsigned int mr=0,mg=0,mb=0,ma=0, all_a; + stbi_uc pal[256][4]; + int psize=0,i,j,width; + int flip_vertically, pad, target; + stbi__bmp_data info; + STBI_NOTUSED(ri); + + info.all_a = 255; + if (stbi__bmp_parse_header(s, &info) == NULL) + return NULL; // error code already set + + flip_vertically = ((int) s->img_y) > 0; + s->img_y = abs((int) s->img_y); + + if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + + mr = info.mr; + mg = info.mg; + mb = info.mb; + ma = info.ma; + all_a = info.all_a; + + if (info.hsz == 12) { + if (info.bpp < 24) + psize = (info.offset - info.extra_read - 24) / 3; + } else { + if (info.bpp < 16) + psize = (info.offset - info.extra_read - info.hsz) >> 2; + } + if (psize == 0) { + // accept some number of extra bytes after the header, but if the offset points either to before + // the header ends or implies a large amount of extra data, reject the file as malformed + int bytes_read_so_far = s->callback_already_read + (int)(s->img_buffer - s->img_buffer_original); + int header_limit = 1024; // max we actually read is below 256 bytes currently. + int extra_data_limit = 256*4; // what ordinarily goes here is a palette; 256 entries*4 bytes is its max size. + if (bytes_read_so_far <= 0 || bytes_read_so_far > header_limit) { + return stbi__errpuc("bad header", "Corrupt BMP"); + } + // we established that bytes_read_so_far is positive and sensible. + // the first half of this test rejects offsets that are either too small positives, or + // negative, and guarantees that info.offset >= bytes_read_so_far > 0. this in turn + // ensures the number computed in the second half of the test can't overflow. + if (info.offset < bytes_read_so_far || info.offset - bytes_read_so_far > extra_data_limit) { + return stbi__errpuc("bad offset", "Corrupt BMP"); + } else { + stbi__skip(s, info.offset - bytes_read_so_far); + } + } + + if (info.bpp == 24 && ma == 0xff000000) + s->img_n = 3; + else + s->img_n = ma ? 4 : 3; + if (req_comp && req_comp >= 3) // we can directly decode 3 or 4 + target = req_comp; + else + target = s->img_n; // if they want monochrome, we'll post-convert + + // sanity-check size + if (!stbi__mad3sizes_valid(target, s->img_x, s->img_y, 0)) + return stbi__errpuc("too large", "Corrupt BMP"); + + out = (stbi_uc *) stbi__malloc_mad3(target, s->img_x, s->img_y, 0); + if (!out) return stbi__errpuc("outofmem", "Out of memory"); + if (info.bpp < 16) { + int z=0; + if (psize == 0 || psize > 256) { STBI_FREE(out); return stbi__errpuc("invalid", "Corrupt BMP"); } + for (i=0; i < psize; ++i) { + pal[i][2] = stbi__get8(s); + pal[i][1] = stbi__get8(s); + pal[i][0] = stbi__get8(s); + if (info.hsz != 12) stbi__get8(s); + pal[i][3] = 255; + } + stbi__skip(s, info.offset - info.extra_read - info.hsz - psize * (info.hsz == 12 ? 3 : 4)); + if (info.bpp == 1) width = (s->img_x + 7) >> 3; + else if (info.bpp == 4) width = (s->img_x + 1) >> 1; + else if (info.bpp == 8) width = s->img_x; + else { STBI_FREE(out); return stbi__errpuc("bad bpp", "Corrupt BMP"); } + pad = (-width)&3; + if (info.bpp == 1) { + for (j=0; j < (int) s->img_y; ++j) { + int bit_offset = 7, v = stbi__get8(s); + for (i=0; i < (int) s->img_x; ++i) { + int color = (v>>bit_offset)&0x1; + out[z++] = pal[color][0]; + out[z++] = pal[color][1]; + out[z++] = pal[color][2]; + if (target == 4) out[z++] = 255; + if (i+1 == (int) s->img_x) break; + if((--bit_offset) < 0) { + bit_offset = 7; + v = stbi__get8(s); + } + } + stbi__skip(s, pad); + } + } else { + for (j=0; j < (int) s->img_y; ++j) { + for (i=0; i < (int) s->img_x; i += 2) { + int v=stbi__get8(s),v2=0; + if (info.bpp == 4) { + v2 = v & 15; + v >>= 4; + } + out[z++] = pal[v][0]; + out[z++] = pal[v][1]; + out[z++] = pal[v][2]; + if (target == 4) out[z++] = 255; + if (i+1 == (int) s->img_x) break; + v = (info.bpp == 8) ? stbi__get8(s) : v2; + out[z++] = pal[v][0]; + out[z++] = pal[v][1]; + out[z++] = pal[v][2]; + if (target == 4) out[z++] = 255; + } + stbi__skip(s, pad); + } + } + } else { + int rshift=0,gshift=0,bshift=0,ashift=0,rcount=0,gcount=0,bcount=0,acount=0; + int z = 0; + int easy=0; + stbi__skip(s, info.offset - info.extra_read - info.hsz); + if (info.bpp == 24) width = 3 * s->img_x; + else if (info.bpp == 16) width = 2*s->img_x; + else /* bpp = 32 and pad = 0 */ width=0; + pad = (-width) & 3; + if (info.bpp == 24) { + easy = 1; + } else if (info.bpp == 32) { + if (mb == 0xff && mg == 0xff00 && mr == 0x00ff0000 && ma == 0xff000000) + easy = 2; + } + if (!easy) { + if (!mr || !mg || !mb) { STBI_FREE(out); return stbi__errpuc("bad masks", "Corrupt BMP"); } + // right shift amt to put high bit in position #7 + rshift = stbi__high_bit(mr)-7; rcount = stbi__bitcount(mr); + gshift = stbi__high_bit(mg)-7; gcount = stbi__bitcount(mg); + bshift = stbi__high_bit(mb)-7; bcount = stbi__bitcount(mb); + ashift = stbi__high_bit(ma)-7; acount = stbi__bitcount(ma); + if (rcount > 8 || gcount > 8 || bcount > 8 || acount > 8) { STBI_FREE(out); return stbi__errpuc("bad masks", "Corrupt BMP"); } + } + for (j=0; j < (int) s->img_y; ++j) { + if (easy) { + for (i=0; i < (int) s->img_x; ++i) { + unsigned char a; + out[z+2] = stbi__get8(s); + out[z+1] = stbi__get8(s); + out[z+0] = stbi__get8(s); + z += 3; + a = (easy == 2 ? stbi__get8(s) : 255); + all_a |= a; + if (target == 4) out[z++] = a; + } + } else { + int bpp = info.bpp; + for (i=0; i < (int) s->img_x; ++i) { + stbi__uint32 v = (bpp == 16 ? (stbi__uint32) stbi__get16le(s) : stbi__get32le(s)); + unsigned int a; + out[z++] = STBI__BYTECAST(stbi__shiftsigned(v & mr, rshift, rcount)); + out[z++] = STBI__BYTECAST(stbi__shiftsigned(v & mg, gshift, gcount)); + out[z++] = STBI__BYTECAST(stbi__shiftsigned(v & mb, bshift, bcount)); + a = (ma ? stbi__shiftsigned(v & ma, ashift, acount) : 255); + all_a |= a; + if (target == 4) out[z++] = STBI__BYTECAST(a); + } + } + stbi__skip(s, pad); + } + } + + // if alpha channel is all 0s, replace with all 255s + if (target == 4 && all_a == 0) + for (i=4*s->img_x*s->img_y-1; i >= 0; i -= 4) + out[i] = 255; + + if (flip_vertically) { + stbi_uc t; + for (j=0; j < (int) s->img_y>>1; ++j) { + stbi_uc *p1 = out + j *s->img_x*target; + stbi_uc *p2 = out + (s->img_y-1-j)*s->img_x*target; + for (i=0; i < (int) s->img_x*target; ++i) { + t = p1[i]; p1[i] = p2[i]; p2[i] = t; + } + } + } + + if (req_comp && req_comp != target) { + out = stbi__convert_format(out, target, req_comp, s->img_x, s->img_y); + if (out == NULL) return out; // stbi__convert_format frees input on failure + } + + *x = s->img_x; + *y = s->img_y; + if (comp) *comp = s->img_n; + return out; +} +#endif + +// Targa Truevision - TGA +// by Jonathan Dummer +#ifndef STBI_NO_TGA +// returns STBI_rgb or whatever, 0 on error +static int stbi__tga_get_comp(int bits_per_pixel, int is_grey, int* is_rgb16) +{ + // only RGB or RGBA (incl. 16bit) or grey allowed + if (is_rgb16) *is_rgb16 = 0; + switch(bits_per_pixel) { + case 8: return STBI_grey; + case 16: if(is_grey) return STBI_grey_alpha; + // fallthrough + case 15: if(is_rgb16) *is_rgb16 = 1; + return STBI_rgb; + case 24: // fallthrough + case 32: return bits_per_pixel/8; + default: return 0; + } +} + +static int stbi__tga_info(stbi__context *s, int *x, int *y, int *comp) +{ + int tga_w, tga_h, tga_comp, tga_image_type, tga_bits_per_pixel, tga_colormap_bpp; + int sz, tga_colormap_type; + stbi__get8(s); // discard Offset + tga_colormap_type = stbi__get8(s); // colormap type + if( tga_colormap_type > 1 ) { + stbi__rewind(s); + return 0; // only RGB or indexed allowed + } + tga_image_type = stbi__get8(s); // image type + if ( tga_colormap_type == 1 ) { // colormapped (paletted) image + if (tga_image_type != 1 && tga_image_type != 9) { + stbi__rewind(s); + return 0; + } + stbi__skip(s,4); // skip index of first colormap entry and number of entries + sz = stbi__get8(s); // check bits per palette color entry + if ( (sz != 8) && (sz != 15) && (sz != 16) && (sz != 24) && (sz != 32) ) { + stbi__rewind(s); + return 0; + } + stbi__skip(s,4); // skip image x and y origin + tga_colormap_bpp = sz; + } else { // "normal" image w/o colormap - only RGB or grey allowed, +/- RLE + if ( (tga_image_type != 2) && (tga_image_type != 3) && (tga_image_type != 10) && (tga_image_type != 11) ) { + stbi__rewind(s); + return 0; // only RGB or grey allowed, +/- RLE + } + stbi__skip(s,9); // skip colormap specification and image x/y origin + tga_colormap_bpp = 0; + } + tga_w = stbi__get16le(s); + if( tga_w < 1 ) { + stbi__rewind(s); + return 0; // test width + } + tga_h = stbi__get16le(s); + if( tga_h < 1 ) { + stbi__rewind(s); + return 0; // test height + } + tga_bits_per_pixel = stbi__get8(s); // bits per pixel + stbi__get8(s); // ignore alpha bits + if (tga_colormap_bpp != 0) { + if((tga_bits_per_pixel != 8) && (tga_bits_per_pixel != 16)) { + // when using a colormap, tga_bits_per_pixel is the size of the indexes + // I don't think anything but 8 or 16bit indexes makes sense + stbi__rewind(s); + return 0; + } + tga_comp = stbi__tga_get_comp(tga_colormap_bpp, 0, NULL); + } else { + tga_comp = stbi__tga_get_comp(tga_bits_per_pixel, (tga_image_type == 3) || (tga_image_type == 11), NULL); + } + if(!tga_comp) { + stbi__rewind(s); + return 0; + } + if (x) *x = tga_w; + if (y) *y = tga_h; + if (comp) *comp = tga_comp; + return 1; // seems to have passed everything +} + +static int stbi__tga_test(stbi__context *s) +{ + int res = 0; + int sz, tga_color_type; + stbi__get8(s); // discard Offset + tga_color_type = stbi__get8(s); // color type + if ( tga_color_type > 1 ) goto errorEnd; // only RGB or indexed allowed + sz = stbi__get8(s); // image type + if ( tga_color_type == 1 ) { // colormapped (paletted) image + if (sz != 1 && sz != 9) goto errorEnd; // colortype 1 demands image type 1 or 9 + stbi__skip(s,4); // skip index of first colormap entry and number of entries + sz = stbi__get8(s); // check bits per palette color entry + if ( (sz != 8) && (sz != 15) && (sz != 16) && (sz != 24) && (sz != 32) ) goto errorEnd; + stbi__skip(s,4); // skip image x and y origin + } else { // "normal" image w/o colormap + if ( (sz != 2) && (sz != 3) && (sz != 10) && (sz != 11) ) goto errorEnd; // only RGB or grey allowed, +/- RLE + stbi__skip(s,9); // skip colormap specification and image x/y origin + } + if ( stbi__get16le(s) < 1 ) goto errorEnd; // test width + if ( stbi__get16le(s) < 1 ) goto errorEnd; // test height + sz = stbi__get8(s); // bits per pixel + if ( (tga_color_type == 1) && (sz != 8) && (sz != 16) ) goto errorEnd; // for colormapped images, bpp is size of an index + if ( (sz != 8) && (sz != 15) && (sz != 16) && (sz != 24) && (sz != 32) ) goto errorEnd; + + res = 1; // if we got this far, everything's good and we can return 1 instead of 0 + +errorEnd: + stbi__rewind(s); + return res; +} + +// read 16bit value and convert to 24bit RGB +static void stbi__tga_read_rgb16(stbi__context *s, stbi_uc* out) +{ + stbi__uint16 px = (stbi__uint16)stbi__get16le(s); + stbi__uint16 fiveBitMask = 31; + // we have 3 channels with 5bits each + int r = (px >> 10) & fiveBitMask; + int g = (px >> 5) & fiveBitMask; + int b = px & fiveBitMask; + // Note that this saves the data in RGB(A) order, so it doesn't need to be swapped later + out[0] = (stbi_uc)((r * 255)/31); + out[1] = (stbi_uc)((g * 255)/31); + out[2] = (stbi_uc)((b * 255)/31); + + // some people claim that the most significant bit might be used for alpha + // (possibly if an alpha-bit is set in the "image descriptor byte") + // but that only made 16bit test images completely translucent.. + // so let's treat all 15 and 16bit TGAs as RGB with no alpha. +} + +static void *stbi__tga_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) +{ + // read in the TGA header stuff + int tga_offset = stbi__get8(s); + int tga_indexed = stbi__get8(s); + int tga_image_type = stbi__get8(s); + int tga_is_RLE = 0; + int tga_palette_start = stbi__get16le(s); + int tga_palette_len = stbi__get16le(s); + int tga_palette_bits = stbi__get8(s); + int tga_x_origin = stbi__get16le(s); + int tga_y_origin = stbi__get16le(s); + int tga_width = stbi__get16le(s); + int tga_height = stbi__get16le(s); + int tga_bits_per_pixel = stbi__get8(s); + int tga_comp, tga_rgb16=0; + int tga_inverted = stbi__get8(s); + // int tga_alpha_bits = tga_inverted & 15; // the 4 lowest bits - unused (useless?) + // image data + unsigned char *tga_data; + unsigned char *tga_palette = NULL; + int i, j; + unsigned char raw_data[4] = {0}; + int RLE_count = 0; + int RLE_repeating = 0; + int read_next_pixel = 1; + STBI_NOTUSED(ri); + STBI_NOTUSED(tga_x_origin); // @TODO + STBI_NOTUSED(tga_y_origin); // @TODO + + if (tga_height > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + if (tga_width > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + + // do a tiny bit of precessing + if ( tga_image_type >= 8 ) + { + tga_image_type -= 8; + tga_is_RLE = 1; + } + tga_inverted = 1 - ((tga_inverted >> 5) & 1); + + // If I'm paletted, then I'll use the number of bits from the palette + if ( tga_indexed ) tga_comp = stbi__tga_get_comp(tga_palette_bits, 0, &tga_rgb16); + else tga_comp = stbi__tga_get_comp(tga_bits_per_pixel, (tga_image_type == 3), &tga_rgb16); + + if(!tga_comp) // shouldn't really happen, stbi__tga_test() should have ensured basic consistency + return stbi__errpuc("bad format", "Can't find out TGA pixelformat"); + + // tga info + *x = tga_width; + *y = tga_height; + if (comp) *comp = tga_comp; + + if (!stbi__mad3sizes_valid(tga_width, tga_height, tga_comp, 0)) + return stbi__errpuc("too large", "Corrupt TGA"); + + tga_data = (unsigned char*)stbi__malloc_mad3(tga_width, tga_height, tga_comp, 0); + if (!tga_data) return stbi__errpuc("outofmem", "Out of memory"); + + // skip to the data's starting position (offset usually = 0) + stbi__skip(s, tga_offset ); + + if ( !tga_indexed && !tga_is_RLE && !tga_rgb16 ) { + for (i=0; i < tga_height; ++i) { + int row = tga_inverted ? tga_height -i - 1 : i; + stbi_uc *tga_row = tga_data + row*tga_width*tga_comp; + stbi__getn(s, tga_row, tga_width * tga_comp); + } + } else { + // do I need to load a palette? + if ( tga_indexed) + { + if (tga_palette_len == 0) { /* you have to have at least one entry! */ + STBI_FREE(tga_data); + return stbi__errpuc("bad palette", "Corrupt TGA"); + } + + // any data to skip? (offset usually = 0) + stbi__skip(s, tga_palette_start ); + // load the palette + tga_palette = (unsigned char*)stbi__malloc_mad2(tga_palette_len, tga_comp, 0); + if (!tga_palette) { + STBI_FREE(tga_data); + return stbi__errpuc("outofmem", "Out of memory"); + } + if (tga_rgb16) { + stbi_uc *pal_entry = tga_palette; + STBI_ASSERT(tga_comp == STBI_rgb); + for (i=0; i < tga_palette_len; ++i) { + stbi__tga_read_rgb16(s, pal_entry); + pal_entry += tga_comp; + } + } else if (!stbi__getn(s, tga_palette, tga_palette_len * tga_comp)) { + STBI_FREE(tga_data); + STBI_FREE(tga_palette); + return stbi__errpuc("bad palette", "Corrupt TGA"); + } + } + // load the data + for (i=0; i < tga_width * tga_height; ++i) + { + // if I'm in RLE mode, do I need to get a RLE stbi__pngchunk? + if ( tga_is_RLE ) + { + if ( RLE_count == 0 ) + { + // yep, get the next byte as a RLE command + int RLE_cmd = stbi__get8(s); + RLE_count = 1 + (RLE_cmd & 127); + RLE_repeating = RLE_cmd >> 7; + read_next_pixel = 1; + } else if ( !RLE_repeating ) + { + read_next_pixel = 1; + } + } else + { + read_next_pixel = 1; + } + // OK, if I need to read a pixel, do it now + if ( read_next_pixel ) + { + // load however much data we did have + if ( tga_indexed ) + { + // read in index, then perform the lookup + int pal_idx = (tga_bits_per_pixel == 8) ? stbi__get8(s) : stbi__get16le(s); + if ( pal_idx >= tga_palette_len ) { + // invalid index + pal_idx = 0; + } + pal_idx *= tga_comp; + for (j = 0; j < tga_comp; ++j) { + raw_data[j] = tga_palette[pal_idx+j]; + } + } else if(tga_rgb16) { + STBI_ASSERT(tga_comp == STBI_rgb); + stbi__tga_read_rgb16(s, raw_data); + } else { + // read in the data raw + for (j = 0; j < tga_comp; ++j) { + raw_data[j] = stbi__get8(s); + } + } + // clear the reading flag for the next pixel + read_next_pixel = 0; + } // end of reading a pixel + + // copy data + for (j = 0; j < tga_comp; ++j) + tga_data[i*tga_comp+j] = raw_data[j]; + + // in case we're in RLE mode, keep counting down + --RLE_count; + } + // do I need to invert the image? + if ( tga_inverted ) + { + for (j = 0; j*2 < tga_height; ++j) + { + int index1 = j * tga_width * tga_comp; + int index2 = (tga_height - 1 - j) * tga_width * tga_comp; + for (i = tga_width * tga_comp; i > 0; --i) + { + unsigned char temp = tga_data[index1]; + tga_data[index1] = tga_data[index2]; + tga_data[index2] = temp; + ++index1; + ++index2; + } + } + } + // clear my palette, if I had one + if ( tga_palette != NULL ) + { + STBI_FREE( tga_palette ); + } + } + + // swap RGB - if the source data was RGB16, it already is in the right order + if (tga_comp >= 3 && !tga_rgb16) + { + unsigned char* tga_pixel = tga_data; + for (i=0; i < tga_width * tga_height; ++i) + { + unsigned char temp = tga_pixel[0]; + tga_pixel[0] = tga_pixel[2]; + tga_pixel[2] = temp; + tga_pixel += tga_comp; + } + } + + // convert to target component count + if (req_comp && req_comp != tga_comp) + tga_data = stbi__convert_format(tga_data, tga_comp, req_comp, tga_width, tga_height); + + // the things I do to get rid of an error message, and yet keep + // Microsoft's C compilers happy... [8^( + tga_palette_start = tga_palette_len = tga_palette_bits = + tga_x_origin = tga_y_origin = 0; + STBI_NOTUSED(tga_palette_start); + // OK, done + return tga_data; +} +#endif + +// ************************************************************************************************* +// Photoshop PSD loader -- PD by Thatcher Ulrich, integration by Nicolas Schulz, tweaked by STB + +#ifndef STBI_NO_PSD +static int stbi__psd_test(stbi__context *s) +{ + int r = (stbi__get32be(s) == 0x38425053); + stbi__rewind(s); + return r; +} + +static int stbi__psd_decode_rle(stbi__context *s, stbi_uc *p, int pixelCount) +{ + int count, nleft, len; + + count = 0; + while ((nleft = pixelCount - count) > 0) { + len = stbi__get8(s); + if (len == 128) { + // No-op. + } else if (len < 128) { + // Copy next len+1 bytes literally. + len++; + if (len > nleft) return 0; // corrupt data + count += len; + while (len) { + *p = stbi__get8(s); + p += 4; + len--; + } + } else if (len > 128) { + stbi_uc val; + // Next -len+1 bytes in the dest are replicated from next source byte. + // (Interpret len as a negative 8-bit int.) + len = 257 - len; + if (len > nleft) return 0; // corrupt data + val = stbi__get8(s); + count += len; + while (len) { + *p = val; + p += 4; + len--; + } + } + } + + return 1; +} + +static void *stbi__psd_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri, int bpc) +{ + int pixelCount; + int channelCount, compression; + int channel, i; + int bitdepth; + int w,h; + stbi_uc *out; + STBI_NOTUSED(ri); + + // Check identifier + if (stbi__get32be(s) != 0x38425053) // "8BPS" + return stbi__errpuc("not PSD", "Corrupt PSD image"); + + // Check file type version. + if (stbi__get16be(s) != 1) + return stbi__errpuc("wrong version", "Unsupported version of PSD image"); + + // Skip 6 reserved bytes. + stbi__skip(s, 6 ); + + // Read the number of channels (R, G, B, A, etc). + channelCount = stbi__get16be(s); + if (channelCount < 0 || channelCount > 16) + return stbi__errpuc("wrong channel count", "Unsupported number of channels in PSD image"); + + // Read the rows and columns of the image. + h = stbi__get32be(s); + w = stbi__get32be(s); + + if (h > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + if (w > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + + // Make sure the depth is 8 bits. + bitdepth = stbi__get16be(s); + if (bitdepth != 8 && bitdepth != 16) + return stbi__errpuc("unsupported bit depth", "PSD bit depth is not 8 or 16 bit"); + + // Make sure the color mode is RGB. + // Valid options are: + // 0: Bitmap + // 1: Grayscale + // 2: Indexed color + // 3: RGB color + // 4: CMYK color + // 7: Multichannel + // 8: Duotone + // 9: Lab color + if (stbi__get16be(s) != 3) + return stbi__errpuc("wrong color format", "PSD is not in RGB color format"); + + // Skip the Mode Data. (It's the palette for indexed color; other info for other modes.) + stbi__skip(s,stbi__get32be(s) ); + + // Skip the image resources. (resolution, pen tool paths, etc) + stbi__skip(s, stbi__get32be(s) ); + + // Skip the reserved data. + stbi__skip(s, stbi__get32be(s) ); + + // Find out if the data is compressed. + // Known values: + // 0: no compression + // 1: RLE compressed + compression = stbi__get16be(s); + if (compression > 1) + return stbi__errpuc("bad compression", "PSD has an unknown compression format"); + + // Check size + if (!stbi__mad3sizes_valid(4, w, h, 0)) + return stbi__errpuc("too large", "Corrupt PSD"); + + // Create the destination image. + + if (!compression && bitdepth == 16 && bpc == 16) { + out = (stbi_uc *) stbi__malloc_mad3(8, w, h, 0); + ri->bits_per_channel = 16; + } else + out = (stbi_uc *) stbi__malloc(4 * w*h); + + if (!out) return stbi__errpuc("outofmem", "Out of memory"); + pixelCount = w*h; + + // Initialize the data to zero. + //memset( out, 0, pixelCount * 4 ); + + // Finally, the image data. + if (compression) { + // RLE as used by .PSD and .TIFF + // Loop until you get the number of unpacked bytes you are expecting: + // Read the next source byte into n. + // If n is between 0 and 127 inclusive, copy the next n+1 bytes literally. + // Else if n is between -127 and -1 inclusive, copy the next byte -n+1 times. + // Else if n is 128, noop. + // Endloop + + // The RLE-compressed data is preceded by a 2-byte data count for each row in the data, + // which we're going to just skip. + stbi__skip(s, h * channelCount * 2 ); + + // Read the RLE data by channel. + for (channel = 0; channel < 4; channel++) { + stbi_uc *p; + + p = out+channel; + if (channel >= channelCount) { + // Fill this channel with default data. + for (i = 0; i < pixelCount; i++, p += 4) + *p = (channel == 3 ? 255 : 0); + } else { + // Read the RLE data. + if (!stbi__psd_decode_rle(s, p, pixelCount)) { + STBI_FREE(out); + return stbi__errpuc("corrupt", "bad RLE data"); + } + } + } + + } else { + // We're at the raw image data. It's each channel in order (Red, Green, Blue, Alpha, ...) + // where each channel consists of an 8-bit (or 16-bit) value for each pixel in the image. + + // Read the data by channel. + for (channel = 0; channel < 4; channel++) { + if (channel >= channelCount) { + // Fill this channel with default data. + if (bitdepth == 16 && bpc == 16) { + stbi__uint16 *q = ((stbi__uint16 *) out) + channel; + stbi__uint16 val = channel == 3 ? 65535 : 0; + for (i = 0; i < pixelCount; i++, q += 4) + *q = val; + } else { + stbi_uc *p = out+channel; + stbi_uc val = channel == 3 ? 255 : 0; + for (i = 0; i < pixelCount; i++, p += 4) + *p = val; + } + } else { + if (ri->bits_per_channel == 16) { // output bpc + stbi__uint16 *q = ((stbi__uint16 *) out) + channel; + for (i = 0; i < pixelCount; i++, q += 4) + *q = (stbi__uint16) stbi__get16be(s); + } else { + stbi_uc *p = out+channel; + if (bitdepth == 16) { // input bpc + for (i = 0; i < pixelCount; i++, p += 4) + *p = (stbi_uc) (stbi__get16be(s) >> 8); + } else { + for (i = 0; i < pixelCount; i++, p += 4) + *p = stbi__get8(s); + } + } + } + } + } + + // remove weird white matte from PSD + if (channelCount >= 4) { + if (ri->bits_per_channel == 16) { + for (i=0; i < w*h; ++i) { + stbi__uint16 *pixel = (stbi__uint16 *) out + 4*i; + if (pixel[3] != 0 && pixel[3] != 65535) { + float a = pixel[3] / 65535.0f; + float ra = 1.0f / a; + float inv_a = 65535.0f * (1 - ra); + pixel[0] = (stbi__uint16) (pixel[0]*ra + inv_a); + pixel[1] = (stbi__uint16) (pixel[1]*ra + inv_a); + pixel[2] = (stbi__uint16) (pixel[2]*ra + inv_a); + } + } + } else { + for (i=0; i < w*h; ++i) { + unsigned char *pixel = out + 4*i; + if (pixel[3] != 0 && pixel[3] != 255) { + float a = pixel[3] / 255.0f; + float ra = 1.0f / a; + float inv_a = 255.0f * (1 - ra); + pixel[0] = (unsigned char) (pixel[0]*ra + inv_a); + pixel[1] = (unsigned char) (pixel[1]*ra + inv_a); + pixel[2] = (unsigned char) (pixel[2]*ra + inv_a); + } + } + } + } + + // convert to desired output format + if (req_comp && req_comp != 4) { + if (ri->bits_per_channel == 16) + out = (stbi_uc *) stbi__convert_format16((stbi__uint16 *) out, 4, req_comp, w, h); + else + out = stbi__convert_format(out, 4, req_comp, w, h); + if (out == NULL) return out; // stbi__convert_format frees input on failure + } + + if (comp) *comp = 4; + *y = h; + *x = w; + + return out; +} +#endif + +// ************************************************************************************************* +// Softimage PIC loader +// by Tom Seddon +// +// See http://softimage.wiki.softimage.com/index.php/INFO:_PIC_file_format +// See http://ozviz.wasp.uwa.edu.au/~pbourke/dataformats/softimagepic/ + +#ifndef STBI_NO_PIC +static int stbi__pic_is4(stbi__context *s,const char *str) +{ + int i; + for (i=0; i<4; ++i) + if (stbi__get8(s) != (stbi_uc)str[i]) + return 0; + + return 1; +} + +static int stbi__pic_test_core(stbi__context *s) +{ + int i; + + if (!stbi__pic_is4(s,"\x53\x80\xF6\x34")) + return 0; + + for(i=0;i<84;++i) + stbi__get8(s); + + if (!stbi__pic_is4(s,"PICT")) + return 0; + + return 1; +} + +typedef struct +{ + stbi_uc size,type,channel; +} stbi__pic_packet; + +static stbi_uc *stbi__readval(stbi__context *s, int channel, stbi_uc *dest) +{ + int mask=0x80, i; + + for (i=0; i<4; ++i, mask>>=1) { + if (channel & mask) { + if (stbi__at_eof(s)) return stbi__errpuc("bad file","PIC file too short"); + dest[i]=stbi__get8(s); + } + } + + return dest; +} + +static void stbi__copyval(int channel,stbi_uc *dest,const stbi_uc *src) +{ + int mask=0x80,i; + + for (i=0;i<4; ++i, mask>>=1) + if (channel&mask) + dest[i]=src[i]; +} + +static stbi_uc *stbi__pic_load_core(stbi__context *s,int width,int height,int *comp, stbi_uc *result) +{ + int act_comp=0,num_packets=0,y,chained; + stbi__pic_packet packets[10]; + + // this will (should...) cater for even some bizarre stuff like having data + // for the same channel in multiple packets. + do { + stbi__pic_packet *packet; + + if (num_packets==sizeof(packets)/sizeof(packets[0])) + return stbi__errpuc("bad format","too many packets"); + + packet = &packets[num_packets++]; + + chained = stbi__get8(s); + packet->size = stbi__get8(s); + packet->type = stbi__get8(s); + packet->channel = stbi__get8(s); + + act_comp |= packet->channel; + + if (stbi__at_eof(s)) return stbi__errpuc("bad file","file too short (reading packets)"); + if (packet->size != 8) return stbi__errpuc("bad format","packet isn't 8bpp"); + } while (chained); + + *comp = (act_comp & 0x10 ? 4 : 3); // has alpha channel? + + for(y=0; ytype) { + default: + return stbi__errpuc("bad format","packet has bad compression type"); + + case 0: {//uncompressed + int x; + + for(x=0;xchannel,dest)) + return 0; + break; + } + + case 1://Pure RLE + { + int left=width, i; + + while (left>0) { + stbi_uc count,value[4]; + + count=stbi__get8(s); + if (stbi__at_eof(s)) return stbi__errpuc("bad file","file too short (pure read count)"); + + if (count > left) + count = (stbi_uc) left; + + if (!stbi__readval(s,packet->channel,value)) return 0; + + for(i=0; ichannel,dest,value); + left -= count; + } + } + break; + + case 2: {//Mixed RLE + int left=width; + while (left>0) { + int count = stbi__get8(s), i; + if (stbi__at_eof(s)) return stbi__errpuc("bad file","file too short (mixed read count)"); + + if (count >= 128) { // Repeated + stbi_uc value[4]; + + if (count==128) + count = stbi__get16be(s); + else + count -= 127; + if (count > left) + return stbi__errpuc("bad file","scanline overrun"); + + if (!stbi__readval(s,packet->channel,value)) + return 0; + + for(i=0;ichannel,dest,value); + } else { // Raw + ++count; + if (count>left) return stbi__errpuc("bad file","scanline overrun"); + + for(i=0;ichannel,dest)) + return 0; + } + left-=count; + } + break; + } + } + } + } + + return result; +} + +static void *stbi__pic_load(stbi__context *s,int *px,int *py,int *comp,int req_comp, stbi__result_info *ri) +{ + stbi_uc *result; + int i, x,y, internal_comp; + STBI_NOTUSED(ri); + + if (!comp) comp = &internal_comp; + + for (i=0; i<92; ++i) + stbi__get8(s); + + x = stbi__get16be(s); + y = stbi__get16be(s); + + if (y > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + if (x > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + + if (stbi__at_eof(s)) return stbi__errpuc("bad file","file too short (pic header)"); + if (!stbi__mad3sizes_valid(x, y, 4, 0)) return stbi__errpuc("too large", "PIC image too large to decode"); + + stbi__get32be(s); //skip `ratio' + stbi__get16be(s); //skip `fields' + stbi__get16be(s); //skip `pad' + + // intermediate buffer is RGBA + result = (stbi_uc *) stbi__malloc_mad3(x, y, 4, 0); + if (!result) return stbi__errpuc("outofmem", "Out of memory"); + memset(result, 0xff, x*y*4); + + if (!stbi__pic_load_core(s,x,y,comp, result)) { + STBI_FREE(result); + result=0; + } + *px = x; + *py = y; + if (req_comp == 0) req_comp = *comp; + result=stbi__convert_format(result,4,req_comp,x,y); + + return result; +} + +static int stbi__pic_test(stbi__context *s) +{ + int r = stbi__pic_test_core(s); + stbi__rewind(s); + return r; +} +#endif + +// ************************************************************************************************* +// GIF loader -- public domain by Jean-Marc Lienher -- simplified/shrunk by stb + +#ifndef STBI_NO_GIF +typedef struct +{ + stbi__int16 prefix; + stbi_uc first; + stbi_uc suffix; +} stbi__gif_lzw; + +typedef struct +{ + int w,h; + stbi_uc *out; // output buffer (always 4 components) + stbi_uc *background; // The current "background" as far as a gif is concerned + stbi_uc *history; + int flags, bgindex, ratio, transparent, eflags; + stbi_uc pal[256][4]; + stbi_uc lpal[256][4]; + stbi__gif_lzw codes[8192]; + stbi_uc *color_table; + int parse, step; + int lflags; + int start_x, start_y; + int max_x, max_y; + int cur_x, cur_y; + int line_size; + int delay; +} stbi__gif; + +static int stbi__gif_test_raw(stbi__context *s) +{ + int sz; + if (stbi__get8(s) != 'G' || stbi__get8(s) != 'I' || stbi__get8(s) != 'F' || stbi__get8(s) != '8') return 0; + sz = stbi__get8(s); + if (sz != '9' && sz != '7') return 0; + if (stbi__get8(s) != 'a') return 0; + return 1; +} + +static int stbi__gif_test(stbi__context *s) +{ + int r = stbi__gif_test_raw(s); + stbi__rewind(s); + return r; +} + +static void stbi__gif_parse_colortable(stbi__context *s, stbi_uc pal[256][4], int num_entries, int transp) +{ + int i; + for (i=0; i < num_entries; ++i) { + pal[i][2] = stbi__get8(s); + pal[i][1] = stbi__get8(s); + pal[i][0] = stbi__get8(s); + pal[i][3] = transp == i ? 0 : 255; + } +} + +static int stbi__gif_header(stbi__context *s, stbi__gif *g, int *comp, int is_info) +{ + stbi_uc version; + if (stbi__get8(s) != 'G' || stbi__get8(s) != 'I' || stbi__get8(s) != 'F' || stbi__get8(s) != '8') + return stbi__err("not GIF", "Corrupt GIF"); + + version = stbi__get8(s); + if (version != '7' && version != '9') return stbi__err("not GIF", "Corrupt GIF"); + if (stbi__get8(s) != 'a') return stbi__err("not GIF", "Corrupt GIF"); + + stbi__g_failure_reason = ""; + g->w = stbi__get16le(s); + g->h = stbi__get16le(s); + g->flags = stbi__get8(s); + g->bgindex = stbi__get8(s); + g->ratio = stbi__get8(s); + g->transparent = -1; + + if (g->w > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + if (g->h > STBI_MAX_DIMENSIONS) return stbi__err("too large","Very large image (corrupt?)"); + + if (comp != 0) *comp = 4; // can't actually tell whether it's 3 or 4 until we parse the comments + + if (is_info) return 1; + + if (g->flags & 0x80) + stbi__gif_parse_colortable(s,g->pal, 2 << (g->flags & 7), -1); + + return 1; +} + +static int stbi__gif_info_raw(stbi__context *s, int *x, int *y, int *comp) +{ + stbi__gif* g = (stbi__gif*) stbi__malloc(sizeof(stbi__gif)); + if (!g) return stbi__err("outofmem", "Out of memory"); + if (!stbi__gif_header(s, g, comp, 1)) { + STBI_FREE(g); + stbi__rewind( s ); + return 0; + } + if (x) *x = g->w; + if (y) *y = g->h; + STBI_FREE(g); + return 1; +} + +static void stbi__out_gif_code(stbi__gif *g, stbi__uint16 code) +{ + stbi_uc *p, *c; + int idx; + + // recurse to decode the prefixes, since the linked-list is backwards, + // and working backwards through an interleaved image would be nasty + if (g->codes[code].prefix >= 0) + stbi__out_gif_code(g, g->codes[code].prefix); + + if (g->cur_y >= g->max_y) return; + + idx = g->cur_x + g->cur_y; + p = &g->out[idx]; + g->history[idx / 4] = 1; + + c = &g->color_table[g->codes[code].suffix * 4]; + if (c[3] > 128) { // don't render transparent pixels; + p[0] = c[2]; + p[1] = c[1]; + p[2] = c[0]; + p[3] = c[3]; + } + g->cur_x += 4; + + if (g->cur_x >= g->max_x) { + g->cur_x = g->start_x; + g->cur_y += g->step; + + while (g->cur_y >= g->max_y && g->parse > 0) { + g->step = (1 << g->parse) * g->line_size; + g->cur_y = g->start_y + (g->step >> 1); + --g->parse; + } + } +} + +static stbi_uc *stbi__process_gif_raster(stbi__context *s, stbi__gif *g) +{ + stbi_uc lzw_cs; + stbi__int32 len, init_code; + stbi__uint32 first; + stbi__int32 codesize, codemask, avail, oldcode, bits, valid_bits, clear; + stbi__gif_lzw *p; + + lzw_cs = stbi__get8(s); + if (lzw_cs > 12) return NULL; + clear = 1 << lzw_cs; + first = 1; + codesize = lzw_cs + 1; + codemask = (1 << codesize) - 1; + bits = 0; + valid_bits = 0; + for (init_code = 0; init_code < clear; init_code++) { + g->codes[init_code].prefix = -1; + g->codes[init_code].first = (stbi_uc) init_code; + g->codes[init_code].suffix = (stbi_uc) init_code; + } + + // support no starting clear code + avail = clear+2; + oldcode = -1; + + len = 0; + for(;;) { + if (valid_bits < codesize) { + if (len == 0) { + len = stbi__get8(s); // start new block + if (len == 0) + return g->out; + } + --len; + bits |= (stbi__int32) stbi__get8(s) << valid_bits; + valid_bits += 8; + } else { + stbi__int32 code = bits & codemask; + bits >>= codesize; + valid_bits -= codesize; + // @OPTIMIZE: is there some way we can accelerate the non-clear path? + if (code == clear) { // clear code + codesize = lzw_cs + 1; + codemask = (1 << codesize) - 1; + avail = clear + 2; + oldcode = -1; + first = 0; + } else if (code == clear + 1) { // end of stream code + stbi__skip(s, len); + while ((len = stbi__get8(s)) > 0) + stbi__skip(s,len); + return g->out; + } else if (code <= avail) { + if (first) { + return stbi__errpuc("no clear code", "Corrupt GIF"); + } + + if (oldcode >= 0) { + p = &g->codes[avail++]; + if (avail > 8192) { + return stbi__errpuc("too many codes", "Corrupt GIF"); + } + + p->prefix = (stbi__int16) oldcode; + p->first = g->codes[oldcode].first; + p->suffix = (code == avail) ? p->first : g->codes[code].first; + } else if (code == avail) + return stbi__errpuc("illegal code in raster", "Corrupt GIF"); + + stbi__out_gif_code(g, (stbi__uint16) code); + + if ((avail & codemask) == 0 && avail <= 0x0FFF) { + codesize++; + codemask = (1 << codesize) - 1; + } + + oldcode = code; + } else { + return stbi__errpuc("illegal code in raster", "Corrupt GIF"); + } + } + } +} + +// this function is designed to support animated gifs, although stb_image doesn't support it +// two back is the image from two frames ago, used for a very specific disposal format +static stbi_uc *stbi__gif_load_next(stbi__context *s, stbi__gif *g, int *comp, int req_comp, stbi_uc *two_back) +{ + int dispose; + int first_frame; + int pi; + int pcount; + STBI_NOTUSED(req_comp); + + // on first frame, any non-written pixels get the background colour (non-transparent) + first_frame = 0; + if (g->out == 0) { + if (!stbi__gif_header(s, g, comp,0)) return 0; // stbi__g_failure_reason set by stbi__gif_header + if (!stbi__mad3sizes_valid(4, g->w, g->h, 0)) + return stbi__errpuc("too large", "GIF image is too large"); + pcount = g->w * g->h; + g->out = (stbi_uc *) stbi__malloc(4 * pcount); + g->background = (stbi_uc *) stbi__malloc(4 * pcount); + g->history = (stbi_uc *) stbi__malloc(pcount); + if (!g->out || !g->background || !g->history) + return stbi__errpuc("outofmem", "Out of memory"); + + // image is treated as "transparent" at the start - ie, nothing overwrites the current background; + // background colour is only used for pixels that are not rendered first frame, after that "background" + // color refers to the color that was there the previous frame. + memset(g->out, 0x00, 4 * pcount); + memset(g->background, 0x00, 4 * pcount); // state of the background (starts transparent) + memset(g->history, 0x00, pcount); // pixels that were affected previous frame + first_frame = 1; + } else { + // second frame - how do we dispose of the previous one? + dispose = (g->eflags & 0x1C) >> 2; + pcount = g->w * g->h; + + if ((dispose == 3) && (two_back == 0)) { + dispose = 2; // if I don't have an image to revert back to, default to the old background + } + + if (dispose == 3) { // use previous graphic + for (pi = 0; pi < pcount; ++pi) { + if (g->history[pi]) { + memcpy( &g->out[pi * 4], &two_back[pi * 4], 4 ); + } + } + } else if (dispose == 2) { + // restore what was changed last frame to background before that frame; + for (pi = 0; pi < pcount; ++pi) { + if (g->history[pi]) { + memcpy( &g->out[pi * 4], &g->background[pi * 4], 4 ); + } + } + } else { + // This is a non-disposal case eithe way, so just + // leave the pixels as is, and they will become the new background + // 1: do not dispose + // 0: not specified. + } + + // background is what out is after the undoing of the previou frame; + memcpy( g->background, g->out, 4 * g->w * g->h ); + } + + // clear my history; + memset( g->history, 0x00, g->w * g->h ); // pixels that were affected previous frame + + for (;;) { + int tag = stbi__get8(s); + switch (tag) { + case 0x2C: /* Image Descriptor */ + { + stbi__int32 x, y, w, h; + stbi_uc *o; + + x = stbi__get16le(s); + y = stbi__get16le(s); + w = stbi__get16le(s); + h = stbi__get16le(s); + if (((x + w) > (g->w)) || ((y + h) > (g->h))) + return stbi__errpuc("bad Image Descriptor", "Corrupt GIF"); + + g->line_size = g->w * 4; + g->start_x = x * 4; + g->start_y = y * g->line_size; + g->max_x = g->start_x + w * 4; + g->max_y = g->start_y + h * g->line_size; + g->cur_x = g->start_x; + g->cur_y = g->start_y; + + // if the width of the specified rectangle is 0, that means + // we may not see *any* pixels or the image is malformed; + // to make sure this is caught, move the current y down to + // max_y (which is what out_gif_code checks). + if (w == 0) + g->cur_y = g->max_y; + + g->lflags = stbi__get8(s); + + if (g->lflags & 0x40) { + g->step = 8 * g->line_size; // first interlaced spacing + g->parse = 3; + } else { + g->step = g->line_size; + g->parse = 0; + } + + if (g->lflags & 0x80) { + stbi__gif_parse_colortable(s,g->lpal, 2 << (g->lflags & 7), g->eflags & 0x01 ? g->transparent : -1); + g->color_table = (stbi_uc *) g->lpal; + } else if (g->flags & 0x80) { + g->color_table = (stbi_uc *) g->pal; + } else + return stbi__errpuc("missing color table", "Corrupt GIF"); + + o = stbi__process_gif_raster(s, g); + if (!o) return NULL; + + // if this was the first frame, + pcount = g->w * g->h; + if (first_frame && (g->bgindex > 0)) { + // if first frame, any pixel not drawn to gets the background color + for (pi = 0; pi < pcount; ++pi) { + if (g->history[pi] == 0) { + g->pal[g->bgindex][3] = 255; // just in case it was made transparent, undo that; It will be reset next frame if need be; + memcpy( &g->out[pi * 4], &g->pal[g->bgindex], 4 ); + } + } + } + + return o; + } + + case 0x21: // Comment Extension. + { + int len; + int ext = stbi__get8(s); + if (ext == 0xF9) { // Graphic Control Extension. + len = stbi__get8(s); + if (len == 4) { + g->eflags = stbi__get8(s); + g->delay = 10 * stbi__get16le(s); // delay - 1/100th of a second, saving as 1/1000ths. + + // unset old transparent + if (g->transparent >= 0) { + g->pal[g->transparent][3] = 255; + } + if (g->eflags & 0x01) { + g->transparent = stbi__get8(s); + if (g->transparent >= 0) { + g->pal[g->transparent][3] = 0; + } + } else { + // don't need transparent + stbi__skip(s, 1); + g->transparent = -1; + } + } else { + stbi__skip(s, len); + break; + } + } + while ((len = stbi__get8(s)) != 0) { + stbi__skip(s, len); + } + break; + } + + case 0x3B: // gif stream termination code + return (stbi_uc *) s; // using '1' causes warning on some compilers + + default: + return stbi__errpuc("unknown code", "Corrupt GIF"); + } + } +} + +static void *stbi__load_gif_main_outofmem(stbi__gif *g, stbi_uc *out, int **delays) +{ + STBI_FREE(g->out); + STBI_FREE(g->history); + STBI_FREE(g->background); + + if (out) STBI_FREE(out); + if (delays && *delays) STBI_FREE(*delays); + return stbi__errpuc("outofmem", "Out of memory"); +} + +static void *stbi__load_gif_main(stbi__context *s, int **delays, int *x, int *y, int *z, int *comp, int req_comp) +{ + if (stbi__gif_test(s)) { + int layers = 0; + stbi_uc *u = 0; + stbi_uc *out = 0; + stbi_uc *two_back = 0; + stbi__gif g; + int stride; + int out_size = 0; + int delays_size = 0; + + STBI_NOTUSED(out_size); + STBI_NOTUSED(delays_size); + + memset(&g, 0, sizeof(g)); + if (delays) { + *delays = 0; + } + + do { + u = stbi__gif_load_next(s, &g, comp, req_comp, two_back); + if (u == (stbi_uc *) s) u = 0; // end of animated gif marker + + if (u) { + *x = g.w; + *y = g.h; + ++layers; + stride = g.w * g.h * 4; + + if (out) { + void *tmp = (stbi_uc*) STBI_REALLOC_SIZED( out, out_size, layers * stride ); + if (!tmp) + return stbi__load_gif_main_outofmem(&g, out, delays); + else { + out = (stbi_uc*) tmp; + out_size = layers * stride; + } + + if (delays) { + int *new_delays = (int*) STBI_REALLOC_SIZED( *delays, delays_size, sizeof(int) * layers ); + if (!new_delays) + return stbi__load_gif_main_outofmem(&g, out, delays); + *delays = new_delays; + delays_size = layers * sizeof(int); + } + } else { + out = (stbi_uc*)stbi__malloc( layers * stride ); + if (!out) + return stbi__load_gif_main_outofmem(&g, out, delays); + out_size = layers * stride; + if (delays) { + *delays = (int*) stbi__malloc( layers * sizeof(int) ); + if (!*delays) + return stbi__load_gif_main_outofmem(&g, out, delays); + delays_size = layers * sizeof(int); + } + } + memcpy( out + ((layers - 1) * stride), u, stride ); + if (layers >= 2) { + two_back = out - 2 * stride; + } + + if (delays) { + (*delays)[layers - 1U] = g.delay; + } + } + } while (u != 0); + + // free temp buffer; + STBI_FREE(g.out); + STBI_FREE(g.history); + STBI_FREE(g.background); + + // do the final conversion after loading everything; + if (req_comp && req_comp != 4) + out = stbi__convert_format(out, 4, req_comp, layers * g.w, g.h); + + *z = layers; + return out; + } else { + return stbi__errpuc("not GIF", "Image was not as a gif type."); + } +} + +static void *stbi__gif_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) +{ + stbi_uc *u = 0; + stbi__gif g; + memset(&g, 0, sizeof(g)); + STBI_NOTUSED(ri); + + u = stbi__gif_load_next(s, &g, comp, req_comp, 0); + if (u == (stbi_uc *) s) u = 0; // end of animated gif marker + if (u) { + *x = g.w; + *y = g.h; + + // moved conversion to after successful load so that the same + // can be done for multiple frames. + if (req_comp && req_comp != 4) + u = stbi__convert_format(u, 4, req_comp, g.w, g.h); + } else if (g.out) { + // if there was an error and we allocated an image buffer, free it! + STBI_FREE(g.out); + } + + // free buffers needed for multiple frame loading; + STBI_FREE(g.history); + STBI_FREE(g.background); + + return u; +} + +static int stbi__gif_info(stbi__context *s, int *x, int *y, int *comp) +{ + return stbi__gif_info_raw(s,x,y,comp); +} +#endif + +// ************************************************************************************************* +// Radiance RGBE HDR loader +// originally by Nicolas Schulz +#ifndef STBI_NO_HDR +static int stbi__hdr_test_core(stbi__context *s, const char *signature) +{ + int i; + for (i=0; signature[i]; ++i) + if (stbi__get8(s) != signature[i]) + return 0; + stbi__rewind(s); + return 1; +} + +static int stbi__hdr_test(stbi__context* s) +{ + int r = stbi__hdr_test_core(s, "#?RADIANCE\n"); + stbi__rewind(s); + if(!r) { + r = stbi__hdr_test_core(s, "#?RGBE\n"); + stbi__rewind(s); + } + return r; +} + +#define STBI__HDR_BUFLEN 1024 +static char *stbi__hdr_gettoken(stbi__context *z, char *buffer) +{ + int len=0; + char c = '\0'; + + c = (char) stbi__get8(z); + + while (!stbi__at_eof(z) && c != '\n') { + buffer[len++] = c; + if (len == STBI__HDR_BUFLEN-1) { + // flush to end of line + while (!stbi__at_eof(z) && stbi__get8(z) != '\n') + ; + break; + } + c = (char) stbi__get8(z); + } + + buffer[len] = 0; + return buffer; +} + +static void stbi__hdr_convert(float *output, stbi_uc *input, int req_comp) +{ + if ( input[3] != 0 ) { + float f1; + // Exponent + f1 = (float) ldexp(1.0f, input[3] - (int)(128 + 8)); + if (req_comp <= 2) + output[0] = (input[0] + input[1] + input[2]) * f1 / 3; + else { + output[0] = input[0] * f1; + output[1] = input[1] * f1; + output[2] = input[2] * f1; + } + if (req_comp == 2) output[1] = 1; + if (req_comp == 4) output[3] = 1; + } else { + switch (req_comp) { + case 4: output[3] = 1; /* fallthrough */ + case 3: output[0] = output[1] = output[2] = 0; + break; + case 2: output[1] = 1; /* fallthrough */ + case 1: output[0] = 0; + break; + } + } +} + +static float *stbi__hdr_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) +{ + char buffer[STBI__HDR_BUFLEN]; + char *token; + int valid = 0; + int width, height; + stbi_uc *scanline; + float *hdr_data; + int len; + unsigned char count, value; + int i, j, k, c1,c2, z; + const char *headerToken; + STBI_NOTUSED(ri); + + // Check identifier + headerToken = stbi__hdr_gettoken(s,buffer); + if (strcmp(headerToken, "#?RADIANCE") != 0 && strcmp(headerToken, "#?RGBE") != 0) + return stbi__errpf("not HDR", "Corrupt HDR image"); + + // Parse header + for(;;) { + token = stbi__hdr_gettoken(s,buffer); + if (token[0] == 0) break; + if (strcmp(token, "FORMAT=32-bit_rle_rgbe") == 0) valid = 1; + } + + if (!valid) return stbi__errpf("unsupported format", "Unsupported HDR format"); + + // Parse width and height + // can't use sscanf() if we're not using stdio! + token = stbi__hdr_gettoken(s,buffer); + if (strncmp(token, "-Y ", 3)) return stbi__errpf("unsupported data layout", "Unsupported HDR format"); + token += 3; + height = (int) strtol(token, &token, 10); + while (*token == ' ') ++token; + if (strncmp(token, "+X ", 3)) return stbi__errpf("unsupported data layout", "Unsupported HDR format"); + token += 3; + width = (int) strtol(token, NULL, 10); + + if (height > STBI_MAX_DIMENSIONS) return stbi__errpf("too large","Very large image (corrupt?)"); + if (width > STBI_MAX_DIMENSIONS) return stbi__errpf("too large","Very large image (corrupt?)"); + + *x = width; + *y = height; + + if (comp) *comp = 3; + if (req_comp == 0) req_comp = 3; + + if (!stbi__mad4sizes_valid(width, height, req_comp, sizeof(float), 0)) + return stbi__errpf("too large", "HDR image is too large"); + + // Read data + hdr_data = (float *) stbi__malloc_mad4(width, height, req_comp, sizeof(float), 0); + if (!hdr_data) + return stbi__errpf("outofmem", "Out of memory"); + + // Load image data + // image data is stored as some number of sca + if ( width < 8 || width >= 32768) { + // Read flat data + for (j=0; j < height; ++j) { + for (i=0; i < width; ++i) { + stbi_uc rgbe[4]; + main_decode_loop: + stbi__getn(s, rgbe, 4); + stbi__hdr_convert(hdr_data + j * width * req_comp + i * req_comp, rgbe, req_comp); + } + } + } else { + // Read RLE-encoded data + scanline = NULL; + + for (j = 0; j < height; ++j) { + c1 = stbi__get8(s); + c2 = stbi__get8(s); + len = stbi__get8(s); + if (c1 != 2 || c2 != 2 || (len & 0x80)) { + // not run-length encoded, so we have to actually use THIS data as a decoded + // pixel (note this can't be a valid pixel--one of RGB must be >= 128) + stbi_uc rgbe[4]; + rgbe[0] = (stbi_uc) c1; + rgbe[1] = (stbi_uc) c2; + rgbe[2] = (stbi_uc) len; + rgbe[3] = (stbi_uc) stbi__get8(s); + stbi__hdr_convert(hdr_data, rgbe, req_comp); + i = 1; + j = 0; + STBI_FREE(scanline); + goto main_decode_loop; // yes, this makes no sense + } + len <<= 8; + len |= stbi__get8(s); + if (len != width) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("invalid decoded scanline length", "corrupt HDR"); } + if (scanline == NULL) { + scanline = (stbi_uc *) stbi__malloc_mad2(width, 4, 0); + if (!scanline) { + STBI_FREE(hdr_data); + return stbi__errpf("outofmem", "Out of memory"); + } + } + + for (k = 0; k < 4; ++k) { + int nleft; + i = 0; + while ((nleft = width - i) > 0) { + count = stbi__get8(s); + if (count > 128) { + // Run + value = stbi__get8(s); + count -= 128; + if ((count == 0) || (count > nleft)) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("corrupt", "bad RLE data in HDR"); } + for (z = 0; z < count; ++z) + scanline[i++ * 4 + k] = value; + } else { + // Dump + if ((count == 0) || (count > nleft)) { STBI_FREE(hdr_data); STBI_FREE(scanline); return stbi__errpf("corrupt", "bad RLE data in HDR"); } + for (z = 0; z < count; ++z) + scanline[i++ * 4 + k] = stbi__get8(s); + } + } + } + for (i=0; i < width; ++i) + stbi__hdr_convert(hdr_data+(j*width + i)*req_comp, scanline + i*4, req_comp); + } + if (scanline) + STBI_FREE(scanline); + } + + return hdr_data; +} + +static int stbi__hdr_info(stbi__context *s, int *x, int *y, int *comp) +{ + char buffer[STBI__HDR_BUFLEN]; + char *token; + int valid = 0; + int dummy; + + if (!x) x = &dummy; + if (!y) y = &dummy; + if (!comp) comp = &dummy; + + if (stbi__hdr_test(s) == 0) { + stbi__rewind( s ); + return 0; + } + + for(;;) { + token = stbi__hdr_gettoken(s,buffer); + if (token[0] == 0) break; + if (strcmp(token, "FORMAT=32-bit_rle_rgbe") == 0) valid = 1; + } + + if (!valid) { + stbi__rewind( s ); + return 0; + } + token = stbi__hdr_gettoken(s,buffer); + if (strncmp(token, "-Y ", 3)) { + stbi__rewind( s ); + return 0; + } + token += 3; + *y = (int) strtol(token, &token, 10); + while (*token == ' ') ++token; + if (strncmp(token, "+X ", 3)) { + stbi__rewind( s ); + return 0; + } + token += 3; + *x = (int) strtol(token, NULL, 10); + *comp = 3; + return 1; +} +#endif // STBI_NO_HDR + +#ifndef STBI_NO_BMP +static int stbi__bmp_info(stbi__context *s, int *x, int *y, int *comp) +{ + void *p; + stbi__bmp_data info; + + info.all_a = 255; + p = stbi__bmp_parse_header(s, &info); + if (p == NULL) { + stbi__rewind( s ); + return 0; + } + if (x) *x = s->img_x; + if (y) *y = s->img_y; + if (comp) { + if (info.bpp == 24 && info.ma == 0xff000000) + *comp = 3; + else + *comp = info.ma ? 4 : 3; + } + return 1; +} +#endif + +#ifndef STBI_NO_PSD +static int stbi__psd_info(stbi__context *s, int *x, int *y, int *comp) +{ + int channelCount, dummy, depth; + if (!x) x = &dummy; + if (!y) y = &dummy; + if (!comp) comp = &dummy; + if (stbi__get32be(s) != 0x38425053) { + stbi__rewind( s ); + return 0; + } + if (stbi__get16be(s) != 1) { + stbi__rewind( s ); + return 0; + } + stbi__skip(s, 6); + channelCount = stbi__get16be(s); + if (channelCount < 0 || channelCount > 16) { + stbi__rewind( s ); + return 0; + } + *y = stbi__get32be(s); + *x = stbi__get32be(s); + depth = stbi__get16be(s); + if (depth != 8 && depth != 16) { + stbi__rewind( s ); + return 0; + } + if (stbi__get16be(s) != 3) { + stbi__rewind( s ); + return 0; + } + *comp = 4; + return 1; +} + +static int stbi__psd_is16(stbi__context *s) +{ + int channelCount, depth; + if (stbi__get32be(s) != 0x38425053) { + stbi__rewind( s ); + return 0; + } + if (stbi__get16be(s) != 1) { + stbi__rewind( s ); + return 0; + } + stbi__skip(s, 6); + channelCount = stbi__get16be(s); + if (channelCount < 0 || channelCount > 16) { + stbi__rewind( s ); + return 0; + } + STBI_NOTUSED(stbi__get32be(s)); + STBI_NOTUSED(stbi__get32be(s)); + depth = stbi__get16be(s); + if (depth != 16) { + stbi__rewind( s ); + return 0; + } + return 1; +} +#endif + +#ifndef STBI_NO_PIC +static int stbi__pic_info(stbi__context *s, int *x, int *y, int *comp) +{ + int act_comp=0,num_packets=0,chained,dummy; + stbi__pic_packet packets[10]; + + if (!x) x = &dummy; + if (!y) y = &dummy; + if (!comp) comp = &dummy; + + if (!stbi__pic_is4(s,"\x53\x80\xF6\x34")) { + stbi__rewind(s); + return 0; + } + + stbi__skip(s, 88); + + *x = stbi__get16be(s); + *y = stbi__get16be(s); + if (stbi__at_eof(s)) { + stbi__rewind( s); + return 0; + } + if ( (*x) != 0 && (1 << 28) / (*x) < (*y)) { + stbi__rewind( s ); + return 0; + } + + stbi__skip(s, 8); + + do { + stbi__pic_packet *packet; + + if (num_packets==sizeof(packets)/sizeof(packets[0])) + return 0; + + packet = &packets[num_packets++]; + chained = stbi__get8(s); + packet->size = stbi__get8(s); + packet->type = stbi__get8(s); + packet->channel = stbi__get8(s); + act_comp |= packet->channel; + + if (stbi__at_eof(s)) { + stbi__rewind( s ); + return 0; + } + if (packet->size != 8) { + stbi__rewind( s ); + return 0; + } + } while (chained); + + *comp = (act_comp & 0x10 ? 4 : 3); + + return 1; +} +#endif + +// ************************************************************************************************* +// Portable Gray Map and Portable Pixel Map loader +// by Ken Miller +// +// PGM: http://netpbm.sourceforge.net/doc/pgm.html +// PPM: http://netpbm.sourceforge.net/doc/ppm.html +// +// Known limitations: +// Does not support comments in the header section +// Does not support ASCII image data (formats P2 and P3) + +#ifndef STBI_NO_PNM + +static int stbi__pnm_test(stbi__context *s) +{ + char p, t; + p = (char) stbi__get8(s); + t = (char) stbi__get8(s); + if (p != 'P' || (t != '5' && t != '6')) { + stbi__rewind( s ); + return 0; + } + return 1; +} + +static void *stbi__pnm_load(stbi__context *s, int *x, int *y, int *comp, int req_comp, stbi__result_info *ri) +{ + stbi_uc *out; + STBI_NOTUSED(ri); + + ri->bits_per_channel = stbi__pnm_info(s, (int *)&s->img_x, (int *)&s->img_y, (int *)&s->img_n); + if (ri->bits_per_channel == 0) + return 0; + + if (s->img_y > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + if (s->img_x > STBI_MAX_DIMENSIONS) return stbi__errpuc("too large","Very large image (corrupt?)"); + + *x = s->img_x; + *y = s->img_y; + if (comp) *comp = s->img_n; + + if (!stbi__mad4sizes_valid(s->img_n, s->img_x, s->img_y, ri->bits_per_channel / 8, 0)) + return stbi__errpuc("too large", "PNM too large"); + + out = (stbi_uc *) stbi__malloc_mad4(s->img_n, s->img_x, s->img_y, ri->bits_per_channel / 8, 0); + if (!out) return stbi__errpuc("outofmem", "Out of memory"); + if (!stbi__getn(s, out, s->img_n * s->img_x * s->img_y * (ri->bits_per_channel / 8))) { + STBI_FREE(out); + return stbi__errpuc("bad PNM", "PNM file truncated"); + } + + if (req_comp && req_comp != s->img_n) { + if (ri->bits_per_channel == 16) { + out = (stbi_uc *) stbi__convert_format16((stbi__uint16 *) out, s->img_n, req_comp, s->img_x, s->img_y); + } else { + out = stbi__convert_format(out, s->img_n, req_comp, s->img_x, s->img_y); + } + if (out == NULL) return out; // stbi__convert_format frees input on failure + } + return out; +} + +static int stbi__pnm_isspace(char c) +{ + return c == ' ' || c == '\t' || c == '\n' || c == '\v' || c == '\f' || c == '\r'; +} + +static void stbi__pnm_skip_whitespace(stbi__context *s, char *c) +{ + for (;;) { + while (!stbi__at_eof(s) && stbi__pnm_isspace(*c)) + *c = (char) stbi__get8(s); + + if (stbi__at_eof(s) || *c != '#') + break; + + while (!stbi__at_eof(s) && *c != '\n' && *c != '\r' ) + *c = (char) stbi__get8(s); + } +} + +static int stbi__pnm_isdigit(char c) +{ + return c >= '0' && c <= '9'; +} + +static int stbi__pnm_getinteger(stbi__context *s, char *c) +{ + int value = 0; + + while (!stbi__at_eof(s) && stbi__pnm_isdigit(*c)) { + value = value*10 + (*c - '0'); + *c = (char) stbi__get8(s); + if((value > 214748364) || (value == 214748364 && *c > '7')) + return stbi__err("integer parse overflow", "Parsing an integer in the PPM header overflowed a 32-bit int"); + } + + return value; +} + +static int stbi__pnm_info(stbi__context *s, int *x, int *y, int *comp) +{ + int maxv, dummy; + char c, p, t; + + if (!x) x = &dummy; + if (!y) y = &dummy; + if (!comp) comp = &dummy; + + stbi__rewind(s); + + // Get identifier + p = (char) stbi__get8(s); + t = (char) stbi__get8(s); + if (p != 'P' || (t != '5' && t != '6')) { + stbi__rewind(s); + return 0; + } + + *comp = (t == '6') ? 3 : 1; // '5' is 1-component .pgm; '6' is 3-component .ppm + + c = (char) stbi__get8(s); + stbi__pnm_skip_whitespace(s, &c); + + *x = stbi__pnm_getinteger(s, &c); // read width + if(*x == 0) + return stbi__err("invalid width", "PPM image header had zero or overflowing width"); + stbi__pnm_skip_whitespace(s, &c); + + *y = stbi__pnm_getinteger(s, &c); // read height + if (*y == 0) + return stbi__err("invalid width", "PPM image header had zero or overflowing width"); + stbi__pnm_skip_whitespace(s, &c); + + maxv = stbi__pnm_getinteger(s, &c); // read max value + if (maxv > 65535) + return stbi__err("max value > 65535", "PPM image supports only 8-bit and 16-bit images"); + else if (maxv > 255) + return 16; + else + return 8; +} + +static int stbi__pnm_is16(stbi__context *s) +{ + if (stbi__pnm_info(s, NULL, NULL, NULL) == 16) + return 1; + return 0; +} +#endif + +static int stbi__info_main(stbi__context *s, int *x, int *y, int *comp) +{ + #ifndef STBI_NO_JPEG + if (stbi__jpeg_info(s, x, y, comp)) return 1; + #endif + + #ifndef STBI_NO_PNG + if (stbi__png_info(s, x, y, comp)) return 1; + #endif + + #ifndef STBI_NO_GIF + if (stbi__gif_info(s, x, y, comp)) return 1; + #endif + + #ifndef STBI_NO_BMP + if (stbi__bmp_info(s, x, y, comp)) return 1; + #endif + + #ifndef STBI_NO_PSD + if (stbi__psd_info(s, x, y, comp)) return 1; + #endif + + #ifndef STBI_NO_PIC + if (stbi__pic_info(s, x, y, comp)) return 1; + #endif + + #ifndef STBI_NO_PNM + if (stbi__pnm_info(s, x, y, comp)) return 1; + #endif + + #ifndef STBI_NO_HDR + if (stbi__hdr_info(s, x, y, comp)) return 1; + #endif + + // test tga last because it's a crappy test! + #ifndef STBI_NO_TGA + if (stbi__tga_info(s, x, y, comp)) + return 1; + #endif + return stbi__err("unknown image type", "Image not of any known type, or corrupt"); +} + +static int stbi__is_16_main(stbi__context *s) +{ + #ifndef STBI_NO_PNG + if (stbi__png_is16(s)) return 1; + #endif + + #ifndef STBI_NO_PSD + if (stbi__psd_is16(s)) return 1; + #endif + + #ifndef STBI_NO_PNM + if (stbi__pnm_is16(s)) return 1; + #endif + return 0; +} + +#ifndef STBI_NO_STDIO +STBIDEF int stbi_info(char const *filename, int *x, int *y, int *comp) +{ + FILE *f = stbi__fopen(filename, "rb"); + int result; + if (!f) return stbi__err("can't fopen", "Unable to open file"); + result = stbi_info_from_file(f, x, y, comp); + fclose(f); + return result; +} + +STBIDEF int stbi_info_from_file(FILE *f, int *x, int *y, int *comp) +{ + int r; + stbi__context s; + long pos = ftell(f); + stbi__start_file(&s, f); + r = stbi__info_main(&s,x,y,comp); + fseek(f,pos,SEEK_SET); + return r; +} + +STBIDEF int stbi_is_16_bit(char const *filename) +{ + FILE *f = stbi__fopen(filename, "rb"); + int result; + if (!f) return stbi__err("can't fopen", "Unable to open file"); + result = stbi_is_16_bit_from_file(f); + fclose(f); + return result; +} + +STBIDEF int stbi_is_16_bit_from_file(FILE *f) +{ + int r; + stbi__context s; + long pos = ftell(f); + stbi__start_file(&s, f); + r = stbi__is_16_main(&s); + fseek(f,pos,SEEK_SET); + return r; +} +#endif // !STBI_NO_STDIO + +STBIDEF int stbi_info_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp) +{ + stbi__context s; + stbi__start_mem(&s,buffer,len); + return stbi__info_main(&s,x,y,comp); +} + +STBIDEF int stbi_info_from_callbacks(stbi_io_callbacks const *c, void *user, int *x, int *y, int *comp) +{ + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks *) c, user); + return stbi__info_main(&s,x,y,comp); +} + +STBIDEF int stbi_is_16_bit_from_memory(stbi_uc const *buffer, int len) +{ + stbi__context s; + stbi__start_mem(&s,buffer,len); + return stbi__is_16_main(&s); +} + +STBIDEF int stbi_is_16_bit_from_callbacks(stbi_io_callbacks const *c, void *user) +{ + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks *) c, user); + return stbi__is_16_main(&s); +} + +#endif // STB_IMAGE_IMPLEMENTATION + +/* + revision history: + 2.20 (2019-02-07) support utf8 filenames in Windows; fix warnings and platform ifdefs + 2.19 (2018-02-11) fix warning + 2.18 (2018-01-30) fix warnings + 2.17 (2018-01-29) change sbti__shiftsigned to avoid clang -O2 bug + 1-bit BMP + *_is_16_bit api + avoid warnings + 2.16 (2017-07-23) all functions have 16-bit variants; + STBI_NO_STDIO works again; + compilation fixes; + fix rounding in unpremultiply; + optimize vertical flip; + disable raw_len validation; + documentation fixes + 2.15 (2017-03-18) fix png-1,2,4 bug; now all Imagenet JPGs decode; + warning fixes; disable run-time SSE detection on gcc; + uniform handling of optional "return" values; + thread-safe initialization of zlib tables + 2.14 (2017-03-03) remove deprecated STBI_JPEG_OLD; fixes for Imagenet JPGs + 2.13 (2016-11-29) add 16-bit API, only supported for PNG right now + 2.12 (2016-04-02) fix typo in 2.11 PSD fix that caused crashes + 2.11 (2016-04-02) allocate large structures on the stack + remove white matting for transparent PSD + fix reported channel count for PNG & BMP + re-enable SSE2 in non-gcc 64-bit + support RGB-formatted JPEG + read 16-bit PNGs (only as 8-bit) + 2.10 (2016-01-22) avoid warning introduced in 2.09 by STBI_REALLOC_SIZED + 2.09 (2016-01-16) allow comments in PNM files + 16-bit-per-pixel TGA (not bit-per-component) + info() for TGA could break due to .hdr handling + info() for BMP to shares code instead of sloppy parse + can use STBI_REALLOC_SIZED if allocator doesn't support realloc + code cleanup + 2.08 (2015-09-13) fix to 2.07 cleanup, reading RGB PSD as RGBA + 2.07 (2015-09-13) fix compiler warnings + partial animated GIF support + limited 16-bpc PSD support + #ifdef unused functions + bug with < 92 byte PIC,PNM,HDR,TGA + 2.06 (2015-04-19) fix bug where PSD returns wrong '*comp' value + 2.05 (2015-04-19) fix bug in progressive JPEG handling, fix warning + 2.04 (2015-04-15) try to re-enable SIMD on MinGW 64-bit + 2.03 (2015-04-12) extra corruption checking (mmozeiko) + stbi_set_flip_vertically_on_load (nguillemot) + fix NEON support; fix mingw support + 2.02 (2015-01-19) fix incorrect assert, fix warning + 2.01 (2015-01-17) fix various warnings; suppress SIMD on gcc 32-bit without -msse2 + 2.00b (2014-12-25) fix STBI_MALLOC in progressive JPEG + 2.00 (2014-12-25) optimize JPG, including x86 SSE2 & NEON SIMD (ryg) + progressive JPEG (stb) + PGM/PPM support (Ken Miller) + STBI_MALLOC,STBI_REALLOC,STBI_FREE + GIF bugfix -- seemingly never worked + STBI_NO_*, STBI_ONLY_* + 1.48 (2014-12-14) fix incorrectly-named assert() + 1.47 (2014-12-14) 1/2/4-bit PNG support, both direct and paletted (Omar Cornut & stb) + optimize PNG (ryg) + fix bug in interlaced PNG with user-specified channel count (stb) + 1.46 (2014-08-26) + fix broken tRNS chunk (colorkey-style transparency) in non-paletted PNG + 1.45 (2014-08-16) + fix MSVC-ARM internal compiler error by wrapping malloc + 1.44 (2014-08-07) + various warning fixes from Ronny Chevalier + 1.43 (2014-07-15) + fix MSVC-only compiler problem in code changed in 1.42 + 1.42 (2014-07-09) + don't define _CRT_SECURE_NO_WARNINGS (affects user code) + fixes to stbi__cleanup_jpeg path + added STBI_ASSERT to avoid requiring assert.h + 1.41 (2014-06-25) + fix search&replace from 1.36 that messed up comments/error messages + 1.40 (2014-06-22) + fix gcc struct-initialization warning + 1.39 (2014-06-15) + fix to TGA optimization when req_comp != number of components in TGA; + fix to GIF loading because BMP wasn't rewinding (whoops, no GIFs in my test suite) + add support for BMP version 5 (more ignored fields) + 1.38 (2014-06-06) + suppress MSVC warnings on integer casts truncating values + fix accidental rename of 'skip' field of I/O + 1.37 (2014-06-04) + remove duplicate typedef + 1.36 (2014-06-03) + convert to header file single-file library + if de-iphone isn't set, load iphone images color-swapped instead of returning NULL + 1.35 (2014-05-27) + various warnings + fix broken STBI_SIMD path + fix bug where stbi_load_from_file no longer left file pointer in correct place + fix broken non-easy path for 32-bit BMP (possibly never used) + TGA optimization by Arseny Kapoulkine + 1.34 (unknown) + use STBI_NOTUSED in stbi__resample_row_generic(), fix one more leak in tga failure case + 1.33 (2011-07-14) + make stbi_is_hdr work in STBI_NO_HDR (as specified), minor compiler-friendly improvements + 1.32 (2011-07-13) + support for "info" function for all supported filetypes (SpartanJ) + 1.31 (2011-06-20) + a few more leak fixes, bug in PNG handling (SpartanJ) + 1.30 (2011-06-11) + added ability to load files via callbacks to accomidate custom input streams (Ben Wenger) + removed deprecated format-specific test/load functions + removed support for installable file formats (stbi_loader) -- would have been broken for IO callbacks anyway + error cases in bmp and tga give messages and don't leak (Raymond Barbiero, grisha) + fix inefficiency in decoding 32-bit BMP (David Woo) + 1.29 (2010-08-16) + various warning fixes from Aurelien Pocheville + 1.28 (2010-08-01) + fix bug in GIF palette transparency (SpartanJ) + 1.27 (2010-08-01) + cast-to-stbi_uc to fix warnings + 1.26 (2010-07-24) + fix bug in file buffering for PNG reported by SpartanJ + 1.25 (2010-07-17) + refix trans_data warning (Won Chun) + 1.24 (2010-07-12) + perf improvements reading from files on platforms with lock-heavy fgetc() + minor perf improvements for jpeg + deprecated type-specific functions so we'll get feedback if they're needed + attempt to fix trans_data warning (Won Chun) + 1.23 fixed bug in iPhone support + 1.22 (2010-07-10) + removed image *writing* support + stbi_info support from Jetro Lauha + GIF support from Jean-Marc Lienher + iPhone PNG-extensions from James Brown + warning-fixes from Nicolas Schulz and Janez Zemva (i.stbi__err. Janez (U+017D)emva) + 1.21 fix use of 'stbi_uc' in header (reported by jon blow) + 1.20 added support for Softimage PIC, by Tom Seddon + 1.19 bug in interlaced PNG corruption check (found by ryg) + 1.18 (2008-08-02) + fix a threading bug (local mutable static) + 1.17 support interlaced PNG + 1.16 major bugfix - stbi__convert_format converted one too many pixels + 1.15 initialize some fields for thread safety + 1.14 fix threadsafe conversion bug + header-file-only version (#define STBI_HEADER_FILE_ONLY before including) + 1.13 threadsafe + 1.12 const qualifiers in the API + 1.11 Support installable IDCT, colorspace conversion routines + 1.10 Fixes for 64-bit (don't use "unsigned long") + optimized upsampling by Fabian "ryg" Giesen + 1.09 Fix format-conversion for PSD code (bad global variables!) + 1.08 Thatcher Ulrich's PSD code integrated by Nicolas Schulz + 1.07 attempt to fix C++ warning/errors again + 1.06 attempt to fix C++ warning/errors again + 1.05 fix TGA loading to return correct *comp and use good luminance calc + 1.04 default float alpha is 1, not 255; use 'void *' for stbi_image_free + 1.03 bugfixes to STBI_NO_STDIO, STBI_NO_HDR + 1.02 support for (subset of) HDR files, float interface for preferred access to them + 1.01 fix bug: possible bug in handling right-side up bmps... not sure + fix bug: the stbi__bmp_load() and stbi__tga_load() functions didn't work at all + 1.00 interface to zlib that skips zlib header + 0.99 correct handling of alpha in palette + 0.98 TGA loader by lonesock; dynamically add loaders (untested) + 0.97 jpeg errors on too large a file; also catch another malloc failure + 0.96 fix detection of invalid v value - particleman@mollyrocket forum + 0.95 during header scan, seek to markers in case of padding + 0.94 STBI_NO_STDIO to disable stdio usage; rename all #defines the same + 0.93 handle jpegtran output; verbose errors + 0.92 read 4,8,16,24,32-bit BMP files of several formats + 0.91 output 24-bit Windows 3.0 BMP files + 0.90 fix a few more warnings; bump version number to approach 1.0 + 0.61 bugfixes due to Marc LeBlanc, Christopher Lloyd + 0.60 fix compiling as c++ + 0.59 fix warnings: merge Dave Moore's -Wall fixes + 0.58 fix bug: zlib uncompressed mode len/nlen was wrong endian + 0.57 fix bug: jpg last huffman symbol before marker was >9 bits but less than 16 available + 0.56 fix bug: zlib uncompressed mode len vs. nlen + 0.55 fix bug: restart_interval not initialized to 0 + 0.54 allow NULL for 'int *comp' + 0.53 fix bug in png 3->4; speedup png decoding + 0.52 png handles req_comp=3,4 directly; minor cleanup; jpeg comments + 0.51 obey req_comp requests, 1-component jpegs return as 1-component, + on 'test' only check type, not whether we support this variant + 0.50 (2006-11-19) + first released version +*/ + + +/* +------------------------------------------------------------------------------ +This software is available under 2 licenses -- choose whichever you prefer. +------------------------------------------------------------------------------ +ALTERNATIVE A - MIT License +Copyright (c) 2017 Sean Barrett +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies +of the Software, and to permit persons to whom the Software is furnished to do +so, subject to the following conditions: +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +------------------------------------------------------------------------------ +ALTERNATIVE B - Public Domain (www.unlicense.org) +This is free and unencumbered software released into the public domain. +Anyone is free to copy, modify, publish, use, compile, sell, or distribute this +software, either in source code form or as a compiled binary, for any purpose, +commercial or non-commercial, and by any means. +In jurisdictions that recognize copyright laws, the author or authors of this +software dedicate any and all copyright interest in the software to the public +domain. We make this dedication for the benefit of the public at large and to +the detriment of our heirs and successors. We intend this dedication to be an +overt act of relinquishment in perpetuity of all present and future rights to +this software under copyright law. +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN +ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +------------------------------------------------------------------------------ +*/

+cN8I83`olICW^C^LPSA%8qx6%~ltMDp1yO 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