@database "Soundy"


Copyright (c) 1991,92,93,94 Antanisoft Group Research
All Rights Reserved



@master "Soundy.guide"

@Remark $VER: soundy.guide 3.1 (25.04.94)
@Remark AmigaGuide document for Soundy

##
## Main
##
@Node Main "Soundy.guide"

@Width 72
                           @{b}Soundy v3.1 Demoversion@{ub}

               Copyright © 1991-1994 Antanisoft Group Research

     You may make and distribute verbatim copies of this documentation if
  the contents are unchanged or the author has agreed to any changes made.

     No guarantee of any kind is given that the program described in this
  document is 100% reliable. You are using this material on your own risk.

 @{" Copyright notice " Link "Copyright_notice"}         @{i}Legal information@{ui}
 @{" Technical info   " Link "Technical_info"}         @{i}Technical information@{ui}
 @{" Introduction     " Link "Introduction"}         @{i}Quick overview@{ui}
 @{" Features         " Link "Features"}         @{i}Complete list of program features@{ui}
 @{" Background       " Link "Background"}         @{i}Why was Soundy created?@{ui}
 @{" Requirements     " Link "Requirements"}         @{i}What you need to use Soundy@{ui}
 @{" Package contents " Link "Package_contents"}         @{i}Description of package contents@{ui}
 @{" Starting Soundy  " Link "Starting_soundy"}         @{i}The first time@{ui}
 @{" Using Soundy     " Link "Using_soundy"}         @{i}The program explanation@{ui}
 @{" To do            " Link "To_do"}         @{i}Things to do in future versions@{ui}
 @{" Revision history " Link "Revision_history"}         @{i}List of changes & enhancements@{ui}
 @{" Reporting bugs   " Link "Reporting_bugs"}         @{i}How to report program bugs@{ui}
 @{" Addresses        " Link "Addresses"}         @{i}How to contact the author@{ui}
 @{" Acknowledgements " Link "Acknowledgements"}         @{i}Who was involved in the creation of Soundy?@{ui}
 @{" Hints            " Link "Hints"}         @{i}Hints about samples@{ui}
 @{" Notes            " Link "Notes"}         @{i}The author speaks@{ui}
 @{" IMPORTANT!       " Link "Important"}         @{i}Important information@{ui}
 @{" Order form       " Link "Orderform"}         @{i}How to obtain a registered copy of Soundy@{ui}
 @{" Restrictions     " Link "Restrictions"}         @{i}Demo version restrictions@{ui}

@EndNode

##
## Order Form
##
@Node "Orderform"

	@{b}@{u}Order Form@{ub}@{uu}

	Below  is  a  register  page which you can print out on your
	printer, and fill out, and after that send it to me.





	REGISTRATION
	------------


	TO

	Antanisoft Group Research
	by Stefano Coletta

	P.le del Caravaggio n.6
	00147 Rome
	Italy





	I  would  like  to  register  my version of Soundy, and have
	included $40 , as cash.



	COMPANY:____________________________________________________


	NAME:_______________________________________________________


	ADDRESS:____________________________________________________


	CITY:______________________________ COUNTRY:________________


	PHONE NUMBER:_______________________________________________
	(REMEMBER INTERNATIONAL CODE)


	COMPUTER TYPE:______________________________________________


	EXTRA EQUIPMENT:____________________________________________




	OTHER INFORMATION YOU WANT US TO KNOW:

	____________________________________________________________

	____________________________________________________________

	____________________________________________________________

	____________________________________________________________



	DATE                  Signature



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



@EndNode

##
## Restrictions
##
@Node "Restrictions"

	@{b}@{u}Demo version restrictions@{ub}@{uu}

	This is a list of what you can't do on Soundy v3.1 demoversion.

	· You can't load samples larger than 100kbytes

	· You can't load modules larger than 100kbytes

	· You can't synchronize more than 2 samples per time

	· You can't play more than two samples per time

	· You can't enlarge the samples' list range to all samples

@EndNode

##
## Using Soundy
##
@Node "Using_soundy"

	@{b}@{u}Using Soundy@{ub}@{uu}

	@{" Menus            " Link "Using_menus"}     @{i}Menu items explanation@{ui}
	@{" Keyboard control " Link "Using_keyboard_control"}     @{i}Keys explanation@{ui}
	@{" Control panels   " Link "Using_control_panels"}     @{i}Screen panels explanation@{ui}
	@{" Scripts          " Link "Using_scripts"}     @{i}Scripting explanation@{ui}

	@{" Loading samples  " Link "Using_loading"}     @{i}Notes on loading samples@{ui}
	@{" Compression      " Link "Using_compression"}     @{i}Supported compression algorithms@{ui}
	@{" File types       " Link "Using_filetypes"}     @{i}Supported file types@{ui}
	@{" Special cable    " Link "Using_special_cable"}     @{i}To have best audio results@{ui}
	@{" Playmodes        " Link "Using_playmodes"}     @{i}Verbose description of playmodes@{ui}
	@{" Keypad           " Link "Using_keypad"}     @{i}Keypad as keyboard@{ui}

@EndNode

##
## Loading samples
##
@Node "Using_loading"

	@{b}@{u}Loading samples@{ub}@{uu}

	To  load samples in memory click on the corresponding sample
	gadget and select it with the file requester.

	A maximum of 20 samples of any size can be loaded. 

	You  can select up to 20 samples per time.  NOTE:  after the
	20th  sample the 21th will be loaded on the 1st, the 22th on
	the 2nd, and so on.

	Samples  will  be loaded from the sample gadget you selected
	onwards.

	Note:   if  a  playing-sample  is encountered the next files
	will not be loaded and you will be signed of this event.

	Loading  routine  will  load  samples giving priority to the
	FastMem to avoid ChipMem shortages.

	Actually are supported both the IFF standard that RAW files.

@EndNode

##
## Control panels
##
@Node "Using_control_panels"

	@{b}@{u}Control panels@{ub}@{uu}

	Here   is  a  complete  explanation  of  all  screen  panels
	relatives to the screen gadgets' and the other stuffs.

	@{" Load mode        " Link "Using_panels_load_mode"}     @{i}Loading defaults panel@{ui}
	@{" Module           " Link "Using_panels_module"}     @{i}Module functions panel@{ui}
	@{" Sequence         " Link "Using_panels_sequence"}     @{i}Sequences functions panel@{ui}
	@{" Touch            " Link "Using_panels_touch"}     @{i}Touch regulations panel@{ui}
	@{" Pitch            " Link "Using_panels_pitch"}     @{i}Pitch functions panel@{ui}
	@{" Misc             " Link "Using_panels_misc"}     @{i}Miscellaneous functions panel@{ui}
	@{" Other controls   " Link "Using_panels_other"}     @{i}Other window stuffs@{ui}

@EndNode

##
## Other Controls
##
@Node "Using_panels_other"

	@{b}@{u}Other controls@{ub}@{uu}

	There  are  several  controls  that  are  not  included with
	panels, they are:

	· @{b}Master Volume@{ub}

	  A  slider  gadget  that  controls  the  master  volume.  All
	  samples volumes depends from this slider.

	· @{b}Volume sliders@{ub}

	  One volume slider for each sample is available to change the
	  sample  volume.   Range  of  this  slider  depends on master
	  volume value.

	· @{b}Status bar@{ub}

	  To  the left bottom side of the screen, is the actual status
	  of  the  program.   Useful  to  know  the  actual  status of
	  operations & activities.

	· @{b}Channels status@{ub}

	  A  graphical  tool  to  see  what  channels are used in that
	  moment.

	· @{b}Pitch bar@{ub}

	  A graphical pitch display of the selected sample.

	· @{b}Samples' name@{ub}

	  In  addition  to  the  up  and  down cursor use the mouse to
	  select the desired sample.

	· @{b}Status panel@{ub}

	  A  little  window to display most important variables of the
	  program.

	  From top to bottom:

	  - Module:

	    Current loaded module name.

	  - SList:

	    Current active samples' list name.

	  - Filter:

	    Current status of the low pass filter.

	  - Memory:

	    Current amount of total free memory.

	  - Pitch:

	    Selected  sample  pitch  value  with  specification of which
	    sample has been selected.

	· @{b}Selecting samples by clicking them@{ub}



