용어 · 도구·코드

웹 그래픽 라이브러리

JS Graphics Libraries

웹 화면에 직접 그림을 그리는 도구들. Three.js 와 Babylon.js 는 3D 장면, p5.js 는 draw() 가 계속 반복되는 스케치, D3 는 데이터를 SVG 도형에 묶어 그래프를 만든다.

고급설명공간감

01직접 돌려 보기

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

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

02이름으로 시키는 지시문

대충 시킴웹에서 3D 공이 멋지게 움직이게 해줘→ 라이브러리도 시간도 곡선도 정해지지 않아서, 대개 실행할 때마다 느낌이 다른 코드가 나온다
이름으로 시킴Three.js 로 구슬 하나를 오른쪽으로 4.8 이동. 0.4초 기다렸다가 1.2초 동안 easeOut 으로, setAnimationLoop 안에서 position.x 를 갱신→ Three.js 구슬이 4.8 만큼 0.4초 뒤에 1.2초 동안 easeOut 으로 움직이는 setAnimationLoop 코드
Claude Code · Codex에 그대로 붙여 넣기

같은 공 움직임을 Three.js, Babylon.js, p5.js, D3 가 어떤 코드로 그리는지 보여 주는 애니메이션이 필요하다. 화면은 2×2 칸으로 나누고, 칸마다 위에는 공이 움직이는 작은 장면(각 도구의 분위기), 아래에는 그 도구의 코드 4~5줄을 둔다.

공이 오른쪽으로 480(Three.js · Babylon.js 는 단위 4.8) 이동한다. 0.4초 기다렸다가 1.2초 동안 움직이고 끝에서 감속(outCubic)한다. 첫째 칸 Three.js 는 어두운 바닥 격자 위의 3D 구슬로, animate( time ) 안에서 mesh.position.x 를 바꾸고 renderer.render( scene, camera ) 를 부르며 renderer.setAnimationLoop( animate ) 로 돌린다. 둘째 칸 Babylon.js 는 하늘과 땅 장면이고 engine.runRenderLoop 안에서 sphere.position.x 를 바꾼 뒤 scene.render() 를 부른다. 셋째 칸 p5.js 는 밝은 회색 캔버스이고 function draw() 안에서 lerp( 0, 480, easeOut( t ) )로 x 를 구해 circle( x, 180, 40 ) 을 그린다. 넷째 칸 D3 는 눈금 축이 있는 어두운 SVG 장면이며 d3.select("circle").transition().delay(400).duration(1200).ease(d3.easeCubicOut).attr("cx", 480) 으로 움직인다.

Three.js, Babylon.js, p5.js 코드의 첫 줄에는 ‘t=(시간-0.4)/1.2: 0~1, easeOut=직접 작성’ 주석을 넣는다. 네 공은 같은 시각에 출발해 같은 시각에 도착하고, 코드의 숫자와 화면 숫자는 서로 같아야 한다.

연출 전에는 Three.js 칸 하나만 있고 easeOut 이 없어서 공이 같은 속도로 움직인다. 칸마다 공의 속도나 도착 시각이 다른 것, 문서에 없는 함수 이름을 지어내는 것은 금지.

구현에 쓰이는 기술: Three.js: scene · camera · renderer · mesh, renderer.setAnimationLoop(animate)Babylon.js: Engine · Scene · MeshBuilder, engine.runRenderLoop, Animation 키프레임(scene.beginAnimation)p5.js: setup() 한 번 + draw() 반복, lerp(시작, 끝, 비율), circle(x, y, 지름)D3: select → transition().duration().ease() → attr (데이터에 묶어 전환)

03응용 팁

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

1

공이 너무 멀리 간다

칸 폭에 비해 이동 거리가 클 때

지시문에서
공이 오른쪽으로 480(Three.js · Babylon.js 는 단위 4.8) 이동
이렇게 바꾸세요
공이 오른쪽으로 300(Three.js · Babylon.js 는 단위 3.0) 이동
그러면
네 칸의 공이 도착하는 자리가 왼쪽으로 가까워지고 코드의 숫자도 480 에서 300 으로(Three.js 와 Babylon.js 는 4.8 에서 3.0 으로) 바뀌어, 같은 1.2초에 가는 거리가 줄어 느려 보인다.
확인
2

