Added old abandoned KDE3 version of the RoseGarden MIDI tool

git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/rosegarden@1097595 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 121 insertions, 0 deletions

diff --git a/src/gui/editors/notation/NotationStrings.h b/src/gui/editors/notation/NotationStrings.h
new file mode 100644
index 0000000..d79dff3
--- /dev/null
+++ b/src/gui/editors/notation/NotationStrings.h
@@ -0,0 +1,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