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

自由変形

free_transform

実数スケール(負でミラー)・任意角回転・スキューを1パスで合成する自由変形です。RotSprite品質なら色を混ぜずに輪郭が滑らかになります

確認済み
解説あり

入力ポート

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

出力ポート

名前型説明
画像
output
Image
変形後の画像です

パラメータ

名前型既定値範囲説明・選択肢
X倍率
scale_x
Float
1-16–16 / step 0.01

横方向の倍率です。1.0 で元のまま、負の値で左右ミラーになります

Y倍率
scale_y
Float
1-16–16 / step 0.01

縦方向の倍率です。1.0 で元のまま、負の値で上下ミラーになります

回転
rotation
Angle
0— / step 1

時計回りの回転角度です

Xスキュー
skew_x
Float
0-85–85 / step 1

横方向のせん断角度です。行が横にずれて平行四辺形になります

Yスキュー
skew_y
Float
0-85–85 / step 1

縦方向のせん断角度です。列が縦にずれて平行四辺形になります

X移動
offset_x
Float
0-4096–4096 / step 1

ほかの変形後に適用する、出力ピクセル単位の水平移動です

Y移動
offset_y
Float
0-4096–4096 / step 1

ほかの変形後に適用する、出力ピクセル単位の垂直移動です

基準点
pivot_mode
Enum
Center—

変形の基準点です

  • 中央Center
    画像の中央を基準に変形します
  • カスタムCustom
    指定した座標を基準に変形します
基準点X
pivot_x
Float
0-4096–4096 / step 0.5

カスタム基準点のX座標です

基準点Y
pivot_y
Float
0-4096–4096 / step 0.5

カスタム基準点のY座標です

方式
sampling
Enum
Auto—

変形の品質です

  • 自動Auto
    軸整列の変形はピクセル厳密なニアレスト、回転・スキューを含むとRotSpriteに自動で切り替えます
  • RotSprite（きれい）RotSprite
    Scale2xで8倍に拡大してから変形し、多数決で縮小します。色を混ぜずに輪郭が滑らかになります
  • そのまま変形Nearest
    最近傍サンプリングです。速いですが、回転・スキューでは輪郭が階段状になります
キャンバス
canvas
Enum
Keep—

出力キャンバスの決め方です

  • 元のサイズを保つKeep
    元のキャンバスサイズを保ちます。はみ出した部分は切れます
  • 変形に合わせて拡張Expand
    変形後の画像が全部入るように、キャンバスを広げます

概要

実数スケール(負でミラー)・任意角回転・スキュー・移動を1パスで合成する汎用の アフィン変形です。transform(整数倍のみ)・pixel_rotate(回転のみ)・ content_resize(軸沿いのみ)が個別に担っていた変形を1ノードにまとめられます。

使い方のポイント

  • 変形を複数チェーンすると段ごとに劣化します。回転+拡縮+スキューは このノード1個にまとめるのがきれいです
  • 方式 は自動のままが基本: 軸整列の変形(回転90°単位・スキューなし)は ピクセル厳密なニアレスト、回転・スキューを含むと RotSprite になります
  • キャンバス は既定で元サイズを保ちます。回転や拡大ではみ出すなら「拡張」へ
  • パス素材なら path_transform に同じ機能(スキュー含む)が無劣化であります。 ラスタライズ前ならそちらが優先です

よくある失敗

  • 非整数スケールでドットの太さが揃わない: ニアレストの宿命です(2倍・3倍などの 整数倍は太さが揃います)。RotSprite でも軽減しますが、整数倍+pixel_scale が 最もドット絵らしい結果になります
  • スキューで端が切れる: 元サイズ維持がデフォルトのためです。キャンバス を 「拡張」にしてください
  • 回転だけしたい: pixel_rotate でも同じ結果になります(こちらは Expand が既定)。 どちらを使っても構いません

関連ノード

  • path_transform — パス段階の同等変形(スキュー含む、無劣化)
  • transform — 整数倍+90°単位の軽量版
  • pixel_rotate — 回転専用(RotSprite の由来)
  • quad_transform — 台形・コーナーピン(こちらは射影変形)

関連ノード

パストランスフォームpath_transform変換transformピクセル回転pixel_rotateコーナーピンquad_transform
ノード一覧に戻る