Camera 시스템

English | 繁體中文 | 日本語 | 한국어

BIT8_CLI는 게임 세계에서 화면에 표시할 영역을 제어하는 Camera 시스템을 제공합니다.

BIT8_CLI 0.1.0에서 Camera는 Map 데이터와 연결되며 World 좌표를 사용하는 렌더링에 영향을 줍니다.

게임은 고정된 64 × 64 픽셀 Viewport를 사용합니다.

1. Camera 개요

Camera는 게임 세계에서 표시할 영역의 중심을 정의합니다.

Framebuffer 해상도는 고정되어 있습니다.

64 × 64 pixels

Map은 Viewport보다 훨씬 클 수 있습니다.

Camera는 큰 게임 세계의 어느 부분이 화면에 나타날지 결정합니다.

2. Camera와 Map

Camera 데이터는 Map 시스템의 일부로 저장됩니다.

.b8map 파일에는 다음 데이터가 포함될 수 있습니다.

• Tile 데이터
• Node
• Camera

Camera를 사용하면 Framebuffer 해상도를 변경하지 않고 Map의 다른 영역을 표시할 수 있습니다.

자세한 내용은 Maps 페이지를 참고하세요.

3. Camera 위치

Camera는 World 좌표상의 위치를 가집니다.

이 위치는 Viewport의 중심을 나타냅니다.

예:

Camera position: (100, 80)
Viewport size:   64 × 64

개념적으로 표시 영역은 Camera 중심에서 각 방향으로 약 32픽셀 확장됩니다.

대략적인 표시 영역:

X: 68 to 131
Y: 48 to 111

정확한 픽셀 경계는 Runtime의 좌표 처리 및 반올림 규칙에 따라 달라질 수 있습니다.

4. World 좌표

World 좌표는 게임 세계 안의 위치를 나타냅니다.

예:

• Map Tile
• Node
• Node Sprite
• World 좌표를 사용하는 렌더링 작업

Camera가 활성화되면 지원되는 World 좌표 렌더링이 Camera 위치를 기준으로 변환됩니다.

따라서 Viewport에 게임 세계의 다른 영역을 표시할 수 있습니다.

5. Screen 좌표

Screen 좌표는 Framebuffer 내부의 고정된 위치를 나타냅니다.

좌표 범위:

X: 0 to 63
Y: 0 to 63

일부 렌더링 작업은 Screen 좌표를 사용합니다.

예:

cls(0)
pix(32, 32, 7)

이러한 작업은 Screen 좌표를 유지하며 Camera 이동의 영향을 받지 않습니다.

UI나 화면 Overlay를 만들 때 유용합니다.

6. World 좌표를 Screen 좌표로 변환하기

간단한 Camera 변환 공식:

screen_x = world_x - camera_x + 32
screen_y = world_y - camera_y + 32

예:

World position:  (100, 80)
Camera position: (100, 80)

Screen position: (32, 32)

Camera 중심에 있는 객체는 화면 중앙 근처에 표시됩니다.

이 공식은 기본 개념을 설명하기 위한 것입니다.

정확한 픽셀 위치는 Runtime의 정수 좌표 처리 규칙에 따라 달라질 수 있습니다.

7. Active Camera 선택

Map에는 여러 Camera가 포함될 수 있습니다.

BIT8_CLI 0.1.0은 다음 규칙으로 Active Camera를 선택합니다.

활성화된 Camera 중 ID가 가장 작은 Camera를 선택합니다.

이 규칙을 통해 여러 Camera가 존재하더라도 선택 결과를 예측할 수 있습니다.

예:

Camera ID 1 → Disabled
Camera ID 2 → Enabled
Camera ID 3 → Enabled

Active Camera:

Camera ID 2

8. Camera와 Tile Rendering

Map Rendering은 World 좌표를 사용합니다.

Camera가 활성화되면 Map은 표시할 World 영역을 기준으로 그려집니다.

예:

func draw()
    cls(0)
    map()
end

Camera는 64×64 Framebuffer 안에 표시되는 Map 영역을 결정합니다.

9. Camera와 Sprite

Node Sprite는 World 좌표를 사용합니다.

Camera가 활성화되면 지원되는 Sprite Rendering이 Screen 좌표로 변환됩니다.

예:

func draw()
    self:spr()
end

Node의 World 좌표는 그대로 유지됩니다.

Camera는 Sprite가 화면에 표시되는 위치에 영향을 줍니다.

자세한 내용은 Sprites and Animation 페이지를 참고하세요.

10. Camera와 UI

게임에서는 특정 그래픽을 화면의 고정된 위치에 표시해야 할 수 있습니다.

예:

• HP 표시
• 카운터
• 메뉴
• Screen Overlay

이러한 요소에는 Screen 좌표 렌더링이 유용합니다.

예:

func draw()
    cls(0)
    map()

    pix(32, 32, 7)
end

여기서 pix()는 고정된 Screen 좌표에 픽셀을 그립니다.

Camera는 이 픽셀의 위치를 변경하지 않습니다.

11. Camera 편집

BIT8_CLI의 VS Code Map Workspace는 Camera 시각화를 지원합니다.

개발자는 Map을 편집하면서 Camera 위치를 확인할 수 있습니다.

Camera 데이터는 Map 프로젝트 데이터에 포함됩니다.

Runtime은 Active Camera를 선택하고 적용하는 역할을 담당합니다.

자세한 내용은 Map Workspace 페이지를 참고하세요.

12. Camera와 Viewport 크기

BIT8_CLI 0.1.0은 고정된 Framebuffer 해상도를 사용합니다.

64 × 64 pixels

Camera는 표시되는 World 영역을 변경합니다.

Framebuffer 자체의 해상도는 변경하지 않습니다.

따라서 작은 Viewport를 통해 큰 Map을 탐색할 수 있습니다.

13. 현재 제한 사항

BIT8_CLI 0.1.0의 Camera 시스템은 주로 다음 기능에 중점을 둡니다.

• Map 데이터에 저장되는 Camera
• World 좌표 렌더링 오프셋
• 고정된 64×64 Viewport
• 결정적인 Active Camera 선택
• Screen 좌표 렌더링

고급 Camera Effect, 영화적 Transition, 범용 Camera Script Framework는 확립된 0.1.0 기능에 포함되지 않습니다.

다음 단계

Core Systems 다음에는 개발 도구 문서가 이어집니다.

CLI Reference

관련 문서:

• Maps
• Nodes
• Sprites and Animation
• Map Workspace
• Runtime API

Map은 세계를 정의하고, Camera는 무엇을 보여 줄지 결정합니다.