Workflow ko

작업 흐름 — 윈도우에서 MSX까지

🇺🇸 English · 🇯🇵 日本語 · ⬅ 홈

이 페이지는 빈 폴더에서 시작해 실기에서 .MUB가 울릴 때까지 곡 하나를 따라갑니다.

---

전체 모양

flowchart LR
  subgraph PC["PC / 윈도우 — MUCOM88 Windows"]
    direction TB
    V["FM 음색 에디터"]
    P["PCM 뱅크 도구"]
    M["MML 편집기"]
  end
  subgraph MSX["MSX"]
    direction TB
    E["MUCEDIT<br>MML 편집"]
    C["MUCPLAY<br>컴파일 · 연주 · MUB / VGM 내보내기"]
    B["MUBPLAY<br>완성된 MUB 재생"]
    E --> C --> B
  end
  V -- "VOICE.DAT" --> E
  P -- "PCM .BIN" --> E
  M -- "SONG.MUC" --> E

Loading

PC에서 시작해야만 하는 것은 아닙니다. 이미 받은 라이브러리의 음색만 쓰면서 SSG와 FM 파트만 작성한다면, MSX 안에서만 지내도 됩니다. PC가 필요해지는 순간은 아직 아무도 만들지 않은 음색이 필요할 때, 또는 자기 샘플을 쓰고 싶을 때입니다.

---

1단계 — 곡마다 폴더 하나

두 기계 모두에서 곡마다 폴더를 하나씩 두십시오. 곡에 필요한 모든 것이 그 옆에 있습니다.

SONG/
  SONG.MUC          음악
  VOICE.DAT         외부 음색 라이브러리를 쓰는 곡이라면
  MUCOMPCM.BIN      K 채널을 쓰는 곡이라면 PCM 뱅크

까다롭게 구는 게 아닙니다. MSX에서는 #voice와 #pcm의 상대 파일명이 현재 작업 디렉터리를 기준으로 해석됩니다. .MUC가 어디에 있든 상관없습니다. 다른 디렉터리에서 컴파일하면 다른 앨범의 VOICE.DAT를 조용히 집어올 수 있습니다. 곡은 컴파일되고, 소리만 틀립니다.

이름이 같은 VOICE.DAT가 두 앨범에 있는 것은 아주 흔한 일입니다. 떼어 놓으십시오.

---

2단계 — PC에서 FM 음색 설계

MUCOM88 Windows에는 FM 음색 에디터(FmToneEditor.exe)가 들어 있습니다. 이걸 쓸 가치가 있는 이유는 플레이어와 연동된다는 점입니다. 메뉴에서 음색 에디터 연동을 켜면 편집한 내용이 지금 연주 중인 MML에 반영돼서, 오퍼레이터를 만지면 결과가 바로 들립니다.

음색을 꺼내는 방법은 두 가지입니다.

• 라이브러리 파일로 — 음색 데이터 파일(관례상 voice.dat)에 저장하고, 곡 헤더의 #voice로 참조합니다.
• MML 안으로 — 에디터에서 Ctrl+C, MML에 Ctrl+V 하면 @n:{ ... } 정의 블록이 소스 안에 인라인으로 들어갑니다.

MUCOMSX에서는 인라인이 나은 경우가 많습니다. 붙여넣은 정의는 .MUC와 함께 움직입니다. 파일이 둘이 아니라 하나이고, 어긋날 것이 없습니다. 형식과, 그래도 라이브러리가 나은 경우는 FM 음색 페이지에서 다룰 예정입니다. 올라오기 전까지는 상류의 음색 데이터와 음색 에디터 문서를 참고하십시오.

---

3단계 — PC에서 PCM 뱅크 만들기

K 채널은 하나의 뱅크 파일에서 ADPCM 샘플을 꺼내 연주합니다. 그 뱅크는 PC에서 평범한 오디오로부터 한 번 만듭니다.

1. 샘플을 16비트 모노 WAV로 준비합니다.
2. 포함할 파일을 순서대로 나열한 평범한 텍스트 목록 파일을 씁니다 — 보통 pcmlist.txt라는 이름을 씁니다. 오디오 파일은 목록과 같은 폴더에 있어야 합니다.
3. MUCOM88 Windows에서 F1 → Tool → Create PCM data file.

뱅크 하나가 나옵니다. 기본 이름은 mucompcm.bin이고, 원하는 이름을 써도 됩니다. 곡 헤더의 #pcm으로 참조합니다.

변환이 오디오에 무슨 짓을 하는지 알아 두십시오. ADPCM 변환 과정에서 샘플은 16 kHz로 리샘플링됩니다. 음정이 중요한 소재나 고역이 많은 소리는 성격이 달라집니다. 곡 전체를 그 위에 쌓기 전에 변환된 뱅크를 먼저 들어 보시고, 원본 WAV는 반드시 남겨 두십시오. 다시 만들 일이 생깁니다.

