wavelength 1.0.0
Loading...
Searching...
No Matches
BankFileIO.h
Go to the documentation of this file.
1#pragma once
2
3#include <vector>
4
5#include "os/File.h"
7#include "utl/BinStream.h"
8#include "utl/FileStream.h"
9#include "utl/Str.h"
10
17static const String kBankExtension(".bnk");
18
26static const String kAudioDataExtension(".nse");
27
36class BankFileIO {
37public:
40 kRead = 0,
41 kWrite = 1,
42 };
43
56
64 BankFileIO(const String &filename, int ioDirection);
65
72
79 bool operator!() const;
80
88 void PackChunkHeader(const char *header, std::vector<unsigned char> &data);
89
97 void UnpackChunkHeader(char *header, std::vector<unsigned char> &data);
98
106 static String AudioDataFilename(const String &iBankFileName);
107
114
121 void WriteAudioData(std::vector<unsigned char> &data);
122
129
137 BinStream *BeginChunk(int chunkType);
138
146 const char *GetChunkTag(int chunkType);
147
154 void EndChunk(BinStream *stream);
155
162 void OpenAudioData(int bufferSize);
163
174 bool GetAudioData(std::vector<unsigned char> &oAudioData, int *position, bool *gotData);
175
182 void FindChunk(int chunkType);
183
191 bool ReadChunk(std::vector<unsigned char> &data);
192
193private:
195 enum ReadState {
196 kReadingHeader = 0,
197 kReadingData = 1,
198 kReadDone = 2,
199 };
200
209 bool ReadChunkHeader(std::vector<unsigned char> &data);
210
211 LazyFileStream *mAudioFileStream;
212 String mFilename;
213 FileStream *mAudioDataOutputFile;
214 FileStream *mBankOutputFile;
215 File *mBankAsyncInputFile;
216 char mChunkTag[4];
217 int mReadState;
218 int mIODirection;
219 int mChunkStart;
220 char mHeaderData[8];
221 char mCurTag[4];
222 int mChunkSize;
223};
static const String kBankExtension(".bnk")
Extension of a bank file.
static const String kAudioDataExtension(".nse")
Extension of the audio data file that goes with a bank file.
Reader of a bank file and the audio data file beside it.
Definition bankfileio.h:36
bool GetAudioData(std::vector< unsigned char > &oAudioData, int *position, bool *gotData)
Poll the reading of the audio data file.
BinStream * BeginChunk(int chunkType)
Start writing a chunk.
void EndChunk(BinStream *stream)
Complete the header of the chunk BeginChunk() started.
void EndAudioDataOutput()
Close the audio data file.
void UnpackChunkHeader(char *header, std::vector< unsigned char > &data)
Copy eight bytes into a chunk header.
ChunkType
Chunks of a bank file.
Definition bankfileio.h:45
@ kSampleFilenameChunk
Definition bankfileio.h:50
@ kInstrumentNameChunk
Definition bankfileio.h:52
@ kSampleDescriptionChunk
Definition bankfileio.h:48
@ kBankNameChunk
Definition bankfileio.h:51
@ kSampleChunk
Definition bankfileio.h:49
@ kInstrumentChunk
Definition bankfileio.h:47
@ kSampleDescriptionNameChunk
Definition bankfileio.h:53
@ kBankChunk
Definition bankfileio.h:46
@ kSampleNameChunk
Definition bankfileio.h:54
bool operator!() const
Report whether the bank file failed to open.
IODirection
Directions of a BankFileIO.
Definition bankfileio.h:39
@ kRead
Definition bankfileio.h:40
@ kWrite
Definition bankfileio.h:41
void OpenAudioData(int bufferSize)
Start reading the audio data file.
void WriteAudioData(std::vector< unsigned char > &data)
Append bytes to the audio data file.
void BeginAudioDataOutput()
Create the audio data file for writing.
static String AudioDataFilename(const String &iBankFileName)
Derive the path of the audio data file from the path of a bank file.
bool ReadChunk(std::vector< unsigned char > &data)
Continue reading the bank file.
BankFileIO(const String &filename, int ioDirection)
Open a bank file for reading or writing.
const char * GetChunkTag(int chunkType)
Report the identifier of a chunk.
void FindChunk(int chunkType)
Start looking for a chunk from the start of the bank file.
~BankFileIO()
Close every file.
void PackChunkHeader(const char *header, std::vector< unsigned char > &data)
Copy a chunk header into eight bytes.
Stream of raw bytes, the base of the memory, file, and network streams.
Definition binstream.h:22
BinStream that reads or writes a file.
Definition filestream.h:14
Open file of the host or the disc.
Definition file.h:29
Double-buffered reader with one asynchronous read of a file always in flight.
Definition lazyfilestream.h:14
Growable text buffer that is also a PrnStream.
Definition string.h:19