home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / dos / music / convert / convert.doc next >
Text File  |  1994-07-19  |  14KB  |  307 lines
  1.                   Convert, (c) 1994 Jesus Villena, Spain
  2.                    Universidad Politecnica de Valencia
  3.                          Facultad de Informatica
  4.  
  5.                      INTERNET:  jvillena@dsic.upv.es
  6.  
  7.                               Version 1.2B
  8.  
  9.  
  10. COPYRIGHT
  11.  
  12. This program is Freeware and may be distributed without any permission of
  13. their author. Their development has been carried out by and for the INTERNET
  14. collective. Collaborates in their improvement and amplification!
  15.  
  16. This software is provided as-is. Author makes no warranties on this program.
  17. You use this software at your own risk.
  18.  
  19.  
  20. INTRODUCTION
  21.  
  22. Convert is a MSDOS tool which serves in order to interchange samples between
  23. several formats of sound.  The translation between the several formats offers
  24. the advantage of maintaining the majority of the present information in the
  25. original file if this is possible, i.e. name, loop points, significant
  26. number of bits, number of channels, etc.
  27.  
  28.  
  29. MOTIVATION
  30.  
  31. Convert surged like a domestic project destined to the obtaining of high
  32. quality instruments for the Gravis Ultrasound card starting with files
  33. from professional samplers (Ensoniq EPS, Roland [S] 50, Yamaha TX16W...)
  34. The source code was designed so that out easy their amplification to more
  35. formats. In fact, soon the formats of the most well-known modules were added
  36. (MOD, MTM, FAR, S3M...). A little later they were added the MIDI standard
  37. formats (SDS and SDX) and other formats offered by several manufacturers
  38. (AIFF, IFF, SMP...).
  39.  
  40. At the same time that was added more available formats for the input files,
  41. these same formats, if it was possible, they were available also like
  42. output, so that virtually, any input format would be converted in any
  43. output format.
  44.  
  45.  
  46. FEATURES
  47.  
  48.         - Great quantity of input and output formats:  seeing list.
  49.  
  50.         - Automatic recognition of the input format:  it is not necessary
  51.         specify the type of the input file, Convert recognizes it automatically.
  52.  
  53.         - Possibility of converting in a single pass great quantity of files and
  54.         carry them to some target directory:  They are accepted wildcards
  55.         in order to specify the input files, and a output directory which
  56.         will be filled with the resulting files.
  57.  
  58.         - Ease of use:  their utilization is clearly intuitive in order to avoid
  59.         remember difficult combinations of input parameters (for example, if you
  60.         want to use the samples that there is in a file ". PAT" in order to
  61.         utilize them in a module ". MOD", simply specifies -MOD as switch and
  62.         Convert translate each one of the waveforms to the format ". SAM"
  63.         readable for all the mod-editors, without specifying if it is SIGNED or
  64.         UNSIGNED...)
  65.  
  66.         - The program may work with input files of until 16 bits and
  67.         2 channels (Stereo), doing the necessary conversion of these values for
  68.         generating the output format (this is, a WAV file of 16 bits Stereo will
  69.         be converted in 8 bits Mono upon converting it to VOC, for example).
  70.  
  71.         - High probability of success: This program has converted with success
  72.         98% of files I have (others conversion programs generated many errors).
  73.         Especially I have all GKH and AIFF files on ftp.reed.edu (now on
  74.         oak.oakland.edu) and it has converted all very well (except some files
  75.         that was corrupted originally).
  76.  
  77. NEW!!   - Varios Keyboard Disk Images have been added: Directly supports the
  78.         disk image formats GKH and Giebler Enterprises (both are the most
  79.         common in the internet) for VFX-SD, SD-1, TS-10 (DD y HD), VFX-SD, EPS
  80.         (normal, 16 and 16+), and ASR keyboards and racks units. Convert
  81.         doesn't need, as a difference to other programs, external programs for
  82.         converting these disk images.
  83.  
  84. NEW!!   - It Comes in this version with some useful utilities: SND2WAV and JOIN.
  85.         SND2WAV converts files that can't carry out Convert (files without
  86.         header) and JOIN links pieces which form a unique sample disk for
  87.         Kurzweil and Ensonig formats.
  88.  
  89.  
  90.  
  91. FORMAT IDENTIFICATION
  92.  
  93. The formats which Convert works in this version are the following:
  94.  
  95.         SND         PCM Unsigned Raw Sound File
  96.         RAW         PCM Signed Raw Sound File
  97.         GKH         Ensoniq Disk Image (VFX, SD, EPS, ASR, TS)
  98.         INS, EFE    Ensoniq Instrument File
  99.         WAV         Microsoft Windows RIFF WAVE
  100.         PAT         Gravis Ultrasound Patch
  101.         UWF         UltraTracker WaveSample
  102.         ULT         UltraTracker Module
  103.         FSM         Farandole Composer WaveSample
  104.         FAR         Farandole Composer Module
  105.         669         669 Tracker Module (and Extended)
  106.         S3I, SMP    Digiplayer /ST3 Sample File
  107.         S3M         Scream Tracker v3 Module
  108.         MTM         MultiTracker Module
  109.         MOD         Protracker/Fastracker/Startracker Module
  110.         VOC         Creative Lab's Sound File
  111.         SDS         MIDI Sample DUMP Standard File
  112.         SDX         Sample DUMP Exchange File
  113.         SMP         Samplevision File
  114.         TXW         Yamaha TX-16W Wave File
  115.         SDK         Roland S-550/S-50/W-30 Disk Image
  116.         AU          Sun/Next Audio File
  117.         AIFF        Audio Interchange Format File
  118.         IFF         Interchange Format File
  119.  
  120.  
  121. SYNTAX
  122.  
  123. The form of invoking to this tool is the following:
  124.  
  125.           CONVERT [InputPath [OutputPath] [OutFmt]]
  126.  
  127. Where:
  128.  
  129. InputPath is the name of the files to convert.  InputPath consists of a route
  130. and a file name, which accept the usual wilcards of DOS.  Examples of
  131. InputPath would be: \SAMPLES\*.*, ..\SAMPLES\ENSONIQ\*.INS, SAMPLE?.*, etc.
  132.  
  133. OutputPath specifies the destination directory where Convert will place the
  134. files converted.  If this directory don't exist, Convert creates it.
  135.  
  136. OutFmt is a switch that allows to specify the output format for the files
  137. to convert to. 
  138.  
  139. The courage of OutFmt may be one of the following:
  140.  
  141. OutFmt      Extension     Offered Characteristics
  142. ------      ---------     --------------------------------------------------
  143. -SND        ".snd"         PCM Unsigned Raw, 8/16 bits INTEL, Stereo/Mono
  144. -RAW        ".raw"         PCM Signed Raw, 8/16 bits INTEL, Stereo/Mono
  145. -WAV        ".wav"         8/16 bits, Stereo/Mono, Rate
  146. -PAT        ".pat"         8/16 bits, Mono, Rate, Loop, Multiple Waveforms
  147. -UWF, -ULT  ".uwf"         8/16 bits, Mono, Loop
  148. -FAR, -FSM  ".fsm"         8/16 bits, Mono, Loop
  149. -669        ".snd"         PCM Unsigned Raw, 8 bits, Mono
  150. -S3I, -S3M  ".smp"         8/16 bits, Stereo/Mono, Rate, Loop
  151. -MTM        ".raw"         PCM Unsigned Raw, 8/16 bits, Mono
  152. -MOD        ".sam"         PCM Signed Raw, 8 bits, Mono
  153. -VOC        ".voc"         8 bits, Mono, Rate
  154. -SDS        ".sds"         8/16 bits, Mono, Rate, Loop
  155. -SDX        ".sdx"         8/16 bits, Mono, Loop
  156. -SMP        ".smp"         16 bits, Mono, Rate, Loop
  157. -AU         ".au"          8/16 bits Linear, Rate, Stereo/Mono
  158. -AIF        ".aif"         8/16 bits, Stereo/Mono, Rate, Loop
  159. -IFF        ".iff"         8 bits, Mono, Rate
  160. -OUT        depends        variable (see notes)
  161.  
  162. Notes:
  163.  
  164. If you run Convert without parameters, the program shows a small help.
  165.  
  166. If you have specified only InputPath, the program shows information on the
  167. content of the input files (sample name, number of Bits, number of channels,
  168. loop points, etc.
  169.  
  170. If you haven't specified OutputPath, it will use the current directory as
  171. target.
  172.  
  173. The output file generated acquires the same name that the input file, if
  174. this has a waveform.  If the input file has various waveforms, the name of
  175. each file generated is the original name adding an index that differentiates
  176. it of the others (Caution: this may override existing files with equal names).
  177.  
  178. Could happen that the file converted doesn't have the loop points very well
  179. definite; I could secure that in many cases in that this has happened me,
  180. it was an appropriate defect of the original file, no due to the conversion.
  181.  
  182. The switch -OUT has a special meaning and it is only accessible from some
  183. formats.  Basically its meaning is to extract all the waveforms that there is
  184. in the input file to individual files, with the same format (or of it same
  185. "family") that the initial.  Logically, this switch only is available for
  186. that formats that may have multiple waveforms on an only file:
  187.  
  188.         GKH --> INS (they are extracted the contained files in the file GKH)
  189.         PAT --> PAT (each WaveForm is converted into a new PAT file)
  190.         ULT --> UWF
  191.         FAR --> FSM
  192.         669 --> SND (each instrument to PCM RAW 8 bits Unsigned)
  193.         S3M --> S3I
  194.         MTM --> RAW (each instrument to PCM RAW 8/16 bits Unsigned)
  195.         MOD --> SAM (each instrument to PCM RAW 8 bits Signed)
  196.  
  197.  
  198. ACKNOWLEDGED INPUT FORMATS
  199.  
  200. So that a file may be automatically acknowledged, It should have a header
  201. that define it.  For it, the files with format PCM RAW is not accepted like
  202. valid input formats.  The following they are the valid input formats for
  203. this version:
  204.  
  205. Format     Acknowledged Characteristics
  206. --------   --------------------------------------------------------
  207. GKH, INS   Various waveforms, 16 bits, Mono, Rate, Loop, Name
  208. WAV        1 waveform, 1..16 bits, Stereo/Mono, Rate, Name, Text
  209. PAT        Various waveforms, 8/16 bits, Mono, Rate, Loop, Name, Text
  210. UWF        1 waveform, 8/16 bits, Mono, Loop, Name, Text
  211. ULT        Equal as the anterior with various waveforms and Text
  212. FSM        1 waveform, 8/16 bits, Mono, Loop, Name
  213. FAR        Equal as the anterior with various waveforms and Text
  214. 669        Various waveforms, 8 bits Mono, Loop, Name, Text
  215. S3I        1 form of wave, 8/16 bits, Stereo/Mono, Rate, Name
  216. S3M        Equal as the anterior with various waveforms and Text
  217. MTM        Various waveforms, 8/16 bits, Mono, Loop, Name, Text
  218. MOD        Various waveforms, 8 bits, Mono, Loop, Name, Text
  219. VOC        1 waveform, 8 bits Mono, Rate, Loop, Text
  220. SDS        1 waveform, 1..16 bits, Rate, Mono, Loop
  221. SDX        1 waveform, 1..16 bits, Rate, Mono, Loop, Name, Text
  222. SMP        1 waveform, 16 bits Mono, Rate, Loop, Name, Text
  223. TXW        1 waveform, 12 bits, Mono, Rate
  224. SDK        Various waveforms, 12 bits, Mono, Rate, Loop, Name, Text
  225. AU         1 waveform, 8/16 bits LINEAR/ULAW, Mono, Rate, Text
  226. AIFF       1 waveform, 1..16 bits, Stereo/Mono, Rate, Loop, Name, Text
  227. IFF        1 waveform, 8 bits, Mono, Rate, Name, Text
  228. KRZ        Various waveforms, 16 bits, Mono, Rate, Loop, Name
  229.  
  230.  
  231. Notes:
  232.  
  233. The GKH format accept Giebler Enterprises image format. The first class files
  234. have ".gkh" extension and include various Ensoniq formats. The second class
  235. have ".ed?" extension, where ? is character which indicates disk tipe (e.g.
  236. ".eda" is a ASR disk image file of Giebler Enterprises, ".edt" es a TS-10 disk
  237. image,...). These formats basically are an Ensoniq disk image.  For it, when Convert
  238. has to carry out the conversion to other formats, first the internal files
  239. are converted to MSDOS files (INS) and subsequently the conversion is carried
  240. out. I recommend you use the -OUT option with this format in order to avoid
  241. this process every time this file is accesed.
  242.  
  243. The INS and KRZ formats support multisample instruments , this is, it allows to
  244. assign various waveforms to several ranges of the MIDI keyboard. This feature
  245. is supported upon converting it to PAT if and only if the ranges are not
  246. overlapped. In this way, a complete percussion kit for example would generate
  247. simply one multisample PAT file.
  248.  
  249. The DMF (Delight Music File) format is also supported as input file, but it
  250. is limited to files with uncompressed instruments (if you know the compression
  251. method 1, 2 and 3 please tell me in order to incorporate it). Unfortunately all
  252. files I have in this format are compressed with method 1.
  253.  
  254. KRZ format supports stereo waveforms, but this version of convert don't
  255. recognize it, and some waves are incorrectly converted (sounds at lower pitch).
  256.  
  257.  
  258. GRATEFULNESS
  259.  
  260. I thank the disinterested help of Cris-(tobal) in the previous phase test
  261. and his contribution of formats, as well as all anonymous sources of where
  262. I have gotten the specifications of the formats. I am Sorry for my SPAnglish.
  263.  
  264.  
  265. PETITIONS
  266.  
  267. Since I commented at first, this tool surged with ideas of expansion.  For it
  268. I request to all users that is interested in including other formats to the
  269. program, that they will send to me a description of the format, and if it
  270. is possible, some file(s) for testing.
  271.  
  272. Especially I am VERY INTERESTED in incorporating the EMU SOUNDFONT LIBRARY
  273. format (used in the new Sound Blater (TM) AWE32) (I have seen an AWE32 board
  274. and it have no information about this, although I saw some files like ".sfk",
  275. known as bank files, with a RIFF header ???), as well as other formats
  276. utilized in the new PC WaveTable soundcards (Sample Store from Turtle Beach,
  277. etc...) Also, I would like dispose of information of Yamaha SY-99 and SY-55,
  278. and EMAX I and II.
  279.  
  280. Also, I would desire you mailme any bug or possible improvements of
  281. the program to jvillena@dsic.upv.es
  282.  
  283.  
  284. START NOW
  285.  
  286. To start to delight with new and vibrant sounds, this is a small list
  287. where you will find them through the INTERNET.  Personally, I have more
  288. than 200 Mbytes of this sounds!!!
  289.  
  290. GKH, INS, EFE, AIFF:    ftp.reed.edu in /eps
  291.                         oak.oakland.edu in /pub2/eps
  292. TXW:                    ftp-ls7.informatik.uni-dortmund.de in /pub/tx16w
  293. SDK:                    lotus.UWaterloo.ca in /pub/sgroup
  294. SDS, SDX:               alf.uib.no in /pub/sds
  295.                         sweaty.palm.cri.nz in sds
  296. PAT:                    archive.epas.utoronto.ca in /pub/pc/ultrasound
  297.                         wuarchive.wustl.edu in /systems/ibmpc/ultrasound
  298. KRZ:                    ftp.uwp.edu in /pub/music/lists/kurzweil
  299.                         cs.utk.edu in /pub/martin/K2000
  300.                         bach.nevada.edu in /pub/K2000
  301. EMAX (future):          sweaty.palm.cri.nz in EMAX
  302.  
  303. You will find a wider list on ftp.cs.ruu.nl in the file /pub/MIDI/DOC/archives
  304.  
  305. HAPPY CONVERSION!!!!!
  306.  
  307.