+ +
About
+ ++ This is the sound generator found inside the NES CPU. The NTSC version + (america/japan) is named 2A03 and the PAL version (europe) is named 2A07. The + difference between the chips is that NTSC version runs at 1.79 MHz and 60 FPS + while PAL runs at 1.66 MHz and 50 FPS.
++ The audio refresh rate is normally tied to the video refresh rate, where each + video frame corresponds to one audio tick, but the NSF format allows any refresh + rate and is customizable from the + Tracker menu
++ There is five sound channels available:
+ +-
+
- Pulse 1 and 2
+ Produces pulse waves with four duty lengths (12.5%, 25%, 50% and 25% inverted). + These channels have a hardware sweep unit that can be accessed by + H and I effects.
+ Note: There is a bug that resets the duty phase when switching between + certain frequencies, this can be heard as a pop and might be noticable when + using vibrato or pitch slides across those frequencies.
+
+
+ - Triangle
+ Triangle shaped waveform. There is no volume control for this channel, + so it will always be either on or off. The triangle cycle period is + twice as long as for square channels so triangle notes will be one octave lower than + square notes.
+
+
+ - Noise
+ White noise generator.
+ Can produce 32k-bit and 93-bit sequences, selectable + from the instruments duty/noise setting. There are only 16 different + pitches available, so a pitch value instead of notes & octaves is displayed.
+
+
+ - DPCM (Delta PCM)
+ Also known as DMC.
+ Used to play delta modulated samples. + Channel effects (volume, arpeggio & pitch slides) does not work on this channel. + The volume column has no effect on this channel. +
+
|
+ + Note: + The volume level + of triangle and noise channels will be affected by the DPCM channel, + due to the way the sound is mixed in the hardware. + More info is available on the bottom of this page. + + |
+
+ + +
+ The 2A03 instruments contains a combination of parameters for the + waveform channels and a set of samples for the DPCM channel.
+ +2A03 settings
+ +
+ 
+ This part of the instrument is only used by the wave channels of 2A03 (pulse, triangle and noise). + The idea is based on the MML style, where a set of sequences are used to program the channels. + A sequence is a list of values that are applied to the channel at the same rate as the NSF refresh rate, shown in the main window. + As shown in the example above, 30 steps take 500 ms to run when using the default rate of 60 FPS.
+ ++ These effects are available
+ +-
+
-
+ Volume
+ Controls channel amplitude. The triangle channel has no volume control, but a volume of zero will make it silent.
+ Range: 0 to 15.
+
+
+ -
+ Arpeggio
+ Used for rapid note shifting, commonly used to simulate chords. This sequence has three separate modes: absolute, relative and fixed.
+-
+
- Absolute: adds to the base note (default).
- Relative: adds to the base note and saves the result as new base note.
- Fixed: does not add to the base note, instead it's used after the sequence + is done. Adding a loop prevents the base note from being used at all.
+
+
+
+
+ -
+ Pitch bend / high-speed pitch bend
+ Affects the pitch, Hi-pitch multiplies the value by 16.
+ Range: -127 to 126 (pitch units)
+
+
+ -
+ Duty cycle / noise mode
+ Sets the duty cycle period and noise mode, the triangle channel is unaffected.
+-
+
- Pulse: 0 = 12.5%, 1 = 25%, 2 = 50%, 3 = 75% (pulse width)
- Noise: 0 = 32k-bit mode, 1 = 93-bit mode
+
+
+ Sequences are defined in the graphical sequence editor, where you can draw with + the mouse (right-click to draw lines) or directly edit the values in the text box. + Left click the bottom part to set a loop point and right click to set a release point. + The text box accepts '$' and 'x' for hexadecimal notation.
+ ++ A loop point causes the sequence to loop and a release points will hold the + sequence until a release command. The loop point is defined as a '|' and release point as '/' in the text + string.
+ ++ Any key can be pressed inside the instrument editor to preview the instrument. + Press ESC to close the instrument editor.
+ ++
DPCM samples
+ +
+ 
+ This tab is used to assign samples for the DPCM channel, it + does not affect any other channel. Assigned samples are samples assigned in + the selected instrument while loaded samples are global for all instruments.
+ +-
+
-
+ Load
+ Load samples from files, the default file extension for DPCM files is '.dmc'. The format must be 1-bit delta PCM and max size is 4081 + bytes. The size should be a multiple of 16 + 1 bytes, otherwise the sample will be padded.
+
+ -
+ Unload
+ Remove selected sample.
+
+ -
+ Save
+ Saves selected sample to a file.
+
+ -
+ Import
+ Load and convert PCM files to delta PCM. + See more info about importing PCM.
+
+ -
+ Edit
+ Open the DPCM editor.
+
+ -
+ Preview
+ Plays the sample (at pitch 15).
+
+
+
+ The available space for DPCM samples is 256 kB with bankswitching (16 kB without bankswitching). + Select a key in "Assigned samples"-box and select the sample from the + drop-down box below (or right click in the list). The pitch box sets the pitch for the sample (15 - 0). + The "<-"-button can also be used to assign samples, and "->"-button to remove assigned + samples.
+ ++ The loop setting will enable the DPCM loop mode, where the entire sample is + looped from start to end.
++ The D-counter (delta counter) setting is used to force the delta counter to an initial value before the + sample is played (equivalent to a Zxx-command in the pattern). Set it to Off to start playing the sample without resetting + the delta counter.
++ The pitch setting translates to a frequency according to the + following table:
+ +| Key | +Frequency | +
| 0 | +4181.71 Hz | +
| 1 | +4709.93 Hz | +
| 2 | +5264.04 Hz | +
| 3 | +5593.04 Hz | +
| 4 | +6257.95 Hz | +
| 5 | +7046.35 Hz | +
| 6 | +7919.35 Hz | +
| 7 | +8363.42 Hz | +
| 8 | +9419.86 Hz | +
| 9 | +11,186.08 Hz | +
| 10 | +12,604.03 Hz | +
| 11 | +13,982.60 Hz | +
| 12 | +16,884.65 Hz | +
| 13 | +21,306.82 Hz | +
| 14 | +24,857.95 Hz | +
| 15 | +33,143.94 Hz | +
+ This is equivalent to the quality setting when converting WAV files to DPCM + samples.
+ +|
+ + Note: + Playing a DPCM sample may decrease the volume level of triangle and noise. + If full volume isn't restored after the sample is finished, + use a note stop or a Z00-effect in the DPCM channel to restore it. + You can use the + Tracker/Display DPCM + option to display the current value of the DPCM delta counter, + a higher value results in lower volume output. Likewise, you can use the Zxx + effect to get some additional control of volume on the triangle and noise + channels. + + |
+
+ + + + diff --git a/hlp/Dn-FamiTracker.hhc b/hlp/Dn-FamiTracker.hhc new file mode 100644 index 000000000..d92fdbb22 --- /dev/null +++ b/hlp/Dn-FamiTracker.hhc @@ -0,0 +1,173 @@ + + + + + +
-
+
+
+
+
+
+
-
+
+
-
+
+
+
+
+
+
+
-
+
+
+
+
+
+
+
+
-
+
+
+
+
+
+
+
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ + Version 0.4.6 +
-
+
- Pattern rows with unspecified instruments will use the selected instrument +
- Fixed some rendering bugs +
- Fixed instrument clone command bug +
-
+
- Improved VRC7 emulation, clipping will occur when audio is too loud +
- Improved accuracy of tempo calculation +
- Added multi-channel support to the insert command +
- Added song selector to the wave export dialog +
- Added drag and drop support to instrument list for instrument reordering +
- Added hex support to macro sequence strings and waves (x00 and $00) +
- Added option to display channel register values +
- Fixed a bug with the transpose command when used without an active selection +
- Fixed a portamento up/down effect bug when used on a silent channel +
- Fixed a bug with Sxx effect on DPCM affecting the pulse 1 channel when exported to NSF +
- Fixed a bug when using delayed notes on the last row of a pattern +
- Fixed a few pattern editor render bugs +
- Fixed MIDI note on/off priority problem +
-
+
- Fixed a problem with fixed arpeggio not playing the final note +
- Fixed muting / unmuting channels affecting all channels when preview full row was enabled +
- Fixed toolbar icons not being visible in Windows XP +
- Fixed a problem that caused the 64th sample not staying assigned when file is loaded +
- Fixed note slides clearing the slide effect after reaching target note +
- Fixed the Select All (Ctrl+A) command behaviour to be more similar to IT +
- Fixed skip command (Dxx) in NSF code when skipping to any other row than 0 +
- Fixed NES export +
- Updated PAL DPCM period table +
-
+
- Added names to the built in VRC7 patches +
- Added option to preview full row when editing notes +
- Added option to display flat notes instead of sharps +
- Added a fix for TNS-HFC carts when DPCM bankswitching is used +
- Added an audio level mixer +
- Removed MIDI import +
- Corrected VRC7 tuning table +
- Fixed DPCM instrument editor keyboard bug +
- Fixed NSF export when using sequences with hidden loop points +
- Fixed NSF code crash when using too many assigned DPCM samples +
- Fixed crash on startup when NSFplay is located in the same folder +
- Fixed a problem with N163 and FDS waves that appeared when playing a module +
- Fixed some DPCM sample editor bugs +
- Fixed duplicated paste bug in the frame editor +
- Fixed some noise pitch slide effect bugs +
- Fixed the tremolo effect command (7xx) on VRC7 channels +
- Fixed note slide effects on VRC7 +
-
+
- Added selection + drag & drop capability to the frame editor +
- NSF exporter will optimize N163 waves +
- Added initial delta counter setting to the DPCM instrument editor +
- Added a text exporter / importer (by rainwarrior) +
- Added a shortcut item for the duplicate patterns command +
- Added a volume mask option to pattern editor (edit menu) +
- Added module comments dialog +
- Adjusted filtering of FDS audio emulation +
- Fixed extra effect columns not being copied on shift+drag +
- Fixed a problem with shift+mouse wheel +
- Fixed a few other FTM file import problems +
- Fixed a problem with FDS wave previewing +
- Fixed a bankswitching bug when exporting multisong NSFs +
- Fixed VRC6 and MMC5 not being silenced by the Cxx command +
- Fixed some problems with the Dxx command +
-
+
- Added an instrument files menu +
- Added an option to copy volume column to text (Shift+copy) +
- Changed default key for note cut to '1' +
- Fixed some problems with the FTM import feature +
- Fixed vibrato (4xx) export bug +
- Fixed volume slide (Axx) export bug +
- Fixed an undo bug after pasting from clipboard +
- Fixed problem when loading instrument files that contains sequences of max size +
- Fixed some wave file export bugs +
-
+
- Added fixed and relative arpeggio modes +
- Added DPCM bank switching +
- Added Namco expansion sound +
- Added pattern expand/shrink options +
- Added pattern & instrument deep clone commands (by coda) +
- Added assembly source export option +
- Added some NSF export optimizations +
- Added indication of unsaved files +
- Added support for 24bit and 32bit samples to the DPCM importer +
- Added better DPCM import resampler (by Jarhmander) +
- Added an option to toggle between old & new speed/tempo split-point +
- Moved the home/end key behaviour to the impulse tracker mode +
- Removed PAL option when using expansion chips +
- Increased auto-scroll speed +
- BPM calculation depends on the row highlight settings +
- Added rainwarrior's new VRC7 patches +
- Fixed the file creation date being overwritten when saving files +
- Fixed VRC6 sawtooth pitch bug +
- Fixed VRC6 instrument switch bug +
- Fixed FDS modulation bug (by rainwarrior) +
- Fixed FDS fine pitch setting in the tracker +
- Fixed FDS instrument release behaviour +
- Fixed export problem that occured when trying to play unassigned samples +
- Fixed VRC7 custom instrument bug in exported NSFs +
-
+
- Added MML string copy/paste to VRC7 instrument editor +
- Added VRC7 built-in patch display +
- Added MML string copy/paste to FDS waveform editor +
- Added pattern font size selector +
- Added single instance option +
- Added play option to FTM file type in file explorer +
- Added context sensitive help (F1) +
- Ctrl+select to do whole channel selections +
- New effects:
+
-
+
- H = FDS modulation depth +
- I = FDS modulation speed, high part +
- J = FDS modulation speed, low part +
+ - Shortcuts with removed keys are saved +
- Fixed a crash bug when frame preview is disabled +
- Fixed a sequence editor crash bug +
- Fixed another VRC6 release sequence bug +
- Fixed the PAL flag bug when loading PAL FTMs +
- Fixed a pitch effect (Pxx) bug in exported NSFs +
- Fixed a portamento effect (3xx) bug on noise channel in exported NSFs + +
- Fixed MIDI sync clock receiver +
- Fixed a square channels emulation bug +
- Fixed a song editor bug +
- Fixed a problem when saving VRC6 instrument files +
- Fixed a small vibrato export bug +
-
+
- Added support for module importing +
- Added a shortcut option to show/hide control panel (in settings/shortcuts) +
- Added alt+left/right to move to left/right channel +
- Added block begin/end commands (Alt+B/E, available in IT-mode) +
- Exporter plugin code updated +
- Fixed a problem when loading multiple FTI files with DPCM samples +
- Fixed a problem that occured when using undo on patterns with Dxx/Bxx effects +
- Fixed VRC7 sweeps, auto portamento & fine pitch setting +
- Adjusted VRC7 mixing volume after hardware measurements +
- Changed the VRC7 built-in patch settings to a more accurate set +
- Fixed auto-arpeggio issue in the tracker +
- Fixed the problem that caused release points to sometimes disappear in + saved files +
- Fixed some synchronization issues that could cause a crash when switching + expansion chip sound +
- Fixed some DPCM editor crash bugs +
- Fixed a bug that crashed the program when loading files with FDS + instruments and FDS expansion disabled +
- Fixed a bug that crashed the program when repeatedly pressing F12 +
- Fixed Sxx effect in exported files +
- Fixed Rxx effect issue on exported files +
- Fixed Vxx effect inconsistency when exporting NSFs +
- Fixed Qxx/Rxx effect behvaiour on FDS in tracker +
- Fixed Rxx/Qxx effect when triggering a new note before the slide is done + in exported files +
- Fixed a bug in the Yxx-effect when exporting to NSF +
- Corrected the tremolo effect on FDS +
- Inverted the Pxx command in the FDS channel +
- Fixed FDS pitch clipping in exported files +
- Disabled FDS hardware envelope trigger for note + offs when exporting to NSF +
- Fixed a crash bug when inserting/removing frames when max count is used +
- Fixed a crash bug that occurred sometimes when using select-all in a + channel with all effect columns enabled +
- Mixed paste does not overwrite non-empty rows anymore +
- Note cut/release works on IT-mode when previewing notes +
- Fixed a crash bug when inputting MIDI data on an invalid channel +
- Fixed VRC6 sequence bug when triggering the release part +
- Fixed a bug where DPCM would fail in exported NSFs after + removing instruments +
- Fixed a crash bug when using a custom refresh rate with expansion chips +
-
+
- Delete key deleted two rows on the bottom row, fixed +
- Entering an instrument column number moves to that instrument +
- Fixed a bug that caused files with 64 instruments to not load +
- Fixed export bug where instruments with empty sequences caused the + file to not work +
- New effect Sxx, cut note after xx frames +
- New effect Xxx, DPCM retrigger, xx = delay in frames +
- Added a feature to remove unused instruments & + patterns +
- Load/save instrument & DPCM paths bug on Windows Vista & 7 fixed +
- Beeps on Alt+[key] removed +
- Redraws screen on row highlight change +
- Fixed pattern display when frame preview is disabled +
- Fixed the tracker/nsf inconcistency when note delay and speed + change was used on the same row +
- DPCM file preview added +
- CTRL+click in frame editor to queue next + frame when playing +
- Added VRC7 & FDS expansion chips +
- Copy & paste in frame editor. Ctrl+C to copy a row and Ctrl+V to + paste +
- Added note release command. Release-part of sequences are defined + by a '/' in the sequence string. +
- Shortcut editor supports combinations of ctrl+alt+shift +
- Added a new vibrato mode that bends both up and + down, old mode is still available as an option +
- Fixed a bug that caused corruption when using undo after pattern + size change +
- Export plugin support is added +
- New commands in the shortcut editor:
+
-
+
- Play song from start (F5) +
- Play and repeat pattern (F6) +
- Play from cursor (F7) +
- Stop (F8) +
- Move to pattern (F2) / frame editor (F3) +
- Replace instrument (Alt+S) +
+ - Frame (order) window now has an edit mode, double click to activate it. Keys:
+
-
+
- 0-F: selects a pattern +
- Ctrl+Up/Down: moves selected frame up/down +
- Insert/Delete: inserts and deletes frames +
- Ctrl+C: copy current frame, Ctrl+V: paste frame into selected frame +
+
-
+
- MMC5 expansion sound support +
- Improved pattern editor (possible to select multiple channels, drag'n'drop, + control+drag = copy, shift+drag = mix) +
- Ctrl+wheel = Transpose selected notes +
- Shift+wheel = Increase/decrease instrument, volume and effect + values +
- Scroll lock = Toggle follow mode +
- Control+D = Duplicate frame +
- It's possible to edit directly in the frame editor by double + clicking +
- Customizable keys for note cut, repeat and clear field +
- Added second highlight +
- Added a repeat action key +
- Added a second highlight option +
- Fixed a bug with the tremolo effect +
-
+
- New effects Q, R (pitch slide), + A (volume slide) A (volume slide) +
- Fixed a tempo bug in the tracker +
- VRC6 support added +
- Improved the song editor +
- Added options to disable follow mode + when playing and customizable row highlighting +
- Added clear patterns command +
- Wave file + export +
- Added .NES file exporting +
- Improved hardware sweep commands + in the tracker again (accurate NSF player is needed to get those right) +
- Fixed a bug where NSFs would + fail if there was deleted instruments in the file +
- Fixed a + problem with NSF bankswitching +
- Fixed some problems with note + delay command in tracker and NSF +
-
+
- New NSF code, creates smaller NSF files (and use less 6502 CPU). +
- NSF bank switching is used automatically when needed. +
- New pattern effects: V, square duty setting/noise mode; Y, DPCM sample offset +
- Settings edit boxes are locked from editing, double click to unlock. +
- Fixed some bugs in the instrument editor to avoid crashes. +
- Added modplug keyboard style when the modplug setting is enabled. +
- Optimized screen updates, the tracker should use less CPU. +
- Currently selected instrument is highlighted in the list box. +
- Added an option to mask the instrument when inserting new notes. +
- Added a tempo box to the song settings. +
- Added multiple-tap-of-home-key functionality. +
- Added an option to select the instrument currently being played by the selected channel. +
- Fixed mixed pasting, instruments is now also pasted. +
- Fixed the instrument sequence too long crash bug. +
- Added buttons for next/prev song in the toolbar. +
- Auto-arpeggio works for PC keyboard input. +
- The commands speed, jump, skip and halt are now handled from muted channels. +
- Notes won't be retriggered when pushing two buttons at the same time and then releasing one. +
- Added a shortcut editor to the option dialog, note that the default shortcuts will still be shown in menus. +
- Page up/down jump lenght is customizable from configuration. +
- Impulse tracker edit option added. +
- The cursor will move with the same length as step length when moving it. +
- Fixed a bug that occured when moving the cursor when multiple effect tracks are visible. +
- Changed the pith sequence interpreter. +
- Volume of channels will be rounded of to 1 instead of 0. +
- DPCM delay works in the tracker. +
- Fixed a problem that caused 8-bit wave files to fail when imported to DPCM. +
- Fixed the crash problem when using samples too long. +
- Added a value gradients option for the volume column. +
- Paste works when edit mode is off. +
- Changed the noise channel to display frequencies instead of useless notes. +
- Square hardware sweep is adjusted. +
- Scrolling with the mouse wheel in free cursor mode will scroll the view and not cursor +
- New keys
+
-
+
- Numpad 0 - 9 = Select instrument 0 - 9 +
- Ctrl + Numpad = Set step size +
- Alt + F9 = Mute channel +
- Alt + F10 = Solo channel +
- Numpad / = Decrease octave +
- Numpad * = Increase octave +
- Ctrl + up = Next instrument +
- Ctrl + Down = Previous instrument +
- Alt + T = Mask instrument column +
+
+ + + + diff --git a/hlp/command_line.htm b/hlp/command_line.htm new file mode 100644 index 000000000..8dbdbc2ef --- /dev/null +++ b/hlp/command_line.htm @@ -0,0 +1,57 @@ + + +
+ +
+ Famitracker may be invoked from the command line + to open a file, or to export an FTM to another file type. +
+ +Open
+ +FamiTracker [FTM filename]
+ +This command line will start FamiTracker and open the + specified FTM document.
+ +Export
+ +FamiTracker [FTM filename] -export [export file] [log file] [DPCM file]
+ +This command line will export the specified FTM file to the specified + export file. Any messages created by the export process will + be sent to the specified log file. After exporting, FamiTracker + will close without opening its main window. This is intended + for automated processing of FTM files.
+ +The type of export is determined by the file extension used. + Known export file extensions: + NSF, + NES, + BIN, + PRG, + ASM, + TXT. + If the export file extension is not known, the first + custom export plugin will be tried instead, if available. + The DPCM file is only required for BIN export; + it is ignored in other cases.
+ +Disable crash dumps
+ +FamiTracker [FTM filename] -nodump
+ ++ This command will disable the crash dump generation, for cases where these are undesirable.
+ ++ + + + diff --git a/hlp/comments.htm b/hlp/comments.htm new file mode 100644 index 000000000..3463811c7 --- /dev/null +++ b/hlp/comments.htm @@ -0,0 +1,23 @@ + + + +
+ +
+ This dialog is used to store a message in the module file.
+
+ Options:
+
-
+
- Show when loading file: Show this dialog when opening file. +
+ + + + diff --git a/hlp/config_appearance.htm b/hlp/config_appearance.htm new file mode 100644 index 000000000..ff8bb799e --- /dev/null +++ b/hlp/config_appearance.htm @@ -0,0 +1,32 @@ + + + +
+ +
+ These settings are used to configure the visual appearance of the pattern editor.
+ ++ Two toggle options are available: + +
-
+
- Pattern colors
+ Check this to enable individual colors for each column. When unchecked + the note/octave color will be used for all columns.
+ - Display flats:
+ Display notes as flats (♭) instead of sharps (♯) in the pattern editor. +
+
+ + + + diff --git a/hlp/config_general.htm b/hlp/config_general.htm new file mode 100644 index 000000000..8fbfcf4a9 --- /dev/null +++ b/hlp/config_general.htm @@ -0,0 +1,189 @@ + + + +
+ +
These settings controls general application behaviour.
+ +General settings
+ +| + Setting | ++ Description | +
| + Wrap cursor | ++ Cursor wraps when it has reached the end or beginning of the pattern. | +
| + Wrap across frames | ++ The cursor in the pattern window can move across frames. | +
| + Free cursor edit | ++ Unlocks the cursor from the middle row. | +
| + Preview wave files | ++ Preview wave files when importing to DPCM. | +
| + Key repeat | ++ Enable key repetition. The same setting as in the control panel. | +
| + Show row numbers in hex | ++ Display row numbers in hexadecimal. | +
| + Preview next/previous frame | ++ Preview the next and prevous frame in the pattern editor. | +
| + Don't reset DPCM on note stop | ++ Don't reset the DPCM channel when stopping the channel. Can remove + annoying popping + sounds when editing. | +
| + Ignore step when moving | ++ Ignore the step setting when moving the cursor, only use it when inserting + notes. | +
| + Delete-key will pull up rows | ++ Delete key is pulling up rows. | +
| + Backup files | ++ Creates backups when saving files. | +
| + Single instance | ++ Prevents opening multiple instances of famitracker. You must restart the + program for this setting to take effect! | +
| + Preview full row | ++ Plays the complete row when inserting or previewing notes, + instead of just the selected channel. | +
| + Don't select on double-click | ++ Disable whole channel selection when double clicking in + the pattern editor. | +
+ +
Tracker edit style
+ +| + Setting | ++ Description | +
| + FastTracker II | ++ Step down after inserting instrument / effect number. | +
| + Modplug | ++ Stays on the same line after inserting instrument / effect number, also + affects keyboard layout. | +
| + Impulse Tracker | ++ Impulse tracker style when inserting instrument / effect numbers. Doesn't + release instruments on key up actions. Changes behaviour of home/end keys. | +
+ +
Keys
+ +| + Key | ++ Description | +
| + Note cut | ++ Inserts a note cut command in the pattern editor. | +
| + Clear field | ++ Clears a pattern field (note, volume, instrument or effect) | +
| + Repeat | ++ Repeats last action in the pattern editor. | +
| + Note release | ++ Inserts a note release command in the pattern editor. | +
+
+ + + + diff --git a/hlp/config_midi.htm b/hlp/config_midi.htm new file mode 100644 index 000000000..9227264e4 --- /dev/null +++ b/hlp/config_midi.htm @@ -0,0 +1,75 @@ + + + +
+ +
+ This panel is used to configure the MIDI interfaces.
+ +| + Setting | ++ Description | +
| + Input device | ++ Selects a MIDI input device to control the pattern editor. | +
| + Output device | ++ Output commands to a MIDI device. | +
| + Receive sync ticks | ++ Enable receiving MIDI timing clock, which causes the tracker to step down in the pattern + editor for each 6'th tick. This results in 4 steps/quarter note.1 | +
| + Skip key releases | ++ Skip recording of key release commands. | +
| + Map MIDI to NES channels | ++ Maps the MIDI channels to the tracker channels (MIDI channel 0 = pulse 1, + channel 1 = pulse 2...) | +
| + Record velocities | ++ Translate MIDI note velocities to volume column values. | +
| + Auto arpeggiate chords | ++ Arpeggiate multiple keypresses. | +
+ 1. Note: This command will also disable automatic step down when inserting notes in the pattern editor! +
+ ++ + + + diff --git a/hlp/config_mixer.htm b/hlp/config_mixer.htm new file mode 100644 index 000000000..bcc07abbf --- /dev/null +++ b/hlp/config_mixer.htm @@ -0,0 +1,25 @@ + + + +
+ +
This allows you to confgure the mixing levels of the emulated audio hardware. This option is provided because + the mixing levels could vary on different types of hardware (such as different models of the Famicom or different versions + of game carts), it allows you to fine tune the audio emulation against a specific + set of hardware.
+Before changing these settings, please be aware that mixing levels are not stored in the NSF format and + that your song could be played back with any configuration of mixing levels!
+APU1 is the first audio out pin (pulse 1 & 2) and APU2 is the second audio out pin (triangle, noise & DPCM), + the rest are the expansion chips. The sliders ranges from -12 dB to +12 dB, the default + value is 0 dB for all sliders.
+ ++ + + + diff --git a/hlp/config_shortcuts.htm b/hlp/config_shortcuts.htm new file mode 100644 index 000000000..be895422e --- /dev/null +++ b/hlp/config_shortcuts.htm @@ -0,0 +1,20 @@ + + + +
+ +
+ This section allows you to customize the key shortcuts in the program.
+ Select the command you want to modify and the press the key combination you wish
+ to use in the keys-field.
+ + + + diff --git a/hlp/config_sound.htm b/hlp/config_sound.htm new file mode 100644 index 000000000..2300cb44c --- /dev/null +++ b/hlp/config_sound.htm @@ -0,0 +1,73 @@ + + + +
+ +
+ This panel is used to configure the audio settings.
+ +| + Setting | ++ Description | +
| + Device | ++ The DirectSound device used for audio output. | +
| + Sample rate | ++ Audio sample rate, should be set to the native setting of your sound card.1 | +
| + Sample size | ++ Audio sample size, use 16 unless you are using a really old sound card. | +
| + Buffer length | ++ Audio buffer length. Keep as short as possible for lowest delay. (Default: 40 ms) | +
| + Bass filtering | ++ Blip-buffer bass filtering, default: 20 Hz. | +
| + Treble filtering | ++ Blip-buffer treble filtering, default: 12kHz, -24 dB. | +
| + Volume | ++ Sound volume level. | +
+ 1. This program is using band-limited synthesis, a higher sample rate is not necessary for high audio quality. + This setting should be set to the native rate of your sound card to maximize performance.
+ ++ + + + diff --git a/hlp/configuration.htm b/hlp/configuration.htm new file mode 100644 index 000000000..edd7ed3c0 --- /dev/null +++ b/hlp/configuration.htm @@ -0,0 +1,29 @@ + + + +
+ +
+ This chapter explains the five categories in the + configuration window. +
+ + + ++ + + + diff --git a/hlp/control_panel.htm b/hlp/control_panel.htm new file mode 100644 index 000000000..60d7e97a6 --- /dev/null +++ b/hlp/control_panel.htm @@ -0,0 +1,104 @@ + + + +
+ +
The main window control panel
+ +
+ +
Frame editor
+ +
+ The first part is the frame editor (also known as order editor), located to
+ the left.
+ A frame is a set of patterns for all channels, where each
+ channel is represented by a pattern number individual from all other channels. There
+ are 128 available pattern slots for each channel, and the patterns aren't shared across
+ the channels. Up to 128 frames can be used.
+ To change pattern, press "+" or "-" buttons or "+" & + "-" keys in + the pattern editor. If "change all" is checked, all channels will change + instead of just the selected one. Use Ctrl+Right and Ctrl+Left to + step through frames from the pattern editor. Double click or press F3 + to enable edit mode for the frame editor, where you can enter pattern values + manually.
+
+ The frame editor also supports mouse selection and drag & drop operations. Use Shift+drag to copy pattern numbers to new frames and Ctrl+drag to
+ copy patterns to new frames.
Song settings & edit settings
+ ++ Song settings is default play speed & tempo, number + of rows and frames in the song. Double-click any box to enter a value manually.
+ ++ Speed and tempo can also be changed by using pattern command Fxx. The real BPM + tempo is calculated by using the formula
+ ++ BPM = (6 * Tempo) / Speed
+ ++ which means that the tempo box is correct at speed of 6.
+ +|
+ + Note: + The speed & tempo split-point is currently set to 32, but files created in older versions of the tracker + will have this point set to 20. This was changed to give a access to a larger speed range since the speed + command sometimes is more useful than the tempo command. + + It is possible to toggle this split-point with the command Ctrl+Shift+S + if you wish to change it in the current module. + + |
+
+ The time base for the song is 60 or + 50 ticks per second (when using default NTSC/PAL settings), and this is used to + calculate the average tempo of the song. This means that some rows may play + slightly longer or shorter than others, + something that might be audible. To avoid this, leave the + tempo setting at 150 (125 for PAL!) and use only the speed setting to change BPM + to ensure that all rows get the same duration.
++ Also be aware that the maximum supported BPM is 900 for NTSC and 750 for PAL + (equal to speed 1 at tempo 150 / 125), going above that will not function + properly!
+ ++ The step setting changes the step behaviour when moving the cursor in the + pattern editor. Key repetition enables key repeat behaviour.
+ ++ Song information & instrument list
+ ++ Song information text fields are for name, artist and copyright. These strings are stored + in NSFs (and also available in the NSF export dialog). The song + list selects a song in multi-song files. + The big list to the right is the instrument box, and + the small toolbar is used to create, + delete, open, save and edit settings for instrument and the text box is to name + instruments.
++ The instrument list supports drag and drop operation for reordering instruments.
+ ++ + + + diff --git a/hlp/dpcm_editor.htm b/hlp/dpcm_editor.htm new file mode 100644 index 000000000..769c3a311 --- /dev/null +++ b/hlp/dpcm_editor.htm @@ -0,0 +1,64 @@ + + + +
+ +
There is a simple DPCM sample editor available from + the DPCM instrument editor, + it's intended mainly for trimming silent parts from the beginning and end of samples. + Other types of edits should be done preferably before the sample is + converted to DPCM.
+ +
+ 
Use the sample area to select a part of the sample and to set the + start position (for preview).
+ +-
+
- Delete
+ Removes a part of the sample, select the part you wish to remove and press delete. This works best on the + beginning and end of a sample; if you need to remove something in the middle + then it's usually better to do this on the sample before you convert it to DPCM. +
+
+
+ - Tilt
+ Inserts zero-value samples + inside a selected area, causing the sample to tilt toward zero. The idea is to + restore the delta counter back to zero when the sample + has finished, in order to restore volume for the triangle and noise channels. +
+
+
+ - Center wave
+ Draws the sample with an initial delta counter value of 64 in order to center the start of the wave. + This is another method to keep the triangle and noise volume consistent, make + sure all samples starts and ends at 64. + The sample itself is not affected by this option, the equal operation in the + tracker is to use the effect Z40 when playing the sample. +
+
+
+ - Play
+ Previews the sample at the selected pitch.
+
+
+ The offset value tells the start position (as used internally by + the DPCM channel), this value can be used with the + Yxx command. + The pos value is the position in size units as used by the DPCM channel.
+ ++ + + + diff --git a/hlp/dpcm_import.htm b/hlp/dpcm_import.htm new file mode 100644 index 000000000..ebebfefee --- /dev/null +++ b/hlp/dpcm_import.htm @@ -0,0 +1,44 @@ + + +
+ +
+ This feature is used to convert Microsoft wave files (.wav) to 1-bit DPCM samples,
+ as used by the NES hardware's sample channel.
+ The format of the wave files must be PCM, no compressed formats are supported.
+ Sample rate, sample size and channel count doesn't matter, the file will be
+ resampled according to the quality setting.
+ Choose import in
+ the DPCM instrument editor dialog, select a file and you will be asked to select
+ a quality and volume
+ setting:
-
+
- Quality
+ Sets the sample rate for the converted sample, this is equivalent to the pitch setting in the instrument editor. Use the same setting to play the + sample at original pitch. Quality of 15 gives + best result but also shortest sample time.
+
+ - Gain
+ Sets the conversion volume level. Range: -12dB to +12dB. +
+
+ Maximum supported size of one DPCM sample + is 4 kB, at quality 15 (33 kHz) it's a little + less than one second and lowest quality (4 kHz) about eight seconds.
+ ++ + + + diff --git a/hlp/effect_list.htm b/hlp/effect_list.htm new file mode 100644 index 000000000..26879a331 --- /dev/null +++ b/hlp/effect_list.htm @@ -0,0 +1,196 @@ + + + +
+ +
The pattern effects are based on the MOD effects. + One important difference to many other trackers is that most effects remains active until it's disabled with a 00 parameter.
+ +General effects
+-
+
- 0xy - Arpeggio +
- 1xx - Slide up +
- 2xx - Slide down +
- 3xx - Automatic portamento +
- 4xy - Vibrato +
- 7xy - Tremolo +
- Axy - Volume slide +
- Bxx - Jump +
- Cxx - Halt +
- Dxx - Skip +
- Exx - Volume +
- Fxx - Speed / tempo +
- Gxx - Note delay +
- Hxy - Hardware sweep up +
- Ixy - Hardware sweep down +
- Pxx - Fine pitch +
- Qxy - Note slide up +
- Rxy - Note slide down +
- Sxx - Delayed cut +
- Vxx - Timbre control +
DPCM effects
+ + +FDS effects
+ + ++
+ + 0xy - Arpeggio
+
Changes the pitch of the note every tick, with base + x and base + y semitones.
+ Use 00 to disable.
+
+ Example: 047 to simulate a major chord.
+ + 1xx - Slide up
+
Continuously slides the pitch up, with xx steps in pitch units every tick. Use 00 to disable.
++ + 2xx - Slide down
+
Continuously slides the pitch down, with xx steps in pitch units every tick. Use 00 to disable.
++ + 3xx - Portamento
+
Automatically slides to new notes, with xx steps in pitch units every tick. Use 00 to disable.
++ + 4xy - Vibrato
+
Applies sine vibrato to notes. x is speed (0 to disable) and y is the depth of the vibrato.
++ + 7xy - Tremolo
+
Applies sine tremolo to notes. x is speed (0 to disable) and y is the depth of the tremolo.
++ + Axy - Volume slide
+
Automatic volume slide. Use A0y to slide up and Ax0 to slide down. + The x and y parameters affects the volume column value as fractions of 8. + Use 00 to disable.
++ + Bxx - Jump
+
Jump to frame/order xx.
++ + Cxx - Halt
+
Halt playback of the module, use this to prevent infinite looping of + songs. (xx has no effect)
++ + Dxx - Skip
+
Skip to next frame/order and jump to row xx.
++ + Exx - Volume
+
Sets the channel volume.
+
+
+ This effect is obsolete and remains for compatibility reasons, prefer to use the volume column instead.
+ + Fxx - Speed / tempo
+
Controls the speed and tempo setting of the module. xx between 01 - 1F sets the speed and + xx between 20 - FF sets the tempo.
++ + Gxx - Note delay
+
Delays the current row for xx number of ticks before + triggering the note, for the specified channel only.
++ + Hxy - Hardware sweep up
+
Triggers the hardware sweep up. x is period (0 - 7) and y is the shift value (1 - 7).
+
+ This effect is only available on the 2A03 pulse channels.
+ + Ixy - Hardware sweep down
+
Triggers the hardware sweep down. x is period (0 - 7) and y is the shift value (1 - 7).
+
+
+ This effect is only available on the 2A03 pulse channels.
+ + Pxx - Fine pitch
+
Sets the fine pitch in xx pitch units. 80 means in tune.
++ + Qxy - Note slide up
+
Triggers a targeted note slide up. x is the speed and y is the number of semitones above the current one to slide to.
++ + Rxy - Note slide down
+
Triggers a targeted note slide down. x is the speed and y is the number of semitones below the current one to slide to.
++ + Sxx - Delayed cut
+
Cuts the active note after xx number of ticks.
++ + Vxx - Timbre control
+
This effect controls the duty period of the pulse channels and noise mode of the noise channel.
+ On N163 it can be used to select a wave.
+ Valid values are:
+
-
+
- 2A03/MMC5 pulse channels: 00 - 03 +
- Noise channel: 00 - 01 +
- VRC6 pulse channels: 00 - 07 +
- N163 channels: 00 - 0F +
+ + Wxx - Pitch
+
Overrides the DPCM pitch setting in the instrument editor. Valid range: 00 - 0F.
++ + Xxx - Retrigger
+
Retriggers the DPCM sample with the duration of xx ticks.
++ + Yxx - Sample offset
+
Adds an offset to the start of the sample. Each step is multiplied by 64 bytes due to hardware limitations.
++ + Zxx - Delta counter
+
Directly controls the DPCM delta counter. This can be used to control the amplitude of the triangle, + noise and DPCM channels due to the non-linear mixing of audio signals. Valid range: 00 - 7F
++ + Hxx - Modulation depth
+
Controls the modulation depth of the FDS frequency modulator. Valid range: 00 - 3F.
++ + Ixx - Modulation speed, high
+
Controls the modulation speed of the FDS frequency modulator. This effect affects the high part of the frequency setting. + Valid range: 00 - 0F.
++ + Jxx - Modulation speed, low
+
Controls the modulation speed of the FDS frequency modulator. This effect affects the low part of the frequency setting. + Valid range: 00 - FF.
++ +
+ + + + diff --git a/hlp/export_wave.htm b/hlp/export_wave.htm new file mode 100644 index 000000000..6a55b1dfb --- /dev/null +++ b/hlp/export_wave.htm @@ -0,0 +1,19 @@ + + + +
+ +
+ This feature allows FTM modules to be exported to wave files. +
+ ++ + + + diff --git a/hlp/faq.htm b/hlp/faq.htm new file mode 100644 index 000000000..605d04dd5 --- /dev/null +++ b/hlp/faq.htm @@ -0,0 +1,150 @@ + + + +
+ +
+ This is a copy of the FAQ on the wiki. The online version might be more + up to date.
+ ++ Module
+
+ Q: So... How do I get started?
+ A: The first thing to do would be to create an instrument. On the
+ top-right corner of the screen you will see a large empty black box. Click the
+ "New Instrument" button below that. Now double-click your new instrument, and
+ start playing around with it (starting with volume obviously) until you get a
+ sound that you're satisfied with. Then you can start laying down some notes, and
+ away you go!
+
+ Q: How do I add a sound chip like MMC5 or VRC6 to my module?
+ A: Simply open Module>Module Properties. There you will find an Expansion
+ Chip menu where you can choose from one of the
+ available sound chips.
+
+ Q: How do I create instruments for them? I can't find the option to
+ create a VRC6
+ instrument!
+
+ A: To create an instrument for a specific chip, the cursor should be
+ focused on one of channels of the chip in question, because every chip has its
+ own type of instrument and you cannot, for instance, use a 2A03 instrument on a
+ VRC6 square channel.
+
+
+ Editing
+
+ Q: I can't find key for stopping note (dash symbol in the pattern).
+ I've checked 'Shortcuts' in 'Configuration', and haven't found anything similar.
+ A: The key is definable, it is in 'Configuration', 'General',
+ bottom-right corner (frame titled 'Keys'). If you have problems with redefining
+ the key, you may need to add the Standard English keyboard layout using your
+ operating system's regional and language options.
+
+ Q: How do I write triplets?
+
+ A: There are several valid ways to insert triplets in your module, but
+ one of the most common ones is to use the Gxx
+ command. If your module's tempo and speed are set to 150 and 6, respectively,
+ then you can use G02 and G04 on your triplet's second and third
+ notes, and you will get perfect triplets. Bear in mind that if you are using a
+ different tempo, different values will be required, so mess around with that
+ until you get the sound you like.
+
+ Q: How to make patterns with different length?
+
+ A: All the patterns have the same length (defined by the "Rows" field),
+ however you can make one pattern shorter using effect Dxx.
+
+ Q: How do I stop my song, as opposed to letting it loop all the time?
+ A: Use the Cxx
+ command at the very end of your module to stop it dead. xx does nothing;
+ use zeros.
+
+ Instruments
+
+ Q: How to load instrument file (*.fti)?
+
+ A: There are five buttons under the instruments list - New, Delete, Open,
+ Save, Editor. Version 0.3.0 has some problems with instruments loading under
+ Windows 7, they could not be saved or loaded from arbitrary folder.
+
+ Q: I've made one instrument, and when I'm trying to make another,
+ first one changes as well.
+
+ A: You should select new 'Sequence' for new instrument. It could be done
+ by clicking 'Select next empty slot' button.
+
+ Q: I'm having difficulty getting any sound out of my custom VRC7
+ instruments. Help!
+
+ A: The first thing to do if you want sound is to increase the attack on
+ the carrier. Then you can mess around with the settings until you get something
+ that you are pleased with.
+
+ Q: My VRC6 sawtooth wave sounds all wrong! What did I do?!
+
+ A: Make sure you didn't accidentally set the duty cycle to 1 in the
+ instrument settings or effect column. This is an intentional feature to distort
+ the sawtooth wave.
+
+ Troubleshooting
+
+ Q: I have problem with FamiTracker under Windows Vista x64 or Windows
+ 7, the sound is stuttering.
+
+ A: Try to update sound card drivers.
+
+ Q: I get sound alright, but it's constantly clicking.
+
+ A: The buffer length is too short. Try adjusting it in the "Sound" tab in
+ File>Configuration.
+
+ Q: I tried opening a module in FamiTracker, but it gives me an error
+ message!
+
+ A: Most likely you are attempting to open a module from a newer version
+ into an old version of FamiTracker (occasionally the error happens the other way
+ around: trying to open an older file in a new version). Download the latest
+ stable release (or, if you already have that, the newest beta), and try opening
+ the file in it. If the problem persists, report your problem on the
+
+ Famitracker forums.
+
+ + + + diff --git a/hlp/fds.htm b/hlp/fds.htm new file mode 100644 index 000000000..593e1cc56 --- /dev/null +++ b/hlp/fds.htm @@ -0,0 +1,70 @@ + + + +
+ +
About
+ ++ This is a single channel chip used in the Famicom Disk System hardware by + Nintendo. It was an external disk drive unit available for + Famicom, games was distributed on disks instead of carts.
+ ++ The channel uses a 64-step customizable waveform and has a simple frequency + modulator.
+ ++
Instruments
+ +
+ 
Wave editor
+ ++ The instrument editor contains a wave editor, the wave is 64 + steps long and the amplitude is 64 steps.
+ ++ Usage: Left-click to change each sample, middle-click to draw a + line and right-click to switch between line/dot mode. A few presets are also + available.
+ ++ Use copy/paste wave to copy a MML-string of the wave to/from the + clipboard.
+ +Modulator editor
+ ++ The rest of the controls belongs to the frequency modulator: + rate (0 - 4095), depth (0 - 63) and delay (0 - 255) + after a note is triggered can be set. + (This has been copied straight from MCK).
+ ++ The big box is the modulation table, where each box tells how much to add or + subtract from the frequency. Each value is + used twice by the modulator unit, and the frequency is automatically reset each time end + is reached. Yellow = 0, green above = +1, +2, +4, green below = -1, -2, -4 and blue + is reset to initial frequency. Use copy/paste table to copy and + MML-string of the table to/from the clipboard.
+ +
+ 
+ There is also a tab with envelopes for volume, arpeggio & pitch.
+ ++ + + + diff --git a/hlp/gpl.txt b/hlp/gpl.txt new file mode 100644 index 000000000..3912109b5 --- /dev/null +++ b/hlp/gpl.txt @@ -0,0 +1,340 @@ + GNU GENERAL PUBLIC LICENSE + Version 2, June 1991 + + Copyright (C) 1989, 1991 Free Software Foundation, Inc. + 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Library General Public License instead.) You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + + We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software. + + Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations. + + Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all. + + The precise terms and conditions for copying, distribution and +modification follow. + + GNU GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + + 1. You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program. + +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee. + + 2. You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) You must cause the modified files to carry prominent notices + stating that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in + whole or in part contains or is derived from the Program or any + part thereof, to be licensed as a whole at no charge to all third + parties under the terms of this License. + + c) If the modified program normally reads commands interactively + when run, you must cause it, when started running for such + interactive use in the most ordinary way, to print or display an + announcement including an appropriate copyright notice and a + notice that there is no warranty (or else, saying that you provide + a warranty) and that users may redistribute the program under + these conditions, and telling the user how to view a copy of this + License. (Exception: if the Program itself is interactive but + does not normally print such an announcement, your work based on + the Program is not required to print an announcement.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. + +In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable + source code, which must be distributed under the terms of Sections + 1 and 2 above on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three + years, to give any third party, for a charge no more than your + cost of physically performing source distribution, a complete + machine-readable copy of the corresponding source code, to be + distributed under the terms of Sections 1 and 2 above on a medium + customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer + to distribute corresponding source code. (This alternative is + allowed only for noncommercial distribution and only if you + received the program in object code or executable form with such + an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. + +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. + + 4. You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance. + + 5. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + + 6. Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + + 7. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 8. If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + + 9. The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any +later version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation. + + 10. If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally. + + NO WARRANTY + + 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION. + + 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + +
S_cMBY_&C6UeB;#$X`CKxP89dR^j2Cy?j?k|{XgM;0Kc6kL1L7$Ca<
z2sK)zOO!%D)3N3IQ0MpBb;dxw)*YZOZ8~)9Aa2=ds8gqYA9U>2vtxHnox1nz+#Rf{
zSF;W(6nc050P54Fr&8apJ@HZB$OoSE?bfqzw_Z>`^h23m@7KL||L%QE>I;TVDD=Xq
z#q(BIEfHC@L{zmBvDHefsa9fLwGx|Zl-OFM_|6(d_tq@BuU656wTd3CRrGkRq9T-`kn^BaA&{
zDU3qNuKu%3Mb7BJ#fY#Lg=-}WN=nYtzpD&@Dm=%3lzULm;*jCp&4_77e;gkq6%@~_
zJ&Qp{d9Z>Mgu-X*ALZd!VIG0l-HY=y-B%8QBYl0HC4KVHP*d^zbG9#pY3C