Fit to Canvas

Fit image to target canvas size with various modes

intermediate
Since P00

Input Ports

Image

入力画像

Image

Output Ports

Image

フィット後の画像

Image

Parameters

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

フィットモード一覧

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

スケール方式

方式日本語説明
NearestNeighborニアレストネイバーフィットサイズに正確にスケール
IntegerOnly整数倍のみ最大の整数倍(1×, 2×, 3×...)でスケール。pixel-perfect
IntegerOnly はドット絵に特に有用。端数スケール(1.5×等)でピクセルが崩れるのを防ぎます。

Usage Examples

ドット絵をプレビューキャンバスに収める

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 Node Reference