From 58d5442dc557016464fea9f0f5736d17b23efb1c Mon Sep 17 00:00:00 2001 From: Seven Du Date: Wed, 6 Mar 2019 09:48:20 +0800 Subject: [PATCH] [core] add stb_image to read more supported picture formats --- images/cluecon.jpg | Bin 0 -> 50243 bytes images/cluecon.png | Bin 0 -> 115565 bytes libs/stb/stb_image.h | 7547 +++++++++++++++++++++++++++++++ src/include/switch_core_video.h | 3 + src/switch_core_video.c | 48 + tests/unit/switch_core_video.c | 21 + 6 files changed, 7619 insertions(+) create mode 100644 images/cluecon.jpg create mode 100644 images/cluecon.png create mode 100644 libs/stb/stb_image.h diff --git a/images/cluecon.jpg b/images/cluecon.jpg new file mode 100644 index 0000000000000000000000000000000000000000..a6e89751ea740a812fe188a25c30c870a9eb7056 GIT binary patch literal 50243 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≪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 +#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 +// NOT 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); + +// 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 + + +#ifdef _MSC_VER +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) >> (32 - (y)))) +#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 +// assume GCC or Clang on ARM targets +#define STBI_SIMD_ALIGN(type, name) type name __attribute__((aligned(16))) +#endif + +#ifndef STBI_SIMD_ALIGN +#define STBI_SIMD_ALIGN(type, name) type name +#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]; + + 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->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->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) +{ + fseek((FILE*) user, n, SEEK_CUR); +} + +static int stbi__stdio_eof(void *user) +{ + return feof((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); +#endif + +// this is not threadsafe +static const char *stbi__g_failure_reason; + +STBIDEF const char *stbi_failure_reason(void) +{ + return stbi__g_failure_reason; +} + +static int stbi__err(const char *str) +{ + stbi__g_failure_reason = str; + return 0; +} + +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; +} + +// 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); +} + +// 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) +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 + +// 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); +} + +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) +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 + +// 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 = 0; + +STBIDEF void stbi_set_flip_vertically_on_load(int flag_true_if_should_flip) +{ + stbi__vertically_flip_on_load = flag_true_if_should_flip; +} + +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; + + #ifndef STBI_NO_JPEG + if (stbi__jpeg_test(s)) return stbi__jpeg_load(s,x,y,comp,req_comp, ri); + #endif + #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); + #endif + #ifndef STBI_NO_PIC + if (stbi__pic_test(s)) return stbi__pic_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; + + if (ri.bits_per_channel != 8) { + STBI_ASSERT(ri.bits_per_channel == 16); + 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; + + if (ri.bits_per_channel != 16) { + STBI_ASSERT(ri.bits_per_channel == 8); + 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(_MSC_VER) && 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(_MSC_VER) && 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(_MSC_VER) && defined(STBI_WINDOWS_UTF8) + wchar_t wMode[64]; + wchar_t wFilename[1024]; + if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, filename, -1, wFilename, sizeof(wFilename))) + return 0; + + if (0 == MultiByteToWideChar(65001 /* UTF8 */, 0, mode, -1, wMode, sizeof(wMode))) + return 0; + +#if _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); + 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; +} + +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; +} + +static void stbi__skip(stbi__context *s, int n) +{ + 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; +} + +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; +} + +static int stbi__get16be(stbi__context *s) +{ + int z = stbi__get8(s); + return (z << 8) + stbi__get8(s); +} + +static stbi__uint32 stbi__get32be(stbi__context *s) +{ + stbi__uint32 z = stbi__get16be(s); + return (z << 16) + stbi__get16be(s); +} + +#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); + return z + (stbi__get16le(s) << 16); +} +#endif + +#define STBI__BYTECAST(x) ((stbi_uc) ((x) & 255)) // truncate int to byte without warnings + + +////////////////////////////////////////////////////////////////////////////// +// +// 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); +} + +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); + } + #undef STBI__CASE + } + + STBI_FREE(data); + return good; +} + +static stbi__uint16 stbi__compute_y_16(int r, int g, int b) +{ + return (stbi__uint16) (((r*77) + (g*150) + (29*b)) >> 8); +} + +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); + } + #undef STBI__CASE + } + + STBI_FREE(data); + return good; +} + +#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); + 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]; + 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); + + sgn = (stbi__int32)j->code_buffer >> 31; // sign bit is always in MSB + k = stbi_lrot(j->code_buffer, n); + STBI_ASSERT(n >= 0 && n < (int) (sizeof(stbi__bmask)/sizeof(*stbi__bmask))); + j->code_buffer = k & ~stbi__bmask[n]; + k &= stbi__bmask[n]; + j->code_bits -= n; + return k + (stbi__jbias[n] & ~sgn); +} + +// 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); + 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); + 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) 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; + dc = j->img_comp[b].dc_pred + diff; + j->img_comp[b].dc_pred = dc; + 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 + 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); + diff = t ? stbi__extend_receive(j, t) : 0; + + dc = j->img_comp[b].dc_pred + diff; + j->img_comp[b].dc_pred = dc; + data[0] = (short) (dc << 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 + j->code_buffer <<= s; + j->code_bits -= s; + zig = stbi__jpeg_dezigzag[k++]; + data[zig] = (short) ((r >> 8) << 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) << 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]; + } + 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 + 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; + } + + // 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; +} + +// 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 ) { + // handle 0s at the end of image data from IP Kamera 9060 + while (!stbi__at_eof(j->s)) { + int x = stbi__get8(j->s); + if (x == 255) { + j->marker = stbi__get8(j->s); + break; + } + } + // if we reach eof without hitting a marker, stbi__get_marker() below will fail and we'll eventually return 0 + } + } 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"); + } else { + if (!stbi__process_marker(j, m)) return 0; + } + 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; + + // 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)); + 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)); + 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))); + 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) + +// 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[288]; + stbi__uint16 value[288]; +} 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 stbi_uc stbi__zget8(stbi__zbuf *z) +{ + if (z->zbuffer >= z->zbuffer_end) return 0; + return *z->zbuffer++; +} + +static void stbi__fill_bits(stbi__zbuf *z) +{ + do { + STBI_ASSERT(z->code_buffer < (1U << z->num_bits)); + 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]; + STBI_ASSERT(z->size[b] == s); + 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) 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; + int cur, limit, old_limit; + z->zout = zout; + if (!z->z_expandable) return stbi__err("output buffer limit","Corrupt PNG"); + cur = (int) (z->zout - z->zout_start); + limit = old_limit = (int) (z->zout_end - z->zout_start); + while (cur + n > limit) + 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; + } + 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) return stbi__err("bad huffman code","Corrupt PNG"); + 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 { + STBI_ASSERT(c == 18); + c = stbi__zreceive(a,7)+11; + } + 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; + } + STBI_ASSERT(a->num_bits == 0); + // 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 ((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[288] = +{ + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, + 8,8,8,8,8,8,8,8,8,8,8,8,8,8,8,8, 8,8,8,8,8,8,8,8,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 , 288)) 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) { + STBI_ASSERT(img_width_bytes <= x); + 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); + 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 = 0; +static int stbi__de_iphone_flag = 0; + +STBIDEF void stbi_set_unpremultiply_on_load(int flag_true_if_should_unpremultiply) +{ + stbi__unpremultiply_on_load = flag_true_if_should_unpremultiply; +} + +STBIDEF void stbi_convert_iphone_png_to_rgb(int flag_true_if_should_convert) +{ + stbi__de_iphone_flag = flag_true_if_should_convert; +} + +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); if (s->img_x > (1 << 24)) return stbi__err("too large","Very large image (corrupt?)"); + s->img_y = stbi__get32be(s); if (s->img_y > (1 << 24)) 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"); + if (scan == STBI__SCAN_header) return 1; + } 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"); + // if 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; + 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) { s->img_n = pal_img_n; return 1; } + 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; + 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 + ri->bits_per_channel = p->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; z >>= 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 >= 0 && 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; +} stbi__bmp_data; + +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; + + 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"); + 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) { + 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 { + info->mr = 31u << 10; + info->mg = 31u << 5; + info->mb = 31u << 0; + } + } else if (compress == 3) { + info->mr = stbi__get32le(s); + info->mg = stbi__get32le(s); + info->mb = stbi__get32le(s); + // 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 { + 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); + 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); + + 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 - 14 - 24) / 3; + } else { + if (info.bpp < 16) + psize = (info.offset - 14 - info.hsz) >> 2; + } + + 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 - 14 - 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 - 14 - 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); + } + 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); + + // 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) + { + // 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; + // 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); + + // 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 (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); + 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 (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 (!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 dispoase 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(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; + 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) { + out = (stbi_uc*) STBI_REALLOC( out, layers * stride ); + if (delays) { + *delays = (int*) STBI_REALLOC( *delays, sizeof(int) * layers ); + } + } else { + out = (stbi_uc*)stbi__malloc( layers * stride ); + if (delays) { + *delays = (int*) stbi__malloc( 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); + + *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 > 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 > 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); + stbi__rewind( s ); + if (p == NULL) + return 0; + if (x) *x = s->img_x; + if (y) *y = s->img_y; + if (comp) *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; + } + (void) stbi__get32be(s); + (void) 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) +// Does not support 16-bit-per-channel + +#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); + + if (!stbi__pnm_info(s, (int *)&s->img_x, (int *)&s->img_y, (int *)&s->img_n)) + return 0; + + *x = s->img_x; + *y = s->img_y; + if (comp) *comp = s->img_n; + + if (!stbi__mad3sizes_valid(s->img_n, s->img_x, s->img_y, 0)) + return stbi__errpuc("too large", "PNM too large"); + + out = (stbi_uc *) stbi__malloc_mad3(s->img_n, s->img_x, s->img_y, 0); + if (!out) return stbi__errpuc("outofmem", "Out of memory"); + stbi__getn(s, out, s->img_n * s->img_x * s->img_y); + + if (req_comp && req_comp != s->img_n) { + 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); + } + + 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 + stbi__pnm_skip_whitespace(s, &c); + + *y = stbi__pnm_getinteger(s, &c); // read height + stbi__pnm_skip_whitespace(s, &c); + + maxv = stbi__pnm_getinteger(s, &c); // read max value + + if (maxv > 255) + return stbi__err("max value > 255", "PPM image not 8-bit"); + else + return 1; +} +#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 + + return 0; +} + +#ifndef STBI_NO_STDIO +STBIDEF int stbi_info(char const *filename, int *x, int *y, int *comp) +{ + FILE *f = stbi__fopen(filename, "rb"); + int result; + if (!f) return stbi__err("can't fopen", "Unable to open file"); + result = stbi_info_from_file(f, x, y, comp); + fclose(f); + return result; +} + +STBIDEF int stbi_info_from_file(FILE *f, int *x, int *y, int *comp) +{ + int r; + stbi__context s; + long pos = ftell(f); + stbi__start_file(&s, f); + r = stbi__info_main(&s,x,y,comp); + fseek(f,pos,SEEK_SET); + return r; +} + +STBIDEF int stbi_is_16_bit(char const *filename) +{ + FILE *f = stbi__fopen(filename, "rb"); + int result; + if (!f) return stbi__err("can't fopen", "Unable to open file"); + result = stbi_is_16_bit_from_file(f); + fclose(f); + return result; +} + +STBIDEF int stbi_is_16_bit_from_file(FILE *f) +{ + int r; + stbi__context s; + long pos = ftell(f); + stbi__start_file(&s, f); + r = stbi__is_16_main(&s); + fseek(f,pos,SEEK_SET); + return r; +} +#endif // !STBI_NO_STDIO + +STBIDEF int stbi_info_from_memory(stbi_uc const *buffer, int len, int *x, int *y, int *comp) +{ + stbi__context s; + stbi__start_mem(&s,buffer,len); + return stbi__info_main(&s,x,y,comp); +} + +STBIDEF int stbi_info_from_callbacks(stbi_io_callbacks const *c, void *user, int *x, int *y, int *comp) +{ + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks *) c, user); + return stbi__info_main(&s,x,y,comp); +} + +STBIDEF int stbi_is_16_bit_from_memory(stbi_uc const *buffer, int len) +{ + stbi__context s; + stbi__start_mem(&s,buffer,len); + return stbi__is_16_main(&s); +} + +STBIDEF int stbi_is_16_bit_from_callbacks(stbi_io_callbacks const *c, void *user) +{ + stbi__context s; + stbi__start_callbacks(&s, (stbi_io_callbacks *) c, user); + return stbi__is_16_main(&s); +} + +#endif // STB_IMAGE_IMPLEMENTATION + +/* + revision history: + 2.20 (2019-02-07) support utf8 filenames in Windows; fix warnings and platform ifdefs + 2.19 (2018-02-11) fix warning + 2.18 (2018-01-30) fix warnings + 2.17 (2018-01-29) change sbti__shiftsigned to avoid clang -O2 bug + 1-bit BMP + *_is_16_bit api + avoid warnings + 2.16 (2017-07-23) all functions have 16-bit variants; + STBI_NO_STDIO works again; + compilation fixes; + fix rounding in unpremultiply; + optimize vertical flip; + disable raw_len validation; + documentation fixes + 2.15 (2017-03-18) fix png-1,2,4 bug; now all Imagenet JPGs decode; + warning fixes; disable run-time SSE detection on gcc; + uniform handling of optional "return" values; + thread-safe initialization of zlib tables + 2.14 (2017-03-03) remove deprecated STBI_JPEG_OLD; fixes for Imagenet JPGs + 2.13 (2016-11-29) add 16-bit API, only supported for PNG right now + 2.12 (2016-04-02) fix typo in 2.11 PSD fix that caused crashes + 2.11 (2016-04-02) allocate large structures on the stack + remove white matting for transparent PSD + fix reported channel count for PNG & BMP + re-enable SSE2 in non-gcc 64-bit + support RGB-formatted JPEG + read 16-bit PNGs (only as 8-bit) + 2.10 (2016-01-22) avoid warning introduced in 2.09 by STBI_REALLOC_SIZED + 2.09 (2016-01-16) allow comments in PNM files + 16-bit-per-pixel TGA (not bit-per-component) + info() for TGA could break due to .hdr handling + info() for BMP to shares code instead of sloppy parse + can use STBI_REALLOC_SIZED if allocator doesn't support realloc + code cleanup + 2.08 (2015-09-13) fix to 2.07 cleanup, reading RGB PSD as RGBA + 2.07 (2015-09-13) fix compiler warnings + partial animated GIF support + limited 16-bpc PSD support + #ifdef unused functions + bug with < 92 byte PIC,PNM,HDR,TGA + 2.06 (2015-04-19) fix bug where PSD returns wrong '*comp' value + 2.05 (2015-04-19) fix bug in progressive JPEG handling, fix warning + 2.04 (2015-04-15) try to re-enable SIMD on MinGW 64-bit + 2.03 (2015-04-12) extra corruption checking (mmozeiko) + stbi_set_flip_vertically_on_load (nguillemot) + fix NEON support; fix mingw support + 2.02 (2015-01-19) fix incorrect assert, fix warning + 2.01 (2015-01-17) fix various warnings; suppress SIMD on gcc 32-bit without -msse2 + 2.00b (2014-12-25) fix STBI_MALLOC in progressive JPEG + 2.00 (2014-12-25) optimize JPG, including x86 SSE2 & NEON SIMD (ryg) + progressive JPEG (stb) + PGM/PPM support (Ken Miller) + STBI_MALLOC,STBI_REALLOC,STBI_FREE + GIF bugfix -- seemingly never worked + STBI_NO_*, STBI_ONLY_* + 1.48 (2014-12-14) fix incorrectly-named assert() + 1.47 (2014-12-14) 1/2/4-bit PNG support, both direct and paletted (Omar Cornut & stb) + optimize PNG (ryg) + fix bug in interlaced PNG with user-specified channel count (stb) + 1.46 (2014-08-26) + fix broken tRNS chunk (colorkey-style transparency) in non-paletted PNG + 1.45 (2014-08-16) + fix MSVC-ARM internal compiler error by wrapping malloc + 1.44 (2014-08-07) + various warning fixes from Ronny Chevalier + 1.43 (2014-07-15) + fix MSVC-only compiler problem in code changed in 1.42 + 1.42 (2014-07-09) + don't define _CRT_SECURE_NO_WARNINGS (affects user code) + fixes to stbi__cleanup_jpeg path + added STBI_ASSERT to avoid requiring assert.h + 1.41 (2014-06-25) + fix search&replace from 1.36 that messed up comments/error messages + 1.40 (2014-06-22) + fix gcc struct-initialization warning + 1.39 (2014-06-15) + fix to TGA optimization when req_comp != number of components in TGA; + fix to GIF loading because BMP wasn't rewinding (whoops, no GIFs in my test suite) + add support for BMP version 5 (more ignored fields) + 1.38 (2014-06-06) + suppress MSVC warnings on integer casts truncating values + fix accidental rename of 'skip' field of I/O + 1.37 (2014-06-04) + remove duplicate typedef + 1.36 (2014-06-03) + convert to header file single-file library + if de-iphone isn't set, load iphone images color-swapped instead of returning NULL + 1.35 (2014-05-27) + various warnings + fix broken STBI_SIMD path + fix bug where stbi_load_from_file no longer left file pointer in correct place + fix broken non-easy path for 32-bit BMP (possibly never used) + TGA optimization by Arseny Kapoulkine + 1.34 (unknown) + use STBI_NOTUSED in stbi__resample_row_generic(), fix one more leak in tga failure case + 1.33 (2011-07-14) + make stbi_is_hdr work in STBI_NO_HDR (as specified), minor compiler-friendly improvements + 1.32 (2011-07-13) + support for "info" function for all supported filetypes (SpartanJ) + 1.31 (2011-06-20) + a few more leak fixes, bug in PNG handling (SpartanJ) + 1.30 (2011-06-11) + added ability to load files via callbacks to accomidate custom input streams (Ben Wenger) + removed deprecated format-specific test/load functions + removed support for installable file formats (stbi_loader) -- would have been broken for IO callbacks anyway + error cases in bmp and tga give messages and don't leak (Raymond Barbiero, grisha) + fix inefficiency in decoding 32-bit BMP (David Woo) + 1.29 (2010-08-16) + various warning fixes from Aurelien Pocheville + 1.28 (2010-08-01) + fix bug in GIF palette transparency (SpartanJ) + 1.27 (2010-08-01) + cast-to-stbi_uc to fix warnings + 1.26 (2010-07-24) + fix bug in file buffering for PNG reported by SpartanJ + 1.25 (2010-07-17) + refix trans_data warning (Won Chun) + 1.24 (2010-07-12) + perf improvements reading from files on platforms with lock-heavy fgetc() + minor perf improvements for jpeg + deprecated type-specific functions so we'll get feedback if they're needed + attempt to fix trans_data warning (Won Chun) + 1.23 fixed bug in iPhone support + 1.22 (2010-07-10) + removed image *writing* support + stbi_info support from Jetro Lauha + GIF support from Jean-Marc Lienher + iPhone PNG-extensions from James Brown + warning-fixes from Nicolas Schulz and Janez Zemva (i.stbi__err. Janez (U+017D)emva) + 1.21 fix use of 'stbi_uc' in header (reported by jon blow) + 1.20 added support for Softimage PIC, by Tom Seddon + 1.19 bug in interlaced PNG corruption check (found by ryg) + 1.18 (2008-08-02) + fix a threading bug (local mutable static) + 1.17 support interlaced PNG + 1.16 major bugfix - stbi__convert_format converted one too many pixels + 1.15 initialize some fields for thread safety + 1.14 fix threadsafe conversion bug + header-file-only version (#define STBI_HEADER_FILE_ONLY before including) + 1.13 threadsafe + 1.12 const qualifiers in the API + 1.11 Support installable IDCT, colorspace conversion routines + 1.10 Fixes for 64-bit (don't use "unsigned long") + optimized upsampling by Fabian "ryg" Giesen + 1.09 Fix format-conversion for PSD code (bad global variables!) + 1.08 Thatcher Ulrich's PSD code integrated by Nicolas Schulz + 1.07 attempt to fix C++ warning/errors again + 1.06 attempt to fix C++ warning/errors again + 1.05 fix TGA loading to return correct *comp and use good luminance calc + 1.04 default float alpha is 1, not 255; use 'void *' for stbi_image_free + 1.03 bugfixes to STBI_NO_STDIO, STBI_NO_HDR + 1.02 support for (subset of) HDR files, float interface for preferred access to them + 1.01 fix bug: possible bug in handling right-side up bmps... not sure + fix bug: the stbi__bmp_load() and stbi__tga_load() functions didn't work at all + 1.00 interface to zlib that skips zlib header + 0.99 correct handling of alpha in palette + 0.98 TGA loader by lonesock; dynamically add loaders (untested) + 0.97 jpeg errors on too large a file; also catch another malloc failure + 0.96 fix detection of invalid v value - particleman@mollyrocket forum + 0.95 during header scan, seek to markers in case of padding + 0.94 STBI_NO_STDIO to disable stdio usage; rename all #defines the same + 0.93 handle jpegtran output; verbose errors + 0.92 read 4,8,16,24,32-bit BMP files of several formats + 0.91 output 24-bit Windows 3.0 BMP files + 0.90 fix a few more warnings; bump version number to approach 1.0 + 0.61 bugfixes due to Marc LeBlanc, Christopher Lloyd + 0.60 fix compiling as c++ + 0.59 fix warnings: merge Dave Moore's -Wall fixes + 0.58 fix bug: zlib uncompressed mode len/nlen was wrong endian + 0.57 fix bug: jpg last huffman symbol before marker was >9 bits but less than 16 available + 0.56 fix bug: zlib uncompressed mode len vs. nlen + 0.55 fix bug: restart_interval not initialized to 0 + 0.54 allow NULL for 'int *comp' + 0.53 fix bug in png 3->4; speedup png decoding + 0.52 png handles req_comp=3,4 directly; minor cleanup; jpeg comments + 0.51 obey req_comp requests, 1-component jpegs return as 1-component, + on 'test' only check type, not whether we support this variant + 0.50 (2006-11-19) + first released version +*/ + + +/* +------------------------------------------------------------------------------ +This software is available under 2 licenses -- choose whichever you prefer. +------------------------------------------------------------------------------ +ALTERNATIVE A - MIT License +Copyright (c) 2017 Sean Barrett +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies +of the Software, and to permit persons to whom the Software is furnished to do +so, subject to the following conditions: +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +------------------------------------------------------------------------------ +ALTERNATIVE B - Public Domain (www.unlicense.org) +This is free and unencumbered software released into the public domain. +Anyone is free to copy, modify, publish, use, compile, sell, or distribute this +software, either in source code form or as a compiled binary, for any purpose, +commercial or non-commercial, and by any means. +In jurisdictions that recognize copyright laws, the author or authors of this +software dedicate any and all copyright interest in the software to the public +domain. We make this dedication for the benefit of the public at large and to +the detriment of our heirs and successors. We intend this dedication to be an +overt act of relinquishment in perpetuity of all present and future rights to +this software under copyright law. +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN +ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +------------------------------------------------------------------------------ +*/ diff --git a/src/include/switch_core_video.h b/src/include/switch_core_video.h index 21e6b77414..23d1356b78 100644 --- a/src/include/switch_core_video.h +++ b/src/include/switch_core_video.h @@ -395,6 +395,9 @@ SWITCH_DECLARE(switch_status_t) switch_img_write_png(switch_image_t *img, char * SWITCH_DECLARE(switch_status_t) switch_png_open(switch_png_t **pngP, const char *file_name); SWITCH_DECLARE(void) switch_png_free(switch_png_t **pngP); SWITCH_DECLARE(switch_status_t) switch_img_data_url_png(switch_image_t *img, char **urlP); + +/*!\brief Read an image file to switch_image_t */ +SWITCH_DECLARE(switch_image_t *) switch_img_read_from_file(const char *file_name, switch_img_fmt_t img_fmt); /*!\brief put a small img over a big IMG at position x,y, with alpha transparency * diff --git a/src/switch_core_video.c b/src/switch_core_video.c index 540edf0ae9..dcdbe67332 100644 --- a/src/switch_core_video.c +++ b/src/switch_core_video.c @@ -48,6 +48,9 @@ #include #endif +#define STB_IMAGE_IMPLEMENTATION +#include "../libs/stb/stb_image.h" + #ifdef SWITCH_HAVE_YUV static inline void switch_img_get_yuv_pixel(switch_image_t *img, switch_yuv_color_t *yuv, int x, int y); #endif @@ -3100,6 +3103,51 @@ SWITCH_DECLARE(switch_status_t) switch_img_data_url_png(switch_image_t *img, cha #endif +SWITCH_DECLARE(switch_image_t *) switch_img_read_from_file(const char* file_name, switch_img_fmt_t img_fmt) +{ + int width = 0, height = 0, channels = 8; + int comp = STBI_rgb; + unsigned char *data = NULL; + + if (img_fmt == SWITCH_IMG_FMT_I420) { + comp = STBI_rgb; + } else if (img_fmt == SWITCH_IMG_FMT_ARGB) { + comp = STBI_rgb_alpha; + } else { + return NULL; + } + + data = stbi_load(file_name, &width, &height, &channels, comp); + // switch_log_printf(SWITCH_CHANNEL_LOG, SWITCH_LOG_ERROR, "%dx%d channels=%d\n", width, height, channels); + + if (data && width > 0 && height > 0) { + switch_image_t *img = switch_img_alloc(NULL, img_fmt, width, height, 1); + switch_assert(img); + + if (img_fmt == SWITCH_IMG_FMT_I420) { + RAWToI420(data, width * 3, + img->planes[SWITCH_PLANE_Y], img->stride[SWITCH_PLANE_Y], + img->planes[SWITCH_PLANE_U], img->stride[SWITCH_PLANE_U], + img->planes[SWITCH_PLANE_V], img->stride[SWITCH_PLANE_V], + width, height); + } else if (img_fmt == SWITCH_IMG_FMT_ARGB) { +#if SWITCH_BYTE_ORDER == __BIG_ENDIAN + RGBAToARGB(data, width * 4, img->planes[SWITCH_PLANE_PACKED], img->stride[SWITCH_PLANE_PACKED], width, height); +#else + ABGRToARGB(data, width * 4, img->planes[SWITCH_PLANE_PACKED], img->stride[SWITCH_PLANE_PACKED], width, height); +#endif + } + + stbi_image_free(data); + + return img; + } else if (data) { + stbi_image_free(data); + } + + return NULL; +} + SWITCH_DECLARE(switch_status_t) switch_img_letterbox(switch_image_t *img, switch_image_t **imgP, int width, int height, const char *color) { int img_w = 0, img_h = 0; diff --git a/tests/unit/switch_core_video.c b/tests/unit/switch_core_video.c index 7d42eaae1f..cafa075337 100644 --- a/tests/unit/switch_core_video.c +++ b/tests/unit/switch_core_video.c @@ -199,6 +199,27 @@ FST_CORE_BEGIN("./conf") switch_img_free(&timg_small); } FST_TEST_END() + + FST_TEST_BEGIN(read_from_file) + { + switch_image_t *img; + + img = switch_img_read_from_file("../../images/cluecon.png", SWITCH_IMG_FMT_I420); + fst_requires(img); + switch_img_write_png(img, "cluecon-rgb.png"); + switch_img_free(&img); + + img = switch_img_read_from_file("../../images/cluecon.png", SWITCH_IMG_FMT_ARGB); + fst_requires(img); + switch_img_write_png(img, "cluecon-argb.png"); + switch_img_free(&img); + + img = switch_img_read_from_file("../../images/cluecon.jpg", SWITCH_IMG_FMT_I420); + fst_requires(img); + switch_img_write_png(img, "cluecon-jpg.png"); + switch_img_free(&img); + } + FST_TEST_END() } FST_SUITE_END() }