Fit to Canvas(キャンバスフィット)

画像をターゲットキャンバスサイズに合わせて配置します。Contain/Cover/Stretch/None の4モード、9方向アンカー、ピクセルパーフェクトな整数倍スケールに対応。

中級
Since P00

入力ポート

Image(画像)

入力画像

Image

出力ポート

Image(画像)

フィット後の画像

Image

パラメータ

名前デフォルト説明
WidthInt32ターゲットキャンバス幅
Height高さInt32ターゲットキャンバス高さ
フィットモードフィットモードEnumContainフィット方法(ツールチップ付き)
整列整列EnumCenter余白がある場合の配置位置(日本語ラベル付き)
スケール方式スケール方式EnumNearestNeighborスケーリング方式(ツールチップ付き)

フィットモード一覧

モード日本語効果
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 → 下中央に配置、周囲に余白。

Fit to Canvas (キャンバスフィット) — PixPipeline ノード解説