# AI Compositor: Effortless Scene Setup for Realistic Compositing

📖 License Validity:

One-time purchase, 10-year authorization

💡 Version Information:

v 2.1.9: Compatible with Blender 5.0.1; optimized color performance of composite background images, no longer appearing gray;

v 2.0.1: Fixed generation errors on Mac;

v 2.0.0: New version released

v 1.x.x: Older versions

💡 Usage Tips:

1. Save the file before generating.

2. Suitable for small-scale models, with model dimensions within a 0.5m x 0.5m space.

3.Ensure a stable internet connection when installing dependencies. If prompted with insufficient permissions, please launch Blender in administrator mode and reinstall the dependencies.

⚠️ Note:

1. The new version requires Blender 5.0.1 or higher. If you are using Blender 4. x, it is recommended to use v 2.0.1.

2. Due to the rapid updates of Blender and limited personal capacity, immediate compatibility with newer versions may not always be possible. Please check version compatibility before purchasing. We apologize for any inconvenience 🙏

📖许可证有效期：

一次购买，10年授权

💡版本信息：

v 2.1.9：适配blender 5.0.1；优化合成的背景图色彩表现，不再显得灰；

v 2.0.1：修复Mac下的生成错误问题；

v 2.0.0：新版本上架

v 1.x.x：旧版本

💡使用提示：

1. 生成前需要先保存文件

2. 适合小尺寸模型，模型尺寸在0.5mx0.5m空间内

3.安装依赖需要保持网络通畅，如果提示权限不足，请使用管理员模式启动blender，然后重新安装依赖

⚠️注意：

1. 新版本需要安装blender5.0.1版本以上，如果使用blender4. x版本，则建议您使用v 2.0.1.

2. 因blender更新速度太快，本人精力有限，不一定能马上适配新版的blender，购买前请看准版本适配情况，不便之处敬请谅解🙏

# Intro

# AI Generate

Stop Wasting Time, Start Creating:

3 Ways to Start:

- Upload: Use your own background image.

- Preset: Select from included background images.

- AI Generation: Create unique images directly within Blender using Replicate, Siliconflow, or ComfyUI APIs. Just type your prompt!

One-Click Scene Setup: AI Compositor instantly sets up:

- Realistic HDR Environment Lighting derived from your image.

- Accurately positioned Sun Light matching the image's lighting direction.

- Perfectly matched Camera settings (resolution, background).

- A ready-to-use Shadow Catcher floor (choose Square or Circle!).

- Optimized Cycles Render Settings with AgX Color Management.

- Basic Compositing Nodes for seamless integration.

- Camera Focal Length (with automatic Dolly Zoom!)

- Shadow Catcher Floor Shape & Scale

How it Works (Quick Start):

1. Save your .blend file! (Required before starting)

2. Open the AI Compositor panel (in the 3D Viewport sidebar - press N).

3. Choose your mode: Preset, Upload, or AI.

4. Follow the simple steps for your chosen mode (e.g., select preset, upload file, or generate AI image & confirm).

5. Let the addon automatically set up your scene!

(Generated files like environment maps and AI source images are neatly saved in AIC_EnvMaps and AIC_AI_Sources folders next to your .blend file.)

6. Use the Adjust Scene controls to fine-tune lighting and camera.

7. Add your 3D models and hit Render!

注意看：激活流程和使用过程

1. 在：`https://leoxplorer40.gumroad.com/l/aic` 购买license得到激活码

2. 同样在gumroad购买结果页，下载zip包并安装插件

3. 安装好插件在插件设置页面，输入刚才的激活码

⚠️ 注意：激活过程有点慢，请耐心等待，务必保证输入正确的激活码。中国大陆用户，需要保持良好的网络环境🪜。

4. 看到这样的界面就证明已经激活成功！

Watch Carefully: Activation Process & Usage Steps

1. Purchase a license and obtain an activation code at: https://leoxplorer40.gumroad.com/l/aic

2. Download addon（zip file） and install the add-on

3. After installation, go to the Add-on Settings page and enter the activation code you obtained earlier

> Note: The activation process may take a little time, please wait patiently and ensure you enter the correct activation code. For users in Mainland China, a stable internet connection (with VPN) is required.

4. If you see an interface like this, it means the activation was successful!

Why Choose AI Compositor?

- Massive Time Saver: Automates tedious setup tasks, letting you focus on creativity.

- Realistic Results: Creates physically plausible lighting and camera setups based on your background.

- Flexible Workflow: Works with your existing images or generates new ones on the fly.

- Easy to Use: Simple interface, minimal configuration required.

- Actively Developed: Continuously improving with new features!

Get AI Compositor today and spend less time setting up, and more time bringing your incredible composites to life!

(Note: Requires saving the .blend file first. Requires API keys for optional AI generation features. Dependency installation is handled within the addon. If you encounter issues with automatic dependency installation, please ensure you are running Blender with Administrator Privileges, especially on Windows, and then try installing dependencies again via the addon's settings panel.)