Back to Node List

Rule Canvas

rule_canvas

Paints materials on a grid canvas and outputs a RuleCanvas.

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
ルールタイル素材
asset
RuleTileAsset
タイルセットとルールセットの束ねです。これ1本で塗れます(個別入力より優先)。
ルールキャンバス
canvas
RuleCanvas
既存のルールキャンバスです。接続すると、その内容を使います。
ルールタイルセット
tile_set
RuleTileSet
完成イメージを確認するためのタイルセットです。
ルールセット
rule_set
RuleSet
地形名で塗ったマスから、どのタイル画像を置くか決めるルールです。

Output Ports

NameTypeDescription
ルールキャンバス
canvas
RuleCanvas
マス目に塗った内容そのものです。
解決済みルール配置
resolved
RuleResolved
タイルセット接続時に、実際に置くタイル画像が決まった状態です。
画像
image
Image
完成配置を画像として確認するためのプレビューです。
概要
summary
Text
キャンバス内容の短いまとめです。
警告
warnings
Text
完成イメージを作るために足りない入力など、気をつける点です。

Parameters

NameTypeDefaultRangeDescription / Options
width
Int
81–4096

新しく作るキャンバスの横マス数です。

高さ
height
Int
81–4096

新しく作るキャンバスの縦マス数です。

セル幅
cell_width
Int
161–2048

新しく作るキャンバスのタイル1枚の幅です。

セル高さ
cell_height
Int
161–2048

新しく作るキャンバスのタイル1枚の高さです。

キャンバスデータ
canvas_data
CustomData

エディタが保存しているルールキャンバスのJSONです。通常は直接触らず、エディタから編集します。

Overview

The canvas for painting an autotile map. Paint materials such as "wall" or "grass" into grid cells, and the connected rules automatically choose the correct tile for each position: corners, edges, and interiors. This is the workbench for the rule-tile workflow.

Usage tips

  • The minimal setup is rule_set_preset (tile set + rules) → rule_canvas. That alone enables painting and automatic tile selection.
  • The most important concept is that you paint a material, not a tile. The rules determine which tile is placed.
  • Export the resolved result (resolved) to Tiled with tiled_map_export.

Related nodes

  • rule_set_preset — supplies the go-to setup; start here
  • rule_set_editor — creates and customizes rules
  • rule_render / rule_animation_render — renders outside the canvas
  • tiled_map_export — exports the map

What this node does

Paint grid cells in the dedicated editor (Edit Rule Canvas) and output the result as a RuleCanvas. When a rule tile set and rule set are connected, the node also outputs the resolved result (RuleResolved) and a preview image immediately. It replaces the legacy Tile Map Canvas.

Key settings

ID Name Description
width / height Width/height Number of cells in a new canvas.
cell_width / cell_height Cell width/height Pixel dimensions of one tile.
canvas_data Canvas data JSON stored by the editor. Do not edit it directly; use the editor.

Example wiring

RuleSetPreset.tile_set -> RuleCanvas.tile_set
RuleSetPreset.rule_set -> RuleCanvas.rule_set
RuleCanvas.resolved    -> TiledMapExport.resolved
Back to Node List
Rule Canvas — PixPipeline Node Reference