OmniPlayer 0.99 (c) 1993-94, Edward Schlunder All Rights Reserved Zilym Limms/OTM zilym@hndymn.stat.com Contents: 1 . . Introduction 2 . . OmniPlayer Usage 3 . . Internal Modules 4 . . Implementation List 5 . . Greetings 6 . . Beta Testing Team 7 . . Disclaimer 8 . . Closing Notes OP is a multiformat digital music player for your 386+ computer. If you find any bugs or other anomalies, please get in contact with us so that it will get fixed for the future. If you find a module format that OP doesn't currently support or doesn't play correctly, please contact us so that it can be added!! We intend to make OP support as many modules formats as they are available! In addition, if you find this program useful in any way, *please* send a short piece of email or snail mail to the author so that I will know how much this program is really being used and whether it is worth the trouble of continuing it. email: zilym@hndymn.stat.com snail mail: Edward Schlunder 554 N. Acacia Road Apache Junction, Arizona 85219-4313 USA 컴컴컴컴컴컴컴컴컴컴컴컴 OmniPlayer Usage OP filespec [options] filespec File to play.. Extension not required options -EMS Force EMS use (even if not detected) -NOEMS Disables EMS use (even when detected) -F Use Foreground mixing This is mainly only useful when playing under Windows or DesqView. It seems to help Windows steady the mouse a bit. -L Disallow any module looping. When the modules stops, exit OmniPlayer. Useful in batch files. [0] -Ax Amplification (x=0 to 9) Note that too high a value will cause clicks and cracks, way high values produce pure trash. Use very small numbers in most cases (1 or 2) [4024 Bytes] -Bxxxxx Buffer Size (x=256 to 32767) [Max of Dev] -Sxx xxKHz oversampling rate (x=5KHz to 45KHz) [Autodetect] -Ixx Device IRQ number [Autodetect] -Dx Device DMA channel [Autodetect] -Pxxx Device Base I/O Address (x=xxxh) -Cx Select Output Device (x=device number) No: Sound Card: 0 Gravis Ultrasound [Default] 1 Sound Blaster 1.xx 2 Sound Blaster 2.xx 3 Sound Blaster Pro 4 Sound Blaster 16 5 Pro AudioSpectrum -Vx Visual Display Mode (x=display number) No: Name: 1 Help 2 Scope(s) [Default] 3 VU Meters 4 Sample List [Offset 0] -Oxxxxx Load module from file offset x (see section below) Example: C:\SOUND\OP>OP DEAF -C3 [enter] <- Plays the example module in stereo on a SBPro 컴컴컴컴컴컴컴컴컴컴컴컴 Internal Modules OmniPlayer has a neat little feature to help you play modules from inside demos and games. This section will try to explain how to use this feature. Included with OmniPlayer is a small utility to scan EXEs for modules within (MODSCAN.EXE). MODSCAN only checks for specail module signatures, so module formats without signatures can not be detected (ie, 15 instrument MODs). In addition, if the EXE is compressed with PKLite or a similar compression program, MODSCAN won't be able to read the signatures that might be present. Use UNP (not included) or another similar utility for uncompressing EXEs so that they can be scanned. Okay, the first thing you need to do now that you've got an EXE file with an embedded module unpacked, you need to find out what offset(s) into the file are the locations for your modules. Use: MODSCAN filename [Enter] Example: C:\DEMOS>MODSCAN PANIC.EXE Internal Module Scanner Version x.xx By Edward Schlunder (C)1994 55076 S3M Scan complete This first column lists the module's title (if any), the second is the modules offset, and the last is the module type. Generally, if a module has a title filled with garbage, it is probably not a module and shouldn't try to play it (would result in crashing OP possibly). To actually play the module we type: Use: OP filename.EXE -Ooffset [Enter] Example: C:\DEMOS>OP PANIC.EXE -o55076 Once that's done, OmniPlayer will attempt to load the specified module at the offset it was told. Note that the EXE extension is required because we wouldn't want to try loading EXEs as 15 instrument MOD files during normal usage now would we? 컴컴컴컴컴컴컴컴컴컴컴 Implementation List Key: � Implementation completed � Implementation incomplete Not implemented at all 컴컴컴컴컴컴컴컴컴 컴袴� File Formats 袴羔� 컴컴컴컴컴컴컴컴컴 >>>MOD/OCT/WOW �Protracker variants 4..32 �0xx Arpeggio/None �Bxx Order Jump �E7x Tremolo Control �1xx Porta Up �Cxx Set Volume �E8x Set Pan �2xx Porta Down �Dxx Pattern Break �E9x Retrigger Note �3xx Porta Note �Fxx Set Tempo/BPM �EAx Fine Vol Up �4xy Vibrato E0x Filter On/Off �EBx Fine Vol Down �5xy Porta Note+Vol Slide �E1x Fine Porta Up �ECx Note Cut �6xy Vibrato+Vol Slide �E2x Fine Porta Down �EDx Note Delay �7xy Tremolo E3x Glissando Control �EEx Pattern Delay �8xx Set Pan/Surround �E4x Vibrato Control �EFx Invert Loop �9xx Sample Offset �E5x Set Finetune �Axy Volume Slide �E6x Pattern Loop >>>MED �MED Editor/OctaMED Pro 4 �0xy Arpeggio/None Exx Synth Jump �11xx Fine Porta Up �1xx Porta Up �F00 Pattern Break �12xx Fine Porta Down �2xx Porta Down Fxx Set BPM �14xy Vibrato �3xx Porta to Note FF1 Play 2*Row �150x Set Finetune 4xy PT v1.0 Vibrato FF2 Delay Row/2 �16xx Pattern Loop �5xy Porta Note+Vol Slide FF3 Play 3*Row �18xx Note Cut �6xy Vibrato+Vol Slide FF8 Filter Off �19xx Sample Offset �7xy Tremolo FF9 Filter On �1Axx Fine Vol Up 8xy Set Hold/Decay FFA MIDI Hold Pedal On �1Bxx Fine Vol Down �9xx Set Tempo FFB MIDI Hold Pedal Off 1Cxx Change MIDI Preset �Axy Volume Slide FFD Change Note �1Dxx Pattern Break �Bxx Order Jump �FFE Stop Song �1Exx Pattern Delay �Cxx Set Volume �FFF Note Cut 1Fxy Delay+Retrigger �Dxy Volume Slide 10xx Send MIDI Message >>>STM �Scream Tracker 2.x 4 >>>S3M �Scream Tracker 3.x 1..16 Notes: If a module sounds out of tune or off key, it's probably because of ST3's nonstandard Amiga clock rate and the period values, not the portamento commands. There's not really anything to do about this problem except grin and bear it. The most notable module with this problem is probably Satellite One by Purple Motion/FC. �Axx Set Tempo �Gxx Porta Note �S3x Vibrato Control �Bxx Order Jump �Hxy Vibrato �S4x Tremolo Control �Cxx Pattern Break Ixy Tremor �S8x Set Pan �Dxy Volume Slide �Jxy Arpeggio �SBx Pattern Loop �DFx Vol Slide Down �Kxy Vibrato+Vol Slide �SCx Note Cut �DxF Vol Slide Up �Lxy Porta Note+Vol Slide �SDx Note Delay �Exx Porta Down �Oxx Sample Offset �SEx Pattern Delay �EFx Fine Porta Down �Qxy Retrigger+Vol Slide �SFx Invert Loop �EEx Xtra Fine Porta Down �Rxy Tremolo �Txx Set BPM �Fxx Porta Up S0x Filter On/Off �Vxx Set Global Volume �FFx Fine Porta Up S1x Glissando Control �FEx Xtra Fine Porta Up �S2x Set Finetune >>>ULT �UltraTracker v1.0 to v1.5 1..32 �1xx Porta Up �B0y Set Pan �E2y Fine Porta Down �2xx Porta Down �Cxx Set Volume �E9y Retrigger �3xx Porta Note �Dxx Pattern Break �EAy Fine Vol Up �4xy Vibrato �Fxx Set Tempo/BPM �EBy Fine Vol Down 501 Forwards/No Loop �E0y Vibrato Depth �ECy Note Cut 502 Backwards/No Loop �E1y Fine Porta Up �EDy Note Delay �Axy Volume Slide >>>MTM �MultiTracker 1..32 �0xx Arpeggio/None �Bxx Order Jump �E7x Tremolo Control �1xx Porta Up �Cxx Set Volume �E8x Set Pan �2xx Porta Down �Dxx Pattern Break �E9x Retrigger Note �3xx Porta Note �Fxx Set Tempo/BPM �EAx Fine Vol Up �4xy Vibrato E0x Filter On/Off �EBx Fine Vol Down �5xy Porta Note+Vol Slide �E1x Fine Porta Up �ECx Note Cut �6xy Vibrato+Vol Slide �E2x Fine Porta Down �EDx Note Delay �7xy Tremolo E3x Glissando Control �EEx Pattern Delay �8xx Set Pan/Surround �E4x Vibrato Control �EFx Invert Loop �9xx Sample Offset �E5x Set Finetune �Axy Volume Slide �E6x Pattern Loop >>>669 �Composer 669/Unis 669 8 �Ax Porta Up �Dx Frequency Adj. G0 Pan Left �Bx Porta Down �Ex Vibrato G1 Pan right �Cx Porta Note �Fx Set Tempo �Hx Retrigger >>>FAR �Farandole Composer 16 �1x Porta Up �8x Fine Volume Down �Fx Set Tempo �2x Porta Down 9x Sustained Vibrato �3x Porta Note Ax Slide to Volume �4x Retrigger �Bx Set Pan �5x Vibrato Depth Cx Sample Offset �6x Vibrato Dx Fine Tempo Down �7x Fine Volume Up Ex Fine Tempo Up 컴컴컴컴컴컴컴컴컴� 컴袴� Sound Devices 袴羔� 컴컴컴컴컴컴컴컴컴� >>>GUS.MSE �Gravis UltraSound (does not work with SBOS) Stereo 44KHz >>>SB1X.MSE �Sound Blaster 1.xx Mono 21KHz >>>SB2X.MSE �Sound Blaster 2.xx Mono 43KHz >>>SBPRO.MSE �Sound Blaster Pro Stereo 22KHz >>>SB16.MSE �Sound Blaster 16 Stereo 45KHz >>>PAS.MSE �Pro AudioSpectrum Stereo 45KHz 컴컴컴컴컴컴컴컴컴컴컴컴 Greetings go to: Renaissance - Thanks for all your help, DareDevil and StarScream. WildCat - Thanks for your help too. Alex Chalfin - Thanks for helping with the TP support. Clint Holeman - Thanks for the great player name idea. Sonic PC - Love your music, Mellow-D. Esp: Frequencies Phil Inch - Can I place an ad in the GDM (heheh) for BWSB? Future Crew - Scream Tracker ]I[ is awesome. Triton - CD ][ is great. Stalker/OTM - Special thanks to these two fine guys who Tek/OTM provided me with lots of modules to test OP on. Voltaire/OTM - Provided me Protracker 2.3a playroutine for effects. 컴컴컴컴컴컴컴컴컴컴컴컴 Beta Testing Team: Clint Holeman Andrew Bartels Steve Govenar Alex Chalfin John Peasley All of OTM More are highly welcomed, send email if you wish to join the beta testing team. 컴컴컴컴컴컴컴컴컴 Disclaimer In no event shall the authors of this program be held responsible for any undesired effects caused by this program. If something should go wrong, it is your problem, not ours. Use at your own risk! 컴컴컴컴컴컴컴컴� Closing Notes Well, it's been over a year since I first began this project.. My, my, how fast the time did go.. At least now I have something to show for all those months of seemingly stupid experiments. Have fun with the program and make sure to spread it around to all your favorite BBSes! Just make sure you don't charge for the program, I'm releasing it as freeware/noteware and don't expect others to profit any more than I do from this program. This is a little prerelease version, so not everything is totally finished and finetuned yet. Some examples of this is the fact that the FAR ULT STM runtime loading isn't implemented just yet. Same thing goes for effects, as Glissando is not implemented. Some have little problems, like Porta Up/Down that work fine with S3Ms, but may allow MODs to porta beyond their normal limit. These things will be completed and more by version 1.00. About the music routines... All sound device music engines are kept in separate runtime loadable modules that have the extension MSE (MSE stands for Music and Sound Engine). Since they are all runtime loaded, routines for other sound devices don't get stuffed in memory when you don't need them! It also has some other nice features to this.. Sometime in the near future I will be releasing another package directed towards programmers only. This package will include OBJ files to the music/sound routines and source code to some example programs (such as OP) that use these music routines. You'll be able to play around with it all and see how you like it, and once you're done, you can register the music routines for a full license allowing you to distribute freeware/shareware programs created using my music/sound engine royalty free (commercail programs will require a small royalty). Expected cost for registering is currently $35+S&H for the non-commercail distribution license (I do not consider shareware as commercail distribution) only and $55+S&H if you would like both the license and full source code to ALL code used in this library. That includes the music processing routines, sound device output, stereo/mono mixing routines, and all other source code used to develop OmniPlayer and the MSEs. Please send me email for further answers and for details on when this will be ready for public distribution. Zilym Limms/OTM 1994 zilym@hndymn.stat.com