51 # include <sys/types.h> 52 # include <sys/stat.h> 59 typedef __int8 int8_t;
60 typedef __int16 int16_t;
61 typedef __int32 int32_t;
62 typedef __int64 int64_t;
63 typedef unsigned __int8 uint8_t;
64 typedef unsigned __int16 uint16_t;
65 typedef unsigned __int32 uint32_t;
66 typedef unsigned __int64 uint64_t;
72 # if (_WIN32 && !_WIN64) || (__GNUC__ && !(__x86_64__ || __ppc64__)) 73 # define _WIN32_WINNT 0x0501 76 typedef unsigned int uint;
82 # define CHUNK_ID_RIFF 0x52494646 83 # define CHUNK_ID_RIFX 0x52494658 84 # define CHUNK_ID_LIST 0x4C495354 86 # define LIST_TYPE_INFO 0x494E464F 87 # define CHUNK_ID_ICMT 0x49434D54 88 # define CHUNK_ID_ICOP 0x49434F50 89 # define CHUNK_ID_ICRD 0x49435244 90 # define CHUNK_ID_IENG 0x49454E47 91 # define CHUNK_ID_INAM 0x494E414D 92 # define CHUNK_ID_IPRD 0x49505244 93 # define CHUNK_ID_ISFT 0x49534654 95 # define CHUNK_ID_SMPL 0x736D706C 97 #else // little endian 98 # define CHUNK_ID_RIFF 0x46464952 99 # define CHUNK_ID_RIFX 0x58464952 100 # define CHUNK_ID_LIST 0x5453494C 102 # define LIST_TYPE_INFO 0x4F464E49 103 # define CHUNK_ID_ICMT 0x544D4349 104 # define CHUNK_ID_ICOP 0x504F4349 105 # define CHUNK_ID_ICRD 0x44524349 106 # define CHUNK_ID_IENG 0x474E4549 107 # define CHUNK_ID_INAM 0x4D414E49 108 # define CHUNK_ID_IPRD 0x44525049 109 # define CHUNK_ID_ISFT 0x54465349 111 # define CHUNK_ID_SMPL 0x6C706D73 113 #endif // WORDS_BIGENDIAN 115 #define CHUNK_HEADER_SIZE(fileOffsetSize) (4 + fileOffsetSize) 116 #define LIST_HEADER_SIZE(fileOffsetSize) (8 + fileOffsetSize) 117 #define RIFF_HEADER_SIZE(fileOffsetSize) (8 + fileOffsetSize) 145 typedef std::string String;
152 stream_mode_read = 0,
153 stream_mode_read_write = 1,
154 stream_mode_closed = 2
160 stream_end_reached = 1,
221 String GetChunkIDString()
const;
225 file_offset_t
GetSize()
const {
return ullCurrentChunkSize; }
227 file_offset_t
GetPos()
const {
return ullPos; }
228 file_offset_t
GetFilePos()
const {
return ullStartPos + ullPos; }
229 file_offset_t SetPos(file_offset_t Where,
stream_whence_t Whence = stream_start);
230 file_offset_t RemainingBytes()
const;
232 file_offset_t Read(
void* pData, file_offset_t WordCount, file_offset_t WordSize);
233 file_offset_t ReadInt8(int8_t* pData, file_offset_t WordCount = 1);
234 file_offset_t ReadUint8(uint8_t* pData, file_offset_t WordCount = 1);
235 file_offset_t ReadInt16(int16_t* pData, file_offset_t WordCount = 1);
236 file_offset_t ReadUint16(uint16_t* pData, file_offset_t WordCount = 1);
237 file_offset_t ReadInt32(int32_t* pData, file_offset_t WordCount = 1);
238 file_offset_t ReadUint32(uint32_t* pData, file_offset_t WordCount = 1);
242 uint16_t ReadUint16();
244 uint32_t ReadUint32();
245 void ReadString(String& s,
int size);
246 file_offset_t Write(
void* pData, file_offset_t WordCount, file_offset_t WordSize);
247 file_offset_t WriteInt8(int8_t* pData, file_offset_t WordCount = 1);
248 file_offset_t WriteUint8(uint8_t* pData, file_offset_t WordCount = 1);
249 file_offset_t WriteInt16(int16_t* pData, file_offset_t WordCount = 1);
250 file_offset_t WriteUint16(uint16_t* pData, file_offset_t WordCount = 1);
251 file_offset_t WriteInt32(int32_t* pData, file_offset_t WordCount = 1);
252 file_offset_t WriteUint32(uint32_t* pData, file_offset_t WordCount = 1);
253 void* LoadChunkData();
254 void ReleaseChunkData();
255 void Resize(file_offset_t NewSize);
259 file_offset_t ullCurrentChunkSize;
260 file_offset_t ullNewChunkSize;
263 file_offset_t ullStartPos;
264 file_offset_t ullPos;
266 file_offset_t ullChunkDataSize;
269 Chunk(
File* pFile,
List* pParent, uint32_t uiChunkID, file_offset_t ullBodySize);
270 void ReadHeader(file_offset_t filePos);
271 void WriteHeader(file_offset_t filePos);
272 file_offset_t ReadSceptical(
void* pData, file_offset_t WordCount, file_offset_t WordSize);
273 inline static String convertToString(uint32_t word) {
275 for (
int i = 0; i < 4; i++) {
276 uint8_t byte = *((uint8_t*)(&word) + i);
282 virtual file_offset_t RequiredPhysicalSize(
int fileOffsetSize);
283 virtual file_offset_t WriteChunk(file_offset_t ullWritePos, file_offset_t ullCurrentDataOffset,
progress_t* pProgress = NULL);
284 virtual void __resetPos();
296 List(
File* pFile, file_offset_t StartPos,
List* Parent);
297 String GetListTypeString()
const;
299 Chunk* GetSubChunk(uint32_t ChunkID);
300 List* GetSubList(uint32_t ListType);
301 Chunk* GetFirstSubChunk();
302 Chunk* GetNextSubChunk();
303 List* GetFirstSubList();
304 List* GetNextSubList();
305 size_t CountSubChunks();
306 size_t CountSubChunks(uint32_t ChunkID);
307 size_t CountSubLists();
308 size_t CountSubLists(uint32_t ListType);
309 Chunk* AddSubChunk(uint32_t uiChunkID, file_offset_t ullBodySize);
310 List* AddSubList(uint32_t uiListType);
311 void DeleteSubChunk(
Chunk* pSubChunk);
313 void MoveSubChunk(
Chunk* pSrc,
List* pNewParent);
316 typedef std::map<uint32_t, RIFF::Chunk*> ChunkMap;
317 typedef std::list<Chunk*> ChunkList;
318 typedef std::set<Chunk*> ChunkSet;
321 ChunkList* pSubChunks;
322 ChunkMap* pSubChunksMap;
323 ChunkList::iterator ChunksIterator;
324 ChunkList::iterator ListIterator;
328 void ReadHeader(file_offset_t filePos);
329 void WriteHeader(file_offset_t filePos);
330 void LoadSubChunks(
progress_t* pProgress = NULL);
331 void LoadSubChunksRecursively(
progress_t* pProgress = NULL);
332 virtual file_offset_t RequiredPhysicalSize(
int fileOffsetSize);
333 virtual file_offset_t WriteChunk(file_offset_t ullWritePos, file_offset_t ullCurrentDataOffset,
progress_t* pProgress = NULL);
334 virtual void __resetPos();
335 void DeleteChunkList();
346 File(uint32_t FileType);
347 File(
const String& path);
352 String GetFileName()
const;
353 void SetFileName(
const String& path);
356 file_offset_t GetCurrentFileSize()
const;
357 file_offset_t GetRequiredFileSize();
358 file_offset_t GetRequiredFileSize(
offset_size_t fileOffsetSize);
359 int GetFileOffsetSize()
const;
360 int GetRequiredFileOffsetSize();
362 virtual void Save(
progress_t* pProgress = NULL);
363 virtual void Save(
const String& path,
progress_t* pProgress = NULL);
388 void __openExistingFile(
const String& path, uint32_t* FileType = NULL);
389 void ResizeFile(file_offset_t ullNewSize);
391 file_offset_t __GetFileSize(
int hFile)
const;
393 file_offset_t __GetFileSize(HANDLE hFile)
const;
395 file_offset_t __GetFileSize(FILE* hFile)
const;
397 int FileOffsetSizeFor(file_offset_t fileSize)
const;
415 static String assemble(String format, va_list arg);
int FileOffsetSize
Size of file offsets (in bytes) when this file was opened (or saved the last time).
stream_whence_t
File stream position dependent to these relations.
String libraryName()
Returns the name of this C++ library.
file_offset_t GetSize() const
Chunk size in bytes (without header, thus the chunk data body)
layout_t Layout
An ordinary RIFF file is always set to layout_standard.
void(* callback)(progress_t *)
Callback function pointer which has to be assigned to a function for progress notification.
stream_state_t
Current state of the file stream.
String libraryVersion()
Returns version of this C++ library.
Use 32 bit offsets for files smaller than 4 GB, use 64 bit offsets for files equal or larger than 4 G...
int hFileWrite
handle / descriptor for writing to (some) file
stream_mode_t
Whether file stream is open in read or in read/write mode.
List * GetParent() const
Returns pointer to the chunk's parent list chunk.
offset_size_t
Size of RIFF file offsets used in all RIFF chunks' headers.
uint64_t file_offset_t
Type used by libgig for handling file positioning during file I/O tasks.
float __range_min
Only for internal usage, do not modify!
layout_t
General RIFF chunk structure of a RIFF file.
uint32_t GetChunkID() const
Chunk ID in unsigned integer representation.
void * custom
This pointer can be used for arbitrary data.
Used for indicating the progress of a certain task.
int hFileRead
handle / descriptor for reading from file
uint32_t GetListType() const
Returns unsigned integer representation of the list's ID.
Not a "real" RIFF file: First chunk in file is an ordinary data chunk, not a List chunk...
endian_t
Alignment of data bytes in memory (system dependant).
Standard RIFF file layout: First chunk in file is a List chunk which contains all other chunks and th...
RIFF specific classes and definitions.
float factor
Reflects current progress as value between 0.0 and 1.0.
file_offset_t GetNewSize() const
New chunk size if it was modified with Resize(), otherwise value returned will be equal to GetSize()...
Always use 32 bit offsets (even for files larger than 4 GB).
File * GetFile() const
Returns pointer to the chunk's File object.
float __range_max
Only for internal usage, do not modify!
Will be thrown whenever an error occurs while handling a RIFF file.
file_offset_t GetFilePos() const
Current, actual offset of chunk data body start in file.
Always use 64 bit offsets (even for files smaller than 4 GB).
file_offset_t GetPos() const
Position within the chunk data body (starting with 0).