빛과소금 MP3 악보 스튜디오 1.1.0 · 피아노 다중 음정 기능.

이번 버전에서 바꾼 핵심.
- 분석 엔진: 피아노 단독 음원에 Basic Pitch 1.0.1 신경망을 사용합니다.
  보컬 한 줄을 분석하는 MELODIA/YIN-FFT 경로와 별도입니다.
- 저장 구조: 음표마다 독립적인 시작 박, 길이, 음 높이, 강세, 배치할 오선을 보관합니다.
  같은 시각에 여러 음이 시작하거나, 길이가 다른 음이 겹쳐도 유지합니다.
- 악보: 높은음자리와 낮은음자리 두 오선을 만들고 화음·여러 성부·쉼표·마디 넘김 이음줄로 저장합니다.
- MIDI: 메타 정보와 위/아래 오선의 별도 음표 트랙을 사용합니다. 동시 음과 독립적인 끝 시각을 유지합니다.

설치.
1. 워드프레스 플러그인 업로드에서 새 ZIP을 선택하고 기존 플러그인을 교체합니다.
2. 페이지/브라우저 캐시를 비운 뒤 Ctrl+F5로 새로고침합니다.
3. 기존 숏코드 [lightsalt_mp3_score]를 그대로 사용합니다. 피아노가 기본 선택된 페이지는 [lightsalt_mp3_score mode="piano"]를 넣습니다.
4. 먼저 피아노 화음 예제를 눌러 두 오선이 나타나는지 확인합니다.

실제 피아노 파일 분석.
1. 원곡 MP3 / WAV 칸에 피아노만 있는 파일을 넣습니다.
2. 음원 유형에서 피아노 단독 · 다중 음정을 선택합니다.
3. 처음에는 길이10~30초로 확인합니다. 기본300초(5분), 파일200MB 제한을 유지합니다.
4. BPM을 알고 있다면 BPM 기준을 직접 입력한 BPM 사용으로 바꿉니다.
5. 박자와 조표를 선택합니다. BPM/조표 자동 후보도 쓸 수 있지만 정답으로 확정하지 않습니다.
6. 기본 박자 정렬은16분음표입니다. 원곡 리듬에 맞춰8분/셋잇단음표 등을 선택합니다.
7. 인식 민감도는 보통부터 시작합니다. 음이 빠지면 높음, 추가 음이 많으면 낮음을 시험합니다.
8. 오선 나누기 기준은 기본C4입니다. 기준보다 낮으면 아래 오선, 같거나 높으면 위 오선에 넣습니다.
9. 멜로디 분석 시작 버튼으로 분석합니다. 진행 중 분석 취소를 누를 수 있습니다.
10. 결과의 피아노롤과 악보 음 듣기로 화음과 겹침음을 확인합니다.

중요한 입력 구분.
이 버전은 원곡에서 피아노만 분리하는 자동 악기 분리 기능을 포함하지 않습니다.
보컬·기타·현악기가 섞인 파일을 넣으면 그 악기의 음도 인식할 수 있습니다.
보컬을 제거한 반주 전체도 피아노 단독 파일은 아닙니다.
별도로 분리한 피아노 파일 또는 피아노 연주만 있는 녹음을 사용하세요.
피아노 모드에서는 보컬 입력칸의 파일을 분석 대상으로 쓰지 않습니다.
음역은 모델의88건반(A0~C8)을 사용하며, 기존 보컬용 최저음/최고음 선택은 사용하지 않습니다.

