ノード一覧に戻る

図形

shape_generate

四角形や円などの基本図形を作り、画像・パス・サーフェースを出力します

確認済み
解説あり

入力ポート

名前説明
塗り色
fill_color
Color
中の色を外から差し替えます
線色
stroke_color
Color
ふちの色を外から差し替えます

出力ポート

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

パラメータ

名前既定値範囲説明・選択肢
図形の種類
shape
Enum
Rectangle

どの図形を作るか選びます

  • 矩形Rectangle
  • Circle
  • 楕円Ellipse
  • 三角形Triangle
  • ひし形Diamond
width
Int
641–1024

出来上がる画像の幅です

高さ
height
Int
641–1024

出来上がる画像の高さです

中を塗る
filled
Bool
true

オンなら図形の中を塗ります

塗り色
fill_color
Color
[1,1,1,1]

図形の中の色です

ふちの太さ
stroke_width
Int
00–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.550–1 / step 0.01

図形がある場所の高さです。大きいほど出っ張った面として扱います

くぼみの暗さ
surface_ao
Float
0.960–1 / step 0.01

図形部分の暗さです。小さいほどくぼんだように暗くなります

ざらつき
surface_roughness
Float
0.750–1 / step 0.01

光を当てた時の質感です。大きいほどつやが弱い面になります

概要

矩形・円・楕円・三角・ひし形をパラメータで生成する、図形の最短ルートです。 単純な形ならパスを手で描くよりこちらが速く、同じ形を 画像・パス・サーフェースの 3形式で同時に出力するのが特長です(マスク・UI部品・ライティング下地を1ノードで賄える)。

使い方のポイント

  • 白い図形(既定)はそのままマスクとして使える。path_maskblend_by_mask の マスク入力へ直結
  • ふちだけ欲しい場合: filled = false + stroke_width ≥ 1。枠線UIやセレクタ表示に
  • 図形を動かす・並べる場合は output(画像)ではなく path 出力を path_transform / path_array に渡す方が劣化しない
  • ドット絵の光沢や立体感を試すなら surface 出力 → surface_light_previewsurface_height を上げると縁に高さ差が出る

よくある失敗

  • 図形がキャンバスからはみ出す/合わない: このノードの 高さ は追加時に キャンバスサイズが入るが、その後は独立(自動追従しない)。キャンバスを変えたら こちらも合わせる
  • 背景が黒くなる: output は透明背景。黒く見えるのはプレビューの背景設定。 背景を敷きたい場合は solid_color の上に blend で重ねる
  • 枠線が出ない: stroke_width = 0(既定)のまま。1以上にする
  • stroke_width が2・4などの偶数でも、輪郭は指定したピクセル幅で描画されます。 偶数幅の中心は右・下へ半ピクセル寄ります。

注意

  • output は透明背景の画像です。
  • pathPathMaskPath TransformShape Sweep などで再利用できます。
  • surface は透明部分を背景扱いにし、図形があるピクセルだけに素材ID・面ID・高さを書き込みます。
  • サーフェース関連のパラメータはインスペクターの「サーフェース関連」に折りたたまれます。
  • エディタから追加した直後は、高さ に現在のキャンバスサイズが入ります。
  • ただし追加後はキャンバスに固定されず、高さ を独立して変更できます。
  • filled = false の時は、中は塗られません。
  • stroke_width = 0 の時は、ふちは描かれません。

使用例

  1. Rectangle を作ってそのまま Blend につなぐ
    • 単純な帯やパネル画像をすぐ作れます
  2. Circle を作って pathPath Transform に送る
    • 円の位置やサイズだけ変えてマスクに再利用できます
  3. Diamond を作って PathMask
    • ひし形の cutout や UI 装飾に使えます
  4. stroke_width を入れて塗りなしにする
    • 枠線だけの図形も作れます
  5. surfaceSurface Light Preview につなぐ
    • surface_height を上げると図形の縁に高さ差が出て、光を当てた時の見え方を調整できます

関連ノード

  • bezier_path — 自由な形を描きたい場合(こちらはエディタで手描き)
  • line_generate — 直線・折れ線が欲しい場合
  • path_transform / path_array — path出力の移動・回転・繰り返し配置
  • pixel_line — ピクセル単位でカクッとした線が欲しい場合
ノード一覧に戻る
図形 — PixPipeline ノード解説