/[svn]/libgig/trunk/src/RIFF.cpp

Diff of /libgig/trunk/src/RIFF.cpp

Parent Directory | Revision Log | View Patch Patch

-revision 798 by schoenebeck,
Thu Nov  3 23:49:11 2005 UTC
+revision 3912 by schoenebeck,
Fri Jun  4 11:20:19 2021 UTC
 Line 1
  /***************************************************************************
   *                                                                         *
-  *   libgig - C++ cross-platform Gigasampler format file loader library    *
+  *   libgig - C++ cross-platform Gigasampler format file access library    *
   *                                                                         *
-  *   Copyright (C) 2003-2005 by Christian Schoenebeck                      *
+  *   Copyright (C) 2003-2021 by Christian Schoenebeck                      *
   *                              <cuse@users.sourceforge.net>               *
   *                                                                         *
   *   This library is free software; you can redistribute it and/or modify  *
 Line 21
   *   MA  02111-1307  USA                                                   *
   ***************************************************************************/
+ #include <algorithm>
+ #include <set>
  #include <string.h>
- #include <sstream>
  #include "RIFF.h"
+ #include "helper.h"
+ #if POSIX
+ # include <errno.h>
+ #endif
  namespace RIFF {
- // *************** Helper Functions **************
+ // *************** Internal functions **************
  // *
-     template<class T> inline String ToString(T o) {
+     /// Returns a human readable path of the given chunk.
-         std::stringstream ss;
+     static String __resolveChunkPath(Chunk* pCk) {
-         ss << o;
+         String sPath;
-         return ss.str();
+         for (Chunk* pChunk = pCk; pChunk; pChunk = pChunk->GetParent()) {
+             if (pChunk->GetChunkID() == CHUNK_ID_LIST) {
+                 List* pList = (List*) pChunk;
+                 sPath = "->'" + pList->GetListTypeString() + "'" + sPath;
+             } else {
+                 sPath = "->'" + pChunk->GetChunkIDString() + "'" + sPath;
+             }
+         }
+         return sPath;
+     }
+ // *************** progress_t ***************
+ // *
+     progress_t::progress_t() {
+         callback    = NULL;
+         custom      = NULL;
+         __range_min = 0.0f;
+         __range_max = 1.0f;
+     }
+     /**
+      * Divides this progress task into the requested amount of equal weighted
+      * sub-progress tasks and returns a vector with those subprogress tasks.
+      *
+      * @param iSubtasks - total amount sub tasks this task should be subdivided
+      * @returns subtasks
+      */
+     std::vector<progress_t> progress_t::subdivide(int iSubtasks) {
+         std::vector<progress_t> v;
+         for (int i = 0; i < iSubtasks; ++i) {
+             progress_t p;
+             __divide_progress(this, &p, iSubtasks, i);
+             v.push_back(p);
+         }
+         return v;
+     }
+     /**
+      * Divides this progress task into the requested amount of sub-progress
+      * tasks, where each one of those new sub-progress tasks is created with its
+      * requested individual weight / portion, and finally returns a vector
+      * with those new subprogress tasks.
+      *
+      * The amount of subprogresses to be created is determined by this method
+      * by calling @c vSubTaskPortions.size() .
+      *
+      * Example: consider you wanted to create 3 subprogresses where the 1st
+      * subtask should be assigned 10% of the new 3 subprogresses' overall
+      * progress, the 2nd subtask should be assigned 50% of the new 3
+      * subprogresses' overall progress, and the 3rd subtask should be assigned
+      * 40%, then you might call this method like this:
+      * @code
+      * std::vector<progress_t> subprogresses = progress.subdivide({0.1, 0.5, 0.4});
+      * @endcode
+      *
+      * @param vSubTaskPortions - amount and individual weight of subtasks to be
+      *                           created
+      * @returns subtasks
+      */
+     std::vector<progress_t> progress_t::subdivide(std::vector<float> vSubTaskPortions) {
+         float fTotal = 0.f; // usually 1.0, but we sum the portions up below to be sure
+         for (int i = 0; i < vSubTaskPortions.size(); ++i)
+             fTotal += vSubTaskPortions[i];
+         float fLow = 0.f, fHigh = 0.f;
+         std::vector<progress_t> v;
+         for (int i = 0; i < vSubTaskPortions.size(); ++i) {
+             fLow  = fHigh;
+             fHigh = vSubTaskPortions[i];
+             progress_t p;
+             __divide_progress(this, &p, fTotal, fLow, fHigh);
+             v.push_back(p);
+         }
+         return v;
      }
-Line 43 
 namespace RIFF {
+Line 126 
 namespace RIFF {
  // *
      Chunk::Chunk(File* pFile) {
-         #if DEBUG
+         #if DEBUG_RIFF
          std::cout << "Chunk::Chunk(File* pFile)" << std::endl;
-         #endif // DEBUG
+         #endif // DEBUG_RIFF
-         ulPos      = 0;
+         ullPos     = 0;
          pParent    = NULL;
          pChunkData = NULL;
+         ullCurrentChunkSize = 0;
+         ullNewChunkSize = 0;
+         ullChunkDataSize = 0;
          ChunkID    = CHUNK_ID_RIFF;
          this->pFile = pFile;
      }
-     Chunk::Chunk(File* pFile, unsigned long StartPos, List* Parent) {
+     Chunk::Chunk(File* pFile, file_offset_t StartPos, List* Parent) {
-         #if DEBUG
+         #if DEBUG_RIFF
-         std::cout << "Chunk::Chunk(File*,ulong,bool,List*),StartPos=" << StartPos << std::endl;
+         std::cout << "Chunk::Chunk(File*,file_offset_t,List*),StartPos=" << StartPos << std::endl;
-         #endif // DEBUG
+         #endif // DEBUG_RIFF
          this->pFile   = pFile;
-         ulStartPos    = StartPos + CHUNK_HEADER_SIZE;
+         ullStartPos   = StartPos + CHUNK_HEADER_SIZE(pFile->FileOffsetSize);
          pParent       = Parent;
-         ulPos         = 0;
+         ullPos        = 0;
          pChunkData    = NULL;
+         ullCurrentChunkSize = 0;
+         ullNewChunkSize = 0;
+         ullChunkDataSize = 0;
          ReadHeader(StartPos);
      }
-     Chunk::Chunk(File* pFile, List* pParent, uint32_t uiChunkID, uint uiBodySize) {
+     Chunk::Chunk(File* pFile, List* pParent, uint32_t uiChunkID, file_offset_t ullBodySize) {
          this->pFile      = pFile;
-         ulStartPos       = 0; // arbitrary usually, since it will be updated when we write the chunk
+         ullStartPos      = 0; // arbitrary usually, since it will be updated when we write the chunk
          this->pParent    = pParent;
-         ulPos            = 0;
+         ullPos           = 0;
          pChunkData       = NULL;
          ChunkID          = uiChunkID;
-         CurrentChunkSize = 0;
+         ullChunkDataSize = 0;
-         NewChunkSize     = uiBodySize;
+         ullCurrentChunkSize = 0;
+         ullNewChunkSize  = ullBodySize;
      }
      Chunk::~Chunk() {
          if (pChunkData) delete[] pChunkData;
      }
-     void Chunk::ReadHeader(unsigned long fPos) {
+     void Chunk::ReadHeader(file_offset_t filePos) {
-         #if DEBUG
+         #if DEBUG_RIFF
-         std::cout << "Chunk::Readheader(" << fPos << ") ";
+         std::cout << "Chunk::Readheader(" << filePos << ") ";
-         #endif // DEBUG
+         #endif // DEBUG_RIFF
+         ChunkID = 0;
+         ullNewChunkSize = ullCurrentChunkSize = 0;
          #if POSIX
-         if (lseek(pFile->hFileRead, fPos, SEEK_SET) != -1) {
+         if (lseek(pFile->hFileRead, filePos, SEEK_SET) != -1) {
              read(pFile->hFileRead, &ChunkID, 4);
-             read(pFile->hFileRead, &CurrentChunkSize, 4);
+             read(pFile->hFileRead, &ullCurrentChunkSize, pFile->FileOffsetSize);
+         #elif defined(WIN32)
+         LARGE_INTEGER liFilePos;
+         liFilePos.QuadPart = filePos;
+         if (SetFilePointerEx(pFile->hFileRead, liFilePos, NULL/*new pos pointer*/, FILE_BEGIN)) {
+             DWORD dwBytesRead;
+             ReadFile(pFile->hFileRead, &ChunkID, 4, &dwBytesRead, NULL);
+             ReadFile(pFile->hFileRead, &ullCurrentChunkSize, pFile->FileOffsetSize, &dwBytesRead, NULL);
          #else
-         if (!fseek(pFile->hFileRead, fPos, SEEK_SET)) {
+         if (!fseeko(pFile->hFileRead, filePos, SEEK_SET)) {
              fread(&ChunkID, 4, 1, pFile->hFileRead);
-             fread(&CurrentChunkSize, 4, 1, pFile->hFileRead);
+             fread(&ullCurrentChunkSize, pFile->FileOffsetSize, 1, pFile->hFileRead);
          #endif // POSIX
              #if WORDS_BIGENDIAN
              if (ChunkID == CHUNK_ID_RIFF) {
-                 bEndianNative = false;
+                 pFile->bEndianNative = false;
              }
              #else // little endian
              if (ChunkID == CHUNK_ID_RIFX) {
-Line 105 
 namespace RIFF {
+Line 204 
 namespace RIFF {
              #endif // WORDS_BIGENDIAN
              if (!pFile->bEndianNative) {
                  //swapBytes_32(&ChunkID);
-                 swapBytes_32(&CurrentChunkSize);
+                 if (pFile->FileOffsetSize == 4)
+                     swapBytes_32(&ullCurrentChunkSize);
+                 else
+                     swapBytes_64(&ullCurrentChunkSize);
              }
-             #if DEBUG
+             #if DEBUG_RIFF
              std::cout << "ckID=" << convertToString(ChunkID) << " ";
-             std::cout << "ckSize=" << ChunkSize << " ";
+             std::cout << "ckSize=" << ullCurrentChunkSize << " ";
-             std::cout << "bEndianNative=" << bEndianNative << std::endl;
+             std::cout << "bEndianNative=" << pFile->bEndianNative << std::endl;
-             #endif // DEBUG
+             #endif // DEBUG_RIFF
-             NewChunkSize = CurrentChunkSize;
+             ullNewChunkSize = ullCurrentChunkSize;
          }
      }
-     void Chunk::WriteHeader(unsigned long fPos) {
+     void Chunk::WriteHeader(file_offset_t filePos) {
          uint32_t uiNewChunkID = ChunkID;
          if (ChunkID == CHUNK_ID_RIFF) {
              #if WORDS_BIGENDIAN
-Line 126 
 namespace RIFF {
+Line 228 
 namespace RIFF {
              #endif // WORDS_BIGENDIAN
          }
-         uint32_t uiNewChunkSize = NewChunkSize;
+         uint64_t ullNewChunkSize = this->ullNewChunkSize;
          if (!pFile->bEndianNative) {
-             swapBytes_32(&uiNewChunkSize);
+             if (pFile->FileOffsetSize == 4)
+                 swapBytes_32(&ullNewChunkSize);
+             else
+                 swapBytes_64(&ullNewChunkSize);
          }
          #if POSIX
-         if (lseek(pFile->hFileWrite, fPos, SEEK_SET) != -1) {
+         if (lseek(pFile->hFileWrite, filePos, SEEK_SET) != -1) {
              write(pFile->hFileWrite, &uiNewChunkID, 4);
-             write(pFile->hFileWrite, &uiNewChunkSize, 4);
+             write(pFile->hFileWrite, &ullNewChunkSize, pFile->FileOffsetSize);
+         }
+         #elif defined(WIN32)
+         LARGE_INTEGER liFilePos;
+         liFilePos.QuadPart = filePos;
+         if (SetFilePointerEx(pFile->hFileWrite, liFilePos, NULL/*new pos pointer*/, FILE_BEGIN)) {
+             DWORD dwBytesWritten;
+             WriteFile(pFile->hFileWrite, &uiNewChunkID, 4, &dwBytesWritten, NULL);
+             WriteFile(pFile->hFileWrite, &ullNewChunkSize, pFile->FileOffsetSize, &dwBytesWritten, NULL);
          }
          #else
-         if (!fseek(pFile->hFileWrite, fPos, SEEK_SET)) {
+         if (!fseeko(pFile->hFileWrite, filePos, SEEK_SET)) {
              fwrite(&uiNewChunkID, 4, 1, pFile->hFileWrite);
-             fwrite(&uiNewChunkSize, 4, 1, pFile->hFileWrite);
+             fwrite(&ullNewChunkSize, pFile->FileOffsetSize, 1, pFile->hFileWrite);
          }
          #endif // POSIX
      }
-Line 148 
 namespace RIFF {
+Line 261 
 namespace RIFF {
       *  Returns the String representation of the chunk's ID (e.g. "RIFF",
       *  "LIST").
       */
-     String Chunk::GetChunkIDString() {
+     String Chunk::GetChunkIDString() const {
          return convertToString(ChunkID);
      }
-Line 164 
 namespace RIFF {
+Line 277 
 namespace RIFF {
       *                  if omitted \a Where relates to beginning of the chunk
       *                  data
       */
-     unsigned long Chunk::SetPos(unsigned long Where, stream_whence_t Whence) {
+     file_offset_t Chunk::SetPos(file_offset_t Where, stream_whence_t Whence) {
-      #if DEBUG
+         #if DEBUG_RIFF
-      std::cout << "Chunk::SetPos(ulong)" << std::endl;
+         std::cout << "Chunk::SetPos(file_offset_t,stream_whence_t)" << std::endl;
-      #endif // DEBUG
+         #endif // DEBUG_RIFF
          switch (Whence) {
              case stream_curpos:
-                 ulPos += Where;
+                 ullPos += Where;
                  break;
              case stream_end:
-                 ulPos = CurrentChunkSize - 1 - Where;
+                 ullPos = ullCurrentChunkSize - 1 - Where;
                  break;
              case stream_backward:
-                 ulPos -= Where;
+                 ullPos -= Where;
                  break;
              case stream_start: default:
-                 ulPos = Where;
+                 ullPos = Where;
                  break;
          }
-         if (ulPos > CurrentChunkSize) ulPos = CurrentChunkSize;
+         if (ullPos > ullCurrentChunkSize) ullPos = ullCurrentChunkSize;
-         return ulPos;
+         return ullPos;
      }
      /**
-Line 196 
 namespace RIFF {
+Line 309 
 namespace RIFF {
       *
       *  @returns  number of bytes left to read
       */
-     unsigned long Chunk::RemainingBytes() {
+     file_offset_t Chunk::RemainingBytes() const {
-        #if DEBUG
+         #if DEBUG_RIFF
-        std::cout << "Chunk::Remainingbytes()=" << CurrentChunkSize - ulPos << std::endl;
+         std::cout << "Chunk::Remainingbytes()=" << ullCurrentChunkSize - ullPos << std::endl;
-        #endif // DEBUG
+         #endif // DEBUG_RIFF
-         return CurrentChunkSize - ulPos;
+         return (ullCurrentChunkSize > ullPos) ? ullCurrentChunkSize - ullPos : 0;
+     }
+     /**
+      *  Returns the actual total size in bytes (including header) of this Chunk
+      *  if being stored to a file.
+      *
+      *  @param fileOffsetSize - RIFF file offset size (in bytes) assumed when
+      *                          being saved to a file
+      */
+     file_offset_t Chunk::RequiredPhysicalSize(int fileOffsetSize) {
+         return CHUNK_HEADER_SIZE(fileOffsetSize) + // RIFF chunk header
+                ullNewChunkSize + // chunks's actual data body
+                ullNewChunkSize % 2; // optional pad byte
      }
      /**
-Line 211 
 namespace RIFF {
+Line 337 
 namespace RIFF {
       *  - RIFF::stream_closed :
       *    the data stream was closed somehow, no more reading possible
       *  - RIFF::stream_end_reached :
-      *    alreaady reached the end of the chunk data, no more reading
+      *    already reached the end of the chunk data, no more reading
       *    possible without SetPos()
       */
-     stream_state_t Chunk::GetState() {
+     stream_state_t Chunk::GetState() const {
-       #if DEBUG
+         #if DEBUG_RIFF
-       std::cout << "Chunk::GetState()" << std::endl;
+         std::cout << "Chunk::GetState()" << std::endl;
-       #endif // DEBUG
+         #endif // DEBUG_RIFF
          #if POSIX
-         if (pFile->hFileRead == 0)    return stream_closed;
+         if (pFile->hFileRead == 0) return stream_closed;
+         #elif defined (WIN32)
+         if (pFile->hFileRead == INVALID_HANDLE_VALUE)
+             return stream_closed;
          #else
          if (pFile->hFileRead == NULL) return stream_closed;
          #endif // POSIX
-         if (ulPos < CurrentChunkSize) return stream_ready;
+         if (ullPos < ullCurrentChunkSize) return stream_ready;
-         else                          return stream_end_reached;
+         else                              return stream_end_reached;
      }
      /**
-Line 240 
 namespace RIFF {
+Line 369 
 namespace RIFF {
       *  @param WordCount  number of data words to read
       *  @param WordSize   size of each data word to read
       *  @returns          number of successfully read data words or 0 if end
-      *                    of file reached or error occured
+      *                    of file reached or error occurred
       */
-     unsigned long Chunk::Read(void* pData, unsigned long WordCount, unsigned long WordSize) {
+     file_offset_t Chunk::Read(void* pData, file_offset_t WordCount, file_offset_t WordSize) {
-        #if DEBUG
+         #if DEBUG_RIFF
-        std::cout << "Chunk::Read(void*,ulong,ulong)" << std::endl;
+         std::cout << "Chunk::Read(void*,file_offset_t,file_offset_t)" << std::endl;
-        #endif // DEBUG
+         #endif // DEBUG_RIFF
-         if (ulPos >= CurrentChunkSize) return 0;
+         //if (ulStartPos == 0) return 0; // is only 0 if this is a new chunk, so nothing to read (yet)
-         if (ulPos + WordCount * WordSize >= CurrentChunkSize) WordCount = (CurrentChunkSize - ulPos) / WordSize;
+         if (ullPos >= ullCurrentChunkSize) return 0;
+         if (ullPos + WordCount * WordSize >= ullCurrentChunkSize) WordCount = (ullCurrentChunkSize - ullPos) / WordSize;
          #if POSIX
-         if (lseek(pFile->hFileRead, ulStartPos + ulPos, SEEK_SET) < 0) return 0;
+         if (lseek(pFile->hFileRead, ullStartPos + ullPos, SEEK_SET) < 0) return 0;
-         unsigned long readWords = read(pFile->hFileRead, pData, WordCount * WordSize);
+         ssize_t readWords = read(pFile->hFileRead, pData, WordCount * WordSize);
+         if (readWords < 1) {
+             #if DEBUG_RIFF
+             std::cerr << "POSIX read() failed: " << strerror(errno) << std::endl << std::flush;
+             #endif // DEBUG_RIFF
+             return 0;
+         }
+         readWords /= WordSize;
+         #elif defined(WIN32)
+         LARGE_INTEGER liFilePos;
+         liFilePos.QuadPart = ullStartPos + ullPos;
+         if (!SetFilePointerEx(pFile->hFileRead, liFilePos, NULL/*new pos pointer*/, FILE_BEGIN))
+             return 0;
+         DWORD readWords;
+         ReadFile(pFile->hFileRead, pData, WordCount * WordSize, &readWords, NULL); //FIXME: does not work for reading buffers larger than 2GB (even though this should rarely be the case in practice)
          if (readWords < 1) return 0;
          readWords /= WordSize;
          #else // standard C functions
-         if (fseek(pFile->hFileRead, ulStartPos + ulPos, SEEK_SET)) return 0;
+         if (fseeko(pFile->hFileRead, ullStartPos + ullPos, SEEK_SET)) return 0;
-         unsigned long readWords = fread(pData, WordSize, WordCount, pFile->hFileRead);
+         file_offset_t readWords = fread(pData, WordSize, WordCount, pFile->hFileRead);
          #endif // POSIX
          if (!pFile->bEndianNative && WordSize != 1) {
              switch (WordSize) {
                  case 2:
-                     for (unsigned long iWord = 0; iWord < readWords; iWord++)
+                     for (file_offset_t iWord = 0; iWord < readWords; iWord++)
                          swapBytes_16((uint16_t*) pData + iWord);
                      break;
                  case 4:
-                     for (unsigned long iWord = 0; iWord < readWords; iWord++)
+                     for (file_offset_t iWord = 0; iWord < readWords; iWord++)
                          swapBytes_32((uint32_t*) pData + iWord);
                      break;
+                 case 8:
+                     for (file_offset_t iWord = 0; iWord < readWords; iWord++)
+                         swapBytes_64((uint64_t*) pData + iWord);
+                     break;
                  default:
-                     for (unsigned long iWord = 0; iWord < readWords; iWord++)
+                     for (file_offset_t iWord = 0; iWord < readWords; iWord++)
                          swapBytes((uint8_t*) pData + iWord * WordSize, WordSize);
                      break;
              }
-Line 290 
 namespace RIFF {
+Line 438 
 namespace RIFF {
       *  @param WordSize   size of each data word to write
       *  @returns          number of successfully written data words
       *  @throws RIFF::Exception  if write operation would exceed current
-      *                           chunk size or any IO error occured
+      *                           chunk size or any IO error occurred
       *  @see Resize()
       */
-     unsigned long Chunk::Write(void* pData, unsigned long WordCount, unsigned long WordSize) {
+     file_offset_t Chunk::Write(void* pData, file_offset_t WordCount, file_offset_t WordSize) {
          if (pFile->Mode != stream_mode_read_write)
              throw Exception("Cannot write data to chunk, file has to be opened in read+write mode first");
-         if (ulPos >= CurrentChunkSize || ulPos + WordCount * WordSize > CurrentChunkSize)
+         if (ullPos >= ullCurrentChunkSize || ullPos + WordCount * WordSize > ullCurrentChunkSize)
              throw Exception("End of chunk reached while trying to write data");
          if (!pFile->bEndianNative && WordSize != 1) {
              switch (WordSize) {
                  case 2:
-                     for (unsigned long iWord = 0; iWord < WordCount; iWord++)
+                     for (file_offset_t iWord = 0; iWord < WordCount; iWord++)
                          swapBytes_16((uint16_t*) pData + iWord);
                      break;
                  case 4:
-                     for (unsigned long iWord = 0; iWord < WordCount; iWord++)
+                     for (file_offset_t iWord = 0; iWord < WordCount; iWord++)
                          swapBytes_32((uint32_t*) pData + iWord);
                      break;
+                 case 8:
+                     for (file_offset_t iWord = 0; iWord < WordCount; iWord++)
+                         swapBytes_64((uint64_t*) pData + iWord);
+                     break;
                  default:
-                     for (unsigned long iWord = 0; iWord < WordCount; iWord++)
+                     for (file_offset_t iWord = 0; iWord < WordCount; iWord++)
                          swapBytes((uint8_t*) pData + iWord * WordSize, WordSize);
                      break;
              }
          }
          #if POSIX
-         if (lseek(pFile->hFileWrite, ulStartPos + ulPos, SEEK_SET) < 0) {
+         if (lseek(pFile->hFileWrite, ullStartPos + ullPos, SEEK_SET) < 0) {
-             throw Exception("Could not seek to position " + ToString(ulPos) +
+             throw Exception("Could not seek to position " + ToString(ullPos) +
-                             " in chunk (" + ToString(ulStartPos + ulPos) + " in file)");
+                             " in chunk (" + ToString(ullStartPos + ullPos) + " in file)");
          }
-         unsigned long writtenWords = write(pFile->hFileWrite, pData, WordCount * WordSize);
+         ssize_t writtenWords = write(pFile->hFileWrite, pData, WordCount * WordSize);
          if (writtenWords < 1) throw Exception("POSIX IO Error while trying to write chunk data");
          writtenWords /= WordSize;
+         #elif defined(WIN32)
+         LARGE_INTEGER liFilePos;
+         liFilePos.QuadPart = ullStartPos + ullPos;
+         if (!SetFilePointerEx(pFile->hFileWrite, liFilePos, NULL/*new pos pointer*/, FILE_BEGIN)) {
+             throw Exception("Could not seek to position " + ToString(ullPos) +
+                             " in chunk (" + ToString(ullStartPos + ullPos) + " in file)");
+         }
+         DWORD writtenWords;
+         WriteFile(pFile->hFileWrite, pData, WordCount * WordSize, &writtenWords, NULL); //FIXME: does not work for writing buffers larger than 2GB (even though this should rarely be the case in practice)
+         if (writtenWords < 1) throw Exception("Windows IO Error while trying to write chunk data");
+         writtenWords /= WordSize;
          #else // standard C functions
-         if (fseek(pFile->hFileWrite, ulStartPos + ulPos, SEEK_SET)) {
+         if (fseeko(pFile->hFileWrite, ullStartPos + ullPos, SEEK_SET)) {
-             throw Exception("Could not seek to position " + ToString(ulPos) +
+             throw Exception("Could not seek to position " + ToString(ullPos) +
-                             " in chunk (" + ToString(ulStartPos + ulPos) + " in file)");
+                             " in chunk (" + ToString(ullStartPos + ullPos) + " in file)");
          }
-         unsigned long writtenWords = fwrite(pData, WordSize, WordCount, pFile->hFileWrite);
+         file_offset_t writtenWords = fwrite(pData, WordSize, WordCount, pFile->hFileWrite);
          #endif // POSIX
          SetPos(writtenWords * WordSize, stream_curpos);
          return writtenWords;
      }
      /** Just an internal wrapper for the main <i>Read()</i> method with additional Exception throwing on errors. */
-     unsigned long Chunk::ReadSceptical(void* pData, unsigned long WordCount, unsigned long WordSize) {
+     file_offset_t Chunk::ReadSceptical(void* pData, file_offset_t WordCount, file_offset_t WordSize) {
-         unsigned long readWords = Read(pData, WordCount, WordSize);
+         file_offset_t readWords = Read(pData, WordCount, WordSize);
          if (readWords != WordCount) throw RIFF::Exception("End of chunk data reached.");
          return readWords;
      }
-Line 348 
 namespace RIFF {
+Line 511 
 namespace RIFF {
       * @param pData             destination buffer
       * @param WordCount         number of 8 Bit signed integers to read
       * @returns                 number of read integers
-      * @throws RIFF::Exception  if an error occured or less than
+      * @throws RIFF::Exception  if an error occurred or less than
       *                          \a WordCount integers could be read!
       */
-     unsigned long Chunk::ReadInt8(int8_t* pData, unsigned long WordCount) {
+     file_offset_t Chunk::ReadInt8(int8_t* pData, file_offset_t WordCount) {
-        #if DEBUG
+         #if DEBUG_RIFF
-        std::cout << "Chunk::ReadInt8(int8_t*,ulong)" << std::endl;
+         std::cout << "Chunk::ReadInt8(int8_t*,file_offset_t)" << std::endl;
-        #endif // DEBUG
+         #endif // DEBUG_RIFF
          return ReadSceptical(pData, WordCount, 1);
      }
-Line 369 
 namespace RIFF {
+Line 532 
 namespace RIFF {
       * @param pData             source buffer (containing the data)
       * @param WordCount         number of 8 Bit signed integers to write
       * @returns                 number of written integers
-      * @throws RIFF::Exception  if an IO error occured
+      * @throws RIFF::Exception  if an IO error occurred
       * @see Resize()
       */
-     unsigned long Chunk::WriteInt8(int8_t* pData, unsigned long WordCount) {
+     file_offset_t Chunk::WriteInt8(int8_t* pData, file_offset_t WordCount) {
          return Write(pData, WordCount, 1);
      }
-Line 385 
 namespace RIFF {
+Line 548 
 namespace RIFF {
       * @param pData             destination buffer
       * @param WordCount         number of 8 Bit unsigned integers to read
       * @returns                 number of read integers
-      * @throws RIFF::Exception  if an error occured or less than
+      * @throws RIFF::Exception  if an error occurred or less than
       *                          \a WordCount integers could be read!
       */
-     unsigned long Chunk::ReadUint8(uint8_t* pData, unsigned long WordCount) {
+     file_offset_t Chunk::ReadUint8(uint8_t* pData, file_offset_t WordCount) {
-        #if DEBUG
+         #if DEBUG_RIFF
-        std::cout << "Chunk::ReadUint8(uint8_t*,ulong)" << std::endl;
+         std::cout << "Chunk::ReadUint8(uint8_t*,file_offset_t)" << std::endl;
-        #endif // DEBUG
+         #endif // DEBUG_RIFF
          return ReadSceptical(pData, WordCount, 1);
      }
-Line 406 
 namespace RIFF {
+Line 569 
 namespace RIFF {
       * @param pData             source buffer (containing the data)
       * @param WordCount         number of 8 Bit unsigned integers to write
       * @returns                 number of written integers
-      * @throws RIFF::Exception  if an IO error occured
+      * @throws RIFF::Exception  if an IO error occurred
       * @see Resize()
       */
-     unsigned long Chunk::WriteUint8(uint8_t* pData, unsigned long WordCount) {
+     file_offset_t Chunk::WriteUint8(uint8_t* pData, file_offset_t WordCount) {
          return Write(pData, WordCount, 1);
      }
-Line 422 
 namespace RIFF {
+Line 585 
 namespace RIFF {
       * @param pData             destination buffer
       * @param WordCount         number of 16 Bit signed integers to read
       * @returns                 number of read integers
-      * @throws RIFF::Exception  if an error occured or less than
+      * @throws RIFF::Exception  if an error occurred or less than
       *                          \a WordCount integers could be read!
       */
-     unsigned long Chunk::ReadInt16(int16_t* pData, unsigned long WordCount) {
+     file_offset_t Chunk::ReadInt16(int16_t* pData, file_offset_t WordCount) {
-       #if DEBUG
+         #if DEBUG_RIFF
-       std::cout << "Chunk::ReadInt16(int16_t*,ulong)" << std::endl;
+         std::cout << "Chunk::ReadInt16(int16_t*,file_offset_t)" << std::endl;
-       #endif // DEBUG
+         #endif // DEBUG_RIFF
          return ReadSceptical(pData, WordCount, 2);
      }
-Line 443 
 namespace RIFF {
+Line 606 
 namespace RIFF {
       * @param pData             source buffer (containing the data)
       * @param WordCount         number of 16 Bit signed integers to write
       * @returns                 number of written integers
-      * @throws RIFF::Exception  if an IO error occured
+      * @throws RIFF::Exception  if an IO error occurred
       * @see Resize()
       */
-     unsigned long Chunk::WriteInt16(int16_t* pData, unsigned long WordCount) {
+     file_offset_t Chunk::WriteInt16(int16_t* pData, file_offset_t WordCount) {
          return Write(pData, WordCount, 2);
      }
-Line 459 
 namespace RIFF {
+Line 622 
 namespace RIFF {
       * @param pData             destination buffer
       * @param WordCount         number of 8 Bit unsigned integers to read
       * @returns                 number of read integers
-      * @throws RIFF::Exception  if an error occured or less than
+      * @throws RIFF::Exception  if an error occurred or less than
       *                          \a WordCount integers could be read!
       */
-     unsigned long Chunk::ReadUint16(uint16_t* pData, unsigned long WordCount) {
+     file_offset_t Chunk::ReadUint16(uint16_t* pData, file_offset_t WordCount) {
-       #if DEBUG
+         #if DEBUG_RIFF
-       std::cout << "Chunk::ReadUint16(uint16_t*,ulong)" << std::endl;
+         std::cout << "Chunk::ReadUint16(uint16_t*,file_offset_t)" << std::endl;
-       #endif // DEBUG
+         #endif // DEBUG_RIFF
          return ReadSceptical(pData, WordCount, 2);
      }
-Line 480 
 namespace RIFF {
+Line 643 
 namespace RIFF {
       * @param pData             source buffer (containing the data)
       * @param WordCount         number of 16 Bit unsigned integers to write
       * @returns                 number of written integers
-      * @throws RIFF::Exception  if an IO error occured
+      * @throws RIFF::Exception  if an IO error occurred
       * @see Resize()
       */
-     unsigned long Chunk::WriteUint16(uint16_t* pData, unsigned long WordCount) {
+     file_offset_t Chunk::WriteUint16(uint16_t* pData, file_offset_t WordCount) {
          return Write(pData, WordCount, 2);
      }
-Line 496 
 namespace RIFF {
+Line 659 
 namespace RIFF {
       * @param pData             destination buffer
       * @param WordCount         number of 32 Bit signed integers to read
       * @returns                 number of read integers
-      * @throws RIFF::Exception  if an error occured or less than
+      * @throws RIFF::Exception  if an error occurred or less than
       *                          \a WordCount integers could be read!
       */
-     unsigned long Chunk::ReadInt32(int32_t* pData, unsigned long WordCount) {
+     file_offset_t Chunk::ReadInt32(int32_t* pData, file_offset_t WordCount) {
-        #if DEBUG
+         #if DEBUG_RIFF
-        std::cout << "Chunk::ReadInt32(int32_t*,ulong)" << std::endl;
+         std::cout << "Chunk::ReadInt32(int32_t*,file_offset_t)" << std::endl;
-        #endif // DEBUG
+         #endif // DEBUG_RIFF
          return ReadSceptical(pData, WordCount, 4);
      }
-Line 517 
 namespace RIFF {
+Line 680 
 namespace RIFF {
       * @param pData             source buffer (containing the data)
       * @param WordCount         number of 32 Bit signed integers to write
       * @returns                 number of written integers
-      * @throws RIFF::Exception  if an IO error occured
+      * @throws RIFF::Exception  if an IO error occurred
       * @see Resize()
       */
-     unsigned long Chunk::WriteInt32(int32_t* pData, unsigned long WordCount) {
+     file_offset_t Chunk::WriteInt32(int32_t* pData, file_offset_t WordCount) {
          return Write(pData, WordCount, 4);
      }
-Line 533 
 namespace RIFF {
+Line 696 
 namespace RIFF {
       * @param pData             destination buffer
       * @param WordCount         number of 32 Bit unsigned integers to read
       * @returns                 number of read integers
-      * @throws RIFF::Exception  if an error occured or less than
+      * @throws RIFF::Exception  if an error occurred or less than
       *                          \a WordCount integers could be read!
       */
-     unsigned long Chunk::ReadUint32(uint32_t* pData, unsigned long WordCount) {
+     file_offset_t Chunk::ReadUint32(uint32_t* pData, file_offset_t WordCount) {
-        #if DEBUG
+         #if DEBUG_RIFF
-        std::cout << "Chunk::ReadUint32(uint32_t*,ulong)" << std::endl;
+         std::cout << "Chunk::ReadUint32(uint32_t*,file_offset_t)" << std::endl;
-        #endif // DEBUG
+         #endif // DEBUG_RIFF
          return ReadSceptical(pData, WordCount, 4);
      }
      /**
+      * Reads a null-padded string of size characters and copies it
+      * into the string \a s. The position within the chunk will
+      * automatically be incremented.
+      *
+      * @param s                 destination string
+      * @param size              number of characters to read
+      * @throws RIFF::Exception  if an error occurred or less than
+      *                          \a size characters could be read!
+      */
+     void Chunk::ReadString(String& s, int size) {
+         char* buf = new char[size];
+         ReadSceptical(buf, 1, size);
+         s.assign(buf, std::find(buf, buf + size, '\0'));
+         delete[] buf;
+     }
+     /**
       * Writes \a WordCount number of 32 Bit unsigned integer words from the
       * buffer pointed by \a pData to the chunk's body, directly to the
       * actual "physical" file. The position within the chunk will
-Line 554 
 namespace RIFF {
+Line 734 
 namespace RIFF {
       * @param pData             source buffer (containing the data)
       * @param WordCount         number of 32 Bit unsigned integers to write
       * @returns                 number of written integers
-      * @throws RIFF::Exception  if an IO error occured
+      * @throws RIFF::Exception  if an IO error occurred
       * @see Resize()
       */
-     unsigned long Chunk::WriteUint32(uint32_t* pData, unsigned long WordCount) {
+     file_offset_t Chunk::WriteUint32(uint32_t* pData, file_offset_t WordCount) {
          return Write(pData, WordCount, 4);
      }
-Line 566 
 namespace RIFF {
+Line 746 
 namespace RIFF {
       * the chunk.
       *
       * @returns                 read integer word
-      * @throws RIFF::Exception  if an error occured
+      * @throws RIFF::Exception  if an error occurred
       */
      int8_t Chunk::ReadInt8() {
-       #if DEBUG
+         #if DEBUG_RIFF
-       std::cout << "Chunk::ReadInt8()" << std::endl;
+         std::cout << "Chunk::ReadInt8()" << std::endl;
-       #endif // DEBUG
+         #endif // DEBUG_RIFF
          int8_t word;
          ReadSceptical(&word,1,1);
          return word;
-Line 582 
 namespace RIFF {
+Line 762 
 namespace RIFF {
       * within the chunk.
       *
       * @returns                 read integer word
-      * @throws RIFF::Exception  if an error occured
+      * @throws RIFF::Exception  if an error occurred
       */
      uint8_t Chunk::ReadUint8() {
-       #if DEBUG
+         #if DEBUG_RIFF
-       std::cout << "Chunk::ReadUint8()" << std::endl;
+         std::cout << "Chunk::ReadUint8()" << std::endl;
-       #endif // DEBUG
+         #endif // DEBUG_RIFF
          uint8_t word;
          ReadSceptical(&word,1,1);
          return word;
-Line 599 
 namespace RIFF {
+Line 779 
 namespace RIFF {
       * needed.
       *
       * @returns                 read integer word
-      * @throws RIFF::Exception  if an error occured
+      * @throws RIFF::Exception  if an error occurred
       */
      int16_t Chunk::ReadInt16() {
-       #if DEBUG
+         #if DEBUG_RIFF
-       std::cout << "Chunk::ReadInt16()" << std::endl;
+         std::cout << "Chunk::ReadInt16()" << std::endl;
-       #endif // DEBUG
+         #endif // DEBUG_RIFF
          int16_t word;
          ReadSceptical(&word,1,2);
          return word;
-Line 616 
 namespace RIFF {
+Line 796 
 namespace RIFF {
       * needed.
       *
       * @returns                 read integer word
-      * @throws RIFF::Exception  if an error occured
+      * @throws RIFF::Exception  if an error occurred
       */
      uint16_t Chunk::ReadUint16() {
-       #if DEBUG
+         #if DEBUG_RIFF
-       std::cout << "Chunk::ReadUint16()" << std::endl;
+         std::cout << "Chunk::ReadUint16()" << std::endl;
-       #endif // DEBUG
+         #endif // DEBUG_RIFF
          uint16_t word;
          ReadSceptical(&word,1,2);
          return word;
-Line 633 
 namespace RIFF {
+Line 813 
 namespace RIFF {
       * needed.
       *
       * @returns                 read integer word
-      * @throws RIFF::Exception  if an error occured
+      * @throws RIFF::Exception  if an error occurred
       */
      int32_t Chunk::ReadInt32() {
-       #if DEBUG
+         #if DEBUG_RIFF
-       std::cout << "Chunk::ReadInt32()" << std::endl;
+         std::cout << "Chunk::ReadInt32()" << std::endl;
-       #endif // DEBUG
+         #endif // DEBUG_RIFF
          int32_t word;
          ReadSceptical(&word,1,4);
          return word;
-Line 650 
 namespace RIFF {
+Line 830 
 namespace RIFF {
       * needed.
       *
       * @returns                 read integer word
-      * @throws RIFF::Exception  if an error occured
+      * @throws RIFF::Exception  if an error occurred
       */
      uint32_t Chunk::ReadUint32() {
-       #if DEBUG
+         #if DEBUG_RIFF
-       std::cout << "Chunk::ReadUint32()" << std::endl;
+         std::cout << "Chunk::ReadUint32()" << std::endl;
-       #endif // DEBUG
+         #endif // DEBUG_RIFF
          uint32_t word;
          ReadSceptical(&word,1,4);
          return word;
-Line 668 
 namespace RIFF {
+Line 848 
 namespace RIFF {
       *
       * <b>Caution:</b> the buffer pointer will be invalidated once
       * File::Save() was called. You have to call LoadChunkData() again to
-      * get a new pointer whenever File::Save() was called.
+      * get a new, valid pointer whenever File::Save() was called.
+      *
+      * You can call LoadChunkData() again if you previously scheduled to
+      * enlarge this chunk with a Resize() call. In that case the buffer will
+      * be enlarged to the new, scheduled chunk size and you can already
+      * place the new chunk data to the buffer and finally call File::Save()
+      * to enlarge the chunk physically and write the new data in one rush.
+      * This approach is definitely recommended if you have to enlarge and
+      * write new data to a lot of chunks.
       *
       * @returns a pointer to the data in RAM on success, NULL otherwise
+      * @throws Exception if data buffer could not be enlarged
       * @see ReleaseChunkData()
       */
      void* Chunk::LoadChunkData() {
-         if (!pChunkData) {
+         if (!pChunkData && pFile->Filename != "" /*&& ulStartPos != 0*/) {
              #if POSIX
-             if (lseek(pFile->hFileRead, ulStartPos, SEEK_SET) == -1) return NULL;
+             if (lseek(pFile->hFileRead, ullStartPos, SEEK_SET) == -1) return NULL;
-             pChunkData = new uint8_t[GetSize()];
+             #elif defined(WIN32)
-             if (!pChunkData) return NULL;
+             LARGE_INTEGER liFilePos;
-             unsigned long readWords = read(pFile->hFileRead, pChunkData, GetSize());
+             liFilePos.QuadPart = ullStartPos;
+             if (!SetFilePointerEx(pFile->hFileRead, liFilePos, NULL/*new pos pointer*/, FILE_BEGIN)) return NULL;
              #else
-             if (fseek(pFile->hFileRead, ulStartPos, SEEK_SET)) return NULL;
+             if (fseeko(pFile->hFileRead, ullStartPos, SEEK_SET)) return NULL;
-             pChunkData = new uint8_t[GetSize()];
+             #endif // POSIX
+             file_offset_t ullBufferSize = (ullCurrentChunkSize > ullNewChunkSize) ? ullCurrentChunkSize : ullNewChunkSize;
+             pChunkData = new uint8_t[ullBufferSize];
              if (!pChunkData) return NULL;
-             unsigned long readWords = fread(pChunkData, 1, GetSize(), pFile->hFileRead);
+             memset(pChunkData, 0, ullBufferSize);
+             #if POSIX
+             file_offset_t readWords = read(pFile->hFileRead, pChunkData, GetSize());
+             #elif defined(WIN32)
+             DWORD readWords;
+             ReadFile(pFile->hFileRead, pChunkData, GetSize(), &readWords, NULL); //FIXME: won't load chunks larger than 2GB !
+             #else
+             file_offset_t readWords = fread(pChunkData, 1, GetSize(), pFile->hFileRead);
              #endif // POSIX
              if (readWords != GetSize()) {
                  delete[] pChunkData;
                  return (pChunkData = NULL);
              }
+             ullChunkDataSize = ullBufferSize;
+         } else if (ullNewChunkSize > ullChunkDataSize) {
+             uint8_t* pNewBuffer = new uint8_t[ullNewChunkSize];
+             if (!pNewBuffer) throw Exception("Could not enlarge chunk data buffer to " + ToString(ullNewChunkSize) + " bytes");
+             memset(pNewBuffer, 0 , ullNewChunkSize);
+             if (pChunkData) {
+                 memcpy(pNewBuffer, pChunkData, ullChunkDataSize);
+                 delete[] pChunkData;
+             }
+             pChunkData       = pNewBuffer;
+             ullChunkDataSize = ullNewChunkSize;
          }
          return pChunkData;
      }
-Line 719 
 namespace RIFF {
+Line 929 
 namespace RIFF {
       *
       * <b>Caution:</b> You cannot directly write to enlarged chunks before
       * calling File::Save() as this might exceed the current chunk's body
-      * boundary.
+      * boundary!
       *
-      * @param iNewSize - new chunk body size in bytes (must be greater than zero)
+      * @param NewSize - new chunk body size in bytes (must be greater than zero)
-      * @throws RIFF::Exception  if \a iNewSize is less than 1
+      * @throws RIFF::Exception  if \a NewSize is less than 1 or unrealistic large
       * @see File::Save()
       */
-     void Chunk::Resize(int iNewSize) {
+     void Chunk::Resize(file_offset_t NewSize) {
-         if (iNewSize <= 0) throw Exception("Chunk size must be at least one byte");
+         if (NewSize == 0)
-         NewChunkSize = iNewSize;
+             throw Exception("There is at least one empty chunk (zero size): " + __resolveChunkPath(this));
-         pFile->LogAsResized(this);
+         if ((NewSize >> 48) != 0)
+             throw Exception("Unrealistic high chunk size detected: " + __resolveChunkPath(this));
+         if (ullNewChunkSize == NewSize) return;
+         ullNewChunkSize = NewSize;
      }
      /** @brief Write chunk persistently e.g. to disk.
       *
       * Stores the chunk persistently to its actual "physical" file.
       *
-      * @param ulWritePos - position within the "physical" file where this
+      * @param ullWritePos - position within the "physical" file where this
       *                     chunk should be written to
-      * @param ulCurrentDataOffset - offset of current (old) data within
+      * @param ullCurrentDataOffset - offset of current (old) data within
       *                              the file
+      * @param pProgress - optional: callback function for progress notification
       * @returns new write position in the "physical" file, that is
-      *          \a ulWritePos incremented by this chunk's new size
+      *          \a ullWritePos incremented by this chunk's new size
       *          (including its header size of course)
       */
-     unsigned long Chunk::WriteChunk(unsigned long ulWritePos, unsigned long ulCurrentDataOffset) {
+     file_offset_t Chunk::WriteChunk(file_offset_t ullWritePos, file_offset_t ullCurrentDataOffset, progress_t* pProgress) {
-         const unsigned long ulOriginalPos = ulWritePos;
+         const file_offset_t ullOriginalPos = ullWritePos;
-         ulWritePos += CHUNK_HEADER_SIZE;
+         ullWritePos += CHUNK_HEADER_SIZE(pFile->FileOffsetSize);
          if (pFile->Mode != stream_mode_read_write)
              throw Exception("Cannot write list chunk, file has to be opened in read+write mode");
          // if the whole chunk body was loaded into RAM
          if (pChunkData) {
-             // in case the chunk size was changed, reallocate the data in RAM with the chunk's new size
+             // make sure chunk data buffer in RAM is at least as large as the new chunk size
-             if (NewChunkSize != CurrentChunkSize) {
+             LoadChunkData();
-                 uint8_t* pNewBuffer = new uint8_t[NewChunkSize];
-                 if (NewChunkSize > CurrentChunkSize) {
-                     memcpy(pNewBuffer, pChunkData, CurrentChunkSize);
-                     memset(pNewBuffer + CurrentChunkSize, 0, NewChunkSize - CurrentChunkSize);
-                 } else {
-                     memcpy(pNewBuffer, pChunkData, NewChunkSize);
-                 }
-                 delete[] pChunkData;
-                 pChunkData = pNewBuffer;
-             }
              // write chunk data from RAM persistently to the file
              #if POSIX
-             lseek(pFile->hFileWrite, ulWritePos, SEEK_SET);
+             lseek(pFile->hFileWrite, ullWritePos, SEEK_SET);
-             if (write(pFile->hFileWrite, pChunkData, NewChunkSize) != NewChunkSize) {
+             if (write(pFile->hFileWrite, pChunkData, ullNewChunkSize) != ullNewChunkSize) {
+                 throw Exception("Writing Chunk data (from RAM) failed");
+             }
+             #elif defined(WIN32)
+             LARGE_INTEGER liFilePos;
+             liFilePos.QuadPart = ullWritePos;
+             SetFilePointerEx(pFile->hFileWrite, liFilePos, NULL/*new pos pointer*/, FILE_BEGIN);
+             DWORD dwBytesWritten;
+             WriteFile(pFile->hFileWrite, pChunkData, ullNewChunkSize, &dwBytesWritten, NULL); //FIXME: won't save chunks larger than 2GB !
+             if (dwBytesWritten != ullNewChunkSize) {
                  throw Exception("Writing Chunk data (from RAM) failed");
              }
              #else
-             fseek(pFile->hFileWrite, ulWritePos, SEEK_SET);
+             fseeko(pFile->hFileWrite, ullWritePos, SEEK_SET);
-             if (fwrite(pChunkData, 1, NewChunkSize, pFile->hFileWrite) != NewChunkSize) {
+             if (fwrite(pChunkData, 1, ullNewChunkSize, pFile->hFileWrite) != ullNewChunkSize) {
                  throw Exception("Writing Chunk data (from RAM) failed");
              }
              #endif // POSIX
          } else {
              // move chunk data from the end of the file to the appropriate position
              int8_t* pCopyBuffer = new int8_t[4096];
-             unsigned long ulToMove = (NewChunkSize < CurrentChunkSize) ? NewChunkSize : CurrentChunkSize;
+             file_offset_t ullToMove = (ullNewChunkSize < ullCurrentChunkSize) ? ullNewChunkSize : ullCurrentChunkSize;
+             #if defined(WIN32)
+             DWORD iBytesMoved = 1; // we have to pass it via pointer to the Windows API, thus the correct size must be ensured
+             #else
              int iBytesMoved = 1;
-             for (unsigned long ulOffset = 0; iBytesMoved > 0; ulOffset += iBytesMoved, ulToMove -= iBytesMoved) {
+             #endif
-                 iBytesMoved = (ulToMove < 4096) ? ulToMove : 4096;
+             for (file_offset_t ullOffset = 0; ullToMove > 0 && iBytesMoved > 0; ullOffset += iBytesMoved, ullToMove -= iBytesMoved) {
+                 iBytesMoved = (ullToMove < 4096) ? int(ullToMove) : 4096;
                  #if POSIX
-                 lseek(pFile->hFileRead, ulStartPos + ulCurrentDataOffset + ulOffset, SEEK_SET);
+                 lseek(pFile->hFileRead, ullStartPos + ullCurrentDataOffset + ullOffset, SEEK_SET);
-                 iBytesMoved = read(pFile->hFileRead, pCopyBuffer, iBytesMoved);
+                 iBytesMoved = (int) read(pFile->hFileRead, pCopyBuffer, (size_t) iBytesMoved);
-                 lseek(pFile->hFileWrite, ulWritePos + ulOffset, SEEK_SET);
+                 lseek(pFile->hFileWrite, ullWritePos + ullOffset, SEEK_SET);
-                 iBytesMoved = write(pFile->hFileWrite, pCopyBuffer, iBytesMoved);
+                 iBytesMoved = (int) write(pFile->hFileWrite, pCopyBuffer, (size_t) iBytesMoved);
+                 #elif defined(WIN32)
+                 LARGE_INTEGER liFilePos;
+                 liFilePos.QuadPart = ullStartPos + ullCurrentDataOffset + ullOffset;
+                 SetFilePointerEx(pFile->hFileRead, liFilePos, NULL/*new pos pointer*/, FILE_BEGIN);
+                 ReadFile(pFile->hFileRead, pCopyBuffer, iBytesMoved, &iBytesMoved, NULL);
+                 liFilePos.QuadPart = ullWritePos + ullOffset;
+                 SetFilePointerEx(pFile->hFileWrite, liFilePos, NULL/*new pos pointer*/, FILE_BEGIN);
+                 WriteFile(pFile->hFileWrite, pCopyBuffer, iBytesMoved, &iBytesMoved, NULL);
                  #else
-                 fseek(pFile->hFileRead, ulStartPos + ulCurrentDataOffset + ulOffset, SEEK_SET);
+                 fseeko(pFile->hFileRead, ullStartPos + ullCurrentDataOffset + ullOffset, SEEK_SET);
                  iBytesMoved = fread(pCopyBuffer, 1, iBytesMoved, pFile->hFileRead);
-                 fseek(pFile->hFileWrite, ulWritePos + ulOffset, SEEK_SET);
+                 fseeko(pFile->hFileWrite, ullWritePos + ullOffset, SEEK_SET);
                  iBytesMoved = fwrite(pCopyBuffer, 1, iBytesMoved, pFile->hFileWrite);
                  #endif
              }
-Line 801 
 namespace RIFF {
+Line 1025 
 namespace RIFF {
          }
          // update this chunk's header
-         CurrentChunkSize = NewChunkSize;
+         ullCurrentChunkSize = ullNewChunkSize;
-         WriteHeader(ulOriginalPos);
+         WriteHeader(ullOriginalPos);
+         if (pProgress)
+             __notify_progress(pProgress, 1.0); // notify done
          // update chunk's position pointers
-         ulStartPos = ulOriginalPos + CHUNK_HEADER_SIZE;
+         ullStartPos = ullOriginalPos + CHUNK_HEADER_SIZE(pFile->FileOffsetSize);
-         ulPos      = 0;
+         ullPos      = 0;
          // add pad byte if needed
-         if ((ulStartPos + NewChunkSize) % 2 != 0) {
+         if ((ullStartPos + ullNewChunkSize) % 2 != 0) {
              const char cPadByte = 0;
              #if POSIX
-             lseek(pFile->hFileWrite, ulStartPos + NewChunkSize, SEEK_SET);
+             lseek(pFile->hFileWrite, ullStartPos + ullNewChunkSize, SEEK_SET);
              write(pFile->hFileWrite, &cPadByte, 1);
+             #elif defined(WIN32)
+             LARGE_INTEGER liFilePos;
+             liFilePos.QuadPart = ullStartPos + ullNewChunkSize;
+             SetFilePointerEx(pFile->hFileWrite, liFilePos, NULL/*new pos pointer*/, FILE_BEGIN);
+             DWORD dwBytesWritten;
+             WriteFile(pFile->hFileWrite, &cPadByte, 1, &dwBytesWritten, NULL);
              #else
-             fseek(pFile->hFileWrite, ulStartPos + NewChunkSize, SEEK_SET);
+             fseeko(pFile->hFileWrite, ullStartPos + ullNewChunkSize, SEEK_SET);
              fwrite(&cPadByte, 1, 1, pFile->hFileWrite);
              #endif
-             return ulStartPos + NewChunkSize + 1;
+             return ullStartPos + ullNewChunkSize + 1;
          }
-         return ulStartPos + NewChunkSize;
+         return ullStartPos + ullNewChunkSize;
      }
      void Chunk::__resetPos() {
-         ulPos = 0;
+         ullPos = 0;
      }
-Line 834 
 namespace RIFF {
+Line 1067 
 namespace RIFF {
  // *
      List::List(File* pFile) : Chunk(pFile) {
-       #if DEBUG
+         #if DEBUG_RIFF
-       std::cout << "List::List(File* pFile)" << std::endl;
+         std::cout << "List::List(File* pFile)" << std::endl;
-       #endif // DEBUG
+         #endif // DEBUG_RIFF
          pSubChunks    = NULL;
          pSubChunksMap = NULL;
      }
-     List::List(File* pFile, unsigned long StartPos, List* Parent)
+     List::List(File* pFile, file_offset_t StartPos, List* Parent)
        : Chunk(pFile, StartPos, Parent) {
-         #if DEBUG
+         #if DEBUG_RIFF
-         std::cout << "List::List(File*,ulong,bool,List*)" << std::endl;
+         std::cout << "List::List(File*,file_offset_t,List*)" << std::endl;
-         #endif // DEBUG
+         #endif // DEBUG_RIFF
          pSubChunks    = NULL;
          pSubChunksMap = NULL;
          ReadHeader(StartPos);
-         ulStartPos    = StartPos + LIST_HEADER_SIZE;
+         ullStartPos = StartPos + LIST_HEADER_SIZE(pFile->FileOffsetSize);
      }
      List::List(File* pFile, List* pParent, uint32_t uiListID)
-Line 860 
 namespace RIFF {
+Line 1093 
 namespace RIFF {
      }
      List::~List() {
-       #if DEBUG
+         #if DEBUG_RIFF
-       std::cout << "List::~List()" << std::endl;
+         std::cout << "List::~List()" << std::endl;
-       #endif // DEBUG
+         #endif // DEBUG_RIFF
+         DeleteChunkList();
+     }
+     void List::DeleteChunkList() {
          if (pSubChunks) {
              ChunkList::iterator iter = pSubChunks->begin();
              ChunkList::iterator end  = pSubChunks->end();
-Line 871 
 namespace RIFF {
+Line 1108 
 namespace RIFF {
                  iter++;
              }
              delete pSubChunks;
+             pSubChunks = NULL;
+         }
+         if (pSubChunksMap) {
+             delete pSubChunksMap;
+             pSubChunksMap = NULL;
          }
-         if (pSubChunksMap) delete pSubChunksMap;
      }
      /**
-Line 887 
 namespace RIFF {
+Line 1128 
 namespace RIFF {
       *                   that ID
       */
      Chunk* List::GetSubChunk(uint32_t ChunkID) {
-       #if DEBUG
+         #if DEBUG_RIFF
-       std::cout << "List::GetSubChunk(uint32_t)" << std::endl;
+         std::cout << "List::GetSubChunk(uint32_t)" << std::endl;
-       #endif // DEBUG
+         #endif // DEBUG_RIFF
          if (!pSubChunksMap) LoadSubChunks();
          return (*pSubChunksMap)[ChunkID];
      }
-Line 897 
 namespace RIFF {
+Line 1138 
 namespace RIFF {
      /**
       *  Returns sublist chunk with list type <i>\a ListType</i> within this
       *  chunk list. Use this method if you expect only one sublist chunk of
-      *  that type in the list. It there are more than one, it's undetermined
+      *  that type in the list. If there are more than one, it's undetermined
       *  which one of them will be returned! If there are no sublists with
       *  that desired list type, NULL will be returned.
       *
-Line 906 
 namespace RIFF {
+Line 1147 
 namespace RIFF {
       *                    that type
       */
      List* List::GetSubList(uint32_t ListType) {
-         #if DEBUG
+         #if DEBUG_RIFF
          std::cout << "List::GetSubList(uint32_t)" << std::endl;
-         #endif // DEBUG
+         #endif // DEBUG_RIFF
          if (!pSubChunks) LoadSubChunks();
          ChunkList::iterator iter = pSubChunks->begin();
          ChunkList::iterator end  = pSubChunks->end();
-Line 923 
 namespace RIFF {
+Line 1164 
 namespace RIFF {
      }
      /**
-      *  Returns the first subchunk within the list. You have to call this
+      *  Returns the first subchunk within the list (which may be an ordinary
+      *  chunk as well as a list chunk). You have to call this
       *  method before you can call GetNextSubChunk(). Recall it when you want
       *  to start from the beginning of the list again.
       *
-Line 931 
 namespace RIFF {
+Line 1173 
 namespace RIFF {
       *            otherwise
       */
      Chunk* List::GetFirstSubChunk() {
-         #if DEBUG
+         #if DEBUG_RIFF
          std::cout << "List::GetFirstSubChunk()" << std::endl;
-         #endif // DEBUG
+         #endif // DEBUG_RIFF
          if (!pSubChunks) LoadSubChunks();
          ChunksIterator = pSubChunks->begin();
          return (ChunksIterator != pSubChunks->end()) ? *ChunksIterator : NULL;
      }
      /**
-      *  Returns the next subchunk within the list. You have to call
+      *  Returns the next subchunk within the list (which may be an ordinary
+      *  chunk as well as a list chunk). You have to call
       *  GetFirstSubChunk() before you can use this method!
       *
       *  @returns  pointer to the next subchunk within the list or NULL if
       *            end of list is reached
       */
      Chunk* List::GetNextSubChunk() {
-         #if DEBUG
+         #if DEBUG_RIFF
          std::cout << "List::GetNextSubChunk()" << std::endl;
-         #endif // DEBUG
+         #endif // DEBUG_RIFF
          if (!pSubChunks) return NULL;
          ChunksIterator++;
          return (ChunksIterator != pSubChunks->end()) ? *ChunksIterator : NULL;
-Line 965 
 namespace RIFF {
+Line 1208 
 namespace RIFF {
       *            otherwise
       */
      List* List::GetFirstSubList() {
-         #if DEBUG
+         #if DEBUG_RIFF
          std::cout << "List::GetFirstSubList()" << std::endl;
-         #endif // DEBUG
+         #endif // DEBUG_RIFF
          if (!pSubChunks) LoadSubChunks();
          ListIterator            = pSubChunks->begin();
          ChunkList::iterator end = pSubChunks->end();
-Line 987 
 namespace RIFF {
+Line 1230 
 namespace RIFF {
       *            end of list is reached
       */
      List* List::GetNextSubList() {
-         #if DEBUG
+         #if DEBUG_RIFF
          std::cout << "List::GetNextSubList()" << std::endl;
-         #endif // DEBUG
+         #endif // DEBUG_RIFF
          if (!pSubChunks) return NULL;
          if (ListIterator == pSubChunks->end()) return NULL;
          ListIterator++;
-Line 1002 
 namespace RIFF {
+Line 1245 
 namespace RIFF {
      }
      /**
-      *  Returns number of subchunks within the list.
+      *  Returns number of subchunks within the list (including list chunks).
       */
-     unsigned int List::CountSubChunks() {
+     size_t List::CountSubChunks() {
          if (!pSubChunks) LoadSubChunks();
          return pSubChunks->size();
      }
-Line 1013 
 namespace RIFF {
+Line 1256 
 namespace RIFF {
       *  Returns number of subchunks within the list with chunk ID
       *  <i>\a ChunkId</i>.
       */
-     unsigned int List::CountSubChunks(uint32_t ChunkID) {
+     size_t List::CountSubChunks(uint32_t ChunkID) {
-         unsigned int result = 0;
+         size_t result = 0;
          if (!pSubChunks) LoadSubChunks();
          ChunkList::iterator iter = pSubChunks->begin();
          ChunkList::iterator end  = pSubChunks->end();
-Line 1030 
 namespace RIFF {
+Line 1273 
 namespace RIFF {
      /**
       *  Returns number of sublists within the list.
       */
-     unsigned int List::CountSubLists() {
+     size_t List::CountSubLists() {
          return CountSubChunks(CHUNK_ID_LIST);
      }
-Line 1038 
 namespace RIFF {
+Line 1281 
 namespace RIFF {
       *  Returns number of sublists within the list with list type
       *  <i>\a ListType</i>
       */
-     unsigned int List::CountSubLists(uint32_t ListType) {
+     size_t List::CountSubLists(uint32_t ListType) {
-         unsigned int result = 0;
+         size_t result = 0;
          if (!pSubChunks) LoadSubChunks();
          ChunkList::iterator iter = pSubChunks->begin();
          ChunkList::iterator end  = pSubChunks->end();
-Line 1056 
 namespace RIFF {
+Line 1299 
 namespace RIFF {
      /** @brief Creates a new sub chunk.
       *
       * Creates and adds a new sub chunk to this list chunk. Note that the
-      * chunk's body size given by \a uiBodySize must be greater than zero.
+      * chunk's body size given by \a ullBodySize must be greater than zero.
       * You have to call File::Save() to make this change persistent to the
       * actual file and <b>before</b> performing any data write operations
       * on the new chunk!
       *
       * @param uiChunkID  - chunk ID of the new chunk
-      * @param uiBodySize - size of the new chunk's body, that is its actual
+      * @param ullBodySize - size of the new chunk's body, that is its actual
-      *                     data size (without header)
+      *                      data size (without header)
-      * @throws RIFF::Exception if \a uiBodySize equals zero
+      * @throws RIFF::Exception if \a ullBodySize equals zero
       */
-     Chunk* List::AddSubChunk(uint32_t uiChunkID, uint uiBodySize) {
+     Chunk* List::AddSubChunk(uint32_t uiChunkID, file_offset_t ullBodySize) {
-         if (uiBodySize == 0) throw Exception("Chunk body size must be at least 1 byte");
+         if (ullBodySize == 0) throw Exception("Chunk body size must be at least 1 byte");
          if (!pSubChunks) LoadSubChunks();
          Chunk* pNewChunk = new Chunk(pFile, this, uiChunkID, 0);
          pSubChunks->push_back(pNewChunk);
          (*pSubChunksMap)[uiChunkID] = pNewChunk;
-         pNewChunk->Resize(uiBodySize);
+         pNewChunk->Resize(ullBodySize);
+         ullNewChunkSize += CHUNK_HEADER_SIZE(pFile->FileOffsetSize);
          return pNewChunk;
      }
+     /** @brief Moves a sub chunk witin this list.
+      *
+      * Moves a sub chunk from one position in this list to another
+      * position in the same list. The pSrc chunk is placed before the
+      * pDst chunk.
+      *
+      * @param pSrc - sub chunk to be moved
+      * @param pDst - the position to move to. pSrc will be placed
+      *               before pDst. If pDst is 0, pSrc will be placed
+      *               last in list.
+      */
+     void List::MoveSubChunk(Chunk* pSrc, Chunk* pDst) {
+         if (!pSubChunks) LoadSubChunks();
+         pSubChunks->remove(pSrc);
+         ChunkList::iterator iter = find(pSubChunks->begin(), pSubChunks->end(), pDst);
+         pSubChunks->insert(iter, pSrc);
+     }
+     /** @brief Moves a sub chunk from this list to another list.
+      *
+      * Moves a sub chunk from this list list to the end of another
+      * list.
+      *
+      * @param pSrc - sub chunk to be moved
+      * @param pDst - destination list where the chunk shall be moved to
+      */
+     void List::MoveSubChunk(Chunk* pSrc, List* pNewParent) {
+         if (pNewParent == this || !pNewParent) return;
+         if (!pSubChunks) LoadSubChunks();
+         if (!pNewParent->pSubChunks) pNewParent->LoadSubChunks();
+         pSubChunks->remove(pSrc);
+         pNewParent->pSubChunks->push_back(pSrc);
+         // update chunk id map of this List
+         if ((*pSubChunksMap)[pSrc->GetChunkID()] == pSrc) {
+             pSubChunksMap->erase(pSrc->GetChunkID());
+             // try to find another chunk of the same chunk ID
+             ChunkList::iterator iter = pSubChunks->begin();
+             ChunkList::iterator end  = pSubChunks->end();
+             for (; iter != end; ++iter) {
+                 if ((*iter)->GetChunkID() == pSrc->GetChunkID()) {
+                     (*pSubChunksMap)[pSrc->GetChunkID()] = *iter;
+                     break; // we're done, stop search
+                 }
+             }
+         }
+         // update chunk id map of other list
+         if (!(*pNewParent->pSubChunksMap)[pSrc->GetChunkID()])
+             (*pNewParent->pSubChunksMap)[pSrc->GetChunkID()] = pSrc;
+     }
      /** @brief Creates a new list sub chunk.
       *
       * Creates and adds a new list sub chunk to this list chunk. Note that
-Line 1090 
 namespace RIFF {
+Line 1384 
 namespace RIFF {
          List* pNewListChunk = new List(pFile, this, uiListType);
          pSubChunks->push_back(pNewListChunk);
          (*pSubChunksMap)[CHUNK_ID_LIST] = pNewListChunk;
+         ullNewChunkSize += LIST_HEADER_SIZE(pFile->FileOffsetSize);
          return pNewListChunk;
      }
-Line 1097 
 namespace RIFF {
+Line 1392 
 namespace RIFF {
       *
       * Removes the sub chunk given by \a pSubChunk from this list and frees
       * it completely from RAM. The given chunk can either be a normal sub
-      * chunk or a list sub chunk. You should call File::Save() to make this
+      * chunk or a list sub chunk. In case the given chunk is a list chunk,
-      * change persistent at any time.
+      * all its subchunks (if any) will be removed recursively as well. You
+      * should call File::Save() to make this change persistent at any time.
       *
       * @param pSubChunk - sub chunk or sub list chunk to be removed
       */
-Line 1120 
 namespace RIFF {
+Line 1416 
 namespace RIFF {
          delete pSubChunk;
      }
-     void List::ReadHeader(unsigned long fPos) {
+     /**
-       #if DEBUG
+      *  Returns the actual total size in bytes (including List chunk header and
-       std::cout << "List::Readheader(ulong) ";
+      *  all subchunks) of this List Chunk if being stored to a file.
-       #endif // DEBUG
+      *
-         Chunk::ReadHeader(fPos);
+      *  @param fileOffsetSize - RIFF file offset size (in bytes) assumed when
-         NewChunkSize = CurrentChunkSize -= 4;
+      *                          being saved to a file
+      */
+     file_offset_t List::RequiredPhysicalSize(int fileOffsetSize) {
+         if (!pSubChunks) LoadSubChunks();
+         file_offset_t size = LIST_HEADER_SIZE(fileOffsetSize);
+         ChunkList::iterator iter = pSubChunks->begin();
+         ChunkList::iterator end  = pSubChunks->end();
+         for (; iter != end; ++iter)
+             size += (*iter)->RequiredPhysicalSize(fileOffsetSize);
+         return size;
+     }
+     void List::ReadHeader(file_offset_t filePos) {
+         #if DEBUG_RIFF
+         std::cout << "List::Readheader(file_offset_t) ";
+         #endif // DEBUG_RIFF
+         Chunk::ReadHeader(filePos);
+         if (ullCurrentChunkSize < 4) return;
+         ullNewChunkSize = ullCurrentChunkSize -= 4;
          #if POSIX
-         lseek(pFile->hFileRead, fPos + CHUNK_HEADER_SIZE, SEEK_SET);
+         lseek(pFile->hFileRead, filePos + CHUNK_HEADER_SIZE(pFile->FileOffsetSize), SEEK_SET);
          read(pFile->hFileRead, &ListType, 4);
+         #elif defined(WIN32)
+         LARGE_INTEGER liFilePos;
+         liFilePos.QuadPart = filePos + CHUNK_HEADER_SIZE(pFile->FileOffsetSize);
+         SetFilePointerEx(pFile->hFileRead, liFilePos, NULL/*new pos pointer*/, FILE_BEGIN);
+         DWORD dwBytesRead;
+         ReadFile(pFile->hFileRead, &ListType, 4, &dwBytesRead, NULL);
          #else
-         fseek(pFile->hFileRead, fPos + CHUNK_HEADER_SIZE, SEEK_SET);
+         fseeko(pFile->hFileRead, filePos + CHUNK_HEADER_SIZE(pFile->FileOffsetSize), SEEK_SET);
          fread(&ListType, 4, 1, pFile->hFileRead);
          #endif // POSIX
-       #if DEBUG
+         #if DEBUG_RIFF
-       std::cout << "listType=" << convertToString(ListType) << std::endl;
+         std::cout << "listType=" << convertToString(ListType) << std::endl;
-       #endif // DEBUG
+         #endif // DEBUG_RIFF
          if (!pFile->bEndianNative) {
              //swapBytes_32(&ListType);
          }
      }
-     void List::WriteHeader(unsigned long fPos) {
+     void List::WriteHeader(file_offset_t filePos) {
          // the four list type bytes officially belong the chunk's body in the RIFF format
-         NewChunkSize += 4;
+         ullNewChunkSize += 4;
-         Chunk::WriteHeader(fPos);
+         Chunk::WriteHeader(filePos);
-         NewChunkSize -= 4; // just revert the +4 incrementation
+         ullNewChunkSize -= 4; // just revert the +4 incrementation
          #if POSIX
-         lseek(pFile->hFileWrite, fPos + CHUNK_HEADER_SIZE, SEEK_SET);
+         lseek(pFile->hFileWrite, filePos + CHUNK_HEADER_SIZE(pFile->FileOffsetSize), SEEK_SET);
          write(pFile->hFileWrite, &ListType, 4);
+         #elif defined(WIN32)
+         LARGE_INTEGER liFilePos;
+         liFilePos.QuadPart = filePos + CHUNK_HEADER_SIZE(pFile->FileOffsetSize);
+         SetFilePointerEx(pFile->hFileWrite, liFilePos, NULL/*new pos pointer*/, FILE_BEGIN);
+         DWORD dwBytesWritten;
+         WriteFile(pFile->hFileWrite, &ListType, 4, &dwBytesWritten, NULL);
          #else
-         fseek(pFile->hFileWrite, fPos + CHUNK_HEADER_SIZE, SEEK_SET);
+         fseeko(pFile->hFileWrite, filePos + CHUNK_HEADER_SIZE(pFile->FileOffsetSize), SEEK_SET);
          fwrite(&ListType, 4, 1, pFile->hFileWrite);
          #endif // POSIX
      }
-     void List::LoadSubChunks() {
+     void List::LoadSubChunks(progress_t* pProgress) {
-        #if DEBUG
+         #if DEBUG_RIFF
-        std::cout << "List::LoadSubChunks()";
+         std::cout << "List::LoadSubChunks()";
-        #endif // DEBUG
+         #endif // DEBUG_RIFF
          if (!pSubChunks) {
              pSubChunks    = new ChunkList();
              pSubChunksMap = new ChunkMap();
+             #if defined(WIN32)
+             if (pFile->hFileRead == INVALID_HANDLE_VALUE) return;
+             #else
              if (!pFile->hFileRead) return;
-             unsigned long uiOriginalPos = GetPos();
+             #endif
+             file_offset_t ullOriginalPos = GetPos();
              SetPos(0); // jump to beginning of list chunk body
-             while (RemainingBytes() >= CHUNK_HEADER_SIZE) {
+             while (RemainingBytes() >= CHUNK_HEADER_SIZE(pFile->FileOffsetSize)) {
                  Chunk* ck;
                  uint32_t ckid;
-                 Read(&ckid, 4, 1);
+                 // return value check is required here to prevent a potential
-        #if DEBUG
+                 // garbage data use of 'ckid' below in case Read() failed
-        std::cout << " ckid=" << convertToString(ckid) << std::endl;
+                 if (Read(&ckid, 4, 1) != 4)
-        #endif // DEBUG
+                     throw Exception("LoadSubChunks(): Failed reading RIFF chunk ID");
+                 #if DEBUG_RIFF
+                 std::cout << " ckid=" << convertToString(ckid) << std::endl;
+                 #endif // DEBUG_RIFF
                  if (ckid == CHUNK_ID_LIST) {
-                     ck = new RIFF::List(pFile, ulStartPos + ulPos - 4, this);
+                     ck = new RIFF::List(pFile, ullStartPos + ullPos - 4, this);
-                     SetPos(ck->GetSize() + LIST_HEADER_SIZE - 4, RIFF::stream_curpos);
+                     SetPos(ck->GetSize() + LIST_HEADER_SIZE(pFile->FileOffsetSize) - 4, RIFF::stream_curpos);
                  }
                  else { // simple chunk
-                     ck = new RIFF::Chunk(pFile, ulStartPos + ulPos - 4, this);
+                     ck = new RIFF::Chunk(pFile, ullStartPos + ullPos - 4, this);
-                     SetPos(ck->GetSize() + CHUNK_HEADER_SIZE - 4, RIFF::stream_curpos);
+                     SetPos(ck->GetSize() + CHUNK_HEADER_SIZE(pFile->FileOffsetSize) - 4, RIFF::stream_curpos);
                  }
                  pSubChunks->push_back(ck);
                  (*pSubChunksMap)[ckid] = ck;
                  if (GetPos() % 2 != 0) SetPos(1, RIFF::stream_curpos); // jump over pad byte
              }
-             SetPos(uiOriginalPos); // restore position before this call
+             SetPos(ullOriginalPos); // restore position before this call
          }
+         if (pProgress)
+             __notify_progress(pProgress, 1.0); // notify done
+     }
+     void List::LoadSubChunksRecursively(progress_t* pProgress) {
+         const int n = (int) CountSubLists();
+         int i = 0;
+         for (List* pList = GetFirstSubList(); pList; pList = GetNextSubList(), ++i) {
+             if (pProgress) {
+                 // divide local progress into subprogress
+                 progress_t subprogress;
+                 __divide_progress(pProgress, &subprogress, n, i);
+                 // do the actual work
+                 pList->LoadSubChunksRecursively(&subprogress);
+             } else
+                 pList->LoadSubChunksRecursively(NULL);
+         }
+         if (pProgress)
+             __notify_progress(pProgress, 1.0); // notify done
      }
      /** @brief Write list chunk persistently e.g. to disk.
-Line 1194 
 namespace RIFF {
+Line 1546 
 namespace RIFF {
       * subchunks (including sub list chunks) will be stored recursively as
       * well.
       *
-      * @param ulWritePos - position within the "physical" file where this
+      * @param ullWritePos - position within the "physical" file where this
       *                     list chunk should be written to
-      * @param ulCurrentDataOffset - offset of current (old) data within
+      * @param ullCurrentDataOffset - offset of current (old) data within
       *                              the file
+      * @param pProgress - optional: callback function for progress notification
       * @returns new write position in the "physical" file, that is
-      *          \a ulWritePos incremented by this list chunk's new size
+      *          \a ullWritePos incremented by this list chunk's new size
       *          (including its header size of course)
       */
-     unsigned long List::WriteChunk(unsigned long ulWritePos, unsigned long ulCurrentDataOffset) {
+     file_offset_t List::WriteChunk(file_offset_t ullWritePos, file_offset_t ullCurrentDataOffset, progress_t* pProgress) {
-         const unsigned long ulOriginalPos = ulWritePos;
+         const file_offset_t ullOriginalPos = ullWritePos;
-         ulWritePos += LIST_HEADER_SIZE;
+         ullWritePos += LIST_HEADER_SIZE(pFile->FileOffsetSize);
          if (pFile->Mode != stream_mode_read_write)
              throw Exception("Cannot write list chunk, file has to be opened in read+write mode");
          // write all subchunks (including sub list chunks) recursively
          if (pSubChunks) {
-             for (ChunkList::iterator iter = pSubChunks->begin(), end = pSubChunks->end(); iter != end; ++iter) {
+             size_t i = 0;
-                 ulWritePos = (*iter)->WriteChunk(ulWritePos, ulCurrentDataOffset);
+             const size_t n = pSubChunks->size();
+             for (ChunkList::iterator iter = pSubChunks->begin(), end = pSubChunks->end(); iter != end; ++iter, ++i) {
+                 if (pProgress) {
+                     // divide local progress into subprogress for loading current Instrument
+                     progress_t subprogress;
+                     __divide_progress(pProgress, &subprogress, n, i);
+                     // do the actual work
+                     ullWritePos = (*iter)->WriteChunk(ullWritePos, ullCurrentDataOffset, &subprogress);
+                 } else
+                     ullWritePos = (*iter)->WriteChunk(ullWritePos, ullCurrentDataOffset, NULL);
              }
          }
          // update this list chunk's header
-         CurrentChunkSize = NewChunkSize = ulWritePos - ulOriginalPos - LIST_HEADER_SIZE;
+         ullCurrentChunkSize = ullNewChunkSize = ullWritePos - ullOriginalPos - LIST_HEADER_SIZE(pFile->FileOffsetSize);
-         WriteHeader(ulOriginalPos);
+         WriteHeader(ullOriginalPos);
          // offset of this list chunk in new written file may have changed
-         ulStartPos = ulOriginalPos + LIST_HEADER_SIZE;
+         ullStartPos = ullOriginalPos + LIST_HEADER_SIZE(pFile->FileOffsetSize);
+         if (pProgress)
+             __notify_progress(pProgress, 1.0); // notify done
-         return ulWritePos;
+         return ullWritePos;
      }
      void List::__resetPos() {
-Line 1238 
 namespace RIFF {
+Line 1603 
 namespace RIFF {
      /**
       *  Returns string representation of the lists's id
       */
-     String List::GetListTypeString() {
+     String List::GetListTypeString() const {
          return convertToString(ListType);
      }
-Line 1253 
 namespace RIFF {
+Line 1618 
 namespace RIFF {
       * "from scratch". Note: there must be no empty chunks or empty list
       * chunks when trying to make the new RIFF file persistent with Save()!
       *
+      * Note: by default, the RIFF file will be saved in native endian
+      * format; that is, as a RIFF file on little-endian machines and
+      * as a RIFX file on big-endian. To change this behaviour, call
+      * SetByteOrder() before calling Save().
+      *
       * @param FileType - four-byte identifier of the RIFF file type
-      * @see AddSubChunk(), AddSubList()
+      * @see AddSubChunk(), AddSubList(), SetByteOrder()
       */
-     File::File(uint32_t FileType) : List(this) {
+     File::File(uint32_t FileType)
+         : List(this), bIsNewFile(true), Layout(layout_standard),
+           FileOffsetPreference(offset_size_auto)
+     {
+         #if defined(WIN32)
+         hFileRead = hFileWrite = INVALID_HANDLE_VALUE;
+         #else
          hFileRead = hFileWrite = 0;
+         #endif
          Mode = stream_mode_closed;
          bEndianNative = true;
-         ulStartPos = RIFF_HEADER_SIZE;
          ListType = FileType;
+         FileOffsetSize = 4;
+         ullStartPos = RIFF_HEADER_SIZE(FileOffsetSize);
      }
      /** @brief Load existing RIFF file.
-Line 1269 
 namespace RIFF {
+Line 1647 
 namespace RIFF {
       * Loads an existing RIFF file with all its chunks.
       *
       * @param path - path and file name of the RIFF file to open
-      * @throws RIFF::Exception if error occured while trying to load the
+      * @throws RIFF::Exception if error occurred while trying to load the
       *                         given RIFF file
       */
-     File::File(const String& path) : List(this), Filename(path) {
+     File::File(const String& path)
-       #if DEBUG
+         : List(this), Filename(path), bIsNewFile(false), Layout(layout_standard),
-       std::cout << "File::File("<<path<<")" << std::endl;
+           FileOffsetPreference(offset_size_auto)
-       #endif // DEBUG
+     {
+         #if DEBUG_RIFF
+         std::cout << "File::File("<<path<<")" << std::endl;
+         #endif // DEBUG_RIFF
          bEndianNative = true;
+         FileOffsetSize = 4;
+         try {
+             __openExistingFile(path);
+             if (ChunkID != CHUNK_ID_RIFF && ChunkID != CHUNK_ID_RIFX) {
+                 throw RIFF::Exception("Not a RIFF file");
+             }
+         }
+         catch (...) {
+             Cleanup();
+             throw;
+         }
+     }
+     /** @brief Load existing RIFF-like file.
+      *
+      * Loads an existing file, which is not a "real" RIFF file, but similar to
+      * an ordinary RIFF file.
+      *
+      * A "real" RIFF file contains at top level a List chunk either with chunk
+      * ID "RIFF" or "RIFX". The simple constructor above expects this to be
+      * case, and if it finds the toplevel List chunk to have another chunk ID
+      * than one of those two expected ones, it would throw an Exception and
+      * would refuse to load the file accordingly.
+      *
+      * Since there are however a lot of file formats which use the same simple
+      * principles of the RIFF format, with another toplevel List chunk ID
+      * though, you can use this alternative constructor here to be able to load
+      * and handle those files in the same way as you would do with "real" RIFF
+      * files.
+      *
+      * @param path - path and file name of the RIFF-alike file to be opened
+      * @param FileType - expected toplevel List chunk ID (this is the very
+      *                   first chunk found in the file)
+      * @param Endian - whether the file uses little endian or big endian layout
+      * @param layout - general file structure type
+      * @param fileOffsetSize - (optional) preference how to deal with large files
+      * @throws RIFF::Exception if error occurred while trying to load the
+      *                         given RIFF-alike file
+      */
+     File::File(const String& path, uint32_t FileType, endian_t Endian, layout_t layout, offset_size_t fileOffsetSize)
+         : List(this), Filename(path), bIsNewFile(false), Layout(layout),
+           FileOffsetPreference(fileOffsetSize)
+     {
+         SetByteOrder(Endian);
+         if (fileOffsetSize < offset_size_auto || fileOffsetSize > offset_size_64bit)
+             throw Exception("Invalid RIFF::offset_size_t");
+         FileOffsetSize = 4;
+         try {
+             __openExistingFile(path, &FileType);
+         }
+         catch (...) {
+             Cleanup();
+             throw;
+         }
+     }
+     /**
+      * Opens an already existing RIFF file or RIFF-alike file. This method
+      * shall only be called once (in a File class constructor).
+      *
+      * @param path - path and file name of the RIFF file or RIFF-alike file to
+      *               be opened
+      * @param FileType - (optional) expected chunk ID of first chunk in file
+      * @throws RIFF::Exception if error occurred while trying to load the
+      *                         given RIFF file or RIFF-alike file
+      */
+     void File::__openExistingFile(const String& path, uint32_t* FileType) {
          #if POSIX
          hFileRead = hFileWrite = open(path.c_str(), O_RDONLY | O_NONBLOCK);
-         if (hFileRead <= 0) {
+         if (hFileRead == -1) {
              hFileRead = hFileWrite = 0;
+             String sError = strerror(errno);
+             throw RIFF::Exception("Can't open \"" + path + "\": " + sError);
+         }
+         #elif defined(WIN32)
+         hFileRead = hFileWrite = CreateFile(
+                                      path.c_str(), GENERIC_READ,
+                                      FILE_SHARE_READ | FILE_SHARE_WRITE,
+                                      NULL, OPEN_EXISTING,
+                                      FILE_ATTRIBUTE_NORMAL |
+                                      FILE_FLAG_RANDOM_ACCESS, NULL
+                                  );
+         if (hFileRead == INVALID_HANDLE_VALUE) {
+             hFileRead = hFileWrite = INVALID_HANDLE_VALUE;
              throw RIFF::Exception("Can't open \"" + path + "\"");
          }
          #else
          hFileRead = hFileWrite = fopen(path.c_str(), "rb");
-         if (!hFile) throw RIFF::Exception("Can't open \"" + path + "\"");
+         if (!hFileRead) throw RIFF::Exception("Can't open \"" + path + "\"");
          #endif // POSIX
          Mode = stream_mode_read;
-         ulStartPos = RIFF_HEADER_SIZE;
-         ReadHeader(0);
+         // determine RIFF file offset size to be used (in RIFF chunk headers)
-         if (ChunkID != CHUNK_ID_RIFF) {
+         // according to the current file offset preference
-             throw RIFF::Exception("Not a RIFF file");
+         FileOffsetSize = FileOffsetSizeFor(GetCurrentFileSize());
+         switch (Layout) {
+             case layout_standard: // this is a normal RIFF file
+                 ullStartPos = RIFF_HEADER_SIZE(FileOffsetSize);
+                 ReadHeader(0);
+                 if (FileType && ChunkID != *FileType)
+                     throw RIFF::Exception("Invalid file container ID");
+                 break;
+             case layout_flat: // non-standard RIFF-alike file
+                 ullStartPos = 0;
+                 ullNewChunkSize = ullCurrentChunkSize = GetCurrentFileSize();
+                 if (FileType) {
+                     uint32_t ckid;
+                     if (Read(&ckid, 4, 1) != 4) {
+                         throw RIFF::Exception("Invalid file header ID (premature end of header)");
+                     } else if (ckid != *FileType) {
+                         String s = " (expected '" + convertToString(*FileType) + "' but got '" + convertToString(ckid) + "')";
+                         throw RIFF::Exception("Invalid file header ID" + s);
+                     }
+                     SetPos(0); // reset to first byte of file
+                 }
+                 LoadSubChunks();
+                 break;
          }
      }
-     String File::GetFileName() {
+     String File::GetFileName() const {
          return Filename;
      }
+     void File::SetFileName(const String& path) {
+         Filename = path;
+     }
-     stream_mode_t File::GetMode() {
+     stream_mode_t File::GetMode() const {
          return Mode;
      }
+     layout_t File::GetLayout() const {
+         return Layout;
+     }
      /** @brief Change file access mode.
       *
       * Changes files access mode either to read-only mode or to read/write
-Line 1311 
 namespace RIFF {
+Line 1803 
 namespace RIFF {
       * @param NewMode - new file access mode
       * @returns true if mode was changed, false if current mode already
       *          equals new mode
-      * @throws RIFF::Exception if new file access mode is unknown
+      * @throws RIFF::Exception if file could not be opened in requested file
+      *         access mode or if passed access mode is unknown
       */
      bool File::SetMode(stream_mode_t NewMode) {
          if (NewMode != Mode) {
-Line 1320 
 namespace RIFF {
+Line 1813 
 namespace RIFF {
                      #if POSIX
                      if (hFileRead) close(hFileRead);
                      hFileRead = hFileWrite = open(Filename.c_str(), O_RDONLY | O_NONBLOCK);
-                     if (hFileRead < 0) {
+                     if (hFileRead == -1) {
                          hFileRead = hFileWrite = 0;
+                         String sError = strerror(errno);
+                         throw Exception("Could not (re)open file \"" + Filename + "\" in read mode: " + sError);
+                     }
+                     #elif defined(WIN32)
+                     if (hFileRead != INVALID_HANDLE_VALUE) CloseHandle(hFileRead);
+                     hFileRead = hFileWrite = CreateFile(
+                                                  Filename.c_str(), GENERIC_READ,
+                                                  FILE_SHARE_READ | FILE_SHARE_WRITE,
+                                                  NULL, OPEN_EXISTING,
+                                                  FILE_ATTRIBUTE_NORMAL |
+                                                  FILE_FLAG_RANDOM_ACCESS,
+                                                  NULL
+                                              );
+                     if (hFileRead == INVALID_HANDLE_VALUE) {
+                         hFileRead = hFileWrite = INVALID_HANDLE_VALUE;
                          throw Exception("Could not (re)open file \"" + Filename + "\" in read mode");
                      }
                      #else
                      if (hFileRead) fclose(hFileRead);
-                     hFileRead = hFileWrite = fopen(path.c_str(), "rb");
+                     hFileRead = hFileWrite = fopen(Filename.c_str(), "rb");
                      if (!hFileRead) throw Exception("Could not (re)open file \"" + Filename + "\" in read mode");
                      #endif
                      __resetPos(); // reset read/write position of ALL 'Chunk' objects
-Line 1335 
 namespace RIFF {
+Line 1843 
 namespace RIFF {
                      #if POSIX
                      if (hFileRead) close(hFileRead);
                      hFileRead = hFileWrite = open(Filename.c_str(), O_RDWR | O_NONBLOCK);
-                     if (hFileRead < 0) {
+                     if (hFileRead == -1) {
                          hFileRead = hFileWrite = open(Filename.c_str(), O_RDONLY | O_NONBLOCK);
-                         throw Exception("Could not open file \"" + Filename + "\" in read+write mode");
+                         String sError = strerror(errno);
+                         throw Exception("Could not open file \"" + Filename + "\" in read+write mode: " + sError);
+                     }
+                     #elif defined(WIN32)
+                     if (hFileRead != INVALID_HANDLE_VALUE) CloseHandle(hFileRead);
+                     hFileRead = hFileWrite = CreateFile(
+                                                  Filename.c_str(),
+                                                  GENERIC_READ | GENERIC_WRITE,
+                                                  FILE_SHARE_READ,
+                                                  NULL, OPEN_ALWAYS,
+                                                  FILE_ATTRIBUTE_NORMAL |
+                                                  FILE_FLAG_RANDOM_ACCESS,
+                                                  NULL
+                                              );
+                     if (hFileRead == INVALID_HANDLE_VALUE) {
+                         hFileRead = hFileWrite = CreateFile(
+                                                      Filename.c_str(), GENERIC_READ,
+                                                      FILE_SHARE_READ | FILE_SHARE_WRITE,
+                                                      NULL, OPEN_EXISTING,
+                                                      FILE_ATTRIBUTE_NORMAL |
+                                                      FILE_FLAG_RANDOM_ACCESS,
+                                                      NULL
+                                                  );
+                         throw Exception("Could not (re)open file \"" + Filename + "\" in read+write mode");
                      }
                      #else
                      if (hFileRead) fclose(hFileRead);
-                     hFileRead = hFileWrite = fopen(path.c_str(), "r+b");
+                     hFileRead = hFileWrite = fopen(Filename.c_str(), "r+b");
                      if (!hFileRead) {
-                         hFileRead = hFileWrite = fopen(path.c_str(), "rb");
+                         hFileRead = hFileWrite = fopen(Filename.c_str(), "rb");
                          throw Exception("Could not open file \"" + Filename + "\" in read+write mode");
                      }
                      #endif
-Line 1353 
 namespace RIFF {
+Line 1884 
 namespace RIFF {
                      #if POSIX
                      if (hFileRead)  close(hFileRead);
                      if (hFileWrite) close(hFileWrite);
+                     hFileRead = hFileWrite = 0;
+                     #elif defined(WIN32)
+                     if (hFileRead  != INVALID_HANDLE_VALUE) CloseHandle(hFileRead);
+                     if (hFileWrite != INVALID_HANDLE_VALUE) CloseHandle(hFileWrite);
+                     hFileRead = hFileWrite = INVALID_HANDLE_VALUE;
                      #else
                      if (hFileRead)  fclose(hFileRead);
                      if (hFileWrite) fclose(hFileWrite);
+                     hFileRead = hFileWrite = NULL;
                      #endif
-                     hFileRead = hFileWrite = 0;
                      break;
                  default:
                      throw Exception("Unknown file access mode");
-Line 1368 
 namespace RIFF {
+Line 1904 
 namespace RIFF {
          return false;
      }
+     /** @brief Set the byte order to be used when saving.
+      *
+      * Set the byte order to be used in the file. A value of
+      * endian_little will create a RIFF file, endian_big a RIFX file
+      * and endian_native will create a RIFF file on little-endian
+      * machines and RIFX on big-endian machines.
+      *
+      * @param Endian - endianess to use when file is saved.
+      */
+     void File::SetByteOrder(endian_t Endian) {
+         #if WORDS_BIGENDIAN
+         bEndianNative = Endian != endian_little;
+         #else
+         bEndianNative = Endian != endian_big;
+         #endif
+     }
      /** @brief Save changes to same file.
       *
       * Make all changes of all chunks persistent by writing them to the
-      * actual (same) file. The file might temporarily grow to a higher size
+      * actual (same) file.
-      * than it will have at the end of the saving process, in case chunks
-      * were grown.
       *
+      * @param pProgress - optional: callback function for progress notification
       * @throws RIFF::Exception if there is an empty chunk or empty list
-      *                         chunk or any kind of IO error occured
+      *                         chunk or any kind of IO error occurred
       */
-     void File::Save() {
+     void File::Save(progress_t* pProgress) {
+         //TODO: implementation for the case where first chunk is not a global container (List chunk) is not implemented yet (i.e. Korg files)
+         if (Layout == layout_flat)
+             throw Exception("Saving a RIFF file with layout_flat is not implemented yet");
+         // make sure the RIFF tree is built (from the original file)
+         if (pProgress) {
+             // divide progress into subprogress
+             progress_t subprogress;
+             __divide_progress(pProgress, &subprogress, 3.f, 0.f); // arbitrarily subdivided into 1/3 of total progress
+             // do the actual work
+             LoadSubChunksRecursively(&subprogress);
+             // notify subprogress done
+             __notify_progress(&subprogress, 1.f);
+         } else
+             LoadSubChunksRecursively(NULL);
          // reopen file in write mode
          SetMode(stream_mode_read_write);
+         // get the current file size as it is now still physically stored on disk
+         const file_offset_t workingFileSize = GetCurrentFileSize();
+         // get the overall file size required to save this file
+         const file_offset_t newFileSize = GetRequiredFileSize(FileOffsetPreference);
+         // determine whether this file will yield in a large file (>=4GB) and
+         // the RIFF file offset size to be used accordingly for all chunks
+         FileOffsetSize = FileOffsetSizeFor(newFileSize);
          // to be able to save the whole file without loading everything into
          // RAM and without having to store the data in a temporary file, we
-         // enlarge the file with the sum of all _positive_ chunk size
+         // enlarge the file with the overall positive file size change,
-         // changes, move current data towards the end of the file with the
+         // then move current data towards the end of the file by the calculated
-         // calculated sum and finally update / rewrite the file by copying
+         // positive file size difference and finally update / rewrite the file
-         // the old data back to the right position at the beginning of the file
+         // by copying the old data back to the right position at the beginning
+         // of the file
-         // first we sum up all positive chunk size changes (and skip all negative ones)
-         unsigned long ulPositiveSizeDiff = 0;
-         for (ChunkList::iterator iter = ResizedChunks.begin(), end = ResizedChunks.end(); iter != end; ++iter) {
-             if ((*iter)->GetNewSize() == 0) throw Exception("There is at least one empty chunk (zero size)");
-             if ((*iter)->GetNewSize() + 1L > (*iter)->GetSize()) {
-                 unsigned long ulDiff = (*iter)->GetNewSize() - (*iter)->GetSize() + 1L; // +1 in case we have to add a pad byte
-                 ulPositiveSizeDiff += ulDiff;
-             }
-         }
-         unsigned long ulWorkingFileSize = GetFileSize();
          // if there are positive size changes...
-         if (ulPositiveSizeDiff > 0) {
+         file_offset_t positiveSizeDiff = 0;
+         if (newFileSize > workingFileSize) {
+             positiveSizeDiff = newFileSize - workingFileSize;
+             // divide progress into subprogress
+             progress_t subprogress;
+             if (pProgress)
+                 __divide_progress(pProgress, &subprogress, 3.f, 1.f); // arbitrarily subdivided into 1/3 of total progress
              // ... we enlarge this file first ...
-             ulWorkingFileSize += ulPositiveSizeDiff;
+             ResizeFile(newFileSize);
-             ResizeFile(ulWorkingFileSize);
              // ... and move current data by the same amount towards end of file.
              int8_t* pCopyBuffer = new int8_t[4096];
-             const unsigned long ulFileSize = GetSize() + RIFF_HEADER_SIZE;
+             #if defined(WIN32)
-             int iBytesMoved = 1;
+             DWORD iBytesMoved = 1; // we have to pass it via pointer to the Windows API, thus the correct size must be ensured
-             for (unsigned long ulPos = 0; iBytesMoved > 0; ulPos += iBytesMoved) {
+             #else
-                 const unsigned long ulToMove = ulFileSize - ulPos;
+             ssize_t iBytesMoved = 1;
-                 iBytesMoved = (ulToMove < 4096) ? ulToMove : 4096;
+             #endif
+             for (file_offset_t ullPos = workingFileSize, iNotif = 0; iBytesMoved > 0; ++iNotif) {
+                 iBytesMoved = (ullPos < 4096) ? ullPos : 4096;
+                 ullPos -= iBytesMoved;
                  #if POSIX
-                 lseek(hFileRead, ulPos, SEEK_SET);
+                 lseek(hFileRead, ullPos, SEEK_SET);
                  iBytesMoved = read(hFileRead, pCopyBuffer, iBytesMoved);
-                 lseek(hFileWrite, ulPos + ulPositiveSizeDiff, SEEK_SET);
+                 lseek(hFileWrite, ullPos + positiveSizeDiff, SEEK_SET);
                  iBytesMoved = write(hFileWrite, pCopyBuffer, iBytesMoved);
+                 #elif defined(WIN32)
+                 LARGE_INTEGER liFilePos;
+                 liFilePos.QuadPart = ullPos;
+                 SetFilePointerEx(hFileRead, liFilePos, NULL/*new pos pointer*/, FILE_BEGIN);
+                 ReadFile(hFileRead, pCopyBuffer, iBytesMoved, &iBytesMoved, NULL);
+                 liFilePos.QuadPart = ullPos + positiveSizeDiff;
+                 SetFilePointerEx(hFileWrite, liFilePos, NULL/*new pos pointer*/, FILE_BEGIN);
+                 WriteFile(hFileWrite, pCopyBuffer, iBytesMoved, &iBytesMoved, NULL);
                  #else
-                 fseek(hFileRead, ulPos, SEEK_SET);
+                 fseeko(hFileRead, ullPos, SEEK_SET);
                  iBytesMoved = fread(pCopyBuffer, 1, iBytesMoved, hFileRead);
-                 fseek(hFileWrite, ulPos + ulPositiveSizeDiff, SEEK_SET);
+                 fseeko(hFileWrite, ullPos + positiveSizeDiff, SEEK_SET);
                  iBytesMoved = fwrite(pCopyBuffer, 1, iBytesMoved, hFileWrite);
                  #endif
+                 if (pProgress && !(iNotif % 8) && iBytesMoved > 0)
+                     __notify_progress(&subprogress, float(workingFileSize - ullPos) / float(workingFileSize));
              }
              delete[] pCopyBuffer;
              if (iBytesMoved < 0) throw Exception("Could not modify file while trying to enlarge it");
+             if (pProgress)
+                 __notify_progress(&subprogress, 1.f); // notify subprogress done
          }
-         // rebuild / rewrite complete RIFF tree
+         // rebuild / rewrite complete RIFF tree ...
-         unsigned long ulTotalSize  = WriteChunk(0, ulPositiveSizeDiff);
-         unsigned long ulActualSize = __GetFileSize(hFileWrite);
+         // divide progress into subprogress
+         progress_t subprogress;
+         if (pProgress)
+             __divide_progress(pProgress, &subprogress, 3.f, 2.f); // arbitrarily subdivided into 1/3 of total progress
+         // do the actual work
+         const file_offset_t finalSize = WriteChunk(0, positiveSizeDiff, pProgress ? &subprogress : NULL);
+         const file_offset_t finalActualSize = __GetFileSize(hFileWrite);
+         // notify subprogress done
+         if (pProgress)
+             __notify_progress(&subprogress, 1.f);
          // resize file to the final size
-         if (ulTotalSize < ulActualSize) ResizeFile(ulTotalSize);
+         if (finalSize < finalActualSize) ResizeFile(finalSize);
-         // forget all resized chunks
+         if (pProgress)
-         ResizedChunks.clear();
+             __notify_progress(pProgress, 1.0); // notify done
      }
      /** @brief Save changes to another file.
-Line 1452 
 namespace RIFF {
+Line 2052 
 namespace RIFF {
       * the new file (given by \a path) afterwards.
       *
       * @param path - path and file name where everything should be written to
+      * @param pProgress - optional: callback function for progress notification
       */
-     void File::Save(const String& path) {
+     void File::Save(const String& path, progress_t* pProgress) {
          //TODO: we should make a check here if somebody tries to write to the same file and automatically call the other Save() method in that case
-         if (Filename.length() > 0) SetMode(stream_mode_read);
+         //TODO: implementation for the case where first chunk is not a global container (List chunk) is not implemented yet (i.e. Korg files)
+         if (Layout == layout_flat)
+             throw Exception("Saving a RIFF file with layout_flat is not implemented yet");
+         // make sure the RIFF tree is built (from the original file)
+         if (pProgress) {
+             // divide progress into subprogress
+             progress_t subprogress;
+             __divide_progress(pProgress, &subprogress, 2.f, 0.f); // arbitrarily subdivided into 1/2 of total progress
+             // do the actual work
+             LoadSubChunksRecursively(&subprogress);
+             // notify subprogress done
+             __notify_progress(&subprogress, 1.f);
+         } else
+             LoadSubChunksRecursively(NULL);
+         if (!bIsNewFile) SetMode(stream_mode_read);
          // open the other (new) file for writing and truncate it to zero size
          #if POSIX
          hFileWrite = open(path.c_str(), O_RDWR | O_CREAT, S_IRUSR | S_IWUSR | S_IRGRP);
-         if (hFileWrite < 0) {
+         if (hFileWrite == -1) {
+             hFileWrite = hFileRead;
+             String sError = strerror(errno);
+             throw Exception("Could not open file \"" + path + "\" for writing: " + sError);
+         }
+         #elif defined(WIN32)
+         hFileWrite = CreateFile(
+                          path.c_str(), GENERIC_WRITE, FILE_SHARE_READ,
+                          NULL, OPEN_ALWAYS, FILE_ATTRIBUTE_NORMAL |
+                          FILE_FLAG_RANDOM_ACCESS, NULL
+                      );
+         if (hFileWrite == INVALID_HANDLE_VALUE) {
              hFileWrite = hFileRead;
              throw Exception("Could not open file \"" + path + "\" for writing");
          }
-Line 1473 
 namespace RIFF {
+Line 2101 
 namespace RIFF {
          #endif // POSIX
          Mode = stream_mode_read_write;
+         // get the overall file size required to save this file
+         const file_offset_t newFileSize = GetRequiredFileSize(FileOffsetPreference);
+         // determine whether this file will yield in a large file (>=4GB) and
+         // the RIFF file offset size to be used accordingly for all chunks
+         FileOffsetSize = FileOffsetSizeFor(newFileSize);
          // write complete RIFF tree to the other (new) file
-         unsigned long ulTotalSize  = WriteChunk(0, 0);
+         file_offset_t ullTotalSize;
-         unsigned long ulActualSize = __GetFileSize(hFileWrite);
+         if (pProgress) {
+             // divide progress into subprogress
+             progress_t subprogress;
+             __divide_progress(pProgress, &subprogress, 2.f, 1.f); // arbitrarily subdivided into 1/2 of total progress
+             // do the actual work
+             ullTotalSize = WriteChunk(0, 0, &subprogress);
+             // notify subprogress done
+             __notify_progress(&subprogress, 1.f);
+         } else
+             ullTotalSize = WriteChunk(0, 0, NULL);
-         // resize file to the final size (if the file was originally larger)
+         file_offset_t ullActualSize = __GetFileSize(hFileWrite);
-         if (ulTotalSize < ulActualSize) ResizeFile(ulTotalSize);
-         // forget all resized chunks
+         // resize file to the final size (if the file was originally larger)
-         ResizedChunks.clear();
+         if (ullActualSize > ullTotalSize) ResizeFile(ullTotalSize);
-         if (Filename.length() > 0) {
+         #if POSIX
-             #if POSIX
+         if (hFileWrite) close(hFileWrite);
-             close(hFileWrite);
+         #elif defined(WIN32)
-             #else
+         if (hFileWrite != INVALID_HANDLE_VALUE) CloseHandle(hFileWrite);
-             fclose(hFileWrite);
+         #else
-             #endif
+         if (hFileWrite) fclose(hFileWrite);
-             hFileWrite = hFileRead;
+         #endif
-         }
+         hFileWrite = hFileRead;
          // associate new file with this File object from now on
          Filename = path;
+         bIsNewFile = false;
          Mode = (stream_mode_t) -1;       // Just set it to an undefined mode ...
          SetMode(stream_mode_read_write); // ... so SetMode() has to reopen the file handles.
+         if (pProgress)
+             __notify_progress(pProgress, 1.0); // notify done
      }
-     void File::ResizeFile(unsigned long ulNewSize) {
+     void File::ResizeFile(file_offset_t ullNewSize) {
          #if POSIX
-         if (ftruncate(hFileWrite, ulNewSize) < 0)
+         if (ftruncate(hFileWrite, ullNewSize) < 0)
              throw Exception("Could not resize file \"" + Filename + "\"");
+         #elif defined(WIN32)
+         LARGE_INTEGER liFilePos;
+         liFilePos.QuadPart = ullNewSize;
+         if (
+             !SetFilePointerEx(hFileWrite, liFilePos, NULL/*new pos pointer*/, FILE_BEGIN) ||
+             !SetEndOfFile(hFileWrite)
+         ) throw Exception("Could not resize file \"" + Filename + "\"");
          #else
-         # error Sorry, this version of libgig only supports POSIX systems yet.
+         # error Sorry, this version of libgig only supports POSIX and Windows systems yet.
          # error Reason: portable implementation of RIFF::File::ResizeFile() is missing (yet)!
          #endif
      }
      File::~File() {
-        #if DEBUG
+         #if DEBUG_RIFF
-        std::cout << "File::~File()" << std::endl;
+         std::cout << "File::~File()" << std::endl;
-        #endif // DEBUG
+         #endif // DEBUG_RIFF
+         Cleanup();
+     }
+     /**
+      * Returns @c true if this file has been created new from scratch and
+      * has not been stored to disk yet.
+      */
+     bool File::IsNew() const {
+         return bIsNewFile;
+     }
+     void File::Cleanup() {
          #if POSIX
          if (hFileRead) close(hFileRead);
+         #elif defined(WIN32)
+         if (hFileRead != INVALID_HANDLE_VALUE) CloseHandle(hFileRead);
          #else
          if (hFileRead) fclose(hFileRead);
          #endif // POSIX
+         DeleteChunkList();
+         pFile = NULL;
+     }
+     /**
+      * Returns the current size of this file (in bytes) as it is currently
+      * yet stored on disk. If this file does not yet exist on disk (i.e. when
+      * this RIFF File has just been created from scratch and Save() has not
+      * been called yet) then this method returns 0.
+      */
+     file_offset_t File::GetCurrentFileSize() const {
+         file_offset_t size = 0;
+         try {
+             size = __GetFileSize(hFileRead);
+         } catch (...) {
+             size = 0;
+         }
+         return size;
+     }
+     /**
+      * Returns the required size (in bytes) for this RIFF File to be saved to
+      * disk. The precise size of the final file on disk depends on the RIFF
+      * file offset size actually used internally in all headers of the RIFF
+      * chunks. By default libgig handles the required file offset size
+      * automatically for you; that means it is using 32 bit offsets for files
+      * smaller than 4 GB and 64 bit offsets for files equal or larger than
+      * 4 GB. You may however also override this default behavior by passing the
+      * respective option to the RIFF File constructor to force one particular
+      * offset size. In the latter case this method will return the file size
+      * for the requested forced file offset size that will be used when calling
+      * Save() later on.
+      *
+      * You may also use the overridden method below to get the file size for
+      * an arbitrary other file offset size instead.
+      *
+      * @see offset_size_t
+      * @see GetFileOffsetSize()
+      */
+     file_offset_t File::GetRequiredFileSize() {
+         return GetRequiredFileSize(FileOffsetPreference);
+     }
+     /**
+      * Returns the rquired size (in bytes) for this RIFF file to be saved to
+      * disk, assuming the passed @a fileOffsestSize would be used for the
+      * Save() operation.
+      *
+      * This overridden method essentialy behaves like the above method, with
+      * the difference that you must provide a specific RIFF @a fileOffsetSize
+      * for calculating the theoretical final file size.
+      *
+      * @see GetFileOffsetSize()
+      */
+     file_offset_t File::GetRequiredFileSize(offset_size_t fileOffsetSize) {
+         switch (fileOffsetSize) {
+             case offset_size_auto: {
+                 file_offset_t fileSize = GetRequiredFileSize(offset_size_32bit);
+                 if (fileSize >> 32)
+                     return GetRequiredFileSize(offset_size_64bit);
+                 else
+                     return fileSize;
+             }
+             case offset_size_32bit: break;
+             case offset_size_64bit: break;
+             default: throw Exception("Internal error: Invalid RIFF::offset_size_t");
+         }
+         return RequiredPhysicalSize(FileOffsetSize);
      }
-     void File::LogAsResized(Chunk* pResizedChunk) {
+     int File::FileOffsetSizeFor(file_offset_t fileSize) const {
-         ResizedChunks.push_back(pResizedChunk);
+         switch (FileOffsetPreference) {
+             case offset_size_auto:
+                 return (fileSize >> 32) ? 8 : 4;
+             case offset_size_32bit:
+                 return 4;
+             case offset_size_64bit:
+                 return 8;
+             default:
+                 throw Exception("Internal error: Invalid RIFF::offset_size_t");
+         }
      }
-     unsigned long File::GetFileSize() {
+     /**
-         return __GetFileSize(hFileRead);
+      * Returns the current size (in bytes) of file offsets stored in the
+      * headers of all chunks of this file.
+      *
+      * Most RIFF files are using 32 bit file offsets internally, which limits
+      * them to a maximum file size of less than 4 GB though. In contrast to the
+      * common standard, this RIFF File class implementation supports handling of
+      * RIFF files equal or larger than 4 GB. In such cases 64 bit file offsets
+      * have to be used in all headers of all RIFF Chunks when being stored to a
+      * physical file. libgig by default automatically selects the correct file
+      * offset size for you. You may however also force one particular file
+      * offset size by supplying the respective option to the RIFF::File
+      * constructor.
+      *
+      * This method can be used to check which RIFF file offset size is currently
+      * being used for this RIFF File.
+      *
+      * @returns current RIFF file offset size used (in bytes)
+      * @see offset_size_t
+      */
+     int File::GetFileOffsetSize() const {
+         return FileOffsetSize;
+     }
+     /**
+      * Returns the required size (in bytes) of file offsets stored in the
+      * headers of all chunks of this file if the current RIFF tree would be
+      * saved to disk by calling Save().
+      *
+      * See GetFileOffsetSize() for mor details about RIFF file offsets.
+      *
+      * @returns RIFF file offset size required (in bytes) if being saved
+      * @see offset_size_t
+      */
+     int File::GetRequiredFileOffsetSize() {
+         return FileOffsetSizeFor(GetCurrentFileSize());
      }
      #if POSIX
-     unsigned long File::__GetFileSize(int hFile) {
+     file_offset_t File::__GetFileSize(int hFile) const {
          struct stat filestat;
-         fstat(hFile, &filestat);
+         if (fstat(hFile, &filestat) == -1)
-         long size = filestat.st_size;
+             throw Exception("POSIX FS error: could not determine file size");
-         return size;
+         return filestat.st_size;
+     }
+     #elif defined(WIN32)
+     file_offset_t File::__GetFileSize(HANDLE hFile) const {
+         LARGE_INTEGER size;
+         if (!GetFileSizeEx(hFile, &size))
+             throw Exception("Windows FS error: could not determine file size");
+         return size.QuadPart;
      }
      #else // standard C functions
-     unsigned long File::__GetFileSize(FILE* hFile) {
+     file_offset_t File::__GetFileSize(FILE* hFile) const {
-         long curpos = ftell(hFile);
+         off_t curpos = ftello(hFile);
-         fseek(hFile, 0, SEEK_END);
+         if (fseeko(hFile, 0, SEEK_END) == -1)
-         long size = ftell(hFile);
+             throw Exception("FS error: could not determine file size");
-         fseek(hFile, curpos, SEEK_SET);
+         off_t size = ftello(hFile);
+         fseeko(hFile, curpos, SEEK_SET);
          return size;
      }
      #endif
-Line 1548 
 namespace RIFF {
+Line 2335 
 namespace RIFF {
  // *************** Exception ***************
  // *
+     Exception::Exception() {
+     }
+     Exception::Exception(String format, ...) {
+         va_list arg;
+         va_start(arg, format);
+         Message = assemble(format, arg);
+         va_end(arg);
+     }
+     Exception::Exception(String format, va_list arg) {
+         Message = assemble(format, arg);
+     }
      void Exception::PrintMessage() {
          std::cout << "RIFF::Exception: " << Message << std::endl;
      }
+     String Exception::assemble(String format, va_list arg) {
+         char* buf = NULL;
+         vasprintf(&buf, format.c_str(), arg);
+         String s = buf;
+         free(buf);
+         return s;
+     }
  // *************** functions ***************
  // *

 Legend:



Removed from v.798
 


changed lines


 
Added in v.3912
 Legend:



Removed from v.798
 


changed lines


 
Added in v.3912
-Removed from v.798
+Added in v.3912

	ViewVC Help
Powered by ViewVC