Path Coordinate Map

Path Coordinate Map

path_coordinate_map

Turn a path's parameter space into images: progress along the path, signed lateral distance, absolute distance, an influence mask, and the sub-path id. Feed them into Gradient Map, dither, Height or Emission to build path-following gradients (flame tails, light trails, roads, ridges) from existing nodes.

Name	Type	Description
パス path	Path Required	座標化するベジェパスです。進行度はサブパスごとに独立して 0(始点)〜1(終点)になります。

Name

Type

Description

パス

path

Path

Required

座標化するベジェパスです。進行度はサブパスごとに独立して 0(始点)〜1(終点)になります。

Output Ports

Name	Type	Description
進行度 progress	Image	最寄りのパス上の位置を弧長で表したグレースケールです(始点0→終点1)。Gradient Map につなぐと「頭から尾へ」のグラデーションになります。
側方距離 lateral	Image	パスをまたぐ向きの符号付き距離です(影響半径で正規化)。線上=0.5、進行方向の左=0.5より上、右=0.5より下。リボンの左右で色を変える等に使います。
距離 distance	Image	パスまでの絶対距離です(影響半径で正規化。線上0→半径以遠1)。Gradient Map につなぐと「線から外へ」の光彩・縁取りになります。
マスク mask	Image	影響半径の内側だけ白、外は透明のマスクです。上のグラデーションをパス周辺の帯に切り抜くのに使います。
サブパスID subpath_index	Image	最寄りサブパスの番号を (番号+1)÷本数のグレースケールで表します。しきい値で切ると分岐パスの特定の枝だけを選べます。

Parameters

Name	Type	Default	Range	Description / Options
幅 width	Int	0	0–1024	出力の幅(ピクセル)です。0 のときはパスのキャンバスサイズを使います(無ければ64)。
高さ height	Int	0	0–1024	出力の高さ(ピクセル)です。0 のときはパスのキャンバスサイズを使います(無ければ64)。
影響半径 influence_radius	Float	8	0.5–128 / step 0.5	側方距離・距離の正規化とマスク帯の届く距離(px)です。小さい値(2〜4)は線に沿った細い軌跡、大きい値(8〜16)は幅広い光彩や道路になります。

Overview

Renders the coordinate system around a path rather than drawing the path itself. Feed progress, signed lateral distance, or absolute distance into Gradient Map and mask nodes to build path-following gradients, glows, and left/right ribbon coloring from existing tools.

Usage tips

For trails or flame tails, map progress through gradient_map from bright at the head to transparent at the tail, then composite it through mask.
For line glow, map distance from a bright center to transparent outside. A radius of 8–16px gives a broad glow; 2–4px gives a narrow outline.
To color branches independently, threshold or palette-map subpath_index from a multi-path or branching input.
The outputs can also drive Surface height and emission. Distance mapped to height is a short route to ruts or raised ridges.
Progress runs independently from 0 to 1 on every subpath. Join paths first if one continuous progression across multiple lines is required.

Common mistakes

The output appears solid black or white: Influence Radius may be so small that distance saturates immediately. Increase it to the intended band width.
Left and right are reversed: the sign of lateral follows path direction, with the left side above 0.5. Use path_reverse to invert it.
The result is 64×64: width and height of 0 inherit the path canvas. A raw path without canvas dimensions requires explicit width and height.

Related nodes

path_stroke / path_fill — draw a path; this node supplies coordinates instead
gradient_map — the usual consumer that turns coordinate images into color
layers_to_surface — direct role-tagged path-to-Surface conversion; coordinate maps are more flexible for carefully designed color or height bands
path_reverse — reverse progress direction and the lateral sign

Input Ports