ノード一覧に戻る

セグメント分解

segment_unpack

ベジェセグメント (Map) を座標値に分解。必要な出力だけ📤で出力ピン化できます

確認済み
解説あり

入力ポート

名前説明
セグメント
segment
Map
必須
BezierPathノードからのセグメントMap

パラメータ

名前既定値範囲説明・選択肢
始点X
p0_x
Int
0-9223372036854776000–9223372036854776000

始点のX座標

始点Y
p0_y
Int
0-9223372036854776000–9223372036854776000

始点のY座標

制御点1 X
cp1_x
Int
0-9223372036854776000–9223372036854776000

制御点1のX座標

制御点1 Y
cp1_y
Int
0-9223372036854776000–9223372036854776000

制御点1のY座標

制御点2 X
cp2_x
Int
0-9223372036854776000–9223372036854776000

制御点2のX座標

制御点2 Y
cp2_y
Int
0-9223372036854776000–9223372036854776000

制御点2のY座標

終点X
p3_x
Int
0-9223372036854776000–9223372036854776000

終点のX座標

終点Y
p3_y
Int
0-9223372036854776000–9223372036854776000

終点のY座標

概要

ベジェセグメントを8つの座標値に分解するノードです(segment_pack の逆)。 エディタで描いた形から座標を取り出して、数値として確認・加工するための 低レベル部品です。

使い方のポイント

  • 出力はすべて「出力専用パラメータ」: 必要な座標だけ📤で出力ピン化して使う (最初はピンが無いのが正常)
  • 基本の流れ: bezier_pathseg_N を📤で出力ピン化 → unpack → 必要な座標を波形で加工 → segment_packbezier_path に戻す
  • 単に「パス上の点の座標」が欲しいなら path_sample の方が高レベルで簡単。 こちらは制御点まで触りたい時専用
  • 読み取り専用出力は、任意のPath由来の座標を失わないようInt全域を扱う。 segment_pack の編集値と📌入力は -1024〜1024 なので、範囲外の座標を Packへ戻す場合はPack側で制限される

関連ノード

  • segment_pack — 再構成側の相方

  • bezier_path — セグメントの供給元・戻し先

  • path_sample — もっと簡単な座標取得

  • motion — 座標の揺らし役

  • バージョン: 1

パラメータ(出力専用)

全パラメータは promotable: false, output_promotable: true に設定されています。 スライダー/入力による編集は不可。計算結果の値が読み取り専用で表示されます。

ID 名前 説明
p0_x 始点X / P0 X Int 始点のX座標
p0_y 始点Y / P0 Y Int 始点のY座標
cp1_x 制御点1 X / CP1 X Int 制御点1のX座標
cp1_y 制御点1 Y / CP1 Y Int 制御点1のY座標
cp2_x 制御点2 X / CP2 X Int 制御点2のX座標
cp2_y 制御点2 Y / CP2 Y Int 制御点2のY座標
p3_x 終点X / P3 X Int 終点のX座標
p3_y 終点Y / P3 Y Int 終点のY座標

UI での挙動

  • ノードボディ: パラメータ展開時、各座標の名前と実際の値を紫色テキストで読み取り専用表示(スライダーなし)
  • インスペクター: バッジ内で計算値を表示。📌/🎚️🔢🎛️ ボタンは非表示
  • 出力ピン化 (📤): 必要な座標だけ出力ピンとして追加し、下流ノードに接続可能

使用例

座標値の確認

  1. BezierPath の seg_N を📤で出力ピン化
  2. SegmentUnpack の Segment 入力に接続
  3. ノードボディまたはインスペクターで各座標値を確認
  4. 必要な座標パラメータの📤をクリックして出力ピン化

座標値の加工パイプライン

  1. BezierPath の seg_N → SegmentUnpack で分解
  2. 必要な座標 (例: p0_x) を📤で出力ピン化
  3. SineWave 等のアニメーションノードで座標値を加工
  4. SegmentPack で再構成
  5. BezierPath の seg_N に📌入力ピン化して戻す

設計メモ

このノードは出力専用パラメータパターンNODE_DEVELOPMENT_GUIDE.md セクション10参照)を採用しています。 固定出力ポートを持たず、全ての出力をパラメータ経由で管理することで、 ユーザーが必要な座標だけを取捨選択できるクリーンなインターフェースを実現しています。

ノード一覧に戻る