기존 PC-8801 ADPCM 바이너리도 WAV와 함께 목록에 넣을 수 있습니다.

---

4단계 — 파일 옮기기

SD 카드든 DirAsDisk든 플로피 이미지든, 곡을 조용히 망가뜨리는 단계가 여기입니다. 규칙 셋.

8.3 이름을 쓰고, 어디서나 일관되게

처음부터 짧게 지으십시오. SONG.MUC, VOICE.DAT, PCM01.BIN. 컴파일러는 동반 파일을 DOS FCB 경로로 읽는데, 여기서 이름이 잘립니다. 헤더에

#voice shinobivoice.dat

라고 적혀 있으면 MSX 쪽 파일은 앞 여덟 글자인 SHINOBIV.DAT라는 이름이어야 합니다. 윈도우가 만들어 주는 SHINOB~1.DAT 같은 짧은 이름 별칭을 찾아 주지 않습니다. 서로 다른 긴 이름 둘이 같은 짧은 이름으로 잘리는 것도 그 나름의 혼란입니다.

복사하기 전에 PC에서 이름을 바꾸고, 태그도 맞춰 고치십시오.

태그는 헤더 안에

#voice와 #pcm은 파일 맨 위 헤더 행들이 이어지는 구간에서만 인정됩니다. 그 위에 주석이나 공백만 있는 행을 하나 넣으면 헤더 밖의 태그로 읽혀 무시됩니다. 경고는 나오지만 곡은 그대로 컴파일되고, 음색만 빠집니다.

전송이 텍스트를 건드리지 않게

나중에 빌드를 바이트 단위로 비교할 생각이라면 개행과 문자 인코딩 둘 다 중요합니다. 가능하면 바이너리로 전송하십시오.

---

5단계 — MSX에서 작업

여기서부터 MSX는 자급자족합니다. 곡 폴더에서:

MUCEDIT SONG.MUC

에디터 안에서 F1 2로 컴파일 → 결과 확인 → F1 3으로 연주. 마음에 들면 Ctrl+S로 저장합니다.

컴파일 전에 저장할 필요는 없습니다. 에디터는 메모리의 버퍼를 컴파일합니다. 다만 저장과 컴파일은 다른 동작이고, 연주도 또 다른 동작입니다. 이 구분이 낯설다면 MUCEdit 설명서를 보십시오.

앨범 전체를 한 번에 처리하려면 MUC2MUB가 DOS 배치 파일에서 한 번에 .MUC 하나씩 변환합니다. 세션도 연주도 없고, 에디터 버퍼가 24 KiB에서 멈추는 것과 달리 64 KiB까지의 소스를 받습니다.

---

6단계 — 반복 작업

무엇을 다시 해야 하는지는 무엇을 바꿨는지에 달려 있습니다.

바꾼 것	다시 할 것
MML의 음표·템포·표현	컴파일, 연주
인라인 @n:{...} 음색	컴파일, 연주 — .MUC 안에 있으므로
라이브러리 파일의 음색	VOICE.DAT를 MSX로 다시 복사한 뒤 컴파일
PCM 뱅크의 샘플	PC에서 뱅크를 다시 만들고, 다시 복사한 뒤 컴파일
아무것도 — 파일만 다시 열었음	연주 전에 컴파일. Play는 현재 텍스트가 아니라 마지막 컴파일 결과를 씁니다

마지막 줄에는 누구나 한 번은 걸립니다. 편집하고, 연주를 누르고, 예전 버전이 들리고, 에디터가 고장 났다고 결론짓습니다. 아닙니다. 그 사이에 컴파일한 것이 없을 뿐입니다.

---

자주 걸리는 함정

증상	대개는
오류는 없는데 FM 파트 소리가 이상함	엉뚱한 VOICE.DAT를 집어옴 — 작업 디렉터리와 8.3 이름 확인
Warning: PCM file not found	#pcm 이름이 실제 DOS 파일명과 다르거나, 태그가 헤더 밖에 있음
곡은 나오는데 한 파트가 빠짐	그 채널 행이 잘못됨 — 채널 문자가 대문자인지, 1열인지, 뒤에 공백이나 탭이 있는지 확인
.MUB는 나왔는데 PCM이 없음	PCM 누락 경고를 무시하고 내보냄 — 고치고 다시 내보내기
수정이 반영되지 않음	컴파일했는지, 그리고 PC에서 고쳤다면 .MUC를 다시 복사했는지

문제 해결 페이지에서 제대로 다룰 예정입니다. 올라오기 전까지는 MUCEdit 설명서의 오류·경고 레퍼런스를 참고하십시오.