피아노 편집.
- 피아노롤에서 같은 가로 위치의 여러 막대는 동시에 울리는 음입니다.
- 초록색은 위 오선, 보라색은 아래 오선, 선택한 음은 노란색입니다.
- 막대를 클릭하거나 음표 목록의 행을 선택합니다.
- 음 이름, 길이(박), 시작(박), 배치할 오선, 강세(1~127)를 수정하고 선택 음 수정을 누릅니다.
- 시작 시각과 길이는 각각 따로 바뀝니다. 다른 음을 뒤로 밀지 않습니다.
- 피아노 모드에서 음 추가는 선택한 음과 같은 시점에 새 음을 넣습니다. 수정해서 화음을 보완합니다.
- 쉼표를 직접 넣는 대신 음을 삭제하거나 다음 음의 시작을 옮겨 빈 시간을 만듭니다.
- 둘로 나누기는 음을 두 번 누르는 두 음표로 나눕니다.
- 앞 음과 합치기는 같은 음·같은 오선에서 이어지거나 겹치는 음을 하나로 합칩니다.
- 기준에 따라 오선 재배치는 현재 기준 음 높이로 전체 배치를 다시 나눕니다.
- 자동 분리는 실제 왼손·오른손을 판별하지 않습니다. 양손이 교차하거나 한 손이 넓게 움직이는 곡은 직접 배치하세요.
- 반음 이동은 멜로디/음표만 바꾸므로 조표와 코드도 확인합니다.
- 되돌리기는 최근 피아노 음표 편집30단계를 지원합니다.
- 피아노 모드에서는 가사를 붙이지 않습니다. 코드 기호는 코드·가사 탭에서 직접 입력할 수 있습니다.

저장과 호환.
- MusicXML: 두 오선, 화음, 여러 성부, 독립적인 음표 길이와 이음줄을 담습니다.
- MIDI: 동시 음·겹치는 음을 보존하며 위/아래 오선을 별도 트랙에 둡니다.
- 작업 JSON: version2, kind=piano, notes 배열에 시작·길이·강세·오선을 보존합니다.
- 기존 멜로디 작업의 version1/events 형식도 계속 읽고 편집할 수 있습니다.
- 작업 파일을 불러오면 피아노 모드와 오선 정보를 복원합니다. 원음 자체는 포함하지 않습니다.
- PDF는 악보 인쇄 / PDF 저장에서 브라우저 인쇄 창으로 저장합니다.
- 재생은 음표 확인용 전자음이며, 실제 피아노 샘플 음색이 아닙니다.

정확도 범위.
이 기능도 자동 초안을 만듭니다. 실제 연주의 모든 음을 정확하게 재현한다고 보장하지 않습니다.
잔향·페달이 강하거나 녹음이 작고 잡음이 많으면 음이 추가/누락되거나 길이가 달라질 수 있습니다.
모델은 물리적인 페달 조작을 인식해 MIDI CC64로 저장하지 않습니다.
실제 운지·양손 구분·셋잇단음표 혼합·복잡한 성부·꾸밈음의 최종 표기는 수동 확인이 필요합니다.
원음과 악보 음을 비교하고, 최종 악보는 MuseScore 같은 악보 편집기에서 마무리하는 것을 권장합니다.

환경.
PC Chrome·Edge 최신 버전, HTTPS를 권장합니다.
음원은 브라우저에서 처리하며 서버 또는 외부 분석 API로 보내지 않습니다. API 키가 필요 없습니다.
모델·JavaScript·WASM 파일을 ZIP에 포함합니다. 사용 시 외부 CDN 다운로드는 하지 않습니다.
브라우저가 WebAssembly를 허용해야 합니다. 호스팅/보안 플러그인은 .js/.json/.bin/.wasm 파일의 제공을 막지 않아야 합니다.
피아노 분석은 CPU보다 WebAssembly에서 빠릅니다. 속도와 메모리 사용은 PC에 따라 다릅니다.
워드프레스의 파일 업로드 제한은 이 도구가 브라우저에서 선택한 음원에는 적용하지 않습니다.
큰 파일은 디코딩 과정에서 메모리를 많이 쓰므로 스마트폰보다 PC를 권장합니다.

검증 자료.
피아노 화음 예제는 구조/편집 확인용이며 음원 분석 결과가 아닙니다.
실제 모델 시험에는 피아노 샘플 음을 합쳐 만든10초 화음·겹침음 파일을 사용했습니다.
그 파일에서20개 음, 최대4개 동시 음과 C3/C4/E4/G4 등을 인식했습니다.
5분·53MB 시험 파일에서도558개 음, 최대5개 동시 음과 마지막 구간까지의 분석·악보 표시를 확인했습니다.
이 수치는 기능 검증 결과이며, 일반 피아노 곡의 정확도 수치가 아닙니다.
독립적인 MusicXML 시간축 복원으로 예제12개 음의 시작·길이·오선이 그대로 유지되는지도 확인했습니다.
실제 워드프레스 서버의 테마·캐시·보안 플러그인 조합은 설치 후 확인해야 합니다.
