Files

tolelom 4d5fc5e44c docs: add entity inspector design spec

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-26 10:47:14 +09:00

4.0 KiB

Raw Blame History

Entity Inspector Design

Overview

에디터 도킹 패널에 엔티티 계층 트리(Hierarchy)와 선택된 엔티티의 컴포넌트 편집(Inspector)을 추가한다. Transform, Tag, Parent 컴포넌트를 하드코딩으로 지원.

Scope

Hierarchy 패널: Transform 보유 엔티티를 계층 트리로 표시, 클릭 선택
Inspector 패널: 선택된 엔티티의 Transform(슬라이더), Tag(text_input), Parent(읽기 전용) 편집
고정 컴포넌트만 (리플렉션/등록 시스템 없음)

Dependencies

voltex_editor/Cargo.toml에 추가:

voltex_ecs.workspace = true

API

함수 기반, 구조체 불필요:

/// Hierarchy 패널: 엔티티 트리 표시, 선택 처리
pub fn hierarchy_panel(
    ui: &mut UiContext,
    world: &World,
    selected: &mut Option<Entity>,
    rect: &Rect,
);

/// Inspector 패널: 선택된 엔티티의 컴포넌트 편집
pub fn inspector_panel(
    ui: &mut UiContext,
    world: &mut World,
    selected: Option<Entity>,
    rect: &Rect,
);

Hierarchy 패널

엔티티 수집

roots(world) → 루트 엔티티 (Transform 있고 Parent 없는) 목록
각 루트에서 world.get::<Children>(entity) 로 자식 재귀 탐색

렌더링

재귀 함수: draw_entity_node(ui, world, entity, depth, selected)
들여쓰기: rect.x + 4.0 + depth * 16.0
표시 텍스트: Tag가 있으면 tag.0, 없으면 "Entity(id)"
자식이 있으면 접두사 "> ", 없으면 " "
선택된 엔티티: 배경 하이라이트 (밝은 색)
클릭 감지: ui.mouse_clicked && ui.mouse_in_rect(x, y, w, line_height)

스크롤

ui.begin_scroll_panel / end_scroll_panel 사용
content_height = 엔티티 수 * line_height

Inspector 패널

선택된 엔티티가 None이면 "No entity selected" 표시.

Transform 섹션

world.has_component::<Transform>(entity) 체크
헤더: "-- Transform --"
Position X/Y/Z: 슬라이더 3개 (range -50.0 ~ 50.0)
Rotation X/Y/Z: 슬라이더 3개 (range -3.15 ~ 3.15, 약 ±π)
Scale X/Y/Z: 슬라이더 3개 (range 0.01 ~ 10.0)
슬라이더 값을 읽은 후 world.get_mut::<Transform>(entity) 로 수정

Tag 섹션

world.has_component::<Tag>(entity) 체크
헤더: "-- Tag --"
ui.text_input(id, &mut buffer, x, y, width) 로 편집
변경 시 world.get_mut::<Tag>(entity).0 = new_value

Parent 섹션

world.has_component::<Parent>(entity) 체크
헤더: "-- Parent --"
"Parent: Entity(id)" 텍스트 (읽기 전용)

UI 통합

// editor_demo에서 dock 패널 매핑
// panel 0: Hierarchy → hierarchy_panel(ui, &world, &mut selected, rect)
// panel 1: Viewport → 3D scene
// panel 2: Inspector → inspector_panel(ui, &mut world, selected, rect)
// panel 3: Console → text

editor_demo에서 ECS World를 생성하고 데모 엔티티를 배치:

Ground (Transform + Tag("Ground"))
Cube1 (Transform + Tag("Cube1"))
Cube2 (Transform + Tag("Cube2"))
Cube3 (Transform + Tag("Cube3"))
Parent-child 관계 1개 (Cube2를 Cube1의 자식으로)

Transform 수정 후 propagate_transforms(world) 호출하여 WorldTransform 갱신.

File Structure

crates/voltex_editor/src/inspector.rs — hierarchy_panel, inspector_panel 함수
crates/voltex_editor/src/lib.rs — 모듈 추가
crates/voltex_editor/Cargo.toml — voltex_ecs 의존성
examples/editor_demo/src/main.rs — World + 엔티티 + 패널 통합

Testing

hierarchy_panel (GPU 불필요)

World에 엔티티 3개 (Transform) 추가 → hierarchy_panel 호출 → draw_list에 커맨드 생성 확인
선택 처리: 마우스 클릭 시뮬레이션 → selected 변경 확인
빈 World → 커맨드 최소 (헤더만)

inspector_panel (GPU 불필요)

Transform가진 엔티티 선택 → inspector_panel 호출 → draw_list에 슬라이더 커맨드 확인
None 선택 → "No entity selected" 텍스트만
Transform 슬라이더 조작 → world에서 값 변경 확인 (슬라이더 반환값으로 시뮬레이션)

4.0 KiB Raw Blame History