Path Interpretation

Many Wrap nodes have file name parameters to load or save data to files. These parameters can contain special syntax that will be interpreted by Wrap in a special way to produce the final file name.

Hash Symbols

Any sequence of # symbols in the file name will be replaced with the current frame number. For example, the string Sequence/Frame##.obj will be replaced with Sequence/Frame01.obj in frame 1 or with Sequence/Frame100.obj in frame 100.

Path Variables

Path variables start with the $ sign and store different predefined paths. For example, in the string $PROJECT_DIR/Texture.jpg the variable $PROJECT_DIR will be replaced with the current project directory.

Wrap support the following path variables:


$PROJECT_DIR stores the path to the current project file. For a new project that has not been saved yet, the $PROJECT_DIR is empty.


$PROJECT_NAME simillary to the $PROJECT_DIR, but stores the project name. File extension .wrap isn’t included in the string.


$COMMON_DIR can store any user-defined path. Often it can be a network path to common resources, or a path to a folder that stores all the projects related to the current production.

Please use File > Set Common Dir to select a path for this variable.

Path Reinterpreting

In Wrap, loaded paths are automatically converted to contain the given path variables. $PROJECT_NAME is never matched. $COMMON_DIR’s priority is medium. $GALLERY_DIR and $PROJECT_DIR have the highest priority. Matching is greedy, so variables will be chosen to cover as many symbols as possible. A variable cannot replace a part of a name. For example, C:\User\Dir10 will not be threatened as $COMMON_DIR with value C:\User\Dir.