Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

ProjectionSimEEVEE

Fast simulated projection mapping for Blender EEVEE.

ProjectionSimEEVEE turns a Blender camera into a lightweight simulated projector. Project still images, image sequences, or movies onto one or more meshes—quickly, cleanly, and without a heavy Cycles lighting workflow.

Built for immersive experiences, live shows, dark rides, pop-ups, spatial concepts, and fast AI-to-3D look development.


Features

  • Project images, image sequences, and movies onto mesh receivers
  • Stack multiple independent projections on the same receivers
  • Control Brightness, Feather, Feather Shape, Facing Softness, and Camera-based Projection Image Scale
  • Rectangle and Circle projection masks
  • Real-time EEVEE workflow
  • Dedicated Projection Camera for every projection
  • Clean creation and deletion of cameras, modifiers, UV layers, node groups, and receiver collections
  • Original receiver materials remain active beneath the projection overlay
  • Supports up to 5 receiver meshes per new projection

Installation

  1. Download the latest ProjectionSimEEVEE_*.zip release.
  2. In Blender, open Edit → Preferences → Add-ons.
  3. Click Install….
  4. Select the downloaded ZIP file.
  5. Enable ProjectionSimEEVEE.
  6. In the 3D Viewport, press N and open the Projection tab.

Quick Start

  1. Select between 1 and 5 mesh objects.
  2. Open the Projection panel in the Viewport sidebar.
  3. Click New Projection From Selected Mesh.
  4. Confirm the operation.
  5. Move or rotate the generated Projection Camera.
  6. Load an image, image sequence, or movie.
  7. Adjust the Projection Effect Control settings.

This operation will apply the object's rotation.

ProjectionSimEEVEE applies the receiver rotation and locks it at 0, 0, 0 so that the simulated UV projection stays aligned with the Projection Camera.


How It Works

Projection Camera
+ UV Project Modifier
+ Geometry Nodes front-facing mask
+ Emissive image / video overlay
= Simulated Projection Mapping

The projection is added as an emissive shader overlay. Your original material stays underneath, giving you room to keep developing the receiver surface independently.

This is not a physically accurate projector light. It is a fast visual simulation designed for EEVEE iteration.


Controls

Projection Effect Control

Control Description
Brightness 0 is nearly invisible. 1 is normal intensity. Values above 1 increase the emissive output.
Feather 0 creates a crisp projection edge. 1 creates the softest edge.
Feather Shape Choose Rectangle or Circle.
Facing Softness Controls how projection fades across surfaces turning away from the Projection Camera.

Projection Image Scale

Control Description
X / Y Projection Camera transform scale.
Zoom Projection Camera Z scale. Cannot be negative.

Video / Sequence Playback

When using a movie or image sequence, the plugin exposes:

  • Frames
  • Start Frame
  • Offset
  • Cyclic playback
  • Auto Refresh / Timeline Sync

Keep Auto Refresh / Timeline Sync enabled when you want media playback to follow Blender’s timeline.


Multiple Projections

Each Projection is independent and includes its own:

  • Projection Camera
  • UV Project modifier
  • Geometry Nodes mask
  • Shader Group
  • Media settings
  • Effect controls

Use the checkbox beside each Projection entry to enable or disable it. Use the trash button to remove it.

Deleting a Projection removes its related setup. When the final Projection is deleted, receiver rotation is unlocked.


Known Limitations

Rotation is applied and locked

ProjectionSimEEVEE uses UV coordinates to simulate projection. Rotating a receiver after setup changes the relationship between the UV map and Projection Camera.

For this reason, receiver rotation is applied and locked during setup.

No true occlusion or shadows

ProjectionSimEEVEE uses an emissive UV overlay, not a physically traced light source. Projection content may remain visible in locations where a real projector would be blocked.

This is an intentional performance tradeoff.

If you need a specific area to block projection, assign a copy of the original material without the ProjectionSimEEVEE overlay to that area.


Credits

Developed by WTHCreative
Maintained by Wen_Tao_Huang

Feedback, bug reports, scene tests, and feature suggestions are welcome.

About

A fast EEVEE projection-mapping simulator for Blender—project images or video onto up to five meshes, with multiple projectors, feathering, brightness, zoom, and clean material overlays.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Contributors