home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / c / cvt2sam2.zip / CVT2SAM.DOC next >
Text File  |  1993-02-15  |  7KB  |  142 lines

  1. ----------------------------------------------------------------------
  2.                Convert to SAM 
  3. ----------------------------------------------------------------------
  4.  
  5.               Version 2.00 (02/15/93)
  6.               Jim Dahl
  7.  
  8. ---------------------------------------
  9. 0. THIS VERSION
  10. ---------------------------------------
  11.  
  12. 1.1 HISTORY. This is the third version (versions 1.00 and 1.10 supported only 
  13. RAW data, requiring a VOC conversion utility to be utilized).  With VOC 
  14. support added, the program has been renamed from RAW2SAM to CVT2SAM to 
  15. demonstrate its multi-format input capabilities.  Future plans include
  16. expanded VOC support (repeat blocks) and WAV support (I have yet been unable 
  17. to obtain the necessary documentation, or WAV support would have been 
  18. included in this version).  Updates will be posted on City Lites BBS (sec 5).
  19.  
  20. 1.2 WHY USE CVT2SAM?  CVT2SAM is provided to you, by me, as a free utility.
  21. I encourage you to use it and copy it.  CVT2SAM, however, is not 'junkware'
  22. (a cheap utility whipped up overnight then sent to the mass markets and left
  23. unsupported), rather it constantly evolves and includes many hours work and
  24. thousands of lines of code.  Each section of code has been rewritten, from
  25. scratch, two or three times to optimize the speed and increase modularity of
  26. the code.  I have heard many comments that the speed of CVT2SAM is amazingly
  27. fast compared to other utilities of the type (though most utilities just strip
  28. the VOC header and treat the rest as raw data, rather than processing the
  29. individual blocks in blocked VOC's).  
  30.  
  31. ---------------------------------------
  32. 1. PURPOSE
  33. ---------------------------------------
  34.  
  35. CVT2SAM.EXE converts raw sound files and VOC files to .SAM files
  36. suitable for use in ModEdit.  Most types of VOC files and all raw
  37. sound types work with CVT2SAM.  If the CTV format is not recognized,
  38. the type will be assumed to be a raw sample, so unknown formats, such as
  39. Microsoft's WAV format, will not be converted correctly.
  40.  
  41. ---------------------------------------
  42. 2. USAGE
  43. ---------------------------------------
  44.  
  45. After typing 'CVT2SAM' on the command line, the program will prompt for
  46. an input file name and an output file name.  The output file name will
  47. default to the first eight characters of the input file name with a '.SAM'
  48. extension.
  49.  
  50. Instead of using the interactive mode, the user can also type:
  51.  
  52.      CVT2SAM  [InFile] [OutFile] [-?] [-C]
  53.  
  54. If both an input file and an output file are specified, the program will
  55. execute the conversion.  If only an input file is specified, the program
  56. will prompt for an output file, with a default value of the first eight
  57. characters of the input file name with a '.SAM' extension.
  58.  
  59. It is recommended that the '.SAM' extension be used, as ModEdit will only
  60. recognize those samples which have an '.SAM' extension.
  61.  
  62. CVT2SAM assumes that the OutFile should be overwritten if it already exists
  63. and therefore does not prompt or warn the user.
  64.  
  65. The '-?' option brings up a short help screen.  The '-C' option instructs
  66. the CTV converter to convert even compressed data (see note in section 4.3).
  67.  
  68. --------------------------------------*
  69. 3. FUNCTION
  70. --------------------------------------*
  71.  
  72. 3.1 WHAT DOES CVT2SAM DO?  CVT2SAM converts the sound data from the input 
  73. file from unsigned to signed sound data.  (Most popular sound types, 
  74. including VOC files, use unsigned data; SAM files use signed data).  CVT2SAM 
  75. also recognizes CTV block types headers and performs the appropriate action 
  76. to convert the blocks to raw sound data when possible.
  77.  
  78. 3.2 HOW EFFICIENT IS CVT2SAM?  CVT2SAM was written in assembly, then PKLITE'd 
  79. so it is very compact and time efficient.  (This version was initially 
  80. ready for release over a month before the actual date of release, but I 
  81. pushed back the date to completely rewrite the VOC conversion routines).  
  82.  
  83. --------------------------------------*
  84. 4. USAGE TIPS - RAW and VOC FILES
  85. --------------------------------------*
  86.  
  87. 4.1 VOC SAMPLING RATES.  A rate of 8000hz corresponds to C2 in ModEdit, 
  88. the default instrument pitch.  However, with ModEdit 3, you can adjust the
  89. rate of each sample at playback or loading time, therefore all VOC speeds
  90. and sampling rates can be used.
  91.  
  92. 4.2 VOC BLOCK TYPES.  This version of CVT2SAM recognizes VOC file structure 
  93. and all current block types.  Silence blocks are expanded; new data and 
  94. consecutive data blocks are converted, marker blocks are discarded, message 
  95. blocks are displayed on the screen, and repeat blocks are ignored at this 
  96. time.
  97.  
  98. 4.3 VOC COMPRESSION.  As the hardware compression feature of the Sound 
  99. Blaster actually discards data from the VOC, compressed VOC files are not 
  100. supported.  If you do not have or can not obtain a decompressed copy of the 
  101. VOC file, use the -C switch to tell CVT2SAM to convert compressed data as 
  102. well (though bear in mind that the actual decompression of it is done by the 
  103. hardware at playback time only if the sound is in VOC format, so by 
  104. converting a 2:1 compressed VOC sampled at 8000hz, you would be left with a 
  105. much poorer quality 4000hz SAM file.  That is why hardware compression is 
  106. NOT supported by default, and not recommended).
  107.  
  108. 4.4 NEW VOC TYPES.  Stereo VOC blocks can not be used, as the SAM format 
  109. does not support stereo and there is no comfortable way to convert a 
  110. stereo sample to a mono sample.  As I gain information of other new block
  111. types, I will address them and include them if appropriate.
  112.  
  113. ----------------------------------------
  114. 5. SUPPORT
  115. ----------------------------------------
  116.  
  117. ** In testing VOC files (over 500 passed successfully through), I encountered
  118. only one error (and have now misplaced the VOC file).  I am, however,
  119. completely unable to duplicate the error, so I suspect it was a faulty VOC.
  120. If, however, you should have any strange behavior or problems, PLEASE contact
  121. me and send me the VOC file!  The particular error was that during processing
  122. the screen filled with extended ASCII characters then the system locked up.
  123.  
  124. I can be contacted at:
  125.  
  126. Internet
  127.     JADAHL@VM1.NoDak.Edu
  128.  
  129. City Lites BBS
  130.     (701) 775-1143  (2400- baud)
  131.     (701) 772-5399  (9600+ baud)
  132.     Jim Dahl
  133.  
  134. Home
  135.     Jim Dahl
  136.     2236 Springbrook Ct.
  137.     Grand Forks, ND 58201
  138.  
  139. Feel free to contact me with any questions/comments (particularly error
  140. reports!)  If for some reason you want the source code, no problem, just
  141. get in touch.
  142.