Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Budowanie i kod

ref2scene

/ref2scene

Odtwarza prawdziwe miejsce z kilku zdjęć referencyjnych jako edytowalną scenę w Blenderze, z dopasowaną kamerą i kontrolą liczbową.

Repozytorium
ref2scene ↗
Licencja
MIT
Ostatnia zmiana repozytorium
28.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 28.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Odtwarza prawdziwe miejsce z kilku zdjęć referencyjnych jako edytowalną scenę w Blenderze, z dopasowaną kamerą i kontrolą liczbową.

Oryginalny opis (EN)

Rebuild a real place from one or a few reference photos as an editable, camera-matched Blender scene - decompose the photo into procedural and generated elements, write GPT Image 2.5 four-view prompts, check the views the user downloads, prepare Tripo web multi-view uploads, check the returned models, fit the camera from vanishing lines and a scale anchor, and build and verify the scene headless with numeric gates. Use when asked to reconstruct, recreate or match an interior or scene from photos in Blender, to make image-to-3D asset prompts or four-view (front/left/right/back) reference images

Jak działa

  1. Loop
  2. Pitfalls
Sekcje z nagłówków SKILL.md, w oryginale · 47 linii, 473 słów
Podgląd SKILL.md
---
name: ref2scene
description: Rebuild a real place from one or a few reference photos as an editable, camera-matched Blender scene - decompose the photo into procedural and generated elements, write GPT Image 2.5 four-view prompts, check the views the user downloads, prepare Tripo web multi-view uploads, check the returned models, fit the camera from vanishing lines and a scale anchor, and build and verify the scene headless with numeric gates. Use when asked to reconstruct, recreate or match an interior or scene from photos in Blender, to make image-to-3D asset prompts or four-view (front/left/right/back) reference images for Tripo, or to fit a Blender camera to a photo.
---

# ref2scene: reference photos → Blender scene (stage-gated)

Toolkit: this repository (`tools/r2s.py`, `r2s/`). Requires Blender 5.2+ and Python with
numpy, pillow, scipy, opencv-python. Never open the Blender GUI; never call image or 3D generation
APIs unless the user asks (their GPT Image runs in ChatGPT, their Tripo on the website).

## Loop

1. `python tools/r2s.py new <project> --ref photo.jpg [--ref photo2.jpg]`, then work inside the
   project. Run `r2s status <project>` at the start of every session and after every stage.
2. **Inventory (your judgement).** Look at the photo(s). Write `inventory.json`
   (`templates/project/inventory.example.json`): one element per distinct thing, each with a route
   and a reason. Rules: architecture, anything that must line up with walls, and thin repeated
   members (slats, mullions, balusters: class `thin_repetitive`) are `procedural`; free-form
   furniture and plants are `generate`; one design = one asset reused for every instance. For
   generated assets give `class`, `size` (+ `basis`), `instances[].bbox` and `.placement`, and the
   prompt slots: say what "front" is in physical terms, state counts of repeated parts.
3. `r2s prompts` → hand the user `prompts/README.md`: one NEW ChatGPT chat per asset, attach the
   photo and `prompts/<id>_crop.png`, paste `prompts/<id>.txt`, download the four images unrenamed
   into `01_asset_images/<id>/raw/`.
4. `r2s views` → read `reports/views.json`, look at every `contact.png`. FAIL → ask for a
   regeneration with `prompts/<id>_front_first.txt`. Folder with retries → check the ranked
   `candidates.json`, then `--pick-best` or write `views.json` with `"mapping_source": "manual"`.
5. `r2s tripo` → hand the user `prompts/tripo/README.md`. They upload the four files by slot label
   and download into `02_models/<id>/`.
6. `r2s models` → read `reports/models.json`, look at every `turntable.png`. A failed part count
   means: switch the element to `procedural`. A yaw/left-right warning: decide from the turntable,
   then set `"apply_yaw_offset": true` in params if the correction is right.
7. `r2s lines` → look at `04_renders/compare/lines_<ref>.png`; cite real depth (y), vertical (z)
   and across (x) lines by id in `03_project/landmarks.json`; add height anchors (bottom/top pixel
   + an assumed size with its basis) and table-top ellipses (centre, a, b) if any. `r2s camera`:
   RMS ≤ 2 px, look at the overlay, drop landmarks the report names as worst if they are wrong.
8. Write `03_project/params.json` (room, assets, placements with `uv` = floor contact pixel) and
   grow `03_project/scene.py` (template: `scene_kit`). `r2s build --check gray` until every
   placement's box IoU passes, then materials and lights, `--check lit`, `r2s compare`.
9. Deliver `05_output/<name>.blend` (packed), the checkpoint renders, `asset_manifest.json`, and a
   short list of assumptions (scale anchor, hidden geometry) and remaining differences.

## Pitfalls

- "Left" = the object's own left: its front points to the image's LEFT edge (Tripo's slots, GPT Image).
- Never trust a vision judgement over a failed numeric check; never fix a FAIL by loosening its
  threshold without recording why in `docs/VERIFICATION.md`.
- Keep every accepted change in `params.json`/`scene.py`; the reopened `.blend` is what is checked.
- Blender's Python has no PIL/scipy: image work stays in `r2s/*.py`.

Wersje

W bazie nie ma innych skilli o nazwie ref2scene.

Migawka bazy z 13.11.2026 · wersja paczki 393445e9514f (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 85blender-scene-builder
    Planuje i buduje edytowalne sceny w Blenderze ze zdjęć lub tekstu, wykorzystując wspólne modele i tekstury z lokalnej biblioteki.
  • 100scenedirector
    Przygotowuje scenę 3D w Blenderze od krótkiego pomysłu do wyrenderowanego obrazu lub animacji, z darmowymi zasobami CC0. Przydaje się przy budowie scen i postaci w 3D.
  • 100blender-image-to-3d
    Buduje model 3D do gry w Blenderze z obrazów referencyjnych, takich jak concept art czy zdjęcia, porównując każdy etap z referencją.
  • 90blender-scene-audit
    Sprawdza scenę Blendera przed zmianami lub renderem, wypisując problemy i stan elementów.
  • 100honeyvid-image-generation
    Generuje lub edytuje obrazy w HoneyVid z promptów i zdjęć referencyjnych, na przykład zdjęć produktów lub logo.
  • 90gauge-reference
    Odtwarza wygląd z obrazu referencyjnego w Blenderze i mierzy zgodność: paletę, ekspozycję, kontrast i ton, z korektami liczbowymi.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.