minor update
This commit is contained in:
186
tests/regression/tex/lupng.h
Normal file
186
tests/regression/tex/lupng.h
Normal file
@@ -0,0 +1,186 @@
|
||||
/*
|
||||
* The MIT License (MIT)
|
||||
*
|
||||
* Copyright (c) 2014 Jan Solanti
|
||||
*
|
||||
* 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.
|
||||
*/
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
#pragma once
|
||||
|
||||
#if defined(_MSC_VER) && (_MSC_VER < 1600)
|
||||
typedef __int8 int8_t;
|
||||
typedef __int16 int16_t;
|
||||
typedef __int32 int32_t;
|
||||
typedef unsigned __int8 uint8_t;
|
||||
typedef unsigned __int16 uint16_t;
|
||||
typedef unsigned __int32 uint32_t;
|
||||
#else
|
||||
#include <stdlib.h>
|
||||
#include <stdint.h>
|
||||
#endif
|
||||
|
||||
typedef struct {
|
||||
int32_t width;
|
||||
int32_t height;
|
||||
uint8_t channels;
|
||||
uint8_t depth; /* must be 8 or 16 */
|
||||
size_t dataSize;
|
||||
uint8_t *data;
|
||||
} LuImage;
|
||||
|
||||
typedef size_t (*PngReadProc)(void *outPtr, size_t size, size_t count, void *userPtr);
|
||||
typedef size_t (*PngWriteProc)(const void *inPtr, size_t size, size_t count, void *userPtr);
|
||||
typedef void* (*PngAllocProc)(size_t size, void *userPtr);
|
||||
typedef void (*PngFreeProc)(void *ptr, void *userPtr);
|
||||
typedef void (*PngWarnProc)(void *userPtr, const char *fmt, ...);
|
||||
|
||||
typedef struct {
|
||||
/* loader */
|
||||
PngReadProc readProc;
|
||||
void *readProcUserPtr;
|
||||
int skipSig;
|
||||
|
||||
/* writer */
|
||||
PngWriteProc writeProc;
|
||||
void *writeProcUserPtr;
|
||||
int compressionLevel;
|
||||
|
||||
/* memory allocation */
|
||||
PngAllocProc allocProc;
|
||||
void *allocProcUserPtr;
|
||||
PngFreeProc freeProc;
|
||||
void *freeProcUserPtr;
|
||||
|
||||
/* warnings/error output */
|
||||
PngWarnProc warnProc; /* set to NULL to disable output altogether */
|
||||
void *warnProcUserPtr;
|
||||
|
||||
/* special case: avoid allocating a LuImage when loading or creating
|
||||
* an image, just use this one */
|
||||
LuImage *overrideImage;
|
||||
} LuUserContext;
|
||||
|
||||
/**
|
||||
* Initializes a LuUserContext to use the defaul malloc implementation.
|
||||
*
|
||||
* @param userCtx the LuUserContext to initialize
|
||||
*/
|
||||
void luUserContextInitDefault(LuUserContext *userCtx);
|
||||
|
||||
/**
|
||||
* Creates a new Image object with the specified attributes.
|
||||
* The data store of the Image is allocated but its contents are undefined.
|
||||
* Only 8 and 16 bits deep images with 1-4 channels are supported.
|
||||
*
|
||||
* @param buffer pointer to an existing buffer (which may already contain the
|
||||
* image data), or NULL to internally allocate a new buffer
|
||||
* @param userCtx the user context (with the memory allocator function
|
||||
* pointers to use), or NULL to use the default allocator
|
||||
* (malloc).
|
||||
*/
|
||||
LuImage *luImageCreate(size_t width, size_t height, uint8_t channels, uint8_t depth,
|
||||
uint8_t *buffer, const LuUserContext *usrCtx);
|
||||
|
||||
/**
|
||||
* Releases the memory associated with the given Image object.
|
||||
*
|
||||
* @param userCtx the user context (with the memory deallocator function
|
||||
* pointers to use), or NULL to use the default deallocator
|
||||
* (free). The deallocator should match the ones used for
|
||||
* allocation.
|
||||
*/
|
||||
void luImageRelease(LuImage *img, const LuUserContext *usrCtx);
|
||||
|
||||
/**
|
||||
* Extracts the raw image buffer form a LuImage and releases the
|
||||
* then-orphaned LuImage object. This can be used if you want to use
|
||||
* the image data in your own structures.
|
||||
*
|
||||
* @param userCtx the user context (with the memory deallocator function
|
||||
* pointers to use), or NULL to use the default deallocator
|
||||
* (free). The deallocator should match the ones used for
|
||||
* allocation.
|
||||
*/
|
||||
uint8_t *luImageExtractBufAndRelease(LuImage *img, const LuUserContext *userCtx);
|
||||
|
||||
/**
|
||||
* Decodes a PNG image from a file
|
||||
*
|
||||
* @param filename the file name (optionally with full path) to read from.
|
||||
* @param userCtx the user context (with the memory allocator function
|
||||
* pointers to use), or NULL to use the default allocator
|
||||
* (malloc).
|
||||
*/
|
||||
LuImage *luPngReadFile(const char *filename, LuUserContext *userCtx);
|
||||
|
||||
/**
|
||||
* Decodes a PNG image with the provided read function into a LuImage struct
|
||||
*
|
||||
* @param readProc a function pointer to a user-defined function to use for
|
||||
* reading the PNG data.
|
||||
* @param userPtr an opaque pointer provided as an argument to readProc
|
||||
* @param skipSig don't verify PNG signature - the bytes have already been
|
||||
* removed from the input stream
|
||||
*/
|
||||
LuImage *luPngRead(PngReadProc readProc, void *userPtr, int skipSig);
|
||||
|
||||
/**
|
||||
* Decodes a PNG image with the provided user context into a LuImage struct
|
||||
*
|
||||
* @param userCtx the LuUserContext to use
|
||||
*/
|
||||
LuImage *luPngReadUC(const LuUserContext *userCtx);
|
||||
|
||||
/**
|
||||
* Encodes a LuImage struct to PNG and writes it out to a file.
|
||||
*
|
||||
* @param filename the file name (optionally with full path) to write to.
|
||||
* Existing files will be overwritten!
|
||||
* @param img the LuImage to encode
|
||||
*/
|
||||
int luPngWriteFile(const char *filename, const LuImage *img);
|
||||
|
||||
/**
|
||||
* Encodes a LuImage struct to PNG and writes it out using a user-defined write
|
||||
* function.
|
||||
*
|
||||
* @param writeProc a function pointer to a user-defined function that will be
|
||||
* used for writing the final PNG data.
|
||||
* @param userPtr an opaque pointer provided as an argument to writeProc
|
||||
* @param img the LuImage to encode
|
||||
*/
|
||||
int luPngWrite(PngWriteProc writeProc, void *userPtr, const LuImage *img);
|
||||
|
||||
/**
|
||||
* Encodes a LuImage struct to PNG and writes it out with the provided user
|
||||
* context.
|
||||
*
|
||||
* @param userCtx the LuUserContext to use
|
||||
* @param img the LuImage to encode
|
||||
*/
|
||||
int luPngWriteUC(const LuUserContext *userCtx, const LuImage *img);
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
Reference in New Issue
Block a user