GenoGlobe
Learning from Life

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
<!DOCTYPE markdown>
# 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는 연주를 그대로 보존하는 도구가 아니라,\
연주 감각을 구조화된 패턴으로 정착시키는 도구이다.

입력은 자유롭되, 결과는 질서 있게 기록된다.

------------------------------------------------------------------------

# 문서 종료