
***********************************************************************
readme for M A P  
***********************************************************************

changes:
  look at whatsnew.txt
	
	
***********************************************************************
The Demoversion of MAP allows only a maximum of 15 MP3 files to play.
All other features are fully implemented!
The fullversion consists of:

software: all needed files send via email - costs 12 US$
hardware: IR-HW readymade and tested              18 US$
Total                                      --------------
                                                  30 US$
Shipment (non europe, for hardware)                5 US$

All in all 35 US$ or 65DM

If you find MAP useful send your requests to:
		Jui_Plus@web.de
***********************************************************************

Note: mpxplay V.1.42 was tested with MAP. It works properly. But you have to do
      some modifications to the mpxplay.ini - file. Please modify the following
      settings:
      
      KeyExit3     =0x5300    ;exit mpxplay with "." on Numpad
      KeyExit4     =0x4800    ;exit mpxplay with Cusor_up-key
      UseVariables =3         ;3:save variables at exit to catch the volume setting
      TimeMode     =1         ;0:elapsed, 1:remaining, 2:allelapsed, 3:allremaining
      LCDtype      =0         ;0:for no LCD support in mpxplay- MAP controls it!
      StartupEnabled  =0
      
      TimeMode is up to you... 0, 1 do work properly


Files:

map.ini      init file for map.exe
map.exe      executable playerfile
rclearn.exe  program to learn your RC-code for using MAP. Generates rcmap.dat
rcmap.exe    TSR-program for mapping RC-codes to the keyboardbuffer
             and LCD-scrolling
rcmap.dat    DEMO file with RC code mappings (USE rclearn to PRODUCE IT) 
lcd.exe      executable file for displaying character LCD like echo
start.bat    batch to loop the program map.exe 
readme.txt   this file
glist.exe    can be used to scan the specified drive for mp3-files
             it uses the same structure as MAP needs for playlist 
autoexec.bat sample autoexec
config.sys   sample config

use option /h for help!

NOTE: IF you don't have a LCD and the IR-Hardware you don't need
      to start the TSR program rcmap.exe! Edit the map.ini file 
      to your belongings and start map.exe.
      BUT if you have the LCD, start rcmap.exe once to do scrolling and to see 
      the timedisplay.
      IF you have both, LCD and IRhardware (you are lucky) start also rcmap.exe once.

INSTALLATION:

Put all the files on a bootable DOS floppy. Install your CDROM driver
and Soundcard driver to the floppy.
If you have the IR hardware, the PC have to learn your special keys:
Connect the hardware to COM port1 (or 2),
start the program  rclearn 1 <CR>
1 - is for COMport

If rclearn.exe recognizes the IR hardware you are now able to learn
the needed keys. Follow the instructions....
After the learning process is finished, all keys are stored in 
rcmap.dat and will be loaded after any reboot by rcmap.exe.
If you don't have the IR hardware you are not able to use a remote control,
but you can use your keyboard instead.

Next you have to edit the map.ini file to your belongings. 
example:
-----------------------------------------------
#Ini-file for M A P (c) 1999 UM

[lcd]
Columns = 16
Rows = 2
ScrollDelay = 2
WaitEnd = 40
# 0=don't Scroll, 1=Scroll_Wrap, 2=Scroll_Ping, 3=Scroll_PingPong
ScrollView = 3

[environment]
# specify your drives where MAP can find mp3s. The first one is the default drive 
# e.g. CDROM. If you have only one drive then put only one driveletter here
mp3drives = e: d: h:
player = mpxplay
playlistfile = mp3.lst
# disable for slow machines (FALSE)
DisplayTime = TRUE
# MAP starts playing 1. found song immedeatly, if TRUE
StartImmedeately = FALSE

-----------------------------------------------

Specify the size of your LCD. Supported sizes are: 40x2, 20x2 and
16x2! I recommend 40x2 - it looks the best. When using 16x2 or 20x2,
scrolling will be enabled if the characters do not fit on the screen.

Specify the mp3drives, where mp3 files could be found. The drive will be selected
by pressing 'c' or with a remote button (You can specify it with rclearn). 
The program map.exe scans all subtrees and looks for files with the
extension *.mp3 at the first drive specified under keyword mpdrives in map.ini. 
Specify the DOS-player, default mpxplay - you have to download
the player by yourself at:
		http://members.tripod.com/~padara/ 
