용어 · 3D·WebGL

돌아가는 지구본

Globe · Sphere Mapping

가로가 경도, 세로가 위도인 평면 지도를 구 표면에 감고 축을 기울여 돌린다. 한쪽에서 빛을 비추면 낮과 밤의 경계와 푸른 대기가 있는 지구본이 된다.

중급공간감데이터 표현

01직접 돌려 보기

‘연출 전’은 대충 시켰을 때를 가정해 만든 화면이고 실제 AI 결과와 다를 수 있다.

연출 전흔한 첫 결과
연출 후완성본
0.00초 / 4.0초

02이름으로 시키는 지시문

대충 시킴지구본 돌아가는 화면 만들어줘→ 대개 지도가 구에 감기지 않거나, 빛이 없어 평평한 원판처럼 나온다
이름으로 시킴정방형 지도(384×192)를 구에 입혀 초당 20°로 자전, 축 23.5° 기울임, 해 방향 (-0.55, 0.35, 0.76) 의 빛과 푸른 테두리→ 23.5° 기운 축으로 초당 20°씩 도는 구에 왼쪽 위가 밝고 오른쪽 아래가 어두운 낮밤 경계, 푸른 테두리, 앞면에만 뜨는 핀 3개
Claude Code · Codex에 그대로 붙여 넣기