@EndNode

##
## Misc Panel
##
@Node "Using_panels_misc"

	@{b}@{u}Misc Panel@{ub}@{uu}

	· @{b}[FILTER]@{ub}

	  This gadget switches on/off the low pass filter or better to
	  say, the POWER LED.

	· @{b}[BACKW]@{ub}

	  To  reverse  the  sample  is  the  function  of this gadget.
	  Reversing will be done on the selected sample.

	· @{b}[FADE]@{ub}

	  This  function  is  used  in  conjuction  with  other screen
	  gadgets.  So this brief explanation is not sufficient to use
	  it.  By pressing here you will activate the auto-fading of a
	  sample, the selected one.

	  Other parameters are necessary to fade a sample; look at the
	  right  side  of  the selected sample name, you will notice a
	  number.   This  number  is  a delay between each step of the
	  sample  volume  slider.   Increase  it and the sample fading
	  will  be  more slow.  As same as increasing, decreasing will
	  make  the  fading  more  fast.   This 'speed number' must be
	  included between 0 and 999.

	  Another  parameter  in necessary to perform the auto-fading;
	  the  direction of fading.  To the right side of our previous
	  number  there  is  a cycle gadget specifing the direction of
	  the fading.

	  Simply  to  use,  it  can assume only two values:  UP n' DN.
	  Obviously  the  first  is  to fade volume from silent to the
	  current  value  and the other is to fade volume from current
	  value to silent.

	  NOTE:   The  auto-fading function works asyncronously giving
	  you  the  possibility to perform all program actions without
	  taking care of it.

	· @{b}[SYNCH]@{ub}

	  This  is one of the best functions of Soundy.  It is able to
	  synchronize  samples  between  them  without losing precious
	  time to do the same work by hand.

	  Samples  are  different and this function will not work 100%
	  of  times.   Do not use it when performing on parties!  It's
	  useful when you are organizing samples to try new effects or
	  mixes. 

	  Samples are synchronized with this procedure:

	  Can  be  multiple  destination  samples but only one source.
	  Result  of  operation  will  be that all destination samples
	  will be synchronized with the source.

	  Example of operation:

	  1) Load at minimum 2 samples

	  2) Click on the [SYNCH] gadget

	  3) Now click on the first sample just loaded (operate on the
	     name of the sample). This will set the source pitch  that
	     will  synchronize  the  pitch  of  the  second sample  to
	     the rate of the first

	  4) Click on the second sample

	  5) Click another time on the [SYNCH] gadget

	  Now the samples are synchronized to the same speed

	  NOTE:  Only the destination sample pitch will be changed

	  To  synchronize  more  samples click more of one destination
	  and follow the same procedure.


	  IF YOU WRONG SOMETHING:

	  By   clicking   on  samples  previously  selected  you  will
	  deactivate them; useful to correct your selection mistakes.

	  HINT:

	  If  you  are synchronizing rhytmics samples you must cut the
	  beginning of the samples to the beat that starts the sample.
	  Doing  so  you  can  be  sure  of  an  excellent  result  of
	  synchronizement.   Demo  samples  provided  with  Soundy are
	  cutted with this method.

	· @{b}[FREE]@{ub}

	  Picking  this  gadget you will free from memory the selected
	  sample.

@EndNode

##
## Pitch Panel
##
@Node "Using_panels_pitch"

	@{b}@{u}Pitch Panel@{ub}@{uu}

	· @{b}[BENDER]@{ub}

	  This  gadget  activates  a function to bend the sample pitch
	  with  mouse.   Once pressed the gadget you may move mouse up
	  n' down to change the pitch value.  A status bar will report
	  in  realtime  the sample pitch.  This function simulates the
	  bender joystick of all common keyboards.  To deactivate this
	  function hit one of the ALT keys.  NOTE:  Mouse pointer will
	  disappear  when bending sample.  Also note that you can play
	  any other sample while bending.

	· @{b}[BT :2]@{ub}

	  This function halves the sample beats (acts on pitch value)

	· @{b}[BT x2]@{ub}

	  This function double the sample beats (acts on pitch value)

	· @{b}[DEF]@{ub}

	  By  pressing  this  gadget you will reset pitch value to the
	  first time loaded value.

@EndNode

##
## Smps' List Panel
##
@Node "Using_panels_smps_list"

	@{b}@{u}Smps' List Panel@{ub}@{uu}

	· @{b}[SELECT]@{ub}

	  This  gadget  will  pop  up  a  file requester to choose the
	  samples'  list  to  activate.  Remember to put the string of
	  recognization  of  the samples' list otherwise an error will
	  occur.

	· @{b}[NEXT BANK]@{ub}

	  Clicking  on this gadget the samples' list will advance from
	  the  previous  STOP  command.  NOTE:  If a playing sample is
	  encountered  the  samples'list  will stop loading.  Once you
	  press again this gadget, loading will advance from here, not
	  from the previous or the next STOP command.

	· @{b}[OFF]@{ub}

	  This gadget deactivates the samples' list currently active.

	· @{b}[RANGE]@{ub}

	  This gadget allows to change current  sample's  list
	  range displaying a nice requester.  For  more  infos
	  about samples' list ranges refer to the @{" scripting " Link "Using_scripts"}
	  section.

@EndNode

##
## Touch Panel
##
@Node "Using_panels_touch"

	@{b}@{u}Touch Panel@{ub}@{uu}

	· @{b}[SLIDER D]@{ub}

	  By  changing  this  slider  you can set the delay before the
	  auto-restart-function takes place.

	  Range from 1 to 99 (a value of 50 is equal to 1 second)

	· @{b}[SLIDER R]@{ub}

	  By  changing  this slider you can set the delay between each
	  repetition of the auto-restart-function.

	  Range from 1 to 99 (a value of 50 is equal to 1 second)

	· @{b}[SLIDER A]@{ub}

	  By  changing this slider you can adjust the [SLIDER R] value
	  to a fine value.

	  Range from 0 to 99 (adjustment only)


	From  the left to the right are represented the three values
	of the three sliders respectively from the top to the bottom
	of the panel.


	Purpose:

	This  effect  is  the  main  feature  of  many  professional
	samplers.   By pressing the corresponding keypad '[' and ']'
	keys  you will notice that between each sample restart there
	is  no  silence.   So,  the  purpose  of this function is to
	eliminate  the  sound  lack  between  repetitions.   Another
	important  feature  of this function is to repeat the sample
	with a certain repeat rate; this, if you let the key pressed
	a  bit.   Do  not spent your time to do it by hand, pressing
	and releasing keys rithmically!


@EndNode

##
## Module Panel
##
@Node "Using_panels_module"

	@{b}@{u}Module Panel@{ub}@{uu}

	· @{b}[LOAD]@{ub}

	  This  gadget  will  pop  up  a  file requester to choose the
	  pro-tracker  module  to  load.   Be careful to what you have
	  selected!   Soundy  is  not  able  to  recognize if what you
	  selected is a pro-tracker module or not!  So I not guarantee
	  the  system functionality if you select PLAY with that piece
	  of file!

	· @{b}[FREE]@{ub}

	  Frees   the   current   module   from   memory   asking  for
	  confirmation.

	· @{b}[PLAY]@{ub}

	  Starts playing module in memory.

	  Note:  samples that were in playing will immediately go back
	  to  their  playing  status  after  you  click  on the [STOP]
	  gadget.

	· @{b}[STOP]@{ub}

	  Stops playing module in memory.

