Esta página te ayudará a diagnosticar y resolver los problemas más comunes relacionados con el inicio, carga, renderizado, interacción, rendimiento e integridad de datos. Si después de seguir estos pasos el problema persiste, contacta con nosotros enviando un correo a **typhoon@plainconcepts.com** con los detalles (consulta la sección de Reportes para más información).

Tabla de Referencia Rápida

Síntoma	Causa Más Probable	Qué Hacer	Ver También
La aplicación no inicia	Falta runtime .NET 8	Vuelve a ejecutar el instalador; asegúrate de que esté presente el Runtime de Escritorio .NET 8	Requisitos del Sistema
Puerto de visualización en blanco / negro	Controlador DX11 desactualizado o inestable	Actualiza el controlador de GPU y reinicia el equipo	Requisitos del Sistema
La nube de puntos no carga	VRAM libre insuficiente	Cierra otras aplicaciones GPU; reduce tamaño del conjunto de datos	Requisitos del Sistema
El splat Gaussiano no carga	Archivo splat corrupto o no compatible	Reexporta el splat; prueba con una muestra conocida que funcione	Inicio Rápido
La nube de puntos carga parcialmente	VRAM agotada durante la transferencia	Libera VRAM; reintenta; divide el conjunto de datos	Requisitos del Sistema
Vista de puntos inicial dispersa	El refinamiento aún está en progreso	Espera 1-2 segundos para ver el detalle completo	Inicio Rápido
Opción de exportación deshabilitada	No hay elemento compatible seleccionado	Selecciona el modelo correcto (nube o splat)	Inicio Rápido
El proyecto se reabre vacío	Archivos de origen movidos o eliminados	Restaura las rutas; vuelve a vincular y guarda de nuevo	Proyectos
La selección no funciona	Error en la herramienta o distancia demasiado grande	Acércate más o cambia el modo de selección	Selección y Etiquetado
Rotación de cámara bloqueada	Foco perdido o botón del ratón incorrecto	Haz clic en la ventana de visualización; mantén presionado el botón derecho	Inicio Rápido
Movimiento muy rápido o muy lento	Configuración de velocidad no ajustada	Ajusta la Velocidad de Cámara	Inicio Rápido
Etiquetas no visibles	El modelo seleccionado no es una nube de puntos	Selecciona una nube de puntos; abre Propiedades	Selección y Etiquetado
El modelo parece cortado	Planos de recorte demasiado ajustados	Ajusta los planos de recorte cercano y lejano	Inicio Rápido
La verificación de actualización falla	Problema de conectividad de red	Restaura la conexión; reintentar	Requisitos del Sistema
Error de autorización	Firewall o proxy bloqueando	Permite la conexión saliente; reintenta	Requisitos del Sistema
El modelo parece desplazado o inestable	Origen lejos de (0,0,0) causando pérdida de precisión	Recentra mediante preprocesamiento; contacta soporte si persiste	Sección 9

1. Problemas de Inicio

La Aplicación No Inicia

Verifica la presencia del Runtime de Escritorio .NET 8 (Aplicaciones y Características o vuelve a ejecutar el instalador).
Confirma que tu sistema operativo es Windows 10 o superior (64 bits).
Si el problema persiste, envíanos un correo a **typhoon@plainconcepts.com** incluyendo información sobre tu equipo.

Puerto de Visualización Negro o en Blanco

Posibles causas: controlador DX11 desactualizado, sesión de escritorio remoto sin reenvío GPU adecuado, o conflictos con aplicaciones superpuestas de terceros.

Acciones a realizar:

Actualiza los controladores de GPU desde el sitio del fabricante (preferible a Windows Update).
Reinicia tu equipo después de actualizar los controladores.
Prueba con una nube pequeña para descartar problemas de memoria.
Si usas Escritorio Remoto, prueba con una sesión local.

2. Carga de Modelos

La Carga de Nube de Puntos Falla Inmediatamente

La mayoría de las veces es por VRAM libre insuficiente. Con ~24 bytes por punto, 2 GB libre pueden gestionar aproximadamente 107 millones de puntos. Libera VRAM cerrando otras aplicaciones que usen GPU. Si incluso una nube pequeña de prueba falla, incluye detalles y envía un correo a **typhoon@plainconcepts.com**.

La Nube de Puntos Aparece Dispersa y Luego Se Rellena

