よつばゲームズ
ノード一覧に戻る

アイソメシーン描画

iso_scene_render

上級者向け: 正本の IsoWorld または内部描画 IR の IsoScene を描画します

確認済み
解説あり

入力ポート

名前型説明
ワールド
world
IsoWorld
コンパイルして描画するワールドです。WorldかSceneのどちらか一方だけを接続します。
シーン
scene
IsoScene
直接描画するコンパイル済みシーンです。WorldかSceneのどちらか一方だけを接続します。

出力ポート

名前型説明
画像
output
Image
画像
深度マスク
depth_mask
Image
深度マスク
輪郭マスク
edge_mask
Image
輪郭マスク
天面輪郭マスク
top_edge_mask
Image
天面輪郭マスク
シルエットマスク
silhouette_mask
Image
シルエットマスク
継ぎ目マスク
seam_mask
Image
継ぎ目マスク
天面マスク
top_mask
Image
天面マスク
左面マスク
left_mask
Image
左面マスク
右面マスク
right_mask
Image
右面マスク

パラメータ

名前型既定値範囲説明・選択肢
フレームモード
frame_mode
Enum
AutoFit—

world から compile する際のフレーム決定方法

  • 自動フィットAutoFit
    見えている内容に合わせてキャンバスと原点を自動調整します
  • 固定キャンバスKeepCanvas
    ここで指定したキャンバスと原点をそのまま使います
キャンバス幅
width
Int
641–4096

コンパイル後のキャンバス幅

キャンバス高さ
height
Int
641–4096

コンパイル後のキャンバス高さ

原点X
origin_x
Float
32-4096–4096 / step 0.5

コンパイル時に使うスクリーン空間の原点X

原点Y
origin_y
Float
0-4096–4096 / step 0.5

コンパイル時に使うスクリーン空間の原点Y

Xステップ
tile_step_x
Float
10.25–16 / step 0.25

アイソメX方向の横ステップ倍率

Yステップ
tile_step_y
Float
0.50.25–16 / step 0.25

床軸の縦ステップ倍率

Zステップ
z_step
Float
10.25–16 / step 0.25

高さ軸のステップ倍率

余白
padding
Int
20–128

自動フィット時に使うピクセル余白

スタイル上書き
override_style
Bool
false—

item / world / scene から来たスタイルをこのノードで上書きします

輪郭を描く
draw_outlines
Bool
true—

見えている面の輪郭を描画します

補正プロファイル
cleanup_profile
Enum
None—

レンダラが輪郭をどの方針で補正するか

  • なしNone
    輪郭補正を行いません
  • 汎用General
    輪郭に対して汎用のピクセル補正を行います
  • 2:1 ソフトIso2To1Soft
    2:1 アイソメ向けの柔らかい補正を行います
  • 2:1 厳格Iso2To1Strict
    2:1 アイソメ向けの厳格な補正を行います
階段プロファイル
stair_profile
Enum
Neutral—

輪郭補正時に優先する階段表現

  • 標準Neutral
    中庸な補正です
  • シャープCrisp
    斜めのキレを優先します
  • ソフトSoft
    角を少し柔らかく残します
  • クラシックRPGClassicRpg
    古典的な JRPG 風の 2:1 階段を優先します
輪郭色
outline_color
Color
[0,0,0,1]—

輪郭線の色

概要

IsoWorld / IsoScene をドット絵画像に描き出すアイソメ系のレンダラーです。 シルエット・天面エッジ・継ぎ目の補助マスクも出すので、後段の仕上げ (輪郭・減色・掃除)につなぐ前提の描画ノードです。

使い方のポイント

  • 標準の流れ: iso_place → iso_world_to_scene → iso_scene_render → outline / palette_quantize / pixel_cleanup。生の描画に仕上げを重ねて ドット絵らしくする
  • 補助マスク(top_edge / silhouette / seam)は仕上げの当て先制御に使える (天面エッジだけ明るく、など)
  • world と scene はどちらか一方だけを接続する。両方を接続した場合は world を使用し、非致命的な警告を表示する
  • AutoFit は内容全体からキャンバスを求め、KeepCanvas は指定範囲外を 意図的に切り取る。ラスタ出力は最大4096×4096、推定総確保量768 MiBまで
  • 現状は solid color 材質のみのPoC段階

関連ノード

  • iso_world_to_scene — 入力の変換元

  • outline / palette_quantize / pixel_cleanup — 定番の後段

  • iso_scene_to_surface_geometry — ライティングしたい場合の別ルート

  • バージョン: 1

メモ

  • 現在の MVP は solid color 材質のみ対応です
  • 現状の軽補正は 可視輪郭のラスタライズ結果のみ に適用されます
  • 後段で Outline, PaletteQuantize, PixelCleanup へ接続する前提の補助マスクを出します
  • 現行 v1 は ポリゴンベース PoC で、今後は occupancy grid -> face masks -> edge masks ベースへ置き換える前提です
  • 現在は top_edge_mask / silhouette_mask / seam_mask を個別に出しており、将来の RasterStyle はこれらの semantic edge を元に組み立てます
  • ClassicCube は最終的に cleanup_profile ではなく RasterStyle として実装する前提です

関連ノード

アイソワールド変換iso_world_to_sceneアウトラインoutlineアイソシーンをサーフェースへiso_scene_to_surface_geometry
ノード一覧に戻る
アイソメシーン描画 — PixPipeline ノード解説