Back to Node List

Path Connect

path_connect

Connects one open sub-path from each input into a single continuous path, reversing directions when needed

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
パス A
path_a
Path
Required
接続順の前半になるサブパスを含むPath文書です
パス B
path_b
Path
Required
接続順の後半になるサブパスを含むPath文書です

Output Ports

NameTypeDescription
パス
path
Path
選んだ2本を一本のサブパスへ接続したPath文書です

Parameters

NameTypeDefaultRangeDescription / Options
サブパス A
sub_path_a
Int
00–255

パス Aから選ぶサブパス番号です(0 = 最初)

サブパス B
sub_path_b
Int
00–255

パス Bから選ぶサブパス番号です(0 = 最初)

接続する端点
endpoints
Enum
Auto

元のどの端点同士を接続するかです。まず「最も近い端点」を使い、近くに別の飾り端があって意図と違う時だけ組を明示します。

  • 最も近い端点Auto
    4通りの始点・終点から最も近い組を選び、必要な側を自動反転します
  • A終点 → B始点AEndBStart
    Aの元の終点からBの元の始点へつなぎます
  • A始点 → B始点AStartBStart
    Aを反転し、Aの元の始点からBの元の始点へつなぎます
  • A終点 → B終点AEndBEnd
    Bを反転し、Aの元の終点からBの元の終点へつなぎます
  • A始点 → B終点AStartBEnd
    両方を反転し、Aの元の始点からBの元の終点へつなぎます
端点間の処理
gap_mode
Enum
Bridge

選んだ端点間の隙間をどう扱うかです。描いた形を動かしたくないケーブルや輪郭は「直線でつなぐ」、元々接する継ぎ目は「Bの端点をAへ合わせる」を使います。

  • Bの端点をAへ合わせるSnap
    B側の接続アンカーと隣のハンドルをA端点へ移します。ほぼ接している部品向けです
  • 直線でつなぐBridge
    両方の形を動かさず、隙間へ直線セグメントを1本追加します
  • 近い時だけ接続WithinTolerance
    端点距離が許容距離以内なら合わせ、超えた時は2本のまま警告します
許容距離
tolerance
Float
20–256 / step 0.5

「近い時だけ接続」で許す端点距離(px)です。手で合わせたドット絵パスは1〜2pxから始め、小さな配置ずれを許したい時だけ上げます。

Overview

Connects separately drawn open paths such as cables, pipes, and outlines into one continuous stroke. Unlike path_combine, it aligns endpoint direction and can bridge a gap with a straight segment. Taper and path coordinates then continue across the join.

Usage tips

  • Start with two multi_path_editor or bezier_path outputs, Nearest Endpoints, and Bridge with Line, then inspect the result through path_stroke.
  • Bridge with Line preserves both source shapes and adds one segment in the gap. It is the normal choice for separated cables, pipes, or frame edges.
  • Snap B Endpoint to A moves only B's connection anchor and adjacent handle. Use it to remove a hand-drawn 1–2px mismatch at an almost-overlapping seam.
  • Connect Only When Near prevents an unexpected automatic pairing. Start with a 1–2px tolerance; paths beyond it remain separate and produce a warning.
  • Specify A End → B Start or another explicit pair only when automatic selection chooses the wrong endpoints. Paths are reversed internally as needed to preserve A→B order.
  • A30 height and width curves reverse with the path and are redistributed over the joined length. Values interpolate across a straight bridge.

Common mistakes

  • The result still contains two paths: check for closed or empty subpaths, an invalid subpath index, or a tolerance failure in Connect Only When Near.
  • The wrong ends connect: select the endpoints explicitly. Use path_reverse upstream when visual confirmation of direction helps.
  • Only the seam changes shape: Snap moves B. Choose Bridge with Line when neither source path may move.
  • Role or color is unexpected: one subpath can hold one metadata set. Explicit values from A win, and missing A values may fall back to B. Keep different roles separate with path_combine.

Related nodes

  • path_combine — collect multiple subpaths without joining endpoints
  • path_reverse — reverse direction explicitly before joining
  • path_stroke — inspect the joined result as one continuous line
  • path_coordinate_map — render progress and lateral distance along the joined path
  • path_trim — shorten a path rather than extending or joining it
Back to Node List
Path Connect — PixPipeline Node Reference