bgiDestroyGizmo

Destroys and removes a gizmo control, freeing its resources. First attempts to destroy as canvas with bgiTryDestroyCanvas (canvases use shared ID space but separate tracking). If not a canvas, searches gizmoMap for the gizmo ID. If found and hWnd is not NULL, calls DestroyWindow to destroy the Windows control. Removes entry from gizmoMap with erase. Returns 1 on success, 0 if gizmo not found.

This function permanently removes a control and frees its resources. Control is destroyed and can no longer be used - gizmo ID becomes invalid. DestroyWindow handles all Windows cleanup (child controls destroyed recursively). Use when controls are no longer needed, for dynamic interfaces, or memory management. Cannot be undone - control must be recreated if needed again. Works with both regular gizmos and canvases.