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

PageWhat is in it
InstallInstalling the zip, where the panel is, updating, removing, Lite versus full
Panel referenceEvery field, button and option with defaults and ranges
WorkflowsStep-by-step recipes for objects, Geometry Nodes instances, arrays, photo walls and later changes
TroubleshootingError messages and limits, and what to do about each
ChangelogWhat changed in each version

The idea in one minute

  1. Choose an Image Folder and a Tile Size, then press Build Atlas.
  2. If the pictures go on separate meshes, select those meshes and press Apply To Selected Objects. Each one gets its own tile.
  3. 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.

Install Image Per Instance in Blender
Next page