Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

タイムラインと構造

シナリオは音響標本を一つずつ予定表へ並べません。スクリプト上の時刻を進め、その時点で Populationを配置し、更新または終了する時刻を記述します。

place、wait、flush

place()は現在時刻に初代のVoiceをただちに配置し、安定したPopulationへの参照を 返します。wait(seconds)は保留中の更新を発行して時刻を進めます。flush()は 時刻を進めずに保留中の更新だけを発行します。

let spec = harmonic()
    .amp(0.04)
    .brightness(0.35)
    .sustain();

let population = place(spec, consonance(220.0).count(3));
population.amp(0.025); // Live patch at the same script time.
flush();               // Emit it; the cursor does not move.
wait(2.0);             // Advance two seconds.
release(population);

意味上の境界はwait()やflush()ではなくplace()です。発音体、振る舞い、生存過程、 再生成の初期設定はPopulationSpecに属し、実行中の更新と終了だけがPopulationに属します。

release、section、play

release(population)は明示的なreleaseです。section(name, callback)と play(callback, ...)は有効範囲を作り、関数が戻ると内部で作られたPopulationを 自動的にreleaseします。有効範囲の終了時にはreleaseより前に保留中の更新を発行します。

名前の付いたformにはsectionを使います。名前はreportのscene_markerになります。 引数を取る再利用可能なgestureにはplayを使います。

let gesture = |root_hz, duration_sec| {
    place(
        harmonic().amp(0.035).sustain(),
        consonance(root_hz).peak().count(3)
    );
    wait(duration_sec);
};

section("two gestures", || {
    play(gesture, 110.0, 2.0);
    play(gesture, 165.0, 2.0);
});

各playが作るPopulationは呼び出しの終了時にreleaseされます。外側のsectionはレポートの印を 提供し、その直下で作ったものを所有します。

Parallel timeline

parallel([callbacks])は現在時刻から複数のcursorをforkします。全branchは同時に始まり、 記述後の主時刻は最長の分岐の終端へ進みます。各分岐も一つの有効範囲であり、戻ると内部の Populationをreleaseします。

section("overlap", || {
    parallel([
        || {
            place(sine().amp(0.05).sustain(), at(220.0));
            wait(3.0);
        },
        || {
            wait(1.0);
            place(harmonic().amp(0.03).sustain(), at(330.0));
            wait(1.0);
        }
    ]);
});

第一branchはforkから3秒後、第二branchは2秒後に終わるため、main cursorは3秒進みます。 両分岐の有効範囲が重なる区間だけ、両方のVoiceが同時に鳴ります。

スクリプト上の時刻と実行時の振る舞い

スクリプト上の時刻は制御事象の時刻を決めます。その時刻のLandscapeを予測するものでは ありません。wait()でscenarioが進む間も、movement、coupled rhythm、death、respawnは 実行中も続きます。

  • scriptはmacro structureを書く。
  • Communityは瞬間ごとの振る舞いを生成する。
  • レポートは、記述された区間で実際に起きたことを示す。

演奏で説明した手順を使って結果を確かめ、scenarioを修正します。 特定の実現を再現するときだけseed(...)または--seedを使います。

シーン全体の設定と途中の変更

大域的な設定の名前は、いつ適用されるかを表します。set_のない meter_stability、temporal_basin、control_update_mode、scaffold_off、 scaffold_shared、scaffold_scrambled、seed、output_gainはシーン全体の初期条件です。 終わりを定めた曲では、wait()の後に書いても、最後の指定が全体へ適用されます。temporal_modeも 初期条件ですが、イベントを置く前に最上位で一度だけ宣言します。

set_roughness_aversion、set_harmonicity_preference、set_support_focus_preference、 set_support_conflict_preference、set_related_novelty_preference、set_global_coupling、 set_pitch_objectiveは、 その時点のスクリプト時刻に変更を置きます。wait()で変更の時刻を選べます。 配置、解放、有効範囲を作る語は、引き続き操作そのものを表します。

部屋の響きを選ぶ

room("presentation") を指定すると、客席にはステレオの反射音が加わり、生態系には直接音が届きます。地点を一つも指定しない曲では、客席は全音源を 12 m の距離で聴きます。 同じ曲を both で演奏すると、客席の響きは従来の 23.5 m 相当になります。 room("both") では、生態系にも反射音が届きます。自分の音を除いて聴く個体では、自分が出した音の反射も差し引きます。 反射音を使う場合のサンプルレートは 48 kHz です。room("off") はモノラルの直接音を選びます。 台本に宣言がなければ設定ファイルの [room].mode が効き、両方を省略すると off になります。

有限の曲では、最後の宣言が wait() の後にあっても曲頭から効きます。 endless() では最初に時刻を進める前に宣言します。both は個体別の履歴をあらかじめ確保できる有限の曲で使えます。

