피벗과 앵커링
피벗 모드(Absolute / Anchor / Percent)와 부모 바운즈에 자식을 붙이는 앵커링, 크기 비율(%) 파라미터를 설명합니다.
파라메트릭 쉐이프는 피벗을 파라미터로 관리합니다. 그리고 부모가 파라메트릭 쉐이프이거나 Layout 이면, 자식의 위치와 크기를 부모 바운즈에 묶어 둘 수 있습니다. 부모 크기를 바꾸면 자식이 따라 움직이고 따라 커집니다.
Pivot 섹션
인스펙터의 Pivot 섹션에서 Anchor Mode 를 고릅니다.
| 모드 | 의미 |
|---|---|
| Absolute | 소스 공간의 절대 좌표를 피벗으로 씁니다. 부모와 무관하게 동작합니다. |
| Anchor | 부모 바운즈의 기준점(각 축 min / center / max)에 붙습니다. |
| Percent | 부모 바운즈 안의 상대 위치(각 축 0 ~ 1)에 붙습니다. |
- Absolute 를 고르면 Position 필드가 표시됩니다. 메시가 이 값만큼 반대로 이동해 트랜스폼 피벗이 유지됩니다.
- Anchor / Percent 를 고르면 Offset 필드가 표시됩니다. 앵커점에서 얼마나 떨어질지 지정하는 로컬 오프셋입니다.
앵커링의 동작
Anchor / Percent 모드에서는 자식의 로컬 위치가 앵커점 + Offset 으로 구속됩니다.
씬뷰에서 자식을 직접 움직이면 그 이동량이 Offset 에 역산되어 흡수됩니다. 즉 자식을 옮겨도 앵커는 유지되고, 앵커점으로부터의 거리만 바뀝니다.
부모 크기가 바뀌면 앵커점이 다시 계산되고 자식이 그 위치로 이동합니다. 예를 들어 벽 상단에 앵커된 조명은 벽을 높여도 계속 상단에 붙어 있습니다.
크기 비율(%) 파라미터
크기 파라미터 행의 m ↔ % 토글을 % 로 바꾸면, 그 필드의 값이 부모 축 길이에 대한 비율로 해석됩니다.
height = 0.5 이고 % 모드이면 부모 높이의 절반이 실제 높이가 됩니다.
각 파라미터가 참조하는 부모 축은 다음과 같습니다.
| 파라미터 | 참조하는 부모 축 |
|---|---|
width, stepWidth | X 크기 |
height, stepHeight, thickness | Y 크기 |
depth | Z 크기 |
radius, radius1, radius2 | min(X, Z) × 0.5 |
반지름 계열이 min(X, Z) × 0.5 를 쓰는 이유는, 원형 단면이 부모 바닥 안에 들어가는 최대 반지름이 그 값이기 때문입니다.
패널의 All % / All m 버튼으로 크기 파라미터 전체를 한 번에 전환할 수 있습니다.
Layout 쉐이프로 영역 잡기
Layout 은 메시가 없는 AABB 박스입니다. 렌더링되지 않고 씬뷰에 와이어 박스로만 보입니다.
건물의 한 층, 방 하나, UI 패널 영역처럼 "이 범위 안에 배치한다" 는 기준만 필요할 때 사용합니다. Layout 을 부모로 두고 자식들을 앵커 · 비율로 묶어 두면, Layout 크기 하나만 바꿔서 구성 전체를 리사이즈할 수 있습니다.
Layout "Floor" (width 8, depth 6, height 3)
├─ Box "WallNorth" pivot=top-back, width 100% ← Layout 폭에 맞춰 늘어남
├─ Box "WallSouth" pivot=top-front, width 100%
└─ Cylinder "Pillar" pivot=bottom-center
스크립트에서 지정하기
스크립트 DSL 에서는 pivot= · offset= · ratio= 로 같은 설정을 지정합니다.
layout "Floor" w=8 d=6 h=3 @0,0,0
box "WallNorth" pivot=top-back ratio=width,height w=1 h=0.9 d=0.2
문법은 씬 스크립트 문법 (umx_parametric_shape) 에서 자세히 다룹니다.