nano_ardule_midi_controller:aps_stepseq_사용_설명서_v2
Table of Contents
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 bar Count-in (High Woodblock)
- 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는 연주를 그대로 보존하는 도구가 아니라,
연주 감각을 구조화된 패턴으로 정착시키는 도구이다.
입력은 자유롭되, 결과는 질서 있게 기록된다.
문서 종료
nano_ardule_midi_controller/aps_stepseq_사용_설명서_v2.txt · Last modified: by hyjeong
