
            NeoTracker v1.4
          Instrukcja  obsługi

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

   WSTĘP

   NeoTracker jest programem służącym
do edycji i odtwarzania muzyki przy
pomocy ośmiobitowych sampli (cyfrowych
próbek dźwięku), wykorzystującym
rozszerzoną pamięć do 1MB oraz COVOX.
Pod względem obsługi wzorowany jest na
najlepszym (najwygodniejszym), zdaniem
autora, programie muzycznym - Theta
Music Composer'ze.
   Od momentu wydania wersji 1.12
minęło już kilka miesięcy, od wpisania
pierwszego LDA - dokładnie rok. Dlatego
też, mimo rozpoczęcia prac nad wersją
2.0, postanowiłem wydać wersję 1.4 -
nie tak bogatą w możliwości, bo opartą
częściowo jeszcze na starym kodzie.
   Mimo tego mam nadzieję, że właśnie
dzięki nowej wersji muzyka tworzona
przy pomocy sampli zacznie być trakto-
wana na naszej platformie nieco
poważniej.
   Miłego tworzenia życzy

                        Epi/Tristesse
                           28.08.2003


   HISTORIA

   Wersja 1.4 (08.2003)
- zwiększona częstotliwość miksowania
  przy odtwarzaniu modułu (11.5kHz)
- poprawione tablice częstotliwości
- poprawiona konwersja formatu MOD
- poprawione zarządzanie pamięcią
- wbudowana podręczna pomoc
- wybór urządzenia: POKEY/COVOX przy
  instalacji
- komendy efektu portamento
- obsługa podkatalogów SpartaDOS
- oddzielne ścieżki dla modułów,
  sampli i paternów
- kilkanaście mniejszych poprawek

   Wersja 1.12p (02.2003)
- odpowiednik wersji 1.12 dla POKEYa

   Wersja 1.12 (12.2002)
- dodana czwarta oktawa przy konwersji
  formatu MOD
- usunięte kilka drobnych błędów

   Wersja 1.11 (11.2002)
- niewielkie zmiany w obsłudze
- poprawiona obsługa płynnej zmiany
  głośności
- opcja wygładzania sampli

   Wersja 1.1 (11.2002)
- opcja testowania sampli z klawiatury
  przy częstotliwości 15.5kHz
- usunięte kilka błędów

   Wersja 1.0 (11.2002)
- zupełnie nowy wygląd, wzorowany na
  TMC
- nowy format pliku
- szybsza i dokładniejsza konwersja
  formatu MOD
- informacja o ilości wolnego miejsca
  na dysku
- możliwość wykorzystania tzw. długiego
  sampla - do 22kB
- komendy płynnej zmiany głośności
- kilka mniejszych poprawek

   Wersja 0.91 (10.2002)
- konwersja plików .MOD (ProTracker)
- drobne zmiany w obsłudze

   Wersja 0.9 (09.2002)
- pierwsza wersja


   WYMAGANIA SYSTEMOWE

Konfiguracja sprzętowa:

minimalna  - ATARI 130XE
           - stacja dysków

podstawowa - +256kB RAM
           - Covox
           - stacja dysków lub SIO2PC

optymalna  - +1MB RAM
           - Covox
           - SpartaDOS X
           - SIO2PC lub twardy dysk

Wymagania programowe:

- MEMLO poniżej $2000
- nie używana pamięć pod ROM-em OS


   INSTALACJA

   W celu zainstalowania NeoTracker'a
należy przygotować ok. 16kB wolnego
miejsca na dowolnym dysku oraz wczytać
plik NEOINST.COM. Po jego załadowaniu
mamy możliwość zmiany następujących
ustawień:

- Katalogi domyślne (Default
  directories) dla modułów, sampli
  i paternów. Ustawiane są one
  standardowo przy każdym uruchomieniu
  programu.
  Klawisze:    DEL - cofnięcie kursora
           RET,TAB - zatwierdzenie
               ESC - wyjście do DOS

