Back to Node List

Solid Array

solid_array

Repeats a solid in a line, grid, or circular arrangement.

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
ソリッド
solid
Solid
Required
複製配置する立体です。

Output Ports

NameTypeDescription
ソリッド
solid
Solid
複製配置された立体です。

Parameters

NameTypeDefaultRangeDescription / Options
配置モード
mode
Enum
Line

複製の配置方法です。

  • 直線Line
    1軸に沿って並べます。
  • グリッドGrid
    3Dグリッドに並べます。
  • 円形Circle
    円または弧に沿って並べます。
count
Int
51–512

直線・円形モードで複製する数です。

axis
Enum
X

直線配列の軸です。

  • XX
    x方向へ並べます。
  • YY
    y方向(奥行き)へ並べます。
  • ZZ
    z方向(高さ)へ並べます。
間隔
spacing
Float
1.5-32–32 / step 0.05

直線配列で隣同士を離す距離です。

X数
count_x
Int
31–64

x方向の個数です。

Y数
count_y
Int
31–64

y方向(奥行き)の個数です。

Z数
count_z
Int
11–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

円形配列の平面です。

  • XYXY
    z軸まわりにxy平面へ並べます。
  • XZXZ
    y軸まわりにxz平面へ並べます。
  • YZYZ
    x軸まわりにyz平面へ並べます。
半径
radius
Float
30–64 / step 0.05

円形配列の半径です。

開始角
start_angle
Angle
0— / step 1

最初の複製を置く角度です。

弧の角度
arc_angle
Float
3600–360 / step 1

配置に使う弧の角度です。360で一周します。

向きを回す
rotate_instances
Bool
false

円形配列の法線軸まわりに各複製の向きも回します。

中央揃え
center
Bool
true

可能な範囲で配列全体の中心が元の立体位置に来るようにします。

インスタンスIDを分ける
unique_instance_ids
Bool
true

空でないソリッドIDに複製番号を付け、レンダリング後の面ID衝突を避けます。

Overview

Duplicates and places one solid in a line, grid, or circle. It batch-produces repeated shapes such as fences, rows of pillars, floor tiles, or gear teeth from numeric settings, without arranging copies manually.

  • Coordinate system: z-up (x right, y back, z up). Sizes are in units and are converted to pixels by pixels_per_unit during rendering.

Usage tips

  • Think in terms of modes: Line for fences and bridge girders, Grid for floor tiles and rows of windows, and Circle for crown ornaments, gears, and stone circles.
  • Set spacing equal to the width of the base solid for exact contact, as in a wall; increase it to make a fence.
  • A node-based setup lets you update the entire arrangement by replacing the base solid. Adjusting a pillar design immediately updates the whole colonnade.
  • Set arc_angle below 360 for a fan-shaped circular arrangement, such as a stair railing.

Related nodes

  • solid_box / solid_cylinder — base solids to duplicate
  • solid_combine — combine the array with other parts
  • solid_transform — move or rotate the whole array
  • solid_render — convert it to pixel art

Notes

  • The maximum number of duplicates is 512. To control the load on solid_render, Grid's count_x * count_y * count_z is also subject to this limit.
  • A base solid with an empty solid_id receives an automatic ID as before.
  • When unique_instance_ids is ON and the original solid_id is block, rendered face IDs are separated into values such as block:i001:top.

Examples

  1. Make a pillar or block with Solid Box.
  2. Duplicate it into floor tiles or rows of pillars with Solid Array(mode: Grid).
  3. Combine it with other parts using Solid Combine or Solid Subtract.
  4. Turn it into a Surface with Solid Render, then connect outline and lighting nodes.
Back to Node List
Solid Array — PixPipeline Node Reference