Differences

This shows you the differences between two versions of the page.

--- nano_ardule_midi_controller:aps_manual [2025/12/17 17:02] – [0.1 디렉토리 구성] hyjeong
+++ nano_ardule_midi_controller:aps_manual [2025/12/18 08:57] (current) – [1.1 APS는 무엇을 하기 위한 도구인가] hyjeong
@@ Line 5: / Line 5: @@
 본 문서는 APS v2.2a 기준의 사용자 매뉴얼 초안이다.
 APS는 드럼 패턴을 **편집·연결·재생·스트리밍**하기 위한 패턴 중심 스튜디오이며, 본 문서는 기능 나열보다 **이해 가능한 사용 흐름과 설계 의도**를 설명하는 데 목적이 있다.
+{{:pictures:aps_main.png?300|메인 화면}}
+{{:nano_ardule_midi_controller:stepedit.png?300|스텝에디트}}
 ----
@@ Line 15: / Line 18: @@
   * 모든 Python 스크립트는 **하나의 디렉토리**에 위치해야 한다.
-  * 동일한 위치에 반드시 ``patterns/`` 디렉토리가 존재해야 한다.
+  * 동일한 위치에 반드시 ''patterns/'' 디렉토리가 존재해야 한다.
-  * ``patterns/`` 아래에는 ADT / ARR / ADP 등의 패턴 파일이 위치한다.
+  * ''patterns/'' 아래에는 ADT / ARR / ADP 등의 패턴 파일이 위치한다.
 예시 구조:
@@ Line 46: / Line 49: @@
 ==== 0.3 실행 환경 ====
-  * Python 3.9 이상 권장
+  * Python 3.9 이상 권장 (가급적 파이썬 공식 웹사이트에서 받아서 설치할 것)
+    * mido, python-rtmidi
   * curses 지원 터미널 (Windows Terminal 권장)
-  * MIDI 출력 장치 또는 가상 MIDI 포트
+  * MIDI 출력 장치 또는 가상 MIDI 포트 (Windows에 기본 내장된 Microsoft GS Wavetable Synth로도 소리가 잘 남)
 ----
@@ Line 56: / Line 60: @@
 ==== 1.1 APS는 무엇을 하기 위한 도구인가 ====
-APS(Ardule Pattern Studio)는 **드럼 패턴 중심 워크플로우**를 위한 프로그램이다.
+APS(Ardule Pattern Studio)는 **드럼 패턴 중심 워크플로우**를 위한 프로그램이다. 보다 쉽게 표현하자면, PC에서 돌아가는 파이썬 프로그램으로서 자체 정의한 2-bar 드럼 패턴 파일([[adt_v2.2|ADT]])를 열람하고, 이를 조합하여 곡 단위의 정보를 만들거나, 패턴 단위의 편집을 하는 작은 프로그램이다. 물론 재생 기능도 갖고 있다. ADT 파일은 공개된 포맷의 텍스트 파일로서 MIDI 파일로부터 드럼 패턴을 추출하여 만들거나(필요한 모든 스크립트 제공) APS 또는 텍스트 편집기로도 편집 가능하다. 샘플 패턴 파일은 [[https://github.com/jeong0449/NanoArdule/tree/main/patterns/ADT|GitHub]]에서 제공한다.
   * 개별 드럼 패턴 편집 (ADT)
@@ Line 106: / Line 110: @@
 ==== 3.2 패턴 이름 규칙 ====
-  * ``_P###`` : Main Pattern
+  * ''_P###'' : Main Pattern
-  * ``_B###`` : Break Pattern
+  * ''_B###'' : Break Pattern
-``C`` 키를 누르면 두 패턴이 전환된다.
+''C'' 키를 누르면 두 패턴이 전환된다.
 <code>