reverse3d 0.5.0__tar.gz → 0.5.1__tar.gz

{reverse3d-0.5.0/reverse3d.egg-info → reverse3d-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reverse3d
-Version: 0.5.0
+Version: 0.5.1
 Summary: AI-agent-ready toolkit for 3D reverse engineering: image analysis, photogrammetry, mesh repair, primitive fitting and headless rendering.
 Author-email: Voxel Enterprise <info@voxel.lat>
 Maintainer-email: Voxel Enterprise <info@voxel.lat>
@@ -425,6 +425,8 @@ Si las fotos están borrosas o falta una herramienta, **no reintenta en vano**:
 
 **Formatos:** imágenes `png jpg jpeg tif tiff bmp webp`, y fotos de iPhone `heic heif` (se convierten a JPEG conservando el EXIF) · mallas `stl obj ply glb gltf off` · nubes `ply xyz pcd`.
 
+**¿Cómo tomar las fotos?** Mínimo 20, recomendadas 40-60, en 4 perfiles (anillos a 10-20°, 35-45° y 60-70°, y 4 desde arriba), sin mover el objeto, con luz pareja y sin reflejos. Guía completa: [docs/captura.md](docs/captura.md).
+
 ---
 
 ## Herramientas externas opcionales

{reverse3d-0.5.0 → reverse3d-0.5.1}/README.md

@@ -358,6 +358,8 @@ Si las fotos están borrosas o falta una herramienta, **no reintenta en vano**:
 
 **Formatos:** imágenes `png jpg jpeg tif tiff bmp webp`, y fotos de iPhone `heic heif` (se convierten a JPEG conservando el EXIF) · mallas `stl obj ply glb gltf off` · nubes `ply xyz pcd`.
 
+**¿Cómo tomar las fotos?** Mínimo 20, recomendadas 40-60, en 4 perfiles (anillos a 10-20°, 35-45° y 60-70°, y 4 desde arriba), sin mover el objeto, con luz pareja y sin reflejos. Guía completa: [docs/captura.md](docs/captura.md).
+
 ---
 
 ## Herramientas externas opcionales

reverse3d-0.5.1/reverse3d/_version.py

@@ -0,0 +1 @@
+__version__ = "0.5.1"

{reverse3d-0.5.0 → reverse3d-0.5.1}/reverse3d/autopilot.py

@@ -68,6 +68,14 @@ KIND_LABEL_ES: dict[str, str] = {
 }
 
 _MIN_PHOTOS = 3
+
+#: Capture guide in one sentence (docs/captura.md has the full guide; Studio shows it too).
+CAPTURE_ADVICE_ES = (
+    "Para un modelo 3D completo: 40-60 fotos (mínimo 20) en 4 perfiles: anillo bajo a 10-20° "
+    "(16 fotos), medio a 35-45° (16), alto a 60-70° (12) y 4 desde arriba; con 60-80 % de "
+    "solape, sin mover el objeto, luz pareja y sin reflejos (luces RGB apagadas; en superficies "
+    "brillantes, spray mate o talco). Guía completa: docs/captura.md."
+)
 _ANALYSIS_SIDE = 256
 
 
@@ -149,7 +157,7 @@ def detect_input(path: str | Path) -> Detection:
                 "unknown",
                 None,
                 f"only {len(images)} photos: photogrammetry needs at least {_MIN_PHOTOS} "
-                "(ideally 20-60)",
+                "(ideally 40-60)",
                 str(src),
             )
         return Detection("unknown", None, "no photos, drawings or 3D files in the folder", str(src))
@@ -388,11 +396,7 @@ def auto_run(
 
     if summary is None and detection.kind == "photos" and last_error is not None:
         reason = last_error.message.split(":", 1)[0].rstrip(".")
-        capture_advice = [
-            "Para un modelo 3D completo: 30-60 fotos en orden alrededor del objeto, sin moverlo, "
-            "con luz pareja y sin reflejos (las luces RGB apagadas; en superficies brillantes, "
-            "spray mate o talco).",
-        ]
+        capture_advice = [CAPTURE_ADVICE_ES]
         try:
             summary = _relief_fallback(source, out, settings, base, reason, history)
         except Reverse3DError as exc:

{reverse3d-0.5.0 → reverse3d-0.5.1}/reverse3d/vision/feature_matcher.py

@@ -308,10 +308,13 @@ def analyze_image_set(
     recommendations: list[str] = []
     if n < 3:
         recommendations.append(
-            "Capture at least 20-40 photos around the object for photogrammetry."
+            "Take at least 20 photos (40-60 recommended) around the object: three rings at "
+            "10-20, 35-45 and 60-70 degrees plus a few from above (see docs/captura.md)."
         )
     elif n < 15:
-        recommendations.append("Few images: add more viewpoints (aim for 60-80% overlap).")
+        recommendations.append(
+            "Few images: aim for 40-60 photos with 60-80% overlap between neighbours."
+        )
     blurry = [q.name for q in qualities if "blurry" in q.issues]
     if blurry:
         recommendations.append(

{reverse3d-0.5.0 → reverse3d-0.5.1/reverse3d.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reverse3d
-Version: 0.5.0
+Version: 0.5.1
 Summary: AI-agent-ready toolkit for 3D reverse engineering: image analysis, photogrammetry, mesh repair, primitive fitting and headless rendering.
 Author-email: Voxel Enterprise <info@voxel.lat>
 Maintainer-email: Voxel Enterprise <info@voxel.lat>
@@ -425,6 +425,8 @@ Si las fotos están borrosas o falta una herramienta, **no reintenta en vano**:
 
 **Formatos:** imágenes `png jpg jpeg tif tiff bmp webp`, y fotos de iPhone `heic heif` (se convierten a JPEG conservando el EXIF) · mallas `stl obj ply glb gltf off` · nubes `ply xyz pcd`.
 
+**¿Cómo tomar las fotos?** Mínimo 20, recomendadas 40-60, en 4 perfiles (anillos a 10-20°, 35-45° y 60-70°, y 4 desde arriba), sin mover el objeto, con luz pareja y sin reflejos. Guía completa: [docs/captura.md](docs/captura.md).
+
 ---
 
 ## Herramientas externas opcionales

{reverse3d-0.5.0 → reverse3d-0.5.1}/tests/test_vision.py

@@ -119,7 +119,7 @@ class TestFeatureMatching:
         assert report.image_count == 2
         assert len(report.pairs) == 1
         assert report.suitable_for_photogrammetry is False  # only 2 images
-        assert any("20-40" in r for r in report.recommendations)
+        assert any("at least 20 photos" in r for r in report.recommendations)
 
 
 def test_largest_group_ignores_capture_order() -> None:

reverse3d-0.5.0/reverse3d/_version.py

@@ -1 +0,0 @@
-__version__ = "0.5.0"