이 글은 Today I Learn 시리즈의 103번째 기록입니다. (총 125개)

악보 파일(MusicXML — 악보 프로그램끼리 음표·박자·가사를 주고받는 표준 형식)을 읽어 화면에 그리고 그걸 투명 영상으로 뽑는 데까지 하루에 갔다. 기능 목록으로 보면 셋이지만, 견적을 잘못 잡을 뻔한 지점이 둘 있었다.


남이 정한 형식을 받는 기능은 견적을 두 배로 잡는다

“MusicXML을 읽는다”는 한 줄짜리 기능처럼 보인다. 실제로는 그 형식을 만든 사람들이 오랫동안 쌓아 둔 규칙을 따라가는 일이다.

이번에 걸린 것만 봐도 — 파일 안에서 시간이 앞으로만 흐르지 않고(피아노 두 손을 겹쳐 적으려고 되감는다), 길이가 초가 아닌 자체 단위(divisions — 4분음표 하나를 몇 칸으로 쪼갤지 파일마다 정해 두는 값)로 적혀 있고, 같은 시각에 울리는 음을 따로 표시한다. 하나라도 놓치면 소리는 나는데 박자가 통째로 밀린다.

여기서 가져갈 판단은 두 가지다.

  • 표준 파일을 받는 기능은 “읽어서 화면에 뿌린다”가 아니라 “그 형식의 규칙을 구현한다”로 본다. 견적도 그렇게 잡는다.
  • 대신 그 값을 한 번만 치른다. 읽는 쪽에서 형식의 별난 점을 전부 흡수해 우리 말로 바꿔 넘기면, 나머지 코드는 그 형식을 몰라도 된다. 흡수를 미루면 그 별난 점이 프로젝트 전체에 번진다.

손으로 만든 테스트 파일로만 확인한 것도 위험했다. 실제 악보 프로그램이 내보낸 파일을 열자 그제야 안 맞는 게 드러났다. 남의 형식은 남이 만든 실물로 확인해야 한다.


배경이 투명한 결과물은 만드는 내내 값을 물린다

이 도구의 결과물은 배경이 없는 영상이다. 그래야 연주 영상 위에 얹힌다. 그런데 배경이 없다는 건 만드는 과정 내내 제약이 따라온다는 뜻이었다.

가장 뚜렷한 예 — 화면 왼쪽에 고정해 둔 기호 위로 음표가 지나가 겹쳤다. 보통이라면 그 자리를 배경색 사각형으로 덮으면 끝이다. 여기서는 못 한다. 흰 사각형으로 덮으면 영상에 흰 판이 남고, 검은 사각형이면 검은 판이 남는다. 투명한 결과물에서 “가리기”는 덮기가 아니라 지우기여야 한다.

이런 게 한 곳이 아니었다. 반투명한 부분의 색이 저장 방식에 따라 달라지는 문제도 있었고(premultiplied alpha, 미리 곱한 알파 — 그림 도구는 색 값에 투명도를 미리 곱해 들고 있는데, 영상 형식은 곱하기 전 값을 받는다), 압축 방식 선택지도 좁아졌다(투명도 채널을 담을 수 있는 코덱이 몇 안 된다).

판단으로 남길 것은 이것이다. 투명 배경은 결과물의 한 속성이 아니라 프로젝트 전반에 붙는 제약이다. 그 제약을 감수할 가치가 있는지는 처음에 정해야 하고, 정했으면 곳곳에서 값을 치를 각오를 한다. 우리는 감수하기로 했다 — 배경 없는 소재가 이 도구의 존재 이유다.


빠른 길을 찾으면 결과가 같은지부터 확인한다

느린 부분(미리 곱한 알파를 곱하기 전 값으로 되돌리는 계산)을 FFmpeg(영상을 인코딩·변환하는 명령줄 도구)의 필터에 맡겼더니 1.6배 빨라졌다. 그런데 결과물을 열어 값을 확인해 보니 색이 달랐다. 빠른 게 아니라 다른 일을 하고 있었다.

눈으로는 알아채기 어려운 종류였다. 반투명한 부분만 조금 어두워지는 거라, 속도만 보고 채택했으면 그대로 계속 뽑았을 것이다.

그래서 규칙 하나를 세웠다. 빨라졌다고 좋아하기 전에 “결과가 같은가”를 먼저 확인한다. 눈으로 확인하기 어려운 값(투명도·색)일수록 숫자로 대조한다. 결국 원래 방식을 여러 코어에 나눠 1.8배를 벌었고, 그건 결과가 완전히 같은지 확인한 뒤에 채택했다.


요약

  • 표준 파일을 받는 기능은 “읽기”가 아니라 “그 형식의 규칙 구현”이다. 견적을 그렇게 잡는다
  • 형식의 별난 점은 읽는 쪽에서 한 번에 흡수한다. 미루면 프로젝트 전체로 번진다
  • 남의 형식은 남이 만든 실물 파일로 확인한다. 직접 만든 예제는 만든 쪽의 가정만 확인해 준다
  • 투명 배경은 결과물의 속성이 아니라 프로젝트 전반의 제약이다. 감수할 값인지 처음에 정한다
  • 빨라진 길은 결과가 같은지부터 대조한다. 눈에 안 보이는 값일수록 숫자로 본다

Series: Today I Learn

