home *** CD-ROM | disk | FTP | other *** search
/ Audio 4.94 - Over 11,000 Files / audio-11000.iso / amiga / players / modplyrs / qc100.lha / QuadraComposer / QCManual.TXT < prev    next >
Text File  |  1993-05-16  |  19KB  |  599 lines
  1. QuadraComposer 1.00 User manual.
  2. ================================
  3.  
  4. DISTRIBUTION:
  5.     You are hereby given permission to distribute the
  6.     QuadraComposer.LhA archive, as long as it is redistributed in its
  7.     original unmodified form. You may NOT take any fee for the
  8.     program itself, only the costs for the media itself.
  9.  
  10. SHAREWARE:
  11.     QuadraComposer is SHAREWARE, and if you use it you should pay the
  12.     shareware fee of US$ 20 (or the equal amount is SEK) (The fee
  13.     should be cashable in OUR local banks, so a $20-bill is the most
  14.     practical payment...). Please support us.
  15.  
  16. COPYRIGHTS:
  17.     QuadraComposer is Copyright ⌐ 1993 Technological Artwork.
  18.     QC makes use of reqtools.library for the requesters.
  19.     ReqTools is Copyright (c) Nico Franτois.
  20.  
  21. THE AUTHORS:
  22.     * Bo Lincoln *
  23.  
  24.     SnailMail:  Bo Lincoln
  25.                 Ryttargatan 70
  26.                 S-731 52 K╓PING
  27.                 SWEDEN
  28.  
  29.     * Calle Englund *
  30.     SnailMail:  Calle Englund
  31.                 NΣmndemansgσrden 10
  32.                 S-582 38 LINK╓PING
  33.                 SWEDEN
  34.     Email:      c92caren@und.ida.liu.se
  35.  
  36.  
  37. 1 OPERATION OF QUADRA COMPOSER
  38. ==============================
  39. Some text that (probably) nobody will read anyway, describing the
  40. user interface of QuadraComposer follows...
  41. 1.0 GADGET TYPES (some...)
  42. ==========================
  43. The gadgets are not StyleGuide compliant, but we are working on a
  44. FULLY intuitionalized release (will probably NOT work on 1.2/1.3
  45. though :) that will be more SG compliant...
  46.  
  47. 1.0.1 UP/DOWN GADGET
  48. ====================
  49.     +--+
  50.     | /|
  51.     |/ |
  52.     +--+
  53.  
  54. Pressing the LMB over the up/down-wards pointing triangle will
  55. in/de-crease the value in the resessed box beside. If the RMB is
  56. pressed simutaneously, the rate of change will increase.
  57.  
  58.  
  59. 1.0.2 CYCLE GADGET
  60. ==================
  61.     +---+
  62.     |/->|
  63.     ||  |
  64.     |\-/|
  65.     +---+
  66.  
  67. Cycles through multiple choices then clicked on with LMB.
  68.  
  69.  
  70. 1.0.3 TEXT(STRING) GADGET
  71. =========================
  72. A box with text in it. Click LMB to edit, [ENTER] finishes...
  73.  
  74.  
  75. 1.0.4 LITTLE RED DOTS
  76. =====================
  77. If a gadget has a little red dot in its upper right corner, then
  78. there is an option window attached to it. Clicking RMB brings it up.
  79.  
  80.  
  81. 1.1 SCREEN OVERVIEW
  82. ===================
  83. The screen is divided in five main areas, which are described below.
  84.  
  85. +-----------------------------------------------------------+
  86. |    TITLE BAR                                              |
  87. +-------++--------------------------------------------------+
  88. |       ||                                                  |
  89. |       ||                                                  |
  90. | SIDE  ||                                                  |
  91. | MENU  ||    MAIN WINDOW                                   |
  92. |       ||                                                  |
  93. |       ||                                                  |
  94. |       ||                                                  |
  95. |       ||                                                  |
  96. |       ||                                                  |
  97. |       ||                                                  |
  98. |       ||                                                  |
  99. |       ||                                                  |
  100. |       ||                                                  |
  101. |       ||                                                  |
  102. |       ||                                                  |
  103. |       ||                                                  |
  104. |       ||                                                  |
  105. |       ||                                                  |
  106. |       ||                                                  |
  107. |       ||                                                  |
  108. |       ||                                                  |
  109. +-------++--------------------------------------------------+
  110. +--------------------------------++-------------------------+
  111. |                                ||                         |
  112. |   TEXT FIELDS                  ||   SPECTROSCOPE          |
  113. |                                ||                         |
  114. +--------------------------------++-------------------------+
  115.  
  116.  
  117. 1.1.1 TITLE BAR
  118. ===============
  119. Contains the standard system screen gadget(s) but also some
  120. information is present;
  121.  
  122. +-------------------------------------+--+
  123. | Quadra Composer x.yz   a b c defg   |  |
  124. +-------------------------------------+--+
  125.  
  126. where x.yz is the version of Quadra Composer and:
  127.  
  128. a   -/M     MULTI off/on
  129. b   -/E     AUTOECHO off/on
  130. c   0-9     EDITSKIP value
  131. d   -/1     CHANNEL 1 off/on
  132. ...
  133. g   -/4     CHANNEL 4 off/on
  134.  
  135.  
  136. 1.1.2 SIDE MENU
  137. ===============
  138.  
  139. +-+-----+  The sidemenu field have two different operation modes,
  140. |Q|  T  |  toggled between with the "Cycle" gadget "T". In both
  141. +-+-+---+  modes Quadra Composer can be exited by clicking the
  142. | a | b |  gadget "Q".
  143. +---+---+
  144. | c | d |  All the gadgets "a" through "n" are mode dependent, and
  145. +---+---+  are described below.
  146. | e | f |
  147. +---+---+
  148. | g | h |
  149. +---+---+
  150. | i | j |
  151. +---+---+
  152. +-++----+
  153. |/|| k  |
  154. +-++----+
  155. +-++----+
  156. |/|| l  |
  157. +-++----+
  158. +-++----+
  159. |/|| m  |
  160. +-++----+
  161. +-++----+
  162. |/|| n  |
  163. +-++----+
  164.  
  165.  
  166. 1.1.2.1 MODE 1: EDITOR MENU
  167. ===========================
  168. Gadget  Function
  169. -----------------------
  170. a       Enter pattern editor
  171. b       Enter sample editor
  172. c       Enter file window
  173. d       Enter track clipboard
  174. e       Enter misc settings
  175. f       Pop up "About" window
  176. g       Cut to buffer
  177. h       Copy to buffer
  178. i       Paste buffer
  179. j       Cut to bitbucket (clear)
  180.  
  181. k       Current position
  182. l       Pattern at current position
  183. m       Current sample number
  184. n       Current pattern
  185.  
  186.  
  187. 1.1.2.2 MODE 2: PLAY/RECORD OPERATION
  188. =====================================
  189. Gadget  Function
  190. -----------------------
  191. a       Play module
  192. b       Play pattern
  193. c       Record module
  194. d       Record pattern
  195. e       Stop play/rec
  196. f       Toggle edit on/off
  197. g-j     As above
  198.  
  199. k       Tempo
  200. l       VBL/CIA timing (VBL=Tempo 125)
  201. m       Songlenght (# of positions used)
  202. n       Pattern lenght (# of rows in current pattern)
  203.  
  204.  
  205. 1.1.3 TEXT FIELDS
  206. =================
  207. There are four of these, from top to bottom;
  208.  
  209. SONG NAME (used as default basename of the module when saving)
  210. PATTERN NAME (useful when mixing the patterns)
  211. SAMPLE NAME (used as default basename when saving)
  212. STATUS LINE (status of the last operation)
  213.  
  214.  
  215. 1.1.4 SPECTROSCOPE
  216. ==================
  217. The fun-to-look-at(tm) part of Quadra Composer (for us poor guys who
  218. can't create any music worth listening to anyway...) it's a combined
  219. spectrumanalyzer and a kind of oscilloscope. Toggles mode with a
  220. mouseclick. (The spec.analyzer is kind of "cheap" (no fft); but it
  221. works remarkably well ;)
  222.  
  223.  
  224. 1.2.1 PATTERN EDITOR
  225. ====================
  226. The window is divided into four vertical areas, tracks, representing
  227. one audio channel each. RMB click toggles the channel on/off
  228. (indicated by the title bar). LMB click moves the cursor to selected
  229. point (row, note/effect). LMB drag marks a block.
  230.  
  231.  
  232. 1.3 KEYBOARD COMMANDS
  233. =====================
  234. The main keyboard is used for entering notes.
  235. (Am. layout)
  236.      2 3   6 7 8   9
  237.     Q W R T Y U I O P       Higher octave
  238.     \___/
  239.         \_________ The same notes
  240.                   \___
  241.                   /   \
  242.      S D   G H J   L ;
  243.     Z X C V B N M , . /     Lower octave
  244.  
  245. The default lower octave is 2.
  246.  
  247. MISC KEYBOARD COMMANDS.
  248. =======================
  249. RIGHT SHIFT     Record song.
  250. RIGHT ALT       Play song.
  251. RIGHT AMIGA     Play pattern.
  252. <               Turn off all samples. (Not available on some Am.
  253.                                        keyboards.)
  254. SPACE           Toggle editing on/off.
  255. RETURN          Insert blank row in track.
  256. A-RETURN        Insert blank row in pattern (all tracks).
  257. C-RETURN        Insert blank row in track (effect cmd only).
  258. BACKSPACE       Delete previous row and move rest of the track upwards.
  259. A-BACKSP.                          -"-                   pattern  -"-
  260. C-BACKSP.       As BACKSPACE but only effect command.
  261. DELETE          Delete note/effect of the current track, row.
  262. S-DELETE        Delete note+effect        -"-
  263. TAB             Move cursor to next track (right).
  264. S-TAB                 -"-      prev  -"-   left
  265. F1              Set lower octave to "1"
  266. F2              Set lower octave to "2"
  267. F3              Cut block to buffer.
  268. S-F3            Cut entire track (notes only).
  269. A-F3            Cut entire pattern (notes only).
  270. F4              As F3, but Copy instead.
  271. F5              Paste buffer.
  272. S-F5            Paste from top of track (notes only).
  273. A-F5            Paste from "top left corner" of track (notes only).
  274. F6-F10          Move to "bookmark", default are 00/10/20/30/40
  275. S-(F6-F10)      Set "bookmark".
  276. A-(F6-F10)      Play pattern from "bookmark".
  277. C-(F6-F10)      Record        -"-
  278. S-(1-9)         Store current effectcommand in effectbuffer 1-9.
  279. A-(1-9)         Paste effectbuffer 1-9 into current cursorpos.
  280. C-(1-9)         Set editskip to 1-9. Ie the number of rows the editor
  281.                 jumps after a note is struck.
  282. A-(Z,X,C,V)     Toggle voice 1-4 on/off
  283. A-MINUS (Main keyboard, Am. layout)
  284.                 Copy previous effect command and decrease its
  285.                 argument.
  286. A-PLUS (Main keyboard, Am. layout)
  287.                 Copy prev. fx cmd and increase its arg.
  288. A-\             Copy prev. fx cmd.
  289.  
  290. C-A             Toggle current voice on/off.
  291. C-C             Copy block.
  292. C-D             Clear block.
  293. C-E             Expand track.
  294. C-F             Toggle filter on/off.
  295. C-G             Toggle AutoEcho on/off.
  296. C-I             Paste buffer.
  297. C-K             Clear to end of track.
  298. C-M             Toggle MultiMode on/off
  299. C-P             Paste buffer.
  300. C-Q             Turn all voices on.
  301. C-R             Restore "bookmarks".
  302. C-T             Swap tracks.
  303. C-V             Paste buffer.
  304. C-X             Cut block.
  305.  
  306. TRANSPOSE (LEFT AMIGA+)
  307. =======================
  308. Active sample   All samples
  309. Track   Pattern Track   Pattern
  310. 1       2       3       4           Up one half note.
  311. Q       W       E       R           Down one half note.
  312. A       S       D       F           Up one octave
  313. Z       X       C       V           Down one octave
  314.  
  315. ARROW KEY OPERATION
  316. ===================
  317. UP              Move cursor up.
  318. DOWN            Move cursor down
  319. LEFT            Move cursor left.
  320. RIGHT           Move corsor right.
  321. S-UP            Move cursor up 8 rows.
  322. S-DOWN          Move cursor down 8 rows.
  323. S-LEFT          Decrease position.
  324. S-RIGHT         Increase position.
  325. C-LEFT          Decrease sample number.
  326. C-RIGHT         Increase sample number.
  327. A-LEFT          Decrease current pattern number.
  328. A-RIGHT         Increase current pattern number.
  329.  
  330. NUMERIC KEYPAD (Not available on A600. ;-(
  331. ==========================================
  332.  
  333. +-+-+-+-+
  334. |1|2|3|4|
  335. +-+-+-+-+
  336. |5|6|7|8|
  337. +-+-+-+-+
  338. |9|A|B|C|
  339. +-+-+-+-+
  340. |D|E|F|0|
  341. +-+-+-+ |
  342. |   | | |
  343. +---+-+-+
  344.  ^   ^
  345.  |   \_ Increase sample number by HEX 10.
  346.  \_____ Decrease         -"-
  347.  
  348.  
  349.  
  350. 2 QUADRA COMPOSER EFFECT COMMANDS
  351. =================================
  352. The effect command is the last three (3) digits of each row of a
  353. track.
  354.  
  355. | C 101xyz |
  356.   ^^^^^^^^
  357.   \|/|| \\____Effect command
  358.    |  \_______Sample number
  359.     \_________Note.
  360.  
  361. 2.1 Command 0yz: ARPEGGIO
  362. =========================
  363. Arpeggio is a rapid pitch change. The pitch changes between the
  364. played note and the notes Y resp. Z halftones higher.
  365.  
  366.  
  367. 2.2 Command 1yz: PITCH SLIDE, UP
  368. ================================
  369. Slides the pitch up YZ halftones. The resulting pitch cannot be
  370. higher than the highest possible pitch (B 3).
  371.  
  372.  
  373. 2.3 Command 2yz: PITCH SLIDE, DOWN
  374. ==================================
  375. Slides the pitch down YZ halftones. The resulting pitch cannot be
  376. lower than the lowest possible pitch (C 1).
  377.  
  378.  
  379. 2.4 Command 3yz: TONE PORTAMENTO
  380. ================================
  381. Slides the pitch up/down to played the note at YZ halftones per
  382. frame. The effect must be reactivated on each row. If YZ=00 then the
  383. last YZ will be used.
  384.  
  385. | C 101000 |
  386. | C 201302 |
  387. |    00300 |
  388. |    00300 |
  389. | ...      |
  390.  
  391. When the desired pitch is reached, the effect will not do anything.
  392.  
  393.  
  394. 2.5 Command 4yz: VIBRATO
  395. ========================
  396. Makes a vibrato effect on the sample played. The command must be
  397. reactivated on each row. Y is the speed of the vibrato and Z is the
  398. depth. If an argument is "0" then the previous value used will be
  399. used.
  400.  
  401. | C 101445 |        +-------------------------------------+
  402. |    00406 |     <--| Makes the vibrato deeper and deeper |
  403. |    00407 |        +-------------------------------------+
  404. |    00408 |
  405. |    00409 |
  406.  
  407.  
  408. 2.6 Command 5yz: VOLUME SLIDE + SUSTAINED TONE PORTAMENTO
  409. =========================================================
  410. Adds a volume slide to a tone portamento. The portamento must be
  411. initialized with the [3yz] effect before this effect can be used. The
  412. Y argument represents the volume increase rate and Z the decrease.
  413.  
  414. | C 101000 |        +--------------------------------------+
  415. | C 201305 |     <--| Continues the portamento and slides  |
  416. |    00501 |        | the volume down                      |
  417. |    00501 |        +--------------------------------------+
  418. |...       |
  419.  
  420.  
  421. 2.7 Command 6yz: VOLUME SLIDE + SUSTAINED VIBRATO
  422. =================================================
  423. Similar to command [5yz], see above. The vibrato should be
  424. initialized before using this command.
  425.  
  426.  
  427. 2.8 Command 7yz: TREMOLO
  428. ========================
  429. Creates a volume vibrato. The speed is set with the argument Y and
  430. the depth with Z. If an argument is "0" then the last value for that
  431. argument is used.
  432.  
  433. 2.9 Command 8yz: NOT USED
  434. =========================
  435.  
  436. 2.10 Command 9yz: SET SAMPLE OFFSET
  437. ===================================
  438. Used only when a note is played, to skip a bit into the sample. The
  439. argument YZ is multiplied with hex 200 and that many bytes of the
  440. sample are skipped.
  441.  
  442. | C 101923 |     <--| Skips hex 23 * 200 = 4600 bytes |
  443.  
  444. NOTE: This differs from the NT-format, where the offset was hex
  445. YZ*100.
  446.  
  447. 2.11 Command Ayz: VOLUME SLIDE
  448. ==============================
  449. Slides the volume up at the speed set by Y or down at the speed set
  450. by Z. The effect must be reactivated on each row.
  451.  
  452. | C 207A20 |        +-----------------------+
  453. |    00A20 |     <--| Slides the volume up. |
  454. | ...      |        +-----------------------+
  455.  
  456. 2.12 Command Byz: POSITION JUMP
  457. ===============================
  458. Skips the rest of the current pattern (It's a good idea to pull the
  459. length down to save some bytes of memory...) and jumps to position
  460. hex YZ.
  461.  
  462. NOTE: This differs from the NT-format, where the argument to this
  463. effect was given as a decimal number.
  464.  
  465.  
  466. 2.13 Command Cyz: SET VOLUME
  467. ============================
  468. Set the volume for a channel. The argument YZ sets the new volume.
  469. The volume must be between hex 0 and 40.
  470.  
  471. 2.14 Command Dyz: PATTERN BREAK
  472. ===============================
  473. Skips the rest of the current pattern (see command Byz) and the first
  474. YZ rows of the next pattern (YZ should not exceed the length of the
  475. next pattern).
  476.  
  477. 2.15 Command Eyz: EXTENDED (E-)COMMANDS
  478. =======================================
  479. The e-commands are explained below.
  480.  
  481. 2.16 Command Fyz: SET SPEED/TEMPO
  482. =================================
  483. Sets the speed of a pattern (and the ones that follow...) if the
  484. argument YZ is less than or equal to hex 1F or the tempo if YZ is
  485. higher than hex 1F.
  486.  
  487. The speed is normally the number of picture frames or vertical blanks
  488. (1/50 second PAL or 1/60 second NTSC) to wait between each row of a
  489. pattern. The default speed is 06, ie 0.12 seconds (PAL) or 125 beats
  490. per minute.
  491.  
  492. If the tempo is set QuadraComposer will switch from VBL timing (125
  493. bpm, PAL) to CIA timing. The default tempo is hex 7D (125 bpm,
  494. again). The tempo rating assumes a default speed setting.
  495.  
  496. TECHNOTE: If the tempo is set to anything else than 7D, then the
  497. level 6 CIA interrupt must be used. If the tempo is set high then the
  498. replay takes more time each frame (the replay interrupt also will get
  499. out of phase with the screen refresh, so worst case time consumtion
  500. can get high (or at least unpredictable) even when using lower tempo,
  501. check the replay routine...).
  502.  
  503.  
  504. 2.17 EXTENDED COMMANDS
  505. ======================
  506.  
  507. 2.17.1 Command E0z: SET FILTER
  508. ==============================
  509. Used to switch the internal audio filter on or off. If Z is "0" the
  510. filter is switched on and if Z is "1" the filter is switched off.
  511.  
  512. NOTE: Some old amiga's don't have this feature.
  513.  
  514. 2.17.2 Command E1z: FINE PITCHSLIDE, UP
  515. =======================================
  516. Slide the pitch up a little bit, Z is simply added to the pitch.
  517.  
  518. 2.17.3 Command E2z: FINE PITCHSLIDE, DOWN
  519. =========================================
  520. As above, but down.
  521.  
  522. 2.17.4 Command E3z: SET GLISSANDO
  523. =================================
  524. Turn glissando on (Z = "1") or off (Z = "0"). Glissando is used with
  525. portamento. If it is turned on, then the portamento will be done
  526. halftone by halftone, like "walking" up or down the piano.
  527.  
  528. TECHNOTE: This effect can use up a lot of time, check the replay
  529. routine...
  530.  
  531. 2.17.5 Command E4z: SET VIBRATO WAVEFORM
  532. ========================================
  533. Simply selects the waveform used for vibrato effects. Z=0     Use
  534. sinewave (default) Z=1     Use ramp down Z=2     Use squarewave
  535.  
  536. 2.17.6 Command E5z: SET FINETUNE VALUE
  537. ======================================
  538. Sets the finetune value for a channel. The finetune can vary from -8
  539. to 7 (using 2's complement, ie 0 to 7 are represented by the numbers
  540. 0 to 7, and -8 to -1 are represented by the numbers 8 to F).
  541.  
  542. | C 101E5E |     <--| Set the finetune value to -2 |
  543.  
  544. 2.17.7 Command E6z: PATTERN LOOP
  545. ================================
  546. Used for creating loops in patterns. First the first row of the loop
  547. must be defined, by using Z = 0, and then at the end of the loop, the
  548. number of "jump backs" are defined with Z > 0. Nested loops (inside
  549. eachother) are not possible.
  550.  
  551. | C 303E60 |     <--| Beginning of the loop |
  552. | ...      |
  553. |    00E64 |     <--| The loop will be replayed 4 times, then |
  554.                     | continue                                |
  555.  
  556. 2.17.8 Command E7z: SET TREMOLO WAVEFORM
  557. ========================================
  558. Like command E4z, but sets waveform for tremolo instead.
  559.  
  560. 2.17.9 Command E8z: NOT USED
  561. ============================
  562.  
  563. 2.17.10 Command E9z: RETRIG NOTE
  564. ================================
  565. Playes the note every Z VBL's (see effect Fyz). Useful is you want to
  566. play the pattern slowly, but want say, a hihat playing rapidly.
  567.  
  568. 2.17.11 Command EAz: FINE VOLUMESLIDE, UP
  569. =========================================
  570. Simply adds the argument to the current volume of the channel.
  571.  
  572. 2.17.12 Command EBz: FINE VOLUMESLIDE, DOWN
  573. ===========================================
  574. Simply subtracts the argument from the current volume.
  575.  
  576. 2.17.13 Command ECz: NOTECUT
  577. ============================
  578. Cuts the note after Z VBL's (see effect E9z), ie sets the volume to
  579. 00.
  580.  
  581. 2.17.14 Command EDz: NOTE DELAY
  582. ===============================
  583. Waits Z VBL's, before playing the note.
  584.  
  585. 2.17.15 Command EEz: NOT USED
  586. =============================
  587.  
  588. 2.17.16 Command EFz: PATTERN DELAY
  589. ==================================
  590. Delays the pattern Z VBL's. Useful for creating a short pause in the
  591. music.
  592.  
  593.  
  594. 2.18 EFFECTS THAT DIFFER FROM THE NT-FORMAT
  595. ===========================================
  596. Some effects differ slightly from the nt-format. These are effect
  597. 9yz, and effect Byz. These differences are autimagically converted
  598. when a module is loaded/saved in NT-format.
  599.