User Tools

Site Tools


nano_ardule_midi_controller:aps_ardule_development_roadmap

This is an old revision of the document!


APS / Ardule Development Roadmap

이 문서는 ARR v0.05 안정화 이후를 기준으로, APS(Ardule Pattern Studio)와 Ardule 펌웨어의 중·장기 개발 로드맵을 정리한 것이다.

초점은 다음 세 가지에 있다.

* 공연에 바로 사용할 수 있는 곡 구조 표현력 * APS와 펌웨어 간의 명확한 역할 분리 * 기능 확장의 안전한 단계적 진행


Phase 0: Baseline (Completed)

* ARR v0.05 포맷 안정화 * ARR write / read 정합성 확보 (1-based section) * #PLAY 메타데이터 처리 확정 * 구조 맵 문서화 완료 * 프로젝트 규모(수천 LOC) 인식

이 단계는 이후 모든 확장의 기준점이 된다.


Phase 1: Performance Structure Expansion (High Priority)

ARR v0.1 – 1-bar 패턴 허용

목표 공연에서 필수적인 홀수 마디 구조를 ARR 단계에서 직접 표현할 수 있도록 한다.

핵심 기능 * ``MAIN|`` 토큰에 ``@A`` / ``@B`` 도입

  • ``N@A``: 2-bar 패턴의 앞 1-bar
  • ``N@B``: 2-bar 패턴의 뒤 1-bar

* ``@``가 붙은 항목은 길이를 1-bar로 간주 * 기존 2-bar 패턴 규칙은 그대로 유지

APS 영향 * 체인 타임라인 계산 로직 수정 * 그리드 뷰는 2-bar 구조를 유지하되, 절반만 채워 표시 * 체인 뷰에 ``@A`` / ``@B`` 명시적 표시

Ardule 영향 * 펌웨어에서 ARR 직접 해석은 지양 * 컴파일된 결과물만 소비하는 구조 유지


Phase 2: ARR to Type 0 MIDI Export

목표 ARR를 공연에 바로 사용할 수 있는 표준 MIDI 산출물로 변환한다.

설명 * ``@A`` / ``@B``를 포함한 ARR를 Type 0 MIDI로 변환 * 단일 트랙, CH10 중심 구성 * 시간축이 완전히 펼쳐진 형태로 고정

장점 * DAW나 MIDI 플레이어로 즉시 검증 가능 * 공연용 백업 포맷으로 활용 가능 * ADS 컴파일로 가는 자연스러운 중간 단계


Phase 3: Song-level ADS Compilation (Ardule Target)

목표 Ardule 펌웨어용 최적의 재생 데이터를 생성한다.

설명 * ARR를 곡 단위 ADS 스트림으로 컴파일 * 모든 패턴 참조를 시간 순서 이벤트로 해소 * ``@A`` / ``@B``는 이 단계에서 완전히 처리됨

특징 * ADS에는 패턴, 섹션 개념이 남지 않음 * 순수 스트리밍 이벤트 데이터 * 펌웨어의 런타임 복잡도 최소화

역할 분리 결과 * APS: 편집기이자 컴파일러 * Ardule: 결정론적 재생 엔진


Phase 4: StepSeq 표현력 확장 (Lower Priority)

StepSeq – 24-step 패턴 허용

목표 블루스, 셔플 등 트리플렛 기반 리듬을 직접 제작할 수 있도록 한다.

내용 * ``GRID=8T`` 와 ``LENGTH=24`` 허용 * 그리드 렌더링, 커서 이동, 편집 로직 전반 수정 필요

후순위인 이유 * UI 및 로직 영향 범위가 큼 * 홀수 마디 구조 표현에는 직접적으로 필요하지 않음 * ARR 파이프라인 완성 이후가 적절


Playback Strategy Summary

* APS 재생

  • ARR 기반 미리보기 및 개발용 재생

* Type 0 MIDI

  • 검증 및 공연용 백업

* ADS

  • Ardule 실전 재생용 최종 산출물
  • APS에서 ADS를 다시 재생할 필요는 없음

Final Principle

APS에서 ARR는 사람이 편집하는 소스 포맷이다. MIDI와 ADS는 컴파일 결과물이다.

이 분리는 다음을 보장한다.

* APS의 유연성과 표현력 * 펌웨어의 단순성과 안정성 * 공연 환경에서의 신뢰성

nano_ardule_midi_controller/aps_ardule_development_roadmap.1766478964.txt.gz · Last modified: by hyjeong