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
|
/* -*- c-basic-offset: 4 indent-tabs-mode: nil -*- vi:set ts=8 sts=4 sw=4: */
/*
Rosegarden
A MIDI and audio sequencer and musical notation editor.
This program is Copyright 2000-2008
Guillaume Laurent <[email protected]>,
Chris Cannam <[email protected]>,
Richard Bown <[email protected]>
The moral rights of Guillaume Laurent, Chris Cannam, and Richard
Bown to claim authorship of this work have been asserted.
Other copyrights also apply to some parts of this work. Please
see the AUTHORS file and individual file headers for details.
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version. See the file
COPYING included with this distribution for more information.
*/
#ifndef _RG_NOTATIONSTRINGS_H_
#define _RG_NOTATIONSTRINGS_H_
#include "base/Exception.h"
#include "base/NotationTypes.h"
#include <qstring.h>
#include "base/Event.h"
namespace Rosegarden
{
/**
* String factory for note names, etc. used in the GUI
* Replaces use of base/NotationTypes.h strings which should
* be used only for non-user purposes.
*/
class NotationStrings
{
public:
NotationStrings();
~NotationStrings();
/**
* Get the name of a note. The default return values are American
* (e.g. quarter note, dotted sixteenth note). If the app is
* internationalised, you will get return names local to your
* region. Note that this includes English note names- set your
* LC_LANG to en_GB.
*/
static QString getNoteName(Note note,
bool plural = false, bool triplet = false);
/**
* Get the UNTRANSLATED American name of a note. This may be
* useful if the user has specified that they'd prefer American
* names to local names.
*/
static QString getAmericanName(Note note,
bool plural = false, bool triplet = false);
/**
* Get the short name of a note. The default return values are
* American (e.g. quarter, dotted 16th). If the app is
* internationalised, you will get return names local to your
* region. Note that this includes English note names- set your
* LC_LANG to en_GB.
*/
static QString getShortNoteName(Note note,
bool plural = false, bool triplet = false);
/**
* Get the UNTRANSLATED reference name of a note or rest. This is the
* formal name used to name pixmap files and the like, so the exact
* values of these strings are pretty sensitive.
*/
static QString getReferenceName(Note note, bool isRest = false);
typedef Exception MalformedNoteName;
/**
* Get the note corresponding to the given string, which must be a
* reference name or an untranslated British, American or short name.
* May throw MalformedNoteName.
*/
static Note getNoteForName(QString name);
/**
* Construct a label to describe the given duration as a note name in
* the proper locale. Uses the nearest available note to the duration
* and returns a non-zero value in errorReturn if it was not an exact
* match for the required duration.
*/
static QString makeNoteMenuLabel(timeT duration,
bool brief,
timeT &errorReturn,
bool plural = false);
private:
/**
* Return a string representing the dotted version of the input str.
*/
static QString addDots(QString s, int dots,
bool hyphenate, bool internationalize);
};
}
#endif
|
