On this page
HTML-in-Canvas(HIC)는 HTML·CSS로 구성한 DOM 요소를 캔버스에 그릴 수 있게 하는 WICG의 제안입니다. 블로샤퍼에서는 기존 UI의 레이아웃을 유지하면서 화면을 캔버스 렌더링 경로로 옮겨, 픽셀이 그려지는 방식을 제어하려고 했습니다.
화질은 좋아졌지만, 성능 개선까지 HIC의 효과라고 말할 수는 없었습니다. Electron 버전이 함께 바뀌었고, HIC 경로에서는 일부 시각 효과도 빠져 비교 조건이 달랐습니다. 이후에는 렌더링 루프가 정상적으로 도는데도 캐릭터 초상이 비는 문제를 확인했습니다. 이 글은 그 비교 조건과 실제 출력의 누락을 추적한 기록입니다.
한때 기본값으로 사용했던 HIC는 이 글의 마지막 검증 시점에는 기본적으로 꺼진 실험 옵션으로 남아 있었습니다. 기본 경로는 기존 렌더러였고, 화면 누락의 원인은 아직 가려내지 못했습니다.
도입 배경
이 실험에서는 Chromium의 실험 플래그로 활성화한
drawElementImage()를 사용했습니다. 브라우저가 배치한 DOM 요소를 2D 캔버스에 그리는 API입니다.블로샤퍼의 인터페이스는 이미 HTML로 구성되어 있습니다. 이 레이아웃은 유지하면서, 완성된 화면이 픽셀로 그려지는 방식을 제어하고 싶었습니다. HIC 경로에서는 화면을 캔버스에 그려 기존 SVG 기반 방식과 다른 경로로 픽셀 렌더링을 처리합니다.
계속 시도해 볼 만한 화질 차이가 있었습니다. 구현하고 검증한 뒤 기본값으로 사용해 볼 이유는 충분했습니다. 문제는 그 화질 개선을 다른 효과의 근거로까지 넓혀 해석하면서 생겼습니다.
동시에 바뀐 런타임과 렌더링 경로
비슷한 시기에 Electron도 42에서 44로 올렸습니다.
런타임과 렌더링 경로가 함께 바뀐 것입니다. 새 빌드로 스팀덱에서 장시간 실행해 보니, 예전에는 이펙트가 나올 때 나타나던 버벅임이 관측되지 않았습니다.
그 조건에서 새 빌드가 더 잘 돌아갔다고는 말할 수 있었습니다. HIC 덕분이라고는 말할 수 없었습니다. 이후 Electron 44에서 HIC를 끄고 돌린 경우에도 예전의 프레임 드롭이 나타나지 않았습니다. 개선의 공로를 HIC에 돌릴 근거는 약해졌고, 런타임 업그레이드 쪽을 보게 됐습니다.
HIC가 메모리 누수를 잡았다거나 장시간 실행의 안정성을 해결했다고 쓸 근거는 없었습니다.
렌더링 효과가 다른 성능 비교
HIC를 켰다 끄며 성능을 비교하는 데는 다른 문제도 있었습니다.
당시 구현에서는 HIC가 켜지면 일부 SVG 효과를 생략했습니다. CRT 스타일의 화면 왜곡 효과와 픽셀화 필터가 그 경로에서는 적용되지 않았습니다.

그러면 HIC를 켠 쪽이 더 부드러워 보여도, 연출 일부가 빠져서 할 일이 줄어든 결과일 수 있습니다. 같은 이미지를 더 효율적으로 그렸다고 볼 수 없는 비교였습니다.
프레임 시간을 재기 전에 두 경로가 동등한 내용을 그리고 있는지부터 확인해야 했습니다. 이 확인을 빼면 성능 숫자 뒤에 게임의 화면 차이가 숨어 버립니다.
그림이 제대로 그려졌는지 확인하는 격자
HTML-in-Canvas로 화면을 그리면 한 가지 어려움이 생깁니다. 화면 요소는 그대로 DOM에 남아 있기 때문에, 요소가 존재하는지나 눌리는지를 확인하는 자동 테스트는 모두 통과합니다. 정작 캔버스에 무엇이 칠해졌는지는 그 테스트들이 보지 않습니다. 실제로 2026년 8월에는 자동 테스트가 전부 통과하는 동안 실제 화면에서는 게임 보드가 깨져 보이는 일이 있었습니다.
그래서 캔버스에 그려진 결과를 직접 비교하는 테스트 페이지를 따로 만들었습니다.

