Back to Node List

Free Transform

free_transform

Scale (fractional, negative mirrors), rotate by any angle and skew in one pass. RotSprite quality keeps palette colors while smoothing edges

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

Input Ports

NameTypeDescription
画像
input
Image
Required
入力画像

Output Ports

NameTypeDescription
画像
output
Image
変形後の画像です

Parameters

NameTypeDefaultRangeDescription / Options
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
    変形後の画像が全部入るように、キャンバスを広げます

Overview

A general affine transform that combines fractional or negative scale, arbitrary rotation, skew, and translation in one resampling pass. It consolidates transformations otherwise handled separately by transform, pixel_rotate, and content_resize.

Usage tips

  • Chaining raster transforms loses quality at every step. Combine rotation, scale, and skew in this one node whenever possible.
  • Auto is the normal sampling choice: axis-aligned transforms use pixel-exact Nearest, while arbitrary rotation or skew uses RotSprite.
  • Canvas preserves the original size by default. Select Expand if rotation or enlargement clips the result.
  • For path-based assets, prefer path_transform before rasterization. It offers the same affine operations, including skew, without raster quality loss.

Common mistakes

  • Pixel thickness varies with fractional scale: this is expected with nearest-neighbor scaling. RotSprite reduces the problem, but integer scale with pixel_scale gives the most consistent pixel-art result.
  • Skew clips the edges: change Canvas from Keep Size to Expand.
  • Only rotation is needed: pixel_rotate can produce the same result and defaults to Expand. Either node is valid.

Related nodes

  • path_transform — lossless path-stage equivalent, including skew
  • transform — lightweight integer-scale and 90° rotation transform
  • pixel_rotate — rotation-only transform and the source of RotSprite sampling
  • quad_transform — trapezoid and corner-pin projection
Back to Node List
Free Transform — PixPipeline Node Reference