1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
|
//=============================================================================
// MuseScore
// Music Composition & Notation
//
// Copyright (C) 2002-2011 Werner Schweer
//
// This program is free software; you can redistribute it and/or modify
// it under the terms of the GNU General Public License version 2
// as published by the Free Software Foundation and appearing in
// the file LICENCE.GPL
//=============================================================================
#ifndef __PART_H__
#define __PART_H__
#include "mscore.h"
#include "instrument.h"
#include "text.h"
namespace Ms {
class XmlWriter;
class Staff;
class Score;
class InstrumentTemplate;
//---------------------------------------------------------
// @@ Part
// @P endTrack int (read only)
// @P harmonyCount int (read only)
// @P hasDrumStaff bool (read only)
// @P hasPitchedStaff bool (read only)
// @P hasTabStaff bool (read only)
// @P instrumentId string (read only)
// @P longName string
// @P lyricCount int (read only)
// @P midiChannel int (read only)
// @P midiProgram int (read only)
// @P mute bool
// @P partName string name of the part, used in the mixer
// @P shortName string
// @P show bool check/set whether or not a part is shown
// @P startTrack int (read only)
// @P volume int
//---------------------------------------------------------
class Part final : public ScoreElement {
QString _partName; ///< used in tracklist (mixer)
InstrumentList _instruments;
QList<Staff*> _staves;
QString _id; ///< used for MusicXml import
bool _show; ///< show part in partitur if true
static const int DEFAULT_COLOR = 0x3399ff;
int _color; ///User specified color for helping to label parts
public:
Part(Score* = 0);
void initFromInstrTemplate(const InstrumentTemplate*);
virtual ElementType type() const override { return ElementType::PART; }
void read(XmlReader&);
bool readProperties(XmlReader&);
void write(XmlWriter& xml) const;
int nstaves() const { return _staves.size(); }
QList<Staff*>* staves() { return &_staves; }
const QList<Staff*>* staves() const { return &_staves; }
Staff* staff(int idx) const;
void setId(const QString& s) { _id = s; }
QString id() const { return _id; }
int startTrack() const;
int endTrack() const;
QString longName(const Fraction& tick = { -1, 1 } ) const;
QString shortName(const Fraction& tick = { -1, 1 } ) const;
QString instrumentName(const Fraction& tick = { -1, 1 } ) const;
QString instrumentId(const Fraction& tick = { -1, 1 } ) const;
const QList<StaffName>& longNames(const Fraction& tick = { -1, 1 } ) const { return instrument(tick)->longNames(); }
const QList<StaffName>& shortNames(const Fraction& tick = { -1, 1 } ) const { return instrument(tick)->shortNames(); }
void setLongNames(QList<StaffName>& s, const Fraction& tick = { -1, 1 } );
void setShortNames(QList<StaffName>& s, const Fraction& tick = { -1, 1 } );
void setLongName(const QString& s);
void setShortName(const QString& s);
void setPlainLongName(const QString& s);
void setPlainShortName(const QString& s);
void setStaves(int);
int midiProgram() const;
void setMidiProgram(int, int bank = 0);
int midiChannel() const;
int midiPort() const;
void setMidiChannel(int ch, int port = -1, const Fraction& tick = {-1,1}); // tick != -1 for InstrumentChange
void insertStaff(Staff*, int idx);
void removeStaff(Staff*);
bool show() const { return _show; }
void setShow(bool val) { _show = val; }
Instrument* instrument(Fraction = { -1, 1 } );
const Instrument* instrument(Fraction = { -1, 1 }) const;
void setInstrument(Instrument*, Fraction = { -1, 1} ); // transfer ownership
void setInstrument(const Instrument&&, Fraction = { -1, 1 });
void setInstrument(const Instrument&, Fraction = { -1, 1 });
void removeInstrument(const Fraction&);
const InstrumentList* instruments() const;
void insertTime(const Fraction& tick, const Fraction& len);
QString partName() const { return _partName; }
void setPartName(const QString& s) { _partName = s; }
int color() const { return _color; }
void setColor(int value) { _color = value; }
QVariant getProperty(Pid) const override;
bool setProperty(Pid, const QVariant&) override;
int lyricCount() const;
int harmonyCount() const;
bool hasPitchedStaff() const;
bool hasTabStaff() const;
bool hasDrumStaff() const;
const Part* masterPart() const;
Part* masterPart();
// Allows not reading the same instrument twice on importing 2.X scores.
// TODO: do we need instruments info in parts at all?
friend void readPart206(Part*, XmlReader&);
};
} // namespace Ms
#endif
|
