home *** CD-ROM | disk | FTP | other *** search
/ Vectronix 2 / VECTRONIX2.iso / FILES_01 / 525_212R.ZIP / README < prev    next >
Text File  |  1995-09-11  |  12KB  |  345 lines
  1.  
  2. FIVE TO FIVE Version 2.12
  3. -------------------------
  4. for ATARI ST/TT/Falcon
  5.  
  6. by Harald Schönfeld and Bernd Spellenberg
  7.  
  8. September 1995
  9.  
  10.  
  11. 'Five to Five' is a program to convert various sound file types, as used on
  12. different computer systems. Some packing algorithms and the following file
  13. types are currently supported by 525:
  14.  
  15. - DVSM (ATARI Falcon 'WinRec')
  16. - AVR (ATARI)
  17. - HSN (ATARI 'CrazySounds')
  18. - FORTUNE (ATARI Falcon 'Fortune')
  19. - SND, AU (Sun, Mac, NeXT)
  20. - WAV (PC)
  21. - AIFF (Mac, ATARI (Cubase))
  22. - Raw data
  23.  
  24. Additionally it is now possible to convert the sample frequency of the sound
  25. data and to use an adjustable low pas filter.
  26.  
  27.  
  28.  
  29. Copyright
  30.  
  31. Copyright 1994-95 by Harald Schönfeld and Bernd Spellenberg.
  32.  
  33. The program 525 is shareware. 525 may and shall be copied and spread under
  34. the condition that all program- and text- files of this archive are
  35. included. Commercial use (distribution, selling the program for money,
  36. spreading via PD disk series or CDs) is not allowed. But the authors may
  37. grant the permission for such use.
  38.  
  39.  
  40. Registration
  41.  
  42. If you use 525 regularely you have to pay the shareware fee of DM 20 ($ 15,
  43. £ 10). Payment can be done via EuroCheque (or other international money
  44. orders if you pay the fee!) or remittance order.
  45.  
  46. Banking account (for remittance orders only):
  47.     Harald Schönfeld
  48.     Kto. 5117726, Vereinigte Sparkasse im Landkreis Fürth, BLZ 76250110
  49. or
  50.     Bernd Spellenberg
  51.     Kto. 122343, Raiffeisenbank Fürth eG, BLZ 76260451
  52.  
  53. Please write your name in the comment field of the remittance order and send
  54. us your name, address, email address and a remark to 525 V2.02 for ATARI
  55. seperately (via mail or email). You will then recieve a personal key from
  56. us that allows you to register yourself in all future versions of the
  57. program for all supported platforms.
  58.  
  59.  
  60. Contact address
  61.  
  62. Send suggestions, criticism, comments, bug reports, cheques and
  63. registrations to:
  64.  
  65. Harald Schönfeld
  66.     Email: Harald.Schoenfeld@rzmail.uni-erlangen.de
  67.     Post: Lerchenstra₧e 2, 90587 Veitsbronn, Germany
  68.  
  69. Bernd Spellenberg
  70.     Email: Bernd.Spellenberg@rzmail.uni-erlangen.de
  71.     Post: Fürther Stra₧e 11, 90617 Puschendorf, Germany
  72.  
  73.  
  74. Beta testers
  75.  
  76. Thanks to  Peter Sergedahl, Thomas 'Gryf' Binder, Wolfgang Simon und Adam
  77. 'Riker' Kulinski (ATARI) and 'Soundy' (OS2).
  78.  
  79.  
  80. Exemption from liability
  81.  
  82. The programmers can not be held responsible for any errors which may occur
  83. while using this software. We do not claim this software is useful for all
  84. applications.
  85.  
  86.  
  87.  
  88. 1. System requirements
  89.  
  90. Five to Five runs on all ATARI computers of the 680x0 series, no matter if
  91. MultiTOS or Magic is installed or not, and on Macintosh computers running
  92. MagicMac. 525 needs about 250 KB free RAM.
  93.  
  94.  
  95.  
  96. 2. Installation
  97.  
  98. Copy the program (525G.PRG=german, 525E.PRG=english) onto your
  99. harddisk.
  100.  
  101. If you own a resource editor, you can insert one of the included 525 icons
  102. into the deskicon.rsc file. In the next step, you can install that icon as
  103. the Five to Five desktop icon.
  104.  
  105.  
  106.  
  107. 3. Usage
  108.  
  109. After starting the program, the 'Convert Sample' dialog is shown and the
  110. 525 menu appears. There are the following menu items:
  111.  
  112.  
  113. Desk/about Five to Five...
  114.  
  115. Informs about the current version number and the regsistered user. To
  116. register as a user, press the 'Register' button and follow the instructions.
  117. After successfull registration the annoying copyright messages will no
  118. longer appear.
  119.  
  120.  
  121. File/Convert...
  122.  
  123. Here you can select samples for conversion and choose a new file type and
  124. format.
  125.  
  126. "File name" is a PopUp to select the import file. Just click onto the PopUp
  127. and select the file in the subsequent file select box. The file will be
  128. opened and 525 tries to get all necessary information from the file header.
  129. A brief information about the file will be shown on the right of the PopUp.
  130.  
  131. If 525 couldn't find a file header, a dialog box appears, where the format
  132. of the sample data has to be defined manually:
  133. - the frequency: Click onto the PopUp to select a predefined frequeny, or
  134.   type in any other frequency.
  135. - the pack/data format
  136. - the number format: Signed or unsigned
  137. - the length of a possible header (to avoid distorsions at the beginning)
  138.  
  139. Many old ST samples are 8 Bit Mono unsigned.
  140.  
  141. To start the program, you can also drag a sound file icon onto the 525
  142. program icon. The file will then be used as import file. Using MultiTOS it
  143. is also possible, to drag a sound file icon from the desktop onto the 525
  144. main dialog window to import the file.
  145.  
  146. "Analyse" will show a detailed information about the import file. If the
  147. file was not yet analysed, the whole file will be scanned now. Then the
  148. information about length, type, format and peak level will be shown. The
  149. reported length is the length of the sample data (without any header). 525
  150. tries to figure out the format by analysing the file header or it simply
  151. uses the definitions you made in the raw file import dialog.
  152.  
  153. To select the export file type, click onto the "File Type" PopUp menu. 525
  154. currently supports 7 different file types:
  155. - DVSM: For WinRec, Win Cut, Fortune (ATARI)
  156. - CIT : For Fortune (ATARI)
  157. - AVR : Many ATARI St/Falcon programs
  158. - HSN : CrazySounds (ATARI)
  159. - SND : Sun, NeXT, Mac
  160. - WAV : PC
  161. - AIFF: Mac, ATARI - also uncompressed AIFC
  162. - AIFF-Cubase: 512 byte aligned, but according to AIFF specifications
  163. - Raw data: Raw data for many different programs
  164.  
  165. To select the format of the export file, click onto the "Format" PopUp. For
  166. every file type the possible file formats will appear in the menu. An actual
  167. format consists of several basic formats:
  168.  
  169. - Stereo / Mono: Two or one channels
  170. - Signed / Unsigned: With or without sign
  171. - Motorola / Intel: For Motorola or Intel CPUs
  172. - 16 / 8 Bit / Mu-Law / Deltapack: 16 or 8 Bit are uncompressed,
  173.   Mu-Law and Deltapack are compressed. Deltapack needs as much memory as
  174.   Mu-Law, but sounds much better. 
  175.  
  176. If you select a format, an abbreviation of the complete format text will
  177. appear in the PopUp.
  178. Selecting 'Keep' in the PopUp menu ensures that the input format is used as
  179. export format if this is possible (which depends on the different file
  180. types). If it is not possible 525 chooses a format that does not use more
  181. memory than the import format.
  182.  
  183. Please notice that it is almost useless to convert a worse format to a
  184. better one. It only requires more memory but sounds the same. But it is
  185. possible that other programms support only some formats.
  186. Converting Mu-Law to deltapack can result in a slightly worse sound quality,
  187. although deltapack is the better format.
  188.  
  189. If the peak level of the import sample is rather low, it is useful to use
  190. "Maximize volume". Using this option, the file will be written with maximal
  191. possible volume (and a peek level of about 99% to 100%). In this case the
  192. file will be scanned once completely. If the following option is active,
  193. too, the file will be even scanned twice.
  194.  
  195. "Fade In/Out" allows you to fade in and out the volume of the sample at the
  196. beginning and end. This is very useful, as there are often some distortions
  197. at this part of the sample. The duration of this effect can be typed in both
  198. for the start and the end of the sample if the option is selected. You can
  199. type in 1 to 9999 milli seconds. If 0 is used, the option has no effect.
  200.  
  201. By selecting the button "Convert Frequency" it is possible to convert the
  202. sample data from the given sample frequency to any other frequency. You can
  203. select this frequency by choosing any from a PopUp with pre defined standard
  204. values or by typing it in.
  205. Converting a sample to a higher frequency increases the length of the file
  206. while the sound quality surely will not get better. Converting to a lower
  207. frequency leads to a shorter file, while the higher frequencies in the
  208. sample data are lost.
  209.  
  210. If frequency conversion is selected, the low pass filter is automatically
  211. activated. This is necessary to avoid harmonic distorsions when converting
  212. to a higer sample rate and to avoid aliasing when converting to a lower
  213. sample rate. The correct edge frequency is automatically selected.
  214. Unfortunately the filtering process takes some additional time. So if you
  215. want to hear the result faster and if you don't care about some distorsions,
  216. you can disable the filter manually.
  217.  
  218. "Low pass filter" can also be selected independently of the frequency
  219. conversion, for example to filter out noise. Just type in the edge frequency
  220. you want. Mark: The highst possible frequency in a sample with the sample
  221. rate f (e.g. 8000Hz) is f/2 (4000Hz). So the highst possible edge frequency
  222. is the half of the sample rate.
  223.  
  224. To write the new file select the "Export" button. At first a file select box
  225. appears to select the export file name. If a file with the same name already
  226. exists, a warning message appears and you can stop the export. During export
  227. a visual progress indicator tells you about the current status of the export
  228. operation. If the export file name is the same as the import file name, a
  229. temporal file will be created. To abort the convert process, press ESC or
  230. UNDO.
  231.  
  232.  
  233. File/Quit
  234.  
  235. Quits the program.
  236.  
  237.  
  238.  
  239. 4. Internals
  240.  
  241. One supported sample type is the DVSM-Format of the programs WinRec, WinCut
  242. and Fortune. Those are programs for the ATARI FALCON.
  243.  
  244. A DVSM sample file has the following structure:
  245.  
  246. typedef struct
  247. {
  248.     char magic[6];     /* "DVSM" */
  249.     int headlen;       /* Headlen in Bytes*/
  250.     int freq;           /* Sample freqency 0=8kHz 7=50kHz*/
  251.     char pack;           /* 0 unpacked, 2=DVS pack method*/
  252.     char mode;         /* 0=Stereo 8Bit,1=Stereo 16Bit,2=Mono 8Bit,3=Mono 16*/
  253.     long blocklen;     /* if pack>0: Length of a packed block*/ 
  254. } DVSMHEAD;
  255.  
  256. followed by cookies and the sound data.
  257.  
  258. The sample frequencies 0 to 7 correspond to the following frequencies:
  259. sam_freq[8]={8195,9834,12292,16390,19668,24585,32778,49170};
  260.  
  261. For further information refer to the WinRec documentation or take a look at
  262. the article series 'Sound Sample Formate' in the german magazin ST Computer
  263. (3/94 - 6/94).
  264.  
  265.  
  266.  
  267. 5. Known Bugs
  268.  
  269. Problems in 256 colours together with NVDI (it's probably NVDI's fault).
  270.  
  271.  
  272.  
  273. 6. Release History
  274.  
  275. 04/12/93: Version 0.9
  276.  
  277. 04/12/94: Version 0.91
  278.           - Correction in DVSM import
  279.  
  280. 05/05/94: Version 1.0
  281.           - AES 4.02 3D support
  282.           - Copyright Maxon
  283.  
  284. 11/27/94: Version 2.0
  285.           - Complete re write of the program.
  286.           - New file types: CIT (Fortune)
  287.                             HSN (CrazySounds)
  288.           - Fade in/out time seperately adjustable
  289.           - Correct volume maximation in connection with fading
  290.           - Visual progress indicator
  291.           - Drag&Drop
  292.  
  293. 02/01/95: Version 2.01
  294.           - New file type: AIFF (Mac, ATARI)
  295.                            AIFF-Cubase (Cubase)
  296.           - Iconize bug with MultiTOS in monochrome mode fixed
  297.           - Bug in user defined message handling corrected
  298.  
  299. 03/05/95: Version 2.01 for OS/2
  300.  
  301. 03/12/95: Version 2.02 for ATARI
  302.           - Shareware registration dialog
  303.           - Icon for desktop resource file included
  304.  
  305. 04/17/95: Version 2.1 for ATARI
  306.           - Frequency conversion
  307.           - Adjustable low pass filter
  308.           - User break during conversion by pressing ESC or UNDO
  309.           - The program can now be hidden using MagiC
  310.           - Bug in command line parameter handling corrected
  311.           - Correct file delete of the export file during 'disk full' on MTOS/MagiC
  312.  
  313. 07/18/95: Version 2.11 for ATARI
  314.           - Check back if export file already exists
  315.           - Bugfix in dialog memory management
  316.           - Problem with export status bar fixed
  317.           - Bug in registration dialog fixed
  318.           - Bug in DVS-Import/Export with frequency conversion fixed
  319.  
  320. 07/18/95: Version 2.11 for OS/2
  321.           - Functionally equivalent to the ATARI version 2.11
  322.           - First German release
  323.  
  324. 09/03/95: Version 2.12 for ATARI
  325.           - Header skip function for raw files
  326.           - No crashing on import files without extension
  327.           - No sreen redraw when iconyfied anymore
  328.  
  329. 09/10/95: Version 2.12 for OS/2
  330.           - Functionally equivalent to the ATARI version 2.12
  331.           
  332.  
  333.  
  334. 7. Future Plans
  335.  
  336. - More formats
  337.     .AIFC compressed
  338.     .WAVE 4Bit
  339.     .ADPCM
  340.     .Yamaha
  341.  
  342. - Additional platforms
  343.     .Macintosh
  344.     .DEC Alpha (OSF/1-Digital Unix)
  345.