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

図形

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

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

まず何に使う？

  • 簡単な図形画像をすぐ作りたい時
  • 図形を Path として再利用したい時
  • 図形に素材IDや高さを付けて、あとでサーフェースライティングしたい時
  • マスクや cutout 用の土台を用意したい時

概要

  • バージョン: 2

注意

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

使用例

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