ANALOG SOUL DSP ENGINE — 문서 색인

주제	공식 매뉴얼	쉬운 말	기술 설명서	사양서	논고
시작·기본 조작	사용 5단계	시작하기	처음 10분	—	—
화면 구성	모니터링 도구	화면 살펴보기	화면 읽는 법	—	—
처리 순서	처리 체인	순서의 이유	신호가 흐르는 길	배치 근거	해석 틀
입력 게인	INPUT GAIN	INPUT GAIN	입력 게인	게인 스테이징	—
모듈 전반	MODULE 01~	여덟 기능	모듈 하나하나	처리 단 사양	—
포화·왜곡	VACUUM TUBE	—	VACUUM TUBE	전달 함수	체비쇼프 전개
대역 분할	SOUNDGOODIZER	—	SOUNDGOODIZER	LR4 구성	전역통과 정리
다이내믹스	MASTERING	—	MASTERING	4대역 압축	시정수 하한
공간·잔향	DOLBY ATMOS	—	DOLBY ATMOS	IR 구성	에코 밀도
스테레오 폭	STEREO WIDTH	—	STEREO WIDTH	M/S 처리	양이 상관도
복원 개요	HD RESTORATION	잘려나간 소리	무엇을 하는가	압축의 흔적	SBR 비교
컷오프 탐지	—	—	알고리즘 해부	판정 임계	추정량
배음 전사·위상	동작 원리	—	배음 옮겨쓰기	차수별 레벨	위상 배수 사상
평활·교차	SMOOTH	—	SMOOTH	가우시안 커널	교차 규칙
LIVE 모드	LIVE 미리듣기	미리 들어보기	LIVE 모드	—	추정 가능성
청감 한계	—	솔직하게	정말 들리는가	가청 상한	융합과 분리
스펙트럼 분석기	A/B·스펙트로그램	그림으로 보기	분석기	계측과 판독	표시 양자화
프리셋	설정 보관	—	—	—	—
내보내기	3가지 포맷	파일로 저장	내보내기	운용 지침	—
앨리어싱	—	—	—	잔류량 산정	임계 차수
레벨 정합	—	—	—	RMS 매칭	K-가중 편향
문제 해결	활용 팁	문제가 생기면	문제 해결	—	그래프 수명주기
알려진 한계	개정 내역	—	알려진 제한	사양상 한계	수치적 고려
용어	—	용어 풀이	용어 사전	—	참고문헌

공식 매뉴얼 — 전 모듈 레퍼런스 쉬운 말 — 전제 없음 기술 설명서 — 오디오 기초 사양서 — 신호 처리 논고 — 박사급

SECTION 04

개정 기록

판별 변경 내역입니다. 각 항목의 근거는 사양서 또는 논고의 해당 절에 있습니다.

v2.4 — 현재 판

설정을 보관하고 다시 불러오는 경로를 만든 판입니다. 문서 묶음의 이동 구조와 이탈 보호도 함께 정리했습니다.

