Programming with vvvv is commonly referred to as patching.
The editors canvas is called the Patch.
The building blocks that make your programs are called Nodes.
Nodes have input and output parameters called Pins which are connected by Links.
The following reference goes into details about those 4 main components.
To open a patch middle-click in the Patch Editor to open the Main Menu and choose:
To save a patch middle-click in the Patch Editor to open the Main Menu and choose:
Everytime you save a patch its previous version is backed up under the same filename but ending in ~.xml. So if ever you need to go back to that previous version just rename it to .v4p and you can open it again.
When patching always remember:
See also: Window Modes.
To lock a patch press CTRL+E. A locked shows a '#' symbol in its topleft corner.
In a locked patch:
To unlock, use CTRL+E again.
You can scroll in a patch by right clicking on an empty space and start dragging.
Alternatively or while making a link you can:
Double click with the left button to bring up the Node Browser. Then enter the text you want to have as a comment in the patch. Make sure the text is not matching any node before pressing ENTER to create a comment.
A comment is essentially an IOBox (String) with its input and output pins hidden. So you can always just doubleclick to change it.
If you want to make a patch into a reusable module, see:
Nodes are the building blocks of your patches and each represents a specific functionality. A nodes identifier is structured in the form:
Name (Category Version)
The combination of name, category and version is unique for each node in vvvv. Versions are optional an can be any number of space-separated strings.
While in a patch you always only see the nodes name. Hover a node to see its full identifier in the tooltip.
Nodes can have different icons:
Every node with an icon can be rightclicked to show its editor or window. Nodes without an icon are built-in native nodes and can not be manipulated.
To get an overview of all the pins of a node, select it and press CTRL+I to open the Inspektor.
To find out more about a nodes functionality, select it and press F1 to open its helppatch.
You can browse a list of available nodes by double-clicking anywhere in a patch to pop up the Node Browser.
There you can start typing tags (separated by space) to search for a node with specific functionality or you can get to a category-sorted view by rightclicking in its text-area.
When you found a node you want to use in your patch press enter or select it with a left click and see it inserted in the patch.
Select a node and press the Delete or BackSpace keys to remove it from the patch.
Press the cursor keys to move them by 1px.
Select a group of nodes and press CTRL+G to replace them with a subpatch of the same functionality and keeping their connections to other nodes.
Note that the created subpatch still needs to be saved. Therefore it is good practice to rightclick the new node immediately and press CTRL+SHIFT+S to save it under a specific name.
Press CTRL+H to mark a selection of nodes/links as hidden.
Hidden nodes/links are not visible or accessible anymore when a patch is locked. In an unlocked patch they will stand out with a lighter shade of grey.
On its top and bottom a node can have any number of inputs and outputs, called pins.
Every pin in vvvv is of a specific type of data.
You can introduce your own custom data-types using plugins.
All primitive datatypes can have subtypes which more precisely specify a value-range a pin is looking for. Examples
Subtypes are only used for the user interface to offer more suitable means for entering the desired data to a pin but they do not influence the calculation a node is doing.
Move the mouse over any pin to see a tool tip showing its name and current value.
Values of inputs that have one of the primitive data types can be changed directly on the pin. Changing the value of a pin is like editing an IOBox:
Two pins that have the same data type can be connected by a link.
Every input pin can only take one link!
Therefore, when you try to add another link to an input that already has a link, the existing link will be replaced by the new link.
Outputs can have any number of links going from them. Except for the rare Video, Audio and Midi outputs of nodes in the DShow9 category that also can only handle one link!
To create multiple links from the same output pin, start with a right click on it and then simply left-click on all input pins you want to connect to.
While making a link you can middle click somewhere to create an IOBox that will contain the data that's in the pin you're coming from. Middle click that IOBox once again to automagically give it the name of a this pin. See also: Descriptive Name.
Creating a loop is not a valid connection!
For details, see Creating Feedback Loops.
While making a link, just do occasional left clicks. For each click, an anchor point is added. If you later want to edit the shape of a link, select it and drag the little blue squares. To remove anchor points, align them in a straight line.
There are 3 different styles for links:
Press CTRL+Y on a selected link to cycle through the styles.
To remove an existing link, first select it (left-click) and then do a right-click on it. (or pressing the BackSpace or Delete key).
Note that when removing a link, pins with a primitive datatype behave different from Node pins:
anonymous user login