スライダー

Slider ノードは、編集中のプライベートブループリントが属する nl.slider の実行時の値と範囲を読み書きします——たとえば Init 時に保存済みの音量を読み込む必要がある音量コントロールや、モードによって範囲が変わる難易度セレクターなどです。ドラッグイベント自体は Events にあります。

規約

• 1つのノードを除き、すべてがマッピング済みの値を扱います。 props.value とその Blueprint Value、dragStart / valueChanged / dragEnd のペイロード、Get Value、Set Slider Value は、いずれも min…max の単位で値を運びます。0…1 の比率は Get Normalized Value にしか存在しません——これを塗りつぶし幅に接続し、Get Value はプレイヤーが数値として読むものに接続してください。

• 書き込まれた値は clamp され、snap され、再び clamp されます。 snap は min から整数ステップ分だけ上へ数えるもので、2回目の clamp は、範囲を割り切らないステップが値を max の外に押し出すのを防ぐ役割を持ちます。

  clamped = clamp(value, min, max)
  snapped = min + round((clamped - min) / step) * step
  value   = clamp(snapped, min, max)

• step が 0 のときは snap が無効になります。 その場合、値は範囲内を連続的に変化します。負の step は 0 として扱われます。

• 範囲は使用される前に修正されます。 max が min 以下のときは常に min + 1 に強制されるため、スライダーの範囲が幅ゼロになることはありません。有限数でない値はフォールバックします——壊れた範囲を読み取る場合はウィジェットの既定値（min 0、max 100、step 1）に、Set Slider Range の場合はその項目の現在の実行時の値にフォールバックします。

• 読み取りは pure、書き込みは latent です。 Get Value、Get Normalized Value、Get Slider Range は event、function、macro グラフで実行でき、Blueprint Value グラフでも使用できます。2つの書き込みノードは latent で、event と macro に限られます——function は呼び出し元に同期的に値を返すため、保留中の書き込みを置いておく場所がありません。

• これらは Self ノードです。 グラフを所有する Slider に対して作用し、ターゲットピンを持ちません。別の Slider を操作するには、Element にある blueprint.element.slider.* の対をなすノードを使用してください。これらは slider 入力を持ち、グラフに nl.slider へのバインディングノードがある場合にのみ現れます。

Set Slider Value

blueprint.slider.setValue · Latent

現在の min / max / step に対して正規化したマッピング値を設定します。有限数でない値は 0 として扱われてから範囲内に clamp されるため、min がゼロより大きい場合、未接続または不正な入力はハンドルを min の位置に留めます。

Set Slider Range

blueprint.slider.setRange · Latent

min、max、step をまとめて設定し、新しい範囲に対して現在の値を再正規化します。そのため、範囲を狭めるとハンドルが移動し、step を粗くするとハンドルが吸着します——値が、たった今宣言した範囲の外に取り残されることはありません。

各ピンは、有限数に解決できない場合、その項目の現在の実行時の値にフォールバックします。そのため、あるピンを未接続のままにし、カード上の値も空にしておけば、範囲のその部分を変更せずに保つことができます。

Set Visible

blueprint.slider.setVisible · Latent

ウィジェットの実行時の可視性を設定します。これは作者が設定した visible プロパティであり、Displayable の描画スイッチではありません——要素をマウントしたまま display: none で隠したい場合は、Displayable の Set Display を参照してください。

Set Enabled

blueprint.slider.setEnabled · Latent

Slider の実行時の操作を有効または無効にします。

Get Value

blueprint.slider.getValue · Pure

現在のマッピング値を出力します——すでに min / max / step に対して clamp と snap が済んでいます。これがセーブに保存したり、コントロールの横に表示したりする数値です。

Get Normalized Value

blueprint.slider.getNormalizedValue · Pure

マッピング値の範囲内での位置を 0…1 として出力します。これは clamp と snap を経た値から導かれるため、step が粗いとこの出力も飛び飛びに変化します。

Get Slider Range

blueprint.slider.getRange · Pure

現在の実行時の範囲を3つのピンで出力します。これらは修正後の値であり、作者が設定した値そのものではありません——max にはすでに min + 1 という下限が反映されており、step が負になることもありません。

Get Visible

blueprint.slider.getVisible · Pure

Get Enabled

blueprint.slider.getEnabled · Pure