@EndNode

##
## Load Mode Panel
##
@Node "Using_panels_load_mode"

	@{b}@{u}Load Mode Panel@{ub}@{uu}

	The  first  cycle  gadget  is the default load mode.  It can
	assume these values:

	· @{b}[LOOP]@{ub}

	  Used to play the sample infinitely

	· @{b}[SINGLE]@{ub}

	  Used to play the sample one time

	· @{b}[TWICE]@{ub}

	  Used to play the sample two times

	· @{b}[TRIPLE]@{ub}

	  Used to play the sample three times

	Usually more than three times looping does not need.


	The  second  cycle  gadget  is the default play mode.  It can
	assume these values:

	· @{b}[MONO]@{ub}

	  Refer to @{" playmodes " Link "Using_playmodes"} section.

	· @{b}[STEREO]@{ub}

	  Refer to @{" playmodes " Link "Using_playmodes"} section.

	· @{b}[FLANGE]@{ub}

	  Refer to @{" playmodes " Link "Using_playmodes"} section.


	The  third   cycle  gadget  is the default file type.  It can
	assume these values:

	· @{b}[AUTO]@{ub}

	  This   flag   will   activate   the  auto-sample-recognition
	  function.   Soundy  will  automatically detect which type of
	  loading method is required to read selected samples.

	  NOTE:   Raw  samples  cannot  be  auto-recognized so set the
	  cycle gadget to the specified RAW sample type.

	· @{b}[IFF8]@{ub}

	  Refer to @{" filetypes " Link "Using_filetypes"} section.

	· @{b}[RAW8]@{ub}

	  Refer to @{" filetypes " Link "Using_filetypes"} section.

	· @{b}[RAW16]@{ub}

	  Refer to @{" filetypes " Link "Using_filetypes"} section.

	· @{b}[VOC]@{ub}

	  Refer to @{" filetypes " Link "Using_filetypes"} section.

@EndNode

##
## Keypad
##
@Node "Using_keypad"

	@{b}@{u}Keypad as keyboard@{ub}@{uu}

	Numeric  pad  is  provided  with  9  keys  relative  to nine
	numbers,  this,  excluding the 0 key.  Now, think to have on
	the  fifth key the selected sample at the actual pitch rate.
	From  this, onward & backward, think to have the same sample
	with  different pitches...  but how much different?  Easy to
	say,  previous  pitch  value  plus or minus the KEYPAD_RANGE
	value.   The  pitch  value you are playing on that sample is
	the result of this formula:

	New_Pitch = Def_Pitch + [ ( Keypad_Key_Value - 5 ) * (-10) ]

	Example:

	Actual pitch: 147
	Keypad range: 10

	By pressing keypad keys you will have this result:

	Key | Pitch
	----|------
	1   | 187
	2   | 177
	3   | 167
	4   | 157
	5   | 147
	6   | 137
	7   | 127
	8   | 117
	9   | 107

	You  can  alter the KEYPAD_RANGE using the menu item "Keypad
	range..."  described  in the @{" menus " Link "Using_menus"} section.

@EndNode

##
## Filetypes
##
@Node "Using_filetypes"

	@{b}@{u}Supported file types@{ub}@{uu}

	Soundy  handles  different  types  of  samples, let's see in
	detail:

	· @{b}IFF8@{ub}

	  This  is  the  more  diffused  samples'  standard around the
	  Amiga's  world.   Any  Amiga program that uses audio handles
	  this standard.

	· @{b}RAW8@{ub}

	  This  is  a  RAW  format,  and  as  raw  format  it can't be
	  classified.   To  restrict  the  group of raw formats we can
	  classify  it  as  an IFF8 sample without the IFF information
	  header.

	  NOTE:

	  On  RAW  samples  playing speed can't be known, so a default
	  speed is assumed to be correct.

	· @{b}RAW16@{ub}

	  This  is  another  RAW format, and as raw format it can't be
	  classified.   To  restrict  the  group of raw formats we can
	  classify  it  as an IFF16 sample without the IFF information
	  header.    These  files  can  be  produced  by  professional
	  keyboards or by sophisticated 16 bit audio-cards.

	· @{b}VOC@{ub}

	  This   is   the   standard  file  format  of  Sound  Blaster
	  soundfiles.    These  files  are  diffused  on  the  IBM  PC
	  computers.

@EndNode

##
## Using Menus
##
@Node "Using_menus"

	@{b}@{u}Using Menus@{ub}@{uu}

	Here are explained all menus functions:

	@{u}@{i}Project menu@{ui}@{uu}

	· @{b}Reset all@{ub}

		With  this  option Soundy will reset his settings to
		default values.

	· @{b}Open Workbench@{ub}

		With this option you can open your Workbench screen.

	· @{b}Close Workbench@{ub}

		With this option you can close your Workbench screen
		to save some memory.

	· @{b}About@{ub}

		This  option  displays  the  information  about  the
		authors of the program itself.

	· @{b}Quit@{ub}

		Acting on this option you  will  exit  from  Soundy.
		A confirm must be done  for  this  DANGEROUS option!


	@{u}@{i}Miscellaneous menu@{ui}@{uu}

	· @{b}Change Palette@{ub}

		You don't like  colors  we've  choosed  for  Soundy?
		Change them with this function!

	· @{b}Flange Range@{ub}

		This option allows to change  current  flange  range
		displaying  a   nice   requester.   For  more  infos
		about the  flange range  refer  to  the @{" playmodes " Link "Using_playmodes"}
		section.

	· @{b}Keypad Range@{ub}

		This option allows to change  current  keypad  range
		displaying  a   nice   requester.   For  more  infos
		about  the  keypad  range  refer  to  the  @{" keypad " Link "Using_keypad"}
		section.

	· @{b}Clear all samples@{ub}

		This   option  allows  to  delete  all  samples  in
		one shot. Playing samples will be skipped.

@EndNode

##
## Playmodes
##
@Node "Using_playmodes"

	@{b}@{u}Playmodes@{ub}@{uu}

	Soundy  has  different  ways  to  play samples, let's see in
	detail:

	· @{b}MONO@{ub}

	  This playmode will play a maximum of four samples per time.

	  NOTE:

	  With  this playmode you have need of the @{" special cable " Link "Using_special_cable"} to
	  make  your  Amiga able to play always on both audiochannels.
	  If  you haven't  the cable installed  you will listen to the
	  samples on a single audiochannel.

	· @{b}STEREO@{ub}

	  This  playmode  will  play a maximum of two samples per time
	  placing  them  in  a manner that the Amiga will play them in
	  stereo.

	  NOTE:

	  With  this playmode you have no need of the @{" special cable " Link "Using_special_cable"}
	  to  make  your   Amiga   able   to   play   always  on  both
	  audiochannels. If  you  have  the  cable  installed you will
	  listen to the samples at twice volume.

	· @{b}FLANGE@{ub}

	  This  playmode  will  play a maximum of two samples per time
	  placing  them in a manner that the Amiga will play them with
	  a flange effect.

	  NOTE:

	  This  playmode  requires a value to be set.  This value will
	  determine  the  flange  depth of the sample.  You can set it
	  automatically  with  the  samples'  list  or  with  the item
	  "Flange Range" placed on the "Miscellaneous" menu.

	  Principle of operation:

	  To  create  the  flange  effect Soundy plays a sample on two
	  audiochannels  with  a  "Range".   This "Range" it's a pause
	  that  Soundy  waits  before to play the 2nd time the sample;
	  the  same  sample  that  was  started to the pression of the
	  corrisponding key.

