» HowTo Make Patches Portable
This site relies heavily on Javascript. You should enable it if you want the full experience. Learn more.

HowTo Make Patches Portable

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.

  • save your 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.

anonymous user login

Shoutbox

~24h ago

udo2013: BeatDetector(bass)not working.ErrorCode from red node:"PLUGINS \BassSound dll BassSound Data BeatDetectorNode" is missing.WhatToDo?

~4d ago

skyliner: the vcard page is assembled by personal settings + user page

~4d ago

lasal: thank you guys but this is to edit the user data, i don't find how to edit the vcard

~5d ago

CeeYaa: @lasal - haha nice - I think it's funny - you should keep it ;) to change - HOME-SETTINGS - PERSONAL SETTINGS

~5d ago

skyliner: @lasal: here?