I recommend version 1.42! BTW since MAP V2.00 only  mpxplay is supported.

If MAP does not find a playlistfile on the CD-R, it creates a
temporary file. 
If you want to use your own playlistfile, it has to look like:

number [directory number] path\filename description
at the end $
Note the directory number represents different CD-albums.

example:
-----------------------------------------------
001 [1] nirvana\NI9166~1.MP3 Nirvana/About A Girl
002 [1] nirvana\NIRVAN~2.MP3 Nirvana/All Apologies
003 [1] nirvana\NIRVAN~3.MP3 Nirvana/Come As You Are
004 [1] nirvana\NIRVAN~4.MP3 Nirvana/Dumb
005 [2] Police\DeDoDoDo.mp3 Police/DeDoDoDo
...
164 [10] Stones\Voodo\track01.mp3 Stones/Voodo_01
165 [10] Stones\Voodo\track02.mp3 Stones/Voodo_02
166 [10] Stones\Voodo\track03.mp3 Stones/Voodo_03
...
$
-----------------------------------------------

The [directory number] counts the directory structure, to allow the
program to jump to different artists or albums. This item is optional. If you
do not use it, you are only able to jump sequentialy.

"path\filename" points to the song from top e.g. d:. The path and
filename has to meet the 8.3 naming convention from MSDOS!! Sorry about
that crap..

"description" is normally the artistname/songtitle. These items will
be displayed on the LCD.

Place "$" at the end of the playfile!

Once more, if your MP3-songs uses the ID-tag, you don't need a playfile!
If no ID-tag and no playfile is specified, the program displays only
the path/filename of the song at 8.3 :(.


AUDIOCD-DATABASE

New feature since version 2.08. To use this feature just place a file 
e.g. cdplayer.ini to the directory where MAP is executed. The cdplayer.ini
is exactly the same as you know from W95(98)(NT). You can build this file by 
yourself or by using the CDDB (look at www.cddb.com for more informations).
The format is:

[5D52DD]
artist=Burdon, Eric
title=Eric Burdon declares -WAR-
numtracks=5
0=The Vision Of Rassan
1=Tobacco Road
2=Spill The Wine
3=Blues For Memphis Slim
4=You're No Stranger
order=0 1 2 3 4 
[157C936]
EntryType=1
artist=Nirvana
title=Unplugged in New York
numtracks=14
0=About A Girl
1=Come As You Are
2=Jesus Doesn't Want Me For A Sunbeam
3=The Man Who Sold The World
4=Pennyroyal Tea
5=Dumb
6=Polly
7=On A Plain
8=Something In The Way
9=Plateau
10=Oh Me
11=Lake Of Fire
12=All Apologies
13=Where Did You Sleep Last Night
order=0 1 2 3 4 5 6 7 8 9 10 11 12 13 
numplay=14

This example shows 2 audiocds. The number in brackets are build automatically.
You can generate this number by typing "vol d:" (d: == CDdrive) in a DOSbox.
MAP reads the keyword "artist" and the trackdescription (0..)
This file has no limitation (64kb) like the cdplayer.ini in W95. So
you can put your whole archive in it.


USING THE PLAYER

Run the batch start.bat. This will run the player in a loop.
Or type map (default is for seeking through the found structure).
If you don't have the remote control hardware, you can use your
keyboard to control the player. But the program is especially written to
use an infrared remote controller! So don't hesitate to order this
little hardware. It's cheap and very useful. BTW You can use nearly any
available RC with the IR-hardware and you can control any DOS application
with it, windows either.
All infos are displayed on LCD (if adapted to printerport 1) and on monitor!
(Except Play-character, Pause-character and time in AudioMode
is not displayed on the monitor!) 

BTW you can key in directly the songnumber you want to play acknowleged with
'enter' or ('play' at IR).
Press 'c' or the appriate button on the remote to change the drive (if you have more 
than 1 specified).
Mark your favorite sound if you want to hear them only.

MAP has lots features, just try it. But note that MAP works fullfunctionaly
only with the IR-hardware.
The IR-hardware (called IR2PC) is also available at:
http://www.ir2pc.com  That's me

I am sure there are many questions. Let me know...

email: Jui_Plus@web.de

homepage: http://jui.homepage.com/index.html
