Post

안 보이는 3D 섹션이 첫 화면을 5.5fps로 만든 이유: IntersectionObserver 경계 판정과 three.js 인스턴싱 낭비

안 보이는 3D 섹션이 첫 화면을 5.5fps로 만든 이유: IntersectionObserver 경계 판정과 three.js 인스턴싱 낭비

회사 웹사이트 첫 화면에 항공 촬영 영상을 넣은 날, 「다른 PC에서 화면이 멈췄다가 죽는다」는 말을 들었다. 원인은 세 겹이었다. AV1 영상 디코딩, 화면에 닿기만 한 3D 섹션을 「보임」으로 판정한 IntersectionObserver, 그리고 빈 큐브까지 매 프레임 그리던 three.js 장면이다. AV1을 빼고, 판정 영역을 2px 줄이고, 3D는 「일을 안 하는」 쪽으로 고쳤다. 약한 PC 흉내 환경에서 첫 화면은 5.5 → 60fps, 3D 섹션은 4.3 → 16.9fps가 됐다.

페이지 구조

flowchart TB
  H["히어로<br/>항공 촬영 영상 video (H.264)"] --> S["숫자 띠"]
  S --> V["3D 섹션<br/>three.js 큐브 격자 장면 · 스크롤로 6단계"]
  V --> R["나머지 섹션"]
  IO1["IntersectionObserver<br/>히어로가 화면 밖 → 영상 멈춤"] -.-> H
  IO2["IntersectionObserver<br/>3D 섹션이 보일 때만 requestAnimationFrame"] -.-> V
  • Vue 3 + Vite + three.js. 히어로는 높이 100svh 영상이고, 바로 아래에 3D 섹션이 붙어 있다.
  • 3D 섹션은 스크롤에 따라 장면이 6단계로 바뀐다. 커서를 따라다니는 오브젝트가 칸을 훑는 연출도 있다.
  • 장면은 InstancedMesh 하나다. 칸 2,500개(50×50) × 칸마다 자리 8개(바닥·타일·기둥 6층) = 인스턴스 2만 개.
  • 재질은 clearcoat(유리 코팅) + 반투명, 2048² VSM 그림자와 환경맵 반사를 쓴다.

InstancedMesh: 같은 도형을 위치·크기만 바꿔 여러 번 그릴 때, draw call 한 번으로 묶어 그리는 three.js 객체다. 인스턴스마다 4×4 행렬 하나를 버퍼에 담는다.

증상

  • 「멈췄다가 죽는다」: 화면 녹화를 보니 영상이 한 장면에서 멈추고 픽셀이 깨졌다.
  • 「띄워 두면 점점 렉」: 첫 화면만 보고 있는데도 무거웠다.
  • 「아래로 내리니 또 렉」: 3D 섹션에서도 느렸다.

증상이 셋이라 하나씩 떼어 봤다.

1. 영상: AV1 디코딩

크롬은 MediaSource.isTypeSupported('video/webm; codecs="av01..."')에 「된다」고 답한다. 그래서 AV1 소스를 받는다. 하지만 하드웨어 AV1 디코딩은 그래픽카드와 드라이버마다 지원이 다르다. 그 PC에서는 멈춤과 깨짐으로 나타났다.

H.264는 사실상 모든 PC가 GPU로 디코딩한다. 그래서 AV1을 빼고 H.264만 남겼다.

  • 용량은 x264 2패스 인코딩 + -tune grain으로 맞췄다. 영상 속 잔점 디테일이 비트레이트만 올렸을 때보다 원본에 가깝게 남았다(1:1 확대 비교).
  • 데스크톱은 17MB, 폰은 세로로 잘라 540×960 3.8MB다.
  • <source media="(max-width: 768px)">로 방문자는 둘 중 하나만 받는다.

2. 첫 화면 렉: 안 보이는 3D가 그려지고 있었다

측정 방법

헤드리스 크롬(puppeteer)에 --disable-gpu(소프트웨어 렌더링)와 CDP Emulation.setCPUThrottlingRate(4)(CPU 4배 느리게)를 걸어 약한 PC를 흉내 냈다. 그 상태에서 requestAnimationFrame으로 5초 동안 fps와 최악 프레임을 잰다(스크립트는 글 끝에). 페이지 일부를 display:none으로 숨겨 가며(영상만 / 3D만 / 둘 다) 같은 측정을 반복했다. 그대로 두면 첫 화면이 5.5fps였다.

범인은 영상이 아니라 화면에 보이지도 않는 3D 섹션이었다. Performance 지표의 ScriptDuration을 보니 3D 스크립트가 첫 화면에서도 돌고 있었다.

