home *** CD-ROM | disk | FTP | other *** search
/ Large Pack of OldSkool DOS MOD Trackers / far100.zip / FAR.DOC < prev    next >
Text File  |  1994-08-04  |  59KB  |  1,373 lines

  1.  
  2.      ╓─────────────────────────────────────────────────────────────╖
  3.      ║                                          ╓          ╖
  4.      ╟───  ╓────╖  ╖────╖  ╓────╖  ╖────╖  ╓────║  ╓────╖  ║  ╓────╖
  5.      ║     ╓─── ║  ║       ╓─── ║  ║    ║  ║    ║  ║    ║  ║  ║ ───╜
  6.      ║     ║    ║  ║       ║    ║  ║    ║  ║    ║  ║    ║  ║  ║    ║
  7.      ╜     ╙────╜  ╜       ╙────╜  ╜    ╙  ╙────╙  ╙────╜  ╙  ╙────╜
  8.      ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  9.                                                ──────══════ COMPOSER
  10.               ╓                      ╥
  11.               ║         ─╥─     ╖    ║      ╓──╖        ─╥─
  12.            ╓──║ ╥ ╓──╖ ╥ ║ ╓──╖ ║    ║ ╖──╖ ║─  ╥ ╖──╖ ╥ ║ ╖  ╓
  13.            ╙──╜ ╨ ╙──║ ╨ ╙ ╙──╙ ╙    ╙ ╜  ╙ ╙   ╨ ╜  ╙ ╨ ╙ ╙──╢
  14.                      ╜                                        ╜  94!
  15.      ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  16.      Composer Coded by Daniel Potter
  17.      Documentation and Music by Ryan Cramer
  18.  
  19.  
  20. ABOUT THESE DOCS
  21. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  22. These docs are old and out of date. However, they are still very efficient
  23. at describing how the program works. I hope you will find it useful. To see
  24. the newest info, look under "ALPHTEST.TXT", "UPDATES.TXT", and "KEYLIST.TXT".
  25.  
  26.                                                                Daniel
  27.  
  28. ABOUT THE FAR COMPOSER
  29. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  30.  
  31. The Farandole composer is a 16 channel digital composer for the Gravis
  32. Ultrasound card (referred to as GUS throughout this documentation). The
  33. composer is styled after Tran/Renaissance's "Composer 669". We decided
  34. to style after Composer 669 because we felt that it had the most usable
  35. environment of all of the composers that we had tried. We also wanted to
  36. create a "familiar" environment, so that people would not have a hard
  37. time learning the new composer. The Farandole composer uses most of the
  38. same commands as Composer 669, but we have added and taken away a few
  39. things here and there. If you read the Composer 669 documentation, most
  40. of the stuff that applies there also applies to the Far composer.
  41.  
  42. Here are some of the features that we feel make Farandole such a fantastic
  43. composer:
  44.  
  45. 1) 16 digital channels (stereo!) with no mixing on the GUS (produces
  46.    fantastic sound!)
  47. 2) A familiar environment (similar to composer 669) which shows all 16
  48.    channels on the screen at once! (132 column text mode)
  49. 3) Panning of each channel to 16 different positions which are
  50.    selectable during playtime or during composition.
  51. 4) Fine tempo ranges so that you can get the exact tempo that you want.
  52. 5) Support for 8 bit and 16 bit samples.
  53. 6) Very flexible instrument and order edit screens.
  54. 7) Loads FAR, 669, MOD, STM, MTM formats.
  55. 8) Can use a special sample format (called FSM) that saves the loop
  56.    start, loop end, and 32 character name with the sample. Long filenames are
  57.    fully handled.
  58. 9) A HUGE pattern edit screen so that you can see whats going on!
  59.    (unlike some other composers).
  60.  
  61.  
  62. REQUiREMENTS
  63. ▀▀▀▀▀▀▀▀▀▀▀▀
  64.  
  65. In order to use the Farandole composer, you must be outfitted with the
  66. following hardware:
  67.  
  68. 1) A 386 or better processor
  69. 2) A Gravis UltraSound (GUS) sound card with 1 meg of RAM.
  70.    (note also that a GUS with 256k will also work; however, it's not
  71.    recommended.
  72. 3) A VGA card
  73. 4) A high quality stereo!!! :)
  74.  
  75. In addition, you must *NOT* have any network drivers loaded! These have a
  76. bad habit of locking things up, right along withQEMM and other memory
  77. managers, such as Windoze (not fully tested). It might work under these; who
  78. knows. But we make no guarantees.
  79.  
  80.  
  81. DiSCLAiMER
  82. ▀▀▀▀▀▀▀▀▀▀
  83. The author makes no warranty of any kind, express or implied, including
  84. without limitation, any warranties of merchantability and/or fitness
  85. for a particular purpose.  The author will not be liable for any damages,
  86. whether direct, indirect, special or consequential arising from a failure
  87. of this program to operate in the manner desired by the user.  The author
  88. will not be liable for any damage to data or property which may be caused
  89. directly or indirectly by use of the program.
  90.  
  91. When trying new software, always backup any and all important files on
  92. your system.
  93.  
  94.  
  95. COPYRiGHT
  96. ▀▀▀▀▀▀▀▀▀
  97. Farandole Composer is distributed under the Shareware concept.  You
  98. are granted a limited license to use and share it under the following
  99. conditions:
  100.  
  101. o  Farandole Composer is not distributed in a modified form.
  102. o  No fee is charged for Farandole Composer itself.
  103. o  All references to the copyright and author are retained.
  104.  
  105. There is a small fee for this program.  Please read the registration
  106. section.
  107.  
  108. This program and ALL FILES included in the archive are:
  109. Copyright (C) 1993, Daniel Potter, ALL RIGHTS RESERVED.
  110.  
  111.  
  112. FiLES iNCLUDED iN THE ARCHiVE
  113. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  114. FAR.EXE      - Main executable for the FAR composer
  115. FAR.DOC      - Documentation for FAR, your reading it!
  116. FORMATS.DOC  - Complete format specs for the various formats used in FAR
  117. SAMPLE1.FSM  - a sample instrument used in the tutorial
  118. SAMPLE2.FSM  - a sample instrument used in the tutorial
  119. THUNDDRM.FAR - A song to demonstrate the FAR composer
  120. KEYLIST.TXT  - Quick reference of all keys (you should print this)
  121. README.1ST   - Important information that you should have read already!
  122. FAR_REG.DOC  - Registration form
  123. DIF.NFO      - Info file about Digital Infinity
  124. FARLOAD.CPP  - Example C++ code that loads and saves FAR files
  125. FAR_UPD.DOC  - Registration update info
  126. MUSICON.EXE  - Ad for Music Connectio BBS - AdLib FM SUPPORT
  127. PROGAD2.EXE  - Ad for Programmer's Oasis BBS - GUS DIGITAL SUPPORT
  128.  
  129. *Note: some extra files may have been included. Check FILES.TXT for an
  130.  updated list.
  131.  
  132. Note that we will make these k00l BBS ads for you for a price. Call
  133. Programmer's Oasis for pricing, availability, and how busy we are. Please
  134. don't page with the reason 'hey', use something like 'make me a bbs ad'.
  135.  
  136. If you are missing any of the above files, please download an up to date
  137. copy from Programmer's Oasis or Data Connection BBS (numbers are listed
  138. at the end of this documentation).
  139.  
  140.  
  141. HOW TO USE THE COMPOSER
  142. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  143. (a tutorial for those that have not had experience with trackers).
  144.  
  145. The Farandole composer uses the standard tracker style edit screen seen
  146. on most composers today. To use this style of composer, you simply move
  147. through the track screen and place the notes where you want them. It may
  148. take awhile to understand the concepts at first, but be patient and stay
  149. with it! :)
  150.  
  151. iMPORTANT TERMS
  152. ---------------
  153. Here are some terms used throughout this document that you should
  154. understand:
  155.  
  156. Sample  - a file that represents an instrument, sample and instrument are
  157.           used interchangably. A sample is just a bunch of bytes that has
  158.           data which represents a waveform.
  159. Pattern - One of the screens on the Far composer, a group of 16
  160.           channels, and 256 notes per channel. Usually these are 64 notes
  161.           long. As soon as you go into the composer, you will be looking at
  162.           a pattern, so this one should be pretty obvious.
  163. Channel - A digital output on the GUS (the GUS has 32 of them). Each
  164.           channel is represented by a column in the pattern edit screen.
  165. Track   - Same as a channel, this is just a single piece of a pattern,
  166.           there are 16 of these in a pattern.
  167. Tempo   - the speed at which your pattern is playing.
  168.  
  169.  
  170. HEXiDECiMAL NOTATiON
  171. --------------------
  172. First off, all of the numbers in Farandole composer are represented in
  173. hexidecimal notation. This makes the composer much more flexible, you
  174. will find that most composers use this notation. It is very easy to
  175. understand, but if you don't already know them, take a look at the
  176. diagram below:
  177.  
  178.   decimal notation: 0  1  2  3  4  5  6  7  8  9 10 11 12 13 14 15
  179.   ------------------+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  180.   Hexidecimal     : 0  1  2  3  4  5  6  7  8  9  A  B  C  D  E  F
  181.  
  182. So... as you can see, Hex and decimal are the same in numbers 0 through
  183. 9, but once you hit 10, hexidecimal starts at A, and then continues on
  184. till F which means "15" in decimal. If you have a hard time getting used
  185. to this, don't worry, because it comes very fast. You might want to
  186. print out this section for reference while your working in the composer
  187. if you can't remember hexidecimal notation right away.
  188.  
  189. The advantage of using this notation is that a range of 0 through 15 can
  190. be represented by a single digit. 10 takes two digits, while A only
  191. takes 1 digit! This makes the composer much more flexible.
  192.  
  193. Its a great way to represent numbers, and you will find that it is the
  194. preferred number system used by programmers. There are other cool ways
  195. to represent numbers, such as base 36 where numbers range from 0-9 then
  196. go from A-Z. 36 digits can be represented with a single digit! Those are
  197. called Meganums, but don't worry, we don't use those in the Farandole
  198. composer :)
  199.  
  200. It is necessary to understand hexidecimal because all numbers in the Far
  201. composer use this notation. When you change the loop start or loop end
  202. of a sample, it will be in hexidecimal. Your main volume ranges from
  203. 0-F, with F being the loudest. When you use special commands (discussed
  204. later) the range will be from 0-F. There are many other examples that I
  205. could mention, but I think you get the point.
  206.  
  207. THE SAMPLE EDiT SCREEN
  208. ----------------------
  209. The sample edit screen (selected by F1). In this screen, you can:
  210.  
  211.    a. load samples
  212.    b. edit the sample loop start, and sample loop end
  213.    c. enter the sample editor (not yet complete)
  214.    d. toggle between 8 bit and 16 bit samples - NOTE that this does NOT
  215.       convert the samples between the two formats, it merely tells Farandole
  216.       what type of sample it is.
  217.  
  218. To load samples, you press the spacebar, and then you will be brought up
  219. with a directory. Then you just highlight the sample that you want and
  220. it will be loaded. If you load something that isn't a sample, it will
  221. sound like garbage. You can use any sample that you would for MODs or
  222. 669s with the Far composer.
  223.  
  224. Once you have a sample loaded, you can press any key on the keyboard,
  225. and you will hear a note corresponding to the key hit (discussed later).
  226. If you are not happy with the sample, you can just hit the spacebar
  227. again and load another sample. Once your happy with the sample, you can
  228. load another by cursoring down (or up) and hitting the spacebar to load
  229. a sample into any one of the 256 samples positions. This is kind of hard
  230. to explain, but its an easy concept, it is best demonstrated (like most
  231. things) by going in the composer and trying it for yourself. It will
  232. probably be self-explanatory once you try it :)
  233.  
  234. The sample that is currently highlighted is always the "active" sample,
  235. and it will be used when you enter notes into the pattern edit screen.
  236.  
  237. If you want a sample to continue playing, nonstop, you would set the
  238. sample loop start and loop end. The loop start is the offset in the
  239. sample at which the sample will start looping, and the loop end is the
  240. offset in the sample at which it will stop and continue back to the loop
  241. start. Please see the example song on how to do this. Most of the time,
  242. this loop start and loop end are best found through experimentation. I
  243. find that many good samples will have a loop start of zero, and a loop
  244. end of the sample length. Here's an example:
  245.  
  246. Lets say that the sample LEADGUIT.SAM was 12345 bytes long. To loop it,
  247. I would set the loop start at 0 and the loop end at 12345. Now this may
  248. or may not sound perfect to you, if it doesn't, then you can experiment
  249. with different numbers for the loop start and loop end until you get it
  250. right. This can take a long time to get it perfect, but you have another
  251. option. The Far composer also uses a special sample format called FSM
  252. (Far sample). You can create FSM samples by loading up another FAR, 669,
  253. or MOD into the far composer and hitting ALT-F on the sample that you
  254. want to save. Far composer will save this sample to disk, and it
  255. remembers the loop start and loop end so that you don't have to set them
  256. next time. I often load up different MODs and 669s, and rip looped
  257. samples out of those so that I don't have to worry about loop start and
  258. loop end later. You can also hit ALT-S which will save the sample in a
  259. "raw" format which can be used by other composers. This raw format does
  260. not save the sample loop start and loop end though. Samples saved in
  261. this format end with the extension "USM".
  262.  
  263. Another way that you may set the loop start and end is through the graphical
  264. sample editor. This is currently the only thing it's useful for unless you
  265. want to look at the pretty sound wave :). Once you have approximate values
  266. set in the graphical editor, you can then experiment.
  267.  
  268. To UNset the looping (make it NOT loop anymore) you would simply enter a
  269. value of FFFFF for the loop end. This tells Farandole that you don't want it
  270. to be looped.
  271.  
  272. Okay, now that you know what loop start and loop end are, here is how
  273. you set them in the sample edit screen:
  274.  
  275. "[" - Sets the loop start
  276. "]" - Sets the loop end
  277.  
  278. Once you hit those keys on a sample, you will be prompted to enter a
  279. number (in hex notation). You can abort by just hitting ESC and it will
  280. bring up the previous number.
  281.  
  282. Here are some other keys available in the sample edit screen:
  283.  
  284. DEL - Deletes the current sample, and moves all samples below it up.
  285. INS - Inserts a blank sample in the current position. This moves all
  286.       samples below it down one.
  287. .   - On the number pad - Deletes current sample without moving other samples
  288.       and advances to the next sample.
  289.  
  290. Be very careful with these commands because this adjusts the positions
  291. of the samples, and by adjusting these positions, the notes in your song
  292. could be pointing to the wrong samples! If this ever happens to you, its
  293. nothing to be concerned about because you can fix it just by repositioning
  294. the samples with INS and DEL. If you want to delete one sample, it's
  295. recommended that you use the . on the number pad.
  296.  
  297. ENTER - Edit the current sample name. You can change the name of a
  298.         sample to a filename if you want to save the sample to disk,
  299.         or you can put text in there or whatever you want! :) Remember
  300.         that if you save an FSM file, you may use names greater than 12
  301.         characters; the composer's file routines take care of it for you.
  302.  
  303. TAB   - Toggle between 8 bit and 16 bit samples. Most of the time you'll
  304.         want this set to 8 bit samples. If you are lucky enough to get
  305.         your hands on some 16 bit samples (CD quality) then you would
  306.         toggle this to switch it to 16. Note that you cannot load the
  307.         MIDI patch set files, they are 16 bit but they are in a
  308.         different format. If you want to load a patch from the MIDI patch
  309.         set, a utility called PAT2FSM is included (by CodeMan/Damage Inc.).
  310.         However, this feature will most likely be built in to the next
  311.         version.
  312.  
  313. ALT-E - This loads up the graphical sample editor. You set the loop
  314.         start and loop end in here and this shows you a waveform of the
  315.         sample. We are planning on adding more functions to the sample
  316.         editor in the future so that you can modify your samples. Currently
  317.         you may set the Repeat Start and End with your mouse on this screen.
  318.         However, since it is not completed, no exact documentation is provided
  319.         yet.
  320.  
  321. -     - Sets 'sticky volume' - use 0 on this to cancel sticky volume. A sticky
  322.         volume is one that stays with the instrument during the current edit
  323.         session (when you load another song, etc it's cancelled). This makes it
  324.         easier to make drum patterns, etc. To cancel the sticky volume effect
  325.         and use the 'Current Volume' setting, use a value of 0 when you set
  326.         this.
  327.  
  328. THE ORDER EDiT SCREEN
  329. ---------------------
  330. You get to the order edit screen by hitting F3.
  331.  
  332. The order edit screen is a small box in the upper right hand corner of
  333. the screen. Here's sort of what it looks like:
  334.  
  335.    00 00
  336.    01 00
  337.    02 00
  338.    03 00
  339.    04 00
  340.    05 00
  341.       
  342.     │  │
  343.     │  │
  344.     │ pattern
  345.     │
  346.    position
  347.  
  348. The numbers in the first column are constant, they are just labels and
  349. they correspond to the "position number". This is the order that the
  350. patterns play in, and so naturally position 00 plays before position 01!
  351. So, in the next column (2), the numbers can be changed, and they correspond
  352. to the "pattern" number to be played for the corresponding position. The above
  353. diagram just shows an "empty" order edit screen, but here is one as it might
  354. appear in a song:
  355.  
  356.    00 01
  357.    01 00
  358.    02 02
  359.    03 02
  360.    04 03
  361.    05 04
  362.  
  363. As you can see here, the song starts with pattern number 1, and then
  364. plays pattern 0 after that. Next, it plays pattern 2 twice, then pattern
  365. 3, and then pattern 4.
  366.  
  367. You can move through the order edit screen with your up and down keys to
  368. select the position. You change the corresponding pattern number with
  369. the "]" key.
  370.  
  371. Well.. that covers the order edit screen, now we move onto the pattern
  372. edit screen:
  373.  
  374. THE PATTERN EDiT SCREEN
  375. -----------------------
  376. Hmm.. well I can't give you an example of what the pattern edit screen
  377. looks like since it is 132 columns, and this is only 80 columns, so
  378. we're going to try something different. Print out this part of the
  379. documentation (or better yet, print out the whole thing), load up the
  380. Far composer, and read this as your looking at the composer screen.
  381.  
  382. Okay, your in the composer right now ...right? Beautiful isn't it :)
  383.  
  384. If when you tried to load the composer, it prompted you for the mode
  385. number, then Far could not detect which mode is 132x43x16 mode. In this
  386. case, your going to have to open up the documentation for your video
  387. card and see which mode number to use. You should find a table in the
  388. documentation that has a bunch of resolutions and mode numbers beside
  389. them. You will want to find the mode number corresponding to 132x43x16
  390. or 132x44x16 and type that in. If you type in the correct mode number
  391. and it still does not work, please get in contact with Daniel Potter on
  392. his BBS (number is listed later in the dox). Make sure that you enter the
  393. number in DECIMAL (not hexidecimal, as it's usually listed). If your video
  394. card does not have a 132x43x16 mode, then you will not be able to use the FAR
  395. composer with your current hardware. Remember also, that any mode that is
  396. 132 columns wide will work, although it will look rather interesting :)
  397.  
  398. Another way you can use the program is to override the detect options, or
  399. enter a mode number on the command line like so:
  400.  
  401. FAR /mXX  (where XX is the mode number. /m MUST BE LOWERCASE!)
  402. FAR /cCARD (where CARD is your video card) Here's a list of the video card
  403.  names supported (note that there is not a built in detect routine for some
  404.  of these). These MUST be typed in the same case as they are shown here:
  405.  
  406.  TRIDENT - Trident 8800 or greater              - mode 85
  407.  PARADISE- Paradise/Western Digital Compatible  - mode 84
  408.  ATI     - ATI SVGA                             - mode 51
  409.  CHIPS   - Chips and Tech SVGA                  - mode 97
  410.  GENOA   - Genoa SVGA                           - mode 99
  411.  TSENG   - TSeng Labs ET4000                    - mode 34
  412.  VIDEO7  - Video7/compatible                    - mode 66
  413.  CIRRUS  - Cirrus logic SVGA or compatible      - mode 84
  414.  ORCHID  - Orchid Faranheight SVGA              - mode 84
  415.  S3      - MOST S3 chipsets                     - mode 84
  416.  AST     - AST/Paradise SVGA                    - mode 84
  417.  
  418.  
  419. Most of the screen is taken up by the pattern edit screen. It consists
  420. of numbers on the left side (corresponding to the note number) and then
  421. 16 columns of tracks. The tracks are colored: light, dark, light, dark...
  422. so that you can distinguish them from one another.
  423.  
  424. Right off the bat, you probably notice that there is really a lot on the
  425. screen at once, and perhaps its even hard to read. Well, that is true,
  426. but its easy to get used to. Make sure that you've got your glasses on!
  427. Now... although this seems like a lot to have on the screen at once, its
  428. a great advantage because you can see ALL of the channels at once. I
  429. feel that this advantage far outweighs the disadvantage of having such
  430. small characters.
  431.  
  432. Okay, lets start figuring out what all of this stuff is. In the upper
  433. left hand corner of the screen, you'll see the sample edit screen. You
  434. can get to that by pressing F1. In the upper right hand corner of the
  435. screen, you'll see the order edit screen. You can get to that by
  436. pressing F3. To get back to the pattern edit screen, just hit F2. So,
  437. remember that F1, F2, F3 correspond to your main editing screens. Try
  438. that a few times to get the hang of it. Note that a bar of a lighter color
  439. appears next to the area you are currently working with.
  440.  
  441. Now, go back to the pattern edit screen. Note that the numbers on the
  442. left side of the pattern edit screen are the note positions. The pattern
  443. edit screen is bigger then what can fit on the screen, so hit your down
  444. arrow key until it starts scrolling. You will notice that it goes all
  445. the way to FF (255 decimal) lines. You can fit approximatly 20
  446. (32 decimal) lines in the screen at a time. Scroll down to position 3F
  447. and look at the far left of the screen, you should see a "B". This is
  448. the "breakpoint". This breakpoint is where the pattern ends. You can
  449. adjust the breakpoint to whereever you want it, but most of the time
  450. it will probably be at 3F. Most composers limit you to 3F notes per
  451. pattern, but Farandole can go up to FF, although I haven't actually
  452. tried it yet! :) You can set your breakpoint whereever you want it in
  453. the pattern. I'm not going to tell you how to do that quite yet,
  454. because its not very important for you to know if you are just
  455. learning how to use the composer. I just want to make sure that you
  456. know what a breakpoint is. All of the keys will be explained in the
  457. KEYLIST.TXT file.
  458.  
  459. Okay, now scroll back up to the top of the pattern (position 00). Then
  460. hit F1 to goto the sample edit screen. Once there, hit the space bar to
  461. load up a sample. Select the example sample file SAMPLE1.FSM. Once you've
  462. got that loaded, jump back down to the pattern edit screen (F2) and
  463. we're going to experiment a bit.
  464.  
  465. Look at the status line on the bottom of the screen, you'll notice that
  466. it has something which says "EDIT = ON". To toggle edit mode on or off,
  467. hit the TAB key. When edit mode is off, you will not be able to enter
  468. any notes into the pattern edit screen (for melody experimentation purposes).
  469. Note that sometimes it is easier to experiment with the entire instrument set
  470. when in the sample edit area.
  471.  
  472. Okay, now is a good time for me to tell you how the keyboard is setup.
  473. Here's a quick diagram:
  474.  
  475.             C#  D#      F#  G#  A#      C#  D#      F#  G#  A#
  476.          ┌─┬─┬─┬─┬──┬──┬─┬─┬─┬─┬─┬──┬──┬─┬─┬─┬──┬──┬─┬─┬─┬─┬─┬─┐
  477.          │ │ │ │ │  │  │ │ │ │ │ │  │  │ │ │ │  │  │ │ │ │ │ │ │
  478.          │ │ │ │ │  │  │ │ │ │ │ │  │  │ │ │ │  │  │ │ │ │ │ │ │
  479.          │ │S│ │D│  │  │G│ │H│ │J│  │  │2│ │3│  │  │5│ │6│ │7│ │
  480.          │ │ │ │ │  │  │ │ │ │ │ │  │  │ │ │ │  │  │ │ │ │ │ │ │
  481.          │ └┬┘ └┬┘  │  └┬┘ └┬┘ └┬┘  │  └┬┘ └┬┘  │  └┬┘ └┬┘ └┬┘ │
  482.          │  │   │   │   │   │   │   │   │   │   │   │   │   │  │
  483.          │Z │ X │ C │ V │ B │ N │ M │ Q │ W │ E │ R │ T │ Y │ U│
  484.          │  │   │   │   │   │   │   │   │   │   │   │   │   │  │
  485.          └──┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴──┘
  486.           C   D   E   F   G   A   B   C   D   E   F   G   A   B
  487.  
  488. btw: this diagram is from Tran's composer 669 docs.
  489.  
  490. Well, thats how its setup, this may or may not be of much help, but to
  491. explain: you have 2 octaves on the keyboard. The first takes up the top
  492. half of the screen, the second takes the lower half of the screen.
  493. Farandole actually has 5 octaves, but I will tell you how to change to
  494. them a little later.
  495.  
  496. Okay, since you're now in the pattern edit screen, try hitting a few keys,
  497. and you should get hear notes. Well, turn up your stereo a bit first so
  498. that you can hear it. note: F8 will stop the sound, you'll probably want
  499. to use this a bit as you're experimenting.
  500.  
  501. Hit a bunch of random notes, and watch them appear on the pattern
  502. screen. Use your left and right arrow keys to get into other channels
  503. so that you can fill up a bunch of channels with different notes. You
  504. will hear that the keys on your keyboard correspond to different notes
  505. as shown in the above diagram. Pretty cool eh?
  506.  
  507. Let me explain what these notes actually mean and what you can do with
  508. them. Here is an example note:
  509.  
  510.         the sample number (from your sample edit screen)
  511.         │
  512.         │    special command (probably is blank on your screen right now)
  513.         │    │
  514.    C-2 00 F c1
  515.    │ │    │
  516.    │ │    the volume of this note
  517.    │ │
  518.    │ the octave
  519.    │
  520.    the note to play!
  521.                   
  522.  
  523. Here's another example:
  524.  
  525.    D#3 01 A
  526.  
  527. This would be playing D sharp, octave 3, with sample number 01 at volume A.
  528.  
  529. You can edit a lot of things with the samples. To change the sample
  530. number of an already existing note, you can hit "[" and it will let you
  531. enter a new sample number. You can adjust the volume of the note by
  532. hitting "]" and it will let you enter a new number. To add a special
  533. command, hit "backspace" and it will prompt you for a command. Don't
  534. worry about the commands quite yet though, I will discuss those later.
  535.  
  536. Now that you see how the notes work, let me show you a few things about
  537. volume. Look on the status line of the screen (the bottom line) and look
  538. for the "volume" indicator. Right now it should say "Volume = F". We're
  539. going to adjust this a bit. Hit the "=" key, this will reduce the main
  540. volume. Keep pressing it till it gets down to "5". Once its at 5, enter
  541. some more notes into the pattern edit screen. You will see and hear that
  542. all of the new notes play softer then the previous ones. Notice that the
  543. volume parameter of the note is now set at "5" instead of "F". Lets
  544. bring your main volume back up to "A", so hit the "\" key until your
  545. main volume is at volume "A". Enter a few more notes and notice the
  546. volume difference. Okay so...
  547.  
  548.   "=" decreases the main volume
  549.   "\" increases the main volume
  550.  
  551. Notice that these keys are right next to your backspace key in a
  552. convenient position so that you can adjust the volume easily. Its very
  553. important to understand how the volume commands work because you will
  554. find yourself using them a lot in the future.
  555.  
  556. In the pattern edit screen, position your cursor over a note thats
  557. already there. Press the "]" key and change the volume. Understand? :)
  558. Notice that when you adjust the volume there, that also changes the main
  559. volume.
  560.  
  561. Remember: Main Volume = the volume at which notes you enter on the
  562.                         screen will use.
  563.  
  564. Now that you've got volume down, go back to the sample edit screen (F1),
  565. and position your cursor to sample number "01" which should currently be
  566. blank. (sample "00" should be SAMPLE1.FSM). Load the sample
  567. "SAMPLE2.FSM". Go back to your pattern edit screen and enter a few
  568. notes. Now you're using a different instrument, but I bet you figured that
  569. one out for yourself (I hope!) :)
  570.  
  571. You probably have a pattern filled up with a bunch of notes now, let me
  572. show you how to play the pattern... Hit F6 and your pattern should start
  573. playing. Probably sounds a little weird? but don't worry, thats how you
  574. start. Once its done playing the pattern, it will jump back up to the
  575. top and play it again.
  576.  
  577. At this point, you might want to experiment trying to make a small one
  578. pattern tune. While you're doing this, here's a few keys which may be
  579. helpful to you:
  580.  
  581. ---
  582.  
  583. spacebar = delete the note that the cursor is positioned on.
  584.  
  585. DEL      = delete the note that the cursor is positioned on, and move
  586.            all notes below it (in the current channel) up one.
  587.  
  588. INS      = insert a blank note in the current position, and move all
  589.            notes in the current channel down one.
  590.  
  591. ?        = get an extensive list of the available keys
  592.  
  593. F8       = stop playback
  594.  
  595. F7       = play from current row in pattern (differs from Composer 669)
  596.  
  597. PGUP     = Move up in the pattern a bunch, just like hitting the up
  598.            arrow key about 20 times :)
  599.  
  600. PGDN     = Move down in the pattern a bunch.
  601.  
  602. "/"      = DOWN octave (use the numeric keypad for convenience)
  603. "*"      = UP octave
  604.            │
  605.            │
  606.            experiment with these if you don't know what they are. Try
  607.            them, enter a few notes, and notice the difference! :)
  608.  
  609. HOME,END = move to the first/last channel in the current row.
  610.  
  611. ---
  612.  
  613. Well there's some keys to get you started with working in a single
  614. pattern. Most of them should be pretty much easy to understand, but if
  615. you haven't experimented with a tracker (or music in general) before,
  616. then "octave" might not make sense to you. Here's an explanation:
  617.  
  618. Octave : "the interval made up of the first and eighth tones (in rising
  619.           order of pitch) in a major or minor scale".
  620.  
  621. So basicly, C-1 and C-2 are going to sound the same, except that C-2 is
  622. a much higher frequency, but still the same note. In fact, the frequency of
  623. C-2 is exactly twice as great as the frequency of C-1. Experiment with
  624. "/" and "*" and you will see what I mean. You've got 5 whole octaves to
  625. work with, so you can get quite a variety of frequencies. Normally, 8
  626. bit samples really only sound good through 3 different octaves, and its
  627. best to base them whereever they sound best. So, you probably won't be
  628. using all of the octaves for a single sample, but in case you need them,
  629. they're there, although the extrememly high octaves such as 3 and 4 tend to
  630. sound out of tune because of math errors involved in generating them.
  631.  
  632. So far, you've just been working with one pattern, but now I'm going to
  633. show you how to work with other patterns. Make sure your in the pattern
  634. edit screen, and then hit the "+" key. Now you will have a screen with
  635. no notes in it. You were on pattern 00, but now your on pattern 01. Look
  636. at the status line on the bottom of the screen, you should see
  637. "Pattern = 01". What the hell, press "+" again, and get to pattern "02"!
  638. Well, lets go back to pattern 01, so hit "-" and you should be back at
  639. pattern "01".
  640.  
  641. Pattern "01" should be blank, but fill it up with a bunch of notes, or a
  642. little tune or something.
  643.  
  644. Once you've got pattern "01" with some notes in it ...umm, press F3 and
  645. we're going to make our first song!
  646.  
  647. You pressed F3 and your in the order edit screen ...right? Make sure
  648. you're on position "00" in the order edit screen, press "]". Now press
  649. "00". Press your down arrow and highlight position "01". Once again,
  650. press "]" but this time put in "01". Move down one more to position "02"
  651. and "]" then "01" again. So, now your order edit should look like:
  652.  
  653.   00 00
  654.   01 01
  655.   02 01
  656.   03
  657.   04
  658.   05
  659.  
  660. You now have a song that is 3 patterns long! Press F5 and the whole song
  661. will play. ahhh.... beautiful!
  662.  
  663. Well, you've now got the basics of pattern editing, there's a lot more
  664. to it, but this should be enough to get you started. Make sure you read
  665. the rest of the documentation to understand the other stuff, but
  666. understand pattern editing before anything else. Don't worry if you need
  667. to read this part over a few times, it takes practice to learn to use a
  668. composing software as powerful as Farandole composer. I remember when I
  669. was first learning Composer 669, I had to read the docs quite a few
  670. times to understand. Just be patient!!!
  671.  
  672. Hey wait... before you exit, lets save your song:
  673.  
  674. Press "ALT-F12" and at the bottom of the screen you'll get a prompt
  675. asking for a song name. Type whatever you want, but I'd just call it
  676. "TESTING". Okay, after you've typed that in and pressed enter, press
  677. "F12" and your song will be saved to disk.
  678.  
  679. Now you can exit, press "ALT-X" and answer "Y" to the "are you sure".
  680.  
  681. When you want to load that song again, press "F11" and highlight your
  682. song in the directory window.
  683.  
  684. At this point, you may want to take a break and grab something to eat,
  685. but when you come back, load up the demo song and play with it:
  686.  
  687. 1) Load up FAR.EXE
  688. 2) Press "F11" and highlight THUNDDRM.FAR
  689. 3) Press "F5" to listen to the whole song.
  690.  
  691. You may want to navigate through the song and look at how I did a lot of
  692. the stuff in that song. Its not a great song or anything, but I hope
  693. that you can learn some stuff from it.
  694.  
  695. You can rip the samples from the song so that you have a few samples to
  696. work with.
  697.  
  698. MiSC STUFF
  699. ▀▀▀▀▀▀▀▀▀▀
  700.  
  701. There are a few nuts and bolts laying around in the composer that have not
  702. been explained above.
  703.  
  704. The little '=' or double tilde in the bottom right corner tells you whether
  705. or not your song has been modified. If it is a double tilde, then it is a
  706. broken file :). In other words, it's not saved.
  707.  
  708. The help screen saves your current position so that you don't have to find
  709. it again when you come back later for more help.
  710.  
  711.  
  712. If you have any additional questions or anything, I am more then happy
  713. to help. You can contact me (Ryan Cramer) at:
  714.  
  715. Data Connection BBS - (703) 506-8598 - 16.8k HST Dual Standard
  716. Programmer's Oasis  - (214) 328-6142 - 14.4k v.32bis
  717. The Sound Barrier   - (718) 979-6629 - 14.4k HST Dual Standard
  718.  
  719. You can contact Daniel Potter at the Programmer's Oasis.
  720.  
  721.  
  722. EXTENSiVE LiST OF ALL KEYS AVAiLABLE IN FAR - THIS LIST AVAILABLE WITH '?'
  723. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  724.  
  725. Global Keys (Apply to all areas except graphical editor and CFG screen
  726. ----------------------------------------------------------------------
  727.  
  728.   /                       octave down (use keypad)
  729.   *                       octave up (use keypad)
  730.  
  731.   UP (on keypad)          current sample up
  732.   DOWN (on keypad)        current sample down
  733.  
  734.   6 (on keypad)           order up
  735.   3 (on keypad)           order down
  736.  
  737.   4                       tempo down
  738.   1                       tempo up
  739.  
  740.   =                       edit volume down
  741.   \                       edit volume up
  742.  
  743.   F1                      Move to sample edit
  744.   F2                      Move to pattern edit
  745.   F3                      Move to order edit
  746.   F4                      Play from current order
  747.   F5                      Play from beginning of song
  748.   F6                      Play from top current pattern
  749.   F7                      Play from current position in current pattern
  750.   F8                      Stop playback of song
  751.   ALT-F11                 Change name of song
  752.   ALT-F12                 Change DOS filename of song
  753.   F10                     Edit or view song text!
  754.   F11                     Load song
  755.   F12                     Save song
  756.   CTRL-0,1,2,3,4,5,6,7,
  757.        8,9,A,B,C,D,E,F    Toggle corresponding channel on/off
  758.  
  759.   CTRL-SHIFT-0,1,2,3,4,
  760.              etc, etc.    Turn off all channels except the one
  761.                           specified.
  762.   ALT-T                   Turn ON all channels.
  763.  
  764.   ALT-F8                  Edit song loop position
  765.   ALT-F10                 Save configuration
  766.  
  767.   ALT-ESC                 Shell to DOS (not 100% reliable)
  768.   ScrollLock              Decrease volume
  769.   Pause                   Increase volume
  770.   ?                       Get a list of keys (like this)
  771.  
  772.  
  773. Keys specific to pattern editing
  774. --------------------------------
  775.  
  776.   SPACE                   erase note under edit bar
  777.   UP,DOWN,LEFT,RIGHT      move edit bar around
  778.   PGUP,PGDN               moves to top or bottom of page - if you are
  779.                              already at one of those, it flips pages
  780.   HOME,END                Moves to the first, last channel in current row
  781.  
  782.   DELETE,INSERT           delete/insert current note under edit bar
  783.                              and move entire set of notes under it up or
  784.                              down
  785.   ALT-B,E                 Mark begin,end of a block
  786.   ALT-C,O                 copy into/out of buffer
  787.   ALT-Q,A                 Transpose block up/down one octave
  788.   ALT-W,S                 Transpose block up/down one halfstep
  789.   ALT-V                   Set volume of block
  790.   ALT-I                   Set instrument of block
  791.   ALT-U                   Unmark block
  792.   ALT-Z                   Clear block
  793.   ALT-R,N                 Copy/paste current row-note that this
  794.                              function CAN be used to rotate the music
  795.   ALT-L                   Mark entire channel
  796.   ALT-M                   Copy entire pattern over another one
  797.   ALT-P                   Place break location
  798.   [                       Edit instrument field of note under edit bar
  799.                              This changes the current edit instrument.
  800.   ]                       Edit volume field of note under edit bar
  801.                              This changes the current edit volume.
  802.   BACKSPACE               Edit effect field of note under edit bar
  803.   SHIFT-BACKSPACE         Erase effect field of note under edit bar
  804.   ALT-F1                  Erase all instruments/samples
  805.   ALT-F2                  Erase current pattern
  806.   ALT-F3                  Erase all order info
  807.   -,+                     Change patterns
  808.   ALT-J                   Jump to another pattern
  809.   `                       Pick up volume,instrument under edit bar
  810.  
  811.  
  812. Keys specific to sample editing
  813. -------------------------------
  814.  
  815.   INSERT,DELETE           Insert or delete sample at this position,
  816.                              moving all others under it up or down
  817.   . (number pad)          Delete current sample, without moving others
  818.   CURSUP,CURSDN           Change samples
  819.   [ ]                     Edit Sample RepStart,RepEnd
  820.   ENTER                   Edit Sample name (saved with sample with
  821.                              saved to disk in FSM format, along with
  822.                              RepStart/RepEnd Info)
  823.   SPACE                   Load a new sample
  824.   ALT-F                   Save a sample in FSM format
  825.   ALT-S                   Save a sample in USM format (unsigned raw)
  826.   ALT-F1                  Erase all Samples
  827.   -                       Set sticky volume (0 to cancel)
  828.  
  829.  
  830. Keys specific to order editing
  831. ------------------------------
  832.  
  833.   CURSUP,CURSDN           Change order up,down
  834.   ]                       Edit order value under cursor
  835.   INSERT,DELETE           Insert,delete an order at cursor, moves all
  836.                              orders under this one up or down
  837.  
  838.  
  839. Keys specific to graphical sample editing
  840. -----------------------------------------
  841.  
  842.   Keypad CURSUP,CURSDN    Change sample up/down
  843.   ESC                     Exit editor
  844.   F8,SPACE                Stop currently playing music/sample
  845.  
  846.  
  847. SPECiAL COMMANDS
  848. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  849.  
  850. Here is a list of the special commands available in the FAR composer.
  851. You can set a special command for each note pattern edit screen by
  852. pressing "backspace" on the note and then putting in the letter (or
  853. number) of the special command and a value argument. Here's an example:
  854.  
  855. C-2 01 F f4
  856.          ││
  857.         this is the special command
  858.  
  859. As you can see, a special command consists of a command character, and
  860. then a variable argument.
  861.  
  862. CHANGiNG THE TEMPO
  863. ------------------
  864. The main special command that you will probably use is the "tempo"
  865. command. This is the "f" command (just like in Composer 669). The
  866. example above is setting the tempo to tempo 4.
  867.  
  868. Tempo 4 is the default tempo for the FAR composer. Tempo 4 corresponds
  869. to tempo 6 in MODs. MODs use a default tempo of 6, if you wanted to use
  870. that default tempo for FAR, you would use the special command "f5" at
  871. the beginning of your pattern. Remember that FAR tempos correspond to
  872. MOD tempos by taking: (far tempo/32.0)*50.0. Tempos can range from 0 through F
  873. with 0 being the fastest. Experiment with the tempos to find out which
  874. one is best for the song your working on. The default tempo of 4 is
  875. usually a good starting place.
  876.  
  877. FiNE TEMPOS
  878. -----------
  879. As you found out in the previous paragraph, the "f" command changes the
  880. main tempo, however you can also set tempo ranges inbetween the main tempo
  881. by using the fine tempo commands. The fine tempo commands are:
  882.  
  883. e - fine tempo up
  884. d - fine tempo down
  885.  
  886. This way you can have 0 through F tempo ranges in between each main
  887. tempo range! This is a very useful feature, and you'll find that I make
  888. use of it quite a bit in the example song. Unless you want an additive effect,
  889. make sure you cancel out the previous fine tempo command with F0 OR E0.
  890.  
  891. CHANNEL BALANCE
  892. ---------------
  893. Another really cool feature about FAR is that you can position a channel
  894. to wherever you want it! FAR lets you pan each channel through 16
  895. different positions. The command to adjust the balance of a channel is
  896. the: "b" command. Here's a couple examples:
  897.  
  898. b0 - sets the channel balance all the way to the left
  899. bF - sets the channel balance all the way to the right
  900. b8 - sets the channel balance in the middle
  901.  
  902. As you can see, the lower the number, the farther to the left it is. The
  903. higher the number, the further to the right it is. Experiment with this
  904. in the composer and you will hear some really neat stuff!
  905.  
  906. NOTE-PORTS
  907. ----------
  908. MANY people have been waiting a long time for this feature. This feature
  909. allows you to start a note on a channel, then later "port" to that note
  910. with a given time interval. The command for this effect is 3. Best way to
  911. show this is an example:
  912.  
  913. C 200F..     start a note (C-2) with instrument 00, vol F
  914. ........
  915. ........
  916. ........
  917. F 200F34     bend the previously started note to pitch F-2, and finish the
  918. ........     bend -4- bars below
  919. ........
  920. ........
  921. --------     Bend will end approximately here
  922.  
  923.  
  924. RETRIGGER
  925. ---------
  926. Many more people have asked for this effect. This simply allows you to have
  927. a note repeat itself a certain number of times within a bar, to create a
  928. drum roll or similar effect. The effect number is 4. The parameter tell the
  929. composer how many of that note to play in THAT bar.
  930.  
  931. C 200F42     play two notes (C-2) with instrument 00, vol F, evenly spaced
  932.              out, in that same bar
  933.  
  934.  
  935. FUTURE COMMANDS
  936. ---------------
  937. In this beta version, there are not many commands. In the release
  938. version, we will probably have vibrato, and all sorts of other stuff.
  939. I personally can't wait for 'em! :)
  940.  
  941.  
  942. BLOCK COMMANDS
  943. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  944. When you are composing a song, you will have to use the block commands
  945. all of the time, otherwise you'd be repeating yourself a lot. Block
  946. commands copy between channels or patterns. Using the block commands you
  947. can duplicate the contents of an individual channel or a pattern.
  948.  
  949. Here is the entire list of block commands:
  950.  
  951.   ALT-B,E                 Mark begin,end of a block
  952.   ALT-C,O                 copy into/out of buffer
  953.   ALT-Q,A                 Transpose block up/down one octave
  954.   ALT-W,S                 Transpose block up/down one halfstep
  955.   ALT-V                   Set volume of block
  956.   ALT-I                   Set instrument of block
  957.   ALT-U                   Unmark block
  958.   ALT-Z                   Clear block
  959.   ALT-R,N                 Copy/paste current row-note that this
  960.                              function CAN be used to rotate the music
  961.   ALT-L                   Mark entire channel
  962.   ALT-M                   Copy entire pattern over another one
  963.  
  964.  
  965. Here's a couple examples on how to use them:
  966.  
  967. Lets say you wanted to duplicate pattern 00 to pattern 01. You would hit
  968. ALT-M. Once you hit that, you would be prompted (at the bottom of the
  969. screen) to enter the pattern to copy to. So you would enter 01 and the
  970. pattern would be copied!
  971.  
  972. Next, lets say that you wanted to copy everything in channel 1 to
  973. channel 7. You would hit ALT-L to mark the entire channel (notice the
  974. highlighted channel marker on the left side of the pattern edit screen).
  975. Once the channel is marked, you would hit ALT-C to copy the channel to
  976. the buffer. Now, move your cursor over to the top of channel 7 and hit
  977. ALT-O. This empties the contents of the buffer into the channel and now
  978. its duplicated! To unmark channel 1, hit ALT-U and that deallocates the
  979. buffer.
  980.  
  981. Note that you don't have to mark the entire channel with ALT-L. You can
  982. also just mark only as much of the channel you want by using ALT-B and
  983. ALT-E (begin and end).
  984.  
  985. You don't have to use channel marking just for copying, you can also
  986. manipulate the marked channel. Notice that ALT-Q and ALT-A transpose the
  987. notes in the block up or down an octave. ALT-W and ALT-S transpose the
  988. marked block up or down one halfstep. ALT-V sets the volume of all notes
  989. in the block to the current editing volume, and ALT-I sets the samples
  990. of the block to the current sample.
  991.  
  992.  
  993. HOW NOTES ARE REPRESENTED
  994. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  995.  
  996. Here is a quick description of how the notes are represented in the FAR
  997. composer:
  998.  
  999.         the sample number (from your sample edit screen)
  1000.         │
  1001.         │    special command
  1002.         │    │
  1003.    C-2 00 F c1
  1004.    │ │    │
  1005.    │ │    the volume of this note
  1006.    │ │
  1007.    │ the octave
  1008.    │
  1009.    the note to play!
  1010.  
  1011. For information how on how to adjust the values in the note, see the
  1012. "pattern edit" section earlier in the documentation.
  1013.  
  1014. KEYBOARD LAYOUT
  1015. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1016.  
  1017. Thanks to Tran of Renaissace for the kewl diagram:
  1018.  
  1019.             C#  D#      F#  G#  A#      C#  D#      F#  G#  A#
  1020.          ┌─┬─┬─┬─┬──┬──┬─┬─┬─┬─┬─┬──┬──┬─┬─┬─┬──┬──┬─┬─┬─┬─┬─┬─┐
  1021.          │ │ │ │ │  │  │ │ │ │ │ │  │  │ │ │ │  │  │ │ │ │ │ │ │
  1022.          │ │ │ │ │  │  │ │ │ │ │ │  │  │ │ │ │  │  │ │ │ │ │ │ │
  1023.          │ │S│ │D│  │  │G│ │H│ │J│  │  │2│ │3│  │  │5│ │6│ │7│ │
  1024.          │ │ │ │ │  │  │ │ │ │ │ │  │  │ │ │ │  │  │ │ │ │ │ │ │
  1025.          │ └┬┘ └┬┘  │  └┬┘ └┬┘ └┬┘  │  └┬┘ └┬┘  │  └┬┘ └┬┘ └┬┘ │
  1026.          │  │   │   │   │   │   │   │   │   │   │   │   │   │  │
  1027.          │Z │ X │ C │ V │ B │ N │ M │ Q │ W │ E │ R │ T │ Y │ U│
  1028.          │  │   │   │   │   │   │   │   │   │   │   │   │   │  │
  1029.          └──┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴──┘
  1030.           C   D   E   F   G   A   B   C   D   E   F   G   A   B
  1031.  
  1032.              (The piano also works in graphical editing mode)
  1033.  
  1034. Two octaves are available on the keyboard at any given time. The top
  1035. octave is controlled by the top numbers and the top row of letter keys.
  1036. The bottom octave is controlled by the middle row of letter keys, and the
  1037. bottom row of letter keys.
  1038.  
  1039. VOLUME COMMANDS
  1040. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1041.  
  1042. The Farandole composer uses a main volume range of 0 through F (0
  1043. through 15 decimal). You can adjust the main volume by pressing "=" to
  1044. decrease the main volume, and "\" to increase it. The main volume is the
  1045. current editing volume at which any notes you place will be given that
  1046. volume value.
  1047.  
  1048. You can adjust the volume of an already exiting note by pressing "]"
  1049. while your cursor is positioned above the note. From here, you can type
  1050. "0" through "F" as your new volume.
  1051.  
  1052. Volume commands can also appear where there is not a note. In fact, you
  1053. will find yourself using this feature a lot.
  1054.  
  1055. Example 1: Lets say we want to fade out a sample:
  1056.  
  1057. D#3 01 F
  1058. ... .. E
  1059. ... .. D
  1060. ... .. C
  1061. ... .. B        - Notice how we are slowly decreasing the volume
  1062. ... .. A
  1063. ... .. 9
  1064. ... .. 8
  1065. ... .. 7
  1066. ... .. 6
  1067. ... .. 5
  1068. ... .. 4
  1069. ... .. 3
  1070. ... .. 2
  1071. ... .. 1
  1072. ... .. 0
  1073.  
  1074. So now you see how powerful volume commands can be. You can also stop
  1075. playing a sample. ie:
  1076.  
  1077. F-1 03 C
  1078. ... ..
  1079. ... ..
  1080. ... .. 0  <-Stops playing! (sets volume to zero)
  1081. ... ..
  1082.  
  1083. This probably seems pretty obvious... but its an important concept for
  1084. beginners! :)
  1085.  
  1086. THE SONG TEXT EDiTOR
  1087. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1088.  
  1089. We noticed that in MODs and 669s (and S3Ms! :), a lot of people are
  1090. using the sample names to give us a message, greets, or anything like
  1091. that. Well, thats cool, but we figured that there should be a special
  1092. screen setup just for that so that composer's can give lots of info
  1093. about the particular song. We've included a songtext editor which you
  1094. can have up to 64k of text (thats ALOT of text!). You can get to this
  1095. songtext editor by hitting F10. Once you hit that, you will be
  1096. brought up with a giant blank screen. You can fill this up with
  1097. text or whatever you want.. You've got 64k to work with. Of course, FAR
  1098. only saves as many bytes as you use, it doesn't actually tack on an
  1099. extra 64k to every song! :) Also you are limited to this one screenful for
  1100. actual text, but you can feel free to make an external util to import texts
  1101. into your songs, or graphics data, or whatever else you want to store in
  1102. there. Keep in mind that this songtext will be scrolled across the screen
  1103. while playing with the command line player. So in other words, a big fancy
  1104. screen with boxes and formatted text wouldn't look so hot (although I've
  1105. already seen a few people do this...)
  1106.  
  1107.  
  1108. TOGGLiNG CHANNELS ON AND OFF
  1109. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1110.  
  1111. You may want to toggle certain channels on or off so that you can focus
  1112. on them more. I use this feature all of the time when composing. To turn
  1113. them on or off, you simple hit CTRL+Channel Number. So, if you wanted to
  1114. toggle channel 0, you would hit "CTRL-0", or if you wanted to toggle
  1115. channel F, you would hit "CTRL-F".
  1116.  
  1117. Sometimes you may want to turn off all channels except a single one so
  1118. that you can focus on that one without hearing anything from the other
  1119. 15 channels. It is a very useful feature, and I suggest using it when
  1120. composing or studying music. You can do this using the CTRL-SHIFT-channel
  1121. combination. Also to turn them all back on, you can use ALT-T
  1122.  
  1123. MULTiTASKER COMMAND LiNE SWiTCHES
  1124. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1125. If you are running Farandole under a multitasker, such as OS/2 or DesqView,
  1126. you can tell it this and it will purposely release timeslices. This allows
  1127. playing in the background, or allowing other processes to continue while
  1128. you play in the foreground:
  1129.  
  1130. /t2   - Assume OS/2 is running
  1131. /tD   - Assume DesqView is running
  1132.  
  1133. Farandole can even release timeslices to DOS for other TSRs, and this is
  1134. the default option if neither of the other two are used.
  1135.  
  1136.  
  1137. HOW TO REGiSTER
  1138. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1139.  
  1140. To register, please fill out the form FAR_REG.DOC, print it out, and
  1141. mail it to Daniel Potter. All information is given in the REGISTER.DOC
  1142. file, but in the event that the file is missing, here is another copy:
  1143.  
  1144. ---- Cut Here --------------------------------------------------------
  1145.  
  1146. FAR_REG.DOC - Registration form
  1147.  
  1148. Please fill out this form and print it out and mail to Daniel Potter
  1149. (address is listed below).
  1150.  
  1151. Farandole Composer 0.9
  1152. Copyright (c) 1993 by Daniel Potter
  1153. All Rights Reserved
  1154.  
  1155. Thanks for deciding to register Farandole,  I really appreciate it.
  1156. Here is all of the legal info, and the registration form is below.
  1157.  
  1158.                                 Thanks,
  1159.                                 Daniel Potter
  1160. Disclaimer
  1161. ▀▀▀▀▀▀▀▀▀▀
  1162. In no way is Daniel Potter to be held responsible for damages,
  1163. including the inability of the program to function as designed.  No
  1164. warranty of this product is expressed nor implied, and it is expected
  1165. that you will have determined the usefulness of Farandole prior to
  1166. remitting the registration fee.
  1167.  
  1168. The Registration Fee
  1169. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1170. The registration fee for the Farandole composer is $15.00 USD. If you
  1171. would like the registered version delivered to you by mail on a disk,
  1172. please also add $2.00 in the US or $4.00 outside the US to cover
  1173. shipping, handling and disks.
  1174.  
  1175. If you do not include the shipping and handling fee, you have to get
  1176. your registered copy on The Programmer's Oasis BBS. Please indicate your
  1177. choice on the registration form below. The number for Programmer's Oasis
  1178. BBS is:
  1179.  
  1180. Programmer's Oasis BBS, Sysop Daniel Potter, Digital Infinity Hdqtrs.
  1181. (214) 328-6142 14.4k v.32bis
  1182.  
  1183. NOTE!! If you decide to get the registered copy off of the BBS, and not
  1184. through the mail, you CANNOT receive a copy of the printed manual (I wonder
  1185. why :). You CAN decide to get a copy of the sample library, however, this is
  1186. not an advisable option with LD, since it is over 1.2 megs compressed.
  1187.  
  1188. You may pay by check or money order. You may also pay with cash, but if
  1189. you do, we cannot be responsible if it is stolen in the mail. It is
  1190. safest to pay by check or money order, but cash is an option if you
  1191. cannot use check or money order.
  1192.  
  1193. Payment should be made out to: Daniel Potter
  1194.  
  1195. You should mail your registration to:
  1196.  
  1197.                     Daniel Potter
  1198.                     2828 Tolosa Dr.
  1199.                     Dallas, TX, 75228
  1200.                     USA
  1201.  
  1202.  
  1203. Once you receive your registered copy of Farandole composer, you may not
  1204. distribute it. It is for your personal use only.
  1205.  
  1206. Print out this form and mail it to the address above.
  1207.  
  1208. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  1209.  
  1210. Please answer the following questions:
  1211.  
  1212. Today's Date: __/__/__
  1213.  
  1214. Payment by (check one): ____ check, ____ money order, ____ cash
  1215.  
  1216. #__ copies of the Farandole composer for $15 each $______
  1217.                plus $2.00 shipping & handling USA $______
  1218.     plus $4.00 shipping & handling Outside of USA $______
  1219.                                         T O T A L $______
  1220.  
  1221. Your real name:  __________________________________________
  1222.  
  1223. Your alias & demogroup (if not applicable, just type N/A):
  1224.  
  1225.                  __________________________________________
  1226.  
  1227.  
  1228. Mailing Address: __________________________________________
  1229.  
  1230.                  __________________________________________
  1231.  
  1232.                  __________________________________________
  1233.  
  1234. Phone Number:    __________________________________________
  1235.  
  1236.  
  1237. Where would you like to get your registered copy of FAR (check one):
  1238.  
  1239.                  ______ Mail it to me, I've included the shipping cost
  1240.                  ______ I'll download it from your BBS
  1241.  
  1242. If your getting it in the mail, what type disk do you want (check one):
  1243.  
  1244.                  ______ 3.5" disk
  1245.                  ______ 5.25" disk
  1246.  
  1247.  
  1248. Leave any additional comments below: THANKS FOR SUPPORTING SHAREWARE!!
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257. ---- Cut Here -----------------------------------------------------------
  1258.  
  1259.  
  1260.  
  1261. HOW TO GET iN CONTACT WiTH DiGITAL iNFiNiTY
  1262. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1263.  
  1264. The Digital Infinity Headquarters board is Programmer's oasis. There are
  1265. conferences and file areas dedicated to Digital Infinity there.
  1266. Programmer's Oasis also has large demo, music, and programming related
  1267. conferences/file areas. Call today!
  1268.  
  1269. Programmer's Oasis - Dallas, Texas USA - Sysop Daniel Potter
  1270. 14.4k v.32bis - (214) 328-6142
  1271.  
  1272. *UPDATE* SORRY PROGRAMMER'S OASIS IS CLOSED DOWN. PLEASE TRY DATA CONNECTION
  1273. OR MUSIC CONNECTION:
  1274.  
  1275. Music Connection - Dallas, Texas USA - Sysop Rob Butler
  1276. 28.8k v.EVERYTHING - (214)596-2827
  1277. 14.4k HST/DS       - (214)964-3743
  1278.  
  1279. You can also get in contact with us at our East Coast distribution site
  1280. which also has lots of demo, music, and programming related conferences
  1281. and file areas:
  1282.  
  1283. Data Connection BBS - McLean, Virginia USA - Sysop Ryan Cramer
  1284. 16.8k HST Dual Standard (703) 506-8598
  1285.  
  1286. FUTURE PLANS FOR THE FAR COMPOSER
  1287. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1288.  
  1289. This version of the composer is just a ßeta version, and probably many
  1290. things will change in the release version. If any changes are made in
  1291. the file format, we will include a conversion program so that you won't
  1292. lose any music that you have composed. The main things that will be in
  1293. the future version are:
  1294.  
  1295. 1. fine volume commands
  1296. 2. bug fixes
  1297. 3. a sample EDITor
  1298. 4. more file format support (send 'em in! :)
  1299. 5. more stuff that we haven't thought of yet! :)
  1300.  
  1301. We are very open to your suggestions and bug reports, so if you discover
  1302. anything, PLEASE contact Daniel Potter on his BBS (number listed above
  1303. in the previous section).
  1304.  
  1305. SPECiAL THANKS
  1306. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1307.  
  1308. Special thanks to Josh Jensen for his fantastic UltraDox and the GusMod
  1309. source code which has helped GREATLY in the production of the FAR
  1310. composer.
  1311.  
  1312. Special thanks also goto Tran for Composer 669 which we feel is the best
  1313. composing environment available for SoundBlaster/PRO, which is why we tried
  1314. to duplicate it! :)
  1315.  
  1316. Many many special thanks go to John Smith at Gravis for all the cool support!
  1317. There's not many companies that would go to the trouble/expense of helping
  1318. its developers like you guys do.
  1319.  
  1320. Thanks also goto Advanced Gravis for making the GUS!
  1321.  
  1322. Thanks go to Ryan Cramer (from Daniel Potter (me)) for really helping me make
  1323. the composer something that MUSICIANS could use too! :) and for the awesome
  1324. example song.
  1325.  
  1326. Thanks go to Mattias Larsson for making a standalone player, and OBJ file
  1327. available to the public! I will have code from FAR coming to you to fix your
  1328. player routines hehe (they are out of tune and tempos are off :)
  1329.  
  1330.  
  1331. GREETiNGS
  1332. ▀▀▀▀▀▀▀▀▀
  1333.  
  1334. Digital Infinity sends greetings to the following groups/people (not in any
  1335. specific order):
  1336.  
  1337. Toxic Zombies                       Triton
  1338. Renaissance                         Paranoids
  1339. End of Time                         New Age
  1340. Psychedelic!                        Extreme
  1341. Imphobia                            The Code Blasters
  1342. EMF                                 Ultraforce
  1343. Twilight Zone                       Hysteria
  1344. Cascada                             Epical
  1345. Sonic-PC                            Silents-PC
  1346. The Phoney Coders                   Surprise Productions
  1347. DCE                                 The Space Pigs
  1348. Paranoids                           VLA
  1349. Skull                               Anarchy-PC
  1350. Onyx                                Access Denied
  1351. The Brain Slayer                    Vibrants
  1352. Majic 12-PC                         XOGraphy
  1353. Dark Zone                           VangeliSTeam/Iguana
  1354. ETR                                 Dust
  1355. Doomsday Productions                Legend Design
  1356. Black Rain                          Witan
  1357. Synergy Design                      Black Design
  1358. Virtual Visions                     Sebastian Dwornik
  1359. ID Software                         Apogee
  1360. Epic Megagames                      Astek
  1361.  
  1362. I know I have forgotten someone here.. I'm sorry.. please mail me again :)
  1363.  
  1364. And Daniel Potter greets all my favorite friends from #trax and #teens on
  1365. IRC (and all the remnants of the broken up #teens :( ..) may the dream of
  1366. an irc free of depersonalization live on! amen.
  1367.  
  1368.  
  1369. ...and all other people that we forgot to mention here.
  1370.  
  1371. T H E  E N D :)
  1372.  
  1373.