How nvxstrikes/smart_render_guard works
Smart Render Guard Lite is a Blender add-on that diagnoses scene and hardware risks, validates assets before rendering, and offers memory cleanup and safe fixes. The main workflow is a user-triggered sidebar scan, followed by validation and optional fixes or purging, then a guarded render. The graph preserves the README’s major Lite capabilities and the separately documented Pro relinking feature. Some links use README workflow statements or SOURCE INDEX references because the relevant implementation excerpts are incomplete.
Main entry points: scanner.py Scan Orchestrator · panel.py Sidebar Panel · render_operator.py Safe Render · auto_fixer.py Safe Fix Engine
Components 22
Blender Interface
- Sidebar Panel
smart_render_guard/ui/panel.py - Risk Popup
smart_render_guard/ui/popup.py - Scan Action
smart_render_guard/operators/scan_operator.py - Validate Action
smart_render_guard/operators/validate_operator.py - Fix Action
smart_render_guard/operators/fix_operator.py - Safe Render
smart_render_guard/operators/render_operator.py
Scene Diagnostics
- Scan Orchestrator
smart_render_guard/core/scanner.py - Risk Report
smart_render_guard/core/report.py - Mesh Analysis
smart_render_guard/core/mesh_analyzer.py - Texture Analysis
smart_render_guard/core/texture_analyzer.py - Particle Analysis
smart_render_guard/core/particle_analyzer.py - VRAM Diagnostics
smart_render_guard/core/vram.py - RAM Diagnostics
smart_render_guard/core/ram.py - Scene Validator
smart_render_guard/core/validator.py
Safety Actions
- Safe Fix Engine
smart_render_guard/core/auto_fixer.py - Memory Optimizer
smart_render_guard/core/optimizer.py - Asset Relinker
smart_render_guard/core/relink_helper.py
Configuration
- Feature Tiers
smart_render_guard/core/tier.py - Addon Preferences
smart_render_guard/preferences.py - Scene Properties
smart_render_guard/properties.py - Shared Helpers
smart_render_guard/utils/helpers.py
Other components
- Blender User
Connections 24
- Blender User → Sidebar Panel: opens
README.md - Sidebar Panel → Scan Action: starts scan
README.md - Scan Action → Scan Orchestrator: runs scan
smart_render_guard/operators/scan_operator.py - Scan Orchestrator → Mesh Analysis: analyzes meshes
smart_render_guard/core/scanner.py - Scan Orchestrator → Texture Analysis: analyzes textures
smart_render_guard/core/scanner.py - Scan Orchestrator → Particle Analysis: analyzes particles
smart_render_guard/core/scanner.py - Scan Orchestrator → VRAM Diagnostics: checks VRAM
smart_render_guard/core/scanner.py - Scan Orchestrator → RAM Diagnostics: checks RAM
smart_render_guard/core/scanner.py - Scan Orchestrator → Risk Report: builds report
smart_render_guard/core/scanner.py - Sidebar Panel → Scan Orchestrator: displays scan
smart_render_guard/ui/panel.py - Blender User → Validate Action: requests validation
README.md - Validate Action → Scene Validator: validates scene
smart_render_guard/operators/validate_operator.py - Blender User → Fix Action: requests fixes
README.md - Fix Action → Safe Fix Engine: applies fixes
smart_render_guard/operators/fix_operator.py - Safe Fix Engine → Memory Optimizer: delegates optimization
smart_render_guard/core/auto_fixer.py - Safe Fix Engine → Feature Tiers: checks tier
smart_render_guard/core/auto_fixer.py - Blender User → Safe Render: starts safe render
README.md - Safe Render → Scan Orchestrator: preflight scan
smart_render_guard/operators/render_operator.py - Safe Render → Risk Popup: shows warning
smart_render_guard/operators/render_operator.py - Scan Orchestrator → Risk Popup: alerts on risk
smart_render_guard/ui/popup.py - Asset Relinker → Scene Validator: uses validation
smart_render_guard/core/relink_helper.py - Sidebar Panel → Addon Preferences: reads settings
- Sidebar Panel → Feature Tiers: checks features
smart_render_guard/ui/panel.py - Scene Properties → Scan Orchestrator: stores scan state
smart_render_guard/properties.py