よつばゲームズ

ノード一覧に戻る

ソリッド配列

solid_array

立体を直線・グリッド・円形に複製配置します。量産パーツや柵、柱列に使います。

下書き

解説あり

入力ポート

名前	型	説明
ソリッド solid	Solid 必須	複製配置する立体です。

出力ポート

名前	型	説明
ソリッド solid	Solid	複製配置された立体です。

パラメータ

名前	型	既定値	範囲	説明・選択肢
配置モード mode	Enum	Line	—	複製の配置方法です。直線`Line` 1軸に沿って並べます。グリッド`Grid` 3Dグリッドに並べます。円形`Circle` 円または弧に沿って並べます。
数 count	Int	5	1–512	直線・円形モードで複製する数です。
軸 axis	Enum	X	—	直線配列の軸です。 X`X` x方向へ並べます。 Y`Y` y方向(奥行き)へ並べます。 Z`Z` z方向(高さ)へ並べます。
間隔 spacing	Float	1.5	-32–32 / step 0.05	直線配列で隣同士を離す距離です。
X数 count_x	Int	3	1–64	x方向の個数です。
Y数 count_y	Int	3	1–64	y方向(奥行き)の個数です。
Z数 count_z	Int	1	1–64	z方向(高さ)の個数です。
X間隔 spacing_x	Float	1.5	-32–32 / step 0.05	x方向の間隔です。
Y間隔 spacing_y	Float	1.5	-32–32 / step 0.05	y方向(奥行き)の間隔です。
Z間隔 spacing_z	Float	1.5	-32–32 / step 0.05	z方向(高さ)の間隔です。
平面 plane	Enum	XY	—	円形配列の平面です。 XY`XY` z軸まわりにxy平面へ並べます。 XZ`XZ` y軸まわりにxz平面へ並べます。 YZ`YZ` x軸まわりにyz平面へ並べます。
半径 radius	Float	3	0–64 / step 0.05	円形配列の半径です。
開始角 start_angle	Angle	0	— / step 1	最初の複製を置く角度です。
弧の角度 arc_angle	Float	360	0–360 / step 1	配置に使う弧の角度です。360で一周します。
向きを回す rotate_instances	Bool	false	—	円形配列の法線軸まわりに各複製の向きも回します。
中央揃え center	Bool	true	—	可能な範囲で配列全体の中心が元の立体位置に来るようにします。
インスタンスIDを分ける unique_instance_ids	Bool	true	—	空でないソリッドIDに複製番号を付け、レンダリング後の面ID衝突を避けます。

概要

座標系: z-up(x右、y奥、z上)。サイズはユニット単位(レンダリング時の pixels_per_unit でドットに変換)

メモ

最大複製数は 512 です。solid_render の負荷を制御するため、Grid の count_x * count_y * count_z もこの上限に入ります。
solid_id が空の素体は従来通り自動IDになります。
unique_instance_ids が ON の時、元の solid_id が block ならレンダリング後の面IDは block:i001:top のように分かれます。

使用例

Solid Box で柱やブロックを作る
Solid Array(mode: Grid) で床タイルや柱列に増やす
Solid Combine や Solid Subtract で別パーツと合成する
Solid Render で Surface 化し、アウトラインやライティングへつなぐ

ノード一覧に戻る

ソリッド配列 — PixPipeline ノード解説