움직임이 너무 빠르다

공이 휙 지나가서 감속이 보이지 않을 때

지시문에서
1.2초 동안 움직이고
이렇게 바꾸세요
2.4초 동안 움직이고
그러면
1.0초에 네 공이 길의 약 88% 지점에서 58% 지점으로 물러나 있다. 코드의 1.2 는 2.4(D3 는 1200 이 2400)로 바뀐다. 끝에서 서서히 멈추는 모습이 길게 보이는 만큼 도착 시각은 2.8초로 늦어진다.
확인
3

처음에 잠깐 멈췄다 가면 좋겠다

화면이 열리자마자 공이 움직여 어디를 봐야 할지 놓칠 때

지시문에서
0.4초 기다렸다가
이렇게 바꾸세요
1.0초 기다렸다가
그러면
코드의 대기 숫자가 0.4 에서 1.0 으로(D3 는 400 에서 1000 으로) 바뀐다. 1.6초 시점의 네 공은 도착해 있던 자리에서 길의 약 88% 지점으로 물러나 있다. 도착 시각은 2.2초가 된다.
확인

04만드는 순서

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

  1. 직선으로 움직이기

    Three.js 는 3D 장면을 만들어 두고, 매 프레임 setAnimationLoop 가 animate 를 불러 준다. animate 안에서 공의 위치(mesh.position.x)를 직접 계산해 넣는다. 시간에 비례해 값을 넣으면 같은 속도로 움직인다.

    function animate( time ) {
      mesh.position.x = 4.8 * t;
      renderer.render( scene, camera );
    }
    renderer.setAnimationLoop( animate );
  2. 끝에서 감속하게 만들기

    t(0~1)를 직접 만든 easeOut 함수에 통과시키면 끝에서 천천히 멈춘다. 바뀐 것은 라이브러리가 아니라 계산식 하나다.

    mesh.position.x = 4.8 * easeOut( t );
  3. Babylon.js 의 렌더 루프

    engine.runRenderLoop 가 매 프레임 scene.render() 를 부른다. 그 안에서 sphere.position.x 를 바꾸는 일은 Three.js 와 똑같다. 키프레임을 찍는 Animation 기능도 따로 있다.

    engine.runRenderLoop(function () {
      sphere.position.x = 4.8 * easeOut( t );
      scene.render();
    });
  4. p5.js 의 draw()

    draw() 는 초당 약 60번 실행된다. lerp 로 시작값과 끝값 사이를 구하고 circle 로 그리며, 3D 장면 없이 평면 캔버스에 바로 그린다.

    function draw() {
      let x = lerp( 0, 480, easeOut( t ) );
      circle( x, 180, 40 );
    }
  5. D3 의 전환(transition)

    프레임을 직접 계산하지 않고, 선택한 요소에 transition 을 걸어 시간(ms)과 ease 만 알려 준다. easeCubicOut 은 끝에서 감속하는 곡선이다. 데이터를 요소에 묶어 많은 점을 한꺼번에 움직일 때 강하다.

    d3.select("circle").transition()
      .delay(400).duration(1200)
      .ease(d3.easeCubicOut)
      .attr("cx", 480);

05전문용어 풀이

렌더 루프Render loop

화면을 계속 다시 그리는 반복이며, Three.js 는 setAnimationLoop, Babylon.js 는 runRenderLoop 로 부른다.

AI에게“렌더 루프 안에서 공의 위치를 갱신해줘”
스케치Sketch (p5.js)

p5.js 프로그램 하나. setup() 한 번과 draw() 반복으로 이루어진다.

AI에게p5.js 스케치로 원이 움직이게
전환Transition (D3)

D3 에서 값이 시간에 따라 부드럽게 바뀌게 하는 기능으로, duration 과 ease 를 정한다.

