Image Per Instance documentation
Image Per Instance documentation
Docs for Image Per Instance, the Blender add-on that gives every object or instance its own image: install, panel reference, workflows and troubleshooting.
What this add-on does
Image Per Instance puts a different image on every object, array element or Geometry Nodes instance while all of them share one material. It reads a folder of images, packs them into one atlas stored in your .blend file, and stores an image number on each object or instance. The material reads that number and shows the matching tile.
This documentation covers version 0.2.0 for Blender 4.2 and newer.
Pages
| Page | What is in it |
|---|---|
| Install | Installing the zip, where the panel is, updating, removing, Lite versus full |
| Panel reference | Every field, button and option with defaults and ranges |
| Workflows | Step-by-step recipes for objects, Geometry Nodes instances, arrays, photo walls and later changes |
| Troubleshooting | Error messages and limits, and what to do about each |
| Changelog | What changed in each version |
The idea in one minute
- Choose an Image Folder and a Tile Size, then press Build Atlas.
- If the pictures go on separate meshes, select those meshes and press Apply To Selected Objects. Each one gets its own tile.
- If you use an Array modifier or Instance on Points, click the host object so it is active and press Add To Instances (Geometry Nodes). The add-on finds the objects being instanced, gives them the shared material and adds an IPI Assign Index modifier to the host.
If you are new to the problem, read the guide different image per instance in Blender first. It explains the manual method and why an atlas helps.
Support
Write to [email protected] and include your Blender version, the add-on version shown at the bottom of the panel, and the message Blender showed.
Related
- Product page: Image Per Instance
- Troubleshooting
- Guide: different image per instance in Blender