Changes between Initial Version and Version 1 of IngenBasics


Ignore:
Timestamp:
Sep 15, 2008, 1:38:07 PM (13 years ago)
Author:
David Robillard
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • IngenBasics

    v1 v1  
     1== Where's File->Open?! ==
     2
     3There isn't one, deliberately.  Ingen (like the Unix filesystem) always has a "root patch", with the path "/".  This is the patch you see when you first start the GUI.  You can't "open" in this window because the operation is ambigious - if there were objects present would the loaded patch it replace them?  Load as a child?  Import to the root patch?  To avoid this ambiguity and confusion there is only an "Import" option, which does what you would expect.
     4
     5
     6
     7== Loading Patches ==
     8
     9You can import into the root patch, but there's a very good chance that's not what you ''should'' do.  Ingen is a recursive environment - if you want to load e.g. a synth patch, you should load it as a ''child'' of the root patch.  Think of the root patch as representing the entire Ingen system itself, which can contain many instruments (or whatever else).  Depending on how Ingen fits into the rest of your audio setup, you might think of the root patch as your "workspace" or "project".
     10
     11Loading children of a patch (any patch) is done via a context menu.  This is a very important concept when using Ingen:  '''Right Click The Canvas'''!
     12
     13It is not even possible to load subpatches or plugins via the menus or any way other than via the canvas context menu, because you need to specify where you want the new object to be.  You do this by bringing up the menu, and the new object will be added where you (right) clicked.  The goal is for using Ingen to be like using a drawing program.  GIMP doesn't have a Draw->Circle menu item because that would be silly - Ingen doesn't have an Add->Plugin menu item for the exact same reason.
     14
     15
     16
     17== Adding Nodes (plugins) and Ports ==
     18
     19You guessed it - right-click the canvas.  If you feel more documentation is required here please tell Dave, because the GUI needs fixing - not the documentation.
     20
     21
     22
     23== Connecting Ports ==
     24
     25'''Important: ''' Signal flow on Nodes in Ingen flows from left to right.  Thus you can distinguish input ports from output ports because inputs are aligned to the left of the node, and output ports are aligned to the right.
     26 
     27There are two ways of connecting ports:
     28
     29 * The click-click method: click one of the ports (it should be highlighted red), then click the port you want it connected to.  Assuming the ports are capable of being connected to each other, a connection should be made.
     30
     31 * The drag method:  Drag from the source (output) port to the destination (input) port.
     32
     33
     34
     35== Disconnecting Ports ==
     36
     37Disconnecting two ports is done in the exact same way as you would connect them.  Either method is fine.