AI에게“transition 은 1.2초에 easeCubicOut 으로”
선형 보간lerp

시작값과 끝값 사이를 비율(0~1)로 구하는 계산. 예를 들어 lerp(0, 480, 0.5) 는 240.

AI에게lerp 로 시작과 끝 사이 채우기

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

  • 연출 전에는 Three.js 칸 하나뿐이고 코드에 easeOut 이 없으며 공이 같은 속도로 움직인다
  • 5단계의 칸이 네 개이고 네 공이 0.4초에 함께 출발해 1.6초에 함께 도착하는가?
  • 코드의 숫자(4.8 또는 480, 0.4, 1.2 또는 1200)가 화면의 숫자와 같고, 칸마다 장면 분위기가 다르다(어두운 바닥 격자, 하늘과 땅, 밝은 회색 캔버스, 눈금 축)

07이럴 때 쓰세요

  • 웹에서 3D 제품 뷰어나 공간 연출을 만드는 경우(Three.js, Babylon.js)
  • 코드로 그림과 움직임을 스케치하듯 실험하기(p5.js)
  • 데이터를 막대, 선, 지도 같은 그래프로 움직여야 할 때(D3)

08같이 쓰는 용어

09근거와 확인 범위

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

  • 확인three.js 는 쓰기 쉽고 가벼운 범용 3D 라이브러리로 WebGL 과 WebGPU 렌더러를 포함하고, SVG·CSS3D 렌더러는 애드온으로 제공된다고 소개한다. 라이선스는 MIT. 예제는 renderer.setAnimationLoop( animate ) 로 매 프레임 mesh.rotation.x = time / 2000 처럼 값을 바꿔 장면을 다시 그린다. GitHub — mrdoob/three.js (README)
  • 확인Object3D 문서에 position 속성(Vector3, 로컬 위치, 기본값 (0,0,0))이 나오고, Vector3 문서는 x, y, z 가 숫자 속성이라고 정리한다. three.js Docs — Object3D · Vector3
  • 확인Babylon.js 시작 템플릿은 new BABYLON.Engine(canvas, true), new BABYLON.Scene(engine), FreeCamera, HemisphericLight, MeshBuilder.CreateSphere(...) 로 장면을 만들고 sphere.position.y = 1 처럼 위치를 정한다. engine.runRenderLoop(function () { scene.render(); }) 가 계속 그려 주는 부분. Babylon.js Docs — Minimal HTML template
  • 확인Babylon.js 의 키프레임 애니메이션은 new Animation(name, property, frames_per_second, property_type, loop_mode), setKeys([{ frame: 0, value: 0.5 }, …]), scene.beginAnimation(target, from, to) 형태다. 이 문서에서는 이징 함수 코드를 확인하지 못했다. Babylon.js Docs — Animation method · introduction
  • 확인draw() 는 setup() 뒤에 계속 반복 실행되는 블록으로 애니메이션과 입력 반응에 쓰이며, 기본은 초당 약 60번이고 noLoop() 로 멈춘다. p5.js Reference — draw()
  • 확인lerp(start, stop, amt) 는 두 수 사이의 값을 비율로 구하는 함수로, 직선 경로 움직임에 편리하다고 설명한다. circle(x, y, d) 는 원을 그린다. p5.js Reference — lerp() · circle()
  • 확인D3 는 데이터를 시각화하는 무료 오픈소스 JavaScript 라이브러리. 차트 추상화 없이 스케일, 도형, 축, 선택(selection) 같은 기본 부품을 조합하며 SVG 와 Canvas 를 다룬다. 2011년 마이크 보스톡이 만들었고 ISC 라이선스다. D3 — What is D3?
  • 확인transition.duration(value)는 밀리초이며 기본 250ms, transition.ease(fn)의 기본은 d3.easeCubic 이고 attr 와 style 등 선택 메서드의 전환판이 있다. d3.easeCubic 은 easeCubicInOut 의 별칭, easeCubicOut 은 ‘거꾸로 돌린 cubic’(1 − easeCubicIn(1 − t)). D3 — d3-transition · d3-ease