ノード一覧に戻る

ピクセルライン

pixel_line

均一なステップパターンのピクセルパーフェクトな線を描画します(例: 2:1 アイソメトリック)

確認済み
解説あり

入力ポート

名前説明
color
Color
線の色(接続時はパラメータより優先)

出力ポート

名前説明
画像
output
Image
生成されたピクセルパーフェクトライン画像

パラメータ

名前既定値範囲説明・選択肢
width
Int
641–1024

キャンバスの幅(ピクセル)

高さ
height
Int
641–1024

キャンバスの高さ(ピクセル)

始点X
origin_x
Int
00–1024

始点の X 座標

始点Y
origin_y
Int
320–1024

始点の Y 座標

ステップX
step_x
Int
21–8

1ステップの水平ドット数(例: アイソメトリック 2:1 なら 2)

ステップY
step_y
Int
11–8

1ステップの垂直ドット数(例: アイソメトリック 2:1 なら 1)

長さ
length
Int
161–256

ステップの繰り返し回数

方向
direction
Enum
Right-Up

線の方向

  • 右上 ↗Right-Up
  • 右下 ↘Right-Down
  • 左上 ↖Left-Up
  • 左下 ↙Left-Down
  • 右 →Right
  • 左 ←Left
  • 上 ↑Up
  • 下 ↓Down
color
Color
[1,1,1,1]

線の色(入力ポート未接続時に使用)

概要

「横2ドット進んで1ドット上がる」のような一定ステップの完璧な直線を引くノードです。 アイソメトリックの床辺・屋根の傾斜・45°斜線など、ドット絵で角度が命の線は、 ベジェよりこちらの方が確実にきれいに引けます。

使い方のポイント

  • 2:1アイソメの辺は step_x=2, step_y=1 が黄金比。この設定のまま方向を変えて ひし形の4辺を構成できる
  • length は「ステップの繰り返し回数」。2:1で length 16 なら横32px分進む
  • 手描き線(bezier_path→path_stroke)との使い分け: 角度が規則的な構造線はこちら、 自由曲線はパス系
  • 線が伸びるアニメ: lengthtime_source → remap で駆動(使用例参照)

よくある失敗

  • 線が途中で切れる: キャンバス外に出た分は描かれない。originlength から 終点を逆算してキャンバスに収める
  • アイソメのひし形が閉じない: 4辺の origin 座標の整合が必要。1辺の終点=次辺の始点に なるよう、step×length で計算して合わせる(または iso_block 系ノードの利用を検討)

キャンバスサイズ連動

ジェネレータノードとして、新規作成時に width / height がプロジェクトのキャンバスサイズ(_canvasWidth / _canvasHeight)に自動バインドされます。

状態 width/height の値
デフォルト(新規作成時) プロジェクトキャンバスサイズにバインド(自動追従)
ユーザーが手入力 or バインド解除 ローカル値(キャンバスサイズと独立)

インスペクターの 🔗 ボタンからバインドの解除・再登録ができます。

ステップパターン例

step_x step_y 用途
2 1 アイソメトリック線(2:1)
1 1 45度斜線
1 2 急な傾斜(1:2)
3 1 緩やかな角度
1 1 水平線(方向: Right/Left。step_y は使いません)
1 1 垂直線(方向: Up/Down。step_x は使いません)

方向

記号 説明
Right-Up 右上方向
Right-Down 右下方向
Left-Up 左上方向
Left-Down 左下方向
Right 右方向(水平)
Left 左方向(水平)
Up 上方向(垂直)
Down 下方向(垂直)

使用例

  • PixelLine(2:1, Right-Up) → Blend — アイソメトリック床の辺
  • TimeSource → Remap → PixelLine(length) → AnimationRender — 線が伸びていくアニメーション
  • PixelLine(1:1) — 45度のきれいな斜線

関連ノード

  • line_generate — 座標2点指定の直線
  • path_stroke — 自由曲線のピクセルパーフェクト線
  • iso_block — アイソメの立体をまとめて作るなら
  • rule_polyline — ルールタイル系の折れ線
ノード一覧に戻る
ピクセルライン — PixPipeline ノード解説