diff options
Diffstat (limited to 'doc/ja/index.docbook')
| -rw-r--r-- | doc/ja/index.docbook | 5376 |
1 files changed, 5376 insertions, 0 deletions
diff --git a/doc/ja/index.docbook b/doc/ja/index.docbook new file mode 100644 index 0000000..a1c09bf --- /dev/null +++ b/doc/ja/index.docbook @@ -0,0 +1,5376 @@ +<?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> + &rosegarden; がMIDIファイルのようなファイル形式をロード/セーブ + できるにもかかわらず、内部的には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ツのメトロノームを持っていて、その1つは + 録音中に使い、もう一つは通常の再生中にスイッチすることができる。 + それらは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> + + メトロノームを構成するためには、スタジオメニュー上の + "メトロノームの管理"オプションを使いメトロノームダイアログを + 起動する。そののち、メトロノームのためのMIDI楽器とメトロノーム + の解像度(1つのビートあたりのティック、ビートの再分割、 + あるいはビートあたり1つ)を選択できる。MIDIシンセサイザーの + 実際のボイスのようなプロパティは選択された楽器に依存する + メトロノームのティックのために使われ、トラックに割り当てられた + 楽器に依存するMIDIトラックのために使われるボイスのようである。 + メインウィンドウ上でそれにをラックを割り当てることで楽器を + 構成することができ、楽器パラメータボックスから正しいプログラム + を選択することができる。 + </para> + + <para> + メトロノームの録音と再生はTransportウィンドウでメトロノーム + ボタンによってonまたはoffすることができる。このボタンは + 録音が供給されているか、実行中の時にメトロノームの録音を制御し、 + 録音メトロノームは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キーボードからのノートのタイプ</title> + + <sect4> + <title>Duration</title> + + <para> + キーボードからのノートのdurations入力は、ツールバー又は + 表示メニュー上のグリッド設定によって制御される。これを + 以下の数字キーを使って設定することができる:</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キーボードからのノートの入力</title> + + <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デバイスにキーボードを構成することを確実にする必要が + ある。次に、ツールバー又は表示メニュー中で、このコントロールが、 + ノートのdurationとなる正しいグリッド設定を確実にする必要がある。 + 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> + 基本的なツールはツールバーボタンから通常アクセスできる、 + 選択ツール、消去ツールと、ノートの挿入、rests、テキスト + その他のためのそれらである。ツールを選択すると、代わりに + 少なくとも他のツールが選択されるまで、メインnotation + キャンバス上でマウスボタンの既定の動作が変わる。たとえば、 + 選択ツールを選択すると、選択が可能になり、(以下の) + 選択ベースの機能が使えるようになる。挿入ツールを選択すると + (たとえばノートの1つ)、<acronym>GUI</acronym>の動作が + 切り替えられ、キャンバス上でクリックすることでノートを + 挿入できる。削除ツールはそれらをクリックすることでイベントを + 削除する。 + </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のすべて + をセンタｃするために、3回クリックする。編集メニューは + 挿入カーソルの位置上を元にした拡張領域を選択するための + 機能を運び、シフトキーと左又は右矢印キーを押すことによって、 + 挿入カーソルの周りのイベントを選択できる。 + </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>ノートの挿入とrests</title> + + <para> + noteを挿入するために、ツールバー上の特定のduration上でクリックする + ことによってノートメニューの1つを選択し、ノートを追加したい位置の + 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 $KDEDIR/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> |