선을 픽셀에 맞추기: 가는 선과 굵은 선이 어긋나는 까닭
2026-10-13에 접기 영역의 테두리를 그리다 나온 것을 정리한다. 메인테이너가 그림을 보고 두 번 짚었다: “왼쪽과 오른쪽의 틈이 크기가 달라보입니다”, “왼쪽 가장 바깥 외곽선이 삐둘빼툴합니다”. 둘 다 같은 까닭이었다.
선은 좌표의 양쪽으로 반씩 퍼진다
SVG에서 선의 굵기(stroke-width)는 좌표를 가운데에 두고 양쪽으로 반씩 퍼진다.
x = 10에 굵기 1px의 세로선을 그으면 선은 9.5에서 10.5까지를 차지한다.- 화면의 픽셀은 9
10, 1011처럼 정수에서 정수까지다. 그래서 이 선은 픽셀 두 줄에 반씩 걸친다.
브라우저는 이것을 둘 중 하나로 그린다.
| 방법 | 결과 |
|---|---|
| 그대로 그린다 (기본값) | 두 픽셀 줄을 절반의 진하기로 칠한다. 선이 흐릿하고 2px처럼 보인다 |
한쪽으로 민다 (shape-rendering="crispEdges") | 한 픽셀 줄만 또렷하게 칠한다. 어느 쪽으로 밀지는 브라우저가 정한다 |
프로토타입은 둘째 방법을 쓰고 있었다. 가는 선만 있을 때는 모든 선이 같은 쪽으로 밀려서 문제가 드러나지 않았다.
굵기가 다른 선이 만나면 어긋난다
굵기 3px의 테두리를 같은 자리에 더하자 어긋났다.
- 1px 선(가운데
x)은x - 0.5~x + 0.5이고, 왼쪽으로 밀려 픽셀x - 1에 그려졌다. - 3px 선은 블록 안쪽에 두려고 가운데를
x + 1.5에 두었다.x~x + 3이라 픽셀에 딱 맞고 밀리지 않는다.
그래서 가는 선은 x - 1에서, 굵은 테두리는 x에서 시작했다. 위에서 아래로 내려가며 보통 블록(가는 선)과 접기 영역(굵은 테두리)이 번갈아 나오니 왼쪽 바깥 선이 1px씩 들쭉날쭉했다.
“틈이 달라 보인다”도 같은 일이다. 접기 영역의 바탕에 두른 가는 선이 왼쪽으로 밀려 왼쪽 틈(1px)을 메웠고, 오른쪽 틈은 비어 있었다.
고친 방법: 그림 전체를 반 픽셀 옮긴다
밀리는 쪽을 브라우저에 맡기지 않고, 처음부터 픽셀에 맞게 그린다.
<g transform="translate(.5 .5)">
<!-- 모든 블록 -->
</g>- 이제 가운데가
x인 1px 선은 실제로x~x + 1을 차지한다. 픽셀 한 줄에 딱 맞는다. - 3px 테두리는 가운데를
x + 1에 둔다. 실제로x~x + 3이다. 가는 선과 같은 픽셀 줄에서 시작한다. - 겹친 테두리는
x + 4에서 시작한다. 바깥 테두리(3px)와의 사이에 정확히 1px이 빈다.
바탕과 이름 띠처럼 선 없이 칠만 하는 것은 반 픽셀을 거꾸로 당겨(x - 0.5) 픽셀 경계에 맞췄다.
배율이 정수가 아니면 1px 선이 1칸 또는 2칸이 된다 (2026-11-22)
웹 베타에서 메인테이너가 “외곽선이 두껍게 나오는 경우가 있음”이라고 신고했다. 앱을 110%로 키우니 “확대를 하니 더 많이 생기네요”.
- 화면의 실제 배율은 앱 확대 ×
devicePixelRatio(브라우저 확대 · Windows 디스플레이 배율)다. 110%이면 1px 선은 1.1 화면 픽셀이 된다. shape-rendering="crispEdges"는 선의 양쪽 가장자리를 각각 가장 가까운 화면 픽셀로 반올림한다. 1.1칸짜리 선은 놓인 자리에 따라 1칸이 되기도 2칸이 되기도 한다. 그래서 같은 굵기의 선이 섞여 보인다.- 고친 방법: 화면에서만 선 굵기를
max(1, round(w × 배율)) / 배율로 바꾼다. 화면 픽셀의 정수배인 선은 어디에 놓여도 같은 칸 수로 반올림된다. 대각선은 계단이 생기지 않게 그대로 둔다. - 좌표를 화면 픽셀에 맞추는 길도 있지만, 그 값은 캔버스의 화면 위치와 스크롤에 따라 달라져서 굵기를 맞추는 쪽을 골랐다.
- 배율이 바뀔 때(모니터를 옮기면
devicePixelRatio가 바뀜)는matchMedia('(resolution: …dppx)')의 change로 알 수 있다.
알아 둘 것
- 이것은 100% 크기에서만 맞는다. 화면을 확대·축소하면 좌표에 배율이 곱해져 다시 픽셀 사이에 걸칠 수 있다. 제품에서는 배율을 곱한 뒤에 픽셀에 맞추는 계산이 필요하다.
- 고해상도 화면(Retina 등)은 사정이 낫다. CSS의 1px이 실제 픽셀 2~3개라서 반 픽셀도 실제 픽셀 하나에 맞는다.
- 저장되는 SVG에도 같은 옮김이 들어간다. 화면 그대로 저장하기 때문이다. 다른 프로그램에서 열어도 선이 또렷하다.
- 그림 위에 겹쳐 그리는 것도 그 옮김을 따라야 한다. 그림을 반 픽셀 옮기면 상자의 오른쪽 · 아래 선은 상자 바깥 1px에 놓인다. 선택 테두리처럼 그 위에 겹치는 표시가 옮기지 않은 상자 안에만 그리면 오른쪽 · 아래만 선이 삐져나와 보인다(2026-11-03, BUG-07 → defects).
- 키워서 봐야 보인다. Claude는 그림을 네 배로 키워 찍고서야 어긋남을 보았다. 메인테이너는 보통 크기에서 눈으로 알아챘다.
관련: 텍스트 폭을 재는 문제는 8. 위험과 검증이 필요한 사항에 있다. 그것도 “화면마다 조금씩 다르게 그려진다”는 같은 뿌리의 문제다.