Skip to content

[Feature] RoundedMask 컴포넌트 추가 #2

Description

@nelu572

배경

RoundedImage는 둥근 UI 배경을 그릴 수 있지만, 자식 UI를 같은 둥근 영역 기준으로 clipping하지는 않습니다. 둥근 패널, 카드, 프로필 영역처럼 자식 Graphic까지 둥근 영역으로 잘라야 하는 UI에서 재사용 가능한 RoundedMask가 필요합니다.

목표

둥근 사각형 영역을 기준으로 자식 uGUI Graphic을 clipping할 수 있는 범용 RoundedMask 컴포넌트를 추가합니다.

구현 범위

  • Radius 기반 둥근 clipping 지원
  • 자식 Graphic clipping
  • RoundedImage와 함께 사용하는 시나리오 검토
  • Unity Mask, RectMask2D와의 호환성 검토
  • 중첩 Mask 동작 검토
  • Material/stencil 관리 방식 검토
  • batching 및 Canvas 동작 영향 검토

제외 범위

  • 복잡한 shape mask 지원
  • 이미지 텍스처 기반 mask authoring 기능
  • 애니메이션/transition 기능
  • UIShadow, UITransition 등 다른 신규 컴포넌트 구현

기술 검토 사항

  • uGUI stencil 기반 Mask 확장 방식과 shader clipping 방식 중 어떤 접근이 적절한지 조사
  • RectMask2D와 동시에 사용할 때 clip rect와 rounded clipping을 어떻게 합성할지 검토
  • RoundedImage shader/vertex channel 구조를 재사용할 수 있는지 검토
  • 중첩 mask에서 stencil depth와 material variant가 안정적인지 검증
  • Runtime Material 인스턴스 생성이 과도해지지 않는 구조 검토

완료 조건

  • 구현 접근 방식이 조사되고 결정 근거가 기록됨
  • RoundedMask 컴포넌트가 Runtime assembly에 추가됨
  • Radius 변경이 Inspector/Scene View에서 즉시 반영됨
  • 자식 Graphic clipping이 동작함
  • Mask/RectMask2D/중첩 Mask 시나리오가 테스트됨
  • Material 관리 및 batching 영향이 문서화됨
  • README 또는 샘플 문서에 사용법이 추가됨

선행/관련 Issue

없음. 단, 현재 RoundedImage의 shader/channel 구조와의 호환성 검토가 필요합니다.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions