Shape

Name	Type	Description
塗り色 fill_color	Color	中の色を外から差し替えます
線色 stroke_color	Color	ふちの色を外から差し替えます

Name	Type	Description
画像 output	Image	作成した図形の画像です
パス path	Path	同じ形を表すパスです
サーフェース surface	Surface	作成した図形に高さ・素材ID・面IDを付けたサーフェースです

Parameters

Name	Type	Default	Range	Description / Options
図形の種類 shape	Enum	Rectangle	—	どの図形を作るか選びます矩形`Rectangle` 円`Circle` 楕円`Ellipse` 三角形`Triangle` ひし形`Diamond`
幅 width	Int	64	1–1024	出来上がる画像の幅です
高さ height	Int	64	1–1024	出来上がる画像の高さです
中を塗る filled	Bool	true	—	オンなら図形の中を塗ります
塗り色 fill_color	Color	[1,1,1,1]	—	図形の中の色です
ふちの太さ stroke_width	Int	0	0–64	ふちの太さです。0 にすると枠なしになります
ふちの色 stroke_color	Color	[0,0,0,1]	—	ふちの色です
素材ID material_id	Text	core:default	—	サーフェース出力で、図形があるピクセルに付ける素材です
面ID face_id	Text	surface:shape	—	サーフェース出力で、図形がどの面に属するかを示すIDです
面の高さ surface_height	Float	0.55	0–1 / step 0.01	図形がある場所の高さです。大きいほど出っ張った面として扱います
くぼみの暗さ surface_ao	Float	0.96	0–1 / step 0.01	図形部分の暗さです。小さいほどくぼんだように暗くなります
ざらつき surface_roughness	Float	0.75	0–1 / step 0.01	光を当てた時の質感です。大きいほどつやが弱い面になります

Overview

The shortest route to parameter-generated rectangles, circles, ellipses, triangles, and diamonds. Standard shapes are faster here than drawing paths by hand, and this node uniquely outputs the same shape simultaneously as an image, path, and Surface. One node can supply a mask, UI part, and lighting base.

Usage tips

The default white shape works directly as a mask. Connect it to mask inputs such as path_mask or blend_by_mask.
For only an edge, use filled = false + stroke_width ≥ 1, useful for UI frames and selectors.
To move or arrange shapes, pass the path output to path_transform / path_array instead of using the image output; the vector path does not degrade.
To try pixel-art gloss or depth, connect surface → surface_light_preview. Increasing surface_height creates an elevation difference at the edge.

Common pitfalls

The shape overflows or no longer matches the canvas: the node receives canvas dimensions in 幅 and 高さ when added, but they become independent afterward. Update them when the canvas changes.
The background looks black: output has a transparent background; black comes from preview settings. To add a background, composite it over solid_color with blend.
No border appears: stroke_width = 0 is still the default. Raise it to at least 1.
Even stroke_width values such as 2 and 4 render at the requested pixel width, using a half-pixel right/down center bias.

Notes

output is an image with a transparent background.
path can be reused by PathMask, Path Transform, Shape Sweep, and similar nodes.
surface treats transparent pixels as background and writes material ID, face ID, and height only where the shape exists.
Surface parameters are collapsed under "Surface" in the inspector.
Immediately after adding the node from the editor, 幅 and 高さ receive the current canvas dimensions.
Afterward, 幅 and 高さ are not locked to the canvas and can be changed independently.
With filled = false, the interior is not filled.
With stroke_width = 0, no edge is drawn.

Examples

Create Rectangle and connect it directly to Blend.
- Quickly create a simple band or panel image.
Create Circle and send its path to Path Transform.
- Reuse it as a mask with different positions or sizes.
Create Diamond and connect it to PathMask.
- Make a diamond cutout or UI decoration.
Set stroke_width and disable fill.
- Create an outline-only shape.
Connect surface to Surface Light Preview.
- Increase surface_height to create edge relief and adjust its lit appearance.

Related nodes

bezier_path — hand-draw a free shape in the editor
line_generate — create straight lines or polylines
path_transform / path_array — move, rotate, or repeat the path output
pixel_line — create a sharply stepped pixel line

Input Ports

Output Ports