@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.0 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 "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 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.0 - 26 May 1996@{ub} First release. @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 If this one is selected you are editing on all 4 Tones at the same time! 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 to Nico Theuns for beta-testing and for typing the waveforms for the Vintage expansion module. 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 #. · Comments · Set Patch # Pressing this button will bring up a window where you can edit the patch's number. This is the user patch number in the JV-80. · 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. @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. · @{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 a patch to load. The loaded patch will replace the currently active entry. · @{b}Save Patch@{ub} Saves the currently active patch. Brings up a filerequester. · @{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. · @{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. @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" There is a bug in the wave window when selecting other waves than the built in.. I'm looking into this.. If you find more 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. · Graphical editing of the various envelopes (already in the JV-1080 module so this should be coming soon). @endnode @node EXPBOARDS "JV-80/Expansion Boards" Currently supported expansion boards: · Orchestral · Vintage 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 a special number not currently used - just write 2 or something. The rest of the file is the waveform names. The first character can be either 'L' or 'O'. Looping or Oneshot. 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. @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