/[svn]/jsampler/trunk/manual/docbook/jsampler.xml
ViewVC logotype

Diff of /jsampler/trunk/manual/docbook/jsampler.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1583 by iliev, Sat Dec 8 13:13:20 2007 UTC revision 1756 by iliev, Tue Aug 26 20:23:39 2008 UTC
# Line 12  Line 12 
12      </author>      </author>
13    
14      <copyright>      <copyright>
15        <year>2007</year>        <year>2008</year>
16    
17        <holder>Grigor Iliev &lt;grigor@grigoriliev.com&gt;</holder>        <holder>Grigor Iliev &lt;grigor@grigoriliev.com&gt;</holder>
18      </copyright>      </copyright>
# Line 22  Line 22 
22        url="gfdl.html">GNU Free Documentation License</ulink>.</para>        url="gfdl.html">GNU Free Documentation License</ulink>.</para>
23      </legalnotice>      </legalnotice>
24    
25      <pubdate>Updated: Sat, 8 December 2007</pubdate>      <pubdate>Updated: Tue, 26 August 2008</pubdate>
26    </bookinfo>    </bookinfo>
27    
28    <chapter id="INTRODUCTION">    <chapter id="INTRODUCTION">
# Line 302  mkdirhier lib/required Line 302  mkdirhier lib/required
302  cp ../jlscp-0.5a/lib/jlscp.jar lib/required/jlscp.jar  cp ../jlscp-0.5a/lib/jlscp.jar lib/required/jlscp.jar
303  cp ../juife-0.4a/lib/juife.jar lib/required/juife.jar</command></literallayout></para>  cp ../juife-0.4a/lib/juife.jar lib/required/juife.jar</command></literallayout></para>
304    
305          <tip>
306            <para>In most cases it is sufficient just to copy the
307            <command>lib</command> directory from the last release, but first
308            check if there are some significant recent changes to those
309            libraries.</para>
310          </tip>
311    
312        <para>Then follow the steps in the next section.</para>        <para>Then follow the steps in the next section.</para>
313      </section>      </section>
314    
# Line 386  cp ../juife-0.4a/lib/juife.jar lib/requi Line 393  cp ../juife-0.4a/lib/juife.jar lib/requi
393      <section id="MANAGING_ORCHESTRAS">      <section id="MANAGING_ORCHESTRAS">
394        <title>Managing Orchestras</title>        <title>Managing Orchestras</title>
395    
396        <para>Tool buttons:</para>        <para><guilabel>Manage Orchestras</guilabel> tool buttons:</para>
397    
398        <para><inlinegraphic fileref="images/new16.png" /> <guilabel>Create new        <para><inlinegraphic fileref="images/new16.png" /> <guilabel>Create new
399        orchestra</guilabel></para>        orchestra</guilabel></para>
# Line 404  cp ../juife-0.4a/lib/juife.jar lib/requi Line 411  cp ../juife-0.4a/lib/juife.jar lib/requi
411    
412        <para><graphic align="center" fileref="images/new-orchestra.png" />Then        <para><graphic align="center" fileref="images/new-orchestra.png" />Then
413        choose orchestra name and description and click        choose orchestra name and description and click
414        <guibutton>OK</guibutton> button. </para>        <guibutton>OK</guibutton> button.</para>
415    
416        <para>To remove an orchestra, select the orchestra and click the        <para>To remove an orchestra, select the orchestra and click the
417        <guibutton>Remove selected orchestra</guibutton> button. To edit an        <guibutton>Remove selected orchestra</guibutton> button. To edit an
# Line 425  cp ../juife-0.4a/lib/juife.jar lib/requi Line 432  cp ../juife-0.4a/lib/juife.jar lib/requi
432      <section id="MANAGING_INSTRUMENTS">      <section id="MANAGING_INSTRUMENTS">
433        <title>Managing Instruments</title>        <title>Managing Instruments</title>
434    
435        <para>Tool buttons:</para>        <para><guilabel>Managing Instruments</guilabel> tool buttons:</para>
436    
437        <para><inlinegraphic fileref="images/new16.png" /> <guilabel>Add new        <para><inlinegraphic fileref="images/new16.png" /> <guilabel>Add new
438        instrument</guilabel></para>        instrument</guilabel></para>
# Line 473  cp ../juife-0.4a/lib/juife.jar lib/requi Line 480  cp ../juife-0.4a/lib/juife.jar lib/requi
480        channel using the instrument chooser of the sampler channel - click        channel using the instrument chooser of the sampler channel - click
481        <guilabel>Select instrument from orchestra</guilabel> radio button,        <guilabel>Select instrument from orchestra</guilabel> radio button,
482        choose orchestra and isntrument from the comboboxes and click        choose orchestra and isntrument from the comboboxes and click
483        <guibutton>OK</guibutton> button.</para>        <guibutton>OK</guibutton> button</para>
484        </section>
485      </chapter>
486    
487      <chapter>
488        <title id="MIDI_INSTRUMENTS">MIDI Instruments</title>
489    
490        <para>The sole purpose of the MIDI instrument mapping is to provide a way
491        to change the loaded instrument on a specific sampler channel through the
492        MIDI keyboard by switching to different MIDI bank/program. To do that you
493        need at least one MIDI instrument map with MIDI instruments mapped for the
494        desired MIDI banks/programs and to assign that map to the sampler channels
495        which instruments should be switched using MIDI bank/program
496        changes.</para>
497    
498        <para>Note that when stopping LinuxSampler all MIDI instrument mappings
499        are gone forever, so it is crucial to export the MIDI instrument maps
500        before quiting your session to be able to load them again next time you
501        start LinuxSampler. This can be done by choosing
502        <guimenu>Actions</guimenu> <guisubmenu>Export</guisubmenu>
503        <guimenuitem>MIDI Instrument Maps</guimenuitem>.</para>
504    
505        <section>
506          <title>Managing MIDI Instrument Maps</title>
507    
508          <para><guilabel>MIDI Instrument Maps</guilabel> tool buttons:</para>
509    
510          <para><inlinegraphic fileref="images/new16.png" /> <guilabel>Add MIDI
511          instrument map</guilabel></para>
512    
513          <para><inlinegraphic fileref="images/edit16.png" /> <guilabel>Edit
514          selected MIDI instrument map</guilabel></para>
515    
516          <para><inlinegraphic fileref="images/delete16.png" /> <guilabel>Remove
517          selected MIDI instrument map</guilabel></para>
518    
519          <para>To create a new MIDI instrument map, click the <guilabel>MIDI
520          Instruments</guilabel> tab in the Left-Side pane then click the
521          <guibutton>Add MIDI instrument map</guibutton> button.</para>
522    
523          <para><graphic fileref="images/add-midi-map.png" /></para>
524    
525          <para>Then choose map name and click <guibutton>OK</guibutton>
526          button.</para>
527    
528          <para>To remove a map, select the map and click the <guibutton>Remove
529          selected MIDI instrument map</guibutton> button. To edit a map, select
530          the map and click the <guibutton>Edit selected MIDI instrument
531          map</guibutton> button, or just double-click the map to edit.</para>
532        </section>
533    
534        <section>
535          <title>Managing MIDI Instruments</title>
536    
537          <para><guilabel>Managing MIDI Instruments</guilabel> tool
538          buttons:</para>
539    
540          <para><inlinegraphic fileref="images/new16.png" /> <guilabel>Add new
541          MIDI instrument</guilabel></para>
542    
543          <para><inlinegraphic fileref="images/edit16.png" /> <guilabel>Edit
544          selected MIDI instrument</guilabel></para>
545    
546          <para><inlinegraphic fileref="images/delete16.png" /> <guilabel>Remove
547          selected MIDI instrument or bank</guilabel></para>
548    
549          <para>To map a MIDI instrument, first select the desired MIDI instrument
550          map from the combobox then click the <guilabel>Add new MIDI
551          instrument</guilabel> button:</para>
552    
553          <para><graphic align="center"
554          fileref="images/map-midi-instrument.png" /><tip>
555              <para>The <link linkend="INSTRUMENTS_DB_ADD_TO_MAP">easiest way to
556              map a MIDI instrument</link> is from the <link
557              linkend="INSTRUMENTS_DATABASE">Instruments Database</link>.</para>
558            </tip>To remove a MIDI bank/instrument, select the MIDI
559          bank/instrument and click the <guibutton>Remove selected MIDI instrument
560          or bank</guibutton> button. To edit a MIDI instrument, select the MIDI
561          instrument and click the <guibutton>Edit selected MIDI
562          instrument</guibutton> button, or just double-click the MIDI instrument
563          to edit.</para>
564        </section>
565    
566        <section>
567          <title>Assigning MIDI Instrument Map To Sampler Channel</title>
568    
569          <para>To assign MIDI instrument map to specific sampler channel, click
570          the <guibutton>Options</guibutton> button to expand the channel options
571          pane then select the desired map from the <guilabel>MIDI Instrument
572          Map</guilabel> combobox:</para>
573    
574          <para><graphic fileref="images/assign-midi-map.png" /></para>
575        </section>
576      </chapter>
577    
578      <chapter id="INSTRUMENTS_DATABASE">
579        <title>Instruments Database</title>
580    
581        <para>The communication between LinuxSampler and its front-ends is TCP/IP
582        based, which provides an option the sampler to be controlled from another
583        computer or device, and while instrument loading is a regular task in the
584        sampler, there should also be a convenient way to browse and load
585        instruments (located on the sampler box) from a front-end launched on a
586        remote host. This need is well covered by the <guilabel>Instruments
587        Database</guilabel>. However, this is not the only purpose of the
588        Instruments Database. It is a great tool that helps you to not get lost in
589        your instrument collection, providing you a flexible way to create your
590        own tree structure and to organize your instruments in more than one way,
591        without moving or altering the instrument files located all over your hard
592        drives. Another great feature is the search engine with enhanced search
593        capabilities providing you fast and easy way of finding instruments by
594        various criteria.</para>
595    
596        <para>It is crucial to understand that, unlike <link
597        linkend="USING_ORCHESTRAS">Orchestras</link>, the Instruments Database is
598        handled by LinuxSampler, not by JSampler, and by default the database file
599        is located in <command>/var/lib/linuxsampler/instruments.db</command> on
600        the host where the back-end is started.</para>
601    
602        <para>Note that you can have more than one instruments database and you
603        can specify which one to be used on LinuxSampler startup. To create a new
604        database file issue the following command:</para>
605    
606        <para><command>linuxsampler --create-instruments-db
607        my_instruments.db</command></para>
608    
609        <para>which will create a new database file called
610        <command>my_instruments.db</command> in the current directory.</para>
611    
612        <para>To start LinuxSampler using the newly created instruments database
613        use the <command>--instruments-db-location</command> option:</para>
614    
615        <para><command>linuxsampler --instruments-db-location
616        my_instruments.db</command></para>
617    
618        <para>To backup the instruments database just copy the database
619        file.</para>
620    
621        <section>
622          <title>Adding Instruments To The Instruments Database</title>
623    
624          <para>Choose <guimenu>Window</guimenu> <guimenuitem>Instruments
625          Database</guimenuitem> to bring up the Instruments Database window, or
626          click the corresponding tool button. Initialy, the instruments database
627          is empty, so you should manually create the desired directories and add
628          instruments to them.</para>
629    
630          <para>To create a new directory, select the directory, in which the new
631          directory should be created and choose <guimenu>Actions</guimenu>
632          <guimenuitem>Create Directory</guimenuitem>, or right-click a blank area
633          and choose <guimenuitem>Create Directory</guimenuitem>.</para>
634    
635          <para>To add instruments to specific instruments database directory, go
636          to that directory and select <guimenu>Actions</guimenu> <guisubmenu>Add
637          Instruments</guisubmenu> submenu, where you have two options - to scan a
638          specific instrument file and add the instruments in that file to the
639          instruments database or scan a file system directory for instrument
640          files and add the instruments to the instruments database.</para>
641        </section>
642    
643        <section>
644          <title>Manging Instruments And Directories</title>
645    
646          <para>Basic commands:</para>
647    
648          <para><command>Cut</command> - <guimenu>Edit</guimenu>
649          <guimenuitem>Cut</guimenuitem>, or right-click on a selected file or
650          directory and choose <guibutton>Cut,</guibutton> or Ctrl+X</para>
651    
652          <para><command>Copy</command> - <guimenu>Edit</guimenu>
653          <guimenuitem>Copy</guimenuitem>, or right-click on a selected file or
654          directory and choose <guibutton>Copy,</guibutton> or Ctrl+C</para>
655    
656          <para><command>Paste</command> - <guimenu>Edit</guimenu>
657          <guimenuitem>Paste</guimenuitem>, or right-click a blank area and choose
658          <guibutton>Paste,</guibutton> or Ctrl+V</para>
659    
660          <para><command>Rename</command> - <guimenu>Edit</guimenu>
661          <guimenuitem>Rename</guimenuitem>, or right-click on a selected file or
662          directory and choose <guibutton>Rename,</guibutton> or press
663          <command>F2</command></para>
664    
665          <para><command>Delete</command> - <guimenu>Actions</guimenu>
666          <guimenuitem>Delete</guimenuitem>, or right-click on a selected file or
667          directory and choose <guibutton>Delete,</guibutton> or press the
668          <command>Delete</command> key from the keyboard</para>
669    
670          <para><tip>
671              <para>This commands also work on a multiple selection.</para>
672            </tip></para>
673        </section>
674    
675        <section>
676          <title>Loading Instruments From The Instruments Database</title>
677    
678          <para>To load an instrument to a sampler channel from the Instruments
679          Database, right-click on the instrument and choose <guimenu>Load
680          Instrument</guimenu>, then choose the sampler channel where the
681          instrument should be loaded to. Note that you need to have at least one
682          sampler channel created, otherwise the <guimenu>Load
683          Instrument</guimenu> submenu is disabled.</para>
684        </section>
685    
686        <section id="INSTRUMENTS_DB_ADD_TO_MAP">
687          <title>Adding Instruments To MIDI Instrument Map</title>
688    
689          <para>To add an instrument to MIDI instrument map from the Instruments
690          Database, right-click on the instrument and choose <guimenu>Add To MIDI
691          Map</guimenu>, then choose the MIDI instrument map to which to add the
692          selected instrument. Note that you need to have at least one MIDI
693          instrument map, otherwise the <guimenu>Add To MIDI Map</guimenu> submenu
694          is disabled. For more info read <link linkend="MIDI_INSTRUMENTS">MIDI
695          Instruments</link>.<tip>
696              <para>To add more than one instrument from an instrument directory
697              at a time, select the instruments and right-click on one of the
698              selected instruments.</para>
699            </tip></para>
700        </section>
701    
702        <section>
703          <title>Adding Instruments To Orchestra From The Instruments
704          Database</title>
705    
706          <para>To add an instrument to orchestra from the Instruments Database,
707          right-click on the instrument and choose <guimenu>Add To
708          Orchestra</guimenu>, then choose the orchestra to which to add the
709          selected instrument. Note that you need to have at least one orchestra,
710          otherwise the <guimenu>Add To Orchestra</guimenu> submenu is disabled.
711          For more info read <link linkend="USING_ORCHESTRAS">Using
712          Orchestras</link>.<tip>
713              <para>To add more than one instrument from an instrument directory
714              at a time, select the instruments and right-click on one of the
715              selected instruments.</para>
716            </tip></para>
717        </section>
718    
719        <section>
720          <title>Finding Instruments</title>
721    
722          <para>To start a search, choose <guimenu>Edit</guimenu>
723          <guimenuitem>Find</guimenuitem>, or Ctrl+F.</para>
724      </section>      </section>
725    </chapter>    </chapter>
726  </book>  </book>
Legend:
Removed from v.1583  
changed lines
  Added in v.1756
  ViewVC Help
Powered by ViewVC