home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / maj / 2399 / modm_eng.doc < prev    next >
Text File  |  1994-06-01  |  21KB  |  499 lines
  1. ┌─────────────────────────────────────────────────────────────────────────────┐
  2. │ ███▀▀██▀▀██            ██     ███▀▀██▀▀██ ▄▄▄▄▄▄ ▄▄▄▄▄▄ ███   ▄▄▄▄▄▄ ▄▄▄▄▄▄ │
  3. │ ███  ██  ██ ██▀▀██ ██▀▀██     ███  ██  ██ ▄▄▄▄██ ███▄▄▄ ███▀▀ ██▄▄██ ███ ▀▀ │
  4. │ ███  ██  ██ ██▄▄██ ██▄▄██     ███  ██  ██ ██▄▄██ ▄▄▄▄██ ███▄▄ ██▄▄▄▄ ███    │
  5. │                                                                             │
  6. │                               - VERSION 2.0 -                               │
  7. │                                                                             │
  8. │                  (c) 1994 Freddy VETELE & Fabrice COUTEAU                   │
  9. └─────────────────────────────────────────────────────────────────────────────┘
  10.  
  11.  
  12.    As his name shows it, Mod Master allows to play the Amiga MOD music files,
  13.    but it also accepts the NST, WOW, STM and Fast Tracker 6 & 8 voices files.
  14.  
  15.    If you want to use Mod Master without waiting for more, just run the program
  16.    MODM and set the type of sound output that you like. However, if you have
  17.    a Sound Blaster or Sound Blaster Pro card, it will automatically be detected
  18.    and set.
  19.  
  20.    When you quit Mod Master, your personal configuration is saved in the
  21.    MODM.CFG file.
  22.  
  23.  
  24.    Minimal configuration:     A PC/XT compatible 8 MHz
  25.    ~~~~~~~~~~~~~~~~~~~~~~     512 Ko RAM
  26.                               A color CGA screen.
  27.  
  28.       For this type of configuration, it is not possible to play 6 or 8-voice
  29.        modules and the sound quality is more than poor (unless you have a
  30.        sound card).
  31.  
  32.  
  33.    Recommanded configuration:  An AT 386 16 MHz
  34.    ~~~~~~~~~~~~~~~~~~~~~~~~~~  1 Mo RAM
  35.                                A compatible Sound Blaster sound card
  36.                                A color VGA screen.
  37.  
  38.  
  39.  
  40.  I. Description of the program
  41.  ═════════════════════════════
  42.  
  43.      Mod Master v2.0 is made of three parts:
  44.  
  45.        1) The interface for the settings and choosing the modules.
  46.        2) The text-mode screen while playing.
  47.        3) The graphic-mode screen (VGA) while playing.
  48.  
  49.  
  50.    1) Settings and choosing the modules
  51.    ────────────────────────────────────
  52.  
  53.       This interface is very easy to use:
  54.  
  55.      - on the left, the lift permits to choose one module (with the Return key
  56.         or the left button of the mouse) or to select a list of modules to make
  57.         a program (Space key or right button of the mouse).
  58.  
  59.      - on the right, some buttons which effects are:
  60.  
  61.          Settings: displays a window inside which you can choose:
  62.         -----------
  63.  
  64.              a) The sound output in the following list:
  65.  
  66.                    Internal speaker (ouch!)
  67.                    Digital-analog converter on port LPT1 or LPT2
  68.                    Sound Blaster 2.0
  69.                    Sound Blaster Pro (Mono or Stereo)
  70.                    Sound Master (compatible Adlib card)
  71.                    Disney Sound Source (on port LPT1 or LPT2)
  72.  
  73.              b) The output frequency: from 5000 Hz to 44100 Hz, depending on
  74.                 the sound output selected, the power of your PC and the
  75.                 number of voices in the module (from 4 to 8).
  76.  
  77.              c) The general volume: from 1 to 100%, it should be increased in
  78.                 order to hear correctly some low-volume modules.
  79.                 Since each sample is digitalized on 8 bits (values from 0 to
  80.                 255), the technique used to return simultaneously 4 samples
  81.                 consists in dividing the amplitude of each instrument by 4
  82.                 (with 4 voices, you obtain values from 0 to 1023, therefore
  83.                 coded on 10 bits).
  84.                 In fact, the general volume is the coefficient put on each
  85.                 sample, then you can adjust at best the amplitude of each
  86.                 instrument to keep the maximum of precision in the calculations.
  87.                 This coefficient is above 1/4th, because it is unusual to find
  88.                 modules that have a volume close to the maximum allowed on
  89.                 8 bits.
  90.  
  91.                  Note: for the stereo, the general volume is automatically
  92.                         multiplied by 2, so that the sound quality is higher
  93.                         (the calculations are at least on 9 bits).
  94.  
  95.                 Warning! If the general volume is too high, you will hear some
  96.                 ~~~~~~~~ very unpleasant cracks in the sound, due to capacity
  97.                          overflows.
  98.  
  99.                 The default general volume (about 40%) is foreseen to avoid
  100.                 any crack with most of the modules.
  101.  
  102.              d) The IntroScan length: from 2 to 30 seconds.
  103.  
  104.  
  105.            If you have a compatible Sound Blaster or SB Pro card, you can
  106.            accede to the following settings with the Options button:
  107.  
  108.                 - Sound output by the DMA or by Timer-interrupt:
  109.  
  110.                       The output by the DMA (default) is recommanded to obtain
  111.                       a better sound quality with a higher frequency than the
  112.                       output by Timer-interrupt.
  113.  
  114.                 - Interruption number (if DMA): 2, 5 or 7.
  115.  
  116.                 - Mono or Stereo (for the Sound Blaster Pro only!)
  117.  
  118.                 - Stereo with mixing:
  119.  
  120.                      Without mixing, the voices of a 4-voice module (for
  121.                       example) are divided as follow:
  122.                       2 voices through the left channel and 2 voices through
  123.                       the right channel, with the same coefficient assigned for
  124.                       each channel.
  125.  
  126.                      With mixing, the 2 voices that are sent through the left
  127.                       channel are also sent through the right channel, but with
  128.                       a lower coefficient. The same for the right channel.
  129.  
  130.                    This option is useful if you listen to the music with head-
  131.                    phones or on a Hi-Fi system (better sharing).
  132.  
  133.                 - High frequencies filter (for the Sound Blaster Pro only!)
  134.  
  135.                 - Separate left/right channels volumes (SB Pro).
  136.  
  137.  
  138.          IntroScan:
  139.         ------------
  140.  
  141.              Well known to the audiophiles, this function allows to hear the
  142.              first seconds of several modules.
  143.              If there is no program, all of the modules are selected, otherwise
  144.              the function works on the program only.
  145.              While playing a module, you can disable this function by hitting
  146.              'I', so you will hear the whole module.
  147.  
  148.  
  149.          Shuffle:
  150.         ----------
  151.  
  152.              This is also a classic function found on most of the CD-players:
  153.              it allows to play a program or the whole of the modules in a
  154.              random order.
  155.              If there is no program, all of the modules are selected, otherwise
  156.              the function works on the program only.
  157.  
  158.  
  159.          Actions on the programs: Play, All, Clear, Load, Save.
  160.         --------------------------------------------------------
  161.  
  162.              It's up to you to find out the rule of these buttons!
  163.  
  164.    
  165.          Help: Displays a short summary of the functions in the interface.
  166.         -------
  167.  
  168.  
  169.          Quit: To use the less often, this button quits Mod Master!
  170.         -------
  171.  
  172.  
  173.  
  174.    2) The text-mode screen while playing
  175.    ─────────────────────────────────────
  176.  
  177.     - At the top, first line:
  178.        The name of the module (possibly its order in a program), its total
  179.        (and exact!) length and the playing-time (chronometer or count-down).
  180.  
  181.     - At the top, in the middle:
  182.        The title of the module, its number of instruments and voices, the
  183.        current position and the number of positions, the number of the note
  184.        in the pattern and the volume.
  185.  
  186.     - At the top, on the left:
  187.        The pitch-bars for each voice (4 voices simultaneously).
  188.  
  189.     - At the top, on the right:
  190.        The period-bars (or note-bars) for each voice (4 voices simultaneously).
  191.  
  192.     - At the bottom:
  193.        You have the choice between displaying the instruments list or
  194.        the partition (4 voices simultaneously).
  195.  
  196.         The partition displays for each voice:
  197.          - the number of the instrument,
  198.          - the note (English, French or Amiga period),
  199.          - the effect and its parameter.
  200.  
  201.         The effects implemented by Mod Master v2.0 are:
  202.  
  203.           0: Arpeggio
  204.           1: Portamento Up
  205.           2: Portamento Down
  206.           3: Tone Portamento
  207.           4: Vibrato
  208.           5: Tone Portamento + Volume Slide
  209.           6: Vibrato + Volume Slide
  210.           A: Volume Slide
  211.           B: Jump Pattern
  212.           C: Set Volume
  213.           D: Pattern Break (works only if the looping(*) is enabled)
  214.           F: Set Tempo
  215.  
  216.     - While playing, you can display a help-screen by hitting F1, and swap the
  217.       text and graphic screens by hitting F6.
  218.  
  219.  
  220.    3) The graphic-mode screen while playing
  221.    ────────────────────────────────────────
  222.  
  223.      If you are the happy owner of a color VGA card, you will be able to enjoy
  224.      this new feature that we let you discover!
  225.  
  226.  
  227.      (*) looping: While playing a module, you can enable/disable this option
  228.                   by hitting 'R' ('Repeat' is displayed in text mode and a
  229.                   symbol is lit in graphic mode).
  230.                   If the looping is set, the module loops on itself when ending
  231.                   (the music resumes either at the beginning or at another
  232.                   position, depending on the module), and forward and backward
  233.                   jumps ('PosJmp' in the partition) are allowed.
  234.  
  235.  
  236.  
  237.  II. Running the program with a command line
  238.  ═══════════════════════════════════════════
  239.  
  240.      The different syntaxes are:
  241.                                                                                 
  242.         MODM module_name[.MOD]    Plays the specified MOD module (default)
  243.         MODM module_name.ext      Plays the specified NST, WOW or STM module
  244.         MODM program_name[.PRG]   Plays the specified program
  245.  
  246.      If you have any doubt, hit MODM ?
  247.                                                                           
  248.  
  249.  
  250.  III. Compatibility and performances
  251.  ═══════════════════════════════════
  252.  
  253.      Mod Master v2.0 has been tested on the following machines:
  254.  
  255.       - Amstrad PC 1512 (5400 Hz on Sound Blaster, by interruption and 4 voices)
  256.       - AT 286: Bull Micral 45 (17000 Hz for 4 voices, 10000 Hz for 8 voices)
  257.       - AT 386DX/40 (44100 Hz on Sound Blaster Pro, by the DMA and 8 voices)
  258.       - AT 486SX/25 (idem)
  259.       - AT 486DX/33 and 40 (idem)
  260.       - AT 486DX2/66 (idem)
  261.  
  262.      Sound outputs tested:
  263.  
  264.       - Internal speaker (not too long...)
  265.       - D/A converter on parallel port (the one shown at the end of this file)
  266.       - Sound Blaster 2.0
  267.       - Sound Blaster Pro 2.0
  268.       - Sound Galaxy NX
  269.       - Sound Galaxy NX Pro
  270.       - Sound Master Boomer
  271.       - Sound Master
  272.       - Audio Sound 16
  273.       - Melody PC
  274.  
  275.  
  276.  
  277.  IV. Improvements since the version 1.0
  278.  ══════════════════════════════════════
  279.  
  280.       - text-mode interface with lift, windows, buttons...
  281.       - mouse support (2 buttons),
  282.       - improvement of the screen while playing (text and graphic),
  283.       - possibility to play programs,
  284.       - recognizes the WOW, STM and 8 voice-MOD formats,
  285.       - more sound outputs (Sound Blaster Pro included),
  286.       - uses the DMA in Mono or Stereo up to 44kHz,
  287.       - auto-detection of the Sound Blaster port (220h, 230h, ...),
  288.       - correction of the effects Arpeggio and Tone Portamento + Volume Slide,
  289.       - displays the partition with choice of the type of note,
  290.       - calculates the exact length of the module.
  291.  
  292.  
  293.  
  294.  V. Problems, causes and solutions
  295.  ═════════════════════════════════
  296.  
  297.      Problem: I run the playing of a module and my PC slows down or freezes.
  298.      ────────
  299.  
  300.      Causes & solutions:
  301.      ───────────────────
  302.  
  303.         1) The output frequency is too high for your PC.
  304.            -> Decrease the frequency of a few kHz.
  305.  
  306.         2) You are trying to run Mod Master under Windows.
  307.            -> It is not recommanded to run Mod Master under Windows, because
  308.               the memory or DMA conflicts entail some slowing-downs or
  309.               weird behaviors. Go back to DOS!
  310.  
  311.         3) Your PC is relatively slow, and you are using the EMS.
  312.            -> On a quite slow PC (386 SX), working with the EMS memory highly
  313.               slows down the running of the foreground program.
  314.               Remove the EMM386 (or equivalent) manager in your CONFIG.SYS file,
  315.               then reboot your system.
  316.  
  317.         4) The interrupt number is wrong (with the DMA only).
  318.            -> Check up if the interrupt number (IRQ) shown in the
  319.               Settings/Options window corresponds with the one used by your
  320.               sound card.
  321.  
  322.      ----------------------------------------------------------------------
  323.  
  324.      Problem: I hear some cracks while playing a module.
  325.      ────────
  326.  
  327.      Cause & solution:
  328.      ─────────────────
  329.  
  330.            The general volume is too high.
  331.            -> Reduce the general volume (about 40% is a mean value).
  332.  
  333.      ----------------------------------------------------------------------
  334.  
  335.      Problem: There are some parasites in the graphic screen ('snow').
  336.      ────────
  337.  
  338.      Cause & solution:
  339.      ─────────────────
  340.  
  341.            You are listening to a module by Timer interrupt.
  342.            -> When the sound output is not done by the DMA, displaying in the
  343.               graphic mode is slower than in the text mode, because of the
  344.               loops done periodically to avoid the 'snow' effect when changing
  345.               the colors. Go back in the text mode!
  346.  
  347.      ----------------------------------------------------------------------
  348.  
  349.      Problem: Your drive containing the modules is not recognized.
  350.      ────────
  351.  
  352.      Cause & solution:
  353.      ─────────────────
  354.                                                 
  355.            -> Logical units may be: a partly compressed hard disk (Stacker,
  356.               Double Space, ...), a RAM disk or a CD-ROM drive.
  357.               Run Mod Master from these drives.
  358.  
  359.      ----------------------------------------------------------------------
  360.  
  361.  
  362.  
  363.  VI. Information and miscellaneous
  364.  ═════════════════════════════════
  365.      
  366.         1) Who are we?
  367.         ──────────────
  368.  
  369.                 - Freddy Vételé: I am 20 years old, I am a student in a
  370.                         public school (electronics and computer) in Angers.
  371.                         My first computing experience was on a prehistorical
  372.                         machine: the TI 99 (Texas Instruments), then I have
  373.                         bought a PC 1512 (Amstrad), with that I have programmed
  374.                         the first version of Mod Master. Now, I spend the most
  375.                         of my freetime on a 486DX/33, that allowed me to realize
  376.                         this new version.
  377.                         I have set up the sound calculations routines, the
  378.                         sound output routines, in fact, all that concerns music!
  379.  
  380.                 - Fabrice Couteau: I am 21 years old and a student in the same
  381.                         school as Freddy (!). I have discovered computers in
  382.                         1987 with a PC 1512 (again!), then I preferred a
  383.                         486DX/40 a few months ago.
  384.                         Freddy asked me to improve the interface of Mod Master
  385.                         (indeed, the one of Mod Master 1.0 was quite poor!),
  386.                         so I have done it in adding mouse support, using of
  387.                         windows, buttons, lifts... in the menu. I have also
  388.                         rearranged the two screens (text and graphic) displayed
  389.                         while listening to a module.
  390.  
  391.  
  392.         2) Mod Master in numbers
  393.         ────────────────────────
  394.  
  395.                 - more than a year of programming (with pauses!)
  396.                 - 7200 lines of Assembly source (compiled with TASM 3.2)
  397.                 - 2800 lines of Turbo-Pascal source (compiled with TP 7.0)
  398.  
  399.  
  400.         3) Greetings
  401.         ────────────
  402.  
  403.              We would like to thank all of those who have helped us, by their
  404.              support informations or critics, to end this project:
  405.  
  406.              Richard Perdriau, Vincent Grenier, Vincent Piocel,
  407.              Denis Panaget, Nicolas Rocher, Romaric Maillard.
  408.  
  409.  
  410.         4) Shareware
  411.         ────────────
  412.  
  413.              Mod Master v2.0 is distributed as shareware, so you have to
  414.              register if you keep it and use it often. To register, print the
  415.              MODM_ENG.FRM form (or send a letter) with your payment of 50 FRF
  416.              or $10 to:
  417.  
  418.                         Freddy Vételé
  419.                         La Pohuère
  420.                         49530 Bouzillé
  421.                         FRANCE
  422.  
  423.               When you register, you get a 3½" or 5"¼ diskette with the latest
  424.               version of Mod Master (with some new features and modules) and
  425.               you will not have to register it.
  426.  
  427.               If you have remarks about Mod Master (if you find bugs, for
  428.               example!), or if you have useful informations for us to know
  429.               (modules formats -compressed or not-, programming new sound cards
  430.               -Sound Blaster 16 ASP, Gravis Ultra Sound-, ...), just send me
  431.               a letter to the address above!
  432.  
  433.  
  434.         5) Files supplied with Mod Master
  435.         ─────────────────────────────────
  436.                                                                   
  437.               - MODM_ENG.DOC ········ this file!
  438.               - MODM_ENG.EXE ········ Mod Master v2.0 in English
  439.               - MODM_ENG.FRM ········ the registration form in English
  440.               - MODM.DOC ············ the documentation in French
  441.               - MODM.EXE ············ Mod Master v2.0 in French
  442.               - MODM.FRM ············ the registration form in French
  443.               - ATOMIC2.MOD ········· an 8-voice module
  444.               - ROTATE.STM ·········· a module in STM format
  445.               - FILE_ID.DIZ ········· a short description of the program
  446.  
  447.  
  448.         6) Lisense and warranty
  449.         ───────────────────────
  450.  
  451.              You can copy and distribute Mod Master freely, provided that
  452.               you do not modify anything in the files supplied (DOC, EXE, FRM).
  453.              We would not be responsible for possible damage caused by this
  454.               kind of modifications...
  455.  
  456.  
  457.         7) Digital-analog converter
  458.         ───────────────────────────
  459.  
  460.             We give you the circuit of a very simple and cheap D/A converter
  461.             that plugs into the parallel port, and that you will have to link
  462.             to an amplifier input.
  463.             You need 18 resistors (tolerance: 1% preferably, 5% maximum),
  464.             2 capacitors, a male D-25 connector and a female jack (or two CINCH
  465.             or RCA, if your amplifier has two separate inputs).
  466.                             
  467.  
  468.           Parallel port
  469.  
  470.           signal   pin
  471.                               20kΩ   20kΩ
  472.           D0       2      >───████─┬─████── 0 Volt (GND, pin 20)
  473.                               20kΩ █ 10kΩ
  474.           D1       3      >───████─┤
  475.                               20kΩ █ 10kΩ
  476.           D2       4      >───████─┤
  477.                               20kΩ █ 10kΩ
  478.           D3       5      >───████─┤
  479.                               20kΩ █ 10kΩ
  480.           D4       6      >───████─┤
  481.                               20kΩ █ 10kΩ
  482.           D5       7      >───████─┤
  483.                               20kΩ █ 10kΩ
  484.           D6       8      >───████─┤
  485.                               20kΩ █ 10kΩ
  486.           D7       9      >───████─┤
  487.                               20kΩ █ 10kΩ  100nF
  488.                                    ├────────┤├──┬───────> To amplifier
  489.                                    │            │
  490.                                    █ 10kΩ      ─┴─ 10nF
  491.                                    │           ─┬─
  492.           GND      20     >────────┼────────────┴───────> Ground
  493.                                    0 Volt
  494.  
  495.  
  496. This circuit has been borrowed in the DOC file of Visual Player 2.0 (an
  497. excellent software, moreover!), so we thank his creator: Luis Ubeda.
  498.  
  499.