@database RolandJV80.guide @author "Jon Rocatis" @(c) "Copyright İ 1996 Jon Rocatis" @wordwrap @$VER: JV-80 Documentation (15.4.96) @node main "Roland JV-80 Plug-In" - Apache PlugIn - XXXXX XXXX XX XXXX XX XX XXXXX XX XX XX XX XX XX XX XXX XX XX XX XXXXX XX XX XX XXXXXX XXXX XX XX XX XX XX XX XX XX XX XX XX XXXX XX XX XX XX XXXX XXXXX XX XX XX XXX XXXXX XXXXXX XX XX XXXX XXXX XX XX XX XX XX XX XX XX XX XX XX XXXX XX XX XX XX XX XX XX XX XX XX XXXX XXX XXXX XXXX v1.59 by Jon Rocatis @{" What is this? " link INTRO} What is it all about? @{" Requirements " link REQ} Which computers can this program run on? @{" Menus " link MENU} What's in the menu? @{" Windows " link WIN} Description of the many windows @{" Expansion boards " link EXPBOARDS} How to add support for more expansion boards @{" License " link LISC} What you may and may not do @{" Disclaimer " link DISC} Warranty? No warranty @{" Registration " link REG} How to register @{" Contacting Author " link AUTH} How to reach author if you got something to say @{" Technical stuff " link TECH} Techno babble.. @{" Future " link FUTURE} What will the future bring? @{" Known bugs " link BUGS} Bugs? What bugs!? @{" Thanks... " link THANKS} The author wishes to thank... @{" Program History " link HISTORY} Description of each release @endnode @node WIN_TSLC "JV-80/Tone Select/Edit" This window determines which Tone you will see in the windows and which Tones will be affected by changes made by you. The currently selected Tone which you see in the windows is always edited. By using the "All/None" function you can quickly edit all the Tones or just the selected one. @endnode @node WIN "JV-80/Windows" Click on a button to get info on that particular window. All the windows have context sensitive help so you can just press the button to get help on the currently active window. @{" Main window " link WIN_MAIN} @{" Patch bank window " link WIN_PBNK} @{" Patch common window" link PCMN} @{" Patch Effects window" link PEFX} @{" Settings window " link PREF} @endnode @node REG "JV-80/Registration" To register the JV-80 PlugIn module please fill in the form below and send it to me together with the cash. Please make sure that your money can't be seen through the envelope! The registration fee is 30 USD. You will receive a disk containing your personal keyfile together with the latest version of both Apache and the JV-80 PlugIn module. You can also choose to receive your keyfile by E-mail only and just pay 25 USD. You will receive your keyfile quicker this way and save me the hassle with preparing and sending disks. O / ---X------CUT---CUT----------------------------------------------------- O \ Registration form for the JV-80 Apache PlugIn Module To: Jon Rocatis Askergate 1, lejl. 108 0475 Oslo NORWAY Name: ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ Street: ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ ZIP, City: ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ Country: ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ E-mail: ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ Amiga Setup: (OS/CPU/ ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ RAM/HD etc) ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ I want my keyfile via E-mail and get a $5 discount: YES/NO I have read the Copyright note and the license details and do agree. ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ (City, Date) (Signature) PS: Please make sure that I can read what you write! O / ---X------CUT---CUT----------------------------------------------------- O \ @endnode @node INTRO "JV-80/Introduction" @{u}The Roland JV-80 Apache Plug-In@{uu} Welcome! This PlugIn module gives you total control and easy access to all of the JV-80's features. Creating your own sounds have never been easier or as much fun! This program is an Apache PlugIn so you need to have Apache installed. See @{" Requirements " link REQ} This program is ShareWare. In the evaluation version you cannot save your patches or patchbanks. By @{" registering " link REG} you will not only support the author and further development of the program but also get a keyfile that will enable the save functions. @endnode @node REQ "JV-80/Requirements" First of all: This program requires Apache to run. Apache acts like a home for plug-in modules like this. Apache can be found on Aminet in mus/midi/apache.lha Other requirements: · Kickstart 2.0 or better. · MUI v3.3 or better. (Magic User Interface) · At least 1MB of RAM. More is recommended. · A MIDI interface and a Roland JV-80 synth module are required if you want to hear the sounds you create :) @endnode @node MENU "JV-80/Menu" @{" Project " link MEN_PRJ} @{" Patch/Tones " link MEN_PT} @{" Miscellaneous " link MEN_MISC} @endnode @node MEN_PRJ "Project Menu" @{b}Project@{ub} Load Patch... See @{" Main Window " link WIN_MAIN} Save Patch... See @{" Main Window " link WIN_MAIN} Send Sends a patch. See @{" Main Window " link WIN_MAIN} Receive Receives a patch. See @{" Main Window " link WIN_MAIN} Iconify Iconifies the PlugIn. Help Opens the AmigaGuide help. About Plug-In Shows information about this PlugIn. Quit Quits the PlugIn. If you have any unsaved changes you will get a chance to abort quitting. @endnode @node MEN_PT "Patch/Tones Menu" @{b}Patch/Tones@{ub} Tone 1 Determines which Tone you are editing. 2 - 3 - 4 - All/None With this you can select all Tones for editing or just the current Tone. See also @{" Tone Select Window " link WIN_TSLC} Patch List Opens the @{" main window " link WIN_MAIN} Patch Common Opens the @{" Patch Common window " link PCMN} Patch Effects Opens the @{" Patch Effects window " link PEFX} Patch Bank Opens the @{" Patch Bank window " link WIN_PBNK} Tone Control Opens the @{" Tone Control window " link TCTR} Tone Wave Opens the @{" Tone Wave window " link WAVE} Tone LFO Opens the @{" LFO window " link LFO} Tone Pitch Opens the @{" Pitch window " link PITC} Tone TVF Opens the @{" TVF window " link TVF} Tone TVA Opens the @{" TVA window " link TVA} All Opens ALL the windows. This may take a while depending on the speed of your system. Patch/Tone Strip Opens the control strip window. This is a window that gives you fast and easy access to all the other windows. @endnode @node MEN_MISC "Miscellaneous Menu" @{b}Miscellaneous@{ub} Reset Paths In the @{" settings window " link PREF} you can set paths up for your patches and patch bank. The filerequesters remembers where you last were, so if you have loaded a patch from ex. DF0: and your normal path is somewhere on your HD it can quite irritating to click through thousand of drawers to get back. Selecting "reset paths" will make the filerequesters use the paths you've set up in the settings window again. Gadget Help... Opens the gadget help window. Place the mouse-pointer over a gadget you wanna know more about. This is mostly to explain what effect the different gadgets have over the sound. Settings... Opens the settings window. Save Window Config Saves information about the currently open windows. The next time you start the JV-80 PlugIn all the windows currently open will open automatically. MUI... Opens the MUI settings program, so you can change the user interface to suit your taste.. @endnode @node THANKS "JV-80/Thanks" I thank Simon Holm for designing the user interface for the JV-1080 PlugIn module. This design was used heavily when constructing the interface for the JV-80 PlugIn. Thanks for typing the waveform names for the expansion modules goes to: SR-JV80-01 Pop - Unknown (no waveform type information) SR-JV80-02 Orchestral - Gary Goldberg. SR-JV80-03 Piano - Unknown (no waveform type information) SR-JV80-04 Vintage - Nico Theuns. SR-JV80-05 World - Unknown (no waveform type information) SR-JV80-06 Dance - Weber Markus. SR-JV80-07 Super Sound Set - Unknown SR-JV80-08 60 and 70's - Unknown Thanks to Nico Theuns for beta-testing and Weber Markus for testing, ideas and registering :) Thanks to Stefan Stuntz for MUI. Great stuff - just keeps getting better and better! @endnode @node DISC "JV-80/Disclaimer" @{b}Disclaimer@{ub} No warranty, either express or implied, is made with respect to the fitness or merchantability of this program. Jon Rocatis (referred to as "the author"), reserves the right to not develop any future versions of this program. The author will try to make a good faith attempt at correcting any problems if any are discovered, but is in no way required, nor bound to correct them. The author neither assumes nor accepts any responsibility for the use or misuse of these programs. He will also not be held liable for damages due to loss of profit or any other damages arising out of the use, or inability to use this program. The author will not be liable for any damage arising from the failure of this program to perform as described, or any destruction of other programs or data residing on a system attempting to run the programs. The user of this program uses it at his or her own risk. @endnode @node WIN_MAIN "JV-80/Main window" This is the main window. This is the place where you create, save and load your patches. When you close this window you also close the whole JV-80 PlugIn module itself - all windows will be closed automagically. If you have any unsaved changes you will get a chance to regret quitting. @{u}What's in the window@{uu} The main listview gadget contains your patches. When you select a patch the patch will be send via the MIDI port to the JV-80. With the string gadget below you can change the name of the patch. Only the characters that are displayable in the JV-80's display can be entered here.. If a patch has been changed it will get a "*" in front of it's name. The window title shows which Tone you are editing. If you are editing all 4 tones at a time you'll see a "All" after the tone #. · Load Brings up a filerequester where you can select a patch to load. The chosen patch will be loaded into the currently selected patch. You can also load raw system exclusive dump patch files from programs like SysExpert. · Save Saves the currently selected patch. Brings up a filerequester where you can specify the filename. See also @{"Settings window" link PREF} · New & Load Creates a new patch and opens a filrequester where you choose the patch to load. · Save * Saves all the patches that are marked as changed. · New Creates a new patch. The patch will be a copy of the currently selected patch. · Remove Removes the currently selected patch. · Send Sends the currently selected patch to the JV-80. Only useful if you don't use the @{b}real time updating@{ub} feature. · Receive Receives a patch from within the JV-80's user patch bank. The patch to receive is determined by the current patch's number. @{u}How to set the Patch #@{uu} Double clicking on an entry in the listview will bring up a window where you can edit the patch's number. This is the user patch number in the JV-80. @endnode @node PREF "JV-80/Settings window" The settings window is where you can edit the functionality and look of the JV-80 PlugIn. @{u}What's in the window@{uu} · Patch Path Here you can specify where you want your patches to be. · Patch Bank Path Here you can specify where you want your patch banks to be. · File postfix The contents of this string gadget will be added to all the files you save. Ex. if you have entered @{b}.JV-80@{ub} here and you save a patch with the name @{b}MegaBass@{ub} the file will be called @{b}MegaBass.JV-80@{ub}. [Not implemented yet] · Unit # This is the device unit number of your JV-80. · Expansion modules This is the place where you can configure which expansion module you have in your JV-80. Press the popup-gadget and a listview gadget pops up showing you the available expansion modules. Select a expansion-module by double-clicking on an entry. Now you will be able to select the waveforms in the @{" wave window " link WAVE} just as you select one of the built-in waveforms. @{b}Note:@{ub} You'll have to save the settings, quit and restart the JV-80 module before these changes will have any effect. Sorry about that - maybe I'll do something about it later.. · Listview Titles With these checkmark gadgets you can change the look of the titles in the listview gadgets. You can mix the different text attributes as you please. Ex. Bold underline is perfectly okay.. · Show. With this one you can enable or disable the titles. · Bold. The titles will be in bold. · Italics. The titles will be in bold. · Underline. The titles will be underlined. · Control Strip The control strip is a window where you can open any of the windows in this PlugIn. It gives you a fast way to open (or activate) the many windows. You can change the look of the window: · Equal Size Buttons. If checked all the buttons in this window will be the same size. · Horizontal/Vertical. Specifies how you want the layout of the window. The @{b}Save, Use and Cancel@{ub} buttons acts like in any other preferences window. @endnode @node WIN_PBNK "JV-80/Patch Bank window" This is the patch bank window. @{u}What's in the window@{uu} The main listview gadget contains your patch bank. In the window's title bar you can see how many entries in the patch bank that are currently used. · @{b}Load Bank@{ub} Loads a patch bank from disk. Opens filerequester. · @{b}Save Bank@{ub} Saves a patch bank to disk. Opens a filerequester. · @{b}Load Patch@{ub} Brings up a filerequester where you can select one or more patches to load. The loaded patch will replace the currently active entry. If you load more than one patch they will be placed one after the other overwriting any existing patches in your bank. · @{b}Save Patch@{ub} Saves the currently selected patches. Brings up a filerequester. If only one patch is selected you can specify the file name and destination directory of the patch. If more than one patch is selected you just select destination directory and all the patches will be saved there with their current names as the file name. · @{b}Store Current@{ub} Pressing this button will copy the currently selected patch in the @{"Main window" link WIN_MAIN} to the currently selected entry in this, the patch bank window. · @{b}Remove@{ub} Removes the currently selected patch(es). If more than one patch is selected a confirmation requester pops-up enabling you to abort the removal. · @{b}Send@{ub} Pressing this button will send the whole patch bank to the JV-80. Only the used entries will be send thus saving transfer time. · @{b}Receive@{ub} Pressing this button opens a window where you enter the desired range of patches to receive from the user patch memory in the JV-80. The default is all the user patches in the JV-80. Hitting the okay button will start the transfer. @{u}Drag'n'drop@{uu} You can use drag'n'drop to rearrange the order of the patches in the listview. You can also drag patches from the main window to the patch bank. @{u}Renaming of patches@{uu} You can rename a patch in the patch bank by double-clicking on the patch you want to rename. A window pops up where you can type the new name. Double- clicking on an empty entry has no effect. Instead of double-clicking you can also press (well, this depends on how your MUI is set up) @endnode @node PCMN "JV-80/Patch Common window" In this window you can change common patch parameters. Note that you can also change the patch name in the @{" main window " link MAIN} @endnode @node PEFX "JV-80/Patch Effects window" @endnode @node TCTR "JV-80/Tone Control window" @endnode @node WAVE "JV-80/Wave window" In the Wave window you can edit wave-parameters for a Tone. If you have a expansion board in your JV-80 you must specify which one. This is done in the @{" settings window " link PREF} @endnode @node LFO "JV-80/LFO window" This is the window where you control the two LFO's. Low Frequency Oscillators. @endnode @node PITC "JV-80/Pitch window" This is the pitch window where you edit parameters that controls the pitch. The big gadget at the bottom controls the pitch @{" envelope " link ENVELOPE} @endnode @node TVF "JV-80/TVF window" This is the TVF window where you edit parameters that controls the TVF. The big gadget at the bottom controls the @{" envelope " link ENVELOPE} @endnode @node TVA "JV-80/TVA window" This is the TVA window where you edit parameters that controls the TVA. The big gadget at the bottom controls the @{" envelope " link ENVELOPE} @endnode @node AUTH "JV-80/Contacting author" @{u}Author@{uu} If you have any comments, ideas, criticism or bug reports, don't hesitate to contact me. E-mail preferred. Jon Rocatis - SideFX / Software Development ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ E-mail: jon@funcom.com Snail-mail: Jon Rocatis Askergate 1, lejl. 108 0475 Oslo NORWAY @endnode @node TECH "JV-80/Technical stuff" This JV-80 PlugIn was developed using SAS/C v6.56 on an Amiga 4000/040. The source code is about 9000 lines long and takes up approx. 227K @endnode @node BUGS "JV-80/Known Bugs" If you find any please tell @{" me " link AUTH} about them! @endnode @node LISC "License" @{b}@{u}Licence Agreement@{ub}@{uu} This, the Roland JV-80 Apache PlugIn module, is offered to you under the concepts of ShareWare. You can use it for an evaluation period of up to 4 weeks without paying any charge. If you are going to use the PlugIn module after the evaluation period, you MUST @{" register " link REG}. By copying, distributing and/or using the program you indicate your acceptance of this license to do so, and all its terms and conditions. @{u}You may@{uu}: · Install and use this software for your personal use on a single microcomputer · Make verbatim copies of the original distribution archive without any files being omitted/added/changed. · Distribute those copies of the software if NO charge is asked for, except for the media. · Upload the software to as many BBSes as you like. @{u}You may @{b}NOT@{ub}@{uu}: · Copy and/or distribute this program without the accompanying documentation and other additional files that come with the original distribution archive. · Alter the software and/or the accompanying files in any way. · Copy and/or distribute modified version of this program. · Decompile, disassemble,translate, convert to another programming language or otherwise reverse engineer the software. · Grant sublicences, leases or other rights in the software. · Rent the software to others. @endnode @node FUTURE "JV-80/Future plans" I have some ideas for future versions: · A better file format for patch banks that doesn't save all the unused entries in the patch bank. · User adjustable colours for the envelope gadgets @endnode @node EXPBOARDS "JV-80/Expansion Boards" Currently supported expansion boards: SR-JV80-01 Pop SR-JV80-02 Orchestral SR-JV80-03 Piano SR-JV80-04 Vintage SR-JV80-05 World SR-JV80-06 Dance SR-JV80-07 Super Sound Set SR-JV80-08 60's and 70's Keyboards If you have another expansion board it is quite easy (although tedious) to add support for that one too! Take a look at the file "Exp.Orchestral". It's a normal ASCII text file. It contains all the waveforms for the Orchestral board. If you have, let's say, the Dance expansion board you create a file called Exp. where is the name you want to use in the wave window's waveform selection gadget. The first line must have a special format: WAVES <#waves> The <#waves> is simply the number of waveforms in the expansion board. The is the number of the expansion board. Ex. Piano is #3.. The rest of the file is the waveform names. The first character can be either 'L', 'O', 'M'. Looping, Oneshot or Menu. If you don't know what type a waveform is type '-' Happy typing! :) If you create a new expansion board file please send it to me so that I can add it for the next release. You will of course be credited :) @endnode @node ENVELOPE "JV-80/Envelope Editor" The TVA, TVF and Pitch windows features a special gadget: @{b}The envelope gadget@{ub}. This gadget allows you to edit an envelope graphically with your mouse. @{u}How does it work?@{uu} If you click the left mouse button over one of the knobs (and keep it pressed you can drag the knob around). This functions just like when you are dragging icons on the Workbench. You can fine-adjust a knob by clicking outside the knob. Clicking to the left will move the knob left by 1. Clicking above the knob will move the knob up by 1 etc. etc.. @endnode @node HISTORY "JV-80/History" Program history - a description of each release. Note: I use C='s definition of version numbers. Ex. 1.10 is newer than 1.5! In fact every time I make a change in the sourcecode and I compile this PlugIn the version number gets increased by one! I use the following 3 letter IDs to describe changes: FIX - Bug fix NEW - New feature CHG - Change in behaviour from previous versions @{u}History:@{uu} (Newest on top) @{b}v1.59 - 21 Jul 1996@{ub} · NEW. You can now remove more than one patch at a time in the patch bank window. · NEW. Patch Bank window has multi-patch-save if more than one patch is selected. · NEW. Loading of patches now supports multi-selection! Both the main window and the patch bank window · NEW. New layout in tone select window. Horizontally placed selection buttons gives the window a bigger dragbar as a side effect. · FIX. If you played around with MUI-prefs and then tried to use a filerequester things would blow up! · FIX. If you deleted the expansion board in the prefs window it didn't disappear - it only looked that way! · NEW. You can now drag patches from the patch bank window to the patch list (main) window. Only one at a time though :-\ · NEW. You can now rename patches in the patch bank window. Double click on an entry and a window pops up.. · NEW. Hotkey on the "Remove" button in the patch bank window. @{b}v1.13 - 18 Jun 1996@{ub} · NEW. Added waveform files for 4 more expansion boards. · NEW. Envelope-value readouts in Pitch, TVA and TVF windows. · NEW. New window just for selecting which Tone you are looking at and which Tones will be affected by changes. You can now edit ex. Tone #1 and Tone #3 at the same time. @{b}v1.5 - 8 Jun 1996@{ub} · FIX. Fixed the selection of waveform groups. Before only the internal ones could be selected. · NEW. Support for "Menu" waveform types in the Waveform listview.. · NEW. Waveform names for the "Dance Expansion module" included. @{b}v1.0 - 26 May 1996@{ub} First release. @endnode