/*

Copyright (c) 2014 - 2019, Syoyo Fujita and many contributors.

All rights reserved.

Redistribution and use in source and binary forms, with or without

modification, are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above copyright

notice, this list of conditions and the following disclaimer.

* Redistributions in binary form must reproduce the above copyright

notice, this list of conditions and the following disclaimer in the

documentation and/or other materials provided with the distribution.

* Neither the name of the Syoyo Fujita nor the

names of its contributors may be used to endorse or promote products

derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND

ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED

WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE

DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY

DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES

(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;

LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND

ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS

SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

*/

// TinyEXR contains some OpenEXR code, which is licensed under ------------

///////////////////////////////////////////////////////////////////////////

//

// Copyright (c) 2002, Industrial Light & Magic, a division of Lucas

// Digital Ltd. LLC

//

// All rights reserved.

//

// Redistribution and use in source and binary forms, with or without

// modification, are permitted provided that the following conditions are

// met:

// * Redistributions of source code must retain the above copyright

// notice, this list of conditions and the following disclaimer.

// * Redistributions in binary form must reproduce the above

// copyright notice, this list of conditions and the following disclaimer

// in the documentation and/or other materials provided with the

// distribution.

// * Neither the name of Industrial Light & Magic nor the names of

// its contributors may be used to endorse or promote products derived

// from this software without specific prior written permission.

//

// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS

// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT

// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR

// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT

// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,

// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT

// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,

// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY

// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE

// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

//

///////////////////////////////////////////////////////////////////////////

// End of OpenEXR license -------------------------------------------------

#ifndef TINYEXR_H_

#define TINYEXR_H_

//

//

// Do this:

// #define TINYEXR_IMPLEMENTATION

// before you include this file in *one* C or C++ file to create the

// implementation.

//

// // i.e. it should look like this:

// #include ...

// #include ...

// #include ...

// #define TINYEXR_IMPLEMENTATION

// #include "tinyexr.h"

//

//

#include <stddef.h> // for size_t

#include <stdint.h> // guess stdint.h is available(C99)

#ifdef __cplusplus