첫 번째 추정: rootMargin 여유 (반만 맞음)

3D 섹션 관찰에 rootMargin: '200px'이 걸려 있었다. 화면 아래 200px 안에 들어오면 미리 돌리는 설정이다. 이를 0으로 줄였다. 그런데 여전히 느렸다.

진짜 원인: 「닿기만 해도 보임」

히어로 높이가 100svh이고 바로 아래가 3D 섹션이다. 그래서 3D 섹션 윗변이 화면 아래 끝에 정확히 닿는다.

IntersectionObserver 명세에서는 경계가 맞닿기만 해도(교차 넓이 0) isIntersecting = true다. 결국 히어로만 보는 동안에도 3D가 매 프레임 그려졌다.

내 실수: 콜백 안에서 걸렀다가 3D가 아예 멈춤

처음에는 콜백 안에서 「교차 높이가 1px 넘을 때만 보임」으로 걸렀다.

1
2
3
4
5
// 잘못된 수정
io = new IntersectionObserver(([e]) => {
  visible = e.isIntersecting && e.intersectionRect.height > 1
  onVisibility()
})

그런데 IntersectionObserver는 문턱(threshold)을 넘을 때만 콜백을 부른다. 「높이 0으로 보임」 상태에서 실제로 화면에 들어오는 순간까지, 문턱 0을 다시 넘지 않는다. 그래서 콜백이 오지 않는다. 결과적으로 스크롤해 내려가도 3D가 아예 시작되지 않았다. 개발 서버에서 측정 스크립트를 돌렸을 때 3D 섹션 스크립트 시간이 0으로 나와서 발견했다.

최종 수정: 판정 영역 자체를 줄이기

콜백에서 거르지 않고, 판정 영역을 아래에서 2px 줄였다.

1
2
3
4
5
6
7
io = new IntersectionObserver(
  ([e]) => {
    visible = e.isIntersecting
    onVisibility()
  },
  { rootMargin: '0px 0px -2px 0px' } // 화면 아래 끝에 닿기만 한 것은 「안 보임」
)

첫 화면이 5.5 → 60fps가 됐다. 같은 원리로 히어로 영상도 화면 밖에 나가면 pause()한다.

3. 3D 섹션 렉: 장면 자체가 무거움

3D 섹션 안에서 쟀다.

환경fps
GPU 있는 PC240(가벼운 단계) / 83(가장 무거운 단계)
약한 PC 흉내4~6
약한 PC 흉내 + 그림자·환경맵 끔, 해상도 1배25

렌더 루프 코드를 읽고 프레임마다 하는 일을 적어 보니 낭비가 여럿이었다.

낭비내용
빈 큐브도 그림2만 개 중 첫 장면에서 보이는 것은 바닥 2,500개뿐이다. 나머지는 크기를 0.00001로 줄여 숨겼을 뿐이다. 정점 셰이더는 2만 개 × 약 100정점을 그림자 패스와 본 패스에서 두 번 돈다
매 프레임 전부 재계산장면이 멈춰 있어도 2만 개 행렬을 Object3D.updateMatrix()(오일러 → 쿼터니언 → 행렬)로 만들어 통째로 GPU에 올렸다
안 쓰는 데이터 업로드예전에 꺼 둔 점구름 셰이더용 데이터 텍스처 4장(50×50 RGBA float)을 매 프레임 올렸다
그림자 매 프레임2048² VSM(블러 10샘플) 그림자 지도를 큐브가 그대로여도 매 프레임 다시 그렸다
느린 기기 감지가 늦음조립 애니메이션이 끝나고 60프레임 평균을 본 뒤에야 화질을 낮췄다. 6fps면 10초 넘게 버벅인 뒤다
재질이 비쌈clearcoat(반사층 하나 더) + 반투명(블렌딩)

해결: 「일을 안 하는」 렌더링

원칙은 하나였다. 겉모습은 그대로 두고, 할 필요 없는 일을 안 한다.

① 보이는 큐브만 그리기 (압축)

칸마다 보이는 큐브만 인스턴스 버퍼 앞에서부터 차례로 쓴다. 그리고 mesh.count = 보이는 수로 둔다. 첫 장면은 2만 → 2,500개가 됐다.

GPU 업로드도 쓴 만큼만 한다.

1
2
3
4
mesh.count = n
mesh.instanceMatrix.clearUpdateRanges()
mesh.instanceMatrix.addUpdateRange(0, n * 16) // 행렬 하나 = float 16개
mesh.instanceMatrix.needsUpdate = true

