# APS StepSeq 사용 설명서 (Input Mode v2 기준) **최종 갱신일:** 2026-02-12\ **적용 버전:** APS StepSeq (Input Mode v2 설계 반영) ------------------------------------------------------------------------ # 1. 개요 APS StepSeq는 마디(bar) 단위 드럼 패턴 편집 도구이다.\ 본 버전은 기존 MVP-2 실시간 입력 실험 단계를 정리하여,\ **안정적이고 예측 가능한 입력 모드(Input Mode v2)**를 기준으로 재정의되었다. ⚠️ StepSeq는 DAW 스타일의 자유 녹음기를 목표로 하지 않는다.\ 패드 입력은 연주와 편집의 중간 단계이며, 최종 권위는 ADT 그리드이다. ------------------------------------------------------------------------ # 2. 기본 조작 ## 2.1 커서 이동 - ← → : 스텝 이동 - ↑ ↓ : 악기 이동 - 화면 페이지 이동 자동 처리 ## 2.2 셀 편집 - Enter : 셀 ON/OFF 토글 - OFF → ON 시 짧은 audition 소리 발생 - PLAY / REC 상태와 무관하게 동작 ------------------------------------------------------------------------ # 3. 재생 및 녹음 구조 ## 3.1 PLAY - Space : 재생 / 정지 - 일반 재생은 FULL 패턴 기준 - 일반 재생 시 Count-in 없음 - 일반 PLAY 중에는 입력 Preview 없음 ------------------------------------------------------------------------ ## 3.2 REC (입력 모드) - r : REC ON / OFF - REC ON 상태에서 Space 입력 시 녹음 시작 녹음 시작 절차: 1. 1 bar Count-in (High Woodblock) 2. Count-in 종료 후 RECORDING 진입 ------------------------------------------------------------------------ # 4. 입력 모드 설계 (v2 기준) ## 4.1 기록 범위 - 기록은 항상 **현재 로드된 bar에만 적용** - RECORDING 중에는 bar 경계를 넘지 않음 - 일반 재생 시에는 다음 bar로 넘어갈 수 있음 ------------------------------------------------------------------------ ## 4.2 모드 종류 ### OVERWRITE - 기존 bar는 작업 버퍼에서 초기화 - 단일 패스 녹음 (루프 없음) - 정상 종료 시 commit - 중단 시 원래 bar로 rollback > 실수하면 버리고 다시 친다. ------------------------------------------------------------------------ ### OVERDUB - 기존 데이터 유지 - 루프 항상 ON - 여러 바퀴에 걸쳐 누적 입력 - 중단 시 현재까지 기록 유지 > 반복 위에 레이어를 쌓는다. ------------------------------------------------------------------------ # 5. 입력 처리 정책 ## 5.1 트리거 - NoteOn만 Record 처리 - NoteOff 무시 - velocity=0 NoteOn 무시 - duration 개념 없음 ## 5.2 Velocity 매핑 Velocity ADT ---------- ----- 1--31 \- 32--79 x 80--127 o 0은 기록하지 않음. ------------------------------------------------------------------------ ## 5.3 Soft Quantize (±50%) 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) - 가장 가까운 스텝으로 스냅 - 다음 bar로 넘어가지 않음 - 내부 tick 기준은 원래 BPM 권위 유지 ------------------------------------------------------------------------ # 6. 입력 템포 스케일 - ARR/Bar BPM은 권위 유지 - 입력 모드에서는 타이머 주기만 스케일 적용 - 내부 tick 계산은 변하지 않음 - Count-in과 녹음은 입력 템포 적용 ------------------------------------------------------------------------ # 7. Count-in 시스템 - 악기: High Woodblock - 1 bar - 마지막 박 accent - R ON 상태에서만 발생 - Count-in 동안 입력 완전 무시 - Preview 없음 - Record 없음 - Quantize 없음 ------------------------------------------------------------------------ # 8. Preview / Playback / Record 분리 ## Preview - RECORDING 중 패드 입력 시 즉시 1회 출력 ## Playback - 그리드 기반 재생 - RECORDING 중에도 항상 동작 ## Record - Quantize 후 ADT 심볼 기록 세 기능은 논리적으로 분리되어야 한다. ------------------------------------------------------------------------ # 9. Overdub 보조 기능 - 루프 시작(컬럼 0) 시 시각적 강조 - LOOP 카운트 표시 - Count-in은 루프 카운트에 포함하지 않음 ------------------------------------------------------------------------ # 10. ADT 슬롯 정책 - 기존 ADT 슬롯 정책 유지 - Core 슬롯(KK / SN / CH / OH)은 교체되지 않음 - 빈 non-core 슬롯이 있을 경우에만 재정의 허용 ------------------------------------------------------------------------ # 11. 최종 철학 StepSeq는 연주를 그대로 보존하는 도구가 아니라,\ 연주 감각을 구조화된 패턴으로 정착시키는 도구이다. 입력은 자유롭되, 결과는 질서 있게 기록된다. ------------------------------------------------------------------------ # 문서 종료