항목	내용
프리셋 저장·불러오기	화면 설정 전체를 `.json` 파일로 내보내고 되돌립니다. 슬라이더 50개, 토글 10개, 모듈 순서, SG 모드, ATMOS 씬이 담기며 음원은 포함하지 않습니다.
빠른 슬롯 4개	브라우저에 남는 즉석 보관함. 짧게 누르면 불러오고 0.6초 길게 누르면 현재 설정을 덮어씁니다. 내용이 있는 슬롯은 초록으로 표시됩니다.
빈 슬롯 → 기본값	비어 있는 슬롯을 누르면 모든 값이 기본값으로 돌아갑니다. 마크업의 default 속성을 기준으로 삼아 초기 상태를 정확히 복원하며, 음원은 그대로 남습니다.
슬롯 복사	복사를 누른 뒤 원본과 대상 슬롯을 차례로 누르면 옮겨집니다. 대상에 내용이 있으면 덮어썼다고 결과에 명시합니다.
한 슬롯 비우기	버튼을 누른 뒤 슬롯을 고르면 그 슬롯만 지워집니다. 복사·비우기·저장 모드는 항상 하나만 켜집니다.
모든 슬롯 비우기	되돌릴 수 없는 동작이라 두 단계로 나눴습니다. 처음 누르면 버튼이 정말 지울까요?로 바뀌고, 6초 안에 다시 누르면 실행됩니다.
슬롯 일괄 백업	네 슬롯을 한 파일로 묶어 내보냅니다. 빈 슬롯은 `null`로 기록해 위치까지 그대로 복원됩니다.
불러오기 자동 판별	파일의 `format` 필드를 읽어 설정 파일이면 지금 값에 적용하고 슬롯 백업이면 슬롯을 되돌립니다. 사용자가 종류를 고를 필요가 없습니다.
드래그 앤 드롭	프리셋 패널에 파일을 끌어다 놓아도 같은 경로로 처리됩니다. 드래그가 올라오면 테두리 색으로 놓을 자리를 알립니다.
패널 내 피드백	상태바가 EXPORT 아래에 있어 프리셋 조작 결과가 화면 밖이었습니다. 패널 안에도 같은 메시지를 띄우고 성공·주의·오류를 색으로 구분합니다.
이탈 확인	값을 바꾼 뒤 다른 문서로 나가려 하면 확인 창이 뜹니다. 새로고침·탭 닫기는 브라우저 기본 경고로 처리합니다.
공통 상단 툴바	문서마다 다른 클래스와 색을 쓰던 이동 바를 하나로 통일했습니다. 문서 테마와 무관한 고정 팔레트를 써서 어디서나 같은 모습입니다. 프로그램에도 추가해 문서로 돌아올 수 있습니다.
목차 겹침 보정	사양서·논고·기술 설명서의 좌측 목차가 툴바 아래로 파고들던 문제. 레일 위치와 높이를 툴바 높이만큼 보정했습니다.
탭 전환 스크롤	브라우저의 스크롤 자동 복원 때문에 문서를 옮기면 중간 위치에 떨어졌습니다. 복원을 끄고 맨 위에서 시작하도록 했으며, `scroll-behavior:smooth`가 이동을 취소하던 문제도 함께 잡았습니다.
앵커 여백	딥링크로 이동하면 목표 지점이 툴바에 가려 첫 줄이 안 보였습니다. `scroll-margin-top`으로 툴바 높이만큼 띄웁니다.
로컬 진입점	`index.html`을 만들어 폴더에서 바로 열 수 있게 했습니다. `file:`로 열리면 문서 간 링크가 같은 폴더 파일을 가리키도록 자동 전환됩니다.
중복 색인 제거	내용이 같은 색인이 두 벌이라 어느 쪽에서 들어왔느냐에 따라 다른 파일에 도착했습니다. `index.html` 하나로 합쳤습니다.
색인 UI 통일	색인의 디자인 언어를 공식 매뉴얼과 같게 맞췄습니다. 폰트·색 토큰·컴포넌트를 공유합니다.
매뉴얼 v2.3 갱신	공식 매뉴얼 본문에 LIVE 미리듣기, 모듈별 입력 게인, A/B 스펙트럼과 스펙트로그램, X-AXIS 고정, 구현된 세 파라미터를 반영했습니다.
버튼 라벨 정리	화면 설정 저장 · 모든 슬롯을 백업 · 불러오기 · 한 슬롯 비우기 · 모든 슬롯 비우기로 이름을 명확히 했습니다.

v2.3

문서를 쓰면서 구현 코드를 읽다 발견해 고친 것과, 그 과정에서 새로 넣은 것들입니다.

