Production multiplane/parallax rig parenting bg layers to camera at set distances, scripted per panel in kreeader-studio | mirror of gitlab.com/lfs.coop/blender/camera-plane
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Damien Picard bd759e2967 Fix #7: Operator poll methods not properly updated
The breakage after API change in Blender 5.0 was partly fixed in
e997791, but the operators' poll methods were not updated.
2026-01-07 23:06:42 +01:00
docs README: Compress images and add figure for operators 2025-07-29 12:22:44 +02:00
utils Fix plane drivers after 5.0 IDProperties update 2025-12-01 23:04:03 +01:00
.gitignore Add .gitignore 2025-06-27 15:12:56 +02:00
__init__.py Feat: Add "Camera Mapping" and "Apply Camera Plane" operators 2025-07-29 11:05:12 +02:00
_gitlab-ci.yml Rename GitLab CI file for now 2025-12-01 23:11:59 +01:00
blender_manifest.toml Fix #7: Operator poll methods not properly updated 2026-01-07 23:06:42 +01:00
handlers.py Cleanup: Quote style 2025-11-26 12:49:16 +01:00
LICENSE.md Relicense to GPL v3 or later, at Dalai Felinto's request 2024-08-27 12:10:19 +02:00
operators.py Fix #7: Operator poll methods not properly updated 2026-01-07 23:06:42 +01:00
props.py Fix plane drivers after 5.0 IDProperties update 2025-12-01 23:04:03 +01:00
pyproject.toml Format using black, add pyproject.toml 2025-06-27 15:32:51 +02:00
README.md README: Mention perspective-correct setup for Camera Mapping 2025-08-25 10:02:24 +02:00
ui.py Fix plane drivers after 5.0 IDProperties update 2025-12-01 23:04:03 +01:00

Camera Plane

Import images and parent them to the camera. You can then set the distance and width from the image objects or the cameras properties. The plane will adjust to the cameras FOV or focal length.
You can easily import several images at once, which will be equally spaced in depth. This is useful when creating painted stage-like sets which need to stick to a camera.

UI

Workflow

Importing

  • Select the camera
  • Click Import Camera Planes from the object properties
  • Select images to import
  • The panel now extends to show a list of images.
  • Those images can be filtered, and they can be displayed either in alphabetical order, or by increasing distance from the camera.

Focal 1 Focal 2
The only thing that was changed between those two images is the cameras focal length, and all planes were scaled accordingly to fit the frame.

Image settings

From the Camera Plane panel, you can reorder the planes by setting their distance from the camera. Like other properties in Blender, you can click on a distance, drag up or down to include the distance from other planes, and then drag left or right to change the distance, and thus move several planes at once.

The scale and opacity of each image can likewise be tweaked by clicking Show Scale and Show Opacity, respectively.

Icons to the left of each layer can be used to change their visibility (both viewport and render at the same time), selectability, and to lock and unlock their transforms.

Operators

Some operators are available in the arrow menu to the top right to manipulate the planes.

UI

Group Selected

This allows creating a sort of “precomposition” from the selected planes. It is useful when your sets have a lot of layers, not all of which should be placed individually.

Space Evenly

This will change the selected planess distances so that they all have the same distance between them.

Apply Selected

This will ungroup selected planes if necessary, and apply their drivers so they no longer need the Camera Plane add-on to be placed.

Setup Layers

This will create view layers for each of the planes, and assign them to collections. That way, they can be rendered to their own render pass and composited individually.

Convert to Camera Mapping

This operator, available in the viewports context menu (right-click / W), will set up the selected objects so they can be edited for camera mapping, with a UV project modifier and a Geometry Nodes setup that fixes UVs so that they are perspective correct. If no camera is selected, a new one will be created, so make sure to select the camera you want to use as projection.

License

This add-on is licensed under the GPL license; either version 3 of the License, or (at your option) any later version.