




















		     Gebruiksaanwijzing Sampbox 4 macro
			   Sampler voor MSX-Audio
				 versie 4.4

			    Een N.O.P. produktie




























				Inhoudsopgave

Paragraaf							    Pagina

1	Inleiding							 4

1.1	Computerconfiguratie						 4
1.2	Hoe gebruikt u Sampbox 4 macro het beste?			 5
1.3	Sampbox 4 macro werkt onder MemMan				 5
1.4	Het inladen van het programma					 6


2	Beschrijving van het gebruik van Sampbox 4 macro		 6

2.1	Algemene bediening						 6
2.2	De indeling van het hoofdscherm 				 6
2.3	De weergave van n macro					 6
2.4	Het herhaald weergeven van n macro				 7
2.5	Het beluisteren van een knip van n macro			 7
2.6	De opname van een sample					 7
2.7	Start Step, de grove instelling voor het begin van een sample	 7
2.8	End Step, de grove instelling voor het einde van een sample	 7
2.9	Start Adres, de fijne instelling voor het begin van een sample	 8
2.10	End Adres, de fijne instelling voor het einde van een sample	 8
2.11	Play Freq, het instellen van de weergavefrequentie		 8
2.12	Volume, het instellen van het weergavevolume			 8
2.13	Repeat/ jump, herhaald weergeven of springen in de macro-lijst	 8
2.14	Rec. Freq, het instellen van de opnamefrequentie		 9
2.15	Level meter/ oscilloscoop, opnameniveau afstellen		 9
2.16	Reset, het terugstellen van de waarden en het wissen van het
	geheugen							 9
2.17	Informatie							 9


3	Het gebruik van macro's                                         10

3.1	Het afspelen van alle macro's                                   10
3.2	Position-1, het afstellen van de huidige macro en start-macro	10
3.3	Position-2, het afstellen van de laatste macro			11
3.4	Beschrijving van een macro					11
3.5	Het invoegen van een macro					11
3.6	Het copiren van een macro					11
3.7	Het wissen van een macro					11


4	Disk acties							12

4.1	Het opvragen van een directory					12
4.2	Het wisselen van de huidige diskdrive				12
4.3	Het opslaan van een (macro)sample				12
4.4	Het wissen van een macro-file					12
4.5.	Wisselen tussen macro sample-files en fragment files
	en hoe frament files te gebruiken				13

Paragraaf							    Pagina

5	Het gebruik van de samples in eigen programma's                 14

5.1	De initialisatie van de routine 				14
5.2	Het inladen van een sample					14
5.3	Het afspelen van een sample					14
5.4	Het opvragen/veranderen van Position-1				15
5.5	Het opvragen/veranderen van Position-2				15
5.6	Het programmeren van de onderbreek-toets			15
5.7	Het geheugengebruik						15
5.8	Replayer voor muziekmodules met 256kB sample RAM		16


6	Tot slot							16


7	Verantwoording							16


Bijlage I	Schermoverzicht 					17

Bijlage II	Tabel van de toetsenbordmatix				17

Bijlage III	BIOS-routines						18


























De  pagina's zijn  gebaseerd op  een pagina-lengte van 54 regels en 78 tekens 
per regel (TED).

1.	Inleiding 

Sampbox 4  macro is een programma voor MSX-Audio en compatibles, dat geschikt 
is  voor het  maken van  lange en  korte samples  van externe  audio signalen 
(ADPCM-techniek). De  nadruk van  dit programma ligt op snelheid en gebruiks 
vriendelijkheid.
Het  nieuwe van  deze versie  ten opzichte van de vorige versies is de macro 
functie. Verder is er nog een groot aantal opties bijgekomen.
De macrofunctie  houdt vooral  in dat u verschillende samples in het geheugen 
kunt  opnemen. Door deze samples te herhalen, in frequentie te verhogen of te 
verlagen kunt  u zelf  een muziekstuk samenstellen. Het zelf "geschreven" mu 
ziekstuk  kan in  een snelle  megafile worden weggeschreven en gemakkelijk in 
eigen programma's gebruikt worden.

Sampbox 4 macro werkt met:

- MSX-Audio of compatibles.
- Grafische interface (duidelijke indeling en comfortabele kleuren).
- MSX computers vanaf versie 2.00 met diskdrive en 128 kB memorymapper.
- MSX Turbo-R in de Turbo-stand.
- Muis, joystick en de cursortoetsen.
- MSX-DOS versie 1.xx en 2.xx.
- Meerdere diskdrives en harddisk.
- Meerdere memorymappers in meerdere sloten.
- MemMan vanaf versie 2.1, TSR's mogelijk.
- Snelle megafiles (1 file per sample).

Sampbox 4  macro heeft,  net als Sampbox 3.20, een gemakkelijke bediening, is 
grafisch  georinteerd, gemaakt in 100% snelle machinetaal, maakt gebruik van 
directe aansturing  van de  Videoprocessor en werkt met eenvoudige muisbestu 
ring.  De samples  zijn tijdens opnemen en weergeven gewoon te onderbreken en 
de megafiles van Sampbox 3.20 zijn in te laden in Sampbox 4 macro.

Sampbox versie 4.2 heeft een aantal wijzigingen ten opzichte van versie 4.1:

