UV Mapper

한 장의 입력 텍스처를 Rect 입력으로 지정한 여러 사각형 영역에 동시에 그려 넣는 노드입니다. 매핑용 출력 면을 구성하기 위한 요소이며, UV Generator의 Rect 출력을 받는 것이 기본 사용법입니다. 출력은 매 프레임 검은색으로 지운 뒤 다시 그려집니다.

Rect 입력

+ / - 버튼으로 Rect 입력 포트를 늘리거나 줄입니다(1~16, 1 미만으로는 할 수 없습니다). 포트 이름은 Rect0, Rect1, …(PortID는 rect_0, rect_1, …)이며, 연결하지 않아도 포트 위의 X/Y/W/H 필드에 직접 입력할 수 있습니다. 연결하지 않았을 때의 초깃값은 (0, 0, 1, 1)＝전체 면입니다.

Fit Mode

• Stretch(초깃값) — Rect 가득 차게 늘립니다

• Fill — Rect를 덮도록 소스 쪽 UV를 잘라냅니다(종횡비 유지)

• Fit — Rect 안에 들어가도록 그리는 대상 사각형을 줄입니다(종횡비 유지, 여백 있음)

• Crop — Crop UV로 지정한 범위만 사용합니다. 이 모드일 때만 Crop UV 항목이 표시됩니다(초깃값 (0, 0, 1, 1))

• Offset — 소스 UV의 X/Y에 더해집니다. 초깃값 (0, 0)

• Output — 출력 해상도. 초깃값 1920×1080. 변경하면 RT가 다시 만들어지고, 하류에 새 참조가 통지됩니다

체이스

Rect가 2개 이상 있을 때, Chase Offset과 Chase Width로 어느 Rect를 그릴지 순서대로 전환할 수 있습니다. 각 Rect의 위치는 index / Rect 수이며, Offset과의 거리(0~1로 되돌림)가 Chase Width / 2 / Rect 수를 넘으면 불투명도가 0이 됩니다.

• Chase Offset — Repeat(v, 1)로 0~1로 되돌려집니다. 초깃값 0(Chase Offset 입력 / chaseOffsetInput / chaseOffset)
• Chase Width — 하한 0.01. 초깃값 1(Chase Width 입력 / chaseWidthInput / chaseWidth)

Rect가 하나뿐일 때 체이스는 작동하지 않습니다(항상 불투명도 1).

불투명도가 0.001 이하인 Rect는 그리는 것 자체가 건너뛰어집니다.

Layer Texture가 연결되지 않았을 때는 출력이 검은색인 채로 있습니다.

await synapse.modules.create({ type: "UVMapper" })