mirror of
https://github.com/DrBeef/Raze.git
synced 2024-12-11 05:11:20 +00:00
126 lines
4.6 KiB
C++
126 lines
4.6 KiB
C++
#ifndef __M_PNG_H
|
|
#define __M_PNG_H
|
|
/*
|
|
** m_png.h
|
|
**
|
|
**---------------------------------------------------------------------------
|
|
** Copyright 2002-2005 Randy Heit
|
|
** All rights reserved.
|
|
**
|
|
** Redistribution and use in source and binary forms, with or without
|
|
** modification, are permitted provided that the following conditions
|
|
** are met:
|
|
**
|
|
** 1. Redistributions of source code must retain the above copyright
|
|
** notice, this list of conditions and the following disclaimer.
|
|
** 2. 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.
|
|
** 3. The name of the author may not be used to endorse or promote products
|
|
** derived from this software without specific prior written permission.
|
|
**
|
|
** THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 AUTHOR 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.
|
|
**---------------------------------------------------------------------------
|
|
**
|
|
*/
|
|
|
|
#include <stdio.h>
|
|
#include "zstring.h"
|
|
#include "files.h"
|
|
#include "palentry.h"
|
|
#include "basics.h"
|
|
|
|
// Screenshot buffer image data types
|
|
enum ESSType
|
|
{
|
|
SS_PAL,
|
|
SS_RGB,
|
|
SS_BGRA
|
|
};
|
|
|
|
class FileWriter;
|
|
// PNG Writing --------------------------------------------------------------
|
|
|
|
// Start writing an 8-bit palettized PNG file.
|
|
// The passed file should be a newly created file.
|
|
// This function writes the PNG signature and the IHDR, gAMA, PLTE, and IDAT
|
|
// chunks.
|
|
bool M_CreatePNG (FileWriter *file, const uint8_t *buffer, const PalEntry *pal,
|
|
ESSType color_type, int width, int height, int pitch, float gamma);
|
|
|
|
// Creates a grayscale 1x1 PNG file. Used for savegames without savepics.
|
|
bool M_CreateDummyPNG (FileWriter *file);
|
|
|
|
// Appends any chunk to a PNG file started with M_CreatePNG.
|
|
bool M_AppendPNGChunk (FileWriter *file, uint32_t chunkID, const uint8_t *chunkData, uint32_t len);
|
|
|
|
// Adds a tEXt chunk to a PNG file started with M_CreatePNG.
|
|
bool M_AppendPNGText (FileWriter *file, const char *keyword, const char *text);
|
|
|
|
// Appends the IEND chunk to a PNG file.
|
|
bool M_FinishPNG (FileWriter *file);
|
|
|
|
bool M_SaveBitmap(const uint8_t *from, ESSType color_type, int width, int height, int pitch, FileWriter *file);
|
|
|
|
// PNG Reading --------------------------------------------------------------
|
|
|
|
struct PNGHandle
|
|
{
|
|
struct Chunk
|
|
{
|
|
uint32_t ID;
|
|
uint32_t Offset;
|
|
uint32_t Size;
|
|
};
|
|
|
|
FileReader File;
|
|
bool bDeleteFilePtr;
|
|
TArray<Chunk> Chunks;
|
|
TArray<char *> TextChunks;
|
|
unsigned int ChunkPt;
|
|
|
|
PNGHandle(FileReader &file);
|
|
~PNGHandle();
|
|
};
|
|
|
|
// Verify that a file really is a PNG file. This includes not only checking
|
|
// the signature, but also checking for the IEND chunk. CRC checking of
|
|
// each chunk is not done. If it is valid, you get a PNGHandle to pass to
|
|
// the following functions.
|
|
PNGHandle *M_VerifyPNG (FileReader &file);
|
|
|
|
// Finds a chunk in a PNG file. The file pointer will be positioned at the
|
|
// beginning of the chunk data, and its length will be returned. A return
|
|
// value of 0 indicates the chunk was either not present or had 0 length.
|
|
unsigned int M_FindPNGChunk (PNGHandle *png, uint32_t chunkID);
|
|
|
|
// Finds a chunk in the PNG file, starting its search at whatever chunk
|
|
// the file pointer is currently positioned at.
|
|
unsigned int M_NextPNGChunk (PNGHandle *png, uint32_t chunkID);
|
|
|
|
// Finds a PNG text chunk with the given signature and returns a pointer
|
|
// to a NULL-terminated string if present. Returns NULL on failure.
|
|
// (Note: tEXt, not zTXt.)
|
|
char *M_GetPNGText (PNGHandle *png, const char *keyword);
|
|
bool M_GetPNGText (PNGHandle *png, const char *keyword, char *buffer, size_t buffsize);
|
|
|
|
// The file must be positioned at the start of the first IDAT. It reads
|
|
// image data into the provided buffer. Returns true on success.
|
|
bool M_ReadIDAT (FileReader &file, uint8_t *buffer, int width, int height, int pitch,
|
|
uint8_t bitdepth, uint8_t colortype, uint8_t interlace, unsigned int idatlen);
|
|
|
|
|
|
class FGameTexture;
|
|
|
|
FGameTexture *PNGTexture_CreateFromFile(PNGHandle *png, const FString &filename);
|
|
|
|
#endif
|