3D
box-gen.js
Draw a box in the scene, and get a model to fit.
<!-- Generated by apps/docs/scripts/gen-tools.mjs. Do not edit here: the words live in apps/web/src/lib/tools/box-gen.tool.json (agent, hint) and packages/shared/src/tools/setting-hints.ts. --> On the rail as **box-gen.js**. ## When to use it Making a 3D model sized to a space you have already measured out on the canvas: a shelf, a doorway, a gap blocked in against a scene. ## When to reach for something else It only starts once a box is drawn in the scene, so there is no way to begin from a picture or a prompt alone. It fits a measured space, not a photo with no space in mind. ## How to use it 1. Drop a picture onto the card's **Image** slot, from the board or your computer. 2. Write what you want in **Prompt**. 3. Set **Force bounding box**, **Fill** on the card. 4. Press **Run**. ## On the card | Control | What it does | Choices | | - | - | - | | Image | The picture the tool works from. Drop one from the board or your computer. | One picture | | Prompt | What you want, in your own words. The card sends it with your inputs. | Your words | | Force bounding box | Stretch the model to fully fill the drawn box. Off keeps the model's true proportions (the box still guides the shape). | On or off | | Fill | How aggressively to fill: higher pushes narrow parts (necks, stems) toward the box walls. | 0 to 100 | | Run | Starts the run. The number on it is what this run costs in credits, worked out before you press. | | | ×1 | Runs the card several times in a row with the same settings. | 1 to 99 | ## Settings These sit behind the settings button on the card. | Setting | What it does | Choices | | - | - | - | | Material | What kind of surface to output: realistic PBR, simple shaded, or both. | PBR, Shaded, All | | Quality / Mesh | The detail budget and surface type in one pick. Higher numbers mean finer detail and a heavier file. | 4K Quad, 8K Quad, 18K Quad, 50K Quad, 100K Quad, 200K Quad, 2K Triangle, 20K Triangle, 150K Triangle, 500K Triangle, 1M Triangle, 2M Triangle | | Tier | The overall quality level. Higher looks better but is slower and pricier. | Extreme Low, Low, Medium, High, Extreme High | | HD Texture | Outputs sharper, higher-resolution surface art. | On or off | | Geometry Mode | Faithful matches your input closely; creative fills in the unseen parts more freely. | Faithful, Creative | | Symmetry | How much to assume the object is mirror-symmetrical, which helps fill in hidden sides. | Symmetric, Balanced, Asymmetric, Auto |On the rail as box-gen.js.
When to use it
Section titled “When to use it”Making a 3D model sized to a space you have already measured out on the canvas: a shelf, a doorway, a gap blocked in against a scene.
When to reach for something else
Section titled “When to reach for something else”It only starts once a box is drawn in the scene, so there is no way to begin from a picture or a prompt alone. It fits a measured space, not a photo with no space in mind.
How to use it
Section titled “How to use it”- Drop a picture onto the card’s Image slot, from the board or your computer.
- Write what you want in Prompt.
- Set Force bounding box, Fill on the card.
- Press Run.
On the card
Section titled “On the card”| Control | What it does | Choices |
|---|---|---|
| Image | The picture the tool works from. Drop one from the board or your computer. | One picture |
| Prompt | What you want, in your own words. The card sends it with your inputs. | Your words |
| Force bounding box | Stretch the model to fully fill the drawn box. Off keeps the model’s true proportions (the box still guides the shape). | On or off |
| Fill | How aggressively to fill: higher pushes narrow parts (necks, stems) toward the box walls. | 0 to 100 |
| Run | Starts the run. The number on it is what this run costs in credits, worked out before you press. | |
| ×1 | Runs the card several times in a row with the same settings. | 1 to 99 |
Settings
Section titled “Settings”These sit behind the settings button on the card.
| Setting | What it does | Choices |
|---|---|---|
| Material | What kind of surface to output: realistic PBR, simple shaded, or both. | PBR, Shaded, All |
| Quality / Mesh | The detail budget and surface type in one pick. Higher numbers mean finer detail and a heavier file. | 4K Quad, 8K Quad, 18K Quad, 50K Quad, 100K Quad, 200K Quad, 2K Triangle, 20K Triangle, 150K Triangle, 500K Triangle, 1M Triangle, 2M Triangle |
| Tier | The overall quality level. Higher looks better but is slower and pricier. | Extreme Low, Low, Medium, High, Extreme High |
| HD Texture | Outputs sharper, higher-resolution surface art. | On or off |
| Geometry Mode | Faithful matches your input closely; creative fills in the unseen parts more freely. | Faithful, Creative |
| Symmetry | How much to assume the object is mirror-symmetrical, which helps fill in hidden sides. | Symmetric, Balanced, Asymmetric, Auto |