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 210 inline bool operator< (
const range_t& other)
const {
211 if (low < other.
low)
return true;
212 if (low > other.
low)
return false;
213 return high < other.
high;
216 inline bool operator== (
const range_t& other)
const {
217 return low == other.
low && high == other.
high;
221 return low <= scalar && scalar <= high;
225 return overlaps(other.
low) || overlaps(other.
high) ||
281 virtual void UpdateChunks(progress_t* pProgress);
293 virtual void UpdateChunks(progress_t* pProgress);
301 void LoadArticulations();
335 virtual void UpdateChunks(progress_t* pProgress);
336 virtual void CopyAssign(
const Info* orig);
342 void SaveString(uint32_t ChunkID,
RIFF::List* lstINFO,
const String& s,
const String& sDefault);
353 virtual void UpdateChunks(progress_t* pProgress);
354 void GenerateDLSID();
355 virtual void CopyAssign(
const Resource* orig);
377 virtual void SetGain(int32_t gain);
378 virtual void UpdateChunks(progress_t* pProgress);
379 virtual void CopyAssign(
const Sampler* orig);
407 void* LoadSampleData();
408 void ReleaseSampleData();
409 file_offset_t GetSize()
const;
410 void Resize(file_offset_t NewSize);
412 file_offset_t Read(
void* pBuffer, file_offset_t SampleCount);
413 file_offset_t Write(
void* pBuffer, file_offset_t SampleCount);
414 virtual void UpdateChunks(progress_t* pProgress);
415 virtual void CopyAssign(
const Sample* orig);
425 void CopyAssignCore(
const Sample* orig);
444 void SetSample(
Sample* pSample);
445 virtual void SetKeyRange(uint16_t Low, uint16_t High);
446 virtual void UpdateChunks(progress_t* pProgress);
447 virtual void CopyAssign(
const Region* orig);
473 void DeleteRegion(
Region* pRegion);
474 virtual void UpdateChunks(progress_t* pProgress);
475 virtual void CopyAssign(
const Instrument* orig);
489 virtual void LoadRegions();
505 String GetFileName();
506 void SetFileName(
const String& name);
510 void DeleteSample(
Sample* pSample);
514 void DeleteInstrument(
Instrument* pInstrument);
516 virtual void UpdateChunks(progress_t* pProgress);
517 virtual void Save(
const String& Path, progress_t* pProgress = NULL);
518 virtual void Save(progress_t* pProgress = NULL);
536 virtual void LoadSamples();
537 virtual void LoadInstruments();
538 virtual void UpdateFileOffsets();
539 void __ensureMandatoryChunksExist();
542 void __UpdateWavePoolTableChunk();
543 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.
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.
file_offset_t ullWavePoolOffset
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
file_offset_t SamplesTotal
Reflects total number of sample points (only if known sample data format is used, 0 otherwise)...
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...
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
bool overlaps(uint16_t scalar) const
uint16_t high
High value of range.
uint64_t file_offset_t
Type used by libgig for handling file positioning during file I/O tasks.
uint32_t Size
For internal usage only: usually reflects exactly sizeof(sample_loop_t), otherwise if the value is la...
std::list< Instrument * > InstrumentList
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).
bool overlaps(const range_t &other) const
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.
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.
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
const Resource * GetParent() const
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.
RIFF::file_offset_t file_offset_t
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