Back to Node List

Rule Path

rule_path

Creates a polyline placement operation by sampling a bezier Path into cells (with progress).

Reviewed
Guide available
The node name and summary are available in English. Port, parameter, and article details are currently shown in Japanese.

Input Ports

NameTypeDescription
パス
path
Path
Required
配置の元になるベジェパスです(ピクセル座標。セルサイズで割ってマスへ変換します)。
ルールキャンバス
canvas
RuleCanvas
操作を追記する既存キャンバスです。未接続なら新規キャンバスを作ります。

Output Ports

NameTypeDescription
ルールキャンバス
canvas
RuleCanvas
パス由来のライン操作を追加したキャンバスです。
概要
summary
Text
結果の短いまとめです。

Parameters

NameTypeDefaultRangeDescription / Options
地形名
material_id
Text
road

パスに沿って塗る地形名(素材ID)です。

進捗
progress
Float
10–1 / step 0.01

パスを先頭から何割描くかです。時間をつなぐと伸びるアニメになります。

サンプル数
samples
Int
642–512

パスを何点でサンプリングするかです。曲線が粗い時に増やします。

マップ幅
map_width
Int
81–4096

キャンバス入力が無い時に作る新規キャンバスの設定です。

マップ高さ
map_height
Int
81–4096

キャンバス入力が無い時に作る新規キャンバスの設定です。

セル幅
cell_width
Int
161–2048

キャンバス入力が無い時に作る新規キャンバスの設定です。

セル高さ
cell_height
Int
161–2048

キャンバス入力が無い時に作る新規キャンバスの設定です。

グリッド種別
grid_kind
Enum
Orthogonal

キャンバス未接続時に作る新規キャンバスのグリッド種別です。

  • 直交Orthogonal
  • アイソダイヤIsometricDiamond
描画順
render_order
Enum
RightDown

キャンバス未接続時に作る新規キャンバスの描画順です。

  • 右下RightDown
  • 右上RightUp
  • 左下LeftDown
  • 左上LeftUp

Overview

A placement node that paints tiles along a Bezier curve drawn in the path editor. Lay winding roads, rivers, and rails onto a map with familiar path editing. Like rule_polyline, progress can grow the result from the start.

Usage tips

  • The shortest route to a curved road is to draw it in multi_path_editor → rule_path → rule_render with the road material. Editing the path updates the road.
  • Increase samples when bends appear jagged.
  • For straight segments and polylines, rule_polyline is lighter.

Related nodes

  • rule_polyline — the point-sequence counterpart
  • multi_path_editor / bezier_path — supply the path
  • rule_animation_render — animates growth
  • rule_operation_merge — combines with hand painting

What this node does

Converts a Path drawn in a path editor such as MultiPathEditor into a cell-based line operation. Path coordinates in pixels are divided by the cell dimensions to map them onto the grid. progress (0–1, promotable) trims the line from its start. This places roads, rivers, and pipes directly from a path asset.

Inputs, outputs, and settings

Kind ID Type Description
Input path Path (required) Source Bezier path; uses the first subpath.
Input canvas RuleCanvas (optional) Canvas to append to. Creates a new canvas when unconnected.
Output canvas RuleCanvas Canvas with the line operation added.
Setting material_id Text Terrain name to paint (default: road).
Setting progress Float 0–1 (promotable) Fraction to draw from the start.
Setting samples Int Number of path samples; increase for coarse curves.

Example wiring

Multi Path Editor.path -> RulePath.path
RulePath.canvas + Road preset.asset -> RuleRender
Back to Node List
Rule Path — PixPipeline Node Reference