Back to Node List

Rule Render

rule_render

Resolves a RuleCanvas with a RuleTileSet and RuleSet, then renders it to an image.

Draft
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
タイルセットとルールセットの束ねです(個別入力より優先)。
ルールキャンバス
canvas
RuleCanvas
解決するルールキャンバスです。未接続時は配置リストから作ります。
配置リスト
cells
List<Any>
ルールキャンバス入力がない時に使う配置指示リストです。
ルールタイルセット
tile_set
RuleTileSet
描画に使うルールタイル画像セットです。
ルールセット
rule_set
RuleSet
どのタイルを置くか決めるルールセットです。

Output Ports

NameTypeDescription
ルールキャンバス
canvas
RuleCanvas
今回使ったルールキャンバスです。
解決済みルール配置
resolved
RuleResolved
各セルに置くタイルが決まった結果です。
画像
image
Image
描画結果の画像です。
配置タイル数
tile_count
Int
実際に置かれたタイル数です。
概要
summary
Text
結果の短い説明です。

Parameters

NameTypeDefaultRangeDescription / Options
キャンバス名
canvas_name
Text
Rule Canvas

配置リストからルールキャンバスを作る時の名前です。

レイヤー名
layer_name
Text
Layer 1

配置リストから作るレイヤー名です。

width
Int
81–4096

配置リストから作るキャンバスの横マス数です。

高さ
height
Int
81–4096

配置リストから作るキャンバスの縦マス数です。

表示時刻(ms)
time_ms
Float
00–600000 / step 1

アニメーションタイルのフレームを選ぶ時刻(ms)です。静止タイルには影響しません。

フレーム番号
frame_index
Int
-1-1–4096

-1 の時は表示時刻(ms)を使います。0以上を指定すると フレーム番号 ÷ fps の時刻で描画します。

FPS
fps
Int
81–60

フレーム番号指定の時に使う1秒あたりのフレーム数です。

配置リストの読み方
cell_mode
Enum
TileIndex

配置リストの値をどう読むかです。

  • タイル番号TileIndex
    配置リストをタイルセット内の番号として読みます。
  • タイルIDTileId
    配置リストをタイルIDとして読みます。
  • 素材IDMaterialId
    配置リストを素材IDとして読みます。

何をするノードか

RuleCanvas(または配置リスト)の各マスについて、ルールセットの近傍条件を評価して置くタイルを決め、 解決結果(RuleResolved)と描画画像を出力します。

アニメーションタイルの時刻指定

ID 名前 説明
time_ms 表示時刻(ms) アニメタイルのフレームを選ぶ時刻です。変数・アニメーションに昇格できます。
frame_index フレーム番号 -1 で無効。0以上なら フレーム番号 ÷ fps の時刻で描画します。
fps FPS フレーム番号指定の時に使います。

全フレームをまとめて出したい場合は ルールアニメーション描画 を使います。

つなぎ方の例

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