@DATABASE "MidiPlay" @$VER: MidiPlay.guide 2.58 30-Sep-95 @(C) "Janne Syväniemi 1993-1995" @AUTHOR "Janne Syväniemi" @NODE MAIN "MidiPlay" @{" INFORMATION " Link INFORMATION} @{" INTRODUCTION " Link INTRODUCTION} @{" INSTALLATION " Link INSTALLATION} @{" NEW FEATURES " Link NEW_FEATURES} @{" STARTING OPTIONS " Link STARTING_MIDIPLAY} @{" WINDOWS " Link WINDOWS} @{" AREXX COMMANDS " Link AREXX} @{" TIPS FOR USERS " Link TIPS} @{" TUTORIAL FOR ADJUSTING MIDI FILES USING ICONS " Link ICONER} @{" OTHER INFORMATION " Link OTHER_INFORMATION} @{" TODO " Link TODO} @{" PROBLEMS AND LIMITATIONS " Link PROBLEMS_AND_LIMITATIONS} @{" HISTORY " Link HISTORY} @{" AUTHOR " Link AUTHOR} @{" CREDITS " Link CREDITS} @{" MIDIPLAY TOOLKIT " Link MPTOOLKIT} @ENDNODE @NODE INFORMATION "INFORMATION" @{b}VERSION@{ub}: MidiPlay v2.58 30-Sep-95 If you need the latest version of MidiPlay, look at my WWW Amiga page: http://www.uta.fi/~csjasy/amiga.html Unfortunately there is currently no support BBS. @{b}REQUIREMENTS@{ub} MidiPlay requires at least OS 2.04 to run. Also midi.library and miditune.library are required. If you want to really hear something, you need external MIDI equipments and a MIDI file. @{b}DISCLAIMER@{ub} The author of this program can not be held responsible for any damage directly or indirectly caused by the use of this program. Use it at your own risk. @{b}COPYRIGHT@{ub} This program is copyright (C) 1993-1995 @{b}Janne Syväniemi@{ub}. All Rights Reserved. The program is @{b}GIFTWARE@{ub}. It is freely distributable as long as all files are included in their original form and no extra fee is charged. MidiPlay may not be included in any commercial package without a permission of the author. People who use MidiPlay much, should consider rewarding the author with some music related gift (like good music in CD format). If you support MidiPlay, you will receive @{"MidiPlay ToolKit" Link MPTOOLKIT}. miditune.libary is copyright (C) 1995 @{b}Janne Syväniemi@{ub}. All Rights Reserved. Distribution separately from the MidiPlay archive is not allowed without a written permission of the author. Bill Barton's midi.library is Copyright (C) 1987, 1988, @{b}Pregnant Badger Music@{ub}. More info about midi.library can be found on Fred Fish disk 227. reqtools.library is copyright (C) @{b}Nico François@{ub}. See also @{" Author " Link Author} @ENDNODE @NODE INTRODUCTION "INTRODUCTION" @{b}WHAT IS MIDIPLAY?@{ub} MidiPlay is a program that can play format 0 and 1 MIDI files. It can also print their contents. You can change most of the features of MidiPlay via a graphical user interface. You can mute instruments or let them play solo. You can play files in different key by transposing. You can speed up or slow down playing by changing the tempo. You can filter certain MIDI messages e.g. pitch bender, program change or system exclusive messages. You can synchronize playing from an external source. You can merge your keyboard playing with MIDI merging. An ARexx port provides even better control for fine tuning of MidiPlay's performance. MidiPlay has over 100 different ARexx commands. You can also change the playing of individual MIDI files via icon tool types. You can add songs to a playlist. You can select songs easily from the playlist with a single click. A file buffer makes it easy to select many songs from the playlist at once to be played next. @{b}MIDI files and General MIDI files@{ub} MIDI files are usually made on one particular system. These files won't necessarily sound good on your system, you may have a completely different synth which has instruments ordered differently than expected in a MIDI file. General MIDI standard tries to remove this problem, but many old files are still made before this standard and many people don't have GM synths. Changing all your MIDI files' instrumentation to correspond your setup by using a sequencer program would require a lot of work and if you changed your setup, you would have to do the whole work again. MidiPlay tries to prevent these problems with many program change mapping features. If you have a GM synth and you listen to GM files you won't have many problems if any. But if you have a synth which doesn't support GM standard, you should make a mapfile for your synth. MidiPlay support two kind of map files. One for normal program change mapping and the other for drum mapping (i.e. for individual note on events on the drum channel). In fact, you can have different map files for every MIDI channel. For example, GM standard says that a program change number 25 corresponds to a nylon guitar, but the nylon guitar can be set with PC number 69 on your synth. In this case, you should put number 69 to your map file's 25th row. If your synth supports different banks for an individual instrument, you can exploit this feature in your map file. It is also possible to send a complete instrument setup via a sysex message file. See the exact @{" description of the map file " Link MAPFILE}. The following commands also affect the instrument mapping: set mapping on/off: @{" MAP " Link MAP} tell the instrument map file: @{" MAPFILE " Link MAPFILETYPE} tell the drum map file: @{" DRUMMAPFILE " Link DRUMMAPFILE} tell the mapping on an individual channel: @{" CHANNELMAP " Link CHANNELMAP} filter all program change messages: @{" NOPC " Link NOPC} tell the channels not requiring mapping: @{" NOMAPCHANNELS " Link NOMAPCHANNELS} set an instrument for a channel: @{" CHANNELPC " Link CHANNELPC} Even if you have a GM synth, you may want to change the playing of the files beforehand without editing the files with a sequencer program. You can use tool types in a file's icon for this purpose. For example, if there is a very long silence after the last audible event before the end of the song, you can use @{" SKIP " Link SKIP} tool type for defining the longest gap between events and if a longer gap is encountered it will be skipped immediately. You can also use commands like TRANSPOSE to play your song in different key or command NOPB to filter out the pitch bender messages. If you are not satisfied with these settings, you only have to edit these tool types. Because these changes are not necessarily changed back when the next file is loaded, you can use a default file called def_midiplay.info in the ENV:sys directory to set all your default file values, which are set before the next file's tool types are read. With this feature you can have default values for files which have no tooltypes or e.g. tempo or instruments defined. You might have also changed (e.g. muted channels) your settings via the user interface during the playing of the previous song, but when this default file is loaded e.g. with MUTE=0 as a tooltype, all channels will be unmuted and you don't have to make all these changes by hand. See @{" ICON " Link ICON} option for more information. See also @{" TUTORIAL FOR ADJUSTING MIDI FILES USING ICONS " Link ICONER} provided by Johnny Bonde. @{b}Karaoke MIDI files@{ub} MidiPlay supports also files which have lyrics. MidiPlay can show certain amount of rows in a lyric window. The word to be sung is highlighted. The most common lyric format is soft karaoke which includes certain formatting commands, e.g. new line and new paragraph. These commands are known by MidiPlay and MidiPlay tries to show the lyrics according to them. There are also MIDI files which have no special format but all the lyrics are in these files as lyric events i.e. like the MIDI file standard says. MidiPlay can handle this case too by showing as much lyric events in the lyric window as possible (highlighting will work also). You can change the look of the lyric window with the following commands: @{" LYRICFONT " Link LYRICFONT} @{" LYRICCOLORS " Link LYRICCOLORS} @{b}Other features@{ub} include: o with MESSAGEREXX, FILENAMEREXX and FILETYPEREXX parameters you can e.g. hear messages and filenames via say command, view text files associated with MIDI files or decompress archives and play MIDI files in them See also @{" NEW FEATURES " Link NEW_FEATURES}. @ENDNODE @NODE NEW_FEATURES "NEW FEATURES" @{b}NEW FEATURES IN 2.58@{ub}: o all loading and playing routines now in a shared library called miditune.library o reqtools.library now optional, ASL file requester used as default. See option @{" REQTOOLS " Link REQTOOLS} o better support for karaoke files, lyric window changed: resizable, no more lyrictype button, more rows of lyric shown, also those words shown that should be sung later and the current word highlighted. The best support the soft karaoke files, but works also with files which have normal lyric events. You can control the font and the colors of the lyric window with options @{" LYRICFONT " Link LYRICFONT} and @{" LYRICCOLORS " Link LYRICCOLORS}. o @{" CHANNELMAP " Link CHANNELMAP} features lets you make program change maps also for individual channels o new kind of @{" selection window " Link SELECTWINDOW} with name selection also o @{" menus " Link MENU} reorganized o @{" Playlist window " Link PLAYLIST_WINDOW} changed: resizable, no more path text gadget, edit gadget opens now a file requester, Select => Play now called @{" Lock " Link SETLOCK} o Text Event Window now @{" Track Name Window " Link TRACKNAME_WINDOW}, shows only tracknames of the current MIDI file, no more check box gadgets o Intro play feature which lets you play only few seconds of each file See @{" INTROPLAY " Link INTROPLAY} and @{" INTROPLAYTIME " Link INTROTIME} o MidiPlay can be opened on a public screen with @{" PUBSCREEN " Link PUBSCREEN} option o You can transpose all note on/off messages to be merged by a certain amount with @{" MERGETRANSPOSE " Link MERGETRANSPOSE} command o With @{" SENDMIDIDATA " Link SENDMIDIDATA} you can transmit different MIDI messages to MIDI out. o Other new commands: @{" SELECTNUMBER " Link SELECTNUMBER} , @{" SELECTBUFFER " Link SELECTBUFFER} @{b}NEW FEATURES IN 2.30@{ub}: o option @{" MIDICLOCK " Link MIDICLOCK} (AREXX command SETMIDICLOCK) @{b}NEW FEATURES IN 2.26@{ub}: o Configuration file will be loaded as ENV:MidiPlay/MidiPlay.prefs or MidiPlay.prefs unless defined with SETTINGS=filename tooltype! You MUST define @{"SETTINGS" Link SETTINGS}=S:midiplay.config, if you want to use your old version, or rename it to MidiPlay.prefs o Window positions with open/closed and zoom information can be saved o @{"NOTEON" Link NOTEON} and @{"NOTEOFF" Link NOTEOFF} commands o @{"PORTNAME" Link PORTNAME} tooltype defines the name of the MidiPlay's ARexx port o FORWARD command requires now a value! o AppWindow and AppIcon features @ENDNODE @NODE INSTALLATION "INSTALLATION" Copy libraries midi.library and miditune.library to your LIBS: directory. A template configuration file (midiplay.prefs) is included with this archive, edit it to suit your needs and copy it to your MidiPlay directory, or ENV:MidiPlay and ENVARC:MidiPlay directories or define with SETTINGS=filename where it is located. Copy MidiPlay wherever you like. Configuration file is not necessary, you can use the tooltypes in the MidiPlay icon or in the project icons. Now there is also default MIDI icon, called def_midiplay.info. If you want use it, copy it to your ENV:sys and ENVARC:sys directories and set tooltypes suitable for your needs. See @{"ICON" Link ICON} for detailed description. If you use map files you should define in the configuration file where they are located. Couple of example ARexx scripts are included, copy them to your REXX: directory, if you want to use them. See starting options @{"FILENAMEREXX" Link FILENAMEREXX}, @{"FILETYPEREXX" Link FILETYPEREXX} and @{"MESSAGEREXX" Link MESSAGEREXX} for more information how to use them. You can use ReqTools requesters from the reqtools.library. This library is not included. See option @{" ReqTools " Link REQTOOLS}. @ENDNODE @NODE STARTING_MIDIPLAY "STARTING MIDIPLAY" Before the starting options or tooltypes are read, MidiPlay looks for configuration file name in SETTINGS=filename or +0filename (CLI argument). If the file name is not defined, MidiPlay looks for MidiPlay.prefs in the current directory or in ENV:MidiPlay directory. The first file found will be loaded. If the configuration file is not found or defined, MidiPlay's default settings are used. All configuration file settings can be changed through CLI arguments or tooltypes. From @{" CLI " Link CLI} From @{" WORKBENCH " Link TOOLTYPE} @ENDNODE @NODE CLI "STARTING FROM CLI" TYPE: midiplay [+|- options] [filename] NOTE (v2.0) : '-' sign means not the same as in previous versions! '+' sign means now that this options is set ON and '-' sign means that this option is set OFF. There is a '*' sign in the following list if + or - has no effect (you can use both of them). NOTE (v2.20): Symbol '|' is still available but using symbol ',' is now recommended. NOTE (v2.21): '-' option is now meaningful only with toggle options. This means that M (melody), m (mute), s (solo) and G (mapfile) have changed. '-' sign can be put right after the option letters m or s to get the same effect as before. Mapping can be set on/off using K option. NOTE (v2.21): if option ICON is set, MidiPlay tries to read tooltypes from ENV:sys/def_midiplay.info before loading tooltypes of a MIDI file. See options @{" ICON " Link ICON} for more information. NOTE (v2.26): SETTINGS=filename defines now the correct configuration file name, S:midiplay.config isn't known to MidiPlay anymore. midiplay.prefs in ENV:MidiPlay directory is recommended. More than one file is allowed. If no filename has been given, MidiPlay expects input from the current input stream, so redirection can be used. Simple options can be given together like: +dcbl. Options with numbers or text must be given separate from the following options. For example: +u10 +lbp35 +m1 +m2 HELP : @{" *? " Link HELP} FILEINFO : @{" +f " Link FILEINFO} TEXTINFO : @{" +x " Link TEXTINFO} NOMIDIOUTPUT: @{" +n " Link DONOTPLAY} TEMPO : @{" *tVALUE " Link TEMPO} DATAINFO : @{" +d " Link DATAINFO} MUTECHANNELS: @{" *mC1,C2... " Link MUTE} SOLOCHANNEL : @{" *sC " Link SOLO} TRANSPOSE : @{" *rVALUE " Link TRANSPOSE} DRUMCHANNEL : @{" *uC " Link DRUMCHANNEL} PC FILTER : @{" +c " Link NOPC} PB FILTER : @{" +b " Link NOPB} LOOP : @{" +l " Link LOOP} PRIORITY : @{" *pVALUE " Link PRIORITY} SEQUENTIAL : @{" +q " Link SEQ} MERGE : @{" +g " Link MERGE} EXT. SYNC : @{" +e " Link EXT} CIA TIMER : @{" +i " Link CIA} MAIN WINDOW : @{" +w " Link MWINDOW} SKIP : @{" *kVALUE " Link SKIP} DRUM PC FILT: @{" +o " Link NODRUMPC} NOMAPCHANNEL: @{" *hC1,C2... " Link NOMAPCHANNELS} BUFDEFAULT : @{" +a " Link BUFDEF} START : @{" +S " Link START} EXIT : @{" +X " Link EXIT} MIDISTART : @{" +D " Link MIDISTART} MAPFILE : @{" *Gfile " Link MAPFILETYPE} MAP ON/OFF : @{" +K " Link MAPPING} RESET TYPE : @{" +R " Link NRESET} QUANTIZE : @{" +Q " Link QUANTIZE} PLAYLISTFILE: @{" *Pfile " Link PLAYLIST} ICON LOADING: @{" +I " Link ICON} MELODY : @{" *Mc " Link MELODY} DRUMMAPFILE : @{" *Ufile " Link DRUMMAP} SOFT MUTING : @{" +O " Link SOFT} COUNT : @{" +C " Link COUNT} STATUS FIELD: @{" *Astatus " Link MFSTATUS} FADE STEPS : @{" *Fsteps " Link FADE} LYRICTYPE : @{" +J " Link LYRICTYPE} LIST PLAYING: @{" +Y " Link PLAYTYPE} PATCHCHANNEL: @{" *Nc1=c2,... " Link PATCHCHANNEL} VOLUMECHANGE: @{" *Vc:X,... " Link VOLUMECHANGE} MESSAGEREXX : @{" *Lfile " Link MESSAGEREXX} FILENAMEREXX: @{" *Efile " Link FILENAMEREXX} FILETYPEREXX: @{" *Hfile " Link FILETYPEREXX} FORCERESET : @{" +T " Link FORCERESET} DIRBUFFER : @{" +B " Link DIRBUFFER} SETTINGS : @{" *0file " Link SETTINGS} @ENDNODE @NODE TOOLTYPE "STARTING FROM WORKBENCH" DOUBLE CLICK MidiPlay icon or MIDI file icon (= project icon with default tool MidiPlay) or SELECT MIDI file icon and SHIFT DOUBLE CLICK MidiPlay icon. All selected MIDI files are added to the playlist. The tooltypes used in the program (default tool) icon are read. Options in the configuration file should be in the tooltype format. Tooltypes (=configuration options): @{" HELP MESSAGE " Link HELP} @{" FILEINFO=ON " Link FILEINFO} @{" TEXTINFO=ON " Link TEXTINFO} @{" DONOTPLAY=ON " Link DONOTPLAY} @{" TEMPO=VALUE " Link TEMPO} @{" DATAINFO=ON " Link DATAINFO} @{" MUTE=C1,C2... " Link MUTE} @{" SOLO=C " Link SOLO} @{" TRANSPOSE=VALUE " Link TRANSPOSE} @{" DRUMCHANNEL=C " Link DRUMCHANNEL} @{" NOPC=ON " Link NOPC} @{" NOPB=ON " Link NOPB} @{" LOOP=ON " Link LOOP} @{" PRIORITY=VALUE " Link PRIORITY} @{" SEQ=ON " Link SEQ} @{" MERGE=ON " Link MERGE} @{" EXT=ON " Link EXT} @{" CIA=ON " Link CIA} @{" WINDOW=ON " Link MWINDOW} @{" SKIP=VALUE " Link SKIP} @{" NODRUMPC=ON " Link NODRUMPC} @{" NOMAPCHANNELS=C1,C2... " Link NOMAPCHANNELS} @{" BUFDEF=ON " Link BUFDEF} @{" START=ON " Link START} @{" EXIT=ON " Link EXIT} @{" MIDISTART=ON " Link MIDISTART} @{" MAPFILE=file " Link MAPFILETYPE} @{" MAP=ON " Link MAPPING} @{" NRESET=ON " Link NRESET} @{" QUANTIZE=ON " Link QUANTIZE} @{" PLAYLIST=file " Link PLAYLIST} @{" ICON=ON " Link ICON} @{" MELODY=c " Link MELODY} @{" DRUMMAPFILE=file " Link DRUMMAP} @{" SOFT=ON " Link SOFT} @{" COUNT=ON " Link COUNT} @{" MFSTATUS=status " Link MFSTATUS} @{" FADE=steps " Link FADE} @{" LYRICTYPE=ON " Link LYRICTYPE} @{" PLAY=ON " Link PLAYTYPE} @{" PATCHCHANNEL=c1=c2,... " Link PATCHCHANNEL} @{" VOLUMECHANGE=c:X,... " Link VOLUMECHANGE} @{" MESSAGEREXX=file " Link MESSAGEREXX} @{" FILENAMEREXX=file " Link FILENAMEREXX} @{" FILETYPEREXX=file " Link FILETYPEREXX} @{" FORCERESET=ON " Link FORCERESET} @{" DIRBUFFER=ON " Link DIRBUFFER} @{" CHANNELBYTE=VALUE " Link CHANNELBYTE} @{" BANKCHANGETYPE=VALUE " Link BANKCHANGETYPE} @{" NOSYSEX=ON " Link NOSYSEX} @{" CHANNELPC=c:MAPINFO,... " Link CHANNELPC} @{" KEYBOARD=file " Link LOADKEYBOARD} @{" DEFAULTKEYBOARD " Link DEFAULTKEYBOARD} @{" PATTERN=pattern " Link PATTERN} @{" SETTINGS=file " Link SETTINGS} @{" PORTNAME=port " Link PORTNAME} @{" MIDICLOCK=ON " Link MIDICLOCK} @{" INTROPLAY=ON " Link INTROPLAY} @{" INTROTIME=time " Link INTROTIME} @{" REQTOOLS=ON " Link REQTOOLS} @{" CHANNELMAP=structure " Link CHANNELMAP} @{" PUBSCREEN=screenname " Link PUBSCREEN} @{" LYRICFONT=size,font " Link LYRICFONT} @{" LYRICCOLORS=text,highlight " Link LYRICCOLORS} @{" MERGETRANSPOSE=VALUE " Link MERGETRANSPOSE} @ENDNODE @NODE HELP "HELP" ToolType: - ARexx : - CLI : *? keyboard: - menu : - Help message. Default: - @ENDNODE @NODE FILEINFO "MIDI FILE INFORMATION" ToolType: FILEINFO= ARexx : SHOWFILEINFO CLI : <-|+>f keyboard: - menu : SETUP->SHOW OPTIONS->FILE INFO Prints details of the MIDI file to the console window: format, the number of the tracks and Steps/Quarter Note. Will be shown only right after loading of a new file. Same information is also available in About requester. Default: OFF @ENDNODE @NODE TEXTINFO "META EVENT PRINTING" ToolType: TEXTINFO= ARexx : SHOWMETA CLI : <-|+>x keyboard: - menu : SETUP->SHOW OPTIONS->META EVENTS Prints all meta events in the file to the console window. A meta event can express tempo, time signature, key signature or a text event (copyright notice, sequence/track name, instrument name, lyric etc.). Default: OFF See also: @{" COUNT " Link COUNT} @{" LYRIC WINDOW " Link LYRIC_WINDOW} @ENDNODE @NODE DONOTPLAY "DO NOT SEND MIDI EVENTS" ToolType: DONOTPLAY= ARexx : SETNOMIDIOUTPUT CLI : <-|+>n keyboard: - menu : SETUP->MIDI OPTIONS->NO MIDI OUTPUT Prevents MidiPlay from sending events to MIDI port. Using this option you can print all the events without a long delay between events (delay is about 10ms). Default: OFF @ENDNODE @NODE TEMPO "SET TEMPO" ToolType: TEMPO= ARexx : TEMPO CLI : *t keyboard: - menu : - Values : 40-240 or 0 Sets playing tempo to VALUE (BPM). Tempo change messages in the midi file are ignored. If value is 0, tempo is set to default value. Default: 120 (and tempo messages not ignored) See also: @{" TEMPODOWN " Link TEMPODOWN} @{" TEMPOUP " Link TEMPOUP} @ENDNODE @NODE DATAINFO "MIDI EVENT PRINTING" ToolType: DATAINFO= ARexx : SHOWDATA CLI : <-|+>d keyboard: - menu : SETUP->SHOW OPTIONS->DATA EVENTS Prints all real midi events in the file to the console window. Default: OFF @ENDNODE @NODE MUTE "MUTE CHANNELS" ToolType: MUTE=,... ARexx : MUTECHANNELS ,... CLI : *m,... keyboard: - menu : - Values : 1-16, sign can be '-', '+' or nothing Mutes all events on requested channels. If sign is '-', MUTE ON is set OFF, otherwise it is set ON. You can mute all selected channels by setting @{" MUTE ON " Link MUTE_ON} to ON. If channel is 0, all channels will be unmuted. You can put MUTE=0 to your configuration file or to def_midiplay.info. Example: MUTE=1,5,9 mutes channels 1, 5 and 9. Default: no muting @ENDNODE @NODE SOLO "SOLO CHANNEL" ToolType: SOLO= ARexx : SOLOCHANNEL CLI : *s keyboard: - menu : - Values: 0-16 Sends events only on requested channel. Sets setting @{" SOLO ON " Link SOLO_ON} to ON when sign is not '-'. Otherwise it is set off. By setting channel to 0 and SOLO ON on, you can mute all channels at once. Default: no soloing @ENDNODE @NODE TRANSPOSE "TRANSPOSE" ToolType: TRANSPOSE= ARexx : TRANSPOSE CLI : *r keyboard: - menu : - Values : -12-+12 Transposes all note on/off messages by value (see also @{" DRUMCHANNEL " Link DRUMCHANNEL} option). NOTE! TRANSPOSE in MIDI file icon is relative to the earlier setting e.g. if you have set transpose value to 5 using Preferences window and there is TRANSPOSE=2 tooltype in the MIDI file icon, the new transpose value will be 5+2 = 7. TRANSPOSE value in def_midiplay.info icon is NOT relative, it is absolute value! Default: 0 @ENDNODE @NODE DRUMCHANNEL "SETS DRUM CHANNEL" ToolType: DRUMCHANNEL= ARexx : DRUMCHANNEL CLI : *u keyboard: - menu : - Values: 0-16 Sets drum channel. If this option is given, no transpose will occur on this channel. Default: 10 @ENDNODE @NODE NOPC "PROGRAM CHANGE FILTER" ToolType: NOPC= ARexx : SETNOPC CLI : <-|+>c keyboard: - menu : SETUP->FILTER OPTIONS->PROGRAM CHANGE Program change messages are not passed if this option is set. Default: OFF See also: @{" NO DRUM PC " Link NODRUMPC} @ENDNODE @NODE NOPB "PITCH BENDER FILTER" ToolType: NOPB= ARexx : SETNOPB CLI : <-|+>b keyboard: - menu : SETUP->FILTER OPTIONS->PITCH BENDER Pitch bender messages are not passed if this option is set. Default: OFF @ENDNODE @NODE LOOP "LOOP" ToolType: LOOP= ARexx : SETLOOP CLI : <-|+>l keyboard: F6 menu : SETUP->PLAY OPTIONS->LOOP (AMIGA-O) Loop. When the end of the song is reached, the song is played again. Default: OFF @ENDNODE @NODE PRIORITY "SETS PLAYER PRIORITY" ToolType: PRIORITY= ARexx : PRIORITY CLI : *p keyboard: - menu : - Values : -128-+127 Sets the player priority. Default : 30 @ENDNODE @NODE SEQ "SEQUENTIAL PLAYING" ToolType: SEQ= ARexx : SETSEQUENCE CLI : <-|+>q keyboard: - menu : SETUP->PLAY OPTIONS->SEQUENTIAL Plays tracks (in format 1 files) in sequence. Default: OFF @ENDNODE @NODE MERGE "MIDI MERGE" ToolType: MERGE= ARexx : SETMERGE CLI : <-|+>g keyboard: F4 menu : SETUP->MIDI OPTIONS->MERGE Merges MIDI input to MIDI output (actually, it routes the MidiIn port to the MidiOut port). Default: OFF @ENDNODE @NODE EXT "EXTERNAL SYNC" ToolType: EXT= ARexx : SETSYNC CLI : <-|+>e keyboard: - menu : SETUP->MIDI OPTIONS->EXTERNAL SYNC Receives clock signals from an external source and synchronizes to it. Tempo can be controlled in real time from the source. The program waits a Start or Continue message from that source before starting. MidiPlay can be stopped by sending a Stop message. If this option is not given, MidiPlay transmits clock signals and Start and Stop messages unless option @{"MIDICLOCK" Link MIDICLOCK} is unset. Thus an external source can be synchronized to MidiPlay. If @{"CIA timer" Link CIA} is selected, it will be used in internal sync mode. Otherwise all timing will be done through timer.device. Default: OFF (internal sync) See also: @{" MIDI START " Link MIDISTART} @ENDNODE @NODE CIA "CIA TIMER" ToolType: CIA= ARexx : SETCIA CLI : <-|+>i keyboard: - menu : SETUP->MISC OPTIONS->CIA TIMER If this option is set and internal sync is used, MidiPlay will use CIA timer. Otherwise timer.device will be used. Use of CIA timer may improve timing. Default: OFF @ENDNODE @NODE MWINDOW "SHOWS MAIN WINDOW" ToolType: WINDOW= ARexx : SETWINDOW CLI : <-|+>w keyboard: - menu : - Shows the main window. ARexx command affects only window updating. If -w is used: there is no keyboard or menu available. The given file(s) will be played unless option -S is used. After all files have been played and if +X option is set, the program exits. Otherwise all files are played again. If loop is used, the first file will be played again. You can stop the program by pressing CTRL-C or CTRL-D (if started from CLI or started from Workbench and text window is open) or by using ARexx QUIT command. Default: ON @ENDNODE @NODE SKIP "SKIPS EMPTY MEASURES" ToolType: SKIP= ARexx : SKIP CLI : *k keyboard: - menu : - Values : 1- If this option is set, MidiPlay will skip all eventless measures if their number is bigger than given value. Default: 20 @ENDNODE @NODE NODRUMPC "NO PROGRAM CHANGE ON DRUM CHANNEL" ToolType: NODRUMPC= ARexx : SETNODRUMPC CLI : <-|+>o keyboard: - menu : SETUP->FILTER OPTIONS->NO DRUM PC If this option is set, MidiPlay will ignore all program change messages on the drum channel. Default: OFF See also: @{" NO PC " Link NOPC} @ENDNODE @NODE NOMAPCHANNELS "NO MAPPING ON CHANNELS" ToolType: NOMAPCHANNELS=,... ARexx : NOMAPCHANNELS ,... CLI : *h,... keyboard: - menu : - Values : 1-16 If this option is used, program change mapping won't apply to given channels. This option doesn't affect drum mapping. If channel is 0, NOMAPCHANNELS is reset to the default value. Example: NOMAPCHANNELS=11,12 means that mapping won't apply to channels 11 and 12. Default: mapping on all channels @ENDNODE @NODE BUFDEF "BUFFER AS DEFAULT SELECTION" ToolType: BUFDEF= ARexx : SETBUFDEFAULT CLI : <-|+>a keyboard: - menu : SETUP->MISC OPTIONS->BUFFER SELECT When this options is used, default selection for the selection requester will be buffer. This means that if you select some number from the playlist, it won't be played until the current file has been played or you press CURSOR DOWN key. Default selection can always be overridden by pressing the PLAY gadget in the selection window. Default: OFF See also: @{" SELECTION WINDOW " Link SELECTWINDOW} @ENDNODE @NODE START "IMMEDIATE START AFTER LOADING" ToolType: START= ARexx : SETSTART CLI : <-|+>S keyboard: F5 menu : SETUP->PLAY OPTIONS->START AFTER LOAD (AMIGA-T) Playing starts immediately after the MIDI file has been loaded. If not set, the program will wait until you press PLAY or CONT gadgets, space bar or TAB key or send corresponding ARexx message. Default: ON @ENDNODE @NODE EXIT "EXIT AFTER PLAYING" ToolType: EXIT= ARexx : SETEXIT CLI : <-|+>X keyboard: - menu : SETUP->PLAY OPTIONS->EXIT AFTER PLAY (AMIGA-X) The program exits after the current file has been played. If MidiPlay has been started without a window and this option is set, the program will exit after all files in the playlist have been played. Default: OFF @ENDNODE @NODE MIDISTART "WAITS EXTERNAL START" ToolType: MIDISTART= ARexx : SETMIDISTART CLI : <-|+>D keyboard: - menu : SETUP->MIDI OPTIONS->MIDI START If external sync is used, the program won't start playing until it receives START or CONT message from the external source. Default: ON See also: @{" EXTERNAL SYNC " Link EXT} @ENDNODE @NODE MAPPING "MAPPING" ToolType: MAP= ARexx : SETMAP CLI : <-|+>K keyboard: - menu : SETUP->FILTER OPTIONS->MAP If this option is set, program change messages will be mapped according to the @{"map file" Link MAPFILE} or individual @{" channel maps " Link CHANNELMAP}. If this option is not set, the map file won't be used even if it were loaded. Default: OFF (no mapping) @ENDNODE @NODE MAPFILETYPE "PROGRAM CHANGE MAPFILE" ToolType: MAPFILE= ARexx : LOADMAP CLI : *G keyboard: - menu : - The program uses file for mapping the program change messages. See @{"content of mapfile" Link MAPFILE}. If @{"MAP" Link MAPPING} is set off, mapping won't be used. Default: no mapfile See also: @{" CHANNEL MAPS " Link CHANNELMAP} @ENDNODE @NODE NRESET "NORMAL RESET" ToolType: NRESET= ARexx : SETRESET CLI : <-|+>R keyboard: - menu : SETUP->RESET OPTIONS->NORMAL RESET The program doesn't use GM reset message. It sends normal reset instead. See also: @{" SENDRESET " Link Reset} @{" FORCERESET " Link FORCERESET} Default: OFF (international) @ENDNODE @NODE QUANTIZE "QUANTIZE" ToolType: QUANTIZE= ARexx : SETQUANTIZE CLI : <-|+>Q keyboard: - menu : SETUP->PLAY OPTIONS->QUANTIZE The program quantizes all event times to the nearest multiple of "steps/measure" / 24. Default: OFF @ENDNODE @NODE PLAYLIST "PLAYLIST FILE" ToolType: PLAYLIST= ARexx : LOADPLAYLIST CLI : *P keyboard: - menu : PROJECT->OPEN PLAYLIST (with requester) The program loads file as a playlist. See @{" File control " Link File_control}. Default: no playlist @ENDNODE @NODE ICON "READS TOOLTYPES" ToolType: ICON= ARexx : SETICON CLI : <-|+>I keyboard: - menu : SETUP->PLAY OPTIONS->LOAD .INFO If this option is set and a new MIDI file is loaded, the tooltypes are read from the icon (if there is an icon). Before loading of the the tooltypes, MidiPlay tries to read tooltypes in the file ENV:sys/def_midiplay.info and set those default file values. Using def_midiplay icon you can decide which values should always be changed even when there is no icon for a file. You could use e.g. TEMPO=0 to set tempo to default value or MUTE=0 to unmute all channels. Value of transpose is bit different. Value in def_midiplay icon is absolute value and in a file icon it is relative (to def_midiplay value or to earlier value), e.g. if for some reason you want all files to be played in lower key preserving the values you have earlier given for files, put suitable negative transpose value to your def_midiplay icon. Default: OFF @ENDNODE @NODE MELODY "MELODY CHANNEL" ToolType: MELODY= ARexx : MELODY CLI : *M keyboard: - menu : - Values : 0-16 (channel), sign can be '-', '+' or nothing This sets the melody channel to given value and that channel is muted. If channel is negative (i.e. sign is '-'), the melody channel won't be muted at the beginning. Default: 0 See also: @{" MELODY CHANNEL " Link MELODY_CHANNEL} @{" MUTE MELODY " Link SETMELODY} @{" MELODY VOLUME DOWN " Link MELODYVOLUMEDOWN} @{" MELODY VOLUME UP " Link MELODYVOLUMEUP} @ENDNODE @NODE DRUMMAP "DRUM MAPFILE" ToolType: DRUMMAPFILE= ARexx : LOADDRUMMAP CLI : *U keyboard: - menu : - The program uses file for mapping the note on/off messages on the drum channel. If MAP is set off, the map file will be loaded but it won't be used. Default: no drum mapfile See also: @{" MAPFILE " Link Mapfile} @ENDNODE @NODE SOFT "SOFT MUTING" ToolType: SOFT= ARexx : SETSOFT CLI : <-|+>O keyboard: - menu : SETUP->MIDI OPTIONS->MUTE ONLY NOTES If this option is used, all messages except note on/off will be passed on muted channels. In this case, the program uses two different routes between MidiPlay and MidiOut. The first one passes only note on/off messages and the other one all other messages. If unset, no messages will be passed. Default: OFF @ENDNODE @NODE COUNT "COUNT MEASURES AND COLLECTS TEXT EVENTS" ToolType: COUNT= ARexx : SETCOUNT CLI : <-|+>C keyboard: - menu : SETUP->PLAY OPTIONS->COUNT If this option is used, the number of the measures in a MIDI file and the duration of the file in seconds will be counted after the file has been loaded. This may take couple of seconds, but then you are able to see e.g. how many seconds are remain during playing. During the counting operation also lyric events are collected for lyric output, track names are collected for the track name window and song name and copyright events are set to the corresponding fields in the main window. If this option is not set when the file is loaded, features mentioned above are not available. Default: OFF See also: @{" TRACK NAME WINDOW " Link TRACKNAME_WINDOW} @{" LYRIC WINDOW " Link LYRIC_WINDOW} @ENDNODE @NODE MFSTATUS "MEASURE FIELD STATUS" ToolType: MFSTATUS= ARexx : SETSTATUSFIELD CLI : *A keyboard: - menu : - Value : 0-3 Status tells what is the state of the measure field in the beginning. Status can be: 0 = none 1 = measure 2 = time 3 = remain Default: 0 See also: @{" STATUS FIELD UP " Link STATUSFIELDUP} @ENDNODE @NODE FADE "FADE" ToolType: FADE= ARexx : FADE CLI : *F keyboard: - menu : - Values : 0 - Steps defines how many steps (tenth of seconds) fade out requires when playing is stopped. When volumes have been faded to zero, all notes off message is sent. Not every instrument reacts correctly to volume message (CC 7). This means that some sounds keep playing until notes off message is sent. 0 means that no fading will be done, pressing STOP gadget or SPACE BAR will stop playing but all notes keep playing until user sends all notes off message by pressing STOP gadget again or ESC. Default: 0 @ENDNODE @NODE LYRICTYPE "LYRIC TYPE" ToolType: LYRICTYPE= ARexx : SETLYRICTYPE CLI : <-|+>J keyboard: - menu : - This option is not available since 2.51beta. Lyric type defines what text events will be seen in the lyric window. If this is set ON, only normal lyric events (FF 5) will be seen, otherwise normal text events (FF 1) will be seen. Default: ON @ENDNODE @NODE PLAYTYPE "SETS PLAYLIST PLAYING" ToolType: PLAY= ARexx : SETPLAYLIST CLI : <-|+>Y keyboard: F7 menu : SETUP->PLAY OPTIONS->AUTO LOAD NEXT (AMIGA-Y) When this option is set, MidiPlay will load a new file from the playlist after the last one has been played. MidiPlay plays first the number 1 in the beginning of the program. Exception: if playlist has been given and other files are given on the command line or other file icons are selected, other files will be added to the end of the playlist and playing is started from the first file after the given playlist files. The current file number played is shown in the window title after the file name, like file :1/Amount. If the file name has an extension, it won't be shown. Amount means the number of files in the playlist. The current number can be change back to 1 using FIRST or SELECT. If you want that a new file is loaded but playing is not started, unset START AFTER LOAD. Default: ON See also: @{" FILE CONTROL " Link FILE_CONTROL} @{" START AFTER LOAD " Link START} @{" SELECTION WINDOW " Link SELECTWINDOW} @{" PLAYLIST WINDOW " Link PLAYLIST_WINDOW} @ENDNODE @NODE PATCHCHANNEL "CHANNEL PATCHING" ToolType: PATCHCHANNEL=,... ARexx : PATCHCHANNEL ,... CLI : *N,... keyboard: - menu : - Values : 0-16 If this option is used, every message originally meant for the first channel will be sent on the second channel instead of the first one. If the first channel is 0 and the second channel is greater than 0, all channel will be set to the value of the second channel. If both are zeros, channels are set to normal values, i.e. 1=1,2=2,3=3... Default: no patch @ENDNODE @NODE VOLUMECHANGE "VOLUMECHANGE" ToolType: VOLUMECHANGE=,... ARexx : SETVOLUMECHANGE ,... CLI : *V,... keyboard: - menu : - Values : 0-16 for channel, -128-+127 for change If this option is used, change will be added to every volume message (CC 7) on channel. change can also be negative. If change is 0, nothing will be added. If channel is 0, volumechange on all channels (1-16) will be set to the change value. Default: 0 (all channels) See also: @{" VOLUMEDOWN " Link VOLUMEDOWN} @{" VOLUMEUP " Link VOLUMEUP} @ENDNODE @NODE MESSAGEREXX "DEFINES SCRIPT FOR MESSAGES" ToolType: MESSAGEREXX= ARexx : MESSAGEREXX CLI : *L keyboard: - menu : - This option replaces old NOMON option. filename is an ARexx script, that will be called every time a message is shown on the screen. The script gets the contents of the message as an argument. See also @{" Example 1 " Link EXA1}. Default: no script @ENDNODE @NODE FILENAMEREXX "DEFINES SCRIPT FOR FILENAMES" ToolType: FILENAMEREXX= ARexx : FILENAMEREXX CLI : *E keyboard: - menu : - This options replaces old SPEAK option. filename is an ARexx script, that will be called after a new file has been loaded. The script gets the following argument: Drive,Path,File,Extension (commas included). You can use this script e.g. to speak the filename or to view a text file associated with this MIDI file. See also @{"Example 2 " Link EXA2}. Default: no script @ENDNODE @NODE FILETYPEREXX "DEFINES SCRIPT FOR NON-MIDI FILES" ToolType: FILETYPEREXX= ARexx : FILETYPEREXX CLI : *H keyboard: - menu : - This option defines an ARexx script, which will be called when the current file is not a MIDI file. The main purpose of this script could be unpacking archived files. The script gets the following argument: Drive,Path,File,Extension (commas included). See also @{" Example 3 " Link EXA3}. Default: no script @ENDNODE @NODE FORCERESET "FORCES RESET" ToolType: FORCERESET= ARexx : SETFORCERESET CLI : <-|+>T keyboard: - menu : SETUP->RESET OPTIONS->FORCE RESET If this option is set, every channel will be reset in spite of the mute/PC/PB settings. If this option is not set, current settings are taken into account. Default: ON See also: @{" RESET " Link NRESET} @{" SEND RESET " Link RESET} @ENDNODE @NODE DIRBUFFER "REMEMBERS LAST DIRECTORY" ToolType: DIRBUFFER= ARexx : SETDIRBUFFER CLI : <-|+>B keyboard: - menu : SETUP->MISC OPTIONS->DIRECTORY BUFFER (AMIGA-B) If this option is set, the MIDI file load requester will remember the contents of the current directory. If unset, the requester will scan the current directory everytime it is opened. This option available only for @{" ReqTools " Link REQTOOLS} requesters. Default: ON @ENDNODE @NODE CHANNELBYTE "CHANNELBYTE FOR TONE SYSEX" ToolType: CHANNELBYTE= ARexx : CHANNELBYTE CLI : - keyboard: - menu : - Values : 3 - ? This option is used in external tone files. If some program change is mapped to an external tone file, which consists of one system exclusive message, bytenumber tells which byte in the sysex message is replaced with program change's channel. Default: 3 (This is a device ID on most synths) @ENDNODE @NODE BANKCHANGETYPE "TYPE OF BANK CHANGE MESSAGE" ToolType: BANKCHANGETYPE= ARexx : BANKCHANGETYPE CLI : - keyboard: - menu : - Values : 0,1,2 or 32 This option defines the bank change message which is sent when a program change is mapped to a bank change + program change combination. There seems to be conflicting bank changes on different synths. Some require at least CC 0, but others CC 32. Value 0 means that the MSB byte is 0, if the value is 32, the MSB is 32, e.g. if bank change 3 is going to be sent and typenumber is 0, CC 0 3 CC 32 0 will be sent, but if typenumber is 32, CC 0 0 CC 32 3 will be sent. If your synth doesn't recognize these bank changes, but they can be defined somehow with a sysex message, contact me with a correct format so that I can add it to MidiPlay. Value 1 is for Roland D-10 and value 2 for Yamaha FB01. Default: 0 @ENDNODE @NODE NOSYSEX "SYSEX MESSAGES IN FILES NOT SENT" ToolType: NOSYSEX= ARexx : SETNOSYSEX CLI : - keyboard: - menu : SETUP->FILTER OPTIONS->SYSEX If this option is set, all system exclusive messages in MIDI files are filtered out. Default : OFF @ENDNODE @NODE CHANNELPC "PROGRAM CHANGE FOR CURRENT FILE" ToolType: CHANNELPC=,... ARexx : CHANNELPC ,... CLI : - keyboard: - Values : 1-16 for channel This tooltype should be used only with individual MIDI files and it shouldn't be used in the configuration file or in the default MidiPlay icon. When CHANNELPC is used, MidiPlay sends defined program change message right before the playing is started. All program change messages encountered in the current MIDI file are ignored. All CHANNELPC settings are cleared when a MIDI file is loaded. Note: If a MIDI file includes a SYSEX reset, all channelpc settings are lost. maptype can be: -value value is mapped according to map file, value can be between 0-127 value value is sent as a program change, value can be between 0-127 Bbank:value bank change and a program change are sent, bank and value can be between 0-127 Ttonefilename message from tonefile is sent, correct channel is set according to @{"CHANNELBYTE" Link CHANNELBYTE}, only 128 tonefiles can be in memory in any time C clears CHANNELPC setting on channel For example, if CHANNELPC=4:-10 is used, program change defined in the current mapfile on row 11 is sent on channel 4. If CHANNELPC=3:B2:20 is used, bank change 3 and program change 20 are sent on channel 3. See also @{"MAP FILE FORMAT" Link MAPFILE}. Default : No forced program changes @ENDNODE @NODE CONNECTMIXER "CONNECTS AN EXTERNAL MIXER" ToolType: - ARexx : CONNECTMIXER CLI : - keyboard: - menu : WINDOWS->CONNECT MIXER If this command is set, an external MIDI mixer will be connected to MidiPlay. If the mixer isn't running, it will be started. By unsetting this option the connection is removed, but the mixer is not quitted. If the mixer has been started from MidiPlay, it will be closed at exit. Currently only Mixer included in MidiPlay ToolKit is supported. When the mixer is running, control, note and program change messages are sent to the mixer. When the mixer is started from MidiPlay or the connection is made to already running mixer, all current volumes are sent to the mixer. Default : Not connected. @ENDNODE @NODE MUTETOGGLE "TOGGLES SELECTED CHANNEL" ToolType: - ARexx : MUTETOGGLE CLI : - keyboard: <1>|<2>|<3>|<4>|<5>|<6>|<7>|<8>|<9>|<0>||| ||| menu : - Values : 1-16 If this command is sent, the state of the channel is changed, i.e. if it is muted, it will be unmuted and if it is unmuted, it will be muted. See also: @{" MUTE CHANNELS " Link MUTE} @{" MUTE ON " Link MUTE_ON} @ENDNODE @NODE STATUSFIELDUP "TOGGLES SELECTED CHANNEL" ToolType: - ARexx : STATUSFIELDUP CLI : - keyboard: u menu : - If this command is sent, the state of the measure field is changed to the next state. See @{"MEASURE FIELD STATUS" Link MFSTATUS}. @ENDNODE @NODE ACTIVATENEXTWIN "ACTIVATES THE NEXT OPEN WINDOW" ToolType: - ARexx : ACTIVATENEXTWIN CLI : - keyboard: i menu : - If this command is sent, the next open window will be activated. @ENDNODE @NODE ACTIVATEDRUMGAD "ACTIVATES THE DRUM CHANNEL GADGET" ToolType: - ARexx : ACTIVATEDRUMGAD CLI : - Keyboard: d menu : - If this command is sent and preferences window is open, the @{" drum channel " Link DRUMCHANNEL } gadget will be activated. @ENDNODE @NODE ACTIVATESOLOGAD "ACTIVATES THE SOLO CHANNEL GADGET" ToolType: - ARexx : ACTIVATESOLOGAD CLI : - Keyboard: s menu : - If this command is sent and preferences window is open, the @{" solo channel " Link SOLO} gadget will be activated. @ENDNODE @NODE ACTIVATEMELODYGAD "ACTIVATES THE MELODY CHANNEL GADGET" ToolType: - ARexx : ACTIVATEMELODYGAD CLI : - Keyboard: l menu : - If this command is sent and preferences window is open, the @{" melody channel " Link MELODY} gadget will be activated. @ENDNODE @NODE MELODYVOLUMEDOWN "VOLUME CHANGE OF THE MELODY CHANNEL DOWN" ToolType: - ARexx : MELODYVOLUMEDOWN CLI : - Keyboard: + menu : - If this command is sent, the volume change of the melody channel will be decreased by amount. See also: @{" MELODY CHANNEL " Link MELODY} @{" MELODY VOLUME UP " Link MELODYVOLUMEUP} @ENDNODE @NODE MELODYVOLUMEUP "VOLUME CHANGE OF THE MELODY CHANNEL UP" ToolType: - ARexx : MELODYVOLUMEUP CLI : - Keyboard: + menu : - If this command is sent, the volume change of the melody channel will be increased by amount. See also: @{" MELODY CHANNEL " Link MELODY} @{" MELODY VOLUME DOWN " Link MELODYVOLUMEDOWN} @ENDNODE @NODE LOADKEYBOARD "LOADS KEYBOARD SETTINGS" ToolType: KEYBOARD ARexx : LOADKEYBOARD CLI : - keyboard: - menu : - If this command is sent, keyboard settings will be loaded from filename. Keyboard files can be edited by using KeyboardEditor (included in @{"MidiPlay ToolKit" Link MPTOOLKIT}). Keyboard files map only raw key codes so custom keyboard files should preserve the correct keys underlined in the user interface, e.g. letters a, s, d, l, m should have correct functions if you want to keep the interface consistent. Only default keyboard hard coded in MidiPlay maps these keys correctly on different local keymaps. Default: Default keyboard @ENDNODE @NODE DEFAULTKEYBOARD "RETURNS DEFAULT KEYBOARD" ToolType: DEFAULTKEYBOARD ARexx : DEFAULTKEYBOARD CLI : - keyboard: - menu : - If this command is sent, the default keyboard is set back. See also: @{" LOAD KEYBOARD " Link LOADKEYBOARD} @ENDNODE @NODE PATTERN "DEFINES PATTERN USED IN MIDI FILE REQUESTER" ToolType: PATTERN= ARexx : - CLI : - keyboard: - menu : - This setting defines the pattern which will be used in the MIDI file requester. This pattern will be used every time. Clearing the file requester's pattern gadget won't clear this setting i.e. it will be shown every time the requester is opened. Default: No pattern @ENDNODE @NODE SETTINGS "DEFINES CONFIGURATION FILENAME" ToolType: SETTINGS= ARexx : - CLI : *0 keyboard: - menu : - SETTINGS defines the name of the configuration file which will be loaded before any other tooltypes or CLI options will be read. You should put SETTINGS tooltype into MidiPlay (tool) icon. This tooltype is useless in project or def_midiplay icons. Examples: SETTINGS=S:midiplay.config (ToolType) +0S:midiplay.config (CLI) Default: midiplay.prefs or ENV:MidiPlay/midiplay.prefs @ENDNODE @NODE PORTNAME "DEFINES THE NAME OF MIDIPLAY'S AREXX PORT" ToolType: PORTNAME= ARexx : - CLI : - keyboard: - menu : - PORTNAME defines the name of the MidiPlay's ARexx port. Normally, MidiPlay_rexx is used, but if you don't like it, you can change it via this tooltype. This tooltype can be put into MidiPlay icon or in the SETTINGS file. The name of the port cannot be changed after it has been created. Example : PORTNAME=myport Default : MidiPlay_rexx See also: @{" MIDIPLAY AREXX COMMANDS " Link AREXX} @ENDNODE @NODE ICONIFY "ICONIFIES OR DEICONIFIES MIDIPLAY" ToolType: - ARexx : ICONIFY CLI : - keyboard: - menu : PROJECT->ICONIFY (AMIGA-F) If ICONIFY ON command is used, all MidiPlay windows will be closed and only a small icon will be shown on Workbench Screen. This icon is an AppIcon. Every icon (MIDI file!) dragged into this icon causes the corresponding file to be added to the playlist (but it is not automatically played). If ICONIFY OFF command is sent when MidiPlay is iconified, MidiPlay will be returned to the original window positions before it was iconified (this is the same action as double clicking on the AppIcon). Example : ICONIFY ON (Iconifies MidiPlay) Default : - @ENDNODE @NODE MIDICLOCK "MIDI START/CLOCK/STOP MESSAGES WILL BE SENT" ToolType: MIDICLOCK= ARexx : SETMIDICLOCK CLI : - keyboard: - menu : SETUP->MIDI OPTIONS->SEND MIDI CLOCK If this option is set, and internal sync is used, START message will be sent when a file is started, STOP message will be sent when a file has been played and CLOCK messages will be sent (24 times per quarter-note). Default : ON @ENDNODE @NODE NOTEON "SENDS NOTEON MESSAGE" ToolType: - ARexx : NOTEON ,,... CLI : - keyboard: - menu : - Values : channel 0-16 note = letter (sharp) octave e.g. C3 or F#4 This command sends NOTEON (0x90) MIDI command on the defined channel. If channel is 0, melody channel will be used. Velocity 100 is always used. Remember always send the corresponding NOTEOFF command! Example : NOTEON 0:C3,0:D#3,0:G3 (sends C minor chord on melody channel) Default : - @ENDNODE @NODE NOTEOFF "SENDS NOTEOFF MESSAGE" ToolType: - ARexx : NOTEOFF ,,... CLI : - keyboard: - menu : - This command sends NOTEOFF (0x80) MIDI command on the defined channel. If channel is 0, melody channel will be used. Example : NOTEOFF 0:C3,0:D#3,0:G3 (turns off C minor chord on melody channel) Default : - @ENDNODE @NODE CHANNELMAP "PROGRAM CHANGE MAPS FOR DIFFERENT CHANNELS" ToolType: CHANNELMAP=,,,... ARexx : CHANNELMAP ,,,... CLI : - keyboard: - menu : - values : channel 0-17 (0 = all channels, 17 = global map table = MAPFILE) With this options it is possible to have different maps for different channels. The exact map structure is shown below: mapstruct::= the global map will be used on the given channel mapstruct::= the map file will be used on the given channel. You cannot use channel 0 (i.e. all channels) in this case mapstruct::= all PCs will be set to the mapformat value on the given channel mapstruct::= <:> PC with number will be set to the mapformat value. You cannot refer to all channels with this structure (use global map instead) mapformat::= (use of this can cause troubles!) mapformat::= <:> mapformat::= Examples: CHANNELMAP=1,A20 (all pcs will be mapped to 20 on channel 1) CHANNELMAP=3,10:B1:10 (pc 10 will be mapped to bank 1 pc 10 on channel 3) CHANNELMAP=2,C (all pcs on channel 2 will be mapped according to global map i.e. the normal map file which can also be referred as channel 17, e.g. CHANNELMAP=17,4:5 will map pc 4 to 5 on channels which are set as mapchannels and there are no local map i.e. structure C has been used) Remember to set MAP option and clear first all channels with CHANNELMAP=0,C in your config file (if you don't clear, local maps will be used on all channels and every pc will be mapped to 0!). You can put these settings one after another like CHANNELMAP=2,C,1:2,2:3,3:4 i.e. every row can refer to only one channel or all channels with channel 0.) See also: @{" MAPPING ON " Link MAPPING} @{" MAP FILE " Link MAPFILETYPE} @{" DRUMMAP FILE " Link DRUMMAP} @{" NO MAP CHANNELS " Link NOMAPCHANNELS} @ENDNODE @NODE INTROPLAY "INTROPLAY" ToolType: INTROPLAY= ARexx : SETINTROPLAY CLI : - keyboard: - menu : SETUP->PLAY OPTIONS->INTRO PLAY When this option is set, the current file is played only a short time defined by @{" INTROTIME " Link INTROTIME} option. Default : OFF @ENDNODE @NODE INTROTIME "INTROTIME" ToolType: INTROTIME= ARexx : INTROPLAYTIME CLI : - keyboard: - menu : - INTROTIME value defines how long the current file will be played when @{" INTROPLAY " Link INTROPLAY} option is set. Default : 10 seconds @ENDNODE @NODE REQTOOLS "REQTOOLS REQUESTERS WILL BE USED INSTEAD OF ASL" ToolType: REQTOOLS= ARexx : SETREQTOOLS CLI : - keyboard: - menu : SETUP->MISC OPTIONS->USE REQTOOLS When this option is not set, normal ASL requester or easy requesters will be used. When this option is set, requesters in the reqtools.library will be used if this library has been found. Default : OFF @ENDNODE @NODE PUBSCREEN "MIDIPLAY OPENED ON AN EXISTING PUBLIC SCREEN" ToolType: PUBSCREEN= ARexx : - CLI : - keyboard: - menu : - If PUBSCREEN has been defined in the configuration file or in the MidiPlay's tool types, MidiPlay will be opened on the given public screen. If this public screen doesn't exist, MidiPlay will be opened on the default public screen (Workbench). Default : NULL @ENDNODE @NODE LYRICFONT "FONT FOR THE LYRIC WINDOW" ToolType: LYRICFONT=, ARexx : LYRICFONT , CLI : - keyboard: - menu : - With this command you can define the font to be used in the @{" lyric window " Link LYRIC_WINDOW}. The ".font" ending must be included. Use of non-proportional font is strongly recommended. Example : LYRICFONT=11,topaz.font Default : System default text @ENDNODE @NODE LYRICCOLORS "COLORS FOR THE LYRICS" ToolType: LYRICCOLORS=, ARexx : LYRICCOLORS , CLI : - keyboard: - menu : - value : 0-7 for colors in the current color palette You can select colors for the lyric window with this command. The first number tells the text colors which will be used to print the text. The second number tells the color which will be used to highlight the word to be sung. The colors can be changed via palette preferences in your prefs directory. See also @{" lyric window " Link LYRIC_WINDOW} Default : 1,2 @ENDNODE @NODE SELECTNUMBER "SELECT BY NUMBER FROM PLAYLIST" ToolType: - ARexx : SELECTNUMBER CLI : - keyboard: - menu : - values : number 1 - With this option, an entry can be selected from the playlist via ARexx without opening the selection window. Default : - See also: @{" SELECTION WINDOW " Link SELECTWINDOW} @ENDNODE @NODE SELECTBUFFER "SELECTION TO BUFFER" ToolType: - ARexx : SELECTBUFFER CLI : - keyboard: - menu : - values : number 1 - With this option, an entry can be selected from the playlist via ARexx without opening the selection window. The selected number will be put into the @{"buffer" Link BUFFER}. Default : - See also: @{" SELECTION WINDOW " Link SELECTWINDOW} @{" SELECT NUMBER " Link SELECTNUMBER} @ENDNODE @NODE SETLOCK "PLAYLIST LOCKED" ToolType: - ARexx : SETLOCK CLI : - keyboard: - menu : SETUP->MISC OPTIONS->LOCK PLAYLIST If this option is set, you can add/edit/delete entries in the playlist via @{"playlist window" Link PLAYLIST_WINDOW} without affecting playing (unless the deleted entry is played). If this option is not set, a click in the playlist will cause the selected entry to be played, add command will cause the added file (the first one if more than one) to be played, edit command will cause the edited filename to be loaded and delete will cause the currently played entry to be deleted from the playlist and the next one in the playlist to be played if there are any left). Default : OFF @ENDNODE @NODE ALLNOTESOFF "ALL NOTES OFF MESSAGE SENT" ToolType: - ARexx : NOTESOFF CLI : - keyboard: ESC menu : FUNCTIONS->ALL NOTES OFF All notes on all channels are turned off. Default : - @ENDNODE @NODE PLAY "PLAY COMMAND" ToolType: - ARexx : PLAY CLI : - keyboard: TAB menu : - Playing is started from the beginning of the current file. @ENDNODE @NODE STOP "STOP COMMAND" ToolType: - ARexx : STOP or STOP TOGGLE CLI : - keyboard: SPACE (= STOP TOGGLE) menu : - If STOP command without the TOGGLE keyword is sent, playing will be stopped. If the TOGGLE keyword is used and the playing was already stopped, it will be continued. @ENDNODE @NODE CONT "CONTINUE PLAYING COMMAND" ToolType: - ARexx : CONT CLI : - keyboard: SPACE (continue when playing stopped) menu : - @ENDNODE @NODE LOAD "LOADS FILE" ToolType: - ARexx : LOAD CLI : - keyboard: - menu : PROJECT->ADD FILE (AMIGA-L) The given file will be loaded and played, and it will be added to the playlist. See also: @{" ADD " Link ADD} @{" FILE " Link FILE} @ENDNODE @NODE FILE "LOADS FILE, NOT ADDED TO THE PLAYLIST" ToolType: - ARexx : FILE CLI : - keyboard: - menu : - The given file will be loaded and played, but it won't be added to the playlist. See also: @{" ADD " Link ADD} @{" LOAD " Link LOAD} @ENDNODE @NODE ADD "ADDS FILE TO THE PLAYLIST" ToolType: - ARexx : ADD CLI : - keyboard: - menu : - The given file will be added to the playlist, but it won't be loaded or played. See also: @{" LOAD " Link LOAD} @{" FILE " Link FILE} @ENDNODE @NODE TRANSPOSEUP "TRANSPOSE UP" ToolType: - ARexx : TRANSPOSEUP CLI : - keyboard: a menu : - Adds value to the transpose value. See also @{" TRANSPOSE " Link TRANSPOSE} @ENDNODE @NODE TRANSPOSEDOWN "TRANSPOSE DOWN" ToolType: - ARexx : TRANSPOSEDOWN CLI : - keyboard: | menu : - Subtracts value from the transpose value. See also @{" TRANSPOSE " Link TRANSPOSE} @ENDNODE @NODE TEMPOUP "TEMPO UP" ToolType: - ARexx : TEMPOUP CLI : - keyboard: m menu : - Adds value to the tempo value. See also @{" TEMPO " Link TEMPO} @ENDNODE @NODE TEMPODOWN "TEMPO DOWN" ToolType: - ARexx : TEMPODOWN CLI : - keyboard: | menu : - Subtracts value from the tempo value. See also @{" TEMPO " Link TEMPO} @ENDNODE @NODE QUIT "QUITS MIDIPLAY" ToolType: - ARexx : QUIT CLI : - keyboard: F1 menu : PROJECT->QUIT (AMIGA-Q) MidiPlay is quitted. All windows are closed and reset message is sent. @ENDNODE @NODE NEWPLAYLIST "NEW PLAYLIST" ToolType: - ARexx : REMPLAYLIST CLI : - keyboard: - menu : PROJECT->NEW PLAYLIST Old playlist is removed. @ENDNODE @NODE LOADPLAYLIST "LOADS PLAYLIST" ToolType: - ARexx : LOADPLAYLIST CLI : - keyboard: - menu : PROJECT->OPEN PLAYLIST (AMIGA-A) (the filename is fetched via a file requester) Removes the old playlist and loads the given playlist. @ENDNODE @NODE SETTEMPOCHANGE "FILTER FOR TEMPO CHANGES" ToolType: - ARexx : SETTEMPOCHANGE CLI : - keyboard: - menu : SETUP->FILTER->TEMPO CHANGE When this option is set, all tempo changes in MIDI files will be ignored. Default : OFF See also: @{" SET TEMPO " Link TEMPO} @{" TEMPOUP " Link TEMPOUP} @{" TEMPODOWN " Link TEMPODOWN} @ENDNODE @NODE SHOWLYRIC "OPENS/CLOSEE THE LYRIC WINDOW" ToolType: - ARexx : SHOWLYRIC CLI : - keyboard: - menu : WINDOWS->LYRIC Opens (ON) or closes (OFF) the @{" lyric window " Link LYRIC_WINDOW}. If the keyword TOGGLE is used, the lyric window is opened, if it's currently closed and closed if it's currently opened. @ENDNODE @NODE SELECT "OPENS (CLOSES) THE SELECTION WINDOW" ToolType: - ARexx : SELECT CLI : - keyboard: F10 menu : FUNCTIONS->SELECT (AMIGA-C) (= SELECT 0) values : number 0-2 If the number is 0, the selection window will be opened and the number gadget is activated. If the number is 1, the file name gadget is activated. If the given number is 0 and the selection window is open, it will be closed without any action. See the @{" selection window " Link SELECTWINDOW} description. @ENDNODE @NODE SETMELODY "MUTES/UNMUTES THE MELODY CHANNEL" ToolType: - ARexx : SETMELODY CLI : - keyboard: F8 menu : - This options can be used to mute/unmute the melody channel. See also @{"MELODY CHANNEL" Link MELODY_CHANNEL} and @{" MUTE ON " Link MUTE_ON} descriptions. Default : OFF @ENDNODE @NODE BUFFERNEXT "SELECTS NEXT NUMBER FROM BUFFER" ToolType: - ARexx : BUFFERNEXT CLI : - keyboard: CURSOR DOWN menu : FUNCTIONS->BUFFER NEXT A number is picked from the @{"buffer" Link BUFFER} (if the buffer is not empty) and the corresponding MIDI file is loaded. @ENDNODE @NODE BUFFERCLEAR "CLEARS THE BUFFER" ToolType: - ARexx : BUFFERCLEAR CLI : - keyboard: DEL menu : FUNCTIONS->BUFFER CLEAR The @{" buffer " Link BUFFER} is cleared. See also: @{" BUFFER NEXT " Link BUFFERNEXT} @ENDNODE @NODE FORWARD "FAST FORWARD" ToolType: - ARexx : FORWARD CLI : - keyboard: f menu : - Playing will be set to the fast forward state. The speed will be value*1.25 times faster than the current tempo. FORWARD 0 should be used to set the playing back to the original tempo. Default : 0 @ENDNODE @NODE VOLUMEUP "VOLUME UP" ToolType: - ARexx : VOLUMEUP ,... CLI : - keyboard: + <1>|<2>|<3>|<4>|<5>|<6>|<7>|<8>|<9>|<0>| ||||| menu : - values : channel 0-16, amount -128 - +127 Adds amount to the value of volumechange on the given channel (if channel = 0, all volumechanges will be affected). See also: @{" VOLUMECHANGE " Link VOLUMECHANGE} @{" VOLUME DOWN " Link VOLUMEDOWN} @ENDNODE @NODE VOLUMEDOWN "VOLUME DOWN" ToolType: - ARexx : VOLUMEDOWN ,... CLI : - keyboard: + <1>|<2>|<3>|<4>|<5>|<6>|<7>|<8>|<9>|<0>| ||||| menu : - values : channel 0-16, amount -128 - +127 Subtracts amount from the value of volumechange on the given channel (if channel = 0, all volumechanges will be affected). See also: @{" VOLUMECHANGE " Link VOLUMECHANGE} @{" VOLUME DOWN " Link VOLUMEDOWN} @ENDNODE @NODE SYSEX "SYSTEM EXCLUSIVE COMMAND" ToolType: - ARexx : SYSEX CLI : - keyboard: - menu : - System exclusive message defined by hexstring is sent. The hexadecimal string can be e.g. 41 20 16 00 or 41,20,16,00. Do not include starting F0 nor ending F7. They will be added automatically. @ENDNODE @NODE SENDMIDIDATA "SEND NORMAL MIDI DATA" ToolType: - ARexx : SENDMIDIDATA CLI : - keyboard: - menu : - MIDI data message defined by hexstring is sent. MIDI data bytes should be separated by spaces or commas. For example, The hexadecimal string can be 90 40 40 or 90,40,40. One MIDI message is started by a command number and it is followed by 1 or 2 bytes. Command number is always hex 80 or greater and data bytes following it must be smaller than hex 80. You can send more than one MIDI message in the same string, e.g. 90 40 40 90 43 40 90 47 40. A MIDI message can be (n = channel number 0-F): 8n ss ss NOTEOFF 9n ss ss NOTEON An ss ss POLYPRESSURE Bn ss ss CONTROL CHANGE Cn ss PROGRAM CHANGE Dn ss CHANNEL PRESSURE En ss ss PITCH BENDER or system message between F1 and FF. Use @{" SYSEX " Link SYSEX} command for messages starting with F0 (F7/EOX messages are not allowed). @ENDNODE @NODE MERGETRANSPOSE "MIDI MERGE TRANPOSE VALUE" ToolType: MERGETRANSPOSE= ARexx : MERGETRANSPOSE CLI : - keyboard: - menu : - Values : -128 - 127 Transposes all note on/off messages from MIDI in by value. These messages are then sent transposed to MIDI out if option @{" MERGE " Link MERGE} is set. Default: 0 @ENDNODE @NODE SETSHUFFLE "RANDOM PLAY" ToolType: - ARexx : SETSHUFFLE CLI : - keyboard: - menu : SETUP->PLAY OPTIONS->RANDOM PLAY (AMIGA-H) When this option is set, the next file in the playlist will be selected at random. Setting this option ON will cause an immediate selection. Because the corresponding menu option only toggles between states, you must first set it OFF and then set it back ON to make a new random selection. If you have the MidiPlay ToolKit you can make your own key for the immediate selection by putting SETSHUFFLE ON to the description of the key combination. If you don't have the Keyboard Editor from the ToolKit you can use programs which have ability to assign ARexx scripts to hotkeys and use then the corresponding ARexx command (i.e. ADDRESS MidiPlay_rexx; SETSHUFFLE ON). Default : OFF @ENDNODE @NODE FIRST "PLAY THE FIRST FILE IN THE PLAYLIST" ToolType: - ARexx : FIRST CLI : - keyboard: CURSOR UP menu : FUNCTIONS->FIRST (AMIGA-1) The first file in the playlist is played. @ENDNODE @NODE NEXT "PLAY THE NEXT FILE IN THE PLAYLIST" ToolType: - ARexx : NEXT CLI : - keyboard: CURSOR RIGHT menu : FUNCTIONS->NEXT (AMIGA->) The next file in the playlist is played. @ENDNODE @NODE PREVIOUS "PLAY THE PREVIOUS FILE IN THE PLAYLIST" ToolType: - ARexx : PREVIOUS CLI : - keyboard: CURSOR LEFT menu : FUNCTIONS->PREVIOUS (AMIGA-<) The previous file in the playlist is played. @ENDNODE @NODE WINDOWS "WINDOWS" @{" MAIN WINDOW " Link MAIN_WINDOW} @{" PREFERENCES WINDOW " Link PREFERENCES_WINDOW} open via menu: @{"SETUP" Link SETUP}->@{"MISC OPTIONS" Link MISC_OPTIONS} @{" TRACK NAME WINDOW " Link TRACKNAME_WINDOW} open via menu: @{"WINDOWS" Link MENU_WINDOWS} @{" LYRIC WINDOW " Link LYRIC_WINDOW} open via menu: @{"WINDOWS" Link MENU_WINDOWS} @{" PLAYLIST WINDOW " Link PLAYLIST_WINDOW} open via menu: @{"WINDOWS" Link MENU_WINDOWS} @{" SELECTION WINDOW " Link SELECTWINDOW} open via menu: @{"FUNCTIONS" Link FUNCTIONS} @ENDNODE @NODE MAIN_WINDOW "MAIN WINDOW" @{" MENUS " Link MENU} @{" GADGETS " Link GADGETS} @{" KEYBOARD " Link KEYBOARD} @ENDNODE @NODE MENU "MENUS" @{" PROJECT " Link PROJECT} @{" FUNCTIONS " Link FUNCTIONS} @{" SETUP " Link SETUP} @{" WINDOWS " Link MENU_WINDOWS} @ENDNODE @NODE PROJECT "PROJECT" @{" NEW PLAYLIST " Link NEWPLAYLIST} OPEN PLAYLIST... (AMIGA A) A file requester is opened and using this requester you can load a new playlist. Be careful what you select, playlist is not verified in any ways, so MidiPlay will probably crash if you load a file which is not a playlist. See also @{" LOADPLAYLIST " Link LOADPLAYLIST} command. SAVE PLAYLIST... (AMIGA S) A file requester is opened and using this requester you can save the current playlist to a file. ADD FILE... (AMIGA L) A file requester is opened. Using this requester you can add files to the end of the playlist. The first (in the alphabetic order) will be played. See also commands: @{" ADD " Link ADD} @{" LOAD " Link LOAD} @{" FILE " Link FILE} REMOVE FILE This one does nothing at this moment. ABOUT (AMIGA ?) Information about the program and the current file will is showed. @{" ICONIFY " Link ICONIFY} (AMIGA F) SAVE ENVIRONMENT All window positions and open/closed/zoomed information are saved to ENV: MidiPlay/midiplay.win and ENVARC: MidiPlay/midiplay.win files. ENV: MidiPlay/midiplay.win file will be loaded when MidiPlay is started and windows will be positioned correctly unless WINDOW=OFF or -w option is used. In this case, windows won't be opened. @{" QUIT " Link QUIT} (AMIGA Q, F1) @ENDNODE @NODE FUNCTIONS "FUNCTIONS" @{" SEND RESET " Link RESET} (AMIGA R) @{" ALL NOTES OFF " Link ALLNOTESOFF} @{" FIRST " Link FIRST} (AMIGA 1, CURSOR UP) @{" PREVIOUS " Link PREVIOUS} (AMIGA <, CURSOR LEFT) @{" NEXT " Link NEXT} (AMIGA >, CURSOR RIGHT) @{" SELECT... " Link SELECTWINDOW} (AMIGA C, F10) @{" BUFFER NEXT " Link BUFFERNEXT} (CURSOR DOWN) @{" BUFFER CLEAR " Link BUFFERCLEAR} (DEL) @ENDNODE @NODE SETUP "SETUP MENU" @{" MIDI OPTIONS " Link MIDI_OPTIONS} @{" RESET OPTIONS " Link RESET_OPTIONS} @{" PLAY OPTIONS " Link PLAY_OPTIONS} @{" FILTER OPTIONS " Link FILTER_OPTIONS} @{" SHOW OPTIONS " Link SHOW_OPTIONS} @{" MISC OPTIONS " Link MISC_OPTIONS} @ENDNODE @NODE MIDI_OPTIONS "MIDI OPTIONS" @{" EXTERNAL SYNC " Link EXT} (AMIGA E) @{" SEND MIDI CLOCK " Link MIDICLOCK} @{" MUTE ON " Link MUTE_ON} (AMIGA M, F2) @{" SOLO ON " Link SOLO_ON} (AMIGA N, F3) @{" MUTE ONLY NOTES " Link SOFT} @{" MERGE " Link MERGE} (F4) @{" NO MIDI OUTPUT " Link DONOTPLAY} @{" MIDI START " Link MIDISTART} @ENDNODE @NODE RESET_OPTIONS "RESET OPTIONS" @{" NORMAL RESET " Link NRESET} @{" FORCE RESET " Link FORCERESET} @ENDNODE @NODE PLAY_OPTIONS "PLAY OPTIONS" @{" LOAD .INFO " Link ICON} @{" COUNT " Link COUNT} @{" LOOP " Link LOOP} (AMIGA O, F6) @{" SEQUENTIAL " Link SEQ} @{" QUANTIZE " Link QUANTIZE} @{" START AFTER LOAD " Link START} (AMIGA T, F5) @{" EXIT AFTER PLAY " Link EXIT} (AMIGA X) @{" AUTO LOAD NEXT " Link PLAYTYPE} (AMIGA Y) @{" RANDOM PLAY " Link SETSHUFFLE} (AMIGA H) @{" INTRO PLAY " Link INTROPLAY} @ENDNODE @NODE FILTER_OPTIONS "FILTER OPTIONS" @{" PROGRAM CHANGE " Link NOPC} @{" NO DRUM PC " Link NODRUMPC} @{" PITCH BENDER " Link NOPB} @{" TEMPO CHANGE " Link SETTEMPOCHANGE} @{" SYSEX " Link NOSYSEX} @{" MAP " Link MAPPING} @ENDNODE @NODE SHOW_OPTIONS "SHOW OPTIONS" @{" FILE INFO " Link FILEINFO} @{" META EVENTS " Link TEXTINFO} @{" DATA EVENTS " Link DATAINFO} @ENDNODE @NODE MISC_OPTIONS "MISC OPTIONS" @{" DIRECTORY BUFFER " Link DIRBUFFER} (AMIGA B) @{" BUFFER SELECT " Link BUFDEF} @{" CIA TIMER " Link CIA} @{" LOCK PLAYLIST " Link SETLOCK} @{" USE REQTOOLS " Link REQTOOLS} SET CHANNELS... " (AMIGA P) Opens the @{" preferences window " Link PREFERENCES_WINDOW} @ENDNODE @NODE MUTE_ON "MUTE ON" ToolType: - (see @{" MUTE " Link MUTE}) ARexx : SETMUTE CLI : - keyboard: F2 menu : SETUP->MIDI OPTIONS->MUTE ON (AMIGA-M) If this option is set, all the selected mute channels will be muted. If SOLO ON is set at the same time, only the solo channel will be played. If this option is not set, all channels will be unmuted (unless SOLO ON is set). See also @{" MUTECHANNELS " Link MUTE} Default : OFF @ENDNODE @NODE SOLO_ON "SOLO ON" ToolType: - (see @{" SOLO " Link SOLO}) ARexx : SETSOLO CLI : - keyboard: F3 menu : SETUP->MIDI OPTIONS->SOLO ON (AMIGA-N) If this option is set, only the selected solo channel will be played. See @{" SOLOCHANNEL " Link SOLO} Default : OFF @ENDNODE @NODE RESET "RESET" ToolType: - ARexx : SENDRESET CLI : - menu : FUNCTIONS->SEND RESET If normal reset is not set, the program will send GM reset message and ALL NOTES OFF messages before the first MIDI event and also before quitting. If normal reset is set, the program will send the following messages before loading a new MIDI file and also before quitting: - PROGRAM CHANGE 0 - CONTROLLERS 0 and 32 to 0 - MAIN VOLUME to 100 - PAN to 64 - EXTDEPTH to 64 - EXPRESSION to 127 - RPN COURSETUNE to 64, RPN FINETUNE to 64, RPN PBSENS to 2 - SUSTAIN to 0 - PORTA to 0 - MODWHEEL to 0 - MAX to 0 - RESET CONTROLLERS - ALL NOTES OFF See also @{" FORCERESET " Link FORCERESET} @ENDNODE @NODE BUFFER "BUFFER" There can be 9 numbers in the buffer at most. You can select the next number from the buffer by pressing CURSOR DOWN key or by selecting BUFFER NEXT from the menu. If there is a number in the buffer when the current file has been played, it will be loaded. The next file in the buffer is shown in the screen title of the main window. You can add entries to the buffer via the @{"selection window" Link SELECTWINDOW} or via @{"SELECTNUMBER" Link SELECTNUMBER} command. @ENDNODE @NODE SELECTWINDOW "SELECTION WINDOW" @{" MENUS " Link MENU} You can select the number of the MIDI file in the playlist through the selection requester. Just write the right number. You can also write the name of the file (or parts of it) into the file gadget. You can move to another gadget by pressing TAB. If the given file (or file number) is not found, the screen flashes. The requester is not closed until cancelled (by pressing ESC or Right Amiga + C when one of the edit gadgets is selected, or C when none of the edit gadget is selected) or legal file is selected. When you are editing, you can press F10 which clears the currently selected field (just like CONTROL+X). You can select the number edit gadget by pressing letter n and the file name edit gadget by pressing letter f when none of the gadgets are selected. Possible file numbers are shown in the window title bar. If you press PLAY gadget (or F8, P when an edit gadget is not selected, or Right Amiga + P, when one of the edit gadget is selected) the selected file will be loaded immediately. If you press BUFFER gadget (or F9, B when an edit gadget is not selected, or Right Amiga + B, when one of the edit gadget is selected), the number will be put to a buffer. Note: the name gadget is case sensitive! See also: @{" BUFFER " Link BUFFER} @{" SELECTBUFFER " Link SELECTBUFFER} @{" SELECT " Link SELECT} @ENDNODE @NODE MAPFILE "MAPFILE" Normal map converts every program change message to the maptype defined in the mapfile. Row number tells which program change message (0-127) is mapped. To use the mapping, MAP option must be set. Maptype can be: a value between 0-127, e.g. 120 Bbank:value this is a bank change+program change combination e.g. B2:20 Ttonefilename program change is mapped to a message in the external tonefile. Correct @{"CHANNELBYTE" Link CHANNELBYTE} should be set. Tone files are first read to memory. Number of tone files in memory is limited to 128, including those in map files and used with @{"CHANNELPC" Link CHANNELPC}. Old ones are replaced with new ones. External tone files are pure system exclusive dump files, not MIDI files. The drum map converts every note on/off message on the drum channel to the number specified in the drum map file (Numbers run from 0 to 127, one per row). To use the mapping, MAP option must be set. See @{" CHANNELMAP " Link CHANNELMAP} for making maps for individual channels See an @{"example map file" Link EXMAPFILE} including the names of the General MIDI instruments @ENDNODE @NODE EXMAPFILE "EXAMPLE MAP FILE" Here is an example map file including the names of the General MIDI instruments. These names and the numbers in front of the names are not needed for mapping. Only the first number/maptype is needed. If tonefilename is given, those instrument names must not be given on that line! In this example, # mark is for commenting purpose only and means that the line ends there and the rest of the line should be removed if used in a real situation. -------------The example file starts after this line--------------- 0 1 :Acoustic Grand Piano 1 2 :Bright Acoustig Piano 2 3 :Electric Grand Piano 3 4 :Honky Tonk Piano B1:4 5 :Electric Piano 1 #electric piano is selected from bank 1 5 6 :Electric Piano 2 6 7 :Harpsichord Tsounds:clavi # 8 :Clavi clavi sound is loaded from a sysex file 8 9 :Celesta 8 10 :Glocken spiel # glocken spiel is played as a celesta 10 11 :Music Box 11 12 :Vibraphone 12 13 :Marimba 13 14 :Xylophones 14 15 :Tubular Bells 15 16 :Dulcimer 16 17 :Drawbar Organ 17 18 :Percussive Organ 18 19 :Rock Organ 19 20 :Church Organ 20 21 :Reed Organ 21 22 :Accordian 22 23 :Harmonica 23 24 :Tango Accordian 24 25 :Acoustic Guitar (N) 25 26 :Acoustic Guitar (S) 26 27 :Electric Guitar 1 27 28 :Electric Guitar 2 28 29 :Electric Guitar 3 29 30 :Overdriven Guitar 30 31 :Distortion Guitar 31 32 :Guitar Harmonica 32 33 :Acoustic Bass 33 34 :Electric Bass (finger) 34 35 :Electric Bass (pick) 35 36 :Fretless Bass 36 37 :Slap Bass 1 37 38 :Slap Bass 2 38 39 :Synth Bass 1 39 40 :Synth Bass 2 40 41 :Violin 41 42 :Viola 42 43 :Cello 43 44 :Contrabass 44 45 :Tremolo Strings 45 46 :Pizzicato Strings 46 47 :Orchestral Strings 47 48 :Timbani 48 49 :String Ensemble 1 49 50 :String Ensemble 2 50 51 :Synth Strings 1 51 52 :Synth Strings 2 52 53 :Choir Aahs 53 54 :Voice Oohs 54 55 :Synth Voice 55 56 :Orchestral Hit 56 57 :Trumpet 57 58 :Trombone 58 59 :Tuba 59 60 :Muted Trumpet 60 61 :French Horn 61 62 :Brass Section 62 63 :Synth Brass 1 63 64 :Synth Brass 2 64 65 :Soprano Sax 65 66 :Alto Sax 66 67 :Tenor Sax 67 68 :Baritone Sax 68 69 :Oboe 69 70 :English Horn 70 71 :Bassoon 71 72 :Clarinet 72 73 :Piccolo 73 74 :Flute 74 75 :Recorder 75 76 :Pan Flute 76 77 :Blown Bottle 77 78 :Shakuhachi 78 79 :Whistle 79 80 :Ocarina 80 81 :Lead 1 (Square) 81 82 :Lead 2 (Sawtooth) 82 83 :Lead 3 (Callihope) 83 84 :Lead 4 (Chiff) 84 85 :Lead 5 (Charang) 85 86 :Lead 6 (Voice) 86 87 :Lead 7 (Fifths) 87 88 :Lead 8 (Bass+lead) 88 89 :Pad 1 (New Age) 89 90 :Pad 2 (Warm) 90 91 :Pad 3 (Polysynth) 91 92 :Pad 4 (Choir) 92 93 :Pad 5 (Bowed) 93 94 :Pad 6 (Metallic) 94 95 :Pad 7 (Halo) 95 96 :Pad 8 (Sweep) 96 97 :FX 1 (Rain) 97 98 :FX 2 (Soundtrack) 98 99 :FX 3 (Crystal) 99 100:FX 4 (Atmosphere) 100 101:FX 5 (Brightness) 101 102:FX 6 (Goblins) 102 103:FX 7 (Echoes) 103 104:FX 8 (SCI-FI) 104 105:Sitar 105 106:Banjo 106 107:Shamisen 107 108:Koto 108 109:Kalimba 109 110:Bagpipe 110 111:Fiddle 111 112:Shanai 112 113:Tinkle Bell 113 114:Agogo 114 115:Steel Drums 115 116:Wood Block 116 117:Taiko Drum 117 118:Melodic Tom 118 119:Synth Drum 119 120:Reverse Cymbal 120 121:Guitar Fret Noise 121 122:Breath Noise 122 123:Seashore 123 124:Bird Tweet 124 125:Telephone Ring 125 126:Helicopter 126 127:Applause 127 128:Gunshot @ENDNODE @NODE FILE_CONTROL "FILE CONTROL" Playlist file is a file that includes names and directories of the MIDI files, like dh0:music/MID/file.mid, one per row. The first file is number 1, the second is number 2 and so on. You can tell the program the name of the playlist file in the configuration file, through tooltypes or CLI arguments. All files given as arguments or icons are added to the end of the playlist. Playlist can be changed using open/save/new playlist in the project menu. @ENDNODE @NODE MENU_WINDOWS "WINDOWS" You can open/close one of the following window by selecting its name. If a window is open, there is a checkmark in front of its name. @{" TRACK NAME WINDOW " Link TRACKNAME_WINDOW} @{" LYRIC WINDOW " Link LYRIC_WINDOW} @{" PLAYLIST WINDOW " Link PLAYLIST_WINDOW} @{" CONNECT MIXER " Link CONNECTMIXER} @ENDNODE @NODE GADGETS "GADGETS" The NAME field shows the name of the sequence (format 0) or the name of the first track (format 1) which usually is the name of the sequence. The COPYRIGHT field shows the copyright event if there is one. Tempo can be changed using the TEMPO SLIDER. Tempo will not be changed until the left mouse button is released. The status field shows the state of the player. END and WAITING means that the program is waiting the user to do something. WAIT EXT means that the program is waiting START or CONT message from an external source. PLAY means that the program is currently playing a MIDI file. You can see the number of the current measure, time elapsed or time remain by changing the state of the cycle gadget. CHECKING means that the file was not recognized as a MIDI file, but FILETYPEREXX command is run (if defined). You can use this command e.g. to unpack packed MIDI files. The CYCLE gadget is used to change the type of the information in the status field left from the cycle gadget. If NONE is selected, only WAIT, PLAY or END messages will be seen. If MEASURES is selected, the current measure number will be seen. If COUNT option is set, also the number of the measures in the file will be shown. If TIME is selected, elapsed time will be shown. If REMAIN is selected and COUNT option is set, remaining time will be shown. The ZOOM gadget toggles between the whole window and a window with only title bar at the top-left corner of the screen. The following graphical symbols are used: [BLACK SQUARE] : @{" STOP " Link STOP} |> : @{" PLAY " Link PLAY} > : @{" CONT " Link CONT} >> : @{" FAST FORWARD " Link FORWARD} |<< : @{" PREVIOUS " Link PREVIOUS} >>| : @{" NEXT " Link NEXT} V [ARROW DOWN] : BUFFER NEXT (meaning of this may change in future) By pressing STOP gadget you can stop playing. If Fade is set to 0 and you press this gadget twice, ALL NOTES OFF messages will be sent on all channels. If Fade is greater than 0, playing fades out (it will take 100ms*Fade), and ALL NOTES OFF messages will be sent after fading. By pressing PLAY gadget you can start playing from the start of the file. By pressing CONT gadget you can continue playing from the current position in the MIDI file. By pressing FAST FORWARD gadget down you can make MidiPlay play faster. When you release the gadget, normal tempo is returned. FF speed used for this gadget is 75% faster than the original tempo. By pressing PREV gadget you can load the previous file from the playlist. By pressing NEXT gadget you can load the next file from the playlist. @ENDNODE @NODE KEYBOARD "KEYBOARD" Custom keyboard can be made with KeyboardEditor see @{"MidiPlay ToolKit" Link MPTOOLKIT}. LSHIFT means that LEFT SHIFT key should be pressed at the same time as other key(s). The main use of LSHIFT key is to decrease e.g. volumechange. RSHIFT means that RIGHT SHIFT key should be pressed at the same time as other key(s). The main use of RSHIFT key is to increase e.g. volumechange. SPACE BAR depending on the state of the program, stops/continues playing TAB starts playing from the start of the file ESC sends ALL NOTES OFF messages on all channels F1 quit F2 MUTE ON ON/OFF F3 SOLO ON ON/OFF F4 merge ON/OFF F5 start after load ON/OFF F6 loop ON/OFF F7 playlist play ON/OFF F8 mutes/unmutes melody channel LSHIFT+F8 decrease volumechange on the melody channel by one RSHIFT+F8 increase volumechange on the melody channel by one F10 select from playlist CURSOR UP plays the first file from the playlist CURSOR LEFT plays the previous file from the playlist CURSOR RIGHT plays the next file from the playlist CURSOR DOWN reads the next playlist number from the buffer DEL clears the buffer 1,2,3,4,5, 6,7,8,9,0, q,w,e,r,t,y use these keys to mute/unmute channels. These keys corresponds the channels 1-16. LSHIFT+key decreases volumechange on this channel by one RSHIFt+key increases volumechange on this channel by one a transpose up A, z transpose down m tempo up M, n tempo down i activates the next open window f fast forward 75% faster than the original tempo, by making a custom keyboard file or using ARexx command, you can use any value greater than 0 for FORWARD command. FORWARD 0 returns the original tempo. u changes the state of the status field cycle gadget l activates the melody channel gadget in the preferences window d activates the drum channel gadget in the preferences window s activates the solo channel gadget in the preferences window @ENDNODE @NODE PREFERENCES_WINDOW "PREFERENCES WINDOW" @{" MENUS " Link MENU} @{" KEYBOARD " Link KEYBOARD} NOTE: Menu shortcuts in the main window are NOT available when this window is active. All other keyboard shortcuts are available. MUTE gadgets channels 1-16. If MUTE ON is set, checked channels will be muted. The SOLO field tells what channel will be heard if SOLO ON is set. Pressing s selects this gadget. The DRUM CHANNEL field tells what is the drum channel that won't be transposed. Pressing d selects this gadget. The @{" MELODY CHANNEL " Link MELODY_CHANNEL} field. Pressing l selects this gadget. MidiPlay transposes note on/note off messages according to the TRANSPOSE SLIDER. Messages on the drum channel will not be transposed. NOTE: If any of the channel is muted and option SOFT is not set when playing is started, the program change, volume, pan and other control messages will NOT be transmitted. This means that instrument settings are not correct when those channels are unmuted. @ENDNODE @{" MELODY CHANNEL " Link MELODY_CHANNEL} @NODE MELODY_CHANNEL "MELODY CHANNEL" The melody channel can be muted/unmuted pressing F8 in the main window. For example the melody channel can be given using the tooltypes in the icon of the MIDI file (MELODY=4). The melody channel is mostly different than in previous files. If you want to play or sing along the file, you may need to mute the melody channel. @ENDNODE @NODE TRACKNAME_WINDOW "TRACK NAME WINDOW" @{" MENUS " Link MENU} @{" KEYBOARD " Link KEYBOARD} The listview gadget will show all track names defined as track name events in the current MIDI file. This listview is updated only right after loading the MIDI file and only if @{" COUNT " Link COUNT} option is set on. You must reload the file, if you had COUNT set off. @ENDNODE @NODE PLAYLIST_WINDOW "PLAYLIST WINDOW" @{" MENUS " Link MENU} @{" KEYBOARD " Link KEYBOARD} Listview gadget in this window shows all the files in the playlist. Text gadget under the listview shows the name of the currently selected/played file. Lock checkbox gadget is checked: the text gadget shows the file currently loaded and you can select a new file to be played by clicking the name of that file in the listview. If you press ADD gadget, a file requester opens and you can add files to the playlist. When you exit the requester without canceling, the selected file (or the first from the selected) will be loaded. All selected files will be added to the end of the playlist. If you press EDIT gadget, an edit file requester opens and you can edit the name of the selected file. When you exit this requester without canceling, the edited file will be loaded. If you press REMOVE gadget, the selected file will be removed from the playlist and the next one in the playlist will be loaded. Lock checkbox gadget is not checked: You can edit the playlist without affecting playing. Selection from the playlist causes that file to be removable/editable and the name will be shown under the listview gadget. If you press ADD gadget, a file requester opens and you can add files to the playlist. When you exit the requester without canceling, all selected files will be added to the end of the playlist. If you press EDIT gadget, an edit file requester opens and you can edit the name and the path of the selected file. If you press REMOVE gadget, the selected file will be removed from the playlist. Playing will be stopped if the removed file was playing and the next one in the playlist will be loaded. @ENDNODE @NODE LYRIC_WINDOW "LYRIC WINDOW" @{" MENUS " Link MENU} @{" KEYBOARD " Link KEYBOARD} All lyrics will be shown in this window. The COUNT options should have been on when the current file was loaded, because during the counting operation, all lyrics are collected to a structure from which the word/syllable to be sung is selected during playing. You can change the font of the lyric window with @{"LYRICFONT" Link LYRICFONT} command and the text colors with @{"LYRICCOLORS" Link LYRICCOLORS} command. MIDI karaoke files If the file is recognized as a MIDI karaoke file, MidiPlay tries to act according to the format of this file type. Depending on the window size, MidiPlay tries to show two paragraphs or the number of the rows that can be fitted into the window (in the case that one paragraph cannot be fitted into the window). The current word/syllable is highlighted. When the current paragraph has been played, the window will scroll so that the next paragraph is shown at the top of the window. The scrolling will happen also, if the number of the rows on the screen has been exceeded. The highlighting will be used only on the top paragraph. If you resize the window, the latest word/syllable will be shown at the top-left corner of the window. The window should be big enough to show at least 4 rows of text for the best performance. If the window was closed and you open it, no lyric is shown in the window until the next lyric event in the file has been encountered. Ordinary MIDI files If the file is not recognized as a MIDI karaoke file and COUNT option has been used, all lyric events found in the file will be collected and shown in the window. All words that fit into the window are shown without any paragraphs (unless these lyric events use MIDI karaoke formatting commands). This may look ugly, but it will look much uglier if these events include new line characters (I can't help you in this case). I have tried to check at least the first character and if it is a new line character, this event will be ignored. You can resize/open/close this window and it will act just like in the karaoke file case. Note: if the lyric events have newline characters, lyrics won't be correctly shown. I've tried to remove the newline characters at the beginning of these events, but those in the middle of the event cannot be detected at this moment. @ENDNODE @NODE AREXX "AREXX COMMANDS" MidiPlay opens one ARexx port called MidiPlay_rexx. See STARTING MIDIPLAY section when MESSAGEREXX, FILETYPEREXX and FILENAMEREXX scripts will be called. If MidiPlay doesn't recognize used keyword, it returns value 1, otherwise 0 is returned. The following keywords can be used with some of the commands: ON is same as 1 (option is set ON) OFF is same as 0 (option is set OFF) TOGGLE is same as -1 (option is set ON if OFF and OFF if ON) The following commands are currently supported: @{b}Playing commands@{ub}: @{" PLAY " Link PLAY} @{" STOP " Link STOP} @{" STOP TOGGLE " Link STOP} @{" CONT " Link CONT} @{" QUIT " Link QUIT} @{" TEMPOUP " Link TEMPOUP} @{" TEMPODOWN " Link TEMPODOWN} @{" TEMPO " Link TEMPO} @{" SETTEMPOCHANGE " Link SETTEMPOCHANGE} @{" FORWARD " Link FORWARD} @{" FADE " Link FADE} @{" SETLOOP " Link LOOP} @{" SETSHUFFLE " Link SETSHUFFLE} @{" SETINTROPLAY " Link INTROPLAY} @{" INTROPLAYTIME " Link INTROTIME} @{b}Playlist commands@{ub}: @{" LOAD " Link LOAD} @{" FILE " Link FILE} @{" ADD " Link ADD} @{" REMPLAYLIST " Link NEWPLAYLIST} @{" LOADPLAYLIST " Link LOADPLAYLIST} @{" SETSTART " Link START} @{" SETEXIT " Link EXIT} @{" SETPLAYLIST " Link PLAYTYPE} @{" SETLOCK " Link SETLOCK} @{" FIRST " Link FIRST} @{" NEXT " Link NEXT} @{" PREVIOUS " Link PREVIOUS} @{" SELECT " Link SELECT} @{" SELECTNUMBER " Link SELECTNUMBER} @{b}Miscellaneous commands@{ub}: @{" SETICON " Link ICON} @{" SETCOUNT " Link COUNT} @{" BUFFERNEXT " Link BUFFERNEXT} @{" BUFFERCLEAR " Link BUFFERCLEAR} @{" SETBUFDEFAULT " Link BUFDEF} @{" SELECTBUFFER " Link SELECTBUFFER} @{" SETCIA " Link CIA} @{" SETSEQUENCE " Link SEQ} @{" SETQUANTIZE " Link QUANTIZE} @{" PRIORITY " Link PRIORITY} @{" SKIP " Link SKIP} @{" FILENAMEREXX " Link FILENAMEREXX} @{" FILETYPEREXX " Link FILETYPEREXX} @{" MESSAGEREXX " Link MESSAGEREXX} @{" SETSTATUSFIELD " Link MFSTATUS} @{" STATUSFIELDUP " Link STATUSFIELDUP} @{" ACTIVATENEXTWIN " Link ACTIVATENEXTWIN} @{" ACTIVATEDRUMGAD " Link ACTIVATEDRUMGAD} @{" ACTIVATESOLOGAD " Link ACTIVATESOLOGAD} @{" ACTIVATEMELODYGAD " Link ACTIVATEMELODYGAD} @{" LOADKEYBOARD " Link LOADKEYBOARD} @{" DEFAULTKEYBOARD " Link DEFAULTKEYBOARD} @{" SETDIRBUFFER " Link DIRBUFFER} @{" SETWINDOW " Link MWINDOW} @{" ICONIFY " Link ICONIFY} @{" CONNECTMIXER " Link CONNECTMIXER} @{" SETREQTOOLS " Link REQTOOLS} @{b}MIDI commands@{ub}: @{" TRANSPOSE " Link TRANSPOSE} @{" TRANSPOSEUP " Link TRANSPOSEUP} @{" TRANSPOSEDOWN " Link TRANSPOSEDOWN} @{" MERGETRANSPOSE " Link MERGETRANSPOSE} @{" SENDRESET " Link RESET} @{" NOTESOFF " Link ALLNOTESOFF} @{" SYSEX " Link SYSEX} @{" SENDMIDIDATA " Link SENDMIDIDATA} @{" NOTEON ,... " Link NOTEON} @{" NOTEOFF ,... " Link NOTEOFF} @{" SETSYNC " Link EXT} @{" MUTECHANNELS ,... " Link MUTE} @{" SOLOCHANNEL " Link SOLO} @{" SETMUTE " Link MUTE_ON} @{" SETSOLO " Link SOLO_ON} @{" MUTETOGGLE " Link MUTETOGGLE} @{" SETMERGE " Link MERGE} @{" SETMIDISTART " Link MIDISTART} @{" SETNOMIDIOUTPUT " Link DONOTPLAY} @{" SETMIDICLOCK " Link MIDICLOCK} @{" SETRESET " Link NRESET} @{" SETFORCERESET " Link FORCERESET} @{" SETNOPC " Link NOPC} @{" SETNOPB " Link NOPB} @{" SETNODRUMPC " Link NODRUMPC} @{" SETNOSYSEX " Link NOSYSEX} @{" SETSOFT " Link SOFT} @{" SETMAP " Link MAPPING} @{" LOADMAP " Link MAPFILETYPE} @{" LOADDRUMMAP " Link DRUMMAP} @{" NOMAPCHANNELS ,..." Link NOMAPCHANNELS} @{" CHANNELMAP ,,,... " Link CHANNELMAP} @{" CHANNELPC ,... " Link CHANNELPC} @{" CHANNELBYTE " Link CHANNELBYTE} @{" BANKCHANGETYPE " Link BANKCHANGETYPE} @{" DRUMCHANNEL " Link DRUMCHANNEL} @{" MELODY " Link MELODY} @{" SETMELODY " Link SETMELODY} @{" MELODYVOLUMEDOWN " Link MELODYVOLUMEDOWN} @{" MELODYVOLUMEUP " Link MELODYVOLUMEUP} @{" PATCHCHANNEL ,... " Link PATCHCHANNEL} @{" SETVOLUMECHANGE ,... " Link VOLUMECHANGE} @{" VOLUMEDOWN ,... " Link VOLUMEDOWN} @{" VOLUMEUP ,... " Link VOLUMEUP} @{b}Print commands@{ub}: @{" SHOWFILEINFO " Link FILEINFO} @{" SHOWMETA " Link TEXTINFO} @{" SHOWDATA " Link DATAINFO} @{" SHOWLYRIC " Link SHOWLYRIC} @{" SETLYRICTYPE " Link LYRICTYPE} @{" LYRICFONT , " Link LYRICFONT} @{" LYRICCOLORS , " Link LYRICCOLORS} @ENDNODE @NODE OTHER_INFORMATION "OTHER INFORMATION" - When started from Workbench, midiplay opens its own console window for text input. That window is not visible unless any text is printed. - Midiplay opens one midi source named "midiplay". Source is connected to MIDI library's resident node "MidiOut". MidiPlay opens also one MIDI destination named "midiplayin" which is connected to "MidiIn" when the player is playing and uses external synchronization. @ENDNODE @NODE TODO "TODO" -map file editor -intelligent remapping -Amiga's internal sounds played on midi channels @ENDNODE @NODE PROBLEMS_AND_LIMITATIONS "PROBLEMS AND LIMITATIONS" On small Amigas (500 & 600) Midiplay does not multitask very well. Files are played in time, but sometimes tempo is jerky. Some files have sometimes so many events in one measure that MidiPlay is not able to send all the events exactly right time on slow Amigas. You can improve timing by using CIA timer and/or using quantization. If you change the time from the workbench preferences, MidiPlay hangs. If you don't want this to happen, use CIA timer instead. MidiIn may lose some clock signals on slow Amigas and the midiplayer is then out of sync. If this happens, use slower tempo and do not print anything on the screen. Faulty MIDI files may cause problems. If you see "Can't read MIDI file" on the screen, loading was incomplete. You can still listen them, but you may get into troubles because of missing END OF TRACK messages etc. Limitations: -SMPTE messages are ignored. @ENDNODE @NODE HISTORY "HISTORY" v1.0 29-Jun-93 first version, only DOS, format 0 files. v1.1 23-Jul-93 first public release, WB and tooltypes, format 1 files. v1.2 29-Aug-93 external/internal sync and midi merge added, SYSEX messages now transmitted correctly, too slow tempo problem fixed. v1.2b 17-Oct-93 some corrections, smaller code v2.0beta 20-Nov-93 added graphical user interface, transpose bug fixed, CIA timer not finished yet v2.0 24-Jan-94 added: playlist, map file support, reset message, lyric and measure fields, melody muting, loading of MIDI file icons, quantization. Priority now set back to 0 when exiting. CIA timer works. v2.0.1 27-Feb-94 fixed int. reset bug, added mapchannel and skip options v2.01 28-Feb-94 added drum map and soft muting option. v2.01a 06-Mar-94 added NODRUMPC option, added short delay after loading when NRESET is used. v2.10beta 14-Mar-94 added own task for the playing routine: printing and using the right mouse button or opening windows/requesters won't stop playing, this means that printing e.g. data events are not necessarily in real time. Printed events look clearer. Fixed memory loss bug, also needs now less stack. 2-Apr-94 added BUFDEF (selection can be put to a buffer), COUNT (length of the file counted) and NOMON (sends arexx messages to Upd) options. Fixed "merge not set after loading" bug. Added different time information and a cycle gadget to select the information type. Many options are set to configuration values when the tool types of a file is loaded. 8-Apr-94 fixed one serious bug in data event printing. 15-Apr-94 changed the minibuffer to hold 9 numbers at maximum. Transpose values in tool types are now added to the configuration value. Options MFSTATUS and SPEAK added. 16-Apr-94 added keyboard shortcuts for tempo, transpose, channel muting, melody/drumchannel/solo channel selection, window activation. New option FADE. 17-Apr-94 all files are now added to the playlist. More than one filename can be given on the command line. More than one icon can be selected and they all will be added to the playlist. File control functions has been changed: MidiPlay doesn't load a new file unless play option is set (default is on), minibuffer is an exception. All other functions work independent of the state of the play option. Setting the play option won't start playing. Added multi-selection for the file requester. 18-Apr-94 if START AFTER LOAD was not set and the first file was started using CONT gadget or SPACE BAR, MIDI routes were not set correctly. This has now been fixed. Added font sensitivity, MidiPlay adapts itself to the screen font. Cosmetic changes in the preferences window. 20-Apr-94 added f key for fast forward. Normal reset now overrides all filters. Directory buffer can be set off from menu. Playlist removing is now possible. v2.11 24-Apr-94 load/save playlist added. ZOOM gadget added. MidiPlay can be quitted by running it again. v2.12beta 30-May-94 illegal gadtools handling removed. Fixed errorneous time information which occured when CIA timer was used. GUI modification. Added over 60 AREXX commands. Added PLAY option. 14-Jun-94 added AREXX commands: PATCHCHANNEL,VOLUMEDOWN,VOLUMEUP, SETVOLUMECHANGE. Added new tooltypes: PATCHCHANNEL, VOLUMECHANGE. Also FILENAMEREXX and FILETYPEREXX for user definable purposes like for displaying text files or unpacking non-midi files. SPEAK tooltype REMOVED! Fade now works as intended. Different MIDI files can now have different mapfiles. Solo channel bug fixed. Keyboard shortcuts for volume changing. Setting load .info on will set normal configuration values even if an icon is not found. MidiPlay.info tooltypes overriding/extending settings in the midiplay.config file are considered as configuration values. 26-Jun-94 Fixed FADE rounding error. Fixed a serious bug: some memory was freed twice. v2.20beta 14-Jul-94 Added playlist, lyric and text event windows. Removed lyric entry in the SHOW menu. Removed the following ToolTypes: NOMON (replaced with MESSAGEREXX script definition, this means: Upd not needed), PLSIZE (this is not needed anymore). Added ToolType LYRICTYPE. Added file information to the About requester. Added small delay before quitting (MidiOut couldn't send the reset message and crashed sometimes). 23-Jul-94 Fixed bug in About requester. Numeric pad now works. v2.20 27-Jul-94 About requester works now!! If a track couldn't be loaded completely, counting lasted sometimes forever, not anymore. 31-Jul-94 Added tooltypes DIRBUFFER, FORCERESET. Fixed GUI. Fixed negative tempo case. Added ',' support for options/arexx commands which have used '|' before. VOLUMECHANGE requires now ':' instead of ','. 1-Aug-94 Bugs, bugs, bugs... Timer message not aborted at exit. Menus not freed. One requester not freed. And where do the rest hide? v2.20a 17-Aug-94 Status cycle gadget was handled incorrectly. Skip value was read incorrectly. Now tries to read tooltypes from ENV:sys/def_midiplay.info before loading an icon of a MIDI file (sets default file values). Channel 0 has a special meaning for MUTE, NOMAPCHANNELS, VOLUMECHANGE and PATCHCHANNEL (it means that all channels will be affected). PATCHCHANNEL and VOLUMECHANGE ARexx commands can now have more than one setting. MERGE set right after loading. 21-Aug-94 SYSEX ARexx command. Menu available on all windows. Changed ARexx commands SETNOMIDISTART to SETMIDISTART and SETMIDIOUTPUT to SETNOMIDIOUTPUT (also the names in the menu bar have been changed). New or working ARexx commands: LOADMAP, LOADDRUMMAP, FILENAMEREXX, FILETYPEREXX, SETFORCERESET, SETLYRICTYPE, MESSAGEREXX, SETDIRBUFFER, SETSTATUSFIELD. Sysex messages printed. 22-Aug-94 Code for CLI options and tooltypes rewritten. Removed '-' from non-toggle options. Added '-' for MUTE and CLI option K (same as MAP). 24-Aug-94 Bugs...NOPC and NOPB ARexx commands didn't work properly. When playlist was removed, buffer value was set incorrectly. MidiPlay crashed sometimes when playlist was removed and forward was used. TEMPO 0 set now tempo to default value, i.e. 120 and TEMPO CHANGE is set off. Seconds left is now set correctly to zero, when count was not used. When Melody ARexx command is used, mute box is set now correctly. STOP TOGGLE works like the space bar. v2.21a 6-Sep-94 Bug fix: if started from CLI without playlist, extra file was added. Int. reset moved before loading a new file. Fixed some incorrectly printed measure numbers. 18-Sep-94 Small changes in volumechange routines. Pattern gadget in file requester. Select requester calls now messagerexx script if it has been defined and illegal value is given. v2.22 1-Oct-94 Added support for bank changes and external tone files in the mapfile. 4-Oct-94 Bug fix: volumechange via keyboard was broken. 8-Oct-94 Added sysex filter. Added CHANNELBYTE, BANKCHANGETYPE, NOSYSEX and CHANNELPC tooltypes. Added ARexx commands CHANNELBYTE, BANKCHANGETYPE, SETNOSYSEX and CHANNELPC. v2.22a 22-Oct-94 Added mixer connection. CONNECTMIXER ARexx command. v2.23 23-Oct-94 Changed keyboard handling, configurable keymapping now possible. For keyboard support added ARexx commands: MUTETOGGLE, STATUSFIELDUP, ACTIVATENEXTWIN, ACTIVATEDRUMGAD, ACTIVATEMELODYGAD, ACTIVATESOLOGAD, MELODYVOLUMEDOWN and MELODYVOLUMEUP. v2.24 4-Nov-94 Added keyboard loading. New ARexx commands: LOADKEYBOARD, DEFAULTKEYBOARD. New tooltypes: KEYBOARD, DEFAULTKEYBOARD, PATTERN. Bank change type supports now both CC 0 and CC 32 messages. v2.25 22-Nov-94 Window positions with open/closed and zoom information can be saved to an environment file. This file will be loaded automatically when started. Next number in the buffer can be seen in the main window's screen title. 23-Nov-94 Added NOTEON and NOTEOFF commands. Added PORTNAME tooltype. FORWARD command requires now value!! (fast forward speed is value*25%). FF gadget reacts immediately when pressed down. 26-Nov-94 Added SETTINGS tooltype, configuration file should be named to midiplay.prefs and should be located in MidiPlay or in ENV:MidiPlay directory unless defined with SETTINGS. v2.26 30-Nov-94 Added AppWindow to main and playlist windows. Icons dragged into these windows will be added to playlist. Added iconify command (+menu) and AppIcon. Icons dragged into AppIcon will be added to playlist. Double clicking on AppIcon opens earlier opened windows. v2.27 14-Dec-94 Fixed a bug which changed the current file name before reading the correct icon file. It is possible to view only lyric events started by '<' mark by using LYRICTYPE=17 and lyric events started by '%' mark by using LYRICTYPE=33. This may however change in the future. v2.28 20-Dec-94 Muting didn't work correctly (notes off sent on wrong channel). v2.29 9-Jan-95 Bug fixes: icons without tooltypes crashed MidiPlay. No midi output option works again. Meta events were printed over time information. 14-Jan-95 Bug fix: EOX messages were sent earlier with EOX byte. v2.30 22-Jan-95 Tooltype MIDICLOCK added. v2.30a 31-Jan-95 ARexx command symbols ON and TOGGLE work again. Serious quantization bug fixed. NOTE: tooltype is QUANTIZE (not QUANT as in previous documents)! v2.31 5-Feb-95 Added more support for Mixer. v2.31a 28-Feb-95 SYSEX messages were sent ( again :-( ) incorrectly. Example3.rexx modified to work with powerpacked files. >> v2.31b 26-Mar-95 Bug fix: Second MidiPlay crashed when one already running. >> v2.31c 16-May-95 Addition: Titles of Karaoke MIDI files recognized. >> v2.31d 6-Jun-95 Bug fix: Use of NOSYSEX option caused incorrect time on tracks which had sysex messages. v2.40beta 5-Mar-95 Reqtools.library required no more, ASL file requester used instead (dirbuffer option is now obsolete). New select requester now with name selection. The edit requester in playlist window now like a file requester. Fixed bug which crashed MidiPlay when started and another MidiPlay was already running. New ARexx command SELECTNUMBER. SELECT command now has two possibilities: SELECT 0 (or SELECT, default) or SELECT 1 which activates the file name gadget. 16-Apr-95 Menus reorganized, many options now available also via menu. New feature: Intro play (songs played only 10 seconds each). New ARexx commands: SETPLAYSELECTED, SETINTROPLAY. v2.50beta 17-May-95 All playing and loading routines now in a shared library called miditune.library. 19-May-95 ReqTools back as an option (tooltype REQTOOLS, ARexx command SETREQTOOLS). Intro time can now be set with INTROPLAYTIME. 20-May-95 New ARexx command SELECTBUFFER (selected number goes to the buffer). Rewritten some of the event handling code. 27-May-95 Fixed playlist handling code to work properly. 31-May-95 Added support for miditune.library's channel mapping with CHANNELMAP command. 6-Jun-95 Fixed random number generating back to normal. v2.51beta 21-Jun-95 New lyric window for better karaoke file support. New counting routine which checks also lyrics & titles. 7-Jul-95 Some lyric handling bugs fixed. Normal requesters support now also reqtools option. Sizes & places of windows saved now more accurately (font & border relative). 17-Jul-95 Resizable playlist and text event window. Text event window replaced with trackname window. More lyric bugs fixed. Also normal lyric text events collected if not karaoke file and count is set. v2.52beta 20-Jul-95 PUBSCREEN tooltype to open MidiPlay on any existing public screen. Requesters opened on correct public screen. About requester shows also miditune.library version. 26-Jul-95 Fixed resizing bug when the width of the used font was smaller than 8. Lock option now correctly in menus. Top of the listview gadget in the playlist window now set according to the currently selected file. 31-Jul-95 Fixed tempo slider bug, when TEMPOCHANGE filter was set. Fixed forward gadget action back to normal, no more removal of all gadgets :). Fixed normal lyric handling when maximum number of rows exceeded. Made a hack for some karaoke files which have new line characters at the beginning of the lyric event. v2.53beta 17-Aug-95 Fixed some lyric printing bugs when the window is quite small. Lyric starting point was not correctly set when START AFTER LOAD was used and playing was started with CONT command. Added LYRICFONT and LYRICCOLORS commands. WINDOW=ON back as default. 21-Aug-95 If the mixer bit was set in the environment file, the mixer connection showed a wrong value (and the mixer wasn't opened at startup). Also if the select window bit was set, there were some serious troubles. These bugs are now fixed. 30-Aug-95 Fixed one enforcer hit in the default keyboard setting routine. Channelmaps cleared as default. Mixer should work now when connected. v2.54beta 5-Sep-95 Changed string handling (edited strings back to original). v2.55beta 11-Sep-95 QUIT ARexx command wasn't replied before exit. PATCHCHANNEL 0=0 command didn't work correctly. First parts of lyrics are now shown even if START AFTER LOAD is not set. In certain cases, only one paragraph was shown even if there was room for more. v2.56beta 18-Sep-95 When the playlist is resized, the buttons are not vertically resized anymore. Tempo change filter works again. v2.57beta 24-Sep-95 Added new commands: MERGETRANSPOSE and SENDMIDIDATA. 26-Sep-95 Name & copyright information were lost when select to buffer was made. Next file in the buffer was shown sometimes incorrectly. Lyric events from the previous file were sometimes left when the new file was started. v2.58 30-Sep-95 Moving the tempo slider set tempo change filtering on. Final cleanup. @ENDNODE @NODE AUTHOR "AUTHOR" Programs, CDs, postcards, midi files, bug reports, requests, suggestions, questions to: Janne Syväniemi Lintuviidankatu 15 C 10 FIN-33340 TAMPERE FINLAND E-mail:csjasy@uta.fi WWW Home Page: http://www.uta.fi/~csjasy/ Hardware: Amiga500+ with OS3.1, SupraTurbo28, SupraDrive500XP 52Mb, 2Mb Fast Mem, MIDI interface, ROLAND D-10 and now also Roland SC-33 (THANKS TO CONTRIBUTORS!!), Microvitec multiscan Monitor, Chinon HD Disk Drive Software: Dr T's KCS v3.57 @ENDNODE @NODE CREDITS "CREDITS" Thanks to: @{b}Johnny B. Musik@{ub} for SC-33, @{" Icon Guide " Link ICONER}, MIDI files, help and all the great ideas. @{b}Erno Tuomainen@{ub} for his BBS support, testing and ideas. @{b}"Ozzy the Amiga Dood" Osborne@{ub} for his ideas, map files and testing. @{b}Claudio Bizzarri@{ub} for testing (I can't dance :-)) Also to the authors of the following programs and libraries: midi.library by @{b}Bill Barton@{ub} GadToolsBox by @{b}Jan van den Baard@{ub} reqtools.library by @{b}Nico François@{ub} Plus all the other people who have been interested. REQUEST: If you make map files for different setups, please share them with other people too by sending them to me. I'll include them in future releases and your name will be include in the list above. @ENDNODE @NODE TIPS "TIPS FOR USERS" PROBLEM: I have two synths, one is a GM synth and another one is a quitar module. How can I map correct patches to the guitar module on channels 1 and 2 and let other channels to be played on the GM synth without mapping? SOLUTION:Make correct mapfiles for your guitar module and use the following parameters in the configuration file: MAP=ON MAPFILE=GuitarModuleMap NOMAPCHANNELS=3,4,5,6,7,8,9,10,11,12,13,14,15,16 PROBLEM: I have many MIDI files, but drums are always played too loud. SOLUTION:If your synth plays drums on channel 10, put the following parameter in your configuration file: VOLUMECHANGE=10:-20 This means that all volume messages are 20 lower on channel 10. Adjust the value (-20) so that drums are played as you like. You can also adjust the value manually using LSHIFT+0 (down) or RSHIFT+0 (up). PROBLEM: How can I run MidiPlay from a directory utility like DirOpus, without window? SOLUTION:Use command line "MidiPlay -w +S +X []". This plays files without window, starts immediately and exits after all files have been played. You can also use ARexx. Check out playonemidi.rexx example script. @ENDNODE @NODE EXA1 "EXAMPLE 1" /* This is an example ARexx script for use with MidiPlay. Use the following parameter: MESSAGEREXX=ThisScript.rexx When MidiPlay shows a message on the screen, it calls ThisScript. Argument Text consists of the text of the message. This particular example tries to speak the message. */ options results parse arg Text address command 'say' Text @ENDNODE @NODE EXA2 "EXAMPLE 2" /* This is an example ARexx script for use with MidiPlay. Use the following parameter: FILENAMEREXX=ThisScript.rexx When MidiPlay has loaded a new file, it calls ThisScript. Argument consists of drive, path, file and extension of the filename. This particular example tries to view a text file with a name '.../file.txt' when loaded file was '.../file.mid'. */ options results parse arg Drive ',' Path ',' File ',' Extension . if Path == "" then Path2 = Path else Path2 = Path || '/' Ext2 = "txt" Whole = '' || Drive || Path2 || File || '.' || Ext2 || '' if exists(Whole) then 'run >nil: more' '"'Whole'"' @ENDNODE @NODE EXA3 "EXAMPLE 3" /* This is an example ARexx script for use with MidiPlay. Use the following parameter: FILETYPEREXX=ThisScript.rexx When MidiPlay cannot load a file, because it is not a MIDI file, it calls ThisScript. Argument consists of drive, path, file and extension of the filename. This particular example tries to unarchive a file with extension lha to a directory ram:t/rxmidi. If unarchiving is succesful, the first .MID file is played by sending command 'FILE first.MID' to MidiPlay. */ lhadir = 'C:' options results parse arg Drive ',' Path ',' File ',' Extension . address command if ~show('L',"rexxsupport.library") then do if ~addlib('rexxsupport.library',0,-30,0) then exit 10 end if ~exists('t:rxmidi') then 'makedir t:rxmidi' if Path == "" then Path2 = Path else Path2 = Path || '/' Whole = '"' || Drive || Path2 || File || '.' || Extension || '"' "delete >nil: t:rxmidi/#?" if Extension='lha' | Extension='LHA' then lhadir'lha >nil: -x0 -q e 'Whole' t:rxmidi/' else do say 'Not a MIDI file' Whole RETURN end dir1=showdir('t:rxmidi/','f','@') dir1=insert(dir1,'@') dir2=upper(dir1) position=index(dir2,'.MID') position3=lastpos('@',dir2,position) position2=index(dir2,'.MID',position) filenam=substr(dir2,position3+1,(position2-position3)+3) address "MidiPlay_rexx" 'FILE t:rxmidi/'filenam @ENDNODE @NODE MPTOOLKIT "MIDIPLAY TOOLKIT" MidiPlay ToolKit is a program collection to extend the capabilities of MidiPlay. Currently there are a simple simple Mixer, KeyboardEditor, Midi2Text and Text2Midi convertors in the toolkit. Later there will be a singer, a sample player, and a map file editor and more... You can get MidiPlay ToolKit by becoming a registered user of MidiPlay. You become a registered user of MidiPlay by sending me a gift and necessary information about yourself and your setup. Recommended gift is a long play CD (only GOOD music!). Mixer v1.2: Sliders for changing the volume and pan/reverb/chorus values on channels. Meters to show active channels. Instrument numbers also shown. KeyboardEditor v1.4: Every rawkey message with any qualifier combination can be mapped to different command or to an ARexx scriptfile. Different messages can be made for even keydown and keyup messages or repeat keys. MidiPlay will support note on and note off messages in future. Then you can make your keyboard file so that different keys play different pitches and maybe with some qualifier combination different chords. Text2Midi v1.0 and Midi2Text v1.0: Midi2Text utility converts MIDI files to ASCII text format. The text files can then be edited with a normal text editor and converted with the changes back to a MIDI file with Text2Midi utility. @ENDNODE @NODE ICONER "How to adjust MIDI files using icons" How do I adjust the Replay of my Midi files using the Midi file Icons ?????? On a Amiga you can for all files create an Icon which is displayed on the Workbench as a picture The easiest way to create Icons is to use a prg like Dir Opus, in that prg you can simply mark your Midifiles and click the button ADD ICON and Dir Opus then creates an icon for the Midifile. You can then edit your Icon from Dir Opus just by clicking twice on the file that has the same name as your Midifile + the ext .info. The Icon picture then pops up, and then you can click new and in the bottom vindow you can input your command and finish with Enter, then the command is moved from the bottom vindow to the top window and is used by Midiplay when the Midifile is loaded. If you dont have Dir Opus you can open the Icon from WB and choose information and edit from there. You can always reedit your commands by opening the Icon and click on the command you want to edit, by clicking the commands is displayed in the bottom vindow and you can alter the command, when finished always remember to use Enter, and done with editing you must remember to save the Icon. What can I actually adjust in thoose Icons ?? You can really adjust ALL commands that Midiplay understands but the most important are theese !! @{"» Melody Channel    " link ICON_MELODY 0} @{"» Transpose         " link ICON_TRANPOSE 0} @{"» Tempo Change      " link ICON_TEMPO 0} @{"» Program Change    " link ICON_PCCHANNEL 0} @{"» Patch Channel     " link ICON_PATCHCHANNEL 0} @{"» Volume Change     " link ICON_VOLUME_CHANGE 0} I have in this documentation written all Commands with Capital letters, but Midiplay don't care so you are allowed to use both or mix like you prefer. @endnode @NODE ICON_MELODY "Melody channel" Command @{b}MELODY=Value@{ub} This Commands tells Midiplay on which channel your Melody are playing and the value are simply the MIDI Channel number You simply write in you Command line this: MELODY=Value and the value can be positive/negative 1-16 If the value are Positive the Melody will be muted, and will not play when the Replay is started. Ex: @{b}MELODY=4@{ub} The Melody voice is on channel 4 and not played. When you give this command to Midiplay then this info is stored to the F8 key and you can now anytime, get the melody to play just pressing the F8 key. Remember to put SOFT=ON in Midiplay config if you want Midiplay to send out all Mididata on the muted melody channel, all Mididata except note on/off is then sent, and the melody will sound with correct voice when you unmute. SOFT=ON can also be a command line in the MIDI file Icon if you prefer that. If the value is Minus=Negativ then the Melody is played when you start the Replay. Ex: @{b}MELODY=-4@{ub} The Melody is on channel 4 and is played. When you give this command to Midiplay then this info is stored to the F8 key and you can now anytime, mute the melody just pressing the F8 key. @{b}@{i}In both cases repeated pressure on the F8 key toggles between muted and unmuted Melody voice. So you must understand that the Positive or negative value only is there to tell Midiplay how to play when first starting the Melody.@{ub}@{ui} @endnode @NODE ICON_TRANPOSE "Transposing" Command @{b}TRANSPOSE=value@{ub} The value can be 1-12 both Positiv and Negativ. The command is used for transposing the Melody. If the Drumchannel is defined then the drumchannel is not Transposed. @{b}Ex: TRANSPOSE=2@{ub} This tells Midiplay to transpose the Midifile 2 half notes up. @{b}Ex: TRANSPOSE=-4@{ub} This tell Midiplay to transpose the Midifile 3 half notes down. Remember this transpose are relativ to the transpose given in the Midiplay config file or in the def_midiplay icon. If you have given transpose=2 in the config file the the command TRANSPOSE=2 gives the result 2+2 = 4 half notes up and the TRANSPOSE=-4 gives the result 2-4 = 2 half notes down. This means that the tranpose command given in the Midifile Icon are always active no matter what transpose you have given elsewhere, and thats good because if you catch a cold and need to transpose all Midifile half a note to sing with you cold voice you can simply transpose=-1 in the Config file and all your Midifiles are transposed half a note down. @endnode @NODE ICON_TEMPO "Tempo changing" Command @{b}TEMPO=beats pr measure@{ub} Values can be between 40-240 or 0 @{b}Ex: TEMPO=136@{ub} This command tell's Midiplay to play the Midifile in tempo 136. BPM If you use this command be sure there is no tempo change in your Midifile because using the command Midiplay ignores all tempo settings in the MIDI file. Setting TEMPO=0 means use default tempo = 120 @endnode @node ICON_PCCHANNEL "Program change on a channel" Command @{b}CHANNELPC=Channel:Value @{ub} Command @{b}CHANNELPC=Channel:Bbank:Value@{ub} Channel can be between 1-16 Bbank can be between 0-127 Value can be between 0-127 Ex: @{b}CHANNELPC=4:24@{ub} You tell Midiplay@{b} to @{ub}send a Program Change 24 on channel 4 Program change 24 will on General Midi choose a Nylon Guitar, but Nylon Guitar on the Display say 25 which is a mistake and don't match reality. In Midi everything starts with 0 which means that 1 Grand Piano really is prg change 0 etc. You must therefor always subtract 1 if you want a certain prg change on you synth if you look it up in the manual. You can make as many lines with channelpc as you wish, but its also possible to make several in the same command line like: Ex: @{b} CHANNELPC=4:24,5:34,9:1@{ub}0 Just seperate the channelpc's using a , Using channelpc the program change on that channel are ignored and only the given will be used. If your Midifiles contains a Reset SYSEX you have to filter sys x because the prg change in channelpc are send and the prg change on the channel are ignored but the reset sets all parts to G Piano so you wont get the Prg change you intended. You can use the command NOSYSEX=ON in the Icon then if you normally wamt it on you can input the command in the def_midiplay icon NOSYSEX=OFF this way every time a new file is loaded the filter off. You also now can do a bank change using Channelpc first you have to define in your config file how Midiplay should send Bank change. You must use the command bakchangetype Ex: @{b}BANKCHANGETYPE=0@{ub} sends Controlchange 0 + value followed by control change 32 0 @{b}BANKCAHNGETYPE=32@{ub} sends Controlchange 32 + value followed by control change 0 0 Please look into your manual to se which way your synth should be told to change banks. If you want to change to a 12 string guitar on a GS module you must send bank change 8 and prg change 25 and you do like this: CHANNELPC=4:B8:25 You must always give the Bank change as B+value. Also by using Channelpc you can send SYS EX files to your synth, you must use a sysx dump prg to recieve the sysx dumps and then save them under a filename then using Channelpc you can send theese dumps back lets say you have a dump called mydump you write like this @{b}CHANNELPC=1:Tmydump@{ub} Remember always to send Sysex dumps on channel 1 @endnode @node ICON_PATCHCHANNEL "Channel patching" Command PA@{b}TCHCHANNEL=Channel=Chann@{ub}el Channel can have value between 1-16 You tell Midipay that all on first given channel must be send on second given channel Ex: PATCHCHANNE@{b}L=1=10 @{ub}All Events on channel 1 is now send on channel 10 I use this one a lot because many Midi Creators uses 4 drum beats on channel 1 to count in, and my synth need them on channel 10 to play drums. I have standarded all my Midfiles to always play the Melody on channel 4 and the Bass on channel 2. I play the Midifile and notes on which channels melody and bass play, and if its not channel 4 and 2 I patch the file. Wee assume we have a Midifile where Melody plays on channel 9 and the BASS plays on channel 6 and wee then write this in the Midifile Icon.@{b} PATCHCHANNEL=9=4,@{ub}4=9,6=2,2=6 Notice that every patch is seperated using a , In this patch we let channel 9 play on channel 4 therefor I say let then channel 4 play on channel 9 and the same for the BASS. I always do this channel switch this way I'm sure nothing goes wrong and data is not mixed. Now Melody=-4 will work on the melody voice because we have Patched = moved it to channel 4 All other commands also works on the given channel even if you have patched around. @endnode @NODE ICON_VOLUME_CHANGE "Volume Changing" Command @{b}VOLUMECHANGE=Channel:Value@{ub} Channel can be between 1-16 Value can be between Plus/Minus 0-127 Ex: @{b}VOLUMECHANGE=4:25@{ub} Here we tell Midiplay to raise volume on channel 4 with 25 @{b}VOLUMECHANGE=4:-25@{ub} Here we tell Midiplay to lower volume on channel 4 with 25 The Value we give is always added to the volume information in the Midifile. If a volume info is not found on the channel the value given is added to the default value 100 This means giving a volumechange it is added to all volumes on the given channel. ADDING a negative value lowers the volume. Also here you can give several channels. @{b}VOLUMECHANGE=4:20,3:-10,6:5,10:-5@{ub} Again you seperate using the , and here we say: @{b}ADD 20 on channel 4 ADD -10 on channel 3 ADD 5 on channel 6 ADD -5 on channel 10@{ub} Another fine feature to use is this if your Midifile plays to loud or to weak on all channels then use the command like this: @{b}VOLUMECHANGE=0:25@{ub} this raises volume on all channels by 25 @{b}VOLUMECHANGE=0:-25@{ub} this lowers volume on all channels by 25 Then afterwards you could tell Midiplay to ex raise volume on channel 4 by 25. I use that often if I have a Midifile where all volumes are on 127 and the melody is to low to be heard, then I lowers all channel and raises the melody channel. Ex: @{b}VOLUMECHANGE=0:-30@{ub} lovers all channels by 30 @{b}VOLUMECHANGE=4:30@{ub} raises volume on channel 4 by 30. @endnode