diff --git a/web/project-website/content/faq/_index.md b/web/project-website/content/faq/_index.md index 255132ce..84658bae 100644 --- a/web/project-website/content/faq/_index.md +++ b/web/project-website/content/faq/_index.md @@ -224,3 +224,13 @@ well, and thus `\` becomes `\\`. In other words, even though it looks strange, this is not a bug in Flamenco. The aim is to prevent you from seeing these doublings as little as possible, but unfortunately it cannot always be avoided. + +### Assets are missing! + +When your blend file references your assets (textures, linked blend files, etc.) +with an absolute path, **Flamenco assumes that this path is valid for all +Workers, and will not copy those assets to the shared storage.** This makes it +possible to store large files, like simulation caches, on the shared storage, +without Flamenco creating a copy for each render job. + +Read more on this in [Absolute vs. Relative Paths](/usage/shared-storage/#absolute-vs-relative-paths). diff --git a/web/project-website/content/usage/shared-storage/_index.md b/web/project-website/content/usage/shared-storage/_index.md index d93bccbe..76f0085d 100644 --- a/web/project-website/content/usage/shared-storage/_index.md +++ b/web/project-website/content/usage/shared-storage/_index.md @@ -92,3 +92,26 @@ have arrived on a specific worker, without waiting for *all* syncing to be completed (as someone may have just submitted another job). [jobtypes]: {{< ref "/usage/job-types" >}} + +## Absolute vs. Relative Paths + +Blender can reference assets (textures, linked blend files, etc.) in two ways: + +- by **relative path**, like `//textures\my-favourite-brick.exr`, which is relative to the blend file, or +- by **absolute path**, like `D:\texture-library\my-favourite-brick.exr`, which is the full path of the file. + +When an asset is referenced by an absolute path, **Flamenco assumes that this +path is valid for all Workers, and will not copy those assets to the shared +storage.** This makes it possible to store large files, like simulation caches, +on the shared storage, without Flamenco creating a copy for each render job. + +{{< hint type=Warning >}} On Windows it is not possible to construct a relative +path to an asset when that asset is no a different drive than the main blend +file. If you still want Flamenco to copy such assets, there are two workarounds: + +- Move your asset libraries to the same drive as your Blender projects. +- Use [symbolic links][symlinks-guide-windows] to make your assets available at + a suitable path. + +[symlinks-guide-windows]: https://www.howtogeek.com/16226/complete-guide-to-symbolic-links-symlinks-on-windows-or-linux/ +{{< /hint >}}