         
    @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
    @                                                                     @
    @        M   M  ZZZZZ          M   M  U   U   SSSS  IIIII   CCCC      @
    @       MM MM     Z           MM MM  U   U  S        I    C           @
    @      M M M    Z     -----  M M M  U   U   SSS     I    C            @
    @     M   M   Z             M   M  U   U      S    I    C             @
    @    M   M  ZZZZZ          M   M   UUU   SSSS   IIIII   CCCC          @
    @                                                                     @ 
    @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@


                                                                             
            >>>  MZ-MUSIC   -  hudobný editor pre  SHARP mz-800  <<<        
                           by TV-software (C) 1992                          
                             popis k verzii 4.0                            
                                                                             
                     

    autor : Tibor Varga                         Distribútor : SaKR soft
            TV software                                       Roman Konečný
                                                              Čkalovova 880
    hudba : Rastislav Blaho                          708 00   Ostrava Poruba



                                              
    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
                       >>>>>     POPIS  PROGRAMU     <<<<<
    +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
               
                - program je uložený od adresy  $2000          
                - dĺžka programu je             $A7FF
                - štartovacia adresa je         $3D00
                                        
   program je umiestnený v pamäti takto:
                                        - hlavný program  $2000-4FFF
                                        - bios            $5000-7AFF
                                        - editovaná hudba $8000-89FF
                                        - help            $9000-AFFF
                                        - pomocné rutiny  $B000-BFFF
                                        - mz player       $c000-c7FF
                                        - preložená hudba $c800-xxxx

  Editovaná hudba : 1.generátor   $8000-81FF  ; 0-252 tónov 
                    2.generátor   $8200-83FF    --- "" ---
                    3.generátor   $8400-85FF    --- "" ---
                    š.generátor   $8600-87FF    --- "" ---
                    podprogrami   $8800-89FF    --- "" ---
                 
  program - prekladá hudbu do strojáku   od  $c800-$xxxx                
          - dokáže uložiť 5 hudieb
          - POZOR ak siahajú preložené hudby až za adresu $D000 , tak
            pri resetnutí sa časť preloženej hudby od $D000 vymaže !  
                            
  mz-player  pracuje pod prerušením  IM2 , využíva VBLN - 50 Hz ,Z80 PIO
             štartovacia adresa je   $c000  {po príkaze CALL sa nastavý
                                             prerušenie a začne hrať hudba}
             ACC = číslo hudby  0-4

  Hudba pracuje : - v 700 a 800 grafickom móde v strojáku (strojový kód)
                  - v BASICu  MZ-1Z016
                  - v monitore
  
 Pre BASIC - istov  -  Hudba sa zavedie do BASICu takto :
                     
   1. -  LIMIT $C000        ; určenie voĺnej pamäti
   2. -  LOAD               ; nahratie hudby

   Spustenie hudby :     POKE $BF00,$3E,XX,$CD,$00,$C0,$C9
                                        /
                               Číslo hudby (0-4)

                         USR ($BF00)

  POZOR !!!  -  Po spustení hudby nejdú príkazy MUSIC,NOISE,SOUND



  +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++  
                       >>>    POPIS MZ PLAYERA    <<<
  +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++


  Program je uložený od adresy $C000 - $C7FF
  Pracuje pod prerušením IM2 , VBLN - 50 Hz , Z80 PIO  A-brány
  Program sa nedá presúvať voĺne po pamäti , na presunutie slúži funkcia
  mover  v  MZ MUSIC
  Počas behu MZ PLAYERa , čiže pod 50 Hz prerušením sa móže vykonávať
  vlastný podprogram (napr. testovanie klávesnice,....).
  
  MZ PLAYER
 
  C000 C3 XXXX   -   skok na začiatok programu
  C003 XX        -   tempo hudby
  C004 XX XX     -   adresa programu ktorí beží pod prerušením
  C006 XX XX     -   premenná ktorá ukazuje na adresu práve spracovávanej hud-
                     by - na notu , príkaz s ktorím pracuje MZ PLAYER
  C008 C3 XX XX  -   adresa vlastne vytvoreného programu - uživatelská
                     pri základnom MZ PLAYERi je tu skok na adresu , na ktorej
                     sa nachádza príkaz RET

  C3FD XX XX     -   dĺžka MZ PLAYERa aj s preloženými hudbami
  C3FF XX        -   počet preložených hudieb  (1-5)


    tabulka adries hudieb pre generátori :
   
        1.gen   2.gen   3.gen   š.gen
 
   C782 XX XX   XX XX   XX XX   XX XX   -  1 . hudba
   C78A XX XX   XX XX   XX XX   XX XX   -  2 . hudba
   C792 XX XX   XX XX   XX XX   XX XX   -  3 . hudba
   C79A XX XX   XX XX   XX XX   XX XX   -  4 . hudba
   C7a2 XX XX   XX XX   XX XX   XX XX   -  5 . hudba


   C7D7 XX  -  farba borderu počas behu MZ PLAYERa
   C7D8 XX  -  farba borderu ostatného priestoru

   Hodnota accmulátora ( ACC ) pri volaní (spúšťaní) MZ PLAYERa             
   t.j. pri CALL C000.
   
   ACC = 0-4  -  číslo preloženej hudby
                 ak je číslo väčšie ako počet preložených hudieb
                 napr. ACC = 4  a preložené hudby sú len dve  
                 tak MZ PLAYER prestane hrať , hudba sa dá spusťiť
                 len správnym číslom v ACC .

   ACC = FF   -  zastaví hudbu  - STOP

   ACC = FE   -  spustí hudbu odtial ,  odkial bola zastavená - CONTINUE
                 t.j hudba pokračuje




  +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
                        >>>   OVLÁDANIE PROGRAMU   <<<
  +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

