wiki:IngenBasics

Version 1 (modified by David Robillard, 12 years ago) (diff)

--

Where's File->Open?!

There 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.

Loading Patches

You 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".

Loading 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!

It 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.

Adding Nodes (plugins) and Ports

You 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.

Connecting Ports

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. There are two ways of connecting ports:

  • 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.
  • The drag method: Drag from the source (output) port to the destination (input) port.

Disconnecting Ports

Disconnecting two ports is done in the exact same way as you would connect them. Either method is fine.