Back to Node List

Rule Polyline

rule_polyline

Creates a polyline placement operation from a point list, with a progress parameter for growing pipes.

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
ルールキャンバス
canvas
RuleCanvas
操作を追記する既存キャンバスです。未接続なら新規キャンバスを作ります。

Output Ports

NameTypeDescription
ルールキャンバス
canvas
RuleCanvas
ライン操作を追加したキャンバスです。
警告
warnings
Text
レイヤー補正などの警告です。
概要
summary
Text
結果の短いまとめです。

Parameters

NameTypeDefaultRangeDescription / Options
地形名
material_id
Text
pipe

ラインで塗る地形名(素材ID)です。

操作種別
operation_kind
Text
polyline

ルールセットの操作条件へ渡す操作種別です。

操作名
operation_name
Text

ルールセットの操作条件へ渡す任意の操作名です。

点列
points
Text
0,0 6,0 6,4

「x,y x,y …」形式の点列です。角で曲がる配管などを表します。

進捗
progress
Float
10–1 / step 0.01

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

マップ幅
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 in a line from a sequence of points. Draw pipes, roads, and rivers numerically, then grow them from the start with progress (0–1), making a growing-pipe animation with simple wiring.

Usage tips

  • The signature use is a growth animation: time_source → progress (promote to an input pin 📌) → rule_animation_render. Rule resolution updates the autotile seams correctly as the line grows.
  • Use this for polylines; use rule_path for Bezier curves.
  • Chain it with rule_rect to build structures such as rooms and pipes.

Related nodes

  • rule_path — the Bezier-path counterpart
  • rule_rect — the rectangle counterpart
  • rule_animation_render — outputs the growth animation
  • rule_operation_merge — combines with hand painting

What this node does

Creates a line operation from points in x,y x,y … format. progress (0–1, promotable) trims the line by cell count from its start. Connect time_source → waveform → progress to animate a pipe growing, optionally with Rule Animation Render.

The cut always lands on a cell along the path, while context such as distance from the start and straight-section information is preserved. Future sequence rules, such as "a seam every N cells," can therefore apply without modification.

Inputs, outputs, and settings

Kind ID Type Description
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: pipe).
Setting points Text Point sequence such as 0,0 6,0 6,4.
Setting progress Float 0–1 (promotable) Fraction to draw from the start.
Setting map_width and others Int Map and cell settings for a new canvas.

Example wiring (growing pipe)

time_source -> sawtooth wave -> RulePolyline.progress (promoted)
RulePolyline.canvas + Pipe asset.asset -> RuleAnimationRender
Back to Node List
Rule Polyline — PixPipeline Node Reference