② 바뀐 칸만 다시 계산 (더티 플래그)

  • 전체 계산: 스크롤 단계·조립·격자 전환 중이거나, 모든 칸이 변하는 효과(스캔 띠·파동 등)가 켜져 있을 때. 이때 칸마다 「몇 번 자리부터 몇 개」를 기록한다(cellStart, cellCount).
  • 부분 계산: 그 밖에는 커서 오브젝트 주변 칸(지금·직전 자리)과 호버 중인 칸만 다시 계산해 그 자리만 덮어쓰고 업로드한다.

부분 계산이 안전한 이유: 큐브가 보이는지는 단계·격자로만 정해지고, 커서·호버는 색과 높이만 바꾼다. 그래서 칸마다 큐브 수가 변하지 않는다. 혹시 수가 달라지면 다음 프레임에 전체 계산을 한다(안전장치).

1
2
3
4
5
6
7
8
9
10
11
// 한 프레임: 「멈춰 있음」이면 커서 주변 + 호버 칸만 다시 계산
const settled =
  last &&
  stage === last.stage &&
  assemble === last.assemble &&
  assemble >= 1.02 &&
  grid === last.grid &&
  fx.scan === 0 &&
  fx.slice <= 0.01 &&
  fx.wave <= 0.01 &&
  ripples.length === 0

assemble >= 1.02 같은 값은 코드에서 끌어냈다. 칸마다 조립 지연의 최댓값이 약 1.03이다. 그래서 모든 칸이 제자리에 오는 시점은 0.55 × 1.03 + 0.45 ≈ 1.02다.

회전이 없는 큐브는 updateMatrix()를 부르지 않는다. 대각선에 크기, 마지막 열에 위치만 있는 행렬 16칸을 instanceMatrix.array에 직접 쓴다.

③ 그림자는 바뀔 때만, 초당 30번까지

1
2
3
4
5
6
renderer.shadowMap.autoUpdate = false
// 큐브가 바뀐 프레임에서만, 최소 30ms 간격
if (changed && now - lastShadow > 30) {
  renderer.shadowMap.needsUpdate = true
  lastShadow = now
}

커서 오브젝트는 늘 움직인다. 그 그림자를 남기면 그림자 지도를 매번 다시 그려야 한다. 그래서 움직이는 오브젝트의 그림자는 뺐다.

④ 느린 기기는 처음 1초 안에 판단

  • 첫 5프레임은 셰이더 컴파일 때문에 튀므로 뺀다.
  • 30프레임 또는 1초 묶음의 평균 프레임 시간이 28ms(약 36fps 미만)를 넘으면 그림자·환경맵 반사를 끄고 해상도를 1배로 낮춘다.
  • 넘지 않으면 묶음마다 계속 잰다. 무거운 단계에서 느려지는 경우도 잡기 위해서다.

⑤ 재질: 반투명만 끄고 광택은 살짝만

코팅 없는 MeshStandardMaterial은 큐브 모서리 선이 흐려졌고, fps 차이도 거의 없었다(16.9 vs 17.2). 그래서 코팅은 남기고 반투명만 껐다(코팅 거칠기 0.08 → 0.12). 불투명이면 블렌딩이 없고, 가려진 화소를 깊이 테스트로 일찍 버린다(early-z).

결과

측정(같은 스크립트)전후
첫 화면, 약한 PC 흉내5.5fps60fps
3D 무거운 단계, 약한 PC 흉내4.3fps, 최악 250ms16.9fps, 최악 83ms
3D 마지막 단계, 약한 PC 흉내4.2fps16.3fps
3D 무거운 단계, GPU PC83fps, 최악 30ms200fps, 최악 5ms
메인 스레드 JS, GPU PC 첫 장면초당 0.36초초당 0.18초

상호작용 시험(데스크톱 1600×900, 폰 390×844)에서 콘솔 오류는 0건이었다. 단계별 캡처를 전후로 비교했다. 겉모습 차이는 두 가지뿐이었다. 움직이는 오브젝트의 그림자가 없어졌고, 큐브가 불투명해져서 스캔 빛기둥이 조금 더 잘 보인다.

덧붙임: 「느리다」의 범인이 내 브라우저였던 일

운영 반영 직후 내 PC에서 「영상이 늦게 뜨고 3D는 로딩 표시만 보인다」. 서버 쪽은 개발 서버와 같았다. 같은 PC에서 브라우저와 curl로 따로 재 보니 전혀 달랐다.

