Russian
a step-by-step tutorial
you have a patch including e.g.:
- subpatches
- custom shaders,
- custom freeframe dlls
- some jpgs for filetexturess
etc.
you want to send this patch to a friend or post it in the vvvvorums etc.
What to do?
Folder Structure
first you should setup a folder for your project or even better a folder structure.
the template folder structure below can be downloaded here
Start
- open your patch, "save as" root.v4p (or however you want to name it) right into your projectfolder.
then you should have a very close look into that patch.
External Files
are you using external files like jpgs for filetextures?
- copy all files you want to use from their original location into your projectfolder (or its subfolder.)
- set the inlet "Filename" to the new location.
- save your patch.
same procedure with xFiles, audio-, videofiles.
Hint:
our fellow
woei made a helpful module "GetExternals (VVVV).v4p",
which lists all externals contained in a patch.
Subpatches, Modules
the following procedure has to be done for each of them:
- rightclick the subpatch's node to open its window
- "save as" into your projectfolder (or its subfolder.)
you may hide the subpatches window again (ALT-3) if you want it. however go back to the rootpatch.
when hovering the node the tooltip shows something like this:
the leading "C:\" indicates that the rootpatch only has an absolute path to the subpatch.
- select the subpatch's node and press SHIFT-ALT-P together (make paths relative)
the tooltip shows up this way
or this way indicating a relative path to your root patch.
note that if you have several instances of your subpatch in your rootpatch you have to do the procedure of saving only once but you have to repeat the "make paths relative"-procedure for each node.
Shader
the following procedure has to be done for each shader that is not part of the vvvv-distribution:
- rightclick the shader's node
the HLSLeditor opens; no reason for panic.
- middleclick and choose "save as" from the three-leaf menu.
- save the shader into your projectfolder (or its subfolder.). of course you can give it a name if you want to.
you may hide the HLSLeditor window again (ALT-3) if you want.
- go back to the rootpatch.
when hovering the shader's node the tooltip shows something like this.
the leading "C:\" again indicates that the rootpatch only has an absolute path to the shader.
- select the shader's node and press SHIFT-ALT-P together (make paths relative).
the tooltip shows up this way indicating a relative path to your root patch.
note that if you have several instances of your subpatch in your rootpatch you have to do the procedure of saving only once but you have to repeat the "make paths relative"-procedure for each node.
Freeframe
- copy the freeframe dlls into into your projectfolder (or its subfolder.)
- middleclick and choose "Open in Patch" from the four-leaf menu.alternative you may use the shortcut CTRL-SHIFT-O.
you can't find the node? look into the upper left corner of your patch window.
- drag the node near the "old one" from your freeframe folder.
- reconnect all links to the "new one" and copy/paste all values of the inlets.
- check if your patch is still working.
- delete old node.
vvvv has a nice feature called "Paste modified Values"
select old node, CTRL-C, select new node, CTRL-SHIFT-V.
Test
to test this you can move the whole new folder to another location and start the root patch.
experienced users now start the patch from a second, "virgin" vvvv-installation to make sure there are no more custom modules or shaders in use.
if no nodes or links are missing and the patch is working like supposed you should be done.