@EndNode

##
## Keyboard control
##
@Node "Using_keyboard_control"

	@{b}@{u}Keyboard control@{ub}@{uu}

	A  lot  of  key  shortcuts are available on Soundy; starting
	from  menu shortcuts that are displayed on the right side of
	each  menu item to arrive to the gadget ones that are signed
	with a line under the gadget shortcut letter.

	Special keys not reported on the screen are documented here:

	SPACEBAR  - Switches the current sample volume between 0 and
	            his max.

	ARROWS    - With Up/Dn arrows you can  select  samples  that
	            will be used successively for other  operations.

	            With Rg/Lf arrows you can do a  fine  regulation
	            to the sample pitch.

	DEL       - Same function of [DEF] gadget.

	ALTs      - Same function of [BENDER] gadget.

	SHIFTes   - Are used to select multiple files  on  the  file
	            requester.

	BACKSPACE - Same function of [FREE] gadget.

	KEYPAD '+'- Same function of [BT x2] gadget

	KEYPAD '-'- Same function of [BT :2] gadget

	KEYPAD '['- Used in conjuction with the Touch panel

	KEYPAD ']'- Used in conjuction with the Touch panel

	            Last two key are used to act on the sample start.
	            Their function is the same but two keys are used
	            to be more finger friendly.

	KEYPAD '/'- Used to stop the sample in conjuction with the
	            Touch effect

	NUM. PAD  - All numeric pad keys are used to form a little
	            keyboard with 9 pitches of the sample sample

	NOTE:

	With  the  word  'selected'  we  mean  the sample that has a
	light-blue color.

@EndNode

##
## Using a Special Cable
##
@Node "Using_special_cable"

	@{b}@{u}Using a Special Cable@{ub}@{uu}

	The  maximum  of  contemporary Amiga sounds is four, this is
	what  we know for a long time.  We know too that Amiga plays
	sounds  on  the left or the right audio channel according to
	the  selected  channel.  Now the problem is how to remedy to
	this  "audio  trouble";  For  instance you can't listen to a
	sound  on  a  single  channel!  This is because I define the
	Amiga stereo feature as a fake!

	Note  now  that Soundy will play samples randomly so...  eg:
	a  sample  may  be  played  on  the  first channel as on the
	fourth.   So connect to your external Amiga audio channels a
	little trick!


	  Left AudioCh  Right AudioCh    (Rear Amiga panel)
	------+   +---------+   +-----------------------------------
	      |   |         |   |
	      |___|         |___|
	                            <- Here connect two jacks
	     |     |       |     |
	      \   /         \   /
	       \ /           \ /
	       | |           | |
	       . .           . .
	       . .           . .    <- Make the audio cables
	
	       | |           | |
	       | |___________| |
	       |               |
	       |  ___________  |    <- Here connect the cables
	       | |           | |       together
	       | |           | |
	       . .           . .
	       . .           . .    <- Make the audio cables
	
	       | |           | |
	       / \           / \
	      /   \         /   \   <- Here connect the other jacks
	     |     |       |     |     with your amplifier


	Doing  so  your  Amiga will pass from STEREO to MONO but the
	sample  you  play  from  Soundy  will  always  stay  on both
	channels!

@EndNode

