MuseScore 3 源码分析之 Segment

音乐 刘宇帅 3年前 阅读量: 1266

每个小节被分成多个 Segment,Segment 包含所有开始时间点相同的元素,且 Segment 是有类型的,所以一个 Segment 里的元素类型也是相同的。
SegmentType 定义

enum class SegmentType {
      ///.\{
      Invalid            = 0x0,
      BeginBarLine       = 0x1, // 开始小节线
      HeaderClef         = 0x2, // 曲谱开头 谱号
      KeySig             = 0x4,  // 调号
      Ambitus            = 0x8, // 音域
      TimeSig            = 0x10, // 拍号
      StartRepeatBarLine = 0x20, // 反复开始小节线
      Clef               = 0x40,  // 谱号
      BarLine            = 0x80, // 小节线
      Breath             = 0x100, // 呼吸记号
      //--
      ChordRest          = 0x200, // 音符/休止符
      //--
      EndBarLine         = 0x400, // 结束小节线
      KeySigAnnounce     = 0x800,
      TimeSigAnnounce    = 0x1000,
      All                = -1, ///< Includes all barline types
      /// Alias for `BeginBarLine | StartRepeatBarLine | BarLine | EndBarLine`
      BarLineType        = BeginBarLine | StartRepeatBarLine | BarLine | EndBarLine
      ///\}
      };

Segment 定义

class Segment final : public Element {
      SegmentType _segmentType { SegmentType::Invalid }; // 类型
      Fraction _tick;  // { Fraction(0, 1) }; // segment 在曲谱整体开始tick比例信息
      Fraction _ticks; // { Fraction(0, 1) }; // 当前 segment 的时值信息
      Spatium _extraLeadingSpace; 
      qreal _stretch;

      Segment* _next = nullptr;                     // linked list of segments inside a measure
      Segment* _prev = nullptr;

      std::vector<Element*> _annotations;
      std::vector<Element*> _elist;       // Element storage, size = staves * VOICES.
      std::vector<Shape>    _shapes;      // size = staves
      std::vector<qreal>    _dotPosX;     // size = staves
      ....
      ....

如果 Segment 类型是 Segment::ChordRest,那么可以遍历 _elist 里的各个声部,每个声部就包含一个和弦下的所有音(单个音符也会保存在一个ChordRest中)
SegmentList 用来保存一组 Segment,定义如下

class SegmentList {
      Segment* _first;        ///< First item of segment list
      Segment* _last;         ///< Last item of segment list
      int _size;              ///< Number of items in segment list
      ....
      ....

Measure 中就是保留了一个 SegmentList,其中包含了该小节下所有的 Segment

提示

功能待开通!


暂无评论~