UModeler X MCP출시 — AI 에이전트로 모델링하세요
UModeler X

Spiral Stair (나선 계단)

중심 반지름과 총 회전각으로 정의되는 나선 계단 쉐이프입니다.

Spiral Stair 는 나선 계단입니다. 중심 반지름, 계단 너비, 총 회전각으로 형태가 결정됩니다.


형태

바깥 반지름 = Radius + Step Width 입니다. Radius 는 중심(안쪽) 반지름이고, Step Width 는 디딤판이 반경 방향으로 뻗는 폭입니다.

Sweep Angle 은 계단이 도는 총 각도(1 ~ 360°)이고, Start Angle 은 첫 단이 시작하는 각도입니다. 회전 방향은 Sweep Angle 의 부호가 아니라 Counter Clockwise 체크박스로 지정합니다 — 음수 각도를 쓰면 면이 뒤집히기 때문입니다.

단 수는 Stair 와 같이 Height ÷ Step Height 로 결정되며 최대 256단입니다. 피벗은 나선 중심의 바닥입니다.


파라미터

라벨스크립트 키기본값범위설명
Radiusr10.01 ~ 1000중심(안쪽) 반지름 (m)
Step Widthsw10.01 ~ 1000디딤판의 반경 방향 폭 (m)
Heighth2-1000 ~ 1000전체 높이 (m)
Start Angleang0-360 ~ 360첫 단이 시작하는 각도 (도)
Sweep Anglesweep3601 ~ 360계단이 도는 총 각도 (도)
Step Heightsh0.20.01 ~ 1000한 단의 높이 (m). 단 수를 결정합니다
Counter Clockwiseccwoffon / off켜면 반시계 방향으로 올라갑니다

sw(Step Width)와 w(Width)는 다른 파라미터입니다. 나선 계단에는 공용 w 를 쓰지 않고 전용 sw 를 씁니다 — 오브젝트 전체 폭과 디딤판 폭을 혼동하지 않기 위한 구분입니다.


만드는 방법

  1. 빈 공간에서 드래그해 중심 반지름(Radius)을 정합니다.

  2. 클릭해 확정하고 마우스를 위로 올려 Height 를 정합니다.

  3. 다시 클릭하면 완성됩니다. Step Width · Sweep Angle · 회전 방향은 인스펙터에서 조정합니다.


씬뷰 편집

±X · ±Z 핸들이 Radius 를, ±Y 핸들이 Height 를 조정합니다. Step Width 와 두 각도는 인스펙터의 슬라이더 · 게이지로 조정합니다.


활용 팁

층 사이를 잇는 계단은 Height 를 층고에 맞추고 Step Height 를 잠근 뒤 Sweep Angle 로 동선을 맞추는 순서가 편합니다.

반 층만 도는 계단은 Sweep Angle 180, 두 바퀴처럼 보이려면 Sweep 360 짜리를 두 개 쌓으세요 — Sweep Angle 은 360 이 상한입니다.

중심 기둥이 필요하면 Radius 만큼의 Cylinder 를 자식으로 두세요.


스크립트

스크립트에서는 spiralstair 로 지정합니다.

spiralstair "Helix" r=0.4 sw=1 h=3 sweep=270 sh=0.18 @0,0,0
spiralstair "HelixCCW" r=0.4 sw=1 h=3 sweep=360 ccw=1 @4,0,0

관련 문서 — 쉐이프 종류 목록 · 생성과 편집 모드 · 씬 스크립트 문법

Spiral Stair (나선 계단) | UModeler X Manual