작성일: 2026-02-12
목적: 본 문서는 현재 대화에서 확정된 APS StepSeq 입력 모드(패드 또는 외부 키보드 사용) 관련 모든 설계 결정을 정리한 것이다.

패드 입력은 APS에서 실시간 연주를 그대로 녹음하는 기능이 아니라, bar 단위 루프 위에서 리듬 감각과 강약을 즉각적으로 반영하여 ADT 그리드에 구조화된 패턴으로 정착시키는 행위이다. 사용자는 패드를 통해 순간적인 타격 감각(Preview)을 얻고, 시스템은 이를 Soft Quantize(±50%) 규칙에 따라 가장 가까운 스텝에 배치하여 4단계 벨로시티 심볼로 기록한다. 즉, 패드 입력은 연주와 편집의 중간 지점에 위치하며, 자유로운 감각을 유지하면서도 MetaTime 기반의 질서 있는 패턴 구조를 보존하는 입력 방식이다.

이 문서는 새로운 세션에서 작업을 이어가기 위한 작업 지시서 용도로 사용된다.

APS 입력 모드는:

• 마디(bar) 단위 드럼 패턴 입력 시스템
• DAW 스타일의 선형 레코더가 아님
• MetaTime(절대 tick 권위) 기반
• 안정성, 예측 가능성, 음악적 사용성 중시

최종 기록 권위는 ADT 그리드이다.

• 기록은 항상 현재 로드된 bar에만 적용
• 기록 중에는 다음 bar로 경계를 넘어가지 않음
  • 중단 상태에서 [ or ] 키로 전환하거나 경계 영역에서 좌우 화살표를 눌렀을 때에는 예외
  • 스페이스바를 눌러 단순 재생 때에는 다음 bar로 넘어감
• 다음 bar 작업은:
  • C 키로 복사
  • 수동 편집

특징:

• 대상: 현재 bar
• 시작 시 기존 데이터 초기화
  • 실제 그리드를 즉시 지우면 안 되고 반드시 작업 버퍼에서 처리
• 단일 패스 녹음 (루프 없음)
• 녹음 전 Count-in 존재
• 정상 종료 시 commit
• 중간 중단 시 롤백

철학:

실수하면 버리고 다시 친다.

특징:

• 대상: 현재 bar
• 기존 데이터 유지
• 루프 항상 ON
• 여러 바퀴에 걸쳐 누적 입력
• Space로 중단
• 중단 시 현재까지 기록 유지

철학:

반복 위에 레이어를 쌓는다.

• Record는 NoteOn만 처리
• NoteOff 무시
• velocity=0 NoteOn 무시
• 길이(duration) 개념 없음
• ADT 심볼 그리드가 최종 결과

입력 Velocity ADT 심볼

0 (무시) 1–31 - 32–79 x 80–127 o

정규 순서: . - x o

공식:

rel = t_hit_tick - bar_start_tick
step_float = rel / step_len_tick
col = int(step_float + 0.5)
col = clamp(col, 0, steps_per_bar - 1)

* 가장 가까운 스텝으로 스냅
* 정확히 0.5일 경우 다음 스텝
* 다음 bar로 넘어가지 않음
* Tick 계산은 원래 BPM 권위 유지

• ARR/Bar BPM은 권위 유지
• 입력 모드에서는 임시 템포 스케일 적용(타이머 주기만 스케일, 내부 tick 기준은 불변)
• 예:
  • 원래 BPM: 120
  • 입력 스케일: 0.92
  • 유효 BPM: 110.4
• Count-in과 녹음은 유효 BPM 사용
• Tick 계산은 원래 BPM 기준 유지

악기: High Woodblock

규칙:

• 1 bar Count-in
• 마지막 박 accent
• R ON 상태에서만 발생
• 일반 재생 시 Count-in 없음
• Count-in 중 입력 완전 무시
  • Preview 없음
  • Record 없음
  • Quantize 없음

• 패드 타격 즉시 1회 출력
• 그리드와 독립
• 루프 재생 안 됨

• 그리드 기반 재생
• 녹음 중에도 계속 동작

• Quantize 후 ADT 심볼 기록

세 엔진은 논리적으로 완전히 분리되어야 함.

Overdub 녹음 중:

• 컬럼 0 도달 시 시각적 강조
• 루프 카운트 표시 (예: LOOP: 3)
• Count-in은 루프 카운트에 포함하지 않음
• Recording 상태 진입 후 첫 컬럼 0 도달 시 LOOP 1
• 새 Overdub 시작 시 카운트 초기화

상태:

• OFF
• READY
• COUNT-IN
• RECORDING

흐름:

R OFF → Space → 일반 재생

R ON → Space → COUNT-IN
COUNT-IN 완료 → RECORDING

RECORDING 종료 → READY 상태로 복귀

OVERWRITE: - 단일 패스 - 중단 시 롤백 - 완료 시 commit

OVERDUB: - 루프 - 중단 시 현재 상태 유지

APS 입력 모드는 다음 요소로 구성된다:

• 현재 bar 한정 기록
• Overwrite (단일 패스 + 롤백)
• Overdub (루프 + 누적)
• Soft Quantize ±50%
• 4단계 벨로시티 매핑
• High Woodblock Count-in
• 입력 전용 템포 스케일
• 컬럼 0 시각 강조
• 루프 카운트 표시

설계 목표:

• 안정성
• 예측 가능성
• 음악적 사용성
• 역할 분리 명확화
• 기능 과잉 방지