- Używane banki pamięci dodatkowej
  (Extended memory). Wyświetlane
  informacje to: liczba aktywnych
  banków, całkowita ilość banków oraz
  (poniżej) kody wszystkich aktywnych
  banków. Kody nieaktywnych (nie
  wykorzystywanych przez NeoTracker'a)
  banków zastępowane są przez "==".
  Klawisze: -,=,+,* - ruch kursorem
               SPC - aktywacja/
               dezaktywacja banku
           RET,TAB - zatwierdzenie
               ESC - wyjście do DOS

- Dźwięk I/O (I/O Sound). Jego
  wyłączenie znacznie uprzyjemnia
  odczyt długich plików przez SIO.
  Klawisze:    SPC - wł-/wyłączenie
           RET,TAB - zatwierdzenie
               ESC - wyjście do DOS

- Urządzenie wyjściowe (Output device).
  Opcja umożliwia korzystanie z prog-
  ramu na komputerach nie wyposażonych
  w Covox. Stereo jest wykrywane
  automatycznie.
  Klawisze:    SPC - zmiana POKEY/COVOX
           RET,TAB - zatwierdzenie
               ESC - wyjście do DOS

- Ścieżka docelowa (Save to:) - określa
  istniejący katalog, w którym zostanie
  zapisany NeoTracker z wybranymi
  ustawieniami.
  Klawisze:    DEL - cofnięcie kursora
               TAB - powrót do edycji
                    katalogu domyślnego
               RET - instalacja
               ESC - wyjście do DOS

   Najprostszym sposobem instalacji
(polecanym użytkownikom starszych DOSów
oraz stacji dysków), jest siedmiokrotne
wciśnięcie klawisza RETURN, a potem Y.
   Użytkownicy SDX powinni pamiętać
o konieczności podania bezwzględnych
ścieżek dostępu oraz wyłączeniu banku
wykorzystywanego przez DOS w trybie
BANKED - najczęściej jest to drugi
(licząc od zera) wykrywany bank, ale
(dla pewności) najlepiej jest użyć
sterownika SSDXBNK.SYS, przenoszącego
SDX do wybranego banku.


   PIERWSZE URUCHOMIENIE

   Uruchomienie programu następuje po
wczytaniu NEO.COM. Po załadowaniu
następuje rozpakowanie i generacja
tablic, po czym ukazuje się główny
ekran. Dzieli się on na trzy najważ-
niejsze części: edytor paternów
(po lewej), edytor songu (po prawej, na
górze) oraz okno sampli (również po
prawej, ale na dole). Przechodzenie
między oknami dokonuje się klawiszem
[TAB].
   Poniżej znajdują się jeszcze trzy
mniejsze okienka, informujące kolejno
o: szybkości odtwarzania całego modułu,
bieżącej oktawie oraz statusie ostat-
niej operacji. Normalnie wyświetlana
jest tu informacja o ilości wolnych
banków rozszerzonej pamięci dla sampli
(jeden sampel zajmuje jeden bank) oraz
rozmiarze wolnej pamięci na paterny
(w bajtach). Oprócz tego, tuż pod
informacją o wersji programu i autorze,
znajduje się miejsce na tytuł aktualnie
wczytanego utworu.
   Wszystkie liczby w programie (za
wyjątkiem numeru błędu) podawane są
w notacji szesnastkowej.
Maksymalna liczba paternów wynosi 128,
a sampli - 64, przy czym w dużej mierze
zależy to od ilości wolnej pamięci.
Zapełnienie bufora dla paternów lub
wszystkich banków rozszerzonej pamięci
dla sampli powoduje wyświetlenie
komunikatu "Out Of Memory". Długość
sampli ograniczona jest rozmiarem
banku (16kB), ale istnieje możliwość
użycia jednego sampla o długości do
22kB ($5800).
   Częstotliwość odtwarzania wynosi:
- przy odgrywaniu modułu - 11.5kHz
  (o 0.4kHz więcej, niż w poprzednich
  wersjach)
- przy testowaniu sampli/odgrywaniu
  paternu - 15.5kHz
- przy wpisywaniu nut z klawiatury
  - ok. 13kHz

   Rozkład klawiszy nutowych jest
następujący:

Pierwsza oktawa:
   [S] [D]     [G] [H] [J]     [L]
 [Z] [X] [C] [V] [B] [N] [M] [,] [.]

Druga oktawa:
   [2] [3]     [5] [6] [7]     [9]
 [Q] [W] [E] [R] [T] [Y] [U] [I] [O]

   Program dysponuje zakresem ponad
pięciu oktaw (63 półtony).

   Przy komponowaniu utworu można
korzystać z następujących efektów:
- koniec paternu - tuż za pozycją
  w paternie, gdzie jest umieszczony,
  powoduje zakończenie odgrywania
  bieżącego paternu/pozycji w songu
  i zapętlenie paternu/przejście do
  następnej pozycji w songu
- zmiana tempa - umożliwia zmianę szyb-
  kości odtwarzania utworu w dowolnym
  momencie jego trwania od pozycji
  w paternie, na której zostanie
  ustawiona
- płynna zmiana głośności - powoduje
  zwiększanie lub zmniejszanie głoś-
  ności co jedną ramkę - na pozycji,
  w której jest umieszczona, wykonuje
  się tyle razy, ile określa to aktual-
  na szybkość odtwarzania
- portamento (płynna zmiana wysokości
  dźwięku) - wartość parametru dodawana
  jest do częstotliwości dźwięku na
  danym kanale, należy pamiętać
  o obowiązującej tutaj skali logary-
  tmicznej; niestety - ze względu na
  różne częstotliwości odtwarzania
  paternu i całego utworu, dobór
  odpowiednich wartości może sprawiać
  problemy

   Tablica głośności obejmuje zakres
33 różnych głośności - od $00 (cisza)
do $20 (pełna głośność sampla).

   Od wersji 0.91 możliwy jest import
modułów w formacie MOD (ProTracker).
Konwersja obejmuje nuty w czterech
oktawach oraz efekty: 1,2 (portamento;
niestety bez uwzględnienia odwróconej
skali logarytmicznej i tylko do
wartości $0F), 5,6,A (płynna zmiana
głośności), B (skok do pozycji),
C (zmiana głośności), D (koniec
paternu). Z grubsza konwersja polega
na zamianie sampli ze znakiem na próbki
bez znaku, podzieleniu głośności przez
2 (format MOD przewiduje 65 poziomów
głośności), oraz podzieleniu paternów
czterościeżkowych na pojedyncze ścieżki
i spakowaniu ich.


   EDYTOR PATERNÓW

   Na szczycie okna widnieje skrótowa
informacja o bieżącym paternie: jego
numer oraz znak "+" lub "-", mówiący
o tym, czy w danym paternie coś się
znajduje. "-" oznacza patern pusty.
   Poniżej znajduje się 17 z 64 linii
paternu - każda z nich wygląda
mniej-więcej tak:

            1E:>D#2 04 20 P5
            ----------------
            aa:znnn ss vv kp

gdzie: aa - numer linii w paternie
        z - w tym miejscu może stać
            znacznik, używany np. przy
            kopiowaniu fragmentów
            paternu
      nnn - nuta odgrywana na danej
            pozycji, lub puste miejsce
            oznaczające kontynuację
            odgrywania poprzedniej nuty
       ss - numer sampla użytego do
            odegrania danej nuty - jego
            brak oznacza kontynuację
            odtwarzania poprzedniego
            sampla
       vv - zmiana głośności
       kp - komenda efektu i parametr:
            S0 - koniec paternu
            Sx - zmiana tempa (x=1-F)
            -x - płynne ściszanie
            +x - płynne pogłaśnianie
            Qx - portamento w dół
            Px - portamento w górę

   Klawisze w edytorze paternów:
(^ = [CTRL], ! = [SHIFT])

klawisze nutowe - wpisywanie nut
[-][=] - ruch kursorem: góra/dół
![INS] - wstawienie pustej linii
![DEL] - usunięcie linii
[DEL]  - kopiowanie zaznaczonej pozycji
^[Z]   - ustawienie znacznika
![P]   - skok na początek paternu
^[P]   - skok do pozycji znacznika

![-][=] - wybór oktawy
^[-][=] - wybór bieżącego sampla
 [+][*] - wybor paternu: poprzedni/
          następny
^[Q]    - skok do wybranego paternu

 ![<]  - wyczyszczenie paternu
 ^[<]  - skopiowanie paternu do bufora
         i wyczyszczenie paternu
 ^[>]  - skopiowanie zawartości bufora
         do paternu
!^[>]  - nałożenie zawartości bufora na
         bieżący patern
 ^[L]  - odczyt paternu
 ^[S]  - zapis paternu
 [RET] - odtwarzanie paternu
![RET] - odtwarzanie od początku
^[RET] - odtwarzanie od pozycji
         znacznika
         ([SPC] - stop)

 ^[C]    - zmiana głośności na bieżącej
           pozycji
 ![+][*] - zmiana głośności stopniowo:
           ciszej/głośniej
 ^[,][.] - ustawienie komendy efektu
 ^[+][*] - zmiana parametru komendy
 ![SPC]  - usunięcie komendy efektu
 ^[SPC]  - usunięcie numeru sampla
 ^[N]    - zmiana tytułu utworu
!^[-][=] - zmiana tempa całego utworu

   Poniższe cztery opcje uruchamia się
z klawiszem [CTRL] (edycja numeru
sampla) lub [SHIFT] (edycja parametru,
nie przy kasowaniu - [D]). Klawisze [+]
i [*] służą do wyboru wpisywanej
wartości (szesnastkowo), [RET] powoduje
zatwierdzenie wpisu, [ESC] - rezygnację
i powrót do edycji paternu.

[T] - transpozycja - wartość parametru
      określa, o ile półtonów zostaną
      podniesione dźwięki
[X] - zmiana sampli - wartość parametru
      określa numer sampla docelowego
[V] - zmiana głośności - parametr
      jest mnożony przez głośność
      na każdej pozycji w paternie
      według zasady: $40 - *2, $20 -
      *1, $10 - *0.5, itd.
[D] - kasowanie nut - wyczyszczenie
      wszystkich pozycji, na których
      użyto wybranego sampla

  [TAB] - przejście do okna sampli
 [HELP] - pomoc
!^[ESC] - wyjście do DOS


   OKNO SAMPLI

   W oknie tym znajduje się lista
wczytanych sampli, każda linia tej
listy wygląda mniej-więcej tak:

        >+04:!MINOR CHORD [L]
        ----------------------
        zuaa:lnnnnnnnnnnnnnnnn

gdzie: z - znacznik wskazujący bieżący
           sampel (używany do odgry-
           wania i wpisywania nut)
       u - znak "+" w tym miejscu
           oznacza, że dany sampel jest
           używany w bieżącym paternie
      aa - numer sampla
       l - znak "!" w tym miejscu
           stoi przed nazwą długiego
           (ponad 16kB) sampla
  nnn... - nazwa sampla

   Po prawej stronie znajduje się wąska
kolumna, z której można odczytać
informacje o bieżącym samplu:
SMP - numer sampla
VOL - głośność bazowa
LEN - długość sampla w bajtach
REP - pozycja początku pętli

   Klawisze w oknie sampli:

 [-][=] - wybór sampla
   ^[Q] - skok do wybranego sampla
![-][=] - wybór oktawy
 [RET]  - testowanie sampla
          ([SPC] - stop)
^[V]    - zmiana głośności bazowej
![+][*] - stopniowa zmiana głośności
          bazowej
^[S]    - zapis sampla .NSF
^[L]    - odczyt sampla .NSF
^[R]    - odczyt sampla .SMP
          (z programu ProTracker)
^[D]    - usunięcie sampla z listy
^[N]    - zmiana nazwy sampla

  [TAB] - przejście do edytora songu
 [HELP] - pomoc
!^[ESC] - wyjście do DOS


   EDYTOR SONGU

   Na samej górze okna znajduje się
informacja o numerach ścieżek oraz
ich stan: podkreślenie pod nazwą
ścieżki oznacza kanał włączony.
   Poniżej widać fragment (8 linii)
songu, każda z tych linii wygląda
mniej-więcej tak:

       01 1E:00 1E:0C 04:00 0A:FE
       --------------------------
       aa p1:t1 p2:t2 p3:t3 p4:t4

gdzie: aa - numer linii
       px - numer paternu na danej
            pozycji na ścieżce nr x
       tx - transpozycja paternu na
            danej pozycji na ścieżce x

   Klawisze w edytorze songu:

[-][=][+][*] - ruch kursorem
 ^[Q]    - skok do wybranej pozycji
  [0..F] - wpisywanie wartości
 ![1..4] - wł-/wyłączenie ścieżki
!^[-][=] - zmiana tempa utworu
  [RET]  - odtwarzanie modułu
 ![RET]  - odtwarzanie od początku
 ^[SPC]  - zerowanie wartości pod
           kursorem
 ^[N]    - edycja tytułu utworu
 ^[L]    - odczyt modułu .NEO
 ^[R]    - import modułu .MOD
 ^[S]    - zapis moduło .NEO
!^[CLR]  - skasowanie wszystkich
           danych

  [TAB] - przejście do edytora paternów
 [HELP] - pomoc
!^[ESC] - wyjście do DOS


   OPERACJE DYSKOWE

   Każda próba odczytu lub zapisu
danych w NeoTrackerze powoduje przej-
ście do menu operacji dyskowych. Na
dole ekranu pojawia się wtedy ścieżka
dostępu do bieżącego katalogu,
a w oknie paternu widoczna jest jego
zawartość - pliki danego typu oraz
podkatalogi. Program obsługuje zarówno
katalogi MyDOS-a, jak i SpartaDOS.
Jeżeli katalog jest pusty, widoczna
jest tylko informacja "no files". Wpis
".." oznacza katalog nadrzędny.

Klawisze przy odczycie pliku:

  [-][=] - ruch kursorem
   [RET] - wejście do podkatalogu/
           odczyt pliku
!^[1..8] - przejście do katalogu
           głównego danego dysku

Klawisze przy zapisie pliku:

[A..Z][0..9][_] - edycja nazwy
   [DEL] - kasowanie znaku
  [-][=] - ruch kursorem
   [RET] - wejście do podkatalogu
  ![RET] - zapis pliku o podanej nazwie
  ^[RET] - utworzenie podkatalogu
           o podanej nazwie
  ![DEL] - usunięcie podkatalogu (tylko
           MyDOS) lub pliku
!^[1..8] - przejście do katalogu
           głównego danego dysku

   Jeżeli podczas odczytu/zapisu
wystąpi błąd, zostanie wyświetlona
odpowiednia informacja. Komunikat "I/O
Error- nnn!" oznacza błąd transmisji
(nnn to jego numer), zaś "Bad file
type", że nie został poprawnie roz-
poznany format pliku.


   KREDYTKI

   Program powstał przy współudziale
następujących osób:

- pomysł, projekt, kod, testowanie,
  dokumentacja:
   Epi/Tristesse^O.S.

- pomysł, testowanie:
   Pinokio/Tristesse

- procedura wykrywająca XMS:
   Fox/Taquart

Przy jego tworzeniu przydały się
następujące programy:
- X-Assembler v2.5          Fox/Taquart
- Turbo Basic XL 1.5    Frank Ostrowski
- MS-Edit v2.0                Microsoft
- APE 1.16             Steven J. Tucker
- QMEG v4.3     S. Dorndorf, Gumi/Tight
- Flash Pack v2.1           Fox/Taquart
- FastTracker v2.09   Vogue&Mr.H/Triton

   Specjalne podziękowania dla
Voy-a/SSG^Dial za masę inspirujących
informacji o tracker-ach z innych
platform.

   NeoTracker v1.4 jest programem typu
freeware, co oznacza, że:
- używasz go na własną odpowiedzialność
- rozpowszechniasz go nie zmieniając
  nic w archiwum i nie biorąc za niego
  żadnej zapłaty
- nic za niego nie płacisz, ale jeżeli
  Ci się on spodoba, jesteś zobowiązany
  wysłać autorowi pocztówkę ze swojej
  miejscowości

   Wszelkie sensowne uwagi i propozycje
oraz kartki pocztowe należy kierować
na adres autora:

        snail: Adrian Matoga
               ul. Jeździecka 11
               30-698 Kraków
       e-mail: epi@atari.pl
          gsm: +48505713863

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

          (c) 2003 Tristesse

