30 # define RIFF_TYPE_DLS 0x444C5320 31 # define LIST_TYPE_WVPL 0x7776706C 32 # define LIST_TYPE_DWPL 0x6477706C 33 # define LIST_TYPE_WAVE 0x77617665 34 # define LIST_TYPE_LINS 0X6C696E73 35 # define LIST_TYPE_INS 0X696E7320 36 # define LIST_TYPE_LRGN 0x6C72676E 37 # define LIST_TYPE_LART 0x6C617274 38 # define LIST_TYPE_LAR2 0x6C617232 39 # define LIST_TYPE_RGN 0x72676E20 40 # define LIST_TYPE_RGN2 0x72676E32 41 # define CHUNK_ID_IARL 0x4941524C 42 # define CHUNK_ID_IART 0x49415254 43 # define CHUNK_ID_ICMS 0x49434D53 44 # define CHUNK_ID_IGNR 0x49474E52 45 # define CHUNK_ID_IKEY 0x494B4559 46 # define CHUNK_ID_IMED 0x494D4544 47 # define CHUNK_ID_ISBJ 0x4953424A 48 # define CHUNK_ID_ISRC 0x49535243 49 # define CHUNK_ID_ISRF 0x49535246 50 # define CHUNK_ID_ITCH 0x49544348 51 # define CHUNK_ID_VERS 0x76657273 52 # define CHUNK_ID_DLID 0x646C6964 53 # define CHUNK_ID_FMT 0x666D7420 54 # define CHUNK_ID_DATA 0x64617461 55 # define CHUNK_ID_INSH 0x696E7368 56 # define CHUNK_ID_RGNH 0x72676E68 57 # define CHUNK_ID_WLNK 0x776C6E6B 58 # define CHUNK_ID_PTBL 0x7074626C 59 # define CHUNK_ID_WSMP 0x77736D70 60 # define CHUNK_ID_COLH 0x636F6C68 61 # define CHUNK_ID_ARTL 0x6172746C 62 # define CHUNK_ID_ART2 0x61727432 63 #else // little endian 64 # define RIFF_TYPE_DLS 0x20534C44 65 # define LIST_TYPE_WVPL 0x6C707677 66 # define LIST_TYPE_DWPL 0x6C707764 67 # define LIST_TYPE_WAVE 0x65766177 68 # define LIST_TYPE_LINS 0X736E696C 69 # define LIST_TYPE_INS 0X20736E69 70 # define LIST_TYPE_LRGN 0x6E67726C 71 # define LIST_TYPE_LART 0x7472616C 72 # define LIST_TYPE_LAR2 0x3272616C 73 # define LIST_TYPE_RGN 0x206E6772 74 # define LIST_TYPE_RGN2 0x326E6772 75 # define CHUNK_ID_IARL 0x4C524149 76 # define CHUNK_ID_IART 0x54524149 77 # define CHUNK_ID_ICMS 0x534D4349 78 # define CHUNK_ID_IGNR 0x524E4749 79 # define CHUNK_ID_IKEY 0x59454B49 80 # define CHUNK_ID_IMED 0x44454D49 81 # define CHUNK_ID_ISBJ 0x4A425349 82 # define CHUNK_ID_ISRC 0x43525349 83 # define CHUNK_ID_ISRF 0x46525349 84 # define CHUNK_ID_ITCH 0x48435449 85 # define CHUNK_ID_VERS 0x73726576 86 # define CHUNK_ID_DLID 0x64696C64 87 # define CHUNK_ID_FMT 0x20746D66 88 # define CHUNK_ID_DATA 0x61746164 89 # define CHUNK_ID_INSH 0x68736E69 90 # define CHUNK_ID_RGNH 0x686E6772 91 # define CHUNK_ID_WLNK 0x6B6E6C77 92 # define CHUNK_ID_PTBL 0x6C627470 93 # define CHUNK_ID_WSMP 0x706D7377 94 # define CHUNK_ID_COLH 0x686C6F63 95 # define CHUNK_ID_ARTL 0x6C747261 96 # define CHUNK_ID_ART2 0x32747261 97 #endif // WORDS_BIGENDIAN 99 #define DLS_WAVE_FORMAT_PCM 0x0001 209 inline bool operator< (
const range_t& other)
const {
210 if (low < other.
low)
return true;
211 if (low > other.
low)
return false;
212 return high < other.
high;
215 inline bool operator== (
const range_t& other)
const {
216 return low == other.
low && high == other.
high;
220 return low <= scalar && scalar <= high;
224 return overlaps(other.
low) || overlaps(other.
high) ||
280 virtual void UpdateChunks(progress_t* pProgress);
292 virtual void UpdateChunks(progress_t* pProgress);
300 void LoadArticulations();
334 virtual void UpdateChunks(progress_t* pProgress);
335 virtual void CopyAssign(
const Info* orig);
341 void SaveString(uint32_t ChunkID,
RIFF::List* lstINFO,
const String& s,
const String& sDefault);
352 virtual void UpdateChunks(progress_t* pProgress);
353 void GenerateDLSID();
354 virtual void CopyAssign(
const Resource* orig);
376 virtual void SetGain(int32_t gain);
377 virtual void UpdateChunks(progress_t* pProgress);
378 virtual void CopyAssign(
const Sampler* orig);
406 void* LoadSampleData();
407 void ReleaseSampleData();
408 unsigned long GetSize()
const;
409 void Resize(
int iNewSize);
411 unsigned long Read(
void* pBuffer,
unsigned long SampleCount);
412 unsigned long Write(
void* pBuffer,
unsigned long SampleCount);
413 virtual void UpdateChunks(progress_t* pProgress);
414 virtual void CopyAssign(
const Sample* orig);
423 void CopyAssignCore(
const Sample* orig);
442 void SetSample(
Sample* pSample);
443 virtual void SetKeyRange(uint16_t Low, uint16_t High);
444 virtual void UpdateChunks(progress_t* pProgress);
445 virtual void CopyAssign(
const Region* orig);
471 void DeleteRegion(
Region* pRegion);
472 virtual void UpdateChunks(progress_t* pProgress);
473 virtual void CopyAssign(
const Instrument* orig);
487 virtual void LoadRegions();
503 String GetFileName();
504 void SetFileName(
const String& name);
508 void DeleteSample(
Sample* pSample);
512 void DeleteInstrument(
Instrument* pInstrument);
514 virtual void UpdateChunks(progress_t* pProgress);
515 virtual void Save(
const String& Path, progress_t* pProgress = NULL);
516 virtual void Save(progress_t* pProgress = NULL);
534 virtual void LoadSamples();
535 virtual void LoadInstruments();
536 virtual void UpdateFileOffsets();
537 void __ensureMandatoryChunksExist();
540 void __UpdateWavePoolTableChunk();
541 void __UpdateWavePoolTable();
ArticulationList * pArticulations
uint16_t BlockAlign
The block alignment (in bytes) of the waveform data. Playback software needs to process a multiple of...
sample_loop_t * pSampleLoops
Points to the beginning of a sample loop array, or is NULL if there are no loops defined.
uint32_t Regions
Reflects the number of Region defintions this Instrument has.
Parses DLS Level 1 and 2 compliant files and provides abstract access to the data.
stream_whence_t
File stream position dependent to these relations.
String CreationDate
<ICRD-ck>. Specifies the date the subject of the file was created. List dates in yyyy-mm-dd format...
uint32_t LoopType
Defines how the waveform samples will be looped (appropriate loop types for the gig format are define...
ArticulationList::iterator ArticulationsIterator
String Engineer
<IENG-ck>. Stores the name of the engineer who worked on the file. Multiple engineer names are separa...
String Artists
<IART-ck>. Lists the artist of the original subject of the file.
Will be thrown whenever a DLS specific error occurs while trying to access a DLS File.
conn_trn_t SourceTransform
Optional information for DLS files, instruments, samples, etc.
const Resource * GetParent() const
String Keywords
<IKEY-ck>. Provides a list of keywords that refer to the file or subject of the file. Keywords are separated with semicolon and blank, e.g., FX; death; murder.
std::list< Articulation * > ArticulationList
conn_src_t
Connection Sources.
uint32_t * pWavePoolTable
uint32_t WavePoolTableIndex
uint16_t Channels
Number of channels represented in the waveform data, e.g. 1 for mono, 2 for stereo (defaults to 1=mon...
RIFF::List * pCkInstrument
String SourceForm
<ISRF-ck>. Identifies the original form of the material that was digitized, such as record...
Defines Sample Loop Points.
RIFF::List * pResourceList
uint16_t MIDIBank
Reflects combination of MIDIBankCoarse and MIDIBankFine (bank 1 - bank 16384). Do not change this val...
void LoadString(RIFF::Chunk *ck, std::string &s, int strLength)
std::list< Sample * > SampleList
InstrumentList::iterator InstrumentsIterator
uint8_t MIDIBankCoarse
Reflects the MIDI Bank number for MIDI Control Change 0 (bank 1 - 128).
uint FrameSize
Reflects the size (in bytes) of one single sample point (only if known sample data format is used...
Every subject of an DLS file and the file itself can have an unique, computer generated ID...
bool overlaps(uint16_t scalar) const
Lower and upper limit of a range.
uint16_t low
Low value of range.
bool b64BitWavePoolOffsets
uint16_t FormatTag
Format ID of the waveform data (should be DLS_WAVE_FORMAT_PCM for DLS1 compliant files, this is also the default value if Sample was created with Instrument::AddSample()).
Abstract base class which provides mandatory informations about sample players in general...
String libraryName()
Returns the name of this C++ library.
conn_trn_t
Connection Transforms.
uint32_t SampleLoops
Reflects the number of sample loops.
conn_trn_t DestinationTransform
conn_dst_t
Connection Destinations.
bool NoSampleDepthTruncation
uint16_t high
High value of range.
uint32_t Size
For internal usage only: usually reflects exactly sizeof(sample_loop_t), otherwise if the value is la...
std::list< Instrument * > InstrumentList
unsigned long SamplesTotal
Reflects total number of sample points (only if known sample data format is used, 0 otherwise)...
String Source
<ISRC-ck>. Identifies the name of the person or organization who supplied the original subject of the...
uint16_t BitDepth
Size of each sample per channel (only if known sample data format is used, 0 otherwise).
uint32_t MIDIProgram
Specifies the MIDI Program Change Number this Instrument should be assigned to.
String Commissioned
<ICMS-ck>. Lists the name of the person or organization that commissioned the subject of the file...
uint32_t LoopLength
Length of the looping area (in sample points).
Used for indicating the progress of a certain task.
SampleList::iterator SamplesIterator
uint16_t WaveLinkOptionFlags
version_t * pVersion
Points to a version_t structure if the file provided a version number else is set to NULL...
String Technician
<ITCH-ck>. Identifies the technician who sampled the subject file.
uint32_t LoopStart
The start value specifies the offset (in sample points) in the waveform data of the first sample poin...
RegionList::iterator RegionsIterator
RIFF::Chunk * pArticulationCk
uint32_t AverageBytesPerSecond
The average number of bytes per second at which the waveform data should be transferred (Playback sof...
uint8_t MIDIBankFine
Reflects the MIDI Bank number for MIDI Control Change 32 (bank 1 - 128).
uint32_t WavePoolHeaderSize
Abstract base class which encapsulates data structures which all DLS resources are able to provide...
InstrumentList * pInstruments
String Software
<ISFT-ck>. Identifies the name of the sofware package used to create the file.
String ArchivalLocation
<IARL-ck>. Indicates where the subject of the file is stored.
unsigned long ulWavePoolOffset
Encapsulates sample waves used for playback.
String Name
<INAM-ck>. Stores the title of the subject of the file, such as, Seattle From Above.
uint32_t SamplesPerSecond
Sampling rate at which each channel should be played (defaults to 44100 if Sample was created with In...
String Product
<IPRD-ck>. Specifies the name of the title the file was originally intended for, such as World Ruler ...
String Medium
<IMED-ck>. Describes the original subject of the file, such as, record, CD, and so forth...
String Subject
<ISBJ-ck>. Describes the contents of the file.
bool overlaps(const range_t &other) const
Will be thrown whenever an error occurs while handling a RIFF file.
Abstract base class for classes that provide articulation information (thus for Instrument and Region...
Connection * pConnections
Points to the beginning of a Connection array.
uint32_t Connections
Reflects the number of Connections.
conn_trn_t ControlTransform
Provides access to the defined connections used for the synthesis model.
dlsid_t * pDLSID
Points to a dlsid_t structure if the file provided a DLS ID else is NULL.
uint32_t Instruments
Reflects the number of available Instrument objects.
String Genre
<IGNR-ck>. Descirbes the original work, such as, Jazz, Classic, Rock, Techno, Rave, etc.
Provides all neccessary information for the synthesis of a DLS Instrument.
Quadtuple version number ("major.minor.release.build").
String Copyright
<ICOP-ck>. Records the copyright information for the file.
DLS specific classes and definitions.
Info * pInfo
Points (in any case) to an Info object, providing additional, optional infos and comments.
String libraryVersion()
Returns version of this C++ library.
Defines a connection within the synthesis model.
uint16_t FormatOptionFlags
bool UseFixedLengthStrings
uint32_t * pWavePoolTableHi
String Comments
<ICMT-ck>. Provides general comments about the file or the subject of the file. Sentences might end w...
Defines Region information of an Instrument.
std::list< RIFF::File * > ExtensionFiles
bool IsDrum
Indicates if the Instrument is a drum type, as they differ in the synthesis model of DLS from melodic...
std::list< Region * > RegionList
RIFF::progress_t progress_t