slavchev / dosmid Goto Github PK
View Code? Open in Web Editor NEWThis project forked from tronix286/dosmid
DOSMid - a low-requirements MIDI and MUS player for DOS
This project forked from tronix286/dosmid
DOSMid - a low-requirements MIDI and MUS player for DOS
DOSMid Copyright (C) 2014-2018 Mateusz Viste Creative Music System / Game Blaster output support version (C) Tronix 2021 Used piece of software codes from third-party peoples, eg: - DEATHSHADOW'S Paku-Paku game by Jason M. Knight - SAATunes v 1.04 lib by Bobcatmodder Jacob Field - Arduino YM2149 MIDI Synth by yukimizake New DOSMid options: /cms=XXX Force dosmid to use Creative Music System / Game Blaster on port XXX. The port part is optional, that means you can use "/cms" to just force CMS usage on default 220h port. ============================= ORIGINAL DOSMID.TXT DOSMid - a low-requirements MIDI and MUS player for DOS http://dosmid.sourceforge.net *** INTRO *** DOSMid is a MIDI, MUS and RMID player for DOS. It's a real mode application designed to run on very modest hardware configurations. It plays standard MIDI files (both format 0 and format 1), as well as MIDI in RIFF (ie. RMID), and even MUS tunes (as used by Id Software in numerous games like Doom, Heretic, Hexen, etc). DOSMid requires MIDI-capable hardware of some sort. Note, that some sound cards have an MPU-401 interface, although many need an additional 'wavetable' daughterboard to produce actual MIDI sound. DOSMid can also emulate MIDI through FM synthesis using an OPL chip (that is one of the Yamaha YM3812 or YMF262 chips, found on most sound cards from the nineties) - be warned however that, most of the time, such MIDI-over-OPL emulation will yeld less than desirable results, unless the MIDI file was specifically crafted for OPL. Minimum requirements: - a compatible synthesizer (wavetable, OPL or external - see the compat list) - an 8086-compatible CPU - 100K of available conventional memory and some XMS - 250K or so available conventional memory if you do not have XMS - a video card able to display an 80x25 monochrome text mode Highly recommended: - 80286 CPU for a guaranteed lag-free experience even on complex MIDI files - VGA graphic with a color monitor - 512K of available XMS memory *** USAGE *** During runtime, DOSMid can be controlled with the keyboard: ESC Quits to DOS +/- Volume up/down SPACE Pause the song (press any key to resume) ENTER Skip to next song of the playlist BKSPC Jump to previous song of the playlist (doesn't work with /random) DOSMid accepts several command-line options, as listed below: DOSMID [options] file.mid (or m3u playlist) /noxms Use conventional memory instead of XMS. This is obviously useful only if you don't have XMS. Don't use this option otherwise, since without XMS you won't be able to load big MIDI files. /xmsdelay Wait 2ms before each XMS access. Such waiting is required sometimes when the MPU controller is emulated by a TSR driver (specifically, the AWEUTIL driver used with SoundBlaster AWE 32/64 cards happens to crash if XMS accesses are not slightly delayed). /mpu=XXX Force dosmid to use MPU-401 on port XXX. If not forced, DOSMID scans the BLASTER environment variable for the MPU port, and if not found, it fallbacks to port 330h. The port part is optional, that means you can use "/mpu" to just force MPU usage. /awe=XXX Use the EMU8000 synth chip found on SoundBlaster AWE32/AWE64 cards on port XXX (the port is optional, you can specify just "/awe"). KNOWN BUG: On some AWE cards, the FM music module becomes muted or noisy after using the EMU8000 chip. This is not a bug in DOSMid, and happens with other applications using AWE as well. If you have this problem, execute AWEUTIL /S after using DOSMid to reinit FM. I observed this problem on an AWE64 CT4390 ("Gold"), but not on an AWE32 CT2760. /opl=XXX Use an OPL2-compatible chip on port XXX. This should be a last resort option if you don't have any wavetable device. Do NOT expect pleasing results. The port part is optional ("/opl" will default to port 388h). /sbmidi=XXX Drives an external synth connected to the gameport of your Sound Blaster card. The port part is optional ("/sbmidi" will use the port read from BLASTER, or fallback to 220h). /com=XXX Send MIDI messages out via the RS232 port at I/O port XXX. This can or /com1 be used to hook a hardware synth to a computer with no MIDI or /com2 interface, only a standard serial port. DOSMid does NOT reconfigure or /com3 the COM port, so you should take care of setting it correctly, for or /com4 example using the 'MODE COM1: ...' command. The port part is not optional, you are expected to pass the hexadecimal I/O address of the RS232 port you wish to use (for example "/com=3f8" is pointing to COM1 on most BIOS implementations). It is also possible to use simpler "/com1", "/com2", "/com3" and "/com4" switches. These will autodetect the correct I/O port. /gus Use the Gravis UltraSound card, relying on its ULTRAMID API. /syx=FILE Uses SYSEX instructions stored in FILE for initializing the MIDI device. FILE must be in "SYX" format, and can contain one or more SYSEX messages. /delay=X Insert an extra delay of X ms (X being in the range 1..9000) before playing the MIDI file. Setting this to 100 or 200 might help in some cases where the sound hardware needs more time to initialize completely, or when complex sysex data is fed via the /syx option. You can also use this simply to make the silence longer between the files of your playlist. /sbnk=FILE Makes DOSMid load a custom sound bank. This is supported only on OPL and AWE hardware. The sound bank file must be in the IBK format when used with OPL, and SBK format for AWE. OPL accepts one or two IBK files (eg. /sbnk=file1.ibk,file2.ibk). If two are provided, then the first one will be used for the standard 128-instruments GM set, and the second one for defining percussion instruments. /log=FILE Logs all DOSMid activity to FILE. This is a debugging feature that you shouldn't be interested in. Beware, the log file can get pretty big (MUCH bigger than the MIDI file you are playing). /fullcpu Do not let DOSMid being CPU-friendly. By default DOSMid issues an INT 28h when idle, to let the system be gentler on the CPU, but on some hardware this might lead to degraded sound performance. /dontstop Never ask the user to press a key after an error occurs. This is useful if you want to play a long playlist and don't care about bad MIDI files, simply skipping them (or if you play a single file and wish that DOSMid exit immediately if the file is unplayable). /random randomize playlist order /nosound Disable sound (not very useful for a music player!) Note: All the above options can also be written to the DOSMID.CFG file. This file is loaded by DOSMID and used as default parameters that can still be overloaded by command-line options. *** THE BLASTER VARIABLE *** When not forced into a specific configuration via command-line switches, DOSMid scans the BLASTER environment variable to find out the most desirable settings. A BLASTER environment variable usually looks similar to this: SET BLASTER=A220 I5 D1 T3 P330 H6 E620 The bits DOSMid is interested in are "A220", "P330" and "E620". P330 provides the port address of the MPU-401 MIDI interface, while E620 tells the port address of the EMU8000 onboard synth (available only on 'AWE' models). A220, on the other hand, provides the base I/O address of the SoundBlaster card, so DOSMid can output directly to the card's MIDI port. If not instructed otherwise, DOSMid will always try to use the EMU8000 synth if found in the BLASTER string, and if not, it will use the MPU-401. If neither of them are found in the BLASTER string, or if there is no BLASTER variable at all, then DOSMid will try to fall back to FM synthesis on port 388h, unless an ULTRADIR environment variable is present, in which case it will try to detect a GUS through the ULTRAMID TSR API. *** COMPATIBLE SOUND HARDWARE *** DOSMid supports a variety of MIDI hardware. Here below I list the types of hardware that DOSMid is able to talk to: External MIDI synthesizers: - Connected through a MIDI/game port: either using an industry standard MPU-401 interface, or SoundBlaster MIDI port, - Connected through a "COM" (RS232) port: many synthesizers come with an RS-232 port that can be used instead of the standard MIDI port. This is supported by Roland SoundCanvas models, Yamaha PSR series, the Miracle Piano, many Korg devices... You could even use a software solution based on ttymidi... Internal MIDI synthesizers: - Available through a virtual MPU-401 interface: some AzTech Waverider 32 models, some versions of the HighScreen SoundBoostar 16, SoundBlaster 64 cards using the 'AWEUTIL' MPU emulator, - Based on the EMU8000 chip (SoundBlaster 32, SoundBlaster 64), - Gravis UltraSound (GUS) cards, through their ULTRAMID driver, - Based on an OPL2 or OPL3-compatible chip (most ISA sound cards from the nineties: Adlib, all SoundBlaster ISA models, Opti, AzTech...). *** BUILDING *** DOSMid is compiled with OpenWatcom 1.9. The entire build process is automated through a Makefile file, so if you wish to rebuild DOSMid, all you have to do is type "wmake". A few compile-time options are available to disable features you might not want: edit the Makefile and adapt FEATURES to your likeness. The FEATURES list is documented in the Makefile. The default build comes with all features compiled in, so you really should fiddle with FEATURES only in case you desperately need to lower DOSMid's memory footprint. *** CONTACT *** If you enjoy DOSMid, or noticed any bugs, I'd love to hear about it! You won't see my e-mail address here, but you will surely find some contact pointers on my home page: http://mateusz.viste.fr *** LICENSE *** Copyright (C) 2014-2018 Mateusz Viste All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.