XLR8 Chip Composer by Sentry
************************************ * XLR8 - Sentry Chip Composor * * Coded and designed by F.v.Nispen * * Painted by A.Bod * * Release Version 1.0 - 01.05.93 * ************************************ XLR8 - Sentry Chip Composor is a SHAREWARE Product from the XLR8 Section of Sentry NL. If you want ro register, you have to send us $10 or any equivalent amount of money. You will receive an ACC-Player for *.XMS, *.XVS and *.XNG files with the possibillity to play your tunes over the MIDI Interface to a synthesiser or keyboard. You will also receive a convert program for other players to Chip Composor (Mad Max, Modules...) and the first update wich will include SID-Voice (Synth) in the Saved *.XMS Files. The adres is on the end of this document. THIS PACKAGE CONTAINS: - XLR8CHIP.PRG The Editor (COLOR and MONO) - XLR8CHIP.TXT This short manual - XLR8PLAY.TTP For playing *.XMS Files from the desktop - PLAY.S Assembler Source for playing *.XMS Files - PLAY.GFA For playing music with GFA - Instruments, VoiceSets, Songs .... This package should run on every ATARI ST(e)/TT/Falcon, with 512kb or more. It supprots both ST Low and Monochrome modes and will run on every vertical sync frequency (50Hz, 60Hz and 71Hz). WHAT DOES IT DO? The XLR8 - Chip Composor is a program to compose music for the Yamaha 2149 soundchip that is included in every ATARI ST(e)/TT computer. With this musical editor, you are able to compose music on this chip with maximum quality. FEATURES: - Three channel soundchip music on every ST - For STE/TT users it will be possible soon to compose music with three channel soundchip and two channel digital sound for drums. This will make an amount of five channel sound that is never been done before on Atari. - A complete instrument-editor to make your own sounds with six different syntheses. - Tone Slides - Volume control for every pattern and note - Possibility to save musicfiles that include the song and voiceset with a replayer in 680X0-machine code, so you are able to use the music you made with it in Assembler, Basic, Pascal, ..... - It works with transposable patterns like Midi-programs, so you will get very small music-files. - The replayer is very fast, so it is also usable for demo's and games. A FAST INTRODUCTION Since the ATARI ST was released in 1985, there have been a many musicians who made music on it. A few of them became very famous on Atari. The music that these people made was often used in many demos because there was no possibility to make your own music. Every one in the demo-scene wanted to have the 'Max Max - editor' or any alike editor, so they could make there own music. But none of the musicians wanted to spread there magic tool. There came a few new musicians and a few stopped their activities, but still there were no editors available. But then! There was Music mon, but this commercial editor didn't get enough of the possible sounds of the Yamaha chip out of it, so your music was doomed to be wors than the DemoRoutines. And till the day of realease of this editor there hasn't been any music-editor available that was good, fast, nice to see, and took complete advandage of the soundchip. So here it is, the first GOOD music editor for the ATARI ST(e)/TT and Falcon computers. START OFF THE PROGRAM To start the editor you must dubbleclick on XLR8CHIP.PRG THE EDITOR, GLOBAL If you start the editor, an information box will appear on screen. You can just click on the OK button to continue. The screen is sepparated in three parts, on TOP you will find the program options like LOAD/SAVE, INFO, V-SET,... In the midle of the screen you'll find a window called 'PATTERN EDITOR'. On the BOTTOM of the screen there is a window called 'SONG EDITOR'. EDIT If you click on the 'EDIT' button, a white cursor will appear within the pattern-window. I the cursor is visable, you are in edit-mode. If you click on the 'EDIT' button again, the cursor will dissapear. By clicking on either the PATTERN-window or the SONG-window, you can swap between the PATTERN EDITOR and the SONG EDITOR. If you are in PATTERN EDIT mode or not in edit-mode at all, you can play tunes with the selected instrument by pressing the keys 'Q' to 'RETURN' and '\' to '/' like playing the piano: 1 A S F G H K L ' 2 3 5 6 8 9 0 = ` | # # | # # # | # # | # # # | # # | # # # | # # | # # | # # # | # # | # # # | # # | # # # | # # | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | ----------------------------------------------- \ Z X C V B N M , . / Q W E R T Y U I O P [ ] RETURN By pressing F1 to F7, you are able to change the octave-range, with F1 the '\'-key will be C0, with F3 the '\'-key will be a C3 note. PATTERN EDIT-Mode A pattern is a little track of music with a maximum of 32 notes. You can play the patterns in any order on any of the three channel and you are able to transpose the patterns to a higher tone. So you can edit a pattern with some melody based on the C-accord, and by transposing it by 12 keys, it will be played in the C1-accord. By transposing it by 4 tones it will be played in the E-accord. In this way it is possible to generate very short music files. An example pattern: 00 C0 01 0F 00 --- 00 00 00 --- 00 00 00 --- 00 00 00 01 A0 01 0F 00 --- 00 00 00 --- 00 00 00 --- 00 00 00 02 01 0F 00 --- 00 00 00 --- 00 00 00 --- 00 00 00 03 A0 01 0F 00 --- 00 00 00 A0 01 00 00 --- 00 00 00 04 C0 01 0F 00 --- 00 00 00 --- 00 00 00 --- 00 00 00 05 C0 01 0F 00 --- 00 00 00 --- 00 00 00 --- 00 00 00 06 C0 01 0F 00 --- 00 00 00 --- 00 00 00 --- 00 00 00 07 C0 01 0F 00 --- 00 00 00 --- 00 00 00 --- 00 00 00 On the first line of this pattern you see 'C0 01 0F 00 .....' C0 is the note that will be played, 01 is the instrument that will be used to play the note with, 0F means TONE-SLIDE SPEED 0 and VOLUME F that is 15! The numbers in the pattern and song-editor are all in HEX! You can find a conversion table for this in the appendices. From the moment you the toneslide is not '0' but '1' to 'F', the current tone will be slided to the tone you wanted to slide to. '1' is a very slow slide, 'F' is very fast. Everything you enter in the pattern are changes. this means is you are playing If you first enter 'C0 01 0F 00' and a little bit later 'A0 00 08 00', the instrument you were playing at the moment will continue exactly the way it was, but the frequency of the tone will change to 'A0' and the volume will be half as loud. If you enter 'A0 01 0F 00' and later '--- 01 00 00', The instrument will be restarted and the tone and volume don't change. So if the instrument was a a piano, the A0-Key will be pressed again. You can change instrument by clicking on the arrows behind the instrument-name and number in the bar of the pattern-window. On this bar you will also find the name of the pattern on the left. By clicking on these arrows you can select a pattern to edit. By clicking on the name, you can alter the name of the pattern, ESC will put the old name back. COPY and MIX patterns By clicking in CPY or MIX you are able to copy or mix patterns. You will be asked to enter a(the) source(s) and destination of the pattern(s). You can change the pattern by clicking on the arrows or by clicking on the name of the pattern and enter the name of the pattern you wish to copy or mix. If you want to mix, you have to put the most important pattern on src 1. For example, if you want to mix DRUMS with a BASELINE, you must put the drums on SCR 1 and the bases on SCR 2. If none of the tracks contain data, the data ot the desteny-pattern will be maintained. If one of the two contain data, it will be copied to the desteny-pattern, of they contain both data, the note from SCR 1 will be copied. THE KEYS IN PATTERN-EDIT mode TAB - Next note UP - cursor up DOWN - cursor down LEFT - cursor left RIGTH - cursor right INSERT - note back CLR/HOME - note further BACKSPACE - clear note, premelary note will be continued ESC - put pause, tone will be stopped + - next instrument - - instrument back ENTER - play song, starting at the first songposition that appears within the song-window . (keypad) - play pattern, at the speed that is set in the bar or the song-window. SPACE - stop sound SONG EDIT-Mode A song is a sequence of patterns. You are able to transpose patterns or alter their maximum volume. You can also edit the channel of the soundchip the pattern will be played on. Clicking on the songname will allow you to enter a new name, pressing ESC will put the old name back. channel 1 channel 2 channel 3 STe channel speed 00 PTRN01 00 0F ------ 00 00 ------ 00 00 ------ 00 00 06 01 PTRN01 02 0F ------ 00 00 ------ 00 00 ------ 00 00 06 02 ------ 00 00 PTRN02 00 0E ------ 00 00 ------ 00 00 06 03 -REST- 01 00 ------ 00 00 ------ 00 00 ------ 00 00 06 04 ------ 00 00 ------ 00 00 ------ 00 00 ------ 00 00 06 05 ------ 00 00 ------ 00 00 ------ 00 00 ------ 00 00 06 06 ------ 00 00 ------ 00 00 ------ 00 00 ------ 00 00 06 07 ------ 00 00 ------ 00 00 ------ 00 00 ------ 00 00 06 The colomn in which you are editing, decides on with channel a pattern will be played. '00 PTRN01 00 0F .....' will play pattern 01 on channel 1 with a maximum volume of 15 (F) at speed 6. On the second line (01) is pattern 01 played with all notes transposed by 2 notes. '-REST- 01 00' mains that the song must continue at position 01. You can enter a new pattern by typing its name or by typing the number of the pattern in 2 digits and press RETURN. '-REST-' means 'RESTART' and can be entered by typing '-REST-' or by pressing '*' on the keypad. '------' is a pause on the channel and can be entered by typing '------' or by pressing 'BACKSPACE'. '-STOP-' means that the song is ended and must stop playing (no restart). You can enter this or press 'ESC'. You can use the arrows to scroll up and down and to move left and rigth. INSERT and DELETE can be used to insert and delete one line. THE TOP PART OF THE SCREEN On the TOP part of the screen you'll find all options for the editor: LOAD, SAVE, INFO, DELETE, EDIT, PREFERENCES, VOICE-SET EDITOR and in the the near future EXTRA. On the rigth-top of the screen you can see a Joystick with means PLAY SONG, a FIST that means stop music and a HEADPHONE that is unused at the moment. Below these three figures there are four leds with a little number on top of it representing the soundchannel corresponding to this number. By clicking on it it will alter from GREEN to RED or from RED to GREEN. Green means that this channel is activated, Red means that this channel is dissabled. INFO Draws the INFOBOX that appears at the start of the program. LOAD This draws a box with the following LOAD FORMATS: LOAD - SONG *.XNG XLR8 soNG - 1 PATTERN *.XPT XLR8 PaTtern - INSTRUMENT *.XIN XLR8 INstrument - VOICE SET *.XVS XLR8 Voice Set - MUSIC FILE *.XMS XLR8 MuSic LOAD SONG loads a song including patterns and names. LOAD 1 PATTERN loads 1 pattern on the pattern that is currently on the screen. LOAD INSTRUMENT loads 1 instrument put it on the instrument that is currently active (in the pattern bar). LOAD VOICESET loads a voice set including names. LOAD MUSIC FILE loads a music file that includes the song, pattern, instruments and generated code for playing it and converts it back to the editor. SAVE This function is dissabled in the DemoVersion EDIT Switch between normal mode and edit mode. PREFERENCES Allows you alter the jump to the next position while editing patterns to be automaticly or manualy and to activate name-change of instruments within the sequencer or dissable it (default). DELETE This allows you to delete some parts of a music, SONG - Clean the song window 1 PATTERN - Clean the pattern window ALL PATTERNS - Clear all patterns VOICE SET - Clear Voice Set ALL - Clear Song, patterns and voiceset If you don't delete ALL before loading a new file, the file will be overlayed on the old information! V-SET Go to the Voice Set editor screen. (See below). EXTRA Not used at the moment. THE VOICE SET EDITOR With this editor you are able to get everything out your YM2149, even new bussounds and SID-Voice are included. The main idea of a sound: You are able to edit 64 Sounds and 5 Synthese Tables. You have 32 Tables with each Synthese. If you want to enable a synthese on a sound, just select a tablenumber with the arrowkeys behind every synthese (On the left top of the sceen): VOLUME -- <> ARPEGGIO -- <> VIBRATO -- <> NOISE -- <> WAVE -- <> SYNTH OFF If you go lower than 0, it will display '--' and disable the synthese. By this way, you don't have to copy any tables from or to an instrument. So you can easilly make two sound completely the same except for the arpeggio (One with and one without arpeggio). VOLUME SYNTHESE Disable this option will always give you a volume of 15 (MAX). If you select a table, the table will be shown in the VOLUME window (right top of the screen). You can alter any volume table you want by clicking on the raster with the left key, The rigth key will delete a position. You can edit with TONE ONLY (Red), TONE & NOISE (brown) or just NOISE (White). You can select this in the volume window: +--------+ | T # | Select TONE ONLY | TN # | Select TONE & NOISE | N # | Select NOISE ONLY | # | Show the selected color +--------+ The bottom of the blue raster gives VOLUME 0, Top of the blue raster gives VOLUME 15 (Max.) and selecting the green raster on a position enables the Hardware Wave Synthese. In every window You can set three things: SPEED 0 <> RSTRT 0 <> REPT 0 <> SPEED Selects the nuber of VBL's to wait for the next value (the speed that the table is handled by the synthese). RSTRT With this one you can set to with position in the table the synthese has to jump after the table has been done one time. If it is 0, the table will be repeated continuesly from start to end. If you put it on the end of a synthtable, the table will only be played ones. So for example if you want to make a PIANO Sound, the table goes from the left to to the bollom right '\' and the RSTRT is set on maximum. REPT Currently unused NOTE: This is the procedure with all other syntheses as well. ARPEGGIO You can edit a table when you selected one by clicking on the data window: 00 00 01 -- 02 -- 03 -- 04 -- 05 -- 06 -- 07 -- Exit the edit mode by pressing 'ESC', you can use 'BACKSPACE' to delete the rest of the table. Arpeggio is used for simulation Chord schemes, If you entered the following in the data table of the Arpeggio window: 00 00 01 04 02 07 03 -- ... If you play any note afterards, the synthesizer will play the Normal tone, then the Tone + 4 Tones, the the Normal Tone + 7 Tones and the normal again... This means if you play 'C', the program will play: C+0: 'C' C+4: 'E' 0:C 1:C# 2:D 3:D# 4:E C+7: 'G' 5:F 6:F# 7:G So the program will simulate the Majeur-C Chord! 0,3,7 will give a mineur-C (C D# G) NOISE Synthese As you could read before, noise synthes should be selected within the VOLUME Synthese window. With this synthes you can alter the NoiseFrequency (0-31) that is played when noise is selected within the Volume table. VIBRATO (FM) In this table you can add a small value to the Tone frequency. If you would enter: 00, 01, 02, -- in the VIBRATO WINDOW, The tone will automaticly vibrate (Frequenty Modulation). SYNTH You can only put this one 'ON' or 'OFF'. It will activate the Ring Modulator, known as 'SID-Voice','LAP-Effect' or 'Synergy Sound'. NOTE: Synth ONLY works on channel 1 (left). WAVE SYNTHESE This one is probably the hardest of all to understand. For this one also counts that the synthese must be selected within the VOICE WINDOW (Green bar is 'ON'). So if you want 'WAVE Synthese' you have to select a Wave Table and a Volume Table with only the left top point set (green to red). Pos. ++------- Wave Number || || ++++-- Period of the wave (Lo-Byte, High Byte) 00 00 0000 01 -- ---- 02 -- ---- 03 -- ---- 04 -- ---- 05 -- ---- 06 -- ---- 07 -- ---- Wave Numbers: 00 \____ You could use this one for PIANO 04 /|___ 08 \\\\\ Usable for the so called 'Hard Buzz' 10 \/\/\ Usable for a 'Soft Buzz' (Synth dream Bass) ____ 11 \ 12 ///// Also a 'Hard Buzz' ____ 13 / Usable for String alike sounds 14 /\/\/ An other 'Soft Buzz' Period of the wave: First two digits: Fine Tune, Last two: Period The Higer the period, the slower the wave is handled: If you use Wave 00 and a high period, the volume will fade slowely away like the Piano. BUT THERE IS MORE WITH THIS! If you are editing the Wave nr. and you press '*', on the Period will appear 'AUTO'. This means that the period of the wave depents on the frequency of the TONE. This is called 'BUZZ SOUND'. If you move upon the 'AUTO' four digits appear again. This time it is NOT the period of the wave, but parameters of the BUZZ Sound. The first two digits give the Shift Value for Tone to period: 04xx Gives the buzz that is used in Trisound and by Synthdream. If you use a higher shift you get a grover sound and you have to move up in octaves. The second two digits have the following functions: xx00 Normal Vibrating Buzz xx01 Half volume buzz xx02 None Vibrating Buzz (Dry Buzz Sound) xx03 Half volume dry buzz xxXX Any other will have a higher period with a higher tone. Example: You want to make the Soft SynthDream bass: Select a VOLUME TABLE with WAVE SYNTHESE activated, select a WAVE TABLE. The WAVE TABEL should look this way: 00 10 AUTO Under AUTO: 0402 01 -- ---- ||++-- Indicates a NONE VIBRATING BUZZ ++---- Standard Buzz shift .... You can alter the name of an instrument by clicking on it. XLR8 is the commercial software trademark of SENTRY. The contact adres is: XLR8 - Frans van Nispen Oranjeboomstraat 139 4812 EC Breda The Netherlands You can contact us for any reason like Design, Conversions for ST/STe/Falcon, Programming, Music, Graphics or information on our products. You can also register on this adres for the Chip Composor Shareware Package.
[ back to the prod ]