- Program ovládame : kurzorovými tlačítkami , JOYSTICKOM - 1 , alebo myšou.
- Editovanie je formou programovania.Teda netestuje chyby. 
- Čísla sú v šestnástkovej (hexadecimálnej) sústave
            1 - 3  -  určuje zvolený zvukový generator
             P pattern,tj.podprogram (využitie pri refrénoch)
             N šumový generátor
- Do editovacieho režimu sa dostanete , po stlačení [SPACE] na okienku RECORD ,
  alebo klávesou [ F1 ]


EDITOVANIE  HUDBY - [ REC ]
----------------------------
- Pri editovaní generátora sa pohybujete pomocou kurzoru a medzerníkom sa vrá-
  tite späť do zakladneho menu. 

- Stlačením klávesov 1 až -  : meníte dĺžku noty

                     ^ : zmena noty na pauzu

                     \ : poltón ( # )

                     P : skok do podprogramu (0-255)

                     O : oktáva (0-2)  - nie je to príkaz MZ PLAYERA
                     príklad  O00 n n G05 O01 X(nota)
                     poloha   00 01 02 03 04 05  - tak pre X plati O01

                     I : nástroj  pri zvukovom generátore 0-10
                                     šumovom  generátore 0-4

                     T : 7 bit = 1 - mínus
                                 0 - plus

                         zmena výšky tónov editovaného generátora

                     V : V(0-F) hlasitosť ; F-vypnutý 

                     G : G+n  n-číslo (0-255) ; adresa skoku                  

                     S : definovanie šumu
                        E0- 6.93 kHz  synchronizovaný
                        E1- 3.47 kHz      --"--
                        E2- 1.73 kHZ      --"--
                        E3- 3.zv.gen      --"--
                        E4- 6.93 kHz  biely
                        E5- 3.47 kHz  --"--
                        E6- 1.73 kHz  --"--
                        E7- 3.zv.gen  --"--



                    E :-odchylka od frekvencie       b7 b6 b5 b4 b3 b2 b1 b0
                       n = 1  mínus , n = 0  plus  ;  n  x  x  x  x  x  x  x
 
                    príklad:  00  01  02  03  04     
                                  L0E E81 N02     - dĺžka efektu = note 1/32
                              L02 L0E E01 N02 N01 -   --"--      = note 1/16
                              L04 ........... N01 -   --"--      = note 1/8
                                       .
                                       .
                                       .
                              L20 ........... N01 -   --"--      = celej note

                    L - priradenie premennej pre opakovanie určitého celku
                        L+číslo (0-255) -  počet opakovaní.
                         - max.8 cyklov v sebe. 

  		    N - ukoncenie cyklu,ktorý bol otvorený príkazom L
                        N+adresa tónu,na ktorý skočí ak naposledy definovaná
                        premenná nie je nula.Inak  pokračuje v hraní od  
                        nasledujúceho tónu za týmto príkazom.
                                     
                    R - návrat s podprogramu do hlavného programu. 
                        (Číslo nemá význam.)

                   [INST] - roztiahnutie o jeden tón (skoky prečísluje)
                   [DEL ] - stlačenie o jeden tón ( -- " -- )

                   T - pri šumovom generátore slúži ako príkaz :

                   b7 b6 b5 b4 b3 b2 b1 b0
                   x  x  x  x  x  c  b  a    bity b7-b3  -  nemajú význam

                   a  =  0     -   normálny šum
                   a  =  1     -   skreslený šum

                   b  =  0     -   skoková zmena pri odchylke od frekvencie
                   b  =  1     -   plynulá zmena pri odchylke od frekvencie

                   c  =  0     -   vypnutie pásu v bordere
                   c  =  1     -   zapnutie pásu v bordere


                   adresa  $C7D7 - farba pásu počas behu mzplayeru
                           $C7D8 - farba okolia
                             
                   Hrúbka pásu určuje aký čas zdržuje mzplayer,čím užší je
                   pás tým menej zdržuje mzplayer.
                   Preto je dobré písať hudbu v čo najkratších tónoch,t.j.
                   , aby  najkratšia nota bola 1/32
                   Najlepšie je najprv napísať hudbu normálne , a potom
                   nájsť najkratšiu notu a tú vydeliť tak aby  bola 1/32
                   Ostatné sa potom delia tým istým číslom.
                   Najoptimálnejšie tempo je 05 , ale pri jenoduchšej hudbe
                   sa dá znížiť a tým sa zmenší zdržovanie mzplayera.



 *****************************************************************************
                     >>>   Prídavné funkcie EMI / SME   <<<
 *****************************************************************************


- [ EMI ]     - editor hudobných nástrojov
              - dovoluje editovať obalovú krivku , zmenu frekvencie počas
                nastroja ...


- [ SME ]     - špeciálny hudobný editor
              - dovoluje počas behu hudby hrať tony z klávesnice , [ PLAY ]
              - vie načítavať tóny z klávesnice do památe , načíta výšku aj 
                dĺžku tónu [ READ ]
              

              [ PLAY ] - postup práce : treba preložiť hudba v MZ MUSICu tak ,
                         že ten generátor s ktorým chceme hrať treba pri prek-
                         ladaní vypnúť.
                         Potom prejdeme do SME a navolíme si ten istý generá -
                         tor aj tu ( vpravo hore )
                         Nakonie použijeme funkciu PLAY
   
              [ READ ] - Číta tóny z klávesnice do pamäti podĺa navoleného 
                         generátora ( vpravo hore ) a umiestňuje ich od po -
                         lohy , ktorú máme nastavenú vedĺa okienka , ktoré
                         znázorňuje tempo ( vĺavo dole )
                         takty pri čítaní su 1/4 noty



 *****************************************************************************
                             >>>   Hlavné menu   <<<
 *****************************************************************************



okienka :     -------------
              I P 1 2 3 N I   -  označenie generátorov , s ktorými sa pracuje
              -------------
                5 1 2 3 4  

              -------------------------------
              I REC I PLAY I << I >> I STOP I
              -------------------------------
                 F1    F2    F3   F4    F5

F1 - editovanie hudby
F2 - Spustí práve definovaný generátor
F3 - Zastaví spustenú hudbu
F4 - pretáča editovaný generátor o stránku vpred
F5 - pretáča editovaný generátor o stránku vzad

[ ^ ]  Prepína aktuálny generátor v smere P>N>3>2>1 - [GRAPH]       
[   ]                             v smere 1>2>3>N>P - [ALPHA]

     Šípky vpravo a vĺavo zmena tempa    - [INST] , [ DEL ]

--------
I LOAD I - nahratie hudby z CMT , FD , alebo RD  - [L]
--------    Nahrať möžete buď hudbu do editora , ktorú möžete ďalej upravovať 
    L        , alebo hudbu skompilovanú , ktorú si möžete iba vypočuť , teda
            nie je možné ju upravovať .          

-------- 
I SAVE I - nahratie hudby na CMT , FD , alebo RD  - [S]
--------   
    S
         
   -----------
   I COMPILE I  - Nahraje s kompilovanú hudbu,ktorú už ďalej nieje možné meniť
   I EDITOR  I  - Nahraje editor , ktorý möžete ďalej upravovať.        
   -----------

 -------
 I NEW I    - vymaže editovanú hudbu ,ak sú nastavené všetky štyri tak vymaže
 -------      aj patterny (podprogramy)
    N

 -------
 I EMI I    - editor hudobných nástrojov / SME - špeciálny hudobný editor
 -------                                            
     E  

 --------
 I QUIT I   - koniec editovania - skok do monitoru
 --------
     Q

 --------       --------   
 I PLAY I   -   I PLAY I - spustí preloženú hudbu 1 - 5
 --------       I COMP I - preloží hudbu do strojového kódu
     P          --------    


                            --------
                            I THIS I - prepíše predošlý hudbu
                            I NEXT I - vytvorí ďaĺšiu hudbu
                            I NEW  I - prekladá od 1 hudby ( od začiatku )
                            --------


 --------
 I COPY I - kopírovanie časti nôt na iné miesto
 --------
     C
 
 -------  
 I ??? I  -  --------- 
 -------     I HELP! I - stručný popis programu
     ?       I COLOR I - zmena farieb
             I  * 2  I - vynásobenie dĺžky nôt dvojkou
             I  / 2  I - vydelenie dĺžky nôt dvojkou
             I EMI   I - editor hudobných nástrojov
             I SME   I - špeciálny hudobný editor
             I mover I - presunutie preloženej hudby v pamäti  
             I savep I - nahratie celého programu na FD            
             ---------


mover - presunie preloženú hudbu do strojáka na iné miesto v pamäti ,
        hudba sa potom spúšťa od novej zvolenej adresy.
      - pri presúvaní sa zadáva len vyššý byt adresy , nižší je nulový


 ******************************************************************************

                            >>>  POZOR   !!!   <<<

1. Program nie je blbovzdorný !!!
2. Netestuje zle zadané hodnoty pri editovaní
3. Pri kopírovaní netestuje zle zvolenú časť , program može zblbnúť !!!
4. Pri použití funkcie mover netestuje zadávanú hodnotu
5. Pri zblbnutí programu rýchlo resetnite a skúste ho spustiť príkazom J3D00

******************************************************************************


++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+    Veĺa úspechov a nových skladieb Vám želá autor a distributor programu   + 
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

 Popis nebol podrobený kontrole , preto prepáčte za vzniknuté gramatické chyby

