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

Capsule (캡슐)

원통 몸통 위아래에 반구 캡이 붙은 캡슐 쉐이프입니다.

Capsule 은 원통 몸통 위아래에 반구 캡이 붙은 형태입니다. 캐릭터 프록시, 알약, 손잡이 등에 쓰입니다.


형태

Height 는 원통 몸통만의 높이입니다. 전체 높이는 Height + Radius × 2 가 됩니다.

피벗은 원통 몸통의 바닥이므로 아래쪽 반구가 피벗보다 Radius 만큼 아래로 내려갑니다. 바닥에 정확히 세우려면 오브젝트를 Radius 만큼 올리거나 피벗을 조정하세요.

Sides 는 둘레 분할, Rings 는 반구 캡의 링 분할, Height Segments 는 원통 몸통의 높이 분할입니다.


파라미터

라벨스크립트 키기본값범위설명
Radiusr0.50.01 ~ 1000반지름 (m). 반구 캡의 반지름도 같습니다
Heighth1-1000 ~ 1000원통 몸통의 높이 (m)
Height Segmentsseg11 ~ 128몸통의 높이 방향 분할 수
Sidessides123 ~ 128둘레 분할 수
Ringsrings62 ~ 128반구 캡의 링 분할 수

Height Segments 의 스크립트 키는 seg(정식명 segments)입니다. 인스펙터 라벨과 키 이름이 다른 몇 안 되는 파라미터이므로 주의하세요.


만드는 방법

  1. 빈 공간에서 드래그해 반지름을 정합니다.

  2. 클릭해 확정하고 마우스를 위로 올려 몸통 높이(Height)를 정합니다.

  3. 다시 클릭하면 완성됩니다.


씬뷰 편집

±X · ±Z 핸들이 Radius 를, ±Y 핸들이 Height(몸통 높이)를 조정합니다. Radius 를 키우면 캡도 함께 커져 전체 높이가 늘어납니다.


활용 팁

Unity 의 Capsule Collider 와 치수를 맞출 때는 전체 높이 기준을 확인하세요. Unity 는 전체 높이를, 이 쉐이프는 몸통 높이를 Height 로 씁니다.

캡슐을 충돌 프록시로만 쓸 거라면 Collider Mode 를 켜면 렌더 메시를 만들지 않고 Capsule Collider 만 남습니다.


스크립트

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

capsule "Pill" r=0.15 h=0.4 @0,0,0
capsule "PlayerProxy" r=0.3 h=1.2 collider=1 @2,0,0

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

Capsule (캡슐) | UModeler X Manual