##
## Scripting
##
@Node "Using_scripts"

	@{b}@{u}Scripts@{uu} (Called 'Samples' List')@{ub}

	@{i}What is a samples' list script?@{ui}

	It's  a  text file containing a list of samples to be loaded
	in  a  certain  order  and  time.  From previous versions of
	Soundy,  samples'  lists  were  equipped with a brief set of
	commands, now Soundy can be totally controlled by the script
	to give you the maximum confort and security of operation.

	An  example  script is provided into the Soundy package.  It
	will  be  in  the <OWN>:Soundy/Samples directory if you have
	previously choosed the complete installation option from the
	Installer.

	Once  you  have  activated  the  samples'  list,  it will be
	completely     indipendant     from     your    work.     To
	activate/deactivate  the  samples'  list refer to the panels
	explanation.


	@{i}How to do a samples' list file@{ui}

	First of all you must put in the first line of samples' list
	this string:

	---- cut here   cut here   cut here   cut here ----
	ANTANISOFT GROUP RESEARCH SAMPLES LIST
	---- cut here   cut here   cut here   cut here ----

	If you forget to do it, your samples' list will never work!

	NOTE: Commands may have comments to the end of line; use the
	      ";" character to specify where the comment is starting
	      from.

	This  is  the  complete  command list.  Remember to put each
	command on a single line:

	· @{b}STOP@{ub}

	  Will  stop  loading  samples  until  the  NextBank gadget is
	  pressed.

	· @{b}REVERSE@{ub}

	  Will reverse next sample listed on the samples' list.

	· @{b}PITCHON <pos>@{ub}

	  Will  set  to  the position <pos> or to the position of next
	  sample  (this  if  the  keyword  "ACTUAL"  is specified) the
	  light-blu selector.

	· @{b}FLANGERANGE <rng>@{ub}

	  Will  change the current flange range to the specified value
	  <rng>.

	· @{b}KEYPADRANGE <rng>@{ub}

	  Will  change the current keypad range to the specified value
	  <rng>.

	· @{b}RESETALL@{ub}

	  Will reset all to defaults.

	· @{b}SLISTRANGE <rng>@{ub}

	  Will change the current samples' list range to the specified
	  value  <rng>.   This  command is useful when you have memory
	  shortages.   You can limit the samples' list loop loading of
	  samples to a more restricted number.

	· @{b}MASTERVOLUME <vol>@{ub}

	  Will change the current master volume to the specified value
	  <vol>.

	· @{b}DEFLOAD <mode>@{ub}

	  Will  change the current loading mode to one of these modes:
	  LOOP, SINGLE, TWICE, TRIPLE

	· @{b}DEFPLAY <mode>@{ub}

	  Will  change  the  current  play mode to one of these modes:
	  MONO, FLANGE, STEREO

	· @{b}DEFTYPE <type>@{ub}

	  Will  change the current file type load mode to one of these
	  modes:  AUTO, IFF8, RAW8, RAW16, VOC

	· @{b}COMMENT <string>@{ub}

	  Will  add  the  comment  string <string> to the name of next
	  sample.

	  NOTE: Remember to use the '_' character instead of spaces!

	· @{b}CHANGETOUCH <delay>,<rate>,<adj>@{ub}

	  Will  change the current Touch values to <delay>, <rate> and
	  <adj>.

	  NOTE:   Instead  of values you can specify a SKIP keyword to
	  left them unchanged.

	  Eg.   CHANGETOUCH 15,SKIP,SKIP will set the <delay> value to
	  15 and will left unchanged the <rate> and <adj> values.

	· @{b}CHANGEDIR <dir>@{ub}

	  Will change the current directory to the directory <dir>.

	· @{b}REMOVE <sample>@{ub}

	  Will delete the sample <sample> from memory.

	· @{b}REMOVEALL @{ub}

	  Will delete all samples from memory.

	· @{b}CHANGEPITCH <buffer> <pitch> @{ub}

	  Will  change  the  <buffer>  period  to  the  <pitch> value.
	  <buffer>  ranges  from  1 to 20 and <pitch> ranges from 1 to
	  1056.

	· @{b}CHANGEVOLUME <buffer> <vol> @{ub}

	  Will  change  the  <buffer>   volume  to  the  <vol>  value.
	  <buffer> ranges  from 1 to 20 and <vol> ranges from 0 to 63.

	· @{b}CHANGEFADETIME <buffer> <time> @{ub}

	  Will  change  the <buffer> fade time  to  the  <time> value.
	  <buffer> ranges from 1 to 20 and <time> ranges from 0 to 999.

	· @{b}CHANGEFADEDIR <buffer> <switch> @{ub}

	  Will  change  the  <buffer>  fade direction to the specified
	  <switch>.   <switch>  can  assume  UP or DOWN to specify the
	  correct direction.

	· @{b}CHANGEPLAYMODE <buffer> <mode> @{ub}

	  Will change the <buffer> play times to the specified <mode>.
	  <mode> can assume SINGLE, TWICE, TRIPLE or LOOP.

	@{i}The sample name@{ui}

	In  addition  to the simple sample name to load, you can add
	several parameters.

	NOTE:   If  you  specify  parameters  you  must  specify all
	        parameters together else none parameter.

	Parameters are:

	· Volume

	· Pitch, or DEF if you want the default sample's pitch

	· Loadmode; one of the following: LOOP, SINGLE, TWICE, TRIPLE

	· Fadetime; a value from 0 to 999 (refer to the gadget docs)

	· Fademode; choose between UP or DOWN


	With no parameters the sample will be loaded with:

	· Volume to 63

	· Default sample's pitch

	· Default loadmode

	· Fadetime equal to 0

	· Fademode equal to DOWN

@EndNode

##
## Hints
##
@Node "Hints"

	@{b}@{u}Hints@{ub}@{uu}

	To have best results with Soundy at your party, if you chose
	to  have one, is to assemble the special cable connecting it
	outside Amiga audio channels.

	Do not spent your time to make high quality samples when you
	use  Soundy  in your private parties!  'cause the quality of
	sounds  will  not be appreciated from an high power speaker,
	so  reserve memory for a greatest quantity of samples (this,
	if your party has disco music!).

	A  good  suggestion  is  to  sample  at  high frequency (eg.
	25.5khz)   that  samples  that  represents  classic  musics,
	choirs, singers or not rythmic music.

@EndNode

##
## Notes
##
@Node "Notes"

	@{b}@{u}Notes@{ub}@{uu}

	After  releasing  version 3.0 I will be busy with university
	so  new  versions  of Soundy will be rarely released.  So if
	you want an upgrade or some bug fix version you must wait!

	Thank you in advance for all your patience!

@EndNode

##
## Copyright notice
##
@Node "Copyright_notice"

	@{b}@{u}Copyright notice@{ub}@{uu}

	Reproduction  or  publication  of the content in any manner,
	without  the  express  written  consent of the publisher, is
	prohibited.  No liability is assumed with respect to the use
	of the information herein.

	The   Soundy  v3.1  software  is  copyrighted  1991-1994  by
	Antanisoft  Group  Research.   In  versions  prior to 3.0 of
	Soundy,  permission  was granted to distribute copies of the
	software for non-commercial use.  This policy does not apply
	to Soundy 3.1 and later versions.  Soundy v3.1 may be copied
	for archival purposes only.

@EndNode

##
## Starting Soundy
##
@Node "Starting_soundy"

	@{b}@{u}Starting Soundy@{ub}@{uu}

	You  can  run Soundy from either the Shell or the Workbench.

	To start Soundy from the Shell you must type the following:

	1> Soundy

 
	To  start  Soundy from the Workbench you should double-click
	it's icon.

	After a successfull start you are presented with a screen on
	which  a  little  window  is  displayed.  This window is the
	"about"  on  which  are  placed  infos  about the authors of
	Soundy.

	NOTE: Tooltypes not implemented in this version.

@EndNode

##
## Package Contents
##
@Node "Package_contents"

	@{b}@{u}Package contents@{ub}@{uu}

	@{i}Installation disk #1 contents:@{ui}

	     Xpk Utilities (dir)
	       xDir                             xDir.doc
	       xDir.doc.info                    xPack
	       xPack.doc                        xPack.doc.info
	       xPack.dok                        xPack.dok.info
	       xpk                              xPK.doc
	       xPK.doc.info                     xQuery
	       xQuery.doc                       xQuery.doc.info
	       xup                              xUP.doc
	       xUP.doc.info                     
	     libs (dir)
	          compressors (dir)
	            xpkBLZW.library                  xpkCBR0.library
	            xpkDLTA.library                  xpkENCO.library
	            xpkFAST.library                  xpkFEAL.library
	            xpkHFMN.library                  xpkHUFF.library
	            xpkIDEA.library                  xpkIMPL.library
	            xpkNONE.library                  xpkNUKE.library
	            xpkRDCN.library                  xpkRLEN.library
	            xpkSHRI.library                  xpkSMPL.library
	            xpkSQSH.library                  
	       amigaguide.library_2.0           amigaguide.library_3.0
	       gadtools.library_2.0             gadtools.library_3.0
	       powerpacker.library              reqtools.library_2.0
	       reqtools.library_3.0             string.library
	       xpkmaster.library                
	     Packers (dir)
	          xDrop (dir)
	            xDrop                            xDrop.doc
	            xDrop.doc.info                   xDrop.dok
	            xDrop.dok.info                   xDrop.info
	          PPack (dir)
	            PPack                            PPack.guide
	            PPack.guide.info                 
	       PPack.info                       xDrop.info
	     Prefs (dir)
	       ReqTools                         ReqTools.doc
	       ReqTools.doc.info                ReqTools.info
	     s (dir)
	       help.guide                       
	     Xpk Documents (dir)
	       BLZW.doc                         BLZW.doc.info
	       CBR0.doc                         CBR0.doc.info
	       DLTA.doc                         DLTA.doc.info
	       FAST.doc                         FAST.doc.info
	       FEAL.doc                         FEAL.doc.info
	       HFMN.doc                         HFMN.doc.info
	       HUFF.doc                         HUFF.doc.info
	       IDEA.doc                         IDEA.doc.info
	       IMPL.doc                         IMPL.doc.info
	       NUKE.doc                         NUKE.doc.info
	       Philosophy.doc                   Philosophy.doc.info
	       RDCN.doc                         RDCN.doc.info
	       SHRI.doc                         SHRI.doc.info
	       SMPL.doc                         SMPL.doc.info
	       SQSH.doc                         SQSH.doc.info
	  AmigaGuide                       AmigaGuide.info
	  Disk.info                        Install Soundy
	  Install Soundy.info              Installer
	  More                             Packers.info
	  Prefs.info                       Soundy
	  Soundy.guide                     Soundy.guide.info
	  Soundy.info                      Xpk Documents.info
	  Xpk Utilities.info               

	@{i}Installation disk #2 contents:@{ui}

	     Samples (dir)
	       Demo.LST                         Demo.readme
	       Demo.readme.info                 Smp-1
	       Smp-10                           Smp-2
	       Smp-3                            Smp-4
	       Smp-5                            Smp-6
	       Smp-7                            Smp-8
	       Smp-9                            
	  Disk.info                        Samples.info

@EndNode

##
## Introduction
##
@Node "Introduction"

	@{b}@{u}Introduction@{ub}@{uu}

	  Soundy  is  a program designed to play samples exclusively
	in  real-time to make your party more fun and more exclusive
	than the others.  It's dedicated to that user who works with
	music   and  is  searching  for  a  tool  to  perform  audio
	effects/variations/mixes  and  more.   It's done exclusively
	for  real-time  use;  do  not  expect a tracker or something
	similar; this is something completely new!

	If  you  like  to  go  to  discos,  raves or parties and are
	interested  in  how the technological music is composed, get
	an overview of Soundy!

	For expert audio users I will be perfectly clear:

	  Soundy  is  simply a Sampling Base Station like the Roland
	DJ-70  or  the  FZ-1 Casio keyboard.  It will cost much less
	than  a keyboard and will perform similar operations without
	too many expectations.  Only a minor deficency compared with
	a  keyboard:   you  must  have  a  sampler  to make your own
	samples.

@EndNode

##
## Features
##
@Node "Features"

	@{b}@{u}Features@{ub}@{uu}

	· Full IFF8/VOC/RAW8/RAW16 samples compatibility

	· 20 samples simultaneously in memory (FAST or CHIP)

	· Low CPU usage

	· Immediate response from keyboard by pressing any key
	  (main purpose of the program is to be incredibly fast at
	   the pression of any key)

	· Fine regulation of pitch for each sample

	· Realtime regulation of pitch with mouse

	· Fine regulation of volume for each sample relative to the
	  Master volume

	· Multi-file-select support on file requesters to speed up
	  operations

	· Scripting of any operation. Called "Samples' List"

	· Screen palette editor to adapt to any ambient light

	· Multitask playing of samples without using DMA

	· Background operation of some functions

	· Xpk compression supported

	· Powerpacker compression algorythm supported

	· Realtime audio switcher (like the switch on professional mixers)

	· Auto-synchronizement of samples

	· Regulation of beats multiples

	· Full Pro-Tracker modules support

	· No samples size limit! (limited only to your memory (Chip + Fast)!)

	· Three playmodes supported: MONO, STEREO, FLANGE

	· Capability of playing any sample 'n' times or infinite times

	· Automatic-Realtime-Fading for each sample with regulation of speed

	· Samples backwarding

	· Graphical pitch display

	· Master volume

	· Capability to close Workbench saving memory

	· Touch function to create special sound effects

	· Keypad keyboard simulator to create special sound effects

@EndNode

##
## Technical Info
##
@Node "Technical_info"

	@{b}@{u}Technical information@{ub}@{uu}

	Soundy v3.1

	Written using SAS C v6.51 by SAS Institute, Inc.

	Interface by GadToolsBox v2.0c by Jaba Development

	Updated in 2 weeks

	Programmed with the help of an Amiga 4000/040

	Edited using Cygnus Editor v3.5 by CygnusSoft Software

	Debugged with the help of ARTM v1.7 by Franz Josef Mertens &
	the Enforcer utility

@EndNode

##
## Requirements
##
@Node "Requirements"

	@{b}@{u}Requirements@{ub}@{uu}

	@{i}Memory requirements:@{ui}

	   A minimum of 512k chip memory

	   100k of chip memory are used to allocate audio channels
	    20k of chip memory are used to allocate screen display
	   150k of public memory are used to perform misc operations

	   All remaining memory is used to allocate samples and modules

	   A minimum of 4096 bytes of stack (if launched from Shell)

	@{i}Hardware requirements:@{ui}

	   Soundy will run on any Amiga model equipped with kick 2.0+

	@{i}Troubles:@{ui}

	   Soundy will conflict with any program that uses audio channels

	   On  A1200  you can't play more than 2 samples per time if is
	   loaded  on  an  F-key  due  to  a  bug  present in the A1200
	   keyboard!

	@{i}Testing:@{ui}

	   Soundy was tested on A500+, A1200, A4000/030, A4000/040 without
	   reporting any problems

@EndNode

##
## Background
##
@Node "Background"

	@{b}@{u}Background@{ub}@{uu}

	This  program  is  a  product  of  anger and despair.  I was
	unable  to  find a simple program that will perform realtime
	play of samples in an intellingent way.

	Who gived to me the idea to develope this software was a man
	aliased "Walter One".  A new type of DJ, nor a 1200 Technics
	system  or  something  else  was  used  but  two  FZ-1 Casio
	keyboards.  Simple, isn't it?  Believe in me, very efficent!
	With  ten  1,44Mb disks he was able to play different musics
	for more than an half hour changing sounds reflecting to the
	people response to the music.  It was a rave party and I let
	you imagine the kind of music used in.

	  Soundy  borns where the need to make this work is high and
	money to do it are few.  With any Amiga model and Soundy you
	can perform the same work of an F-Z1 Casio keyboard.

@EndNode

##
## Using Compression
##
@Node "Using_compression"

	@{b}@{u}Using Compression@{ub}@{uu}

	These are the compression methods that Soundy supports:

	 @{b}1. @{ub}@{i}PowerPacker@{ui}
	 @{b}2. @{ub}@{i}Shrink@{ui}
	 @{b}3. @{ub}@{i}Ross Data Compression@{ui}
	 @{b}4. @{ub}@{i}Bryan's turbo-charged LZW compressor@{ui}
	 @{b}5. @{ub}@{i}CmpByteRun0@{ui}
	 @{b}6. @{ub}@{i}Delta@{ui}
	 @{b}7. @{ub}@{i}Fast Encryprion ALgorithm@{ui}
	 @{b}8. @{ub}@{i}Huffman@{ui}
	 @{b}9. @{ub}@{i}ABPs IDEA@{ui}
	@{b}10. @{ub}@{i}LZ77@{ui}
	@{b}11. @{ub}@{i}LZ77 hyperfast decrunching@{ui}
	@{b}12. @{ub}@{i}LZRW@{ui}
	@{b}13. @{ub}@{i}Fast Huffman@{ui}
	@{b}14. @{ub}@{i}LZ Based with special purpose for 8 bit samples@{ui}
	@{b}15. @{ub}@{i}Dynamic huffman crunch algorithm with delta precoding@{ui}
	@{b}16. @{ub}@{i}Fast LZRW based compression algorithm@{ui}
	@{b}17. @{ub}@{i}Very fast packing & fast unpacking dynamic huffman@{ui}

	With  compression  you can save much of your precious space.
	Soundy will automatically decrunch files while loading them.

	More infos about compression algorithms are available on the
	xpk documents directory.

@EndNode

##
## Acknowledgements
##
@Node "Acknowledgements"

	@{b}@{u}Acknowledgements@{ub}@{uu}

	@{i}Special thanks goes to:@{ui}

	· @{b}Walter  One@{ub} - Who inspired me to create Soundy from his work
	  done with an FZ-1 Casio keyboard.

	· @{b}Roberto Campus@{ub} - The author of Soundy's icon.

	· @{b}Davide Pasca@{ub} - The programmer who help me to add
	  ProTracker  modules  support  to  Soundy  and  gived  to  me
	  precious  infos.   In  addition to this he has found the IFF
	  major  bug  &  fixed  a  lot  of problems with the 16bit raw
	  samples conversion.

	· @{b}Sergio   Chiesa@{ub}  -  The  programmer  who  gived  to  me  the
	  capability  to  put  samples  in  FASTMEM and to use samples
	  greater than 131Kb.

	· @{b}Renato Medini@{ub} - The first samples developer for Soundy.

	· @{b}Cecilia  Maria  Zannini@{ub} - Who help me to give a good english
	  style to the documentations of Soundy.

	· @{b}Federico    Provvedi@{ub}    -    Who   help   me   to   develope
	  auto-sample-synchronizement.

	· @{b}Nico  Francoise@{ub}  -  Who  developed  the  mighty  reqtools  &
	  powerpacker libraries.

	· @{b}Dominik Mueller@{ub} - Who developed the xpkmaster library.

	· @{b}Jan van den Baard@{ub} - Who created GadToolsBox!

	· @{b}Fabrizio Zavagli@{ub} - Who supplied some VOC files.

	· @{b}Michael  Cramer@{ub}  -  Who  written  the VOC to IFF
	  converter from which I've taken information about VOC files.

	      All authors of xpk compression libraries.


	@{i}Thanks for bugs reporting:@{ui}

	Edoardo  Di  Loreto,  Marco  Desiati,  Renato  Medini, Dario
	Biagetti, Karim Benaddi, Fabio Foggia


	@{i}...and all Soundy's supporters!@{ui}


	@{b}Please  dot not be angry with me if you are not in the list!
	Let me now and in the next release you will.@{ub}

@EndNode

##
## Revision History
##
@Node "Revision_History"

	@{b}@{u}Revision History@{ub}@{uu}

	This  file  contains specific changes/fixes in the different
	releases  of Soundy.  The most recent version is last in the
	list.   The  following is a list of abbrevations so you know
	what's what.

	SA  = Suggestion added
	MIN = Minor bug fixed
	MAJ = Major bug fixed
	NF  = New feature
	CH  = Minor change
	BF  = Bug found but not fixed
	UP  = Upgrade of an old function

	@{b}@{i}Soundy v1.0 released on 8/6/1992 - First version@{ui}@{ub}

	· First release!

	@{i}@{b}Soundy v1.0a released on 13/6/1992 - Bug fix version (not released)@{ui}@{ub}

	· (MIN)  Optimized  code  and  faster  response from mouse and
	  keyboard

	@{i}@{b}Soundy v1.1 released on 16/6/1992 - Update version@{ui}@{ub}

	· (NF) Regulation of volume for each channel added!

	· (NF)  Finally  multi-file-select  feature works fine and the
	  reqtools.library was replaced with the mighty req.library of
	  course with less bugs!

	· (BF)  Bug  found  in loading procedure.  Soundy will cause a
	  system  crash  if  a read/write error occurs.  This bug will
	  occur if the sample has the flag read protect too

	· (CH) Now to exit from Soundy you can use ESC key too

	@{i}@{b}Soundy v1.2 released on 22/6/1992 - Update & bug fix version@{ui}@{ub}

	· (NF) Wow! Now Soundy plays Octa-Med modules!

	· (UP)  Little changes to the system event routine to speed up
	  key responses

	· (MIN)  Bug fixed when pressing an F-key on an empty channel,
	  now the silent not the memory trash!

	@{i}@{b}Soundy v1.9x released on 6/10/1992 - Bug fix version (not released)@{ui}@{ub}

	· (MAJ) Fixed a lot of bugs, optimized and speeded up code

	@{i}@{b}Soundy v2.0 released on 17/12/1992 - Update & bug fix release@{ui}@{ub}

	· (MIN) Little bug fixed when loading Octa-Med module

	· (MIN)  Removed  some  functions  that  conflicts  with short
	  compilation mode without removing power to Soundy

	· (UP) Faster response when loading samples

	· (MAJ)  Guru  meditation  bug  fixed  when a "FILE NOT FOUND"
	  requester occurs

	· (MAJ)  Entirely  rewritten the file select routine:  faster,
	  more little and with no bugs

	· (CH)   Replaced   old  req.library  with  the  new  powerful
	  reqtools.library v2.1

	· (NF) Interface design now it's WB2.04 style, 3d of course!

	· (NF) Finally samples lists implemented in this version!

	· (CH)  Added  a  little  utility to alter the WB colors, very
	  funny!

	· (CH) Added an ABOUT gadget for our spreading informations

	· (CH)  Routine  to  deallocate buffers now added; very useful
	  try it!

	· (MIN) Bug fixed in OpenAudioChannels() routine which cause a
	  guru if channels were not ready
                  
	· (UP) Optimized code on ChangeBuffersVolume() routine, about
	  80% more faster

	· (UP)  System  event routine updated and re-optimized to keep
	  up the original speed with new commands too

	· (CH) Size of samples is displayed too

	· (CH)  When  you  press an F-Key you'll see the corresponding
	  gadget pop up!

	· (CH)  When an unrecoverable error occurs Soundy will display
	  a recoverable alert; in previous versions Soundy will simply
	  exit without any errors warning

	@{i}@{b}Soundy v2.1 released on 3/6/1993 - Bug fix release@{ui}@{ub}

	· (NF) From this version Soundy will work only under kickstart
	  2.04

	· (CH) Reduced code using kick 2.04 functions

	· (CH)  Now  Soundy  is  CLI  indipendant!   You can launch it
	  without the RUN command

	· (CH)  Soundy  is  equipped  with the new powerful version of
	  reqtools.library V38.1022

	· (CH)  Added  the new string.library.  This tool will provide
	  to reduce formatting string operations to Soundy

	· (CH) Removed math routines from code

	· (NF)  Added  to the archive an utility from reqtools.library
	  to set the preferences of the Soundy's file requester

	· (MIN) Size of samples bug fixed

	@{i}@{b}Soundy v3.0 released on 28/03/1994 - Update & bug fix version (Comm.)@{ui}@{ub}

	· (CH) Now Soundy works under kick 3.0 too!

	· (UP)  Entirely rewritten the Intuition part!  Now Soundy has
	  a new interface!

	· (UP) Entirely rewritten the Event Routines part!  Now Soundy
	  has an incredibly speed with all functions!

	· (CH) Diskfont.library is no more necessary to run Soundy

	· (UP) Optimized code size and speed for entire program

	· (NF) Now Soundy supports PowerPacker algorithm!
                  
	· (MAJ) Bug fixed when loading samples, which causes a guru if
	  the  loading  routine will encounter read/write error.  This
	  bug were not fixed from v1.1 of Soundy

	· (MIN)  Size of samples bug were not completely fixed, now it
	  is!

	· (UP)  Replaced  old stdio sprintf with a new SPrintf written
	  in assembly language

	· (CH)  Added to the archive the new reqtools.library revision
	  38.385

	· (NF)  Support  of Xpk libraries added.  Now Soundy handles a
	  large wide of compression algorithms

	· (NF) Status report added

	· (NF) Added regulation of sample beats for each sample

	· (NF) Great feature added to Soundy!  Auto-synchronizement of
	  samples rate from a specific sample to all the others

	· (NF) Audio switcher on/off in real time for each sample

	· (UP)  Soundy  is  more safe on intuition gadgets; now unused
	  gadgets are unselectable to prevent errors

	· (NF) Now Soundy plays Pro-Tracker modules instead of OctaMed
	  ones!

	· (UP) Drawing routines a little faster

	· (NF) Now Soundy uses a new generation of PlayRoutines!  With
	  these  new ones Soundy will be able to play samples directly
	  from  FAST  memory  and  will  be  able to play in loop mode
	  samples  greater  than  131Kbytes.   Now  the  length of the
	  sample  you  can  load  from Soundy can be great as great is
	  your FAST or CHIP memory

	· (UP) Volume refresh routine entirely rewritten; now is about
	  180% more fast!

	· (MIN)  Soundy  will always get back the audio channels after
	  playing any module

	· (MAJ)  Loss  of  memory  caused  by multiply key stroking is
	  fixed  now.  Soundy will handle all intuimessages.  This bug
	  was not fixed from v1.0 of Soundy

	· (CH) Now Soundy will not process F-Key calls if all channels
	  are playing

	· (MIN)  Now  Soundy  will  take  care to switch off all sound
	  resources before playing a module

	· (NF) Auto-Volume-Fading feature added

	· (NF) Now Soundy supports multiple audio playmodes:
             MONO, STEREO and FLANGE
             For FLANGE MODE is available a requester to change the
             FLANGE parameter

	· (NF) You can look at your selected picture via a graphic bar
             on the sample name

	· (NF) Capability to open/close workbench screen

	· (MAJ) Fixed a lot of bugs in bender mode

	· (MIN) Code to switch audio filter debugged & rewritten

	· (NF) Backwarding of samples feature added

	· (CH) Changed the pitch value on screen to the real value

	· (NF) Added a graphical bar relative to the pitch value

	· (NF) Soundy is more friendly on performance operations

	· (UP) Graphics relative to the channels status rewritten

	· (NF) Capability  to  set  the number of loop times for each
	  sample

	· (UP) Command set for samples'  list  highly  increased  with
	  these new commands: SLISTRANGE, REVERSE, PITCHON, DEFLOAD,
			    FLANGERANGE, DEFLOAD, MASTERVOLUME,
			    DEFPLAY, COMMENT
	  and a lot of keywords relative to these commands too

	· (NF) Twenty samples in memory instead of ten!

	· (NF) Master volume added

	· (NF) Capability to set a samples' list range relative to the
	  maximum samples to load; this, looping on the buffers

	· (NF)  All requesters are automagically placed on the pointer
	  position

	· (BF)  Sometimes,  when  Soundy  can't  be  launched due to a
	  missing of a resource, a system crash will occur

	· (BF) On fast machines as A4000/A1200 or any Amiga model with
	  an accelerator card you can notice a little sound trash when
	  playing samples at high pitch rate

	@{i}@{b}Soundy v3.1 released on 25/04/1994 - Update & bug fix version (Comm.)@{ui}@{ub}

	· (BF) Bug found in reqtools.library!  Size of files is not
	  displayed correctly under 2.04 kickstart

	· (NF) Added a function to delete all samples in one shot

	· (NF) Added  a  samples' list parameter to delete samples
	  from memory: REMOVE <sample-number>

	· (CH) Changed the default flange range to 1 instead of 3

	· (NF) Now you can select samples by clicking on their name

	· (UP) Updated the sqsh.library from v1.0 to v1.10

	· (CH) Screen refresh now supported

	· (CH) Now to select samples to synchronize you must click
	  on  their  name instead of his corresponding gadget.
	  You'll notice that samples can be toggled too

	· (CH) When  stopping  module,  previous samples that were
	  playing will immediately go back to their status

	· (MAJ) Soundy will no more conflict with itself.  Now, if
	  you launch Soundy twice, a nice requester will inform you
	  of your wrong action

	· (CH) Samples' List function moved to a gadget instead of a
	  menu item

	· (MIN) When  encountering a playing sample the status bar
	  was not refreshed properly.  Fixed!

	· (CH) Part of the synch routine rewritten to be faster with
	  intuition  gadgets.   Now  you  can  use  all functions when
	  synchronizing too

	· (NF) Auto-Repeat-Function added for special audio effects

	· (MIN) Raw samples default speed parameter fixed

	· (CH) Now IFF8 and RAW8 samples are loaded in a different
	  manner

	· (NF) 16 bit raw samples support added

	· (NF) VOC samples support added

	· (CH) Added a cycle gadget to specify what kind of sample
	  is to be loaded

	· (MAJ) Sometimes, on exit, audio was left opened. Fixed!

	· (MAJ) Fixed a great bug relative to the start of the IFF
	  sample. This was not fixed from version v1.0

	· (NF) Auto-Filetype-Recognition  to  speed  up  loading
	  procedure.   NOTE:  Raw samples cannot be auto-recognized
	  so you must specify the file type to RAW8 or RAW16

	· (MIN) Fixed a minor bug relative to the start of reversed
	  samples

	· (NF) Added two xpk libraries: FAST, HFMN

	· (NF) Added these new samples' list commands: DEFTYPE,
	  KEYPADRANGE, RESETALL, REMOVEALL, CHANGETOUCH,
	  CHANGEPITCH, CHANGEVOLUME, CHANGEFADEDIR,
	  CHANGEFADETIME, CHANGEPLAYMODE

	· (NF) Numeric keypad used to have 9 different pitches of a
	  single sample!

	· (NF) Added a function change settings to default values

	· (MIN) Little bug fix to the pitch bender routine

@EndNode

##
## To do
##
@Node "To_Do"

	@{b}@{u}To do@{ub}@{uu}

	@{i}This is what we expect to add to Soundy in future releases:@{ui}

	· Asynchronous loading

	· A fast function to load samples from disk to save precious
	  space on the hard disk

	  This disk will be written with an utility that will convert
	  normal samples into a NOT DOS format that Soundy will be able
	  to load

	· Online help

	· Capability to load .WAV samples

	· Capability to load Casio FZ-1 samples

	· Capability to load 16bit IFF samples

	· A little graph reporting the status of the playroutine

	· A real vu-meter for each channel

	· Boost playmode

	· Capability to display additional information about samples
	  in  addition to the length.  You can choose sample-frequency
	  or time

@EndNode

##
## Reporting Bugs
##
@Node "Reporting_Bugs"

	@{b}@{u}Reporting bugs@{ub}@{uu}

	  Soundy is a rather complex  program  which is difficult to
	maintain - especially since there is only one person to take
	care  of  it:   me.   Although  one  tries to write correct,
	bug-free  software,  one  cannot  always  achieve this goal.
	Tough  -  but  that's  life.   It  rains  when you leave the
	umbrella  at  home.   Toast  falls  buttered-side down.  The
	phone rings while you are in the bath.

	  In  case  you  come upon one of those nasty features which
	even  the author was unable to track down and remove, follow
	these steps:

	  1.  Keep calm.  Shouting, cursing, crushing disks may help
	to cool your temper, but it will not help anybody (the least
	yourself!)  if  it  results  in a sudden cardiac infarction:
	you will have problems in reporting the problem.

	  2.  Read  the  documentation!   The  bug  you may want  to
	report may be a deliberate feature.

	  3.  Repeat  previous  step  as  often  as  possible.  Yes,
	really,  do  so.   Read the documentation.  You will be glad
	you did.

	  4.  Describe  your  problem  elaborately.  A comment  like
	`things  fall down when dropped' may have inspired Sir Isaac
	Newton,  but a similarly laconic comment `playroutine do not
	work'  will most certainly fail to give any useful hints how
	to approach the problem.

	  5.  If  you  wish  to  report  a bug in the  samples' list
	script  include a sample samples' list script to produce the
	bug.

	  6.  Do not forget to write it down!  There is a difference
	between noticing a bug and reporting it (honestly!).  Do not
	suppose  that  a  bug  will  be  fixed  in  a future program
	revision  or  rely  on  anybody  else  to  report it:  do it
	yourself.   Send  a  letter  to  the  author, preferably per
	electronic  mailing  services  or  call the Soundy's support
	board.

	  7.  State your system and program configuration.  It helps
	a  lot to know on which machine the program caused problems.
	Please  include  information  such as memory expansion size,
	Amiga  model  (A500+,  A600,  A1200,  A3000,  A4000,  etc.),
	graphics  hardware  (ECS,  AGA,  etc.),  CPU  type (MC68000,
	MC68020, MC68030, MC68040, etc.).

	  8.  Report programs that were in multitasking while Soundy
	was running.

	  9.  Report all of this to author @{" address " Link "Addresses"}.

@EndNode

##
## Addresses
##
@Node "Addresses"

	@{b}@{u}Addresses@{ub}@{uu}


	@{i}Home address:@{ui}

	    Stefano Coletta
	    P.le del Caravaggio n.6
	    ZIP 00147 Rome Italy


	@{i}Support BBS:@{ui}

	    Antanisoft Group Research BBS - Node #1
	    Line #1: +39-6-541-3311 28800 HST 24 hours per day
	    Line #2: +39-6-512-2051 28800 HST 24 hours per day
		  (from may 1994 will be +39-6-5422-4376)

@EndNode

##
## IMPORTANT!
##
@Node "Important"

	@{b}@{u}Important notice@{ub}@{uu}

	Note to all Amiga 1200 users:

	  You  will  notice  that  Soundy  cannot  play  more than 2
	samples  per  time...   This  is  not a bug of Soundy nor an
	installation  bug...   it's  an Amiga 1200 keyboard bug!  On
	A1200  Commodore has changed the old keyboard chipset making
	it  different  from  all  Amiga models.  It's something new,
	something  shitty!   Now  on these keyboards you can't press
	more  than  2 keys per time!  Try yourself with any program!
	So don't be angry with me...

@EndNode