@node AppD APPENDIX D: OctaMED's ARexx Commands (version 1) Version 1 commands (and option and window names) are compatible with OctaMED V6 and OctaMED Soundstudio. D.1 Option names Use option names with e.g. OP_GET/SET. See the Help guide under ARexx for more information. AddPaths AdvCurs AdvLine AdvTrk AdvVoice AudioChannels AuraActive AuraFixedRate AuraMinPer AuraSingleCh AutoFlush AutoFreeze AutoTerminate Chord CloseWB Compression CreateIcons CreateIconsForSamples DefHQMode DefLPB DefSlowHQ DefTempo DefTempoBPM DefTPL DefVolMode DestrSpc Edit ExpShrk_Factor F6_F10_Highlights FollowSeq FourBitPalette HalveLoadedSamples HelpViewer HtoB InstCtrlStrLoad KeymapActive KeypadMap KeypadMode KillBx7B00 KillNOff LMB MIDIActive MIDIActSensing MIDIExtSync MIDIInput MIDIReadKeyUps MIDIReadVolume MIDISendOutInput MIDISendSync MMB OverwriteReq Palette_WB PolyPlay PlayAfterLoading PPBuffer PPEfficiency RemPaths ReqTools ResetChord RMB RoundSpc SaveAllInfo SaveInstruments SaveMultiMod SaveNotation SaveTimer SaveTimerOpenWin ShowUnusedBlocks SizeOnlyWindowZoom SMFL_CmdPage_ChAftertouch SMFL_CmdPage_ChannelVol SMFL_CmdPage_MIDIPreset SMFL_CmdPage_ModWheel SMFL_CmdPage_Pan SMFL_CmdPage_Pitchbend SMFL_CmdPage_Tempo SMFL_CmdPage_Velocity SMFL_DontIntermix SMFL_LinesPerBlock SMFL_MaxTracks SMFL_OffsetAdjust SMFL_Resolution SmpEdCrNoise_Level SmpEdDensity SmpEdDigiWVoice SmpEdEcho_Num SmpEdEcho_Rate SmpEdEcho_VolDecr SmpEdFastGfx SmpEdFB_Averaging SmpEdFB_Distance SmpEdFreehand SmpEdMaxVolClip SmpEdMinZoom SmpEdMix_Dest SmpEdMix_Source SmpEdPitch SmpEdPitchChg_AntiAlias SmpEdPitchChg_Dest SmpEdPitchChg_Source SmpEdPitchInHz SmpEdPixelDisp SmpEdVolChg_End SmpEdVolChg_Start SmpEdVolClip SmpEdZoomRngCent SmpEd_LoopPoint Space SpaceIsDel SpaceVal SpreadVal TempoOpChangeCmds Toccata_LevelDisp Transpose_InstSlots WarnDiskFull D.2 Window names (use with WI commands) BLOCKLIST BLOCKPROPERTIES EDITOR EQBAR EQOSC EXPANDSHRINK FONT HIGHLIGHTOPTIONS INFORMATION INSTLOAD INSTPARAMS INSTTYPE INPUTMAP KEYBOARDOPTIONS KEYBOARDSHORTCUTS MAINCONTROL AURAOPTIONS MIDIINPUTCHANNEL MIDIMESSAGEEDITOR MISCOPTIONS MOUSEOPTIONS NEW NOTEECHO PALETTE PLAYINGSEQ PROGKEYS PRINTOPTIONS SAMPLEEDITOR SAMPLELIST SAMPLELISTEDITOR SAVEOPTIONS SAVETIMER SAVE_PPSETTINGS SAVE_XPKSETTINGS SA_ADDWORKSPACE SA_ADJUSTY SA_CHANGEPITCH SA_CHANGEVOLUME SA_CHORDCREATION SA_NOISE SA_DISPLAYSETTINGS SA_ECHO SA_FILTERBOOST SA_MIX SECTIONLIST SMFLOADOPTIONS SONGANNOTATION SONGOPTIONS SONGSELECT SPREADNOTES SYNTHSOUNDEDITOR SY_PROGRAM SY_STRETCH SY_VOLUME TEMPO TEMPOOP TOCCATA_CAPTURE TRACKVOLUMES TRANSPOSE D.3 VE and WI commands (Commands marked * return a value) *VE_OCTAMED: Returns OctaMED version number *VE_OCTAMEDREXX: Returns version number of OctaMED ARexx implementation WI_ACTIVATE WINDOW/A: Activates the specified window WI_CHANGEBOX WINDOW/A,X/N,Y/N,W=WIDTH/N,H=HEIGHT/N: Changes win. dimensions WI_CLOSE WINDOW/A: Closes a window *WI_ISOPEN WINDOW/A: Tests if the specified window is currently open. WI_OCTAMEDTOBACK: Sends the OctaMED screen to back. WI_OCTAMEDTOFRONT: Brings the OctaMED screen to front. WI_OPEN WINDOW/A: Open a window. See above for a list of supported names. WI_OPENSHELL: Opens a new command shell window. Can be more than one open. *WI_REQUEST BODYTEXT/A,GADGETTEXT/A: Displays a requester with one or more gadgets. GADGETTEXT specifies the gadget labels, separated by "|". Result: 0 for rightmost choice; 1, 2.. for other choices (left to right) WI_SHOWSTRING MESSAGE/F: Displays a message on OctaMED's title bar. If no message is specified, resets the title bar to its default state. WI_TOBACK WINDOW/A: Moves specified window behind all other windows. WI_TOFRONT WINDOW/A: Moves specified window in front of all other windows. WI_ZIP WINDOW/A: Shrinks or unshrinks the specified window. D.4 PL (Playing) commands PL_CONTBLOCK: Play block (continue from current position). PL_CONTSONG: Play song (continue from current position). *PL_GETSTATE: Get player's current state. Returns STOPPED/PLAYSONG/PLAYBLOCK PL_JUMPTOTIMERZERO: Jumps to the position where the timer was last reset. PL_NEXTALPHAKEYCHANGESINSTR: "Alpha-enter" facility PL_PLAYBLOCK: Play block (from the beginning). PL_PLAYSONG: Play song (from the beginning). PL_PLAYSTATECOMMAND CMD,ELSE: If playing, executes CMD; if not, ELSE. PL_RESETMIDI: Resets MIDI pitchbenders, mod. wheels and inst. presets. PL_RESETTIMER: Resets the play timer. PL_STOP: Stop playing. D.5 IN (Instrument) commands IN_FLUSH CURR=CURRENT/S,ALL/S,UN=UNUSED/S: Flush one or more instruments. *IN_GETFINETUNE: Returns current instrument's finetune value (-8 - 7). *IN_GETHOLD: Returns Hold value. *IN_GETDECAY: Returns Decay value. *IN_GETDEFAULTPITCH: Returns default pitch (note number, 0 = none). *IN_GETEXTENDEDPRESET: Returns 0 if Extended Preset off, 1 if on. *IN_GETMIDICHANNEL: Returns instrument's MIDI channel (1 - 16, 0 = none). *IN_GETMIDIPRESET: Returns MIDI preset. *IN_GETNAME: Returns current instrument's name. *IN_GETNUMBER: Returns number of current instrument (1 - 63). *IN_GETNUMOCTAVES: Returns number of octaves in the current sample (1 - 7). Returns 0 if the instrument is not of type SAMPLE. *IN_GETOUTPUT: Returns current sample's output device (AMIGA/AURA/TOCCATA) *IN_GETSUPPRESSNOTEOFF: Returns 0 if Suppress Note Off is off, 1 if on. *IN_GETTRANSPOSE: Returns transpose value (-128 - 127). *IN_GETTYPE: Returns EMPTY/SAMPLE/SYNTH/HYBRID/EXTSAMPLE/SAMPLE16/UNKNOWN. *IN_GETVOLUME: Instrument's volume (0 - 64). *IN_ISSLOTUSED SL=SLOT/N: Returns 1 if the specified instrument slot (1-63) is used, 0 if empty. Caution: could be a MIDI instrument even if empty. *IN_ISSTEREO: Returns 1 if sample in stereo, 0 if mono (or not a sample) IN_LOAD NAME/A,NOSL=NOSLIST/S,CN=COMPARENAMES/S: Loads an inst. from disk. NOSLIST = don't search the sample list; COMPARENAMES = don't load if NAME and the name of the current instrument are equal. IN_LOADREQ: Opens the Load Instruments requester. IN_MONO: Convert this sample to mono. IN_SAVE NAME,RAW/S,EIGHTSVX/S,MAUD/S,AIFF/S,WAVE/S: Saves sample. NAME should be a full path name. Default format = EIGHTSVX or MAUD. IN_SAVEREQ RAW/S,EIGHTSVX/S,MAUD/S,AIFF/S,WAVE/S: Opens save requester for saving in the specified format (default: EIGHTSVX). IN_SELECT INS/N,NEXT/S,PREV/S,LAST/S,LU=LASTUSED/S,NEXTFREE/S,PREVFREE/S, MINUS16/S,PLUS16/S,PREVFOUND=NEARCURSOR/S,SWITCH/S: Changes current instrument number. e.g. INS 3 = go to instrument 3; NEXTFREE / PREVFREE = next/previous free instrument slot; MINUS16 / PLUS16 = go back/forward 16 instruments; PREVFOUND selects instrument nearest cursor; SWITCH toggles first inst no. (e.g. 05 -> 15) IN_SETDEFAULTPITCH NO=NOTE/N/A: Sets instrument's default pitch. IN_SETFINETUNE FT=FINETUNE/N/A: Sets finetune (-8 - 7). IN_SETHOLDDECAY H=HOLD/N,D=DECAY/N: Sets hold and/or decay value(s). IN_SETMIDICHANNEL CH=CHANNEL/N/A: Set instrument's MIDI channel (0 - 16). IN_SETMIDIPRESET PR=PRESET/N/A,EXT=EXTENDED/S: Sets MIDI preset. EXTENDED = use extended preset. IN_SETNAME NAME/A: Sets current instrument's name (up to 39 characters). IN_SETNUMOCTAVES OCTS/N/A: Set number of octaves (1 - 7). Only valid if the instrument type is SAMPLE. IN_SETOUTPUT AMIGA/S,AURA/S,TOCCATA/S: Sets instrument's output device. IN_SETSUPPRESSNOTEOFF ON/S,OFF/S,TOGGLE/S: Set/clear/toggle Suppr. NoteOff. IN_SETTRANSPOSE TR=TRANSPOSE/N/A: Sets transpose value (-128 - 127). IN_SETTYPE SAMPLE/S,EXTSAMPLE/S,SYNTHETIC/S,HYBRID/S,SAMPLE16/S: Changes instrument type. Not all type changes are allowed (see docs on disk). IN_SETVOLUME VOL/N,INCREASE/S,DECREASE/S: Sets instrument's volume (0-64), or optionally INCREASE or DECREASE it by one. IN_STEREO: Convert this sample to stereo. IN_SWAPINSTRUMENTS SLOT1/N/A,SLOT2/N/A: Swaps the two given instruments. It only exchanges the instruments, song data is not modified. D.6 SA (Sample editor) commands SA_ADJUSTYRANGE S=SHIFT/N/A: Adjusts range about x-axis (zero line). SHIFT is an 8-bit adjust value. SA_BOOST AVG=AVERAGING/N,D=DISTANCE/N: Boosts range. If either or both values aren't supplied, the values in the Filter/Boost window are used. SA_BUFFERTOSAMPLE: Copies the copy buffer to the sample. SA_CENTRALIZESAMPLE: Centralizes entire sample about x-axis. SA_CHANGEPITCH S=SOURCE/N,D=DEST/N,AA=ANTIALIAS/S: Changes current sample's pitch. SOURCE and DEST are period values. If not supplied, uses values in Change Pitch window. ANTIALIAS turns antialiasing on (otherwise off). SA_CHANGEVOL S=START/N,E=END/N,CLIP/S,NOCLIP/S: Changes range volume. START and END are percentage values. CLIP/NOCLIP set Change Volume window's Check Clip gadget, otherwise current setting is used. To maximize the volume, use SA_CHANGEVOL 999 999 NOCLIP SA_CHANGESIZE SIZE/N/A,C=CLEAR/S,RE=RETAINATEND/S,REQ/S: Changes current sample's size. By default, retains existing sample at the start. CLEAR = entire sample cleared, RETAINATEND = retain at end, REQ = request user. SA_CHOPRANGE: Chops the selected range. SA_CLEARRANGE: Clears the selected range. SA_COPYRANGE: Copies the selected range to the copy buffer. SA_CREATECHORD N=NOTES/N/M/A,FV=FULLVOL/S,NFV=NOFULLVOL/S,ET=ERASETRAIL/S, NET=NOERASETRAIL/S: Creates chord of given notes. NOTES = chord's note numbers (up to 4 can be given). FULLVOL/NOFULLVOL override Chord Creation's Full Volume; ERASETRAIL/NOERASETRAIL override Erase Trailing Notes. For example, to create a three-note major chord: SA_CREATECHORD 1 5 8 SA_CREATENOISE L=LEVEL/N: Adds noise to the selected range. SA_CUTRANGE: Cuts the selected range. SA_DELRANGE: Erases the selected range. SA_ECHO NUM/N,R=RATE/N,VD=VOLDECR/N: Creates echoes. Parameters' purpose given in Echo Window instructions (see the on-line help). SA_ERASE TS=TOSTART/S,TE=TOEND/S,BL=BEFORELOOP/S,AL=AFTERLOOP/S: Erases part of current sample. TOSTART = Range start to sample start; TOEND (default) = Range end to sample end; BEFORELOOP = Loop start to sample start; AFTERLOOP = Loop end to sample end. SA_FILTER AVG=AVERAGING/N,D=DISTANCE/N: Filters range. *SA_GETBUFFERLENGTH: Returns copy buffer size (0 if empty). *SA_GETDISPLAYCHANNEL: Returns currently displayed channel of a stereo sample (LEFT/RIGHT/BOTH). *SA_GETDISPLAYSIZE: The size of the currently displayed part of the sample. *SA_GETDISPLAYSTART: Position of the display start (from the sample start). *SA_GETLOOPLENGTH: Returns the length of the loop. *SA_GETLOOPSTART: Returns the beginning of the loop. *SA_GETLOOPSTATE: Returns 1 if loop is on, 0 if off. *SA_GETRANGEEND: Returns the range end position. *SA_GETRANGESTART: Returns the range start position. *SA_GETSAMPLE O=OFFSET/N/A: Returns the sample value at byte number OFFSET. OFFSET range is 0 to (SAMPLELENGTH-1). Sample value always given in 16-bit, even for 8-bit samples (-32768 to 32767). *SA_GETSAMPLELENGTH: Returns the length of the current sample. SA_INVERTRANGE: Flips the selected range upside down. SA_MIX SL=SOURCELEVEL/N,DL=DESTLEVEL/N: Mixes copy buffer with range. SA_MONITOR AS=ALLOWSAMPLING/S: Starts monitoring. Only the user can close the monitoring area. ALLOWSAMPLING = like clicking Digitize. SA_PASTE OW=OVERWRITE/S: Pastes buffer at Range Start. Will insert unless OVERWRITE specified. SA_PLAY D=DISPLAY/S,R=RANGE/S,CB=CBUFF/S,LO=LOOP/S,TU=TUNING/S: Plays the display / range / loop / tuning tone. SA_RANGE S=START/N,E=END/N,A=ALL/S,LO=LOOP/S: Sets range. START / END = Range Start / End values. ALL ranges whole sample, LOOP ranges loop. SA_RANGETOSYNTHED: Copies the range to the synth editor wave buffer. SA_REFRESH: Refreshes the sample display (see SA_SETSAMPLE). SA_REMUNUSEDSPACE: Removes unused space from both ends of the sample. SA_REVERSERANGE: Reverses the selected range. SA_SAMPLETOBUFFER: Copies the whole sample to the copy buffer. SA_SCROLLDISPLAY L=LEFT/S,R=RIGHT/S,STEP/N: Scrolls the waveform display LEFT or RIGHT. STEP is the scroll step size, as a percentage of the display (for example, 100 scrolls one displayful). Default is 50%. SA_SETDISPLAYCHANNEL BOTH/S,L=LEFT/S,R=RIGHT/S: Change stereo display mode. SA_SETLOOP S=START/N,L=LENGTH/N,KE=KEEPEND/S,R=RANGE/S,D=DISPLAY/S, SA=SAMPLE/S: Sets the loop. START/LENGTH = Loop Start/Length. If only START given, length is unchanged unless KEEPEND set (keeps the end position intact). RANGE/DISPLAY/SAMPLE loops the range/disp./sample. SA_SETLOOPSTATE ON/S,OFF/S: Turns the loop on or off. SA_SETSAMPLE O=OFFSET/N/A,V=VALUE/N/A: For editing the actual sample waveform. Sets the sample value at byte number OFFSET. OFFSET range is 0 to (SAMPLELENGTH-1). Sample value should always be given in 16-bit, even for 8-bit samples (-32768 to 32767). Call SA_REFRESH to refresh display. SA_SHOW S=START/N,L=LENGTH/N,R=RANGE/S,A=ALL/S,LO=LOOP/S: Sets the display to the specified part of the sample. START/LENGTH specify absolute bytes; RANGE/LOOP/ALL shows the range/loop/sample. SA_SWAPBUFFERWITHSAMPLE: Swaps the copy buffer with the sample. SA_ZOOM IN/S,OUT/S: Zooms in/out (havling/doubling the display size). D.7 SG (Song) commands SG_CLEARALLSONGS: Clears all songs (without confirmation). SG_CLEARCURRENTSONG: Clears the current song. SG_DELETESONG CURRENT=HERE/S,LAST/S: Deletes CURRENT (default) or LAST song of a multi-module. Has no effect if only one song exists. SG_DISCARDANNOTEXT: Discards the long annotation text (if it exists). SG_FORGETMODIFICATIONS: After using this command, OctaMED thinks there have been no changes since song was last saved - careful! (See SG_ISMODIFIED) *SG_GETANNOSTRING: Returns the current (short) annotation string. *SG_GETCHANNELMODE: Returns the current channel mode (4 - 8). *SG_GETCURRENTSONGNUMBER: Returns current song number (1 - NUMBEROFSONGS). *SG_GETFILESIZE MMD2/S,MMD1/S,MMD0/S,SMF0/S,MULTIMOD/S,CURRSONG/S: Calculates and returns the unpacked file size of the multi-module (default) or the current song in the desired file format. *SG_GETFILTER: Returns the state of Audio Filter Active (1 or 0). *SG_GETHQ: Returns the state of High Quality Mode (1 or 0). *SG_GETMASTERVOL: Returns the master volume (1 - 64). *SG_GETNAME: Returns the name of the current song (a string). *SG_GETNUMBEROFSONGS: Returns the total number of songs. *SG_GETPLAYTRANSPOSE: Returns the play transpose value (-12 - 12). *SG_GETSLIDEMODE: Returns the slide mode (NO1ST/STD). *SG_GETTEMPO: Returns the main SPD or BPM tempo (Tempo slider). *SG_GETTEMPOLPB: Returns the Lines per Beat value (only used in BPM mode). *SG_GETTEMPOMODE: Returns the current tempo mode (SPD/BPM). *SG_GETTEMPOTPL: Returns the Ticks Per Line value (a.k.a. secondary tempo). *SG_GETTRACKVOL TRACK/N/A: Returns the track volume (1 - 64) of the specified track (0 - 63). *SG_GETVOLMODE: Returns the current volume mode (HEX/DEC). SG_GOTOSONG SONGNUM/N,NEXT/S,PREV/S,LAST/S,NEXTORAPPEND/S: Selects a song. SONGNUM = song number; NEXT/PREV = next/previous song; LAST = last song. NEXTORAPPEND = NEXT with requester to add new song if current is last. *SG_ISMODIFIED: Returns a non-zero value if the song has been modified since it was last loaded or saved. Otherwise returns 0. *SG_ISTRACKON TRK=TRACK/N: Returns the on/off (1/0) state of the specified track. If track not specified, current track is assumed. *SG_ISTRACKSELECTED TRK=TRACK/N: Returns the selected/deselected (1/0) state of the specified track. If track unspecified, current track is assumed. SG_LOAD NAME,FORCE/S: Loads song into memory. IF NAME omitted, opens file requester. Returns an error if song modified, unless FORCE is set. SG_LOADANNOTEXT NAME: Loads annotation text file NAME (or opens requester). SG_NEWSONG HERE/S,LAST/S: Adds new song at curr. pos. (HERE) or after LAST. SG_SAVE NAME,FULLNAME/K,MMD2/S,MMD1/S,MMD0/S,SMF0/S,EXEC/S,MULTIMOD/S, CURRSONG/S: Saves current song (CURRSONG) or multi-module (MULTIMOD, default) in the given format (MMD2/MMD1/MMD0/SMF0/EXEC). Saves under name NAME (if given) using current save path (see SG_SETSAVEPATH). FULLNAME = save path + name. SG_SAVEANNOTEXT NAME: Saves annotation text to NAME (or opens requester). SG_SETANNOSTRING STRING/F: Sets/clears (if no STRING) short anno string. SG_SETCHANNELMODE MODE/N/A: Sets the current channel mode (4 - 8). SG_SETFILTER ON/S,OFF/S: Sets the state of Audio Filter Active (1 or 0). SG_SETHQ ON/S,OFF/S: Sets the state of High Quality Mode (1 or 0). SG_SETMASTERVOL VOL/N/A: Sets the master volume (1 - 64). SG_SETNAME NAME/A/F: Sets the name of the current song. SG_SETPLAYTRANSPOSE TRANSP/N/A: Sets the play transpose (-12 - 12). SG_SETSAVENAME NAME/A: Sets the current project's default save filename. But use the next command to set the save path. SG_SETSAVEPATH PATH/A: Sets the default save file name and save path. You should specify the volume name, the directory and the filename. SG_SETSLIDEMODE STD/S,NO1ST/S: Sets the slide mode. SG_SETTEMPO BPM=SPD/N,TPL/N,LPB/N: Sets the current tempo. SG_SETTEMPOMODE SPD/S,BPM/S: Sets the tempo mode (BPM is now recommended). SG_SETTRACKSTATE TRK=TRACK/N/A,ON/S,OFF/S,TOGGLE/S,SEL/S,DESEL/S, TOGGLESEL/S: Sets the state of the specified track. ON/OFF/TOGGLE = track playing status; other switches = selected state. SG_SETTRACKSTATES ON/S,OFF/S: Sets all tracks ON or OFF. SG_SETTRACKVOL TRACK/N/A,VOL/N/A: Sets TRACK's (0-63) track volume (1-64). SG_SETVOLMODE DEC/S,HEX/S: Sets the volume mode (DECimal or HEX). SG_SHOWFREEMEMORY: Displays free memory on the title bar (used for Ctrl-F). SG_TEMPO_DECREASE TPL/S: Decreases the Tempo (or TPL if set) slider. SG_TEMPO_INCREASE TPL/S: Increases the Tempo (or TPL if set) slider. SG_VOLCONVERT TOHEX/S,TODEC/S,REQ/S: Converts the volume commands of the song. TOHEX = dec -> hex; TODEC = hex -> dec; REQ asks the user. D.8 OP (Options) commands *OP_GET OPT/A: Returns specified option's current value. (See part D.1) See docs on disk for returned value details. *OP_GETKEYBOARDOCT: Returns current octaves: 0 = 1+2, 1 = 2+3, 2 = 3+4 etc. OP_LOADKEYBOARDSHORTCUTS NAME/A: Loads shortcut file (NAME = full path). OP_LOADSETTINGS NAME/A: Loads settings file (NAME = full path name). OP_MULTICMD CMD/M: Multiple commands. You can't use commands which need spaces in their parameters (even with quotes). OP_REPEATCMD TIMES/N,CMD/F: Repeats command CMD the given number of times. Can use with OP_MULTICMD to repeat a sequence of commands. OP_SAVEKEYBOARDSHORTCUTS NAME/A: Saves shortcut file (NAME = full path). OP_SET OPT/A,VAL/N,ON/S,OFF/S,TOGGLE/S: Changes specified option's value or state. ON/OFF/TOGGLE affect check boxes and 'toggling' menu items; VAL affects other options. Make sure the value you give is valid!! OP_SETKEYBOARDOCT OCT/N,FKEY/K/N: Sets current edit octaves. OCT = 1 - 9 (1 = 1+2, 2 = 2+3 etc.) or use FKEY 1 - 5: corresponds to key F1 - F5. OP_TOGGLEBETWEEN OPT/A,VAL1/N/A,VAL2/N/A: Toggles options between two possible values (not check boxes / toggling menu items). OP_UPDATE ON/S,OFF/S: Turns Editor and Information updating on/off. D.9 SY (Synth editor) commands SY_ADDWAVES: Adds the right waveform to the left one. SY_CHANGEVOL VAL/N/A: Changes range volume (VAL = percentage of original). SY_CLEARRANGE: Clears range. SY_CLEARWAVE: Clears current waveform. SY_COPYRANGE: Copies range to the right waveform. SY_COPYWAVE TOTEMP/S,FROMTEMP/S: Copies waveform (TOTEMP = right to left). SY_CUTRANGE: Cuts the selected range. SY_DELPROGCOMMAND VOL/S,WF/S: Deletes entry from VOLume or WaveForm seq. SY_DELWAVE L=LAST/S: Deletes current waveform (unless LAST specified). SY_DOUBLERANGE: Doubles range. *SY_GETNUMBEROFWAVES: Returns number of waveforms in current synthsound. *SY_GETPROGCOMMAND O=OFFSET/N/A,VOL/S,WF/S: Returns an sequence entry. OFFSET specifies the position in either the VOLume or WaveForm sequence. *SY_GETPROGCURSORX: Returns the horizontal cursor position (0 - 5). *SY_GETPROGLENGTH VOL/S,WF/S: Returns length of VOL or WF sequence. *SY_GETPROGLINE: Returns current line number. (May exceed program length). *SY_GETPROGSPEED VOL/S,WF/S: Returns program (= sequence) execution speed. *SY_GETSAMPLE O=OFFSET/N/A: Returns a sample value from the current waveform at position OFFSET (-32768 to 32767: in 16-bit even though 8-bit!). *SY_GETSELECTEDWAVE: Returns selected wave (0 = left, 1 = right). *SY_GETWAVELENGTH: Returns length of curr. waveform (2 - 128, even number). *SY_GETWAVENUM: Returns the number of the currently selected wave. SY_GOTOPROGLINE L=LINE/N/A: Moves to specified sequence line. SY_GOTOWAVE WAVE/N,NEXT/S,PREV/S: Moves to specified waveform. SY_MIXWAVES: Mixes the right waveform to the left. SY_MOVEPROGCURSOR POS/N,LEFT/S,RIGHT/S,UP/S,DOWN/S,FKEY/K/N: Moves sequence cursor. POS = horizontal position 1 - 5; FKEY: 0 = F6, 1 = F7 etc. SY_NEW: Creates a new synthsound. SY_NEWWAVE H=HERE/S: Creates new waveform (adds to end unless HERE given). SY_NOISE: Sets the current waveform to the Noise preset. SY_PASTERANGE: Pastes the right waveform to the left. SY_PULSE: Sets the current waveform to the Pulse preset. SY_RAMPDOWN: Sets the current waveform to the Ramp Down preset. SY_RAMPUP: Sets the current waveform to the Ramp Up. SY_RANGE S=START/N,E=END/N,A=ALL/S: Sets the range. SY_REVERSERANGE: Reverses the selected range. SY_SETPROGRAM PROGRAM/M/A,VOL/S,WF/S,INS=INSERT/S: Enters a VOL or WF seq. Entire sequence is set unless INSERT given. (See docs on disk for more) SY_SETPROGSPEED VOL/K/N,WF/K/N: Sets sequence(s) execution speed. SY_SETSAMPLE O=OFFSET/N/A,V=VALUE/N/A: Set sample value at position OFFSET (-32768 to 32767: 16-bit values). Display refreshed automatically. SY_SETSELECTEDWAVE TEMP/S,ACTUAL/S: Selects right (TEMP) or left waveform. SY_SETWAVELENGTH LENGTH/N/A: Sets current waveform length (2 - 128). SY_SHIFTRANGE L=LEFT/S,R=RIGHT/S: Shifts range left or right. SY_SINE: Sets the current waveform to the Sine preset. SY_STRETCH DIST/N/A: Stretches curr. waveform at cursor (DIST = distance). SY_SWAPWAVES: Exchanges the left and right waveforms. SY_TRIANGLE: Sets the current waveform to the Triangle preset. SY_UNDO: Undoes (reverses the effects of) the last editing operation. SY_WAVETRANSFORMATION START/N/A,END/N/A: Transforms START to END waveform. D.10 ED (Edit) commands - Playing Sequence and Section List ED_CLEARSEQ FORCE/S: Clears the current playseq. FORCE overrides requester. ED_DELETEPLAYSEQ: Deletes the current playseq entry. ED_DELETESECLIST: Deletes the current section list entry. ED_DELETESECTION: Deletes the current section (playing sequence list). *ED_GETCURRPLAYSEQ: Returns current playseq position in current section. *ED_GETCURRSECLIST: Returns the current section list position. *ED_GETCURRSECTION: Returns the current section number. *ED_GETNUMPLAYSEQ: Returns the current section's length. *ED_GETNUMSECLIST: Returns the section list's length. *ED_GETNUMSECTIONS: Returns the total number of sections. *ED_GETPLAYSEQBLOCK O=OFFSET/N: Returns the playseq block no. at pos OFFSET. *ED_GETSECLISTSECTION O=OFFSET/N: Returns seclist section no. at pos OFFSET. *ED_GETSECTIONNAME: Returns the current section's name. ED_GOTOPLAYSEQ NUM/N,PREV/S,NEXT/S,FIRST/S,LAST/S,BOTTOM/S,JUMPED/S, JUMPPLAY/S: Changes current playseq position. NUM = absolute position; BOTTOM = under the last entry; JUMPED instructs Tracker editor to jump to first line of block in that position; JUMPPLAY = same while playing. ED_GOTOSECLIST SECPOS/N/A: Changes current section list position. ED_GOTOSECTION SECT/N/A: Changes current section. *ED_ISBLOCKINSEQ B=BLOCK/N: Returns 0 if block BLOCK doesn't exist in any section, 1 if it does. (cf. Block List window -> Show Unused) ED_NEWPLAYSEQ BLOCK/N,CURRBLOCK/S,COPYBLOCK/S: Inserts new playseq entry at current position. CURRBLOCK inserts current block number, COPYBLOCK copies current playseq entry. ED_NEWSECLIST INSERT=HERE/S,APPEND=LAST/S: Adds new entry to section list. ED_NEWSECTION INSERT=HERE/S,APPEND=LAST/S: Creates new section. ED_SETPLAYSEQBLOCK O=OFFSET/N,B=BLOCK/N,INCREASE/S,DECREASE/S: Edits the current section. INCREASE/DECREASE change selected/current value by 1. ED_SETSECLISTSECTION O=OFFSET/N,SC=SECNUM/N: Edits the section list. ED_SETSECTIONNAME NAME: Sets the current section's name. D.11 ED (Edit) commands - Other ED_ADVANCELINE LINES/N,UP/S,DOWN/S,FKEY/K/N,SPC=SPACING/S,USESETT/S: Advances the cursor UP or DOWN lines LINES (default 1). SPACING uses current Space Value (ensure Space is on). FKEY (6 - 10) moves to F6 - F10 position. USESETT uses current Keyboard Options advance settings. ED_CLEARNOTECMD NOTE/S,CMD/S,ALLPAGES/S: Clears note and/or command digits on the current page (default) or ALLPAGES. Takes Space into account. ED_CREATESLIDE VOL/S,GEN/S,PITCH1/S,PITCH2/S: Creates slide (Edit menu). ED_DELETEBLOCK HERE=CURRENT/S,LAST/S: Deletes CURRENT (def.) or LAST block. ED_DELETENOTE B=BLOCK/K/N,L=LINE/K/N,T=TRACK/K/N,DELSPACE/N: Like pressing Backspace. Default: current cursor pos. DELSPACE = no. of removed notes. ED_ENTERNOTE NOTE/N,PROGKEY/K/N,HOLD/S: Enters NOTE/PROGKEY/HOLD symbol. ED_FINDSAMPLEOCCURRENCE PREV/S,NEXT/S: Like Alt-Ctrl-/. *ED_GETBLOCKNAME B=BLOCK/N: Returns current/specified block's name. *ED_GETCURRBLOCK: Returns the current block number. *ED_GETCURRLINE: Returns the current line number (in decimal). *ED_GETCURRPAGE: Returns the currently displayed command page. *ED_GETCURRTRACK: Returns the track that the cursor is on. *ED_GETDATA B=BLOCK/K/N,L=LINE/K/N,T=TRACK/K/N,P=PAGE/K/N,NOTE/S,INUM/S, CMDNUM=CMDTYPE/S,QUAL=CMDLVL/S,PRTALL/S: Returns song data. Default is cursor pos but can use BLOCK/LINE/TRACK/PAGE. The switches set what data to return (note/inst no/cmd type/cmd level/string e.g. 'C-3 20C48'). *ED_GETLINEHIGHLIGHT B=BLOCK/K/N,L=LINE/N: Returns 1 if line highlighted. *ED_GETNUMBLOCKS: Returns the total number of blocks in memory. *ED_GETNUMLINES B=BLOCK/N: Returns the current/specified block's length. *ED_GETNUMPAGES B=BLOCK/N: Returns the curr/spec block's number of pages. *ED_GETNUMTRACKS B=BLOCK/N: Returns the curr/spec block's number of tracks. *ED_GETPREVIOUSINUM: Returns the current track's previous instrument number. ED_GOTO B=BLOCK/K/N,L=LINE/K/N,T=TRACK/K/N,P=PAGE/K/N: Moves the cursor. ED_GOTOBLOCK PREV/S,NEXT/S,FIRST/S,LAST/S,FIRSTLINE/S,FIRSTPAGE/S: Mainly for keyboard shortcuts. FIRSTLINE/PAGE jumps to block's first line/page. ED_GOTOCMDPAGE PAGE/N,NEXT/S,PREV/S,CYCLEFWD/S: Selects current command page. CYCLEFWD cycles forward, jumping to page 1 after the last page. ED_GOTOTRACK PREVNOTE/S,NEXTNOTE/S,NEXTCHORD/S,FIRST/S,LAST/S,PREVDISP/S, NEXTDISP/S: Mainly for keyboard shortcuts. NEXTCHORD = next chord note. ED_HIGHLIGHTLINE B=BLOCK/K/N,L=LINE/N,ON/S,OFF/S,TOGGLE/S: Highlights, dehighlights, or toggles the current or specified line ED_INSERTEMPTYNOTE B=BLOCK/K/N,L=LINE/K/N,T=TRACK/K/N,INSSPACE/N: Like Shift-Backspace. INSSPACE = number of inserted notes (default = 1). ED_KILLNOTES CURRTRACK/S,ALLTRACKS/S,CBS=CHANGEBLOCKSIZE/S: Kills notes below cursor. (See keyboard shortcuts (Shift/Alt)-Ctrl-K) ED_MOVECURSOR LEFT/S,RIGHT/S,NOTE/S,INUM/S,CMDNUM1=CMDTYPE1/S,CMDNUM2= CMDTYPE2/S,QUAL1=CMDLVL1/S,QUAL2=CMDLVL2/S: Moves cursor. ED_NEWBLOCK HERE=INSERT/S,LAST=APPEND/S,TRACKS/N/K,LINES/N/K,PAGES/N/K: INSERTs/APPENDs new block. You can also specify its size. *ED_NUMBERTONOTE NOTE/N/A: Converts note number to string. E.g. 2 -> 'C#1'. ED_PICKPROGKEYNOTE PROGKEY/N/A: Like keyboard shortcuts Shift-Ctrl- 1 - 0. ED_PLAYNOTE NOTE/N,INUM/N,TRACK/N: Plays a note. Defaults = current. ED_SETBLOCKLINES B=BLOCK/N/K,LINES/N/A: Sets curr/spec block's length. ED_SETBLOCKNAME B=BLOCK/K/N,NAME: Sets current/specified block's name. ED_SETBLOCKPAGES B=BLOCK/N/K,PAGES/N/A: Sets block's no. of pages to PAGES. ED_SETBLOCKTRACKS B=BLOCK/N/K,TRACKS/N/A: Sets curr/spec block's tracks. ED_SETDATA B=BLOCK/K/N,L=LINE/K/N,T=TRACK/K/N,P=PAGE/K/N,NOTE/K/N,INUM/K/N, CMDNUM=CMDTYPE/K/N,QUAL=CMDLVL/K/N,ALTCMD/S: Changes notes/data (see ED_GETDATA). ALTCMD enters the Right Alt programmable key definition. ED_SETDATA_UPDATE ON/S,OFF/S: Turns ED_SETDATA updating on/off. ED_SWAPNOTEWITH FOLL=FOLLOWING/S,RIGHT/S: Like Ctrl-< / >. D.12 RN (Range) commands (and one extra free!) RN_CANCELRANGE: Discards the range. RN_CHANGEINUM SRC/N,DEST/N,CHANGE/S,EXCHANGE=SWAP/S,DELNOTES/S,AFFECT/K/N: Changes instrument numbers (see the Transpose window). AFFECT is 1 - 5. RN_CHANGENOTES SRC/N,DEST/N,CHANGE/S,EXCHANGE=SWAP/S,AFFECT/K/N: Chg notes. RN_COPY RANGE/S,TRACK/S,BLOCK/S: Copies a RANGE/TRACK/BLOCK. RN_CUT RANGE/S,TRACK/S,BLOCK/S: Cuts a RANGE/TRACK/BLOCK. RN_DELETELINE LINE/N: Deletes the current or specified line. RN_DELETETRACK TRACK/N,WHOLESONG/S: Deletes the current or specified track. WHOLESONG deletes the same-numbered track throughout the entire song. RN_DISCARDBUFFERS: Discards all copy buffers. RN_ERASE RANGE/S,TRACK/S,BLOCK/S: Clears a RANGE/TRACK/BLOCK. RN_EXPANDBLOCK FACTOR/N: Expands the block. Can specify FACTOR. *RN_GETRANGEENDLINE: Returns the line number of the last ranged line. *RN_GETRANGEENDTRACK: Returns the track number of the last ranged track. *RN_GETRANGESTARTLINE: Returns the line number of the first ranged line. *RN_GETRANGESTARTTRACK: Returns the track number of the first ranged track. RN_GETSPACINGFROMRANGE: Like keyboard shortcut Alt-~. RN_INSERTLINE LINE/N: Inserts an empty line at current/specified line. RN_INSERTTRACK TRACK/N,WHOLESONG/S: Inserts an empty track. *RN_ISRANGED: Returns 1 if a range is marked, 0 if not. RN_JOINBLOCKS: Joins the current block with the following one. RN_NOTEECHO DIST/N,MINVOL/N: Echoes the range (see the Note Echo window). RN_PASTE RANGE/S,TRACK/S,BLOCK/S,TS=TOSELECTED/S: Pastes. (See Edit menu) RN_SETRANGE STARTTRACK/N,STARTLINE/N,ENDTRACK/N,ENDLINE/N,TRACK/K/N, LINE/K/N,CURRBLOCK/S,CURRTRACK/S: Sets range. Can specify absolute values, or range a given line/track, or range current trk/blk. RN_SHRINKBLOCK FACTOR/N: Shrinks the block. Can specify FACTOR. RN_SPLITBLOCK LINE/N: Splits the block at the current/specified line. RN_SPREADNOTES WIDTH/N: Spreads the ranged notes (see Spread Notes window). RN_SWAP TRACK/S,BLOCK/S: Swaps a track or block with the copy buffer. RN_TRANSPOSE HSUP/S,HSDOWN/S,OCTUP/S,OCTDOWN/S,AFFECT/K/N,ALLINSTRS/S, CURRINSTR/S: Transposes (see the Transpose window). MM_MOVECURSOR LEFT/S,RIGHT/S,UP/S,DOWN/S: For the MIDI Message Editor. @{" Contents " link "Main" 0} @{" Appendix A " link "AppA" 0} @{" Appendix B " link "AppB" 0} @{" Appendix C " link "AppC" 0} @{" Appendix E " link "AppE" 0} @{" Appendix F " link "AppF" 0} @endnode