2 |
* * |
* * |
3 |
* libgig - C++ cross-platform Gigasampler format file access library * |
* libgig - C++ cross-platform Gigasampler format file access library * |
4 |
* * |
* * |
5 |
* Copyright (C) 2003-2006 by Christian Schoenebeck * |
* Copyright (C) 2003-2007 by Christian Schoenebeck * |
6 |
* <cuse@users.sourceforge.net> * |
* <cuse@users.sourceforge.net> * |
7 |
* * |
* * |
8 |
* This library is free software; you can redistribute it and/or modify * |
* This library is free software; you can redistribute it and/or modify * |
364 |
* Usually there is absolutely no need to call this method explicitly. |
* Usually there is absolutely no need to call this method explicitly. |
365 |
* It will be called automatically when File::Save() was called. |
* It will be called automatically when File::Save() was called. |
366 |
* |
* |
367 |
* @throws DLS::Exception if FormatTag != WAVE_FORMAT_PCM or no sample data |
* @throws DLS::Exception if FormatTag != DLS_WAVE_FORMAT_PCM or no sample data |
368 |
* was provided yet |
* was provided yet |
369 |
* @throws gig::Exception if there is any invalid sample setting |
* @throws gig::Exception if there is any invalid sample setting |
370 |
*/ |
*/ |
635 |
* enlarged samples before calling File::Save() as this might exceed the |
* enlarged samples before calling File::Save() as this might exceed the |
636 |
* current sample's boundary! |
* current sample's boundary! |
637 |
* |
* |
638 |
* Also note: only WAVE_FORMAT_PCM is currently supported, that is |
* Also note: only DLS_WAVE_FORMAT_PCM is currently supported, that is |
639 |
* FormatTag must be WAVE_FORMAT_PCM. Trying to resize samples with |
* FormatTag must be DLS_WAVE_FORMAT_PCM. Trying to resize samples with |
640 |
* other formats will fail! |
* other formats will fail! |
641 |
* |
* |
642 |
* @param iNewSize - new sample wave data size in sample points (must be |
* @param iNewSize - new sample wave data size in sample points (must be |
643 |
* greater than zero) |
* greater than zero) |
644 |
* @throws DLS::Excecption if FormatTag != WAVE_FORMAT_PCM |
* @throws DLS::Excecption if FormatTag != DLS_WAVE_FORMAT_PCM |
645 |
* or if \a iNewSize is less than 1 |
* or if \a iNewSize is less than 1 |
646 |
* @throws gig::Exception if existing sample is compressed |
* @throws gig::Exception if existing sample is compressed |
647 |
* @see DLS::Sample::GetSize(), DLS::Sample::FrameSize, |
* @see DLS::Sample::GetSize(), DLS::Sample::FrameSize, |
1338 |
if (lfo3ctrl & 0x40) // bit 6 |
if (lfo3ctrl & 0x40) // bit 6 |
1339 |
VCFType = vcf_type_lowpassturbo; |
VCFType = vcf_type_lowpassturbo; |
1340 |
} |
} |
1341 |
|
if (_3ewa->RemainingBytes() >= 8) { |
1342 |
|
_3ewa->Read(DimensionUpperLimits, 1, 8); |
1343 |
|
} else { |
1344 |
|
memset(DimensionUpperLimits, 0, 8); |
1345 |
|
} |
1346 |
} else { // '3ewa' chunk does not exist yet |
} else { // '3ewa' chunk does not exist yet |
1347 |
// use default values |
// use default values |
1348 |
LFO3Frequency = 1.0; |
LFO3Frequency = 1.0; |
1423 |
VCFVelocityDynamicRange = 0x04; |
VCFVelocityDynamicRange = 0x04; |
1424 |
VCFVelocityCurve = curve_type_linear; |
VCFVelocityCurve = curve_type_linear; |
1425 |
VCFType = vcf_type_lowpass; |
VCFType = vcf_type_lowpass; |
1426 |
|
memset(DimensionUpperLimits, 0, 8); |
1427 |
} |
} |
1428 |
|
|
1429 |
pVelocityAttenuationTable = GetVelocityTable(VelocityResponseCurve, |
pVelocityAttenuationTable = GetVelocityTable(VelocityResponseCurve, |
1479 |
|
|
1480 |
// update '3ewa' chunk with DimensionRegion's current settings |
// update '3ewa' chunk with DimensionRegion's current settings |
1481 |
|
|
1482 |
const uint32_t unknown = _3ewa->GetSize(); // unknown, always chunk size ? |
const uint32_t chunksize = _3ewa->GetSize(); |
1483 |
memcpy(&pData[0], &unknown, 4); |
memcpy(&pData[0], &chunksize, 4); // unknown, always chunk size? |
1484 |
|
|
1485 |
const int32_t lfo3freq = (int32_t) GIG_EXP_ENCODE(LFO3Frequency); |
const int32_t lfo3freq = (int32_t) GIG_EXP_ENCODE(LFO3Frequency); |
1486 |
memcpy(&pData[4], &lfo3freq, 4); |
memcpy(&pData[4], &lfo3freq, 4); |
1735 |
|
|
1736 |
const uint8_t vcftype = (VCFType == vcf_type_lowpassturbo) ? vcf_type_lowpass : VCFType; |
const uint8_t vcftype = (VCFType == vcf_type_lowpassturbo) ? vcf_type_lowpass : VCFType; |
1737 |
memcpy(&pData[139], &vcftype, 1); |
memcpy(&pData[139], &vcftype, 1); |
1738 |
|
|
1739 |
|
if (chunksize >= 148) { |
1740 |
|
memcpy(&pData[140], DimensionUpperLimits, 8); |
1741 |
|
} |
1742 |
} |
} |
1743 |
|
|
1744 |
// get the corresponding velocity table from the table map or create & calculate that table if it doesn't exist yet |
// get the corresponding velocity table from the table map or create & calculate that table if it doesn't exist yet |
2120 |
dimension == dimension_releasetrigger || |
dimension == dimension_releasetrigger || |
2121 |
dimension == dimension_keyboard || |
dimension == dimension_keyboard || |
2122 |
dimension == dimension_roundrobin || |
dimension == dimension_roundrobin || |
2123 |
dimension == dimension_random) ? split_type_bit |
dimension == dimension_random || |
2124 |
: split_type_normal; |
dimension == dimension_smartmidi || |
2125 |
|
dimension == dimension_roundrobinkeyboard) ? split_type_bit |
2126 |
|
: split_type_normal; |
2127 |
pDimensionDefinitions[i].zone_size = |
pDimensionDefinitions[i].zone_size = |
2128 |
(pDimensionDefinitions[i].split_type == split_type_normal) ? 128.0 / pDimensionDefinitions[i].zones |
(pDimensionDefinitions[i].split_type == split_type_normal) ? 128.0 / pDimensionDefinitions[i].zones |
2129 |
: 0; |
: 0; |
2152 |
if (file->pWavePoolTable) pDimensionRegions[i]->pSample = GetSampleFromWavePool(wavepoolindex); |
if (file->pWavePoolTable) pDimensionRegions[i]->pSample = GetSampleFromWavePool(wavepoolindex); |
2153 |
} |
} |
2154 |
GetSample(); // load global region sample reference |
GetSample(); // load global region sample reference |
2155 |
|
} else { |
2156 |
|
DimensionRegions = 0; |
2157 |
} |
} |
2158 |
|
|
2159 |
// make sure there is at least one dimension region |
// make sure there is at least one dimension region |
2176 |
* @throws gig::Exception if samples cannot be dereferenced |
* @throws gig::Exception if samples cannot be dereferenced |
2177 |
*/ |
*/ |
2178 |
void Region::UpdateChunks() { |
void Region::UpdateChunks() { |
2179 |
|
// in the gig format we don't care about the Region's sample reference |
2180 |
|
// but we still have to provide some existing one to not corrupt the |
2181 |
|
// file, so to avoid the latter we simply always assign the sample of |
2182 |
|
// the first dimension region of this region |
2183 |
|
pSample = pDimensionRegions[0]->pSample; |
2184 |
|
|
2185 |
// first update base class's chunks |
// first update base class's chunks |
2186 |
DLS::Region::UpdateChunks(); |
DLS::Region::UpdateChunks(); |
2187 |
|
|
2268 |
int dim[8] = { 0 }; |
int dim[8] = { 0 }; |
2269 |
for (int i = 0 ; i < DimensionRegions ; i++) { |
for (int i = 0 ; i < DimensionRegions ; i++) { |
2270 |
|
|
2271 |
if (pDimensionRegions[i]->VelocityUpperLimit) { |
if (pDimensionRegions[i]->DimensionUpperLimits[veldim] || |
2272 |
|
pDimensionRegions[i]->VelocityUpperLimit) { |
2273 |
// create the velocity table |
// create the velocity table |
2274 |
uint8_t* table = pDimensionRegions[i]->VelocityTable; |
uint8_t* table = pDimensionRegions[i]->VelocityTable; |
2275 |
if (!table) { |
if (!table) { |
2278 |
} |
} |
2279 |
int tableidx = 0; |
int tableidx = 0; |
2280 |
int velocityZone = 0; |
int velocityZone = 0; |
2281 |
for (int k = i ; k < end ; k += step) { |
if (pDimensionRegions[i]->DimensionUpperLimits[veldim]) { // gig3 |
2282 |
DimensionRegion *d = pDimensionRegions[k]; |
for (int k = i ; k < end ; k += step) { |
2283 |
for (; tableidx <= d->VelocityUpperLimit ; tableidx++) table[tableidx] = velocityZone; |
DimensionRegion *d = pDimensionRegions[k]; |
2284 |
velocityZone++; |
for (; tableidx <= d->DimensionUpperLimits[veldim] ; tableidx++) table[tableidx] = velocityZone; |
2285 |
|
velocityZone++; |
2286 |
|
} |
2287 |
|
} else { // gig2 |
2288 |
|
for (int k = i ; k < end ; k += step) { |
2289 |
|
DimensionRegion *d = pDimensionRegions[k]; |
2290 |
|
for (; tableidx <= d->VelocityUpperLimit ; tableidx++) table[tableidx] = velocityZone; |
2291 |
|
velocityZone++; |
2292 |
|
} |
2293 |
} |
} |
2294 |
} else { |
} else { |
2295 |
if (pDimensionRegions[i]->VelocityTable) { |
if (pDimensionRegions[i]->VelocityTable) { |
2484 |
} else { |
} else { |
2485 |
switch (pDimensionDefinitions[i].split_type) { |
switch (pDimensionDefinitions[i].split_type) { |
2486 |
case split_type_normal: |
case split_type_normal: |
2487 |
bits = uint8_t(DimValues[i] / pDimensionDefinitions[i].zone_size); |
if (pDimensionRegions[0]->DimensionUpperLimits[i]) { |
2488 |
|
// gig3: all normal dimensions (not just the velocity dimension) have custom zone ranges |
2489 |
|
for (bits = 0 ; bits < pDimensionDefinitions[i].zones ; bits++) { |
2490 |
|
if (DimValues[i] <= pDimensionRegions[bits << bitpos]->DimensionUpperLimits[i]) break; |
2491 |
|
} |
2492 |
|
} else { |
2493 |
|
// gig2: evenly sized zones |
2494 |
|
bits = uint8_t(DimValues[i] / pDimensionDefinitions[i].zone_size); |
2495 |
|
} |
2496 |
break; |
break; |
2497 |
case split_type_bit: // the value is already the sought dimension bit number |
case split_type_bit: // the value is already the sought dimension bit number |
2498 |
const uint8_t limiter_mask = (0xff << pDimensionDefinitions[i].bits) ^ 0xff; |
const uint8_t limiter_mask = (0xff << pDimensionDefinitions[i].bits) ^ 0xff; |
2506 |
DimensionRegion* dimreg = pDimensionRegions[dimregidx]; |
DimensionRegion* dimreg = pDimensionRegions[dimregidx]; |
2507 |
if (veldim != -1) { |
if (veldim != -1) { |
2508 |
// (dimreg is now the dimension region for the lowest velocity) |
// (dimreg is now the dimension region for the lowest velocity) |
2509 |
if (dimreg->VelocityUpperLimit) // custom defined zone ranges |
if (dimreg->VelocityTable) // custom defined zone ranges |
2510 |
bits = dimreg->VelocityTable[DimValues[veldim]]; |
bits = dimreg->VelocityTable[DimValues[veldim]]; |
2511 |
else // normal split type |
else // normal split type |
2512 |
bits = uint8_t(DimValues[veldim] / pDimensionDefinitions[veldim].zone_size); |
bits = uint8_t(DimValues[veldim] / pDimensionDefinitions[veldim].zone_size); |
2748 |
} |
} |
2749 |
|
|
2750 |
Group::~Group() { |
Group::~Group() { |
2751 |
|
// remove the chunk associated with this group (if any) |
2752 |
|
if (pNameChunk) pNameChunk->GetParent()->DeleteSubChunk(pNameChunk); |
2753 |
} |
} |
2754 |
|
|
2755 |
/** @brief Update chunks with current group settings. |
/** @brief Update chunks with current group settings. |
2756 |
* |
* |
2757 |
* Apply current Group field values to the respective. You have to call |
* Apply current Group field values to the respective chunks. You have |
2758 |
* File::Save() to make changes persistent. |
* to call File::Save() to make changes persistent. |
2759 |
|
* |
2760 |
|
* Usually there is absolutely no need to call this method explicitly. |
2761 |
|
* It will be called automatically when File::Save() was called. |
2762 |
*/ |
*/ |
2763 |
void Group::UpdateChunks() { |
void Group::UpdateChunks() { |
2764 |
// make sure <3gri> and <3gnl> list chunks exist |
// make sure <3gri> and <3gnl> list chunks exist |
2906 |
if (!pSamples || !pSamples->size()) throw gig::Exception("Could not delete sample as there are no samples"); |
if (!pSamples || !pSamples->size()) throw gig::Exception("Could not delete sample as there are no samples"); |
2907 |
SampleList::iterator iter = find(pSamples->begin(), pSamples->end(), (DLS::Sample*) pSample); |
SampleList::iterator iter = find(pSamples->begin(), pSamples->end(), (DLS::Sample*) pSample); |
2908 |
if (iter == pSamples->end()) throw gig::Exception("Could not delete sample, could not find given sample"); |
if (iter == pSamples->end()) throw gig::Exception("Could not delete sample, could not find given sample"); |
2909 |
|
if (SamplesIterator != pSamples->end() && *SamplesIterator == pSample) ++SamplesIterator; // avoid iterator invalidation |
2910 |
pSamples->erase(iter); |
pSamples->erase(iter); |
2911 |
delete pSample; |
delete pSample; |
2912 |
} |
} |
3043 |
* have to call Save() to make this persistent to the file. |
* have to call Save() to make this persistent to the file. |
3044 |
* |
* |
3045 |
* @param pInstrument - instrument to delete |
* @param pInstrument - instrument to delete |
3046 |
* @throws gig::Excption if given instrument could not be found |
* @throws gig::Exception if given instrument could not be found |
3047 |
*/ |
*/ |
3048 |
void File::DeleteInstrument(Instrument* pInstrument) { |
void File::DeleteInstrument(Instrument* pInstrument) { |
3049 |
if (!pInstruments) throw gig::Exception("Could not delete instrument as there are no instruments"); |
if (!pInstruments) throw gig::Exception("Could not delete instrument as there are no instruments"); |
3121 |
return pGroup; |
return pGroup; |
3122 |
} |
} |
3123 |
|
|
3124 |
|
/** @brief Delete a group and its samples. |
3125 |
|
* |
3126 |
|
* This will delete the given Group object and all the samples that |
3127 |
|
* belong to this group from the gig file. You have to call Save() to |
3128 |
|
* make this persistent to the file. |
3129 |
|
* |
3130 |
|
* @param pGroup - group to delete |
3131 |
|
* @throws gig::Exception if given group could not be found |
3132 |
|
*/ |
3133 |
void File::DeleteGroup(Group* pGroup) { |
void File::DeleteGroup(Group* pGroup) { |
3134 |
if (!pGroups) LoadGroups(); |
if (!pGroups) LoadGroups(); |
3135 |
std::list<Group*>::iterator iter = find(pGroups->begin(), pGroups->end(), pGroup); |
std::list<Group*>::iterator iter = find(pGroups->begin(), pGroups->end(), pGroup); |
3136 |
if (iter == pGroups->end()) throw gig::Exception("Could not delete group, could not find given group"); |
if (iter == pGroups->end()) throw gig::Exception("Could not delete group, could not find given group"); |
3137 |
if (pGroups->size() == 1) throw gig::Exception("Cannot delete group, there must be at least one default group!"); |
if (pGroups->size() == 1) throw gig::Exception("Cannot delete group, there must be at least one default group!"); |
3138 |
|
// delete all members of this group |
3139 |
|
for (Sample* pSample = pGroup->GetFirstSample(); pSample; pSample = pGroup->GetNextSample()) { |
3140 |
|
DeleteSample(pSample); |
3141 |
|
} |
3142 |
|
// now delete this group object |
3143 |
|
pGroups->erase(iter); |
3144 |
|
delete pGroup; |
3145 |
|
} |
3146 |
|
|
3147 |
|
/** @brief Delete a group. |
3148 |
|
* |
3149 |
|
* This will delete the given Group object from the gig file. All the |
3150 |
|
* samples that belong to this group will not be deleted, but instead |
3151 |
|
* be moved to another group. You have to call Save() to make this |
3152 |
|
* persistent to the file. |
3153 |
|
* |
3154 |
|
* @param pGroup - group to delete |
3155 |
|
* @throws gig::Exception if given group could not be found |
3156 |
|
*/ |
3157 |
|
void File::DeleteGroupOnly(Group* pGroup) { |
3158 |
|
if (!pGroups) LoadGroups(); |
3159 |
|
std::list<Group*>::iterator iter = find(pGroups->begin(), pGroups->end(), pGroup); |
3160 |
|
if (iter == pGroups->end()) throw gig::Exception("Could not delete group, could not find given group"); |
3161 |
|
if (pGroups->size() == 1) throw gig::Exception("Cannot delete group, there must be at least one default group!"); |
3162 |
// move all members of this group to another group |
// move all members of this group to another group |
3163 |
pGroup->MoveAll(); |
pGroup->MoveAll(); |
3164 |
pGroups->erase(iter); |
pGroups->erase(iter); |
3189 |
} |
} |
3190 |
} |
} |
3191 |
|
|
3192 |
|
/** |
3193 |
|
* Apply all the gig file's current instruments, samples, groups and settings |
3194 |
|
* to the respective RIFF chunks. You have to call Save() to make changes |
3195 |
|
* persistent. |
3196 |
|
* |
3197 |
|
* Usually there is absolutely no need to call this method explicitly. |
3198 |
|
* It will be called automatically when File::Save() was called. |
3199 |
|
* |
3200 |
|
* @throws Exception - on errors |
3201 |
|
*/ |
3202 |
|
void File::UpdateChunks() { |
3203 |
|
// first update base class's chunks |
3204 |
|
DLS::File::UpdateChunks(); |
3205 |
|
|
3206 |
|
// update group's chunks |
3207 |
|
if (pGroups) { |
3208 |
|
std::list<Group*>::iterator iter = pGroups->begin(); |
3209 |
|
std::list<Group*>::iterator end = pGroups->end(); |
3210 |
|
for (; iter != end; ++iter) { |
3211 |
|
(*iter)->UpdateChunks(); |
3212 |
|
} |
3213 |
|
} |
3214 |
|
} |
3215 |
|
|
3216 |
|
|
3217 |
|
|
3218 |
// *************** Exception *************** |
// *************** Exception *************** |