extern "C" {

#endif

// Use embedded miniz or not to decode ZIP format pixel. Linking with zlib

// required if this flas is 0.

#ifndef TINYEXR_USE_MINIZ

#define TINYEXR_USE_MINIZ (1)

#endif

// Disable PIZ comporession when applying cpplint.

#ifndef TINYEXR_USE_PIZ

#define TINYEXR_USE_PIZ (1)

#endif

#ifndef TINYEXR_USE_ZFP

#define TINYEXR_USE_ZFP (0) // TinyEXR extension.

// http://computation.llnl.gov/projects/floating-point-compression

#endif

#ifndef TINYEXR_USE_THREAD

#define TINYEXR_USE_THREAD (0) // No threaded loading.

// http://computation.llnl.gov/projects/floating-point-compression

#endif

#ifndef TINYEXR_USE_OPENMP

#ifdef _OPENMP

#define TINYEXR_USE_OPENMP (1)

#else

#define TINYEXR_USE_OPENMP (0)

#endif

#endif

#define TINYEXR_SUCCESS (0)

#define TINYEXR_ERROR_INVALID_MAGIC_NUMBER (-1)

#define TINYEXR_ERROR_INVALID_EXR_VERSION (-2)

#define TINYEXR_ERROR_INVALID_ARGUMENT (-3)

#define TINYEXR_ERROR_INVALID_DATA (-4)

#define TINYEXR_ERROR_INVALID_FILE (-5)

#define TINYEXR_ERROR_INVALID_PARAMETER (-6)

#define TINYEXR_ERROR_CANT_OPEN_FILE (-7)

#define TINYEXR_ERROR_UNSUPPORTED_FORMAT (-8)

#define TINYEXR_ERROR_INVALID_HEADER (-9)

#define TINYEXR_ERROR_UNSUPPORTED_FEATURE (-10)

#define TINYEXR_ERROR_CANT_WRITE_FILE (-11)

#define TINYEXR_ERROR_SERIALZATION_FAILED (-12)

#define TINYEXR_ERROR_LAYER_NOT_FOUND (-13)

// @note { OpenEXR file format: http://www.openexr.com/openexrfilelayout.pdf }

// pixel type: possible values are: UINT = 0 HALF = 1 FLOAT = 2

#define TINYEXR_PIXELTYPE_UINT (0)

#define TINYEXR_PIXELTYPE_HALF (1)

#define TINYEXR_PIXELTYPE_FLOAT (2)

#define TINYEXR_MAX_HEADER_ATTRIBUTES (1024)

#define TINYEXR_MAX_CUSTOM_ATTRIBUTES (128)

#define TINYEXR_COMPRESSIONTYPE_NONE (0)

#define TINYEXR_COMPRESSIONTYPE_RLE (1)

#define TINYEXR_COMPRESSIONTYPE_ZIPS (2)

#define TINYEXR_COMPRESSIONTYPE_ZIP (3)

#define TINYEXR_COMPRESSIONTYPE_PIZ (4)

#define TINYEXR_COMPRESSIONTYPE_ZFP (128) // TinyEXR extension

#define TINYEXR_ZFP_COMPRESSIONTYPE_RATE (0)

#define TINYEXR_ZFP_COMPRESSIONTYPE_PRECISION (1)

#define TINYEXR_ZFP_COMPRESSIONTYPE_ACCURACY (2)

#define TINYEXR_TILE_ONE_LEVEL (0)

#define TINYEXR_TILE_MIPMAP_LEVELS (1)

#define TINYEXR_TILE_RIPMAP_LEVELS (2)

#define TINYEXR_TILE_ROUND_DOWN (0)

#define TINYEXR_TILE_ROUND_UP (1)

typedef struct _EXRVersion {

int version; // this must be 2

int tiled; // tile format image

int long_name; // long name attribute

int non_image; // deep image(EXR 2.0)

int multipart; // multi-part(EXR 2.0)

} EXRVersion;

typedef struct _EXRAttribute {

char name[256]; // name and type are up to 255 chars long.

char type[256];

unsigned char *value; // uint8_t*

int size;

int pad0;

} EXRAttribute;

typedef struct _EXRChannelInfo {

char name[256]; // less than 255 bytes long

int pixel_type;

int x_sampling;

int y_sampling;

unsigned char p_linear;

unsigned char pad[3];

} EXRChannelInfo;

typedef struct _EXRTile {

int offset_x;

int offset_y;

int level_x;

int level_y;

int width; // actual width in a tile.

int height; // actual height int a tile.

unsigned char **images; // image[channels][pixels]

} EXRTile;

typedef struct _EXRHeader {

float pixel_aspect_ratio;

int line_order;

int data_window[4];

int display_window[4];

float screen_window_center[2];

float screen_window_width;

int chunk_count;

// Properties for tiled format(`tiledesc`).

int tiled;

int tile_size_x;

int tile_size_y;

int tile_level_mode;

int tile_rounding_mode;

int long_name;

int non_image;

int multipart;

unsigned int header_len;

// Custom attributes(exludes required attributes(e.g. `channels`,

// `compression`, etc)

int num_custom_attributes;

EXRAttribute *custom_attributes; // array of EXRAttribute. size =

// `num_custom_attributes`.

EXRChannelInfo *channels; // [num_channels]

int *pixel_types; // Loaded pixel type(TINYEXR_PIXELTYPE_*) of `images` for

// each channel. This is overwritten with `requested_pixel_types` when

// loading.

int num_channels;

int compression_type; // compression type(TINYEXR_COMPRESSIONTYPE_*)

int *requested_pixel_types; // Filled initially by

// ParseEXRHeaderFrom(Meomory|File), then users

// can edit it(only valid for HALF pixel type

// channel)

} EXRHeader;

typedef struct _EXRMultiPartHeader {

int num_headers;

EXRHeader *headers;

} EXRMultiPartHeader;

typedef struct _EXRImage {

EXRTile *tiles; // Tiled pixel data. The application must reconstruct image

// from tiles manually. NULL if scanline format.

unsigned char **images; // image[channels][pixels]. NULL if tiled format.

int width;

int height;

int num_channels;

// Properties for tile format.

int num_tiles;

} EXRImage;

typedef struct _EXRMultiPartImage {

int num_images;

EXRImage *images;

} EXRMultiPartImage;

typedef struct _DeepImage {

const char **channel_names;

float ***image; // image[channels][scanlines][samples]

int **offset_table; // offset_table[scanline][offsets]

int num_channels;

int width;

int height;

int pad0;

} DeepImage;

// @deprecated { For backward compatibility. Not recommended to use. }

// Loads single-frame OpenEXR image. Assume EXR image contains A(single channel

// alpha) or RGB(A) channels.

// Application must free image data as returned by `out_rgba`

// Result image format is: float x RGBA x width x hight

// Returns negative value and may set error string in `err` when there's an

// error

extern int LoadEXR(float **out_rgba, int *width, int *height,

const char *filename, const char **err);

// Loads single-frame OpenEXR image by specifing layer name. Assume EXR image contains A(single channel

// alpha) or RGB(A) channels.

// Application must free image data as returned by `out_rgba`

// Result image format is: float x RGBA x width x hight

// Returns negative value and may set error string in `err` when there's an

// error

// When the specified layer name is not found in the EXR file, the function will return `TINYEXR_ERROR_LAYER_NOT_FOUND`.

extern int LoadEXRWithLayer(float **out_rgba, int *width, int *height,

const char *filename, const char *layer_name, const char **err);

//

// Get layer infos from EXR file.

//

// @param[out] layer_names List of layer names. Application must free memory after using this.

// @param[out] num_layers The number of layers

// @param[out] err Error string(wll be filled when the function returns error code). Free it using FreeEXRErrorMessage after using this value.

//

// @return TINYEXR_SUCCEES upon success.

//

extern int EXRLayers(const char *filename, const char **layer_names[], int *num_layers, const char **err);

// @deprecated { to be removed. }

// Simple wrapper API for ParseEXRHeaderFromFile.

// checking given file is a EXR file(by just look up header)

// @return TINYEXR_SUCCEES for EXR image, TINYEXR_ERROR_INVALID_HEADER for

// others

extern int IsEXR(const char *filename);

// @deprecated { to be removed. }

// Saves single-frame OpenEXR image. Assume EXR image contains RGB(A) channels.

// components must be 1(Grayscale), 3(RGB) or 4(RGBA).

// Input image format is: `float x width x height`, or `float x RGB(A) x width x

// hight`

// Save image as fp16(HALF) format when `save_as_fp16` is positive non-zero

// value.

// Save image as fp32(FLOAT) format when `save_as_fp16` is 0.

// Use ZIP compression by default.

// Returns negative value and may set error string in `err` when there's an

// error

extern int SaveEXR(const float *data, const int width, const int height,

const int components, const int save_as_fp16,

const char *filename, const char **err);

// Initialize EXRHeader struct

extern void InitEXRHeader(EXRHeader *exr_header);

// Initialize EXRImage struct

extern void InitEXRImage(EXRImage *exr_image);

// Free's internal data of EXRHeader struct

extern int FreeEXRHeader(EXRHeader *exr_header);

// Free's internal data of EXRImage struct

extern int FreeEXRImage(EXRImage *exr_image);

// Free's error message

extern void FreeEXRErrorMessage(const char *msg);

// Parse EXR version header of a file.

extern int ParseEXRVersionFromFile(EXRVersion *version, const char *filename);

// Parse EXR version header from memory-mapped EXR data.

extern int ParseEXRVersionFromMemory(EXRVersion *version,

const unsigned char *memory, size_t size);

// Parse single-part OpenEXR header from a file and initialize `EXRHeader`.

// When there was an error message, Application must free `err` with

// FreeEXRErrorMessage()

extern int ParseEXRHeaderFromFile(EXRHeader *header, const EXRVersion *version,

const char *filename, const char **err);

// Parse single-part OpenEXR header from a memory and initialize `EXRHeader`.

// When there was an error message, Application must free `err` with

// FreeEXRErrorMessage()

extern int ParseEXRHeaderFromMemory(EXRHeader *header,

const EXRVersion *version,

const unsigned char *memory, size_t size,

const char **err);

// Parse multi-part OpenEXR headers from a file and initialize `EXRHeader*`

// array.

// When there was an error message, Application must free `err` with

// FreeEXRErrorMessage()

extern int ParseEXRMultipartHeaderFromFile(EXRHeader ***headers,

int *num_headers,

const EXRVersion *version,

const char *filename,

const char **err);

// Parse multi-part OpenEXR headers from a memory and initialize `EXRHeader*`

// array

// When there was an error message, Application must free `err` with

// FreeEXRErrorMessage()

extern int ParseEXRMultipartHeaderFromMemory(EXRHeader ***headers,

int *num_headers,

const EXRVersion *version,

const unsigned char *memory,

size_t size, const char **err);

// Loads single-part OpenEXR image from a file.

// Application must setup `ParseEXRHeaderFromFile` before calling this function.

// Application can free EXRImage using `FreeEXRImage`

// Returns negative value and may set error string in `err` when there's an

// error

// When there was an error message, Application must free `err` with

// FreeEXRErrorMessage()

extern int LoadEXRImageFromFile(EXRImage *image, const EXRHeader *header,

const char *filename, const char **err);

// Loads single-part OpenEXR image from a memory.

// Application must setup `EXRHeader` with

// `ParseEXRHeaderFromMemory` before calling this function.

// Application can free EXRImage using `FreeEXRImage`

// Returns negative value and may set error string in `err` when there's an

// error

// When there was an error message, Application must free `err` with

// FreeEXRErrorMessage()

extern int LoadEXRImageFromMemory(EXRImage *image, const EXRHeader *header,

const unsigned char *memory,

const size_t size, const char **err);

// Loads multi-part OpenEXR image from a file.

// Application must setup `ParseEXRMultipartHeaderFromFile` before calling this

// function.

// Application can free EXRImage using `FreeEXRImage`

// Returns negative value and may set error string in `err` when there's an

// error

// When there was an error message, Application must free `err` with

// FreeEXRErrorMessage()

extern int LoadEXRMultipartImageFromFile(EXRImage *images,

const EXRHeader **headers,

unsigned int num_parts,

const char *filename,

const char **err);

// Loads multi-part OpenEXR image from a memory.

// Application must setup `EXRHeader*` array with

// `ParseEXRMultipartHeaderFromMemory` before calling this function.

// Application can free EXRImage using `FreeEXRImage`

// Returns negative value and may set error string in `err` when there's an

// error

// When there was an error message, Application must free `err` with

// FreeEXRErrorMessage()

extern int LoadEXRMultipartImageFromMemory(EXRImage *images,

const EXRHeader **headers,

unsigned int num_parts,

const unsigned char *memory,

const size_t size, const char **err);

// Saves multi-channel, single-frame OpenEXR image to a file.

// Returns negative value and may set error string in `err` when there's an

// error

// When there was an error message, Application must free `err` with

// FreeEXRErrorMessage()

extern int SaveEXRImageToFile(const EXRImage *image,

const EXRHeader *exr_header, const char *filename,

const char **err);

// Saves multi-channel, single-frame OpenEXR image to a memory.

// Image is compressed using EXRImage.compression value.

// Return the number of bytes if success.

// Return zero and will set error string in `err` when there's an

// error.

// When there was an error message, Application must free `err` with

// FreeEXRErrorMessage()

extern size_t SaveEXRImageToMemory(const EXRImage *image,

const EXRHeader *exr_header,

unsigned char **memory, const char **err);

// Loads single-frame OpenEXR deep image.

// Application must free memory of variables in DeepImage(image, offset_table)

// Returns negative value and may set error string in `err` when there's an

// error

// When there was an error message, Application must free `err` with

// FreeEXRErrorMessage()

extern int LoadDeepEXR(DeepImage *out_image, const char *filename,

const char **err);

// NOT YET IMPLEMENTED:

// Saves single-frame OpenEXR deep image.

// Returns negative value and may set error string in `err` when there's an

// error

// extern int SaveDeepEXR(const DeepImage *in_image, const char *filename,

// const char **err);

// NOT YET IMPLEMENTED:

// Loads multi-part OpenEXR deep image.

// Application must free memory of variables in DeepImage(image, offset_table)

// extern int LoadMultiPartDeepEXR(DeepImage **out_image, int num_parts, const

// char *filename,

// const char **err);

// For emscripten.

// Loads single-frame OpenEXR image from memory. Assume EXR image contains

// RGB(A) channels.

// Returns negative value and may set error string in `err` when there's an

// error

// When there was an error message, Application must free `err` with

// FreeEXRErrorMessage()

extern int LoadEXRFromMemory(float **out_rgba, int *width, int *height,

const unsigned char *memory, size_t size,

const char **err);

#ifdef __cplusplus

}

