background-creator

name	background-creator
description	Generate background 3D scenes with EmbodiedGen using scene3d-cli. Use this skill whenever users ask to create room/indoor background scenes from text prompts, pre-generate backgrounds for layout-cli, or control scene3d generation quality/runtime with retry, seed, and gs3d settings.

Background Creator

Unified entry for EmbodiedGen background scene generation via scene3d-cli.

When To Use

Use this skill when users want to:

• Generate indoor/background 3D scenes from text prompts.
• Pre-generate scene assets for layout-cli.
• Control scene3d-cli runtime/quality via seed, retry, and gs3d settings.

Routing Rule (Core)

Use scene3d-cli when input is scene-level text prompts and output target is a background scene (mesh + 3DGS), not single foreground assets.

Pre-checks

1. Run commands from the repository root.
2. Confirm the active environment is embodiedgen.
3. Install scene3d dependencies first if needed: bash install.sh scene3d
4. If CLI commands are unavailable, run pip install -e . to register entrypoints.

Standard Command Template

scene3d-cli --prompts "Art studio with easel and canvas" \
  --output_dir outputs/bg_scenes \
  --seed 0 \
  --gs3d.max_steps 4000 \
  --disable_pano_check

Common Parameters

• --prompts: one or more scene text prompts.
• --output_dir: output root directory for generated scenes.
• --seed: random seed for reproducibility.
• --n_retry: panorama generation retries.
• --real_height: force target real-world room height in meters.
• --pano_image_only: generate only panorama image (debug/fast validation).
• --disable_pano_check: skip panorama quality check.
• --keep_middle_result: keep intermediate training artifacts.
• --gs3d.max_steps: training steps for 3DGS optimization.

Output Conventions

Each prompt is saved under <output_dir>/scene_xxxx/, typically including:

• gs_model.ply
• mesh_model.ply
• pano_image.png
• prompt.txt
• video.mp4
• gsplat_cfg.yml

Runtime Expectations

• Typical full generation time is around 30 minutes per scene.
• Use --pano_image_only for quick prompt validation before full generation.

Failure Handling and Retry

1. OOM or GPU pressure: reduce concurrency and lower --gs3d.max_steps.
2. Unstable scene quality: increase --n_retry or adjust prompt specificity.
3. Missing outputs: verify --output_dir permissions and use absolute paths.