音源と耳を置く

有限の台本を conchordal-render で描画するときは、配置に site(x, y) を付けてメートル単位の座標を選べます。下の例では、線を (−12, 0) と (12, 0) のどちらに置いても客席からは 12 m です。線を (12, 0) に移すと、苔には線の直接音が強く届きます。

room("both");
let moss = place(flora().respond_to_onsets(2), random(200, 1000).site(12, 0));
let line = place(sine().sustain(), at(500).site(-12, 0)); // try (12, 0)
wait(4);

一つでも地点を指定すると、曲頭からすべての配置に距離が効き、無指定の音源は (0, 12) に置かれます。客席と生態系の共有の観測点は原点 (0, 0) です。直接音の振幅は、1 m を下限として耳までの距離で割ります。反射音への送りは距離によらず 1/23.5 なので、both では遠くの音ほど個体に届く残響の割合が高まります。すべてのモードで、複数の外音の相対的な大きさや、かすかな音が解析の床を越えるかどうかが変わります。二者だけの off/presentation で外音が一声なら、調波性・粗さの正規化が音量差をほぼ相殺します。絶対量を使う資源消費や音の重なりには距離が効きます。地点は固定で、伝搬の遅れ、左右の方位、発音中の移動は扱いません。全音源を (0, 12) に置くと、presentation で地点を省いたときと客席の直接音・反射音の比が揃います。地点を指定すると個体がその場所の音を聴くため、演奏自体は変わることがあります。

共有の慣れ、音響から学ぶ拍、音高集合の記憶は原点で聴きます。原点に近い音が共有の慣れや拍を支配しても、遠方の個体にはその音が小さく届きます。原点と客席の感度は 12 で、原点の近くでいくつもの音が重なると調性感・音高集合を読む IPEM の入力範囲 [−1, 1) で飽和しえます。左チャネルの max_p は最終 gain と limiter より前の客席音を測ります。個体の耳では 1 m 基準の振幅を保ちます。地点指定は有限の offline 描画で使えます。follow_harmonic_relations と follow_harmonic_continuation の重みは 0 を指定するか、省略します。

曲全体の再生音量

output_gain(db)で曲全体の再生音量をdB単位で指定します。整数と小数のどちらも使え、 省略時は0 dBです。終わりを定めた曲では、seedと同じく、wait()の後の宣言も含めて最後の指定が曲全体に 適用されます。途中の音量変化やフェードを作る操作ではありません。

output_gain(3.0);
play(|| {
    place(sine().amp(0.04).sustain(), at(220.0));
    wait(2.0);
});

指定値は設定ファイルの[audio].output_gain_db(既定値は off で +4.0 dB、presentation と地点指定のある both で −5.0 dB、地点指定のない both で −10.5 dB)に加算され、 振幅を10^((設定のdB + 曲のdB)/20)倍にします。楽器のスピーカー出力と、オフライン描画の WAV出力の両方で、出力リミッターの直前に適用されます。リミッターを無効にしても音量指定は 有効です。曲の指定を0にすると、設定ファイルで定めた再生音量を保ちます。音量を上げると、 ピークを抑えるリミッターが働く場合があります。

変わるのは再生音量だけです。音響解析、ListenerTwin、生態、レポート、UIの音量表示には 元の水準の音が渡ります。Populationの発音そのものや、生態に与える影響を変えるときは amp()を使います。

値は有限で、振幅倍率が有限かつ正のf32として表現できる必要があります。設定値と加算した 結果も同じ条件で検査し、不正な指定には宣言位置を付けてエラーを返します。この制限は f32の表現範囲によるものです。作品の音量目標や、それ以外のdB範囲は設けていません。

既知の終わりへ向けた表情

expressive_section(name, arch_weight, ritard_weight, callback)は、作者が明示した 最後の区間に強弱の弧と減速を付けます。Populationの所有と自動解放はsectionと同じです。 二つの重みは初期の指定だけに使い、有限の非負値を受け取ります。0では中立、1以上では 完全適用に飽和します。語を使わなければ従来の音を保ち、両方0ならsectionと同じ処理を通ります。

temporal_basin(1.6, 2.4);
meter_stability(0.55);
let pluck = modal().metric()
    .modes(stiff_string_modes(0.004).count(12))
    .brightness(0.42).adsr(0.004, 0.18, 0.0, 0.35).amp(0.04);
let pulse = place(pluck, line(196.0, 392.0).count(3));
section("opening", || { wait(4.0); });
expressive_section("ending", 1.0, 1.0, || {
    wait(8.0);
    release(pulse);
});

