


  .._   _.._   _.._.____. _ .____   _   _..___..
  .| \_/ || | | || ||   |(_)|  _ \ | \_/ || _ \.
   | | | || |_| || |.| | | || |_| || | | ||  _/
   |_| |_| \___/ |__||_| |_|| | |_||_| |_||_|Raf
  .                         |/                 .
   ............................................  



My ultimate lovely totally innovating Automatic Multimedia Player


                Documentation







==================================================
============ Introduction to MultiAMP ============
==================================================



Reasons for writing this program

Well.. I wanted to do something interesting! (I hope MAMP is interesting a lot!)
I also wanted to show that DOS can be multimedia environment! 




Features overview 

Multiamp key features are fast operating and small overall size.
It uses a lot of libraries to provide wide support for sound formats.
Libraries related info is listed in Credits section. 

MultiAMP is multiplatform multimedia player which supports most of popular audio formats.
This program is free and will be free!

And as project grows MultiAMP has got native Linux and window$ port and is now developed as Open Source!


System requirements 

DOS version:


TIP: Under "clean" DOS session loading SmartDrive (type smartdrv at DOS promt) speeds up disk operations a lot! 



Supported operating systems:DOS 3.30+ , window$ 3.x,95,98,Me
It won't work on NT based systems - at all :( [nt4/2000/xp]

Supported Sound Cards:All Sound Blasters,Pro Audio Spectrum, Gravis UltraSound,Ensoniq Soundscape,Windows Sound System 

Additonal:

Non-GUI version:

0.4MB of HDD space

486dx2/66MHz,Pentium 60Mhz or faster suggested (especially for MP3 and OGG playback)

1MB of RAM,preferably 4+


GUI version:

0.6MB of HDD space

will run on 486s but Pentium 60Mhz+ is recommended,however Pentium 120Mhz or faster is suggested when you'll play MP3/OGG

2MB of RAM,preferably 4+ (preferably more)



Window$ version:

0.5MB of HDD space

486dx2/66MHz,Pentium 60Mhz or faster suggested (espacially for MP3 and OGG playback)

8MB of RAM,preferably 12+ 
(that depends on window$ and IE you're using... it may run even on 4MB with W95 OEM 1)


===============================
============ Usage ============
===============================


Features

MAMP supports a lot of different filetypes, it's small ... fast... 
generally nice :) 

+ Playlist
+ Same functionality for DOS , Win32 and Linux (If you used any version - rest looks the same!)
+ Different language localizations are avaiable and new ones are very easy to made



Supported formats

List of formats supported by MultiAMP.

NOTE for non GUI DOS version: Run CD Audio player using 'mamp cda' command or CDA.BAT file



Ext.    Description
WAV     RIFF waves 
MP3/MPG MPEG Layer 3 
MP2/MPG MPEG Layer 2 
MID     Midi sequences 
CDA     CDAudio Tracks 
MOD     Amiga Protracker MODule (later on PC) 
XM      Fasttracker ][ eXtended Module 
S3M     ScreamTracker3 Module 
IT      Impulse Tracker 1.xx/2.xx Module 
OGG     Great compression similar to MP3 but better



 


FAQ

All versions:

none for now

DOS Version:

Q:Why MAMP produces noisy sound?
A:It's simple - see this table: Type max Hz/mono max Hz/stereo 16 bit support 

Type      Max Hz:Mono  Stereo  16 Bits

SB 1.0/1.5/2.0   22-44k   -    no 
SB Pro I/II      44100  22050  no 
SB 16 and higher 44100  44100  yes 




So - You need at least SoundBlaster 16/compatible to hear sound without noise made by card itself.
NOTE: 8 bit sound always produces noise! 22Khz degregades sound very little.
I've Sound Blaster Pro - it's initialized as 22KHz/8bit/stereo by default.


Windows version:

none for now

Linux version:

none for now



==================================
============ Credits  ============
==================================


MultiAMP authors and contributors

Authors:

Rafa Szyja - rafalszyja @ poczta . onet . pl
        Started the project at 2nd July 2002
        Made main API of MultiAMP 
        Created graphics and DOCS and anything else that others did not :) 
        Was managing the project alone up to late November 2002. 

Web Site: http://rafalszyja.republika.pl


Oscar Giner - O_giner @ hotmail . com
        Was invited to cooperate with Rafa in late November 2002. 
        Did playlist :) 
        Added monitor refresh rate control 
        Contributed a lot of useful code , tips and tricks 
        Made Spanish localization
        Made Multiamp account on sourceforge.net

Web Site: http://www.oginer.tk

Contributors:

Christer Sandberg - christer . sandberg @ mdh . idt . se
        Made Swedish localization
        I suppose that Christer know all about C! ;)
        MAMP uses Christer's CGUI...

Web Site: http://www.idt.mdh.se/~csg/cgui/


Ben Davis - entheh @ users . sf . net
        He compiled MAMP under Linux , also thanks for nice suggestions!
        MAMP also uses Ben's DUMB!

Web Site: http://www.dumb.sf.net/


Eduardo "Dudaskank" Machado - dudaskank @ yahoo . com
        Made Portugal (Brazil) localization
        
Antonios Grizis (Medron/SAMAR Productions) - medron @ gmx . net
        Made Greek localization
        

        






        


Thanks... Greets... 

Shawn & All the Allegro community - Allegro is base of MultiAMP!
Jeffrey Guan - JGMOD is nice mod library [currently unused]
Delirium Software - AllegroOGG and AllegroMP3 are very good!

here is list of testers:
Ben "Enteth" Davis entheh @ users . sf . net
Marcin "eber" ebrowski zeber00 @ wp . pl
Tomek "Yasioo" Jasiski
Kamil "Suchy" Ncek
Marcin "CzechU" Czech
Catalyst88 catalyst88 @ btopenworld . com

And here is list of all libraries used:

Allegro 
DUMB  
AllegroMP3 
AllegroOGG 
CGUI  
LIBCDA  
AlText


====================================
============ Additional ============
====================================


Reporting bugs


If you find a BUG or PROBLEM let us know about that as fast as possible!

you can mail Rafal or Oscar but it's better to mail both of us at a time!




Future Plans

Future plans - yeah...
Making MultiAMP better! - that's IT!


=====================================
============ Source Code ============
=====================================

How to compile sources

updated 14 Apr 2003 by Rafal.

Libraries needed to compile:


Allegro 4.x.x  http://www.allegro.sf.net
DUMB  v0.9.x   http://www.dumb.sf.net
AllegroMP3     http://nekros.freeshell.org/delirium
AllegroOGG     http://nekros.freeshell.org/delirium
CGUI v1.6.x    http://www.idt.mdh.se/personal/csg/cgui/
LIBCDA v0.5    http://www.psynet.net/tjaden/
AlText v0.94   http://www.oginer.tk/  


Case: GCC under Linux 

Install all needed libraries then 
use MAKE to create the program. (see end of this file for targets)
ie : make -f makefile.linux

Case: GCC under DJGPP

Install all needed libraries then 
use MAKE to create the program. (see end of this file for targets)

make [then press enter]

Case: GCC under Mingw32
Install all needed libraries then 
use MAKE to create the program. (see end of this file for targets)

default makes build statically linked EXE but you can 
build dynamic also - remove _s form -lalleg_s and -lcgui_s in
makefile.mgw file.

Case: MSVC
Open included workspace and compile it


--------

Makefile targets:
clean - removes all object-files (rm -f *.o)
fuck - deletes executable, then type make to recreate it (faster recompiling)
compress - uses UPX (must be in PATH) to pack EXE.
debug=1 - creates DEBUG version

that's it.