three.js 로 지구본(SphereGeometry, 반지름 1, 화면에서 지름 280px) 장면을 만들어줘. 화면은 640×360, 배경은 짙은 파랑(가운데 #1f3a8a에서 가장자리 #172a63으로 어두워짐)에 작은 별 약 90개.

  • 표면 질감가상의 행성(바다, 대륙, 극지방 얼음)을 가로 384 × 세로 192 짜리 정방형(equirectangular) 이미지로 만들어 구에 입힌다. 이미지의 가로가 경도, 세로가 위도에 대응한다.
  • 자전초당 20°로 왼쪽에서 오른쪽(동쪽)으로 돈다. 자전축은 23.5° 기울어 있고, 카메라는 위에서 0.3rad 내려다본다.
  • 빛해가 왼쪽 위 앞쪽(방향 (-0.55, 0.35, 0.76))에 있어서 밝은 쪽과 어두운 쪽의 경계(터미네이터)가 부드럽게 이어진다. 바다에는 작은 반사 하이라이트, 어두운 쪽 땅에는 도시 불빛 점이 보인다. 구 둘레에는 얇은 하늘색 테두리 빛(가장자리일수록 밝게)과 바깥으로 번지는 글로우를 겹으로 둔다.
  • 위도와 경도 격자선을 30° 간격으로 옅게 얹고, 핀 3개를 표면에서 살짝 띄워 꽂는다(끝에 금빛 점, 주기적으로 퍼지는 링). 핀은 앞면에 있을 때만 보이고 가장자리로 갈수록 옅어진다.
  • 오른쪽 위에는 단계 이름을 직각 모서리의 작은 표로, 아래에는 한 줄 설명을 보여 준다.
  • 연출 전같은 이미지를 구에 입히지 않고 납작한 2:1 지도로 보여 준다.
  • 금지빛 없이 평평한 원판으로 보이는 구, 뒷면에서도 보이는 핀, 지도를 구에 감을 때 극지방이 가로로 늘어나 보이는 것.

구현에 쓰이는 기술: three.js: SphereGeometry + MeshStandardMaterial({ map: 지구 텍스처 })three-globe 와 globe.gl(핀, 아크, 점을 올리는 지구본 라이브러리)D3 geoOrthographic(지도 데이터를 구에서 본 모양으로 투영)셰이더로 낮과 밤 텍스처를 빛 방향에 따라 섞기

03응용 팁

팁은 데모에서 값만 바꿔 같은 장면과 비교한 것이다. AI가 같은 결과를 내는지는 직접 해 봐야 안다.

1

너무 똑바로 서 있어 밋밋함

축이 거의 서 있어 평범한 공처럼 보일 때

지시문에서
자전축은 23.5° 기울어 있고
이렇게 바꾸세요
자전축은 60° 기울어 있고
그러면
축이 23.5°에서 60°로 누우면 구가 옆으로 크게 기울어 돌고, 위쪽 극지방과 격자선이 비스듬한 궤적을 그린다. 실제 지구본(약 23.5°)보다 훨씬 커서 지구보다는 장난감 팽이에 가깝게 보이고 위도 방향도 헷갈린다.
확인
2

돌아가는 게 느려서 지루하다

돌아가는 게 잘 안 보일 때

지시문에서
초당 20°로
이렇게 바꾸세요
초당 90°로
그러면
자전이 초당 20°에서 90°로 4.5배 빨라져 4초 만에 한 바퀴를 돈다.
확인

04만드는 순서

각 단계의 버튼을 누르면 위의 데모가 그 단계까지의 모습으로 바뀝니다.

  1. 평면 지도 그대로 보여 주기

    가로 384 × 세로 192 칸의 지도 이미지를 2:1 비율로 펼쳐 놓았다. 가로는 경도 360°, 세로는 위도 180° 이고, 극지방(위아래 가장자리)이 가로로 크게 늘어나 있다.

    ctx.drawImage(mapImage, 60, 62, 520, 260);
  2. 지도를 구에 감아 돌리기

    구 위 각 점의 법선 (x, y, z) 를 자전 각도만큼 돌려 ‘지도의 어느 점인지’를 구한다. 위도 = asin(y), 경도 = atan2(x, z). 그 자리의 지도 색을 가져오면 구의 앞면이 화면에 나타난다. 빛이 없는 단계라 구보다는 평평한 원판처럼 보인다.

    const lat = Math.asin(p.y);
    const lon = Math.atan2(p.x, p.z);
    color = map[(.5 - lat / PI) * H][(lon / TAU + .5) * W];
  3. 빛과 대기 더하기

    빛 방향 (-0.55, 0.35, 0.76) 과 법선의 내적이 밝기가 되어 왼쪽 위는 밝고 오른쪽 아래는 어두워진다. 가장자리일수록 푸른빛을 더하고(프레넬), 구 바깥에는 반지름이 다른 글로우 두 겹을 깐다. 바다에는 작은 하이라이트가 생긴다.

    const lam = dot(n, SUN);
    color = base * (0.12 + 0.95 * max(0, lam));
    color += pow(1 - n.z, 3) * ATMOSPHERE;
  4. 축 기울기, 격자, 핀, 야경으로 마무리

    자전축을 23.5° 기울이고 30° 간격의 옅은 위경도선을 올린다. 핀은 지도 좌표를 같은 회전으로 옮겨 앞면(z > 0.12)일 때만 그리고 가장자리로 갈수록 옅게 한다. 어두운 쪽(day = 0)에는 땅 위로 도시 불빛이 켜진다.

    const w = F * pinVector;
    if (w.z > 0.12) drawPin(CX + w.x * R, CY - w.y * R, alpha);
    nightLights *= 1 - day;

05전문용어 풀이

정방형 지도Equirectangular map

가로가 경도, 세로가 위도 그대로인 채로 편 지도다. 구에 입힐 텍스처로 가장 흔하게 쓴다.

AI에게“정방형 지도 이미지를 구에 입혀줘”
위도와 경도Latitude · Longitude

구 위의 위치를 나타내는 두 각도. 위도는 적도 기준 위아래, 경도는 가로 방향이다.

AI에게핀을 위도 48°, 경도 -100° 에 꽂기
자전축 기울기Axial tilt

지구본의 회전축이 수직에서 기운 각도로, 많은 지구본이 약 23.5° 를 쓴다.

AI에게“자전축을 23.5° 기울여서 초당 20°로 돌려줘”
터미네이터Terminator

낮인 쪽과 밤인 쪽을 가르는 경계선. 빛 방향과 법선의 내적이 0 이 되는 곳이다.

AI에게경계는 부드럽게
대기 테두리Atmosphere rim · Fresnel

가장자리로 갈수록 푸른빛이 세지는 효과이고, 얇은 대기층을 가진 행성처럼 보이게 한다.

AI에게“가장자리에 푸른 대기 테두리 빛을 겹으로”

06결과를 받으면 이것부터 확인

  • 연출 전은 구가 아니라 가로로 긴 2:1 평면 지도이고 극지방이 가로로 넓게 늘어나 있다
  • 1단계는 같은 지도가 구 표면에서 동쪽으로 돌지만 빛이 없어 평평한 원판 같은가
  • 2단계에서 왼쪽 위는 밝고 오른쪽 아래는 어두우며 가장자리에 푸른 빛이 있다
  • 3단계에서 30° 간격 격자선이 보이고, 핀은 앞면에만 있으며, 어두운 쪽 땅에는 도시 불빛 점이 있다

07이럴 때 쓰세요

  • 서비스의 전 세계 이용자, 지점, 배송 위치를 지구본 위에 보여 줄 때
  • 랜딩 페이지 히어로에 천천히 돌아가는 지구 넣기
  • 나라별 데이터를 구 위의 핀이나 점으로 표시하는 시각화
  • 계절과 낮밤이 생기는 원리를 설명하는 교육 콘텐츠

08같이 쓰는 용어

09근거와 확인 범위

‘확인’은 출처 문서에서 사실로 확인한 내용, ‘추정’은 결과물을 보고 추론한 내용, ‘원본 없음’은 흔히 쓰이지만 대표 원본 사례를 확인하지 못해 성공 사례로 제시하지 않은 기법이다.

  • 확인정사영(orthographic) 투영은 시점이 무한히 먼 곳에 있는 투영으로, 구의 한 반구(우주에서 보이는 면)를 평면에 그린다. 뒷면의 점은 그리지 않고 가장자리로 갈수록 모양과 면적 왜곡이 커진다. 중심 경도 λ0, 위도 φ0, 반지름 R 일 때 x = R cos φ sin(λ − λ0), y = R(cos φ0 sin φ − sin φ0 cos φ cos(λ − λ0)). 이 데모는 같은 대응을 구 위 픽셀에서 거꾸로 계산한다. Wikipedia — Orthographic map projection
  • 확인지구본은 지구 같은 천체를 구로 만든 모형이다. 평면 지도는 면적이 클수록 모양과 크기가 더 왜곡되지만 지구본은 큰 지형의 모양과 크기를 그대로 유지하고 축척만 바뀐다. 많은 지구본이 회전축을 약 23.5° 기울여 세워 계절 변화를 보여 준다. Wikipedia — Globe
  • 확인SphereGeometry 는 구 모양 지오메트리를 만드는 three.js 클래스이며 반지름과 가로, 세로 분할 수(widthSegments, heightSegments)를 받는다. three.js docs — SphereGeometry
  • 확인난반사 밝기는 면의 법선과 빛 방향 사이 각의 코사인에 비례해서, 빛을 정면으로 향한 곳이 가장 밝고 등진 곳은 어둡다. 밝은 쪽과 어두운 쪽의 경계가 터미네이터. Wikipedia — Lambertian reflectance
  • 확인유리 같은 표면은 수직으로 볼 때보다 비스듬히(가장자리에서) 볼 때 반사가 훨씬 세진다. 구의 가장자리에 푸른 테두리 빛을 더하는 것이 이 현상(프레넬)을 흉내 낸 것이다. Wikipedia — Fresnel equations