/[svn]/libgig/trunk/src/gig.h
ViewVC logotype

Diff of /libgig/trunk/src/gig.h

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

revision 2540 by schoenebeck, Wed Apr 23 16:39:43 2014 UTC revision 2547 by schoenebeck, Tue May 13 11:17:24 2014 UTC
# Line 342  namespace gig { Line 342  namespace gig {
342       */       */
343      class DimensionRegion : protected DLS::Sampler {      class DimensionRegion : protected DLS::Sampler {
344          public:          public:
345              uint8_t            VelocityUpperLimit;            ///< Defines the upper velocity value limit of a velocity split (only if an user defined limit was set, thus a value not equal to 128/NumberOfSplits, else this value is 0). Only for gig2, otherwise the DimensionUpperLimts are used instead.              uint8_t            VelocityUpperLimit;            ///< Defines the upper velocity value limit of a velocity split (only if an user defined limit was set, thus a value not equal to 128/NumberOfSplits, else this value is 0). Only for gig2, for gig3 and above the DimensionUpperLimits are used instead.
346              Sample*            pSample;                       ///< Points to the Sample which is assigned to the dimension region.              Sample*            pSample;                       ///< Points to the Sample which is assigned to the dimension region.
347              // Sample Amplitude EG/LFO              // Sample Amplitude EG/LFO
348              uint16_t           EG1PreAttack;                  ///< Preattack value of the sample amplitude EG (0 - 1000 permille).              uint16_t           EG1PreAttack;                  ///< Preattack value of the sample amplitude EG (0 - 1000 permille).
# Line 426  namespace gig { Line 426  namespace gig {
426              bool               MSDecode;                      ///< Gigastudio flag: defines if Mid Side Recordings should be decoded.              bool               MSDecode;                      ///< Gigastudio flag: defines if Mid Side Recordings should be decoded.
427              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).
428              double             SampleAttenuation;             ///< Sample volume (calculated from DLS::Sampler::Gain)              double             SampleAttenuation;             ///< Sample volume (calculated from DLS::Sampler::Gain)
429              uint8_t            DimensionUpperLimits[8];       ///< gig3: defines the upper limit of the dimension values for this dimension region              uint8_t            DimensionUpperLimits[8];       ///< gig3: defines the upper limit of the dimension values for this dimension region. In case you wondered why this is defined on DimensionRegion level and not on Region level: the zone sizes (upper limits) of the velocity dimension can indeed differ in the individual dimension regions, depending on which zones of the other dimension types are currently selected. So this is exceptional for the velocity dimension only. All other dimension types have the same dimension zone sizes for every single DimensionRegion (of the sample Region).
430    
431              // derived attributes from DLS::Sampler              // derived attributes from DLS::Sampler
432              using DLS::Sampler::UnityNote;              using DLS::Sampler::UnityNote;
# Line 685  namespace gig { Line 685  namespace gig {
685      };      };
686    
687      // TODO: <3dnl> list not used yet - not important though (just contains optional descriptions for the dimensions)      // TODO: <3dnl> list not used yet - not important though (just contains optional descriptions for the dimensions)
688      /** Defines <i>Region</i> information of an <i>Instrument</i>. */      /** @brief Defines Region information of an Instrument.
689         *
690         * A Region reflects a consecutive area on the keyboard. The individual
691         * regions in the gig format may not overlap with other regions (of the same
692         * instrument). Further, in the gig format a Region is merely a container
693         * for DimensionRegions (a.k.a. "Cases"). The Region itself does not provide
694         * the sample mapping or articulation informations used, even though the
695         * data structures indeed provide such informations. The latter is however
696         * just of historical nature, because the gig format was derived from the
697         * DLS format.
698         *
699         * Each Region consists of at least one or more DimensionRegions. The actual
700         * amount of DimensionRegions depends on which kind of "dimensions" are
701         * defined for this region, and on the split / zone amount for each of those
702         * dimensions.
703         */
704      class Region : public DLS::Region {      class Region : public DLS::Region {
705          public:          public:
706              unsigned int            Dimensions;               ///< Number of defined dimensions, do not alter!              unsigned int            Dimensions;               ///< Number of defined dimensions, do not alter!
# Line 700  namespace gig { Line 715  namespace gig {
715              Sample*          GetSample();              Sample*          GetSample();
716              void             AddDimension(dimension_def_t* pDimDef);              void             AddDimension(dimension_def_t* pDimDef);
717              void             DeleteDimension(dimension_def_t* pDimDef);              void             DeleteDimension(dimension_def_t* pDimDef);
718                dimension_def_t* GetDimensionDefinition(dimension_t type);
719              // overridden methods              // overridden methods
720              virtual void     SetKeyRange(uint16_t Low, uint16_t High);              virtual void     SetKeyRange(uint16_t Low, uint16_t High);
721              virtual void     UpdateChunks();              virtual void     UpdateChunks();
# Line 935  namespace gig { Line 951  namespace gig {
951              Group*      GetFirstGroup(); ///< Returns a pointer to the first <i>Group</i> object of the file, <i>NULL</i> otherwise.              Group*      GetFirstGroup(); ///< Returns a pointer to the first <i>Group</i> object of the file, <i>NULL</i> otherwise.
952              Group*      GetNextGroup();  ///< Returns a pointer to the next <i>Group</i> object of the file, <i>NULL</i> otherwise.              Group*      GetNextGroup();  ///< Returns a pointer to the next <i>Group</i> object of the file, <i>NULL</i> otherwise.
953              Group*      GetGroup(uint index);              Group*      GetGroup(uint index);
954                Group*      GetGroup(String name);
955              Group*      AddGroup();              Group*      AddGroup();
956              void        DeleteGroup(Group* pGroup);              void        DeleteGroup(Group* pGroup);
957              void        DeleteGroupOnly(Group* pGroup);              void        DeleteGroupOnly(Group* pGroup);
Legend:
Removed from v.2540  
changed lines
  Added in v.2547
  ViewVC Help
Powered by ViewVC