Files and formats
What the .polly, .pollymat and cache files are, and what is stored where.
Scene files (.polly)#
A .polly file is a complete scene: a JSON header (the description of the scene) followed by a binary block (meshes, embedded images). It contains:
- the objects: groups, primitives with their parameters, paths, text objects, imported models (as a path to the source file), their transforms, anchor points and Aux channel bindings;
- the materials as layer stacks, including embedded images (gradients, matcaps, pasted images), and the links to Connectors and drivers;
- the lights;
- the Cloner and effectors of each object;
- the animation: timeline duration, loop, keyframes;
- the scene settings: background, ambient, Sky, ambient occlusion, fog, post-processing, render quality;
- the panoramas you loaded, embedded.
It does not contain the geometry of imported models, nor the texture files you linked: those are stored by path. Move them together with the project.
Studio and the After Effects effect read exactly the same file. Saving in Studio is the only thing needed for After Effects to see the changes.
Material files (.pollymat)#
A material saved with Keep this material in the library is a small .pollymat file in ~/Documents/Polly3D/Library/Materials. Copy it to another machine to share it.
Caches#
| Folder | Content | Safe to delete? |
|---|---|---|
~/Library/Caches/Polly3D/Textures | Decoded, reduced images (key: path, size, date) | Yes |
~/Library/Caches/Polly3D/MaterialThumbs | Library thumbnails | Yes |
~/Library/Caches/Polly3D/Geometry | Imported models converted to a fast format (.pollygeo) | Only for models that no scene needs; a scene that uses one has to re-import it |
~/Library/Caches/Polly3D/Derived | Computed textures | Yes |
The caches are shared by Studio and by the After Effects effect.
Other folders#
| Folder | Content |
|---|---|
~/Documents/Polly3D/Library | Starter library, your materials and panoramas |
~/Library/Application Support/Polly3D | Shared settings, the last saved scene (used by an effect that has no scene yet), the local socket used by the AI assistant |
Importing from other tools#
| Format | Notes |
|---|---|
| OBJ + MTL | Materials and textures are read |
| glTF / GLB | PBR materials, textures, hierarchy; no animation |
| FBX (binary 7.x) | Meshes, hierarchy, materials; no skeleton or animation |
| STL, PLY | Meshes |
SVG, path data, After Effects createPath | By paste, as Path or Shape objects |
| HDR, EXR (panoramas) | For the Sky and Environment layers |
Exporting#
Polly3D has no export of its own: the final output is the After Effects render. To use the scene elsewhere, render the Polly3D layer from After Effects (a movie, or an image sequence with an alpha channel).