- De door ons bekende bugs zijn verwijderd (welke ookalweer?).
- Het  laden/saven van	een sample  is voorzien  van een teller, die aangeeft 
  hoeveel blokken van 16 kB er nog geladen of bewaard moeten worden.
- De mogelijkheid te springen in de macro-lijst.
- Een oscilloscoop.

Wijzigingen versie 4.3 ten opzichte van versie 4.2:

- De door ons bekende bugs zijn verwijderd (na de scoop reset; adres &HBFFB).
- Het is  nu ook  mogelijk samples te verschuiven in het geheugen, door ze in 
  tijdelijk  op disk  te zetten  en ze	op een andere positie in het geheugen 
  weer in te laden.  
- Directe toetsen voor het veranderen van pos1 (de < en > toetsen).
- Kleine letters, speciale tekens (!,.#$%^&*()-+/?\<=>@[]) en spaties zijn nu 
  ook mogelijk te gebruiken in de omschrijving.




Wijzigingen versie 4.4 ten opzichte van versie 4.3:

- Sampbox is nu een N.O.P. productie.
- Replayer voor 256kB muziekmodules wordt nu standaard bij Sampbox geleverd.
- Naamsbeveiliging is verbeterd.

1.1.	Computerconfiguratie 

De  minimale computerconfiguratie  is een  MSX 2 computer met minimaal 128 kB 
User RAM  en 128 kB Video RAM, een dubbelzijdige diskdrive en natuurlijk MSX 
Audio (muziekmodule of compatibles). MemMan 2.1 of hoger moet in het geheugen 
aanwezig  zijn. Bij  de MSX Turbo-R wordt gebruik gemaakt van de Turbo-stand, 
echter alleen  bij laden  en saven,  dit omdat de aansturing van de MSX-Audio 
problemen zou kunnen opleveren.


1.2.	Hoe gebruikt u Sampbox 4 macro het beste?

Het  wordt aangeraden  om de MSX-Audio via de externe uitgangen (line-out) op 
een versterker	aan te	sluiten voor  een zo goed mogelijke geluidskwaliteit, 
dit omdat er veel ruis en een zwak signaal uit de computer output komt.
Voor opnemen is het noodzakelijk dat u over een regelbaar volume van de weer 
gavebron  beschikt. Het  afstellen van	het ingangssignaal vereist veel nauw 
keurigheid (meer hierover in paragraaf 2.15).
Het programma  zelf komt het beste tot zijn recht met minimaal n memorymap 
per  van 1  MB user  RAM, en voor snelle toegang tot de samplefiles wordt een 
harddisk niet  afgeraden. Voor	snelle en efficinte bediening wordt een muis 
van goede kwaliteit aangeraden.


1.3.	Sampbox 4 macro werkt onder MemMan

De  door MST  gemaakte memorymanager, MemMan, maakt het mogelijk dat program 
ma's al  het aanwezige  geheugen kunnen  gebruiken. Het  voordeel hiervan is, 
dat,  als u  meerdere memorymappers  bezit, u  deze effectief kunt gebruiken. 
Sampbox 4  macro werkt	met de	maproutines van  DOS 2.xx,  omdat MemMan deze 
verwerkt.  Het nadeel  is echter, dat het rendement van MemMan laag is, als u 
slechts een kleine memorymapper bezit.
Vanaf versie  2.0 is  het mogelijk  om TSR-programma's (programma's die op de 
achtergrond  werken) in het geheugen te installeren. Nu Sampbox 4 macro mini 
maal met  versie 2.1 werkt is het in theorie mogelijk deze TSR-programma's te 
gebruiken  onder Sampbox 4 macro. Werking van deze programma's kan niet gega 
randeerd worden  wegens het ontbreken van documentatie en de nodige TSR's. Nu 
Sampbox  4 macro strikt volgens de routines van MemMan versie 2.1 is geschre 
ven, worden er geen problemen verwacht. Mogen er toch problemen geconstateerd 
worden willen wij dit graag van u vernemen.
Als u  een vroegere versie van MemMan 2.1 in het geheugen heeft zal deze ver 
wijderd  moeten worden,  dit gaat  het gemakkelijkste  m.b.v. de  reset knop. 
MemMan wordt  automatisch ingeladen  als u zich aan de laadinstructies (para 
graaf 1.4) houdt.




1.4.	Het inladen van het programma

Het  inladen gebeurt door de originele disk in drive A: te stoppen en de com 
puter  te   resetten  of   aan	te  schakelen.	Eventueel  kan	ook  de  file 
"AUTOEXEC.BAS" geladen worden van een willekeurige drive door middel van:

- het MSX-BASIC commando:	RUN "AUTOEXEC.BAS"
- het MSX-DOS commando: 	BASIC AUTOEXEC.BAS 

Het  programma wordt nmaal in het geheugen ingeladen en behoeft verder geen 
disk-toegang, dus  kan de  originele disk kan uit de drive verwijderd worden. 
De  Sampbox 4  macro files  kunnen in  een subdirectory  worden genstalleerd 
(bijvoorbeeld op  een harddisk), wij verwijzen hiervoor naar de DOS gebruiks 
aanwijzing.  Als u gebruik van een muis wilt maken moet deze vr het opstar 
ten van het programma zich in n van de twee joystickpoorten bevinden.


2.	Beschrijving van het gebruik van Sampbox 4 macro 


2.1.	Algemene bediening

