b3dTestExtended

Tests availability of extended 3D graphics features (debug/capability check). Takes no parameters. Returns nothing. Checks if extended 3D rendering features are available and functional, useful for verifying graphics capabilities and debugging feature support.

Function purpose: capability detection (verify extended features available on current hardware/driver), debugging and diagnostics (test 3D system initialization and feature support), development testing (confirm advanced rendering features enabled), runtime validation (check if optional features functional).

Extended features: advanced rendering techniques beyond basic 3D (may include PBR, shadows, post-processing, compute shaders, etc.), optional capabilities (not guaranteed on all hardware), requires DX12/Vulkan feature level (modern GPU and driver support).

Use cases: (1) Feature detection (check if advanced rendering available before using), (2) Fallback logic (If extended features unavailable Then use basic renderer), (3) Debug verification (confirm extended features initialized during development), (4) Capability reporting (log available features for diagnostics).

Common patterns: capability check = b3dTestExtended() (check console/log output for results); conditional features = b3dTestExtended(): If extendedAvailable Then use PBR Else use basic; diagnostic = b3dTestExtended() (during startup to verify graphics system).

Typical usage: call once during initialization (verify extended features available), use for development/debugging (not typically in release builds), check error output or logs (function may print diagnostic information), basis for feature branching (choose rendering path based on availability).

Performance: fast one-time check (~0.1-1ms, typically called once at startup), may query GPU capabilities (driver calls), not intended for per-frame calls (initialization/diagnostic function only).

System requirements: requires extended 3D features initialized (b3dGraphics3D with extended mode), depends on hardware capabilities (modern GPU with DX12/Vulkan support), driver support required (up-to-date graphics drivers).

Output and logging: may print diagnostic information to console or log (check stderr/stdout for messages), indicates feature support status (success/failure of extended features), useful for troubleshooting rendering issues (confirms what features available).

Limitations: no return value to check programmatically (diagnostic function, not feature query), results may vary by hardware (different GPUs have different capabilities), primarily for debugging (use other functions for runtime feature detection if needed).

Related: b3dGraphics3D initializes 3D rendering system (with or without extended features), PBR functions (b3dSetEntityMetallicFX, b3dSetEntityRoughnessFX, etc.) require extended features.