#endif

#endif // TINYEXR_H_

#ifdef TINYEXR_IMPLEMENTATION

#ifndef TINYEXR_IMPLEMENTATION_DEIFNED

#define TINYEXR_IMPLEMENTATION_DEIFNED

#include <algorithm>

#include <cstdio>

#include <cstdlib>

#include <cstring>

#include <sstream>

// #include <iostream> // debug

#include <limits>

#include <string>

#include <vector>

#if __cplusplus > 199711L

// C++11

#include <cstdint>

#if TINYEXR_USE_THREAD

#include <atomic>

#include <thread>

#endif

#endif // __cplusplus > 199711L

#if TINYEXR_USE_OPENMP

#include <omp.h>

#endif

#if TINYEXR_USE_MINIZ

#else

// Issue #46. Please include your own zlib-compatible API header before

// including `tinyexr.h`

//#include "zlib.h"

#endif

#if TINYEXR_USE_ZFP

#include "zfp.h"

#endif

namespace tinyexr {

#if __cplusplus > 199711L

// C++11

typedef uint64_t tinyexr_uint64;

typedef int64_t tinyexr_int64;

#else

// Although `long long` is not a standard type pre C++11, assume it is defined

// as a compiler's extension.

#ifdef __clang__

#pragma clang diagnostic push

#pragma clang diagnostic ignored "-Wc++11-long-long"

#endif

typedef unsigned long long tinyexr_uint64;

typedef long long tinyexr_int64;

#ifdef __clang__

#pragma clang diagnostic pop

#endif

#endif

#if TINYEXR_USE_MINIZ

namespace miniz {

#ifdef __clang__

#pragma clang diagnostic push

#pragma clang diagnostic ignored "-Wc++11-long-long"

#pragma clang diagnostic ignored "-Wold-style-cast"

#pragma clang diagnostic ignored "-Wpadded"

#pragma clang diagnostic ignored "-Wsign-conversion"

#pragma clang diagnostic ignored "-Wc++11-extensions"

#pragma clang diagnostic ignored "-Wconversion"

#pragma clang diagnostic ignored "-Wunused-function"

#pragma clang diagnostic ignored "-Wc++98-compat-pedantic"

#pragma clang diagnostic ignored "-Wundef"

#if __has_warning("-Wcomma")

#pragma clang diagnostic ignored "-Wcomma"

#endif

#if __has_warning("-Wmacro-redefined")

#pragma clang diagnostic ignored "-Wmacro-redefined"

#endif

#if __has_warning("-Wcast-qual")

#pragma clang diagnostic ignored "-Wcast-qual"

#endif

#if __has_warning("-Wzero-as-null-pointer-constant")

#pragma clang diagnostic ignored "-Wzero-as-null-pointer-constant"

#endif

#if __has_warning("-Wtautological-constant-compare")

#pragma clang diagnostic ignored "-Wtautological-constant-compare"

#endif

#if __has_warning("-Wextra-semi-stmt")

#pragma clang diagnostic ignored "-Wextra-semi-stmt"

#endif

#endif

/* miniz.c v1.15 - public domain deflate/inflate, zlib-subset, ZIP

reading/writing/appending, PNG writing

See "unlicense" statement at the end of this file.

Rich Geldreich <richgel99@gmail.com>, last updated Oct. 13, 2013

Implements RFC 1950: http://www.ietf.org/rfc/rfc1950.txt and RFC 1951:

http://www.ietf.org/rfc/rfc1951.txt

Most API's defined in miniz.c are optional. For example, to disable the

archive related functions just define

MINIZ_NO_ARCHIVE_APIS, or to get rid of all stdio usage define MINIZ_NO_STDIO

(see the list below for more macros).

* Change History

10/13/13 v1.15 r4 - Interim bugfix release while I work on the next major

release with Zip64 support (almost there!):

- Critical fix for the MZ_ZIP_FLAG_DO_NOT_SORT_CENTRAL_DIRECTORY bug

(thanks kahmyong.moon@hp.com) which could cause locate files to not find

files. This bug

would only have occured in earlier versions if you explicitly used this

flag, OR if you used mz_zip_extract_archive_file_to_heap() or

mz_zip_add_mem_to_archive_file_in_place()

(which used this flag). If you can't switch to v1.15 but want to fix

this bug, just remove the uses of this flag from both helper funcs (and of

course don't use the flag).

- Bugfix in mz_zip_reader_extract_to_mem_no_alloc() from kymoon when

pUser_read_buf is not NULL and compressed size is > uncompressed size

- Fixing mz_zip_reader_extract_*() funcs so they don't try to extract

compressed data from directory entries, to account for weird zipfiles which

contain zero-size compressed data on dir entries.

Hopefully this fix won't cause any issues on weird zip archives,

because it assumes the low 16-bits of zip external attributes are DOS

attributes (which I believe they always are in practice).

- Fixing mz_zip_reader_is_file_a_directory() so it doesn't check the

internal attributes, just the filename and external attributes

- mz_zip_reader_init_file() - missing MZ_FCLOSE() call if the seek failed

- Added cmake support for Linux builds which builds all the examples,

tested with clang v3.3 and gcc v4.6.

- Clang fix for tdefl_write_image_to_png_file_in_memory() from toffaletti

- Merged MZ_FORCEINLINE fix from hdeanclark

- Fix <time.h> include before config #ifdef, thanks emil.brink

- Added tdefl_write_image_to_png_file_in_memory_ex(): supports Y flipping

(super useful for OpenGL apps), and explicit control over the compression

level (so you can

set it to 1 for real-time compression).

- Merged in some compiler fixes from paulharris's github repro.

- Retested this build under Windows (VS 2010, including static analysis),

tcc 0.9.26, gcc v4.6 and clang v3.3.

- Added example6.c, which dumps an image of the mandelbrot set to a PNG

file.

- Modified example2 to help test the

MZ_ZIP_FLAG_DO_NOT_SORT_CENTRAL_DIRECTORY flag more.

- In r3: Bugfix to mz_zip_writer_add_file() found during merge: Fix

possible src file fclose() leak if alignment bytes+local header file write

faiiled

- In r4: Minor bugfix to mz_zip_writer_add_from_zip_reader():

Was pushing the wrong central dir header offset, appears harmless in this

release, but it became a problem in the zip64 branch

5/20/12 v1.14 - MinGW32/64 GCC 4.6.1 compiler fixes: added MZ_FORCEINLINE,

#include <time.h> (thanks fermtect).

5/19/12 v1.13 - From jason@cornsyrup.org and kelwert@mtu.edu - Fix

mz_crc32() so it doesn't compute the wrong CRC-32's when mz_ulong is 64-bit.

- Temporarily/locally slammed in "typedef unsigned long mz_ulong" and

re-ran a randomized regression test on ~500k files.

- Eliminated a bunch of warnings when compiling with GCC 32-bit/64.

- Ran all examples, miniz.c, and tinfl.c through MSVC 2008's /analyze

(static analysis) option and fixed all warnings (except for the silly

"Use of the comma-operator in a tested expression.." analysis warning,

which I purposely use to work around a MSVC compiler warning).

- Created 32-bit and 64-bit Codeblocks projects/workspace. Built and

tested Linux executables. The codeblocks workspace is compatible with

Linux+Win32/x64.

- Added miniz_tester solution/project, which is a useful little app

derived from LZHAM's tester app that I use as part of the regression test.

- Ran miniz.c and tinfl.c through another series of regression testing on

~500,000 files and archives.

- Modified example5.c so it purposely disables a bunch of high-level

functionality (MINIZ_NO_STDIO, etc.). (Thanks to corysama for the

MINIZ_NO_STDIO bug report.)

- Fix ftell() usage in examples so they exit with an error on files which

are too large (a limitation of the examples, not miniz itself).

4/12/12 v1.12 - More comments, added low-level example5.c, fixed a couple

minor level_and_flags issues in the archive API's.

level_and_flags can now be set to MZ_DEFAULT_COMPRESSION. Thanks to Bruce

Dawson <bruced@valvesoftware.com> for the feedback/bug report.

5/28/11 v1.11 - Added statement from unlicense.org

5/27/11 v1.10 - Substantial compressor optimizations:

- Level 1 is now ~4x faster than before. The L1 compressor's throughput

now varies between 70-110MB/sec. on a

- Core i7 (actual throughput varies depending on the type of data, and x64

vs. x86).

- Improved baseline L2-L9 compression perf. Also, greatly improved

compression perf. issues on some file types.

- Refactored the compression code for better readability and

maintainability.

- Added level 10 compression level (L10 has slightly better ratio than

level 9, but could have a potentially large

drop in throughput on some files).

5/15/11 v1.09 - Initial stable release.

* Low-level Deflate/Inflate implementation notes:

Compression: Use the "tdefl" API's. The compressor supports raw, static,

and dynamic blocks, lazy or

greedy parsing, match length filtering, RLE-only, and Huffman-only streams.

It performs and compresses

approximately as well as zlib.

Decompression: Use the "tinfl" API's. The entire decompressor is

implemented as a single function

coroutine: see tinfl_decompress(). It supports decompression into a 32KB

(or larger power of 2) wrapping buffer, or into a memory

block large enough to hold the entire file.

The low-level tdefl/tinfl API's do not make any use of dynamic memory

allocation.

* zlib-style API notes:

miniz.c implements a fairly large subset of zlib. There's enough

functionality present for it to be a drop-in

zlib replacement in many apps:

The z_stream struct, optional memory allocation callbacks

deflateInit/deflateInit2/deflate/deflateReset/deflateEnd/deflateBound

inflateInit/inflateInit2/inflate/inflateEnd

compress, compress2, compressBound, uncompress

CRC-32, Adler-32 - Using modern, minimal code size, CPU cache friendly

routines.

Supports raw deflate streams or standard zlib streams with adler-32

checking.

Limitations:

The callback API's are not implemented yet. No support for gzip headers or

zlib static dictionaries.

I've tried to closely emulate zlib's various flavors of stream flushing

and return status codes, but

there are no guarantees that miniz.c pulls this off perfectly.

* PNG writing: See the tdefl_write_image_to_png_file_in_memory() function,

originally written by

Alex Evans. Supports 1-4 bytes/pixel images.

* ZIP archive API notes:

The ZIP archive API's where designed with simplicity and efficiency in

mind, with just enough abstraction to

get the job done with minimal fuss. There are simple API's to retrieve file

information, read files from

existing archives, create new archives, append new files to existing

archives, or clone archive data from

one archive to another. It supports archives located in memory or the heap,

on disk (using stdio.h),

or you can specify custom file read/write callbacks.

- Archive reading: Just call this function to read a single file from a

disk archive:

void *mz_zip_extract_archive_file_to_heap(const char *pZip_filename, const

char *pArchive_name,

size_t *pSize, mz_uint zip_flags);

For more complex cases, use the "mz_zip_reader" functions. Upon opening an

archive, the entire central

directory is located and read as-is into memory, and subsequent file access

only occurs when reading individual files.

- Archives file scanning: The simple way is to use this function to scan a

loaded archive for a specific file:

int mz_zip_reader_locate_file(mz_zip_archive *pZip, const char *pName,

const char *pComment, mz_uint flags);

The locate operation can optionally check file comments too, which (as one

example) can be used to identify

multiple versions of the same file in an archive. This function uses a

simple linear search through the central

directory, so it's not very fast.

Alternately, you can iterate through all the files in an archive (using

mz_zip_reader_get_num_files()) and

retrieve detailed info on each file by calling mz_zip_reader_file_stat().

- Archive creation: Use the "mz_zip_writer" functions. The ZIP writer

immediately writes compressed file data

to disk and builds an exact image of the central directory in memory. The

central directory image is written

all at once at the end of the archive file when the archive is finalized.

The archive writer can optionally align each file's local header and file

data to any power of 2 alignment,

which can be useful when the archive will be read from optical media. Also,

the writer supports placing

arbitrary data blobs at the very beginning of ZIP archives. Archives

written using either feature are still

readable by any ZIP tool.

- Archive appending: The simple way to add a single file to an archive is

to call this function:

mz_bool mz_zip_add_mem_to_archive_file_in_place(const char *pZip_filename,

const char *pArchive_name,

const void *pBuf, size_t buf_size, const void *pComment, mz_uint16

comment_size, mz_uint level_and_flags);

The archive will be created if it doesn't already exist, otherwise it'll be

appended to.

Note the appending is done in-place and is not an atomic operation, so if

something goes wrong

during the operation it's possible the archive could be left without a

central directory (although the local

file headers and file data will be fine, so the archive will be

recoverable).

For more complex archive modification scenarios:

1. The safest way is to use a mz_zip_reader to read the existing archive,

cloning only those bits you want to

preserve into a new archive using using the

mz_zip_writer_add_from_zip_reader() function (which compiles the

compressed file data as-is). When you're done, delete the old archive and

rename the newly written archive, and

you're done. This is safe but requires a bunch of temporary disk space or

heap memory.

2. Or, you can convert an mz_zip_reader in-place to an mz_zip_writer using

mz_zip_writer_init_from_reader(),

append new files as needed, then finalize the archive which will write an

updated central directory to the

original archive. (This is basically what

mz_zip_add_mem_to_archive_file_in_place() does.) There's a

possibility that the archive's central directory could be lost with this

method if anything goes wrong, though.

- ZIP archive support limitations:

No zip64 or spanning support. Extraction functions can only handle

unencrypted, stored or deflated files.

Requires streams capable of seeking.

* This is a header file library, like stb_image.c. To get only a header file,

either cut and paste the

below header, or create miniz.h, #define MINIZ_HEADER_FILE_ONLY, and then

include miniz.c from it.

* Important: For best perf. be sure to customize the below macros for your

target platform:

#define MINIZ_USE_UNALIGNED_LOADS_AND_STORES 1

#define MINIZ_LITTLE_ENDIAN 1

#define MINIZ_HAS_64BIT_REGISTERS 1

* On platforms using glibc, Be sure to "#define _LARGEFILE64_SOURCE 1" before

including miniz.c to ensure miniz

uses the 64-bit variants: fopen64(), stat64(), etc. Otherwise you won't be

able to process large files

(i.e. 32-bit stat() fails for me on files > 0x7FFFFFFF bytes).

*/

#ifndef MINIZ_HEADER_INCLUDED

#define MINIZ_HEADER_INCLUDED

//#include <stdlib.h>

// Defines to completely disable specific portions of miniz.c:

// If all macros here are defined the only functionality remaining will be

// CRC-32, adler-32, tinfl, and tdefl.

// Define MINIZ_NO_STDIO to disable all usage and any functions which rely on

// stdio for file I/O.

//#define MINIZ_NO_STDIO

// If MINIZ_NO_TIME is specified then the ZIP archive functions will not be able

// to get the current time, or

// get/set file times, and the C run-time funcs that get/set times won't be

// called.

// The current downside is the times written to your archives will be from 1979.

#define MINIZ_NO_TIME

// Define MINIZ_NO_ARCHIVE_APIS to disable all ZIP archive API's.

#define MINIZ_NO_ARCHIVE_APIS

// Define MINIZ_NO_ARCHIVE_APIS to disable all writing related ZIP archive

// API's.

//#define MINIZ_NO_ARCHIVE_WRITING_APIS

// Define MINIZ_NO_ZLIB_APIS to remove all ZLIB-style compression/decompression

// API's.

//#define MINIZ_NO_ZLIB_APIS

// Define MINIZ_NO_ZLIB_COMPATIBLE_NAME to disable zlib names, to prevent

// conflicts against stock zlib.

//#define MINIZ_NO_ZLIB_COMPATIBLE_NAMES

// Define MINIZ_NO_MALLOC to disable all calls to malloc, free, and realloc.

// Note if MINIZ_NO_MALLOC is defined then the user must always provide custom

// user alloc/free/realloc

// callbacks to the zlib and archive API's, and a few stand-alone helper API's

// which don't provide custom user

// functions (such as tdefl_compress_mem_to_heap() and

// tinfl_decompress_mem_to_heap()) won't work.

//#define MINIZ_NO_MALLOC

#if defined(__TINYC__) && (defined(__linux) || defined(__linux__))

// TODO: Work around "error: include file 'sys\utime.h' when compiling with tcc

// on Linux

#define MINIZ_NO_TIME

#endif

#if !defined(MINIZ_NO_TIME) && !defined(MINIZ_NO_ARCHIVE_APIS)

//#include <time.h>

#endif

#if defined(_M_IX86) || defined(_M_X64) || defined(__i386__) || \

defined(__i386) || defined(__i486__) || defined(__i486) || \

defined(i386) || defined(__ia64__) || defined(__x86_64__)

// MINIZ_X86_OR_X64_CPU is only used to help set the below macros.

#define MINIZ_X86_OR_X64_CPU 1

#endif

#if defined(__sparcv9)

// Big endian

#else

#if (__BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__) || MINIZ_X86_OR_X64_CPU

// Set MINIZ_LITTLE_ENDIAN to 1 if the processor is little endian.

#define MINIZ_LITTLE_ENDIAN 1

#endif

#endif

#if MINIZ_X86_OR_X64_CPU

// Set MINIZ_USE_UNALIGNED_LOADS_AND_STORES to 1 on CPU's that permit efficient

// integer loads and stores from unaligned addresses.

//#define MINIZ_USE_UNALIGNED_LOADS_AND_STORES 1

#define MINIZ_USE_UNALIGNED_LOADS_AND_STORES \

0 // disable to suppress compiler warnings

#endif

#if defined(_M_X64) || defined(_WIN64) || defined(__MINGW64__) || \

defined(_LP64) || defined(__LP64__) || defined(__ia64__) || \

defined(__x86_64__)

// Set MINIZ_HAS_64BIT_REGISTERS to 1 if operations on 64-bit integers are

// reasonably fast (and don't involve compiler generated calls to helper

// functions).

#define MINIZ_HAS_64BIT_REGISTERS 1

#endif

#ifdef __cplusplus

extern "C" {

#endif

// ------------------- zlib-style API Definitions.

// For more compatibility with zlib, miniz.c uses unsigned long for some

// parameters/struct members. Beware: mz_ulong can be either 32 or 64-bits!

typedef unsigned long mz_ulong;

// mz_free() internally uses the MZ_FREE() macro (which by default calls free()

// unless you've modified the MZ_MALLOC macro) to release a block allocated from

// the heap.

void mz_free(void *p);

#define MZ_ADLER32_INIT (1)

// mz_adler32() returns the initial adler-32 value to use when called with

// ptr==NULL.

mz_ulong mz_adler32(mz_ulong adler, const unsigned char *ptr, size_t buf_len);

#define MZ_CRC32_INIT (0)

// mz_crc32() returns the initial CRC-32 value to use when called with

// ptr==NULL.

mz_ulong mz_crc32(mz_ulong crc, const unsigned char *ptr, size_t buf_len);

// Compression strategies.

enum {

MZ_DEFAULT_STRATEGY = 0,

MZ_FILTERED = 1,

MZ_HUFFMAN_ONLY = 2,

MZ_RLE = 3,

MZ_FIXED = 4

};

// Method

#define MZ_DEFLATED 8

#ifndef MINIZ_NO_ZLIB_APIS

// Heap allocation callbacks.

// Note that mz_alloc_func parameter types purpsosely differ from zlib's:

// items/size is size_t, not unsigned long.

typedef void *(*mz_alloc_func)(void *opaque, size_t items, size_t size);

typedef void (*mz_free_func)(void *opaque, void *address);

typedef void *(*mz_realloc_func)(void *opaque, void *address, size_t items,

size_t size);

#define MZ_VERSION "9.1.15"

#define MZ_VERNUM 0x91F0

#define MZ_VER_MAJOR 9

#define MZ_VER_MINOR 1

#define MZ_VER_REVISION 15

#define MZ_VER_SUBREVISION 0

// Flush values. For typical usage you only need MZ_NO_FLUSH and MZ_FINISH. The

// other values are for advanced use (refer to the zlib docs).

enum {