항목	내용
모듈별 INPUT GAIN	여덟 모듈 전부에 −24~+24dB 입력 게인 추가. 모듈이 꺼지면 게인도 체인에서 빠집니다.
HD/UHD LIVE 미리듣기	내보내기 전에 복원 결과를 재생. 전체를 미리 복원해 캐시하고 그 버퍼를 재생합니다.
A/B 좌우 스펙트럼	원음과 적용본을 나란히 표시. 원음은 모든 모듈 진입 직전에서 분기합니다.
스펙트럼 dB 눈금	세로축에 10dB 간격 −30~−100dB 눈금. 넓은 화면에서 읽기 쉽도록 숫자를 가로로 네 번 반복.
스펙트로그램 전환	그래프 클릭으로 시간–주파수 표시 전환. 약 8.7초 이력, 무지개 음압 컬러맵.
X-AXIS 범위 고정	순응·48·96·192 4단 스위치. 고정하면 LIVE를 켜고 꺼도 같은 자리끼리 비교됩니다.
데이터 없는 구간 표시	고정 범위가 실제 나이퀴스트보다 넓으면 경계에 점선을 긋고 그 오른쪽을 어둡게 덮습니다.
브릭월 세이프티 클리퍼	체인 최종단 추가. 천장의 85% 아래는 완전 선형, 그 위는 1.0에 점근해 천장을 넘지 않습니다.
MASTER STEREO WIDTH	값만 있고 처리가 없었습니다. M/S 분해 후 사이드에 폭 계수를 곱해 재합성. 배치는 리미터 뒤.
VINYL WOBBLE	미구현이었습니다. 가변 지연을 와우 0.556Hz와 플러터 4.2Hz로 변조. 최대 피치 편차 ±0.31%.
VINYL CROSSTALK	미구현이었습니다. 채널 교차 합산으로 최대 −9.1dB 누설. 합산 보정으로 레벨은 불변.
SMOOTH	복원 함수에 전달만 되고 쓰이지 않았습니다. 가우시안 커널 반경 1~4와 적용 비율을 제어하도록 연결.
AIR MIX 개명	실제로는 평활을 제어하므로 UHD 쪽 라벨을 SMOOTH로 변경.
SG STEREO	스테레오 폭이 아니라 압축기 릴리즈만 바꾸고 있었습니다. 실제 M/S 폭 조절로 교체, 릴리즈는 200ms 고정.
재생·내보내기 순서 불일치	드래그 순서가 내보내기에만 반영되고 재생은 고정 순서였습니다. 양쪽 모두 DOM 순서를 읽도록 통일.
재생 중 순서 변경	순서를 바꾸면 재생 위치를 유지한 채 체인만 교체되도록 연결.
배음 전사 위상 누락	원본 위상을 그대로 복사해 프레임 간 정합이 깨져 있었습니다. 차수만큼 배수하도록 수정.
SG 커브가 순수 기함수	짝수 배음이 풍부하다는 주석과 달리 2차가 −68.6dB. 동작점 이동을 넣어 −28.9dB로 조정.
직류 오프셋 누출	비대칭 포화의 직류를 막는 고역 통과가 없었고 마스터 저역 밴드가 저역 통과라 출력까지 도달. 12Hz 차단기 삽입.
SG 비상보 대역 분할	LPF+BPF+HPF 병렬이라 합이 0.906~1.568로 흔들렸습니다. Linkwitz-Riley 4차로 교체해 전 대역 1.000.
포화 앨리어싱	웨이브셰이퍼 전부 4배 오버샘플링, 포화 전 sr/3 대역 제한 추가. 시작 차수 7차→10.5차, 잔류 약 −80dBFS.
ATMOS IR 중복	초기 반사와 후기 잔향이 같은 IR을 두 번 컨볼브했습니다. 각각 다른 응답으로 분리해 연산량도 감소.
LFO 누적	재생마다 새로 만든 와우 오실레이터가 정지되지 않고 쌓였습니다. 정지 시 함께 정리.
복합 블록 연결 해제	체인 재구성 시 블록 내부 배선까지 끊어 망가지던 문제. 바깥으로 나가는 출력만 끊도록 수정.
192kHz 내보내기 실패	미사용 컨텍스트 생성이 try 밖에 있어 예외 시 잠금이 풀리지 않았습니다. 구조 재정비 + 사전 점검 추가.
WAV 인코딩 지연	샘플마다 getChannelData를 호출해 192kHz에서 9200만 회. 채널 배열을 루프 밖으로 이동.
대용량 다운로드 취소	revokeObjectURL을 즉시 호출해 저장 시작 전에 URL이 사라졌습니다. DOM 부착 후 해제를 지연.
메모리 피크	렌더 완료 후 리샘플 버퍼 참조를 끊어 GC 대상이 되게 하고, 예상 용량이 한계를 넘으면 사전에 차단.
원본 샘플레이트 미보존	디코딩이 장치 기준으로 리샘플했습니다. WAV·FLAC·OGG·MP3·MP4 헤더를 직접 읽어 그 레이트로 디코딩.
게시 환경 저장	온라인 페이지에서도 내보내기 동작. wav가 허용 확장자가 아니라 무압축 zip으로 감싸 전달합니다.
기본 모듈 순서	COMP → BBE → TUBE → EXCITER → SG → VINYL → ATMOS → MASTER로 재배치. 레벨 정리 후 색을 입히는 순서.
진행 로그 표시	내보내기 오버레이 로그를 4.5줄로 조정하고 마지막 줄이 그라데이션으로 사라지도록 수정.
죽은 데이터 정리	SG 프리셋의 loQ·hiQ와 ATMOS 씬의 roomSize가 한 번도 읽히지 않아 제거.
문서 다섯 종	쉬운 말 설명서·기술 설명서·신호 처리 사양서·개발자 논고를 새로 작성하고 공식 매뉴얼을 v2.3으로 갱신.
통합 색인	23개 주제를 다섯 문서의 해당 절로 연결하는 상호 참조 표와 목적별 독서 경로를 신설.
공통 상단 툴바	전 문서에 동일한 툴바를 넣어 어디서나 오갈 수 있게 하고, 로컬 폴더에서는 상대 경로로 자동 전환.

v2.2 — 최초 판

여덟 개 처리 모듈과 HD/ULTRA HD 복원, 드래그 순서 변경, 기본 스펙트럼 표시를 갖춘 판입니다. v2.3에서 고친 항목들은 이 판에 존재하던 것입니다.