@database "QS-Edit" @Node Main "QS-Edit" @{i} QS-Edit V1.2ß 26.12.1998@{ui} @{b} Full editor for Alesis QS series synthesizers.@{ub} THIS PROGRAM IS @{b}FREEWARE@{ub} @{" Features " Link "Features"} @{" Requirements " Link "Requirements"} @{" Starting QS-Edit " Link "Starting QS-Edit"} @{" Author " Link "Author"} @{" Using QS-Edit " Link "Using QS-Edit"} @EndNode @Node "Features" @{b} FEATURES@{ub} Synthesizers supported: -QS6, QS7, QS8, AND QSR -AND POSSIBLY NANOSYNTH, NANOBASS, NANOPIANO AND QS6.1 -TESTED ONLY ON QSR!!! Features: -PROGRAM, EFFECT and MIX modes. I tought that there's no need for GLOBAL mode. -Play notes with keyboard. There's special window with aftertouch, modulation, velocity and pitchbend controllers. There is also slid- er for program change, octave and midi channel. Use F1 and F2 butt- otons on any window to change octave, press SPACE to kill notes. -Device may be specified and configured -Copy sounds between them selves or to buffer -Add sample group/sample names from sound cards to special text files, Keyboard.QS and Drums.QS. This you have to do with text editor! *NEW* *NEW* *NEW* *NEW* *NEW* *NEW* *NEW* *NEW* *NEW* *NEW* *NEW* -CAPTURE mode. Capture programs and mixes as SysEX Dumps. Also OPENS SysEX format files that are generated by synth and SAVES files in SysEX format that can be recognized by synth. @EndNode @Node "Author" Program written and copyrigted by Jouni 'TECHO' Vepsäläinen Kangaslahdentie 560 73810 Palonurmi Finland email our group at: skylined@iwn.fi Feel free to send bug reports, suggestions, etc. Written in 100% assembler, compiled with PhxAss v4.38 By Frank Wille!!! @EndNode @Node "Starting QS-Edit" @{b} STARTING QS-Edit@{ub} Just click QS-Edit icon or enter QS-Edit at CLI. But make sure these files are in the same directory where you started QS-Edit from: -Keyboard.QS -Drums.QS -QS-Edit.prefs @EndNode @Node "Requirements" @{b} REQUIREMENTS@{ub} -At Least KS2.0 -Around 385Kb of chip memory, 445Kb memory of any type. Total 830Kb. SO ONE MEGA BYTE AT LEAST. -Processor 68000 --> -asl.library -serial.device, UNIT 0. These can be changed at the @{" Prefs " Link "Prefs"} editor. Tested on A1200 KickStart 3.0 (39.106) with Blizzard 1230-III Turbo: -50Mhz 68030 -50Mhz 68882 FPU -68851 MMU -32Mb of FAST RAM and 2Mb CHIP RAM. @EndNode @Node "Using QS-Edit" @{b} USING QS-Edit@{ub} @{" READ THIS FIRST! " Link "Read this first"} @{" Menus " Link "Menus"} @EndNode @Node "Read this first" THESE INSTRUCTINS ARE IMPORTANT TO READ FOR NOT LOOSING YOUR WORK! Before starting to use this software make backup of your synths data. For example with "SEND ALL DATA TO MIDI?" function found on your synth using some other software (like you sequencer). Always when starting to edit a new program or loading program into memory initialize all sounds on synthesizer. If you don't, synth may freeze up and display some error message. You can continue only by turning power off and on again on synth. Remember to press store button on synth after you have finished editing pr- ogram or mix! CHECK YOUR SYNTHESIZERS USER MANUAL IF YOU ARE UNFAMILIAR WITH INITIALIZING PROGRAM OR STORING PROGRAM/MIX. @EndNode @Node "Menus" @{b} MENUS@{ub} Project @{" Open... " Link "Open..."} @{" Save As... " Link "Save As..."} @{" About " Link "About"} @{" Quit " Link "Quit"} Mode @{" Program " Link "Program"} @{" Effect " Link "Effect"} @{" Mix " Link "Mix"} @{" Capture " Link "Capture"} Misc @{" Edit Prefs... " Link "Prefs"} @{" Play Controls... " Link "Play Controls..."} This menu shows only when in @{" Program " Link "Program"} or @{" Effect " Link "Effect"} mode. Sound @{" Copy Sound... " Link "Copy Sounds..."} @{" INIT Sound... " Link "INIT Sounds..."} @{" Program Name " Link "Program Name..."} @EndNode @Node "Open..." @{b} PROJECT MENU Open...@{ub} Opens new project to edit and sends parameters to synth. Sends parameters to synth only if set in @{" prefs " Link "Prefs"}. -Opens Program and Effect Parameters if in @{" Program " Link "Program"} or @{" Effect " Link "Effect"} mode. -Opens Mix parameters if in @{" Mix " Link "Mix"} mode. -Opens any data if in @{" Capture " Link "Capture"} mode. Files must be in SysEX format if in PROGRAM, EFFECT or MIX mode. If in CAPTURE mode any data less than 524272 bytes long can be loaded and vie- wed. @EndNode @Node "Save As..." @{b} PROJECT MENU Save As...@{ub} Saves projects parameters. -Saves Program and Effect parameters if in @{" Program " Link "Program"} or @{" Effect " Link "Effect"} mode. -Saves Mix parameters if in @{" Mix " Link "Mix"} mode. -Saves any data if in @{" Capture " Link "Capture"} mode. If in PROGRAM, EFFECT or MIX mode data is saved in Alesis QS-Series SysEX format. @EndNode @Node "About" @{b} PROJECT MENU About@{ub} Fiqure it out all by your self :-) @EndNode @Node "Quit" @{b} PROJECT MENU Quit@{ub} Quits program. @EndNode @Node "Program" @{b} MODE MENU Program@{ub} @{" READ THIS FIRST! " Link "Read This First!"} @{" Windows " Link "Program Windows"} @EndNode @Node "Read This First!" Here you can edit all the parameters found on both KEYBOARD and DRUM modes. Dragging sliders, clicking cycle gadgets and listview gadgets sends parame- ters to synth if serial (or similiar) device opened properly. Gadgets also remember their values if you choose different sound, change to another win- dow or change between different modes. @EndNode @Node "Program Windows" @{b} PROGRAM MODE WINDOWS@{ub} @{" CONTROL SOUND " Link "Control Sound"} @{" MISC " Link "Misc"} @{" ENVELOPE " Link "Envelope"} @{" MODULATION " Link "Modulation"} @{" LFO " Link "LFO"} @{" EDIT DRUMS " Link "Edit Drums"} @EndNode @Node "Control Sound" This window is where you can: -choose to edit KEYBOARD or DRUM parameters -enable or disable sounds -change between different sounds -change between different drums (if in DRUM MODE) -flick between different KEYBOARD mode windows @EndNode @Node "Misc" This window is where you can edit: -VOICE, LEVEL, PITCH, FILTER, and AMP/RANGE parameters. -Special notes about listview gadgets (those with what you choose sample group/sample or modulation sources/destinations)! -Exit from listview gadget by pressing right mouse button and choose like normally with left mouse button. -You may have noticed these files Keyboard.QS and Drums.QS! If Not, you find them from the same directory as where the main program is. They are normal ASCII files wich you can view with your text displa- yer/editor. This is where the sample group and sample names are sto- red for listview gadget. If you have sound card(s) (i don't) you can change sample group and sample names to these files (Keyboard.QS for KEYBOARD mode names and Drums.QS for DRUM mode names). HERE IS HOW YOU DO IT! FIRST COPY FILES TO SOMEWHERE SAFE PLACE. IF YOU MANAGE TO MESS THE FILES TOO BADLY YOU HAVE A BACKUP!!! Start QS-Edit program and choose KEYBOARD or DRUM mode depending on which mode sound/group names you want to replace. Then press button: -'Voice...' at KEYBOARD mode -'Sample Group... | Sample...' at DRUM mode Listview gadgets should pop in front now. There are these weird group names -CART 1...CART 8 and Grp 25...Grp 47 at KEYBOARD mode -CRT D1...CRT D6 and Grp 63 at DRUM mode Press one of those... If after selecting the group name there is reading something else in synths display then in the selected name on computers screen you ha- ve found the right place where to start replacing with right names. Open your text editor and load either file. Find the group name from the first line, let's say it was CART 1 in KEYBOARD mode for exampl- e. Replace text CART 1 with the group name that is in the synth scr- een. Use only 6 letters for the name and leave one space mark, so that there are total of 7 marks. ... CART 1 CART 2 CART 3 CART 4 ... the line is like this ... XXXXXX CART 2 CART 3 CART 4 ... change it to look like this (replace the X marks with the name!!!) REMEMBER TO LEAVE ONE SPACE MARK BETWEEN NAMES!! ! And now let's replace those sample names. It's basically the same thing but now you can use 10 letters for name and leave one space mark, total 11 marks. Find line which starts like this: offCART 1 n/a n/a n/a ... And change n/a slots with the sample names and if you like, delete the word CART 1 and leave word 'off' on it's place. off XXXXXXXXXX XXXXXXXXXX XXXXXXXXXX ... I THINK YOU SHOULD UNDERSTAND IT NOW BUT READ THESE LAST WORDS!!! Pay attention to the space marks between names. If there are no space mar- ks (which stands for 0) QS-Edit program wont be able to lay the names cor- rectly in the listview gadgets. THE QS-Edit PROGRAM MAY EVEN CRASH. Espec- ially when changing last name in line be sure you don't leave too many or any less marks. These instructions are only my guessing, because I don't have any sound c- ards to test. But I think this is the way it goes. @EndNode @Node "Envelope" This window is where you can edit: -PITCH, FILTER and AMPLITUDE envelope parameters. @EndNode @Node "Modulation" This window is where you can edit: -MODULATION and TRACK GENERATOR parameters. @EndNode @Node "LFO" This window is where you can edit: -PITCH, FILTER and AMPLITUDE LFO parameters. @EndNode @Node "Edit Drums" This window is where you can edit: -DRUM mode parameters. Use @{" CONTROL SOUND " Link "Control Sound"} windows 'Drum Number' slider to change between different drums. @EndNode @Node "Effect" @{b} MODE MENU Effect@{ub} @{" READ THIS FIRST! " Link "Read This First!!"} @{" Windows " Link "Effect Windows"} @EndNode @Node "Read This First!!" Here you can edit all the parameters found on EFFECT mode. Dragging slide- rs, clicking cycle gadgets and listview gadgets sends parameters to synth if serial (or similiar) device opened properly. Gadgets also remember their values if you choose different sends change to another window or change be- tween different modes. @EndNode @Node "Effect Windows" @{b} EFFECT MODE WINDOWS@{ub} @{" Control Sends " Link "Control Sends"} @{" Reverb " Link "Reverb"} @{" Delay " Link "Delay"} @{" Pitch " Link "Pitch"} @{" Lezlie / Overdrive " Link "LezlieOverdrive"} @EndNode @Node "Control Sends" This window is where you can: -choose different sends -choose effect configuration -edit MODULATION parameters -edit EQ parameters if in configuration -flick between different EFFECT mode windows @EndNode @Node "Reverb" This window is where you can: -edit REVERB parameters @EndNode @Node "LezlieOverdrive" This window is where you can: -edit LEZLIE and OVERDRIVE parameters @EndNode @Node "Delay" This window is where you can: -edit DELAY parameters @EndNode @Node "Pitch" This window is where you can: -edit PITCH parameters THERE IS SOMETHING WRONG IN PITCH SEND 3, IT MAY NOT SEND ALL PARAMETERS ON SOME CONFIGURATIONS. AND I DONT'T KNOW WHY!!! EDIT THESE PARAMETERS WITH SYNTHESIZERS CONTROLS ALSO!!! @EndNode @Node "Mix" @{b} MODE MENU MIX@{ub} Here you can edit all the parameters found on MIX mode. Dragging sliders and clicking cycle gadgets sends parameters to synth if serial (or similiar) device opened properly. Gadgets also remember their values if you choose different channels or change between different modes. On the bottom right corner there is MIX GROUP CHANNEL selector for QSR, I don't know if this works on other synths. There is also cycle gadget to activate GENERAL MIDI! The MIDI Group/Keyboard cycle gadget is named like that, because on QSR it activates MIDI Group and on others the KEYBOARD. @EndNode @Node "Prefs" Here you can select another device or different unit number. Also here are options to turn off parameter sending to synth! Open Device = if set, device is open and will be tried to open when program is loaded. If not, just the opposite. Open Shared = If set, other programs can use the same device. If not, the device is completelly at our use. Set this to off if you int- end to use the capture facility so that you don't loose any data for sure. Unit = defaults to 0, serial port found on every amiga. Other unit numbers are for extra ports added later to system with expan- sion boards. Device Name = select another device for sending parameters to serial port. Defaults to serial.device. Send PROGRAM, EFFECT and MIX parameters to synth after load = if set, when you load project, parameters will also be send to synth. SAVE = save current settings to disk USE = use current settings but don't save CANCEL = exit without changing settings @EndNode @Node "Play Controls..." If you don't have a keyboard and want to test modulation, pitchbend, aft- ertouch and velocity controllers effect on your programs and mixes. Also you can play different notes with these keys: 2 3 5 6 7 9 0 = \ q w er t y ui o p [ ] s d g h j l ; z x cv b n m, . / There is also octave, notes off, program change and midi channel selectors. Octave can be changed by pressing F1 and F2, press SPACE to send notes off message. @EndNode @Node "Copy Sounds..." Here you can copy sounds to another sound or to buffer. If you want some sound to another program: - Copy it to buffer. - Load another program. Maybe now you want to turn off the parameter sending to synth found on the @{" Prefs " Link "Prefs"} editor. - Select the same buffer as source and copy it to sound of your choi- ce. Parameters will also be send to synth. @EndNode @Node "INIT Sounds..." Here you can INIT parameters to match the values as if they vere INITiali- zed with synths controls. INIT can be done as KEYBOARD or DRUM init. This init actually only sends values to synth, which match the values if the so- und would have been really initialized with synths controls manually. SO DON'T CONFUSE THIS WITH THE REAL INITIALIZE FOUND ON SYNTHS CONTROLS! In KEYBOARD mode: - INIT SOUND = INITializes keyboard parameters from the current sound. - INIT DRUM = is obsolete in this mode. In DRUM mode: - INIT SOUND = INITializes all 10 drums parameters at the current so- und. - INIT DRUM = INITializes only parameters at the current drum. @EndNode @Node "Program Name..." Enter here name for your program. Use only the characters which are shown in the window for avoiding problems. AND REMEMBER TO ALWAYS PRESS ENTER SO THAT THE CHANGES TAKE PLACE. Name will be printed at the screens title bar and send to synth. These same instructions apply also to mixes name found on @{" Mix " Link "Mix"} window. @EndNode @Node "Capture" @{b} MODE MENU Capture@{ub} @{" READ THIS FIRST! " Link "Read This First!!!"} @{" Features " Link "Capture Mode Features"} @EndNode @Node "Read This First!!!" In this mode you can capture/dump SysEX messages via MIDI from your syn- thesizer. And you can copy parameters found on those dumps to editors. Capture is done automatically by first sending dump request message to synth. So you must only turn synth on and not needing to send message manually with "MIDI PRG", "MIDI MIX" or "SEND ALL DATA TO MIDI" functi- ons found on STORE mode. Of course this can be switched off if you want to dump data manually (ie. using some different synth model). Also there is the handy LISTVIEW gadget with what you can easily view ALL messages contents (explained on the "Capture Mode Features"). MAYBE YOU SHOULD SET THE OPEN SHARED TO OFF WHEN USING THE CAPTURE FACI- LITY SO THAT THE DATA IS REALLY FROM THE SYNTH AND NOT FROM ANYWHERE EL- SE. SET IT TO OFF AT THE @{" Prefs " Link "Prefs"} editor. @EndNode @Node "Capture Mode Features" Let's look at those gadgets found on the right side of the window first. NUMBER = Select with this slider the PROGRAM+EFFECT or MIX that you want to capture/dump from/to the "USER MEMORY". You can select: - PRG+FX 0-127, MIX 0-99 - And if you drag the slider all the way to right it sho- uld say BUF on the place of the usual numbers. This me- ans that you can also capture the EDIT BUFFER dependi- ng of the CAPTURE MODE. You can also dump messages to EDIT BUFFER with the same manner. CAPTURE MODE = Select with this cycle gadget what you want to capture. Possible modes: - PROGRAM+EFFECT - MIX - ALL CAPTURE = IF YOU WANT TO CAPTURE PROGRAM+EFFECT CHANGE MODE WITH SYNTHS CONTROLS TO 'PROG', AND IF MIX CHANGE IT TO 'MIX' THIS COULD HAVE BEEN DONE AUTOMATICALLY BY SENDING CHA- NGE MODE MESSAGE TO SYNTH BUT I FOUND IT TO BE LITTLEB- IT CONFUSING. Start Capturing. After an succesful capture the bytes that were captured are printed on the screen. And if c- aptured an PROGRAM+EFFECT or MIX the name of it will a- lso be printed so that you can be sure that you got the right one. Capture can be stopped with ESC button. AUTO CAPTURE = In AUTO CAPTURE mode the capture is done automatically by first sending an "dump request message" to synth on which it will then respond with a dump depending of the CAPTURE MODE. Change this to MANUAL CAPTURE and you can capture mess- ages by sending them manually with synths controls. DUMP->SYNTH = Click this button to dump message to synth. You can ch- ange the memory location on which it will be sended wi- th the NUMBER slider explained earlier. If you are dum- ping PROGRAM+EFFECT an requester will ask you if you want to dump PROGRAM, EFFECT or BOTH parameters. COPY TO EDITOR = With this button you can copy parameters to PROGRAM+E- FFECT or MIX editors depending of the message type. If copying PROGRAM+EFFECT an requester will ask you if you want to copy PROGRAM, EFFECT or BOTH parameters. CLEAR BUFFER = Clears capture buffer so that another message can be captured. YOU CAN ALSO ENTER THE CAPTURES SIZE MANUALLY BY CLICKING THE INTEGER GADGEDT WHICH SHOWS THE CAPTURE SIZE (491 for PROGRAM+EFFECT, 166 for MIX and 79479 for ALL). SO YOU CAN CAPTURE MESSAGES FROM OTHER MANUFACT- RES SYNTHESIZERS. YOU CAN @{" SAVE " Link "Save As..."} MESSAGES TO DISK AND @{" OPEN " Link "Open..."} MESSAGES FROM DISK. The LISTVIEW gadget found from the bottom right corner of the window. When captured or opened from an disk an ALL type of message, this gadget will be filled with the names contained by the message. First there are PROGRAM+EFFECT names and then MIX names. Every time you click on an name an operation defined by the cycle gadget under it will be done. The ope- rations: TEST PROGRAM/MIX = PROGRAM+EFFECT or MIX will be send to synths EDIT BUFFER, nothing will be changed from your synths m- emories. This is an handy way to check what kind of programs there are in that ALL message. COPY TO EDITOR = Copies parameters found on PROGRAM+EFFECT or MIX to corresponding editor. If copying PROGRAM+EFFECT an requester will ask you if you want to copy PROGRAM, EFFECT or BOTH parameters. COPY->SysEX EDITOR = Replaces ALL message with single PROGRAM+EFFECT or MIX message at the capture buffer. SAVE PRG/MIX AS... = Saves one PROGRAM+EFFECT or MIX to disk. I guess it's also nice to explain the large area where the numbers appe- ar when message is captured/opened. I added this that you can see easilly that capture was succesful. At least for now you can't edit those numbe- rs only view them and scroll the area with the scroller gadget. It is an custom to put those numbers as HEXADESIMAL. IF YOU DON'T KNOW HOW TO READ THEM, IT SHOULD NOT MATTER. @EndNode