KSPリファレンスマニュアル 5 - 制御構文(Control Statements)

KSPリファレンスマニュアル 5 - 制御構文(Control Statements)


ブール演算子

x > y

より大きい。

x < y

より小さい。

x >= y

より大きいか等しい。

x <= y

より小さいか等しい。

x = y

等しい。

x # y

等しくない。

in_range(x, y, z)

xがyとzの間(両端を含む)にあればtrueです。

not a

aがfalseならtrue、その逆も同様です。

a and b

aがtrueかつbがtrueならtrueです。

a or b

aがtrueまたはbがtrueならtrueです。

a xor b

aとbのどちらか一方だけがtrueで、両方がtrueでない場合のみtrueです。

補足

  • ブール演算子はifとwhileの文で使われます。条件がtrueかfalseかを返すためです。上の一覧では、x、y、zは数値を表し、aとbはブール値を表します。


continue

while (<condition>)

    if (<condition>)

        continue

    end if

    ...

end while

continue文です。条件が満たされた場合、現在の繰り返しの残りをスキップします。

補足

  • continue文はwhileループの中でのみ使えます。

例

on init
    declare $i
    declare $skipped

    $i := 0
    while ($i < 5)
      inc($i)

      if ($i <= 3)
        continue
      end if

      inc($skipped)
    end while
  
    message($i & ", " & $skipped)
end on

whileループの最初の3回の繰り返しをスキップします。メッセージは 5, 2 と表示されます。

関連項目

while ()


if ... else ... end if

if

    <statements>

else

    <statements>

end if

条件分岐のif文です。elseの分岐は必須ではありません。

例

on controller
    if (in_range($CC_NUM, 0, 127))
        message("CC Number: " & $CC_NUM & " - Value: " & %CC[$CC_NUM])
    else
        if ($CC_NUM = $VCC_PITCH_BEND)
            message("Pitch Bend - Value: " & %CC[$CC_NUM])
        end if

        if ($CC_NUM = $VCC_MONO_AT)
            message("Channel Pressure - Value: " & %CC[$CC_NUM])
        end if
    end if
end on

さまざまなMIDIコントローラーメッセージに応じて異なるテキストを表示します。

関連項目

select ()


select ()

select (<variable>)

    case <constant>

        <statements>

    case <constant> to <constant>

        <statements>

end select

select-case文です。

補足

  • この文はif文に似ていますが、分岐の数を任意に増やせる点が異なります。selectキーワードの後の式が評価され、個々のcase分岐と照合されます。最初に一致したcase分岐が実行されます。

  • case分岐は、単一の定数値か、「x to y」という書き方で表した数値の範囲のいずれかで構成できます。

  • KSPにはelseやdefaultにあたるcase分岐はありませんが、case 08000000H to 07FFFFFFFHを使えば同じことができます。これは32ビット符号付き整数値の全範囲をカバーし、明示的に分岐が指定されていないすべてのケースを実質的に受け止めます。

例

on controller
    if ($CC_NUM = $VCC_PITCH_BEND)
        select (%CC[$VCC_PITCH_BEND])
            case -8191 to -1
                message("Pitch Bend down")
            case 0
                message("Pitch Bend center")
            case 1 to 8191
                message("Pitch Bend up")
            case 080000000H to 07FFFFFFH
                message("We're not sure how you got this Pitch Bend value!")
        end select
    end if
end on

ピッチベンドホイールの状態を調べます。

関連項目

if ... else ... end if


while ()

while (<condition>)

    <statements>

    <increment, decrement or wait>

end while

whileループです。

補足

  • whileループにカウンターもwait()/wait_ticks()コマンドも含まれていない場合、10,000,000回の繰り返しの後で停止して終了します。

例

on note
    ignore_event($EVENT_ID)

    while ($NOTE_HELD = 1)
        play_note($EVENT_NOTE, $EVENT_VELOCITY, 0, $DURATION_QUARTER / 2)
        wait($DURATION_QUARTER)
    end while
end on

押さえたノートを4分音符の間隔で繰り返します。

関連項目

wait()

wait_ticks()

イベントとMIDI:$NOTE_HELD


参照元情報:Control Statements
https://docs.native-instruments.com/online-guides/ksp-manual/en/control-statements

    • Related Articles

    • KSPリファレンスマニュアル 28 - バージョン履歴(Version History)

      以下の変更履歴は、Kontaktでリリースされたすべての新機能および改善された機能のバージョン履歴です。 Kontakt 8.8 新機能 新しいEP Preamp ...
    • KSPリファレンスマニュアル - 目次

      Kontakt Script Processor(KSP)は、Kontaktのインストゥルメントの動きを記述するスクリプト言語です。本マニュアルは、KSPのすべてのコールバック、コマンド、変数、定数を網羅したリファレンスです。各章はNative Instrumentsの原文と1対1で対応しており、見出しのアンカーも原文と同じ値を使っています。 目次 KSPへようこそ Kontakt 8.12の新機能 コールバック 一般情報 on async_complete on controller on ...
    • KSPリファレンスマニュアル 25 - 応用概念(Advanced Concepts)

      KSPからのFXの変更 はじめに Kontakt 5.5より前のバージョンでも、エフェクトスロットの内容に関する情報を取得するための仕組みは、$ENGINE_PAR_EFFECT_TYPEのようなエンジンパラメーター変数や$EFFECT_TYPE_FILTERのようなビルトイン定数を通じてすでに用意されていました(モジュールの種類とサブタイプを参照)。 Kontakt 5.5以降では、同じビルトイン定数のセットを使って、ロードされているエフェクトを変更することも可能になりました。 例 on ...
    • KSPリファレンスマニュアル 6 - ユーザー定義関数(User-defined Functions)

      function <function-name>() <statements> end function 関数を宣言します。 call <function-name> あらかじめ宣言しておいた関数を呼び出します。 補足 関数は、呼び出すよりも前に宣言しておく必要があります。 関数を宣言するときと呼び出すときには、空の丸括弧を任意で付けることができます。 ...
    • KSPリファレンスマニュアル 3 - 変数(Variables)

      一般情報 ユーザー定義変数はすべてon initコールバックの中で宣言する必要があります。 変数名に使用できるのは英数字(0-9、a-z、A-Z)とアンダースコア(_)だけです。 次の接頭辞が付いた変数は作成しないでください。これらは内部の変数および定数のために使用されています。 $NI_ $CONTROL_PAR_ $EVENT_PAR_ $ENGINE_PAR_ $ZONE_PAR_ $LOOP_PAR_ $ (integer variable) declare ...