Why is the 3D viewport black in Diaz Editor?

Almost always a GPU driver issue. On Windows: update your GPU driver via NVIDIA GeForce Experience, AMD Radeon Software, or Intel Graphics Command Center, then restart. On macOS: System Settings → Software Update. On Linux: update Mesa drivers (sudo apt update + upgrade). If the viewport is still black, switch the renderer in Settings → Graphics → Renderer to 'Compatibility' as a fallback.

Why does Diaz Editor crash on startup?

Windows: usually missing Visual C++ runtime — install vc_redist.x64.exe from Microsoft. macOS: Gatekeeper blocking unsigned binary — System Settings → Privacy & Security → click 'Open Anyway'. Linux: missing libGL — run 'sudo apt install libgl1-mesa-glx libglu1-mesa'. If crashes persist, send the crash log (Help → Show Crash Log) to juan@diazatlas.com.

How can I improve 3D performance in Diaz Editor?

For large projects (200+ panels) enable Settings → Performance → Simplified Geometry. Reduce shadow quality from High to Medium. Close other GPU-heavy apps (Chrome with many tabs, Photoshop). On laptops, plug in power — most GPUs throttle on battery. If you are on Intel integrated graphics, expect 30-50% slower rendering than discrete NVIDIA/AMD.

What if my Diaz Editor project file is corrupt or won't open?

Check the autosave folder: Windows %APPDATA%/DiazEditor/autosave/, macOS ~/Library/Application Support/DiazEditor/autosave/, Linux ~/.config/DiazEditor/autosave/. The last 5 autosaves are kept. Copy the most recent .diaz file to your projects folder and open. If autosave is also corrupt, email juan@diazatlas.com with the file — we can usually recover the geometry via the binary format spec.

Why does the Diaz Editor auto-update fail to download?

Auto-update fetches from github.com/bongartzdiaz/diaz-editor-releases. If you are on a corporate network, the GitHub releases endpoint may be firewalled. Workarounds: (1) download the latest installer manually from diazatlas.com/download, (2) ask IT to allow github.com/bongartzdiaz/* and *.githubusercontent.com, or (3) set Settings → Updates → Channel to 'manual' and check periodically.

Solución de problemas comunes

Tiempo de lectura: 6 min · Actualizado: 2026-05-12

Viewport 3D negro

Diaz Editor necesita WebGPU (DirectX 12 en Windows, Metal en Mac). Soluciones en orden:

Actualiza el driver de GPU (ver install-windows para enlaces)
Reinicia la PC (la actualización del driver a veces requiere reinicio)
Comprueba el modo GPU: portátiles con dual-GPU (Intel + NVIDIA) deben ejecutar Diaz Editor en la GPU dedicada. Click derecho en el exe → 'Ejecutar con procesador gráfico' → elige NVIDIA/AMD.
¿GPU demasiado antigua? Diaz Editor no funciona en GPUs pre-2017. Prueba tu sistema en webgpureport.org.

La app se cuelga al iniciar

Primero recoge los logs — te dicen qué salió mal:

Windows: %APPDATA%\diaz-editor\logs\main.log
macOS: ~/Library/Logs/diaz-editor/main.log
Linux: ~/.config/diaz-editor/logs/main.log

Abre el archivo. Busca la última línea con [error] o [fatal]. Envía ese fragmento a juan@diazatlas.com con tu número de versión (visible en nombre del instalador).

✓ Quick-fix en el 70% de los crashes: borra %APPDATA%\diaz-editor\settings.json y reinicia. Solo resetea preferencias UI, no proyectos.

Performance lenta / lag en 3D

Proyecto >500 componentes: desactiva 'Sombreado en tiempo real' vía Configuración → Renderer → 'Modo sombreado: Static'
Uso de memoria >3 GB: proyectos viejos no liberan memoria. Guarda el proyecto y reinicia la app.
FPS <30: baja la resolución del viewport vía Configuración → Renderer → 'Calidad: Performance'
Antivirus: añade %APPDATA%\diaz-editor como excepción (algunos AV escanean cada guardado)

Archivo de proyecto corrupto o no abre

Diaz Editor hace auto-backup cada 60 segundos. Recuperar:

Abre menú → Archivo → 'Restaurar último auto-backup'
O: navega a %APPDATA%\diaz-editor\backups\ y elige el .diaz.bak más reciente
Renombra .diaz.bak a .diaz y ábrelo en la app

⚠ Nunca sobrescribas un proyecto corrupto con Save → primero Save As a nuevo nombre, luego debuggea el original.

Descarga de actualización automática falla

El firewall típicamente bloquea api.github.com. Soluciones:

Whitelist github.com y api.github.com en tu firewall
O descarga manualmente: última release en GitHub
Para firewalls corporativos que bloquean todo: email soporte para un enlace de descarga directa