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.

Troubleshooting — algemene problemen

Leestijd: 6 min · Bijgewerkt: 2026-05-12

Zwarte 3D-viewport

Diaz Editor heeft WebGPU nodig (DirectX 12 op Windows, Metal op Mac). Oplossingen op volgorde:

Update GPU-driver (zie install-windows voor links)
Herstart de PC (driver-update vereist soms reboot)
Check GPU-modus: laptops met dual-GPU (Intel + NVIDIA) moeten Diaz Editor op de discrete GPU draaien. Rechtermuisklik op Diaz Editor exe → 'Uitvoeren met grafische processor' → kies NVIDIA/AMD.
GPU te oud? Diaz Editor draait niet op pre-2017 GPUs. Test je systeem op webgpureport.org.

App crasht bij opstarten

Eerst de logs verzamelen — die vertellen wat er mis ging:

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

Open het bestand. Zoek de laatste regel met [error] of [fatal]. Stuur dat fragment naar juan@diazatlas.com met je versienummer (te zien in installer-naam).

✓ Quick-fix in 70% van crash-cases: verwijder %APPDATA%\diaz-editor\settings.json en herstart. Dit reset alleen UI-preferences, geen projecten.

Trage performance / lag in 3D

Project >500 componenten: schakel 'Real-time shading' uit via Instellingen → Renderer → 'Shading mode: Static'
Geheugen-gebruik >3 GB: oudere projecten openen vrijwoorden geheugen niet. Sla project op + herstart de app.
FPS <30: verlaag de viewport-resolutie via Instellingen → Renderer → 'Quality: Performance'
Antivirus-scanner: voeg %APPDATA%\diaz-editor toe als uitzondering (sommige AV's scannen elke project-save)

Project-bestand corrupt of opent niet

Diaz Editor maakt elke 60 seconden een auto-backup. Herstel:

Open menu → Bestand → 'Herstel laatste auto-backup'
Of: navigeer naar %APPDATA%\diaz-editor\backups\ en kies het meest recente .diaz.bak bestand
Hernoem .diaz.bak naar .diaz en open in de app

⚠ Nooit corrupt project overschrijven met Save → eerst Save As naar nieuwe bestandsnaam, dan origineel debuggen.

Auto-update download faalt

Firewall blokkeert typisch api.github.com. Workarounds:

Whitelist github.com en api.github.com in je firewall
Of download handmatig: laatste release op GitHub
Voor corporate-firewalls die alles blokkeren: e-mail support voor een directe download-link