home *** CD-ROM | disk | FTP | other *** search
/ Collection of Hack-Phreak Scene Programs / cleanhpvac.zip / cleanhpvac / CMF2MID.ZIP / CMF2MID.DOC < prev    next >
Text File  |  1991-07-05  |  3KB  |  98 lines
  1.  
  2.                 CMF2MID
  3.             Version 1.0   July 5, 1991
  4.              (C) 1991 Adam Mirowski
  5.               Portions (C) 1991 Tim Thompson
  6.  
  7.  
  8. Purpose
  9. -------
  10.  
  11. CMF2MID converts Sound Blaster CMF files into format 0 standard MIDI files.
  12.  
  13.  
  14. Features
  15. --------
  16.  
  17. CMF2MID supports CMF format versions 1.0 and 1.1.
  18.  
  19. In the process of conversion, note durations aren't touched, to avoid all
  20. aliasing. Required tempo is obtained by adjusting the midifile quarter note
  21. division. If the CMF file doesn't contain explicit tempo indication, a
  22. division of 96 is taken, and the midifile tempo set accordingly. The tempo
  23. can also be externally imposed.
  24.  
  25. Instruments are recognized accordingly to an internal database of about 1000
  26. sounds. Their names aren't explicited in CMF files.
  27.  
  28. Instrument information can be converted into appropriate program/note/channel
  29. and volume changes if you provide directives in an external .CMM file, named
  30. after the CMF file. This file is automatically used when present.
  31. Its contents depends on the synthesizer you want to play the midifile on,
  32. so you must do it yourself. You won't get interesting output unless you use
  33. it.
  34.  
  35. CMF header information can be displayed.
  36.  
  37. Various checks and optimizations of the MIDI file output are performed.
  38.  
  39.  
  40. Usage details
  41. -------------
  42.  
  43. Entering CMF2MID at DOS prompt displays usage instructions.
  44.  
  45. A .CMM file is a text file composed of lines of the following form:
  46.  
  47. instr-#  midi-channel  midi-note  midi-prog-change  volume-adjustment remarks
  48. 0->...        -1->15    -1->127       -1->127           0->100->...
  49.  
  50.  
  51. -1 values mean "don't change".
  52. Volume adjustments are percentages. They are not mandatory. Use 0 to
  53. shut off an instrument.
  54. Lines starting with ";"s are not interpreted.
  55.  
  56. Currently, only 2 variants are allowed for the lines:
  57.  
  58.     ins-number     -1         -1        program<>-1     ...
  59.     ins-number  chan<>-1   note<>-1         -1          ...
  60.  
  61. The second type is for drums, which at least on my (extremely modest)
  62. equipment, must go to a predefined channel. If you see a need for another
  63. formats, let me know.
  64.  
  65.  
  66. Remarks
  67. -------
  68.  
  69. If you want to convert ROL files into MIDI files, use rol2cmf first. Must
  70. CMF files are converted ROLs.
  71.  
  72. There will soon be new versions of the CMF file format, I think, because
  73. new hardware is to be released in August, so if you want CMF2MID process
  74. them, send me the specs or some new files (and preferably a program to play
  75. them...).
  76.  
  77. CMF2MID contains code from Tim Thompson's Midifile decoder.
  78.  
  79. CMF2MID version 1.0 is free for any usage.
  80.  
  81.  
  82. Author
  83. ------
  84.  
  85. I can be reached by e-mail as mir@chorus.fr
  86. by phone at: +33 (1) 30-64-82-00
  87. or at:
  88.  
  89. M. Adam Mirowski
  90. c/o Chorus systèmes
  91. 6, av. Gustave Eiffel
  92. F-78182 Saint-Quentin-en-Yvelines CEDEX
  93. FRANCE
  94.  
  95. or leave me a message in the 'PCM' (5) conference at the "SOS Micro" BBS
  96. phone: +33 (1) 46-21-32-70  (France!)
  97.  
  98.