측정크롬같은 PC의 curl
바깥에 보이는 IP유럽 IP국내 통신사 IP
다운로드7~13Mbps, 왕복 350ms220~290Mbps
첫 응답(TTFB)0.5~1.1초0.05초

크롬에 설치된 무료 VPN 확장 프로그램(프록시 권한)이 켜져 있었다. 크롬 트래픽만 유럽을 돌아오고 있었다. 끄자 정상이 됐다.

이 과정에서 코드 쪽 진짜 문제도 하나 찾았다. 3D 코드를 window의 load 뒤에 불러오고 있었는데, 브라우저는 <video>가 받는 동안 load를 미룬다. 느린 회선에서는 영상을 다 받을 때까지 3D가 시작조차 안 됐다(20Mbps 흉내: 6.3초 뒤에야 시작). 영상은 먼저 자동 재생하고, 3D 코드는 2.5초 뒤 또는 첫 스크롤·터치 때 불러오게 바꿨다.

한계

  • 실제 내장 그래픽 노트북이나 폰에서는 재지 않았다. 거기서는 화소를 칠하는 비용(해상도·재질)이 더 클 수 있다.
  • 전체 효과가 켜진 단계는 여전히 매 프레임 전체를 계산한다. 더 줄이려면 효과를 셰이더로 옮겨야 한다(onBeforeCompile).

배운 점

IntersectionObserver의 「보임」은 넓이 0도 포함한다

  • 경계가 맞닿기만 해도 isIntersecting = true다.
  • 콜백은 문턱을 넘을 때만 온다. 그래서 콜백 안에서 값을 다시 거르면, 걸러진 상태에서 벗어나는 순간을 놓친다.
  • 판정 자체를 바꾸려면 rootMargin(음수 = 판정 영역 줄이기)이나 threshold를 쓴다.

개발자 도구 콘솔에서 직접 확인할 수 있다. 화면 높이 히어로 바로 아래 요소에 걸고 스크롤해 보자.

1
2
3
new IntersectionObserver(([e]) =>
  console.log(e.isIntersecting, e.intersectionRect.height)
).observe(document.querySelector('#target'))

인스턴스를 「숨기는」 것은 그리기 비용을 없애지 않는다

  • 크기 0으로 숨겨도 정점 셰이더는 그대로 돈다.
  • 안 그리려면 count를 줄이고 보이는 것만 버퍼 앞으로 모은다.
  • 그림자를 켜면 같은 정점을 그림자 패스에서 한 번 더 그린다.

나머지 개념

개념한 줄 설명
더티 플래그바뀐 것만 다시 계산한다. 핵심은 「무엇이 바뀌면 전부, 무엇이 바뀌면 일부」를 정확히 나누는 것과, 가정이 깨졌을 때의 안전장치다
그림자 지도빛에서 본 깊이 그림이다. 빛과 물체가 그대로면 다시 그릴 필요가 없다(shadowMap.autoUpdate = false)
반투명 비용블렌딩 + 정렬이 필요하고, 겹친 만큼 화소를 여러 번 칠한다(overdraw)
「느리다」 가르기같은 PC에서 둘 이상의 경로(브라우저 vs curl)로 재서 서버·회선·브라우저·렌더링 중 어디인지 먼저 가른다

약한 PC 흉내 fps 측정 스크립트

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
import puppeteer from 'puppeteer'

const browser = await puppeteer.launch({ args: ['--disable-gpu'] })
const page = await browser.newPage()
const cdp = await page.createCDPSession()
await cdp.send('Emulation.setCPUThrottlingRate', { rate: 4 })
await page.goto(process.argv[2], { waitUntil: 'networkidle2' })

const result = await page.evaluate(() => new Promise((resolve) => {
  const t0 = performance.now()
  let last = t0, frames = 0, worst = 0
  function tick(t) {
    worst = Math.max(worst, t - last)
    last = t
    frames++
    if (t - t0 < 5000) requestAnimationFrame(tick)
    else resolve({ fps: frames / ((t - t0) / 1000), worstMs: worst })
  }
  requestAnimationFrame(tick)
}))
console.log(result)
await browser.close()

소프트웨어 렌더링은 실제 내장 그래픽과 병목 위치가 다를 수 있다. 실기기 확인은 따로 필요하다.

더 찾아볼 키워드: IntersectionObserver rootMargin, three.js InstancedMesh count, BatchedMesh, shadowMap.autoUpdate, overdraw, early-z, onBeforeCompile, AV1 hardware decode support

This post is licensed under CC BY 4.0 by the author.