TopoCleaner¶

Limpieza avanzada de topología de malla con dos modos de limpieza y procesamiento recursivo.

Descripción General¶

TopoCleaner proporciona operaciones inteligentes de limpieza de malla para corregir problemas comunes de topología en modelos 3D importados o generados. Ofrece dos modos de limpieza con diferentes niveles de agresividad y soporta limpieza recursiva hasta la convergencia.

Ubicación¶

Menú Shift+W → CLEANING → Default Clean / Aggressive Clean

Características¶

Dos Modos de Limpieza¶

Default Clean (Limpieza Por Defecto)¶

Enfoque conservador adecuado para la mayoría de modelos
Elimina geometría suelta (vértices, aristas)
Fusiona vértices duplicados (umbral 0.0001)
Convierte triángulos a cuádruples
Disolución limitada (ángulo 5°)
Recalcula normales (orientación interior)
Seguro para modelos con UVs y materiales

Aggressive Clean (Limpieza Agresiva)¶

Limpieza integral para importaciones problemáticas
Todas las operaciones de Default Clean
Considera factores adicionales: UVs, materiales, costuras, aristas marcadas
Disolución limitada más agresiva (ángulo 1°)
Ideal para importaciones CAD/STL con problemas de topología

Procesamiento Recursivo¶

Mantén presionado ALT mientras haces clic en cualquier botón de limpieza para habilitar el modo recursivo: - Iteración automática hasta que no ocurran más cambios - Máximo 10 iteraciones para prevenir bucles infinitos - Seguimiento del progreso con detalles de iteración - Detección de convergencia cuando la malla está completamente limpia

Interfaz Inteligente¶

Botones deshabilitados cuando no se necesita limpieza
Retroalimentación en tiempo real con barras de progreso
Operación no bloqueante - Blender permanece responsivo
Resultados detallados mostrando qué se limpió

Cómo Usar¶

Limpieza Básica¶

Selecciona objetos de malla que necesiten limpieza
Abre Shift+W → CLEANING
Elige el modo de limpieza:
Default Clean: Para limpieza general
Aggressive Clean: Para importaciones problemáticas
Revisa los resultados en el diálogo emergente

Limpieza Recursiva¶

Selecciona objetos de malla que necesiten limpieza extensiva
Mantén presionado ALT y haz clic en cualquier botón de limpieza
Observa la barra de progreso mostrando múltiples iteraciones
Revisa los resultados detallados de iteración

Operaciones de Limpieza¶

Eliminación de Geometría Suelta¶

Vértices sueltos: Vértices no conectados a ninguna cara
Aristas sueltas: Aristas no conectadas a ninguna cara
Reporte de conteo: Muestra exactamente cuántos elementos fueron eliminados

Fusión de Vértices Duplicados¶

Umbral: 0.0001 unidades (muy preciso)
Detección automática de vértices en posiciones idénticas
Preserva la topología mientras limpia redundancia

Conversión de Triángulos a Cuádruples¶

Default Clean: Conversión básica (ángulos de cara/forma 40°)
Aggressive Clean: Conversión avanzada considerando:
Coordenadas UV
Colores de vértices
Aristas de costura
Aristas marcadas
Límites de materiales

Disolución Limitada¶

Default Clean: Umbral de ángulo 5° (conservador)
Aggressive Clean: Umbral de ángulo 1° (agresivo)
Elimina aristas innecesarias preservando la forma
Respeta límites de materiales (modo Agresivo)

Recálculo de Normales¶

Detección automática de orientación interior/exterior
Normales consistentes en toda la malla
Procesamiento basado en BMesh para confiabilidad

Diálogo de Resultados¶

Resultados de Iteración Única¶

✅ ¡Limpieza de Topología Completada!

📊 Cambios de Geometría:
• Eliminados 15 vértices
• Eliminadas 8 aristas
• Eliminadas 3 caras

🔧 Operaciones Realizadas:
1. Eliminados 10 vértices sueltos, 5 aristas sueltas
2. Fusionados vértices duplicados (distancia: 0.0001)
3. Convertidos triángulos a cuádruples
4. Aplicada disolución limitada (ángulo: 5°)
5. Recalculadas normales (orientación interior)

🎯 Procesados 1 objeto(s) de malla

Resultados Recursivos¶

🔄 ¡Limpieza Recursiva Completada! (4 iteraciones)

📊 Cambios Totales:
• Eliminados 21 vértices
• Eliminadas 15 aristas
• Eliminadas 8 caras

🔄 Detalles de Iteración:
Iter 1: -15v, -8e, -3f
Iter 2: -5v, -2e, -1f
Iter 3: -1v, 0e, 0f
Iter 4: 0v, 0e, 0f ✓ CONVERGIÓ

🔧 Operaciones Realizadas:
[Operaciones de la última iteración]

🎯 Procesados 1 objeto(s) de malla

Cuándo Usar Cada Modo¶

Default Clean¶

Limpieza general de malla después del modelado
Modelos importados con problemas menores
Modelos con UVs/materiales que quieres preservar
Mantenimiento regular de mallas complejas

Aggressive Clean¶

Importaciones de modelos CAD con problemas de topología
Archivos STL de otro software
Geometría escaneada con artefactos
Mallas con geometría superpuesta

Modo Recursivo¶

Modelos importados complejos que requieren múltiples pasadas
Topología muy corrupta de conversión
Cuando la limpieza manual requeriría múltiples intentos
Ensambles CAD con múltiples problemas de conexión

Consejos¶

Comienza con Default Clean - es más seguro para la mayoría de casos
Usa Aggressive Clean para importaciones de software CAD
Prueba el modo Recursivo cuando la limpieza de una sola pasada no sea suficiente
Revisa los resultados - el diálogo muestra exactamente qué se limpió
Las barras de progreso te mantienen informado durante operaciones largas
Los botones se auto-deshabilitan cuando no se necesita limpieza

Detalles Técnicos¶

Operaciones basadas en BMesh para máxima confiabilidad
Retroalimentación de progreso previene el congelamiento de UI
Manejo de errores con respaldos elegantes
Procesamiento eficiente en memoria de mallas grandes
Operaciones thread-safe con limpieza apropiada