@DATABASE "MrMIDI.guide"
@$VER: MrMIDI.guide 1.3 (8.2.1998)
@AUTHOR "Deok-Min Yun"

@NODE Main "MrMIDI Documentation"

This is documentation for MrMIDI 1.3.

MrMIDI is ©1997-1998 by Deok-Min Yun.


@{B}Table of Contents@{UB}

@{" Introduction     " link Introduction}
@{" Legal Stuff      " link LegalStuff}
@{" Requirements     " link Requirements}
@{" How To Install   " link Installation}
@{" How To Use       " link Usage}
@{" Revision History " link MrMIDI.History/Main}
@{" Bugs             " link MrMIDI.Bugs/Main}
@{" Things To Do     " link MrMIDI.ToDo/Main}
@{" Acknowledgements " link Acknowledgements}
@{" Author           " link Author}

@ENDNODE

@NODE Introduction
@{B}Introduction@{UB}

@{U}Description@{UU}

MrMIDI is a GUI frontend for GMPlay using MUIRexx. It supports many of the
features provided in GMPlay with intuitive interface.


@{U}Features@{UU}

- Easy to use interface.
- Strong song list manipulation.
- User can change settings while playing the music or stopped.
- Drag & drop MIDI files from Workbench.
- Total song play time display.

@ENDNODE

@NODE LegalStuff
@{B}Legal Stuff@{UB}

@{U}Copyright@{UU}

This program is CounterWare(TM). You only have to visit the @{"author" link Author}'s
home page and increase the counter! It doesn't cost you anything and also
when you visit, you might find something new every week. You can do whatever
you want with this software.


@{U}Disclamer@{UU}

This program is provided "AS IS" without warranty of any kind. The author
assumes no responsibility or liability whatsoever for any damage or data 
loss caused by using this program.

@ENDNODE

@NODE Requirements
@{B}Requirements@{UB}

- A fast Amiga (68040 or better is recommended).
- GMPlay 1.3 (mus/midi).
- MUIRexx 3.0a (dev/mui) or better with MUIREXX: assign (should've been done
  by MUIRexx installation).
- MUI 3.0 (util/libs) or better.
- rexxutil.library 33.159 (included in the archive) in LIBS:.
- ARexx (supplied with Workbench disks) and RexxMast started.
- MIDI songs to play (of course :))

@ENDNODE

@NODE Installation
@{B}How To Install@{UB}

Double-click on the 'Install_MrMIDI' icon. This will copy 'rexxutil.library'
to LIBS: and fix protection bit for 'Kill'. Other than that, just keep the
whole directory structure intact.

@ENDNODE

@NODE Usage
@{B}How To Use@{UB}

To launch the program from Workbench, simply double-click on the icon. You
can also start from CLI by 'Execute MrMIDI'. No prior configuration is
required and nearly everything can be changed within the program.

@{"Menu     " link Menu}
@{"Interface" link Interface}

@ENDNODE

@NODE Menu
@{B}Menu@{UB}

Save Prefs      : Saves current settings.
MUI Prefs...    : Opens MUI Preference window.
About MrMIDI... : Opens version and author information window.
About MUI...    : Opens MUI information window.
Quit            : Quits MrMIDI.

@ENDNODE

@NODE Interface
@{B}Interface@{UB}

@{U}Main@{UU}
Filename : Currently playing song filename.
Details  : Format, number of tracks, and DPQ (deltas per quarter-note).

Current Song : Currently playing song number in the list.
Total Songs  : Total number of songs in the list.
Current Time : The duration of currently playing song.
Total Time   : Total time of all the songs in the list.

Volume : Chanes the volume.

Previous     : Selects the previous song.
Rewind       : Not supported.
Play/Pause   : Plays or pauses the song.
Fast Forward : Not supported.
Next         : Selectd the next song.
Stop         : Stops the song.
Eject        : Ejects the song.
Song List    : Shows/Hides song list window.

Advanced Settings : Shows/Hides advanced settings.
Stereo/Mono       : Stereo/Mono output.
Filter            : Not supported.
Sequencial/Random : Sequencial/Random order play.
Repeat Type       : Selects between no repeat, repeat one song, and repeat
                    all songs.

Status Bar : Shows the status.


@{U}Advanced Settings@{UU}
Frequency    : Selects the output frequency.
Polyphony    : Selects number of channels.
Priority     : Selects priority for GMPlay.
Tone Filter  : Enables/Disables tone filter.
Tone Map     : Selects tone map (Standard, XG, etc.)
Drum Filter  : Enables/Disables drum filter.
Drum Map     : Selects drum map (Standard, XG, etc.)
Buffer       : Allocates buffers for the samples (in kilo buffers).
Velocity Map : Selects the velocity map (linear, quadratic, or exponential).
Volume Map   : Selects the volume map (linear, quadratic, or exponential).


@{U}Song List@{UU}
GMPlay Path     : Path for the GMPlay.
MIDI Files Path : Path for the MIDI files.

Song List       : Drag & drop, multi-select, drag-sortable, multi-column,
                  double-clickable song list.

Insert  : Inserts a song(s) to the list.
Delete  : Delete the selected song(s) from the list.
Clear   : Clears the list.
Sort    : Sorts the list in alphabetical order with full path names.

Load    : Loads a song list.
Save    : Saves the current song list.
Include : Includes a song list.

@ENDNODE

@NODE Acknowledgements
@{B}Acknowledgements@{UB}

Alessandro de Luca : Original author of GMPlay.
Christian Buchner  : Current author of GMPlay.
Stefan Stuntz      : Author of MUI (Magic User Interface).
Russ Leighton      : Author of MUIRexx.
David Junod        : Author of rexxutil.library.
Magnus Holmgren    : Author of Visage. His utility, 'Kill', is used
                     extensively in my program.

@ENDNODE

@NODE Author
@{B}Author@{UB}

Name   : Deok-Min Yun
E-Mail : dmyun@mailexcite.com
         dmyun@hotmail.com
         dmyun@rocketmail.com
WWW    : http://www.geocities.com/SiliconValley/Horizon/7576/


My other programs include,

MrMPEG    : GUI frontend for MPEGA using MUIRexx.
XBM_DT    : X BitMap DataType.
KLS       : Korean Locale System for Amiga.
CUR2ILBM  : Windows cursor/icon to ILBM converter.
Aminet2DB : Aminet RECENT, CSV, TSV converter.

@ENDNODE