home *** CD-ROM | disk | FTP | other *** search
/ EuroCD 3 / EuroCD 3.iso / MIDI / Utilities / CS1x-Ed / english / DOC / cs1x.text < prev   
Encoding:
Text File  |  1998-06-24  |  19.8 KB  |  515 lines

  1. Document cs1x-editor.guide
  2.                 
  3.                            CS1x- Documentation
  4.                        ~~~~~~~~~~~~~~~~~~~~~~~~~~
  5.                   Release 01.00 © Udo Gantner 1996/97
  6.  
  7.  
  8. 1. Introduction
  9.    ------------
  10.  
  11.  This synthesizer of Yamaha is extremly hot !!! 
  12.  After I had bought that thing and had heard all the demosongs, I was
  13.  totally inspired.
  14.  This synthesizer for now is unbeatable in value against price. 
  15.  After I've worked through the included Blue-Book and the tutorium, I realized
  16.  that are still more possibilities than I'd exspected.
  17.  
  18.  The paticular thing of this synthesizer is the Performance-Mode.  
  19.  This mode enables you to layer up to four voices to one midichannel while using
  20.  the rest of midichannels with the XG-Mode.
  21.  
  22.  This means, that you can create a sound by layering up to four voices, control it 
  23.  with one midichannel and you still have 12 midichannels left for use with other
  24.  samples.
  25.  What other synthesizer can do that ??
  26.  
  27.  This program is for those of you, who like that Performance-Mode and like to
  28.  create Performances on your own. 
  29.  
  30.      
  31. 2. Installation
  32.    ------------
  33.  
  34.  The installation is verry easy:  
  35.  
  36.  A.You have to create a directory on your harddisk and to put an assign on that directory
  37.    with "CS1xed:" or to format a disk and name it "CS1xed".  
  38.  B.Than you have to copy CS1x-Editor and the directories "System", "Dok" and "SysexDump"
  39.    to "CS1x-ed:"
  40.  C.Thats all
  41.  
  42. 3. The program CS1x-EDITOR      
  43.    ------------------------
  44.  
  45.  The creation of a performancebank with CS1x-Editor bases on following idea.
  46.  You have a `Referencebank' and a `Userbank', by those you built your own Performance-
  47.  bank. 
  48.  At programstart the `Userbank' is filled with 128 Initperformances. You can pick one
  49.  Initperformance and edit its parameters or you can copy one Performance after the other
  50.  from the buffer of the `Referencebank' to the `Userbank' and work with them.
  51.  You can allways fill the buffer of the `Referencebank' with Performancebanks you load
  52.  from disk or receive from CS1x by midi.
  53.  By this way you can collect Performances for your own "Best off" - banks or create totally
  54.  new Performances. 
  55.  
  56. 3.1. CS1x-Performance-Editor-Window
  57.      ------------------------------
  58. 3.1.1.  The Menu
  59. 3.1.1.1. Project
  60. 3.1.1.1.1. Load Bank
  61.  
  62.  This menuitem enables you to load a Performancebank into the buffer of the `Referencebank'.
  63.  It opens a filerequester, by that you can pick your favoured Bank.
  64.  !! Attention: You can only load files you saved with CS1x-Editor as Performancebank
  65.                before !!
  66.  
  67. 3.1.1.1.2. Save Bank
  68.  
  69.  This menuitem is for saving the performancebank existing in the buffer of the `Userbank'.
  70.  If during the use of CS1x-Editor no `Userbank' has been saved before, automatically a 
  71.  filerequester opens which enables you to fix path and filename.
  72.  Else if a `Userbank' has been saved before, automatically its path and filename is used
  73.  and a securityrequester aks you to overwrite that file.
  74.  
  75. 3.1.1.1.3. Save as ...
  76.  
  77.  This menuitem is equal to `Save Bank' and enables you to archive a `Userbank'. 
  78.  It opens a filerequester, which enables you to fix path and filename. If a
  79.  file still exists a securityrequester opens and aks you to overwrite that file.          
  80.  
  81. 3.1.1.1.4. Load SMF0
  82.  
  83.  By that menuitem you can load performancebanks stored as standart-midifile-format
  84.  (short SMF0) into the buffer of the `Referencebank'.
  85.  It opens a filerequester too.
  86.      
  87. 3.1.1.1.5. Print Bank
  88.  
  89.  Prints the names of the performances in the buffer of the `Userbank' with programnumber.
  90. 3.1.1.1.6. Info
  91.  
  92.  Infos about this program 
  93. 3.1.1.1.7. Quit
  94.  
  95.  Quits this program. A securityrequester appears!
  96. 3.1.1.2. Edit
  97. 3.1.1.2.1. edit performance
  98.  
  99.  The performance chosen in the listview-gadget of the `Userbank' will be copied into
  100.  a temporary buffer and the `Performance-Common-Window' will be opened 
  101.  
  102. 3.1.1.2.2. test performance
  103.  
  104.  The performance chosen in the listview-gadget of the `Userbank' will be copied into
  105.  a temporary buffer and will be sent via midi into the currentbuffer of CS1x.
  106.  The `Performance-Test'-Window opens and you are able to test the performances
  107.  by mouse and keyboard of the computer. 
  108.  
  109. 3.1.1.2.3. copy left -> right
  110.  
  111.  A: current performance - The performance chosen in the listviewgadget of the 
  112.                           `Referencebank' will be copied to the place chosen in the
  113.                           listviewgadget of the `Userbank'.
  114.  
  115.    
  116.  B: whole `Referencebank'- The whole `Referencebank' will be copied into the buffer of
  117.                            the `Userbank'.
  118.                             
  119. 3.1.1.2.4. reset performance 
  120.  
  121.  The current performance of the `Userbank' will be reset to defaultvalues (Initperformance)
  122.  
  123. 3.1.1.3. Transfer
  124. 3.1.1.3.1. send bank
  125.  
  126.  A: ->CS1x - The performancebank of the `Userbank' will be transmitted via midi to CS1x 
  127.   
  128.  B: ->Disk - The performancebank of the `Userbank' will be saved as Bank-Sysex-Dumpfile
  129.              to disk. A filerequester opens. 
  130.  
  131. 3.1.1.3.2. request bank
  132.  
  133.  This menuitem enables you to request for the performancebank stored in the Userbuffer
  134.  of CS1x. The received performancebank will be stored into the buffer of the 
  135.  `Referencebank'.
  136.  This procedure takes a lot of time, because each of the 128 performances has to be
  137.  requested before it could be received. 
  138.  
  139. 3.1.1.3.3. send performance
  140.  
  141.  A: ->CS1x Current - The performance chosen in the listviewgadget of the `Userbank'
  142.                      will be copied into the Currentbuffer of CS1x. 
  143.    
  144.  B: ->Disk - The performance chosen in the listviewgadget of the `Userbank' will
  145.              be saved to disk as Current-Sysex-Dump. A filerequester appears.   
  146.    
  147. 3.1.1.3.4. request curr. performance
  148.  
  149.  This menuitem enables you to request for the performance stored in the Currentbuffer
  150.  of CS1x. The received performance will be stored into a temporary buffer of CS1x-
  151.  Editor and then copied to the chosen place of the `Userbank'. 
  152.  !! Attention: You first have to pick the performance which could be overwritten in
  153.                the listviewgadget of the `Userbank' before you request for the current
  154.                performance.
  155.                The other way you will lose the performance you picked in the listview-
  156.                gadget and you will be glad if you have stored this performancebank,
  157.                you have in work, before.
  158.               
  159. 3.1.1.4. Help
  160. 3.1.1.4.1. about CS1x-Editor
  161.  
  162.    This helpfile.       
  163. 3.1.2. The Gui
  164.  
  165.  I tried to get the structure of the gui (graphic userinterface) as clearly arranged 
  166.  as possible.
  167.  But sometimes, because of the high count of parameters, it was not possible to prevent  
  168.  the impression of an overloaded gui. 
  169.  Most of the time you have to manage with textgadgets and sliders. The sliders are used to 
  170.  change the values of the parameters and the textgadgets display you their current value.
  171.  Some gadgets enable you to put in a number. In this case you don't need to move a slider
  172.  for changing a parameter.
  173.  Just click with your mouse into a gadget and look, if a curser appears inside the gadget.
  174.  After an input in such a gadget the sliderlevel of the slider  belonging to that gadget
  175.  will be corrected.
  176.  There will be no error-message if your input is false. If the value of your input is
  177.  higher than the maximum value of the paramter you are editing automatically the
  178.  maximum value will be taken and displayed.
  179.  The same thing will be done if the value is smaller than the minimum value, except
  180.  the minimum value will be taken and displayed. 
  181.    
  182. 3.1.2.1. Referencebank
  183.  
  184.  The Referencebank is used to be filled with performancebanks, which you can use for
  185.  reference. You can fill the Referencebank with performancebanks you receive via midi
  186.  or load from disk. The performances will be displayed sorted by the programnumber
  187.  in the listviewgadget of the Referencebank. You are able to copy either the whole 
  188.  Referencebank or a just a single performance of the Referencebank into the buffer
  189.  of the `Userbank'. 
  190.  
  191. 3.1.2.2. Userbank
  192.  
  193.  The Userbank is a bank of performances the user could collect or edit on his own.
  194.  Only those performances stored in the buffer of the Userbank could be edited and
  195.  changed.
  196.  At start of the program the Userbank will automatically be filled with 128 
  197.  Initperformances. These Initperformances are the starting-point for the work with
  198.  CS1x-Editor and could be edited or be replaced with performances of the 
  199.  `Referencebank'.
  200.  
  201.   
  202. 3.1.2.3. _edit 
  203.  
  204.  A click into the edit-button opens the `Performance-Common-Window'. This window is the
  205.  bridge to other windows, which deal with the inner structure of a performance.   
  206.  The activated Performance in the listviewgadget of the `Userbank' will be copied into
  207.  a temporary buffer, which stores the changes of the performance. The activated
  208.  performance will be untouched as long as you don't  click into the `OKAY'- button
  209.  of the `Performance-Common-Window'.
  210.  If you click into the edit-button with no performances activated in the listview-
  211.  gadget of the `Userbank', a requester will appear which will remember you to pick
  212.  a performance first. 
  213.  
  214. 3.1.2.4. testperf
  215.  
  216.  The activated performance in the listviewgadget of the `Userbank' will be transmitted
  217.  via midi into the Currentbuffer of the CS1x. After that the `Performance-Test'-
  218.  window will be opened.
  219.     
  220. 3.1.2.5. copy ->
  221.  
  222.  The activated performance in the listviewgadget of the `Referencebank' will be copied
  223.  to place chosen in the listviewgadget of the `Userbank'.
  224.  If no performance is selected, a message-requester will appear.
  225.   
  226. 3.1.2.6. init
  227.   
  228.  The activated performance in the listviewgadget of the `Userbank' will be reset to default
  229.  values of a Initperformance.
  230.  
  231.   
  232. 3.1.2.7. system
  233.  
  234.  The `CS1x-System'-window which enables you edit the parameters of CS1x's system.
  235.  Look for chapter "Utility Mode" in the CS1x's Owner's Manual for more Information.
  236.  
  237. 3.2. Performance-Common-Window
  238.      -------------------------
  239.  
  240.  The Peformance-Common-Window enables you to edit the parameters of the 6 knobs of
  241.  CS1x. The window will show you the current performancenumber, name and category of
  242.  the performance and it's mainvolume could be edited.
  243.  You should pay attention on knob 3 and 6, which could be configured with Controller-
  244.  Assigns.
  245.  For more information see chapter "Performance-Mode" in the Owner's Manual.
  246.  Following buttons bring you to other edittools. 
  247.  
  248. 3.2.1. Layer-Assign
  249.  
  250.  This button opens the `Knob6-Layer-Assigns'-window which enables you to edit the
  251.  assignparameters of the four layers.
  252.  
  253. 3.2.2. ed.Layers
  254.  
  255.  Opens the `Layer-Edit-Window' for editing the parameters of a layer
  256.  
  257. 3.2.3. ed.Effekte
  258.  
  259.  Opens the `Effects'-window for editing the effects of the performance.
  260.  
  261. 3.2.4. ed.Arpeggiator
  262.   
  263.  Opens the `Arpeggiator-Window' for editing the parameters of the arpeggiator.
  264.  
  265. 3.2.5. ed.Wheels
  266.  
  267.  Opens the `Wheels-Footcontrol-Portamento'-window.
  268.  
  269. 3.2.6. Test
  270.  
  271.  The performance stored in the temporary buffer will be transmitted into the
  272.  Currentbuffer of the CS1x and the `Performance-Test'-window will be opened
  273.  for testing the performance.
  274.  
  275. 3.2.7. OKAY
  276.   
  277.  The current settings of the performance stored in the temporary buffer will be copied
  278.  to the activated Performance in the `Userbank'.
  279.  The `Performance-Common-Window' and all other windows opened via it will be closed.
  280.  
  281. 3.3. Arpeggiator-Window
  282.      ------------------
  283.  This window enables you to edit the settings of the arpeggiator. Information
  284.  about the algorithms, tempo, subdevid, hold and split is given in the Owner's
  285.  Manual.
  286.      
  287. 3.4. Wheels-Footcontrol-Portamento
  288.      -----------------------------
  289.      
  290.  This window enables you to edit the settings for modulation- and pitchwheel,
  291.  footcontrol, portamento and portamentotime.
  292.   
  293. 3.5. Effects
  294.      -------
  295.  Here you are able to edit the paramters of the reverb-, chorus- and variation-effect.
  296.  The variation- effect has got parameters depending on its type. Inactivated gadgets
  297.  are not a bug in the program, but show you that there is no parameter for this type
  298.  of effect to edit.
  299.  For more information see chapter "Digital Effects" in the appendix of the Owner's
  300.  Manual.
  301.  
  302.  The settings of "Vari on Layer Revsend" and "Vari on Layer ChoSend" are not important
  303.  for the performances you want to archive, but are still here, because these parameters
  304.  are used in the currentperformance which will be sent to CS1x at performancetests. 
  305.   
  306. 3.6. Knob6-Layer-Assigns
  307.      --------------------
  308.  This window enables you to edit the assign-settings of knob6 referenced to the layers
  309.  of a performance.
  310.      
  311. 3.7. Layer-Edit-Window
  312.      -----------------
  313.  This window enables you to edit the settings of a layer of a performance. Here you
  314.  can edit the voices, portion of effects etc. for each layer.
  315.  Clicking the cyclegadget named layer switches you through all layers.
  316.  The buttons `copy' and `paste' help you to copy the settings of one layer to another
  317.  one. The `EGS'-button opens the `Envelope-Editor'-window.
  318.  
  319. 3.7.1. copy
  320.   
  321.  All settings of the layer in use will be copied into a buffer. 
  322.  Attention: This function exits in the `Envelope-Editor' too, but with the
  323.             difference that only those parameters will be copied, which 
  324.             could be edited in the `Envelope-Editor'. 
  325.   
  326. 3.7.2. paste
  327.   
  328.  The settings stored in the buffer will be copied to the layer in use.
  329.  That means that all settings will be overwritten with the settings stored 
  330.  in the buffer.
  331.  If the buffer is empty a message-requester will tell you.
  332.  
  333. 3.7.3. EGS         
  334.  
  335.  Opens the `Envelope-Editor'
  336. 3.8. Envelope-Editor
  337.      ---------------     
  338.  Here you can edit the envelopes for amplitude- (AEG), pitch- (PEG) and filtercourse (FEG)
  339.  related to time and also settings of the LFO for each layer.
  340.  Equal to the `Layer-Edit-Window' you can switch to another layer by clicking the
  341.  cyclegadget named layer.
  342.  The function of the menuitems copy and paste are equal to the function of the buttons
  343.  `copy' and `paste' of the `Layer-Edit-Window', but only manage the paramters you can
  344.  edit in the `Envelope-Editor'.
  345.  "copy" copies the parameters of the layer in use into a buffer and "paste" overwrites
  346.  the layer in use with the settings stored in the buffer. 
  347.  
  348.  Attention: `copy' and `paste' of the `Layer-Edit-Window' manage the whole settings of
  349.              a layer.
  350.             "copy" and "paste" of the `Envelope-Editor' only manage those settings
  351.              you can edit in the `Envelope-Editor'.  
  352.             If the buffer is empty a message-requester will appear.
  353.           
  354.        
  355. 3.9. Performance-Test
  356.      ----------------
  357.  
  358.  This window enables you to test the performance in the Currentbuffer of CS1x by keyboard
  359.  of your computer. The idea behind this ability is to use the keyboard of your Amiga as a 
  360.  masterkeyboard for the reason the CS1x is placed too far away.
  361.  Creativity should be convenient!
  362.  
  363.  You can control three cyclegadgets and four sliders:
  364.  The cyclegadget named "Playrange" is for setting the octave-range, to be played
  365.  by the keyboard of your Amiga.
  366.  The cyclegadgets below enable you to set the midicontroller for each of the large
  367.  sliders which simulate the pitch- and modulationwheel of your CS1x- keyboard. You
  368.  can also set controllers used by the six knobs of CS1x.   
  369.  
  370.  The small sliders are used to fix attackrate and mainvolume.
  371.  
  372.  The button called "Midi-Reset" enables you to turn off hanging notes and to reset the
  373.  controller-values of your CS1x.
  374.  
  375.  The "Quit Test"-button quits this test.
  376.  
  377.  If you can't hear any sound using the performancetest you should check following cases:
  378.      
  379.  - is midiconnection all right ?
  380.  - is receivechannel of CS1x equal to the setting of receivechannel in the `System'-
  381.    window?
  382.  - Have you heard a demosong before, which turned off the mainvolume by sysexdatas?  
  383.  - Have you read all the manuals?
  384.  
  385.     
  386. 3.10. CS1x-System 
  387.       ----------- 
  388.  
  389.  This window enables you to edit the settings of your CS1x- system, to send or receive and 
  390.  to store them.
  391.  
  392. 3.10.1. Menuitems
  393.    
  394.  Disk: -Load: You are able to load a systemsetting by a filerequester. 
  395.         
  396.        -Save: The setting will be stored as defaults (CS1x.sys)
  397.         
  398.        -Save as...: You are able to store a setting under a name given by you.
  399.                     You can fix path and filename by a filerequester
  400.        
  401.        -Quit: will close this window
  402.         
  403.  Midi: -Send->CS1x: The systemsettings will be transmitted to CS1x.
  404.     
  405.        -Empfangen<-CS1x: The systemsettings will be received from CS1x.
  406.         
  407.        -Sende alle Änderungen: This switch works global within CS1x-editor.
  408.                                All changes you make to a userperformances will 
  409.                                be transmitted to CS1x, if this switch is active.
  410.                                 
  411.  Help: -Help: Brings up this helpfile.
  412.                                                                                   
  413. 4. Functionkeys
  414.    ---------------
  415.  
  416.  To make switching through the edittools (windows) more convenient, I've included
  417.  functionkeys as following:
  418.  
  419.  "F1": opens the `CS1x-System' -Window
  420.  "F2": opens the `Performance-Common-Window'
  421.  "F3": opens the `Knob6-Layer-Assigns' -Window
  422.  "F4": opens the `Effects' -Window
  423.  "F5": opens the `Arpeggiator-Window'
  424.  "F6": opens the `Wheels-Footcontrol-Portamento' -Window
  425.  "F7": opens the `Layer-Edit-Window'
  426.  "F8": opens the `Envelope-Editor' -Window
  427.  "F9": opens the `Performance-Test' -Window
  428.  
  429.  "Help": opens this helpfile
  430.     
  431. 5. Thanks
  432.    ------
  433.  
  434.  I want to thank following persons:
  435.  
  436.  - my whife and my two sons (3.5 years and 6 months old) for their patience. 
  437.  
  438.  - Wouter van Oortmerssen for his great E-compiler.
  439.  
  440.  - Fabio Rotondo for his Nodemaster- and StringNode- Modules to the E- Compiler
  441.  
  442.  - Bill Barton and Pregnant Badger Music for the great Midi-Library, I used within 
  443.    this programm. The Copyright for Midi-Library is by Bill Barton and Pregnant 
  444.    Badger Music.
  445.  
  446.  - Stephan Sürken for Text2Guide
  447.  
  448.  - Commodore for the best Computer at all.
  449.  
  450.  - Yamaha for the CS1x
  451.  
  452.  - Peter Krischker, who inspired me with his great performances for the CS1x to get
  453.    deeper in detail about CS1x and to write this programm.   
  454.  
  455.  - Martin Endress (ISM), whose midisequencer must be called proffesional because of
  456.    its functionality (multiporttransmitting), but was less valued by leading magacines
  457.    or just casual mentioned.
  458.    Talking about multimedia; multimedia is subject number one, but what is multimedia
  459.    without music and programms for creating it. 
  460.     
  461.    
  462. 6. The Author
  463.    ---------
  464.    
  465.  Udo Alexander Gantner
  466.  Rich.- Wagner- Str.29
  467.  76669 Bad Schönborn
  468.  Germany  
  469.  
  470.  Tel.: 07253/32856
  471.  Email: none
  472.    
  473. 7. Copyright & disclaimer, fullversion
  474.    ----------------------------------------
  475.  
  476.  The program CS1x is Copyright (C),1996, Udo Alexander Gantner.
  477.  I won't accept any call to account in reference to the name "CS1x-Editor" for this
  478.  program, because I don't claim the Copyright for this name. It is free for all users
  479.  to give the program another name. Just raname the programm and the relating icon.
  480.  I take this step, because I read in a magacine for musicians about a shareware-
  481.  author who was called to account from a big softwarecompany because of the name
  482.  he has given his program.  
  483.  I hold no responsibility for any damage caused to your computer or your software
  484.  during the use of CS1x-Editor.
  485.  
  486.  This program is shareware or nowadays called crippleware.
  487.  
  488.  The one of you who payed more than 5.- DM for CS1x-editor on a disk of PD should 
  489.  think about, how many money he wants to throw away this way in future. 
  490.  
  491.  This version is for demonstration and the functions for storing are disabled.
  492.  
  493.  If you like that program you could order the fullversion from me.
  494.  
  495.  The price for the fullversion is 40.- DM
  496.  
  497.  Have much pleasure !!!
  498.  
  499.  
  500.   
  501. 8. Plans for future
  502.    ----------------
  503.    
  504.  - Correcting of bugs, if there are
  505.    Please write me if you find one.
  506.    
  507.  - nicer Gui (maybe MUI), depends on demand.
  508.  
  509.  - Localisation of CS1x-Editor.
  510.  
  511.  - Editors for Quasimidi Technox, MT32, DX/TX7, Fb01 in plan.
  512.  
  513.  - transporting of CS1x- Editors for PC (in work).
  514.  
  515.  - Course about midihandling in E.