@database RolandJV1080.guide @author "Jon Rocatis" @(c) "Copyright İ 1996 Jon Rocatis" @wordwrap @$VER: JV-1080 Documentation (17.3.96) @node main "Roland JV-1080 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 XX XXXX XXXX XXXX XX XX XX XXX XX XX XX XX XX XX XX XX XX XX XX XX XXXX XX XX XX XX XX XX XX XX XX XX XX XX XX XXXX XXX XX XXXX XXXX XXXX v1.0 by Jon Rocatis Design by Simon Holm @{" 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-1080/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-1080/Registration" To register the JV-1080 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-1080 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-1080 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-1080/Introduction" @{u}The Roland JV-1080 Apache Plug-In@{uu} Welcome! This plugin module gives you total control and easy access to all of the JV-1080's features. Creating your own sounds have never been easier or as much fun! You are able to store patches on your harddisk - you are no longer limited to work with max. 128 patches. 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-1080/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. · 68020 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-1080 synth module are required if you want to hear the sounds you create :) @endnode @node HISTORY "JV-1080/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 Apache 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 - 17 Mar 1996@{ub} First release. @endnode @node MENU "JV-1080/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. Tone Tool Opens the @{" Tone Tool window " link TOOL} 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-1080 plugin all the windows currently open will open automatically. Print Patch Debug tool for the programmer. (will probably be removed later) Print EFX-Params Debug tool for the programmer. (will probably be removed later) MUI... Opens the MUI settings program, so you can change the user interface to suit your taste.. @endnode @node THANKS "JV-1080/Thanks" I thank Simon Holm for designing the user interface and doing a lot of tedious testing + letting me create some truly horrible sounds on his JV-1080! :) Thanks to Gary Goldberg for typing all the waveforms for the Orchestral expansion module and all the other betatesters. Thanks to Stefan Stuntz for MUI. Great stuff - just keeps getting better and better! @endnode @node DISC "JV-1080/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-1080/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-1080 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-1080. With the string gadget below you can change the name of the patch. Only the characters that are displayable in the JV-1080'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-1080. · 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-1080. Only useful if you don't use the @{b}real time updating@{ub} feature. · Receive Receives a patch from within the JV-1080's user patch bank. The patch to receive is determined by the current patch's number. @endnode @node PREF "JV-1080/Settings window" The settings window is where you can edit the functionality and look of the JV-1080 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-1080@{ub} here and you save a patch with the name @{b}MegaBass@{ub} the file will be called @{b}MegaBass.JV-1080@{ub}. [Not implemented yet] · Unit # This is the device unit number of your JV-1080. · Expansion modules This is the place where you can configure which expansion modules you have in your JV-1080 and where. 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 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-1080 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-1080/Patch Bank window" This is the patch bank window. @{u}What's in the window@{uu} The main listview gadget contains your patch bank. · Load Bank Loads a patch bank from disk. Opens filerequester. · Save Bank Saves a patch bank to disk. Opens a filerequester. · Load Patch Brings up a filerequester where you can select a patch to load. The loaded patch will replace the currently active entry. · Save Patch Saves the currently active patch. Brings up a filerequester. · Store Current 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. · Remove Removes the currently selected patch. · Send Pressing this button will send the whole patch bank to the JV-1080. Only the used entries will be send thus saving transfer time. · Receive Pressing this button opens a window where you enter the desired range of patches to receive from the user patch memory in the JV-1080. The default is all the user patches in the JV-1080. Hitting the okay button will start the transfer. @endnode @node PCMN "JV-1080/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-1080/Patch Effects window" The effect-windows that pop-up are not working as they are supposed to at the moment so don't rely on them. The stuff in the main Patch Effects window is okay though.. @endnode @node TCTR "JV-1080/Tone Control window" @endnode @node WAVE "JV-1080/Wave window" @endnode @node LFO "JV-1080/LFO window" @endnode @node PITC "JV-1080/Pitch window" @endnode @node TVF "JV-1080/TVF window" @endnode @node TVA "JV-1080/TVA window" @endnode @node TOOL "JV-1080/Tone Tools window" This is the Tone Tools window. With this window you can copy parts of a Tone to 1 or more Tones within the same patch. In the source group you select which Tone to copy FROM. With the checkmark gadgets on the right you select which Tones will be affected by your operations. The section group controls which @{b}sections@{ub} of a Tone will be affected by your operations. The invert button will invert your selections and the clear button will clear your selections. The Copy button will copy your selected sections from the selected source Tone to the selected destination Tones. The window will close after the operation is completed. The Reset button works the same way as the copy button but instead of copying sections it resets the sections to that of the default patch. The cancel button closes the window and leaves your patch intact. @endnode @node AUTH "JV-1080/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-1080/Technical stuff" This JV-1080 plugin was developed using SAS/C v6.56 on an Amiga 4000/040. The source code is about 14000 lines long and takes up approx. 420K! @endnode @node BUGS "JV-1080/Known Bugs" No known bugs. Well, yet.. 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-1080 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-1080/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. · Drag and drop support between the main window and the patch bank window. @endnode @node EXPBOARDS "JV-1080/Expansion Boards" At the moment only the Orchestral expansion module is supported - BUT 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