--------------------------------------------------------------------------------
ProTracker clone for modern platforms                                       2014
--------------------------------------------------------------------------------

 This help file was probably written by Lars "ZAP" Hamre back in the early
 90s. It was edited by me.

 Some technical info:
 
 Sloppy coding by: Olav "8bitbubsy" Sorensen
      Source code: About 730kB (excluding big tables)
 Compiled program: About 680kB
    Graphics data: About 1100kB (when unpacked)
         Worktime: Countless of hours
 
 
 Some buttons/keybindings were not implemented because they would not make
 sense on a non-Amiga system.
 
 
 == Missing things that will be added in the future ==
 
  * Setup screen (will be heavily modified)
 
 
 == Missing things that will NOT be added in the future ==
 
  * Split keys (kinda pointless without MIDI). ctrl+s is now used for MOD saving
  * MIDI support
  * Audio sampling (sampler button in sampler screen).
 
 
 == Where's the Amiga key? ==
 
 PC keyboard:
    Left Amiga key = left Windows key
   Right Amiga key = right Windows key
 
 Mac keyboard:
    Left Amiga key = left Command key
   Right Amiga key = right Command key


 == Non-ProTracker additions ==
 
 * New keybindings:
         F11 - Toggle fullscreen (only works for the opengl version)
         F12 - Toggle low-pass filter (non-A1200 filter mode)
   SHIFT+F12 - Toggle Amiga panning (100% stereo separation)
    CTRL+F12 - Toggle CIA/VBLANK timing for tempo/speed effect (Fxx)
    
 * MOD2WAV button for rendering the current song to a .WAV file.
   Amiga panning mode, channel solo/mute and the low-pass filter are
   included in the rendering.
   
 * Use right mouse button to edit sample data in the sampler like in FT2
   (hold SHIFT key to stop drawing in the y axis, for making steady lines)
   
 * WAV sample loader. 16-bit and/or stereo WAVs are downmixed to 8-bit mono.
   It also attempts to load the "SMPL" chunk to get loop points from
   sampler WAVs and Open ModPlug Tracker and the like. It will put this
   chunk in saved WAV samples too.
   
 * PAGE UP/DOWN and HOME/END works in POS-ED, DISK OP. and the pattern editor
   (and HOME/END works while editing strings)
   
 * POS-ED order entries are clickable



               MAINSCREEN
               ----------
 ## PLAY ##
 Will play the song from the current position in the song. The pointer
 turns yellow, just to show you what's going on.

 ## PATTERN ##
 Will play the current pattern which is shown at the bottom of the screen.
 The pointer turns yellow here as well. Holding down the right button while
 pressing play or pattern will play from the current patternposition.

 ## EDIT ##
 Will put you in edit mode. The pointer turns blue, and you can enter notes
 and numbers from the keyboard. Use the arrowkeys to move up/down and
 left/right in the pattern. Entering a note or a number will cause the
 pattern to jump one or more slots down.

 ## RECORD ##
 Will put you in edit mode, but also play the current pattern or song.
 You can select this in the Edit Options menu. While the pattern or
 song is playing, you can type in notes and numbers from the keyboard,
 and they will appear in the pattern as it scrolls. The notes and numbers
 will also be quantized to the nearest slot, so that keeping a steady rhythm
 is no problem. The pointer will turn blue here as well as in the the normal
 edit mode.

 ## STOP ##
 Will stop playing of songs and patterns, recording, and will turn edit
 mode off.

 ## CLEAR ##
 Will first ask you what you want to clear. You can clear either all,
 song or samples.

 ## EDIT OP. ##
 Will exchange the Spectrum Analyzer
 with the Edit Menu(s). Pressing more
 than one time will browse through the
 edit op. screens.

 ## DISK OP. ##
 Will go to the File Requester.

 ## MOD2WAV ##
 Renders the current tracker module to a .WAV file. Things such as the
 low-pass filter (F12), the panning mode (SHIFT+F12) and channel solo/muting
 also apply to the rendering.
 
 ## POS ED. ##
 This is the Position Editor screen found in ProTracker 2.2 or later.

 ## SETUP ##
 Not implemented yet, but might or might not be an actual setup screen
 in the future.

 ## SAMPLER ##
 Will go to the Sampler screen.

 The small gadgets labeled

 ## 1, 2, 3 and 4 ##
 Represent the audio channels of your Ami.. I mean, non-Amiga computer.
 When lit, that channel is on. When not lit, the channel is muted and and
 the notes in that track will not be played.

 You can also use ctrl-a to toggle an audiochannel, and ctrl-q to unmute all
 channels. Ctrl+shift-a will solo the current channel.

 ## Tempo ##
 The tempo gadget on the status bar is for setting the CIA speed, if CIA
 timing is used. The gadget will be updated every time you set the speed
 using the F command (if CIA that is). To toggle between VBLANK/CIA,
 press CTRL+F12. This flag is not stored in the MOD file, so be careful.
 CIA is the standard mode, use it all the time unless you know what
 you're doning.



                DISK OP.
                --------

 ## Path ##
 The paths for songs, modules and samples. It can be up to ~260 characters
 long, depending on the OS. Click on it to edit the path. Right click
 while editing to zero out all the text - handy for changing the drive.

 ## Pack ## (NOT YET IMPLEMENTED)
 When on, ProTracker will powerpack modules/samples before saving.

 ## Load module ##
 Will set the DISK OP. to LOAD MODULE mode. It will only list loadable
 files (e.g. MOD./.MOD/STK./.STK/M15./.M15)

 ## Save module ##
 Will save the module to the current modules path. The filename will be
 <songname>.mod

 ## Load sample ##
 Will set the DISK OP. to LOAD SAMPLE mode. It will list all files in a dir.

 ## Save Sample ##
 Will save the current sample as WAV, IFF or RAW. Select this in the "Save"
 gadget to the left. WAV/IFF loops will be saved too.



                SAMPLER
                -------
 The new sampler/sample editor was included simply because we thought 
 the one in Noisetracker 2.0 was terrible, and we needed graphing of
 samples and proper loop editing. 

 It's very fast, much faster than Audiomaster, and the editing is
 much simpler. 

 We also included a resampling option which we hope you'll find useful.

 Editing
 -------
 When editing a sample, use the mouse to set the cursorline and to mark
 ranges.

 ## Waveform ##
 Will play the full sample with loops.

 ## Display ##
 Will play the part of the sample being shown on screen.

 ## Range ##
 Will play the marked range.

 ## Stop ##
 Will stop all playing of samples.

 ## Show range ##
 Will magnify the current range and display it.

 ## Show all ##
 Will display the whole sample.

 ## Beg ##
 Will put the cursorline at the beginning of the sample.
 
 ## End ##
 Will put the cursorline at the end of the sample.

 ## Swap buff(er) ##
 The swap the current sample with the copy-buffer.

 ## Zoom out ##
 Will show double the range you are displaying.

 ## Range all ##
 Will range the part of the sample being displayed on screen.

 ## Cut ## (or CTRL+X)
 Will cut away the part of the sample that's marked.

 ## Copy ## (or CTRL+C)
 Will copy the marked range to the copy-buffer.

 ## Paste ## (or CTRL+V)
 Will paste the copy-buffer into the current sample.
 
 ## Tunetone ##
 Will create a sinus sound, which you can tune your samples after.
 See setup 2 help for details.

 ## Note ##
 This is the note to sample on. Range is C-1 to B-3.

 ## Resample ##
 The resampling option is much easier to use than the one in Audiomaster.
 Here's a step-by-step explanation:

 1. Turn on the tuning tone.
 2. Use the keyboard to find what note it is. Use finetune if needed.
 3. Enter the note in the "Note:" box to the right. 
 4. Press resample!

 ## Note ##
 This is what note to resample to.

 ## Disp(lay) ##
 This is the length of the part of the sample being shown on screen.

 ## Loop on/off ##
 This is for turning loops on/off without having to fiddle with the
 repeat and replen gadgets.
 
 ## Exit ##
 Exits the sampler screen. 


 The volume box
 --------------
 The volume box is a bit like Audiomaster's, only better.
 
 Set the "from" and "to" volume percentages by using the sliders,
 or just type in any number you please (from 0 to 200) in the
 percentage boxes to the right.

 ## Normalize ##
 Will find the highest volume settings possible (without clipping).

 ## Cancel##
 Will exit the volume box.

 ## \ ##
 Will set the percentages 100%-0%

 ## / ##
 Will set the percentages 0%-100%

 ## - ##
 Will set the percentages 100%-100%

 ## Ramp ##
 Will ramp (calculate) the volume!



                EDIT OP.
                --------

 The edit op. screens were just a handy way for us to implement all the new
 functions we had thought of. There are three screens, and you can browse 
 through them by pressing the edit op.  gadget more than once, or select one
 by clicking on the numbers 1-3. 
               
 To exit edit op., click on the gadget labeled "E" or press ESC.

 
 Edit op. Screen 1:

 ## Transposing ##

 What is transposing ?

 Transposing lets you shift the pitch of the notes up or down. 
 E.g. Change a C-3 to a C#3.

 In comparison to other trackers, protracker lets you transpose in just
 about every way you can imagine. You can transpose either the current
 sample or all the samples in a track or pattern.

 To the right of the title bar is a small box with the letter "S" or "A".

 S - Only the current sample will be transposed. 
 A - All the samples from $00-$1F will be transposed. V2.0: Now bugfree!

 To toggle between the two, click on the edit op. title bar.
 
 If the setup toggle "TransDel" is on, all the notes transposed out of range
 (C-1 to B-3) will be deleted. If not, they will not be transposed.



 Edit op. screen 2: (Record)

 ## Record ## 
 Patt - Record current pattern only. 
 Song - When recording, pt will move through the patterns in the
        song, just like normal play.

 ## Quantize ##
 Will move the notes you record to every n'th slot. Entering 00 will 
 turn off the quantizing, and the notes you play will always be 
 inserted at the patternposition you are at. Entering 01 will quantize
 the notes the the nearest slot according to the speed. i.e. if you 
 play a note after the first half has been played, it will be quantized
 to the slot below. Entering a value like 8 will quantize to every 8th
 note, and so on. Got that? 

 ## Metro(nome) ##
 The first number is the speed of the metronome, and the second is the 
 channel to play it on. The Sample used for metronomes is always sample
 $1F. Load your own favourite metronome sample. The metronome will always
 be played at C-3, but you can still change the volume and loop values. 
 To turn off the metronome, just set the speed or channel to 00. 

 ## Multi ##
 When on, pt will jump to another channel after you play a note on the
 keyboard. This makes it possible to play two or more notes at the same
 time (very useful with midi). On the setup screen you can choose what
 channel to jump to after playing a note.



 Edit Op. screen 2: (Samples)

 To the right of the title bar is a small box with the letter "T", "P"
 or "S".

 T - Copy & Exchange apply to current track only.
 P - Copy & Exchange will affect the the whole pattern.
 S - Copy & Exchange will apply to the real samples in memory.

 To toggle between the two, click on the edit op. title bar.

 ## Delete ##
 Will delete all notes with the current sample in current track or whole
 pattern.

 ## Kill ##
 Will kill the current sample. That is, remove it from memory and reset
 all sample settings. It will not be deleted from the track or pattern.
 You can also use the period (.) key on the numeric keyboard to invoke
 this function.

 ## EXCHGE (Exchange) ##
 Will exchange the samplenumber shown in the "from" gadget with the sample-
 number in the "to" gadget and vice versa. "T" or "P" selects track or
 pattern. "S" exchanges the samples.

 ## MOVE ##
 Will move the samplenumber shown in the "from" gadget to the sample-
 number in the "to" gadget.



 Edit Op. screen 3: (Sample Editor)

 To the right of the title bar is a small box with the letter "H" or "C".

 H - Will halve the volume when mixing and echoing to avoid clipping.
 C - Will not halve the volume. The sample may be clipped.
 
 To toggle between the two, click on the edit op. title bar.

 ## Mix ## 
 Will mix one sample with another. Pt asks you which two samples to be
 mixed, and where to put the result.

 Holding the right button and pressing mix will mix the current sample with
 itself. You can offset the sample by setting a position in the "pos" gadg.
 If you set "mod" to a non-zero value, the sample will also be modulated. 

 ## Echo ##
 Will create a echo effect on the current sample. Use "pos" to set the 
 delay time of the echo. If you want more room to echo in, just turn up
 the length of the sample.

 ## Boost ##
 Will turn up the treble of the sample. Use this on hi-hats and snares!

 ## Filter ##
 Will Delta-filter the sample. Use this on noisy basses.

 ## X-Fade ##
 Will crossfade the sample (mix with itself, backwards). Handy for looping
 samples that are hard to loop.

 ## Backwd (backwards) ##
 Will turn the sample backwards!

 ## Upsample ##
 Will remove every second byte of the sample, halving the length and 
 shifting the pitch one octave up.

 ## Downsample ##
 Will double every byte of the sample, doubling the length, and shifting
 the pitch one octave down. If you downsample samples longer than $7FFE, 
 you will lose the end of them. 

 ## POS ##
 This is just an offset in the sample, used for a lot of things.

 ## MOD ##
 This is used for modulation. Press "MOD" to modulate the current sample.

 ## Cutbeg(inning) ##
 Will chop the number of bytes set in the "pos" gadget off the beginning of
 the sample.

 ## Chord ##
 Will take you to the Sample Chord Editor screen.
 
 ## FU (Fade Up) ##
 Will fade the volume from 0 to 100%. Use "Pos" to select where in the
 sample to fade up to.

 ## FD (Fade Down) ##
 Will fade the volume from 100 to 0%. Use "Pos" to select where in the
 sample to fade down from.

 ## VOL ##
 With this you can change the "real" volume of the sample. Just set a
 percentage and press "VOL".

 Edit Op.3 is now intended to be used with the new sample-editor. If a 
 range is marked, some of the functions apply to the range only. If there's
 no range marked, the functions will affect the whole sample. You may also
 set "POS" by clicking on the sample and setting the cursor-line.



 Edit Op. screen 4: (Sample Chord Editor)
 
 ## Chord ##
 Will make the chord, using the current sample and the notes chosen, and
 the chord will be put in the current sample or a free sample, depending
 on your choice (see below)

 ## Reset ##
 Will reset the notes and the length

 ## Undo ##
 Will undo the last change (apart from multiple arrow up/down)
 
 ## Length ##
 Will set the length to the maximum value, depending on the length of
 the original sample and the notes you choose. This will of course set
 the ':' after the 4 length digits (see below).
 Holding the right mousebutton will set the length to the minimum depending
 on the notes chosen. '.' will be shown after the 4 digits. Mixing with the
 minimum length will make the sample as long as the shortest sample of the
 four resampled notes.

 ## Major ##
 Will set a major chord, depending on the basenote.

 ## Minor ##
 Will set a minor chord, depending on the basenote.

 ## Sus-4 ##
 Will set a sus-4 chord, depending on the basenote.

 ## Major7 ##
 Will set a major7 chord, depending on the basenote.

 ## Minor7 ##
 Will set a minor7 chord, depending on the basenote.

 ## Major6 ##
 Will set a major6 chord, depending on the basenote.

 ## Minor6 ##
 Will set a minor6 chord, depending on the basenote.

 ## 4 notegadgets ##
 The upper one is the basenote. If you press a gadget, PT will wait for you
 to press a note. Holding the right mouse button will reset the note.

 ## 4 Up/Down gadgets ##
 Will add/sub 1 halfnote from the current note. Holding right button will
 add/sub 1 octave. You can reset the note by adding past B-3.

 ## The 4 rightmost gadgets ##
 Works just like the edit op gadgets.
 1,2,3 takes you to the corresponding edit option, and E exits.

 ## The statusline ##
 Pressing the upper line will toggle between New or Old sample: If N, then
 PT will search for an free sample to put the result. If O, then PT will
 put the result on the current sample, overwriting the original sample.

 Note1!
 ------
 PT puts a '!' last in the samplename to show you that this is a chord
 sample. The '!' is for you to see where the destination-sample has gone,
 it has nothing to do with the program. You can take the '!' away and
 rename the sample to ...-major, ...-minor etc for instance.

 Note2!
 ------
 The chosen option on the status line in edit op. 3, H(alve) or C(lip)
 will affect the chord mixing.
 


             EFFECT COMMANDS
             ---------------

 Effect commands on ProTracker should
 be compatible with all other trackers.

 0 - None/Arpeggio      8 - * NOT USED *
 1 - Portamento Up      9 - SampleOffset
 2 - Portamento Down    A - VolumeSlide
 3 - TonePortamento     B - PositionJump
 4 - Vibrato            C - Set Volume
 5 - ToneP + VolSlide   D - PatternBreak
 6 - Vibra + VolSlide   E - Misc. Cmds
 7 - Tremolo            F - Set Speed

              E - COMMANDS
              ------------

 The E command has been altered to contain more commands than one.

 E0- Filter On/Off      E8- * NOT USED *
 E1- Fineslide Up       E9- Retrig Note
 E2- Fineslide Down     EA- FineVol Up
 E3- Glissando Control  EB- FineVol Down
 E4- Vibrato Control    EC- NoteCut
 E5- Set Finetune       ED- NoteDelay
 E6- Patternloop        EE- PatternDelay
 E7- Tremolo Control    EF- Invert Loop



 Cmd 0. Arpeggio [Range:$0-$F/$0-$F]
 -----------------------------------
 Usage: $0 + 1st halfnote add
           + 2nd halfnote add

 Arpeggio is used to simulate chords. This is done by rapidly changing the
 pitch between 3(or 2) different notes. It sounds very noisy and grainy on
 most samples, but ok on monotone ones.

 Example: C-300047  C-major chord: (C+E+G  or C+4+7 halfnotes)

          C-300037  C-minor chord: (C+D#+G or C+3+7 halfnotes)



 Cmd 1. Portamento up [Speed:$00-$FF]
 ------------------------------------
 Usage: $1 + portamento speed

 Portamento up will simply slide the sample pitch up. You can NOT slide
 higher than B-3! (Period 113)

 Example: C-300103  1 is the command, 3 is the portamentospeed.

 NOTE: The portamento will be called as many times as the speed of the song.
 This means that you'll sometimes have trouble sliding accuratly. If you
 change the speed without changing the sliderates, it will sound bad...



 Cmd 2. Portamento down [Speed:$00-FF]
 -------------------------------------
 Usage: $2 + portamento speed

 Just like command 1, except that this one slides the pitch down instead.
 (Adds to the period).

 You can NOT slide lower than C-1! (Period 856)

 Example: C-300203  2 is the command, 3 is the portamentospeed.



 Cmd 3. Tone-portamento [Speed:$00-$FF]
 --------------------------------------
 Usage: Dest-note + $3 + slidespeed

 This command will automatically slide from the old note to the new.
 You don't have to worry about which direction to slide, you need only set
 the slide speed. To keep on sliding, just select the command $3 + 00.

 Example: A-200000  First play a note.
          C-300305  C-3 is the note to slide to, 3 the command,
                    and 5 the speed.



 Cmd 4. Vibrato [Rate:$0-$F,Dpth:$0-$F]
 --------------------------------------
 Usage: $4 + vibratorate + vibratodepth

 Example: C-300481  4 is the command, 8 is the speed of the vibrato,
                    and 1 is the depth of the vibrato.

 To keep on vibrating, just select the command $4 + 00. To change the
 vibrato, you can alter the rate, depth or both. Use command E4- to
 change the vibrato-waveform.



 Cmd 5. ToneP + Volsl [Spd:$0-$F/$0-$F]
 --------------------------------------
 Usage: $5 + upspeed + downspeed
 
 This command will continue the current toneportamento and slide the volume
 at the same time. Compatible with Noisetracker 2.0.

 Example: C-300503  3 is the speed to turn the volume down.

          C-300540  4 is the speed to slide it up.



 Cmd 6. Vibra + Volsl [Spd:$0-$F/$0-$F]
 --------------------------------------
 Usage: $6 + upspeed + downspeed

 This command will continue the current vibrato and slide the volume at the
 same time. Compatible with Noisetracker 2.0.

 Example: C-300605  5 is the speed to turn the volume down.

          C-300640  4 is the speed to slide it up.



 Cmd 7. Tremolo [Rate:$0-$F,Dpth:$0-$F]
 --------------------------------------
 Usage: $7 + tremolorate + tremolodepth

 Tremolo vibrates the volume.

 Example: C-300794  7 is the command, 9 is the speed of the tremolo,
                    and 4 is the depth of the tremolo.

 To keep on tremoling, just select the command $7 + 00. To change the
 tremolo, you can alter the rate, depth or both. Use command E7- to
 change the tremolo-waveform.



 Cmd 9. Set SampleOffset [Offs:$00-$FF]
 --------------------------------------
 Usage: $9 + Sampleoffset

 This command will play from a chosen position in the sample, and not from
 the beginning. The two numbers equal the two first numbers in the length
 of the sample. Handy for speech samples.

 Example: C-300923  Play sample from offset $2300.



 Cmd A. Volumeslide [Speed:$0-$F/$0-$F]
 --------------------------------------
 Usage: $A + upspeed + downspeed

 Example: C-300A05  5 is the speed to turn the volume down.

          C-300A40  4 is the speed to slide it up.

 NOTE: The slide will be called as many times as the speed of the song.
 The slower the song, the more the volume will be changed on each note.



 Cmd B. Position-jump [Pos:$00-$7F]
 ----------------------------------
 Usage: $B + position to continue at

 Example: C-300B01  B is the command, 1 is the position to
                    restart the song at.

 This command will also perform a pattern-break (see 2 pages below).

 You can use this command instead of restart as on Noisetracker, but you 
 must enter the position in hex!



 Cmd C. Set volume [Volume:$00-$40]
 ----------------------------------
 Usage: $C + new volume

 Well, this old familiar command will set the current volume to your own
 selected. The highest volume is $40. All volumes are represented in hex.
 (Programmers do it in hex, you know!)

 Example: C-300C10  C is the command, 10 is the volume (16 decimal).



 Cmd D. Pattern-break [Pattern-pos:00-63, decimal]
 -------------------------------------------------
 Usage: $D + pattern-position

 This command just jumps to the next song-position, and continues play
 from the patternposition you specify.

 Example: C-300D00  Jump to the next song-position and continue play
                    from patternposition 00.
      Or: C-300D32  Jump to the next song-position and continue play
                    from patternposition 32 instead.



 Cmd E0. Set filter [Range:$0-$F]
 --------------------------------
 Usage: $E0 + filter-status (0 = on, anything else = off)

 This command jerks around with the stupid LED filter.
 No one should ever use it.

 Example: C-300E01  turns LED filter off

          C-300E00  turns LED filter on



 Cmd E1. Fineslide up [Range:$0-$F]
 ----------------------------------
 Usage: $E1 + value

 This command works just like the normal portamento up, except that
 it only slides up once. It does not continue sliding during the length
 of the note.

 Example: C-300E11  Slide up 1 at the beginning of the note.

 (Great for creating chorus effects)



 Cmd E2. Fineslide down [Range:$0-$F]
 ------------------------------------
 Usage: $E2 + value

 This command works just like the normal portamento down, except that
 it only slides down once. It does not continue sliding during the length
 of the note.

 Example: C-300E26  Slide up 6 at the beginning of the note.



 Cmd E3. Glissando Ctrl [Range:$0-$1]
 ------------------------------------
 Usage: $E3 + Glissando-Status

 Glissando must be used with the tone-portamento command. When glissando is
 activated, toneportamento will slide a halfnote at a time, instead of a
 straight slide.

 Example: C-300E31  Turn Glissando on.

          C-300E30  Turn Glissando off.



 Cmd E4. Set vibrato waveform [Range:$0-$3]
 ------------------------------------------
 Usage: $E4 + vibrato-waveform

 Example: C-300E40  Set sine(default)
               E44  Don't retrig WF
          C-300E41  Set Ramp Down
               E45  Don't retrig WF
          C-300E42  Set Squarewave
               E46  Don't retrig WF



 Cmd E5. Set finetune [Range:$0-$F]
 ----------------------------------
 Usage: $E5 + finetune-value

 Example: C-300E51  Set finetune to 1.

 Use these tables to figure out the finetune-value.

 Finetune: +7 +6 +5 +4 +3 +2 +1  0
    Value:  7  6  5  4  3  2  1  0

 Finetune: -1 -2 -3 -4 -5 -6 -7 -8
    Value:  F  E  D  C  B  A  9  8



 Cmd E6. PatternLoop [Loops:$0-$F]
 ----------------------------------
 Usage: $E6 + number of loops

 This command will loop a part of a pattern.

 Example: C-300E60  Set loopstart.

          C-300E63  Jump to loop 3 times before playing on.



 Cmd E7. Set tremolo waveform [Range:$0-$3]
 ------------------------------------------
 Usage: $E7 + tremolo-waveform

 Example: C-300E70  Set sine(default)
               E74  Don't retrig WF
          C-300E71  Set Ramp Down
               E75  Don't retrig WF
          C-300E72  Set Squarewave
               E76  Don't retrig WF



 Cmd E9. Retrig note [Value:$0-$F]
 ---------------------------------
 Usage: $E9 + Tick to Retrig note at.

 This command will retrig the same note before playing the next. Where to
 retrig depends on the speed of the song. If you retrig with 1 in speed 6
 that note will be trigged 6 times in one note slot. Retrig on hi-hats!

 Example: C-300F06  Set speed to 6.
          C-300E93  Retrig at tick 3 out of 6.



 Cmd EA. FineVolsl up [Range:$0-$F]
 ----------------------------------
 Usage: $EA + value

 This command works just like the normal volumeslide up, except that
 it only slides up once. It does not continue sliding during the length
 of the note.

 Example: C-300EA3  Slide volume up 1 at the beginning of the note.



 Cmd EB. FineVolsl down [Range:$0-$F]
 ------------------------------------
 Usage: $EB + value

 This command works just like the normal volumeslide down, except that
 it only slides down once. It does not continue sliding during the length
 of the note.

 Example: C-300EB6  Slide volume down 6 at the beginning of the note.



 Cmd EC. Cut note [Value:$0-$F]
 ------------------------------
 Usage: $EC + Tick to cut note at.

 This command will cut the note at the selected tick, creating
 extremely short notes.

 Example: C-300F06  Set speed to 6.
          C-300EC3  Cut at tick 3 out of 6.

 Note that the note is not really cut, the volume is just turned down.



 Cmd ED. NoteDelay [Value:$0-$F]
 -------------------------------
 Usage: $ED + ticks to delay note.

 This command will delay the note to the selected tick.

 Example: C-300F06  Set speed to 6.
          C-300ED3  Play note at tick 3 out of 6.

 If you use ED0, the note will be delayed a little anyway.
 You can play the same note on two channels, delay one, and get a
 nice flanging effect.



 Cmd EE. PatternDelay [Notes:$0-$F]
 ----------------------------------
 Usage: $EE + notes to delay pattern.

 This command will delay the pattern the selected numbers of notes.

 Example: C-300EE8  Delay pattern 8 notes before playing on.

 All other effects are still active when the pattern is being delayed.



 Cmd EF. Invert Loop [Speed:$0-$F]
 ---------------------------------
 Usage: $EF + Invertspeed

 This command will need a short loop ($10,20,40,80 etc. bytes) to work.
 It will invert the loop byte by byte. Sounds better than funkrepeat...

 Example: C-300EF8 Set invspeed to 8.

 To turn off the inverting, set invspeed to 0, or press ctrl + Z.

 This effect will trash the sample, and will probably be removed in
 the next version.



 Cmd F. Set speed [Speed:$00-$FF]
 --------------------------------
 Usage: $F + speed

 This command will set the speed of the song.  

Vblank: Range 01-FF - Normal timing  

   CIA: Range 01-1F - Set vblank speeds
                      with CIA timing.
   CIA: Range 20-FF - Set BPM speeds,
                      range 32-255.
  Both: Range 00    - STOP song. 




                KEYBOARD
                --------
 The keymap on ProTracker is a standard us keymap. The font has been enhanced
 and redrawn a little, so you now have a lot more special characters than
 before. Remember to always use the left shift and alt, as the right ones
 are used for other things.

 High notekeys:  2 3   5 6 7   9 0   =
                Q W E R T Y U I O P [ ]
                   
 Low notekeys:    S D   G H J   L ;
                 Z X C V B N M , . /

 F1 - Choose lo octave(From C-1 to G-3)
 F2 - Choose hi octave(From C-2 to B-3)

 shft+F3 - Cut track to buffer
 shft+F4 - Copy track to buffer
 shft+F5 - Paste track-buffer to track

  alt+F3 - Cut whole pattern to buffer
  alt+F4 - Copy whole pattern to buffer
  alt+F5 - Paste patt-buffer to pattern
 
 ctrl+F3 - Cut commands to buffer
 ctrl+F4 - Copy commands to buffer
 ctrl+F5 - Paste cmd-buffer to track

 F6 - Go to patternposition 0
 F7 - Go to patternposition 16
 F8 - Go to patternposition 32
 F9 - Go to patternposition 48
 F10- Go to patternposition 63

 shft+F6-F10 - Store current patternposition on selected F-key
  alt+F6-F10 - Play pattern from the stored patternposition
 ctrl+F6-F10 - Record from the stored patternposition

 Esc - Exit DiskOp/EditOp/etc...

 shft+Return  - Insert blank note at cursorposition and move
                the others down. Notes beyond patternposition
                63 will be lost!
 shft+Bckspce - Delete note above cursorposition and move
                the others up. You can NOT do this if you're
                at patternposition 0!

 alt+Return    - As above, but with all 4 tracks
 alt+Backspace - As above, but with all 4 tracks

 ctrl+Return    - Push cmds one down
 ctrl+Backspace - Drag cmds one up

 ctrl+0-9 - Select how many slots PT will jump down each time
            you insert a note (this is only in Edit-mode)

  alt+cursor right - patternnumber up
  alt+cursor left  - patternnumber down
 shft+cursor right - song-position up
 shft+cursor left  - song-position down

 Space - Toggle between Stop/Edit-mode

  right Amiga - Play Pattern
    right Alt - Play Song
  right Shift - Record
    Caps Lock - Toggle Keyrepeat on/off (capslock light = state)

      Del - Delete note under cursor
  alt+Del - Delete command only 
 shft+Del - Delete note and command

 On Numeric pad:

          0 - Select Sample $0
    1st row - Select Sample $1-$4
    2nd row - Select Sample $5-$8
    3rd row - Select Sample $9-$c
    4th row - Select Sample $d-$f
 Just Enter - Select Sample $10

 Holding Enter + the other keys, will select sample $11-$1F

 Left Amiga (Plus keys below) - Transposing like in Edit Op.

   Sample/Track        Sample/Pattern
   ----------------------------------
   1 - Note Up         2 - Note Up
   Q - Note Down       W - Note Down
   A - Octave Up       S - Octave Up
   Z - Octave Down     X - Octave Down

   All/Track           All/Pattern
   -------------------------------
   3 - Note Up         4 - Note Up
   E - Note Down       R - Note Down
   D - Octave Up       F - Octave Up
   C - Octave Down     V - Octave Down

      tab - Move cursor to next track
 shft+tab - Move cursor to prev track

 ctrl+a - Toggle channel on/off
 ctrl+b - Mark block
 ctrl+c - Copy block to buffer (if sampler is open; copy data)
 ctrl+d - Delete block, drag notes up
 ctrl+e - Expand track
 ctrl+f - Toggle LED filter on/off
 ctrl+g - Boost treble on all samples
 ctrl+h - Transpose block up
 ctrl+i - Insert block, push notes down
 ctrl+j - Join-paste block
 ctrl+k - Kill to end of track
 ctrl+l - Transpose block down
 ctrl+m - Toggle multikeys
 ctrl+n - Re-mark last block
 ctrl+o - Contract track
 ctrl+p - Paste block
 ctrl+q - Unmute all channels
 ctrl+r - Restore F6-F10 positions
 ctrl+s - Save module (this is 'toggle split mode' in original PT)
 ctrl+t - Swap tracks
 ctrl+u - Undo last pattern edit change
 ctrl+v - Decrease treble on all samples (if sampler is open; paste data)
 ctrl+w - Polyphonize block
 ctrl+x - Cut block to buffer (if sampler is open; cut data)
 ctrl+y - Backwards block
 ctrl+z - Restore Effects

 shft+0-9 - Store current command on selected key
  alt+0-9 - Insert command in current track

  alt+"\" - Copy command above cursor to current patternposition.
  alt+"=" - Copy command above cursor to current patternposition
            and add one to the value.
  alt+"-" - Copy command above cursor to current patternposition
            and subract one from the value.

  alt+b - Treble increase current sample
  alt+c - Toggle channel 3
  alt+d - Go to Disk Op.
  alt+e - Toggle Edit Op. + screens
  alt+f - Treble decrease current sample
  alt+i - Autoinsert effect on/off
  alt+k - Delete current sample/track
  alt+m - Toggle metronome on/of
  alt+q - Quit ProTracker
  alt+r - Resample current sample
  alt+s - Go to Sampler screen
  alt+t - Toggle Tuning Tone
  alt+v - Toggle channel 4
  alt+x - Toggle channel 2
  alt+y - Save all samples
  alt+z - Toggle channel 1

  F3 - Cut   (and/or ctrl+c in sampler screen)
  F4 - Copy  (and/or ctrl+c in sampler screen)
  F5 - Paste (and/or ctrl+v in sampler screen)

               
     return - Step one note forward
  backspace - Step one note backward
       
               \ - Toggle keypad mode (dots!)
      alt+keypad - tune drumpad
 ctrl+left/right - Sample up/down     



             GENERAL INFO.
             -------------
 Making Music
 ------------
 Any piece of music written with ProTracker is built up from patterns.
 Each pattern is built up from four tracks, one for each of the amiga's
 audiochannels.

 A pattern is 64 lines long. The magnified line is always the one you edit.
 If you need shorter patterns, use the patternbreak effect command.

 A track is built up like this:

     32  C-3 01 C20
     /   \_/ |/ \_/
    /    /   |    \
  Pos Note Sample Effect cmd.

 The C-3 is the note being played at patternposition 32. 01 is the sample-
 number, and the three last digits are the effect command, in this case, set
 volume to $20 (C-Command, 20-Value).

 ProTracker holds a table with info about the sequence in which the patt-
 erns will be played. With the "Pos" gadget you determine your position in
 the table. With "Pattern" you define what pattern to play at that position.
 "Length" defines the total size of the table. The full sequence of Patterns
 is the Song. A song is built up from up to 64 different patterns, each
 being played at up to 128 different positions.

 The small gadgets labeled "I" and "D" are Insert and Delete. With them you
 can Insert or Delete a position from your song. The length of your song
 will be adjusted automatically. Remember that the length of your song
 always must be one more than the last position, since the first position
 is 0.

 Holding down the right button when pressing the Pos, Pattern and Length
 gadgets will speed them up a bit.


 Finetune
 --------
 This is a goodie. Tune your untuned samples to match the others. Right
 button will set finetune to zero.

     0 436.4 hz    -1 432.1 hz
     1 439.0 hz    -2 429.6 hz
     2 441.6 hz    -3 426.3 hz
     3 445.1 hz    -4 423.1 hz
     4 447.8 hz    -5 419.9 hz
     5 451.5 hz    -6 416.7 hz
     6 455.2 hz    -7 414.4 hz
     7 457.0 hz    -8 412.0 hz


 Sample 
 ------
 Clicking on the sample up/down gadgets will flicker through the
 samples. You can use up to 31, or hex $1F samples in a song.

 Sample zero function
 --------------------
 Pressing both mousebuttons at the same time will set the samplenumber
 to zero. You can then record the pattern with sample 0 to prevent
 ProTracker from setting the volume each time you play a new note.

 Length
 ------
 The Length gadgets are simply used for setting the length of the sample.
 A sample can be up to 128k, 131070 or $1fffe long. Do note that any lengths
 above 64k/65534/$fffe will make the real Amiga ProTracker act strange in the
 GUI. It will play the song fine, except that 9xx (sample offset) forces the
 sample to not play if >64k. This happens in this ProTracker port too.

 Volume
 ------
 Use this to set the volume the current sample will be played with.

 Repeat
 ------
 Here you set the start of the sampleloop.

 Replen
 ------
 Here you set the length of the sampleloop.

 Pressing both the left aaaand right button on the sample-gadgets will
 speed them up a bit.

 The PatternNumber Gadget
 ------------------------
 To the middle left of the screen is a box with a number in it. The number
 is the current pattern number.

 The "Are you sure ?" requester
 ------------------------------
 In addition to the gadgets, you can use "Y" or Return for Yes,
 and "N" or ESC for No.

 The Clear requester
 -------------------
 In addition to the gadgets you can use "A" for All, "O" for Song, "S" for
 samples and "C" or ESC for Cancel.

 The Load (sample) gadget
 ------------------------
 This gadget will set DISK OP. "load sample" mode and enter the DISK OP.

 The text-input routine
 ----------------------
 Now this is really simple. Clicking on a textline will enable you to edit
 it. Some text lines are longer than they seem, so use the arrowkeys to
 scroll back and forth in the text. You can also use HOME/END on your keyb.
 The text input mode is just like an ordinary text editor. You can use
 backspace, delete, space and such.
 In text-input mode you can also use the numeric pad for entering numbers.
 Pressing the right mousebutton will clear the textline and exit the editing.
 Use ESC or return to just exit.


 Tips 'n tricks
 --------------
 When inserting, pasting or join-pasting, hold down shift to keep the
 cursor from jumping to the end of the block. e.g. shft+ctrl+P

 Holding shift while pressing ctrl+K (kill to end of track) will kill to
 start of track instead.

 Use Esc or right mousebutton to exit from a lot of things.


 Effect tips
 -----------
 You can set the volume without playing a note. e.g. ---01000
 This will set the volume for sample 1 without trigging the note.

 Or try trigging the sample and sliding
 the volume down. e.g. C-301A08
                       ---01A08
                       ---01A08
 This will create a strange arpeggiato effect, like on "Cream of the earth"
 by Romeo Knight / RSI.


 Pointer Colors
 --------------

 Gray      - Nothing is happening.
 Yellow    - Playing song / pattern.
 Green     - Disk action.
 Blue      - Edit / record.
 Magenta   - Waiting for something (text, number or something else).
 Cyan      - Select entry or delete.
 Red       - Something went wrong.


 Drumpad
 -------
 ProTracker features a drumpad as in Noisetracker 2.0 and 2.1.
 Use backspace '\' instead of period '.' to toggle modes. One or
 more dots will appear to the right of the TUNE/TIMING display.

 No dots: Normal keypad.
   1 dot: Drumpad.
  2 dots: Drumpad - Edit/Rec possible.

 Use Alt + keypad key to set note.


/* End of File */