曲線にはTodd(1992)の単層の強度とFriberg–Sundberg(1999)のq=3の減速を使います。 これらは候補モデルです。作者の区間に割り当てること、振幅の床を加えること、生成時計を 一時的に固定することは作者規則です。句や終止を知覚したという意味ではありません。 既定の聴き手の型へ自動で加える機能でもありません。

初版の対象は、自由音高の再発音を伴わないOnceのVoiceと、持続しない同期型のmetric()の Voiceです。Flora、参加型の時計、持続するmetric()、follow_own_sequenceとの併用、 restは対象外です。対象外を含むシーンでは警告を出し、表情の効果全体を無視します。 既存の語の指定は消しません。非零の区間は一つだけとし、全Populationを終端までに解放します。 例のように外側で作ったPopulationには明示的なreleaseが必要です。関数を抜ける際の自動解放は 内部で作ったPopulationだけに働きます。区間後の配置や更新はできません。不正な重みや区間も 警告して効果を無視します。装置の設定時には、Onceの発音と解放が同じ配送hopに入る場合と、 変換後600秒を越える場合を、時間写像の適用前に診断します。

強弱は既に鳴っている余韻を含め、両busへ分ける前の発音に作用します。発音行為の直接の エネルギー更新には掛けません。完全適用では区間中央の振幅が√2倍になります。 減速の完全適用では区間長が約1.403倍になり、末端の速度は入口の0.3倍になります。 同期時計の入口の位相速度を保存し、区間内では速度の再抽選も停止します。感覚の観測、生態、 身体の包絡は実時間のままです。gate単位の音長は同じ写像に従い、解放の開始は遅くなりますが、 その後のフェードは元の秒数を保ちます。入口より前に予約済みのOffは元の実時刻を保ちます。 減速の重みは正ならどれだけ小さくても時計を固定し、0なら従来の時計を維持します。 区間名や予定された終端をListenerTwinの終止の知覚の根拠へ渡すことはありません。

Once は出生時に発音する形に限ります。Once の phonate_when_viable() は初版の対象外です。

終わりを定めずに演奏する

endless()を宣言すると、脚本が最後まで進んでも演奏は続きます。イベントが 尽きた後もVoiceは活動し、世代交代も続きます。すべてを解放した場合も自動終了せず、 無音のまま演奏者の終了操作を待ちます。endless()は最上位に一度だけ、再生イベントを 置く前、時刻を進める前に書きます。

endless();
let drone = place(sine().amp(0.04).anchor().sustain(), at(220.0));
wait(2.0);
drone.amp(0.025);
flush();

GUIの End または一度目のCtrl-Cで、残っているPopulation、Flora、Rainをそれぞれに 指定した長さでフェードさせて終了します。すでに始まっているフェードも最後まで待ちます。 Exit、ウィンドウを閉じる操作、二度目のCtrl-Cは即時終了です。

--duration <sec>を指定すると、その演奏時刻に終了を要求します。同じ処理区間に 予定されたイベントを配ってから解放するので、出力には解放後のフェードや余韻も含まれます。 終わりを定めた曲が指定時刻より先に終わる場合は、そのまま終了します。

終わりを定めない曲をconchordal-renderでWAVに書く場合、--durationが必須です。 楽器でも、この種の曲に--reportや--profileを付ける場合は--durationが必要です。 計測記録には処理区間数の上限があるので、フェードの余地を残してください。 WAVは起動時の長さの検査に加え、書き込み中にもRIFF形式の上限を検査します。 楽器自体には録音機能はありません。

終わりを定めない曲には、次の三つの規則があります。

  • seed、output_gain、temporal_mode、scaffold_*、 control_update_mode、meter_stability、temporal_basinは、最初に時刻を 進めるwait()より前に宣言します。いずれも演奏全体の初期条件です。
  • 自分自身の音を除外するPopulationには、配置前のPopulationSpecで leave_self_out(true)を指定します。その能力を後から新たに追加する更新はできません。 配置時に指定してあれば、無効にしてから再び有効にする更新はできます。
  • parallelは使えません。

終わりを定めない脚本は専用のスレッドで、演奏時刻の少し先まで逐次評価します。 終わらないループには、譜面時刻を進めるwait()を入れます。

endless();
loop {
    section("breath", || {
        let p = place(sine().sustain(), at(220));
        wait(4);
    });
    wait(2);
}

最初に時刻を進めるwait()で演奏全体の初期条件を確定します。時刻を進めずに脚本が 返る場合は、その時点で確定します。時刻0のイベントは確定するまで実行しません。 metric()で拍に同期するVoiceの初期値には、最後のtemporal_basin宣言を反映します。 最初のイベントより前にwait()を書いてもかまいません。初期条件の確定後に脚本で エラーが起きると、以後の評価は止まりますが、確定済みのイベントと生態系の演奏は 続きます。System欄で評価済み時刻、完了、エラー、同じ呼び出し箇所ごとにまとめた 警告を確認できます。

