home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / NEWS / 271 / PROTRACK / BPT.DOC next >
Text File  |  1993-10-07  |  13KB  |  329 lines
  1. Distribution site for USA : 602-8670488 The Point Of know Return
  2.  
  3.                      Europ: 00-32-2-377.99.25 Exocet BBS
  4.  
  5.                            B's Pro Tracker   (BPT)
  6.  
  7.                                 Version 0.05ß2
  8.  
  9.  
  10.                               Copyright 1990,1991
  11.                                    Kim Heino
  12.  
  13.  
  14.                               All rights reserved.
  15.  
  16.  
  17. ===============================================================================
  18.  
  19.  
  20.         Contents of this manual:
  21.  
  22. 1       General information
  23. 2       Commands
  24. 2.2     Hotkeys
  25. 3       Setup
  26. 4       Technical information
  27. 5       Last words, version information
  28. 5.1     Last words
  29. 5.2     Version information
  30.  
  31.  
  32. ===============================================================================
  33.  
  34.  
  35. 1       General information
  36.  
  37.         BPT is a music module editor and player for IBM PC and
  38.         compatibles. It requires EGA or VGA display adapter and 256kB of
  39.         memory. More memory (up to 640kB), VGA and a fast computer are
  40.         recommended. BPT supports JDAC (or other D/A converter), Sound
  41.         Blaster card (8086 and 80386 modes), Roland MPU-401-compatible
  42.         MIDI interface (Roland MT-32, Roland LAPC-1), Akai Professional
  43.         Sampling Keyboard X7000 (with MIDI), Akai Professional Sampler
  44.         S700 (with MIDI), BriteSounds' stereo-DAC card and the PC
  45.         internal speaker. BPT can load BPM-modules, BPS-songs,
  46.         BPP-patterns, BWC-samples, STM-modules, STS-songs, MTM-modules,
  47.         MTS-songs and MOD-modules and it can save BPM-modules,
  48.         BPS-songs, BPP-patterns, BWC-samples and MOD-modules,
  49.  
  50.         JDAC is a simple 8 bit D/A-converter to be connected to your 
  51.         parallel port. Also a product called Covox Speech Thing seems to 
  52.         be compatible with the JDAC. It is possible to use it with BPT.
  53.  
  54.         The internal speaker routine plays the modules only with 6 bits.
  55.         It is IBM's fault! Another internal speaker playing routines,
  56.         like RealSound, plays the samples just like I do. But BPT
  57.         converts the 8 bit data to 6 bit in real-time to get the best
  58.         result. Note that you can easily hang your computer by playing
  59.         modules with too high PHertz.
  60.  
  61.         MPU-MIDI routine uses your synths original instruments. PHertz 
  62.         and IHertz doesn't affect to MIDI, the playing speed is always 
  63.         768 hertz. If you have Akai sampler you can dump some or all of 
  64.         the samples to Akai and BPT commands Akai to play them. Note 
  65.         that you can use Roland MT-32 / LAPC-1 and Akai simultaneus! 
  66.         IHertz should be near to some value Akai supports.
  67.         
  68.         Don't panic if you find some undocumented features in BPT. Just
  69.         report them to me and they will be mentioned in the future
  70.         versions.
  71.  
  72.         And remember, if you want to get good background music buy
  73.         CD-player!
  74.  
  75.  
  76. 2       Commands
  77.  
  78.         Try everything! This is beta-version, you can't expect the full
  79.         documents yet, do you?
  80.  
  81.         Just few things:
  82.  
  83.         BPT is buggy!
  84.  
  85.         Try all and see what happens. All the commands are found from
  86.         the menus.
  87.  
  88.         You can specify the playing speed by changing PHertz (Alt-H).
  89.         Trying to play too fast will hang your computer. But it also
  90.         sounds better. My 386/33 plays in 25000Hz without problems.
  91.         For PC, 4000Hz may be too much!
  92.  
  93.         Tempo (Alt-T) is given in BPM (Beats Per Minute) as in MIDI. If
  94.         you change the tempo in moduledata (command "A") it is given in
  95.         timebase-format (96=120BPM, 48=240BPM).
  96.  
  97.         Command A (set tempo), B (go to) and C (break) are the only
  98.         supported commands at this time.
  99.  
  100.         First row is notes, then instruments, commands and note volumes.
  101.  
  102.         You can press enter to "Filename?"-prompt to get a list of the
  103.         available files.
  104.  
  105.  
  106.         Sample/Memory:
  107.  
  108.         +----------------------------------------------------------+
  109.         |                                                          |
  110.         |  00:                 00000B  100%  ----- -----  --  ---  |
  111.         |  01: lzsynth.snd     10405B  078%  00435 10000  03  ---  |
  112.         |  02: yeah            34594B  100%  ----- ----- *13  ---  |
  113.         |  03: hihat           02045B  060%  ----- -----  10  C 4  |
  114.  
  115.            ^^  ^^^^^^^^^^^^    ^^^^^   ^^^   ^^^^^ ^^^^^ ^^^  ^^^
  116.            1   2               3       4     5     6     78   9
  117.  
  118.         1 = Instrument number
  119.         2 = Instrument name
  120.         3 = Size in bytes
  121.         4 = Volume (0-255%)
  122.         5 = Loop begin offset, "-----" means no loop
  123.         6 = Loop end offset
  124.         7 = An asterisk means dump this instrument to Akai
  125.         8 = MIDI channel for this instrument, "--" means none
  126.         9 = Fixed note for this instrument, "---" means normal
  127.         
  128.  
  129.         Program Changes per MIDI channels can be configured in 
  130.         Sample/Program.
  131.  
  132.         And remember, Real Programmers do it in hex!
  133.  
  134.  
  135. 2.2     Hotkeys
  136.  
  137.         This is the list of the hotkeys:
  138.  
  139.         Key             Meaning
  140.         ---------------------------------------------------------------
  141.         Alt-1           Toggle track 1 on/off
  142.         Alt-2           Toggle track 2 on/off
  143.         Alt-3           Toggle track 3 on/off
  144.         Alt-4           Toggle track 4 on/off
  145.         Alt-A           Toggle arrange on/off
  146.         Alt-B           Bosskey
  147.         Alt-C           Copy
  148.         Alt-G           Toggle trace on/off
  149.         Alt-H           Change PHertz
  150.         Alt-I           Change IHertz
  151.         Alt-L           Load BPM-module
  152.         Alt-M           Samples in memory
  153.         Alt-O           Change output
  154.         Alt-P           Play
  155.         Alt-S           Stop playing
  156.         Alt-T           Change tempo
  157.         Alt-V           Change volume
  158.         Alt-W           Save BPM-module
  159.         Alt-X           Exit
  160.         Backspace       Scroll one char left
  161.         Ctrl-Backspace  Delete one noteline below the cursor
  162.         Cursor keys     Move cursor
  163.         DEL             Previous pattern
  164.         ESC             Go to menus, last selected
  165.         Enter           Next line
  166.         F1              Edit notes
  167.         F2              Edit orders
  168.         F3              Edit sample names
  169.         F4              Go to menus, File
  170.         F5              Go to menus, Play
  171.         F6              Go to menus, Edit
  172.         F7              Go to menus, Samples
  173.         F8              Go to menus, Options
  174.         F9              Go to menus, SetUp
  175.         F10             Go to menus, last selected
  176.         INS             Next pattern
  177.         PgDn            Move down fast
  178.         PgUp            Move up fast
  179.         Tab             Next channel / next samplerow
  180.  
  181.  
  182. 3       Setup
  183.  
  184.         You can specify the output in the command line. Type "BPT /?"
  185.         for help. And there's a setup-menu in BPT's menu structure. All
  186.         the setups can be saved with "Save setup"-command.
  187.  
  188.  
  189. 4       Technical information
  190.  
  191.         BPM/BPS file format version #01:
  192.  
  193.         Offset  Meaning
  194.         0000    (32 char) Song/Filename
  195.         0032    (byte) File type: bit 0-6 = file version
  196.                                   bit 7   = song (0) / module (1)
  197.         0033    (8 char) Tracker name
  198.         0041    (word) Tempo hi
  199.         0043    (word) Tempo lo
  200.         0045    (word) IHertz
  201.         0047    (byte) Signature hi
  202.         0048    (byte) Signature lo
  203.         0049    Instruments (0-1F)
  204.                 Offset  Meaning
  205.                 0000    (12 char) Filename
  206.                 0012    (word) Length
  207.                 0014    (byte) Volume
  208.                 0015    (word) Loop begin
  209.                 0017    (word) Loop end
  210.                 0019    (byte) bit 0-3 = MIDI channel
  211.                                bit 4-5 = free
  212.                                bit 6   = Dump to sampler (1)
  213.                                bit 7   = Play (0)
  214.                 0020    (byte) 00-7F: Fixed note (00=None)
  215.         0721    (16 byte) Program Changes for MIDI-channels
  216.         0737    (byte) Patterns saved
  217.         0738    (255 byte) Pattern orders
  218.         0993    Extra infos
  219.                 Offset  Meaning
  220.                 0000    (byte) Number of bytes in info,
  221.                                if zero then go to Pattern #0 name
  222.                                directly
  223.                 0001    (byte) Info type (00=Text)
  224.                 0002    (??? byte) Info
  225.         ????    (10 char) Pattern #0 name
  226.         [????]  Patterns
  227.                 Offset  Meaning
  228.                 0000    (10 char) Name
  229.                 0010    (word) Length
  230.                 0012    Notes
  231.                         Offset  Meaning
  232.                         0000    bit 0-3 = note (0=C, 1=C# ... 11=B)
  233.                                 bit 4-7 = octave
  234.                         0001    bit 0-4 = instrument
  235.                                 bit 5-7 = volume bit 0-2
  236.                         0002    bit 0-3 = command
  237.                                           00 = No command
  238.                                           01 = Set tempo (timebase)
  239.                                           02 = Go to order
  240.                                           03 = Jump to next order
  241.                                           04 = Volume slide
  242.                                           05 = Portamento down
  243.                                           06 = Portamento up
  244.                                           07 = Tone portamento
  245.                                 bit 4-7 = volume bit 3-6
  246.                         0003    bit 0-7 = command value
  247.         [????]  In modules: Samples
  248.  
  249.  
  250.         BWC's samplefile format is following:
  251.  
  252.         Offset  Meaning
  253.         0000    The header, always letters "BJH"
  254.         0003    (word) Digirate of the sample in hertz.
  255.         0005    (word) Type of the sample.
  256.         0007    The sampledata starts here. Or, if (type and 1)=1 then
  257.                 0007    (word) Loop begin offset.
  258.                 0009    (word) Loop end offset.
  259.                 0011    Begin of real sample.
  260.         
  261.  
  262. 5       Last words, version information
  263.  
  264. 5.1     Last words
  265.  
  266.         This program has no copy protection. Only thing is your name
  267.         displayed after exiting. It can be changed, but remember, it is
  268.         not the only one. It is crypted all over the EXE file too.
  269.  
  270.         If you have ideas, have found some bugs, or anything, contact
  271.         me. See BPTREG.DOC for more information.
  272.  
  273.         Thanks to...
  274.         Patrick Aalto, David Komatsu, Tapani Salmi, Tomi Aarnio, Tomi
  275.         Engdahl, Veli-Pekka Suuronen, Jari Ahmavuo, Timo Haanpää and
  276.         BriteSounds.
  277.  
  278.         To keep lawyers happy...
  279.         IBM PC, XT and AT are registered trademarks of International
  280.         Business Machines Corp.
  281.         RealSound is a registered trademark of Steve Vitzel.
  282.         Sound Blaster is a registered trademark of Creative Labs, Inc.
  283.         DESQview is a registered trademark of Quarterdeck Office 
  284.         Systems.
  285.         Akai Professional Sampling Keyboard X7000 and Akai Professional
  286.         Sampler S700 are registered trademarks of Akai Electric Co, Ltd 
  287.         (Japan).
  288.         Roland MPU-401, Roland MT-32 and Roland LAPC-1 are copyrights of 
  289.         Roland Corporation.
  290.         BWC is a copyright of Kim Heino and Arttu Kontkanen.
  291.         MidiTracker is a copyright of Patrick Aalto.
  292.         ScreamTracker is a copyright of Sami Tammilehto.
  293.  
  294.  
  295. 5.2     Version information
  296.  
  297.         v0.02   This is the first released version. Some bugs, lots of
  298.                 missing stuff. But I had to release it now or never.
  299.         v0.03   Bugfix: Changing PHertz after loading the module didn't
  300.                         change instrument table correctly.
  301.                 Sound Blaster's IO-address can be configured.
  302.                 Sound Blaster's 80386-mode added.
  303.         v0.04   Better MOD-loader (still buggy?).
  304.                 EGA-support added, see command line parameter /E.
  305.                 Editor to Sample/Memory added.
  306.                 Runs correctly under DOS 5.
  307.         v0.05ß  MIDI player added.
  308.                 Roland MPU support added.
  309.                 Akai sampler support added.
  310.                 BriteSounds' stereo-DAC card support added.
  311.                 MTM- and MTS-loader added.
  312.                 Sample/Program added.
  313.                 Sample/Memory and file format changed to support MIDI.
  314.                 Sound Blaster check added.
  315.                 Play/Play Repeat added.
  316.                 Volume slide command added.
  317.                 Portamento commands added.
  318.                 Limits to PHertz.
  319.                 Better STM- and MOD-loader.
  320.                 Bugfix: Go to order command.
  321.                 Bugfix: Change IHertz.
  322.                 Bugfix: Load instruments.
  323.         v0.05ß2 Save Amiga's MOD command added.
  324.  
  325.         To do:  Vibrato command.
  326.                 Arpeggio command.
  327.                 Amiga's ProTracker commands.
  328.  
  329.