Back to Node List

Path Flip

path_flip

Flips a bezier path like a card in 3D: squashes toward the axis, switches to the back path past 90°, and keeps sub-path winding consistent when mirrored

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
表面
front
Path
Required
表面のパスです
裏面
back
Path
90°を超えたときに見える裏面のパスです(正面から見た形で作ります)。未接続なら表面のミラーが使われます

Output Ports

NameTypeDescription
パス
path
Path
フリップ後のパスです
裏面表示中
face
Bool
裏面が見えている間(90°〜270°)trueになります。候補選択(value_select)につなぐと塗り色の表裏切替に使えます

Parameters

NameTypeDefaultRangeDescription / Options
回転軸
axis
Enum
Vertical

回転させる軸です

  • 縦軸(左右フリップ)Vertical
    縦の軸で回します。横方向に潰れます
  • 横軸(上下フリップ)Horizontal
    横の軸で回します。縦方向に潰れます
軸の傾き
axis_angle
Angle
0— / step 1

回転軸を画面内で時計回りに傾けます。ベジェはアフィン変換に閉じるため、どの傾きでも無劣化です

角度
angle
Angle
0— / step 1

フリップの角度です。0°で正面、90°で線に潰れ、180°で裏面。ポート化してアニメーションさせるとフリップ動画になります

基準点
pivot_mode
Enum
CanvasCenter

フリップ軸が通る基準点です

  • キャンバス中央CanvasCenter
    キャンバス中央を軸にします。表裏のバウンズが違ってもズレません
  • パス中央Center
    パス自身の境界中心を軸にします
  • 原点Origin
    原点(0, 0)を軸にします
  • カスタムCustom
    指定した座標を軸にします
基準点X
pivot_x
Float
0-4096–4096 / step 0.5

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

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

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

巻き方向を保つ
winding_normalize_enabled
Bool
true

ミラーはサブパスの巻き方向(時計/反時計回り)を反転させます。ONにすると向きを自動で戻し、塗り・オフセット・ストロークの左右が変形後も同じ挙動になります

Overview

The path equivalent of sprite_flip: it turns a Bezier path as if it were a card. Because Bezier geometry remains affine, flipping at the path stage is lossless at every angle and axis tilt. Rasterization and lighting then run on the flattened shape for each frame.

Usage tips

  • A common chain is a path from shape_generate or bezier_path → path_flip → path_fill or path_stroke, optionally followed by surface_light_preview for per-frame lighting.
  • Promote Angle and drive it with time_source → remap from 0–1 to 0–360 for a full flip.
  • Connect a back path drawn as seen from the front. The node handles mirroring at 180°. Without a back input, it uses the mirrored front path.
  • Connect the showing_back Boolean to a value_select index to switch fill colors or stroke settings between front and back.
  • Canvas Center is the default pivot and remains stable even if front and back bounds differ. A path without canvas dimensions falls back to its bounds center.

Common mistakes

  • Nothing is visible near 90°: a path has zero thickness and collapses to a line. Fill disappears, but a 1px path_stroke can retain an edge-like line.
  • Offsets or winding-dependent fills break after mirroring: keep Preserve Winding on. Mirroring reverses winding, and the default corrects it automatically.
  • The shape jumps when front and back switch: Path Center moves when their bounds differ. Use Canvas Center or a Custom pivot.
  • Perspective is required: perspective is not affine. Rasterize first and use sprite_flip when perspective is necessary.

Related nodes

  • sprite_flip — raster-stage flip with perspective, edge line, and RotSprite
  • path_transform — general affine path transform, including manual negative scale
  • path_fill / path_stroke — rasterize the flipped path
  • surface_light_preview — relight the flattened shape on every frame
  • value_select — switch appearance using the back-side flag
Back to Node List
Path Flip — PixPipeline Node Reference