/[svn]/gigedit/trunk/src/gigedit/CombineInstrumentsDialog.cpp
ViewVC logotype

Diff of /gigedit/trunk/src/gigedit/CombineInstrumentsDialog.cpp

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 2549 by schoenebeck, Tue May 13 16:14:33 2014 UTC revision 2841 by persson, Sun Aug 30 10:00:49 2015 UTC
# Line 1  Line 1 
1  /*  /*
2      Copyright (c) 2014 Christian Schoenebeck      Copyright (c) 2014-2015 Christian Schoenebeck
3            
4      This file is part of "gigedit" and released under the terms of the      This file is part of "gigedit" and released under the terms of the
5      GNU General Public License version 2.      GNU General Public License version 2.
# Line 11  Line 11 
11  #define DEBUG_COMBINE_INSTRUMENTS 0  #define DEBUG_COMBINE_INSTRUMENTS 0
12    
13  #include "global.h"  #include "global.h"
14    #include "compat.h"
15    
16  #include <set>  #include <set>
17  #include <iostream>  #include <iostream>
18  #include <assert.h>  #include <assert.h>
19    #include <stdarg.h>
20    #include <string.h>
21    
22  #include <glibmm/ustring.h>  #include <glibmm/ustring.h>
23  #include <gtkmm/stock.h>  #include <gtkmm/stock.h>
24  #include <gtkmm/messagedialog.h>  #include <gtkmm/messagedialog.h>
25    #include <gtkmm/label.h>
26    
27  Glib::ustring gig_to_utf8(const gig::String& gig_string);  Glib::ustring gig_to_utf8(const gig::String& gig_string);
28    Glib::ustring dimTypeAsString(gig::dimension_t d);
29    
30    typedef std::vector< std::pair<gig::Instrument*, gig::Region*> > OrderedRegionGroup;
31  typedef std::map<gig::Instrument*, gig::Region*> RegionGroup;  typedef std::map<gig::Instrument*, gig::Region*> RegionGroup;
32  typedef std::map<DLS::range_t,RegionGroup> RegionGroups;  typedef std::map<DLS::range_t,RegionGroup> RegionGroups;
33    
# Line 32  typedef std::map<gig::dimension_t,int> D Line 38  typedef std::map<gig::dimension_t,int> D
38    
39  typedef std::map<gig::dimension_t, int> DimensionRegionUpperLimits;  typedef std::map<gig::dimension_t, int> DimensionRegionUpperLimits;
40    
41  typedef std::map<gig::DimensionRegion*, DimensionZones> VelocityZones;  typedef std::set<Glib::ustring> Warnings;
42    
43    ///////////////////////////////////////////////////////////////////////////
44    // private static data
45    
46    static Warnings g_warnings;
47    
48  ///////////////////////////////////////////////////////////////////////////  ///////////////////////////////////////////////////////////////////////////
49  // private functions  // private functions
# Line 49  static void printRanges(const RegionGrou Line 60  static void printRanges(const RegionGrou
60  #endif  #endif
61    
62  /**  /**
63     * Store a warning message that shall be stored and displayed to the user as a
64     * list of warnings after the overall operation has finished. Duplicate warning
65     * messages are automatically eliminated.
66     */
67    inline void addWarning(const char* fmt, ...) {
68        va_list arg;
69        va_start(arg, fmt);
70        const int SZ = 255 + strlen(fmt);
71        char* buf = new char[SZ];
72        vsnprintf(buf, SZ, fmt, arg);
73        Glib::ustring s = buf;
74        delete [] buf;
75        va_end(arg);
76        std::cerr << _("WARNING:") << " " << s << std::endl << std::flush;
77        g_warnings.insert(s);
78    }
79    
80    /**
81   * If the two ranges overlap, then this function returns the smallest point   * If the two ranges overlap, then this function returns the smallest point
82   * within that overlapping zone. If the two ranges do not overlap, then this   * within that overlapping zone. If the two ranges do not overlap, then this
83   * function will return -1 instead.   * function will return -1 instead.
# Line 68  inline int smallestOverlapPoint(const DL Line 97  inline int smallestOverlapPoint(const DL
97   *          found with a range member point >= iStart   *          found with a range member point >= iStart
98   */   */
99  static int findLowestRegionPoint(std::vector<gig::Instrument*>& instruments, int iStart) {  static int findLowestRegionPoint(std::vector<gig::Instrument*>& instruments, int iStart) {
100      DLS::range_t searchRange = { iStart, 127 };      DLS::range_t searchRange = { uint16_t(iStart), 127 };
101      int result = -1;      int result = -1;
102      for (uint i = 0; i < instruments.size(); ++i) {      for (uint i = 0; i < instruments.size(); ++i) {
103          gig::Instrument* instr = instruments[i];          gig::Instrument* instr = instruments[i];
# Line 90  static int findLowestRegionPoint(std::ve Line 119  static int findLowestRegionPoint(std::ve
119   *          with a range end >= iStart   *          with a range end >= iStart
120   */   */
121  static int findFirstRegionEnd(std::vector<gig::Instrument*>& instruments, int iStart) {  static int findFirstRegionEnd(std::vector<gig::Instrument*>& instruments, int iStart) {
122      DLS::range_t searchRange = { iStart, 127 };      DLS::range_t searchRange = { uint16_t(iStart), 127 };
123      int result = -1;      int result = -1;
124      for (uint i = 0; i < instruments.size(); ++i) {      for (uint i = 0; i < instruments.size(); ++i) {
125          gig::Instrument* instr = instruments[i];          gig::Instrument* instr = instruments[i];
# Line 133  static RegionGroup getAllRegionsWhichOve Line 162  static RegionGroup getAllRegionsWhichOve
162          std::vector<gig::Region*> v = getAllRegionsWhichOverlapRange(instr, range);          std::vector<gig::Region*> v = getAllRegionsWhichOverlapRange(instr, range);
163          if (v.empty()) continue;          if (v.empty()) continue;
164          if (v.size() > 1) {          if (v.size() > 1) {
165              std::cerr << "WARNING: More than one region found!" << std::endl;              addWarning("More than one region found!");
166          }          }
167          group[instr] = v[0];          group[instr] = v[0];
168      }      }
# Line 143  static RegionGroup getAllRegionsWhichOve Line 172  static RegionGroup getAllRegionsWhichOve
172  /** @brief Identify required regions.  /** @brief Identify required regions.
173   *   *
174   * Takes a list of @a instruments as argument (which are planned to be combined   * Takes a list of @a instruments as argument (which are planned to be combined
175   * as layers in one single new instrument) and fulfills the following tasks:   * as separate dimension zones of a certain dimension into one single new
176     * instrument) and fulfills the following tasks:
177   *   *
178   * - 1. Identification of total amount of regions required to create a new   * - 1. Identification of total amount of regions required to create a new
179   *      instrument to become a layered version of the given instruments.   *      instrument to become a combined version of the given instruments.
180   * - 2. Precise key range of each of those identified required regions to be   * - 2. Precise key range of each of those identified required regions to be
181   *      created in that new instrument.   *      created in that new instrument.
182   * - 3. Grouping the original source regions of the given original instruments   * - 3. Grouping the original source regions of the given original instruments
# Line 165  static RegionGroups groupByRegionInterse Line 195  static RegionGroups groupByRegionInterse
195          iStart = findLowestRegionPoint(instruments, iStart);          iStart = findLowestRegionPoint(instruments, iStart);
196          if (iStart < 0) break;          if (iStart < 0) break;
197          const int iEnd = findFirstRegionEnd(instruments, iStart);          const int iEnd = findFirstRegionEnd(instruments, iStart);
198          DLS::range_t range = { iStart, iEnd };          DLS::range_t range = { uint16_t(iStart), uint16_t(iEnd) };
199          intersections.push_back(range);          intersections.push_back(range);
200          iStart = iEnd + 1;          iStart = iEnd + 1;
201      }      }
# Line 177  static RegionGroups groupByRegionInterse Line 207  static RegionGroups groupByRegionInterse
207          if (!group.empty())          if (!group.empty())
208              groups[range] = group;              groups[range] = group;
209          else          else
210              std::cerr << "WARNING: empty region group!" << std::endl;              addWarning("Empty region group!");
211      }      }
212    
213      return groups;      return groups;
# Line 236  static Dimensions getDimensionsForRegion Line 266  static Dimensions getDimensionsForRegion
266               itNums != it->second.end(); ++itNums)               itNums != it->second.end(); ++itNums)
267          {          {
268              const int iUpperLimit = *itNums;              const int iUpperLimit = *itNums;
269              DLS::range_t range = { iLow, iUpperLimit };              DLS::range_t range = { uint16_t(iLow), uint16_t(iUpperLimit) };
270              dims[type].push_back(range);              dims[type].push_back(range);
271              iLow = iUpperLimit + 1;              iLow = iUpperLimit + 1;
272          }          }
# Line 253  inline int getDimensionIndex(gig::dimens Line 283  inline int getDimensionIndex(gig::dimens
283  }  }
284    
285  static void fillDimValues(uint* values/*[8]*/, DimensionCase dimCase, gig::Region* rgn, bool bShouldHaveAllDimensionsPassed) {  static void fillDimValues(uint* values/*[8]*/, DimensionCase dimCase, gig::Region* rgn, bool bShouldHaveAllDimensionsPassed) {
286        #if DEBUG_COMBINE_INSTRUMENTS
287        printf("dimvalues = { ");
288        fflush(stdout);
289        #endif
290      for (DimensionCase::iterator it = dimCase.begin(); it != dimCase.end(); ++it) {      for (DimensionCase::iterator it = dimCase.begin(); it != dimCase.end(); ++it) {
291          gig::dimension_t type = it->first;          gig::dimension_t type = it->first;
292          int iDimIndex = getDimensionIndex(type, rgn);          int iDimIndex = getDimensionIndex(type, rgn);
293          if (bShouldHaveAllDimensionsPassed) assert(iDimIndex >= 0);          if (bShouldHaveAllDimensionsPassed) assert(iDimIndex >= 0);
294          else if (iDimIndex < 0) continue;          else if (iDimIndex < 0) continue;
295          values[iDimIndex] = it->second;          values[iDimIndex] = it->second;
296            #if DEBUG_COMBINE_INSTRUMENTS
297            printf("%x=%d, ", type, it->second);
298            #endif
299      }      }
300        #if DEBUG_COMBINE_INSTRUMENTS
301        printf("}\n");
302        #endif
303  }  }
304    
305  static DimensionRegionUpperLimits getDimensionRegionUpperLimits(gig::DimensionRegion* dimRgn) {  static DimensionRegionUpperLimits getDimensionRegionUpperLimits(gig::DimensionRegion* dimRgn) {
# Line 334  static DimensionZones preciseDimensionZo Line 374  static DimensionZones preciseDimensionZo
374      int iBaseBits = baseBits(type, rgn);      int iBaseBits = baseBits(type, rgn);
375      int mask = ~(((1 << def.bits) - 1) << iBaseBits);      int mask = ~(((1 << def.bits) - 1) << iBaseBits);
376    
377        #if DEBUG_COMBINE_INSTRUMENTS
378        printf("velo zones { ");
379        fflush(stdout);
380        #endif
381      int iLow = 0;      int iLow = 0;
382      for (int z = 0; z < def.zones; ++z) {      for (int z = 0; z < def.zones; ++z) {
383          gig::DimensionRegion* dimRgn2 =          gig::DimensionRegion* dimRgn2 =
384              rgn->pDimensionRegions[ (iDimRgn & mask) | ( z << iBaseBits) ];              rgn->pDimensionRegions[ (iDimRgn & mask) | ( z << iBaseBits) ];
385          int iHigh = dimRgn2->DimensionUpperLimits[iDimension];          int iHigh = dimRgn2->DimensionUpperLimits[iDimension];
386          DLS::range_t range = { iLow, iHigh};          DLS::range_t range = { uint16_t(iLow), uint16_t(iHigh) };
387            #if DEBUG_COMBINE_INSTRUMENTS
388            printf("%d..%d, ", iLow, iHigh);
389            fflush(stdout);
390            #endif
391          zones.push_back(range);          zones.push_back(range);
392          iLow = iHigh + 1;          iLow = iHigh + 1;
393      }      }
394        #if DEBUG_COMBINE_INSTRUMENTS
395        printf("}\n");
396        #endif
397      return zones;      return zones;
398  }  }
399    
400  static VelocityZones getVelocityZones(gig::Region* rgn) {  struct CopyAssignSchedEntry {
401      VelocityZones zones;      gig::DimensionRegion* src;
402      for (uint i = 0; i < rgn->DimensionRegions; ++i) {      gig::DimensionRegion* dst;
403          gig::DimensionRegion* dimRgn = rgn->pDimensionRegions[i];      int velocityZone;
404          zones[dimRgn] = preciseDimensionZonesFor(gig::dimension_velocity, dimRgn);      int totalSrcVelocityZones;
405      }  };
406      return zones;  typedef std::vector<CopyAssignSchedEntry> CopyAssignSchedule;
407  }  
408    /** @brief Schedule copying DimensionRegions from source Region to target Region.
409  /** @brief Copy all DimensionRegions from source Region to target Region.   *
410   *   * Schedules copying the entire articulation informations (including sample
411   * Copies the entire articulation informations (including sample reference of   * reference) from all individual DimensionRegions of source Region @a inRgn to
412   * course) from all individual DimensionRegions of source Region @a inRgn to   * target Region @a outRgn. It is expected that the required dimensions (thus
413   * target Region @a outRgn. There are no dimension regions created during this   * the required dimension regions) were already created before calling this
414   * task. It is expected that the required dimensions (thus the required   * function.
415   * dimension regions) were already created before calling this function.   *
416   *   * To be precise, it does the task above only for the dimension zones defined by
417   * To be precise, it does the task above only for the layer selected by   * the three arguments @a mainDim, @a iSrcMainBit, @a iDstMainBit, which reflect
418   * @a iSrcLayer and @a iDstLayer. All dimensions regions of other layers that   * a selection which dimension zones shall be copied. All other dimension zones
419   * may exist, will not be copied by one single call of this function. So if   * will not be scheduled to be copied by a single call of this function. So this
420   * there is a layer dimension, this function needs to be called several times.   * function needs to be called several time in case all dimension regions shall
421     * be copied of the entire region (@a inRgn, @a outRgn).
422   *   *
423   * @param outRgn - where the dimension regions shall be copied to   * @param outRgn - where the dimension regions shall be copied to
424   * @param inRgn - all dimension regions that shall be copied from   * @param inRgn - all dimension regions that shall be copied from
425   * @param dims - dimension definitions of target region   * @param dims - precise dimension definitions of target region
426   * @param iDstLayer - layer number of destination region where the dimension   * @param mainDim - this dimension type, in combination with @a iSrcMainBit and
427   *                    regions shall be copied to   *                  @a iDstMainBit defines a selection which dimension region
428   * @param iSrcLayer - layer number of the source region where the dimension   *                  zones shall be copied by this call of this function
429   *                    regions shall be copied from   * @param iDstMainBit - destination bit of @a mainDim
430   * @param dstVelocityZones - all precise velocity zones for destination region   * @param iSrcMainBit - source bit of @a mainDim
431   *                           (since this information is stored on   * @param schedule - list of all DimensionRegion copy operations which is filled
432   *                           DimensionRegion level and this function is   *                   during the nested loops / recursions of this function call
  *                           modifying target DimensionRegions, this  
  *                           informations thus needs to be retrieved before  
  *                           calling this function)  
433   * @param dimCase - just for internal purpose (function recursion), don't pass   * @param dimCase - just for internal purpose (function recursion), don't pass
434   *                  anything here, this function will call itself recursively   *                  anything here, this function will call itself recursively
435   *                  will fill this container with concrete dimension values for   *                  will fill this container with concrete dimension values for
436   *                  selecting the precise dimension regions during its task   *                  selecting the precise dimension regions during its task
437   */   */
438  static void copyDimensionRegions(gig::Region* outRgn, gig::Region* inRgn, Dimensions dims, int iDstLayer, int iSrcLayer, const VelocityZones& dstVelocityZones, DimensionCase dimCase = DimensionCase()) {  static void scheduleCopyDimensionRegions(gig::Region* outRgn, gig::Region* inRgn,
439      if (dims.empty()) { // finally reached end of function recursion ...                                   Dimensions dims, gig::dimension_t mainDim,
440                                     int iDstMainBit, int iSrcMainBit,
441                                     CopyAssignSchedule* schedule,
442                                     DimensionCase dimCase = DimensionCase())
443    {
444        if (dims.empty()) { // reached deepest level of function recursion ...
445            CopyAssignSchedEntry e;
446    
447          // resolve the respective source & destination DimensionRegion ...                  // resolve the respective source & destination DimensionRegion ...        
448          uint srcDimValues[8] = {};          uint srcDimValues[8] = {};
449          uint dstDimValues[8] = {};          uint dstDimValues[8] = {};
450          DimensionCase srcDimCase = dimCase;          DimensionCase srcDimCase = dimCase;
451          DimensionCase dstDimCase = dimCase;          DimensionCase dstDimCase = dimCase;
452          srcDimCase[gig::dimension_layer] = iSrcLayer;          srcDimCase[mainDim] = iSrcMainBit;
453          dstDimCase[gig::dimension_layer] = iDstLayer;          dstDimCase[mainDim] = iDstMainBit;
454    
455            #if DEBUG_COMBINE_INSTRUMENTS
456            printf("-------------------------------\n");
457            printf("iDstMainBit=%d iSrcMainBit=%d\n", iDstMainBit, iSrcMainBit);
458            #endif
459    
460          // first select source & target dimension region with an arbitrary          // first select source & target dimension region with an arbitrary
461          // velocity split zone, to get access to the precise individual velocity          // velocity split zone, to get access to the precise individual velocity
462          // split zone sizes (if there is actually a velocity dimension at all,          // split zone sizes (if there is actually a velocity dimension at all,
463          // otherwise we already select the desired source & target dimension          // otherwise we already select the desired source & target dimension
464          // region here)          // region here)
465            #if DEBUG_COMBINE_INSTRUMENTS
466            printf("src "); fflush(stdout);
467            #endif
468          fillDimValues(srcDimValues, srcDimCase, inRgn, false);          fillDimValues(srcDimValues, srcDimCase, inRgn, false);
469          fillDimValues(dstDimValues, dstDimCase, outRgn, true);          #if DEBUG_COMBINE_INSTRUMENTS
470            printf("dst "); fflush(stdout);
471            #endif
472            fillDimValues(dstDimValues, dstDimCase, outRgn, false);
473          gig::DimensionRegion* srcDimRgn = inRgn->GetDimensionRegionByValue(srcDimValues);          gig::DimensionRegion* srcDimRgn = inRgn->GetDimensionRegionByValue(srcDimValues);
474          gig::DimensionRegion* dstDimRgn = outRgn->GetDimensionRegionByValue(dstDimValues);          gig::DimensionRegion* dstDimRgn = outRgn->GetDimensionRegionByValue(dstDimValues);
475          #if DEBUG_COMBINE_INSTRUMENTS          #if DEBUG_COMBINE_INSTRUMENTS
476            printf("iDstMainBit=%d iSrcMainBit=%d\n", iDstMainBit, iSrcMainBit);
477          printf("srcDimRgn=%lx dstDimRgn=%lx\n", (uint64_t)srcDimRgn, (uint64_t)dstDimRgn);          printf("srcDimRgn=%lx dstDimRgn=%lx\n", (uint64_t)srcDimRgn, (uint64_t)dstDimRgn);
478            printf("srcSample='%s' dstSample='%s'\n",
479                   (!srcDimRgn->pSample ? "NULL" : srcDimRgn->pSample->pInfo->Name.c_str()),
480                   (!dstDimRgn->pSample ? "NULL" : dstDimRgn->pSample->pInfo->Name.c_str())
481            );
482          #endif          #endif
483    
484            assert(srcDimRgn->GetParent() == inRgn);
485            assert(dstDimRgn->GetParent() == outRgn);
486    
487          // now that we have access to the precise velocity split zone upper          // now that we have access to the precise velocity split zone upper
488          // limits, we can select the actual source & destination dimension          // limits, we can select the actual source & destination dimension
489          // regions we need to copy (assuming that source or target region has          // regions we need to copy (assuming that source or target region has
490          // a velocity dimension)          // a velocity dimension)
491          if (outRgn->GetDimensionDefinition(gig::dimension_velocity)) {          if (outRgn->GetDimensionDefinition(gig::dimension_velocity)) {
492              // re-select target dimension region              // re-select target dimension region (with correct velocity zone)
493              assert(dstVelocityZones.find(dstDimRgn) != dstVelocityZones.end());              DimensionZones dstZones = preciseDimensionZonesFor(gig::dimension_velocity, dstDimRgn);
             DimensionZones dstZones = dstVelocityZones.find(dstDimRgn)->second;  
494              assert(dstZones.size() > 1);              assert(dstZones.size() > 1);
495              int iZoneIndex = dstDimCase[gig::dimension_velocity];              const int iDstZoneIndex =
496                    (mainDim == gig::dimension_velocity)
497                        ? iDstMainBit : dstDimCase[gig::dimension_velocity]; // (mainDim == gig::dimension_velocity) exception case probably unnecessary here
498                e.velocityZone = iDstZoneIndex;
499              #if DEBUG_COMBINE_INSTRUMENTS              #if DEBUG_COMBINE_INSTRUMENTS
500              printf("dst velocity zone: %d/%d\n", iZoneIndex, dstZones.size());              printf("dst velocity zone: %d/%d\n", iDstZoneIndex, (int)dstZones.size());
501              #endif              #endif
502              assert(iZoneIndex < dstZones.size());              assert(uint(iDstZoneIndex) < dstZones.size());
503              dstDimCase[gig::dimension_velocity] = dstZones[iZoneIndex].low; // arbitrary value between low and high              dstDimCase[gig::dimension_velocity] = dstZones[iDstZoneIndex].low; // arbitrary value between low and high
504              #if DEBUG_COMBINE_INSTRUMENTS              #if DEBUG_COMBINE_INSTRUMENTS
505              printf("dst velocity value = %d\n", dstDimCase[gig::dimension_velocity]);              printf("dst velocity value = %d\n", dstDimCase[gig::dimension_velocity]);
506                printf("dst refilled "); fflush(stdout);
507              #endif              #endif
508              fillDimValues(dstDimValues, dstDimCase, outRgn, true);              fillDimValues(dstDimValues, dstDimCase, outRgn, false);
509              dstDimRgn = outRgn->GetDimensionRegionByValue(dstDimValues);              dstDimRgn = outRgn->GetDimensionRegionByValue(dstDimValues);
510              #if DEBUG_COMBINE_INSTRUMENTS              #if DEBUG_COMBINE_INSTRUMENTS
511              printf("reselected dstDimRgn=%lx\n", (uint64_t)dstDimRgn);              printf("reselected dstDimRgn=%lx\n", (uint64_t)dstDimRgn);
512                printf("dstSample='%s'%s\n",
513                    (!dstDimRgn->pSample ? "NULL" : dstDimRgn->pSample->pInfo->Name.c_str()),
514                    (dstDimRgn->pSample ? " <--- ERROR ERROR ERROR !!!!!!!!! " : "")
515                );
516              #endif              #endif
517    
518              // re-select source dimension region              // re-select source dimension region with correct velocity zone
519              // (if it has a velocity dimension)              // (if it has a velocity dimension that is)
520              if (inRgn->GetDimensionDefinition(gig::dimension_velocity)) {              if (inRgn->GetDimensionDefinition(gig::dimension_velocity)) {
521                  DimensionZones srcZones = preciseDimensionZonesFor(gig::dimension_velocity, srcDimRgn);                  DimensionZones srcZones = preciseDimensionZonesFor(gig::dimension_velocity, srcDimRgn);
522                  assert(srcZones.size() > 1);                  e.totalSrcVelocityZones = srcZones.size();
523                  if (iZoneIndex >= srcZones.size())                  assert(srcZones.size() > 0);
524                      iZoneIndex  = srcZones.size();                  if (srcZones.size() <= 1) {
525                  srcDimCase[gig::dimension_velocity] = srcZones[iZoneIndex].low; // same zone as used above for target dimension region (no matter what the precise zone ranges are)                      addWarning("Input region has a velocity dimension with only ONE zone!");
526                    }
527                    int iSrcZoneIndex =
528                        (mainDim == gig::dimension_velocity)
529                            ? iSrcMainBit : iDstZoneIndex;
530                    if (uint(iSrcZoneIndex) >= srcZones.size())
531                        iSrcZoneIndex = srcZones.size() - 1;
532                    srcDimCase[gig::dimension_velocity] = srcZones[iSrcZoneIndex].low; // same zone as used above for target dimension region (no matter what the precise zone ranges are)
533                    #if DEBUG_COMBINE_INSTRUMENTS
534                    printf("src refilled "); fflush(stdout);
535                    #endif
536                  fillDimValues(srcDimValues, srcDimCase, inRgn, false);                  fillDimValues(srcDimValues, srcDimCase, inRgn, false);
537                  srcDimRgn = inRgn->GetDimensionRegionByValue(srcDimValues);                  srcDimRgn = inRgn->GetDimensionRegionByValue(srcDimValues);
538                  #if DEBUG_COMBINE_INSTRUMENTS                  #if DEBUG_COMBINE_INSTRUMENTS
539                  printf("reselected srcDimRgn=%lx\n", (uint64_t)srcDimRgn);                  printf("reselected srcDimRgn=%lx\n", (uint64_t)srcDimRgn);
540                    printf("srcSample='%s'\n",
541                        (!srcDimRgn->pSample ? "NULL" : srcDimRgn->pSample->pInfo->Name.c_str())
542                    );
543                  #endif                  #endif
544              }              }
545          }          }
546    
547          // backup the target DimensionRegion's current dimension zones upper          // Schedule copy operation of source -> target DimensionRegion for the
548          // limits (because the target DimensionRegion's upper limits are already          // time after all nested loops have been traversed. We have to postpone
549          // defined correctly since calling AddDimension(), and the CopyAssign()          // the actual copy operations this way, because otherwise it would
550          // call next, will overwrite those upper limits unfortunately          // overwrite informations inside the destination DimensionRegion object
551          DimensionRegionUpperLimits dstUpperLimits = getDimensionRegionUpperLimits(dstDimRgn);          // that we need to read in the code block above.
552          DimensionRegionUpperLimits srcUpperLimits = getDimensionRegionUpperLimits(srcDimRgn);          e.src = srcDimRgn;
553            e.dst = dstDimRgn;
554          // copy over the selected DimensionRegion          schedule->push_back(e);
         const gig::Region* const origRgn = dstDimRgn->GetParent(); // just for sanity check below  
         dstDimRgn->CopyAssign(srcDimRgn);  
         assert(origRgn == dstDimRgn->GetParent());  
   
         // restore all original dimension zone upper limits except of the  
         // velocity dimension, because the velocity dimension zone sizes are  
         // allowed to differ for individual DimensionRegions in gig v3 format  
         if (srcUpperLimits.count(gig::dimension_velocity)) {  
             assert(dstUpperLimits.count(gig::dimension_velocity));  
             dstUpperLimits[gig::dimension_velocity] = srcUpperLimits[gig::dimension_velocity];  
         }  
         restoreDimensionRegionUpperLimits(dstDimRgn, dstUpperLimits);  
555    
556          return; // end of recursion          return; // returning from deepest level of function recursion
557      }      }
558    
559      // Copying n dimensions requires n nested loops. That's why this function      // Copying n dimensions requires n nested loops. That's why this function
# Line 479  static void copyDimensionRegions(gig::Re Line 562  static void copyDimensionRegions(gig::Re
562      // argument 'dimCase'.      // argument 'dimCase'.
563    
564      Dimensions::iterator itDimension = dims.begin();      Dimensions::iterator itDimension = dims.begin();
   
565      gig::dimension_t type = itDimension->first;      gig::dimension_t type = itDimension->first;
566      DimensionZones  zones = itDimension->second;      DimensionZones  zones = itDimension->second;
   
567      dims.erase(itDimension);      dims.erase(itDimension);
568    
569      int iZone = 0;      int iZone = 0;
# Line 492  static void copyDimensionRegions(gig::Re Line 573  static void copyDimensionRegions(gig::Re
573          DLS::range_t zoneRange = *itZone;          DLS::range_t zoneRange = *itZone;
574          gig::dimension_def_t* def = outRgn->GetDimensionDefinition(type);          gig::dimension_def_t* def = outRgn->GetDimensionDefinition(type);
575          dimCase[type] = (def->split_type == gig::split_type_bit) ? iZone : zoneRange.low;          dimCase[type] = (def->split_type == gig::split_type_bit) ? iZone : zoneRange.low;
576    
577          // recurse until 'dims' is exhausted (and dimCase filled up with concrete value)          // recurse until 'dims' is exhausted (and dimCase filled up with concrete value)
578          copyDimensionRegions(outRgn, inRgn, dims, iDstLayer, iSrcLayer, dstVelocityZones, dimCase);          scheduleCopyDimensionRegions(outRgn, inRgn, dims, mainDim, iDstMainBit, iSrcMainBit, schedule, dimCase);
579      }      }
580  }  }
581    
582    static OrderedRegionGroup sortRegionGroup(const RegionGroup& group, const std::vector<gig::Instrument*>& instruments) {
583        OrderedRegionGroup result;
584        for (std::vector<gig::Instrument*>::const_iterator it = instruments.begin();
585             it != instruments.end(); ++it)
586        {
587            RegionGroup::const_iterator itRgn = group.find(*it);
588            if (itRgn == group.end()) continue;
589            result.push_back(
590                std::pair<gig::Instrument*, gig::Region*>(
591                    itRgn->first, itRgn->second
592                )
593            );
594        }
595        return result;
596    }
597    
598  /** @brief Combine given list of instruments to one instrument.  /** @brief Combine given list of instruments to one instrument.
599   *   *
600   * Takes a list of @a instruments as argument and combines them to one single   * Takes a list of @a instruments as argument and combines them to one single
601   * new @a output instrument. For this task, it will create a 'layer' dimension   * new @a output instrument. For this task, it will create a dimension of type
602   * in the new instrument and copies the source instruments to those layers.   * given by @a mainDimension in the new instrument and copies the source
603     * instruments to those dimension zones.
604   *   *
605   * @param instruments - (input) list of instruments that shall be combined,   * @param instruments - (input) list of instruments that shall be combined,
606   *                      they will only be read, so they will be left untouched   *                      they will only be read, so they will be left untouched
# Line 509  static void copyDimensionRegions(gig::Re Line 608  static void copyDimensionRegions(gig::Re
608   *              be created   *              be created
609   * @param output - (output) on success this pointer will be set to the new   * @param output - (output) on success this pointer will be set to the new
610   *                 instrument being created   *                 instrument being created
611     * @param mainDimension - the dimension that shall be used to combine the
612     *                        instruments
613   * @throw RIFF::Exception on any kinds of errors   * @throw RIFF::Exception on any kinds of errors
614   */   */
615  static void combineInstruments(std::vector<gig::Instrument*>& instruments, gig::File* gig, gig::Instrument*& output) {  static void combineInstruments(std::vector<gig::Instrument*>& instruments, gig::File* gig, gig::Instrument*& output, gig::dimension_t mainDimension) {
616      output = NULL;      output = NULL;
617    
618      // divide the individual regions to (probably even smaller) groups of      // divide the individual regions to (probably even smaller) groups of
# Line 544  static void combineInstruments(std::vect Line 645  static void combineInstruments(std::vect
645      {      {
646          gig::Region* outRgn = outInstr->AddRegion();          gig::Region* outRgn = outInstr->AddRegion();
647          outRgn->SetKeyRange(itGroup->first.low, itGroup->first.high);          outRgn->SetKeyRange(itGroup->first.low, itGroup->first.high);
648            #if DEBUG_COMBINE_INSTRUMENTS
649            printf("---> Start target region %d..%d\n", itGroup->first.low, itGroup->first.high);
650            #endif
651    
652          // detect the total amount of layers required to build up this combi          // detect the total amount of zones required for the given main
653          // for current key range          // dimension to build up this combi for current key range
654          int iTotalLayers = 0;          int iTotalZones = 0;
655          for (RegionGroup::iterator itRgn = itGroup->second.begin();          for (RegionGroup::iterator itRgn = itGroup->second.begin();
656               itRgn != itGroup->second.end(); ++itRgn)               itRgn != itGroup->second.end(); ++itRgn)
657          {          {
658              gig::Region* inRgn = itRgn->second;              gig::Region* inRgn = itRgn->second;
659              iTotalLayers += inRgn->Layers;              gig::dimension_def_t* def = inRgn->GetDimensionDefinition(mainDimension);
660                iTotalZones += (def) ? def->zones : 1;
661          }          }
662            #if DEBUG_COMBINE_INSTRUMENTS
663            printf("Required total zones: %d, vertical regions: %d\n", iTotalZones, itGroup->second.size());
664            #endif
665    
666          // create all required dimensions for this output region          // create all required dimensions for this output region
667          // (except the layer dimension, which we create as next step)          // (except the main dimension used for separating the individual
668            // instruments, we create that particular dimension as next step)
669          Dimensions dims = getDimensionsForRegionGroup(itGroup->second);          Dimensions dims = getDimensionsForRegionGroup(itGroup->second);
670          for (Dimensions::iterator itDim = dims.begin();          // the given main dimension which is used to combine the instruments is
671               itDim != dims.end(); ++itDim)          // created separately after the next code block, and the main dimension
672            // should not be part of dims here, because it also used for iterating
673            // all dimensions zones, which would lead to this dimensions being
674            // iterated twice
675            dims.erase(mainDimension);
676          {          {
677              if (itDim->first == gig::dimension_layer) continue;              std::vector<gig::dimension_t> skipTheseDimensions; // used to prevent a misbehavior (i.e. crash) of the combine algorithm in case one of the source instruments has a dimension with only one zone, which is not standard conform
678    
679              gig::dimension_def_t def;              for (Dimensions::iterator itDim = dims.begin();
680              def.dimension = itDim->first; // dimension type                  itDim != dims.end(); ++itDim)
681              def.zones = itDim->second.size();              {
682              def.bits = zoneCountToBits(def.zones);                  gig::dimension_def_t def;
683              #if DEBUG_COMBINE_INSTRUMENTS                  def.dimension = itDim->first; // dimension type
684              std::cout << "Adding new regular dimension type=" << std::hex << (int)def.dimension << std::dec << ", zones=" << (int)def.zones << ", bits=" << (int)def.bits << " ... " << std::flush;                  def.zones = itDim->second.size();
685              #endif                  def.bits = zoneCountToBits(def.zones);
686              outRgn->AddDimension(&def);                  if (def.zones < 2) {
687              #if DEBUG_COMBINE_INSTRUMENTS                      addWarning(
688              std::cout << "OK" << std::endl << std::flush;                          "Attempt to create dimension with type=0x%x with only "
689              #endif                          "ONE zone (because at least one of the source "
690                            "instruments seems to have such a velocity dimension "
691                            "with only ONE zone, which is odd)! Skipping this "
692                            "dimension for now.",
693                            (int)itDim->first
694                        );
695                        skipTheseDimensions.push_back(itDim->first);
696                        continue;
697                    }
698                    #if DEBUG_COMBINE_INSTRUMENTS
699                    std::cout << "Adding new regular dimension type=" << std::hex << (int)def.dimension << std::dec << ", zones=" << (int)def.zones << ", bits=" << (int)def.bits << " ... " << std::flush;
700                    #endif
701                    outRgn->AddDimension(&def);
702                    #if DEBUG_COMBINE_INSTRUMENTS
703                    std::cout << "OK" << std::endl << std::flush;
704                    #endif
705                }
706                // prevent the following dimensions to be processed further below
707                // (since the respective dimension was not created above)
708                for (int i = 0; i < skipTheseDimensions.size(); ++i)
709                    dims.erase(skipTheseDimensions[i]);
710          }          }
711    
712          // create the layer dimension (if necessary for current key range)          // create the main dimension (if necessary for current key range)
713          if (iTotalLayers > 1) {          if (iTotalZones > 1) {
714              gig::dimension_def_t def;              gig::dimension_def_t def;
715              def.dimension = gig::dimension_layer; // dimension type              def.dimension = mainDimension; // dimension type
716              def.zones = iTotalLayers;              def.zones = iTotalZones;
717              def.bits = zoneCountToBits(def.zones);              def.bits = zoneCountToBits(def.zones);
718              #if DEBUG_COMBINE_INSTRUMENTS              #if DEBUG_COMBINE_INSTRUMENTS
719              std::cout << "Adding new (layer) dimension type=" << std::hex << (int)def.dimension << std::dec << ", zones=" << (int)def.zones << ", bits=" << (int)def.bits << " ... " << std::flush;              std::cout << "Adding new main combi dimension type=" << std::hex << (int)def.dimension << std::dec << ", zones=" << (int)def.zones << ", bits=" << (int)def.bits << " ... " << std::flush;
720              #endif              #endif
721              outRgn->AddDimension(&def);              outRgn->AddDimension(&def);
722              #if DEBUG_COMBINE_INSTRUMENTS              #if DEBUG_COMBINE_INSTRUMENTS
723              std::cout << "OK" << std::endl << std::flush;              std::cout << "OK" << std::endl << std::flush;
724              #endif              #endif
725            } else {
726                dims.erase(mainDimension);
727          }          }
728    
729          // now copy the source dimension regions to the target dimension regions          // for the next task we need to have the current RegionGroup to be
730          int iDstLayer = 0;          // sorted by instrument in the same sequence as the 'instruments' vector
731          for (RegionGroup::iterator itRgn = itGroup->second.begin();          // argument passed to this function (because the std::map behind the
732               itRgn != itGroup->second.end(); ++itRgn) // iterate over 'vertical' / source regions ...          // 'RegionGroup' type sorts by memory address instead, and that would
733            // sometimes lead to the source instruments' region to be sorted into
734            // the wrong target layer)
735            OrderedRegionGroup currentGroup = sortRegionGroup(itGroup->second, instruments);
736    
737            // schedule copying the source dimension regions to the target dimension
738            // regions
739            CopyAssignSchedule schedule;
740            int iDstMainBit = 0;
741            for (OrderedRegionGroup::iterator itRgn = currentGroup.begin();
742                 itRgn != currentGroup.end(); ++itRgn) // iterate over 'vertical' / source regions ...
743          {          {
744              gig::Region* inRgn = itRgn->second;              gig::Region* inRgn = itRgn->second;
745              VelocityZones dstVelocityZones = getVelocityZones(outRgn);              #if DEBUG_COMBINE_INSTRUMENTS
746              for (uint iSrcLayer = 0; iSrcLayer < inRgn->Layers; ++iSrcLayer, ++iDstLayer) {              printf("[source region of '%s']\n", inRgn->GetParent()->pInfo->Name.c_str());
747                  copyDimensionRegions(outRgn, inRgn, dims, iDstLayer, iSrcLayer, dstVelocityZones);              #endif
748    
749                // determine how many main dimension zones this input region requires
750                gig::dimension_def_t* def = inRgn->GetDimensionDefinition(mainDimension);
751                const int inRgnMainZones = (def) ? def->zones : 1;
752    
753                for (uint iSrcMainBit = 0; iSrcMainBit < inRgnMainZones; ++iSrcMainBit, ++iDstMainBit) {
754                    scheduleCopyDimensionRegions(
755                        outRgn, inRgn, dims, mainDimension,
756                        iDstMainBit, iSrcMainBit, &schedule
757                    );
758              }              }
759          }          }
760    
761            // finally copy the scheduled source -> target dimension regions
762            for (uint i = 0; i < schedule.size(); ++i) {
763                CopyAssignSchedEntry& e = schedule[i];
764    
765                // backup the target DimensionRegion's current dimension zones upper
766                // limits (because the target DimensionRegion's upper limits are
767                // already defined correctly since calling AddDimension(), and the
768                // CopyAssign() call next, will overwrite those upper limits
769                // unfortunately
770                DimensionRegionUpperLimits dstUpperLimits = getDimensionRegionUpperLimits(e.dst);
771                DimensionRegionUpperLimits srcUpperLimits = getDimensionRegionUpperLimits(e.src);
772    
773                // now actually copy over the current DimensionRegion
774                const gig::Region* const origRgn = e.dst->GetParent(); // just for sanity check below
775                e.dst->CopyAssign(e.src);
776                assert(origRgn == e.dst->GetParent()); // if gigedit is crashing here, then you must update libgig (to at least SVN r2547, v3.3.0.svn10)
777    
778                // restore all original dimension zone upper limits except of the
779                // velocity dimension, because the velocity dimension zone sizes are
780                // allowed to differ for individual DimensionRegions in gig v3
781                // format
782                //
783                // if the main dinension is the 'velocity' dimension, then skip
784                // restoring the source's original velocity zone limits, because
785                // dealing with merging that is not implemented yet
786                // TODO: merge custom velocity splits if main dimension is the velocity dimension (for now equal sized velocity zones are used if mainDim is 'velocity')
787                if (srcUpperLimits.count(gig::dimension_velocity) && mainDimension != gig::dimension_velocity) {
788                    if (!dstUpperLimits.count(gig::dimension_velocity)) {
789                        addWarning("Source instrument seems to have a velocity dimension whereas new target instrument doesn't!");
790                    } else {
791                        dstUpperLimits[gig::dimension_velocity] =
792                            (e.velocityZone >= e.totalSrcVelocityZones)
793                                ? 127 : srcUpperLimits[gig::dimension_velocity];
794                    }
795                }
796                restoreDimensionRegionUpperLimits(e.dst, dstUpperLimits);
797            }
798      }      }
799    
800      // success      // success
# Line 615  CombineInstrumentsDialog::CombineInstrum Line 808  CombineInstrumentsDialog::CombineInstrum
808      : Gtk::Dialog(_("Combine Instruments"), parent, true),      : Gtk::Dialog(_("Combine Instruments"), parent, true),
809        m_gig(gig), m_fileWasChanged(false), m_newCombinedInstrument(NULL),        m_gig(gig), m_fileWasChanged(false), m_newCombinedInstrument(NULL),
810        m_cancelButton(Gtk::Stock::CANCEL), m_OKButton(Gtk::Stock::OK),        m_cancelButton(Gtk::Stock::CANCEL), m_OKButton(Gtk::Stock::OK),
811        m_descriptionLabel()        m_descriptionLabel(), m_tableDimCombo(2, 2), m_comboDimType(),
812          m_labelDimType(Glib::ustring(_("Combine by Dimension:")) + "  ", Gtk::ALIGN_END)
813  {  {
814        m_scrolledWindow.add(m_treeView);
815        m_scrolledWindow.set_policy(Gtk::POLICY_AUTOMATIC, Gtk::POLICY_AUTOMATIC);
816    
817      get_vbox()->pack_start(m_descriptionLabel, Gtk::PACK_SHRINK);      get_vbox()->pack_start(m_descriptionLabel, Gtk::PACK_SHRINK);
818      get_vbox()->pack_start(m_treeView);      get_vbox()->pack_start(m_tableDimCombo, Gtk::PACK_SHRINK);
819        get_vbox()->pack_start(m_scrolledWindow);
820      get_vbox()->pack_start(m_buttonBox, Gtk::PACK_SHRINK);      get_vbox()->pack_start(m_buttonBox, Gtk::PACK_SHRINK);
821    
822  #if GTKMM_MAJOR_VERSION >= 3  #if GTKMM_MAJOR_VERSION >= 3
823      description.set_line_wrap();      m_descriptionLabel.set_line_wrap();
824  #endif  #endif
825      m_descriptionLabel.set_text(_(      m_descriptionLabel.set_text(_(
826          "Select at least two instruments below that shall be combined  "          "Select at least two instruments below that shall be combined (as "
827          "as layers (using a \"Layer\" dimension) to a new instrument. The "          "separate dimension zones of the selected dimension type) as a new "
828          "original instruments remain untouched.")          "instrument. The original instruments remain untouched.\n\n"
829      );          "You may use this tool for example to combine solo instruments into "
830            "a combi sound arrangement by selecting the 'layer' dimension, or you "
831            "might combine similar sounding solo sounds into separate velocity "
832            "split layers by using the 'velocity' dimension, and so on."
833        ));
834    
835        // add dimension type combo box
836        {
837            int iLayerDimIndex = -1;
838            Glib::RefPtr<Gtk::ListStore> refComboModel = Gtk::ListStore::create(m_comboDimsModel);
839            for (int i = 0x01, iRow = 0; i < 0xff; i++) {
840                Glib::ustring sType =
841                    dimTypeAsString(static_cast<gig::dimension_t>(i));
842                if (sType.find("Unknown") != 0) {
843                    Gtk::TreeModel::Row row = *(refComboModel->append());
844                    row[m_comboDimsModel.m_type_id]   = i;
845                    row[m_comboDimsModel.m_type_name] = sType;
846                    if (i == gig::dimension_layer) iLayerDimIndex = iRow;
847                    iRow++;
848                }
849            }
850            m_comboDimType.set_model(refComboModel);
851            m_comboDimType.pack_start(m_comboDimsModel.m_type_id);
852            m_comboDimType.pack_start(m_comboDimsModel.m_type_name);
853            m_tableDimCombo.attach(m_labelDimType, 0, 1, 0, 1);
854            m_tableDimCombo.attach(m_comboDimType, 1, 2, 0, 1);
855            m_comboDimType.set_active(iLayerDimIndex); // preselect "layer" dimension
856        }
857    
858      m_refTreeModel = Gtk::ListStore::create(m_columns);      m_refTreeModel = Gtk::ListStore::create(m_columns);
859      m_treeView.set_model(m_refTreeModel);      m_treeView.set_model(m_refTreeModel);
860      //m_treeView.set_tooltip_text(_("asdf"));      m_treeView.set_tooltip_text(_(
861            "Use SHIFT + left click or CTRL + left click to select the instruments "
862            "you want to combine."
863        ));
864      m_treeView.append_column("Instrument", m_columns.m_col_name);      m_treeView.append_column("Instrument", m_columns.m_col_name);
865      m_treeView.set_headers_visible(false);      m_treeView.set_headers_visible(false);
866      m_treeView.get_selection()->set_mode(Gtk::SELECTION_MULTIPLE);      m_treeView.get_selection()->set_mode(Gtk::SELECTION_MULTIPLE);
# Line 682  CombineInstrumentsDialog::CombineInstrum Line 910  CombineInstrumentsDialog::CombineInstrum
910      );      );
911    
912      show_all_children();      show_all_children();
913    
914        // show a warning to user if he uses a .gig in v2 format
915        if (gig->pVersion->major < 3) {
916            Glib::ustring txt = _(
917                "You are currently using a .gig file in old v2 format. The current "
918                "combine algorithm will most probably fail trying to combine "
919                "instruments in this old format. So better save the file in new v3 "
920                "format before trying to combine your instruments."
921            );
922            Gtk::MessageDialog msg(*this, txt, false, Gtk::MESSAGE_WARNING);
923            msg.run();
924        }
925  }  }
926    
927  void CombineInstrumentsDialog::combineSelectedInstruments() {  void CombineInstrumentsDialog::combineSelectedInstruments() {
# Line 698  void CombineInstrumentsDialog::combineSe Line 938  void CombineInstrumentsDialog::combineSe
938          instruments.push_back(instrument);          instruments.push_back(instrument);
939      }      }
940    
941        g_warnings.clear();
942    
943      try {      try {
944          combineInstruments(instruments, m_gig, m_newCombinedInstrument);          // which main dimension was selected in the combo box?
945            gig::dimension_t mainDimension;
946            {
947                Gtk::TreeModel::iterator iterType = m_comboDimType.get_active();
948                if (!iterType) throw gig::Exception("No dimension selected");
949                Gtk::TreeModel::Row rowType = *iterType;
950                if (!rowType) throw gig::Exception("Something is wrong regarding dimension selection");
951                int iTypeID = rowType[m_comboDimsModel.m_type_id];
952                mainDimension = static_cast<gig::dimension_t>(iTypeID);
953            }
954    
955            // now start the actual cobination task ...
956            combineInstruments(instruments, m_gig, m_newCombinedInstrument, mainDimension);
957      } catch (RIFF::Exception e) {;      } catch (RIFF::Exception e) {;
958          Gtk::MessageDialog msg(*this, e.Message, false, Gtk::MESSAGE_ERROR);          Gtk::MessageDialog msg(*this, e.Message, false, Gtk::MESSAGE_ERROR);
959          msg.run();          msg.run();
960          return;          return;
961        } catch (...) {
962            Glib::ustring txt = _("An unknown exception occurred!");
963            Gtk::MessageDialog msg(*this, txt, false, Gtk::MESSAGE_ERROR);
964            msg.run();
965            return;
966        }
967    
968        if (!g_warnings.empty()) {
969            Glib::ustring txt = _(
970                "Combined instrument was created successfully, but there were warnings:"
971            );
972            txt += "\n\n";
973            for (Warnings::const_iterator itWarn = g_warnings.begin();
974                 itWarn != g_warnings.end(); ++itWarn)
975            {
976                txt += "-> " + *itWarn + "\n";
977            }
978            txt += "\n";
979            txt += _(
980                "You might also want to check the console for further warnings and "
981                "error messages."
982            );
983            Gtk::MessageDialog msg(*this, txt, false, Gtk::MESSAGE_WARNING);
984            msg.run();
985      }      }
986    
987      // no error occurred      // no error occurred
Legend:
Removed from v.2549  
changed lines
  Added in v.2841
  ViewVC Help
Powered by ViewVC