キャンバスフィット

名前	型	説明
画像 input	Image 必須	入力画像

名前

型

説明

画像

input

Image

必須

入力画像

名前	型	説明
画像 output	Image	フィット後の画像

名前

型

説明

画像

output

Image

フィット後の画像

パラメータ

名前	型	既定値	範囲	説明・選択肢
幅 width	Int	32	1–4096	ターゲットキャンバス幅
高さ height	Int	32	1–4096	ターゲットキャンバス高さ
フィットモード fit_mode	Enum	Contain	—	画像をキャンバスにどう合わせるか内包`Contain` アスペクト比を維持してキャンバス内に収める。余白ありカバー`Cover` アスペクト比を維持してキャンバスを覆う。はみ出しクリップ引き延ばし`Stretch` アスペクト比を無視して引き延ばし配置のみ`None` リサイズなし、キャンバスに配置のみ
整列 anchor	Enum	Center	—	余白がある場合の画像配置位置左上`Top-Left` 上中央`Top-Center` 右上`Top-Right` 左中央`Center-Left` 中央`Center` 右中央`Center-Right` 左下`Bottom-Left` 下中央`Bottom-Center` 右下`Bottom-Right`
スケール方式 sampling	Enum	NearestNeighbor	—	スケーリング方式ニアレストネイバー`NearestNeighbor` フィットサイズに正確にスケール整数倍のみ`IntegerOnly` 最大の整数倍でスケール（ピクセルパーフェクト）

フィットモード一覧

モード	日本語	効果
Contain	内包	キャンバス内に収まる最大サイズ。アスペクト比維持、余白あり
Cover	カバー	キャンバスを覆う最小サイズ。アスペクト比維持、はみ出しクリップ
Stretch	引き延ばし	アスペクト比を無視してキャンバスいっぱいに引き延ばし
None	配置のみ	リサイズなし。指定キャンバスに配置のみ

方式	日本語	説明
NearestNeighbor	ニアレストネイバー	フィットサイズに正確にスケール
IntegerOnly	整数倍のみ	最大の整数倍（1×, 2×, 3×...）でスケール。ピクセルパーフェクト

IntegerOnly はドット絵に特に有用。端数スケール（1.5×等）でピクセルが崩れるのを防ぎます。

16×16のドット絵を width: 64, height: 64, fit_mode: Contain, scale_method: IntegerOnly → 4×拡大で64×64。

48×32の背景を width: 64, height: 64, fit_mode: Cover, alignment: Center → アスペクト比維持でキャンバスを覆い、はみ出し部分クリップ。

16×16のスプライトを width: 32, height: 32, fit_mode: None, alignment: Bottom-Center → 下中央に配置、周囲に余白。