<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.0//EN" "dtd/kdex.dtd" [
<!ENTITY rosegarden "<application>Rosegarden</application>">
<!ENTITY MIDI "<acronym>MIDI</acronym>">
<!ENTITY % English "INCLUDE" > <!-- change language only here -->
<!ENTITY % addindex "IGNORE">
]>
<!-- The language must be changed in the <book> tag for translations. -->
<!--
Notes on style and terminology for Rosegarden handbook
======================================================
* Aim to be clear, brief and direct, but be informal.
* Write instructions in the second person.
Good: "You can select segments by clicking on
them with the arrow tool."
Bad: "Segments can be selected by clicking on
them with the arrow tool."
Very bad: "The arrow tool allows the user to select
segments by clicking on them."
If you dislike the first of these because you want to
make the phrase "the arrow tool" more obvious by placing
it at the start of the sentence, then perhaps you
should be using a variablelist instead and making
"the arrow tool" a list item.
* It's perfectly permissible to detour to explain why
something is the way it is, particularly if it might
not be obvious.
* It's also entirely permissible to omit advanced stuff
from the "Using Rosegarden" section and document it
only in the reference section. "Using Rosegarden"
should be about understanding how and why, not about
knowing every last clever detail.
* Bear in mind we can link extensively from any part of
the handbook to any other. Unfortunately DocBook won't
allow you to write a link to a target that doesn't
exist yet, so if you want to link to something that's
not yet been written, either make a note of the planned
link in an XML comment, or go and create a stub for the
bit that hasn't been written yet, or else just write in
a way that allows for a link to be easily added later
(we could do an editing phase specially for links).
* Be strict about using the correct terminology for
Rosegarden data structures (segment, event, track,
instrument, composition), but don't capitalise the
words. Capitalisation is useful in technical documents
to make it clear that you're referring to a precise
concept, but you shouldn't have to do it to make your
meaning clear in user documentation. If something
seems ambiguous without, try rewording it instead.
-->
<book id="rosegarden" lang="ja">
<!-- This header contains all of the meta-information for the document such
as Authors, publish date, the abstract, and Keywords -->
<bookinfo>
<title>Rosegarden ハンドブック</title>
<authorgroup>
<author>
<firstname>Richard</firstname>
<surname>Bown</surname>
</author>
<author>
<firstname>Chris</firstname>
<surname>Cannam</surname>
</author>
<author>
<firstname>Guillaume</firstname>
<surname>Laurent</surname>
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
<copyright>
<year>2002-2003</year>
<holder>Richard Bown, Chris Cannam, Guillaume Laurent</holder>
</copyright>
<date>2003-11-26</date>
<releaseinfo>0.9.5</releaseinfo>
<abstract>
<para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-mainwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>&rosegarden;</phrase>
</textobject>
</mediaobject>
</screenshot>
Rosegardenは音と &MIDI; シーケンサと楽譜エディタである。この
ハンドブックはどのようにこれを使うかを説明する。
</para>
</abstract>
<keywordset>
<keyword>Rosegarden</keyword>
<keyword>sequencer</keyword>
<keyword>MIDI</keyword>
<keyword>audio</keyword>
<keyword>music</keyword>
<keyword>notation</keyword>
<keyword>score</keyword>
<keyword>KDE</keyword>
</keywordset>
</bookinfo>
<!-- The contents of the documentation begins here. Label each
chapter so with the id attribute. This is necessary for two reasons:
it allows you to easily reference the chapter from other chapters of
your document, and if there is no ID, the name of the generated HTML
files will vary from time to time making it hard to manage for
maintainers and for the CVS system. Any chapter labelled (OPTIONAL)
may be left out at the author's discretion. Other chapters should
not be left out in order to maintain a consistent documentation
style across all KDE apps. -->
<chapter id="introduction">
<title>概要</title>
<para>
<application>Rosegarden</application> は&MIDI; と音シーケンサ
と楽譜エディタである。音楽の録音、編曲と作曲ができる。音楽は
従来の楽譜か&MIDI; データ、あるいは指定した任意の音源かギターか
マイクからの入力で録音されたものか、一続きの音ファイルから
インポートされたもので表現される。
sequencer and musical notation editor. It allows the user to
record, arrange and compose music. Music is represented either
by traditional score or &MIDI; data, or by sets of audio files
either imported or recorded from a microphone, guitar or
whatever audio source you care to specify. Music data can be
edited to create a composition, effects can be applied and the
resulting mix can be burnt to CD or turned into MP3/ogg format
suitable for distribution on the web. Professional notation
editing support also provides high quality printed output of the
composition.
</para>
<para>
<application>Rosegarden</application> is designed to look and
act in a manner familiar to experienced users coming to Linux
from other platforms whilst also being accessible and friendly
to users new to music software generally.
</para>
<para>
このハンドブックは参考資料と基本概念の簡単な概要と、&rosegarden; の
使用法を含んでいる。これは
<ulink url="http://rosegarden.sourceforge.net/tutorial/"> ここに
置いてあるチュートリアル</ulink> ではない。 もしも何か理解できないか、
さらに助言が必要であれば、
<ulink url="http://www.all-day-breakfast.com/rosegarden/">
Rosegarden webサイト</ulink> にFAQ とメーリングリストがあるので
見てほしい。
</para>
<!-- Note that the revhistory tags apply to the documentation
version and not to the app version. That is why we use an
ItemizedList here. -->
<sect1 id="rosegarden-revhistory">
<title>変更記録</title>
<para>
<itemizedlist>
<listitem><para>
0.9.5 – November 2003: a great many stuff
</para></listitem>
<listitem><para>
0.9.1 – May 2003: step recording, Mup export, many many bug fixes
</para></listitem>
<listitem><para>
0.9 – April 2003: many notation improvements, improved bank editor, audio enhancements and refinements, translations
</para></listitem>
<listitem><para>
0.8.5 – December 2002: bank editor, MIDI filters, panic button
</para></listitem>
<listitem><para>
0.8 – October 2002: printing, LADSPA plugins, improved Matrix View
</para></listitem>
<listitem><para>
0.2.0 – August 2002: WAV file support, sweep selections, contrapuntal staves
</para></listitem>
<listitem><para>
0.1.6 – June 2002: configuration dialog, Lilypond support, quantize dialog
</para></listitem>
<listitem><para>
0.1.5 – May 2002: KDE 3, ALSA support, JACK audio support
</para></listitem>
<listitem><para>
0.1.4 – March 2002: more undo, segment editing, audio playback
</para></listitem>
<listitem><para>
0.1.3 – January 2002: piano-roll/matrix view, &MIDI; recording
</para></listitem>
<listitem><para>
0.1.2 – November 2001: notation undo, transport dialog, position pointer
</para></listitem>
<listitem><para>
0.1.1 – October 2001: scalable notation
</para></listitem>
<listitem><para>
0.1 – June 2001: first public release of Rosegarden4
</para></listitem>
</itemizedlist>
</para>
</sect1>
</chapter>
<!--
**********************************
PART I:
Discussion and tutorial material
**********************************
-->
<chapter id="using-rosegarden">
<title>Rosegardenの使用法</title>
<!-- This chapter should tell the user how to use your app. You
should use as many sections (Chapter, Sect1, Sect3, etc...) as is
necessary to fully document your application. -->
<!-- Note that all graphics should be in .png format. Use no
gifs because of patent issues. -->
<sect1 id="file-operations">
<title>ファイルとドキュメントの基礎</title>
<para>
&rosegarden; は各々の楽曲情報を固有のドキュメントに、固有の内部
形式で格納する。ドキュメントをセーブするとき、ディスク上に、
.rg 拡張子を付けたファイルとして格納される。&rosegarden; は、
いくつかの、その他のファイル形式も扱うことができる。
</para>
<sect2 id="file-creating">
<title>新しい楽曲情報</title>
<para>
&rosegarden; の起動時には、編集を行なうための、"空白の"楽曲情報
を含む新しいドキュメントが開かれる。その楽曲情報になんらかのもの
を配置するために、何らかを録音するか、色々な編集機能を使って埋める
ことができる、長さ0(空白)の音楽("セグメント"として参照される)を
作成しなければならない。
</para>
<para>音楽の録音についての詳細の記述がある
<!-- link linkend="recording" -->録音<!-- /link
--> と、どのように音楽のセグメントを作成、編集、編集するか
が記載されている<link
linkend="segment-view">トラックエディタ</link> セクションを
参照のこと。
</para>
</sect2>
<sect2 id="file-midi">
<title>MIDIファイルの使用法</title>
<para>
MIDIファイルをインポート/エクスポートするためには、
ファイルメニューのインポートとエクスポートサブメニュー
中にある
"MIDIファイルのインポート"と"MIDIファイルのエクスポート"
を使用する。
</para>
<para>
できるにもかかわらず、内部的にはMIDIデータを格納しない。
一般的には、&rosegarden; が、MIDIにエクスポートするときに
失われる大量の情報を格納する &rosegarden; 固有の形式でセーブ
することを選択しなければならない。
</para>
<para>
MIDIファイルがロードされると、&rosegarden;は音楽データを
MIDI1トラックごとに1つのトラックに分割するか、ファイルに送り
込み、
<link linkend="studio-midi-import">は適切な楽器のマッピングを
行ない</link>、 <link
linkend="nv-quantization">MIDIパフォーマンスデータのために
もっともな楽譜</link>を計算することを試みる。
</para>
</sect2>
<sect2 id="file-merge">
<title>ファイルのマージ</title>
<para>
ファイルをロード/インポートするだけではなく、現在のドキュメント
中にそれらをマージすることも、すでにそこにあるファイル中にある
セグメントを追加することもできる。
</para>
<para>
ファイルをマージするために、オープン又はインポートオプションを
使う代わりに、ファイルメニュー中のマージサブメニュー上の適切な
オプションを使う。
</para>
</sect2>
<sect2 id="file-printing">
<title>印刷</title>
<para>
ファイルメニュー中の"印刷"機能を使うことで、
楽譜として楽曲情報を印刷することができる。
</para>
<para>
楽譜を演奏データから作成することは大変な作業なので、
ほとんどの場合、MIDIデータに基づく既定値の印刷結果がとても読み
やすいことを期待するのは無謀である。印刷する前に、楽譜を
<link linkend="notation-view">楽譜エディタ</link>
を使って整形すべきである。
(<link linkend="nv-quantization">演奏データからの作譜</link>
も参照のこと。)
</para>
<para>
注意深く扱うことによって、 &rosegarden;はとても読みやすい楽譜を
作成する能力がある。たとえそうでも、スクリーンエディタとして
デザインされたのであって、写植機ではない。本当に印刷品質の
楽譜を作成したいのであれば、&rosegarden; と結合できる
<ulink url="http://www.lilypond.org">Lilypond</ulink>
を考慮すべきである。 Lilypond は楽譜の写植を行なうソフトウェアで、
特別なテキストファイル形式を読み込み、高品質の活字化された
楽譜を生成する。
&rosegarden; はファイルメニュー中のエクスポートサブメニュー上の
"Lilypondにエクスポート"を使うことでLilypondファイルを書き出す
ことができる。
</para>
</sect2>
</sect1>
<sect1 id="segment-view">
<title>トラックエディタ</title>
<sect2 id="segment-view-overview">
<title>概要</title>
<para>
&rosegarden; のメインレイアウトは、その他の一般的なシーケンサ
とよく似たコンセプトである。これは、— のトラック
コンセプトを基礎としていて、メインウィンドウはトラックの
一覧を表示しているトラックエディタを表示し、そのトラックは、
左側の下の楽器に関連付けられている。
(<link
linkend="notation-view">notation</link>、 <link
linkend="matrix-view">matrix</link>、と <link
linkend="event-view">event list</link>)という特化した
エディタ中でセグメントそれ自身をオープンするのと同じように、
トラックエディタ上で(“セグメント”として参照
される)音楽データのブロックを移動したり操作することができる。
</para>
<para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-trackeditor.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>&rosegarden;'s Track Editor showing two segments of music data</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
<para>
トラックは、&MIDI;のレンジや、オーディオ楽器(audio instruments)
に割り当てることができる。上記の絵の中では、トラックエディタ上で
2つのセグメント(黄色がかった緑のブロックの部分)が表示されていて、
それは"IIWU Synth"という楽器に割り当てられている。
</para>
</sect2>
<sect2 id="segment-view-instruments">
<title>トラックと楽器</title>
<para>
各々のトラックは、音を鳴らすために、それに割り当てられている
楽器を持たなければならない。1つの楽器をトラックに割り当てるために、
トラックラベル上で左マウスボタンをクリックしホールドする。
するとポップアップメニューが表示され、その中に有効な楽器の
一覧が表示される。
</para>
<para>
楽器というものは、&MIDI;デバイス上の1つのチャネル、あるいは
1つのオーディオ出力として理解することができる。トラックには
&MIDI; 楽器に割り当てられなければならない音符データを含み、
それらは、音から音へのinstrumentを含んでいる。1つ以上のトラックに
同じ楽器を割り当てることができ、その場合、複数のトラックは
同じ音を使う。
</para>
<para>
<link
linkend="segment-view-instrumentparameterbox">楽器パラメータ
ボックス</link> を使うことで、トラックに割り当てられた色々な
プロパティを変更することができる。ここは、たとえば、特定の
パッチを使って特定の音(ピアノ、ストリング、その他)を出すために
MIDI楽器を設定するところである。
</para>
<para>
楽器についての詳細がある
<link linkend="studio-introduction">Studio</link> セクションを
参照のこと。 </para>
</sect2>
<sect2 id="segment-view-creating">
<title>セグメントの作成</title>
<para>
何らかの作曲を開始するために、1つの空白のセグメントを作成するために、
鉛筆ツールを使う必要がある。ツールバーの鉛筆をクリックし、
セグメントを開始したい場所でまたクリックし、
(at the correct height for the
track you want the segment to be on, and at a distance
across the editor window corresponding to the correct time)
セグメントが正しい長さのバーになるまで右にドラッグする。
</para>
<para>
既定値では、新しいセグメントはバーライン上で開始し、バー単位で
拡張するが、これは、クリックとドラッグ中シフトキーを押すことに
よってグリッドに張り付く効果を抑止できる。
</para>
<para>
一度セグメントを作成すると、
<link linkend="matrix-view">マトリクス</link> 又は <link
linkend="notation-view">notation</link>エディタを使って編集を
開始できる。それらのエディタを使うためには、セグメントをダブル
クリックするか、右マウスボタンをクリックし、コンテキストメニュー で使いたいエディタを選択する。
</para>
<para>
MIDIデバイスかオーディオ入力からの録音を考えているならば、
最初に新しいセグメントを作成する必要はない -- それぞれの分離
された録音は、録音中に自動的に作成される常に新しいセグメント
中に入る。
</para>
</sect2>
<sect2 id="segment-view-manipulating">
<title>セグメントの操作</title>
<para>
メインウィンドウはセグメントを編集するための"ツール"の集まり
が用意されている。それらはメインツールバーで有効になっている。
最初にツールバーから使いたいツールを選択し、メインキャンバス上の
セグメント上にクリックとドラッグを行なう。
</para>
<sect3 id="segment-view-selector">
<title>選択ツール</title>
<para>
"選択ツール"(矢印ツール)は実際には他目的のツールである:
それは選択、移動、コピー、リサイズとセグメントの作成に
使える。</para>
<para>
最も明白な使用方法は"選択"である:これは、選択ツールで、
セグメントを、
セグメント上でクリックすることで1つを選択するか、
シフトキーを押したままでクリックしていくつかを選択するか、
ウィンドウの空白の領域中でクリックして領域外にドラッグする。
</para>
<para>
選択ツールでセグメントを移動するためには、単にクリックし、
セグメントをドラッグする。コピーを作成するためには、クリックし、
セグメントの右端をドラッグする。新しいセグメントを作成するため
には、中マウスボタンで空白の領域をクリックしてドラッグする。
</para>
<para>
選択ツールは、時々、—が
特に小さなセグメント上で、意図している動作により明確にする必要がある
にもかかわらず、
その他のツールを完全に置き換えるものではない。
</para>
</sect3>
<sect3 id="segment-view-move-resize">
<title>移動とリサイズツール</title>
<para>
セグメントを別の開始時間又はトラックに移動するためには、
移動ツールを使い、移動したい場所に、セグメント上でクリックし
ドラッグする。もしも、Ctrlキーを押したまま移動するならば、
セグメントは移動でなはくてコピーされる。
</para>
<para>
セグメントのリサイズをしたいならば、リサイズツールを使い、
セグメントの右端をクリックし、ドラッグする。</para>
<para>
移動とリサイズの両方のために、特定のグリッド位置に張り付くのを
防ぐため、シフトキーを押すことができる。
</para>
</sect3>
<sect3 id="segment-view-split-join">
<title>分割ツール</title>
<para>
<inlinemediaobject>
<imageobject>
<imagedata fileref="rg-split.png"/>
</imageobject>
</inlinemediaobject>
を、1つのセグメントを2つの分離されたセグメントにするために
分割ツールを使うことができる。セグメントを分割するために、
分割ツールを選択し、分割したい点でクリックする。
</para>
<para>
既定値では、セグメントは、カーソルに関係した最も近いバーラインに
分割されるが、これはセグメントを分割している間シフトキーを押すこと
で抑制できる。
</para>
</sect3>
</sect2>
<sect2 id="segment-view-segmentparameterbox">
<title>セグメントパラメータボックス</title>
<para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-segmentparameterbox.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>&rosegarden;'s segment parameter box</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
<para>
セグメントパラメータボックスは、選択されたセグメントのいくつかの
外見を変更することができる。もしも1つのセグメントが現在選択され
ているのならば、そのパラメータはセグメントパラメータボックス中
で表示され、そこで編集できる。もしも複数のセグメントが選択されて
いるのならば、パラメータボックスは選択されたセグメントすべてで
現在共通な値のみが表示されるが、それらは変更でき、それはすべての
選択されたセグメントに反映される。
<variablelist>
<varlistentry>
<term>ラベル</term>
<listitem>
<para>
選択されたセグメント(もしも同じラベルを持っているならば、
複数のセグメント)のラベルを表示する。"..."ボタンをクリック
してラベルの編集ができる</para>
</listitem>
</varlistentry>
<varlistentry>
<term>繰り返し</term>
<listitem>
<para>
選択されたセグメントの繰り返しのon/offを切り替える。繰り返しを
指定されたセグメントは、同じトラック上の継続するセグメントの
開始点まで繰り返すか、継続するセグメントがない場合、楽曲の
最後まで繰り返す。
</para>
<para>
繰り返しているセグメントの繰り返している部分は、オリジナルの
セグメントに比べて、メインキャンバス上で淡い色で表示される。
セグメントメニュー上で"Turn Repeats into Copies"オプションを
使うか、単に単一の繰り返しブロック上でダブルクリックを行なう
ことによって、オリジナルのセグメントを真に編集可能なコピーに
変更することができる。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Quantize</term>
<listitem>
<para>
選択されたセグメントのquantizationを表示する。
すべてのそれらの音符の開始時間を簡単にquantize
するために、これを変更することができる。
より詳細なquantizationはセグメントメニュー上の
Quantize機能を使う。 <link
linkend="quantization">Quantization</link>
に詳細がある。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Transpose</term>
<listitem>
<para>
選択されたセグメントに現在適用されているtransposition(in semitones)
を表示する。このtranspositionはセグメントが演奏されるときに適用され、
マトリクス、notationまたはイベントリストエディタ内で表示される音符
では見えない。楽曲全部または一部分のピッチを簡単に変更するために、
これを使うことができる。</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ディレイ</term>
<listitem>
<para>
選択されたセグメント上で現在効力のあるディレイを表示する。
演奏するために、後で書くより、セグメント全体にさせるために、
ここでディレイを設定することができる。このディレイはセグメントが
演奏されるときに適用されるが、マトリクス、notationまたはイベント
リストエディタ内で表示される音符では見えない。
</para>
<para>
You can set a delay either in musical time (by
choosing a note duration from the delay dropdown),
in which time the exact delay will depend on the
tempo, or in real time (by choosing a time in
milliseconds from the dropdown).
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>色</term>
<listitem>
<para>
選択されたセグメントが表示されるときに使われる色を表示する。
ドロップダウン機能を使うか、ドロップダウンで見付からない場合、
"新しい色を追加"オプションを選択することでその他の色を選択できる。
</para>
<para>
編集メニュー上の"ドキュメントプロパティの編集"
(ドキュメントプロパティダイアログの色ページを選択)
を使うことによって色の管理と名前の変更もできる。
変更された色のパレットはRosegardenファイル中の楽曲
データと共にセーブされる。
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-colours.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>&rosegarden;の色マネージャ</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2 id="segment-view-instrumentparameterbox">
<title>楽器パラメータボックス</title>
<para>
</para>
</sect2>
</sect1>
<sect1 id="transport">
<title>The Transport</title>
<para>
トラックエディタは、割り当てられた楽器にたいして配置される一連の
セグメントを表示する。楽曲を演奏するとき、&rosegarden; はそれが
クロスしているセグメントの内容を演奏するときに左から右へとトラック
上でポインタを横切る。画面上でのポインタの位置は、Transportと
呼ばれるダイアログによってtrackされ制御される。
</para>
<para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-transport.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>&rosegarden;'s Transport dialog</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
<para>
もしもTransportが見えないならば設定メニューに行くことで
有効にできる。
(<menuchoice> <guimenu lang="ja">設定</guimenu>
<guimenuitem>Transportの表示</guimenuitem> </menuchoice>).
</para>
<para>
Transportは最初のバー(秒単位)または、24-fps<acronym>SMPTE
</acronym>中の時間又は代わりにバーとビートからの絶対時間の
ポインタの現在位置を表示する。それは、希望するならば、
楽曲の最後からの時間も表示できる。それらの機能はメインの
transport表示の左にある小さなボタンによって制御できる。
</para>
<para>
transport上のメインコントロールはシーケンサの演奏を起動、一時停止、
ポインタの位置の早送り、巻き戻し、停止または楽曲の最初/最後への
移動を行なう。
</para>
<para>
追加のコントロールと &MIDI; イベントはtransport上の下部にある
矢印ボタンの左に隣接しているものでon/offすることができる。
さらに、この特別な部分は録音、ループ、ソロとメトロノームの実行
ボタンがある。
</para>
</sect1>
<sect1 id="studio">
<title>スタジオ</title>
<sect2 id="studio-introduction">
<title>デバイス、楽器と接続</title>
<para>
Rosegardenは"スタジオ"という単語をコンピュータに繋がれる
サウンドシステムについて知っているモのすべてを参照するために
使う。これは、&MIDI; とオーディオ用のハードウェアとその他の
サウンドソフトウェアを含んでもよく、さらに、接続状態の情報と
構成(configuration)と&MIDI; パッチやその他を含んでもよい。
</para>
<para>
用語の3つの部分はここで重要である:
<variablelist>
<varlistentry>
<term>デバイス</term>
<listitem>
<para>
<quote>デバイス</quote>はRosegardenの範囲において
関係するものは、単に音を生成する能力がある何かである。
これはMIDIシンセサイザーやオーディオデバイスでもよい。
MIDIデバイスは物理的なMIDIポートに直接対応する必要は
ない:それらは参照することができ、特定の手段で動作する
ことを期待する、名前を持つ何らかのものである。MIDIパッチ
マップのような構成情報は、デバイスに割り当てることができる。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>楽器</term>
<listitem>
<para>
各々のデバイスはいくつかの<quote>楽器</quote>をもち、
それらの各々は、特定の音を作るために仮定される。それらは
音を演奏するために選択されたトラックに割り当てることができる
ものである。既定値ではデバイスは起動時に生成される16の
楽器を持つ:もしも、デバイスがMIDIデバイスであれば、16の
MIDIチャネルのうちの1つに初期化される。楽器はたとえば、
プログラムの設定、リバーブ(reverb)、ボイスなどのような
特定のボイスのすべてのプロパティである。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>接続</term>
<listitem>
<para>
MIDIデバイスが単に名前で、構成情報の集合の間は<quote>
接続</quote>はどのMIDIポートに物理的に割り当てられている
かを指定する。これは、MIDIデバイス管理ダイアログ中で構成
することができる(オーディオデバイスは同じ方法では接続を
もたない)。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
例をあげると、セットアップが、2つの物理MIDIポートを持つPC
によって成り立っていて、その1つは外部のシンセサイザー
が接続されていることを想像する。ここでは1台のシンセサイザーに
対応するMIDIデバイスを持つために、通常Resegardenを構成する。
次に、このデバイスについて、名前を修正し、マップをパッチする
ように構成することができ、次にサウンドカードの関連するMIDI
ポートにそれを結合するために接続を指定する。それぞれの16個の
デバイス上の既定値の楽器は適切なプログラムとともに構成でき、
それらをトラックに割り当てられる。</para>
<para>
実際の所、Rosegardenは既定値で、起動時に有効な接続をおのおのの
デバイスに対して作成するだろう。そのため、上記の例では、
2つのMIDIデバイスは1つのみが必要だったとしても既定値で2つの
デバイスが作成されるだろう。一般的に、最初のものに対して
名前を変え、パッチマップを適用し、2つめのものに対しては、
削除するか未使用にする。コンピュータ上のMIDIポートに実際に
どのシンセサイザーが接続されているかをRosegardenが知るすべは
ないことを記憶しておくこと。この理由により、起動時に作成され
るデバイスは、既定値のセットになる予定であり、構成するデバイスが
本当に使うものに一致しているかどうかはあなた次第である。
</para>
<para>
一度構成されると、スタジオのセットアップはセーブするRosegarden
形式のファイルに毎回保存される。
</para>
</sect2>
<sect2 id="studio-midi-import">
<title>&MIDI; インポート上のスタジオのマッピング</title>
<para>
楽曲情報に &MIDI;ファイルをインポートするとき、&rosegarden; は
&rosegarden; の楽器上に &MIDI; プログラムをどのようにマップするかを
決めるために、存在するスタジオのセットアップを使用する。
目的は、スタジオ中に実際に存在するマップされた1つの楽器を、
すべての &MIDI; プログラムが得ることを確実にすることであり、
(そして、そういう理由で、実際にコンピュータに割り当てられる)
そのため、すべての &MIDI;トラックは聞くことができる。
</para><para>
インポートされたファイル中に見付かった、&MIDI; プログラム
チェンジとバンクセレクトイベントはインポートのときに使用されるが、
スタジオ中の1まとまりの楽器から各々の&MIDI;トラックのための
適切な楽器を見つけるのを手助けする手段としてのみ使われる。そのため、
例をあげると、もしもスタジオが現在<acronym>GM</acronym>楽器(音源)
のみ含んでいるようにセットアップされていた場合で、
<acronym>GS</acronym> プログラムチェンジをその上に含む&MIDI;ファイル
をインポートした場合、&rosegarden;は<acronym>GS</acronym>バンク
を<acronym>GM</acronym>にリマップする。なぜならば、ファイルを
インポートするときに知っているすべてだからである。オリジナルの
<acronym>GS</acronym> プログラムナンバーを憶えているわけではない。
</para><para>
このことは、&MIDI; ファイルをインポートする前に、
実際に持っているデバイス向けに正しくスタジオを
構成することを確実にしなければならない、ということを意味する。
それ以外では、&MIDI;ファイル中のプログラムデータは失われるだ
ろう。
</para>
</sect2>
<sect2 id="studio-device-editor">
<title>MIDIデバイスの管理</title>
<para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-devicemanager.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>The MIDI device manager</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
<para>
MIDIデバイスマネージャダイアログは現在有効なMIDIデバイスと
どこに繋がっているかを表示する。このダイアログに到達する
ためには、スタジオメニューのMIDIデバイス管理機能を使う。
</para>
<para>
<link linkend="studio-introduction"> デバイス、楽器、と接続
</link> 中で説明されているように、既定値では Rosegardenは
起動時に、もっともらしいデバイスのセットを提供しようとする。
しかし、既定値の構成では、通常は最適ではないかもしれないので、
このダイアログはデバイスの名前を変更し、それらの接続を変更
し、再生/録音方向の接続を修正する。
</para>
<para>
各々のここでリストされた再生デバイスは、通信(talk to)するため
のMIDIトラックのためのターゲットを提供する。もしも、新しい
再生デバイスを追加するならば、トラックに割り当てることができる
このデバイス上の16の新しい楽器を持つことができるだろう。
もしも、そのデバイスに対する接続を割り当てるならば、
トラックはその接続に割り当てられた任意のMIDIシンセサイザー
の適切なチャネル(楽器によって依存する)で再生するために
割り当てられる。
</para>
<para>
ここでリストされた録音デバイスは、MIDIを録音することが
可能なソースを意味する。それらの1つはこのダイアログ中でその
時点で有効状態になっている。
</para>
</sect2>
<sect2 id="studio-bank-editor">
<title>MIDIデバイスのバンクとプログラムの管理</title>
<para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-bankeditor.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>The MIDI bank and program editor</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
<para>
おのおののMIDIデバイスは複数の楽器を含み、それらの楽器を
トラックに割り当てることができることを憶えておくこと。
MIDI用語中では、おのおのの楽器はMIDIシンセサイザー上の
1つのチャネルに対応する。使用する各々の楽器のシンセサイザー
上の有効なボイス(サウンド)のどれかを選択することができるが、
この理由により、すべての有効なボイスの名前をRosegardenが
知っているようにする必要がある。
</para>
<para>
このダイアログはプログラムのバンク(ボイスの名前)をMIDIデバイス
に接続することを可能にし、それゆえ、
<link
linkend="segment-view-instrumentparameterbox">
楽器パラメータボックス</link>
中のそれらのボイスの1つを使うために、デバイス上の各々の楽器は
セットされる。
</para>
<para>
デバイスのプログラム名をセットアップするための通常の方法は、
単に提供されるデバイスファイル(".rgd")の1つからそれらを
インポートすることである。これを行なうために、ダイアログの
左のリスト中のデバイスを選択し、リストの下のインポートボタン
をクリックし、シンセサイザーに対応する.rgdファイルを選択する。
</para>
<para>
もしも、シンセサイザー用に何らの.rgdファイルが有効になっていない
のであれば、新しいバンクを作るためにこのダイアログを使うことが
できる。これを行なうために、シンセサイザーのMIDI実装チャート中の
プログラムマップを見つけ、すべての名前を手入力で入力する必要が
ある。次にそれを他のRosegardenユーザのために.rgdファイルに
エクスポートする。もしもそれを共有したいのであれば、
rosegarden-userメーリングリストにコンタクトしてほしい(これは
どのようにして、Rosegardenと共に存在するすべての.rgdファイルが
含まれているかの理由である)。
</para>
<para>
もしも、ソフトウェアシンセサイザーかSountFont(.sf2)ファイルを
使うサウンドカードを使っているならば、このダイアログ中に
.sf2ファイルから正しいプログラム名を単純に直接ロードすることが
できる。通常と同じようにインポートをも止められたら、.rgdファイル
の代わりに.sf2ファイルを選択する。
</para>
<sect3 id="studio-variations">
<title>Variations</title>
<para>
いくつかのMIDIデバイス(たとえばローランドからのもの)は、
"variations"として知られているスキームを使うプログラム名
を体系化している。それらのデバイスのために、一般的に
基本的なプログラム名—を最初に選択することによって
プログラムを選択したい。そして、電子ピアノのようなプログラム
—上の1セットのvariationsを選択する。これは、一般的な
MIDIベースのシンセサイザーと対象的であり、それはバンク中に
それらのプログラムを組織化し、バンクを最初に選択することを
期待し、次にそのバンクからプログラムを選択する。
</para>
<para>
Rosegarden はvariationを使うデバイスをサポートできるが、
バンクフォーマット中にプログラム名を入力しなければならない。
内部的に、variationを使うデバイスはvariationsとの間で
選択するために、MIDIバンク選択コントローラを使う。
variationを選択するために、デバイスがLSBかMSBのどちらかの
バンクセレクトを使うかを、シンセサイザーのドキュメントから
見つけ出す必要があり、どのバンク番号がどのvariationに
対応しているかを見つけ出す必要がある。次に、通常として、
バンクを入力し、バンクダイアログ上の、
"MSB/LSB上のVariationリストの表示"オプションを使い、
Rosegardenに楽器パラメータボックス内でそのデバイスが表示される
ときにバンクの代わりにvariationが表示するように伝える。
</para>
</sect3>
</sect2>
<sect2 id="studio-metronome">
<title>メトロノーム</title>
<para>
Rosegarden は内蔵の2ツのメトロノ
録音中に使い、もう一つは通常の再生中にスイッチすることができる。
それらはMIDI楽器にノ
メトロノームは同じ楽器、ピッチとベロシティ情報を使う。
</para>
<para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-metronome.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>&rosegarden;'s metronome configuration dialog</phrase>
</textobject>
</mediaobject>
</screenshot>
メトロノームを構成するためには、スタジオメニュー上の
"メトロノームの管理"オプションを使いメトロノームダイアログを
起動する。そののち、メトロノ ノ
の解像度(1つのビートあたりのティック、ビートの再分割、
あるいはビートあたり1つ)を選択できる。MIDIシンセサイザーの
実際のボイスのようなプロパティは選択された楽器に依存する
メトロノームのティックのために使われ、トラックに割り当てられた
楽器に依存するMIDIトラックのために使われるボイスのようである。
メインウィンドウ上でそれにをラックを割り当てることで楽器を
構成することができ、楽器パラメータボックスから正しいプログラム
を選択することができる。
</para>
<para>
メトロノ ノ
ボタンによってonまたはoffすることができる。このボタンは
録音が供給されているか、実行中の時にメトロノームの録音を制御し、
録音メトロノ ノ
</para>
</sect2>
<sect2 id="studio-midi-filters">
<title>MIDIフィルタ</title>
<para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-midifilter.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>The MIDI filter dialog</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
<para>
このダイアログを使うことで、どのMIDIイベントをRosegardenが
MIDI THRUを使ってイベントを送るか、それを単に録音するかで
受け付けたり無視したりすることを決められる。このダイアログ上の
チェックボックスを使うことで、RosegardenにどのタイプのMIDI
イベントを送るか録音するかを希望しないことを伝える。
</para>
</sect2>
</sect1>
<sect1 id="quantization">
<title>Quantization</title>
<para>
"Quantization" は音符の再ポジショニングのプロセスとその他の
イベントであり、 so that they start or finish on exact beat divisions.
It is traditionally used to make an approximate performance
into a precise but rather mechanical-sounding one, either
because precision is the desired effect or for a result such
as making the notes clearer in notation.
</para>
<para>
The quickest way to quantize something is to do it in the main
window, using the Quantize menu on the <link
linkend="segment-view-segmentparameterbox">Segment Parameter
Box</link>. If you select some segments and change the value
shown in the menu, the segments will immediately be quantized
so that all their notes start at multiples of the note
duration in the menu.
</para>
<para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-gridquantizer.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>&rosegarden;'s quantize dialog</phrase>
</textobject>
</mediaobject>
</screenshot>
For more control, use the Quantize function on the Segments
menu of the main window, or on the Transforms menu of the
matrix or notation editors. This shows you a dialog in which
you can select the precise quantization parameters you need,
and then it applies these to all of the selected segments or
notes.
</para>
<para>
<!-- !!! to be continued -->
</para>
</sect1>
<sect1 id="matrix-view">
<title>マトリクスエディタ</title>
<para>
&rosegarden;のマトリクスエディタは、クリヤで論理的な形式で
音楽を表示し、編集することを可能にする。それぞれの音符は
グリッド中のブロックとして表わされ、高さはピッチに関連する。
</para>
<para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-matrixview.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>&rosegarden;'s matrix editor</phrase>
</textobject>
</mediaobject>
</screenshot>
それぞれのマトリクスエディタウィンドウは1つのセグメントを表示する。
セグメントを編集するために、メインキャンバス上で右クリックし、
メニューからマトリクスエディタを選択する。代わりに、セグメントを
ダブルクリックするときにマトリクスエディタが既定値のエディタに
なるようにRosegardenを設定することも可能である。
</para>
<sect2 id="matrix-insertion">
<title>音符の挿入</title>
<para>
マトリクスビューにノートを挿入する一番簡単な方法は、マウスを
使うことである。これを行なうために、ツールバー上で鉛筆ツール
を選択し、マトリクスエディタ上にクリックしドラッグする。
音符と、そこでクリックした点に関連するピッチが入力され、
マウスボタンをリリースする前に関連した距離に関連するduration
を持つだろう。
</para>
<para>
既定値では、時間とdurationはツールバー又は表示メニュー上のグリッド
設定に添った形で、特定のグリッドユニットに貼り付けられる。
クリックとドラッグ中にシフトキーを押したままにすることでこの効果を
抑止できる。
</para>
<sect3 id="matrix-insertion-keyboard">
<title>PCキーボードからのノ
<sect4>
<title>Duration</title>
<para>
キーボードからのノ
表示メニュー上のグリッド設定によって制御される。これを
以下の数字キーを使って設定することができる:</para>
<itemizedlist>
<listitem><para><keycap>5</keycap> – Whole bar</para></listitem>
<listitem><para><keycap>1</keycap> – Beat</para></listitem>
<listitem><para><keycap>2</keycap> – Half note (minim)</para></listitem>
<listitem><para><keycap>4</keycap> – Quarter note (crotchet)</para></listitem>
<listitem><para><keycap>8</keycap> – Eighth note (quaver)</para></listitem>
<listitem><para><keycap>6</keycap> – Sixteenth note (semiquaver)</para></listitem>
<listitem><para><keycap>3</keycap> – Thirty-second note (demisemiquaver)</para></listitem>
<listitem><para><keycap>0</keycap> – Sixty-fourth note (hemidemisemiquaver)</para></listitem>
</itemizedlist>
</sect4>
<sect4>
<title>ピッチ</title>
<para>
一旦正確なdurationがグリッドメニュー中で選択されると、
以下のピッチキーの1つを押すことによって、
<link linkend="nv-rulers">カーソルの挿入</link>による
現在の位置にノートを挿入できる。
</para>
<itemizedlist>
<listitem><para><keycap>A</keycap> – ド (the tonic of the current key in the current clef)<!-- !!! FIXME: no clef in matrix view --></para></listitem>
<listitem><para><keycap>S</keycap> – レ</para></listitem>
<listitem><para><keycap>D</keycap> – ミ</para></listitem>
<listitem><para><keycap>F</keycap> – ファ</para></listitem>
<listitem><para><keycap>J</keycap> – ソ</para></listitem>
<listitem><para><keycap>K</keycap> – ラ</para></listitem>
<listitem><para><keycap>L</keycap> – シ</para></listitem>
</itemizedlist>
<para>キーを押す間に<keycap>Shiftキー</keycap>を押すと、
ノートが半音上がり、(シャープが定義されていないミとシは
除く) <keycap>Shift</keycap>と<keycap>Ctrl</keycap>キーを
一緒に押すと、半音下がる(ファとドを除く)</para>
<para>
1オクターブ上を入力する場合は、
use the corresponding
keys on the next row up: <keycap>Q</keycap>,
<keycap>W</keycap>, <keycap>E</keycap>, <keycap>R</keycap>,
<keycap>U</keycap>, <keycap>I</keycap>, と
<keycap>O</keycap>を使う。
同様に、1オクターブ下を入力する場合には
<keycap>Z</keycap>, <keycap>X</keycap>,
<keycap>C</keycap>, <keycap>V</keycap>, <keycap>B</keycap>,
<keycap>N</keycap> と <keycap>M</keycap>を使う。</para>
</sect4>
<sect4>
<title>その他の注意すべき点</title>
<para>
すべてのコマンドの挿入はツールメニューのサブメニュー上で
有効である。たった1つのノ
辿っていくことはありそうもないが、メニューはキーボード
ショートカットを表示しているので、どのキーがどの機能に
割り当てられているかを忘れた場合には役に立つリファレンスを
提供する。</para>
<para>
キーボードショートカットはQWERTYレイアウトキーボード用に
現在デザインされている。その他のレイアウトにキーをリマップ
する方法はまだなく、設定メニュー上の"ショートカットの構成"
オプションを使うことによって各々のキーの再定義を個別に行なう??。
short of reassigning each
key individually using the "Configure Shortcuts..." option
on the Settings menu.</para>
</sect4>
</sect3>
<sect3 id="matrix-insertion-midi">
<title>MIDIキーボードからのノ
<para>
MIDIキーボード又はその他のMIDI制御デバイスを使うことで
マトリクスエディタ中にノートを入力することができる。
マトリクスエディタはキーボード上で演奏したピッチを使うが、
durationsはエディタそれ自身でのグリッドの設定中で選択したもの
You can enter notes into the matrix editor one at a time
using a MIDI keyboard or other MIDI control device. The
matrix editor uses the pitches you play on the keyboard,
but the durations you have selected in the Grid setting of
the editor itself. これは"ステップ録音"として知られている。
</para>
<para>
MIDIキーボードからノ
MIDIデバイスにキーボードを構成することを確実にする必要が
ある。次に、ツールバー又は表示メニュー中で、このコントロールが、
ノ
Then make sure you have the right Grid
setting in the View menu or toolbar, as this controls the
note duration.
次に、マトリクスエディタのツールバー上のステップ録音ボタンか
ツールメニューのステップ録音を選択する。MIDIキーボード上で
押されたすべてのノート上のその点は、ウィンドウがクローズするか、
別のウィンドウが有効になるか、再度ステップ録音がoffにされるまで
そのウィンドウ中に現在の挿入時間で挿入される。
</para>
<para>
異なったdurationのノ
中の間グリッド設定を変更することができる。
</para>
</sect3>
</sect2>
<sect2 id="matrix-selection">
<title>ノートの選択</title> <para>
マトリクスエディタ中でノートを選択するために、選択(矢印)ツール
にスイッチし、次に、選択したいノートを含む四角の領域を囲む。
選択されたイベントは青でハイライトされる。もしも1つのイベント
上で代わりにクリックすると、そのイベントのみが選択される。
</para><para>
もしも、<keycap>シフト</keycap>キーを、ノートをクリックするか、
四角で囲む間押しているならば、新しい選択が、置き代わる代わりに
存在する任意の選択に追加される。
</para>
<para>
選択を解除したい場合には、マトリクスエディタの空白の場所で
クリックするか、エスケープキーを押す。</para>
<para>
マトリクスエディタの左端のピアノキーボードの下中でキー上で
シフトしながらクリックすることによって与えられたピッチの
ノートをすべて選択することができる。ピッチの範囲を選択する
ために、シフトキーをOSIながらドラッグすることもできる。この選択
は、今まで選択したものに追加されるので、新しく選択したい場合には
古いものを先に消す。
</para>
</sect2>
<sect2 id="matrix-editing">
<title>音符の移動とコピー</title>
<para>
移動ツールと共にクリックしてドラッグするか、選択の後
選択ツールと共にドラッグするかをマトリクスエディタで
行なうことによって時間とピッチの両方中でノートを移動
することができる。
</para>
<para>
ノートをコピーするためには、まず選択し、標準のコピーと
貼り付け機能を使う。貼り付け後、張り付けられた音符は
代わりに選択され、必要なところにどこにもドラッグすることが
できる。
</para>
</sect2>
<sect2 id="matrix-view-options">
<title>マトリクス表示の設定</title>
<para>
<!-- zoom, rulers etc -->
</para>
</sect2>
</sect1>
<sect1 id="notation-view">
<title>Notationエディタ</title>
<!-- Introduction, purpose -->
<sect2 id="nv-introduction">
<title>概要</title>
<para>
&rosegarden;のnotationエディタは、伝統的なスコア記法中で
1つまたはそれ以上のstaffを表示、編集することを可能にする。
</para><para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-notationview.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>&rosegarden;'s notation editor</phrase>
</textobject>
</mediaobject>
</screenshot>
&rosegarden; はシーケンサアプリケーションとして、その主要な
焦点と互換性を持つ、最高のレイアウトを提供しようとする。
This means that although the editor supports
chords, overlapping and nested beamed groups, triplets and
arbitrary tuplets, grace notes, dynamics, accents, text and
so on, it does not provide as much fine control over layout
(especially in contrapuntal music) as a dedicated score
editing program might.
写植によい形式である、
<link linkend="commands-main-file-export-lilypond">
Lilypondファイル</link> を書くことができるのにもかかわらず、
写植品質の楽譜を&rosegarden;は生成することを目的としない。
</para>
</sect2>
<!-- Single and multiple staffs, and "current staff" -->
<sect2 id="nv-staffs">
<title>1つまたは複数のstaff</title>
<para>
&rosegarden;メインウィンドウからnotationエディタを開く
3つの方法がある(それらはすべて、メインウィンドウに
いくつかのセグメントが存在することを最初に要求し、
そのため、もしも、新しい楽曲構成を始めるならば、
それを編集することを考え始める前に、セグメントを
作成する必要がある)。
<variablelist>
<varlistentry>
<term>セグメント上でのダブルクリック</term>
<listitem>
<para>
最も明らかな手段は、メインキャンバス中でセグメントを
ダブルクリックする方法である。これは既定のエディタ
(notation、マトリクスまたはイベントリスト)として
構成されているもので、どこででもセグメントを
オープンし、既定値でこれはnotationエディタである。
そのため、Notationエディタウィンドウ中で1つの
staffとして、1つのセグメントをダブルクリックする
と開く。</para>
<para>
この方法で複数のstaffをオープンすることもできる。
シフトキーを押しながら、オープンしたい複数のセグメントの
各々を、メイン表示上で選択(1つのマウスクリック)するが、
最後のものをダブルクリックする。選択されたすべての
セグメントは1つのnotationウィンドウ中に一緒に
オープンされる。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>既定のエディタメニュー機能でのオープン(リターンキー)</term>
<listitem>
<para>
リターンキーは既定のエディタメニュー機能の中のオープン
のショートカットであり、それはダブルクリックと同じ
である。notationエディタ中で現在選択されている
セグメントすべてをまとめてオープンするか、既定値として
構成したその他のエディタでオープンする。</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Notationエディタメニュー機能内でのオープン</term>
<listitem>
<para>代わりに、メインウィンドウのメニュー機能内の
オープンた、キャンバス内のセグメント上の右ボタンの
ポップアップメニュー上でオープンすることもできる。
希望のセグメントを選択(上記のようにシフトキー+クリックか、
<link linkend="commands-main-edit-select-all-segments">
すべてのセグメントの選択</link>機能のどちらか)し、
次に、Notationエディタ中でオープンを選択する。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
もしも1つ以上のstaff(すなわちセグメント)をnotationエディタ
内で表示したいのであれば、一時にそのうちの1つのみが"カレント"
にできる。
カレントstaffは、その上に挿入カーソルを持つことで識別すること
ができ(<link linkend="nv-rulers">ルーラとカーソル</link>
を参照)、挿入用カーソルを使う編集操作が起こった上のstaff
である。this is the staff on which any editing
operations that use the insert cursor will take place.
最上部のstaffは既定値ではカレントであるが、その上で
コントロールキーを押しながらクリックするか、
Staff上のカーソルを上に
とStaff上のカーソルを下にメニュー機能を使うことで、
違ったstaffに切り替えることができる。
</para>
</sect2>
<!-- Linear and page layouts -->
<sect2 id="nv-layout">
<title>リニアとページレイアウト</title>
<para>
notationエディタがstaffを表示する通常の方法は、
リニアレイアウトとして知られているものである。1つのstaff
がその他の一番上にあり、それぞれのstaffは単独の、水平に
スクロール可能な長い行になっている。エディタ上のいくつかの
機能は(<link linkend="nv-rulers">ルーラ</link>のようなもの)
リニアレイアウトのみで有効である。
</para>
<para>
しかし、2つの違ったページベースのレイアウト内でstaffを
表示させることも可能である。継続(Continuous)ページ
と複数(Multiple)ページである。</para>
<para>
継続ページレイアウト内では、楽曲はウィンドウとして同じ
幅の無限の高さのページとして編集される。各々のstaffは
各行の終わりで区切られ、残りのstaffを以下に持つ新しい
行で始まる。
</para>
<para>
複数ページレイアウトでは楽曲は印刷されるときに真のページに
分割される。それぞれのページのサイズは、実際に印刷される
的にそれぞれのラインにほぼ同じ量の楽曲がフィットするように
計算される(構成ダイアログ中で印刷の改造度のために指定された
ポイントサイズに従って)。印刷バージョンは、印刷するときに
明確な紙の大きさとマージンに依存するので、まったく同じという
ことはありそうもないが、A4サイズを使うときにはそれはかなり
近くなければならない。
</para>
<para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-notationview-multipage.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>複数ページレイアウトでの&rosegarden;のnotationエディタ</phrase>
</textobject>
</mediaobject>
</screenshot>
ほとんど、但し全部ではない、表示と編集機能はリニアレイアウト
と同じようにページレイアウトモードで動く。
</para>
<para>
3つのレイアウトモードを切り替えるためには、リニアレイアウト、
継続ページレイアウトと複数ページレイアウトメニュー機能を使う。
</para>
</sect2>
<!-- Rulers and Cursors -->
<sect2 id="nv-rulers">
<title>ルーラとカーソル</title>
<para>
&rosegarden;notation エディタウィンドウは2つのルーラと
カーソルを含んでいる。ルーラはメインnotationキャンバスの
上から下までtickmarkとともに水平のstripで分割されていて、
カーソルはエディタ中のトップのstaffの開始点に初期状態として
垂直の色が付いた行としてある。
</para>
<para>
紫色のカーソルは挿入カーソルである。これは、挿入かペースト
が起こるような動作のポイントを表示する。上部のルーラ上で
ドラッグかクリックをするか、(任意のイベントを避ける)空白の
staffの一部上でクリックするかドラッグするか、<keycap>
コントロール</keycap>キーを押したままどこかでクリックすること
で挿入カーソルを移動することができる。
</para>
<para>
一度に1つのイベントを、挿入カーソルを移動するために、左か右の
矢印キーを使うことができる。もしも<keycap>コントロール</keycap>
キーを、矢印キーを押すときに押していると、カーソルは一度に
すべてのバーを移動する。もしもシフトキーを押しているならば、
カーソルはそれらをパスするように、
<link linkend="nv-tools-selections">イベントの選択</link>
を行なう。
</para>
<para>
青のカーソルは再生ポインタである。マトリクス表示とメイン
ウィンドウ内の同様のカーソルと同じく、これは、現在の再生
または録音位置を示す。これは下の方のルーラで位置を変更できる。
</para>
<para>
ルーラは<link linkend="nv-layout">リニアレイアウト</link>
モードでのみ表示されることに注意。
</para>
</sect2>
<!-- Display conventions (annotated picture with some selected notes,
some quantized notes, a bar of incorrect length etc) -->
<!-- Tools and Selections -->
<sect2 id="nv-tools-selections">
<title>ツールと選択</title>
<para>
ほとんどの、&rosegarden; Notationエディタのメニューと
ツールバー編集機能は<quote>ツール</quote>、<quote>
選択を行なう機能</quote>と<quote>ドラッグ操作</quote>
の3つの機能に分類される。
</para>
<variablelist>
<varlistentry>
<term>ツール</term>
<listitem>
<para>
基本的なツールはツールバーボタンから通常アクセスできる、
選択ツール、消去ツールと、ノ
その他のためのそれらである。ツールを選択すると、代わりに
少なくとも他のツールが選択されるまで、メインnotation
キャンバス上でマウスボタンの既定の動作が変わる。たとえば、
選択ツールを選択すると、選択が可能になり、(以下の)
選択ベースの機能が使えるようになる。挿入ツールを選択すると
(たとえばノ
切り替えられ、キャンバス上でクリックすることでノートを
挿入できる。削除ツールはそれらをクリックすることでイベントを
削除する。
</para>
<para>
ツール目丹生を使うことで現在のツールを変更することもできる。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>選択操作上の機能</term>
<listitem>
<para>
残りの大多数のメニュー機能は使うことができる前にキャンバス
上で選択されることを要求する。そのうちのいくつかは、
(たとえば、<guimenuitem>Cut</guimenuitem> や
<guimenuitem>Note スタイル</guimenuitem>機能)
選択されたイベント上で動作する。その他は
(たとえば<guimenuitem>Grace Notes</guimenuitem>や
<guimenuitem>Stem Directions</guimenuitem>機能)
選択がいくつかのnoteを含むまで実行を凍結する。
</para>
<para>
キャンバス上のいくつかのイベントを選択するために、
選択(矢印)ツールに切り替え、選択したいイベントを含む
矩形領域を囲む。選択されたイベントは、青にハイライト
される。もしも1つのイベント上でクリックすると、
そのイベントのみが選択される。
<footnote><para>
そのイベントのために編集ダイアログをオープンするために
1つのイベント上でダブルクリックをすることもできるが、
それは選択には何の動作もしない。</para></footnote>。
</para>
<para>
もしも、<keycap>シフト</keycap>を矩形領域からドラッグ
アウトする間押しているならば、そのコンテンツは置換の
変わりに存在する任意の選択に追加される。
</para>
<para>
すべてのバーを選択するために、そのバー内のどこか空白の
場所で、選択ツールと共にダブルクリックする。staffのすべて
をセンタｃ
挿入カーソルの位置上を元にした拡張領域を選択するための
機能を運び、シフトキーと左又は右矢印キーを押すことによって、
挿入カーソルの周りのイベントを選択できる。
</para>
<para>
一度に、1つのstaffより多くイベントを選択することはできない。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ドラッグ操作</term>
<listitem>
<para>
あるものの周りでドラッグを行なうことでひとまとまりの編集を
確実にすることができる。選択(矢印)ツールに切り替え、
ノートのピッチを、その頭を上か下にクリックし、ドラッグする
ことによって変更でき、noteの時間とその他のイベントは、
それらを左か右にドラッグすることによって変更できる。
(残りの時間シグネチャにドラッグできないが、それ以外は
すべてドラッグできる。もしも1つ以上のイベントを選択
しているならば、一度にすべての選択がドラッグされる。)
</para>
<para>
ドラッグは通常ツールバー機能やメニューを使うよりも、
より少ない確実な手段であるが、それはより簡単である。
</para>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<!-- Insertion: notes, auto-ties, accidentals -->
<sect2 id="nv-insertion">
<title>ノ
<para>
noteを挿入するために、ツールバー上の特定のduration上でクリックする
ことによってノ ノ
staff上でクリックする。
</para>
<para>
If you add a note at the same time as an existing note of
different duration, the editor will generally assume that you
want to create chords and will split the existing or new note
accordingly so as to create one or more chords with ties. If
you really do want to chord two different durations, you can
select the tied noteheads and use the Collapse Equal-Pitch Notes
function to merge them together. Alternatively, the default
behaviour can be changed in the &rosegarden; configuration dialog
so as not to do the split at all.</para>
<para>
もしも、異なったduration(すなわち同じピッチ)の存在する音符の
上に正確に音符を追加するならば、存在する音符のdurationは新しい
ものによって変更される。
</para>
<para>
もしも存在する音符と同じような時間の休符を追加するならば、
音符は、おそらくそれと共に削除されるか、短くされるか、
restのdurationのために、封じられる。
If you add a rest at the same time as an existing note,
the note will be silenced for the duration of the rest,
shortening or possibly removing it altogether.</para>
<sect3 id="nv-insertion-keyboard">
<title>PCキーボードによる音符と休符の入力</title>
<sect4>
<title>Duration</title>
<para>
最初に、挿入したいときに音符(又は休符)のdurationを
表示するためにnotationツールを選択することを確実にすること。
以下の数字キーを使うことによって色々なノートタイプを選択できる:
</para>
<itemizedlist>
<listitem><para><keycap>5</keycap> – Breve</para></listitem>
<listitem><para><keycap>1</keycap> – Whole note (semibreve)</para></listitem>
<listitem><para><keycap>2</keycap> – Half note (minim)</para></listitem>
<listitem><para><keycap>4</keycap> – Quarter note (crotchet)</para></listitem>
<listitem><para><keycap>8</keycap> – Eighth note (quaver)</para></listitem>
<listitem><para><keycap>6</keycap> – Sixteenth note (semiquaver)</para></listitem>
<listitem><para><keycap>3</keycap> – Thirty-second note (demisemiquaver)</para></listitem>
<listitem><para><keycap>0</keycap> – Sixty-fourth note (hemidemisemiquaver)</para></listitem>
</itemizedlist>
<para>数字キーを押す間に<keycap>Ctrl</keycap>キーを押すと、
関連するdotted-noteツールを選択する。</para>
<para>
<keycap>G</keycap>キーを押すことで、tripletバージョンの
note durationに切り替えることができる。もう一回押すと、
通常のdurationに切り替わる。ウィンドウの下部のステータス
バーはtriplet durationが有効の時にそれを通知する。</para>
</sect4>
<sect4>
<title>ピッチ</title>
<para>
notationツールが選択されると、以下のピッチキーのどれかを
押すことによって<link linkend="nv-rulers">カーソルの挿入
</link> で現在の位置に音符を挿入することができる。</para>
<itemizedlist>
<listitem><para><keycap>A</keycap> – ド (the tonic of the current key in the current clef)</para></listitem>
<listitem><para><keycap>S</keycap> – レ</para></listitem>
<listitem><para><keycap>D</keycap> – ミ</para></listitem>
<listitem><para><keycap>F</keycap> – ファ</para></listitem>
<listitem><para><keycap>J</keycap> – ソ</para></listitem>
<listitem><para><keycap>K</keycap> – ラ</para></listitem>
<listitem><para><keycap>L</keycap> – シ</para></listitem>
</itemizedlist>
<para>キーを押している間<keycap>Shift</keycap>キーを押すと、
半音noteが高くなり(＃が定義されていないミとシを除く)
<keycap>Shift</keycap>と<keycap>Ctrl</keycap>キーを一緒に押すと、
半音低くなる(ファとドを除く)
</para>
<para>一オクターブ高い音符を入力するためには、以下にあるキーを
使う。<keycap>Q</keycap>,
<keycap>W</keycap>, <keycap>E</keycap>, <keycap>R</keycap>,
<keycap>U</keycap>, <keycap>I</keycap>と
<keycap>O</keycap>。同様に、オクターブ下の音符を入力する
ためには、 <keycap>Z</keycap>, <keycap>X</keycap>,
<keycap>C</keycap>, <keycap>V</keycap>, <keycap>B</keycap>,
<keycap>N</keycap> と<keycap>M</keycap>を使う。</para>
</sect4>
<sect4>
<title>休符</title>
<para>音符の代わりに休符を挿入するためには、
<keycap>P</keycap>を使う。その代わりに、現在のツールを
切り替えてrestツールに、また、noteツールに再度戻すために、
<keycap>T</keycap> と <keycap>Y</keycap>を使うことができる。
</para>
</sect4>
<sect4>
<title>Chords</title>
<para>
既定値のnotationエディタの動作は、音符の挿入後に挿入
カーソルを次に進め、メロディ中でその後に別の音符を
挿入できるようになる。これは、<keycap>H</keycap>キーを、
chordモードに切り替えるために使うことによって、変更する
ことができ、最後のものの同じ時間に続く挿入が起きるchord
モードへ切り替えることができる。再度<keycap>H</keycap>
キーを押すと、メロディ挿入動作に戻る。</para>
</sect4>
<sect4>
<title>その他の注意点</title>
<para>
挿入コマンドのすべては、ツールメニューのサブメニューで有効で
ある。1つのno-toを挿入するためにメニューを操作することは、
ありそうもないことであるが、メニューはショートカットを表示し、
それゆえ、どのキーがどの機能か忘れた場合に有効なリファレンス
を提供する。</para>
<para>
キーボードショートカットはQWERTYレイアウトキーボード用に
現在デザインされている。その他のレイアウトにキーをリマップ
する方法はまだなく、設定メニュー上の"ショートカットの構成"
オプションを使うことによって各々のキーの再定義を個別に行なう??。
The keyboard shortcuts are currently designed for use
with a QWERTY-layout keyboard. There is not yet any way to
remap the keys for another layout, short of reassigning each
key individually using the "Configure Shortcuts..." option
on the Settings menu.</para>
</sect4>
</sect3>
<sect3 id="nv-insertion-midi">
<title>MIDIキーボードを使った音符の挿入</title>
<para>
MIDIキーボード又はその他のMIDI制御デバイスを使うことで
マトリクスエディタ中に音符を入力することができる。
notationエディタはキーボード上で演奏したピッチを使うが、
durationsはエディタそれ自身でのグリッドの設定中で選択したもの
をつかう。これは"ステップ録音"として知られている。
</para>
<para>
MIDIキーボードからノ
MIDIデバイスにキーボードを構成することを確実にする必要が
ある。次に、notationツールがdurationをセットするために選択
されることを確実にする。次に、notationエディタのツールバー
上のステップ録音ボタンかツールメニューのステップ録音を
選択する。MIDIキーボード上で押されたすべてのノ
は、ウィンドウがクローズするか、
別のウィンドウが有効になるか、再度ステップ録音がoffにされるまで
そのウィンドウ中に現在の挿入時間で挿入される。
</para>
<para>
異なったdurationのノ
中の間別のnotationツールに変更することができ、また、chord
を挿入するために、Chordモードに切り替えることができる。
</para>
</sect3>
</sect2>
<!-- Keys, Clefs and Time Signatures -->
<sect2 id="nv-signatures">
<title>Clefs, keys, テンポと時間シグネチャ</title>
<para>
時間に関係した変更(テンポと時間シグネチャ)を操作するために
&rosegarden;が行なう方法について知る最初のことは、clefsと
keysに完全に違うことが扱われる。
The first thing to know about the way &rosegarden; handles
these is that time-related changes (tempos and time
signatures) are treated entirely differently from clefs and
keys.
notationと同じように再生と録音を簡単に管理するために、&rosegarden;
はテンポと時間シグネチャが変更されることを要求し、それは一度に
すべてのstaffを行なう。
In order to simplify managing playback and recording as
well as notation, &rosegarden; requires that when the tempo or
time signature changes, it does so in all staffs at once. You
can't have one staff in 3/4 and another in 4/4 simultaneously,
or one staff playing at 120 to the beat and another at 90.
This applies only to time: there is no such restriction on the
use of clef and key changes.</para>
<para>clef, key, テンポまたは時間シグネチャをnotationエディタ
内で変更したい場合、変更を行ないたい場所に<link
linkend="nv-rulers">挿入カーソル</link>を位置づけ、編集
メニュー
<link linkend="commands-nv-menu-edit-add-clef">Add Clef
Change...</link>, <link linkend="commands-nv-menu-edit-add-key-signature">Add Key
Change...</link>, <link linkend="commands-nv-menu-edit-add-tempo">Add
Tempo Change...</link> と <link
linkend="commands-nv-menu-edit-add-time-signature">Add Time Signature
Change...</link> 機能を使う。すると以下のように、変更したい固有の
clef,key,テンポまたは時間シグネチャを変更できる所にダイアログ
ボックスが表示される。</para>
<sect3 id="nv-signatures-clef">
<title>Clef</title>
<para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-clefdialog.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>&rosegarden;'s clef dialog</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
</sect3>
<sect3 id="nv-signatures-key">
<title>Key</title>
<para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-keysigdialog.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>&rosegarden;'s key signature dialog</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
</sect3>
<sect3 id="nv-signatures-tempo">
<title>テンポ</title>
<!-- Should be in general section, not notation -->
<para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-tempodialog.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>&rosegarden;'s tempo dialog</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
</sect3>
<sect3 id="nv-signatures-time-signature">
<title>時間シグネチャ</title>
<!-- Should be in general section, not notation -->
<para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-timesigdialog.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>&rosegarden;'s time signature dialog</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
</sect3>
</sect2>
<!-- Text -->
<sect2 id="nv-text">
<title>テキストと歌詞</title>
<para>
テキストイベント中で、staffはたくさんの種類のテキストを含む
ことが可能である。テキストイベントには2つの基本的なクラスがある。
最初のものは、(staff中の特定の時間に関連付けられる)ツールバー
中の大きな<guilabel>T</guilabel>としてマークされたボタン上で
有効な、テキストツールを使うことで、作成できる。
歌詞は、これと同じ方法で作成できるが、
<link linkend="nv-text-lyrics">歌詞エディタ</link>
を使うことによってより簡単に作成できる。
</para>
<para>
小さなテキストを追加するために、追加したい点でテキストツールを
選択してクリックする。ダイアログボックスが表示され、その中に
テキストを入力することができ、その意図された目的を選択する。
(Rosegarden prefers to store what the text
is for, rather than how it should look; this is so that in
future we may be able to configure how the various sorts of
text are presented for each individual user.)
有効なpurposes(又はスタイル)は以下の通りである。
</para>
<variablelist>
<varlistentry><term>Dynamic</term><listitem><para> Used for
minor local indications such as the dynamic marks "p", "mf"
etc. Shown below the staff in small italic
type by default. </para></listitem></varlistentry>
<varlistentry><term>Direction</term><listitem><para> Used
when indicating significant changes in style or mood. Shown
above the staff in large roman type by default.
</para></listitem></varlistentry>
<varlistentry><term>Local Direction</term><listitem><para>
Used to indicate less significant changes in style or mood.
Shown below the staff in a smaller bold-italic roman type by
default. </para></listitem></varlistentry>
<varlistentry><term>Tempo</term><listitem><para> Used to
indicate significant changes in tempo. Shown above the
staff in large bold roman type by default.
</para></listitem></varlistentry>
<varlistentry><term>Local Tempo</term><listitem><para> Used
to indicate more minor or local changes in tempo. Shown
above the staff in a small bold roman type by default.
</para></listitem></varlistentry>
<varlistentry><term>歌詞</term><listitem><para>
<link linkend="nv-text-lyrics">歌詞エディタ</link>
を使うことで通常歌詞は作成できるが、このスタイルを使うことで
1語1語入力することもできる。このスタイルは既定値では
小さなroman type でテキストの下に表示される。
(注意:もしもこの方法で歌詞を入力し、staffの歌詞を
あとで編集する場合、この方法で入力した任意の歌詞は、
その位置が、もしも、歌詞エディタによって期待される所と適合して
いなければ、変更又は移動される。)
</para></listitem></varlistentry>
<varlistentry><term>Annotation</term><listitem><para> Used
for helpful text that is not strictly considered part of the
score. Shown below the staff, boxed-out in a yellow
sticky-label-style box by default.
</para></listitem></varlistentry>
</variablelist>
<para>
テキストツールで存在するテキスト上でクリックすることで、
作成した後にテキストを編集することもできる。</para>
<sect3 id="nv-text-lyrics">
<title>歌誌の編集</title>
<para><guimenu>表示</guimenu>メニュー中の、
<guimenuitem>歌詞エディタのオープン</guimenuitem>オプション
から、歌詞エディタは有効であり、これは、一度に1つのstaffの
ためにすべての歌詞イベントを編集することができるようになり、
これは基本の本文編集システムを使う。これを使うために、メニュー
オプションを有効にし、残りのダイアログ中で歌詞を編集し、
OKをクリックする。</para>
<para>The lyrics you enter should follow a particular
format. Bar lines are vital to avoid the editor getting
confused, and are represented with a slash ("/"). Within
each bar the individual syllables are separated by spaces
(at least one space: the editor doesn't care about any extra
whitespace). Each syllable in turn will be attached to the
next subsequent note or chord within that bar (although at
the moment the editor can get quite confused by chords that
are not exact, i.e. that require smoothing or
quantizing).</para>
<para>If you want a note to have no syllable attached to it,
you need to provide a dot (".") as the syllable for that
note. (This is why the default lyric text for a segment is
usually full of dots.) Remember to separate the dots with
spaces, so that they are clearly separate syllables.</para>
<para>If you want more than one syllable on the same note,
with a space between them, use a tilde ("~") instead of the
space. It will be shown as a space on the score.</para>
<para>If you want to split a syllable across two notes, with
a hyphen, you need to enter a space following the hyphen so
the editor knows to treat it as two syllables. (Hyphens get
no special treatment within syllables.)</para>
<para>Syllables consisting only of numbers surrounded by
square brackets (like "[29]") will be ignored; this is the
format used for the automatically-generated bar numbers
shown in the editor.</para>
<para>You should also be aware that the textual format of
lyrics is only used for editing: the lyrics are actually
stored as distinct text events (one per syllable). This
means that the text format may potentially change in the
future to accommodate more advanced editing capabilities,
although the event format should not change and so your
saved files should continue to be compatible.</para>
</sect3>
</sect2>
<!-- Indications -->
<sect2 id="nv-indication">
<title>スラーとhairpins</title>
<para>スラーとhairpin dynamic markingsはイベントとして、
noteやrestsと同じように保存される。これらを生成するために、
カバーしたいもの(一続きのnoteやその他)の領域を選択し、次に、
<guimenu>グループ</guimenu>メニューからの
<guimenuitem>スラーの追加</guimenuitem>,
<guimenuitem>クレッシェンドの追加</guimenuitem> または
<guimenuitem>デクレッシェンドの追加</guimenuitem> options from
the <guimenu>Group</guimenu> を選択する。</para>
<para>その他のイベントと同じように、スラー又はhairpin を取り除く
ことができる。選択ツールを使って選択し、<keycap>Delete</keycap>
キーを押すか、削除ツールを有効にしてそれをクリックする。</para>
</sect2>
<!-- Stem direction, slashes etc -->
<sect2 id="nv-note-qualities">
<title>Note stems and slashes</title>
<para>You can set the stem direction of any selected notes
(provided they are a sort that have stems) using the three
Stem Direction options on the Notes menu. The options allow
you to either fix the stems up or down, or revert to the stem
direction that &rosegarden; would otherwise have chosen. See
also <link linkend="nv-beamed-groups">Beams</link>.</para>
<para>The <guimenu>Notes</guimenu> menu also contains options for adding slashes
across note stems, for example to indicate short repeated
notes or drum rolls. These are currently purely notational;
&rosegarden; will not take them into account when playing the
staff or generating &MIDI;.</para>
</sect2>
<!-- Beamed groups, including overlapping and nesting them -->
<sect2 id="nv-beamed-groups">
<title>Beams</title>
<para>Adding beams to notes is considered a grouping operation
in the &rosegarden; Notation editor, available on the <guimenu>Group</guimenu>
menu. Select the notes you want to beam, and use the Beam
<guimenu>Group</guimenu> menu option. To remove a beam, select the notes and use
the <guimenuitem>Unbeam</guimenuitem> menu option.</para>
<para>It is possible to have more than one beamed group
happening at the same time — you just select and beam the
separate groups one at a time — but Rosegarden is usually not
yet clever enough to work out which notes should have stems up
and which should have stems down for simultaneous beamed
groups, so you will probably have to set the stem directions
of the notes in the groups explicitly as well as beaming them.</para>
<para>&rosegarden; can attempt to guess a sensible beaming for a
piece of music, provided it's not too complicated. To invoke
this, select the notes you want to calculate the beaming for
(for example by triple-clicking to select a whole staff) and
then use the <guimenuitem>Auto-Beam</guimenuitem> option on the
<guimenu>Group menu</guimenu>. Auto-beaming
is also done automatically when loading a &MIDI; file, for
example, and the editor also does some automatic beaming as
you enter notes (this can be disabled by changing the
"Auto-Beam when appropriate" setting on the configuration
dialog or the insertion tool's right-button menu).</para>
</sect2>
<!-- Tuplets -->
<sect2 id="nv-tuplets">
<title>三連符とその他の連符</title>
<para>A triplet group consists of three notes or chords played
in the time of two. (More precisely, it consists of notes
with a total duration of three arbitrary units played in the
time of two of those units.)</para>
<para>We use the word <quote>tuplet</quote> to describe the general
situation in which notes with a total duration of any given
number of units are played in the time of a different number
of those units: nine notes in the time of eight, or six in the
time of four, or a crotchet and a quaver in the time of a
single crotchet, or even two notes in the time of three. (At
present &rosegarden; does not support the last example — tuplet
groups must always be played with a shorter duration than
written.)</para>
<para>The triplet and tuplet menu functions work by taking an
existing series of notes or rests and squashing them so they
play quicker, filling in the left-over space at the end of the
series with a final rest and drawing the whole as a tuplet
group. You can therefore create a new series of triplets by
entering the first two notes of the series (in their normal
form), making them into triplets, and then filling in the rest
left over by the triplet operation with the final note of the
triplet. Or you can apply the triplet operation before you
enter any notes, thus turning the original rest itself into
triplet form, and then insert the notes of the triplet on top
of it. Some examples may help:</para>
<!-- Need examples and screenshots -->
<!-- Then discuss general tuplet dialog... -->
<para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-tupletdialog.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>&rosegarden;'s general tuplet dialog</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
<para>To specify a general tuplet group, we need to know what
the base note is (for example, if we play three crotchets in
the time of two then the base is a crotchet) and the ratio of
the number of base notes written to the number played.</para>
<!-- Then discuss "tuplet mode": with a subtitle? -->
</sect2>
<!-- Grace notes -->
<!-- Paste -->
<sect2 id="nv-paste-types">
<title>Paste types</title>
<para>
The meaning of <quote>cut and paste</quote> is less obvious for a music
editing program than it is for something like a word
processor in which the letters and words go in a simple
linear order. Accordingly, &rosegarden;'s Notation editor
offers several different types of Paste operation, as well
as separate <link
linkend="commands-nv-menu-edit-cut">Cut</link> and <link
linkend="commands-nv-menu-edit-cut-and-close">Cut and
Close</link> functions.
</para>
<para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-pastedialog.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>&rosegarden;'s paste-type dialog</phrase>
</textobject>
</mediaobject>
</screenshot>
The types of Paste operation are:</para>
<variablelist>
<varlistentry>
<term>Restricted</term>
<listitem>
<para>Requires an existing gap (containing nothing but
rests) of enough duration to completely contain the
clipboard's contents. The contents are pasted into
the gap. If there is no gap long enough, the paste
is not carried out.
</para>
<para>
This is the default paste type.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Simple</term>
<listitem>
<para>Erases enough events to make a gap long enough to
paste into, and then pastes into that. The pasted
events therefore completely replace any existing ones
in the time covered by the paste.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Open and Paste</term>
<listitem>
<para>The opposite of <link
linkend="commands-nv-menu-edit-cut-and-close">Cut and
Close</link>. Makes room for the paste by moving all of the
subsequent events further towards the end of the
composition.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Note Overlay</term>
<listitem>
<para>Carries out a paste in the way that it would
happen if you entered each of the notes in the clipboard
yourself using the notation editor: if there are other
notes overlapping with them, the new or existing notes
will be split into ties appropriately.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Matrix Overlay</term>
<listitem>
<para>Carries out a paste in the way that it would
happen if you entered each of the notes in the clipboard
yourself using the matrix editor: the notes presently
in the way of the paste will be ignored, allowing the new
notes to overlap arbitrarily with them.
</para>
</listitem>
</varlistentry>
</variablelist>
<para>All of these take effect at the current position of the
insert cursor on the current staff. To choose between the various
paste types, use the <link
linkend="commands-nv-menu-edit-paste-dot-dot-dot">Paste...</link>
menu option (with dots) on the <link
linkend="commands-nv-menu-edit">Edit</link> menu.
</para>
</sect2>
<sect2 id="nv-note-styles">
<title>音符のスタイル</title>
<para>
&rosegarden;は、たとえば、音符の頭の選択、tailの数を、音符が
埋まっているか埋まっていないかにかかわらず、描画された音符の
色々なタイプの色々な描画方法を変更することができる。
</para>
<para>
標準のスタイル(クラシック、クロス、三角とMensual)が提供され、
音符スタイルメニューオプションを、選択した個別の音符のために
スタイルを変更することができる。それぞれの音符はそれに対して
ドのスタイルが選択されたかを憶えていて、この情報は楽曲情報
の中に格納される。<guimenu>設定</guimenu>メニュー中の
<guimenuitem>Rosegardenの構成...</guimenuitem>オプションを
使うことによって新しい音符の既定値のスタイルを
変更することができる。
</para>
<para>
<acronym>XML</acronym>ファイル中に音符のスタイルを記述する
ことによって固有の音符スタイルを作成することができる。
(Even the standard styles are
defined this way: the only reason the editor knows that a
Classical semiquaver has a tilted oval filled head, a stem,
two flags, etc., is that the description in Classical.xml
says so.) See the <link
linkend="developers-note-styles">Developers Guide</link> for
more information.
</para>
</sect2>
<sect2 id="nv-note-fonts">
<title>音符フォント</title>
<para>
&rosegarden; は、Lilypondプロジェクトによって開発された、
Fetaフォントという1つのスケーラブルなnotationフォントを提供
している。Fetaはほとんどすべての古典的な仕事のために適合して
いるとても高品質のフォントである。
</para>
<para>&rosegarden; は、数多くの、その他のnotationフォントを
標準のサポートを含む。それらは、TrueType(.ttf)またはPostScript
Type-1(.pfb,.pfa)形式のフォントで提供されることを必要とし、
&rosegarden;がインストールされた場所にそれらをインストール
するために、関連したパーミッションを必要とする。サポートされて
いるnotationフォントをインストールするために、&rosegarden;
のインストールのためにshareディレクトリに位置づける(通常
/opt/kde/share/apps/rosegardenのようなKDEデスクトップの
インストールツリーである)。これは、"fonts"と呼ばれる
サブディレクトリで見付かる。そこにフォントファイルをコピーし、
&rosegarden;を再起動する。もしも、そのフォントがサポートされて
いるならば、それは、notationエディタのフォントメニューに
現われる</para>
<para>完全又は部分的なサポートは以下のフォントで提供されて
いる:Blake HodgettsによるFughetta; "オリジナル" Finale
フォントのPetrucci;"新しい"Finale"フォントのMaestro;
SibeliusフォントのOpus;Sibelius ジャズフォントのInkpen;
AdobeからのSonata;CubaseシーケンサからのSteinberg;と
Xinfonia(上記のフォントのほとんどは、各社の登録商標で
ある)。THE ROSEGARDEN TEAM
MAKES NO REPRESENTATION AS TO THE LEGAL STATUS OF ANY USE OF
THESE FONTS WITH ROSEGARDEN。
It is your responsibility to
ensure you are in compliance with the licence (if any) under
which a font was provided to you, before attempting to use it.
If you are not sure whether you have the right to use a font,
don't: apart from anything else, the standard Feta font better
than most of these anyway.</para>
<para>It is also possible to provide new mapping files so as
to use new fonts. For some fonts that have similar mappings
or metrics to fonts in the above list, this may be as simple
as editing the name of the font in the mapping file. See the
<link linkend="developers-note-fonts">Developers Guide</link>
for more information.
</para>
</sect2>
<!-- Quantization, smoothing, and display of quantized notes -->
<sect2 id="nv-quantization">
<title>Notation from performance data</title>
<para>
&rosegarden; は多用途のプログラムである。これはnotation
エディタであるが、第一次的にはシーケンサと音楽を演奏する
ためのプログラムである。さらに、演奏中、もちろん、時間と
noteのduration は印刷された楽譜上ほど明確ではない。
</para>
<para>
これは、notationエディタ中で意味のあるnoteを表示させるために
大量の基本的なnoteの時間とdurationを試みることを&rosegarden;
が行なうためにそれはたびたび望ましいことを意味する。これは
quantizationの一種であるが、大量の、驚くべき、あてずっぽうで
うまく行なうことを要求する種類のものである。&rosegarden;は、
平面のグリッドquantizerよりもわずかによい仕事を行なうために
デザインされたquantizerを含む。</para>
<para>Applying
quantization strictly for notation is rather unimaginatively
referred to as <quote>notation quantization</quote>: it only
applies to the notes you see and edit in notation, and
doesn't affect the notes that play, or that you edit in
other views such as the matrix. This quantization is
automatically applied to music imported or recorded from
MIDI, although not all of its possible capabilities are
enabled by default.
</para>
<para>
There are two ways to see which notes have been quantized
for notation. By default, each notation view contains a Raw
Note Ruler (in the group of rulers above the score) showing
a rectangular block for each note. This block is positioned
so as to represent the time and duration of the note as
performed, but with the top and bottom edges of the
rectangle extended or shortened to represent the time after
notation quantization. If this is too much information for
you, you can alternatively choose (in the configuration
dialog) to show in a green colour all note heads in the
score that have had their timings altered by notation
quantization.
</para>
<para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-notationquantizer.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>&rosegarden;'s notation quantize dialog</phrase>
</textobject>
</mediaobject>
</screenshot>
If the quantization &rosegarden; has used is not suitable,
either for the entire score or for a selection of notes, you
can choose to use a different level of quantization or none
at all. To apply a different quantization to some notes,
select the notes and use the <link
linkend="commands-nv-menu-transforms-quantize">Quantize</link>
menu function (tick the box labelled <quote>Quantize for
notation only</quote>). The quantization level or type used
by default can be changed in the configuration dialog.
</para>
<sect3 id="nv-quantization-parameters">
<title>Configurable parameters for the heuristic notation quantizer</title>
<sect4 id="nv-quantization-parameters-during">
<title>Parameters for quantization itself</title>
<variablelist>
<varlistentry>
<term>Complexity</term>
<listitem>
<para>The "complexity" of a notation quantizer is its
most fundamental parameter. A "complex" quantizer
will be more prepared to accept that complex-looking
music is in fact intended to be complex, whereas a
"simple" quantizer is more likely to assume that
complex-looking music results from an imprecise
performance of simple music.
</para>
<para>The default setting is intended to produce
reasonable results for a fairly wide range of music.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Base grid unit</term>
<listitem>
<para>The base grid unit (set to a note duration
value) specifies the absolute minimum unit of note
that will be permitted to remain in the score after
quantization. For example, if set to a semiquaver,
all notes will be placed on boundaries of a multiple
of a semiquaver, with durations also a multiple of a
semiquaver.
</para>
<para>The setting of the base grid unit is not quite
as significant for a notation quantizer as it is for a
plain grid quantizer, because all it does is impose an
absolute limit on the level of precision permitted by
the complexity parameter. Mostly, when you find a
case in which increasing the grid unit produces better
results, you've actually found a case in which the
quantizer simply didn't do as good a job as it should
have been able to with the smaller unit.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Tuplet level</term>
<listitem>
<para>The notation quantizer is capable of identifying
tuplets (triplets and other time-squashed groups),
within reasonable limits. This parameter controls how
ambitious it will attempt to be when looking for
tuplets, by setting a limit on how many notes per
tuplet group it will attempt to identify. If it is
set to <quote>None</quote>, the quantizer will not
attempt to identify tuplets at all.
</para>
</listitem>
</varlistentry>
</variablelist>
</sect4>
<sect4 id="nv-quantization-parameters-after">
<title>Parameters that control tidying up after quantization</title>
<variablelist>
<varlistentry>
<term>Tie notes at barlines etc</term>
<listitem>
<para>Causes any notes that are still found after
quantization to overlap barlines or to have
durations not exactly expressible with single note
heads to be split into multiple notes appropriately,
and tied. This has the same effect as applying the
<!-- !!! link --> "Tie Notes at Barlines" function
in the notation view.
</para>
<para>
This parameter is not set by default because it
changes the number of note events, which is
undesirable when using &rosegarden; partly or
principally as a MIDI sequencer.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Split-and-tie overlapping chords</term>
<listitem>
<para>
Causes overlapping notes to be split and tied, so
as to make strict chords with individual noteheads
tied as necessary. This has the same effect as
applying the <!-- !!! link --> "Split-and-Tie
Overlapping Chords" function in the notation view.
</para>
<para>
This parameter is not set by default partly because
it changes the number of note events, which is
undesirable when using &rosegarden; partly or
principally as a MIDI sequencer.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Re-beam</term>
<listitem>
<para>
Causes the notes to be re-beamed into groups
appropriately after quantization. This is usually
desirable.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Add articulations (staccato, tenuto,
slurs)</term>
<listitem>
<para>
Causes the quantizer to attempt to identify, based
on the durations of individual and consecutive
notes, which notes should be notated with staccato
marks (for notes that fall significantly short of
the following note, but not apparently short
enough to merit a rest), tenuto (for notes that
almost or just overlap the following note) and
slurs (for series of notes that meet or overlap).
</para>
</listitem>
</varlistentry>
</variablelist>
</sect4>
</sect3>
</sect2>
</sect1>
<sect1 id="event-view">
<title>The Event List editor</title>
<sect2 id="ev-introduction">
<title>概要</title>
<para>
The &rosegarden; Event List editor shows the events in a
single segment in a raw form, and enables you to edit the
precise properties of those events individually.
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-eventlisteditor.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>&rosegarden;'s event list editor</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
</sect2>
</sect1>
</chapter>
<!--
**********************************
PART II:
Command reference
**********************************
-->
<chapter id="commands">
<title>Command Reference</title>
<!-- (OPTIONAL, BUT RECOMMENDED) This chapter should list all of
the application windows and their menubar and toolbar commands for
easy reference. Also include any keys that have a special
function but have no equivalent in the menus or toolbars. This may
not be necessary for small apps or apps with no tool or menu
bars. -->
<para></para>
<sect1 id="commands-main">
<title>Main window</title>
<para></para>
<sect2>
<title>File menu</title>
<para>
<variablelist>
<varlistentry id="commands-main-file-new">
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>n</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>New</guimenuitem>
</menuchoice></term>
<listitem><para><action>Creates a new composition.</action></para></listitem>
</varlistentry>
<varlistentry id="commands-main-file-open">
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>o</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Open</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens an existing composition from a Rosegarden-4 (.rg) file.</action></para></listitem>
</varlistentry>
<varlistentry id="commands-main-file-import">
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Import</guimenuitem>
</menuchoice></term>
<listitem><para>This submenu contains functions for importing compositions from other file formats.</para>
<variablelist>
<varlistentry id="commands-main-file-import-midi">
<term><menuchoice>
<guimenu>Import</guimenu>
<guimenuitem>Import &MIDI; file...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Creates a new composition from the contents of an existing &MIDI; (.mid) file.</action></para></listitem>
</varlistentry>
<varlistentry id="commands-main-file-import-rg21">
<term><menuchoice>
<guimenu>Import</guimenu>
<guimenuitem>Import Rosegarden 2.1 file...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Creates a new composition from the contents of an existing Rosegarden 2.1 (.rose) file.</action></para></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
<varlistentry id="commands-main-file-merge">
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Merge</guimenuitem>
</menuchoice></term>
<listitem><para>This submenu contains functions for merging other files into the current composition.</para>
<variablelist>
<varlistentry id="commands-main-file-merge-file">
<term><menuchoice>
<guimenu>Merge</guimenu>
<guimenuitem>Merge File...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Merges the contents of an existing Rosegarden (.rg) file into the current composition. You will be offered a choice of whether to merge the file in new tracks at the start of the composition, or after the end of the current composition.</action></para></listitem>
</varlistentry>
<varlistentry id="commands-main-file-merge-midi">
<term><menuchoice>
<guimenu>Merge</guimenu>
<guimenuitem>Merge &MIDI; file...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Merges the contents of an existing &MIDI; (.mid) file into the current composition. You will be offered a choice of whether to merge the file in new tracks at the start of the composition, or after the end of the current composition.</action></para></listitem>
</varlistentry>
<varlistentry id="commands-main-file-merge-rg21">
<term><menuchoice>
<guimenu>Merge</guimenu>
<guimenuitem>Merge Rosegarden 2.1 file...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Merges the contents of an existing Rosegarden 2.1 (.rose) file into the current composition. You will be offered a choice of whether to merge the file in new tracks at the start of the composition, or after the end of the current composition.</action></para></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
<varlistentry id="commands-main-file-export">
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Export</guimenuitem>
</menuchoice></term>
<listitem><para>This submenu contains functions for exporting the contents of compositions to other file formats.</para>
<variablelist>
<varlistentry id="commands-main-file-export-midi">
<term><menuchoice>
<guimenu>Export</guimenu>
<guimenuitem>Export &MIDI; file...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Saves the contents of the current composition into a new &MIDI; file.</action> Note that not all data in the Rosegarden composition necessarily can or will be saved in the &MIDI; format.</para></listitem>
</varlistentry>
<varlistentry id="commands-main-file-export-csound">
<term><menuchoice>
<guimenu>Export</guimenu>
<guimenuitem>Export Csound score file...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Saves the contents of the current composition into a new Csound score file.</action> Together with a suitable orchestra file (not supplied), this can be used to play the composition through <ulink url="http://www.csounds.com/">Csound</ulink>. Note that not all data in the Rosegarden composition necessarily can or will be saved in the Csound format.</para></listitem>
</varlistentry>
<varlistentry id="commands-main-file-export-lilypond">
<term><menuchoice>
<guimenu>Export</guimenu>
<guimenuitem>Export Lilypond file...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Saves the contents of the current composition into a new Lilypond file.</action> This can then be processed by the <ulink url="http://www.lilypond.org/">Lilypond</ulink> system to produce typeset-quality music, although it is likely that the file may need some tweaking to get really good quality output. Note that not all data in the Rosegarden composition necessarily can or will be saved in the Lilypond format.</para></listitem>
</varlistentry>
<varlistentry id="commands-main-file-export-mup">
<term><menuchoice>
<guimenu>Export</guimenu>
<guimenuitem>Export Mup file...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Saves the contents of the current composition into a new Mup file.</action> This can then be processed by the <ulink url="http://www.arkkra.com/">Mup</ulink> music publication system, although it is likely that the file may need some tweaking to get really good quality output. Note that not all data in the Rosegarden composition necessarily can or will be saved in the Mup format.</para></listitem>
</varlistentry>
<varlistentry id="commands-main-file-export-musicxml">
<term><menuchoice>
<guimenu>Export</guimenu>
<guimenuitem>Export MusicXML file...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Saves the contents of the current composition into a new MusicXML file.</action> This can then be used with any music software that supports the MusicXML format. Note that MusicXML support is experimental and has not been well tested. Not all data in the Rosegarden composition necessarily can or will be saved in the MusicXML format.</para></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
<varlistentry id="commands-main-file-save">
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>s</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Save</guimenuitem>
</menuchoice></term>
<listitem><para><action>Saves the composition.</action></para></listitem>
</varlistentry>
<varlistentry id="commands-main-file-save-as">
<term><menuchoice>
<guimenu>File</guimenu>
<guimenuitem>Save As...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Saves the composition with a new filename.</action></para></listitem>
</varlistentry>
<varlistentry id="commands-main-file-close">
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>w</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Close</guimenuitem>
</menuchoice></term>
<listitem><para><action>Closes the current composition.</action></para></listitem>
</varlistentry>
<varlistentry id="commands-main-file-print">
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>p</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Print</guimenuitem>
</menuchoice></term>
<listitem><para><action>Prints the current composition.</action> At the time of writing, the print function is incomplete. We recommend using the <link linkend="commands-main-file-export-lilypond">Export Lilypond file</link> function and printing with Lilypond instead.</para></listitem>
</varlistentry>
<varlistentry id="commands-main-file-quit">
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>q</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Quit</guimenuitem>
</menuchoice></term>
<listitem><para><action>Quits &rosegarden;</action></para></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<!-- Levi Burton additions 2003.03.05 -->
<sect2>
<title>Edit menu</title>
<para>
<variablelist>
<varlistentry id="commands-main-edit-undo">
<term>
<menuchoice>
<shortcut>
<keycombo>
<keycap>Ctrl</keycap>
<keycap>z</keycap>
</keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Undo</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>
Reverses the last command performed.
</action>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-main-edit-redo">
<term>
<menuchoice>
<shortcut>
<keycombo>
<keycap>Ctrl</keycap>
<keycap>Shift</keycap>
<keycap>z</keycap>
</keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Redo</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>
Repeats the last command performed, following an undo.
</action>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-main-edit-cut">
<term>
<menuchoice>
<shortcut>
<keycombo>
<keycap>Ctrl</keycap>
<keycap>x</keycap>
</keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Cut</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>
Removes the currently selected segment from the
composition view and adds it to the clipboard. Note that
when you have selected a track, all segments in that track
are selected.
</action>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-main-edit-copy">
<term>
<menuchoice>
<shortcut>
<keycombo>
<keycap>Ctrl</keycap>
<keycap>c</keycap>
</keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Copy</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>
Removes the selected segments from the composition and
places them in the clipboard to replace any contents the
clipboard previously had.
</action>
Note that when you have selected a track, all segments in that track
are selected.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-main-edit-paste">
<term>
<menuchoice>
<shortcut>
<keycombo>
<keycap>Ctrl</keycap>
<keycap>v</keycap>
</keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Paste</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>
Inserts the contents of the clipboard into the composition.
Verbage hear stating where the contents are inserted
(current track, offset within that track etc).
</action>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-main-edit-delete">
<term>
<menuchoice>
<shortcut>
<keycombo>
<keycap>Delete</keycap>
</keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Delete</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>
Removes the selected segments from the composition and throws them away.
</action>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-main-edit-select-all-segments">
<term>
<menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Select All Segments</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>
Selects all segments within the composition.
</action>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-main-edit-add-tempo-change">
<term>
<menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Add Tempo Change...</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>
Invokes a tempo change dialog.
</action>
This offers a
selection of ways to change the tempo of the
composition, including changing the tempo from the
insert cursor position onwards, from the last
tempo change onwards, or for the entire
composition. See <!-- !!!link linkend="segment-tempo-changes" -->Changing the Tempo<!-- /link --> for more information.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-main-edit-add-time-signature">
<term>
<menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Add Time Signature Change...</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>
Invokes a time-signature change dialog.
</action>
This offers a
selection of ways to change the tempo of the
composition, including changing the time signature
from the insert cursor position onwards or from the
start of the current bar. See
<!-- !!!link linkend="segment-tempo-changes" -->Changing the Time Signature<!-- /link -->
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-main-edit-change-composition-duration">
<term>
<menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Change Composition Duration...</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>
Invokes a composition duration change dialog.
</action>
This allows you to change the overall duration of
the composition. This duration sets a hard limit
(as a number of bars) on the scrollable width of the
main window and the length of time you can play or
record before the composition is deemed to have
ended. The default is 100 bars.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-main-edit-document-properties">
<term>
<menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Edit Document Properties...</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>
Invokes a document properties dialog.
</action>
The document properties dialog allows you to review and/or modify the current document properties. Note - explain what are properties. Note to developers - It seems kinda weird to have icons on the left for selecting, and tabs in each one. Why not just tabs or just the things on the left?
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<!-- Levi Burton additions 2003.03.05 -->
<sect2>
<title>Segments menu</title>
<para>
<variablelist>
<varlistentry id="commands-main-segments-open-default-editor">
<term>
<menuchoice>
<shortcut>
<keycombo>
<keycap>Return</keycap>
</keycombo>
</shortcut>
<guimenu>Segments</guimenu>
<guimenuitem>Open in Default Editor</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action> Opens all of the currently
selected segments together in a notation editor, or in
whichever other editor you have configured as your
default.
</action>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-main-segments-open-matrix-editor">
<term>
<menuchoice>
<guimenu>Segments</guimenu>
<guimenuitem>Open in Matrix Editor</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action> Opens all of the currently
selected segments in a matrix editor.
</action>
See <link linkend="matrix-view">matrix editor</link>.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-main-segments-open-notation-editor">
<term>
<menuchoice>
<guimenu>Segments</guimenu>
<guimenuitem>Open in Notation Editor</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action> Opens all of the currently
selected segments together in a notation editor.
</action>
See <link linkend="notation-view">notation editor</link>.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-main-segments-open-event-editor">
<term>
<menuchoice>
<guimenu>Segments</guimenu>
<guimenuitem>Open in Event List Editor</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action> Opens all of the currently
selected segments together in a event-list editor.
</action>
See <link linkend="event-view">event-list editor</link>.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-main-segments-quantize">
<term>
<menuchoice>
<guimenu>Segments</guimenu>
<guimenuitem>Quantize...</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Invokes a quantization dialog for quantizing the current selection.
</action>
See <link linkend="nv-quantization">quantization</link>.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-main-segments-rescale">
<term>
<menuchoice>
<guimenu>Segments</guimenu>
<guimenuitem>Rescale...</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Allows you to stretch or squash segments in time.
</action>
This option invokes a rescale dialog, which allows
you to specify a ratio of timings that is then
applied to the selected segments. This has the
result of stretching (slowing down) or squashing
(speeding up) the selected segments, changing their
durations accordingly.
</para>
<para>
This only applies to segments containing MIDI
events, not to audio segments. Rosegarden does not
currently provide native support for audio
time-stretching.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-main-segments-auto-split">
<term>
<menuchoice>
<guimenu>Segments</guimenu>
<guimenuitem>Auto-Split</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>
Splits the selected segments on silences.
</action>
This function works slightly differently depending
on whether the selected segments contain audio or
MIDI data. For audio segments, it offers you a
dialog in which you can choose a threshold below
which the segment is considered "silent"; it then
splits the segment whenever its amplitude falls
below this threshold. For MIDI segments, it simply
splits the segment everywhere that a full bar of
silence occurs.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-main-segments-split-by-pitch">
<term>
<menuchoice>
<guimenu>Segments</guimenu>
<guimenuitem>Split by Pitch...</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
<action>Splits the currently selected segments into higher and
lower parts.
</action>
This function invokes a dialog allowing you to
choose a pitch as a "split point", and then splits
the selected segments in half with all the notes on
or above that split point in the "higher" segment
and all the notes below it in the "lower".
</para>
<para>
If the music in the segment consists of two separate
parts (e.g. left and right hand piano parts) that
are not always completely on either side of a single
split point, you may with to select the "ranging
split-point" option. If this is selected,
Rosegarden will attempt to track the two parts as
they move up and down, usually doing a slightly
better job of separating out notes that were
intended to lie in the two separate parts.
</para>
<para>
The resulting segments are both created on the same
track, with one overlapping the other.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
</sect1>
<sect1 id="commands-nv">
<title>Notation editor</title>
<para></para>
<!-- Tools -->
<!-- Note insertion tools -->
<!-- Rest insertion tools -->
<!-- Clef insertion tools -->
<!-- Text tool -->
<!-- Eraser -->
<sect2 id="commands-nv-menu-file">
<title>File menu</title>
<para>
<variablelist>
<varlistentry id="commands-nv-menu-file-close">
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>w</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu>
<guimenuitem>Close</guimenuitem>
</menuchoice></term>
<listitem><para><action>Closes the window</action></para></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2 id="commands-nv-menu-edit">
<title>Edit menu</title>
<para>
<variablelist>
<varlistentry id="commands-nv-menu-edit-undo">
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>z</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Undo</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Reverses the last edit.
</action> Edits are shared across
all views, so if the last edit was not made in
this view, undoing it might not appear to change
this view either.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-edit-redo">
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>z</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Redo</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Repeats the last edit, following an undo.
</action>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-edit-cut">
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>x</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Cut</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Removes the selected events from the composition
and places them in the clipboard to replace any
contents the clipboard previously had.
</action>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-edit-copy">
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>c</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Copy</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Copies the selected events to the clipboard
to replace any contents the clipboard previously had.
</action>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-edit-paste">
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>v</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Paste</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Copies the contents of the clipboard to the
location of the insert cursor in the current
composition.
</action>
The clipboard must not contain
multiple segments, and there must be enough
space (occupied only by rests) starting at
the insert cursor position to accommodate the
clipboard's contents.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-edit-cut-and-close">
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>x</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Cut and Close</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Removes the selected events from the composition
and places them in the clipboard to replace any
contents the clipboard previously had, and closes
the gap left behind by moving all subsequent
events towards the beginning of the composition.
</action>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-edit-paste-dot-dot-dot">
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>v</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Paste...</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Provides a choice of paste mechanisms with the
ability to set one as the default for use in the
Paste menu function.
</action>
See the section on <link linkend="nv-paste-types">Paste types</link> for more information.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-edit-delete">
<term><menuchoice>
<shortcut>
<keycombo><keycap>Del</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Delete</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Removes the selected events from the composition
and throws them away.
</action>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-edit-select-from-start">
<term><menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Select from Start</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Extends the current selection by selecting
all events from the start of the staff up to the
current selection (or up to the insert cursor,
if no events are currently selected).
</action>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-edit-select-to-end">
<term><menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Select to End</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Extends the current selection by selecting
all events from the end of the current selection
(or from the insert cursor, if no events are
currently selected) up to the end of the staff.
</action>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-edit-select-whole-staff">
<term><menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Select Whole Staff</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Selects all the events on the current staff.
</action>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-edit-clear-selection">
<term><menuchoice>
<shortcut>
<keycombo><keycap>Esc</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Clear Selection</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Unselects all events.
</action>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-edit-filter-selection">
<term><menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Filter Selection</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Invokes an event filter dialog.
</action>
This offers you the ability to filter a range of events in
any of several categories out of your selection.
</para>
<para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="rg-eventfilter.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>The event filter dialog</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
<para>
All ranges may be either inclusive or exclusive.
</para>
<para>
An inclusive range will remove events on either side of it
from the selection. You can use this, for example, to
filter everything below middle C and above the A above
middle C out of your selection.
</para>
<para>
An exclusive range will remove the events within the range
itself, leaving everything on either side of it selected.
Using the same search points as in the previous example,
you would use an exclusive range to remove everything
between middle C and the A above middle C from your
selection, while leaving everything above and below that
range selected.
</para>
<para>
Once your selection has been filtered, you can manipulate
it by any conventional means.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-edit-add-tempo">
<term><menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Add Tempo Change...</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Invokes a tempo change dialog.
</action>
This offers a
selection of ways to change the tempo of the
composition, including changing the tempo from the
insert cursor position onwards, from the last
tempo change onwards, or for the entire
composition. See <!-- !!!link linkend="segment-tempo-changes" -->Changing the Tempo<!-- /link --> for more information.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-edit-add-time-signature">
<term><menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Add Time Signature Change...</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Invokes a time-signature change dialog.
</action>
This offers a
selection of ways to change the tempo ofthe
composition, including changing the time signature
from the insert cursor position onwards or from the
start of the current bar. See
<!-- !!!link linkend="segment-tempo-changes" -->Changing the Time Signature<!-- /link -->
for more information.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-edit-add-clef">
<term><menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Add Clef Change...</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Invokes a clef selection dialog, and inserts the
chosen clef at the current insert cursor position.
</action>
The dialog allows you to choose a clef, but also
to choose how you want the clef to be applied, in
cases where there are already some notes following
the point where the clef is to be inserted. You
must choose one of the following:
<variablelist>
<varlistentry>
<term>Maintain current pitches</term>
<listitem>
<para>
Any notes following the clef will keep
their current performance pitches.
</para>
<para>
For example, inserting a
tenor clef in the middle of a previously
treble-clef section will cause the notes following
the clef to be moved an octave
higher up the staff, because they will still have
their treble-clef pitches.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Transpose into appropriate octave</term>
<listitem>
<para>
Any notes following the clef will
retain their pitch within the octave, but
may be moved into a different octave to
match the new clef, and therefore will play
at a new pitch.
</para>
<para>
For example, inserting a tenor clef in the
middle of a previously treble-clef section
will cause the notes following the clef to
move by one staff line only to adjust to the new
clef, but to play an octave lower than before.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-edit-add-key-signature">
<term><menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Add Key Change...</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
</action>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2 id="commands-nv-menu-group">
<title>Group menu</title>
<para>
<variablelist>
<varlistentry id="commands-nv-menu-group-beam">
<term><menuchoice>
<guimenu>Group</guimenu>
<guimenuitem>Beam Group</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Makes the selected notes into a beamed group.
</action>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-group-auto-beam">
<term><menuchoice>
<guimenu>Group</guimenu>
<guimenuitem>Auto-Beam</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Scans the area covered by the selection and attempts
to group short notes into plausible beamed groups.
</action>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-group-break-group">
<term><menuchoice>
<guimenu>Group</guimenu>
<guimenuitem>Unbeam</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Removes the selected notes from any beamed groups
they may be part of, leaving them as separate
individuals.
</action>
If part of a beamed group is selected, the unselected
part of the group will remain beamed.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-group-tuplet">
<term><menuchoice>
<guimenu>Group</guimenu>
<guimenuitem>Tuplet</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Makes a triplet or other tuplet group.
</action>
This function allows you to adjust the timing of a
short section of music in the ratio of two
durations, for example to indicate that three notes
should be played in the time of two (the classic
triplet), or nine in the time of six, or whatever.
You can set this ratio in a dialog box when you
invoke the function.
</para>
<para>
If you have selected some events before invoking the
function, it will assume that you want to make a
tuplet group out of the selected region (or as close
to its duration as possible) and will adjust the
default values available in the dialog accordingly.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-group-simple-tuplet">
<term><menuchoice>
<guimenu>Group</guimenu>
<guimenuitem>Simple Tuplet</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Makes a tuplet group (normally of triplets) with
the most apparently obvious ratio of durations.
</action>
Usually this function will attempt to make a triplet
group starting at the current insert cursor, or if
some events are selected, will attempt to make them
into triplets. It is possible that it might end up
making non-triplet groups if there is no obvious
valid triplet arrangement.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-group-grace">
<term><menuchoice>
<guimenu>Group</guimenu>
<guimenuitem>Make Grace Notes</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Converts the selected notes into grace notes.
</action>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-group-ungrace">
<term><menuchoice>
<guimenu>Group</guimenu>
<guimenuitem>Ungrace</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Converts any grace notes in the selection to
normal notes.
</action>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-group-slur">
<term><menuchoice>
<guimenu>Group</guimenu>
<guimenuitem>Slur</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Adds a slur across the selected notes.
</action>
To remove the slur, click on it
with the erase tool just as you would for a note.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-group-crescendo">
<term><menuchoice>
<guimenu>Group</guimenu>
<guimenuitem>Crescendo</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Adds a crescendo (opening hairpin) indication
across the selected notes.
</action>
To remove the crescendo indication, click on it
with the erase tool just as you would for a note.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-group-decrescendo">
<term><menuchoice>
<guimenu>Group</guimenu>
<guimenuitem>Decrescendo</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Adds a decrescendo (closing hairpin) indication
across the selected notes.
</action>
To remove the decrescendo indication, click on it
with the erase tool just as you would for a note.
</para>
</listitem>
</varlistentry>
<!--
<varlistentry id="commands-nv-menu-group-remove-indications">
<term><menuchoice>
<guimenu>Group</guimenu>
<guimenuitem>Remove Indications</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
</action>
</para>
</listitem>
</varlistentry>
-->
</variablelist>
</para>
</sect2>
<sect2 id="commands-nv-menu-notes">
<title>Notes menu</title>
<para>
<variablelist>
<varlistentry id="commands-nv-menu-notes-">
<term><menuchoice>
<guimenu>Notes</guimenu>
<guimenuitem></guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
</action>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-notes-style-actionmenu">
<term><menuchoice>
<guimenu>Notes</guimenu>
<guimenuitem>Note Style</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Change the note style of the selected notes.
</action>
This submenu contains an entry for each of the <link
linkend="nv-note-styles">note
styles</link> that are currently available. Choosing one
will change the note style of the selected notes to
that style.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-notes-stems">
<term><menuchoice>
<guimenu>Notes</guimenu>
<guimenuitem>Stem Direction</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Change the stem
direction of the selected notes.
</action>
This submenu allows you to specify that all the
<link linkend="nv-note-qualities">stems</link> of
the selected notes should point up or down, plus an
entry to reset the stem directions to those that
Rosegarden originally chose for the notes.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-notes-slashes">
<term><menuchoice>
<guimenu>Notes</guimenu>
<guimenuitem>Slashes</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>
Add diagonal
slashes across the selected notes' stems.
</action>
This submenu allows you to choose a number of
diagonal strokes or <link linkend="nv-note-qualities">slashes</link> to be drawn across the
stems of each of the selected notes. These may be
used, for example, to indicate repetition or rolls
to a human reader. They do not (yet) affect
performance using Rosegarden.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2 id="commands-nv-menu-marks">
<title>Marks menu</title>
<para>
<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu>blah</guimenu>
<guimenuitem>blah</guimenuitem>
</menuchoice></term>
<listitem>
<para>to be continued</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2 id="commands-nv-menu-transforms">
<title>Transforms menu</title>
<para>
<variablelist>
<varlistentry id="commands-nv-menu-transforms-normalize-rests">
<term><menuchoice>
<guimenu>Transforms</guimenu>
<guimenuitem>Normalize Rests</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>Makes the rests in the selection
theoretically correct.</action>
This function examines each sequence of consecutive
rests found in the selection, and adjusts, splits
and merges rests as necessary to ensure that the
rests have theoretically correct durations and fall
on the correct boundaries.
</para>
<para>For example, a 4/4 bar containing a crotchet
(quarter-note), then a minim (half-note) rest and a
crotchet rest will be rearranged to place the crotchet
rest first, as the minim rest should not cross the
central beat boundary of the bar.
</para>
<para>This function is also useful in occasional
situations where Rosegarden has made a bad job of
maintaining the rests correctly within a bar, for
example when editing imported &MIDI; data. Normalizing
the rests will usually make the arrangement of notes
in such a situation a bit clearer. (Rosegarden always
normalizes the rests as a matter of course when
importing or recording &MIDI;, but things can sometimes
get muddled up again.)</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-transforms-collapse-rests">
<term><menuchoice>
<guimenu>Transforms</guimenu>
<guimenuitem>Collapse Rests</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>Makes multiple short rests into fewer longer
ones.</action>
This function merges consecutive rests into longer
rests, wherever possible. That is, wherever two
consecutive rests in the selection are found to have
a total duration expressible as a single longer
rest, they will be merged.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-transforms-collapse-notes">
<term><menuchoice>
<guimenu>Transforms</guimenu>
<guimenuitem>Collapse Equal-Pitch Notes</guimenuitem>
</menuchoice></term>
<listitem>
<para>
<action>Makes multiple short notes into fewer longer
ones.</action>
This function merges consecutive notes into longer
notes, wherever possible. That is, wherever two
consecutive notes of equal pitch in the selection
are found to have a total duration expressible as a
single longer note, they will be merged.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-transforms-tie-notes">
<term><menuchoice>
<guimenu>Transforms</guimenu>
<guimenuitem>Tie Equal-Pitch Notes</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>Ties consecutive notes whenever possible.</action>
This function ties together any consecutive notes of
equal pitch found in the selection. Tied notes are
shown with a curved line joining the note heads, and
are played as a single long note.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-transforms-untie-notes">
<term><menuchoice>
<guimenu>Transforms</guimenu>
<guimenuitem>Untie Notes</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>Breaks ties between notes.</action>
Any tied notes found in the selection are untied,
and will subsequently be played as separate
notes.</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-transforms-make-viable">
<term><menuchoice>
<guimenu>Transforms</guimenu>
<guimenuitem>Make Notes Viable</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>Splits notes at displayable
durations.</action> This function is intended to deal
with notes that have excessively long durations that
overflow barlines or that are too long to be displayed
as a single note. It takes any such notes and splits
them into shorter, tied notes.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-transforms-de-counterpoint">
<term><menuchoice>
<guimenu>Transforms</guimenu>
<guimenuitem>De-Counterpoint</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>Turns counterpoint into a series of split-and-tied notes and chords.</action>
&rosegarden; has no explicit support for counterpoint
(multiple lines of notes edited separately on the
same staff), but it will do its best to approximate
it when it finds notes in a segment that are
apparently contrapuntal, i.e. that overlap but that
are not precise enough to be treated as chords. For
example, when a short note starts shortly after a
longer note, Rosegarden will show the longer note
and a short <quote>spacing</quote> rest together, followed by the
shorter note. Unfortunately this often isn't what
you want.
</para>
<para>The De-Counterpoint function can be applied to a
selection that contains overlapping notes. It will
split overlapping notes at the point where they
overlap, and tie together the resulting split notes,
ensuring that the music takes the form of a series of
chords and/or single notes starting and ending in neat
blocks, with some notes possibly tied.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-transforms-quantize">
<term><menuchoice>
<guimenu>Transforms</guimenu>
<guimenuitem>Quantize...</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>Quantizes the selection.</action></para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-transforms-fix-smoothing">
<term><menuchoice>
<guimenu>Transforms</guimenu>
<guimenuitem>Fix Smoothed Values</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>Makes the note durations in the current
view permanent.</action>
When notating recorded or performance &MIDI;,
Rosegarden usually has to round off the durations of
some notes so that they can be displayed as normal
note types. This is known as <link
linkend="nv-quantization">smoothing</link>, and it
normally does not affect the notes actually played,
it's just a convenience for display. The Fix
Smoothed Values function takes the current smoothed
note durations and sets them such that they are used
for performance (and editing in the matrix view,
etc) as well as for notation.
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-transforms-interpret">
<term><menuchoice>
<guimenu>Transforms</guimenu>
<guimenuitem>Interpret...</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>Modifies the velocities and timings of
notes according to any written or indicated dynamics
found.</action> The selection of interpretations
available is as follows:
<variablelist>
<varlistentry>
<term>Apply text dynamics (p, mf, ff etc)
</term>
<listitem><para> Sets a velocity to each note
based on the last piece of text of "Dynamic"
type seen on the same staff (only texts of the
form pp, p, mp, mf, f, ff, fff etc are matched).
</para></listitem>
</varlistentry>
<varlistentry>
<term>Apply hairpin dynamics
</term>
<listitem><para> Makes the notes gradually
increase or decrease in velocity during a
crescendo or decrescendo hairpin.
</para></listitem>
</varlistentry>
<varlistentry>
<term>
Stress beats
</term>
<listitem><para> Makes notes that land on bar or
beat boundaries slightly louder (greater
velocity) than the surrounding notes.
</para></listitem>
</varlistentry>
<varlistentry>
<term>
Articulate slurs, staccato, tenuto etc
</term>
<listitem><para> Shortens unslurred notes,
shortens staccato notes more, and gives notes
inside slurs and tenuto notes their full length.
</para></listitem>
</varlistentry>
</variablelist>
</para>
</listitem>
</varlistentry>
<varlistentry id="commands-nv-menu-transforms-transpose">
<term><menuchoice>
<guimenu>Transforms</guimenu>
<guimenuitem>Transpose</guimenuitem>
</menuchoice></term>
<listitem>
<para><action>Alters the pitch of the selected
notes.</action> This submenu contains basic
transposition functions which move the selected notes
up or down a semitone or a whole octave in pitch, as
well as a general transpose function that allows you
to choose how far up or down you want to transpose the
selection.
</para>
<para>These functions simply change the stored pitches
of the notes in the selection, so that they both play
and appear at the new pitches. They do not deal with
performance transposition (displaying one pitch and
playing another), for which see the main window's
segment parameter box; nor do they help you with
transposing from one key into another, for which see
the <link
linkend="commands-nv-menu-edit-add-key-signature">key
change</link> function.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
</sect1>
</chapter>
<!--
**********************************
PART III:
Technical material
**********************************
-->
<chapter id="developers">
<title>Developer's Guide to Rosegarden</title>
<sect1 id="developers-note-fonts">
<title>Configuring custom notation fonts</title>
<para>If you have a notation font installed on your system in a
scalable format (TrueType or Type-1) but it is not currently
supported by Rosegarden, you can create your own mapping XML
file to describe the font's character map and metrics in a way
Rosegarden can use. These files are installed in the
fonts/mappings subdirectory of the Rosegarden installation
directory, and a number of samples are included with the
distribution.</para>
<para>You can also use these mapping files to define new
pixmap-based fonts, in which every shape in a particular size is
loaded from a separate pixmap file. The two standard notation
fonts supplied with Rosegarden-4 are pixmap fonts defined in
exactly this way.
</para>
<para>It is even possible to define a notation font as using one
or more scalable system fonts, augmented with pixmaps for
particular sizes or for characters not found in the scalable
fonts. This is because most of the mapping file format is the
same for scalable and pixmap fonts, and where there are
different elements for the different sorts of fonts, it is
usually possible to include both of them. Rosegarden will
usually use pixmaps where available and scalable fonts
otherwise.
</para>
<para>You may also wish to edit the mapping files supplied with
Rosegarden if you find their measurements for alignment or
sizing are not to your liking. (If you believe that any of the
supplied files are actually wrong, please let us know.)
</para>
<sect2 id="developers-note-fonts-codes-glyphs">
<title>Codes and Glyphs</title>
<para></para>
</sect2>
<sect2 id="developers-note-fonts-mapping-format">
<title>Notation font mapping XML format</title>
<para>Here is a summary of the XML elements that may be used
in the font mapping file.</para>
<sect3 id="developers-note-fonts-mapping-format-font-encoding">
<title>rosegarden-font-encoding</title>
<para>This element must exist in every mapping file, and
should contain all the other elements. The only attribute
is "name", which contains the font's name as shown in the
font selection dropdown. Although the file format will
permit any name to be used here, Rosegarden will only pick
up the font corectly if the XML file has the same name as
the contents of this attribute (except that the XML file
should be named in lower-case and should end in ".xml").
</para>
</sect3>
<sect3 id="developers-note-fonts-mapping-format-font-information">
<title>font-information</title>
<para>This should normally be the first child element of
"rosegarden-font-encoding". It may have any of the
following attributes, all of which are optional:
<variablelist>
<varlistentry>
<term>origin</term>
<listitem>
<para>A textual description of the likely origin of
the mapped font (not the origin of the mapping
file).</para>
</listitem>
</varlistentry>
<varlistentry>
<term>copyright</term>
<listitem>
<para>A textual description of the likely copyright
status of the mapped font (not the copyright status
of the mapping file). Note that because the mapping
file contains information such as origin and
copyright of the font itself, it is usually
advisable to make separate mapping files for
separate fonts where practical, even if the fonts
share other mapping data.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>mapped-by</term>
<listitem>
<para>The name of the creator of the mapping file
(i.e. you, presumably).</para>
</listitem>
</varlistentry>
<varlistentry>
<term>type</term>
<listitem>
<para>The type of the font. This attribute should
contain one of the values "pixmap" or "scalable".
Fonts that are loaded into the windowing system and
are available to Rosegarden as standard system fonts
have type "scalable"; fonts that need to be loaded
from pixmap files corresponding to individual sizes
of pixmap (such as the feta and rg21 fonts included
with Rosegarden) have type "pixmap".</para>
<para>This information is only intended for the user
reference; it isn't actually used by Rosegarden. It is
legitimate in practice for a font to be a mixture of the
two, but in general we will assume in this documentation
that a font is either scalable or pixmap.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>smooth</term>
<listitem>
<para>A boolean attribute indicating whether the
font is antialiased (smooth) or not. Should have
the value "true" or "false". If the font is smooth,
other display elements such as beams and slurs that
are not generated from the font will also be
antialiased.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>autocrop</term>
<listitem>
<para>Only relevant for scalable (system) fonts.
Rosegarden usually expects the metrics for a font to
contain the vertically smallest bounding boxes for
elements such as note heads and accents, rather than
including empty space above or below these elements
for alignment purposes. Most fonts do not do what
Rosegarden expects. Therefore for these fonts you
should set the autocrop attribute to "true"; then
Rosegarden will crop any unnecessary space from the
top and bottom of these elements when rendering
them.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect3>
<sect3 id="developers-note-fonts-mapping-format-font-requirements">
<title>font-requirements</title>
<para>
This element is only relevant for scalable fonts. It is
used to specify that this font should only be offered if
certain system fonts are available, as well as to
associate IDs with those system fonts to refer to in the
<link
linkend="developers-note-fonts-mapping-format-font-symbol-map">font-symbol-map</link>
element. This scheme is used to decide which notation
fonts should be offered to the user, and also allows you
to compose a Rosegarden notation font from more than one
system font if desired.
</para>
<para>The "font-requirements" element should contain a list
of "font-requirement" child elements. Each of these has two
attributes: "font-id", containing a numerical ID of your
choice for reference elsewhere in the file, and either a
"name" or a "names" attribute. If "name" is provided, it
will be used as the name of a single system font to be
associated with the font id; if "names" is provided, it will
be treated as a comma-separated list of system fonts and the
first one found will be associated with the font id.
</para>
</sect3>
<sect3 id="developers-note-fonts-mapping-format-font-sizes">
<title>font-sizes</title>
<para>The "font-sizes" element specifies which notation font
sizes are available, and how the nominal font size relates
to the dimensions of non-font elements such as stems, staff
lines and beams. The "size" of a notation font is assumed
to be the distance in pixels between staff lines, or more
precisely, the height of a conventional note head that
completely fills the space between lines: the size therefore
does not include the thickness of either of the neighbouring
staff lines.
</para>
<para>
<!-- !!! TODO throughout this section: how to mark up XML element/attribute names? equiv of <code> in HTML would do -->
There are two possible child elements of "font-sizes":
"font-scale" and "font-size". Their use depends on the
type of font being described.</para>
<para>
For pixmap (non-scalable) fonts, the "font-sizes" element
should contain a list of "font-size" elements, one for
each size of pixmaps available. The pixmaps themselves
must be installed in the
fonts/<font-name>/<font-size> subdirectory of
the Rosegarden installation directory, where
<font-name> is the name of the font (as specified in
the "rosegarden-font-encoding" element at the start of the
mapping file), or a lower-case version of the name, and
<font-size> is the pixel size of the font. A font
size will only be made available to the user if it has an
entry in the "font-sizes" list and the pixmap directory is
found.
</para>
<para>
For scalable fonts, the "font-sizes" element should
contain one "font-scale" element that defines the
relationships between font and non-font elements in a
general way, and also defines the relationship between
Rosegarden's nominal font size and the size of the
corresponding system font. If this "font-scale" element
is found, then Rosegarden will assume the font is
available in any size. You can however still include one
or more "font-size" elements to define precise proportions
for any particular size for which the general proportions
do not quite work correctly, for example because of
rounding error.
</para>
<para>
The attributes of "font-scale" and "font-size" are very
similar. The main difference is that all attributes of
"font-scale" are floating-point values relative to the
font size, where 1.0 is the base font size (i.e. the
distance between staff lines), whereas attributes of
"font-size" are integer pixel values. The attributes
available are as follows. (Those marked "optional" have
vaguely sensible defaults, so it's a good idea to try not
setting them first.)
</para>
<variablelist>
<varlistentry>
<term>note-height</term>
<listitem>
<para>This attribute is only available for the
"font-size" element, and it is mandatory in that
element. It defines the base size of font to which the
other attributes in this element apply, and a size that
will be offered to the user and used when looking up
pixmaps for this font.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>font-height</term>
<listitem>
<para>May be used in either "font-size" or "font-scale".
This is only relevant for scalable fonts, but is
mandatory for them if used in the "font-scale" element.
This defines the size of the system font used to draw a
given size of notation font.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>beam-thickness</term>
<listitem>
<para>Optional. Defines the thickness of a beam.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>staff-line-thickness</term>
<listitem>
<para>Optional. Defines the thickness of a staff line.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>stem-thickness</term>
<listitem>
<para>Optional. Defines the thickness of a note stem.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>flag-spacing</term>
<listitem>
<para>Optional. Defines the gap between note flags in
cases where multiple flags are drawn by drawing a single
flag several times.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>border-x</term>
<listitem>
<para>Optional. Specifies that the note head pixmaps
have a fixed area to left and right that should not be
considered part of the note head. This attribute gives
the thickness of that area.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>border-y</term>
<listitem>
<para>Optional. Specifies that the note head pixmaps
have a fixed area to top and bottom that should not be
considered part of the note head. This attribute gives
the thickness of that area.</para>
</listitem>
</varlistentry>
</variablelist>
</sect3>
<sect3 id="developers-note-fonts-mapping-format-font-symbol-map">
<title>font-symbol-map</title>
<para>
This element lists the symbols available in this notation
font, and which pixmap files or system font code points
they should be drawn from.</para>
<para>It should contain a list of "symbol" elements. These
have several possible attributes, the choice of which will
normally depend on whether the font is based on pixmaps or
system fonts:
</para>
<variablelist>
<varlistentry>
<term>name</term>
<listitem>
<para>Mandatory. This attribute should contain the
name of the notation symbol. If the symbol exists in
the <ulink
url="http://www.unicode.org/charts/PDF/U1D100.pdf">Unicode
3.2 standard</ulink>, the name should be that used to
identify the symbol in the standard.</para>
<para>Most of the symbols Rosegarden expects to find
are in the standard; one exception is that many fonts
have a special version of the flag symbol that is
intended to be used when composing multiple flags from
individual single flags. Rosegarden refers to this as
"MUSICAL SYMBOL COMBINING FLAG-0", a name not used in
the Unicode standard (which has flags 1-5 only).</para>
<para>For a definitive set of the symbol names
Rosegarden knows about, see the file
"gui/notecharname.cpp" in the Rosegarden source
distribution. Note however that it is possible to use
additional symbol names by introducing them in a <link
linkend="developers-note-styles">notation
style</link>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>src</term>
<listitem>
<para>The name of the pixmap file from which this
symbol should be loaded, without a directory or
extension. This is the usual way of describing a
symbol in a pixmap font. The file itself should be
installed to
fonts/<font-name>/<font-size>/<src>.xpm
under the Rosegarden installation directory.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>inversion-src</term>
<listitem>
<para>The name of a pixmap file from which an inverted
version of this symbol may be loaded, without a
directory or extension. If this attribute is absent
and an inverted version of the symbol is required, it
will be generated simply by loading the normal version
and reflecting it in a central x-axis.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>code</term>
<listitem>
<para>The code point at which this symbol may be found
in the relevant system font, as a decimal integer.
This is a way of describing a symbol in a scalable
font. This attribute will only be referred to if no
pixmap file is supplied, or if the pixmap file fails
to load.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>inversion-code</term>
<listitem>
<para>The code point at which an inverted version of
this symbol may be found in the relevant system font.
If this attribute is absent and an inverted version of
the symbol is required, it will be generated simply by
loading the normal version and reflecting it in a
central x-axis.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>glyph</term>
<listitem>
<para>The raw glyph index at which this symbol may be found
in the relevant system font, as a decimal integer.
This is a way of describing a symbol in a scalable
font. This attribute will only be referred to if no
pixmap file is supplied, or if the pixmap file fails
to load.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>inversion-glyph</term>
<listitem>
<para>The raw glyph index at which an inverted version of
this symbol may be found in the relevant system font.
If this attribute is absent and an inverted version of
the symbol is required, it will be generated simply by
loading the normal version and reflecting it in a
central x-axis.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>font-id</term>
<listitem>
<para>The id of the system font from which this symbol
should be loaded, as defined in the <link
linkend="developers-note-fonts-mapping-format-font-requirements">font-requirements</link>
element. The default is 0.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>codebase</term>
<listitem>
<para>This (decimal integer) attribute may be of use
if many of the symbols in a scalable font cover a
short range of code points starting at a relatively
high code page. If supplied, the codebase value will
be added to each of the subsequent code and
inversion-code values when looking up a symbol.
</para>
</listitem>
</varlistentry>
</variablelist>
<para>
Although none of these attributes is mandatory except for
the name, a symbol obviously needs to supply at least one
of "src", "inversion-src", "code", "inversion-code",
"glyph", or "inversion-glyph" to stand any chance of being
rendered at all. It is of course perfectly legitimate to
supply several or all of these attributes.
</para>
</sect3>
<sect3 id="developers-note-fonts-mapping-format-font-hotspots">
<title>font-hotspots</title>
<para>
</para>
</sect3>
</sect2>
</sect1>
<sect1 id="developers-note-styles">
<title>Creating new notation styles</title>
<para>
Rosegarden's notation editor has the ability to display and
edit notes in various standard styles: classical, diamond
heads and so on. These styles are all defined in XML style
definition files installed along with the application, and
it's possible to create a new one by writing a simple XML
file. Rosegarden simply looks at the set of installed files
to determine which styles to offer the user. You can refer to
the default set of files in the styles subdirectory of the
Rosegarden installation directory for examples.
</para>
<para>
The file format is not yet especially comprehensive; at the
moment it has been designed to be powerful enough to describe
the standard styles that come with Rosegarden, but not much
more. If you should try to create new styles this way, we'd
be very interested in your feedback on the Rosegarden
mailing-lists.
</para>
<sect2 id="developers-note-styles-format">
<title>Notation style XML format</title>
<para>
Here is a summary of the XML elements that may be used in
a style definition file.
</para>
<sect3 id="developers-note-styles-note-style">
<title>rosegarden-note-style</title>
<para>This element must exist in every style file, and
should contain all the other elements. It has one optional
attribute, "base-style", which may be used to name a style
from which this style takes the default values for any
parameters not specified elsewhere in the present file.
It's often good practice to define a style in terms of the
minimal difference from a given base style: see the supplied
Cross.xml for a particularly simple example.
</para>
<para>Note that the "rosegarden-note-style" element does not
give the name of the style being defined, which is instead
currently drawn from the name of the file. At some point in
the future we may add internationalizable style name
attributes to this element.</para>
</sect3>
<sect3 id="developers-note-styles-global-note">
<title>global, note</title>
<para>Within the "rosegarden-note-style" element, there may
be one "global" element and any number of "note" elements.
We describe these together, as they have almost identical
sets of attributes. The "global" element simply provides
default values for those parameters not specified for a
particular note type in any following "note" element.
</para>
<para>The attributes for these elements are as follows. All
of these are optional except as described:</para>
<variablelist>
<varlistentry>
<term>type</term>
<listitem>
<para>Only relevant to the "note" element, and
mandatory for that element. This attribute specifies
which sort of note is being styled. Legal values are
textual American or British note names (from "64th",
"sixth-fourth note", "hemidemisemiquaver" etc to
"double whole note").
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>shape</term>
<listitem>
<para>Defines a note head shape for this style. Any
string is a legal value, but the only values
implemented so far are "angled oval", "level oval",
"breve", "cross", "triangle up", "triangle down",
"diamond" and "rectangle". The value "number" is also
recognised but not yet implemented.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>charname</term>
<listitem>
<para>Defines a note font character name to be used as
the note head for this style. An element may supply a
"shape" or "charname" attribute, but not both. The
name should be one of those defined in the current
notation font's <link
linkend="developers-note-fonts-mapping-format-font-symbol-map">symbol
map</link> (in a "name" attribute).
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>filled</term>
<listitem>
<para>Specifies whether this note should have a filled
head (where applicable, i.e. where the shape attribute
supplies a shape that is available both filled and
unfilled). Must be "true" or "false".
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>stem</term>
<listitem>
<para>Specifies whether this note should have a stem.
Must be "true" or "false".
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>flags</term>
<listitem>
<para>Defines how many flags or beams this note should
have. The valid range is 0 to 4.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>slashes</term>
<listitem>
<para>Defines how many slashes this note should have
across its stem.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>hfixpoint</term>
<listitem>
<para>Specifies in which x position the stem fixes to
the note head. Acceptable values are "normal" (the
right side when the stem points up, the left when it
points down), "central", and "reversed" (left side
when the stem points up, right when it points down).
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>vfixpoint</term>
<listitem>
<para>Specifies in which y position the stem fixes to
the note head. Acceptable values are "near" (the stem
fixes to the top when pointing up, the bottom when
pointing down), "middle", or "far".
</para>
</listitem>
</varlistentry>
</variablelist>
</sect3>
</sect2>
</sect1>
<!-- (OPTIONAL) A Programming/Scripting reference chapter should be
used for apps that use plugins or that provide their own scripting hooks
and/or development libraries. -->
<!-- cc: I think we should document the DCOP API here, but I don't
think we should include extensive developer docs, although we should
point to where they can be found in the source tree or online. -->
<!--
<para>
Programming <application>Rosegarden</application> plugins is
a joy to behold. Just read through the next
66 pages of <acronym>API</acronym>'s to learn how!
</para>
-->
<!-- Use refentries to describe APIs. Refentries are fairly
complicated and you should consult the docbook reference for
further details. The example below was taken from that reference
and shortened a bit for readability. -->
<!--
<refentry id="re-1007-unmanagechildren-1">
<refmeta>
<refentrytitle>XtUnmanageChildren</refentrytitle>
<refmiscinfo>Xt – Geometry Management</refmiscinfo>
</refmeta>
<refnamediv>
<refname>XtUnmanageChildren
</refname>
<refpurpose>remove a list of children from a parent widget's managed list.
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<refsynopsisdivinfo>
<date>4 March 1996</date>
</refsynopsisdivinfo>
<synopsis>
void XtUnmanageChildren(<replaceable>children</replaceable>, <replaceable>num_children</replaceable>)
WidgetList <replaceable>children</replaceable>;
Cardinal <replaceable>num_children</replaceable>;
</synopsis>
<refsect2 id="r2-1007-unmanagechildren-1">
<title>Inputs</title>
<variablelist>
<varlistentry>
<term><replaceable>children</replaceable>
</term>
<listitem>
<para>
Specifies an array of child widgets. Each child must be of
class RectObj or any subclass thereof.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><replaceable>num_children</replaceable>
</term>
<listitem>
<para>Specifies the number of elements in <replaceable>children</replaceable>.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2></refsynopsisdiv>
<refsect1 id="r1-1007-unmanagechildren-1">
<title>Description
</title>
<para>
<function>XtUnmanageChildren()</function> unmaps the specified widgets
and removes them from their parent's geometry management.
The widgets will disappear from the screen, and (depending
on its parent) may no longer have screen space allocated for
them.
</para>
<para>Each of the widgets in the <replaceable>children</replaceable> array must have
the same parent.
</para>
<para>See the “Algorithm” section below for full details of the
widget unmanagement procedure.
</para>
</refsect1>
<refsect1 id="r1-1007-unmanagechildren-2">
<title>Usage</title>
<para>
Unmanaging widgets is the usual method for temporarily
making them invisible. They can be re-managed with
<function>XtManageChildren()</function>.
</para>
<para>
You can unmap a widget, but leave it under geometry
management by calling <function>XtUnmapWidget()</function>. You can
destroy a widget's window without destroying the widget by
calling <function>XtUnrealizeWidget()</function>. You can destroy a
widget completely with <function>XtDestroyWidget()</function>.
</para>
<para>
If you are only going to unmanage a single widget, it is
more convenient to call <function>XtUnmanageChild()</function>. It is
often more convenient to call <function>XtUnmanageChild()</function>
several times than it is to declare and initialize an array
of widgets to pass to <function>XtUnmanageChildren()</function>. Calling
<function>XtUnmanageChildren()</function> is more efficient, however,
because it only calls the parent's <function>change_managed()</function>
method once.
</para>
</refsect1>
<refsect1 id="r1-1007-unmanagechildren-3">
<title>Algorithm
</title>
<para><function>XtUnmanageChildren()</function> performs the following:
</para>
<variablelist>
<varlistentry>
<term>-
</term>
<listitem>
<para>Ignores the child if it already is unmanaged or is being
destroyed.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-
</term>
<listitem>
<para>Otherwise, if the child is realized, it makes it nonvisible
by unmapping it.
</para>
</listitem>
</varlistentry>
</variablelist>
<para>
</para>
</refsect1>
<refsect1 id="r1-1007-unmanagechildren-4">
<title>Structures</title>
<para>
The <type>WidgetList</type> type is simply an array of widgets:
</para>
<screen id="sc-1007-unmanagechildren-1">
typedef Widget *WidgetList;
</screen>
</refsect1>
</refentry>
-->
</chapter>
<chapter id="credits">
<title>Credits and License</title>
<para>
<application>Rosegarden</application>
</para>
<para>
<itemizedlist>
<listitem>
<para>
Rosegarden-4 is Copyright 2000-2003 Guillaume Laurent,
Chris Cannam and Richard Bown. The moral rights of
Guillaume Laurent, Chris Cannam and Richard Bown to be
identified as the authors of this work have been asserted.
</para>
</listitem>
<listitem>
<para>
Parts of Rosegarden-4 are derived from Rosegarden 2.1,
which is Copyright 1994 – 2001 Chris Cannam, Andrew Green,
Richard Bown and Guillaume Laurent.
</para>
</listitem>
<listitem>
<para>
For musical notation display Rosegarden-4 uses pixmaps
derived from the Feta font, part of the <ulink
url="http://lilypond.org/">Lilypond</ulink> software,
which is Copyright 1997 – 2001 Jan Nieuwenhuizen and
Han-Wen Nienhuys.
</para>
</listitem>
<listitem>
<para>
Other major contributors include Randall Farmer, Ron
Kuris, Hans Kieserman, and Michael McIntyre.
</para>
</listitem>
<listitem>
<para>
The Rosegarden splash-screen image is from a 1900 postcard
of Thornden Park at Syracuse University, Syracuse, NY,
used with thanks to the staff of Syracuse University.
</para>
</listitem>
</itemizedlist>
</para>
<para>
Documentation copyright 2002-2003 Chris Cannam, Richard Bown, Guillaume Laurent
</para>
<!--
<para>
Translations done by:
<itemizedlist>
<listitem>
<para>Babel D. Fish <email>babelfish@kde.org</email> (Sanskrit)</para>
</listitem>
</itemizedlist>
</para>
-->
<!-- For URL links to common stuff like the one below,
always use paths like "common/gpl-licence".
In this path, "common" will be a symbolic link built at "make install" time.
This link will normally point to $TDEDIR/share/doc/HTML/en/common,
where "en" should be replaced with the current language. -->
<para>
This program is licensed under the terms of the
<ulink url="common/gpl-license.html">GNU GPL</ulink>.
</para>
</chapter>
&documentation.index;
</book>