Na  het inladen  van het  programma verschijnt	het hoofdscherm waarover ver 
schillende "knoppen"  verdeeld zijn.  De functie  van deze  "knoppen" kunt  u 
gebruiken door er op te "klikken". Dit houdt in dat u de pijl naar een van de 
knoppen  stuurt  met  het betreffende  besturingsapparaat (muis,  joystick of 
toetsenbord)  en op  de eerste	muistoets, joysticktoets  of op de spatiebalk 
drukt.
In het	algemeen geldt het zo, dat, als u een functie wilt activeren, u op de 
eerste	vuurknop of op de spatiebalk moet drukken. Wilt u iets annuleren, dan 
drukt u  op de tweede vuurknop of op [ESC]. Het is mogelijk de interrupt fre 
quentie van de computer in te stellen door middel van [SELECT] (50 of 60 Hz).


2.2.	De indeling van het hoofdscherm

Het  scherm is in twee delen verdeeld. Het linkse gedeelte is verdeeld in: de 
levelmeter (bovenaan), de knoppen voor variabelen en onderaan de knoppen voor 
de step-functie.  Aan de  rechterkant is  het scherm  verdeeld in: de knoppen 
voor diskoperaties (bovenaan), de pijltoetsen voor variabelen en daaronder de 
actietoetsen. Een tekening van het hoofdscherm bevindt zich in bijlage I.


2.3.	De weergave van n macro

Bij  een weergave  (toets 7.2)	wordt de sample afgespeeld volgens de waarden 
die zichtbaar zijn in de displays 2.0 t/m 2.5.







2.4.	Het herhaald weergeven van n macro

Met de	herhaal-toets (7.1) kan, volgens de waarden van 2.0 t/m 2.5, herhaald 
worden	weergeven. U  kunt deze lus onderbreken door op de tweede vuurknop of 
op [ESC] te drukken.


2.5.	Het beluisteren van een knip van n macro

Met de	knip-toets (7.0)  kunt u  eenvoudig de	overgang beluisteren  van het 
einde  van de  sample en het begin ervan. Deze functie speelt de laatste twee 
blokken af  die ingesteld  zijn met de huidige End Step (display 2.1, zie ook 
paragraaf  2.8) en  End Adres (display 2.3, zie ook paragraaf 2.10) en begint 
dan met het eerste blok dat ingesteld is met Start Step (display 2.0, zie ook 
paragraaf 2.7)	en Start  Adres (display  2.2, zie  ook paragraaf 2.9). Is er 
slechts  n blok  geselecteerd dan wordt ook gewoon n blok afgespeeld. Bij 
langere samples  is deze  optie erg  handig omdat u dan niet steeds de gehele 
sample hoeft af te spelen.


2.6.	De opname van een sample

De  opname van	het ingangssignaal  gebeurt volgens  de waarden die afgebeeld 
staan in displays 2.0 t/m 2.3. De opnamefrequentie van de sample is weergege 
ven in display 3.2.


2.7.	Start Step, de grove instelling voor het begin van een sample

Met Start Step kunt u instellen waar u in het geheugen wilt starten met resp. 
opnemen of  weergeven. Dit  gaat, vergeleken  met Start  Adres, met  relatief 
grote  stappen (n "step" is gelijk aan 16 kilobytes). Het aantal blokken is 
afhankelijk van  de hoeveelheid  geheugen dat in de computer aanwezig is. Als 
men  de toets  van Start Step (2.0) heeft aangeklikt kunt u met behulp van de 
pijltoetsen in	het midden van het scherm (5.0 t/m 5.3) de waarde veranderen. 
Met de enkele pijltoetsen (5.2 en 5.3) gaat dit met stappen van n blok, met 
de  dubbele pijltoetsen  (5.0 en 5.1) met stappen van 10 blokken. De minimale 
waarde van  een blok is 1, en de maximale waarde kan niet boven de waarde van 
End Step komen.


2.8.	End Step, de grove instelling voor het einde van een sample

End Step werkt het zelfde als Start Step (paragraaf 2.7) maar dan stelt u het 
laatste  blok, dat  opgenomen of afgespeeld moet worden, in. u klikt de toets 
van End  Step aan  (2.1) en u kunt met de pijltoetsen (5.0 t/m 5.3) de waarde 
van  End Step  veranderen. De  minimale waarde van End Step kan niet onder de 
waarde van  Start Step	ingesteld worden. De maximale waarde van End Step kan 
niet boven het aantal geheugen blokken ingesteld worden dat door MemMan vrij 
gegeven is (zie ook paragraaf 1.3).




2.9.	Start Adres, de fijne instelling voor het begin van een sample

Met de functie Start Adres (toets 2.2) kunt u het begin van de sample instel 
len.  Deze functie  heeft effect  bij weergave	n opname.  De waarde van het 
startadres is minimaal 0000 en maximaal 3FFF (hexadecimaal).


2.10.	End Adres, de fijne instelling voor het einde van een sample

Met de	functie End  Adres (toets 2.3) kunt u het einde van de sample instel 
len.  De waarde  van End  Adres kan minimaal 0000 en maximaal 3FFF (hexadeci 
maal) bevatten.


2.11.	Play Freq, het instellen van de weergavefrequentie

Met Play  Freq (toets 2.4) kunt u de weergavefrequentie van de sample instel 
len.  Normaal gesproken is deze gelijk aan de opnamefrequentie, maar voor het 
maken van geluidseffecten of muziek kan deze functie zeer nuttig zijn.


2.12.	Volume, het instellen van het weergavevolume

Met de	optie Volume  (toets 2.5)  kunt u  het volume van de weergave van n 
macro instellen. Deze optie kan handig zijn bij het gebruik van verschillende 
opnameniveaus  en bij  het produceren van geluidseffecten. Als u deze functie 
heeft geselecteerd dan kunt u met behulp van de pijltoetsen (5.0 t/m 5.3) het 
volume instellen met stappen van 1 of 10.


2.13.	Repeat/Jump, herhaald weergeven of springen in de macro-lijst.

Met de	functie Repeat (toets en display 2.6) kunt u de gemaakte sample meer 
dere  malen herhalen,  waardoor u  effectiever gebruik kunt maken van het be 
schikbare geheugen.  Als de  inhoud van  Repeat gelijk is aan 1, dan wordt de 
sample	slechts nmaal  afgespeeld. Is  de waarde  0, dan geeft u aan dat de 
huidige macro  de laatste  is, en  dat de computer kan stoppen met weergeven. 
Als  de waarde van Repeat groter wordt dan 99, dan verschijnt er een letter J 
met een getal, om aan te geven dat de jump-functie dan actief wordt. De macro 
waarin de jump staat wordt niet afgespeeld, maar het programma "springt" naar 
de position  (zie paragraaf  3.1 en  verder), waar het getal achter de J naar 
wijst. Als een macro-lijst er bijvoorbeeld zo uit ziet:

Position  : 0001 0002 0003 0004

Start step: 0001 0003 0004 0006
End step  : 0002 0003 0005 0007
Repeat	  : J003 0008 0001 0001

Dan  zal Position-2 worden overgeslagen, en zullen alleen samples die in step 
4 tot en met 7 staan, worden afgespeeld. (Zie ook paragraaf 3.1.)



2.14.	Rec Freq, het instellen van de opnamefrequentie 

Bij Rec.  Freq. (toets	3.2) kan  de opnamefrequentie  in kilohertz ingesteld 
worden.  Een  hogere  sample-frequentie geeft  betere geluidskwaliteit,  maar 
neemt  meer geheugen  in beslag een geeft dus korte samples. Er wordt geadvi 
seerd om  afhankelijk van  de toepassing  de sample-frequentie aan te passen. 
Voor  muziek is  deze meestal  16 Khz en voor spraak bijvoorbeeld 8 Khz. Deze 
functie wordt  natuurlijk niet	in een	macro opgeslagen. De inhoud wordt wel 
gecopieerd naar Play Freq. als op Reset (zie paragraaf 2.16) wordt geklikt.
2.15.	Level meter/ oscilloscoop, opnameniveau afstellen

Een hulpfunctie  voor het  opnemen is  de levelmeter (1.0 in bijlage I) of de 
oscilloscoop.  Deze wordt  geactiveerd door  middel van  toets 6.4. Door deze 
toets kort  in te  drukken verschijnt de oscilloscoop, maar wanneer u de knop 
langer ingedrukt houdt, verschijnt de levelmeter. Met deze functie kunt u het 
geluidsniveau van de ingang aflezen. Het opnemen van het audiosignaal vereist 
veel ervaring in verband met het juiste volume van het signaal. Het wordt dan 
ook  aangeraden om  het uitgangsvolume van de geluidsbron te regelen. Dit kan 
met een  mengpaneel of	een regelbare weerstand. Door een hoog/laag-toonrege 
ling  of equalizer  kan het geluid opgehaald worden (in verband met een niet 
lineaire opname).
LET OP!!  Bij een  te hoog ingangssignaal bestaat de mogelijkheid van interne 
beschadiging  van de  MSX-Audio. Een te hoog ingangssignaal kan tijdig worden 
gesignaleerd door de levelmeter of de oscilloscoop.


2.16.	Reset, het terugstellen van waarden en het wissen van het geheugen

Met deze  optie kunnen	de huidige instellingen (displays 2.0 t/m 2.6) worden 
gereset.  De opnamefrequentie (display 3.2) wordt gecopieerd naar de afspeel 
frequentie (display  2.4). Als	u de  resetknop een  paar seconden  ingedrukt 
houdt,	worden alle macro's gewist, ook wordt het samplegeheugen gewist en de 
opname frequentie wordt gecopieerd naar de afspeelfrequentie. Alle instellin 
gen worden op de beginwaarden teruggezet.


2.17.	Informatie

De informatietoets  (toets 6.5)  geeft informatie over het gebruikte geheugen 
en tijd van de huidige macro, aangegeven in position-1 (display 3.0), de naam 
van  de geregistreerde	gebruiker en  over de  gebruikte versie van Sampbox 4 
macro. Info kan worden onderbroken met de tweede fireknop en [ESC].












3.	Het gebruik van macro's

Als u  meer met  eenvoudige samplers  heeft gewerkt, dan zal u waarschijnlijk 
opgevallen zijn, dat de meeste samplers geschikt zijn om een analoge informa 
tie  (muziek, spraak enz.) op te nemen en weer af te spelen. Nu heeft Sampbox 
4 macro  deze optie  ook. U  stelt Start  Step, End  Step, Start Adres en End 
Adres  in en u kunt opnemen, weergeven, herhalen en knippen. Nu is n van de 
unieke opties van Sampbox 4 dat er macro's gemaakt kunnen worden waarin Start 
Step, End  Step, Start Adres, End Adres, Play Freq, Volume en Repeat opgesla 
gen  kunnen worden. U heeft bijvoorbeeld een muziekstuk waarin het intro ver 
schillende malen herhaald wordt, hiervan kunt u dus een macro maken. Dit gaat 
als volgt:  U zorgt  dat position-1  (display 3.0)  op 0001  staat en u stelt 
start-	en end	step in. U neemt de sample ruim op en knipt de sample als een 
loop (paragraaf  2.4). Nu  kunt u  het volume  en het  aantal keren  dat u de 
sample	herhaald wilt  hebben instellen. Heeft u een sample-loop van bijvoor 
beeld 32 kB en herhaald u de sample 2 keer, dan heeft u een geheugenbesparing 
van ongeveer  32 kB  (dit is  iets minder  omdat de tabel ook opgeslagen moet 
worden). Na macro nummer n komt natuurlijk nummer twee etcetera.


3.1.   Het afspelen van alle macro's

Bij het afspelen van alle macro's (toets 7.3) begint de computer af te spelen 
bij de macro die aangegeven staat in Position-1 (display 3.0) en stopt bij de 
macro in Position-2 (display 3.1). Als de waarde van Repeat (display 2.6) nul 
bedraagt  in de  laatste macro,  dan stopt  de computer met afspelen. Is deze 
waarde groter  dan nul,  dan zal  de computer de macro-lijst van voren af aan 
weer  beginnen. De laatste macro wordt wel afgespeeld. Staat er in Repeat een 
jump (paragraaf  2.13) dan  zal er worden "gesprongen" naar de desbetreffende 
macro.	Het  afspelen  kan onderbroken	worden door  vuurknop nummer  twee of 
[ESC].


3.2.	Position-1, het afstellen van de huidige macro en start-macro

Bij Position-1	(display 3.0)  kunt u door de macro's heen "bladeren". U ziet 
dan  de waarden  veranderen (mits  deze hetzelfde  zijn) en u kunt de macro's 
veranderen. Als  u n	macro wilt  afspelen (toets  7.0 t/m  7.2) of opnemen 
(toets	7.4) zal  dit gebeuren volgens de waarden van de huidige macro, zoals 
aangegeven in  Position-1. Bij	het afspelen van alle macro's (toets 7.3) zal 
de eerste macro die afgespeeld wordt, aangegeven staan in Position-1. Het ook 
mogelijk  deze functie rechtstreeks via het toetsenbord te bereiken, namelijk 
door de groter-en kleiner dan toetsen in te drukken (< >). Hierbij hoeft niet 
eerst shift gebruikt te worden, dus eigenlijk drukt u op de punt (.) en komma 
(.) toetsen.  Dit is vooral handig als u in veel macro's dezelfde waarde bij 
voorbeeld  1 stap  groter wilt	maken, u hoeft dan niet telkens 2 functies te 
selecteren, en dit scheelt tijd.







3.3.	Position-2, het afstellen van de laatste macro

Position-2 geeft de laatste macro aan. Bevat Repeat (display 2.6) in de laat 
ste macro  nul, dan  zal bij  het afspelen  van macro's  (toets 7.3), gestopt 
worden.  Is Repeat niet gelijk aan nul zal de laatste macro afgespeeld worden 
en zal aan de computer aan het begin (Position-1) weer beginnen te spelen. De 
sample is altijd te onderbreken met de tweede vuurknop of [ESC].


3.4.	Beschrijving van een macro

Men kan  in het  kader (1.1)  een beschrijving geven van n macro. Zo kunt u 
sneller  een overzicht van de macro's krijgen, zonder ze n voor n te moe 
ten afspelen.  U "klikt"  op het kader en u kunt de beschrijving intoetsen op 
het toetsenbord, onderbreken kan met [ESC] of met de tweede vuurknop.


3.5.	Het invoegen van een macro

Het  invoegen van  een macro  (toets 6.0) vindt plaats vr de huidige waarde 
van Position-1. In de macro komen de standaard-waarden te staan.


3.6.	Het copiren van een macro

Het copiren  van een macro (toets 6.1) gaat volgens de waarden in Position-1 
en Position-2. Position-1 (display 3.0) geeft de waarde van de macro aan, die 
gecopieerd  moet worden, Position-2 (display 3.1) geeft de waarde aan van het 
blok waar  de macro  naar toe gecopieerd moet worden. Wilt u een macro ergens 
tussen	copiren dan  zult u  eerst een  lege macro tussen moeten voegen (zie 
paragraaf 3.5).


3.7.	Het wissen van een macro

Het wissen  van de  huidige macro  (toets 6.2) staat aangegeven in Position-1 
(display 3.0). Alle macro's worden doorgeschoven naar de gewiste macro.

















4.	Disk-acties


4.1.	Het opvragen van een directory

Voor  het inladen  van een  (macro-)sample (toets 4.1) zal eerst de directory 
moeten worden opgevraagd (toets 4.0). U kunt door de directory "bladeren" met 
de toetsen  4.6 en 4.7. De betreffende file die u in wilt laden "klikt" u aan 
en u drukt op toets 4.1.

4.2.	Het wisselen van de huidige diskdrive

Met  de optie wisselen van drive (toets 4.4) wordt de opeenvolgende diskdrive 
geselecteerd. Bijvoorbeeld  van A:  naar B:,  van B:  naar C: enz. De huidige 
drive en het aantal vrije clusters zullen zichtbaar zijn in display 4.8.


4.3.	Het opslaan van een (macro)sample

Bij  het wegschrijven  van een	sample (toets  4.2) begint de computer bij de 
eerste macro  te schrijven,  welke aangegeven is in Position-1 (display 3.0). 
De  laatste macro  die wordt opgeslagen, staat aangegeven in Position-2 (dis 
play 3.1).  Er wordt  bij het wegschrijven op gelet dat er slecht nmaal een 
sample-step wordt opgeslagen.
Een voorbeeld om het opslaan wat te verduidelijken:

Macro nummer	Start Step	End Step	Repeat

0001		0001		0007		0001
0002		0003		0009		0001
0003		0001		0002		0001

Position-1	Position-2

0001		0003

Nu worden de sample-steps 1 t/m 9 slechts nmaal op disk opgeslagen. Merkt u
op  dat deze  sample oneindig zal worden herhaald (zie paragraaf 3.1). Wilt u 
geen macro-sample  opslaan maar  n grote  sample dan	laat u	Position-1 en 
Position-2  gewoon op  1 staan.  In het voorbeeld zal dan Step 1 t/m 7 worden 
opgeslagen. LET  OP! Het  is dus  belangrijk dat  repeat een waarde bevat die 
groter	is dan	nul, want  anders wordt de macro niet opgeslagen. Macro's met 
een "jump"  in plaats  van een  repeat-waarde worden ook niet opgeslagen. Dit 
heeft verder geen consequenties voor de macro-samples.


4.4. Het wissen van een sample-file

Het wissen van een sample-file (toets 4.3) gebeurt op dezelfde manier als het 
laden,	eerst de  directory opvragen  (toets 4.0), dan een file selecteren in 
display 4.5,  maar dan	in plaats van toets 4.5, toets 4.3 gebruiken. De com 
puter  zal dan	om een	bevestiging vragen. Druk op de linker muistoets of de 
spatiebalk om te bevestigen.

4.5. Wisselen tussen macro sample-files en fragment files

Met deze  toets (4.5)  kunt u wisselen tussen  macro sample files en fragment 
files.	Staat de  toets op  macro sample-files,  dan is hierop een afbeelding 
zichtbaar van  streepjes met  daaronder een  horizontale pijl. Alle streepjes 
(die macro's  voorstellen) zijn  donker gekleurd.  Het programma  zal nu alle 
macro's laden en bewaren, zoals ingesteld bij position-1 en position-2. Staat 
deze  toets echter  op de  fragment-files functie,  dan is  er een afbeelding 
zichtbaar, waarbij slechts 1 streepje donker gekleurd is, en de pijl staat nu 
verticaal.  Wordt  er  nu  een sample  bewaard, dan  wordt alleen  die sample 
opgeslagen, die  in het  beeld omschreven is. Het is nu mogelijk dit fragment 
weer  in te  laden, op	een andere  plaats in het geheugen, dus op een andere 
step en adres, dan waar het stond. Voorbeeld:

Je hebt een sample-fragment: START STEP   0004
			     END STEP	  0005
			     START ADRES  2000
			     END ADRES	  1FFF

en  je wilt deze hebben op START STEP 0001, START ADRES 1234. Eerst bewaar je 
de bovenstaande  sample (in  de fragment mode) op disk, en stel je START STEP 
in  op 0001  en START  ADRES op  1234, dan laad je de zojuist bewaarde sample 
weer in,  en klaar. Het programma past automatisch END STEP en END ADRES aan, 
en  vult ook de oude omschrijving in, PLAY FREQ, VOLUME en REPEAT. Deze func 
tie bied  op deze  manier niet alleen de mogelijkheid samples te verplaatsen, 
maar ook ze uit te wisselen met andere macro sample-files.




























5.	Het gebruik van de samples in eigen programma's

Voor gebruik  van de samples in zelfgemaakte programma's staat op de disk een 
file "BASIC.BIN". Deze machinecode-file biedt de mogelijkheid om de sample in 
te  laden, en op verschillde plaatsen af te spelen. Ook is het mogelijk om de 
toets aan  te geven, waarmee de sample onderbroken kan worden. Enige ervaring 
met MSX-BASIC en/of machinetaal is wel noodzakelijk. Het is alleen maar moge 
lijk  macro sample-file te gebruiken in deze afspeel routine, dus het is niet 
mogelijk fragment files te gebruiken.


5.1.	De initialisatie van de routine

Als eerste moet MemMan in het geheugen aanwezig zijn (zie ook paragraaf 1.1), 
waarna moeten deze BASIC-commando's worden uitgevoerd:
 
	BLOAD "BASIC.BIN",R 
	DEF USR0 = &HD000
	A = USR0(0)

In  de variabele A bevindt zich nu het aantal blokken van 16 kB dat door Mem 
Man is	vrijgegeven. Hiermee  kunt u  testen of  de in te laden sample in het 
geheugen  past. Wel  moet u weten hoe groot de in te laden sample is. Als bij 
het uitvoeren  van deze instructie het resultaat 0 is, dan wil dit zeggen dat 
MemMan	zich niet  in het geheugen bevindt, en het programma niet kan werken. 
Is dit	niet het  geval, dan  zijn er  een aantal functies onder het commando 
USR0(x) aanwezig. De variabele x moet wel een integer zijn.


5.2.	Het inladen van een sample

Het inladen van de sample gebeurt als volgt:

	A = USR0("d:FILENAAM.SAM")

Deze  syntax wijkt af van de normale syntax omdat de foutcode in de variabele 
A wordt teruggegeven. De waarde van A heeft de volgende betekenis:

	0	Sample correct ingeladen.
	1	Diskfout/ Laadfout.
	2	Geen Sampbox 4 macro file.
	3	Te weinig geheugen beschikbaar.

BASIC-foutmeldingen zoals Disk offine en Disk error zullen zelf moeten worden 
opgevangen.


5.3.	Het afspelen van een sample

Daartoe moet het volgende commando wordt ingevoerd:

	A = USR0(1)

De sample wordt afgespeeld zoals door Position-1 en Position-2 is aangegeven.
5.4.	Het opvragen/veranderen van Position-1.

Het opvragen hiervan gebeurt door de instructies:

	A = USR0(2): B = USR0(A)

In de variabele A bevindt zich nu de huidige waarde van Position-1.
Het veranderen van de waarde gebeurt door de instructies:

	A = USR0(2): A = USR0(x)

De variabele x betreft hier de nieuwe waarde.


5.5.	Het opvragen/veranderen van Position-2

Zie hiervoor  de instructies  in paragraaf 5.4, maar gebruikt u nu USR0(3) in 
plaats van USR0(2).


5.6.	Het programmeren van de onderbreek-toets

Zie  paragraaf 5.4,  maar gebruikt u voor het instellen van de rij USR0(4) en 
voor de  kolom USR0(5).  Door een combinatie te maken van een rij met een ko 
lom, kan een bepaalde toets worden geselecteerd. Zie ook Bijlage II.
Een voorbeeld om dit te verduidelijken:

	A = USR0(4): A = USR0(5): ' rij-nummer
	A = USR0(5): A = USR0(6): ' kolom-nummer

Nu is [F1] de toets waarmee een sample kan worden onderbroken.

Voor [RETURN] moeten de volgende instructies ingegeven worden:

	A = USR0(4): A = USR0(7): ' rij-nummer
	A = USR0(5): A = USR0(7): ' kolom-nummer

De standaard onderbreek-toets is [ESC].


5.7.	Het geheugengebruik

BASIC.BIN	&HCA00,&HD037,&HD029

De routine gebruikt geheugen van &H4000 tot &H7FFF, en van &HD000 tot &HD029, 
maar  indien geen  BASIC maar  machinetaal wordt gebruikt, kan het gebied van 
&HD000 tot  &HD029 gewist worden, en kan de routine worden aangeroepen met de 
adressen  die in  Bijlage III zijn vermeld. Dit gebeurt dan d.m.v. een inter 
slot-call, of er moet zelf RAM geselecteerd worden op &H4000.





5.8.	Replayer voor muziekmodules met 256kB sample RAM.

De replayer  voor 256kB  sample RAM  wordt sinds  versie 4.4  bij Sampbox ge 
levert. Mensen, die hun muziekmodule hebben laten uitbreiden, kunnen nu de in 
Sampbox  gemaakte samples  inladen in  dit geheugen, en het dan afspelen. Het 
grootste voordeel  wat hierbij komt kijken, is het feit dat deze replayer erg 
snel  is (ongeveer  16 beeldlijnen).  Nu kan  er ook muziek worden afgespeeld 
tijdens  erg  ingewikkelde en  tijdsrovende routines,  zoals toegepast	in de 
megademo "Unknown  Reality" van  N.O.P. De  samples in deze demo zijn ook ge 
maakt  met Sampbox.  Voor het  gebruik van  de replayer,  zie de (BASIC) file 
REPLY256.BAS. Let  er wel  op dat de samples niet meer dan 256kB geheugen ge 
bruiken,  de replayer zal het te grote gedeelte niet meer afspelen. De source 
code van  de replayer,	geschreven in WBASS2, is bij N.O.P. aan te vragen. Uw 
muziekmodule kunt u laten uit breiden op het volgende adres:

			      Joben Microware 
			     Jachthondenstraat 2
			      7521 XN Enschede
			       Tel: 053-351131


6.	Tot slot

Wij  hebben  veel  plezier  gehad met  het ontwikkelen	en het	gebruiken van 
Sampbox 4  macro, wij  hopen dat  ook u  het programma	vaak gebruikt. In het 
begin  zal vooral  het macro-samplen  zeer tegenvallen,  maar het  is ons ook 
redelijk gelukt.  Wij hopen  dat er veel programma's uitkomen die samples ge 
bruiken gemaakt onder Sampbox 4 macro, wij kijken er in ieder geval naar uit. 
Voor  vragen, opmerkingen,  ideen, donaties  en bugs  stuur even een briefje 
naar onderstaand adres.

Verder hopen  we dat  iedereen een  legale copie  van het  programma heeft en 
houdt  zodat het  voor ons ook in de toekomst nog de moeite loont om program 
ma's voor MSX te schrijven (alle opbrengsten worden gespendeerd aan MSX Hard- 
en Software  en diskettes).  In het  programma staat  de naam  van de geregi 
streerde gebruiker (onder info paragraaf 2.17).


7.	Verantwoording

Programma en graphics:		M. Loor.
Diverse Ml-routines:		V. van Acht.
Orgineel idee:			J. Reijnders/ DATA Konnekt.
Gebruiksaanwijzing:		W. Loor en M. Verhappen.

Correspondentie adres:	M. Loor
			Biezenstuck 1
			5673 KT Nuenen.
			Holland.

Sampbox 4 macro is een produktie van N.O.P.

Vastgestelde verkoopprijs:	F25,-

Bijlage I.	Schermoverzicht

XWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWY
V XWRWRWRWRWRWRWRWRWRWRWRWRWY	  XWWWY XWWWY  XWWWWWWWWWWWWWWWWWWY XWWY  V
V V   1.0. Level Meter	    V	  V4.0V V4.5V  V		  V V4.V  V
V ZWQWQWQWQWQWQWQWQWQWQWQWQW[	  ZWWW[ ZWWW[  V       4.5.	  V V 6V  V
V XWWWWWWWWWWWWWWWWWWWWWWWWWWY	  XWWWY XWWWY  V		  V ZWW[  V
V V   1.1. Step Remarks      V	  V4.1V V4.2V  V		  V XWWY  V
V ZWWWWWWWWWWWWWWWWWWWWWWWWWW[	  ZWWW[ ZWWW[  TWWWWWWWWWWWWWWWWWWS V4.V  V
V				  XWWWY XWWWY  V       4.8.	  V V 7V  V
V				  V4.3V V4.4V  ZWWWWWWWWWWWWWWWWWW[ ZWW[  V
V  Start Step	 0000	 2.0	  ZWWW[ ZWWW[				  V
V  End Step	 0000	 2.1	  XWWWY XWWWY	XWWWY  XWWWY  XWWWY	  V
V  Start Adres	 0000	 2.2	  V5.0V V5.1V	V6.0V  V6.1V  V6.2V	  V
V  End Adres	 0000	 2.3	  ZWWW[ ZWWW[	ZWWW[  ZWWW[  ZWWW[	  V
V  Play Freq	 000k	 2.4	  XWWWY XWWWY	XWWWY  XWWWY  XWWWY	  V
V  Volume	 0000	 2.5	  V5.2V V5.3V	V6.3V  V6.4V  V6.5V	  V
V  Repeat	 0000	 2.6	  ZWWW[ ZWWW[	ZWWW[  ZWWW[  ZWWW[	  V
V									  V
V				  XWWWWY XWWWWY XWWWWY	XWWWWY XWWWWY	  V
V  Position-1	 0000	 3.0	  V 7.0V V 7.1V V 7.2V	V 7.3V V 7.4V	  V
V  Position-2	 0000	 3.1	  ZWWWW[ ZWWWW[ ZWWWW[	ZWWWW[ ZWWWW[	  V
V  Rec. Freq	 000k	 3.2						  V
V				    S  A  M  P	B  O  X   4  M a c r o	  V
ZWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWW[


Bijlage II.	Tabel van de toetsenbordmatrix

		      Kolom

	  7   6   5   4   3   2   1   0
	+---+---+---+---+---+---+---+---+	DTS - Dode toets
      0 | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 |	COD - Code
	+---+---+---+---+---+---+---+---+	CAP - Caps
      1 | ; | ] | [ | \ | = | - | 9 | 8 |	GRP - Graph
	+---+---+---+---+---+---+---+---+	CTR - Ctrl
      2 | B | A |DTS| / | . | , | ` | ' |       SHF - Shift
	+---+---+---+---+---+---+---+---+	RET - Return
      3 | J | I | H | G | F | E | D | C |	SEL - Select
   R	+---+---+---+---+---+---+---+---+	BS  - Back space
   i  4 | R | Q | P | O | N | M | L | K |	TAB - Tab
   j	+---+---+---+---+---+---+---+---+	ESC - Escape
      5 | Z | Y | X | W | V | U | T | S |	RGT - Right
	+---+---+---+---+---+---+---+---+	DWN - Down
      6 |F3 |F2 |F1 |COD|CAP|GRP|CTR|SHF|	UP  - Up
	+---+---+---+---+---+---+---+---+	LFT - Left
      7 |RET|SEL|BS |STP|TAB|ESC|F5 |F4 |	DEL - Delete
	+---+---+---+---+---+---+---+---+	INS - Insert
      8 |RGT|DWN|UP |LFT|DEL|INS|HOM|SPC|	HOM - CLR/HOME
	+---+---+---+---+---+---+---+---+	SPC - Space



Bijlage III.	BIOS-routines (normale replayer)


Naam:		INIMUZ.
Adres:		&H4000
Invoer: 	Geen.
Uitvoer:	HL - Aantal segmenten vrijgegeven door MemMan.
Wijzigt:	Alles.
Omschrijving:	Initialiseert de routine.
      

Naam:		LDSAMP.
Adres:		&H4003
Invoer: 	HL - Adres string (d:FILENAME.EXT), B - Lengte string.
Uitvoer:	A - Foutcode.
Wijzigt:	Alles.
Omschrijving:	Laad een sample in het geheugen.


Naam:		STGTRG.
Adres:		&H4006
Invoer: 	A - Register/data.
Outvoer:	A - Eventuele data.
Wijzigt:	Alles.
Omschrijving:	Heeft hetzelfde effect als USR in BASIC (zie par. 5.3 - 5.6)

