Polly3D Documentation Français
Guides

Troubleshooting and FAQ

Answers to the most common problems with Studio and the After Effects plugin.

Installation and launch#

macOS refuses to open Installer.command or Polly3D Studio. Right-click the file or the app and choose Open, then confirm. This is needed the first time only.

The effect does not appear in After Effects. The plugin is installed while After Effects is closed. Quit After Effects, run the installer again, and restart After Effects. The effect is in Effect > Polly3D > Polly3D.

Scene Setup does nothing. Make sure Polly3D Studio.app is in ~/Applications. The effect looks for it there.

Studio and After Effects#

I saved in Studio but After Effects did not update. Check the status bar at the bottom right of Studio: it should say After Effects connected. If it says closed, After Effects is not running. If it is running, allow Polly3D Studio to control After Effects in System Settings > Privacy & Security > Automation. You can also use File > Refresh After Effects (⌃ R). If After Effects is busy rendering, the refresh waits and replays when it is free.

The effect shows an old version after I changed the scene. Click Load Scene… again, or use File > Refresh After Effects. If the scene file was renamed outside Studio, reload it.

The effect shows nothing. Check that a scene is loaded (the Scene Interface group), that the composition has a 3D camera, and that the scene is not hidden behind the camera: raise Far Distance (px) or turn Disable Cut-off on in Output > Camera Cut-off. Check Unit Size (px): with the default of 100, a 1.6 unit object is 160 px.

My 3D text is not updating. The text object must follow the right channel: the Text channel of the object must match the Custom Text where you put the layer. Studio receives text only for the frame under the After Effects playhead.

Paste After Effects path says it is not open. After Effects must be running, with a mask path or shape path selected in the timeline.

Look#

Metals look black or dull. A metal reflects its environment. Turn the Sky on (Scene tab) or add a Matcap / Reflection layer. See Recipes.

The glass is invisible. Glass shows only what is behind it. Put a backdrop or colored objects behind it. See Glass.

The glass does not show the footage under it in After Effects. Tick Layers Below Interact in Output.

Everything looks flat. The material has no Light layer (it is displayed unlit), or the scene has no lights. Add a Light layer and a light, or the Sky.

Shadows look grainy. Raise Shadow quality and Accumulation frames in the Render tab.

Glass or shadows flicker between frames in After Effects. Raise Accumulation frames. Low accumulation counts show noise that changes from frame to frame.

The background is not transparent. A scene with a background color is opaque. Use a scene with no background color (the AI assistant's set_background can set it to transparent), and check that the sky is not shown as the background.

An imported model looks black or has no texture. The texture files were not found. In the import dialog tick Look for missing textures in the folder, or keep the textures next to the model. The Scene panel shows File not found if the model file itself moved.

Performance#

The viewport is slow. Turn on 3D Draft, leave Resolution while moving on Adaptive, or lower the texture size in Preferences. See Performance.

The disk fills up. Open Preferences > Caches and Clear safe caches, or lower the Texture cache limit. The caches are recomputed when needed.

FAQ#

Does Polly3D work without After Effects? Yes: Studio is a full 3D editor. But the output you use in a video lives in After Effects through the effect.

Does it run on Windows? Not yet. The current version is for Apple Silicon Macs on macOS 12 or later.

Can I use several scenes in one composition? Yes: apply the effect on several layers, each with its own scene.

Where are my scenes? Wherever you saved them; Studio proposes the Polly3D folder of your After Effects project. Scene files are small .polly files that reference models and textures by path.

How do I share a project? Send the After Effects project, the .polly scenes and the models and textures they reference (keep the folder structure). Gradients, matcaps and panoramas you loaded into a scene are embedded in it.

Can the AI assistant break my scene? Every action is an undo step, and the assistant cannot save. Undo with ⌘ Z and close the tab without saving if you do not like the result.

Polly3D Studio documentation