=== f l e x ======================================================== ======================================================== t r a x === F L E X T R A X version 0.9 a New Beat production http://home.swipnet.se/newbeat/ newbeat@telia.com -------------------------------------------------------- credits --- Programming: -------------------------- Thomas Bergstr”m Additional Programming: -------------------------- Daniel Hedberg Odd Skancke Graphics and design: -------------------------- Thomas Bergstr”m Daniel Hedberg (intro picture) Demo tunes: -------------------------- Thomas Bergstr”m Nils Feske Documentation: -------------------------- Thomas Bergstr”m Daniel Hedberg ================================================= september 2000 === CONTENTS ------------------------------------------------------- flextrax --- 1 INTRODUCTION 1.1 System Requirements 1.2 Compatibility 1.3 Distribution 2 OVERVIEW 2.1 Preface 2.2 Overview 3 DISC OPERATIONS 3.1 Load module 3.2 Save module 3.3 Load sample 3.4 Save sample 4 PATTERN BLOCK OPERATIONS 4.1 Mark 4.2 Copy 4.3 Paste 4.4 Paste over 4.5 Paste under 4.6 Clear 5 THE SAMPLE EDITOR 5.1 The sample window 5.2 Block operations 5.3 Sample manipulation operations 6 REAL-TIME EFFECTS 6.1 Reverb 6.2 Delay 7 OPTIONS 7.1 Keyboard options 7.2 Mouse buttons 7.3 Interface colours 7.4 Save options 8 KEYBOARD CONTROLS 8.1 The alphanumeric keyboard 8.2 The numeric keyboard 8.3 Keys in edit-mode 8.4 Function keys 9 HOW TO CONTACT NEW BEAT 10 FINAL THANKS! 1 INTRODUCTION ------------------------------------------------------- flextrax --- 1.1 System Requirements FlexTrax will run on any Atari Falcon030 compatible computer equipped with at least 4Mb of memory and a VGA or RGB monitor. 1.2 Compatibility FlexTrax has been tested on many different hardware configurations but as the number of possible configurations are very large we have no possibility to test them all. If you are the owner of a Falcon030 computer equipped with any hardware accelerator or add-ons that you suspect are causing trouble, please contact us. When using screen enhancers such as Screen Blaster to increase the screen resolution, more system memory is consumed which directly affects the program. Users with only 4Mb of RAM should disable the screen enhancer to free as much memory as possible. 1.3 Distribution This version of FlexTrax is freeware. It may only be copied and passed on freely if it is left unchanged and contains all relevant files. Commercial sale of FlexTrax is strictly prohibited. 2 OVERVIEW ------------------------------------------------------- flextrax --- 2.1 Preface After more than one year of work, a new version of FlexTrax is finally ready. There are too many changes since v0.5 to list all of them in detail. FlexTrax v0.9 should almost be considered as a complete new application. Many of the old functions have been improved and several new ones included. Although major changes to the graphical interface have been made, it will hopefully not be too hard to get used to. 2.2 Overview FlexTrax is a soundtracker for Atari Falcon030 compatible computers. It features a user-friendly graphical interface in high-resolution (640x480) with a built in sound sample editor. Version 0.9 has support for both the AVR and WAV sample formats and the sample editor has been greatly improved. FlexTrax supports the standard MOD file format (up to eight channels) for compatibility reasons but also features a new enhanced module format FLX. The FLX format is an extended version of the standard MOD file format with support for real-time sound effects like reverb and delay. 3 DISC OPERATIONS ------------------------------------------------------- flextrax --- 3.1 Load module [F1] To load a module, click on the "LOAD MODULE" button in the upper left part of the screen. Only the .MOD and .FLX module file formats are supported. A new feature as of FlexTrax v0.9 is the possibility to combine channels from two or more modules. Lock the channels you want to keep and load a new module. Only the unlocked channels will now be loaded and replaced. 3.2 Save module [F2] Click on the "SAVE MODULE" button in the upper left part of the screen. The module will be saved in the format corresponding to the active FlexTrax mode. The extended .FLX format if in FlexTrax mode and .MOD format if in ProTracker mode. The reason for this is that some module players do not like the .FLX format. 3.3 Load sample [F3] To load a module, click on the "LOAD SAMPLE" button in the upper left part of the screen. Any file can be loaded and used as a sample, but only the .AVR and .WAV formats will be recognised and properly interpreted by FlexTrax. 3.4 Save sample [F4] Click on the "SAVE SAMPLE" button in the upper left part of the screen to save the selected sample. Samples are always saved as 8bit mono .AVR. 4 PATTERN BLOCK OPERATIONS ------------------------------------------------------- flextrax --- 4.1 Mark (pattern block) [CONTROL] + [TAB] Marking a pattern block can be done by using the mouse or the keyboard. If you use the mouse, move the cursor to the pattern area you want to mark. Hold down the left button and move the cursor in any direction to mark the block. Release the mouse button when finished. When using the keyboard there are four different ways to mark a block: * One channel from the current line and down. * All channels from current line and down. * Whole channel. * Whole pattern. You can choose the type of marking by pressing the [TAB] key repeatedly while holding down the [CONTROL] key. 4.2 Copy (pattern block) [CONTROL] + [C] A Pattern block can be copied by clicking on the "COPY" button in the "P-BLOCK..." section (to the right of the pattern window) or by pressing the [C] key while holding down the [CONTROL] key on the keyboard. 4.3 Paste (pattern block) [CONTROL] + [V] Paste a pattern block by clicking on the "PASTE" button in the "P-BLOCK..." section (to the right of the pattern window) or by pressing the [V] while holding down the [CONTROL] key on the keyboard. 4.4 Paste over (pattern block) Only used pattern lines in the block are pasted. Example: Block: Destination: Result: C-2 12 A05 B-3 1 201 C-2 12 A05 --- --- B-3 1 201 B-3 1 201 C-2 12 A05 --- --- C-2 12 A05 --- --- --- --- --- --- C-2 12 A05 B-3 1 201 C-2 12 A05 --- --- --- --- --- -- --- --- --- B-3 1 201 B-3 1 201 C-2 12 A05 --- --- C-2 12 A05 4.5 Paste under (pattern block) The paste under operation replaces only non-used destination pattern lines. Example: Block: Destination: Result: C-2 12 A05 B-3 1 201 B-3 1 201 --- --- B-3 1 201 B-3 1 201 C-2 12 A05 --- --- C-2 12 A05 --- --- --- --- --- --- C-2 12 A05 B-3 1 201 B-3 1 201 --- --- --- --- --- -- --- --- --- B-3 1 201 B-3 1 201 C-2 12 A05 --- --- C-2 12 A05 4.6 Clear (pattern block) [CONTROL] + [D] To clear a part of a pattern just mark (see 4.1 for more information on how to mark a pattern block) what you want to clear and click on the "CLEAR" button in the "BLOCK..." section or press [D] key while holding down the [CONTROL] key on the keyboard. 5 THE SAMPLE EDITOR ------------------------------------------------------- flextrax --- 5.1 The sample window The sample window is used to show the sample data. In the middle of the window there is a red line. Left click on the mouse above this line to zoom in the sample, right click to zoom out. To scroll the contents of the window, move the mouse cursor below the red line and hold the left mouse button while moving the mouse. Scrolling is only possible when the sample is zoomed in one or more steps. 5.2 Block operations Mark: There exist three different modes that control the behaviour of the mark sample operation. These mode buttons are located to the left of the sample window in the "MODE" section. The first mode is "ALL". In this mode the whole sample will be marked. The second mode is "o TO o" (where the first ring is orange and the other one blue). In this mode the sample loop points is used to mark a part of the sample. The third mode is "o TO o" where both rings are grey. Use this mode if you want to mark a part of the sample without changing the loop points. The last two modes uses bars to set the start and end positions of the block. The positions of the bars is also displayed as numbers. The value of the sample loop points is located in the "SAMPLE" section under "LOOP START" and "LOOP LENGTH". The value of the bars in the last mode can be found above the sample window ("BLOCK START" and "BLOCK LENGTH"). Besides moving the bars graphically using the mouse, they can be moved by clicking on the "+" and "-" buttons. Copy: Makes a copy of the marked sample for later use in paste, add ,insert and A.M. Cut: Cuts out the marked sample and saves the sample chunk for later use in paste, add, insert and A.M. Paste: To be able to paste a sample block you must first copy or cut the marked part of the sample. The block will be pasted into the destination position (see below). Add: Works like the paste operation, but instead of overwriting the destination data the source and destination data is mixed. Insert: Inserts the sample block between the data before and after the destination position. The destination position is defined by the boundaries set by the MODE buttons. In "ALL" mode the destination position is the beginning of the sample and for the other two modes the "START" bar is used for the destination position. 5.3 Sample manipulation operations All the following operations applies directly to the marked sample boundaries. Normalise: Maximises the amplitude of the marked sample. Clear: Clears marked sample data. Negate: Inverts marked sample data. Reverse: Reverses marked sample data. Amplify: Left click with the mouse on the "+" button to amplify the sample, and the "-" button to lower the amplitude. The amplify operator can be used to distort samples. Fade: Fades in/out the marked sample. Can be used to shorten drums, make soft strings from lead sounds, etc. Re-sample: Use this operator to change the frequency (or detune) the sample or parts of it. Click on the "+" and "-" buttons with the mouse to set the note you want to detune to. A zero equals the note C-2 (no change), '1' equals C#2 and '2' equals D-2. The same goes for negative values, '-1' equals B-1 and so on. The sample can be changed maximum one octave up/down. Click on the DO button to start the re-sampling. Please note that when a sample is being re-sampled the sample size will change. Remember to update the sample length and loop position (if used) with the new values. You should also be aware of that the sample size is limited to 64kb. Be careful or you will loose sample data if the sample grows too large. Y-offset: Some samples may have a incorrect zero point and this operation can be used to correct this. The zero point is changed by clicking the "+" and "-" buttons. The "SIGN" button will change the sign of the sample as some samples ranges from 0-255 and some formats use -128 to +128. The sign of a sample is automatically converted when using the .AVR and .WAV file formats but as you can load any file and use as a sample it is convenient to be able to do this manually. 6 REAL-TIME EFFECTS ------------------------------------------------------- flextrax --- 6.1 Reverb The reverb effect has two parameters: - DECAY: Determines the length of the reverb effect. A small value will make the effect fade out quickly while a large value will make it fade out slowly. - LEVEL: Main reverb volume. Applies to all samples in use. 6.2 Delay The delay effect has four parameters: - DECAY: Determines the delay effect's fade out time. - LEVEL: Main volume of the echo. - TIME: Time between every echo reflection. - PP: PP stand for "Ping Pong" and determines the echo reflection between the left and right channel. If set to zero the time difference between the channels will be none, resulting in a mono delay. Setting PP to the maximum value will result in a "Ping Pong" delay. The difference between the left and right channel will be half the value of the "TIME" parameter. 7 OPTIONS ------------------------------------------------------- flextrax --- 7.1 Keyboard The keyboard option allows you to customise the key repetition behaviour of the keyboard. It has two parameters: - WAIT: The delay before key repetition is activated. - SPEED: The speed of the key repetition. 7.2 Mouse The mouse option allows you to customise the mouse button repetition behaviour of the mouse. It has two parameters: - WAIT: The delay before button repetition is activated. - SPEED: The speed of the button repetition. 7.3 Interface colour FlexTrax has 15 colour set-ups, click on the "+" and "-" buttons to choose between them. 7.4 Save options Allows you to save the current configuration of FlexTrax. The following is saved: - Keyboard configuration - Mouse configuration - Interface colour - Sample and module paths - Real-time effect parameters 8 KEYBOARD CONTROLS ------------------------------------------------------- flextrax --- 8.1 The alphanumeric keyboard [ALT] Play song. [CAPSLOCK] Play pattern. [SPACE BAR] Stop song, toggle edit On/Off. [TAB] Move the pattern edit cursor to the next channel. +[SHIFT] Move the pattern edit cursor to the previous channel. +[CONTROL] Mark a pattern block. [CONTROL] While playing, only 1 channel is monitored. +[C] Copy a marked pattern block. +[V] Paste a marked pattern block. +[D] Clear a marked pattern block. [ESC] Unmark a block. 8.2 The numeric keyboard [(] Pattern (-) [)] Pattern (+) [/] Position (-) [*] Position (+) [-] Sample (-) [+] Sample (+) [0] Jump to line (0) [1] Jump to line (10) [2] Jump to line (20) [3] Jump to line (30) [4] Steprate (-) [5] Steprate (set to 1) [6] Steprate (+) [7] Mask Note (On/Off) [8] Mask Sample # (On/Off) [9] Mask Command (On/Off) [.] Set line (X) [ENTER] Jump to line (X) 8.3 Keys used in edit-mode [TAB] Move the pattern edit cursor to the next channel. +[SHIFT] Move the pattern edit cursor to the previous channel. +[CONTROL] Mark a pattern block. [LEFT] Move to next edit section (All, sample #, command). [RIGHT] Move to next edit section (All, sample #, command). [UP] Backward one pattern line. [DOWN] Forward one pattern line. [BACKSPACE] Clear the current chunk. [INSERT] Insert a blank chunk at the current position. [DELETE] Delete the chunk at the current position. [CLRHOME] Jump to first pattern line. 8.4 Function keys [F1] Load module [F2] Save module [F3] Load sample [F4] Save sample [F5] Set keyboard zone (low) [F6] Set keyboard zone (hi) [F7] Set keyboard zone (all) [F8] Set 4 channels mode and reset muted channels [F9] Set 6 channels mode and reset muted channels [F10] Set 8 channels mode and reset muted channels 9 HOW TO CONTACT NEW BEAT ------------------------------------------------------- flextrax --- Feel free to contact us for any reason. Suggestions how to improve FlexTrax and bug reports are welcome! Mail: Thomas Bergström Urbergsterassen 16 802 62 GÄVLE SWEDEN E-Mail: newbeat@telia.com newbeat@atari.org WWW: http://home.swipnet.se/newbeat/ http://newbeat.atari.org 10 FINAL THANKS ------------------------------------------------------- flextrax --- Finally we would like to thank all people who have mailed us with ideas, suggestions and bug-reports. Special thanks goes to: Nils Feske - for great support, ideas, modules, bug-testing and your patience. It means a lot! Odd Skancke - for programcode and help with the fileselector calls.