화면에는 같은 타일 격자가 두 벌 있습니다. 왼쪽은 HTML-in-Canvas로 캔버스에 그린 것이고, 오른쪽은 똑같은 마크업을 평범한 DOM으로 둔 비교용입니다. 타일은 모두 같은 파란 바탕 위에 CSS 기능을 하나씩만 다르게 적용했습니다. 투명도, 3D 변환,
filter, backdrop-filter, 블렌드 모드, 마스크, 그림자, 텍스트, SVG, 이미지, 그리고 타일 안에 다시 넣은 2D 캔버스와 WebGL 캔버스 같은 것들입니다. 어떤 기능이 캔버스로 옮겨지는 과정에서 사라지면, 그 타일 하나만 오른쪽과 색이 달라집니다. 눈으로 봐도 바로 보이고, 페이지가 캔버스의 픽셀을 직접 읽어 기준색과의 차이를 숫자로도 남깁니다.격자의 첫 타일은 아무 효과도 없는 기본 타일입니다. 이 타일이 틀리게 나오면 특정 기능의 문제가 아니라 테스트 자체가 잘못된 것이므로, 다른 결과를 보기 전에 이 타일부터 확인합니다.
한 장이 그려지는 것과 계속 움직이는 것
처음 격자는 정지한 타일만 비교했습니다. 그런데 이 방식으로는 확인할 수 없는 문제가 있었습니다. 당시 Electron 앱에서 벚꽃 효과는 화면에 나타나기는 하는데 움직이지 않았습니다. 첫 장면은 제대로 그려지고, 그다음 갱신이 캔버스에 반영되지 않은 것이었습니다.
그래서 움직이는 타일을 따로 추가했습니다. CSS 애니메이션, 이미지, 2D 캔버스, WebGL 캔버스가 계속 바뀌도록 해 두고, 일정 시간 간격으로 그림을 비교해 실제로 픽셀이 변했는지를 봅니다. 여기에도 기준 타일이 있습니다. 일반 DOM으로 움직이는 타일이 변하지 않는다고 나오면 측정 방법이 잘못된 것이므로, 그 타일이 움직인다는 것을 먼저 확인한 다음에야 다른 타일이 멈췄다고 판단합니다.
함께 기록하는 값도 정했습니다. 그리기 함수가 몇 번 호출되었고 몇 번 실패했는지를 결과 옆에 같이 남깁니다. 함수가 호출되었다는 것과 그림이 실제로 그려졌다는 것은 다른 사실이기 때문입니다.
이 격자로 확인한 것
2026년 8월에 이 격자를 Chromium 버전별로 돌려 보니 차이가 분명하게 나왔습니다.
- 당시 출시 빌드의 Chromium 148에서는
backdrop-filter가 걸린 요소를 만나면 그 뒤에 그려야 할 내용이 통째로 사라졌습니다. 정지 타일 33개 중 15개만 제대로 그려졌습니다. 게임에서 보드 가운데가 비어 보였던 증상이 바로 이 모양이었습니다. 중첩한 2D·WebGL 캔버스는 첫 장면만 그려지고 이후에는 멈춰 있었습니다.
- Chromium 152를 쓰는 Electron 44에서는 정지 타일 33개가 모두 맞게 그려졌고, 움직이는 타일도 모두 갱신되었습니다.
이 결과가 Electron 44 전환 이후 HTML-in-Canvas를 다시 시험해 볼 근거가 되었습니다.
위 스크린샷은 이 8월 검증 수치와 구분해서 볼 필요가 있습니다. CSS 기능을 적용한 타일은 대체로 오른쪽과 비슷하게 그려졌지만,
backdrop-filter 타일의 가장자리처럼 차이가 남아 있는 부분도 있습니다. 타일 안에 넣은 캔버스 여섯 개(2D 캔버스 세 종류, WebGL, 움직이는 2D, 움직이는 WebGL)는 왼쪽에서 모두 비어 있습니다. 캐릭터 초상과 주사위는 WebGL 캔버스이고 벚꽃은 2D 캔버스입니다. 다음 절에서 다룰, HTML-in-Canvas를 켰을 때 초상이 비어 보였던 현상과 같은 쪽을 가리키는 결과입니다. 다만 이 격자는 어떤 기능이 빠지는지를 보여줄 뿐 그 원인까지 알려주지는 않습니다.2026년 10월 추가 검증: 정상 렌더링 루프와 빈 초상
Electron 45.1.0을 검증하면서 HIC도 다시 확인했습니다. Apple M4 환경에서 테스트한 macOS 빌드는 HIC를 켜면 캐릭터 초상과 중첩된 캔버스 콘텐츠가 빈 화면으로 나왔습니다.
낮은 수준의 확인 결과 중에는 정상인 것도 있었습니다. 초상의 WebGL 컨텍스트는 존재했고, 컨텍스트가 유실됐다는 상태도 아니었습니다. HIC의 렌더링 루프도 돌고 있었습니다. 그렇다고 초상이 화면에 그려졌다는 뜻은 아니었습니다.
실제 출력 화면을 확인하는 검사가 이 실패를 잡았습니다. API가 있는지, 컨텍스트가 만들어지는지, 그리기 호출이 계속되는지는 질문의 일부에만 답합니다. 게임에서는 캐릭터가 화면에 보여야 합니다.
이번 재검증으로 확인한 것은 해당 구성에서 렌더링이 실패한다는 사실입니다. 근본 원인이 Chromium에 있는지, 제 사용 방식에 있는지까지 가려낸 것은 아닙니다.
같은 달 30일 기준 상태
블로샤퍼는 Electron 45.1.0으로 올라갔습니다. HIC는 기본적으로 꺼진 실험 옵션으로 남아 있고, 렌더링 문제도 아직 열려 있습니다.
화질상의 이점은 계속 살펴볼 이유가 됩니다. 하지만 캐릭터 초상이 비어 버릴 수 있는 경로를 모든 플레이어에게 기본으로 제공할 근거는 되지 못합니다.
당분간 기본값은 기존 렌더러입니다. 다음에 다시 비교할 때도 연출 조건을 맞추고, 실제 게임 화면을 확인하고, 무엇을 바꿔서 결과가 달라졌는지 설명할 수 있어야 합니다.
HIC 구현은 다음에 다시 시험할 수 있도록 게임에 남겨두었습니다. 플레이어가 기본으로 사용하는 경로는 아닙니다.