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
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
|
//=============================================================================
// 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 __STAFF_H__
#define __STAFF_H__
/**
\file
Definition of class Staff.
*/
#include "mscore.h"
#include "velo.h"
#include "pitch.h"
#include "cleflist.h"
#include "keylist.h"
#include "stafftypelist.h"
#include "groups.h"
#include "scoreElement.h"
namespace Ms {
class InstrumentTemplate;
class XmlWriter;
class Part;
class Score;
class KeyList;
class StaffType;
class Staff;
struct ClefTypeList;
class Segment;
class Clef;
class TimeSig;
class Ottava;
class BracketItem;
enum class Key;
//---------------------------------------------------------
// SwingParameters
//---------------------------------------------------------
struct SwingParameters {
int swingUnit;
int swingRatio;
};
//---------------------------------------------------------
// Staff
/// Global staff data not directly related to drawing.
//---------------------------------------------------------
class Staff final : public ScoreElement {
public:
enum class HideMode { AUTO, ALWAYS, NEVER, INSTRUMENT };
private:
Part* _part { 0 };
ClefList clefs;
ClefTypeList _defaultClefType;
KeyList _keys;
std::map<int,TimeSig*> timesigs;
QList <BracketItem*> _brackets;
int _barLineSpan { false }; ///< true - span barline to next staff
int _barLineFrom { 0 }; ///< line of start staff to draw the barline from (0 = staff top line, ...)
int _barLineTo { 0 }; ///< line of end staff to draw the bar line to (0= staff bottom line, ...)
bool _invisible { false };
bool _cutaway { false };
bool _showIfEmpty { false }; ///< show this staff if system is empty and hideEmptyStaves is true
bool _hideSystemBarLine { false }; // no system barline if not preceded by staff with barline
HideMode _hideWhenEmpty { HideMode::AUTO }; // hide empty staves
QColor _color { MScore::defaultColor };
qreal _userDist { 0.0 }; ///< user edited extra distance
StaffTypeList _staffTypeList;
QMap<int,int> _channelList[VOICES];
QMap<int,SwingParameters> _swingList;
QMap<int,int> _capoList;
bool _playbackVoice[VOICES] { true, true, true, true };
VeloList _velocities; ///< cached value
PitchList _pitchOffsets; ///< cached value
void fillBrackets(int);
void cleanBrackets();
public:
Staff(Score* score = 0);
void init(const InstrumentTemplate*, const StaffType *staffType, int);
void initFromStaffType(const StaffType* staffType);
void init(const Staff*);
virtual ElementType type() const override { return ElementType::STAFF; }
bool isTop() const;
QString partName() const;
int rstaff() const;
int idx() const;
void read(XmlReader&);
bool readProperties(XmlReader&);
void write(XmlWriter& xml) const;
Part* part() const { return _part; }
void setPart(Part* p) { _part = p; }
BracketType bracketType(int idx) const;
int bracketSpan(int idx) const;
void setBracketType(int idx, BracketType val);
void setBracketSpan(int idx, int val);
void swapBracket(int oldIdx, int newIdx);
void changeBracketColumn(int oldColumn, int newColumn);
void addBracket(BracketItem*);
const QList<BracketItem*>& brackets() const { return _brackets; }
QList<BracketItem*>& brackets() { return _brackets; }
void cleanupBrackets();
int bracketLevels() const;
ClefList& clefList() { return clefs; }
ClefTypeList clefType(const Fraction&) const;
ClefTypeList defaultClefType() const { return _defaultClefType; }
void setDefaultClefType(const ClefTypeList& l) { _defaultClefType = l; }
ClefType clef(const Fraction&) const;
Fraction nextClefTick(const Fraction&) const;
Fraction currentClefTick(const Fraction&) const;
void setClef(Clef*);
void removeClef(const Clef*);
void addTimeSig(TimeSig*);
void removeTimeSig(TimeSig*);
void clearTimeSig();
Fraction timeStretch(const Fraction&) const;
TimeSig* timeSig(const Fraction&) const;
TimeSig* nextTimeSig(const Fraction&) const;
Fraction currentTimeSigTick(const Fraction&) const;
bool isLocalTimeSignature(const Fraction& tick) { return timeStretch(tick) != Fraction(1, 1); }
const Groups& group(const Fraction&) const;
KeyList* keyList() { return &_keys; }
Key key(const Fraction& tick) const { return keySigEvent(tick).key(); }
KeySigEvent keySigEvent(const Fraction&) const;
Fraction nextKeyTick(const Fraction&) const;
Fraction currentKeyTick(const Fraction&) const;
KeySigEvent prevKey(const Fraction&) const;
void setKey(const Fraction&, KeySigEvent);
void removeKey(const Fraction&);
bool show() const;
bool slashStyle(const Fraction&) const;
bool invisible() const { return _invisible; }
void setInvisible(bool val) { _invisible = val; }
bool cutaway() const { return _cutaway; }
void setCutaway(bool val) { _cutaway = val; }
bool showIfEmpty() const { return _showIfEmpty; }
void setShowIfEmpty(bool val) { _showIfEmpty = val; }
bool hideSystemBarLine() const { return _hideSystemBarLine; }
void setHideSystemBarLine(bool val) { _hideSystemBarLine = val; }
HideMode hideWhenEmpty() const { return _hideWhenEmpty; }
void setHideWhenEmpty(HideMode v) { _hideWhenEmpty = v; }
int barLineSpan() const { return _barLineSpan; }
int barLineFrom() const { return _barLineFrom; }
int barLineTo() const { return _barLineTo; }
void setBarLineSpan(int val) { _barLineSpan = val; }
void setBarLineFrom(int val) { _barLineFrom = val; }
void setBarLineTo(int val) { _barLineTo = val; }
qreal height() const;
int channel(const Fraction&, int voice) const;
void clearChannelList(int voice) { _channelList[voice].clear(); }
void insertIntoChannelList(int voice, const Fraction& tick, int channelId) { _channelList[voice].insert(tick.ticks(), channelId); }
SwingParameters swing(const Fraction&) const;
void clearSwingList() { _swingList.clear(); }
void insertIntoSwingList(const Fraction& tick, SwingParameters sp) { _swingList.insert(tick.ticks(), sp); }
int capo(const Fraction&) const;
void clearCapoList() { _capoList.clear(); }
void insertIntoCapoList(const Fraction& tick, int fretId) { _capoList.insert(tick.ticks(), fretId); }
//==== staff type helper function
const StaffType* staffType(const Fraction&) const;
const StaffType* constStaffType(const Fraction&) const;
StaffType* staffType(const Fraction&);
StaffType* setStaffType(const Fraction&, const StaffType&);
void removeStaffType(const Fraction&);
void staffTypeListChanged(const Fraction&);
bool isPitchedStaff(const Fraction&) const;
bool isTabStaff(const Fraction&) const;
bool isDrumStaff(const Fraction&) const;
int lines(const Fraction&) const;
void setLines(const Fraction&, int lines);
qreal lineDistance(const Fraction&) const;
void setSlashStyle(const Fraction&, bool val);
int middleLine(const Fraction&) const;
int bottomLine(const Fraction&) const;
qreal userMag(const Fraction&) const;
void setUserMag(const Fraction&, qreal m);
qreal mag(const Fraction&) const;
bool small(const Fraction&) const;
void setSmall(const Fraction&, bool val);
qreal spatium(const Fraction&) const;
//===========
VeloList& velocities() { return _velocities; }
PitchList& pitchOffsets() { return _pitchOffsets; }
int pitchOffset(const Fraction& tick) { return _pitchOffsets.pitchOffset(tick.ticks()); }
void updateOttava();
QList<Staff*> staffList() const;
bool primaryStaff() const;
qreal userDist() const { return _userDist; }
void setUserDist(qreal val) { _userDist = val; }
void spatiumChanged(qreal /*oldValue*/, qreal /*newValue*/);
void localSpatiumChanged(double oldVal, double newVal, Fraction tick);
bool genKeySig();
bool showLedgerLines(const Fraction&) const;
QColor color() const { return _color; }
void setColor(const QColor& val) { _color = val; }
void undoSetColor(const QColor& val);
void insertTime(const Fraction&, const Fraction& len);
virtual QVariant getProperty(Pid) const override;
virtual bool setProperty(Pid, const QVariant&) override;
virtual QVariant propertyDefault(Pid) const override;
BracketType innerBracket() const;
bool playbackVoice(int voice) const { return _playbackVoice[voice]; }
void setPlaybackVoice(int voice, bool val) { _playbackVoice[voice] = val; }
#ifndef NDEBUG
void dumpClefs(const char* title) const;
void dumpKeys(const char* title) const;
void dumpTimeSigs(const char*) const;
#else
void dumpClefs(const char*) const {}
void dumpKeys(const char*) const {}
void dumpTimeSigs(const char*) const {}
#endif
};
} // namespace Ms
#endif
|
