Editor hudby pre programy v pascale

{XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX}
Manual k programu EditSND
 
{XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX}
Obsah:
 
  1. Vyznam editoru
  2. Zvukovy format SND
  3. Prace s editorem
  4. Kontaktni adresa
  5. Unit Speaker.pas
 
{XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX}
1. VYZNAM EDITORU
 
  S programem EditSnd.exe je mozne generovat soubory s priponou SND. Tyto
  soubory maji slouzit k ozvuceni programu na profesionalni urovni pomoci
  PC Speakeru. Vyuziva se k tomu preruseni od casovace nastavene na 100Hz
  tzn. vzorkovaci frekvence prehravanych zvuku je 100Hz. Nedochazi ke
  zhrouceni hodin vse je osetreno tak aby sly prehravat zvuky, aby spravne
  sly hodiny a zaroven aby program mohl vykonavat jine ulohy. Vse bezi na
  pozadi pres int8 viz. unit speaker.pas
 
{XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX}
2. ZVUKOVY FORMAT SND
 
  Soubor SND generovany programem EditSND.exe je muj vlastni format takze
  neni mozne pomoci tohoto editoru otevirat soubory s priponou snd ktere se
  vyskytovaly napr. ve starych hrach, tam je struktura souboru zcela odlisna
  od te moji.
 
  V mem souboru SND jsou dve hlavni casti ato:
  prvnich 4000 bajtu (2000 wordu - blok dat 1)
  dalsich  200 bajtu ( 100 wordu - blok dat 2)
 
  V souboru snd je mozne ulozit az 50 zvuku [0..49]. Jeden zvuk je popsan
  dvema cisly: ZACATKEM a DELKOU v tabulce (druhy blok dat) a samotnymi
  zvukovymi daty (prvni blok dat).
 
  Prvnich 2000 wordu(slov) obsahuje hodnoty vysky prehravaneho zvuku. Jsou
  tam ulozeny hodnoty v rozsahu 0..1000. Pri prehravani se pak jde rychlosti
  vzorkovaci frekvence word po wordu a nastavuje se vyska prehravaneho tonu
  na PC Speakeru.
 
  Zbyvajicich 200 bajtu: V teto casti je ulozena tabulka jednotlivych zvuku.
  Kazdy sudy word v teto tabulce predstavuje ZACATEK a kazdy lichy DELKU.
 
  Priklad Zvuk[0]:
  V druhem bloku dat je jeho ZACATEK na nultem wordu a DELKA na prvnim wordu.
 
  Priklad Zvuk[49]:
  V druhem bloku dat word 98 urcuje ZACATEK a word 99 urcuje DELKU
 
  Co je to ZACATEK: ZACATKEM zvuku je mineno cislo ktere urcuje kde v prvnim
  bloku dat zacinaji data tohoto zvuku. Napr zvuk[20] ma ZACATEK=1600
  a DELKA=100. Data tohoto zvuku zacinaji v prvnim bloku dat na wordu 1600 a
  sahaji az k wordu 1700 (ZACATEK+DELKA)
 
  Co je to DELKA: Je to pocet wordu(slov) ktere zabira dany zvuk v prvnim
  bloku dat. Maximalni DELKA jednoho zvuku je 300 wordu coz pri vzorkovaci
  frekvenci 100Hz odpovida trem vterinam zvuku.
 
  Jak asi vyplynulo vysledny soubor snd ulozi 20 vterin ruznych zvuku pro
  PC Speaker, pri delce jednoho zvuku pul vteriny je to asi 40 zvuku. Pro
  Zaokrouhleni a taky pro jistotu jsem tam dal moznost ulozit 50 zvuku.
 
{XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX}
3. PRACE S EDITOREM
 
  Po spusteni programu EditSND.exe se objevi nahore lista a po stisku sipky
  dolu se otevre menu s nabidkami. Na liste je : napis MENU, napis EDITOR
  ZVUKU dale je tam soubor= a sem se dosadi jmeno editovaneho souboru a
  napis F10=EXIT
 
  V nabidce ktera se objevi po stisku sipky dolu jsou moznosti: VYTVORIT,
  ULOZIT, OTEVRIT, EDITOR a NAPOVEDA. V menu se pohybujeme sipkami nahoru a
  dolu, vyber se provadi stiskem ENTER nebo pomoci klavesovych zkratek.
 
  F1 = zobrazi napovedu (ESC=Zpet)
  F2 = ulozeni, program sam nikde nevyzyva k ukladani proto nezapomente F2
  F3 = spusti dialog pro zadani jmena existujiciho souboru k otevreni,
       jmeno souboru k otevreni stejne jako u vytvareni noveho se zadava ve
       tvaru jmeno souboru bez pripony dlouhe max. 8 znaku, priponu snd si
       editor dosazuje sam, potvrezeni jmena se provadi stiskem ENTER
  F4 = spusti dialog pro vytvoreni noveho souboru, stejne jako u otevirani
  F5 = pokud mame zadane nejake jmeno souboru a vidime ho na liste tak se
       spusti graficky editor zvuku (ESC=navrat zpet do textoveho menu)
  F10 = konec programu
 
  F5 Graficky editor zvuku:
  Zobrazi se seznam jednotlivych zvuku. Co je k videni na jednom radku:
  Cislo od 0 do 49 udava cislo zvuku, dale ZACATEK=(0..1999), DELKA=(0..300)
  a ROZSAH kde vidime ktere wordy v prvnim bloku dat ve vyslednem souboru
  budou obsazeny vybranym zvukem. Sipkami nahoru a dolu se pohybujeme mezi
  jednotlivymi zvuky na trech obrazovkach (zvuky 0..19 , 20..39 , 40..49 ).
  Sipkami doleva a doprava menime pozici kurzoru (barevne oznaceni) a
  vybirame jestli budeme editovat ZACATEK nebo DELKU vybraneho zvuku.
 
  Klavesami Insert a Delete pridavame a ubirame jednotky
            Home a End pridavame a ubirame desitky
            PgUp a PgDn pridavame a ubirame stovky
 
  Rozsahy jake muzeme pomoci techto klaves nastavovat jsou:
  pro ZACATEK 0..1999 (2000 Wordu = 4000 Bajtu)
  pro DELKU   0..300
 
  Stiskem Enter nebo F6 na vybranem zvuku spustime obrazovku ktera nam
  umozni naeditovat jakou podobu bude mit tento zvuk. Na teto obrazovce je
  dole mala sipka kterou pohybujeme klavesami doprava a doleva a tak se
  pohybujeme po zvuku po jeho jednotlivych krocich. Vlevo nahore hned vidime
  jak se meni cislo ktere nam rika jakou vysku bude mit tato cast zvuku.
  Doleva a doprava se muzeme pohybovat po rozsahu DELKY vybraneho zvuku.
  Pokud nemame v listu jednotlivych zvuku nastavenou nejakou DELKU zvuku
  tak se nam na teto obrazovce zobrazi jen delka nula a malou sipkou nepujde
  pohybovat.
 
  Klavesami Insert a Delete pridavame a ubirame jednotky
            Home a End pridavame a ubirame desitky
            PgUp a PgDn pridavame a ubirame stovky
 
  Rozsah jaky muzeme pomoci techto klaves nastavovat je 0..1000
 
  Jakmile pomoci zminenych klaves nastavime nejake vysky tonu pro PC Speaker
  vidime to graficky jako sloupce, sloupec se zvysi o jeden pixel pri zvyseni
  o deset. Muzeme editovat s presnosti i na jednotky pomoci Insert a Delete
  a vysledny zvuk se bude menit jen to neuvidime na sloupci. Jako cislo v
  rohu nahore vlevo to vsak videt bude.
 
  Stiskem klavesy P muzeme vysledny zvuk hned prehrat, tato moznost prehrani
  pomoci klavesy P je i v nabidce jednotlivych zvuku tam jak se edituje
  ZACATEK a DELKA.
 
  Navrat do nabidky jednotlivych zvuku provedeme pomoci F5 nebo ESC. Protoze
  i navrat do textoveho menu se provadi pomoci ESC tak doporucuju spis F5 ale
  preskoceni az do textoveho menu by nemelo hrozit ani stiskem ESC. Ukladat
  pomoci klavesy F2 je mozne jak v textovem menu tak v nabidce jednotlivych
  zvuku tak i na obrazovce s editovanym zvukem.
 
{XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX}
4. KONTAKTNI ADRESA
 
  Kritiku nebo nejake dotazy ohledne editoru nebo meho formatu snd posilejte
  na kolecek.martin@email.cz
 
{XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX}
5. UNIT SPEAKER.PAS
 
  Tato knihovna obsahuje:
 
  Procedure InitSound;
  Procedure ShutdownSound;
  Procedure LoadSNDFile(Filename:String);
  Procedure PlaySound(Sample:Byte);
  Function  FPS2s: Boolean; {pomoc pri vypoctu fps pomoci timeru}
 
  InitSound
    Je nutno zavolat na zacatku programu. Tato procedura nastavuje novou
  obsluhu preruseni 8 (timer) a nastavuje frekvenci timeru na 100Hz. Bez
  zavolani teto procedury by nebylo mozne prehravat zvuky na pozadi.
 
  ShutdownSound
    Je nutno zavolat na konci programu. Tato procedura vse uvede zase do
  puvodni podoby, nastavi zpatky starou obsluhu preruseni 8 (timer).
 
  LoadSNDFile(Filename:String)
    Nacte z disku soubor snd se zvuky do pameti. Filename se zadava vcetne
  pripony napr. LoadSNDFile('test.snd');
 
  PlaySound(Sample:Byte); {Sample v rozsahu 0..49 viz soubor}
    Spusti prehravani zvuku. Sample=Cislo ktery zvuk z tabulky zvuku chceme
  prehrat napr PlaySound(20); Pokud hned po jednom zavolani PlaySound
  zavolame dalsi tak ze se jeste nestacil prehrat predchozi zvuk tak dojde k
  tomu ze se ten drivejsi zasatavi a zacne hrat novy. Kazde zavolani
  PlaySound spousti nove prehravani a trvale rusi predchozi.
 
  a nakonec funkce FPS2s: Boolean {pro prehravani zvuku neni treba}
    Toto jsem do unitu pridal jako pomocnou rutinu pri vypoctu fps. Funkce
  vraci True po dobu jedne vteriny a po dobu druhe vteriny zase vraci False.
  Pak zase true atd.
 
  Priklad programu;
  USES CRT,Speaker;
  Begin
    InitSound;
    LoadSNDFile('test.snd');
    PlaySound(0);
    Delay(2000);
    ShutdownSound;
  End.
{XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX}