!AWMay91/Goodies/Coconizer/!Coconizer/ReadMe

Home » Archimedes archive » Archimedes World » AW-1991-05.adf » May91 » !AWMay91/Goodies/Coconizer/!Coconizer/ReadMe

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk:	Home » Archimedes archive » Archimedes World » AW-1991-05.adf » May91
Filename:	!AWMay91/Goodies/Coconizer/!Coconizer/ReadMe
Read OK:	✔
File size:	9983 bytes
Load address:	0000
Exec address:	0000

   *******************************************************************
   *                                                                 *
   *  The Archimedes Coconizer SoundTracker , Version 1.31 - ReadMe  *
   *                                                                 *
   *                         3rd March 1991                          *
   *                                                                 *
   *******************************************************************



The Coconizer consists of the following disc structure:

   The directory "!Coconizer" It contains the main program,  the  "Ready?" 
                              text (Coco's history) and this ReadMe file.

   The directory "Tools"      It contains the tools:
                              - Locater
                              - Modul
                              - Player, Turbo, Play
                              - Changer
                              - WipeRest, WipeSame
                              - LinLog
                              - AmiTrans

   The file "location"        It holds the instruments' allocation.

   The directories "SongsX"   They hold some of your song files.

   The "Sample Discs xx"      They are containing your instruments.




 SOME GENERAL NOTES
 ==================

The  Coconizer SoundTracker uses a method of managing songs that  is  very 
similar  to  other soundtrackers.  The whole program,  its tools  and  the 
player(s) are Freeware (see end of text for further details).

Well, there are some basic ideas when writing a new song:

 - First of all,  you should title your song, up to 19 characters long, or 
   rather type in your name and use the songs' file name as  title.  After 
   that you could choose the song format, that is, four or eight channels. 
   Let's explain what this means.
   The  eight channel format uses the eight independent stereo  voices  of 
   the Archimedes for playing.  And believe me, they sound a lot of better 
   than four channels (what surprise).  But as a result,  the player needs 
   more  processor  speed to handle  the  requested  sound_buffers.  Well, 
   whilst using Coco you won't and needn't care but if you think you  need 
   a song for a (fast) program then you've to judge (or test) which format 
   is to be preferred.  Nevertheless,  your Archimedes is very fast and so 
   it's well possible to play an eight voices song AND run a  program,  if 
   not programmed unskilled...
   On  the other side there is the four channel format,  using  only  four 
   voices at once,  like other computers do. The player routine needs less 
   time of the Arc in this mode.  And somebody knowing how to compose will 
   achieve quite cool songs with just four channels.

 - Well,  then let's begin. Now you could define some instruments you wish 
   to  use in your composition (for an explanation of what  an  instrument 
   is,  see paragraph "Instruments" please). They are labelled from "a" to 
   "z", resulting in a total instrument pool of 26 samples at once (though 
   future versions of Coco could allow the usage of more samples).  It  is 
   not  possible  to  create a pattern without one  instrument  loaded  at 
   least.

 - After this you may start editing the song itself.  Please read the next 
   chapter for full instructions on the usage of Coco.
   Well, what is a song?
   A songs consists of several patterns, each of them is 64 lines dept and 
   four  or  eight rows wide,  depending on the selected  channel  format. 
   Patterns are used to allow you to repeat several parts in your song and 
   to keep and/or beat the time,  and to keep the overview of course.  The 
   patterns hold the informations of the tones and how to play them.


 Let's see an example of how a tone is build up:

    C#0 a F 05
    / | |  \ \\_ Info Byte (left and right nibble)
   /  | |   \
  /   | |    \Command (or Effect)
 /    | |
Note  | Instrument number
      |
 Octave number


   And the interpretation of this information is easiest:

   � "C"  is the international C in this case,  the "0" holds  the  octave 
     number, here Octave zero. Current octaves are in the range from -3 to 
     +4,  and  this  means  even  some extremely low  or  high  notes  are 
     possible, especially for special sound effects.
     Further the note is played as "C Sharp". The "#" always indicates the 
     Sharp of a tone.
     If the note entry contains nothing, than no (new) note is played.
   � The  "a"  entry says that instrument "a" (that is the first  one)  is 
     used to play the note.  By selecting an instrument its volume is  set 
     to its default value.
     If the instrument byte contains nothing,  then the last selected  one 
     is used, inclusive its last volume.
   � The next entry "F" holds the desired command or effect.  In this case 
     command "Set Speed" (see below for a list of all commands).
   � And the last entry "05" is the Infobyte,  it contains values for  the 
     selected command/effect. In this case "Set Speed to 05".


   Quite  difficult?  Oh no.  All these informations are displayed  in  an 
   expanded form in the head line of the edit window.


Fine, now let's continue with the main steps...

 - After creating some patterns, you could choose the sequence of them, ie 
   setting the play order of the patterns.

 - Further  you could change the default setting of your selected  instru-
   ments.  Each of them has its own default Volume,  RepeatAt and  Repeat-
   Length.
   The  default  volume  of  an instrument is used  for  playing  when  an 
   instrument  is selected by the letter "a" - "z".  But the command "C  = 
   Set volume" overwrites this of course.
   If  Repeat_At  is  zero,  then your instrument  will  be  silent  after 
   arriving at the samples' end.  That means, the tone just sounds as long 
   as its sample is played.
   When set, then the instrument will start and be repeated at this offset 
   number, whilst playing <Repeat_Lenght> bytes each time.

 - And last but not least the stereo positions of the channels.  If a song 
   is started, they are set in a quite logical way. Beginning with channel 
   one at the most left stereo position,  ending with channel eight at the 
   most right position.  In four channel mode the two most right and  most 
   left stereo positions are not set.
   For finer control, there's a command available which allows the setting 
   of all stereo positions whilst playing.



 COCO'S COMMANDS AND EFFECTS
 ===========================

Although  programmed  in the same way,  we should  distinguish  between  a 
command and an effect. A command is performed once, like Set Speed, or Set 
Volume,  together with new playing instructions,  ie notes. And an effect, 
like Arpeggio or Sliding, etc. is performed every interrupt call, that is, 
it's not performed when set, but at the following five (or more, depending 
onto  speed) interrupt calls,  which are made until the next new  note  is 
played.  Of course you can perform commands/effects without playing a  new 
tone.
As  the used interrupt is called every Vsync (frame fly),  the  expression 
"every  interrupt"  and  "every  Vsync" mean the  same  in  the  following 
context.  And  as the Vsync event usually has 50Hz,  multisync modes  will 
change the play speed (but you could correct the counter appropriate).


The following effects/commands are currently available (indeed they  could 
increase to a theoretical amount of &FF) :

 * EFFECT &00 :
   Use  arpeggio  playing.  That is,  swap the note value 5  times  whilst 
   playing, this is the default. Or exactly: swap it <speed-1> times.
   During these <speed-1> steps the following is performed:
   1) Add left nibble of infobyte to the note value (and play).
   2) Add right nibble to the origin note (and play this).
   3) Play origin (base) note.
   4) Do step 1 again, ie add left nibble, etc.
   5) Do step 2 again, ie add right nibble, etc.

   For example, commando arpeggio playing, infobyte contains &54. The tone 
   which must be played is entered as "D". So at the first step, nibble &5 
   is added to the original note, resulting in the tone "G" (D - D sharp - 
   E - F - F sharp - G). This is played.
   At the second step,  nibble &4 is added to the original,  resulting  in 
   the tone "F Sharp". It is played, and so on.
   Originally  invented on four (and less) channel computers for  allowing 
   their voices to sound a little bit "fuller", and other effects.

 * EFFECT &01 :
   Slide up tone,  ie add the infobyte*64 to the output frequency, this is 
   usually 5 times (depending onto the speed) while playing a note,  until 
   a  certain frequency is achieved.  Invented for being able to  simulate 
   Amiga periods.

 * EFFECT &02 :
   Slide down tone, subtract infobyte*64 from frequency, <speed-1> times a 
   play, until a certain frequency (Amiga period) is achieved.

 * EFFECT &03 :
   Slide  up  volume.  Every first vsync,  the infobyte is  added  to  the 
   current volume (of the current instrument).  Because of the LSB  (lower 
   sign bit) format of the sample system, only even infobytes are allowed, 
   to achieve smooth sliding.

 * EFFECT &04 :
   Slide down volume.  Subtract infobyte every first Vsync,  for  allowing 
   slow sliding.

 * EFFECT &05 :
   Slide Arc pitch up.  Add infobyte*16 to frequency.  No maximum. This is 
   the preferred pitch sliding.

 * EFFECT &06 :
   Slide Arc pitch down.  Subtract infobyte*16.  Minimum is zero.  This is 
   the preferred pitch sliding.

 * COMMAND &07 :
   Set the stereo position of the current channel to infobyte value.  Each 
   used  channel  may  have its own  stereo  position.  The  infobyte  can 
   indicate one of the following 7 positions:

          01 100% Left Channel
          02  83% Left Channel
          03  67% Left Channel
          04      Center
          05  67% Right Channel
          06  83% Right Channel
          07 100% Right Channel

 * COMMAND &08 :
   Start  auto  volume_up.  That is,  slide up the volume of  the  current 
   instrument in this channel by the infobyte every first Vsync,  from now 
   on. This will be done automatically.
   In order to clear this auto flag, you've to use command effect &08 with 
   infobyte containing zero.

 * COMMAND &09 :
   Start auto volume_down. Appropriate to &08.
   Clear this auto flag by selecting same command + zero infobyte.

 * COMMAND &0A :
   Start auto sliding_up.  That is,  slide up the pitch (frequency)  every 
   vsync automatically with the infobyte value.
   Clear this auto flag by selecting same command + zero infobyte.

 * COMMAND &0B :
   Start auto sliding_down. Appropriate to &0A.
   Clear this auto flag by selecting same command + zero infobyte.

 * COMMAND &0C :
   Set  volume  of  the current instrument (on  current  channel)  to  the 
   infobyte  value.  The  volume is in the linear range from &00  to  &ff, 
   where  0 is loudest and 255 totally quiet.  Please note the LSB  sample 
   format (ie use only even numbers).

 * COMMAND &0D :
   Pattern  Break.  When  this command is set then the  whole  pattern  is 
   terminated,  and  the next one in the sequence is started.  It  doesn't 
   matter which channel activates it.

 * COMMAND &0F :
   Set  the  play speed to value contained in the  infobyte.  The  default 
   speed is 6.  That is, if the Vsync counter (interrupt counter) achieves 
   the  selected  speed,  then  the next pattern  information  has  to  be 
   interpreted (a new note is played) and the counter is reset.


An additional note to the auto commands:  Although these auto commands are 
executed as commands,  they actually make their appropriate effects to  be 
started.  They  are invented to allow you to make multiple effects at  the 
same time.  Even all four auto effects may be active at the same time  (or 
rather: after setting one, the next may be set too). Please don't "forget" 
an  auto effect when set once.  Clear it by setting the  command  together 
with infobyte zero.  Like the other effects,  the auto fx are performed in 
the  time between two new notes,  that is <speed-1> times,  and only if  a 
tone for this channel is (still) active.



 THE INSTRUMENTS
 ===============

Well,  an instrument is a digitised sample file.  Digitised at an original 
base octave (for example middle C).  Some people digitise(d) their samples 
at  other  octaves.  So don't wonder when hearing  different  instruments, 
about  having different base octaves.  If you digitise a new  sample  then 
please  do  it  at the default octave else  there's  confusion  about  the 
entered value and the actual played pitch of a note!  Current  instruments 
should not exceed the length of 64 KBytes.

A sample file contains digitised data bytes.  But what's with them?  Well, 
let's see what the manual says...
 The  sound DMA system of the Archimedes systematically outputs  the  data 
 bytes at a programmed sample rate;  each (16-byte) load of DMA data  from 
 memory is synchronized to the first stereo image position. Each byte must 
 be  stored as an eight bit signed logarithm,  ready for direct output  to 
 the VIDC chip:
 Multiple  channel  operations  are  possible  with  two,  four  or  eight 
 channels. When output the channels are multiplexed into what is effectiv-
 ely  one  half,  one quarter or one eight of the sample  period,  so  the 
 signal  level  per channel is scaled down by the same  amount.  Thus  the 
 signal level per channel is scaled,  depending on the number of channels; 
 but  the  overall  signal level remains the same for  all  multi  channel 
 modes.

Well,  why telling this?  Look,  there are some things resulting from  the 
VIDC 8 bit logarithm LSB (lower sign bit) format:
 If  you  digitise and/or handle a new sample with  appropriate  software, 
 then the resulting file often is a (signed) linear one and therefore  not 
 ready for direct sound output.  It first have to be converted by the tool 
 "LinLog" into the VIDC pleased signed logarithm format,  in order to  use 
 it with Coconizer.
 If  you create a synthetic sample,  ie the data bytes are created  by  an 
 algorithm (for example sinus or rectangle waves) then usually they are of 
 linear form and should be converted into the VIDC format.

And  last but not least some technical details to the maximum and  default 
sample rate.
 A high sample rate will give the best sound quality.  If too high a  rate 
 is  sought then DMA request conflicts will occur,  especially  when  high 
 bandwidths are also required from the Video Controller by high resolution 
 screen  modes.  To avoid such contentions the output period must  not  be 
 less  than 4 �s.  Outputting a byte to one of eight channels every  4  �s 
 results in a sample period of 32 �s, which gives a maximum sample rate of 
 31.25  kHz with eight active channels (with one active channel  even  250 
 kHz! CD players usually have about 42 kHz).
 Current ARM based computers use a VIDC system clock of 24  MHz;  however, 
 20 MHz and 28 MHz clocks are also supported. The default output period is 
 the shortest one that can be derived from all three clocks, thus ensuring 
 that  music  can  be  produced at the same pitch  on  any  likely  future 
 hardware.  This  is 6 �s.  Outputting a byte to one of eight every  6  �s 
 results in a sample period of 48 �s, which gives a default sample rate of 
 20.833 kHz.

This is what the manual says. And as Coco plays four or eight channels, we 
decided  to keep the default sample rate,  ie its sample period of 48  �s. 
You'll  find this value at the beginning of the player routines (and  some 
tools). Although you could change this - there's no actual reason to do so 
(believe me).

And the final conclusion:  A song just sounds as well as the used  samples 
(instruments)  are  digitised.  There  are samples  which  end  immediate, 
resulting  in  an abrupt click.  To avoid this you either  could  use  the 
command "Slide Volume down" when playing a note with this instrument. Then 
you  get  a volume envelope (getting quieter),  so the  "click"  won't  be 
heard.  Or you could search for a better instrument, ie use smooth samples 
only, obviously this should be the more preferred way...



 THE LOCATION OF INSTRUMENTS AND SONGS
 =====================================

The  samples are located on several discs (it's up to you to  expand  your 
collection). All files together are allocated in a file called "location". 
It  holds  the name,  length and directory number of each  sample  (file). 
After  adding  new samples to your existing ones you should run  the  tool 
"Locater" to scan them.

As  ADFS just allows a maximum of 77 directory entries,  the sample  files 
have  to be split up into several directories.  They are  named  "InstA.", 
"InstB.", "InstC.", and so on.
In  order to be able to calculate the disc number out from  the  directory 
number,  you  should always create pairs of InstX  dirs.  So,  always  two 
instrument directories must be on one sample disc.

Same thing with the songs.  They should be in several song directories. To 
keep  the overview,  Coco scans only directory names of the type  "S*"  at 
'Set  Directory'.  The song files may be of normal or packed  file  format 
(Packet).  You enter the 'Set Directory' mode by clicking the "D" icon  in 
the  song selection window (when you are the MAIN menu,  ie  nothing  else 
selected).

To install Coconizer on Harddisc or Disc,  see the "Ready?" text or Coco's 
!Boot file please.



 THE COCONIZER USAGE
 ===================

As a guideline for the mouse handling, the left button incs/decs slow, the 
mid button steps normal,  and the right button steps fast through a  list. 
When  changing  default settings like RepeatAt,  then  pressing  the  left 
button together with the right one step very fast.
With  some control icons like "Play" and "Load Inst/Song",  the  left  and 
right  button  perform  different actions.  The  left  one  continues  (if 
possible)  from the last stopped position,  and the right one begins  from 
the start, ie restarts.

You toggle channels on/off by clicking on the voice number (to the left to 
the graphic equalizer).  This will help you editing a song and isolating a 
single voice for controlling it.
When  playing a song or pattern,  the "DISPLAY" icon toggles  the  channel 
display with the spectrum analyzer display. During play the cursor up/down 
arrows control the overall volume (useful for external audio output).


It follows an overview about the main icons:

 * LOAD SONG
   Clicking  this icon opens the selection window.  To be able to  load  a 
   song, you should have inserted a disc with a song directory. The showed 
   songs are those of the default directory "Songs".  Please click the "D" 
   icon whilst being in the main menu (ie not at LOAD SONG) to set another 
   song directory.
   After loading the song,  the used instruments are loaded. So there will 
   be  more  or  less disc changes to be done.  Coco  always  loads  these 
   instruments  beginning  with  your Sample Disc 01  in  ascending  (disc 
   sorted) order. Instruments which couldn't be found in the location file 
   are  shown red,  and similar samples should be loaded  instead  (please 
   note, they can't be heard when they are red!).
   If the message "INSERT SAMPLE DISC xx" appears,  and you just  inserted 
   the  right  sample  disc  (or use a HD),  then  this  shows  that  your 
   "location"  file  is  not updated,  ie Coco thinks there  would  be  an 
   instrument that actually is not on your discs or in another InstX  than 
   specified.  Please relocate your sample discs with the tools  "Locater" 
   in such cases.

   An alternative way of loading songs is to drag or double click them  in 
   the  usual directory viewer method of the desktop.  For use  with  more 
   than one disc drive this method saves some disc changes.

 * SAVE SONG
   Your  work will be saved after entering a save name.  Packed saving  is 
   asked  for.  The  operation may be cancelled via the ESC  key.  If  the 
   saving  should fail,  you will notice an appropriate blinking  message. 
   Please click a button to clear the message, then retry.

   An  alternative  way  of  saving a song is via  the  "SaveBox"  of  the 
   Coconizer icon. This works in the usual desktop manner.

 * LOAD INST
   A  new  instrument  is  added to the instrument  pool  if  the  current 
   instrument place is empty,  and an old one is replaced with the new one 
   if its place was already used.
   The  number to the right of the instrument in the selection list  holds 
   the  K Bytes  of the sample on disc.  The following number  shows  onto 
   which disc it is located.

 * PLAY
   Clicking the left mouse button continues playing the song,  at the last 
   stopped  position  (if possible).  The middle button continues  at  the 
   beginning  of the last stopped pattern.  And the right button  restarts 
   the song from its beginning.

 * STOP
   Used  to  stop playing,  to leave the edit modus and  to  stop  pattern 
   playing.  When clicked in edit & play_pattern (debug off) then the left 
   button stops,  and sets the cursor to the last played line.  The  right 
   button sets the cursor to the top of the pattern.

 * EDIT PATTERN
   For  editing  there must be one loaded instrument at  least.  Then  the 
   current pattern number is entered.  You may step through your  patterns 
   by clicking the left/right arrow at the pattern number.
   If  you wish to create a new pattern,  then you've to select the  blank 
   pattern  after  the last one available,  you've to do this  before  you 
   click the EDIT icon.
   Quit editing with either the STOP icon or the ENTER key.

   Informations about the keymap:
     The  function keys F1 - F8 set the cursor to the equivalent  channel. 
     TAB jumps to the next channel row.
     If  the  cursor  is at the note row of a  channel,  then  pressing  a 
     "piano"  key  will  enter the pushed note &  current  octave.  A  new 
     instrument  entry will be performed if it was not the same  like  the 
     last  one.  Keypad keys "+" and "-" (or the octave icon) changes  the 
     current octave.
     Moving  the cursor allows you to enter all other  informations,  like 
     commands,  and  so on.  With Page up/down you step to  the  next/last 
     green mark.  RETURN steps to the upper right cursor position and  the 
     "~" key mutes all sound activity.

   Paste/delete functions:
     "Backspace"  clears  the current information entry.  Key  "-"  clears 
     either the note,  inst, command or the infobyte entry, depending onto 
     the cursor position.
     "Insert"  inserts  a  free tone entry at  your  current  voice.  With 
     "Delete" you kill one tone and shifts the followers up.
     The  keypad "/" deletes one whole channel row and keypad "*"  deletes 
     one  whole line.  And finally the "Home" key copies all 64  tones  of 
     your current channel into a buffer (doing a flash to indicate  this), 
     the "Copy" key writes the buffer back to the current channel.

 * PLAY PATTERN
   This command is for repeated playing of the current pattern.
   Clicking this icon in edit mode with debug on, changes its meaning: All 
   keyboard presses are recorded.  The pattern is played,  and your inputs 
   are directly entered to the current cursor position.

 * DEBUG on (off)
   If  you're in edit mode,  and debug is on,  then all the notes  of  one 
   pattern line are played when moving the cursor up/down.  This allows  a 
   very exact way of editing and/or finding "wrong" notes.
   If "play pattern" is active then recording works with slow motion,  and 
   some  keys,  like the space bar and the cursor  keys,  perform  special 
   actions.  The speed of the "slow motion" may be set with function  keys 
   F9-F12, in Vsyncs: F9=3, F10=5, F11=7, F12=12.
   Note that "debug_on" disables effects of being performed, cause of slow 
   motion (that even means "play pattern" mutes the effects too).

 * EDIT SEQUENCE
   The  selection  window  opens  and you may choose  the  order  of  your 
   patterns.  With  "Enter" you input a new pattern number,  or  edit  the 
   current one.  "Insert" copies the current pattern number and shifts its 
   followers downwards,  "Delete" clears the current number and shifts the 
   others upwards.
   The  pattern number at your cursor position is displayed in the  bottom 
   window and is set as "last stopped at" (for PLAYing,  started with  the 
   left button).

 * COMMANDS
   Well,  obviously this icon lets you enter some CLI commands of the  OS. 
   Certain  restrictions  are made to avoid a system crash  by  running  a 
   second program or other fatal things, etc.

 * RESTART
   Well,  clicking this icon restarts the Coconizer, ie you will loose all 
   your work after confirming the safety request.
   Cause of other memory management of the two different channel  formats, 
   it's  not  possible to change to the other format whilst working  at  a 
   song.  Only after restarting (and loosing your old song) you can select 
   the desired channel format. If you wish to change the channel format of 
   a saved song then use the tool "Changer" please.

 * QUIT
   By clicking this icon you swap back to the desktop.  All your work  and 
   current  pointers  are  saved  until  you  re-enter  Coco  via  iconbar 
   clicking.



 THE TOOLS
 =========

With the Coconizer comes a directory which contains several tools. Some of 
them have already been mentioned. Now a more detailed info.

Locater   :
 When you append new samples to your existing ones, delete, rename or move 
 existing  ones,  then please use this sample allocator.  It  creates  the 
 sample allocation file, containing all your sample names and their (disc) 
 directory positions. Run the "Locator", then insert your first instrument 
 disc.  For disc based use:  please ensure to have dismounted the old disc 
 (ie  *nodir) before,  else the locator can't find new  directories.  This 
 should also be applied to other tools scanning directory informations.
 After the two sample directories of a disc have been scanned, insert your 
 next sample disc and press "Y", or press any other key to start sorting & 
 updating if it was your last disc.

Changer   :
 With  it you have the possibility to convert a song to the other  channel 
 format,  but be careful when converting eight to four channels down cause 
 you will lose half your voices...
 You may select the new voice order, either for the destination song or of 
 the source songfile.
 Please  note  that  this  tool needs the  "Packit"  module  of  directory 
 !Coconizer, it is loaded initially (if necessary).

PackIt    :
 A further tool is the PackIt Module. Because it's used by Coco, this tool 
 is in the !Coconizer directory. You could use this module to achieve more 
 disc capacity.  Of course it's not fixed to song files,  it easily can be 
 used everywhere.  (And it really uses a very simple but fast  compressing 
 method).

WipeRest  :
 To  keep the overview over your sample file collection,  this  tool  will 
 scan all your songs and calculate all the used (needed)  instruments.  It 
 then  allows  the  deletion  of all the  unused  sample  files.  This  is 
 recommended  if you decided to wipe some songs and think that  you  don't 
 need their (now needless) sample files any more.
 Please ensure to enter ALL your song directories when running this  tool, 
 because  only sample files which have been found in those  scanned  songs 
 will be kept (ie not deleted) !

WipeSame  :
 In  case  you have several samples with the same name  but  in  different 
 directories, then this tool will find and delete them.

LinLog    :
 This  utility  converts  signed  linear sample  files  into  Archie  VIDC 
 logarithm LSB files, needed by the Coconizer.
 Copy  your linear samples into a directory called "Samples" on ram  disc, 
 then run "LinLog".  It will convert them to logarithm ones and write them 
 back  to directory "Samples.".  After this you should copy them from  ram 
 disc to your desired sample disc(s), cause your Arc has no idea where you 
 would like to put these new samples on!
 Please note that this program needs the "location" file when started  the 
 first time, therefore it is loaded initially.

AmiTrans  :
 This  utility  allows a limited conversion  of  Amiga  MasterSoundTracker 
 songs  into  a Coconizer song.  Please note that the  Amiga  uses  signed 
 linear sample files.
 Most things are converted pretty correctly.  Some differences may  appear 
 at  the  Slide up/down command.  This is because the  MasterTracker  uses 
 Amiga periods to store its note values.  Sliding up or down just modifies 
 this  period  by  a variable slide step and the  result  is  a  logarithm 
 increase/decrease  of the output frequency.  Coco is build up  on  single 
 note values (internal 01="C" Oct -3,  02="C#" Oct -3,  03="D" Oct -3, and 
 so  on)  which are directly translated into  sample  output  frequencies. 
 Increasing/decreasing the frequency is a totally linear  operation.  This 
 can  lead to some unwanted effects,  but probably most songs  will  sound 
 quite similar. And last but not least you could edit critical sections by 
 hand.
 Great  confusion  is about the different Amiga  SoundTrackers  available. 
 Lots of them only use a base set of compatible commands,  other  commands 
 differ...
 So problems could appear when you try to convert songs from newer tracker 
 formats.  Apart from using up to 31 instruments, some of them support the 
 Amiga hardware possibility of modulating voices which can't be  converted 
 to Coco so far.  This modulating is used for vibrato effects with  either 
 the  period or the volume of one channel depending onto the  sample  data 
 (!) of a next higher channel. Try sliding or arpeggio instead please, and 
 you will achieve quite good vibrato effects. Until now it's very unlikely 
 that we're going to imitate Amiga's "Paula", better concentrating on more 
 important things.
 This tool needs the "PackIt" module too, which is loaded initially.

Modul & Player :
 There are two player routines, an exact descriptions follows. The program 
 "Modul"  creates an autostartable module file from a  song.  That  means, 
 it's an Archimedes module, running in the RMA, whilst you work within the 
 Desktop, or run other programs. For ending it, simply RMKill this module.
 Using  a  song  in this module form is the  first  and  more  comfortable 
 possibility  of using songs together with own programs.  The  second  one 
 allows more direct song control,  like spectrum analyzing,  etc. It works 
 as follows:



 THE STAND ALONE PLAYER ROUTINE
 ==============================

The  Coconizer  Player Routine is a source assembler program  which  plays 
Coconizer songs via interrupt system.  All non technical interested  users 
should ignore the following paragraphs... :

In order to use your songs in your own programs, demos, games, etc, simply 
append the routine "Player" to your source assembler code.  Involve it  in 
your code by inserting a "PROC_Music" at the desired position, recommended 
between  your last closing "]" and the "NEXT pass" statement.  Please  use 
variable  'p' for your two-pass FOR-NEXT loop (because the player makes  a 
check for which pass is running).
The player routine has been written relatively, or rather: it recalculates 
some  addresses  after being called the first time,  so you  needn't  care 
about its location.  Therefore your program should be written  relatively, 
too (this is always preferable).  If not so,  then please adapt the player 
to your additional O% when loading samples, etc.
Please  remember  to reserve enough memory for your code  AND  the  entire 
sound at the beginning of assembling (DIM code xxx).

The music is started by calling "v_on".  Stop it with "v_off". If you like 
to restart your tune whilst play, your program could call "v_reset".
You  could set the overall volume of the player with  "STR Rx,Volume",  in 
the  range  fr fr 00=loud to &ff=totally quiet.  Like Coco  does  it,  you 
should only set even numbers because of the LSB (lower sign bit) format of 
the VIDC.  Otherwise you won't get a fine volume sliding.  When the player 
is  initialised  (after  BL v_on),  the current *VOLUME is  used  for  the 
overall volume.
The music is played via the 'Event' interrupt (&10),  and the sound system 
of the Arc uses repeatedly buffer filling. Under some seldom circumstances 
it's  possible that the used event interrupts the installed  sound  voice, 
resulting in the so called "losing channel syndrome".  The player tries to 
auto-sync at initialising, but after trying three times it aborts. If your 
program  should run with 50Hz then perhaps there's a possibility  to  call 
the  player directly via "BL v_inter" and some other slight changes  (then 
don't forget r12=Head address, originally supplied at the vector claim).

If  you want to make some sound effects (fx) together with the  tune,  you 
should  add your desired effect samples to your song,  as  unused  instru-
ments,  ie  they are loaded in the instrument pool but not played by  your 
song. After initialising the player with "BL v_on" you could call "fx1" to 
"fx4", with r1 containing the sound information. This will produce a sound 
fx on the appropriate channel (1-4),  while the song sound on this channel 
is  muted  until  the  effect has reached its  sample  end  (please  note: 
RepeatAt=On means until the next effect on same channel is started!).
Register  r1 contains the relevant sound information,  it is  exactly  the 
same  longword  that you use when you edit your song.  With top  byte  (3) 
first and low byte (0) last, this is:

 3 : Tone frequency (in half tones, as the effect Arpeggio use).
 2 : Instrument to use, please do not exceed the last instrument number!
 1 : Command or effect number.
 0 : Infobyte.

A BASIC statement example would be...  B%=&25110502 :CALL fx3
This is read as &25-11-05-02 and produces a sound fx on channel 3 :
Tone C#0 is played (=&25 =dez 37, as one octave has 12 halftones, starting 
with number 01 = C-3); with sample number 17 (=&11, instrument "q"); using 
the "Slide effect" (&05) with step &02.  In pattern-edit-form,  this would 
be: C#0 q 5 02

Alternatively you could modify the channel heads directly, to produce your 
sound  effects (the appropriate assembler part is  documented).  Therefore 
you just have to set byte 30 of the appropriate channel head,  in order to 
halt the song sound on this channel (0 means continue song).


There's a second player,  called "Play". But it isn't for use IN a runtime 
program. You start it in BASIC and the song will be played. After this you 
could  set  BASIC's  start value PAGE higher than  the  players  end,  for 
testing  and/or  loading your source program WHILE the sound  is  playing. 
This let you test several things like speed, synchronisation, etc, without 
linking all parts together each time.
Use CALL A% to stop the player (and please do not start other applications 
before  having stopped it!),  and later on CALL B% to reactivate  it.  The 
value  V% points to the overall volume longword.  (Provided  these  static 
variables haven't been corrupted by your program!)


You may freely use and copy the player routine(s).  And of course you  may 
adapt  it  to your requirements when appending it  to  your  program.  But 
please leave the original players and all other tools unchanged.



 SOME FINAL CONCLUSIONS
 ======================

Well, the aim of Coconizer is to allow you to create songs and to use them 
independently (stand alone) in own programs, with the possibility of using 
four or eight Archimedes channels.
Coco's  Player is mainly intended to be included into self made  programs. 
We think most programmers shouldn't have many problems.

And coming back to the "AmiTrans" tool and the known converting  problems: 
It's  not the main aim of Coco to play Amiga songs.  Although we tried  to 
keep several main commands and general structures,  Coconizer was  created 
to  be  an  Archimedes  soundtracker.  If you want  to  hear  Amiga  songs 
exclusively, please use the Player of Hugo Fiennes instead.
And  all assembler fans will see that our routines (try to) use  the  RISC 
32 bit  facilities the ARM provides.  So we use an own (ARM pleased)  song 
format.  We tried to write fast routines,  because lazy interrupt routines 
slow down the whole system considerably.  And though your Arc is very fast 
(yes, it is!), we don't think it's a good idea to waste its speed.


At this point we would like to thank the following people (and even if  we 
don't know all of them directly...) :

 � Guttorm for his news, hints and suggestions.
 � Karsten  Obarski,  Doc  and  others for  inventing  the  popular  Amiga 
   SoundTracker standard, and for a lot of PD songs and instruments.
 � Andy (of JLACS) and a few other nice people for their support.
 � And  finally Acorn for their exquisite Archimedes  series,  implemented 
   Assembler/Debugger and the superb ARM Basic.



 COPYRIGHT & CONTRIBUTIONS
 =========================

So that somebody may benefit from our efforts,  we have decided to set the 
status of Coconizer to FREEWARE.  According to the German law we keep  the 
copyright,  ie Coconizer is our intellectual property.  As the program  is 
free, you may use and copy it freely, with the following restrictions.

Freeware means you may copy as long as:

 1) This is not for commercial purposes.
     (Including charging for the copying!)
 2) That Coconizer and its resources & tools are not tampered with.
     (Except removing/adding samples and songs)
 3) This ReadMe file is always included with Coconizer.


Well, and if you have...

   Suggestion or improvements,
   Found some bugs (we don't hope so),
   Just some questions or comments of all kinds,
   Made a good song and would like to release it as Public Domain,

     ..then why not contacting us?



Well,  as  we always do,  we spent a lot of time and work on this  program 
(although this is our spare time - we don't care).  And perhaps there  are 
some people honouring this. So if you think that Coco is quite nice, or if 
you would like to support the authors for further programs on that  superb 
Archimedes, then why not sending a small donation or something in that way 
(like a nice 'Hello' :-)  to...


          ..either                      ..or

          Thomas Alber                  Eduard Pfarr
          Oggelshauserstrasse 7         Atzenbergerstrasse 2
          W-7952 Bad Buchau             W-7953 Otterswang

          Germany                       Germany



As  you  see,  we're  (unfortunately) no english men and so  we  hope  you 
understand  our terrible English in this text.  Always remember:  A  human 
should at least laugh three times a day - this file gives the impulse...



                  Written by Eduard Pfarr & Thomas Alber
                        (c) July 1990 by Playfield

00000000  0a 20 20 20 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |.   ************|
00000010  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00000040  2a 2a 2a 2a 2a 2a 2a 0a  20 20 20 2a 20 20 20 20  |*******.   *    |
00000050  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000080  20 20 20 20 20 20 20 20  20 20 20 20 20 2a 0a 20  |             *. |
00000090  20 20 2a 20 20 54 68 65  20 41 72 63 68 69 6d 65  |  *  The Archime|
000000a0  64 65 73 20 43 6f 63 6f  6e 69 7a 65 72 20 53 6f  |des Coconizer So|
000000b0  75 6e 64 54 72 61 63 6b  65 72 20 2c 20 56 65 72  |undTracker , Ver|
000000c0  73 69 6f 6e 20 31 2e 33  31 20 2d 20 52 65 61 64  |sion 1.31 - Read|
000000d0  4d 65 20 20 2a 0a 20 20  20 2a 20 20 20 20 20 20  |Me  *.   *      |
000000e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000110  20 20 20 20 20 20 20 20  20 20 20 2a 0a 20 20 20  |           *.   |
00000120  2a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |*               |
00000130  20 20 20 20 20 20 20 20  20 20 33 72 64 20 4d 61  |          3rd Ma|
00000140  72 63 68 20 31 39 39 31  20 20 20 20 20 20 20 20  |rch 1991        |
00000150  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000160  20 20 2a 0a 20 20 20 2a  20 20 20 20 20 20 20 20  |  *.   *        |
00000170  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000001a0  20 20 20 20 20 20 20 20  20 2a 0a 20 20 20 2a 2a  |         *.   **|
000001b0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
000001f0  2a 0a 0a 0a 0a 54 68 65  20 43 6f 63 6f 6e 69 7a  |*....The Coconiz|
00000200  65 72 20 63 6f 6e 73 69  73 74 73 20 6f 66 20 74  |er consists of t|
00000210  68 65 20 66 6f 6c 6c 6f  77 69 6e 67 20 64 69 73  |he following dis|
00000220  63 20 73 74 72 75 63 74  75 72 65 3a 0a 0a 20 20  |c structure:..  |
00000230  20 54 68 65 20 64 69 72  65 63 74 6f 72 79 20 22  | The directory "|
00000240  21 43 6f 63 6f 6e 69 7a  65 72 22 20 49 74 20 63  |!Coconizer" It c|
00000250  6f 6e 74 61 69 6e 73 20  74 68 65 20 6d 61 69 6e  |ontains the main|
00000260  20 70 72 6f 67 72 61 6d  2c 20 20 74 68 65 20 20  | program,  the  |
00000270  22 52 65 61 64 79 3f 22  20 0a 20 20 20 20 20 20  |"Ready?" .      |
00000280  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000290  20 20 20 20 20 20 20 20  74 65 78 74 20 28 43 6f  |        text (Co|
000002a0  63 6f 27 73 20 68 69 73  74 6f 72 79 29 20 61 6e  |co's history) an|
000002b0  64 20 74 68 69 73 20 52  65 61 64 4d 65 20 66 69  |d this ReadMe fi|
000002c0  6c 65 2e 0a 0a 20 20 20  54 68 65 20 64 69 72 65  |le...   The dire|
000002d0  63 74 6f 72 79 20 22 54  6f 6f 6c 73 22 20 20 20  |ctory "Tools"   |
000002e0  20 20 20 49 74 20 63 6f  6e 74 61 69 6e 73 20 74  |   It contains t|
000002f0  68 65 20 74 6f 6f 6c 73  3a 0a 20 20 20 20 20 20  |he tools:.      |
00000300  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000310  20 20 20 20 20 20 20 20  2d 20 4c 6f 63 61 74 65  |        - Locate|
00000320  72 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |r.              |
00000330  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000340  2d 20 4d 6f 64 75 6c 0a  20 20 20 20 20 20 20 20  |- Modul.        |
00000350  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000360  20 20 20 20 20 20 2d 20  50 6c 61 79 65 72 2c 20  |      - Player, |
00000370  54 75 72 62 6f 2c 20 50  6c 61 79 0a 20 20 20 20  |Turbo, Play.    |
00000380  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000390  20 20 20 20 20 20 20 20  20 20 2d 20 43 68 61 6e  |          - Chan|
000003a0  67 65 72 0a 20 20 20 20  20 20 20 20 20 20 20 20  |ger.            |
000003b0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000003c0  20 20 2d 20 57 69 70 65  52 65 73 74 2c 20 57 69  |  - WipeRest, Wi|
000003d0  70 65 53 61 6d 65 0a 20  20 20 20 20 20 20 20 20  |peSame.         |
000003e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000003f0  20 20 20 20 20 2d 20 4c  69 6e 4c 6f 67 0a 20 20  |     - LinLog.  |
00000400  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000410  20 20 20 20 20 20 20 20  20 20 20 20 2d 20 41 6d  |            - Am|
00000420  69 54 72 61 6e 73 0a 0a  20 20 20 54 68 65 20 66  |iTrans..   The f|
00000430  69 6c 65 20 22 6c 6f 63  61 74 69 6f 6e 22 20 20  |ile "location"  |
00000440  20 20 20 20 20 20 49 74  20 68 6f 6c 64 73 20 74  |      It holds t|
00000450  68 65 20 69 6e 73 74 72  75 6d 65 6e 74 73 27 20  |he instruments' |
00000460  61 6c 6c 6f 63 61 74 69  6f 6e 2e 0a 0a 20 20 20  |allocation...   |
00000470  54 68 65 20 64 69 72 65  63 74 6f 72 69 65 73 20  |The directories |
00000480  22 53 6f 6e 67 73 58 22  20 20 20 54 68 65 79 20  |"SongsX"   They |
00000490  68 6f 6c 64 20 73 6f 6d  65 20 6f 66 20 79 6f 75  |hold some of you|
000004a0  72 20 73 6f 6e 67 20 66  69 6c 65 73 2e 0a 0a 20  |r song files... |
000004b0  20 20 54 68 65 20 22 53  61 6d 70 6c 65 20 44 69  |  The "Sample Di|
000004c0  73 63 73 20 78 78 22 20  20 20 20 20 20 54 68 65  |scs xx"      The|
000004d0  79 20 61 72 65 20 63 6f  6e 74 61 69 6e 69 6e 67  |y are containing|
000004e0  20 79 6f 75 72 20 69 6e  73 74 72 75 6d 65 6e 74  | your instrument|
000004f0  73 2e 0a 0a 0a 0a 0a 20  53 4f 4d 45 20 47 45 4e  |s...... SOME GEN|
00000500  45 52 41 4c 20 4e 4f 54  45 53 0a 20 3d 3d 3d 3d  |ERAL NOTES. ====|
00000510  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 0a 0a  |==============..|
00000520  54 68 65 20 20 43 6f 63  6f 6e 69 7a 65 72 20 53  |The  Coconizer S|
00000530  6f 75 6e 64 54 72 61 63  6b 65 72 20 75 73 65 73  |oundTracker uses|
00000540  20 61 20 6d 65 74 68 6f  64 20 6f 66 20 6d 61 6e  | a method of man|
00000550  61 67 69 6e 67 20 73 6f  6e 67 73 20 74 68 61 74  |aging songs that|
00000560  20 20 69 73 20 20 76 65  72 79 20 0a 73 69 6d 69  |  is  very .simi|
00000570  6c 61 72 20 20 74 6f 20  20 6f 74 68 65 72 20 73  |lar  to  other s|
00000580  6f 75 6e 64 74 72 61 63  6b 65 72 73 2e 20 20 54  |oundtrackers.  T|
00000590  68 65 20 77 68 6f 6c 65  20 70 72 6f 67 72 61 6d  |he whole program|
000005a0  2c 20 20 69 74 73 20 74  6f 6f 6c 73 20 20 61 6e  |,  its tools  an|
000005b0  64 20 20 74 68 65 20 0a  70 6c 61 79 65 72 28 73  |d  the .player(s|
000005c0  29 20 61 72 65 20 46 72  65 65 77 61 72 65 20 28  |) are Freeware (|
000005d0  73 65 65 20 65 6e 64 20  6f 66 20 74 65 78 74 20  |see end of text |
000005e0  66 6f 72 20 66 75 72 74  68 65 72 20 64 65 74 61  |for further deta|
000005f0  69 6c 73 29 2e 0a 0a 57  65 6c 6c 2c 20 74 68 65  |ils)...Well, the|
00000600  72 65 20 61 72 65 20 73  6f 6d 65 20 62 61 73 69  |re are some basi|
00000610  63 20 69 64 65 61 73 20  77 68 65 6e 20 77 72 69  |c ideas when wri|
00000620  74 69 6e 67 20 61 20 6e  65 77 20 73 6f 6e 67 3a  |ting a new song:|
00000630  0a 0a 20 2d 20 46 69 72  73 74 20 6f 66 20 61 6c  |.. - First of al|
00000640  6c 2c 20 20 79 6f 75 20  73 68 6f 75 6c 64 20 74  |l,  you should t|
00000650  69 74 6c 65 20 79 6f 75  72 20 73 6f 6e 67 2c 20  |itle your song, |
00000660  75 70 20 74 6f 20 31 39  20 63 68 61 72 61 63 74  |up to 19 charact|
00000670  65 72 73 20 6c 6f 6e 67  2c 20 6f 72 20 0a 20 20  |ers long, or .  |
00000680  20 72 61 74 68 65 72 20  74 79 70 65 20 69 6e 20  | rather type in |
00000690  79 6f 75 72 20 6e 61 6d  65 20 61 6e 64 20 75 73  |your name and us|
000006a0  65 20 74 68 65 20 73 6f  6e 67 73 27 20 66 69 6c  |e the songs' fil|
000006b0  65 20 6e 61 6d 65 20 61  73 20 20 74 69 74 6c 65  |e name as  title|
000006c0  2e 20 20 41 66 74 65 72  20 0a 20 20 20 74 68 61  |.  After .   tha|
000006d0  74 20 79 6f 75 20 63 6f  75 6c 64 20 63 68 6f 6f  |t you could choo|
000006e0  73 65 20 74 68 65 20 73  6f 6e 67 20 66 6f 72 6d  |se the song form|
000006f0  61 74 2c 20 74 68 61 74  20 69 73 2c 20 66 6f 75  |at, that is, fou|
00000700  72 20 6f 72 20 65 69 67  68 74 20 63 68 61 6e 6e  |r or eight chann|
00000710  65 6c 73 2e 20 0a 20 20  20 4c 65 74 27 73 20 65  |els. .   Let's e|
00000720  78 70 6c 61 69 6e 20 77  68 61 74 20 74 68 69 73  |xplain what this|
00000730  20 6d 65 61 6e 73 2e 0a  20 20 20 54 68 65 20 20  | means..   The  |
00000740  65 69 67 68 74 20 63 68  61 6e 6e 65 6c 20 66 6f  |eight channel fo|
00000750  72 6d 61 74 20 75 73 65  73 20 74 68 65 20 65 69  |rmat uses the ei|
00000760  67 68 74 20 69 6e 64 65  70 65 6e 64 65 6e 74 20  |ght independent |
00000770  73 74 65 72 65 6f 20 20  76 6f 69 63 65 73 20 20  |stereo  voices  |
00000780  6f 66 20 0a 20 20 20 74  68 65 20 41 72 63 68 69  |of .   the Archi|
00000790  6d 65 64 65 73 20 66 6f  72 20 70 6c 61 79 69 6e  |medes for playin|
000007a0  67 2e 20 20 41 6e 64 20  62 65 6c 69 65 76 65 20  |g.  And believe |
000007b0  6d 65 2c 20 74 68 65 79  20 73 6f 75 6e 64 20 61  |me, they sound a|
000007c0  20 6c 6f 74 20 6f 66 20  62 65 74 74 65 72 20 0a  | lot of better .|
000007d0  20 20 20 74 68 61 6e 20  66 6f 75 72 20 63 68 61  |   than four cha|
000007e0  6e 6e 65 6c 73 20 28 77  68 61 74 20 73 75 72 70  |nnels (what surp|
000007f0  72 69 73 65 29 2e 20 20  42 75 74 20 61 73 20 61  |rise).  But as a|
00000800  20 72 65 73 75 6c 74 2c  20 20 74 68 65 20 70 6c  | result,  the pl|
00000810  61 79 65 72 20 6e 65 65  64 73 20 0a 20 20 20 6d  |ayer needs .   m|
00000820  6f 72 65 20 20 70 72 6f  63 65 73 73 6f 72 20 20  |ore  processor  |
00000830  73 70 65 65 64 20 74 6f  20 68 61 6e 64 6c 65 20  |speed to handle |
00000840  20 74 68 65 20 20 72 65  71 75 65 73 74 65 64 20  | the  requested |
00000850  20 73 6f 75 6e 64 5f 62  75 66 66 65 72 73 2e 20  | sound_buffers. |
00000860  20 57 65 6c 6c 2c 20 0a  20 20 20 77 68 69 6c 73  | Well, .   whils|
00000870  74 20 75 73 69 6e 67 20  43 6f 63 6f 20 79 6f 75  |t using Coco you|
00000880  20 77 6f 6e 27 74 20 61  6e 64 20 6e 65 65 64 6e  | won't and needn|
00000890  27 74 20 63 61 72 65 20  62 75 74 20 69 66 20 79  |'t care but if y|
000008a0  6f 75 20 74 68 69 6e 6b  20 79 6f 75 20 20 6e 65  |ou think you  ne|
000008b0  65 64 20 0a 20 20 20 61  20 73 6f 6e 67 20 66 6f  |ed .   a song fo|
000008c0  72 20 61 20 28 66 61 73  74 29 20 70 72 6f 67 72  |r a (fast) progr|
000008d0  61 6d 20 74 68 65 6e 20  79 6f 75 27 76 65 20 74  |am then you've t|
000008e0  6f 20 6a 75 64 67 65 20  28 6f 72 20 74 65 73 74  |o judge (or test|
000008f0  29 20 77 68 69 63 68 20  66 6f 72 6d 61 74 20 0a  |) which format .|
00000900  20 20 20 69 73 20 74 6f  20 62 65 20 70 72 65 66  |   is to be pref|
00000910  65 72 72 65 64 2e 20 20  4e 65 76 65 72 74 68 65  |erred.  Neverthe|
00000920  6c 65 73 73 2c 20 20 79  6f 75 72 20 41 72 63 68  |less,  your Arch|
00000930  69 6d 65 64 65 73 20 69  73 20 76 65 72 79 20 66  |imedes is very f|
00000940  61 73 74 20 61 6e 64 20  73 6f 20 0a 20 20 20 69  |ast and so .   i|
00000950  74 27 73 20 77 65 6c 6c  20 70 6f 73 73 69 62 6c  |t's well possibl|
00000960  65 20 74 6f 20 70 6c 61  79 20 61 6e 20 65 69 67  |e to play an eig|
00000970  68 74 20 76 6f 69 63 65  73 20 73 6f 6e 67 20 41  |ht voices song A|
00000980  4e 44 20 72 75 6e 20 61  20 20 70 72 6f 67 72 61  |ND run a  progra|
00000990  6d 2c 20 20 69 66 20 0a  20 20 20 6e 6f 74 20 70  |m,  if .   not p|
000009a0  72 6f 67 72 61 6d 6d 65  64 20 75 6e 73 6b 69 6c  |rogrammed unskil|
000009b0  6c 65 64 2e 2e 2e 0a 20  20 20 4f 6e 20 20 74 68  |led....   On  th|
000009c0  65 20 6f 74 68 65 72 20  73 69 64 65 20 74 68 65  |e other side the|
000009d0  72 65 20 69 73 20 74 68  65 20 66 6f 75 72 20 63  |re is the four c|
000009e0  68 61 6e 6e 65 6c 20 66  6f 72 6d 61 74 2c 20 20  |hannel format,  |
000009f0  75 73 69 6e 67 20 20 6f  6e 6c 79 20 20 66 6f 75  |using  only  fou|
00000a00  72 20 0a 20 20 20 76 6f  69 63 65 73 20 61 74 20  |r .   voices at |
00000a10  6f 6e 63 65 2c 20 20 6c  69 6b 65 20 6f 74 68 65  |once,  like othe|
00000a20  72 20 63 6f 6d 70 75 74  65 72 73 20 64 6f 2e 20  |r computers do. |
00000a30  54 68 65 20 70 6c 61 79  65 72 20 72 6f 75 74 69  |The player routi|
00000a40  6e 65 20 6e 65 65 64 73  20 6c 65 73 73 20 0a 20  |ne needs less . |
00000a50  20 20 74 69 6d 65 20 6f  66 20 74 68 65 20 41 72  |  time of the Ar|
00000a60  63 20 69 6e 20 74 68 69  73 20 6d 6f 64 65 2e 20  |c in this mode. |
00000a70  20 41 6e 64 20 73 6f 6d  65 62 6f 64 79 20 6b 6e  | And somebody kn|
00000a80  6f 77 69 6e 67 20 68 6f  77 20 74 6f 20 63 6f 6d  |owing how to com|
00000a90  70 6f 73 65 20 77 69 6c  6c 20 0a 20 20 20 61 63  |pose will .   ac|
00000aa0  68 69 65 76 65 20 71 75  69 74 65 20 63 6f 6f 6c  |hieve quite cool|
00000ab0  20 73 6f 6e 67 73 20 77  69 74 68 20 6a 75 73 74  | songs with just|
00000ac0  20 66 6f 75 72 20 63 68  61 6e 6e 65 6c 73 2e 0a  | four channels..|
00000ad0  0a 20 2d 20 57 65 6c 6c  2c 20 20 74 68 65 6e 20  |. - Well,  then |
00000ae0  6c 65 74 27 73 20 62 65  67 69 6e 2e 20 4e 6f 77  |let's begin. Now|
00000af0  20 79 6f 75 20 63 6f 75  6c 64 20 64 65 66 69 6e  | you could defin|
00000b00  65 20 73 6f 6d 65 20 69  6e 73 74 72 75 6d 65 6e  |e some instrumen|
00000b10  74 73 20 79 6f 75 20 77  69 73 68 20 0a 20 20 20  |ts you wish .   |
00000b20  74 6f 20 20 75 73 65 20  69 6e 20 79 6f 75 72 20  |to  use in your |
00000b30  63 6f 6d 70 6f 73 69 74  69 6f 6e 20 28 66 6f 72  |composition (for|
00000b40  20 61 6e 20 65 78 70 6c  61 6e 61 74 69 6f 6e 20  | an explanation |
00000b50  6f 66 20 77 68 61 74 20  20 61 6e 20 20 69 6e 73  |of what  an  ins|
00000b60  74 72 75 6d 65 6e 74 20  0a 20 20 20 69 73 2c 20  |trument .   is, |
00000b70  20 73 65 65 20 70 61 72  61 67 72 61 70 68 20 22  | see paragraph "|
00000b80  49 6e 73 74 72 75 6d 65  6e 74 73 22 20 70 6c 65  |Instruments" ple|
00000b90  61 73 65 29 2e 20 54 68  65 79 20 61 72 65 20 6c  |ase). They are l|
00000ba0  61 62 65 6c 6c 65 64 20  66 72 6f 6d 20 22 61 22  |abelled from "a"|
00000bb0  20 74 6f 20 0a 20 20 20  22 7a 22 2c 20 72 65 73  | to .   "z", res|
00000bc0  75 6c 74 69 6e 67 20 69  6e 20 61 20 74 6f 74 61  |ulting in a tota|
00000bd0  6c 20 69 6e 73 74 72 75  6d 65 6e 74 20 70 6f 6f  |l instrument poo|
00000be0  6c 20 6f 66 20 32 36 20  73 61 6d 70 6c 65 73 20  |l of 26 samples |
00000bf0  61 74 20 6f 6e 63 65 20  28 74 68 6f 75 67 68 20  |at once (though |
00000c00  0a 20 20 20 66 75 74 75  72 65 20 76 65 72 73 69  |.   future versi|
00000c10  6f 6e 73 20 6f 66 20 43  6f 63 6f 20 63 6f 75 6c  |ons of Coco coul|
00000c20  64 20 61 6c 6c 6f 77 20  74 68 65 20 75 73 61 67  |d allow the usag|
00000c30  65 20 6f 66 20 6d 6f 72  65 20 73 61 6d 70 6c 65  |e of more sample|
00000c40  73 29 2e 20 20 49 74 20  20 69 73 20 0a 20 20 20  |s).  It  is .   |
00000c50  6e 6f 74 20 20 70 6f 73  73 69 62 6c 65 20 20 74  |not  possible  t|
00000c60  6f 20 20 63 72 65 61 74  65 20 61 20 70 61 74 74  |o  create a patt|
00000c70  65 72 6e 20 77 69 74 68  6f 75 74 20 6f 6e 65 20  |ern without one |
00000c80  20 69 6e 73 74 72 75 6d  65 6e 74 20 20 6c 6f 61  | instrument  loa|
00000c90  64 65 64 20 20 61 74 20  0a 20 20 20 6c 65 61 73  |ded  at .   leas|
00000ca0  74 2e 0a 0a 20 2d 20 41  66 74 65 72 20 74 68 69  |t... - After thi|
00000cb0  73 20 79 6f 75 20 6d 61  79 20 73 74 61 72 74 20  |s you may start |
00000cc0  65 64 69 74 69 6e 67 20  74 68 65 20 73 6f 6e 67  |editing the song|
00000cd0  20 69 74 73 65 6c 66 2e  20 20 50 6c 65 61 73 65  | itself.  Please|
00000ce0  20 72 65 61 64 20 74 68  65 20 6e 65 78 74 20 0a  | read the next .|
00000cf0  20 20 20 63 68 61 70 74  65 72 20 66 6f 72 20 66  |   chapter for f|
00000d00  75 6c 6c 20 69 6e 73 74  72 75 63 74 69 6f 6e 73  |ull instructions|
00000d10  20 6f 6e 20 74 68 65 20  75 73 61 67 65 20 6f 66  | on the usage of|
00000d20  20 43 6f 63 6f 2e 0a 20  20 20 57 65 6c 6c 2c 20  | Coco..   Well, |
00000d30  77 68 61 74 20 69 73 20  61 20 73 6f 6e 67 3f 0a  |what is a song?.|
00000d40  20 20 20 41 20 73 6f 6e  67 73 20 63 6f 6e 73 69  |   A songs consi|
00000d50  73 74 73 20 6f 66 20 73  65 76 65 72 61 6c 20 70  |sts of several p|
00000d60  61 74 74 65 72 6e 73 2c  20 65 61 63 68 20 6f 66  |atterns, each of|
00000d70  20 74 68 65 6d 20 69 73  20 36 34 20 6c 69 6e 65  | them is 64 line|
00000d80  73 20 64 65 70 74 20 61  6e 64 20 0a 20 20 20 66  |s dept and .   f|
00000d90  6f 75 72 20 20 6f 72 20  20 65 69 67 68 74 20 72  |our  or  eight r|
00000da0  6f 77 73 20 77 69 64 65  2c 20 20 64 65 70 65 6e  |ows wide,  depen|
00000db0  64 69 6e 67 20 6f 6e 20  74 68 65 20 73 65 6c 65  |ding on the sele|
00000dc0  63 74 65 64 20 20 63 68  61 6e 6e 65 6c 20 20 66  |cted  channel  f|
00000dd0  6f 72 6d 61 74 2e 20 0a  20 20 20 50 61 74 74 65  |ormat. .   Patte|
00000de0  72 6e 73 20 61 72 65 20  75 73 65 64 20 74 6f 20  |rns are used to |
00000df0  61 6c 6c 6f 77 20 79 6f  75 20 74 6f 20 72 65 70  |allow you to rep|
00000e00  65 61 74 20 73 65 76 65  72 61 6c 20 70 61 72 74  |eat several part|
00000e10  73 20 69 6e 20 79 6f 75  72 20 73 6f 6e 67 20 61  |s in your song a|
00000e20  6e 64 20 0a 20 20 20 74  6f 20 6b 65 65 70 20 61  |nd .   to keep a|
00000e30  6e 64 2f 6f 72 20 62 65  61 74 20 74 68 65 20 74  |nd/or beat the t|
00000e40  69 6d 65 2c 20 20 61 6e  64 20 74 6f 20 6b 65 65  |ime,  and to kee|
00000e50  70 20 74 68 65 20 6f 76  65 72 76 69 65 77 20 6f  |p the overview o|
00000e60  66 20 63 6f 75 72 73 65  2e 20 20 54 68 65 20 0a  |f course.  The .|
00000e70  20 20 20 70 61 74 74 65  72 6e 73 20 68 6f 6c 64  |   patterns hold|
00000e80  20 74 68 65 20 69 6e 66  6f 72 6d 61 74 69 6f 6e  | the information|
00000e90  73 20 6f 66 20 74 68 65  20 74 6f 6e 65 73 20 61  |s of the tones a|
00000ea0  6e 64 20 68 6f 77 20 74  6f 20 70 6c 61 79 20 74  |nd how to play t|
00000eb0  68 65 6d 2e 0a 0a 0a 20  4c 65 74 27 73 20 73 65  |hem.... Let's se|
00000ec0  65 20 61 6e 20 65 78 61  6d 70 6c 65 20 6f 66 20  |e an example of |
00000ed0  68 6f 77 20 61 20 74 6f  6e 65 20 69 73 20 62 75  |how a tone is bu|
00000ee0  69 6c 64 20 75 70 3a 0a  0a 20 20 20 20 43 23 30  |ild up:..    C#0|
00000ef0  20 61 20 46 20 30 35 0a  20 20 20 20 2f 20 7c 20  | a F 05.    / | |
00000f00  7c 20 20 5c 20 5c 5c 5f  20 49 6e 66 6f 20 42 79  ||  \ \\_ Info By|
00000f10  74 65 20 28 6c 65 66 74  20 61 6e 64 20 72 69 67  |te (left and rig|
00000f20  68 74 20 6e 69 62 62 6c  65 29 0a 20 20 20 2f 20  |ht nibble).   / |
00000f30  20 7c 20 7c 20 20 20 5c  0a 20 20 2f 20 20 20 7c  | | |   \.  /   ||
00000f40  20 7c 20 20 20 20 5c 43  6f 6d 6d 61 6e 64 20 28  | |    \Command (|
00000f50  6f 72 20 45 66 66 65 63  74 29 0a 20 2f 20 20 20  |or Effect). /   |
00000f60  20 7c 20 7c 0a 4e 6f 74  65 20 20 7c 20 49 6e 73  | | |.Note  | Ins|
00000f70  74 72 75 6d 65 6e 74 20  6e 75 6d 62 65 72 0a 20  |trument number. |
00000f80  20 20 20 20 20 7c 0a 20  4f 63 74 61 76 65 20 6e  |     |. Octave n|
00000f90  75 6d 62 65 72 0a 0a 0a  20 20 20 41 6e 64 20 74  |umber...   And t|
00000fa0  68 65 20 69 6e 74 65 72  70 72 65 74 61 74 69 6f  |he interpretatio|
00000fb0  6e 20 6f 66 20 74 68 69  73 20 69 6e 66 6f 72 6d  |n of this inform|
00000fc0  61 74 69 6f 6e 20 69 73  20 65 61 73 69 65 73 74  |ation is easiest|
00000fd0  3a 0a 0a 20 20 20 bb 20  22 43 22 20 20 69 73 20  |:..   . "C"  is |
00000fe0  74 68 65 20 69 6e 74 65  72 6e 61 74 69 6f 6e 61  |the internationa|
00000ff0  6c 20 43 20 69 6e 20 74  68 69 73 20 63 61 73 65  |l C in this case|
00001000  2c 20 20 74 68 65 20 22  30 22 20 68 6f 6c 64 73  |,  the "0" holds|
00001010  20 20 74 68 65 20 20 6f  63 74 61 76 65 20 0a 20  |  the  octave . |
00001020  20 20 20 20 6e 75 6d 62  65 72 2c 20 68 65 72 65  |    number, here|
00001030  20 4f 63 74 61 76 65 20  7a 65 72 6f 2e 20 43 75  | Octave zero. Cu|
00001040  72 72 65 6e 74 20 6f 63  74 61 76 65 73 20 61 72  |rrent octaves ar|
00001050  65 20 69 6e 20 74 68 65  20 72 61 6e 67 65 20 66  |e in the range f|
00001060  72 6f 6d 20 2d 33 20 74  6f 20 0a 20 20 20 20 20  |rom -3 to .     |
00001070  2b 34 2c 20 20 61 6e 64  20 20 74 68 69 73 20 20  |+4,  and  this  |
00001080  6d 65 61 6e 73 20 20 65  76 65 6e 20 20 73 6f 6d  |means  even  som|
00001090  65 20 65 78 74 72 65 6d  65 6c 79 20 6c 6f 77 20  |e extremely low |
000010a0  20 6f 72 20 20 68 69 67  68 20 20 6e 6f 74 65 73  | or  high  notes|
000010b0  20 20 61 72 65 20 0a 20  20 20 20 20 70 6f 73 73  |  are .     poss|
000010c0  69 62 6c 65 2c 20 65 73  70 65 63 69 61 6c 6c 79  |ible, especially|
000010d0  20 66 6f 72 20 73 70 65  63 69 61 6c 20 73 6f 75  | for special sou|
000010e0  6e 64 20 65 66 66 65 63  74 73 2e 0a 20 20 20 20  |nd effects..    |
000010f0  20 46 75 72 74 68 65 72  20 74 68 65 20 6e 6f 74  | Further the not|
00001100  65 20 69 73 20 70 6c 61  79 65 64 20 61 73 20 22  |e is played as "|
00001110  43 20 53 68 61 72 70 22  2e 20 54 68 65 20 22 23  |C Sharp". The "#|
00001120  22 20 61 6c 77 61 79 73  20 69 6e 64 69 63 61 74  |" always indicat|
00001130  65 73 20 74 68 65 20 0a  20 20 20 20 20 53 68 61  |es the .     Sha|
00001140  72 70 20 6f 66 20 61 20  74 6f 6e 65 2e 0a 20 20  |rp of a tone..  |
00001150  20 20 20 49 66 20 74 68  65 20 6e 6f 74 65 20 65  |   If the note e|
00001160  6e 74 72 79 20 63 6f 6e  74 61 69 6e 73 20 6e 6f  |ntry contains no|
00001170  74 68 69 6e 67 2c 20 74  68 61 6e 20 6e 6f 20 28  |thing, than no (|
00001180  6e 65 77 29 20 6e 6f 74  65 20 69 73 20 70 6c 61  |new) note is pla|
00001190  79 65 64 2e 0a 20 20 20  bb 20 54 68 65 20 20 22  |yed..   . The  "|
000011a0  61 22 20 20 65 6e 74 72  79 20 73 61 79 73 20 74  |a"  entry says t|
000011b0  68 61 74 20 69 6e 73 74  72 75 6d 65 6e 74 20 22  |hat instrument "|
000011c0  61 22 20 28 74 68 61 74  20 69 73 20 74 68 65 20  |a" (that is the |
000011d0  66 69 72 73 74 20 20 6f  6e 65 29 20 20 69 73 20  |first  one)  is |
000011e0  0a 20 20 20 20 20 75 73  65 64 20 74 6f 20 70 6c  |.     used to pl|
000011f0  61 79 20 74 68 65 20 6e  6f 74 65 2e 20 20 42 79  |ay the note.  By|
00001200  20 73 65 6c 65 63 74 69  6e 67 20 61 6e 20 69 6e  | selecting an in|
00001210  73 74 72 75 6d 65 6e 74  20 69 74 73 20 76 6f 6c  |strument its vol|
00001220  75 6d 65 20 69 73 20 20  73 65 74 20 0a 20 20 20  |ume is  set .   |
00001230  20 20 74 6f 20 69 74 73  20 64 65 66 61 75 6c 74  |  to its default|
00001240  20 76 61 6c 75 65 2e 0a  20 20 20 20 20 49 66 20  | value..     If |
00001250  74 68 65 20 69 6e 73 74  72 75 6d 65 6e 74 20 62  |the instrument b|
00001260  79 74 65 20 63 6f 6e 74  61 69 6e 73 20 6e 6f 74  |yte contains not|
00001270  68 69 6e 67 2c 20 20 74  68 65 6e 20 74 68 65 20  |hing,  then the |
00001280  6c 61 73 74 20 73 65 6c  65 63 74 65 64 20 20 6f  |last selected  o|
00001290  6e 65 20 0a 20 20 20 20  20 69 73 20 75 73 65 64  |ne .     is used|
000012a0  2c 20 69 6e 63 6c 75 73  69 76 65 20 69 74 73 20  |, inclusive its |
000012b0  6c 61 73 74 20 76 6f 6c  75 6d 65 2e 0a 20 20 20  |last volume..   |
000012c0  bb 20 54 68 65 20 6e 65  78 74 20 65 6e 74 72 79  |. The next entry|
000012d0  20 22 46 22 20 68 6f 6c  64 73 20 74 68 65 20 64  | "F" holds the d|
000012e0  65 73 69 72 65 64 20 63  6f 6d 6d 61 6e 64 20 6f  |esired command o|
000012f0  72 20 65 66 66 65 63 74  2e 20 20 49 6e 20 74 68  |r effect.  In th|
00001300  69 73 20 63 61 73 65 20  0a 20 20 20 20 20 63 6f  |is case .     co|
00001310  6d 6d 61 6e 64 20 22 53  65 74 20 53 70 65 65 64  |mmand "Set Speed|
00001320  22 20 28 73 65 65 20 62  65 6c 6f 77 20 66 6f 72  |" (see below for|
00001330  20 61 20 6c 69 73 74 20  6f 66 20 61 6c 6c 20 63  | a list of all c|
00001340  6f 6d 6d 61 6e 64 73 29  2e 0a 20 20 20 bb 20 41  |ommands)..   . A|
00001350  6e 64 20 74 68 65 20 6c  61 73 74 20 65 6e 74 72  |nd the last entr|
00001360  79 20 22 30 35 22 20 69  73 20 74 68 65 20 49 6e  |y "05" is the In|
00001370  66 6f 62 79 74 65 2c 20  20 69 74 20 63 6f 6e 74  |fobyte,  it cont|
00001380  61 69 6e 73 20 76 61 6c  75 65 73 20 66 6f 72 20  |ains values for |
00001390  20 74 68 65 20 0a 20 20  20 20 20 73 65 6c 65 63  | the .     selec|
000013a0  74 65 64 20 63 6f 6d 6d  61 6e 64 2f 65 66 66 65  |ted command/effe|
000013b0  63 74 2e 20 49 6e 20 74  68 69 73 20 63 61 73 65  |ct. In this case|
000013c0  20 22 53 65 74 20 53 70  65 65 64 20 74 6f 20 30  | "Set Speed to 0|
000013d0  35 22 2e 0a 0a 0a 20 20  20 51 75 69 74 65 20 20  |5"....   Quite  |
000013e0  64 69 66 66 69 63 75 6c  74 3f 20 20 4f 68 20 6e  |difficult?  Oh n|
000013f0  6f 2e 20 20 41 6c 6c 20  74 68 65 73 65 20 69 6e  |o.  All these in|
00001400  66 6f 72 6d 61 74 69 6f  6e 73 20 61 72 65 20 64  |formations are d|
00001410  69 73 70 6c 61 79 65 64  20 20 69 6e 20 20 61 6e  |isplayed  in  an|
00001420  20 0a 20 20 20 65 78 70  61 6e 64 65 64 20 66 6f  | .   expanded fo|
00001430  72 6d 20 69 6e 20 74 68  65 20 68 65 61 64 20 6c  |rm in the head l|
00001440  69 6e 65 20 6f 66 20 74  68 65 20 65 64 69 74 20  |ine of the edit |
00001450  77 69 6e 64 6f 77 2e 0a  0a 0a 46 69 6e 65 2c 20  |window....Fine, |
00001460  6e 6f 77 20 6c 65 74 27  73 20 63 6f 6e 74 69 6e  |now let's contin|
00001470  75 65 20 77 69 74 68 20  74 68 65 20 6d 61 69 6e  |ue with the main|
00001480  20 73 74 65 70 73 2e 2e  2e 0a 0a 20 2d 20 41 66  | steps..... - Af|
00001490  74 65 72 20 63 72 65 61  74 69 6e 67 20 73 6f 6d  |ter creating som|
000014a0  65 20 70 61 74 74 65 72  6e 73 2c 20 79 6f 75 20  |e patterns, you |
000014b0  63 6f 75 6c 64 20 63 68  6f 6f 73 65 20 74 68 65  |could choose the|
000014c0  20 73 65 71 75 65 6e 63  65 20 6f 66 20 74 68 65  | sequence of the|
000014d0  6d 2c 20 69 65 20 0a 20  20 20 73 65 74 74 69 6e  |m, ie .   settin|
000014e0  67 20 74 68 65 20 70 6c  61 79 20 6f 72 64 65 72  |g the play order|
000014f0  20 6f 66 20 74 68 65 20  70 61 74 74 65 72 6e 73  | of the patterns|
00001500  2e 0a 0a 20 2d 20 46 75  72 74 68 65 72 20 20 79  |... - Further  y|
00001510  6f 75 20 63 6f 75 6c 64  20 63 68 61 6e 67 65 20  |ou could change |
00001520  74 68 65 20 64 65 66 61  75 6c 74 20 73 65 74 74  |the default sett|
00001530  69 6e 67 20 6f 66 20 79  6f 75 72 20 73 65 6c 65  |ing of your sele|
00001540  63 74 65 64 20 20 69 6e  73 74 72 75 2d 0a 20 20  |cted  instru-.  |
00001550  20 6d 65 6e 74 73 2e 20  20 45 61 63 68 20 6f 66  | ments.  Each of|
00001560  20 74 68 65 6d 20 68 61  73 20 69 74 73 20 6f 77  | them has its ow|
00001570  6e 20 64 65 66 61 75 6c  74 20 56 6f 6c 75 6d 65  |n default Volume|
00001580  2c 20 20 52 65 70 65 61  74 41 74 20 61 6e 64 20  |,  RepeatAt and |
00001590  20 52 65 70 65 61 74 2d  0a 20 20 20 4c 65 6e 67  | Repeat-.   Leng|
000015a0  74 68 2e 0a 20 20 20 54  68 65 20 20 64 65 66 61  |th..   The  defa|
000015b0  75 6c 74 20 20 76 6f 6c  75 6d 65 20 20 6f 66 20  |ult  volume  of |
000015c0  20 61 6e 20 69 6e 73 74  72 75 6d 65 6e 74 20 69  | an instrument i|
000015d0  73 20 75 73 65 64 20 20  66 6f 72 20 20 70 6c 61  |s used  for  pla|
000015e0  79 69 6e 67 20 20 77 68  65 6e 20 20 61 6e 20 0a  |ying  when  an .|
000015f0  20 20 20 69 6e 73 74 72  75 6d 65 6e 74 20 20 69  |   instrument  i|
00001600  73 20 73 65 6c 65 63 74  65 64 20 62 79 20 74 68  |s selected by th|
00001610  65 20 6c 65 74 74 65 72  20 22 61 22 20 2d 20 22  |e letter "a" - "|
00001620  7a 22 2e 20 20 42 75 74  20 74 68 65 20 63 6f 6d  |z".  But the com|
00001630  6d 61 6e 64 20 22 43 20  20 3d 20 0a 20 20 20 53  |mand "C  = .   S|
00001640  65 74 20 76 6f 6c 75 6d  65 22 20 6f 76 65 72 77  |et volume" overw|
00001650  72 69 74 65 73 20 74 68  69 73 20 6f 66 20 63 6f  |rites this of co|
00001660  75 72 73 65 2e 0a 20 20  20 49 66 20 20 52 65 70  |urse..   If  Rep|
00001670  65 61 74 5f 41 74 20 20  69 73 20 20 7a 65 72 6f  |eat_At  is  zero|
00001680  2c 20 20 74 68 65 6e 20  79 6f 75 72 20 69 6e 73  |,  then your ins|
00001690  74 72 75 6d 65 6e 74 20  20 77 69 6c 6c 20 20 62  |trument  will  b|
000016a0  65 20 20 73 69 6c 65 6e  74 20 20 61 66 74 65 72  |e  silent  after|
000016b0  20 0a 20 20 20 61 72 72  69 76 69 6e 67 20 61 74  | .   arriving at|
000016c0  20 74 68 65 20 73 61 6d  70 6c 65 73 27 20 65 6e  | the samples' en|
000016d0  64 2e 20 20 54 68 61 74  20 6d 65 61 6e 73 2c 20  |d.  That means, |
000016e0  74 68 65 20 74 6f 6e 65  20 6a 75 73 74 20 73 6f  |the tone just so|
000016f0  75 6e 64 73 20 61 73 20  6c 6f 6e 67 20 0a 20 20  |unds as long .  |
00001700  20 61 73 20 69 74 73 20  73 61 6d 70 6c 65 20 69  | as its sample i|
00001710  73 20 70 6c 61 79 65 64  2e 0a 20 20 20 57 68 65  |s played..   Whe|
00001720  6e 20 73 65 74 2c 20 74  68 65 6e 20 74 68 65 20  |n set, then the |
00001730  69 6e 73 74 72 75 6d 65  6e 74 20 77 69 6c 6c 20  |instrument will |
00001740  73 74 61 72 74 20 61 6e  64 20 62 65 20 72 65 70  |start and be rep|
00001750  65 61 74 65 64 20 61 74  20 74 68 69 73 20 6f 66  |eated at this of|
00001760  66 73 65 74 20 0a 20 20  20 6e 75 6d 62 65 72 2c  |fset .   number,|
00001770  20 77 68 69 6c 73 74 20  70 6c 61 79 69 6e 67 20  | whilst playing |
00001780  3c 52 65 70 65 61 74 5f  4c 65 6e 67 68 74 3e 20  |<Repeat_Lenght> |
00001790  62 79 74 65 73 20 65 61  63 68 20 74 69 6d 65 2e  |bytes each time.|
000017a0  0a 0a 20 2d 20 41 6e 64  20 6c 61 73 74 20 62 75  |.. - And last bu|
000017b0  74 20 6e 6f 74 20 6c 65  61 73 74 20 74 68 65 20  |t not least the |
000017c0  73 74 65 72 65 6f 20 70  6f 73 69 74 69 6f 6e 73  |stereo positions|
000017d0  20 6f 66 20 74 68 65 20  63 68 61 6e 6e 65 6c 73  | of the channels|
000017e0  2e 20 20 49 66 20 61 20  73 6f 6e 67 20 0a 20 20  |.  If a song .  |
000017f0  20 69 73 20 73 74 61 72  74 65 64 2c 20 74 68 65  | is started, the|
00001800  79 20 61 72 65 20 73 65  74 20 69 6e 20 61 20 71  |y are set in a q|
00001810  75 69 74 65 20 6c 6f 67  69 63 61 6c 20 77 61 79  |uite logical way|
00001820  2e 20 42 65 67 69 6e 6e  69 6e 67 20 77 69 74 68  |. Beginning with|
00001830  20 63 68 61 6e 6e 65 6c  20 0a 20 20 20 6f 6e 65  | channel .   one|
00001840  20 61 74 20 74 68 65 20  6d 6f 73 74 20 6c 65 66  | at the most lef|
00001850  74 20 73 74 65 72 65 6f  20 70 6f 73 69 74 69 6f  |t stereo positio|
00001860  6e 2c 20 20 65 6e 64 69  6e 67 20 77 69 74 68 20  |n,  ending with |
00001870  63 68 61 6e 6e 65 6c 20  65 69 67 68 74 20 61 74  |channel eight at|
00001880  20 74 68 65 20 0a 20 20  20 6d 6f 73 74 20 72 69  | the .   most ri|
00001890  67 68 74 20 70 6f 73 69  74 69 6f 6e 2e 20 20 49  |ght position.  I|
000018a0  6e 20 66 6f 75 72 20 63  68 61 6e 6e 65 6c 20 6d  |n four channel m|
000018b0  6f 64 65 20 74 68 65 20  74 77 6f 20 6d 6f 73 74  |ode the two most|
000018c0  20 72 69 67 68 74 20 61  6e 64 20 20 6d 6f 73 74  | right and  most|
000018d0  20 0a 20 20 20 6c 65 66  74 20 73 74 65 72 65 6f  | .   left stereo|
000018e0  20 70 6f 73 69 74 69 6f  6e 73 20 61 72 65 20 6e  | positions are n|
000018f0  6f 74 20 73 65 74 2e 0a  20 20 20 46 6f 72 20 66  |ot set..   For f|
00001900  69 6e 65 72 20 63 6f 6e  74 72 6f 6c 2c 20 74 68  |iner control, th|
00001910  65 72 65 27 73 20 61 20  63 6f 6d 6d 61 6e 64 20  |ere's a command |
00001920  61 76 61 69 6c 61 62 6c  65 20 77 68 69 63 68 20  |available which |
00001930  61 6c 6c 6f 77 73 20 74  68 65 20 73 65 74 74 69  |allows the setti|
00001940  6e 67 20 0a 20 20 20 6f  66 20 61 6c 6c 20 73 74  |ng .   of all st|
00001950  65 72 65 6f 20 70 6f 73  69 74 69 6f 6e 73 20 77  |ereo positions w|
00001960  68 69 6c 73 74 20 70 6c  61 79 69 6e 67 2e 0a 0a  |hilst playing...|
00001970  0a 0a 20 43 4f 43 4f 27  53 20 43 4f 4d 4d 41 4e  |.. COCO'S COMMAN|
00001980  44 53 20 41 4e 44 20 45  46 46 45 43 54 53 0a 20  |DS AND EFFECTS. |
00001990  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
000019a0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 0a 0a 41 6c 74  |===========..Alt|
000019b0  68 6f 75 67 68 20 20 70  72 6f 67 72 61 6d 6d 65  |hough  programme|
000019c0  64 20 20 69 6e 20 74 68  65 20 73 61 6d 65 20 77  |d  in the same w|
000019d0  61 79 2c 20 20 77 65 20  73 68 6f 75 6c 64 20 20  |ay,  we should  |
000019e0  64 69 73 74 69 6e 67 75  69 73 68 20 20 62 65 74  |distinguish  bet|
000019f0  77 65 65 6e 20 20 61 20  0a 63 6f 6d 6d 61 6e 64  |ween  a .command|
00001a00  20 61 6e 64 20 61 6e 20  65 66 66 65 63 74 2e 20  | and an effect. |
00001a10  41 20 63 6f 6d 6d 61 6e  64 20 69 73 20 70 65 72  |A command is per|
00001a20  66 6f 72 6d 65 64 20 6f  6e 63 65 2c 20 6c 69 6b  |formed once, lik|
00001a30  65 20 53 65 74 20 53 70  65 65 64 2c 20 6f 72 20  |e Set Speed, or |
00001a40  53 65 74 20 0a 56 6f 6c  75 6d 65 2c 20 20 74 6f  |Set .Volume,  to|
00001a50  67 65 74 68 65 72 20 77  69 74 68 20 6e 65 77 20  |gether with new |
00001a60  70 6c 61 79 69 6e 67 20  69 6e 73 74 72 75 63 74  |playing instruct|
00001a70  69 6f 6e 73 2c 20 20 69  65 20 6e 6f 74 65 73 2e  |ions,  ie notes.|
00001a80  20 41 6e 64 20 61 6e 20  65 66 66 65 63 74 2c 20  | And an effect, |
00001a90  0a 6c 69 6b 65 20 41 72  70 65 67 67 69 6f 20 6f  |.like Arpeggio o|
00001aa0  72 20 53 6c 69 64 69 6e  67 2c 20 65 74 63 2e 20  |r Sliding, etc. |
00001ab0  69 73 20 70 65 72 66 6f  72 6d 65 64 20 65 76 65  |is performed eve|
00001ac0  72 79 20 69 6e 74 65 72  72 75 70 74 20 63 61 6c  |ry interrupt cal|
00001ad0  6c 2c 20 74 68 61 74 20  69 73 2c 20 0a 69 74 27  |l, that is, .it'|
00001ae0  73 20 6e 6f 74 20 70 65  72 66 6f 72 6d 65 64 20  |s not performed |
00001af0  77 68 65 6e 20 73 65 74  2c 20 62 75 74 20 61 74  |when set, but at|
00001b00  20 74 68 65 20 66 6f 6c  6c 6f 77 69 6e 67 20 66  | the following f|
00001b10  69 76 65 20 28 6f 72 20  6d 6f 72 65 2c 20 64 65  |ive (or more, de|
00001b20  70 65 6e 64 69 6e 67 20  0a 6f 6e 74 6f 20 20 73  |pending .onto  s|
00001b30  70 65 65 64 29 20 69 6e  74 65 72 72 75 70 74 20  |peed) interrupt |
00001b40  63 61 6c 6c 73 2c 20 20  77 68 69 63 68 20 61 72  |calls,  which ar|
00001b50  65 20 6d 61 64 65 20 75  6e 74 69 6c 20 74 68 65  |e made until the|
00001b60  20 6e 65 78 74 20 6e 65  77 20 20 6e 6f 74 65 20  | next new  note |
00001b70  20 69 73 20 0a 70 6c 61  79 65 64 2e 20 20 4f 66  | is .played.  Of|
00001b80  20 63 6f 75 72 73 65 20  79 6f 75 20 63 61 6e 20  | course you can |
00001b90  70 65 72 66 6f 72 6d 20  63 6f 6d 6d 61 6e 64 73  |perform commands|
00001ba0  2f 65 66 66 65 63 74 73  20 77 69 74 68 6f 75 74  |/effects without|
00001bb0  20 70 6c 61 79 69 6e 67  20 61 20 20 6e 65 77 20  | playing a  new |
00001bc0  0a 74 6f 6e 65 2e 0a 41  73 20 20 74 68 65 20 75  |.tone..As  the u|
00001bd0  73 65 64 20 69 6e 74 65  72 72 75 70 74 20 69 73  |sed interrupt is|
00001be0  20 63 61 6c 6c 65 64 20  65 76 65 72 79 20 56 73  | called every Vs|
00001bf0  79 6e 63 20 28 66 72 61  6d 65 20 66 6c 79 29 2c  |ync (frame fly),|
00001c00  20 20 74 68 65 20 20 65  78 70 72 65 73 73 69 6f  |  the  expressio|
00001c10  6e 20 0a 22 65 76 65 72  79 20 20 69 6e 74 65 72  |n ."every  inter|
00001c20  72 75 70 74 22 20 20 61  6e 64 20 20 22 65 76 65  |rupt"  and  "eve|
00001c30  72 79 20 20 56 73 79 6e  63 22 20 6d 65 61 6e 20  |ry  Vsync" mean |
00001c40  74 68 65 20 20 73 61 6d  65 20 20 69 6e 20 20 74  |the  same  in  t|
00001c50  68 65 20 20 66 6f 6c 6c  6f 77 69 6e 67 20 0a 63  |he  following .c|
00001c60  6f 6e 74 65 78 74 2e 20  20 41 6e 64 20 20 61 73  |ontext.  And  as|
00001c70  20 74 68 65 20 56 73 79  6e 63 20 65 76 65 6e 74  | the Vsync event|
00001c80  20 75 73 75 61 6c 6c 79  20 68 61 73 20 35 30 48  | usually has 50H|
00001c90  7a 2c 20 20 6d 75 6c 74  69 73 79 6e 63 20 6d 6f  |z,  multisync mo|
00001ca0  64 65 73 20 20 77 69 6c  6c 20 0a 63 68 61 6e 67  |des  will .chang|
00001cb0  65 20 74 68 65 20 70 6c  61 79 20 73 70 65 65 64  |e the play speed|
00001cc0  20 28 62 75 74 20 79 6f  75 20 63 6f 75 6c 64 20  | (but you could |
00001cd0  63 6f 72 72 65 63 74 20  74 68 65 20 63 6f 75 6e  |correct the coun|
00001ce0  74 65 72 20 61 70 70 72  6f 70 72 69 61 74 65 29  |ter appropriate)|
00001cf0  2e 0a 0a 0a 54 68 65 20  66 6f 6c 6c 6f 77 69 6e  |....The followin|
00001d00  67 20 65 66 66 65 63 74  73 2f 63 6f 6d 6d 61 6e  |g effects/comman|
00001d10  64 73 20 61 72 65 20 63  75 72 72 65 6e 74 6c 79  |ds are currently|
00001d20  20 61 76 61 69 6c 61 62  6c 65 20 28 69 6e 64 65  | available (inde|
00001d30  65 64 20 74 68 65 79 20  20 63 6f 75 6c 64 20 0a  |ed they  could .|
00001d40  69 6e 63 72 65 61 73 65  20 74 6f 20 61 20 74 68  |increase to a th|
00001d50  65 6f 72 65 74 69 63 61  6c 20 61 6d 6f 75 6e 74  |eoretical amount|
00001d60  20 6f 66 20 26 46 46 29  20 3a 0a 0a 20 2a 20 45  | of &FF) :.. * E|
00001d70  46 46 45 43 54 20 26 30  30 20 3a 0a 20 20 20 55  |FFECT &00 :.   U|
00001d80  73 65 20 20 61 72 70 65  67 67 69 6f 20 20 70 6c  |se  arpeggio  pl|
00001d90  61 79 69 6e 67 2e 20 20  54 68 61 74 20 69 73 2c  |aying.  That is,|
00001da0  20 20 73 77 61 70 20 74  68 65 20 6e 6f 74 65 20  |  swap the note |
00001db0  76 61 6c 75 65 20 35 20  20 74 69 6d 65 73 20 20  |value 5  times  |
00001dc0  77 68 69 6c 73 74 20 0a  20 20 20 70 6c 61 79 69  |whilst .   playi|
00001dd0  6e 67 2c 20 74 68 69 73  20 69 73 20 74 68 65 20  |ng, this is the |
00001de0  64 65 66 61 75 6c 74 2e  20 4f 72 20 65 78 61 63  |default. Or exac|
00001df0  74 6c 79 3a 20 73 77 61  70 20 69 74 20 3c 73 70  |tly: swap it <sp|
00001e00  65 65 64 2d 31 3e 20 74  69 6d 65 73 2e 0a 20 20  |eed-1> times..  |
00001e10  20 44 75 72 69 6e 67 20  74 68 65 73 65 20 3c 73  | During these <s|
00001e20  70 65 65 64 2d 31 3e 20  73 74 65 70 73 20 74 68  |peed-1> steps th|
00001e30  65 20 66 6f 6c 6c 6f 77  69 6e 67 20 69 73 20 70  |e following is p|
00001e40  65 72 66 6f 72 6d 65 64  3a 0a 20 20 20 31 29 20  |erformed:.   1) |
00001e50  41 64 64 20 6c 65 66 74  20 6e 69 62 62 6c 65 20  |Add left nibble |
00001e60  6f 66 20 69 6e 66 6f 62  79 74 65 20 74 6f 20 74  |of infobyte to t|
00001e70  68 65 20 6e 6f 74 65 20  76 61 6c 75 65 20 28 61  |he note value (a|
00001e80  6e 64 20 70 6c 61 79 29  2e 0a 20 20 20 32 29 20  |nd play)..   2) |
00001e90  41 64 64 20 72 69 67 68  74 20 6e 69 62 62 6c 65  |Add right nibble|
00001ea0  20 74 6f 20 74 68 65 20  6f 72 69 67 69 6e 20 6e  | to the origin n|
00001eb0  6f 74 65 20 28 61 6e 64  20 70 6c 61 79 20 74 68  |ote (and play th|
00001ec0  69 73 29 2e 0a 20 20 20  33 29 20 50 6c 61 79 20  |is)..   3) Play |
00001ed0  6f 72 69 67 69 6e 20 28  62 61 73 65 29 20 6e 6f  |origin (base) no|
00001ee0  74 65 2e 0a 20 20 20 34  29 20 44 6f 20 73 74 65  |te..   4) Do ste|
00001ef0  70 20 31 20 61 67 61 69  6e 2c 20 69 65 20 61 64  |p 1 again, ie ad|
00001f00  64 20 6c 65 66 74 20 6e  69 62 62 6c 65 2c 20 65  |d left nibble, e|
00001f10  74 63 2e 0a 20 20 20 35  29 20 44 6f 20 73 74 65  |tc..   5) Do ste|
00001f20  70 20 32 20 61 67 61 69  6e 2c 20 69 65 20 61 64  |p 2 again, ie ad|
00001f30  64 20 72 69 67 68 74 20  6e 69 62 62 6c 65 2c 20  |d right nibble, |
00001f40  65 74 63 2e 0a 0a 20 20  20 46 6f 72 20 65 78 61  |etc...   For exa|
00001f50  6d 70 6c 65 2c 20 63 6f  6d 6d 61 6e 64 6f 20 61  |mple, commando a|
00001f60  72 70 65 67 67 69 6f 20  70 6c 61 79 69 6e 67 2c  |rpeggio playing,|
00001f70  20 69 6e 66 6f 62 79 74  65 20 63 6f 6e 74 61 69  | infobyte contai|
00001f80  6e 73 20 26 35 34 2e 20  54 68 65 20 74 6f 6e 65  |ns &54. The tone|
00001f90  20 0a 20 20 20 77 68 69  63 68 20 6d 75 73 74 20  | .   which must |
00001fa0  62 65 20 70 6c 61 79 65  64 20 69 73 20 65 6e 74  |be played is ent|
00001fb0  65 72 65 64 20 61 73 20  22 44 22 2e 20 53 6f 20  |ered as "D". So |
00001fc0  61 74 20 74 68 65 20 66  69 72 73 74 20 73 74 65  |at the first ste|
00001fd0  70 2c 20 6e 69 62 62 6c  65 20 26 35 20 0a 20 20  |p, nibble &5 .  |
00001fe0  20 69 73 20 61 64 64 65  64 20 74 6f 20 74 68 65  | is added to the|
00001ff0  20 6f 72 69 67 69 6e 61  6c 20 6e 6f 74 65 2c 20  | original note, |
00002000  72 65 73 75 6c 74 69 6e  67 20 69 6e 20 74 68 65  |resulting in the|
00002010  20 74 6f 6e 65 20 22 47  22 20 28 44 20 2d 20 44  | tone "G" (D - D|
00002020  20 73 68 61 72 70 20 2d  20 0a 20 20 20 45 20 2d  | sharp - .   E -|
00002030  20 46 20 2d 20 46 20 73  68 61 72 70 20 2d 20 47  | F - F sharp - G|
00002040  29 2e 20 54 68 69 73 20  69 73 20 70 6c 61 79 65  |). This is playe|
00002050  64 2e 0a 20 20 20 41 74  20 74 68 65 20 73 65 63  |d..   At the sec|
00002060  6f 6e 64 20 73 74 65 70  2c 20 20 6e 69 62 62 6c  |ond step,  nibbl|
00002070  65 20 26 34 20 69 73 20  61 64 64 65 64 20 74 6f  |e &4 is added to|
00002080  20 74 68 65 20 6f 72 69  67 69 6e 61 6c 2c 20 20  | the original,  |
00002090  72 65 73 75 6c 74 69 6e  67 20 20 69 6e 20 0a 20  |resulting  in . |
000020a0  20 20 74 68 65 20 74 6f  6e 65 20 22 46 20 53 68  |  the tone "F Sh|
000020b0  61 72 70 22 2e 20 49 74  20 69 73 20 70 6c 61 79  |arp". It is play|
000020c0  65 64 2c 20 61 6e 64 20  73 6f 20 6f 6e 2e 0a 20  |ed, and so on.. |
000020d0  20 20 4f 72 69 67 69 6e  61 6c 6c 79 20 20 69 6e  |  Originally  in|
000020e0  76 65 6e 74 65 64 20 6f  6e 20 66 6f 75 72 20 28  |vented on four (|
000020f0  61 6e 64 20 6c 65 73 73  29 20 63 68 61 6e 6e 65  |and less) channe|
00002100  6c 20 63 6f 6d 70 75 74  65 72 73 20 66 6f 72 20  |l computers for |
00002110  20 61 6c 6c 6f 77 69 6e  67 20 0a 20 20 20 74 68  | allowing .   th|
00002120  65 69 72 20 76 6f 69 63  65 73 20 74 6f 20 73 6f  |eir voices to so|
00002130  75 6e 64 20 61 20 6c 69  74 74 6c 65 20 62 69 74  |und a little bit|
00002140  20 22 66 75 6c 6c 65 72  22 2c 20 61 6e 64 20 6f  | "fuller", and o|
00002150  74 68 65 72 20 65 66 66  65 63 74 73 2e 0a 0a 20  |ther effects... |
00002160  2a 20 45 46 46 45 43 54  20 26 30 31 20 3a 0a 20  |* EFFECT &01 :. |
00002170  20 20 53 6c 69 64 65 20  75 70 20 74 6f 6e 65 2c  |  Slide up tone,|
00002180  20 20 69 65 20 61 64 64  20 74 68 65 20 69 6e 66  |  ie add the inf|
00002190  6f 62 79 74 65 2a 36 34  20 74 6f 20 74 68 65 20  |obyte*64 to the |
000021a0  6f 75 74 70 75 74 20 66  72 65 71 75 65 6e 63 79  |output frequency|
000021b0  2c 20 74 68 69 73 20 69  73 20 0a 20 20 20 75 73  |, this is .   us|
000021c0  75 61 6c 6c 79 20 35 20  74 69 6d 65 73 20 28 64  |ually 5 times (d|
000021d0  65 70 65 6e 64 69 6e 67  20 6f 6e 74 6f 20 74 68  |epending onto th|
000021e0  65 20 73 70 65 65 64 29  20 77 68 69 6c 65 20 70  |e speed) while p|
000021f0  6c 61 79 69 6e 67 20 61  20 6e 6f 74 65 2c 20 20  |laying a note,  |
00002200  75 6e 74 69 6c 20 0a 20  20 20 61 20 20 63 65 72  |until .   a  cer|
00002210  74 61 69 6e 20 66 72 65  71 75 65 6e 63 79 20 69  |tain frequency i|
00002220  73 20 61 63 68 69 65 76  65 64 2e 20 20 49 6e 76  |s achieved.  Inv|
00002230  65 6e 74 65 64 20 66 6f  72 20 62 65 69 6e 67 20  |ented for being |
00002240  61 62 6c 65 20 74 6f 20  20 73 69 6d 75 6c 61 74  |able to  simulat|
00002250  65 20 0a 20 20 20 41 6d  69 67 61 20 70 65 72 69  |e .   Amiga peri|
00002260  6f 64 73 2e 0a 0a 20 2a  20 45 46 46 45 43 54 20  |ods... * EFFECT |
00002270  26 30 32 20 3a 0a 20 20  20 53 6c 69 64 65 20 64  |&02 :.   Slide d|
00002280  6f 77 6e 20 74 6f 6e 65  2c 20 73 75 62 74 72 61  |own tone, subtra|
00002290  63 74 20 69 6e 66 6f 62  79 74 65 2a 36 34 20 66  |ct infobyte*64 f|
000022a0  72 6f 6d 20 66 72 65 71  75 65 6e 63 79 2c 20 3c  |rom frequency, <|
000022b0  73 70 65 65 64 2d 31 3e  20 74 69 6d 65 73 20 61  |speed-1> times a|
000022c0  20 0a 20 20 20 70 6c 61  79 2c 20 75 6e 74 69 6c  | .   play, until|
000022d0  20 61 20 63 65 72 74 61  69 6e 20 66 72 65 71 75  | a certain frequ|
000022e0  65 6e 63 79 20 28 41 6d  69 67 61 20 70 65 72 69  |ency (Amiga peri|
000022f0  6f 64 29 20 69 73 20 61  63 68 69 65 76 65 64 2e  |od) is achieved.|
00002300  0a 0a 20 2a 20 45 46 46  45 43 54 20 26 30 33 20  |.. * EFFECT &03 |
00002310  3a 0a 20 20 20 53 6c 69  64 65 20 20 75 70 20 20  |:.   Slide  up  |
00002320  76 6f 6c 75 6d 65 2e 20  20 45 76 65 72 79 20 66  |volume.  Every f|
00002330  69 72 73 74 20 76 73 79  6e 63 2c 20 20 74 68 65  |irst vsync,  the|
00002340  20 69 6e 66 6f 62 79 74  65 20 69 73 20 20 61 64  | infobyte is  ad|
00002350  64 65 64 20 20 74 6f 20  20 74 68 65 20 0a 20 20  |ded  to  the .  |
00002360  20 63 75 72 72 65 6e 74  20 76 6f 6c 75 6d 65 20  | current volume |
00002370  28 6f 66 20 74 68 65 20  63 75 72 72 65 6e 74 20  |(of the current |
00002380  69 6e 73 74 72 75 6d 65  6e 74 29 2e 20 20 42 65  |instrument).  Be|
00002390  63 61 75 73 65 20 6f 66  20 74 68 65 20 4c 53 42  |cause of the LSB|
000023a0  20 20 28 6c 6f 77 65 72  20 0a 20 20 20 73 69 67  |  (lower .   sig|
000023b0  6e 20 62 69 74 29 20 66  6f 72 6d 61 74 20 6f 66  |n bit) format of|
000023c0  20 74 68 65 20 73 61 6d  70 6c 65 20 73 79 73 74  | the sample syst|
000023d0  65 6d 2c 20 6f 6e 6c 79  20 65 76 65 6e 20 69 6e  |em, only even in|
000023e0  66 6f 62 79 74 65 73 20  61 72 65 20 61 6c 6c 6f  |fobytes are allo|
000023f0  77 65 64 2c 20 0a 20 20  20 74 6f 20 61 63 68 69  |wed, .   to achi|
00002400  65 76 65 20 73 6d 6f 6f  74 68 20 73 6c 69 64 69  |eve smooth slidi|
00002410  6e 67 2e 0a 0a 20 2a 20  45 46 46 45 43 54 20 26  |ng... * EFFECT &|
00002420  30 34 20 3a 0a 20 20 20  53 6c 69 64 65 20 64 6f  |04 :.   Slide do|
00002430  77 6e 20 76 6f 6c 75 6d  65 2e 20 20 53 75 62 74  |wn volume.  Subt|
00002440  72 61 63 74 20 69 6e 66  6f 62 79 74 65 20 65 76  |ract infobyte ev|
00002450  65 72 79 20 66 69 72 73  74 20 56 73 79 6e 63 2c  |ery first Vsync,|
00002460  20 20 66 6f 72 20 20 61  6c 6c 6f 77 69 6e 67 20  |  for  allowing |
00002470  0a 20 20 20 73 6c 6f 77  20 73 6c 69 64 69 6e 67  |.   slow sliding|
00002480  2e 0a 0a 20 2a 20 45 46  46 45 43 54 20 26 30 35  |... * EFFECT &05|
00002490  20 3a 0a 20 20 20 53 6c  69 64 65 20 41 72 63 20  | :.   Slide Arc |
000024a0  70 69 74 63 68 20 75 70  2e 20 20 41 64 64 20 69  |pitch up.  Add i|
000024b0  6e 66 6f 62 79 74 65 2a  31 36 20 74 6f 20 66 72  |nfobyte*16 to fr|
000024c0  65 71 75 65 6e 63 79 2e  20 20 4e 6f 20 6d 61 78  |equency.  No max|
000024d0  69 6d 75 6d 2e 20 54 68  69 73 20 69 73 20 0a 20  |imum. This is . |
000024e0  20 20 74 68 65 20 70 72  65 66 65 72 72 65 64 20  |  the preferred |
000024f0  70 69 74 63 68 20 73 6c  69 64 69 6e 67 2e 0a 0a  |pitch sliding...|
00002500  20 2a 20 45 46 46 45 43  54 20 26 30 36 20 3a 0a  | * EFFECT &06 :.|
00002510  20 20 20 53 6c 69 64 65  20 41 72 63 20 70 69 74  |   Slide Arc pit|
00002520  63 68 20 64 6f 77 6e 2e  20 20 53 75 62 74 72 61  |ch down.  Subtra|
00002530  63 74 20 69 6e 66 6f 62  79 74 65 2a 31 36 2e 20  |ct infobyte*16. |
00002540  20 4d 69 6e 69 6d 75 6d  20 69 73 20 7a 65 72 6f  | Minimum is zero|
00002550  2e 20 20 54 68 69 73 20  69 73 20 0a 20 20 20 74  |.  This is .   t|
00002560  68 65 20 70 72 65 66 65  72 72 65 64 20 70 69 74  |he preferred pit|
00002570  63 68 20 73 6c 69 64 69  6e 67 2e 0a 0a 20 2a 20  |ch sliding... * |
00002580  43 4f 4d 4d 41 4e 44 20  26 30 37 20 3a 0a 20 20  |COMMAND &07 :.  |
00002590  20 53 65 74 20 74 68 65  20 73 74 65 72 65 6f 20  | Set the stereo |
000025a0  70 6f 73 69 74 69 6f 6e  20 6f 66 20 74 68 65 20  |position of the |
000025b0  63 75 72 72 65 6e 74 20  63 68 61 6e 6e 65 6c 20  |current channel |
000025c0  74 6f 20 69 6e 66 6f 62  79 74 65 20 76 61 6c 75  |to infobyte valu|
000025d0  65 2e 20 20 45 61 63 68  20 0a 20 20 20 75 73 65  |e.  Each .   use|
000025e0  64 20 20 63 68 61 6e 6e  65 6c 20 20 6d 61 79 20  |d  channel  may |
000025f0  20 68 61 76 65 20 69 74  73 20 6f 77 6e 20 20 73  | have its own  s|
00002600  74 65 72 65 6f 20 20 70  6f 73 69 74 69 6f 6e 2e  |tereo  position.|
00002610  20 20 54 68 65 20 20 69  6e 66 6f 62 79 74 65 20  |  The  infobyte |
00002620  20 63 61 6e 20 0a 20 20  20 69 6e 64 69 63 61 74  | can .   indicat|
00002630  65 20 6f 6e 65 20 6f 66  20 74 68 65 20 66 6f 6c  |e one of the fol|
00002640  6c 6f 77 69 6e 67 20 37  20 70 6f 73 69 74 69 6f  |lowing 7 positio|
00002650  6e 73 3a 0a 0a 20 20 20  20 20 20 20 20 20 20 30  |ns:..          0|
00002660  31 20 31 30 30 25 20 4c  65 66 74 20 43 68 61 6e  |1 100% Left Chan|
00002670  6e 65 6c 0a 20 20 20 20  20 20 20 20 20 20 30 32  |nel.          02|
00002680  20 20 38 33 25 20 4c 65  66 74 20 43 68 61 6e 6e  |  83% Left Chann|
00002690  65 6c 0a 20 20 20 20 20  20 20 20 20 20 30 33 20  |el.          03 |
000026a0  20 36 37 25 20 4c 65 66  74 20 43 68 61 6e 6e 65  | 67% Left Channe|
000026b0  6c 0a 20 20 20 20 20 20  20 20 20 20 30 34 20 20  |l.          04  |
000026c0  20 20 20 20 43 65 6e 74  65 72 0a 20 20 20 20 20  |    Center.     |
000026d0  20 20 20 20 20 30 35 20  20 36 37 25 20 52 69 67  |     05  67% Rig|
000026e0  68 74 20 43 68 61 6e 6e  65 6c 0a 20 20 20 20 20  |ht Channel.     |
000026f0  20 20 20 20 20 30 36 20  20 38 33 25 20 52 69 67  |     06  83% Rig|
00002700  68 74 20 43 68 61 6e 6e  65 6c 0a 20 20 20 20 20  |ht Channel.     |
00002710  20 20 20 20 20 30 37 20  31 30 30 25 20 52 69 67  |     07 100% Rig|
00002720  68 74 20 43 68 61 6e 6e  65 6c 0a 0a 20 2a 20 43  |ht Channel.. * C|
00002730  4f 4d 4d 41 4e 44 20 26  30 38 20 3a 0a 20 20 20  |OMMAND &08 :.   |
00002740  53 74 61 72 74 20 20 61  75 74 6f 20 20 76 6f 6c  |Start  auto  vol|
00002750  75 6d 65 5f 75 70 2e 20  20 54 68 61 74 20 69 73  |ume_up.  That is|
00002760  2c 20 20 73 6c 69 64 65  20 75 70 20 74 68 65 20  |,  slide up the |
00002770  76 6f 6c 75 6d 65 20 6f  66 20 20 74 68 65 20 20  |volume of  the  |
00002780  63 75 72 72 65 6e 74 20  0a 20 20 20 69 6e 73 74  |current .   inst|
00002790  72 75 6d 65 6e 74 20 69  6e 20 74 68 69 73 20 63  |rument in this c|
000027a0  68 61 6e 6e 65 6c 20 62  79 20 74 68 65 20 69 6e  |hannel by the in|
000027b0  66 6f 62 79 74 65 20 65  76 65 72 79 20 66 69 72  |fobyte every fir|
000027c0  73 74 20 56 73 79 6e 63  2c 20 20 66 72 6f 6d 20  |st Vsync,  from |
000027d0  6e 6f 77 20 0a 20 20 20  6f 6e 2e 20 54 68 69 73  |now .   on. This|
000027e0  20 77 69 6c 6c 20 62 65  20 64 6f 6e 65 20 61 75  | will be done au|
000027f0  74 6f 6d 61 74 69 63 61  6c 6c 79 2e 0a 20 20 20  |tomatically..   |
00002800  49 6e 20 6f 72 64 65 72  20 74 6f 20 63 6c 65 61  |In order to clea|
00002810  72 20 74 68 69 73 20 61  75 74 6f 20 66 6c 61 67  |r this auto flag|
00002820  2c 20 79 6f 75 27 76 65  20 74 6f 20 75 73 65 20  |, you've to use |
00002830  63 6f 6d 6d 61 6e 64 20  65 66 66 65 63 74 20 26  |command effect &|
00002840  30 38 20 77 69 74 68 20  0a 20 20 20 69 6e 66 6f  |08 with .   info|
00002850  62 79 74 65 20 63 6f 6e  74 61 69 6e 69 6e 67 20  |byte containing |
00002860  7a 65 72 6f 2e 0a 0a 20  2a 20 43 4f 4d 4d 41 4e  |zero... * COMMAN|
00002870  44 20 26 30 39 20 3a 0a  20 20 20 53 74 61 72 74  |D &09 :.   Start|
00002880  20 61 75 74 6f 20 76 6f  6c 75 6d 65 5f 64 6f 77  | auto volume_dow|
00002890  6e 2e 20 41 70 70 72 6f  70 72 69 61 74 65 20 74  |n. Appropriate t|
000028a0  6f 20 26 30 38 2e 0a 20  20 20 43 6c 65 61 72 20  |o &08..   Clear |
000028b0  74 68 69 73 20 61 75 74  6f 20 66 6c 61 67 20 62  |this auto flag b|
000028c0  79 20 73 65 6c 65 63 74  69 6e 67 20 73 61 6d 65  |y selecting same|
000028d0  20 63 6f 6d 6d 61 6e 64  20 2b 20 7a 65 72 6f 20  | command + zero |
000028e0  69 6e 66 6f 62 79 74 65  2e 0a 0a 20 2a 20 43 4f  |infobyte... * CO|
000028f0  4d 4d 41 4e 44 20 26 30  41 20 3a 0a 20 20 20 53  |MMAND &0A :.   S|
00002900  74 61 72 74 20 61 75 74  6f 20 73 6c 69 64 69 6e  |tart auto slidin|
00002910  67 5f 75 70 2e 20 20 54  68 61 74 20 69 73 2c 20  |g_up.  That is, |
00002920  20 73 6c 69 64 65 20 75  70 20 74 68 65 20 70 69  | slide up the pi|
00002930  74 63 68 20 28 66 72 65  71 75 65 6e 63 79 29 20  |tch (frequency) |
00002940  20 65 76 65 72 79 20 0a  20 20 20 76 73 79 6e 63  | every .   vsync|
00002950  20 61 75 74 6f 6d 61 74  69 63 61 6c 6c 79 20 77  | automatically w|
00002960  69 74 68 20 74 68 65 20  69 6e 66 6f 62 79 74 65  |ith the infobyte|
00002970  20 76 61 6c 75 65 2e 0a  20 20 20 43 6c 65 61 72  | value..   Clear|
00002980  20 74 68 69 73 20 61 75  74 6f 20 66 6c 61 67 20  | this auto flag |
00002990  62 79 20 73 65 6c 65 63  74 69 6e 67 20 73 61 6d  |by selecting sam|
000029a0  65 20 63 6f 6d 6d 61 6e  64 20 2b 20 7a 65 72 6f  |e command + zero|
000029b0  20 69 6e 66 6f 62 79 74  65 2e 0a 0a 20 2a 20 43  | infobyte... * C|
000029c0  4f 4d 4d 41 4e 44 20 26  30 42 20 3a 0a 20 20 20  |OMMAND &0B :.   |
000029d0  53 74 61 72 74 20 61 75  74 6f 20 73 6c 69 64 69  |Start auto slidi|
000029e0  6e 67 5f 64 6f 77 6e 2e  20 41 70 70 72 6f 70 72  |ng_down. Appropr|
000029f0  69 61 74 65 20 74 6f 20  26 30 41 2e 0a 20 20 20  |iate to &0A..   |
00002a00  43 6c 65 61 72 20 74 68  69 73 20 61 75 74 6f 20  |Clear this auto |
00002a10  66 6c 61 67 20 62 79 20  73 65 6c 65 63 74 69 6e  |flag by selectin|
00002a20  67 20 73 61 6d 65 20 63  6f 6d 6d 61 6e 64 20 2b  |g same command +|
00002a30  20 7a 65 72 6f 20 69 6e  66 6f 62 79 74 65 2e 0a  | zero infobyte..|
00002a40  0a 20 2a 20 43 4f 4d 4d  41 4e 44 20 26 30 43 20  |. * COMMAND &0C |
00002a50  3a 0a 20 20 20 53 65 74  20 20 76 6f 6c 75 6d 65  |:.   Set  volume|
00002a60  20 20 6f 66 20 20 74 68  65 20 63 75 72 72 65 6e  |  of  the curren|
00002a70  74 20 69 6e 73 74 72 75  6d 65 6e 74 20 28 6f 6e  |t instrument (on|
00002a80  20 20 63 75 72 72 65 6e  74 20 20 63 68 61 6e 6e  |  current  chann|
00002a90  65 6c 29 20 20 74 6f 20  20 74 68 65 20 0a 20 20  |el)  to  the .  |
00002aa0  20 69 6e 66 6f 62 79 74  65 20 20 76 61 6c 75 65  | infobyte  value|
00002ab0  2e 20 20 54 68 65 20 20  76 6f 6c 75 6d 65 20 69  |.  The  volume i|
00002ac0  73 20 69 6e 20 74 68 65  20 6c 69 6e 65 61 72 20  |s in the linear |
00002ad0  72 61 6e 67 65 20 66 72  6f 6d 20 26 30 30 20 20  |range from &00  |
00002ae0  74 6f 20 20 26 66 66 2c  20 0a 20 20 20 77 68 65  |to  &ff, .   whe|
00002af0  72 65 20 20 30 20 69 73  20 6c 6f 75 64 65 73 74  |re  0 is loudest|
00002b00  20 61 6e 64 20 32 35 35  20 74 6f 74 61 6c 6c 79  | and 255 totally|
00002b10  20 71 75 69 65 74 2e 20  20 50 6c 65 61 73 65 20  | quiet.  Please |
00002b20  6e 6f 74 65 20 74 68 65  20 4c 53 42 20 20 73 61  |note the LSB  sa|
00002b30  6d 70 6c 65 20 0a 20 20  20 66 6f 72 6d 61 74 20  |mple .   format |
00002b40  28 69 65 20 75 73 65 20  6f 6e 6c 79 20 65 76 65  |(ie use only eve|
00002b50  6e 20 6e 75 6d 62 65 72  73 29 2e 0a 0a 20 2a 20  |n numbers)... * |
00002b60  43 4f 4d 4d 41 4e 44 20  26 30 44 20 3a 0a 20 20  |COMMAND &0D :.  |
00002b70  20 50 61 74 74 65 72 6e  20 20 42 72 65 61 6b 2e  | Pattern  Break.|
00002b80  20 20 57 68 65 6e 20 20  74 68 69 73 20 63 6f 6d  |  When  this com|
00002b90  6d 61 6e 64 20 69 73 20  73 65 74 20 74 68 65 6e  |mand is set then|
00002ba0  20 74 68 65 20 20 77 68  6f 6c 65 20 20 70 61 74  | the  whole  pat|
00002bb0  74 65 72 6e 20 20 69 73  20 0a 20 20 20 74 65 72  |tern  is .   ter|
00002bc0  6d 69 6e 61 74 65 64 2c  20 20 61 6e 64 20 20 74  |minated,  and  t|
00002bd0  68 65 20 6e 65 78 74 20  6f 6e 65 20 69 6e 20 74  |he next one in t|
00002be0  68 65 20 73 65 71 75 65  6e 63 65 20 69 73 20 73  |he sequence is s|
00002bf0  74 61 72 74 65 64 2e 20  20 49 74 20 20 64 6f 65  |tarted.  It  doe|
00002c00  73 6e 27 74 20 0a 20 20  20 6d 61 74 74 65 72 20  |sn't .   matter |
00002c10  77 68 69 63 68 20 63 68  61 6e 6e 65 6c 20 61 63  |which channel ac|
00002c20  74 69 76 61 74 65 73 20  69 74 2e 0a 0a 20 2a 20  |tivates it... * |
00002c30  43 4f 4d 4d 41 4e 44 20  26 30 46 20 3a 0a 20 20  |COMMAND &0F :.  |
00002c40  20 53 65 74 20 20 74 68  65 20 20 70 6c 61 79 20  | Set  the  play |
00002c50  73 70 65 65 64 20 74 6f  20 76 61 6c 75 65 20 63  |speed to value c|
00002c60  6f 6e 74 61 69 6e 65 64  20 69 6e 20 74 68 65 20  |ontained in the |
00002c70  20 69 6e 66 6f 62 79 74  65 2e 20 20 54 68 65 20  | infobyte.  The |
00002c80  20 64 65 66 61 75 6c 74  20 0a 20 20 20 73 70 65  | default .   spe|
00002c90  65 64 20 69 73 20 36 2e  20 20 54 68 61 74 20 69  |ed is 6.  That i|
00002ca0  73 2c 20 69 66 20 74 68  65 20 56 73 79 6e 63 20  |s, if the Vsync |
00002cb0  63 6f 75 6e 74 65 72 20  28 69 6e 74 65 72 72 75  |counter (interru|
00002cc0  70 74 20 63 6f 75 6e 74  65 72 29 20 61 63 68 69  |pt counter) achi|
00002cd0  65 76 65 73 20 0a 20 20  20 74 68 65 20 20 73 65  |eves .   the  se|
00002ce0  6c 65 63 74 65 64 20 20  73 70 65 65 64 2c 20 20  |lected  speed,  |
00002cf0  74 68 65 6e 20 20 74 68  65 20 6e 65 78 74 20 70  |then  the next p|
00002d00  61 74 74 65 72 6e 20 20  69 6e 66 6f 72 6d 61 74  |attern  informat|
00002d10  69 6f 6e 20 20 68 61 73  20 20 74 6f 20 20 62 65  |ion  has  to  be|
00002d20  20 0a 20 20 20 69 6e 74  65 72 70 72 65 74 65 64  | .   interpreted|
00002d30  20 28 61 20 6e 65 77 20  6e 6f 74 65 20 69 73 20  | (a new note is |
00002d40  70 6c 61 79 65 64 29 20  61 6e 64 20 74 68 65 20  |played) and the |
00002d50  63 6f 75 6e 74 65 72 20  69 73 20 72 65 73 65 74  |counter is reset|
00002d60  2e 0a 0a 0a 41 6e 20 61  64 64 69 74 69 6f 6e 61  |....An additiona|
00002d70  6c 20 6e 6f 74 65 20 74  6f 20 74 68 65 20 61 75  |l note to the au|
00002d80  74 6f 20 63 6f 6d 6d 61  6e 64 73 3a 20 20 41 6c  |to commands:  Al|
00002d90  74 68 6f 75 67 68 20 74  68 65 73 65 20 61 75 74  |though these aut|
00002da0  6f 20 63 6f 6d 6d 61 6e  64 73 20 61 72 65 20 0a  |o commands are .|
00002db0  65 78 65 63 75 74 65 64  20 61 73 20 63 6f 6d 6d  |executed as comm|
00002dc0  61 6e 64 73 2c 20 20 74  68 65 79 20 61 63 74 75  |ands,  they actu|
00002dd0  61 6c 6c 79 20 6d 61 6b  65 20 74 68 65 69 72 20  |ally make their |
00002de0  61 70 70 72 6f 70 72 69  61 74 65 20 65 66 66 65  |appropriate effe|
00002df0  63 74 73 20 74 6f 20 20  62 65 20 0a 73 74 61 72  |cts to  be .star|
00002e00  74 65 64 2e 20 20 54 68  65 79 20 20 61 72 65 20  |ted.  They  are |
00002e10  69 6e 76 65 6e 74 65 64  20 74 6f 20 61 6c 6c 6f  |invented to allo|
00002e20  77 20 79 6f 75 20 74 6f  20 6d 61 6b 65 20 6d 75  |w you to make mu|
00002e30  6c 74 69 70 6c 65 20 65  66 66 65 63 74 73 20 61  |ltiple effects a|
00002e40  74 20 20 74 68 65 20 0a  73 61 6d 65 20 74 69 6d  |t  the .same tim|
00002e50  65 2e 20 20 45 76 65 6e  20 61 6c 6c 20 66 6f 75  |e.  Even all fou|
00002e60  72 20 61 75 74 6f 20 65  66 66 65 63 74 73 20 6d  |r auto effects m|
00002e70  61 79 20 62 65 20 61 63  74 69 76 65 20 61 74 20  |ay be active at |
00002e80  74 68 65 20 73 61 6d 65  20 74 69 6d 65 20 20 28  |the same time  (|
00002e90  6f 72 20 0a 72 61 74 68  65 72 3a 20 61 66 74 65  |or .rather: afte|
00002ea0  72 20 73 65 74 74 69 6e  67 20 6f 6e 65 2c 20 74  |r setting one, t|
00002eb0  68 65 20 6e 65 78 74 20  6d 61 79 20 62 65 20 73  |he next may be s|
00002ec0  65 74 20 74 6f 6f 29 2e  20 50 6c 65 61 73 65 20  |et too). Please |
00002ed0  64 6f 6e 27 74 20 22 66  6f 72 67 65 74 22 20 0a  |don't "forget" .|
00002ee0  61 6e 20 20 61 75 74 6f  20 65 66 66 65 63 74 20  |an  auto effect |
00002ef0  77 68 65 6e 20 73 65 74  20 6f 6e 63 65 2e 20 20  |when set once.  |
00002f00  43 6c 65 61 72 20 69 74  20 62 79 20 73 65 74 74  |Clear it by sett|
00002f10  69 6e 67 20 74 68 65 20  20 63 6f 6d 6d 61 6e 64  |ing the  command|
00002f20  20 20 74 6f 67 65 74 68  65 72 20 0a 77 69 74 68  |  together .with|
00002f30  20 69 6e 66 6f 62 79 74  65 20 7a 65 72 6f 2e 20  | infobyte zero. |
00002f40  20 4c 69 6b 65 20 74 68  65 20 6f 74 68 65 72 20  | Like the other |
00002f50  65 66 66 65 63 74 73 2c  20 20 74 68 65 20 61 75  |effects,  the au|
00002f60  74 6f 20 66 78 20 61 72  65 20 70 65 72 66 6f 72  |to fx are perfor|
00002f70  6d 65 64 20 69 6e 20 0a  74 68 65 20 20 74 69 6d  |med in .the  tim|
00002f80  65 20 62 65 74 77 65 65  6e 20 74 77 6f 20 6e 65  |e between two ne|
00002f90  77 20 6e 6f 74 65 73 2c  20 20 74 68 61 74 20 69  |w notes,  that i|
00002fa0  73 20 3c 73 70 65 65 64  2d 31 3e 20 74 69 6d 65  |s <speed-1> time|
00002fb0  73 2c 20 20 61 6e 64 20  6f 6e 6c 79 20 69 66 20  |s,  and only if |
00002fc0  20 61 20 0a 74 6f 6e 65  20 66 6f 72 20 74 68 69  | a .tone for thi|
00002fd0  73 20 63 68 61 6e 6e 65  6c 20 69 73 20 28 73 74  |s channel is (st|
00002fe0  69 6c 6c 29 20 61 63 74  69 76 65 2e 0a 0a 0a 0a  |ill) active.....|
00002ff0  20 54 48 45 20 49 4e 53  54 52 55 4d 45 4e 54 53  | THE INSTRUMENTS|
00003000  0a 20 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |. ==============|
00003010  3d 0a 0a 57 65 6c 6c 2c  20 20 61 6e 20 69 6e 73  |=..Well,  an ins|
00003020  74 72 75 6d 65 6e 74 20  69 73 20 61 20 64 69 67  |trument is a dig|
00003030  69 74 69 73 65 64 20 73  61 6d 70 6c 65 20 66 69  |itised sample fi|
00003040  6c 65 2e 20 20 44 69 67  69 74 69 73 65 64 20 61  |le.  Digitised a|
00003050  74 20 61 6e 20 6f 72 69  67 69 6e 61 6c 20 0a 62  |t an original .b|
00003060  61 73 65 20 6f 63 74 61  76 65 20 28 66 6f 72 20  |ase octave (for |
00003070  65 78 61 6d 70 6c 65 20  6d 69 64 64 6c 65 20 43  |example middle C|
00003080  29 2e 20 20 53 6f 6d 65  20 70 65 6f 70 6c 65 20  |).  Some people |
00003090  64 69 67 69 74 69 73 65  28 64 29 20 74 68 65 69  |digitise(d) thei|
000030a0  72 20 73 61 6d 70 6c 65  73 20 0a 61 74 20 20 6f  |r samples .at  o|
000030b0  74 68 65 72 20 20 6f 63  74 61 76 65 73 2e 20 20  |ther  octaves.  |
000030c0  53 6f 20 64 6f 6e 27 74  20 77 6f 6e 64 65 72 20  |So don't wonder |
000030d0  77 68 65 6e 20 68 65 61  72 69 6e 67 20 20 64 69  |when hearing  di|
000030e0  66 66 65 72 65 6e 74 20  20 69 6e 73 74 72 75 6d  |fferent  instrum|
000030f0  65 6e 74 73 2c 20 0a 61  62 6f 75 74 20 20 68 61  |ents, .about  ha|
00003100  76 69 6e 67 20 64 69 66  66 65 72 65 6e 74 20 62  |ving different b|
00003110  61 73 65 20 6f 63 74 61  76 65 73 2e 20 20 49 66  |ase octaves.  If|
00003120  20 79 6f 75 20 64 69 67  69 74 69 73 65 20 61 20  | you digitise a |
00003130  6e 65 77 20 20 73 61 6d  70 6c 65 20 20 74 68 65  |new  sample  the|
00003140  6e 20 0a 70 6c 65 61 73  65 20 20 64 6f 20 20 69  |n .please  do  i|
00003150  74 20 20 61 74 20 74 68  65 20 64 65 66 61 75 6c  |t  at the defaul|
00003160  74 20 6f 63 74 61 76 65  20 65 6c 73 65 20 20 74  |t octave else  t|
00003170  68 65 72 65 27 73 20 20  63 6f 6e 66 75 73 69 6f  |here's  confusio|
00003180  6e 20 20 61 62 6f 75 74  20 20 74 68 65 20 0a 65  |n  about  the .e|
00003190  6e 74 65 72 65 64 20 76  61 6c 75 65 20 61 6e 64  |ntered value and|
000031a0  20 74 68 65 20 61 63 74  75 61 6c 20 70 6c 61 79  | the actual play|
000031b0  65 64 20 70 69 74 63 68  20 6f 66 20 61 20 6e 6f  |ed pitch of a no|
000031c0  74 65 21 20 20 43 75 72  72 65 6e 74 20 20 69 6e  |te!  Current  in|
000031d0  73 74 72 75 6d 65 6e 74  73 20 0a 73 68 6f 75 6c  |struments .shoul|
000031e0  64 20 6e 6f 74 20 65 78  63 65 65 64 20 74 68 65  |d not exceed the|
000031f0  20 6c 65 6e 67 74 68 20  6f 66 20 36 34 20 4b 42  | length of 64 KB|
00003200  79 74 65 73 2e 0a 0a 41  20 73 61 6d 70 6c 65 20  |ytes...A sample |
00003210  66 69 6c 65 20 63 6f 6e  74 61 69 6e 73 20 64 69  |file contains di|
00003220  67 69 74 69 73 65 64 20  64 61 74 61 20 62 79 74  |gitised data byt|
00003230  65 73 2e 20 20 42 75 74  20 77 68 61 74 27 73 20  |es.  But what's |
00003240  77 69 74 68 20 74 68 65  6d 3f 20 20 57 65 6c 6c  |with them?  Well|
00003250  2c 20 0a 6c 65 74 27 73  20 73 65 65 20 77 68 61  |, .let's see wha|
00003260  74 20 74 68 65 20 6d 61  6e 75 61 6c 20 73 61 79  |t the manual say|
00003270  73 2e 2e 2e 0a 20 54 68  65 20 20 73 6f 75 6e 64  |s.... The  sound|
00003280  20 44 4d 41 20 73 79 73  74 65 6d 20 6f 66 20 74  | DMA system of t|
00003290  68 65 20 41 72 63 68 69  6d 65 64 65 73 20 73 79  |he Archimedes sy|
000032a0  73 74 65 6d 61 74 69 63  61 6c 6c 79 20 6f 75 74  |stematically out|
000032b0  70 75 74 73 20 20 74 68  65 20 20 64 61 74 61 20  |puts  the  data |
000032c0  0a 20 62 79 74 65 73 20  61 74 20 61 20 70 72 6f  |. bytes at a pro|
000032d0  67 72 61 6d 6d 65 64 20  73 61 6d 70 6c 65 20 72  |grammed sample r|
000032e0  61 74 65 3b 20 20 65 61  63 68 20 28 31 36 2d 62  |ate;  each (16-b|
000032f0  79 74 65 29 20 6c 6f 61  64 20 6f 66 20 44 4d 41  |yte) load of DMA|
00003300  20 64 61 74 61 20 20 66  72 6f 6d 20 0a 20 6d 65  | data  from . me|
00003310  6d 6f 72 79 20 69 73 20  73 79 6e 63 68 72 6f 6e  |mory is synchron|
00003320  69 7a 65 64 20 74 6f 20  74 68 65 20 66 69 72 73  |ized to the firs|
00003330  74 20 73 74 65 72 65 6f  20 69 6d 61 67 65 20 70  |t stereo image p|
00003340  6f 73 69 74 69 6f 6e 2e  20 45 61 63 68 20 62 79  |osition. Each by|
00003350  74 65 20 6d 75 73 74 20  0a 20 62 65 20 20 73 74  |te must . be  st|
00003360  6f 72 65 64 20 61 73 20  61 6e 20 65 69 67 68 74  |ored as an eight|
00003370  20 62 69 74 20 73 69 67  6e 65 64 20 6c 6f 67 61  | bit signed loga|
00003380  72 69 74 68 6d 2c 20 20  72 65 61 64 79 20 66 6f  |rithm,  ready fo|
00003390  72 20 64 69 72 65 63 74  20 6f 75 74 70 75 74 20  |r direct output |
000033a0  20 74 6f 20 0a 20 74 68  65 20 56 49 44 43 20 63  | to . the VIDC c|
000033b0  68 69 70 3a 0a 20 4d 75  6c 74 69 70 6c 65 20 20  |hip:. Multiple  |
000033c0  63 68 61 6e 6e 65 6c 20  20 6f 70 65 72 61 74 69  |channel  operati|
000033d0  6f 6e 73 20 20 61 72 65  20 20 70 6f 73 73 69 62  |ons  are  possib|
000033e0  6c 65 20 20 77 69 74 68  20 20 74 77 6f 2c 20 20  |le  with  two,  |
000033f0  66 6f 75 72 20 20 6f 72  20 20 65 69 67 68 74 20  |four  or  eight |
00003400  0a 20 63 68 61 6e 6e 65  6c 73 2e 20 57 68 65 6e  |. channels. When|
00003410  20 6f 75 74 70 75 74 20  74 68 65 20 63 68 61 6e  | output the chan|
00003420  6e 65 6c 73 20 61 72 65  20 6d 75 6c 74 69 70 6c  |nels are multipl|
00003430  65 78 65 64 20 69 6e 74  6f 20 77 68 61 74 20 69  |exed into what i|
00003440  73 20 65 66 66 65 63 74  69 76 2d 0a 20 65 6c 79  |s effectiv-. ely|
00003450  20 20 6f 6e 65 20 20 68  61 6c 66 2c 20 20 6f 6e  |  one  half,  on|
00003460  65 20 71 75 61 72 74 65  72 20 6f 72 20 6f 6e 65  |e quarter or one|
00003470  20 65 69 67 68 74 20 6f  66 20 74 68 65 20 73 61  | eight of the sa|
00003480  6d 70 6c 65 20 20 70 65  72 69 6f 64 2c 20 20 73  |mple  period,  s|
00003490  6f 20 20 74 68 65 20 0a  20 73 69 67 6e 61 6c 20  |o  the . signal |
000034a0  20 6c 65 76 65 6c 20 20  70 65 72 20 63 68 61 6e  | level  per chan|
000034b0  6e 65 6c 20 69 73 20 73  63 61 6c 65 64 20 64 6f  |nel is scaled do|
000034c0  77 6e 20 62 79 20 74 68  65 20 73 61 6d 65 20 20  |wn by the same  |
000034d0  61 6d 6f 75 6e 74 2e 20  20 54 68 75 73 20 20 74  |amount.  Thus  t|
000034e0  68 65 20 0a 20 73 69 67  6e 61 6c 20 6c 65 76 65  |he . signal leve|
000034f0  6c 20 70 65 72 20 63 68  61 6e 6e 65 6c 20 69 73  |l per channel is|
00003500  20 73 63 61 6c 65 64 2c  20 20 64 65 70 65 6e 64  | scaled,  depend|
00003510  69 6e 67 20 6f 6e 20 74  68 65 20 6e 75 6d 62 65  |ing on the numbe|
00003520  72 20 6f 66 20 63 68 61  6e 6e 65 6c 73 3b 20 0a  |r of channels; .|
00003530  20 62 75 74 20 20 74 68  65 20 20 6f 76 65 72 61  | but  the  overa|
00003540  6c 6c 20 20 73 69 67 6e  61 6c 20 6c 65 76 65 6c  |ll  signal level|
00003550  20 72 65 6d 61 69 6e 73  20 74 68 65 20 73 61 6d  | remains the sam|
00003560  65 20 66 6f 72 20 20 61  6c 6c 20 20 6d 75 6c 74  |e for  all  mult|
00003570  69 20 20 63 68 61 6e 6e  65 6c 20 0a 20 6d 6f 64  |i  channel . mod|
00003580  65 73 2e 0a 0a 57 65 6c  6c 2c 20 20 77 68 79 20  |es...Well,  why |
00003590  74 65 6c 6c 69 6e 67 20  74 68 69 73 3f 20 20 4c  |telling this?  L|
000035a0  6f 6f 6b 2c 20 20 74 68  65 72 65 20 61 72 65 20  |ook,  there are |
000035b0  73 6f 6d 65 20 74 68 69  6e 67 73 20 72 65 73 75  |some things resu|
000035c0  6c 74 69 6e 67 20 66 72  6f 6d 20 20 74 68 65 20  |lting from  the |
000035d0  0a 56 49 44 43 20 38 20  62 69 74 20 6c 6f 67 61  |.VIDC 8 bit loga|
000035e0  72 69 74 68 6d 20 4c 53  42 20 28 6c 6f 77 65 72  |rithm LSB (lower|
000035f0  20 73 69 67 6e 20 62 69  74 29 20 66 6f 72 6d 61  | sign bit) forma|
00003600  74 3a 0a 20 49 66 20 20  79 6f 75 20 20 64 69 67  |t:. If  you  dig|
00003610  69 74 69 73 65 20 61 6e  64 2f 6f 72 20 68 61 6e  |itise and/or han|
00003620  64 6c 65 20 61 20 6e 65  77 20 73 61 6d 70 6c 65  |dle a new sample|
00003630  20 77 69 74 68 20 20 61  70 70 72 6f 70 72 69 61  | with  appropria|
00003640  74 65 20 20 73 6f 66 74  77 61 72 65 2c 20 0a 20  |te  software, . |
00003650  74 68 65 6e 20 74 68 65  20 72 65 73 75 6c 74 69  |then the resulti|
00003660  6e 67 20 66 69 6c 65 20  6f 66 74 65 6e 20 69 73  |ng file often is|
00003670  20 61 20 28 73 69 67 6e  65 64 29 20 6c 69 6e 65  | a (signed) line|
00003680  61 72 20 6f 6e 65 20 61  6e 64 20 74 68 65 72 65  |ar one and there|
00003690  66 6f 72 65 20 20 6e 6f  74 20 0a 20 72 65 61 64  |fore  not . read|
000036a0  79 20 66 6f 72 20 64 69  72 65 63 74 20 73 6f 75  |y for direct sou|
000036b0  6e 64 20 6f 75 74 70 75  74 2e 20 20 49 74 20 66  |nd output.  It f|
000036c0  69 72 73 74 20 68 61 76  65 20 74 6f 20 62 65 20  |irst have to be |
000036d0  63 6f 6e 76 65 72 74 65  64 20 62 79 20 74 68 65  |converted by the|
000036e0  20 74 6f 6f 6c 20 0a 20  22 4c 69 6e 4c 6f 67 22  | tool . "LinLog"|
000036f0  20 69 6e 74 6f 20 74 68  65 20 56 49 44 43 20 70  | into the VIDC p|
00003700  6c 65 61 73 65 64 20 73  69 67 6e 65 64 20 6c 6f  |leased signed lo|
00003710  67 61 72 69 74 68 6d 20  66 6f 72 6d 61 74 2c 20  |garithm format, |
00003720  20 69 6e 20 6f 72 64 65  72 20 74 6f 20 20 75 73  | in order to  us|
00003730  65 20 0a 20 69 74 20 77  69 74 68 20 43 6f 63 6f  |e . it with Coco|
00003740  6e 69 7a 65 72 2e 0a 20  49 66 20 20 79 6f 75 20  |nizer.. If  you |
00003750  63 72 65 61 74 65 20 61  20 73 79 6e 74 68 65 74  |create a synthet|
00003760  69 63 20 73 61 6d 70 6c  65 2c 20 20 69 65 20 74  |ic sample,  ie t|
00003770  68 65 20 64 61 74 61 20  62 79 74 65 73 20 61 72  |he data bytes ar|
00003780  65 20 63 72 65 61 74 65  64 20 20 62 79 20 20 61  |e created  by  a|
00003790  6e 20 0a 20 61 6c 67 6f  72 69 74 68 6d 20 28 66  |n . algorithm (f|
000037a0  6f 72 20 65 78 61 6d 70  6c 65 20 73 69 6e 75 73  |or example sinus|
000037b0  20 6f 72 20 72 65 63 74  61 6e 67 6c 65 20 77 61  | or rectangle wa|
000037c0  76 65 73 29 20 74 68 65  6e 20 75 73 75 61 6c 6c  |ves) then usuall|
000037d0  79 20 74 68 65 79 20 61  72 65 20 6f 66 20 0a 20  |y they are of . |
000037e0  6c 69 6e 65 61 72 20 66  6f 72 6d 20 61 6e 64 20  |linear form and |
000037f0  73 68 6f 75 6c 64 20 62  65 20 63 6f 6e 76 65 72  |should be conver|
00003800  74 65 64 20 69 6e 74 6f  20 74 68 65 20 56 49 44  |ted into the VID|
00003810  43 20 66 6f 72 6d 61 74  2e 0a 0a 41 6e 64 20 20  |C format...And  |
00003820  6c 61 73 74 20 62 75 74  20 6e 6f 74 20 6c 65 61  |last but not lea|
00003830  73 74 20 73 6f 6d 65 20  74 65 63 68 6e 69 63 61  |st some technica|
00003840  6c 20 64 65 74 61 69 6c  73 20 74 6f 20 74 68 65  |l details to the|
00003850  20 6d 61 78 69 6d 75 6d  20 61 6e 64 20 20 64 65  | maximum and  de|
00003860  66 61 75 6c 74 20 0a 73  61 6d 70 6c 65 20 72 61  |fault .sample ra|
00003870  74 65 2e 0a 20 41 20 68  69 67 68 20 73 61 6d 70  |te.. A high samp|
00003880  6c 65 20 72 61 74 65 20  77 69 6c 6c 20 67 69 76  |le rate will giv|
00003890  65 20 74 68 65 20 62 65  73 74 20 73 6f 75 6e 64  |e the best sound|
000038a0  20 71 75 61 6c 69 74 79  2e 20 20 49 66 20 74 6f  | quality.  If to|
000038b0  6f 20 68 69 67 68 20 61  20 20 72 61 74 65 20 0a  |o high a  rate .|
000038c0  20 69 73 20 20 73 6f 75  67 68 74 20 74 68 65 6e  | is  sought then|
000038d0  20 44 4d 41 20 72 65 71  75 65 73 74 20 63 6f 6e  | DMA request con|
000038e0  66 6c 69 63 74 73 20 77  69 6c 6c 20 6f 63 63 75  |flicts will occu|
000038f0  72 2c 20 20 65 73 70 65  63 69 61 6c 6c 79 20 20  |r,  especially  |
00003900  77 68 65 6e 20 20 68 69  67 68 20 0a 20 62 61 6e  |when  high . ban|
00003910  64 77 69 64 74 68 73 20  61 72 65 20 61 6c 73 6f  |dwidths are also|
00003920  20 72 65 71 75 69 72 65  64 20 66 72 6f 6d 20 74  | required from t|
00003930  68 65 20 56 69 64 65 6f  20 43 6f 6e 74 72 6f 6c  |he Video Control|
00003940  6c 65 72 20 62 79 20 68  69 67 68 20 72 65 73 6f  |ler by high reso|
00003950  6c 75 74 69 6f 6e 20 0a  20 73 63 72 65 65 6e 20  |lution . screen |
00003960  20 6d 6f 64 65 73 2e 20  20 54 6f 20 61 76 6f 69  | modes.  To avoi|
00003970  64 20 73 75 63 68 20 63  6f 6e 74 65 6e 74 69 6f  |d such contentio|
00003980  6e 73 20 74 68 65 20 6f  75 74 70 75 74 20 70 65  |ns the output pe|
00003990  72 69 6f 64 20 6d 75 73  74 20 20 6e 6f 74 20 20  |riod must  not  |
000039a0  62 65 20 0a 20 6c 65 73  73 20 20 74 68 61 6e 20  |be . less  than |
000039b0  34 20 b5 73 2e 20 20 4f  75 74 70 75 74 74 69 6e  |4 .s.  Outputtin|
000039c0  67 20 61 20 62 79 74 65  20 74 6f 20 6f 6e 65 20  |g a byte to one |
000039d0  6f 66 20 65 69 67 68 74  20 63 68 61 6e 6e 65 6c  |of eight channel|
000039e0  73 20 65 76 65 72 79 20  20 34 20 20 b5 73 20 0a  |s every  4  .s .|
000039f0  20 72 65 73 75 6c 74 73  20 69 6e 20 61 20 73 61  | results in a sa|
00003a00  6d 70 6c 65 20 70 65 72  69 6f 64 20 6f 66 20 33  |mple period of 3|
00003a10  32 20 b5 73 2c 20 77 68  69 63 68 20 67 69 76 65  |2 .s, which give|
00003a20  73 20 61 20 6d 61 78 69  6d 75 6d 20 73 61 6d 70  |s a maximum samp|
00003a30  6c 65 20 72 61 74 65 20  6f 66 20 0a 20 33 31 2e  |le rate of . 31.|
00003a40  32 35 20 20 6b 48 7a 20  77 69 74 68 20 65 69 67  |25  kHz with eig|
00003a50  68 74 20 61 63 74 69 76  65 20 63 68 61 6e 6e 65  |ht active channe|
00003a60  6c 73 20 28 77 69 74 68  20 6f 6e 65 20 61 63 74  |ls (with one act|
00003a70  69 76 65 20 63 68 61 6e  6e 65 6c 20 20 65 76 65  |ive channel  eve|
00003a80  6e 20 20 32 35 30 20 0a  20 6b 48 7a 21 20 43 44  |n  250 . kHz! CD|
00003a90  20 70 6c 61 79 65 72 73  20 75 73 75 61 6c 6c 79  | players usually|
00003aa0  20 68 61 76 65 20 61 62  6f 75 74 20 34 32 20 6b  | have about 42 k|
00003ab0  48 7a 29 2e 0a 20 43 75  72 72 65 6e 74 20 41 52  |Hz).. Current AR|
00003ac0  4d 20 62 61 73 65 64 20  63 6f 6d 70 75 74 65 72  |M based computer|
00003ad0  73 20 75 73 65 20 61 20  56 49 44 43 20 73 79 73  |s use a VIDC sys|
00003ae0  74 65 6d 20 63 6c 6f 63  6b 20 6f 66 20 32 34 20  |tem clock of 24 |
00003af0  20 4d 48 7a 3b 20 20 68  6f 77 65 76 65 72 2c 20  | MHz;  however, |
00003b00  0a 20 32 30 20 4d 48 7a  20 61 6e 64 20 32 38 20  |. 20 MHz and 28 |
00003b10  4d 48 7a 20 63 6c 6f 63  6b 73 20 61 72 65 20 61  |MHz clocks are a|
00003b20  6c 73 6f 20 73 75 70 70  6f 72 74 65 64 2e 20 54  |lso supported. T|
00003b30  68 65 20 64 65 66 61 75  6c 74 20 6f 75 74 70 75  |he default outpu|
00003b40  74 20 70 65 72 69 6f 64  20 69 73 20 0a 20 74 68  |t period is . th|
00003b50  65 20 73 68 6f 72 74 65  73 74 20 6f 6e 65 20 74  |e shortest one t|
00003b60  68 61 74 20 63 61 6e 20  62 65 20 64 65 72 69 76  |hat can be deriv|
00003b70  65 64 20 66 72 6f 6d 20  61 6c 6c 20 74 68 72 65  |ed from all thre|
00003b80  65 20 63 6c 6f 63 6b 73  2c 20 74 68 75 73 20 65  |e clocks, thus e|
00003b90  6e 73 75 72 69 6e 67 20  0a 20 74 68 61 74 20 20  |nsuring . that  |
00003ba0  6d 75 73 69 63 20 20 63  61 6e 20 20 62 65 20 20  |music  can  be  |
00003bb0  70 72 6f 64 75 63 65 64  20 61 74 20 74 68 65 20  |produced at the |
00003bc0  73 61 6d 65 20 70 69 74  63 68 20 20 6f 6e 20 20  |same pitch  on  |
00003bd0  61 6e 79 20 20 6c 69 6b  65 6c 79 20 20 66 75 74  |any  likely  fut|
00003be0  75 72 65 20 0a 20 68 61  72 64 77 61 72 65 2e 20  |ure . hardware. |
00003bf0  20 54 68 69 73 20 20 69  73 20 36 20 b5 73 2e 20  | This  is 6 .s. |
00003c00  20 4f 75 74 70 75 74 74  69 6e 67 20 61 20 62 79  | Outputting a by|
00003c10  74 65 20 74 6f 20 6f 6e  65 20 6f 66 20 65 69 67  |te to one of eig|
00003c20  68 74 20 65 76 65 72 79  20 20 36 20 20 b5 73 20  |ht every  6  .s |
00003c30  0a 20 72 65 73 75 6c 74  73 20 69 6e 20 61 20 73  |. results in a s|
00003c40  61 6d 70 6c 65 20 70 65  72 69 6f 64 20 6f 66 20  |ample period of |
00003c50  34 38 20 b5 73 2c 20 77  68 69 63 68 20 67 69 76  |48 .s, which giv|
00003c60  65 73 20 61 20 64 65 66  61 75 6c 74 20 73 61 6d  |es a default sam|
00003c70  70 6c 65 20 72 61 74 65  20 6f 66 20 0a 20 32 30  |ple rate of . 20|
00003c80  2e 38 33 33 20 6b 48 7a  2e 0a 0a 54 68 69 73 20  |.833 kHz...This |
00003c90  69 73 20 77 68 61 74 20  74 68 65 20 6d 61 6e 75  |is what the manu|
00003ca0  61 6c 20 73 61 79 73 2e  20 41 6e 64 20 61 73 20  |al says. And as |
00003cb0  43 6f 63 6f 20 70 6c 61  79 73 20 66 6f 75 72 20  |Coco plays four |
00003cc0  6f 72 20 65 69 67 68 74  20 63 68 61 6e 6e 65 6c  |or eight channel|
00003cd0  73 2c 20 77 65 20 0a 64  65 63 69 64 65 64 20 20  |s, we .decided  |
00003ce0  74 6f 20 6b 65 65 70 20  74 68 65 20 64 65 66 61  |to keep the defa|
00003cf0  75 6c 74 20 73 61 6d 70  6c 65 20 72 61 74 65 2c  |ult sample rate,|
00003d00  20 20 69 65 20 69 74 73  20 73 61 6d 70 6c 65 20  |  ie its sample |
00003d10  70 65 72 69 6f 64 20 6f  66 20 34 38 20 20 b5 73  |period of 48  .s|
00003d20  2e 20 0a 59 6f 75 27 6c  6c 20 20 66 69 6e 64 20  |. .You'll  find |
00003d30  74 68 69 73 20 76 61 6c  75 65 20 61 74 20 74 68  |this value at th|
00003d40  65 20 62 65 67 69 6e 6e  69 6e 67 20 6f 66 20 74  |e beginning of t|
00003d50  68 65 20 70 6c 61 79 65  72 20 72 6f 75 74 69 6e  |he player routin|
00003d60  65 73 20 28 61 6e 64 20  20 73 6f 6d 65 20 0a 74  |es (and  some .t|
00003d70  6f 6f 6c 73 29 2e 20 41  6c 74 68 6f 75 67 68 20  |ools). Although |
00003d80  79 6f 75 20 63 6f 75 6c  64 20 63 68 61 6e 67 65  |you could change|
00003d90  20 74 68 69 73 20 2d 20  74 68 65 72 65 27 73 20  | this - there's |
00003da0  6e 6f 20 61 63 74 75 61  6c 20 72 65 61 73 6f 6e  |no actual reason|
00003db0  20 74 6f 20 64 6f 20 73  6f 20 0a 28 62 65 6c 69  | to do so .(beli|
00003dc0  65 76 65 20 6d 65 29 2e  0a 0a 41 6e 64 20 74 68  |eve me)...And th|
00003dd0  65 20 66 69 6e 61 6c 20  63 6f 6e 63 6c 75 73 69  |e final conclusi|
00003de0  6f 6e 3a 20 20 41 20 73  6f 6e 67 20 6a 75 73 74  |on:  A song just|
00003df0  20 73 6f 75 6e 64 73 20  61 73 20 77 65 6c 6c 20  | sounds as well |
00003e00  61 73 20 74 68 65 20 75  73 65 64 20 20 73 61 6d  |as the used  sam|
00003e10  70 6c 65 73 20 0a 28 69  6e 73 74 72 75 6d 65 6e  |ples .(instrumen|
00003e20  74 73 29 20 20 61 72 65  20 20 64 69 67 69 74 69  |ts)  are  digiti|
00003e30  73 65 64 2e 20 20 54 68  65 72 65 20 20 61 72 65  |sed.  There  are|
00003e40  20 73 61 6d 70 6c 65 73  20 20 77 68 69 63 68 20  | samples  which |
00003e50  20 65 6e 64 20 20 69 6d  6d 65 64 69 61 74 65 2c  | end  immediate,|
00003e60  20 0a 72 65 73 75 6c 74  69 6e 67 20 20 69 6e 20  | .resulting  in |
00003e70  20 61 6e 20 61 62 72 75  70 74 20 63 6c 69 63 6b  | an abrupt click|
00003e80  2e 20 20 54 6f 20 61 76  6f 69 64 20 74 68 69 73  |.  To avoid this|
00003e90  20 79 6f 75 20 65 69 74  68 65 72 20 20 63 6f 75  | you either  cou|
00003ea0  6c 64 20 20 75 73 65 20  20 74 68 65 20 0a 63 6f  |ld  use  the .co|
00003eb0  6d 6d 61 6e 64 20 22 53  6c 69 64 65 20 56 6f 6c  |mmand "Slide Vol|
00003ec0  75 6d 65 20 64 6f 77 6e  22 20 77 68 65 6e 20 70  |ume down" when p|
00003ed0  6c 61 79 69 6e 67 20 61  20 6e 6f 74 65 20 77 69  |laying a note wi|
00003ee0  74 68 20 74 68 69 73 20  69 6e 73 74 72 75 6d 65  |th this instrume|
00003ef0  6e 74 2e 20 54 68 65 6e  20 0a 79 6f 75 20 20 67  |nt. Then .you  g|
00003f00  65 74 20 20 61 20 76 6f  6c 75 6d 65 20 65 6e 76  |et  a volume env|
00003f10  65 6c 6f 70 65 20 28 67  65 74 74 69 6e 67 20 71  |elope (getting q|
00003f20  75 69 65 74 65 72 29 2c  20 20 73 6f 20 74 68 65  |uieter),  so the|
00003f30  20 20 22 63 6c 69 63 6b  22 20 20 77 6f 6e 27 74  |  "click"  won't|
00003f40  20 20 62 65 20 0a 68 65  61 72 64 2e 20 20 4f 72  |  be .heard.  Or|
00003f50  20 79 6f 75 20 63 6f 75  6c 64 20 73 65 61 72 63  | you could searc|
00003f60  68 20 66 6f 72 20 61 20  62 65 74 74 65 72 20 69  |h for a better i|
00003f70  6e 73 74 72 75 6d 65 6e  74 2c 20 69 65 20 75 73  |nstrument, ie us|
00003f80  65 20 73 6d 6f 6f 74 68  20 73 61 6d 70 6c 65 73  |e smooth samples|
00003f90  20 0a 6f 6e 6c 79 2c 20  6f 62 76 69 6f 75 73 6c  | .only, obviousl|
00003fa0  79 20 74 68 69 73 20 73  68 6f 75 6c 64 20 62 65  |y this should be|
00003fb0  20 74 68 65 20 6d 6f 72  65 20 70 72 65 66 65 72  | the more prefer|
00003fc0  72 65 64 20 77 61 79 2e  2e 2e 0a 0a 0a 0a 20 54  |red way....... T|
00003fd0  48 45 20 4c 4f 43 41 54  49 4f 4e 20 4f 46 20 49  |HE LOCATION OF I|
00003fe0  4e 53 54 52 55 4d 45 4e  54 53 20 41 4e 44 20 53  |NSTRUMENTS AND S|
00003ff0  4f 4e 47 53 0a 20 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |ONGS. ==========|
00004000  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
00004010  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 0a 0a 54 68 65  |===========..The|
00004020  20 20 73 61 6d 70 6c 65  73 20 61 72 65 20 6c 6f  |  samples are lo|
00004030  63 61 74 65 64 20 6f 6e  20 73 65 76 65 72 61 6c  |cated on several|
00004040  20 64 69 73 63 73 20 28  69 74 27 73 20 75 70 20  | discs (it's up |
00004050  74 6f 20 79 6f 75 20 74  6f 20 20 65 78 70 61 6e  |to you to  expan|
00004060  64 20 20 79 6f 75 72 20  0a 63 6f 6c 6c 65 63 74  |d  your .collect|
00004070  69 6f 6e 29 2e 20 41 6c  6c 20 66 69 6c 65 73 20  |ion). All files |
00004080  74 6f 67 65 74 68 65 72  20 61 72 65 20 61 6c 6c  |together are all|
00004090  6f 63 61 74 65 64 20 69  6e 20 61 20 66 69 6c 65  |ocated in a file|
000040a0  20 63 61 6c 6c 65 64 20  22 6c 6f 63 61 74 69 6f  | called "locatio|
000040b0  6e 22 2e 20 0a 49 74 20  20 68 6f 6c 64 73 20 20  |n". .It  holds  |
000040c0  74 68 65 20 6e 61 6d 65  2c 20 20 6c 65 6e 67 74  |the name,  lengt|
000040d0  68 20 61 6e 64 20 64 69  72 65 63 74 6f 72 79 20  |h and directory |
000040e0  6e 75 6d 62 65 72 20 6f  66 20 65 61 63 68 20 20  |number of each  |
000040f0  73 61 6d 70 6c 65 20 20  28 66 69 6c 65 29 2e 20  |sample  (file). |
00004100  0a 41 66 74 65 72 20 20  61 64 64 69 6e 67 20 20  |.After  adding  |
00004110  6e 65 77 20 73 61 6d 70  6c 65 73 20 74 6f 20 79  |new samples to y|
00004120  6f 75 72 20 65 78 69 73  74 69 6e 67 20 6f 6e 65  |our existing one|
00004130  73 20 79 6f 75 20 73 68  6f 75 6c 64 20 72 75 6e  |s you should run|
00004140  20 20 74 68 65 20 20 74  6f 6f 6c 20 0a 22 4c 6f  |  the  tool ."Lo|
00004150  63 61 74 65 72 22 20 74  6f 20 73 63 61 6e 20 74  |cater" to scan t|
00004160  68 65 6d 2e 0a 0a 41 73  20 20 41 44 46 53 20 6a  |hem...As  ADFS j|
00004170  75 73 74 20 61 6c 6c 6f  77 73 20 61 20 6d 61 78  |ust allows a max|
00004180  69 6d 75 6d 20 6f 66 20  37 37 20 64 69 72 65 63  |imum of 77 direc|
00004190  74 6f 72 79 20 65 6e 74  72 69 65 73 2c 20 20 74  |tory entries,  t|
000041a0  68 65 20 73 61 6d 70 6c  65 20 20 66 69 6c 65 73  |he sample  files|
000041b0  20 0a 68 61 76 65 20 20  74 6f 20 62 65 20 73 70  | .have  to be sp|
000041c0  6c 69 74 20 75 70 20 69  6e 74 6f 20 73 65 76 65  |lit up into seve|
000041d0  72 61 6c 20 64 69 72 65  63 74 6f 72 69 65 73 2e  |ral directories.|
000041e0  20 20 54 68 65 79 20 61  72 65 20 20 6e 61 6d 65  |  They are  name|
000041f0  64 20 20 22 49 6e 73 74  41 2e 22 2c 20 0a 22 49  |d  "InstA.", ."I|
00004200  6e 73 74 42 2e 22 2c 20  22 49 6e 73 74 43 2e 22  |nstB.", "InstC."|
00004210  2c 20 61 6e 64 20 73 6f  20 6f 6e 2e 0a 49 6e 20  |, and so on..In |
00004220  20 6f 72 64 65 72 20 74  6f 20 62 65 20 61 62 6c  | order to be abl|
00004230  65 20 74 6f 20 63 61 6c  63 75 6c 61 74 65 20 74  |e to calculate t|
00004240  68 65 20 64 69 73 63 20  6e 75 6d 62 65 72 20 6f  |he disc number o|
00004250  75 74 20 66 72 6f 6d 20  20 74 68 65 20 20 64 69  |ut from  the  di|
00004260  72 65 63 74 6f 72 79 20  0a 6e 75 6d 62 65 72 2c  |rectory .number,|
00004270  20 20 79 6f 75 20 20 73  68 6f 75 6c 64 20 61 6c  |  you  should al|
00004280  77 61 79 73 20 63 72 65  61 74 65 20 70 61 69 72  |ways create pair|
00004290  73 20 6f 66 20 49 6e 73  74 58 20 20 64 69 72 73  |s of InstX  dirs|
000042a0  2e 20 20 53 6f 2c 20 20  61 6c 77 61 79 73 20 20  |.  So,  always  |
000042b0  74 77 6f 20 0a 69 6e 73  74 72 75 6d 65 6e 74 20  |two .instrument |
000042c0  64 69 72 65 63 74 6f 72  69 65 73 20 6d 75 73 74  |directories must|
000042d0  20 62 65 20 6f 6e 20 6f  6e 65 20 73 61 6d 70 6c  | be on one sampl|
000042e0  65 20 64 69 73 63 2e 0a  0a 53 61 6d 65 20 74 68  |e disc...Same th|
000042f0  69 6e 67 20 77 69 74 68  20 74 68 65 20 73 6f 6e  |ing with the son|
00004300  67 73 2e 20 20 54 68 65  79 20 73 68 6f 75 6c 64  |gs.  They should|
00004310  20 62 65 20 69 6e 20 73  65 76 65 72 61 6c 20 73  | be in several s|
00004320  6f 6e 67 20 64 69 72 65  63 74 6f 72 69 65 73 2e  |ong directories.|
00004330  20 54 6f 20 0a 6b 65 65  70 20 20 74 68 65 20 6f  | To .keep  the o|
00004340  76 65 72 76 69 65 77 2c  20 20 43 6f 63 6f 20 73  |verview,  Coco s|
00004350  63 61 6e 73 20 6f 6e 6c  79 20 64 69 72 65 63 74  |cans only direct|
00004360  6f 72 79 20 6e 61 6d 65  73 20 6f 66 20 74 68 65  |ory names of the|
00004370  20 74 79 70 65 20 20 22  53 2a 22 20 20 61 74 20  | type  "S*"  at |
00004380  0a 27 53 65 74 20 20 44  69 72 65 63 74 6f 72 79  |.'Set  Directory|
00004390  27 2e 20 20 54 68 65 20  73 6f 6e 67 20 66 69 6c  |'.  The song fil|
000043a0  65 73 20 6d 61 79 20 62  65 20 6f 66 20 6e 6f 72  |es may be of nor|
000043b0  6d 61 6c 20 6f 72 20 70  61 63 6b 65 64 20 20 66  |mal or packed  f|
000043c0  69 6c 65 20 20 66 6f 72  6d 61 74 20 0a 28 50 61  |ile  format .(Pa|
000043d0  63 6b 65 74 29 2e 20 20  59 6f 75 20 65 6e 74 65  |cket).  You ente|
000043e0  72 20 74 68 65 20 27 53  65 74 20 44 69 72 65 63  |r the 'Set Direc|
000043f0  74 6f 72 79 27 20 6d 6f  64 65 20 62 79 20 63 6c  |tory' mode by cl|
00004400  69 63 6b 69 6e 67 20 74  68 65 20 22 44 22 20 69  |icking the "D" i|
00004410  63 6f 6e 20 20 69 6e 20  0a 74 68 65 20 20 73 6f  |con  in .the  so|
00004420  6e 67 20 73 65 6c 65 63  74 69 6f 6e 20 77 69 6e  |ng selection win|
00004430  64 6f 77 20 28 77 68 65  6e 20 79 6f 75 20 61 72  |dow (when you ar|
00004440  65 20 74 68 65 20 4d 41  49 4e 20 6d 65 6e 75 2c  |e the MAIN menu,|
00004450  20 20 69 65 20 20 6e 6f  74 68 69 6e 67 20 20 65  |  ie  nothing  e|
00004460  6c 73 65 20 0a 73 65 6c  65 63 74 65 64 29 2e 0a  |lse .selected)..|
00004470  0a 54 6f 20 69 6e 73 74  61 6c 6c 20 43 6f 63 6f  |.To install Coco|
00004480  6e 69 7a 65 72 20 6f 6e  20 48 61 72 64 64 69 73  |nizer on Harddis|
00004490  63 20 6f 72 20 44 69 73  63 2c 20 20 73 65 65 20  |c or Disc,  see |
000044a0  74 68 65 20 22 52 65 61  64 79 3f 22 20 74 65 78  |the "Ready?" tex|
000044b0  74 20 6f 72 20 43 6f 63  6f 27 73 20 0a 21 42 6f  |t or Coco's .!Bo|
000044c0  6f 74 20 66 69 6c 65 20  70 6c 65 61 73 65 2e 0a  |ot file please..|
000044d0  0a 0a 0a 20 54 48 45 20  43 4f 43 4f 4e 49 5a 45  |... THE COCONIZE|
000044e0  52 20 55 53 41 47 45 0a  20 3d 3d 3d 3d 3d 3d 3d  |R USAGE. =======|
000044f0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 0a 0a 41 73  |============..As|
00004500  20 61 20 67 75 69 64 65  6c 69 6e 65 20 66 6f 72  | a guideline for|
00004510  20 74 68 65 20 6d 6f 75  73 65 20 68 61 6e 64 6c  | the mouse handl|
00004520  69 6e 67 2c 20 74 68 65  20 6c 65 66 74 20 62 75  |ing, the left bu|
00004530  74 74 6f 6e 20 69 6e 63  73 2f 64 65 63 73 20 73  |tton incs/decs s|
00004540  6c 6f 77 2c 20 74 68 65  20 0a 6d 69 64 20 62 75  |low, the .mid bu|
00004550  74 74 6f 6e 20 73 74 65  70 73 20 6e 6f 72 6d 61  |tton steps norma|
00004560  6c 2c 20 20 61 6e 64 20  74 68 65 20 72 69 67 68  |l,  and the righ|
00004570  74 20 62 75 74 74 6f 6e  20 73 74 65 70 73 20 66  |t button steps f|
00004580  61 73 74 20 74 68 72 6f  75 67 68 20 61 20 20 6c  |ast through a  l|
00004590  69 73 74 2e 20 0a 57 68  65 6e 20 20 63 68 61 6e  |ist. .When  chan|
000045a0  67 69 6e 67 20 20 64 65  66 61 75 6c 74 20 73 65  |ging  default se|
000045b0  74 74 69 6e 67 73 20 6c  69 6b 65 20 52 65 70 65  |ttings like Repe|
000045c0  61 74 41 74 2c 20 20 74  68 65 6e 20 20 70 72 65  |atAt,  then  pre|
000045d0  73 73 69 6e 67 20 20 74  68 65 20 20 6c 65 66 74  |ssing  the  left|
000045e0  20 0a 62 75 74 74 6f 6e  20 74 6f 67 65 74 68 65  | .button togethe|
000045f0  72 20 77 69 74 68 20 74  68 65 20 72 69 67 68 74  |r with the right|
00004600  20 6f 6e 65 20 73 74 65  70 20 76 65 72 79 20 66  | one step very f|
00004610  61 73 74 2e 0a 57 69 74  68 20 20 73 6f 6d 65 20  |ast..With  some |
00004620  63 6f 6e 74 72 6f 6c 20  69 63 6f 6e 73 20 6c 69  |control icons li|
00004630  6b 65 20 22 50 6c 61 79  22 20 61 6e 64 20 22 4c  |ke "Play" and "L|
00004640  6f 61 64 20 49 6e 73 74  2f 53 6f 6e 67 22 2c 20  |oad Inst/Song", |
00004650  20 74 68 65 20 20 6c 65  66 74 20 20 61 6e 64 20  | the  left  and |
00004660  0a 72 69 67 68 74 20 20  62 75 74 74 6f 6e 20 20  |.right  button  |
00004670  70 65 72 66 6f 72 6d 20  20 64 69 66 66 65 72 65  |perform  differe|
00004680  6e 74 20 61 63 74 69 6f  6e 73 2e 20 20 54 68 65  |nt actions.  The|
00004690  20 20 6c 65 66 74 20 20  6f 6e 65 20 20 63 6f 6e  |  left  one  con|
000046a0  74 69 6e 75 65 73 20 20  28 69 66 20 0a 70 6f 73  |tinues  (if .pos|
000046b0  73 69 62 6c 65 29 20 20  66 72 6f 6d 20 74 68 65  |sible)  from the|
000046c0  20 6c 61 73 74 20 73 74  6f 70 70 65 64 20 70 6f  | last stopped po|
000046d0  73 69 74 69 6f 6e 2c 20  20 61 6e 64 20 74 68 65  |sition,  and the|
000046e0  20 72 69 67 68 74 20 6f  6e 65 20 62 65 67 69 6e  | right one begin|
000046f0  73 20 20 66 72 6f 6d 20  0a 74 68 65 20 73 74 61  |s  from .the sta|
00004700  72 74 2c 20 69 65 20 72  65 73 74 61 72 74 73 2e  |rt, ie restarts.|
00004710  0a 0a 59 6f 75 20 74 6f  67 67 6c 65 20 63 68 61  |..You toggle cha|
00004720  6e 6e 65 6c 73 20 6f 6e  2f 6f 66 66 20 62 79 20  |nnels on/off by |
00004730  63 6c 69 63 6b 69 6e 67  20 6f 6e 20 74 68 65 20  |clicking on the |
00004740  76 6f 69 63 65 20 6e 75  6d 62 65 72 20 28 74 6f  |voice number (to|
00004750  20 74 68 65 20 6c 65 66  74 20 74 6f 20 0a 74 68  | the left to .th|
00004760  65 20 67 72 61 70 68 69  63 20 65 71 75 61 6c 69  |e graphic equali|
00004770  7a 65 72 29 2e 20 20 54  68 69 73 20 77 69 6c 6c  |zer).  This will|
00004780  20 68 65 6c 70 20 79 6f  75 20 65 64 69 74 69 6e  | help you editin|
00004790  67 20 61 20 73 6f 6e 67  20 61 6e 64 20 69 73 6f  |g a song and iso|
000047a0  6c 61 74 69 6e 67 20 61  20 0a 73 69 6e 67 6c 65  |lating a .single|
000047b0  20 76 6f 69 63 65 20 66  6f 72 20 63 6f 6e 74 72  | voice for contr|
000047c0  6f 6c 6c 69 6e 67 20 69  74 2e 0a 57 68 65 6e 20  |olling it..When |
000047d0  20 70 6c 61 79 69 6e 67  20 61 20 73 6f 6e 67 20  | playing a song |
000047e0  6f 72 20 70 61 74 74 65  72 6e 2c 20 20 74 68 65  |or pattern,  the|
000047f0  20 22 44 49 53 50 4c 41  59 22 20 69 63 6f 6e 20  | "DISPLAY" icon |
00004800  74 6f 67 67 6c 65 73 20  20 74 68 65 20 20 63 68  |toggles  the  ch|
00004810  61 6e 6e 65 6c 20 0a 64  69 73 70 6c 61 79 20 77  |annel .display w|
00004820  69 74 68 20 74 68 65 20  73 70 65 63 74 72 75 6d  |ith the spectrum|
00004830  20 61 6e 61 6c 79 7a 65  72 20 64 69 73 70 6c 61  | analyzer displa|
00004840  79 2e 20 44 75 72 69 6e  67 20 70 6c 61 79 20 74  |y. During play t|
00004850  68 65 20 63 75 72 73 6f  72 20 75 70 2f 64 6f 77  |he cursor up/dow|
00004860  6e 20 0a 61 72 72 6f 77  73 20 63 6f 6e 74 72 6f  |n .arrows contro|
00004870  6c 20 74 68 65 20 6f 76  65 72 61 6c 6c 20 76 6f  |l the overall vo|
00004880  6c 75 6d 65 20 28 75 73  65 66 75 6c 20 66 6f 72  |lume (useful for|
00004890  20 65 78 74 65 72 6e 61  6c 20 61 75 64 69 6f 20  | external audio |
000048a0  6f 75 74 70 75 74 29 2e  0a 0a 0a 49 74 20 66 6f  |output)....It fo|
000048b0  6c 6c 6f 77 73 20 61 6e  20 6f 76 65 72 76 69 65  |llows an overvie|
000048c0  77 20 61 62 6f 75 74 20  74 68 65 20 6d 61 69 6e  |w about the main|
000048d0  20 69 63 6f 6e 73 3a 0a  0a 20 2a 20 4c 4f 41 44  | icons:.. * LOAD|
000048e0  20 53 4f 4e 47 0a 20 20  20 43 6c 69 63 6b 69 6e  | SONG.   Clickin|
000048f0  67 20 20 74 68 69 73 20  69 63 6f 6e 20 6f 70 65  |g  this icon ope|
00004900  6e 73 20 74 68 65 20 73  65 6c 65 63 74 69 6f 6e  |ns the selection|
00004910  20 77 69 6e 64 6f 77 2e  20 20 54 6f 20 62 65 20  | window.  To be |
00004920  61 62 6c 65 20 74 6f 20  20 6c 6f 61 64 20 20 61  |able to  load  a|
00004930  20 0a 20 20 20 73 6f 6e  67 2c 20 79 6f 75 20 73  | .   song, you s|
00004940  68 6f 75 6c 64 20 68 61  76 65 20 69 6e 73 65 72  |hould have inser|
00004950  74 65 64 20 61 20 64 69  73 63 20 77 69 74 68 20  |ted a disc with |
00004960  61 20 73 6f 6e 67 20 64  69 72 65 63 74 6f 72 79  |a song directory|
00004970  2e 20 54 68 65 20 73 68  6f 77 65 64 20 0a 20 20  |. The showed .  |
00004980  20 73 6f 6e 67 73 20 61  72 65 20 74 68 6f 73 65  | songs are those|
00004990  20 6f 66 20 74 68 65 20  64 65 66 61 75 6c 74 20  | of the default |
000049a0  64 69 72 65 63 74 6f 72  79 20 22 53 6f 6e 67 73  |directory "Songs|
000049b0  22 2e 20 20 50 6c 65 61  73 65 20 63 6c 69 63 6b  |".  Please click|
000049c0  20 74 68 65 20 22 44 22  20 0a 20 20 20 69 63 6f  | the "D" .   ico|
000049d0  6e 20 77 68 69 6c 73 74  20 62 65 69 6e 67 20 69  |n whilst being i|
000049e0  6e 20 74 68 65 20 6d 61  69 6e 20 6d 65 6e 75 20  |n the main menu |
000049f0  28 69 65 20 6e 6f 74 20  61 74 20 4c 4f 41 44 20  |(ie not at LOAD |
00004a00  53 4f 4e 47 29 20 74 6f  20 73 65 74 20 61 6e 6f  |SONG) to set ano|
00004a10  74 68 65 72 20 0a 20 20  20 73 6f 6e 67 20 64 69  |ther .   song di|
00004a20  72 65 63 74 6f 72 79 2e  0a 20 20 20 41 66 74 65  |rectory..   Afte|
00004a30  72 20 6c 6f 61 64 69 6e  67 20 74 68 65 20 73 6f  |r loading the so|
00004a40  6e 67 2c 20 20 74 68 65  20 75 73 65 64 20 69 6e  |ng,  the used in|
00004a50  73 74 72 75 6d 65 6e 74  73 20 61 72 65 20 6c 6f  |struments are lo|
00004a60  61 64 65 64 2e 20 53 6f  20 74 68 65 72 65 20 77  |aded. So there w|
00004a70  69 6c 6c 20 0a 20 20 20  62 65 20 20 6d 6f 72 65  |ill .   be  more|
00004a80  20 20 6f 72 20 20 6c 65  73 73 20 64 69 73 63 20  |  or  less disc |
00004a90  63 68 61 6e 67 65 73 20  74 6f 20 62 65 20 64 6f  |changes to be do|
00004aa0  6e 65 2e 20 20 43 6f 63  6f 20 20 61 6c 77 61 79  |ne.  Coco  alway|
00004ab0  73 20 20 6c 6f 61 64 73  20 20 74 68 65 73 65 20  |s  loads  these |
00004ac0  0a 20 20 20 69 6e 73 74  72 75 6d 65 6e 74 73 20  |.   instruments |
00004ad0  20 62 65 67 69 6e 6e 69  6e 67 20 20 77 69 74 68  | beginning  with|
00004ae0  20 20 79 6f 75 72 20 53  61 6d 70 6c 65 20 44 69  |  your Sample Di|
00004af0  73 63 20 30 31 20 20 69  6e 20 20 61 73 63 65 6e  |sc 01  in  ascen|
00004b00  64 69 6e 67 20 20 28 64  69 73 63 20 0a 20 20 20  |ding  (disc .   |
00004b10  73 6f 72 74 65 64 29 20  6f 72 64 65 72 2e 20 49  |sorted) order. I|
00004b20  6e 73 74 72 75 6d 65 6e  74 73 20 77 68 69 63 68  |nstruments which|
00004b30  20 63 6f 75 6c 64 6e 27  74 20 62 65 20 66 6f 75  | couldn't be fou|
00004b40  6e 64 20 69 6e 20 74 68  65 20 6c 6f 63 61 74 69  |nd in the locati|
00004b50  6f 6e 20 66 69 6c 65 20  0a 20 20 20 61 72 65 20  |on file .   are |
00004b60  20 73 68 6f 77 6e 20 72  65 64 2c 20 20 61 6e 64  | shown red,  and|
00004b70  20 73 69 6d 69 6c 61 72  20 73 61 6d 70 6c 65 73  | similar samples|
00004b80  20 73 68 6f 75 6c 64 20  62 65 20 6c 6f 61 64 65  | should be loade|
00004b90  64 20 20 69 6e 73 74 65  61 64 20 20 28 70 6c 65  |d  instead  (ple|
00004ba0  61 73 65 20 0a 20 20 20  6e 6f 74 65 2c 20 74 68  |ase .   note, th|
00004bb0  65 79 20 63 61 6e 27 74  20 62 65 20 68 65 61 72  |ey can't be hear|
00004bc0  64 20 77 68 65 6e 20 74  68 65 79 20 61 72 65 20  |d when they are |
00004bd0  72 65 64 21 29 2e 0a 20  20 20 49 66 20 74 68 65  |red!)..   If the|
00004be0  20 6d 65 73 73 61 67 65  20 22 49 4e 53 45 52 54  | message "INSERT|
00004bf0  20 53 41 4d 50 4c 45 20  44 49 53 43 20 78 78 22  | SAMPLE DISC xx"|
00004c00  20 61 70 70 65 61 72 73  2c 20 20 61 6e 64 20 79  | appears,  and y|
00004c10  6f 75 20 6a 75 73 74 20  20 69 6e 73 65 72 74 65  |ou just  inserte|
00004c20  64 20 0a 20 20 20 74 68  65 20 20 72 69 67 68 74  |d .   the  right|
00004c30  20 20 73 61 6d 70 6c 65  20 20 64 69 73 63 20 20  |  sample  disc  |
00004c40  28 6f 72 20 75 73 65 20  61 20 48 44 29 2c 20 20  |(or use a HD),  |
00004c50  74 68 65 6e 20 20 74 68  69 73 20 20 73 68 6f 77  |then  this  show|
00004c60  73 20 20 74 68 61 74 20  20 79 6f 75 72 20 0a 20  |s  that  your . |
00004c70  20 20 22 6c 6f 63 61 74  69 6f 6e 22 20 20 66 69  |  "location"  fi|
00004c80  6c 65 20 20 69 73 20 20  6e 6f 74 20 75 70 64 61  |le  is  not upda|
00004c90  74 65 64 2c 20 20 69 65  20 43 6f 63 6f 20 74 68  |ted,  ie Coco th|
00004ca0  69 6e 6b 73 20 74 68 65  72 65 20 20 77 6f 75 6c  |inks there  woul|
00004cb0  64 20 20 62 65 20 20 61  6e 20 0a 20 20 20 69 6e  |d  be  an .   in|
00004cc0  73 74 72 75 6d 65 6e 74  20 74 68 61 74 20 61 63  |strument that ac|
00004cd0  74 75 61 6c 6c 79 20 69  73 20 6e 6f 74 20 6f 6e  |tually is not on|
00004ce0  20 79 6f 75 72 20 64 69  73 63 73 20 6f 72 20 69  | your discs or i|
00004cf0  6e 20 61 6e 6f 74 68 65  72 20 49 6e 73 74 58 20  |n another InstX |
00004d00  20 74 68 61 6e 20 0a 20  20 20 73 70 65 63 69 66  | than .   specif|
00004d10  69 65 64 2e 20 20 50 6c  65 61 73 65 20 72 65 6c  |ied.  Please rel|
00004d20  6f 63 61 74 65 20 79 6f  75 72 20 73 61 6d 70 6c  |ocate your sampl|
00004d30  65 20 64 69 73 63 73 20  77 69 74 68 20 74 68 65  |e discs with the|
00004d40  20 74 6f 6f 6c 73 20 20  22 4c 6f 63 61 74 65 72  | tools  "Locater|
00004d50  22 20 0a 20 20 20 69 6e  20 73 75 63 68 20 63 61  |" .   in such ca|
00004d60  73 65 73 2e 0a 0a 20 20  20 41 6e 20 61 6c 74 65  |ses...   An alte|
00004d70  72 6e 61 74 69 76 65 20  77 61 79 20 6f 66 20 6c  |rnative way of l|
00004d80  6f 61 64 69 6e 67 20 73  6f 6e 67 73 20 69 73 20  |oading songs is |
00004d90  74 6f 20 64 72 61 67 20  6f 72 20 64 6f 75 62 6c  |to drag or doubl|
00004da0  65 20 63 6c 69 63 6b 20  74 68 65 6d 20 20 69 6e  |e click them  in|
00004db0  20 0a 20 20 20 74 68 65  20 20 75 73 75 61 6c 20  | .   the  usual |
00004dc0  64 69 72 65 63 74 6f 72  79 20 76 69 65 77 65 72  |directory viewer|
00004dd0  20 6d 65 74 68 6f 64 20  6f 66 20 74 68 65 20 64  | method of the d|
00004de0  65 73 6b 74 6f 70 2e 20  20 46 6f 72 20 75 73 65  |esktop.  For use|
00004df0  20 20 77 69 74 68 20 20  6d 6f 72 65 20 0a 20 20  |  with  more .  |
00004e00  20 74 68 61 6e 20 6f 6e  65 20 64 69 73 63 20 64  | than one disc d|
00004e10  72 69 76 65 20 74 68 69  73 20 6d 65 74 68 6f 64  |rive this method|
00004e20  20 73 61 76 65 73 20 73  6f 6d 65 20 64 69 73 63  | saves some disc|
00004e30  20 63 68 61 6e 67 65 73  2e 0a 0a 20 2a 20 53 41  | changes... * SA|
00004e40  56 45 20 53 4f 4e 47 0a  20 20 20 59 6f 75 72 20  |VE SONG.   Your |
00004e50  20 77 6f 72 6b 20 77 69  6c 6c 20 62 65 20 73 61  | work will be sa|
00004e60  76 65 64 20 61 66 74 65  72 20 65 6e 74 65 72 69  |ved after enteri|
00004e70  6e 67 20 61 20 73 61 76  65 20 6e 61 6d 65 2e 20  |ng a save name. |
00004e80  20 50 61 63 6b 65 64 20  73 61 76 69 6e 67 20 20  | Packed saving  |
00004e90  69 73 20 0a 20 20 20 61  73 6b 65 64 20 20 66 6f  |is .   asked  fo|
00004ea0  72 2e 20 20 54 68 65 20  20 6f 70 65 72 61 74 69  |r.  The  operati|
00004eb0  6f 6e 20 6d 61 79 20 62  65 20 63 61 6e 63 65 6c  |on may be cancel|
00004ec0  6c 65 64 20 76 69 61 20  74 68 65 20 45 53 43 20  |led via the ESC |
00004ed0  20 6b 65 79 2e 20 20 49  66 20 20 74 68 65 20 0a  | key.  If  the .|
00004ee0  20 20 20 73 61 76 69 6e  67 20 20 73 68 6f 75 6c  |   saving  shoul|
00004ef0  64 20 66 61 69 6c 2c 20  20 79 6f 75 20 77 69 6c  |d fail,  you wil|
00004f00  6c 20 6e 6f 74 69 63 65  20 61 6e 20 61 70 70 72  |l notice an appr|
00004f10  6f 70 72 69 61 74 65 20  62 6c 69 6e 6b 69 6e 67  |opriate blinking|
00004f20  20 20 6d 65 73 73 61 67  65 2e 20 0a 20 20 20 50  |  message. .   P|
00004f30  6c 65 61 73 65 20 63 6c  69 63 6b 20 61 20 62 75  |lease click a bu|
00004f40  74 74 6f 6e 20 74 6f 20  63 6c 65 61 72 20 74 68  |tton to clear th|
00004f50  65 20 6d 65 73 73 61 67  65 2c 20 74 68 65 6e 20  |e message, then |
00004f60  72 65 74 72 79 2e 0a 0a  20 20 20 41 6e 20 20 61  |retry...   An  a|
00004f70  6c 74 65 72 6e 61 74 69  76 65 20 20 77 61 79 20  |lternative  way |
00004f80  20 6f 66 20 20 73 61 76  69 6e 67 20 61 20 73 6f  | of  saving a so|
00004f90  6e 67 20 69 73 20 76 69  61 20 20 74 68 65 20 20  |ng is via  the  |
00004fa0  22 53 61 76 65 42 6f 78  22 20 20 6f 66 20 20 74  |"SaveBox"  of  t|
00004fb0  68 65 20 0a 20 20 20 43  6f 63 6f 6e 69 7a 65 72  |he .   Coconizer|
00004fc0  20 69 63 6f 6e 2e 20 54  68 69 73 20 77 6f 72 6b  | icon. This work|
00004fd0  73 20 69 6e 20 74 68 65  20 75 73 75 61 6c 20 64  |s in the usual d|
00004fe0  65 73 6b 74 6f 70 20 6d  61 6e 6e 65 72 2e 0a 0a  |esktop manner...|
00004ff0  20 2a 20 4c 4f 41 44 20  49 4e 53 54 0a 20 20 20  | * LOAD INST.   |
00005000  41 20 20 6e 65 77 20 20  69 6e 73 74 72 75 6d 65  |A  new  instrume|
00005010  6e 74 20 20 69 73 20 20  61 64 64 65 64 20 74 6f  |nt  is  added to|
00005020  20 74 68 65 20 69 6e 73  74 72 75 6d 65 6e 74 20  | the instrument |
00005030  20 70 6f 6f 6c 20 20 69  66 20 20 74 68 65 20 20  | pool  if  the  |
00005040  63 75 72 72 65 6e 74 20  0a 20 20 20 69 6e 73 74  |current .   inst|
00005050  72 75 6d 65 6e 74 20 70  6c 61 63 65 20 69 73 20  |rument place is |
00005060  65 6d 70 74 79 2c 20 20  61 6e 64 20 61 6e 20 6f  |empty,  and an o|
00005070  6c 64 20 6f 6e 65 20 69  73 20 72 65 70 6c 61 63  |ld one is replac|
00005080  65 64 20 77 69 74 68 20  74 68 65 20 6e 65 77 20  |ed with the new |
00005090  6f 6e 65 20 0a 20 20 20  69 66 20 69 74 73 20 70  |one .   if its p|
000050a0  6c 61 63 65 20 77 61 73  20 61 6c 72 65 61 64 79  |lace was already|
000050b0  20 75 73 65 64 2e 0a 20  20 20 54 68 65 20 20 6e  | used..   The  n|
000050c0  75 6d 62 65 72 20 74 6f  20 74 68 65 20 72 69 67  |umber to the rig|
000050d0  68 74 20 6f 66 20 74 68  65 20 69 6e 73 74 72 75  |ht of the instru|
000050e0  6d 65 6e 74 20 69 6e 20  74 68 65 20 73 65 6c 65  |ment in the sele|
000050f0  63 74 69 6f 6e 20 6c 69  73 74 20 20 68 6f 6c 64  |ction list  hold|
00005100  73 20 0a 20 20 20 74 68  65 20 20 4b 20 42 79 74  |s .   the  K Byt|
00005110  65 73 20 20 6f 66 20 74  68 65 20 73 61 6d 70 6c  |es  of the sampl|
00005120  65 20 6f 6e 20 64 69 73  63 2e 20 20 54 68 65 20  |e on disc.  The |
00005130  66 6f 6c 6c 6f 77 69 6e  67 20 6e 75 6d 62 65 72  |following number|
00005140  20 20 73 68 6f 77 73 20  20 6f 6e 74 6f 20 0a 20  |  shows  onto . |
00005150  20 20 77 68 69 63 68 20  64 69 73 63 20 69 74 20  |  which disc it |
00005160  69 73 20 6c 6f 63 61 74  65 64 2e 0a 0a 20 2a 20  |is located... * |
00005170  50 4c 41 59 0a 20 20 20  43 6c 69 63 6b 69 6e 67  |PLAY.   Clicking|
00005180  20 74 68 65 20 6c 65 66  74 20 6d 6f 75 73 65 20  | the left mouse |
00005190  62 75 74 74 6f 6e 20 63  6f 6e 74 69 6e 75 65 73  |button continues|
000051a0  20 70 6c 61 79 69 6e 67  20 74 68 65 20 73 6f 6e  | playing the son|
000051b0  67 2c 20 20 61 74 20 74  68 65 20 6c 61 73 74 20  |g,  at the last |
000051c0  0a 20 20 20 73 74 6f 70  70 65 64 20 20 70 6f 73  |.   stopped  pos|
000051d0  69 74 69 6f 6e 20 20 28  69 66 20 70 6f 73 73 69  |ition  (if possi|
000051e0  62 6c 65 29 2e 20 20 54  68 65 20 6d 69 64 64 6c  |ble).  The middl|
000051f0  65 20 62 75 74 74 6f 6e  20 63 6f 6e 74 69 6e 75  |e button continu|
00005200  65 73 20 20 61 74 20 20  74 68 65 20 0a 20 20 20  |es  at  the .   |
00005210  62 65 67 69 6e 6e 69 6e  67 20 20 6f 66 20 74 68  |beginning  of th|
00005220  65 20 6c 61 73 74 20 73  74 6f 70 70 65 64 20 70  |e last stopped p|
00005230  61 74 74 65 72 6e 2e 20  20 41 6e 64 20 74 68 65  |attern.  And the|
00005240  20 72 69 67 68 74 20 62  75 74 74 6f 6e 20 20 72  | right button  r|
00005250  65 73 74 61 72 74 73 20  0a 20 20 20 74 68 65 20  |estarts .   the |
00005260  73 6f 6e 67 20 66 72 6f  6d 20 69 74 73 20 62 65  |song from its be|
00005270  67 69 6e 6e 69 6e 67 2e  0a 0a 20 2a 20 53 54 4f  |ginning... * STO|
00005280  50 0a 20 20 20 55 73 65  64 20 20 74 6f 20 20 73  |P.   Used  to  s|
00005290  74 6f 70 20 70 6c 61 79  69 6e 67 2c 20 20 74 6f  |top playing,  to|
000052a0  20 6c 65 61 76 65 20 74  68 65 20 65 64 69 74 20  | leave the edit |
000052b0  6d 6f 64 75 73 20 61 6e  64 20 20 74 6f 20 20 73  |modus and  to  s|
000052c0  74 6f 70 20 20 70 61 74  74 65 72 6e 20 0a 20 20  |top  pattern .  |
000052d0  20 70 6c 61 79 69 6e 67  2e 20 20 57 68 65 6e 20  | playing.  When |
000052e0  63 6c 69 63 6b 65 64 20  69 6e 20 65 64 69 74 20  |clicked in edit |
000052f0  26 20 70 6c 61 79 5f 70  61 74 74 65 72 6e 20 28  |& play_pattern (|
00005300  64 65 62 75 67 20 6f 66  66 29 20 74 68 65 6e 20  |debug off) then |
00005310  74 68 65 20 6c 65 66 74  20 0a 20 20 20 62 75 74  |the left .   but|
00005320  74 6f 6e 20 73 74 6f 70  73 2c 20 20 61 6e 64 20  |ton stops,  and |
00005330  73 65 74 73 20 74 68 65  20 63 75 72 73 6f 72 20  |sets the cursor |
00005340  74 6f 20 74 68 65 20 6c  61 73 74 20 70 6c 61 79  |to the last play|
00005350  65 64 20 6c 69 6e 65 2e  20 20 54 68 65 20 20 72  |ed line.  The  r|
00005360  69 67 68 74 20 0a 20 20  20 62 75 74 74 6f 6e 20  |ight .   button |
00005370  73 65 74 73 20 74 68 65  20 63 75 72 73 6f 72 20  |sets the cursor |
00005380  74 6f 20 74 68 65 20 74  6f 70 20 6f 66 20 74 68  |to the top of th|
00005390  65 20 70 61 74 74 65 72  6e 2e 0a 0a 20 2a 20 45  |e pattern... * E|
000053a0  44 49 54 20 50 41 54 54  45 52 4e 0a 20 20 20 46  |DIT PATTERN.   F|
000053b0  6f 72 20 20 65 64 69 74  69 6e 67 20 20 74 68 65  |or  editing  the|
000053c0  72 65 20 6d 75 73 74 20  62 65 20 6f 6e 65 20 6c  |re must be one l|
000053d0  6f 61 64 65 64 20 69 6e  73 74 72 75 6d 65 6e 74  |oaded instrument|
000053e0  20 61 74 20 20 6c 65 61  73 74 2e 20 20 54 68 65  | at  least.  The|
000053f0  6e 20 20 74 68 65 20 0a  20 20 20 63 75 72 72 65  |n  the .   curre|
00005400  6e 74 20 70 61 74 74 65  72 6e 20 6e 75 6d 62 65  |nt pattern numbe|
00005410  72 20 69 73 20 65 6e 74  65 72 65 64 2e 20 20 59  |r is entered.  Y|
00005420  6f 75 20 6d 61 79 20 73  74 65 70 20 74 68 72 6f  |ou may step thro|
00005430  75 67 68 20 79 6f 75 72  20 20 70 61 74 74 65 72  |ugh your  patter|
00005440  6e 73 20 0a 20 20 20 62  79 20 63 6c 69 63 6b 69  |ns .   by clicki|
00005450  6e 67 20 74 68 65 20 6c  65 66 74 2f 72 69 67 68  |ng the left/righ|
00005460  74 20 61 72 72 6f 77 20  61 74 20 74 68 65 20 70  |t arrow at the p|
00005470  61 74 74 65 72 6e 20 6e  75 6d 62 65 72 2e 0a 20  |attern number.. |
00005480  20 20 49 66 20 20 79 6f  75 20 77 69 73 68 20 74  |  If  you wish t|
00005490  6f 20 63 72 65 61 74 65  20 61 20 6e 65 77 20 70  |o create a new p|
000054a0  61 74 74 65 72 6e 2c 20  20 74 68 65 6e 20 79 6f  |attern,  then yo|
000054b0  75 27 76 65 20 74 6f 20  73 65 6c 65 63 74 20 74  |u've to select t|
000054c0  68 65 20 20 62 6c 61 6e  6b 20 0a 20 20 20 70 61  |he  blank .   pa|
000054d0  74 74 65 72 6e 20 20 61  66 74 65 72 20 20 74 68  |ttern  after  th|
000054e0  65 20 6c 61 73 74 20 6f  6e 65 20 61 76 61 69 6c  |e last one avail|
000054f0  61 62 6c 65 2c 20 20 79  6f 75 27 76 65 20 74 6f  |able,  you've to|
00005500  20 64 6f 20 74 68 69 73  20 20 62 65 66 6f 72 65  | do this  before|
00005510  20 20 79 6f 75 20 0a 20  20 20 63 6c 69 63 6b 20  |  you .   click |
00005520  74 68 65 20 45 44 49 54  20 69 63 6f 6e 2e 0a 20  |the EDIT icon.. |
00005530  20 20 51 75 69 74 20 65  64 69 74 69 6e 67 20 77  |  Quit editing w|
00005540  69 74 68 20 65 69 74 68  65 72 20 74 68 65 20 53  |ith either the S|
00005550  54 4f 50 20 69 63 6f 6e  20 6f 72 20 74 68 65 20  |TOP icon or the |
00005560  45 4e 54 45 52 20 6b 65  79 2e 0a 0a 20 20 20 49  |ENTER key...   I|
00005570  6e 66 6f 72 6d 61 74 69  6f 6e 73 20 61 62 6f 75  |nformations abou|
00005580  74 20 74 68 65 20 6b 65  79 6d 61 70 3a 0a 20 20  |t the keymap:.  |
00005590  20 20 20 54 68 65 20 20  66 75 6e 63 74 69 6f 6e  |   The  function|
000055a0  20 6b 65 79 73 20 46 31  20 2d 20 46 38 20 73 65  | keys F1 - F8 se|
000055b0  74 20 74 68 65 20 63 75  72 73 6f 72 20 74 6f 20  |t the cursor to |
000055c0  74 68 65 20 65 71 75 69  76 61 6c 65 6e 74 20 20  |the equivalent  |
000055d0  63 68 61 6e 6e 65 6c 2e  20 0a 20 20 20 20 20 54  |channel. .     T|
000055e0  41 42 20 6a 75 6d 70 73  20 74 6f 20 74 68 65 20  |AB jumps to the |
000055f0  6e 65 78 74 20 63 68 61  6e 6e 65 6c 20 72 6f 77  |next channel row|
00005600  2e 0a 20 20 20 20 20 49  66 20 20 74 68 65 20 20  |..     If  the  |
00005610  63 75 72 73 6f 72 20 20  69 73 20 61 74 20 74 68  |cursor  is at th|
00005620  65 20 6e 6f 74 65 20 72  6f 77 20 6f 66 20 61 20  |e note row of a |
00005630  20 63 68 61 6e 6e 65 6c  2c 20 20 74 68 65 6e 20  | channel,  then |
00005640  20 70 72 65 73 73 69 6e  67 20 20 61 20 0a 20 20  | pressing  a .  |
00005650  20 20 20 22 70 69 61 6e  6f 22 20 20 6b 65 79 20  |   "piano"  key |
00005660  20 77 69 6c 6c 20 20 65  6e 74 65 72 20 74 68 65  | will  enter the|
00005670  20 70 75 73 68 65 64 20  6e 6f 74 65 20 26 20 20  | pushed note &  |
00005680  63 75 72 72 65 6e 74 20  20 6f 63 74 61 76 65 2e  |current  octave.|
00005690  20 20 41 20 20 6e 65 77  20 0a 20 20 20 20 20 69  |  A  new .     i|
000056a0  6e 73 74 72 75 6d 65 6e  74 20 20 65 6e 74 72 79  |nstrument  entry|
000056b0  20 77 69 6c 6c 20 62 65  20 70 65 72 66 6f 72 6d  | will be perform|
000056c0  65 64 20 69 66 20 69 74  20 77 61 73 20 6e 6f 74  |ed if it was not|
000056d0  20 74 68 65 20 73 61 6d  65 20 20 6c 69 6b 65 20  | the same  like |
000056e0  20 74 68 65 20 0a 20 20  20 20 20 6c 61 73 74 20  | the .     last |
000056f0  20 6f 6e 65 2e 20 20 4b  65 79 70 61 64 20 6b 65  | one.  Keypad ke|
00005700  79 73 20 22 2b 22 20 61  6e 64 20 22 2d 22 20 28  |ys "+" and "-" (|
00005710  6f 72 20 74 68 65 20 6f  63 74 61 76 65 20 69 63  |or the octave ic|
00005720  6f 6e 29 20 63 68 61 6e  67 65 73 20 20 74 68 65  |on) changes  the|
00005730  20 0a 20 20 20 20 20 63  75 72 72 65 6e 74 20 6f  | .     current o|
00005740  63 74 61 76 65 2e 0a 20  20 20 20 20 4d 6f 76 69  |ctave..     Movi|
00005750  6e 67 20 20 74 68 65 20  63 75 72 73 6f 72 20 61  |ng  the cursor a|
00005760  6c 6c 6f 77 73 20 79 6f  75 20 74 6f 20 65 6e 74  |llows you to ent|
00005770  65 72 20 61 6c 6c 20 6f  74 68 65 72 20 20 69 6e  |er all other  in|
00005780  66 6f 72 6d 61 74 69 6f  6e 73 2c 20 20 6c 69 6b  |formations,  lik|
00005790  65 20 0a 20 20 20 20 20  63 6f 6d 6d 61 6e 64 73  |e .     commands|
000057a0  2c 20 20 61 6e 64 20 20  73 6f 20 6f 6e 2e 20 20  |,  and  so on.  |
000057b0  57 69 74 68 20 50 61 67  65 20 75 70 2f 64 6f 77  |With Page up/dow|
000057c0  6e 20 79 6f 75 20 73 74  65 70 20 74 6f 20 20 74  |n you step to  t|
000057d0  68 65 20 20 6e 65 78 74  2f 6c 61 73 74 20 0a 20  |he  next/last . |
000057e0  20 20 20 20 67 72 65 65  6e 20 6d 61 72 6b 2e 20  |    green mark. |
000057f0  20 52 45 54 55 52 4e 20  73 74 65 70 73 20 74 6f  | RETURN steps to|
00005800  20 74 68 65 20 75 70 70  65 72 20 72 69 67 68 74  | the upper right|
00005810  20 63 75 72 73 6f 72 20  70 6f 73 69 74 69 6f 6e  | cursor position|
00005820  20 61 6e 64 20 20 74 68  65 20 0a 20 20 20 20 20  | and  the .     |
00005830  22 7e 22 20 6b 65 79 20  6d 75 74 65 73 20 61 6c  |"~" key mutes al|
00005840  6c 20 73 6f 75 6e 64 20  61 63 74 69 76 69 74 79  |l sound activity|
00005850  2e 0a 0a 20 20 20 50 61  73 74 65 2f 64 65 6c 65  |...   Paste/dele|
00005860  74 65 20 66 75 6e 63 74  69 6f 6e 73 3a 0a 20 20  |te functions:.  |
00005870  20 20 20 22 42 61 63 6b  73 70 61 63 65 22 20 20  |   "Backspace"  |
00005880  63 6c 65 61 72 73 20 20  74 68 65 20 63 75 72 72  |clears  the curr|
00005890  65 6e 74 20 69 6e 66 6f  72 6d 61 74 69 6f 6e 20  |ent information |
000058a0  65 6e 74 72 79 2e 20 20  4b 65 79 20 20 22 2d 22  |entry.  Key  "-"|
000058b0  20 20 63 6c 65 61 72 73  20 0a 20 20 20 20 20 65  |  clears .     e|
000058c0  69 74 68 65 72 20 74 68  65 20 6e 6f 74 65 2c 20  |ither the note, |
000058d0  20 69 6e 73 74 2c 20 63  6f 6d 6d 61 6e 64 20 6f  | inst, command o|
000058e0  72 20 74 68 65 20 69 6e  66 6f 62 79 74 65 20 65  |r the infobyte e|
000058f0  6e 74 72 79 2c 20 64 65  70 65 6e 64 69 6e 67 20  |ntry, depending |
00005900  6f 6e 74 6f 20 0a 20 20  20 20 20 74 68 65 20 63  |onto .     the c|
00005910  75 72 73 6f 72 20 70 6f  73 69 74 69 6f 6e 2e 0a  |ursor position..|
00005920  20 20 20 20 20 22 49 6e  73 65 72 74 22 20 20 69  |     "Insert"  i|
00005930  6e 73 65 72 74 73 20 20  61 20 20 66 72 65 65 20  |nserts  a  free |
00005940  74 6f 6e 65 20 65 6e 74  72 79 20 61 74 20 20 79  |tone entry at  y|
00005950  6f 75 72 20 20 63 75 72  72 65 6e 74 20 20 76 6f  |our  current  vo|
00005960  69 63 65 2e 20 20 57 69  74 68 20 0a 20 20 20 20  |ice.  With .    |
00005970  20 22 44 65 6c 65 74 65  22 20 79 6f 75 20 6b 69  | "Delete" you ki|
00005980  6c 6c 20 6f 6e 65 20 74  6f 6e 65 20 61 6e 64 20  |ll one tone and |
00005990  73 68 69 66 74 73 20 74  68 65 20 66 6f 6c 6c 6f  |shifts the follo|
000059a0  77 65 72 73 20 75 70 2e  0a 20 20 20 20 20 54 68  |wers up..     Th|
000059b0  65 20 20 6b 65 79 70 61  64 20 22 2f 22 20 64 65  |e  keypad "/" de|
000059c0  6c 65 74 65 73 20 6f 6e  65 20 77 68 6f 6c 65 20  |letes one whole |
000059d0  63 68 61 6e 6e 65 6c 20  72 6f 77 20 61 6e 64 20  |channel row and |
000059e0  6b 65 79 70 61 64 20 22  2a 22 20 20 64 65 6c 65  |keypad "*"  dele|
000059f0  74 65 73 20 0a 20 20 20  20 20 6f 6e 65 20 20 77  |tes .     one  w|
00005a00  68 6f 6c 65 20 6c 69 6e  65 2e 20 20 41 6e 64 20  |hole line.  And |
00005a10  66 69 6e 61 6c 6c 79 20  74 68 65 20 22 48 6f 6d  |finally the "Hom|
00005a20  65 22 20 6b 65 79 20 63  6f 70 69 65 73 20 61 6c  |e" key copies al|
00005a30  6c 20 36 34 20 20 74 6f  6e 65 73 20 20 6f 66 20  |l 64  tones  of |
00005a40  0a 20 20 20 20 20 79 6f  75 72 20 63 75 72 72 65  |.     your curre|
00005a50  6e 74 20 63 68 61 6e 6e  65 6c 20 69 6e 74 6f 20  |nt channel into |
00005a60  61 20 62 75 66 66 65 72  20 28 64 6f 69 6e 67 20  |a buffer (doing |
00005a70  61 20 66 6c 61 73 68 20  74 6f 20 69 6e 64 69 63  |a flash to indic|
00005a80  61 74 65 20 20 74 68 69  73 29 2c 20 0a 20 20 20  |ate  this), .   |
00005a90  20 20 74 68 65 20 22 43  6f 70 79 22 20 6b 65 79  |  the "Copy" key|
00005aa0  20 77 72 69 74 65 73 20  74 68 65 20 62 75 66 66  | writes the buff|
00005ab0  65 72 20 62 61 63 6b 20  74 6f 20 74 68 65 20 63  |er back to the c|
00005ac0  75 72 72 65 6e 74 20 63  68 61 6e 6e 65 6c 2e 0a  |urrent channel..|
00005ad0  0a 20 2a 20 50 4c 41 59  20 50 41 54 54 45 52 4e  |. * PLAY PATTERN|
00005ae0  0a 20 20 20 54 68 69 73  20 63 6f 6d 6d 61 6e 64  |.   This command|
00005af0  20 69 73 20 66 6f 72 20  72 65 70 65 61 74 65 64  | is for repeated|
00005b00  20 70 6c 61 79 69 6e 67  20 6f 66 20 74 68 65 20  | playing of the |
00005b10  63 75 72 72 65 6e 74 20  70 61 74 74 65 72 6e 2e  |current pattern.|
00005b20  0a 20 20 20 43 6c 69 63  6b 69 6e 67 20 74 68 69  |.   Clicking thi|
00005b30  73 20 69 63 6f 6e 20 69  6e 20 65 64 69 74 20 6d  |s icon in edit m|
00005b40  6f 64 65 20 77 69 74 68  20 64 65 62 75 67 20 6f  |ode with debug o|
00005b50  6e 2c 20 63 68 61 6e 67  65 73 20 69 74 73 20 6d  |n, changes its m|
00005b60  65 61 6e 69 6e 67 3a 20  41 6c 6c 20 0a 20 20 20  |eaning: All .   |
00005b70  6b 65 79 62 6f 61 72 64  20 70 72 65 73 73 65 73  |keyboard presses|
00005b80  20 61 72 65 20 72 65 63  6f 72 64 65 64 2e 20 20  | are recorded.  |
00005b90  54 68 65 20 70 61 74 74  65 72 6e 20 69 73 20 70  |The pattern is p|
00005ba0  6c 61 79 65 64 2c 20 20  61 6e 64 20 79 6f 75 72  |layed,  and your|
00005bb0  20 69 6e 70 75 74 73 20  0a 20 20 20 61 72 65 20  | inputs .   are |
00005bc0  64 69 72 65 63 74 6c 79  20 65 6e 74 65 72 65 64  |directly entered|
00005bd0  20 74 6f 20 74 68 65 20  63 75 72 72 65 6e 74 20  | to the current |
00005be0  63 75 72 73 6f 72 20 70  6f 73 69 74 69 6f 6e 2e  |cursor position.|
00005bf0  0a 0a 20 2a 20 44 45 42  55 47 20 6f 6e 20 28 6f  |.. * DEBUG on (o|
00005c00  66 66 29 0a 20 20 20 49  66 20 20 79 6f 75 27 72  |ff).   If  you'r|
00005c10  65 20 69 6e 20 65 64 69  74 20 6d 6f 64 65 2c 20  |e in edit mode, |
00005c20  20 61 6e 64 20 64 65 62  75 67 20 69 73 20 6f 6e  | and debug is on|
00005c30  2c 20 20 74 68 65 6e 20  61 6c 6c 20 74 68 65 20  |,  then all the |
00005c40  6e 6f 74 65 73 20 20 6f  66 20 20 6f 6e 65 20 0a  |notes  of  one .|
00005c50  20 20 20 70 61 74 74 65  72 6e 20 6c 69 6e 65 20  |   pattern line |
00005c60  61 72 65 20 70 6c 61 79  65 64 20 77 68 65 6e 20  |are played when |
00005c70  6d 6f 76 69 6e 67 20 74  68 65 20 63 75 72 73 6f  |moving the curso|
00005c80  72 20 75 70 2f 64 6f 77  6e 2e 20 20 54 68 69 73  |r up/down.  This|
00005c90  20 61 6c 6c 6f 77 73 20  20 61 20 0a 20 20 20 76  | allows  a .   v|
00005ca0  65 72 79 20 65 78 61 63  74 20 77 61 79 20 6f 66  |ery exact way of|
00005cb0  20 65 64 69 74 69 6e 67  20 61 6e 64 2f 6f 72 20  | editing and/or |
00005cc0  66 69 6e 64 69 6e 67 20  22 77 72 6f 6e 67 22 20  |finding "wrong" |
00005cd0  6e 6f 74 65 73 2e 0a 20  20 20 49 66 20 22 70 6c  |notes..   If "pl|
00005ce0  61 79 20 70 61 74 74 65  72 6e 22 20 69 73 20 61  |ay pattern" is a|
00005cf0  63 74 69 76 65 20 74 68  65 6e 20 72 65 63 6f 72  |ctive then recor|
00005d00  64 69 6e 67 20 77 6f 72  6b 73 20 77 69 74 68 20  |ding works with |
00005d10  73 6c 6f 77 20 6d 6f 74  69 6f 6e 2c 20 20 61 6e  |slow motion,  an|
00005d20  64 20 0a 20 20 20 73 6f  6d 65 20 20 6b 65 79 73  |d .   some  keys|
00005d30  2c 20 20 6c 69 6b 65 20  74 68 65 20 73 70 61 63  |,  like the spac|
00005d40  65 20 62 61 72 20 61 6e  64 20 74 68 65 20 63 75  |e bar and the cu|
00005d50  72 73 6f 72 20 20 6b 65  79 73 2c 20 20 70 65 72  |rsor  keys,  per|
00005d60  66 6f 72 6d 20 20 73 70  65 63 69 61 6c 20 0a 20  |form  special . |
00005d70  20 20 61 63 74 69 6f 6e  73 2e 20 20 54 68 65 20  |  actions.  The |
00005d80  73 70 65 65 64 20 6f 66  20 74 68 65 20 22 73 6c  |speed of the "sl|
00005d90  6f 77 20 6d 6f 74 69 6f  6e 22 20 6d 61 79 20 62  |ow motion" may b|
00005da0  65 20 73 65 74 20 77 69  74 68 20 66 75 6e 63 74  |e set with funct|
00005db0  69 6f 6e 20 20 6b 65 79  73 20 0a 20 20 20 46 39  |ion  keys .   F9|
00005dc0  2d 46 31 32 2c 20 69 6e  20 56 73 79 6e 63 73 3a  |-F12, in Vsyncs:|
00005dd0  20 46 39 3d 33 2c 20 46  31 30 3d 35 2c 20 46 31  | F9=3, F10=5, F1|
00005de0  31 3d 37 2c 20 46 31 32  3d 31 32 2e 0a 20 20 20  |1=7, F12=12..   |
00005df0  4e 6f 74 65 20 74 68 61  74 20 22 64 65 62 75 67  |Note that "debug|
00005e00  5f 6f 6e 22 20 64 69 73  61 62 6c 65 73 20 65 66  |_on" disables ef|
00005e10  66 65 63 74 73 20 6f 66  20 62 65 69 6e 67 20 70  |fects of being p|
00005e20  65 72 66 6f 72 6d 65 64  2c 20 63 61 75 73 65 20  |erformed, cause |
00005e30  6f 66 20 73 6c 6f 77 20  0a 20 20 20 6d 6f 74 69  |of slow .   moti|
00005e40  6f 6e 20 28 74 68 61 74  20 65 76 65 6e 20 6d 65  |on (that even me|
00005e50  61 6e 73 20 22 70 6c 61  79 20 70 61 74 74 65 72  |ans "play patter|
00005e60  6e 22 20 6d 75 74 65 73  20 74 68 65 20 65 66 66  |n" mutes the eff|
00005e70  65 63 74 73 20 74 6f 6f  29 2e 0a 0a 20 2a 20 45  |ects too)... * E|
00005e80  44 49 54 20 53 45 51 55  45 4e 43 45 0a 20 20 20  |DIT SEQUENCE.   |
00005e90  54 68 65 20 20 73 65 6c  65 63 74 69 6f 6e 20 20  |The  selection  |
00005ea0  77 69 6e 64 6f 77 20 20  6f 70 65 6e 73 20 20 61  |window  opens  a|
00005eb0  6e 64 20 79 6f 75 20 6d  61 79 20 63 68 6f 6f 73  |nd you may choos|
00005ec0  65 20 20 74 68 65 20 20  6f 72 64 65 72 20 20 6f  |e  the  order  o|
00005ed0  66 20 20 79 6f 75 72 20  0a 20 20 20 70 61 74 74  |f  your .   patt|
00005ee0  65 72 6e 73 2e 20 20 57  69 74 68 20 20 22 45 6e  |erns.  With  "En|
00005ef0  74 65 72 22 20 79 6f 75  20 69 6e 70 75 74 20 61  |ter" you input a|
00005f00  20 6e 65 77 20 70 61 74  74 65 72 6e 20 6e 75 6d  | new pattern num|
00005f10  62 65 72 2c 20 20 6f 72  20 20 65 64 69 74 20 20  |ber,  or  edit  |
00005f20  74 68 65 20 0a 20 20 20  63 75 72 72 65 6e 74 20  |the .   current |
00005f30  6f 6e 65 2e 20 20 22 49  6e 73 65 72 74 22 20 63  |one.  "Insert" c|
00005f40  6f 70 69 65 73 20 74 68  65 20 63 75 72 72 65 6e  |opies the curren|
00005f50  74 20 70 61 74 74 65 72  6e 20 6e 75 6d 62 65 72  |t pattern number|
00005f60  20 61 6e 64 20 73 68 69  66 74 73 20 69 74 73 20  | and shifts its |
00005f70  0a 20 20 20 66 6f 6c 6c  6f 77 65 72 73 20 64 6f  |.   followers do|
00005f80  77 6e 77 61 72 64 73 2c  20 20 22 44 65 6c 65 74  |wnwards,  "Delet|
00005f90  65 22 20 63 6c 65 61 72  73 20 74 68 65 20 63 75  |e" clears the cu|
00005fa0  72 72 65 6e 74 20 6e 75  6d 62 65 72 20 61 6e 64  |rrent number and|
00005fb0  20 73 68 69 66 74 73 20  74 68 65 20 0a 20 20 20  | shifts the .   |
00005fc0  6f 74 68 65 72 73 20 75  70 77 61 72 64 73 2e 0a  |others upwards..|
00005fd0  20 20 20 54 68 65 20 20  70 61 74 74 65 72 6e 20  |   The  pattern |
00005fe0  6e 75 6d 62 65 72 20 61  74 20 79 6f 75 72 20 63  |number at your c|
00005ff0  75 72 73 6f 72 20 70 6f  73 69 74 69 6f 6e 20 69  |ursor position i|
00006000  73 20 64 69 73 70 6c 61  79 65 64 20 69 6e 20 74  |s displayed in t|
00006010  68 65 20 20 62 6f 74 74  6f 6d 20 0a 20 20 20 77  |he  bottom .   w|
00006020  69 6e 64 6f 77 20 61 6e  64 20 69 73 20 73 65 74  |indow and is set|
00006030  20 61 73 20 22 6c 61 73  74 20 73 74 6f 70 70 65  | as "last stoppe|
00006040  64 20 61 74 22 20 28 66  6f 72 20 50 4c 41 59 69  |d at" (for PLAYi|
00006050  6e 67 2c 20 20 73 74 61  72 74 65 64 20 77 69 74  |ng,  started wit|
00006060  68 20 20 74 68 65 20 0a  20 20 20 6c 65 66 74 20  |h  the .   left |
00006070  62 75 74 74 6f 6e 29 2e  0a 0a 20 2a 20 43 4f 4d  |button)... * COM|
00006080  4d 41 4e 44 53 0a 20 20  20 57 65 6c 6c 2c 20 20  |MANDS.   Well,  |
00006090  6f 62 76 69 6f 75 73 6c  79 20 74 68 69 73 20 69  |obviously this i|
000060a0  63 6f 6e 20 6c 65 74 73  20 79 6f 75 20 65 6e 74  |con lets you ent|
000060b0  65 72 20 73 6f 6d 65 20  43 4c 49 20 63 6f 6d 6d  |er some CLI comm|
000060c0  61 6e 64 73 20 6f 66 20  74 68 65 20 20 4f 53 2e  |ands of the  OS.|
000060d0  20 0a 20 20 20 43 65 72  74 61 69 6e 20 20 72 65  | .   Certain  re|
000060e0  73 74 72 69 63 74 69 6f  6e 73 20 20 61 72 65 20  |strictions  are |
000060f0  6d 61 64 65 20 74 6f 20  61 76 6f 69 64 20 61 20  |made to avoid a |
00006100  73 79 73 74 65 6d 20 63  72 61 73 68 20 20 62 79  |system crash  by|
00006110  20 20 72 75 6e 6e 69 6e  67 20 20 61 20 0a 20 20  |  running  a .  |
00006120  20 73 65 63 6f 6e 64 20  70 72 6f 67 72 61 6d 20  | second program |
00006130  6f 72 20 6f 74 68 65 72  20 66 61 74 61 6c 20 74  |or other fatal t|
00006140  68 69 6e 67 73 2c 20 65  74 63 2e 0a 0a 20 2a 20  |hings, etc... * |
00006150  52 45 53 54 41 52 54 0a  20 20 20 57 65 6c 6c 2c  |RESTART.   Well,|
00006160  20 20 63 6c 69 63 6b 69  6e 67 20 74 68 69 73 20  |  clicking this |
00006170  69 63 6f 6e 20 72 65 73  74 61 72 74 73 20 74 68  |icon restarts th|
00006180  65 20 43 6f 63 6f 6e 69  7a 65 72 2c 20 69 65 20  |e Coconizer, ie |
00006190  79 6f 75 20 77 69 6c 6c  20 6c 6f 6f 73 65 20 61  |you will loose a|
000061a0  6c 6c 20 0a 20 20 20 79  6f 75 72 20 77 6f 72 6b  |ll .   your work|
000061b0  20 61 66 74 65 72 20 63  6f 6e 66 69 72 6d 69 6e  | after confirmin|
000061c0  67 20 74 68 65 20 73 61  66 65 74 79 20 72 65 71  |g the safety req|
000061d0  75 65 73 74 2e 0a 20 20  20 43 61 75 73 65 20 6f  |uest..   Cause o|
000061e0  66 20 6f 74 68 65 72 20  6d 65 6d 6f 72 79 20 6d  |f other memory m|
000061f0  61 6e 61 67 65 6d 65 6e  74 20 6f 66 20 74 68 65  |anagement of the|
00006200  20 74 77 6f 20 64 69 66  66 65 72 65 6e 74 20 63  | two different c|
00006210  68 61 6e 6e 65 6c 20 20  66 6f 72 6d 61 74 73 2c  |hannel  formats,|
00006220  20 0a 20 20 20 69 74 27  73 20 20 6e 6f 74 20 20  | .   it's  not  |
00006230  70 6f 73 73 69 62 6c 65  20 74 6f 20 63 68 61 6e  |possible to chan|
00006240  67 65 20 74 6f 20 74 68  65 20 6f 74 68 65 72 20  |ge to the other |
00006250  66 6f 72 6d 61 74 20 77  68 69 6c 73 74 20 77 6f  |format whilst wo|
00006260  72 6b 69 6e 67 20 20 61  74 20 20 61 20 0a 20 20  |rking  at  a .  |
00006270  20 73 6f 6e 67 2e 20 20  4f 6e 6c 79 20 61 66 74  | song.  Only aft|
00006280  65 72 20 72 65 73 74 61  72 74 69 6e 67 20 28 61  |er restarting (a|
00006290  6e 64 20 6c 6f 6f 73 69  6e 67 20 79 6f 75 72 20  |nd loosing your |
000062a0  6f 6c 64 20 73 6f 6e 67  29 20 79 6f 75 20 63 61  |old song) you ca|
000062b0  6e 20 73 65 6c 65 63 74  20 0a 20 20 20 74 68 65  |n select .   the|
000062c0  20 64 65 73 69 72 65 64  20 63 68 61 6e 6e 65 6c  | desired channel|
000062d0  20 66 6f 72 6d 61 74 2e  20 49 66 20 79 6f 75 20  | format. If you |
000062e0  77 69 73 68 20 74 6f 20  63 68 61 6e 67 65 20 74  |wish to change t|
000062f0  68 65 20 63 68 61 6e 6e  65 6c 20 66 6f 72 6d 61  |he channel forma|
00006300  74 20 6f 66 20 0a 20 20  20 61 20 73 61 76 65 64  |t of .   a saved|
00006310  20 73 6f 6e 67 20 74 68  65 6e 20 75 73 65 20 74  | song then use t|
00006320  68 65 20 74 6f 6f 6c 20  22 43 68 61 6e 67 65 72  |he tool "Changer|
00006330  22 20 70 6c 65 61 73 65  2e 0a 0a 20 2a 20 51 55  |" please... * QU|
00006340  49 54 0a 20 20 20 42 79  20 63 6c 69 63 6b 69 6e  |IT.   By clickin|
00006350  67 20 74 68 69 73 20 69  63 6f 6e 20 79 6f 75 20  |g this icon you |
00006360  73 77 61 70 20 62 61 63  6b 20 74 6f 20 74 68 65  |swap back to the|
00006370  20 64 65 73 6b 74 6f 70  2e 20 20 41 6c 6c 20 79  | desktop.  All y|
00006380  6f 75 72 20 77 6f 72 6b  20 20 61 6e 64 20 0a 20  |our work  and . |
00006390  20 20 63 75 72 72 65 6e  74 20 20 70 6f 69 6e 74  |  current  point|
000063a0  65 72 73 20 20 61 72 65  20 20 73 61 76 65 64 20  |ers  are  saved |
000063b0  20 75 6e 74 69 6c 20 20  79 6f 75 20 20 72 65 2d  | until  you  re-|
000063c0  65 6e 74 65 72 20 20 43  6f 63 6f 20 20 76 69 61  |enter  Coco  via|
000063d0  20 20 69 63 6f 6e 62 61  72 20 0a 20 20 20 63 6c  |  iconbar .   cl|
000063e0  69 63 6b 69 6e 67 2e 0a  0a 0a 0a 20 54 48 45 20  |icking..... THE |
000063f0  54 4f 4f 4c 53 0a 20 3d  3d 3d 3d 3d 3d 3d 3d 3d  |TOOLS. =========|
00006400  0a 0a 57 69 74 68 20 74  68 65 20 43 6f 63 6f 6e  |..With the Cocon|
00006410  69 7a 65 72 20 63 6f 6d  65 73 20 61 20 64 69 72  |izer comes a dir|
00006420  65 63 74 6f 72 79 20 77  68 69 63 68 20 63 6f 6e  |ectory which con|
00006430  74 61 69 6e 73 20 73 65  76 65 72 61 6c 20 74 6f  |tains several to|
00006440  6f 6c 73 2e 20 53 6f 6d  65 20 6f 66 20 0a 74 68  |ols. Some of .th|
00006450  65 6d 20 68 61 76 65 20  61 6c 72 65 61 64 79 20  |em have already |
00006460  62 65 65 6e 20 6d 65 6e  74 69 6f 6e 65 64 2e 20  |been mentioned. |
00006470  4e 6f 77 20 61 20 6d 6f  72 65 20 64 65 74 61 69  |Now a more detai|
00006480  6c 65 64 20 69 6e 66 6f  2e 0a 0a 4c 6f 63 61 74  |led info...Locat|
00006490  65 72 20 20 20 3a 0a 20  57 68 65 6e 20 79 6f 75  |er   :. When you|
000064a0  20 61 70 70 65 6e 64 20  6e 65 77 20 73 61 6d 70  | append new samp|
000064b0  6c 65 73 20 74 6f 20 79  6f 75 72 20 65 78 69 73  |les to your exis|
000064c0  74 69 6e 67 20 6f 6e 65  73 2c 20 64 65 6c 65 74  |ting ones, delet|
000064d0  65 2c 20 72 65 6e 61 6d  65 20 6f 72 20 6d 6f 76  |e, rename or mov|
000064e0  65 20 0a 20 65 78 69 73  74 69 6e 67 20 20 6f 6e  |e . existing  on|
000064f0  65 73 2c 20 20 74 68 65  6e 20 70 6c 65 61 73 65  |es,  then please|
00006500  20 75 73 65 20 74 68 69  73 20 73 61 6d 70 6c 65  | use this sample|
00006510  20 61 6c 6c 6f 63 61 74  6f 72 2e 20 20 49 74 20  | allocator.  It |
00006520  20 63 72 65 61 74 65 73  20 20 74 68 65 20 0a 20  | creates  the . |
00006530  73 61 6d 70 6c 65 20 61  6c 6c 6f 63 61 74 69 6f  |sample allocatio|
00006540  6e 20 66 69 6c 65 2c 20  63 6f 6e 74 61 69 6e 69  |n file, containi|
00006550  6e 67 20 61 6c 6c 20 79  6f 75 72 20 73 61 6d 70  |ng all your samp|
00006560  6c 65 20 6e 61 6d 65 73  20 61 6e 64 20 74 68 65  |le names and the|
00006570  69 72 20 28 64 69 73 63  29 20 0a 20 64 69 72 65  |ir (disc) . dire|
00006580  63 74 6f 72 79 20 70 6f  73 69 74 69 6f 6e 73 2e  |ctory positions.|
00006590  20 52 75 6e 20 74 68 65  20 22 4c 6f 63 61 74 6f  | Run the "Locato|
000065a0  72 22 2c 20 74 68 65 6e  20 69 6e 73 65 72 74 20  |r", then insert |
000065b0  79 6f 75 72 20 66 69 72  73 74 20 69 6e 73 74 72  |your first instr|
000065c0  75 6d 65 6e 74 20 0a 20  64 69 73 63 2e 20 20 46  |ument . disc.  F|
000065d0  6f 72 20 64 69 73 63 20  62 61 73 65 64 20 75 73  |or disc based us|
000065e0  65 3a 20 20 70 6c 65 61  73 65 20 65 6e 73 75 72  |e:  please ensur|
000065f0  65 20 74 6f 20 68 61 76  65 20 64 69 73 6d 6f 75  |e to have dismou|
00006600  6e 74 65 64 20 74 68 65  20 6f 6c 64 20 64 69 73  |nted the old dis|
00006610  63 20 0a 20 28 69 65 20  20 2a 6e 6f 64 69 72 29  |c . (ie  *nodir)|
00006620  20 62 65 66 6f 72 65 2c  20 20 65 6c 73 65 20 74  | before,  else t|
00006630  68 65 20 6c 6f 63 61 74  6f 72 20 63 61 6e 27 74  |he locator can't|
00006640  20 66 69 6e 64 20 6e 65  77 20 20 64 69 72 65 63  | find new  direc|
00006650  74 6f 72 69 65 73 2e 20  20 54 68 69 73 20 0a 20  |tories.  This . |
00006660  73 68 6f 75 6c 64 20 61  6c 73 6f 20 62 65 20 61  |should also be a|
00006670  70 70 6c 69 65 64 20 74  6f 20 6f 74 68 65 72 20  |pplied to other |
00006680  74 6f 6f 6c 73 20 73 63  61 6e 6e 69 6e 67 20 64  |tools scanning d|
00006690  69 72 65 63 74 6f 72 79  20 69 6e 66 6f 72 6d 61  |irectory informa|
000066a0  74 69 6f 6e 73 2e 0a 20  41 66 74 65 72 20 74 68  |tions.. After th|
000066b0  65 20 74 77 6f 20 73 61  6d 70 6c 65 20 64 69 72  |e two sample dir|
000066c0  65 63 74 6f 72 69 65 73  20 6f 66 20 61 20 64 69  |ectories of a di|
000066d0  73 63 20 68 61 76 65 20  62 65 65 6e 20 73 63 61  |sc have been sca|
000066e0  6e 6e 65 64 2c 20 69 6e  73 65 72 74 20 79 6f 75  |nned, insert you|
000066f0  72 20 0a 20 6e 65 78 74  20 73 61 6d 70 6c 65 20  |r . next sample |
00006700  64 69 73 63 20 61 6e 64  20 70 72 65 73 73 20 22  |disc and press "|
00006710  59 22 2c 20 6f 72 20 70  72 65 73 73 20 61 6e 79  |Y", or press any|
00006720  20 6f 74 68 65 72 20 6b  65 79 20 74 6f 20 73 74  | other key to st|
00006730  61 72 74 20 73 6f 72 74  69 6e 67 20 26 20 0a 20  |art sorting & . |
00006740  75 70 64 61 74 69 6e 67  20 69 66 20 69 74 20 77  |updating if it w|
00006750  61 73 20 79 6f 75 72 20  6c 61 73 74 20 64 69 73  |as your last dis|
00006760  63 2e 0a 0a 43 68 61 6e  67 65 72 20 20 20 3a 0a  |c...Changer   :.|
00006770  20 57 69 74 68 20 20 69  74 20 79 6f 75 20 68 61  | With  it you ha|
00006780  76 65 20 74 68 65 20 70  6f 73 73 69 62 69 6c 69  |ve the possibili|
00006790  74 79 20 74 6f 20 63 6f  6e 76 65 72 74 20 61 20  |ty to convert a |
000067a0  73 6f 6e 67 20 74 6f 20  74 68 65 20 6f 74 68 65  |song to the othe|
000067b0  72 20 20 63 68 61 6e 6e  65 6c 20 0a 20 66 6f 72  |r  channel . for|
000067c0  6d 61 74 2c 20 20 62 75  74 20 62 65 20 63 61 72  |mat,  but be car|
000067d0  65 66 75 6c 20 77 68 65  6e 20 63 6f 6e 76 65 72  |eful when conver|
000067e0  74 69 6e 67 20 65 69 67  68 74 20 74 6f 20 66 6f  |ting eight to fo|
000067f0  75 72 20 63 68 61 6e 6e  65 6c 73 20 64 6f 77 6e  |ur channels down|
00006800  20 63 61 75 73 65 20 0a  20 79 6f 75 20 77 69 6c  | cause . you wil|
00006810  6c 20 6c 6f 73 65 20 68  61 6c 66 20 79 6f 75 72  |l lose half your|
00006820  20 76 6f 69 63 65 73 2e  2e 2e 0a 20 59 6f 75 20  | voices.... You |
00006830  6d 61 79 20 73 65 6c 65  63 74 20 74 68 65 20 6e  |may select the n|
00006840  65 77 20 76 6f 69 63 65  20 6f 72 64 65 72 2c 20  |ew voice order, |
00006850  65 69 74 68 65 72 20 66  6f 72 20 74 68 65 20 64  |either for the d|
00006860  65 73 74 69 6e 61 74 69  6f 6e 20 73 6f 6e 67 20  |estination song |
00006870  6f 72 20 6f 66 20 0a 20  74 68 65 20 73 6f 75 72  |or of . the sour|
00006880  63 65 20 73 6f 6e 67 66  69 6c 65 2e 0a 20 50 6c  |ce songfile.. Pl|
00006890  65 61 73 65 20 20 6e 6f  74 65 20 20 74 68 61 74  |ease  note  that|
000068a0  20 20 74 68 69 73 20 20  74 6f 6f 6c 20 6e 65 65  |  this  tool nee|
000068b0  64 73 20 74 68 65 20 20  22 50 61 63 6b 69 74 22  |ds the  "Packit"|
000068c0  20 20 6d 6f 64 75 6c 65  20 20 6f 66 20 20 64 69  |  module  of  di|
000068d0  72 65 63 74 6f 72 79 20  0a 20 21 43 6f 63 6f 6e  |rectory . !Cocon|
000068e0  69 7a 65 72 2c 20 69 74  20 69 73 20 6c 6f 61 64  |izer, it is load|
000068f0  65 64 20 69 6e 69 74 69  61 6c 6c 79 20 28 69 66  |ed initially (if|
00006900  20 6e 65 63 65 73 73 61  72 79 29 2e 0a 0a 50 61  | necessary)...Pa|
00006910  63 6b 49 74 20 20 20 20  3a 0a 20 41 20 66 75 72  |ckIt    :. A fur|
00006920  74 68 65 72 20 74 6f 6f  6c 20 69 73 20 74 68 65  |ther tool is the|
00006930  20 50 61 63 6b 49 74 20  4d 6f 64 75 6c 65 2e 20  | PackIt Module. |
00006940  42 65 63 61 75 73 65 20  69 74 27 73 20 75 73 65  |Because it's use|
00006950  64 20 62 79 20 43 6f 63  6f 2c 20 74 68 69 73 20  |d by Coco, this |
00006960  74 6f 6f 6c 20 0a 20 69  73 20 69 6e 20 74 68 65  |tool . is in the|
00006970  20 21 43 6f 63 6f 6e 69  7a 65 72 20 64 69 72 65  | !Coconizer dire|
00006980  63 74 6f 72 79 2e 20 59  6f 75 20 63 6f 75 6c 64  |ctory. You could|
00006990  20 75 73 65 20 74 68 69  73 20 6d 6f 64 75 6c 65  | use this module|
000069a0  20 74 6f 20 61 63 68 69  65 76 65 20 6d 6f 72 65  | to achieve more|
000069b0  20 0a 20 64 69 73 63 20  63 61 70 61 63 69 74 79  | . disc capacity|
000069c0  2e 20 20 4f 66 20 63 6f  75 72 73 65 20 69 74 27  |.  Of course it'|
000069d0  73 20 6e 6f 74 20 66 69  78 65 64 20 74 6f 20 73  |s not fixed to s|
000069e0  6f 6e 67 20 66 69 6c 65  73 2c 20 20 69 74 20 65  |ong files,  it e|
000069f0  61 73 69 6c 79 20 63 61  6e 20 62 65 20 0a 20 75  |asily can be . u|
00006a00  73 65 64 20 65 76 65 72  79 77 68 65 72 65 2e 20  |sed everywhere. |
00006a10  20 28 41 6e 64 20 69 74  20 72 65 61 6c 6c 79 20  | (And it really |
00006a20  75 73 65 73 20 61 20 76  65 72 79 20 73 69 6d 70  |uses a very simp|
00006a30  6c 65 20 62 75 74 20 66  61 73 74 20 20 63 6f 6d  |le but fast  com|
00006a40  70 72 65 73 73 69 6e 67  20 0a 20 6d 65 74 68 6f  |pressing . metho|
00006a50  64 29 2e 0a 0a 57 69 70  65 52 65 73 74 20 20 3a  |d)...WipeRest  :|
00006a60  0a 20 54 6f 20 20 6b 65  65 70 20 74 68 65 20 6f  |. To  keep the o|
00006a70  76 65 72 76 69 65 77 20  6f 76 65 72 20 79 6f 75  |verview over you|
00006a80  72 20 73 61 6d 70 6c 65  20 66 69 6c 65 20 63 6f  |r sample file co|
00006a90  6c 6c 65 63 74 69 6f 6e  2c 20 20 74 68 69 73 20  |llection,  this |
00006aa0  20 74 6f 6f 6c 20 20 77  69 6c 6c 20 0a 20 73 63  | tool  will . sc|
00006ab0  61 6e 20 61 6c 6c 20 79  6f 75 72 20 73 6f 6e 67  |an all your song|
00006ac0  73 20 61 6e 64 20 63 61  6c 63 75 6c 61 74 65 20  |s and calculate |
00006ad0  61 6c 6c 20 74 68 65 20  75 73 65 64 20 28 6e 65  |all the used (ne|
00006ae0  65 64 65 64 29 20 20 69  6e 73 74 72 75 6d 65 6e  |eded)  instrumen|
00006af0  74 73 2e 20 20 49 74 20  0a 20 74 68 65 6e 20 20  |ts.  It . then  |
00006b00  61 6c 6c 6f 77 73 20 20  74 68 65 20 20 64 65 6c  |allows  the  del|
00006b10  65 74 69 6f 6e 20 20 6f  66 20 61 6c 6c 20 74 68  |etion  of all th|
00006b20  65 20 20 75 6e 75 73 65  64 20 20 73 61 6d 70 6c  |e  unused  sampl|
00006b30  65 20 20 66 69 6c 65 73  2e 20 20 54 68 69 73 20  |e  files.  This |
00006b40  20 69 73 20 0a 20 72 65  63 6f 6d 6d 65 6e 64 65  | is . recommende|
00006b50  64 20 20 69 66 20 79 6f  75 20 64 65 63 69 64 65  |d  if you decide|
00006b60  64 20 74 6f 20 77 69 70  65 20 73 6f 6d 65 20 73  |d to wipe some s|
00006b70  6f 6e 67 73 20 61 6e 64  20 74 68 69 6e 6b 20 74  |ongs and think t|
00006b80  68 61 74 20 20 79 6f 75  20 20 64 6f 6e 27 74 20  |hat  you  don't |
00006b90  0a 20 6e 65 65 64 20 74  68 65 69 72 20 28 6e 6f  |. need their (no|
00006ba0  77 20 6e 65 65 64 6c 65  73 73 29 20 73 61 6d 70  |w needless) samp|
00006bb0  6c 65 20 66 69 6c 65 73  20 61 6e 79 20 6d 6f 72  |le files any mor|
00006bc0  65 2e 0a 20 50 6c 65 61  73 65 20 65 6e 73 75 72  |e.. Please ensur|
00006bd0  65 20 74 6f 20 65 6e 74  65 72 20 41 4c 4c 20 79  |e to enter ALL y|
00006be0  6f 75 72 20 73 6f 6e 67  20 64 69 72 65 63 74 6f  |our song directo|
00006bf0  72 69 65 73 20 77 68 65  6e 20 72 75 6e 6e 69 6e  |ries when runnin|
00006c00  67 20 74 68 69 73 20 20  74 6f 6f 6c 2c 20 0a 20  |g this  tool, . |
00006c10  62 65 63 61 75 73 65 20  20 6f 6e 6c 79 20 73 61  |because  only sa|
00006c20  6d 70 6c 65 20 66 69 6c  65 73 20 77 68 69 63 68  |mple files which|
00006c30  20 68 61 76 65 20 62 65  65 6e 20 66 6f 75 6e 64  | have been found|
00006c40  20 69 6e 20 74 68 6f 73  65 20 20 73 63 61 6e 6e  | in those  scann|
00006c50  65 64 20 20 73 6f 6e 67  73 20 0a 20 77 69 6c 6c  |ed  songs . will|
00006c60  20 62 65 20 6b 65 70 74  20 28 69 65 20 6e 6f 74  | be kept (ie not|
00006c70  20 64 65 6c 65 74 65 64  29 20 21 0a 0a 57 69 70  | deleted) !..Wip|
00006c80  65 53 61 6d 65 20 20 3a  0a 20 49 6e 20 20 63 61  |eSame  :. In  ca|
00006c90  73 65 20 20 79 6f 75 20  68 61 76 65 20 73 65 76  |se  you have sev|
00006ca0  65 72 61 6c 20 73 61 6d  70 6c 65 73 20 77 69 74  |eral samples wit|
00006cb0  68 20 74 68 65 20 73 61  6d 65 20 6e 61 6d 65 20  |h the same name |
00006cc0  20 62 75 74 20 20 69 6e  20 20 64 69 66 66 65 72  | but  in  differ|
00006cd0  65 6e 74 20 0a 20 64 69  72 65 63 74 6f 72 69 65  |ent . directorie|
00006ce0  73 2c 20 74 68 65 6e 20  74 68 69 73 20 74 6f 6f  |s, then this too|
00006cf0  6c 20 77 69 6c 6c 20 66  69 6e 64 20 61 6e 64 20  |l will find and |
00006d00  64 65 6c 65 74 65 20 74  68 65 6d 2e 0a 0a 4c 69  |delete them...Li|
00006d10  6e 4c 6f 67 20 20 20 20  3a 0a 20 54 68 69 73 20  |nLog    :. This |
00006d20  20 75 74 69 6c 69 74 79  20 20 63 6f 6e 76 65 72  | utility  conver|
00006d30  74 73 20 20 73 69 67 6e  65 64 20 20 6c 69 6e 65  |ts  signed  line|
00006d40  61 72 20 73 61 6d 70 6c  65 20 20 66 69 6c 65 73  |ar sample  files|
00006d50  20 20 69 6e 74 6f 20 20  41 72 63 68 69 65 20 20  |  into  Archie  |
00006d60  56 49 44 43 20 0a 20 6c  6f 67 61 72 69 74 68 6d  |VIDC . logarithm|
00006d70  20 4c 53 42 20 66 69 6c  65 73 2c 20 6e 65 65 64  | LSB files, need|
00006d80  65 64 20 62 79 20 74 68  65 20 43 6f 63 6f 6e 69  |ed by the Coconi|
00006d90  7a 65 72 2e 0a 20 43 6f  70 79 20 20 79 6f 75 72  |zer.. Copy  your|
00006da0  20 6c 69 6e 65 61 72 20  73 61 6d 70 6c 65 73 20  | linear samples |
00006db0  69 6e 74 6f 20 61 20 64  69 72 65 63 74 6f 72 79  |into a directory|
00006dc0  20 63 61 6c 6c 65 64 20  22 53 61 6d 70 6c 65 73  | called "Samples|
00006dd0  22 20 6f 6e 20 72 61 6d  20 20 64 69 73 63 2c 20  |" on ram  disc, |
00006de0  0a 20 74 68 65 6e 20 72  75 6e 20 22 4c 69 6e 4c  |. then run "LinL|
00006df0  6f 67 22 2e 20 20 49 74  20 77 69 6c 6c 20 63 6f  |og".  It will co|
00006e00  6e 76 65 72 74 20 74 68  65 6d 20 74 6f 20 6c 6f  |nvert them to lo|
00006e10  67 61 72 69 74 68 6d 20  6f 6e 65 73 20 61 6e 64  |garithm ones and|
00006e20  20 77 72 69 74 65 20 74  68 65 6d 20 0a 20 62 61  | write them . ba|
00006e30  63 6b 20 20 74 6f 20 64  69 72 65 63 74 6f 72 79  |ck  to directory|
00006e40  20 22 53 61 6d 70 6c 65  73 2e 22 2e 20 20 41 66  | "Samples.".  Af|
00006e50  74 65 72 20 74 68 69 73  20 79 6f 75 20 73 68 6f  |ter this you sho|
00006e60  75 6c 64 20 63 6f 70 79  20 74 68 65 6d 20 66 72  |uld copy them fr|
00006e70  6f 6d 20 20 72 61 6d 20  0a 20 64 69 73 63 20 74  |om  ram . disc t|
00006e80  6f 20 79 6f 75 72 20 64  65 73 69 72 65 64 20 73  |o your desired s|
00006e90  61 6d 70 6c 65 20 64 69  73 63 28 73 29 2c 20 63  |ample disc(s), c|
00006ea0  61 75 73 65 20 79 6f 75  72 20 41 72 63 20 68 61  |ause your Arc ha|
00006eb0  73 20 6e 6f 20 69 64 65  61 20 77 68 65 72 65 20  |s no idea where |
00006ec0  79 6f 75 20 0a 20 77 6f  75 6c 64 20 6c 69 6b 65  |you . would like|
00006ed0  20 74 6f 20 70 75 74 20  74 68 65 73 65 20 6e 65  | to put these ne|
00006ee0  77 20 73 61 6d 70 6c 65  73 20 6f 6e 21 0a 20 50  |w samples on!. P|
00006ef0  6c 65 61 73 65 20 6e 6f  74 65 20 74 68 61 74 20  |lease note that |
00006f00  74 68 69 73 20 70 72 6f  67 72 61 6d 20 6e 65 65  |this program nee|
00006f10  64 73 20 74 68 65 20 22  6c 6f 63 61 74 69 6f 6e  |ds the "location|
00006f20  22 20 66 69 6c 65 20 77  68 65 6e 20 73 74 61 72  |" file when star|
00006f30  74 65 64 20 20 74 68 65  20 0a 20 66 69 72 73 74  |ted  the . first|
00006f40  20 74 69 6d 65 2c 20 74  68 65 72 65 66 6f 72 65  | time, therefore|
00006f50  20 69 74 20 69 73 20 6c  6f 61 64 65 64 20 69 6e  | it is loaded in|
00006f60  69 74 69 61 6c 6c 79 2e  0a 0a 41 6d 69 54 72 61  |itially...AmiTra|
00006f70  6e 73 20 20 3a 0a 20 54  68 69 73 20 20 75 74 69  |ns  :. This  uti|
00006f80  6c 69 74 79 20 20 61 6c  6c 6f 77 73 20 61 20 6c  |lity  allows a l|
00006f90  69 6d 69 74 65 64 20 63  6f 6e 76 65 72 73 69 6f  |imited conversio|
00006fa0  6e 20 20 6f 66 20 20 41  6d 69 67 61 20 20 4d 61  |n  of  Amiga  Ma|
00006fb0  73 74 65 72 53 6f 75 6e  64 54 72 61 63 6b 65 72  |sterSoundTracker|
00006fc0  20 0a 20 73 6f 6e 67 73  20 20 69 6e 74 6f 20 20  | . songs  into  |
00006fd0  61 20 43 6f 63 6f 6e 69  7a 65 72 20 73 6f 6e 67  |a Coconizer song|
00006fe0  2e 20 20 50 6c 65 61 73  65 20 6e 6f 74 65 20 74  |.  Please note t|
00006ff0  68 61 74 20 74 68 65 20  20 41 6d 69 67 61 20 20  |hat the  Amiga  |
00007000  75 73 65 73 20 20 73 69  67 6e 65 64 20 0a 20 6c  |uses  signed . l|
00007010  69 6e 65 61 72 20 73 61  6d 70 6c 65 20 66 69 6c  |inear sample fil|
00007020  65 73 2e 0a 20 4d 6f 73  74 20 74 68 69 6e 67 73  |es.. Most things|
00007030  20 61 72 65 20 63 6f 6e  76 65 72 74 65 64 20 70  | are converted p|
00007040  72 65 74 74 79 20 63 6f  72 72 65 63 74 6c 79 2e  |retty correctly.|
00007050  20 20 53 6f 6d 65 20 64  69 66 66 65 72 65 6e 63  |  Some differenc|
00007060  65 73 20 6d 61 79 20 20  61 70 70 65 61 72 20 0a  |es may  appear .|
00007070  20 61 74 20 20 74 68 65  20 20 53 6c 69 64 65 20  | at  the  Slide |
00007080  75 70 2f 64 6f 77 6e 20  63 6f 6d 6d 61 6e 64 2e  |up/down command.|
00007090  20 20 54 68 69 73 20 69  73 20 62 65 63 61 75 73  |  This is becaus|
000070a0  65 20 74 68 65 20 20 4d  61 73 74 65 72 54 72 61  |e the  MasterTra|
000070b0  63 6b 65 72 20 20 75 73  65 73 20 0a 20 41 6d 69  |cker  uses . Ami|
000070c0  67 61 20 70 65 72 69 6f  64 73 20 74 6f 20 73 74  |ga periods to st|
000070d0  6f 72 65 20 69 74 73 20  6e 6f 74 65 20 76 61 6c  |ore its note val|
000070e0  75 65 73 2e 20 20 53 6c  69 64 69 6e 67 20 75 70  |ues.  Sliding up|
000070f0  20 6f 72 20 64 6f 77 6e  20 6a 75 73 74 20 6d 6f  | or down just mo|
00007100  64 69 66 69 65 73 20 0a  20 74 68 69 73 20 20 70  |difies . this  p|
00007110  65 72 69 6f 64 20 20 62  79 20 20 61 20 76 61 72  |eriod  by  a var|
00007120  69 61 62 6c 65 20 73 6c  69 64 65 20 73 74 65 70  |iable slide step|
00007130  20 61 6e 64 20 74 68 65  20 20 72 65 73 75 6c 74  | and the  result|
00007140  20 20 69 73 20 20 61 20  20 6c 6f 67 61 72 69 74  |  is  a  logarit|
00007150  68 6d 20 0a 20 69 6e 63  72 65 61 73 65 2f 64 65  |hm . increase/de|
00007160  63 72 65 61 73 65 20 20  6f 66 20 74 68 65 20 6f  |crease  of the o|
00007170  75 74 70 75 74 20 66 72  65 71 75 65 6e 63 79 2e  |utput frequency.|
00007180  20 20 43 6f 63 6f 20 69  73 20 62 75 69 6c 64 20  |  Coco is build |
00007190  75 70 20 20 6f 6e 20 20  73 69 6e 67 6c 65 20 0a  |up  on  single .|
000071a0  20 6e 6f 74 65 20 76 61  6c 75 65 73 20 28 69 6e  | note values (in|
000071b0  74 65 72 6e 61 6c 20 30  31 3d 22 43 22 20 4f 63  |ternal 01="C" Oc|
000071c0  74 20 2d 33 2c 20 20 30  32 3d 22 43 23 22 20 4f  |t -3,  02="C#" O|
000071d0  63 74 20 2d 33 2c 20 20  30 33 3d 22 44 22 20 4f  |ct -3,  03="D" O|
000071e0  63 74 20 2d 33 2c 20 61  6e 64 20 0a 20 73 6f 20  |ct -3, and . so |
000071f0  20 6f 6e 29 20 20 77 68  69 63 68 20 61 72 65 20  | on)  which are |
00007200  64 69 72 65 63 74 6c 79  20 74 72 61 6e 73 6c 61  |directly transla|
00007210  74 65 64 20 69 6e 74 6f  20 20 73 61 6d 70 6c 65  |ted into  sample|
00007220  20 20 6f 75 74 70 75 74  20 20 66 72 65 71 75 65  |  output  freque|
00007230  6e 63 69 65 73 2e 20 0a  20 49 6e 63 72 65 61 73  |ncies. . Increas|
00007240  69 6e 67 2f 64 65 63 72  65 61 73 69 6e 67 20 74  |ing/decreasing t|
00007250  68 65 20 66 72 65 71 75  65 6e 63 79 20 69 73 20  |he frequency is |
00007260  61 20 74 6f 74 61 6c 6c  79 20 6c 69 6e 65 61 72  |a totally linear|
00007270  20 20 6f 70 65 72 61 74  69 6f 6e 2e 20 20 54 68  |  operation.  Th|
00007280  69 73 20 0a 20 63 61 6e  20 20 6c 65 61 64 20 74  |is . can  lead t|
00007290  6f 20 73 6f 6d 65 20 75  6e 77 61 6e 74 65 64 20  |o some unwanted |
000072a0  65 66 66 65 63 74 73 2c  20 20 62 75 74 20 70 72  |effects,  but pr|
000072b0  6f 62 61 62 6c 79 20 6d  6f 73 74 20 73 6f 6e 67  |obably most song|
000072c0  73 20 20 77 69 6c 6c 20  20 73 6f 75 6e 64 20 0a  |s  will  sound .|
000072d0  20 71 75 69 74 65 20 73  69 6d 69 6c 61 72 2e 20  | quite similar. |
000072e0  41 6e 64 20 6c 61 73 74  20 62 75 74 20 6e 6f 74  |And last but not|
000072f0  20 6c 65 61 73 74 20 79  6f 75 20 63 6f 75 6c 64  | least you could|
00007300  20 65 64 69 74 20 63 72  69 74 69 63 61 6c 20 73  | edit critical s|
00007310  65 63 74 69 6f 6e 73 20  62 79 20 0a 20 68 61 6e  |ections by . han|
00007320  64 2e 0a 20 47 72 65 61  74 20 20 63 6f 6e 66 75  |d.. Great  confu|
00007330  73 69 6f 6e 20 20 69 73  20 61 62 6f 75 74 20 74  |sion  is about t|
00007340  68 65 20 64 69 66 66 65  72 65 6e 74 20 41 6d 69  |he different Ami|
00007350  67 61 20 20 53 6f 75 6e  64 54 72 61 63 6b 65 72  |ga  SoundTracker|
00007360  73 20 20 61 76 61 69 6c  61 62 6c 65 2e 20 0a 20  |s  available. . |
00007370  4c 6f 74 73 20 6f 66 20  74 68 65 6d 20 6f 6e 6c  |Lots of them onl|
00007380  79 20 75 73 65 20 61 20  62 61 73 65 20 73 65 74  |y use a base set|
00007390  20 6f 66 20 63 6f 6d 70  61 74 69 62 6c 65 20 63  | of compatible c|
000073a0  6f 6d 6d 61 6e 64 73 2c  20 20 6f 74 68 65 72 20  |ommands,  other |
000073b0  20 63 6f 6d 6d 61 6e 64  73 20 0a 20 64 69 66 66  | commands . diff|
000073c0  65 72 2e 2e 2e 0a 20 53  6f 20 70 72 6f 62 6c 65  |er.... So proble|
000073d0  6d 73 20 63 6f 75 6c 64  20 61 70 70 65 61 72 20  |ms could appear |
000073e0  77 68 65 6e 20 79 6f 75  20 74 72 79 20 74 6f 20  |when you try to |
000073f0  63 6f 6e 76 65 72 74 20  73 6f 6e 67 73 20 66 72  |convert songs fr|
00007400  6f 6d 20 6e 65 77 65 72  20 74 72 61 63 6b 65 72  |om newer tracker|
00007410  20 0a 20 66 6f 72 6d 61  74 73 2e 20 20 41 70 61  | . formats.  Apa|
00007420  72 74 20 66 72 6f 6d 20  75 73 69 6e 67 20 75 70  |rt from using up|
00007430  20 74 6f 20 33 31 20 69  6e 73 74 72 75 6d 65 6e  | to 31 instrumen|
00007440  74 73 2c 20 73 6f 6d 65  20 6f 66 20 74 68 65 6d  |ts, some of them|
00007450  20 73 75 70 70 6f 72 74  20 74 68 65 20 0a 20 41  | support the . A|
00007460  6d 69 67 61 20 68 61 72  64 77 61 72 65 20 70 6f  |miga hardware po|
00007470  73 73 69 62 69 6c 69 74  79 20 6f 66 20 6d 6f 64  |ssibility of mod|
00007480  75 6c 61 74 69 6e 67 20  76 6f 69 63 65 73 20 77  |ulating voices w|
00007490  68 69 63 68 20 63 61 6e  27 74 20 62 65 20 20 63  |hich can't be  c|
000074a0  6f 6e 76 65 72 74 65 64  20 0a 20 74 6f 20 43 6f  |onverted . to Co|
000074b0  63 6f 20 73 6f 20 66 61  72 2e 20 20 54 68 69 73  |co so far.  This|
000074c0  20 6d 6f 64 75 6c 61 74  69 6e 67 20 69 73 20 75  | modulating is u|
000074d0  73 65 64 20 66 6f 72 20  76 69 62 72 61 74 6f 20  |sed for vibrato |
000074e0  65 66 66 65 63 74 73 20  77 69 74 68 20 20 65 69  |effects with  ei|
000074f0  74 68 65 72 20 0a 20 74  68 65 20 20 70 65 72 69  |ther . the  peri|
00007500  6f 64 20 6f 72 20 74 68  65 20 76 6f 6c 75 6d 65  |od or the volume|
00007510  20 6f 66 20 6f 6e 65 20  63 68 61 6e 6e 65 6c 20  | of one channel |
00007520  64 65 70 65 6e 64 69 6e  67 20 6f 6e 74 6f 20 74  |depending onto t|
00007530  68 65 20 20 73 61 6d 70  6c 65 20 20 64 61 74 61  |he  sample  data|
00007540  20 0a 20 28 21 29 20 6f  66 20 61 20 6e 65 78 74  | . (!) of a next|
00007550  20 68 69 67 68 65 72 20  63 68 61 6e 6e 65 6c 2e  | higher channel.|
00007560  20 54 72 79 20 73 6c 69  64 69 6e 67 20 6f 72 20  | Try sliding or |
00007570  61 72 70 65 67 67 69 6f  20 69 6e 73 74 65 61 64  |arpeggio instead|
00007580  20 70 6c 65 61 73 65 2c  20 61 6e 64 20 0a 20 79  | please, and . y|
00007590  6f 75 20 77 69 6c 6c 20  61 63 68 69 65 76 65 20  |ou will achieve |
000075a0  71 75 69 74 65 20 67 6f  6f 64 20 76 69 62 72 61  |quite good vibra|
000075b0  74 6f 20 65 66 66 65 63  74 73 2e 20 55 6e 74 69  |to effects. Unti|
000075c0  6c 20 6e 6f 77 20 69 74  27 73 20 76 65 72 79 20  |l now it's very |
000075d0  75 6e 6c 69 6b 65 6c 79  20 0a 20 74 68 61 74 20  |unlikely . that |
000075e0  77 65 27 72 65 20 67 6f  69 6e 67 20 74 6f 20 69  |we're going to i|
000075f0  6d 69 74 61 74 65 20 41  6d 69 67 61 27 73 20 22  |mitate Amiga's "|
00007600  50 61 75 6c 61 22 2c 20  62 65 74 74 65 72 20 63  |Paula", better c|
00007610  6f 6e 63 65 6e 74 72 61  74 69 6e 67 20 6f 6e 20  |oncentrating on |
00007620  6d 6f 72 65 20 0a 20 69  6d 70 6f 72 74 61 6e 74  |more . important|
00007630  20 74 68 69 6e 67 73 2e  0a 20 54 68 69 73 20 74  | things.. This t|
00007640  6f 6f 6c 20 6e 65 65 64  73 20 74 68 65 20 22 50  |ool needs the "P|
00007650  61 63 6b 49 74 22 20 6d  6f 64 75 6c 65 20 74 6f  |ackIt" module to|
00007660  6f 2c 20 77 68 69 63 68  20 69 73 20 6c 6f 61 64  |o, which is load|
00007670  65 64 20 69 6e 69 74 69  61 6c 6c 79 2e 0a 0a 4d  |ed initially...M|
00007680  6f 64 75 6c 20 26 20 50  6c 61 79 65 72 20 3a 0a  |odul & Player :.|
00007690  20 54 68 65 72 65 20 61  72 65 20 74 77 6f 20 70  | There are two p|
000076a0  6c 61 79 65 72 20 72 6f  75 74 69 6e 65 73 2c 20  |layer routines, |
000076b0  61 6e 20 65 78 61 63 74  20 64 65 73 63 72 69 70  |an exact descrip|
000076c0  74 69 6f 6e 73 20 66 6f  6c 6c 6f 77 73 2e 20 54  |tions follows. T|
000076d0  68 65 20 70 72 6f 67 72  61 6d 20 0a 20 22 4d 6f  |he program . "Mo|
000076e0  64 75 6c 22 20 20 63 72  65 61 74 65 73 20 61 6e  |dul"  creates an|
000076f0  20 61 75 74 6f 73 74 61  72 74 61 62 6c 65 20 6d  | autostartable m|
00007700  6f 64 75 6c 65 20 66 69  6c 65 20 66 72 6f 6d 20  |odule file from |
00007710  61 20 20 73 6f 6e 67 2e  20 20 54 68 61 74 20 20  |a  song.  That  |
00007720  6d 65 61 6e 73 2c 20 0a  20 69 74 27 73 20 61 6e  |means, . it's an|
00007730  20 41 72 63 68 69 6d 65  64 65 73 20 6d 6f 64 75  | Archimedes modu|
00007740  6c 65 2c 20 72 75 6e 6e  69 6e 67 20 69 6e 20 74  |le, running in t|
00007750  68 65 20 52 4d 41 2c 20  77 68 69 6c 73 74 20 79  |he RMA, whilst y|
00007760  6f 75 20 77 6f 72 6b 20  77 69 74 68 69 6e 20 74  |ou work within t|
00007770  68 65 20 0a 20 44 65 73  6b 74 6f 70 2c 20 6f 72  |he . Desktop, or|
00007780  20 72 75 6e 20 6f 74 68  65 72 20 70 72 6f 67 72  | run other progr|
00007790  61 6d 73 2e 20 46 6f 72  20 65 6e 64 69 6e 67 20  |ams. For ending |
000077a0  69 74 2c 20 73 69 6d 70  6c 79 20 52 4d 4b 69 6c  |it, simply RMKil|
000077b0  6c 20 74 68 69 73 20 6d  6f 64 75 6c 65 2e 0a 20  |l this module.. |
000077c0  55 73 69 6e 67 20 20 61  20 20 73 6f 6e 67 20 20  |Using  a  song  |
000077d0  69 6e 20 74 68 69 73 20  6d 6f 64 75 6c 65 20 66  |in this module f|
000077e0  6f 72 6d 20 69 73 20 74  68 65 20 20 66 69 72 73  |orm is the  firs|
000077f0  74 20 20 61 6e 64 20 20  6d 6f 72 65 20 20 63 6f  |t  and  more  co|
00007800  6d 66 6f 72 74 61 62 6c  65 20 0a 20 70 6f 73 73  |mfortable . poss|
00007810  69 62 69 6c 69 74 79 20  20 6f 66 20 75 73 69 6e  |ibility  of usin|
00007820  67 20 73 6f 6e 67 73 20  74 6f 67 65 74 68 65 72  |g songs together|
00007830  20 77 69 74 68 20 6f 77  6e 20 70 72 6f 67 72 61  | with own progra|
00007840  6d 73 2e 20 20 54 68 65  20 20 73 65 63 6f 6e 64  |ms.  The  second|
00007850  20 20 6f 6e 65 20 0a 20  61 6c 6c 6f 77 73 20 6d  |  one . allows m|
00007860  6f 72 65 20 64 69 72 65  63 74 20 73 6f 6e 67 20  |ore direct song |
00007870  63 6f 6e 74 72 6f 6c 2c  20 20 6c 69 6b 65 20 73  |control,  like s|
00007880  70 65 63 74 72 75 6d 20  61 6e 61 6c 79 7a 69 6e  |pectrum analyzin|
00007890  67 2c 20 20 65 74 63 2e  20 49 74 20 77 6f 72 6b  |g,  etc. It work|
000078a0  73 20 0a 20 61 73 20 66  6f 6c 6c 6f 77 73 3a 0a  |s . as follows:.|
000078b0  0a 0a 0a 20 54 48 45 20  53 54 41 4e 44 20 41 4c  |... THE STAND AL|
000078c0  4f 4e 45 20 50 4c 41 59  45 52 20 52 4f 55 54 49  |ONE PLAYER ROUTI|
000078d0  4e 45 0a 20 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |NE. ============|
000078e0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
000078f0  3d 3d 0a 0a 54 68 65 20  20 43 6f 63 6f 6e 69 7a  |==..The  Coconiz|
00007900  65 72 20 20 50 6c 61 79  65 72 20 52 6f 75 74 69  |er  Player Routi|
00007910  6e 65 20 69 73 20 61 20  73 6f 75 72 63 65 20 61  |ne is a source a|
00007920  73 73 65 6d 62 6c 65 72  20 70 72 6f 67 72 61 6d  |ssembler program|
00007930  20 20 77 68 69 63 68 20  20 70 6c 61 79 73 20 0a  |  which  plays .|
00007940  43 6f 63 6f 6e 69 7a 65  72 20 73 6f 6e 67 73 20  |Coconizer songs |
00007950  76 69 61 20 69 6e 74 65  72 72 75 70 74 20 73 79  |via interrupt sy|
00007960  73 74 65 6d 2e 20 20 41  6c 6c 20 6e 6f 6e 20 74  |stem.  All non t|
00007970  65 63 68 6e 69 63 61 6c  20 69 6e 74 65 72 65 73  |echnical interes|
00007980  74 65 64 20 20 75 73 65  72 73 20 0a 73 68 6f 75  |ted  users .shou|
00007990  6c 64 20 69 67 6e 6f 72  65 20 74 68 65 20 66 6f  |ld ignore the fo|
000079a0  6c 6c 6f 77 69 6e 67 20  70 61 72 61 67 72 61 70  |llowing paragrap|
000079b0  68 73 2e 2e 2e 20 3a 0a  0a 49 6e 20 6f 72 64 65  |hs... :..In orde|
000079c0  72 20 74 6f 20 75 73 65  20 79 6f 75 72 20 73 6f  |r to use your so|
000079d0  6e 67 73 20 69 6e 20 79  6f 75 72 20 6f 77 6e 20  |ngs in your own |
000079e0  70 72 6f 67 72 61 6d 73  2c 20 64 65 6d 6f 73 2c  |programs, demos,|
000079f0  20 67 61 6d 65 73 2c 20  65 74 63 2c 20 73 69 6d  | games, etc, sim|
00007a00  70 6c 79 20 0a 61 70 70  65 6e 64 20 74 68 65 20  |ply .append the |
00007a10  72 6f 75 74 69 6e 65 20  22 50 6c 61 79 65 72 22  |routine "Player"|
00007a20  20 74 6f 20 79 6f 75 72  20 73 6f 75 72 63 65 20  | to your source |
00007a30  61 73 73 65 6d 62 6c 65  72 20 63 6f 64 65 2e 20  |assembler code. |
00007a40  20 49 6e 76 6f 6c 76 65  20 69 74 20 20 69 6e 20  | Involve it  in |
00007a50  0a 79 6f 75 72 20 63 6f  64 65 20 62 79 20 69 6e  |.your code by in|
00007a60  73 65 72 74 69 6e 67 20  61 20 22 50 52 4f 43 5f  |serting a "PROC_|
00007a70  4d 75 73 69 63 22 20 61  74 20 74 68 65 20 64 65  |Music" at the de|
00007a80  73 69 72 65 64 20 70 6f  73 69 74 69 6f 6e 2c 20  |sired position, |
00007a90  72 65 63 6f 6d 6d 65 6e  64 65 64 20 0a 62 65 74  |recommended .bet|
00007aa0  77 65 65 6e 20 20 79 6f  75 72 20 6c 61 73 74 20  |ween  your last |
00007ab0  63 6c 6f 73 69 6e 67 20  22 5d 22 20 61 6e 64 20  |closing "]" and |
00007ac0  74 68 65 20 22 4e 45 58  54 20 70 61 73 73 22 20  |the "NEXT pass" |
00007ad0  73 74 61 74 65 6d 65 6e  74 2e 20 20 50 6c 65 61  |statement.  Plea|
00007ae0  73 65 20 20 75 73 65 20  0a 76 61 72 69 61 62 6c  |se  use .variabl|
00007af0  65 20 20 27 70 27 20 66  6f 72 20 79 6f 75 72 20  |e  'p' for your |
00007b00  74 77 6f 2d 70 61 73 73  20 46 4f 52 2d 4e 45 58  |two-pass FOR-NEX|
00007b10  54 20 6c 6f 6f 70 20 28  62 65 63 61 75 73 65 20  |T loop (because |
00007b20  74 68 65 20 70 6c 61 79  65 72 20 6d 61 6b 65 73  |the player makes|
00007b30  20 20 61 20 0a 63 68 65  63 6b 20 66 6f 72 20 77  |  a .check for w|
00007b40  68 69 63 68 20 70 61 73  73 20 69 73 20 72 75 6e  |hich pass is run|
00007b50  6e 69 6e 67 29 2e 0a 54  68 65 20 70 6c 61 79 65  |ning)..The playe|
00007b60  72 20 72 6f 75 74 69 6e  65 20 68 61 73 20 62 65  |r routine has be|
00007b70  65 6e 20 77 72 69 74 74  65 6e 20 72 65 6c 61 74  |en written relat|
00007b80  69 76 65 6c 79 2c 20 6f  72 20 72 61 74 68 65 72  |ively, or rather|
00007b90  3a 20 69 74 20 72 65 63  61 6c 63 75 6c 61 74 65  |: it recalculate|
00007ba0  73 20 0a 73 6f 6d 65 20  20 61 64 64 72 65 73 73  |s .some  address|
00007bb0  65 73 20 20 61 66 74 65  72 20 62 65 69 6e 67 20  |es  after being |
00007bc0  63 61 6c 6c 65 64 20 74  68 65 20 66 69 72 73 74  |called the first|
00007bd0  20 74 69 6d 65 2c 20 20  73 6f 20 79 6f 75 20 20  | time,  so you  |
00007be0  6e 65 65 64 6e 27 74 20  20 63 61 72 65 20 0a 61  |needn't  care .a|
00007bf0  62 6f 75 74 20 69 74 73  20 6c 6f 63 61 74 69 6f  |bout its locatio|
00007c00  6e 2e 20 20 54 68 65 72  65 66 6f 72 65 20 79 6f  |n.  Therefore yo|
00007c10  75 72 20 70 72 6f 67 72  61 6d 20 73 68 6f 75 6c  |ur program shoul|
00007c20  64 20 62 65 20 77 72 69  74 74 65 6e 20 20 72 65  |d be written  re|
00007c30  6c 61 74 69 76 65 6c 79  2c 20 0a 74 6f 6f 20 28  |latively, .too (|
00007c40  74 68 69 73 20 69 73 20  61 6c 77 61 79 73 20 70  |this is always p|
00007c50  72 65 66 65 72 61 62 6c  65 29 2e 20 20 49 66 20  |referable).  If |
00007c60  6e 6f 74 20 73 6f 2c 20  20 74 68 65 6e 20 70 6c  |not so,  then pl|
00007c70  65 61 73 65 20 61 64 61  70 74 20 74 68 65 20 70  |ease adapt the p|
00007c80  6c 61 79 65 72 20 0a 74  6f 20 79 6f 75 72 20 61  |layer .to your a|
00007c90  64 64 69 74 69 6f 6e 61  6c 20 4f 25 20 77 68 65  |dditional O% whe|
00007ca0  6e 20 6c 6f 61 64 69 6e  67 20 73 61 6d 70 6c 65  |n loading sample|
00007cb0  73 2c 20 65 74 63 2e 0a  50 6c 65 61 73 65 20 20  |s, etc..Please  |
00007cc0  72 65 6d 65 6d 62 65 72  20 20 74 6f 20 72 65 73  |remember  to res|
00007cd0  65 72 76 65 20 65 6e 6f  75 67 68 20 6d 65 6d 6f  |erve enough memo|
00007ce0  72 79 20 66 6f 72 20 79  6f 75 72 20 63 6f 64 65  |ry for your code|
00007cf0  20 20 41 4e 44 20 20 74  68 65 20 20 65 6e 74 69  |  AND  the  enti|
00007d00  72 65 20 0a 73 6f 75 6e  64 20 61 74 20 74 68 65  |re .sound at the|
00007d10  20 62 65 67 69 6e 6e 69  6e 67 20 6f 66 20 61 73  | beginning of as|
00007d20  73 65 6d 62 6c 69 6e 67  20 28 44 49 4d 20 63 6f  |sembling (DIM co|
00007d30  64 65 20 78 78 78 29 2e  0a 0a 54 68 65 20 6d 75  |de xxx)...The mu|
00007d40  73 69 63 20 69 73 20 73  74 61 72 74 65 64 20 62  |sic is started b|
00007d50  79 20 63 61 6c 6c 69 6e  67 20 22 76 5f 6f 6e 22  |y calling "v_on"|
00007d60  2e 20 20 53 74 6f 70 20  69 74 20 77 69 74 68 20  |.  Stop it with |
00007d70  22 76 5f 6f 66 66 22 2e  20 49 66 20 79 6f 75 20  |"v_off". If you |
00007d80  6c 69 6b 65 20 0a 74 6f  20 72 65 73 74 61 72 74  |like .to restart|
00007d90  20 79 6f 75 72 20 74 75  6e 65 20 77 68 69 6c 73  | your tune whils|
00007da0  74 20 70 6c 61 79 2c 20  79 6f 75 72 20 70 72 6f  |t play, your pro|
00007db0  67 72 61 6d 20 63 6f 75  6c 64 20 63 61 6c 6c 20  |gram could call |
00007dc0  22 76 5f 72 65 73 65 74  22 2e 0a 59 6f 75 20 20  |"v_reset"..You  |
00007dd0  63 6f 75 6c 64 20 73 65  74 20 74 68 65 20 6f 76  |could set the ov|
00007de0  65 72 61 6c 6c 20 76 6f  6c 75 6d 65 20 6f 66 20  |erall volume of |
00007df0  74 68 65 20 70 6c 61 79  65 72 20 77 69 74 68 20  |the player with |
00007e00  20 22 53 54 52 20 52 78  2c 56 6f 6c 75 6d 65 22  | "STR Rx,Volume"|
00007e10  2c 20 20 69 6e 20 0a 74  68 65 20 20 72 61 6e 67  |,  in .the  rang|
00007e20  65 20 20 66 72 20 66 72  20 30 30 3d 6c 6f 75 64  |e  fr fr 00=loud|
00007e30  20 74 6f 20 26 66 66 3d  74 6f 74 61 6c 6c 79 20  | to &ff=totally |
00007e40  71 75 69 65 74 2e 20 20  4c 69 6b 65 20 43 6f 63  |quiet.  Like Coc|
00007e50  6f 20 20 64 6f 65 73 20  20 69 74 2c 20 20 79 6f  |o  does  it,  yo|
00007e60  75 20 0a 73 68 6f 75 6c  64 20 6f 6e 6c 79 20 73  |u .should only s|
00007e70  65 74 20 65 76 65 6e 20  6e 75 6d 62 65 72 73 20  |et even numbers |
00007e80  62 65 63 61 75 73 65 20  6f 66 20 74 68 65 20 4c  |because of the L|
00007e90  53 42 20 28 6c 6f 77 65  72 20 73 69 67 6e 20 62  |SB (lower sign b|
00007ea0  69 74 29 20 66 6f 72 6d  61 74 20 6f 66 20 0a 74  |it) format of .t|
00007eb0  68 65 20 56 49 44 43 2e  20 20 4f 74 68 65 72 77  |he VIDC.  Otherw|
00007ec0  69 73 65 20 79 6f 75 20  77 6f 6e 27 74 20 67 65  |ise you won't ge|
00007ed0  74 20 61 20 66 69 6e 65  20 76 6f 6c 75 6d 65 20  |t a fine volume |
00007ee0  73 6c 69 64 69 6e 67 2e  20 20 57 68 65 6e 20 74  |sliding.  When t|
00007ef0  68 65 20 70 6c 61 79 65  72 20 0a 69 73 20 20 69  |he player .is  i|
00007f00  6e 69 74 69 61 6c 69 73  65 64 20 20 28 61 66 74  |nitialised  (aft|
00007f10  65 72 20 20 42 4c 20 76  5f 6f 6e 29 2c 20 20 74  |er  BL v_on),  t|
00007f20  68 65 20 63 75 72 72 65  6e 74 20 2a 56 4f 4c 55  |he current *VOLU|
00007f30  4d 45 20 69 73 20 20 75  73 65 64 20 20 66 6f 72  |ME is  used  for|
00007f40  20 20 74 68 65 20 0a 6f  76 65 72 61 6c 6c 20 76  |  the .overall v|
00007f50  6f 6c 75 6d 65 2e 0a 54  68 65 20 6d 75 73 69 63  |olume..The music|
00007f60  20 69 73 20 70 6c 61 79  65 64 20 76 69 61 20 74  | is played via t|
00007f70  68 65 20 27 45 76 65 6e  74 27 20 69 6e 74 65 72  |he 'Event' inter|
00007f80  72 75 70 74 20 28 26 31  30 29 2c 20 20 61 6e 64  |rupt (&10),  and|
00007f90  20 74 68 65 20 73 6f 75  6e 64 20 73 79 73 74 65  | the sound syste|
00007fa0  6d 20 0a 6f 66 20 74 68  65 20 41 72 63 20 75 73  |m .of the Arc us|
00007fb0  65 73 20 72 65 70 65 61  74 65 64 6c 79 20 62 75  |es repeatedly bu|
00007fc0  66 66 65 72 20 66 69 6c  6c 69 6e 67 2e 20 55 6e  |ffer filling. Un|
00007fd0  64 65 72 20 73 6f 6d 65  20 73 65 6c 64 6f 6d 20  |der some seldom |
00007fe0  63 69 72 63 75 6d 73 74  61 6e 63 65 73 20 0a 69  |circumstances .i|
00007ff0  74 27 73 20 20 70 6f 73  73 69 62 6c 65 20 74 68  |t's  possible th|
00008000  61 74 20 74 68 65 20 75  73 65 64 20 65 76 65 6e  |at the used even|
00008010  74 20 69 6e 74 65 72 72  75 70 74 73 20 74 68 65  |t interrupts the|
00008020  20 69 6e 73 74 61 6c 6c  65 64 20 20 73 6f 75 6e  | installed  soun|
00008030  64 20 20 76 6f 69 63 65  2c 20 0a 72 65 73 75 6c  |d  voice, .resul|
00008040  74 69 6e 67 20 69 6e 20  74 68 65 20 73 6f 20 63  |ting in the so c|
00008050  61 6c 6c 65 64 20 22 6c  6f 73 69 6e 67 20 63 68  |alled "losing ch|
00008060  61 6e 6e 65 6c 20 73 79  6e 64 72 6f 6d 65 22 2e  |annel syndrome".|
00008070  20 20 54 68 65 20 70 6c  61 79 65 72 20 74 72 69  |  The player tri|
00008080  65 73 20 74 6f 20 0a 61  75 74 6f 2d 73 79 6e 63  |es to .auto-sync|
00008090  20 61 74 20 69 6e 69 74  69 61 6c 69 73 69 6e 67  | at initialising|
000080a0  2c 20 62 75 74 20 61 66  74 65 72 20 74 72 79 69  |, but after tryi|
000080b0  6e 67 20 74 68 72 65 65  20 74 69 6d 65 73 20 69  |ng three times i|
000080c0  74 20 61 62 6f 72 74 73  2e 20 49 66 20 79 6f 75  |t aborts. If you|
000080d0  72 20 0a 70 72 6f 67 72  61 6d 20 20 73 68 6f 75  |r .program  shou|
000080e0  6c 64 20 72 75 6e 20 77  69 74 68 20 35 30 48 7a  |ld run with 50Hz|
000080f0  20 74 68 65 6e 20 70 65  72 68 61 70 73 20 74 68  | then perhaps th|
00008100  65 72 65 27 73 20 61 20  70 6f 73 73 69 62 69 6c  |ere's a possibil|
00008110  69 74 79 20 20 74 6f 20  20 63 61 6c 6c 20 0a 74  |ity  to  call .t|
00008120  68 65 20 20 70 6c 61 79  65 72 20 64 69 72 65 63  |he  player direc|
00008130  74 6c 79 20 76 69 61 20  22 42 4c 20 76 5f 69 6e  |tly via "BL v_in|
00008140  74 65 72 22 20 61 6e 64  20 73 6f 6d 65 20 6f 74  |ter" and some ot|
00008150  68 65 72 20 73 6c 69 67  68 74 20 63 68 61 6e 67  |her slight chang|
00008160  65 73 20 20 28 74 68 65  6e 20 0a 64 6f 6e 27 74  |es  (then .don't|
00008170  20 66 6f 72 67 65 74 20  72 31 32 3d 48 65 61 64  | forget r12=Head|
00008180  20 61 64 64 72 65 73 73  2c 20 6f 72 69 67 69 6e  | address, origin|
00008190  61 6c 6c 79 20 73 75 70  70 6c 69 65 64 20 61 74  |ally supplied at|
000081a0  20 74 68 65 20 76 65 63  74 6f 72 20 63 6c 61 69  | the vector clai|
000081b0  6d 29 2e 0a 0a 49 66 20  20 79 6f 75 20 77 61 6e  |m)...If  you wan|
000081c0  74 20 74 6f 20 6d 61 6b  65 20 73 6f 6d 65 20 73  |t to make some s|
000081d0  6f 75 6e 64 20 65 66 66  65 63 74 73 20 28 66 78  |ound effects (fx|
000081e0  29 20 74 6f 67 65 74 68  65 72 20 77 69 74 68 20  |) together with |
000081f0  74 68 65 20 20 74 75 6e  65 2c 20 20 79 6f 75 20  |the  tune,  you |
00008200  0a 73 68 6f 75 6c 64 20  20 61 64 64 20 79 6f 75  |.should  add you|
00008210  72 20 64 65 73 69 72 65  64 20 65 66 66 65 63 74  |r desired effect|
00008220  20 73 61 6d 70 6c 65 73  20 74 6f 20 79 6f 75 72  | samples to your|
00008230  20 73 6f 6e 67 2c 20 20  61 73 20 20 75 6e 75 73  | song,  as  unus|
00008240  65 64 20 20 69 6e 73 74  72 75 2d 0a 6d 65 6e 74  |ed  instru-.ment|
00008250  73 2c 20 20 69 65 20 20  74 68 65 79 20 61 72 65  |s,  ie  they are|
00008260  20 6c 6f 61 64 65 64 20  69 6e 20 74 68 65 20 69  | loaded in the i|
00008270  6e 73 74 72 75 6d 65 6e  74 20 70 6f 6f 6c 20 62  |nstrument pool b|
00008280  75 74 20 6e 6f 74 20 70  6c 61 79 65 64 20 62 79  |ut not played by|
00008290  20 20 79 6f 75 72 20 0a  73 6f 6e 67 2e 20 41 66  |  your .song. Af|
000082a0  74 65 72 20 69 6e 69 74  69 61 6c 69 73 69 6e 67  |ter initialising|
000082b0  20 74 68 65 20 70 6c 61  79 65 72 20 77 69 74 68  | the player with|
000082c0  20 22 42 4c 20 76 5f 6f  6e 22 20 79 6f 75 20 63  | "BL v_on" you c|
000082d0  6f 75 6c 64 20 63 61 6c  6c 20 22 66 78 31 22 20  |ould call "fx1" |
000082e0  74 6f 20 0a 22 66 78 34  22 2c 20 77 69 74 68 20  |to ."fx4", with |
000082f0  72 31 20 63 6f 6e 74 61  69 6e 69 6e 67 20 74 68  |r1 containing th|
00008300  65 20 73 6f 75 6e 64 20  69 6e 66 6f 72 6d 61 74  |e sound informat|
00008310  69 6f 6e 2e 20 54 68 69  73 20 77 69 6c 6c 20 70  |ion. This will p|
00008320  72 6f 64 75 63 65 20 61  20 73 6f 75 6e 64 20 0a  |roduce a sound .|
00008330  66 78 20 6f 6e 20 74 68  65 20 61 70 70 72 6f 70  |fx on the approp|
00008340  72 69 61 74 65 20 63 68  61 6e 6e 65 6c 20 28 31  |riate channel (1|
00008350  2d 34 29 2c 20 20 77 68  69 6c 65 20 74 68 65 20  |-4),  while the |
00008360  73 6f 6e 67 20 73 6f 75  6e 64 20 6f 6e 20 74 68  |song sound on th|
00008370  69 73 20 63 68 61 6e 6e  65 6c 20 0a 69 73 20 20  |is channel .is  |
00008380  6d 75 74 65 64 20 20 75  6e 74 69 6c 20 20 74 68  |muted  until  th|
00008390  65 20 20 65 66 66 65 63  74 20 68 61 73 20 72 65  |e  effect has re|
000083a0  61 63 68 65 64 20 69 74  73 20 20 73 61 6d 70 6c  |ached its  sampl|
000083b0  65 20 20 65 6e 64 20 20  28 70 6c 65 61 73 65 20  |e  end  (please |
000083c0  20 6e 6f 74 65 3a 20 0a  52 65 70 65 61 74 41 74  | note: .RepeatAt|
000083d0  3d 4f 6e 20 6d 65 61 6e  73 20 75 6e 74 69 6c 20  |=On means until |
000083e0  74 68 65 20 6e 65 78 74  20 65 66 66 65 63 74 20  |the next effect |
000083f0  6f 6e 20 73 61 6d 65 20  63 68 61 6e 6e 65 6c 20  |on same channel |
00008400  69 73 20 73 74 61 72 74  65 64 21 29 2e 0a 52 65  |is started!)..Re|
00008410  67 69 73 74 65 72 20 20  72 31 20 63 6f 6e 74 61  |gister  r1 conta|
00008420  69 6e 73 20 74 68 65 20  72 65 6c 65 76 61 6e 74  |ins the relevant|
00008430  20 73 6f 75 6e 64 20 69  6e 66 6f 72 6d 61 74 69  | sound informati|
00008440  6f 6e 2c 20 20 69 74 20  69 73 20 20 65 78 61 63  |on,  it is  exac|
00008450  74 6c 79 20 20 74 68 65  20 0a 73 61 6d 65 20 20  |tly  the .same  |
00008460  6c 6f 6e 67 77 6f 72 64  20 20 74 68 61 74 20 79  |longword  that y|
00008470  6f 75 20 75 73 65 20 77  68 65 6e 20 79 6f 75 20  |ou use when you |
00008480  65 64 69 74 20 79 6f 75  72 20 73 6f 6e 67 2e 20  |edit your song. |
00008490  20 57 69 74 68 20 74 6f  70 20 20 62 79 74 65 20  | With top  byte |
000084a0  20 28 33 29 20 0a 66 69  72 73 74 20 61 6e 64 20  | (3) .first and |
000084b0  6c 6f 77 20 62 79 74 65  20 28 30 29 20 6c 61 73  |low byte (0) las|
000084c0  74 2c 20 74 68 69 73 20  69 73 3a 0a 0a 20 33 20  |t, this is:.. 3 |
000084d0  3a 20 54 6f 6e 65 20 66  72 65 71 75 65 6e 63 79  |: Tone frequency|
000084e0  20 28 69 6e 20 68 61 6c  66 20 74 6f 6e 65 73 2c  | (in half tones,|
000084f0  20 61 73 20 74 68 65 20  65 66 66 65 63 74 20 41  | as the effect A|
00008500  72 70 65 67 67 69 6f 20  75 73 65 29 2e 0a 20 32  |rpeggio use).. 2|
00008510  20 3a 20 49 6e 73 74 72  75 6d 65 6e 74 20 74 6f  | : Instrument to|
00008520  20 75 73 65 2c 20 70 6c  65 61 73 65 20 64 6f 20  | use, please do |
00008530  6e 6f 74 20 65 78 63 65  65 64 20 74 68 65 20 6c  |not exceed the l|
00008540  61 73 74 20 69 6e 73 74  72 75 6d 65 6e 74 20 6e  |ast instrument n|
00008550  75 6d 62 65 72 21 0a 20  31 20 3a 20 43 6f 6d 6d  |umber!. 1 : Comm|
00008560  61 6e 64 20 6f 72 20 65  66 66 65 63 74 20 6e 75  |and or effect nu|
00008570  6d 62 65 72 2e 0a 20 30  20 3a 20 49 6e 66 6f 62  |mber.. 0 : Infob|
00008580  79 74 65 2e 0a 0a 41 20  42 41 53 49 43 20 73 74  |yte...A BASIC st|
00008590  61 74 65 6d 65 6e 74 20  65 78 61 6d 70 6c 65 20  |atement example |
000085a0  77 6f 75 6c 64 20 62 65  2e 2e 2e 20 20 42 25 3d  |would be...  B%=|
000085b0  26 32 35 31 31 30 35 30  32 20 3a 43 41 4c 4c 20  |&25110502 :CALL |
000085c0  66 78 33 0a 54 68 69 73  20 69 73 20 72 65 61 64  |fx3.This is read|
000085d0  20 61 73 20 26 32 35 2d  31 31 2d 30 35 2d 30 32  | as &25-11-05-02|
000085e0  20 61 6e 64 20 70 72 6f  64 75 63 65 73 20 61 20  | and produces a |
000085f0  73 6f 75 6e 64 20 66 78  20 6f 6e 20 63 68 61 6e  |sound fx on chan|
00008600  6e 65 6c 20 33 20 3a 0a  54 6f 6e 65 20 43 23 30  |nel 3 :.Tone C#0|
00008610  20 69 73 20 70 6c 61 79  65 64 20 28 3d 26 32 35  | is played (=&25|
00008620  20 3d 64 65 7a 20 33 37  2c 20 61 73 20 6f 6e 65  | =dez 37, as one|
00008630  20 6f 63 74 61 76 65 20  68 61 73 20 31 32 20 68  | octave has 12 h|
00008640  61 6c 66 74 6f 6e 65 73  2c 20 73 74 61 72 74 69  |alftones, starti|
00008650  6e 67 20 0a 77 69 74 68  20 6e 75 6d 62 65 72 20  |ng .with number |
00008660  30 31 20 3d 20 43 2d 33  29 3b 20 77 69 74 68 20  |01 = C-3); with |
00008670  73 61 6d 70 6c 65 20 6e  75 6d 62 65 72 20 31 37  |sample number 17|
00008680  20 28 3d 26 31 31 2c 20  69 6e 73 74 72 75 6d 65  | (=&11, instrume|
00008690  6e 74 20 22 71 22 29 3b  20 75 73 69 6e 67 20 0a  |nt "q"); using .|
000086a0  74 68 65 20 22 53 6c 69  64 65 20 65 66 66 65 63  |the "Slide effec|
000086b0  74 22 20 28 26 30 35 29  20 77 69 74 68 20 73 74  |t" (&05) with st|
000086c0  65 70 20 26 30 32 2e 20  20 49 6e 20 70 61 74 74  |ep &02.  In patt|
000086d0  65 72 6e 2d 65 64 69 74  2d 66 6f 72 6d 2c 20 20  |ern-edit-form,  |
000086e0  74 68 69 73 20 77 6f 75  6c 64 20 0a 62 65 3a 20  |this would .be: |
000086f0  43 23 30 20 71 20 35 20  30 32 0a 0a 41 6c 74 65  |C#0 q 5 02..Alte|
00008700  72 6e 61 74 69 76 65 6c  79 20 79 6f 75 20 63 6f  |rnatively you co|
00008710  75 6c 64 20 6d 6f 64 69  66 79 20 74 68 65 20 63  |uld modify the c|
00008720  68 61 6e 6e 65 6c 20 68  65 61 64 73 20 64 69 72  |hannel heads dir|
00008730  65 63 74 6c 79 2c 20 74  6f 20 70 72 6f 64 75 63  |ectly, to produc|
00008740  65 20 79 6f 75 72 20 0a  73 6f 75 6e 64 20 20 65  |e your .sound  e|
00008750  66 66 65 63 74 73 20 28  74 68 65 20 61 70 70 72  |ffects (the appr|
00008760  6f 70 72 69 61 74 65 20  61 73 73 65 6d 62 6c 65  |opriate assemble|
00008770  72 20 70 61 72 74 20 69  73 20 20 64 6f 63 75 6d  |r part is  docum|
00008780  65 6e 74 65 64 29 2e 20  20 54 68 65 72 65 66 6f  |ented).  Therefo|
00008790  72 65 20 0a 79 6f 75 20  6a 75 73 74 20 68 61 76  |re .you just hav|
000087a0  65 20 74 6f 20 73 65 74  20 62 79 74 65 20 33 30  |e to set byte 30|
000087b0  20 6f 66 20 74 68 65 20  61 70 70 72 6f 70 72 69  | of the appropri|
000087c0  61 74 65 20 63 68 61 6e  6e 65 6c 20 68 65 61 64  |ate channel head|
000087d0  2c 20 20 69 6e 20 6f 72  64 65 72 20 74 6f 20 0a  |,  in order to .|
000087e0  68 61 6c 74 20 74 68 65  20 73 6f 6e 67 20 73 6f  |halt the song so|
000087f0  75 6e 64 20 6f 6e 20 74  68 69 73 20 63 68 61 6e  |und on this chan|
00008800  6e 65 6c 20 28 30 20 6d  65 61 6e 73 20 63 6f 6e  |nel (0 means con|
00008810  74 69 6e 75 65 20 73 6f  6e 67 29 2e 0a 0a 0a 54  |tinue song)....T|
00008820  68 65 72 65 27 73 20 61  20 73 65 63 6f 6e 64 20  |here's a second |
00008830  70 6c 61 79 65 72 2c 20  20 63 61 6c 6c 65 64 20  |player,  called |
00008840  22 50 6c 61 79 22 2e 20  42 75 74 20 69 74 20 69  |"Play". But it i|
00008850  73 6e 27 74 20 66 6f 72  20 75 73 65 20 49 4e 20  |sn't for use IN |
00008860  61 20 72 75 6e 74 69 6d  65 20 0a 70 72 6f 67 72  |a runtime .progr|
00008870  61 6d 2e 20 59 6f 75 20  73 74 61 72 74 20 69 74  |am. You start it|
00008880  20 69 6e 20 42 41 53 49  43 20 61 6e 64 20 74 68  | in BASIC and th|
00008890  65 20 73 6f 6e 67 20 77  69 6c 6c 20 62 65 20 70  |e song will be p|
000088a0  6c 61 79 65 64 2e 20 41  66 74 65 72 20 74 68 69  |layed. After thi|
000088b0  73 20 79 6f 75 20 0a 63  6f 75 6c 64 20 20 73 65  |s you .could  se|
000088c0  74 20 20 42 41 53 49 43  27 73 20 20 73 74 61 72  |t  BASIC's  star|
000088d0  74 20 76 61 6c 75 65 20  50 41 47 45 20 68 69 67  |t value PAGE hig|
000088e0  68 65 72 20 74 68 61 6e  20 20 74 68 65 20 20 70  |her than  the  p|
000088f0  6c 61 79 65 72 73 20 20  65 6e 64 2c 20 20 66 6f  |layers  end,  fo|
00008900  72 20 0a 74 65 73 74 69  6e 67 20 20 61 6e 64 2f  |r .testing  and/|
00008910  6f 72 20 20 6c 6f 61 64  69 6e 67 20 79 6f 75 72  |or  loading your|
00008920  20 73 6f 75 72 63 65 20  70 72 6f 67 72 61 6d 20  | source program |
00008930  57 48 49 4c 45 20 74 68  65 20 73 6f 75 6e 64 20  |WHILE the sound |
00008940  20 69 73 20 20 70 6c 61  79 69 6e 67 2e 20 0a 54  | is  playing. .T|
00008950  68 69 73 20 6c 65 74 20  79 6f 75 20 74 65 73 74  |his let you test|
00008960  20 73 65 76 65 72 61 6c  20 74 68 69 6e 67 73 20  | several things |
00008970  6c 69 6b 65 20 73 70 65  65 64 2c 20 73 79 6e 63  |like speed, sync|
00008980  68 72 6f 6e 69 73 61 74  69 6f 6e 2c 20 65 74 63  |hronisation, etc|
00008990  2c 20 77 69 74 68 6f 75  74 20 0a 6c 69 6e 6b 69  |, without .linki|
000089a0  6e 67 20 61 6c 6c 20 70  61 72 74 73 20 74 6f 67  |ng all parts tog|
000089b0  65 74 68 65 72 20 65 61  63 68 20 74 69 6d 65 2e  |ether each time.|
000089c0  0a 55 73 65 20 43 41 4c  4c 20 41 25 20 74 6f 20  |.Use CALL A% to |
000089d0  73 74 6f 70 20 74 68 65  20 70 6c 61 79 65 72 20  |stop the player |
000089e0  28 61 6e 64 20 70 6c 65  61 73 65 20 64 6f 20 6e  |(and please do n|
000089f0  6f 74 20 73 74 61 72 74  20 6f 74 68 65 72 20 61  |ot start other a|
00008a00  70 70 6c 69 63 61 74 69  6f 6e 73 20 0a 62 65 66  |pplications .bef|
00008a10  6f 72 65 20 20 68 61 76  69 6e 67 20 73 74 6f 70  |ore  having stop|
00008a20  70 65 64 20 69 74 21 29  2c 20 20 61 6e 64 20 6c  |ped it!),  and l|
00008a30  61 74 65 72 20 6f 6e 20  43 41 4c 4c 20 42 25 20  |ater on CALL B% |
00008a40  74 6f 20 72 65 61 63 74  69 76 61 74 65 20 20 69  |to reactivate  i|
00008a50  74 2e 20 20 54 68 65 20  0a 76 61 6c 75 65 20 20  |t.  The .value  |
00008a60  56 25 20 70 6f 69 6e 74  73 20 74 6f 20 74 68 65  |V% points to the|
00008a70  20 6f 76 65 72 61 6c 6c  20 76 6f 6c 75 6d 65 20  | overall volume |
00008a80  6c 6f 6e 67 77 6f 72 64  2e 20 20 28 50 72 6f 76  |longword.  (Prov|
00008a90  69 64 65 64 20 20 74 68  65 73 65 20 20 73 74 61  |ided  these  sta|
00008aa0  74 69 63 20 0a 76 61 72  69 61 62 6c 65 73 20 68  |tic .variables h|
00008ab0  61 76 65 6e 27 74 20 62  65 65 6e 20 63 6f 72 72  |aven't been corr|
00008ac0  75 70 74 65 64 20 62 79  20 79 6f 75 72 20 70 72  |upted by your pr|
00008ad0  6f 67 72 61 6d 21 29 0a  0a 0a 59 6f 75 20 6d 61  |ogram!)...You ma|
00008ae0  79 20 66 72 65 65 6c 79  20 75 73 65 20 61 6e 64  |y freely use and|
00008af0  20 63 6f 70 79 20 74 68  65 20 70 6c 61 79 65 72  | copy the player|
00008b00  20 72 6f 75 74 69 6e 65  28 73 29 2e 20 20 41 6e  | routine(s).  An|
00008b10  64 20 6f 66 20 63 6f 75  72 73 65 20 79 6f 75 20  |d of course you |
00008b20  20 6d 61 79 20 0a 61 64  61 70 74 20 20 69 74 20  | may .adapt  it |
00008b30  20 74 6f 20 79 6f 75 72  20 72 65 71 75 69 72 65  | to your require|
00008b40  6d 65 6e 74 73 20 77 68  65 6e 20 61 70 70 65 6e  |ments when appen|
00008b50  64 69 6e 67 20 69 74 20  20 74 6f 20 20 79 6f 75  |ding it  to  you|
00008b60  72 20 20 70 72 6f 67 72  61 6d 2e 20 20 42 75 74  |r  program.  But|
00008b70  20 0a 70 6c 65 61 73 65  20 6c 65 61 76 65 20 74  | .please leave t|
00008b80  68 65 20 6f 72 69 67 69  6e 61 6c 20 70 6c 61 79  |he original play|
00008b90  65 72 73 20 61 6e 64 20  61 6c 6c 20 6f 74 68 65  |ers and all othe|
00008ba0  72 20 74 6f 6f 6c 73 20  75 6e 63 68 61 6e 67 65  |r tools unchange|
00008bb0  64 2e 0a 0a 0a 0a 20 53  4f 4d 45 20 46 49 4e 41  |d..... SOME FINA|
00008bc0  4c 20 43 4f 4e 43 4c 55  53 49 4f 4e 53 0a 20 3d  |L CONCLUSIONS. =|
00008bd0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
00008be0  3d 3d 3d 3d 3d 0a 0a 57  65 6c 6c 2c 20 74 68 65  |=====..Well, the|
00008bf0  20 61 69 6d 20 6f 66 20  43 6f 63 6f 6e 69 7a 65  | aim of Coconize|
00008c00  72 20 69 73 20 74 6f 20  61 6c 6c 6f 77 20 79 6f  |r is to allow yo|
00008c10  75 20 74 6f 20 63 72 65  61 74 65 20 73 6f 6e 67  |u to create song|
00008c20  73 20 61 6e 64 20 74 6f  20 75 73 65 20 74 68 65  |s and to use the|
00008c30  6d 20 0a 69 6e 64 65 70  65 6e 64 65 6e 74 6c 79  |m .independently|
00008c40  20 28 73 74 61 6e 64 20  61 6c 6f 6e 65 29 20 69  | (stand alone) i|
00008c50  6e 20 6f 77 6e 20 70 72  6f 67 72 61 6d 73 2c 20  |n own programs, |
00008c60  77 69 74 68 20 74 68 65  20 70 6f 73 73 69 62 69  |with the possibi|
00008c70  6c 69 74 79 20 6f 66 20  75 73 69 6e 67 20 0a 66  |lity of using .f|
00008c80  6f 75 72 20 6f 72 20 65  69 67 68 74 20 41 72 63  |our or eight Arc|
00008c90  68 69 6d 65 64 65 73 20  63 68 61 6e 6e 65 6c 73  |himedes channels|
00008ca0  2e 0a 43 6f 63 6f 27 73  20 20 50 6c 61 79 65 72  |..Coco's  Player|
00008cb0  20 69 73 20 6d 61 69 6e  6c 79 20 69 6e 74 65 6e  | is mainly inten|
00008cc0  64 65 64 20 74 6f 20 62  65 20 69 6e 63 6c 75 64  |ded to be includ|
00008cd0  65 64 20 69 6e 74 6f 20  73 65 6c 66 20 6d 61 64  |ed into self mad|
00008ce0  65 20 20 70 72 6f 67 72  61 6d 73 2e 20 0a 57 65  |e  programs. .We|
00008cf0  20 74 68 69 6e 6b 20 6d  6f 73 74 20 70 72 6f 67  | think most prog|
00008d00  72 61 6d 6d 65 72 73 20  73 68 6f 75 6c 64 6e 27  |rammers shouldn'|
00008d10  74 20 68 61 76 65 20 6d  61 6e 79 20 70 72 6f 62  |t have many prob|
00008d20  6c 65 6d 73 2e 0a 0a 41  6e 64 20 63 6f 6d 69 6e  |lems...And comin|
00008d30  67 20 62 61 63 6b 20 74  6f 20 74 68 65 20 22 41  |g back to the "A|
00008d40  6d 69 54 72 61 6e 73 22  20 74 6f 6f 6c 20 61 6e  |miTrans" tool an|
00008d50  64 20 74 68 65 20 6b 6e  6f 77 6e 20 63 6f 6e 76  |d the known conv|
00008d60  65 72 74 69 6e 67 20 20  70 72 6f 62 6c 65 6d 73  |erting  problems|
00008d70  3a 20 0a 49 74 27 73 20  20 6e 6f 74 20 74 68 65  |: .It's  not the|
00008d80  20 6d 61 69 6e 20 61 69  6d 20 6f 66 20 43 6f 63  | main aim of Coc|
00008d90  6f 20 74 6f 20 70 6c 61  79 20 41 6d 69 67 61 20  |o to play Amiga |
00008da0  73 6f 6e 67 73 2e 20 20  41 6c 74 68 6f 75 67 68  |songs.  Although|
00008db0  20 77 65 20 74 72 69 65  64 20 20 74 6f 20 0a 6b  | we tried  to .k|
00008dc0  65 65 70 20 73 65 76 65  72 61 6c 20 6d 61 69 6e  |eep several main|
00008dd0  20 63 6f 6d 6d 61 6e 64  73 20 61 6e 64 20 67 65  | commands and ge|
00008de0  6e 65 72 61 6c 20 73 74  72 75 63 74 75 72 65 73  |neral structures|
00008df0  2c 20 20 43 6f 63 6f 6e  69 7a 65 72 20 77 61 73  |,  Coconizer was|
00008e00  20 20 63 72 65 61 74 65  64 20 0a 74 6f 20 20 62  |  created .to  b|
00008e10  65 20 20 61 6e 20 20 41  72 63 68 69 6d 65 64 65  |e  an  Archimede|
00008e20  73 20 20 73 6f 75 6e 64  74 72 61 63 6b 65 72 2e  |s  soundtracker.|
00008e30  20 20 49 66 20 79 6f 75  20 77 61 6e 74 20 20 74  |  If you want  t|
00008e40  6f 20 20 68 65 61 72 20  20 41 6d 69 67 61 20 20  |o  hear  Amiga  |
00008e50  73 6f 6e 67 73 20 0a 65  78 63 6c 75 73 69 76 65  |songs .exclusive|
00008e60  6c 79 2c 20 70 6c 65 61  73 65 20 75 73 65 20 74  |ly, please use t|
00008e70  68 65 20 50 6c 61 79 65  72 20 6f 66 20 48 75 67  |he Player of Hug|
00008e80  6f 20 46 69 65 6e 6e 65  73 20 69 6e 73 74 65 61  |o Fiennes instea|
00008e90  64 2e 0a 41 6e 64 20 20  61 6c 6c 20 61 73 73 65  |d..And  all asse|
00008ea0  6d 62 6c 65 72 20 66 61  6e 73 20 77 69 6c 6c 20  |mbler fans will |
00008eb0  73 65 65 20 74 68 61 74  20 6f 75 72 20 72 6f 75  |see that our rou|
00008ec0  74 69 6e 65 73 20 28 74  72 79 20 74 6f 29 20 75  |tines (try to) u|
00008ed0  73 65 20 20 74 68 65 20  20 52 49 53 43 20 0a 33  |se  the  RISC .3|
00008ee0  32 20 62 69 74 20 20 66  61 63 69 6c 69 74 69 65  |2 bit  facilitie|
00008ef0  73 20 74 68 65 20 41 52  4d 20 70 72 6f 76 69 64  |s the ARM provid|
00008f00  65 73 2e 20 20 53 6f 20  77 65 20 75 73 65 20 61  |es.  So we use a|
00008f10  6e 20 6f 77 6e 20 28 41  52 4d 20 70 6c 65 61 73  |n own (ARM pleas|
00008f20  65 64 29 20 20 73 6f 6e  67 20 0a 66 6f 72 6d 61  |ed)  song .forma|
00008f30  74 2e 20 20 57 65 20 74  72 69 65 64 20 74 6f 20  |t.  We tried to |
00008f40  77 72 69 74 65 20 66 61  73 74 20 72 6f 75 74 69  |write fast routi|
00008f50  6e 65 73 2c 20 20 62 65  63 61 75 73 65 20 6c 61  |nes,  because la|
00008f60  7a 79 20 69 6e 74 65 72  72 75 70 74 20 72 6f 75  |zy interrupt rou|
00008f70  74 69 6e 65 73 20 0a 73  6c 6f 77 20 64 6f 77 6e  |tines .slow down|
00008f80  20 74 68 65 20 77 68 6f  6c 65 20 73 79 73 74 65  | the whole syste|
00008f90  6d 20 63 6f 6e 73 69 64  65 72 61 62 6c 79 2e 20  |m considerably. |
00008fa0  20 41 6e 64 20 74 68 6f  75 67 68 20 79 6f 75 72  | And though your|
00008fb0  20 41 72 63 20 69 73 20  76 65 72 79 20 66 61 73  | Arc is very fas|
00008fc0  74 20 0a 28 79 65 73 2c  20 69 74 20 69 73 21 29  |t .(yes, it is!)|
00008fd0  2c 20 77 65 20 64 6f 6e  27 74 20 74 68 69 6e 6b  |, we don't think|
00008fe0  20 69 74 27 73 20 61 20  67 6f 6f 64 20 69 64 65  | it's a good ide|
00008ff0  61 20 74 6f 20 77 61 73  74 65 20 69 74 73 20 73  |a to waste its s|
00009000  70 65 65 64 2e 0a 0a 0a  41 74 20 74 68 69 73 20  |peed....At this |
00009010  70 6f 69 6e 74 20 77 65  20 77 6f 75 6c 64 20 6c  |point we would l|
00009020  69 6b 65 20 74 6f 20 74  68 61 6e 6b 20 74 68 65  |ike to thank the|
00009030  20 66 6f 6c 6c 6f 77 69  6e 67 20 70 65 6f 70 6c  | following peopl|
00009040  65 20 28 61 6e 64 20 65  76 65 6e 20 69 66 20 20  |e (and even if  |
00009050  77 65 20 0a 64 6f 6e 27  74 20 6b 6e 6f 77 20 61  |we .don't know a|
00009060  6c 6c 20 6f 66 20 74 68  65 6d 20 64 69 72 65 63  |ll of them direc|
00009070  74 6c 79 2e 2e 2e 29 20  3a 0a 0a 20 b7 20 47 75  |tly...) :.. . Gu|
00009080  74 74 6f 72 6d 20 66 6f  72 20 68 69 73 20 6e 65  |ttorm for his ne|
00009090  77 73 2c 20 68 69 6e 74  73 20 61 6e 64 20 73 75  |ws, hints and su|
000090a0  67 67 65 73 74 69 6f 6e  73 2e 0a 20 b7 20 4b 61  |ggestions.. . Ka|
000090b0  72 73 74 65 6e 20 20 4f  62 61 72 73 6b 69 2c 20  |rsten  Obarski, |
000090c0  20 44 6f 63 20 20 61 6e  64 20 20 6f 74 68 65 72  | Doc  and  other|
000090d0  73 20 66 6f 72 20 20 69  6e 76 65 6e 74 69 6e 67  |s for  inventing|
000090e0  20 20 74 68 65 20 20 70  6f 70 75 6c 61 72 20 20  |  the  popular  |
000090f0  41 6d 69 67 61 20 0a 20  20 20 53 6f 75 6e 64 54  |Amiga .   SoundT|
00009100  72 61 63 6b 65 72 20 73  74 61 6e 64 61 72 64 2c  |racker standard,|
00009110  20 61 6e 64 20 66 6f 72  20 61 20 6c 6f 74 20 6f  | and for a lot o|
00009120  66 20 50 44 20 73 6f 6e  67 73 20 61 6e 64 20 69  |f PD songs and i|
00009130  6e 73 74 72 75 6d 65 6e  74 73 2e 0a 20 b7 20 41  |nstruments.. . A|
00009140  6e 64 79 20 28 6f 66 20  4a 4c 41 43 53 29 20 61  |ndy (of JLACS) a|
00009150  6e 64 20 61 20 66 65 77  20 6f 74 68 65 72 20 6e  |nd a few other n|
00009160  69 63 65 20 70 65 6f 70  6c 65 20 66 6f 72 20 74  |ice people for t|
00009170  68 65 69 72 20 73 75 70  70 6f 72 74 2e 0a 20 b7  |heir support.. .|
00009180  20 41 6e 64 20 20 66 69  6e 61 6c 6c 79 20 41 63  | And  finally Ac|
00009190  6f 72 6e 20 66 6f 72 20  74 68 65 69 72 20 65 78  |orn for their ex|
000091a0  71 75 69 73 69 74 65 20  41 72 63 68 69 6d 65 64  |quisite Archimed|
000091b0  65 73 20 20 73 65 72 69  65 73 2c 20 20 69 6d 70  |es  series,  imp|
000091c0  6c 65 6d 65 6e 74 65 64  20 0a 20 20 20 41 73 73  |lemented .   Ass|
000091d0  65 6d 62 6c 65 72 2f 44  65 62 75 67 67 65 72 20  |embler/Debugger |
000091e0  61 6e 64 20 74 68 65 20  73 75 70 65 72 62 20 41  |and the superb A|
000091f0  52 4d 20 42 61 73 69 63  2e 0a 0a 0a 0a 20 43 4f  |RM Basic..... CO|
00009200  50 59 52 49 47 48 54 20  26 20 43 4f 4e 54 52 49  |PYRIGHT & CONTRI|
00009210  42 55 54 49 4f 4e 53 0a  20 3d 3d 3d 3d 3d 3d 3d  |BUTIONS. =======|
00009220  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
00009230  3d 3d 0a 0a 53 6f 20 74  68 61 74 20 73 6f 6d 65  |==..So that some|
00009240  62 6f 64 79 20 6d 61 79  20 62 65 6e 65 66 69 74  |body may benefit|
00009250  20 66 72 6f 6d 20 6f 75  72 20 65 66 66 6f 72 74  | from our effort|
00009260  73 2c 20 20 77 65 20 68  61 76 65 20 64 65 63 69  |s,  we have deci|
00009270  64 65 64 20 74 6f 20 73  65 74 20 74 68 65 20 0a  |ded to set the .|
00009280  73 74 61 74 75 73 20 6f  66 20 43 6f 63 6f 6e 69  |status of Coconi|
00009290  7a 65 72 20 74 6f 20 46  52 45 45 57 41 52 45 2e  |zer to FREEWARE.|
000092a0  20 20 41 63 63 6f 72 64  69 6e 67 20 74 6f 20 74  |  According to t|
000092b0  68 65 20 47 65 72 6d 61  6e 20 6c 61 77 20 77 65  |he German law we|
000092c0  20 6b 65 65 70 20 20 74  68 65 20 0a 63 6f 70 79  | keep  the .copy|
000092d0  72 69 67 68 74 2c 20 20  69 65 20 43 6f 63 6f 6e  |right,  ie Cocon|
000092e0  69 7a 65 72 20 69 73 20  6f 75 72 20 69 6e 74 65  |izer is our inte|
000092f0  6c 6c 65 63 74 75 61 6c  20 70 72 6f 70 65 72 74  |llectual propert|
00009300  79 2e 20 20 41 73 20 74  68 65 20 70 72 6f 67 72  |y.  As the progr|
00009310  61 6d 20 20 69 73 20 0a  66 72 65 65 2c 20 79 6f  |am  is .free, yo|
00009320  75 20 6d 61 79 20 75 73  65 20 61 6e 64 20 63 6f  |u may use and co|
00009330  70 79 20 69 74 20 66 72  65 65 6c 79 2c 20 77 69  |py it freely, wi|
00009340  74 68 20 74 68 65 20 66  6f 6c 6c 6f 77 69 6e 67  |th the following|
00009350  20 72 65 73 74 72 69 63  74 69 6f 6e 73 2e 0a 0a  | restrictions...|
00009360  46 72 65 65 77 61 72 65  20 6d 65 61 6e 73 20 79  |Freeware means y|
00009370  6f 75 20 6d 61 79 20 63  6f 70 79 20 61 73 20 6c  |ou may copy as l|
00009380  6f 6e 67 20 61 73 3a 0a  0a 20 31 29 20 54 68 69  |ong as:.. 1) Thi|
00009390  73 20 69 73 20 6e 6f 74  20 66 6f 72 20 63 6f 6d  |s is not for com|
000093a0  6d 65 72 63 69 61 6c 20  70 75 72 70 6f 73 65 73  |mercial purposes|
000093b0  2e 0a 20 20 20 20 20 28  49 6e 63 6c 75 64 69 6e  |..     (Includin|
000093c0  67 20 63 68 61 72 67 69  6e 67 20 66 6f 72 20 74  |g charging for t|
000093d0  68 65 20 63 6f 70 79 69  6e 67 21 29 0a 20 32 29  |he copying!). 2)|
000093e0  20 54 68 61 74 20 43 6f  63 6f 6e 69 7a 65 72 20  | That Coconizer |
000093f0  61 6e 64 20 69 74 73 20  72 65 73 6f 75 72 63 65  |and its resource|
00009400  73 20 26 20 74 6f 6f 6c  73 20 61 72 65 20 6e 6f  |s & tools are no|
00009410  74 20 74 61 6d 70 65 72  65 64 20 77 69 74 68 2e  |t tampered with.|
00009420  0a 20 20 20 20 20 28 45  78 63 65 70 74 20 72 65  |.     (Except re|
00009430  6d 6f 76 69 6e 67 2f 61  64 64 69 6e 67 20 73 61  |moving/adding sa|
00009440  6d 70 6c 65 73 20 61 6e  64 20 73 6f 6e 67 73 29  |mples and songs)|
00009450  0a 20 33 29 20 54 68 69  73 20 52 65 61 64 4d 65  |. 3) This ReadMe|
00009460  20 66 69 6c 65 20 69 73  20 61 6c 77 61 79 73 20  | file is always |
00009470  69 6e 63 6c 75 64 65 64  20 77 69 74 68 20 43 6f  |included with Co|
00009480  63 6f 6e 69 7a 65 72 2e  0a 0a 0a 57 65 6c 6c 2c  |conizer....Well,|
00009490  20 61 6e 64 20 69 66 20  79 6f 75 20 68 61 76 65  | and if you have|
000094a0  2e 2e 2e 0a 0a 20 20 20  53 75 67 67 65 73 74 69  |.....   Suggesti|
000094b0  6f 6e 20 6f 72 20 69 6d  70 72 6f 76 65 6d 65 6e  |on or improvemen|
000094c0  74 73 2c 0a 20 20 20 46  6f 75 6e 64 20 73 6f 6d  |ts,.   Found som|
000094d0  65 20 62 75 67 73 20 28  77 65 20 64 6f 6e 27 74  |e bugs (we don't|
000094e0  20 68 6f 70 65 20 73 6f  29 2c 0a 20 20 20 4a 75  | hope so),.   Ju|
000094f0  73 74 20 73 6f 6d 65 20  71 75 65 73 74 69 6f 6e  |st some question|
00009500  73 20 6f 72 20 63 6f 6d  6d 65 6e 74 73 20 6f 66  |s or comments of|
00009510  20 61 6c 6c 20 6b 69 6e  64 73 2c 0a 20 20 20 4d  | all kinds,.   M|
00009520  61 64 65 20 61 20 67 6f  6f 64 20 73 6f 6e 67 20  |ade a good song |
00009530  61 6e 64 20 77 6f 75 6c  64 20 6c 69 6b 65 20 74  |and would like t|
00009540  6f 20 72 65 6c 65 61 73  65 20 69 74 20 61 73 20  |o release it as |
00009550  50 75 62 6c 69 63 20 44  6f 6d 61 69 6e 2c 0a 0a  |Public Domain,..|
00009560  20 20 20 20 20 2e 2e 74  68 65 6e 20 77 68 79 20  |     ..then why |
00009570  6e 6f 74 20 63 6f 6e 74  61 63 74 69 6e 67 20 75  |not contacting u|
00009580  73 3f 0a 0a 0a 0a 57 65  6c 6c 2c 20 20 61 73 20  |s?....Well,  as |
00009590  20 77 65 20 61 6c 77 61  79 73 20 64 6f 2c 20 20  | we always do,  |
000095a0  77 65 20 73 70 65 6e 74  20 61 20 6c 6f 74 20 6f  |we spent a lot o|
000095b0  66 20 74 69 6d 65 20 61  6e 64 20 77 6f 72 6b 20  |f time and work |
000095c0  6f 6e 20 74 68 69 73 20  20 70 72 6f 67 72 61 6d  |on this  program|
000095d0  20 0a 28 61 6c 74 68 6f  75 67 68 20 74 68 69 73  | .(although this|
000095e0  20 69 73 20 6f 75 72 20  73 70 61 72 65 20 74 69  | is our spare ti|
000095f0  6d 65 20 2d 20 77 65 20  64 6f 6e 27 74 20 63 61  |me - we don't ca|
00009600  72 65 29 2e 20 20 41 6e  64 20 70 65 72 68 61 70  |re).  And perhap|
00009610  73 20 74 68 65 72 65 20  20 61 72 65 20 0a 73 6f  |s there  are .so|
00009620  6d 65 20 70 65 6f 70 6c  65 20 68 6f 6e 6f 75 72  |me people honour|
00009630  69 6e 67 20 74 68 69 73  2e 20 53 6f 20 69 66 20  |ing this. So if |
00009640  79 6f 75 20 74 68 69 6e  6b 20 74 68 61 74 20 43  |you think that C|
00009650  6f 63 6f 20 69 73 20 71  75 69 74 65 20 6e 69 63  |oco is quite nic|
00009660  65 2c 20 6f 72 20 69 66  20 0a 79 6f 75 20 77 6f  |e, or if .you wo|
00009670  75 6c 64 20 6c 69 6b 65  20 74 6f 20 73 75 70 70  |uld like to supp|
00009680  6f 72 74 20 74 68 65 20  61 75 74 68 6f 72 73 20  |ort the authors |
00009690  66 6f 72 20 66 75 72 74  68 65 72 20 70 72 6f 67  |for further prog|
000096a0  72 61 6d 73 20 6f 6e 20  74 68 61 74 20 20 73 75  |rams on that  su|
000096b0  70 65 72 62 20 0a 41 72  63 68 69 6d 65 64 65 73  |perb .Archimedes|
000096c0  2c 20 74 68 65 6e 20 77  68 79 20 6e 6f 74 20 73  |, then why not s|
000096d0  65 6e 64 69 6e 67 20 61  20 73 6d 61 6c 6c 20 64  |ending a small d|
000096e0  6f 6e 61 74 69 6f 6e 20  6f 72 20 73 6f 6d 65 74  |onation or somet|
000096f0  68 69 6e 67 20 69 6e 20  74 68 61 74 20 77 61 79  |hing in that way|
00009700  20 0a 28 6c 69 6b 65 20  61 20 6e 69 63 65 20 27  | .(like a nice '|
00009710  48 65 6c 6c 6f 27 20 3a  2d 29 20 20 74 6f 2e 2e  |Hello' :-)  to..|
00009720  2e 0a 0a 0a 20 20 20 20  20 20 20 20 20 20 2e 2e  |....          ..|
00009730  65 69 74 68 65 72 20 20  20 20 20 20 20 20 20 20  |either          |
00009740  20 20 20 20 20 20 20 20  20 20 20 20 2e 2e 6f 72  |            ..or|
00009750  0a 0a 20 20 20 20 20 20  20 20 20 20 54 68 6f 6d  |..          Thom|
00009760  61 73 20 41 6c 62 65 72  20 20 20 20 20 20 20 20  |as Alber        |
00009770  20 20 20 20 20 20 20 20  20 20 45 64 75 61 72 64  |          Eduard|
00009780  20 50 66 61 72 72 0a 20  20 20 20 20 20 20 20 20  | Pfarr.         |
00009790  20 4f 67 67 65 6c 73 68  61 75 73 65 72 73 74 72  | Oggelshauserstr|
000097a0  61 73 73 65 20 37 20 20  20 20 20 20 20 20 20 41  |asse 7         A|
000097b0  74 7a 65 6e 62 65 72 67  65 72 73 74 72 61 73 73  |tzenbergerstrass|
000097c0  65 20 32 0a 20 20 20 20  20 20 20 20 20 20 57 2d  |e 2.          W-|
000097d0  37 39 35 32 20 42 61 64  20 42 75 63 68 61 75 20  |7952 Bad Buchau |
000097e0  20 20 20 20 20 20 20 20  20 20 20 20 57 2d 37 39  |            W-79|
000097f0  35 33 20 4f 74 74 65 72  73 77 61 6e 67 0a 0a 20  |53 Otterswang.. |
00009800  20 20 20 20 20 20 20 20  20 47 65 72 6d 61 6e 79  |         Germany|
00009810  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00009820  20 20 20 20 20 20 20 47  65 72 6d 61 6e 79 0a 0a  |       Germany..|
00009830  0a 0a 41 73 20 20 79 6f  75 20 20 73 65 65 2c 20  |..As  you  see, |
00009840  20 77 65 27 72 65 20 20  28 75 6e 66 6f 72 74 75  | we're  (unfortu|
00009850  6e 61 74 65 6c 79 29 20  6e 6f 20 65 6e 67 6c 69  |nately) no engli|
00009860  73 68 20 6d 65 6e 20 61  6e 64 20 73 6f 20 20 77  |sh men and so  w|
00009870  65 20 20 68 6f 70 65 20  20 79 6f 75 20 0a 75 6e  |e  hope  you .un|
00009880  64 65 72 73 74 61 6e 64  20 20 6f 75 72 20 74 65  |derstand  our te|
00009890  72 72 69 62 6c 65 20 45  6e 67 6c 69 73 68 20 69  |rrible English i|
000098a0  6e 20 74 68 69 73 20 74  65 78 74 2e 20 20 41 6c  |n this text.  Al|
000098b0  77 61 79 73 20 72 65 6d  65 6d 62 65 72 3a 20 20  |ways remember:  |
000098c0  41 20 20 68 75 6d 61 6e  20 0a 73 68 6f 75 6c 64  |A  human .should|
000098d0  20 61 74 20 6c 65 61 73  74 20 6c 61 75 67 68 20  | at least laugh |
000098e0  74 68 72 65 65 20 74 69  6d 65 73 20 61 20 64 61  |three times a da|
000098f0  79 20 2d 20 74 68 69 73  20 66 69 6c 65 20 67 69  |y - this file gi|
00009900  76 65 73 20 74 68 65 20  69 6d 70 75 6c 73 65 2e  |ves the impulse.|
00009910  2e 2e 0a 0a 0a 0a 20 20  20 20 20 20 20 20 20 20  |......          |
00009920  20 20 20 20 20 20 20 20  57 72 69 74 74 65 6e 20  |        Written |
00009930  62 79 20 45 64 75 61 72  64 20 50 66 61 72 72 20  |by Eduard Pfarr |
00009940  26 20 54 68 6f 6d 61 73  20 41 6c 62 65 72 0a 20  |& Thomas Alber. |
00009950  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00009960  20 20 20 20 20 20 20 28  63 29 20 4a 75 6c 79 20  |       (c) July |
00009970  31 39 39 30 20 62 79 20  50 6c 61 79 66 69 65 6c  |1990 by Playfiel|
00009980  64 0a 0a                                          |d..|
00009983

Our privacy policy is here.
Last updated: 01 May 2025, 21:49 UTC
Website designed by .