Este es un comportamiento normal del refinamiento. La interacción ya es posible—los detalles completos aparecerán en un par de segundos.

La Nube de Puntos Carga Parcialmente y Se Detiene

Indica presión de memoria o VRAM agotada durante la transferencia. Intenta cargar solo ese archivo en primer lugar. Si funciona bien aislado, carga los demás archivos de forma secuencial. Si sigue siendo parcial para un tamaño modesto (<50 millones de puntos con VRAM disponible), contacta con nosotros.

La Carga de Splat Gaussiano Falla

Probablemente se trate de un archivo splat corrupto o incompatible. Verifica la tubería de exportación de origen. Prueba con una muestra splat conocida y que funcione. Si solo un archivo falla, reexporta; si muchos fallan, reporta incluyendo tamaño del archivo y herramienta de generación usada.

El Splat Gaussiano Muestra Artefactos Inesperados

Puede indicar datos de canal faltantes o problemas de precisión. Compara con la versión de nube de puntos (si está disponible) para identificar si los artefactos provienen de los datos originales o de la conversión a splat.

Archivo No Soportado o Corrupto (Ambos Tipos)

Si ocurre un fallo silencioso, confirma que la extensión del archivo coincida con su contenido real (ej. LAS vs LAZ). Intenta abrirlo en otro visor para validar su integridad. Reexporta los conjuntos de datos corruptos o truncados.

3. Navegación y Cámara

Problema	Causa	Solución
Rotación no funciona	Botón derecho no presionado o foco perdido	Haz clic en ventana de visualización; mantén presionado botón derecho mientras mueves ratón
Movimiento muy rápido	Valor de velocidad demasiado alto	Reduce la Velocidad en el panel de Cámara
Difícil juzgar profundidad	Proyección configurada en Ortográfica	Cambia a Perspectiva en el Panel Izquierdo
La nube desaparece al acercarse	Plano cercano demasiado grande	Reduce el clipping cercano en el panel de Cámara
Porciones lejanas cortadas	Plano lejano demasiado pequeño	Aumenta la distancia de clipping lejano

Consejo: Usa "Centrar Cámara" después de seleccionar un elemento para reorientarte rápidamente.

4. Selección y Etiquetas

Errores comunes:

Síntoma	Causa	Solución
Ningún punto seleccionado	Herramienta no activada	Activa la herramienta de selección deseada (Panel Inferior)
Selección rectangular no selecciona nada	Zoom demasiado alejado o densidad baja	Acércate; prueba selección con pincel o cúbica
Campo de etiqueta ausente	Elemento que no es nube seleccionado	Selecciona una nube de puntos en el Administrador de Escena y verifica que tenga etiquetas
Región incorrecta etiquetada	Selección sobrescrita sin advertencia	Confirma el resaltado de selección antes de etiquetar
Partes de la escena desaparecen al usar pincel o herramienta de medida	El plano lejano se ajusta automáticamente para mejorar precisión	Ajusta manualmente el plano lejano en el panel de Cámara.

Mejor Práctica: Después de etiquetar, cambia a un modo de color diferente (si está disponible) para confirmar visualmente tus grupos.

5. Exportando

Las exportaciones son específicas según el tipo de modelo que selecciones.

Exportación de Nube de Puntos

Selecciona una nube de puntos y elige un formato soportado (E57, PCD, EPC si está disponible en tu compilación). Asegúrate de tener espacio en disco suficiente. Los recuentos de puntos grandes significan tiempos de exportación más prolongados.

Exportación de Splat Gaussiano

Selecciona un modelo splat y exporta a su formato nativo o a uno basado en puntos convertido (ej. PLY comprimido) si es compatible. La fidelidad de ciertos atributos puede verse reducida al convertir a formatos de puntos debido a la compresión.

Si la exportación se detiene o produce un archivo inesperadamente pequeño, envía los detalles a **typhoon@plainconcepts.com**.

6. Proyectos (.typh)

El contenido depende de las rutas de archivo relativas originales. Si los elementos aparecen faltantes:

Recrea la estructura de carpetas o señala el cargador a las ubicaciones nuevas.
Abre cada archivo crudo manualmente y luego guarda el proyecto de nuevo.
Mantén rutas relativas estables al mover proyectos entre equipos.

Si persisten fallos a pesar de rutas correctas, empaqueta la escena y envíala a **typhoon@plainconcepts.com**.

7. Rendimiento y Detalle de Renderizado

