225 |
dimension_channelaftertouch = 0x83, ///< Channel Key Pressure |
dimension_channelaftertouch = 0x83, ///< Channel Key Pressure |
226 |
dimension_releasetrigger = 0x84, ///< Special dimension for triggering samples on releasing a key. |
dimension_releasetrigger = 0x84, ///< Special dimension for triggering samples on releasing a key. |
227 |
dimension_keyboard = 0x85, ///< Dimension for keyswitching |
dimension_keyboard = 0x85, ///< Dimension for keyswitching |
228 |
|
dimension_roundrobin = 0x86, ///< Different samples triggered each time a note is played, dimension regions selected in sequence |
229 |
|
dimension_random = 0x87, ///< Different samples triggered each time a note is played, random order |
230 |
dimension_modwheel = 0x01, ///< Modulation Wheel (MIDI Controller 1) |
dimension_modwheel = 0x01, ///< Modulation Wheel (MIDI Controller 1) |
231 |
dimension_breath = 0x02, ///< Breath Controller (Coarse, MIDI Controller 2) |
dimension_breath = 0x02, ///< Breath Controller (Coarse, MIDI Controller 2) |
232 |
dimension_foot = 0x04, ///< Foot Pedal (Coarse, MIDI Controller 4) |
dimension_foot = 0x04, ///< Foot Pedal (Coarse, MIDI Controller 4) |
309 |
unsigned long loop_cycles_left; ///< How many times the loop has still to be passed, this value will be decremented with each loop cycle. |
unsigned long loop_cycles_left; ///< How many times the loop has still to be passed, this value will be decremented with each loop cycle. |
310 |
}; |
}; |
311 |
|
|
312 |
|
/** |
313 |
|
* @brief Used for indicating the progress of a certain task. |
314 |
|
* |
315 |
|
* The function pointer argument has to be supplied with a valid |
316 |
|
* function of the given signature which will then be called on |
317 |
|
* progress changes. An equivalent progress_t structure will be passed |
318 |
|
* back as argument to the callback function on each progress change. |
319 |
|
* The factor field of the supplied progress_t structure will then |
320 |
|
* reflect the current progress as value between 0.0 and 1.0. You might |
321 |
|
* want to use the custom field for data needed in your callback |
322 |
|
* function. |
323 |
|
*/ |
324 |
|
struct progress_t { |
325 |
|
void (*callback)(progress_t*); ///< Callback function pointer which has to be assigned to a function for progress notification. |
326 |
|
float factor; ///< Reflects current progress as value between 0.0 and 1.0. |
327 |
|
void* custom; ///< This pointer can be used for arbitrary data. |
328 |
|
float __range_min; ///< Only for internal usage, do not modify! |
329 |
|
float __range_max; ///< Only for internal usage, do not modify! |
330 |
|
progress_t(); |
331 |
|
}; |
332 |
|
|
333 |
// just symbol prototyping |
// just symbol prototyping |
334 |
class File; |
class File; |
335 |
class Instrument; |
class Instrument; |
403 |
bool VCFEnabled; ///< If filter should be used. |
bool VCFEnabled; ///< If filter should be used. |
404 |
vcf_type_t VCFType; ///< Defines the general filter characteristic (lowpass, highpass, bandpass, etc.). |
vcf_type_t VCFType; ///< Defines the general filter characteristic (lowpass, highpass, bandpass, etc.). |
405 |
vcf_cutoff_ctrl_t VCFCutoffController; ///< Specifies which external controller has influence on the filter cutoff frequency. |
vcf_cutoff_ctrl_t VCFCutoffController; ///< Specifies which external controller has influence on the filter cutoff frequency. |
406 |
|
bool VCFCutoffControllerInvert; ///< Inverts values coming from the defined cutoff controller |
407 |
uint8_t VCFCutoff; ///< Max. cutoff frequency. |
uint8_t VCFCutoff; ///< Max. cutoff frequency. |
408 |
curve_type_t VCFVelocityCurve; ///< Defines a transformation curve for the incoming velocity values, affecting the VCF. |
curve_type_t VCFVelocityCurve; ///< Defines a transformation curve for the incoming velocity values, affecting the VCF. |
409 |
uint8_t VCFVelocityScale; ///< (0-127) Amount velocity controls VCF cutoff frequency (only if no other VCF cutoff controller is defined). |
uint8_t VCFVelocityScale; ///< (0-127) Amount velocity controls VCF cutoff frequency (only if no other VCF cutoff controller is defined, otherwise this is the minimum cutoff). |
410 |
uint8_t VCFVelocityDynamicRange; ///< 0x04 = lowest, 0x00 = highest |
uint8_t VCFVelocityDynamicRange; ///< 0x04 = lowest, 0x00 = highest |
411 |
uint8_t VCFResonance; ///< Firm internal filter resonance weight. |
uint8_t VCFResonance; ///< Firm internal filter resonance weight. |
412 |
bool VCFResonanceDynamic; ///< If <i>true</i>: Increases the resonance Q according to changes of controllers that actually control the VCF cutoff frequency (EG2, ext. VCF MIDI controller). |
bool VCFResonanceDynamic; ///< If <i>true</i>: Increases the resonance Q according to changes of controllers that actually control the VCF cutoff frequency (EG2, ext. VCF MIDI controller). |
433 |
bool SustainDefeat; ///< If <i>true</i>: Sustain pedal will not hold a note. |
bool SustainDefeat; ///< If <i>true</i>: Sustain pedal will not hold a note. |
434 |
bool MSDecode; ///< Gigastudio flag: defines if Mid Side Recordings should be decoded. |
bool MSDecode; ///< Gigastudio flag: defines if Mid Side Recordings should be decoded. |
435 |
uint16_t SampleStartOffset; ///< Number of samples the sample start should be moved (0 - 2000). |
uint16_t SampleStartOffset; ///< Number of samples the sample start should be moved (0 - 2000). |
436 |
|
double SampleAttenuation; ///< Sample volume (calculated from DLS::Sampler::Gain) |
437 |
|
|
438 |
// derived attributes from DLS::Sampler |
// derived attributes from DLS::Sampler |
439 |
DLS::Sampler::UnityNote; |
DLS::Sampler::UnityNote; |
440 |
DLS::Sampler::FineTune; |
DLS::Sampler::FineTune; |
444 |
|
|
445 |
// Methods |
// Methods |
446 |
double GetVelocityAttenuation(uint8_t MIDIKeyVelocity); |
double GetVelocityAttenuation(uint8_t MIDIKeyVelocity); |
447 |
|
double GetVelocityRelease(uint8_t MIDIKeyVelocity); |
448 |
|
double GetVelocityCutoff(uint8_t MIDIKeyVelocity); |
449 |
|
|
450 |
protected: |
protected: |
451 |
DimensionRegion(RIFF::List* _3ewl); |
DimensionRegion(RIFF::List* _3ewl); |
452 |
~DimensionRegion(); |
~DimensionRegion(); |
485 |
static uint Instances; ///< Number of DimensionRegion instances. |
static uint Instances; ///< Number of DimensionRegion instances. |
486 |
static VelocityTableMap* pVelocityTables; ///< Contains the tables corresponding to the various velocity parameters (VelocityResponseCurve and VelocityResponseDepth). |
static VelocityTableMap* pVelocityTables; ///< Contains the tables corresponding to the various velocity parameters (VelocityResponseCurve and VelocityResponseDepth). |
487 |
double* pVelocityAttenuationTable; ///< Points to the velocity table corresponding to the velocity parameters of this DimensionRegion. |
double* pVelocityAttenuationTable; ///< Points to the velocity table corresponding to the velocity parameters of this DimensionRegion. |
488 |
|
double* pVelocityReleaseTable; ///< Points to the velocity table corresponding to the release velocity parameters of this DimensionRegion |
489 |
|
double* pVelocityCutoffTable; ///< Points to the velocity table corresponding to the filter velocity parameters of this DimensionRegion |
490 |
|
|
491 |
leverage_ctrl_t DecodeLeverageController(_lev_ctrl_t EncodedController); |
leverage_ctrl_t DecodeLeverageController(_lev_ctrl_t EncodedController); |
492 |
|
double* GetVelocityTable(curve_type_t curveType, uint8_t depth, uint8_t scaling); |
493 |
double* CreateVelocityTable(curve_type_t curveType, uint8_t depth, uint8_t scaling); |
double* CreateVelocityTable(curve_type_t curveType, uint8_t depth, uint8_t scaling); |
494 |
}; |
}; |
495 |
|
|
513 |
uint32_t LoopFraction; ///< The fractional value specifies a fraction of a sample at which to loop (only if Loops > 0). This allows a loop to be fine tuned at a resolution greater than one sample. A value of 0 means no fraction, a value of 0x80000000 means 1/2 of a sample length. 0xFFFFFFFF is the smallest fraction of a sample that can be represented. |
uint32_t LoopFraction; ///< The fractional value specifies a fraction of a sample at which to loop (only if Loops > 0). This allows a loop to be fine tuned at a resolution greater than one sample. A value of 0 means no fraction, a value of 0x80000000 means 1/2 of a sample length. 0xFFFFFFFF is the smallest fraction of a sample that can be represented. |
514 |
uint32_t LoopPlayCount; ///< Number of times the loop should be played (only if Loops > 0, a value of 0 = infinite). |
uint32_t LoopPlayCount; ///< Number of times the loop should be played (only if Loops > 0, a value of 0 = infinite). |
515 |
bool Compressed; ///< If the sample wave is compressed (probably just interesting for instrument and sample editors, as this library already handles the decompression in it's sample access methods anyway). |
bool Compressed; ///< If the sample wave is compressed (probably just interesting for instrument and sample editors, as this library already handles the decompression in it's sample access methods anyway). |
516 |
|
uint32_t TruncatedBits; ///< For 24-bit compressed samples only: number of bits truncated during compression (0, 4 or 6) |
517 |
|
bool Dithered; ///< For 24-bit compressed samples only: if dithering was used during compression with bit reduction |
518 |
|
|
519 |
// own methods |
// own methods |
520 |
buffer_t LoadSampleData(); |
buffer_t LoadSampleData(); |
541 |
unsigned long WorstCaseFrameSize; ///< For compressed samples only: size (in bytes) of the largest possible sample frame. |
unsigned long WorstCaseFrameSize; ///< For compressed samples only: size (in bytes) of the largest possible sample frame. |
542 |
unsigned long SamplesPerFrame; ///< For compressed samples only: number of samples in a full sample frame. |
unsigned long SamplesPerFrame; ///< For compressed samples only: number of samples in a full sample frame. |
543 |
buffer_t RAMCache; ///< Buffers samples (already uncompressed) in RAM. |
buffer_t RAMCache; ///< Buffers samples (already uncompressed) in RAM. |
544 |
|
unsigned long FileNo; ///< File number (> 0 when sample is stored in an extension file, 0 when it's in the gig) |
545 |
|
|
546 |
Sample(File* pFile, RIFF::List* waveList, unsigned long WavePoolOffset); |
Sample(File* pFile, RIFF::List* waveList, unsigned long WavePoolOffset, unsigned long fileNo = 0); |
547 |
~Sample(); |
~Sample(); |
548 |
/** |
/** |
549 |
* Swaps the order of the data words in the given memory area |
* Swaps the order of the data words in the given memory area |
651 |
|
|
652 |
Region(Instrument* pInstrument, RIFF::List* rgnList); |
Region(Instrument* pInstrument, RIFF::List* rgnList); |
653 |
void LoadDimensionRegions(RIFF::List* rgn); |
void LoadDimensionRegions(RIFF::List* rgn); |
654 |
Sample* GetSampleFromWavePool(unsigned int WavePoolTableIndex); |
Sample* GetSampleFromWavePool(unsigned int WavePoolTableIndex, progress_t* pProgress = NULL); |
655 |
~Region(); |
~Region(); |
656 |
friend class Instrument; |
friend class Instrument; |
657 |
}; |
}; |
690 |
Region* RegionKeyTable[128]; ///< fast lookup for the corresponding Region of a MIDI key |
Region* RegionKeyTable[128]; ///< fast lookup for the corresponding Region of a MIDI key |
691 |
int RegionIndex; |
int RegionIndex; |
692 |
|
|
693 |
Instrument(File* pFile, RIFF::List* insList); |
Instrument(File* pFile, RIFF::List* insList, progress_t* pProgress = NULL); |
694 |
~Instrument(); |
~Instrument(); |
695 |
friend class File; |
friend class File; |
696 |
}; |
}; |
710 |
DLS::Resource::GetParent; |
DLS::Resource::GetParent; |
711 |
// overridden methods |
// overridden methods |
712 |
File(RIFF::File* pRIFF); |
File(RIFF::File* pRIFF); |
713 |
Sample* GetFirstSample(); ///< Returns a pointer to the first <i>Sample</i> object of the file, <i>NULL</i> otherwise. |
Sample* GetFirstSample(progress_t* pProgress = NULL); ///< Returns a pointer to the first <i>Sample</i> object of the file, <i>NULL</i> otherwise. |
714 |
Sample* GetNextSample(); ///< Returns a pointer to the next <i>Sample</i> object of the file, <i>NULL</i> otherwise. |
Sample* GetNextSample(); ///< Returns a pointer to the next <i>Sample</i> object of the file, <i>NULL</i> otherwise. |
715 |
Instrument* GetFirstInstrument(); ///< Returns a pointer to the first <i>Instrument</i> object of the file, <i>NULL</i> otherwise. |
Instrument* GetFirstInstrument(); ///< Returns a pointer to the first <i>Instrument</i> object of the file, <i>NULL</i> otherwise. |
716 |
Instrument* GetNextInstrument(); ///< Returns a pointer to the next <i>Instrument</i> object of the file, <i>NULL</i> otherwise. |
Instrument* GetNextInstrument(); ///< Returns a pointer to the next <i>Instrument</i> object of the file, <i>NULL</i> otherwise. |
717 |
Instrument* GetInstrument(uint index); |
Instrument* GetInstrument(uint index, progress_t* pProgress = NULL); |
718 |
~File(); |
~File(); |
719 |
protected: |
protected: |
720 |
typedef std::list<Sample*> SampleList; |
typedef std::list<Sample*> SampleList; |
725 |
InstrumentList* pInstruments; |
InstrumentList* pInstruments; |
726 |
InstrumentList::iterator InstrumentsIterator; |
InstrumentList::iterator InstrumentsIterator; |
727 |
|
|
728 |
void LoadSamples(); |
void LoadSamples(progress_t* pProgress = NULL); |
729 |
void LoadInstruments(); |
void LoadInstruments(progress_t* pProgress = NULL); |
730 |
friend class Region; |
friend class Region; |
731 |
|
|
732 |
|
std::list<RIFF::File*> ExtensionFiles; |
733 |
}; |
}; |
734 |
|
|
735 |
/** Will be thrown whenever a gig specific error occurs while trying to access a Gigasampler File. */ |
/** Will be thrown whenever a gig specific error occurs while trying to access a Gigasampler File. */ |
739 |
void PrintMessage(); |
void PrintMessage(); |
740 |
}; |
}; |
741 |
|
|
742 |
|
String libraryName(); |
743 |
|
String libraryVersion(); |
744 |
|
|
745 |
} // namespace gig |
} // namespace gig |
746 |
|
|
747 |
#endif // __GIG_H__ |
#endif // __GIG_H__ |