Repository navigation
Settings and Controls
eduardoabreu81 edited this page Nov 6, 2026
·
1 revision
It appears in img2img while an Idol checkpoint is selected.
| Control | What it does |
|---|---|
| Idol input | How much room the crop leaves around the object. Render or generated image: the object fills 1/1.2 of the frame. Photo: 1/1.7 |
| Idol Gaussians | 32,768 to 1,048,576, in steps of 32. The default of 262,144 matches the octree's density; more makes the object denser and takes more memory, without new detail |
| Idol Turbo | 5 steps with no guidance, on the same checkpoint (more) |
| Idol object | The 3D viewer: drag to turn. It shows the last object, or the mesh when .glb is the only file ticked |
| Control | What it does |
|---|---|
| Idol files | What to save: .ply, .spz, .glb. A .json with the settings and the predicted camera is saved at every generation |
| Idol mesh resolution | 64 to 512, default 256. A finer surface, with more faces and more time |
| Idol mesh smoothing | 0 to 60, default 0. Rounds the surface without shrinking it |
| Idol rotate X, Y, Z | -180 to 180 degrees, about the axes the viewer shows, applied in that order. Only used by Rotate and save |
| Rotate and save | Turns the last object and saves the ticked files, next to the original |
With .ply unticked, the viewer uses a temporary copy, in the system's temporary folder.
The three file types:
| File | What it is |
|---|---|
.ply |
The full object, the standard 3D Gaussian Splatting file. About 17 MB at 262,144 Gaussians. y-down, the usual 3DGS convention |
.spz |
The same object compressed, version 3 of Niantic's format. About 3.4 MB. y-up, as the format defines |
.glb |
A binary glTF mesh with vertex colours and normals and an unlit material. y-up. Takes 10 to 20 seconds on the CPU at the default resolution |
| Control | Idol |
|---|---|
| Sampling method | Euler, the preset's. Other samplers run, but only Euler has been tested |
| Schedule type | Simple, the preset's |
| Sampling steps | 50, or 5 with Idol Turbo. Fewer are faster and lose detail |
| CFG | 4, or 1 with Idol Turbo. It is what the Idol SDK calls guidance 3: the SDK writes (1 + w) * cond - w * uncond
|
| Shift | 3, on the idol preset's slider |
| Seed | The same seed gives the same object, byte for byte |
| Control | Why |
|---|---|
| Prompt and negative prompt | The picture is the condition. An empty prompt is saved as 3D object, because the sd-dynamic-prompts extension fails on an empty one |
| Width, Height, Resize mode | The picture is always cropped to 1024 × 1024 |
| Denoising strength | The object always starts from noise |
Batch Count must be 1. There is no inpainting, and no txt2img: generate your picture there first, then send it to img2img.
The live preview only shows the latent settling, in grey: an object is not an image.
Idol for Forge Neo
Using it
Reference