Esperado: Capacidad de respuesta de navegación inmediata; refinamiento completa en un par de segundos.

Si ocurre tartamudeo:

Causa	Solución
Proceso GPU en competencia	Cierra otras aplicaciones intensivas de GPU
Cerca del límite de VRAM	Descarga una nube grande; intenta con un conjunto de datos más pequeño
Estrangulamiento del controlador	Actualiza el controlador; desactiva modos de ahorro de batería

Artefactos visuales (parpadeo de puntos, bloques de color aleatorio):

Asegúrate de esperar un par de segundos para que se complete el renderizado. Mientras está en progreso, puede haber parpadeos.
Prueba con un formato diferente de los mismos datos para descartar problemas de atributos.
¿Persiste el problema? Captura un vídeo y envíalo a **typhoon@plainconcepts.com**.

8. Red y Autorización

Requiere conectividad activa para autorización, telemetría y actualizaciones automáticas.

Síntomas y Soluciones:

8. Red y Autorización

Se requiere conectividad activa para autorización, telemetría y actualizaciones automáticas.

Síntomas y Soluciones:

Síntoma	Causa	Solución
Error de autorización	Puerto saliente bloqueado	Permite la aplicación en el firewall; reintenta
La verificación de actualización falla	Conexión intermitente	Verifica tu acceso general a internet; reintenta más tarde
Telemetría deshabilitada inesperadamente	Política de red global o sin conexión	Vuelve a habilitar cuando estés en línea si lo deseas

Si tu conectividad es estable pero los errores persisten, envía una breve descripción junto con cualquier mensaje de error a **typhoon@plainconcepts.com**.

9. Recorte, Visibilidad y Distancia del Origen

Indicadores: Los puntos o parches splat desaparecen, parpadean o muestran z-fighting; la geometría distante se corta; el movimiento leve causa cambios visuales grandes.

Planos de Recorte

Ajusta los valores de clipping cercano y lejano en el panel de Cámara. Para escenas muy grandes, aumenta considerablemente el plano lejano mientras mantienes el plano cercano pequeño (pero >0.01 para evitar pérdida de precisión). Si tu escena necesita un plano lejano más allá de 1000 unidades, modifícalo presionando Ctrl + Clic Izquierdo en el valor del plano lejano. Esto te permitirá ingresar un valor personalizado.

Desplazamiento del Origen / Problemas de Precisión

Si las coordenadas de tu conjunto de datos están muy alejadas de (0, 0, 0) (por ejemplo, coordenadas geoespaciales grandes del mundo real), la precisión de punto flotante puede degradarse, causando temblor, imprecisión en selecciones o artefactos visuales.

Soluciones:

Preprocesa: Traslada los datos de modo que su centroide esté cerca del origen antes de cargar.
Divide: Separa grandes regiones espaciadas en múltiples conjuntos de datos más pequeños y centrados.
Valida: Carga una muestra reducida para comprobar si los problemas desaparecen tras recentrar.

Si los artefactos de precisión persisten después de recentrar, envía una descripción breve junto con los rangos de coordenadas aproximados a **typhoon@plainconcepts.com**.

10. Registros y Diagnósticos

Antes de reportar un problema:

Anota la versión de Typhoon (se muestra en la barra de título).
Registra el modelo de GPU, versión de controlador y VRAM disponible.
Captura pantallazos o un vídeo del problema (incluye la ventana de visualización y cualquier cuadro de diálogo).
Si la aplicación se ha bloqueado, cualquier registro del Visor de Eventos de Windows será útil.
Obtén tu ID de cliente desde el menú Ayuda > Acerca de.

11. Cuándo Reportar un Problema

Reporta el problema a **typhoon@plainconcepts.com** si:

Un formato soportado falla consistentemente al cargar (incluye tamaño, formato y número de puntos).
Hay un bloqueo reproducible con pasos claros.
Los artefactos visuales persisten tras actualizar el controlador y probar con un formato diferente.
Hay errores de autorización o red a pesar de tener conectividad confirmada.

Tu correo debe incluir: versión de Typhoon, versión del SO, modelo y VRAM de GPU, versión del controlador, número aproximado de puntos, ID de cliente (Ayuda > Acerca de) y los pasos exactos para reproducir el problema.

¿Buscas más respuestas? Consulta las Preguntas Frecuentes o vuelve a Requisitos del Sistema. Para ayuda directa, envía un correo a **typhoon@plainconcepts.com**.