1 C++ 자료형(Data Type) 2 MD5 vs pHash 3 C++에서 함수의 선언과 정의 4 Tkinter padx, pady 5 메모리와 포인터 변수 6 Call by Value, Call by Reference, Call by Pointer 비교 7 const 8 Gemfile — Jekyll 프로젝트의 의존성 파일 9 kramdown-parser-gfm — Jekyll의 GFM 파서 10 파서(Parser) 11 AHU vs OHU 12 I might try it vs I'll try it 뉘앙스 차이 13 SESSION_EXPIRE_AT_BROWSER_CLOSE=True 14 configuration key 15 Git stash vs discard 16 subprocess.Popen으로 Windows 탐색기에 명령어를 전달 17 Post 잔디 분석하기 18 Google Sheets Sync 최적화 19 DSL (Domain Specific Language)과 GPL (General Purpose Language) 20 마크다운 표 그리는 방법 21 쿼리 파라미터(Query Parameter). 기존 QR코드 재활용 22 Django 보안 취약점 점검 및 수정 23 OOP Object-Oriented Programming 객체 지향 프로그래밍 24 Fernet 대칭 암호화 25 Jekyll 코드블록 안의 Liquid 태그 26 insertOnConflictUpdate vs DoUpdate(target) 27 세션 필터 28 아코디언(Accordiaon) UI를 펼친상태로 만들기 29 input의 step 30 Word Cloud 31 Google Sheets를 데이터 버스로(with AppSheet) 32 Django 모델 텍스트 필드 자동 수집 패턴 33 localStorage로 섹션 토글 상태 유지 34 순차 ID 생성(`select_for_update()` + `max()` 조합) 35 역참조 검색과 distinct() 36 xlsx 다운로드와 로딩 오버레이 충돌 37 Android 파일 공유 MIME 타입 38 AssetManifest — Flutter 빌드 타임 asset 목록 런타임 조회 39 UTF-8 BOM과 PowerShell 파일 쓰기 40 소리꽃 KeyBloom TIL 1 41 소리꽃 KeyBloom TIL 2 42 소리꽃 KeyBloom TIL 3 43 메트로놈 Simple Metronome TIL 1 44 소리꽃 KeyBloom TIL 4 45 메트로놈 Simple Metronome TIL 2 46 소리꽃 KeyBloom TIL 5 47 메트로놈 Simple Metronome TIL 3 48 정적 블로그 SEO 정비와 Pagefind 검색 도입 49 메트로놈 Simple Metronome TIL 4 50 안드로이드 AudioTrack 연속 재생, 실측 피커 정렬, 카메라 토치 플래시 51 메트로놈 Simple Metronome TIL 5 52 모래게임 Sandrop TIL 1 53 메트로놈 Simple Metronome TIL 6 54 모래게임 Sandrop TIL 2 55 모래게임 Sandrop TIL 3 56 메트로놈 Simple Metronome TIL 7 57 모래게임 Sandrop TIL 4 58 모래게임 Sandrop TIL 5 59 모래게임 Sandrop TIL 6 60 소리꽃 KeyBloom TIL 6 61 모래게임 Sandrop TIL 7 62 모래게임 Sandrop TIL 8 63 소리꽃 KeyBloom TIL 7 64 모래게임 Sandrop TIL 9 65 소리꽃 KeyBloom TIL 8 66 모래게임 Sandrop TIL 10 67 소리꽃 KeyBloom TIL 9 68 소리꽃 KeyBloom TIL 10 69 소리꽃 KeyBloom TIL 11 70 소리꽃 KeyBloom TIL 12 71 소리꽃 KeyBloom TIL 13 72 온실 GreenHouse TIL 1 73 소리꽃 KeyBloom TIL 14 74 온실 GreenHouse TIL 2 75 소리꽃 KeyBloom TIL 15 76 소리꽃 KeyBloom TIL 16 77 소리꽃 KeyBloom TIL 17 78 소리꽃 KeyBloom TIL 18 79 소리꽃 KeyBloom TIL 19 80 소리꽃 KeyBloom TIL 20 81 로그스톤 상표 셀프 출원 TIL 1 82 소리꽃 KeyBloom TIL 21 83 소리꽃 KeyBloom TIL 22 84 소리꽃 KeyBloom TIL 23 85 소리꽃 KeyBloom TIL 24 86 MiniMacro TIL 1 87 Astro가 무엇인지, 왜 옮기는지 88 MiniMacro TIL 2 89 메트로놈 Simple Metronome TIL 8 90 메트로놈 Simple Metronome TIL 9 91 블로그 Astro 이관 TIL 92 오픈데이 Openday TIL 1 93 오픈데이 Openday TIL 2 94 Unreal Engine MCP TIL 1 95 콘티온 Conti On TIL 11 96 오픈데이 Openday TIL 3 97 오픈데이 Openday TIL 4 98 오픈데이 Openday TIL 5 99 ScorePlayer TIL 1 100 BuildingHub TIL 1 101 ScorePlayer TIL 2 102 BuildingHub TIL 2 103 ScorePlayer TIL 3 읽는 중 104 Unreal Engine MCP TIL 2 105 궁 미로 PalaceMaze TIL 1 106 메트로놈 Simple Metronome TIL 10 107 메트로놈 Simple Metronome TIL 11 108 오픈데이 Openday TIL 6 109 BuildingHub TIL 3 110 Obsidian vault에서 코드만 빼기 — directory junction 111 ScorePlayer TIL 4 112 오픈데이 Openday TIL 7 113 URL은 바뀔 수 있는 것에 묶지 않는다 114 도구는 기능이 아니라 내 일에 맞는지로 고른다 115 돌이키기 힘든 변경은 작게 먼저 확인한다 116 궁 미로 PalaceMaze TIL 3 117 궁 미로 PalaceMaze TIL 2 118 소리꽃 KeyBloom TIL 29 119 오픈데이 Openday TIL 8 120 BuildingHub TIL 4 121 ScorePlayer TIL 5 122 BuildingHub TIL 5 123 MiniMacro TIL 3 124 소리꽃 KeyBloom TIL 30 125 궁 미로 PalaceMaze TIL 4