繰り返し配置するPopulationやFloraは、明示的に解放するか、処理を終えて解放する sectionやplayの内側で作ります。Voiceが自然に死んでも、未解放のPopulationの 記録は残ります。配置やRhai配列を解放せず増やし続ける場合、その保持量は作者側の管理です。

終わりを定めない曲のコンパイルのみの実行とWAV出力には、--durationが必要です。 その範囲を越えるwait()では、範囲の時刻で評価を止め、sectionやplayの内側で 作ったPopulationとFloraを解放します。この解放は同じ時刻の演奏終了要求より先に 実行します。--compile-onlyでは end: open (evaluated through t=…)を表示します。有限曲は従来どおり一括評価し、 parallelも利用できます。1処理区間内の操作数や、操作に付随するデータの保持量が 受け渡し用のキューの容量を超えると、WAV出力とコンパイルのみの実行は、同じ譜面時刻で 容量超過のエラーになります。

脚本から使える機能

終わりの有無にかかわらず、すべての脚本でevalとファイルを読むimportを禁止します。 sleepとtimestampもエラーになります。演奏上の時刻を進めるにはwait()を使います。 実時間をtimestampやelapsedで読み取る経路と、sleepで評価を止める経路を閉じることで、 脚本とseedから演奏予定が定まります。診断用のprintとdebugは引き続き使えます。

調的文脈の観測を予約する

終わりを定めない曲で正の重みのfollow_tonal_contextを配置する場合、時刻を進める前、 その配置より前にobserve_tonal_context()を宣言します。これは作者規則です。演奏開始時から 調的文脈の観測器と表を用意し、後から生まれるVoiceにもそれまでに聴いた履歴を渡します。 時刻が進んだ後の宣言と、宣言なしの正の重みの配置は、位置付きの脚本エラーになります。 有限の曲では宣言は不要です。書いた場合は警告して無効にし、従来どおり配置の先読みにより 観測器の要否を決めます。

終わりを定めない曲では、共有のonset habituationを演奏開始時から観測します。 後のrest_on_habituationの配置を予見できないためです。有限の曲は正の重みの利用者が ある場合だけ観測器を用意します。harmonic_rhythmも、終わりを定めない曲では最初に 時刻を進めるwait()より前に宣言します。

支持の集中・競合・関連する新規成分への三つの選好は、いずれも既定値が0です。 集中と競合には符号付きの有限値、新規成分には0以上の有限値を指定します。 聴いた音の一次の支持場を身体の部分音で積分する作者規則です。Voiceの移動には leave_self_out(true)が必要で、自己除外がないVoiceでは正の重みを一度警告し、 移動への加点を無視します。出生のpeak・density・tensionとFloraのlane選択にも作用します。 Floraの成長、慣れ、ListenerTwinの入力は変えません。部分音の密度は身体のスペクトルの 自己申告から出生・再構成時に保存します。自己申告がない身体は基本周波数の単一部分音として 読み、その旨を表示します。これは仮想的なPCMの混合結果を予測する評価ではありません。

follow_harmonic_relations(w) と follow_harmonic_continuation(w) はcursor eventで、 有限の [-1,1]、既定0の符号付きの性向を取ります。関係は、動くときの行き先について 正なら学んだ関係への適合、負なら離脱を好みます。継続は、正なら保持・待機・出生見送り、 負ならその逆の方向を、学んだ継続の支持に応じて評価します。関係だけでは既定の 「動く/保つ」を変更しません。どちらも作者規則であり、既存の慣れや身体費用を含む scoreへ加算します。未知の証拠は中立、両方0なら元の経路と乱数列を保ちます。 固定の調や進行profileを使わず、性向の変更でも履歴は残ります。 シーンの途中で変更する場合は、wait()でcursorを進めてから指定します。

endlessでの和声観測の予約

endlessでは縦の支持scanを演奏開始時から公開し、三つの評価重みが0の間も観測します。 時間方向の関係モデルは、時刻を進める前にobserve_harmonic_relations(max_sources)で 別に予約します。正の整数max_sourcesは退役中を含む同時VoiceとFlora laneの最大音源数で、 上限38400は既存の構造記録の容量に由来し、音楽上の上限ではありません。時間の二語は 正負いずれかの非零重みを使うときに宣言が必要で、未宣言と遅い宣言は位置付きの脚本エラーです。 有限の曲では宣言を警告して無視し、観測器と音源容量は従来どおりeventの先読みで決めます。 宣言だけでは評価重みは有効になりません。宣言は作者規則で、既存の600秒の移動履歴と 対応するevent密度の範囲を変更しません。