A. Ursina 라이브러리 불러오기

예상 시간: 5분 | 다음: B. 게임 창 만들기

🎯 학습 목표

이 강의를 마치면 다음을 할 수 있어요:

○ from ursina import *의 의미를 이해한다
○ 라이브러리가 무엇인지 이해한다
○ 왜 라이브러리를 불러오는지 이해한다

핵심 개념

라이브러리(Library)란?

라이브러리는 다른 사람들이 미리 만들어둔 코드 모음입니다.

📝 비유: 도구 상자

라이브러리는 도구 상자와 같습니다!

망치, 드라이버, 톱 등이 들어있는 도구 상자
필요한 도구를 꺼내서 사용하면 됩니다
직접 도구를 만들 필요 없이 바로 사용!

Ursina 라이브러리에는 3D 게임을 만드는 도구들이 들어있어요!

import 흐름도

flowchart TD
    A["from ursina import *"] --> B["Ursina 라이브러리 로드"]
    B --> C["Entity, color, Vec3 등<br/>모든 기능 사용 가능!"]
    C --> D["3D 게임 개발 시작"]

    style A fill:#e3f2fd,stroke:#1976d2
    style B fill:#fff3e0,stroke:#f57c00
    style C fill:#e8f5e9,stroke:#388e3c
    style D fill:#f3e5f5,stroke:#7b1fa2

주요 라이브러리 비교

라이브러리	용도	예시
math	수학 계산	`sqrt()`, `sin()`
turtle	2D 그래픽	거북이 그림
ursina	3D 게임 개발	큐브, 캐릭터

코드 작성하기

from ursina import *

설명:

from ursina: Ursina 라이브러리에서
import *: 모든 기능을 가져옵니다
*는 "모든 것"을 의미합니다

⚠️ 순서가 중요해요!

from ursina import *는 항상 파일 맨 위에 작성해야 합니다!

이 줄이 없으면 Ursina의 어떤 기능도 사용할 수 없어요.

예제 코드

from ursina import *  # Ursina의 모든 기능 가져오기

# 이제 Ursina(), Entity(), color 등을 사용할 수 있습니다!

결과

이 줄 덕분에 3D 게임 기능을 사용할 수 있게 됩니다!

🎯 퀴즈

퀴즈: import 문

from ursina import *에서 *는 무엇을 의미하나요?

정답 보기

정답: C) 모든 기능을 가져온다는 의미

*는 "모든 것(everything)"을 의미하는 와일드카드입니다. from ursina import *는 Ursina 라이브러리의 모든 기능을 가져옵니다!

🔧 디버그 클리닉

문제: NameError: name 'Ursina' is not defined

원인: from ursina import *를 안 썼거나 오타가 있음

해결: 파일 맨 위에 from ursina import * 추가

# ❌ 잘못된 코드
app = Ursina()  # NameError 발생!

# ✅ 올바른 코드
from ursina import *  # 먼저 불러오기!
app = Ursina()

문제: ModuleNotFoundError: No module named 'ursina'

원인: Ursina가 설치되지 않음

해결: 터미널에서 설치 명령어 실행

pip install ursina

직접 코딩해보기

Ursina 라이브러리를 불러오는 코드를 직접 작성해보세요!

import 문 작성하기

빈 칸에 올바른 import 문을 작성하세요.

예시 답안

from ursina import *

설명: 이 한 줄로 Ursina의 모든 3D 게임 기능을 사용할 수 있습니다!

🧩 핵심 요약

이번 강의에서 배운 내용:

라이브러리: 미리 만들어진 코드 모음 (도구 상자)
import: 라이브러리를 불러오는 명령어
*: "모든 것"을 의미 (와일드카드)
위치: 항상 파일 맨 위에 작성!

복습 체크리스트

[ ] 라이브러리가 무엇인지 설명할 수 있나요?
[ ] from ursina import *의 의미를 이해했나요?
[ ] import 문을 파일의 어디에 써야 하는지 알고 있나요?

다음 단계: B. 게임 창 만들기 →