Yotsuba Games
Back to Node List

Shape

shape_generate

Generates basic shapes as an image, reusable path, and optional surface

Draft
Guide available
The node name and summary are available in English. Port, parameter, and article details are currently shown in Japanese.

Input Ports

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

Output Ports

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

Parameters

NameTypeDefaultRangeDescription / Options
図形の種類
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 を上げると図形の縁に高さ差が出て、光を当てた時の見え方を調整できます
Back to Node List
Shape — PixPipeline Node Reference