Skip to content

CHANGELOG.md

Latest commit

 

History

History
178 lines (116 loc) · 8.35 KB

CHANGELOG.md

File metadata and controls

178 lines (116 loc) · 8.35 KB

Change Log

All notable changes to the "C++ DebugMate" extension will be documented in this file.

Check Keep a Changelog for recommendations on how to structure this file.

[0.0.38] - 2026-01-21

Added

  • Variable Grouping & Categorization: Added a new C++ DebugMate side panel that automatically categorizes visualizable variables into groups (Images, Plots, Points) for better organization during debugging.
  • "Add to Group" Functionality: New command to manually add variables to groups, improving management of multiple visualization targets.
  • Webview State Restoration: Panels now correctly restore their internal state (zoom, pan, orientation) when the extension is reloaded or when the webview becomes ready, ensuring a seamless experience when switching focus.

Performance

  • Optimized variable visualization startup: Significantly reduced delay before progress bar appears when clicking variables
    • Removed slow "variables" request for LLDB when reading large vectors (e.g., 600K elements now starts instantly instead of 3+ seconds)
    • Added short-circuit optimization to skip unnecessary type detection when type is already known
    • Wrapped entire visualization operation in progress indicator for immediate user feedback
  • Reduced memory read concurrency: Lowered concurrent memory reads from 8 to 4 to reduce debugger load
  • Added timeout protection: 30-second timeout per memory chunk read to prevent indefinite hangs
  • Reduced console output: Disabled INFO logs by default to reduce output noise

Fixed

  • Critical: Debug session freezing when closing new window webviews: Fixed the root cause of debug buttons freezing when closing webview panels that were moved to new windows
    • Changed all postMessage calls to fire-and-forget (non-blocking) to prevent large data transfers from blocking the debug adapter
    • Added _isDisposing checks before all data send operations
    • Disabled auto-refresh on stack item change to prevent triggering during panel disposal
    • This fix applies to all visualization types: Mat images, point clouds, plots, Matx, 2D/3D arrays
  • Debug session freezing: Fixed issue where moving visualization panels to new windows would freeze the debug session
    • Added session validity checks to all reload handlers (9 locations across pointCloud, plot, and mat providers)
    • Reload requests are now skipped if debug session is no longer active
  • Plot panel reload loop: Fixed 1D plot panels showing "Reloading..." indefinitely when moved to new windows
    • Added extensionReady flag and loading overlay hide in updateInitialData message handler
  • Concurrent refresh protection: Added isRefreshing flag to prevent multiple simultaneous refresh operations
  • Batch refresh optimization: Limited visible panel refresh to maximum 2 at a time to reduce debugger load

Refactored

  • Panel & Session Management: Refactored PanelManager and SyncManager for improved code structure, more robust data pointer handling, and better integration with VS Code's auxiliary window management.

[0.0.37] - 2025-01-11

Added

  • Point cloud view controls: Enhanced point cloud webview with interactive camera controls
    • 6 view angle buttons: Top, Bottom, Front, Back, Left, Right (similar to CloudCompare)
    • Reload button for manual data refresh
    • Reset button to return to fixed isometric view
    • "Colored by" label with color mode buttons (Solid, Z, Y, X) with selection highlighting

Fixed

  • View angle corrections: Fixed Front/Back view directions (Front now looks from Y- direction)
  • Reset view consistency: Reset button now always returns to the same fixed isometric angle regardless of current view

[0.0.36] - 2025-01-11

Added

  • std::array point cloud support: Added visualization support for std::array<cv::Point3f, N> and std::array<cv::Point3d, N>
  • 2D std::array image support: Visualize std::array<std::array<T, cols>, rows> as grayscale images

Fixed

  • LLDB data pointer extraction: Improved reliability of getting data pointers for std::array types in LLDB debugger

[0.0.35] - 2025-01-10

Added

  • Pointer type support: Visualize pointers to supported types (cv::Mat*, std::vector<T>*, std::array<T,N>*, etc.). Pointers are automatically dereferenced, and variables pointing to the same memory address share the same visualization tab.
  • Uninitialized variable detection: Detect and warn about uninitialized variables, including:
    • cv::Mat with suspicious member values (garbage dimensions, invalid flags)
    • std::vector with garbage size values (MSVC debug patterns like 0xCCCCCCCC)
    • Variables marked as <uninitialized>, <optimized out>, or <not available>
  • Adaptive plot tick generation: Dynamic axis tick formatting with smart label placement, preventing overlap and improving readability for various data ranges.
  • Real-time view range display: Plot viewer now shows current zoom level and visible data range in an overlay.
  • Zoom limits: Plot viewer prevents excessive zooming to maintain usability.
  • Multi-threaded debugging support: Variables are now retrieved from the user's currently selected thread and stack frame in the debugger, instead of always using the main thread's top frame.

Fixed

  • Memory address reuse safety: Clear pointer-to-panel mappings on each debug step to prevent stale memory addresses from incorrectly matching new variables after the original was freed.

Changed

  • Improved Y-axis label measurement for better tick formatting in plots.
  • Updated documentation (EN/CN) with pointer type support information.

[0.0.34] - 2025-01-05

Added

  • Multi-platform CI/CD: Added GitHub Actions workflow for building demos on Windows, macOS, and Linux.
  • RGBA 4-channel support: Added support for visualizing 4-channel RGBA images.

[0.0.33] - 2025-01-03

Added

  • 3D array multi-channel image support: Visualize T[H][W][C] and std::array<std::array<std::array<T,C>,W>,H> as multi-channel images (C=1,3,4).
  • 2D C-style array support: Visualize T[rows][cols] C-style 2D arrays as images.

Fixed

  • Memory reference validation: Added validation to all pointer extraction paths to prevent invalid pointer usage.

Changed

  • Enhanced debugger support documentation in DEVELOPMENT.md.

[0.0.27] - 2025-12-31

Fixed

  • Linux/GDB point cloud empty bug: Add fallback to get real size of the vector of Point3f/3d.

[0.0.25] - 2025-12-30

Added

  • Jet Colormap: New render mode for cv::Mat, colorized by grayscale (or mean RGB)
  • Matx support: Detect and visualize cv::Matx fixed-size matrices (e.g., Matx33f, Matx44d)
  • Small-image auto-scale: Mats auto-zoom to a minimum 400px display size for tiny images (e.g., 3x3)

Fixed

  • GDB STL parsing: More robust size detection for vectors/sets/Point3 under gdb pretty-printers
  • Empty variables guard: Prevent opening empty/zero-sized variables from the panel or context menu

Changed

  • Documentation updated (EN/CN) for Jet Colormap, Matx support, and small-image auto-scale

[0.0.24] - 2024-12-29

Added

  • std::set support: Added visualization support for std::set<int>, std::set<float>, std::set<double>
  • Multiple plot types: Switch between Line Plot, Scatter Plot, and Histogram in the 1D data viewer
  • Plot settings panel: Real-time customization with the following options:
    • Line width (for line plots)
    • Point size (for scatter plots)
    • Bin count (for histograms)
    • Custom X/Y axis limits
    • Chart title (centered above the plot)
    • Canvas size (width × height)
    • Axis font size
    • Reset all settings button
  • Dynamic padding: Axis labels and tick marks automatically adjust based on font size

Fixed

  • Fixed LLDB vector size detection when selecting X-axis variable in plot viewer
  • Improved axis label positioning to prevent overlap with tick marks

Changed

  • Disabled mouse wheel zoom in plot viewer to prevent accidental zooming (use Zoom button instead)

[0.0.22] - 2024-12-27

Changed

  • Migrated build system from tsc to esbuild for faster builds and smaller bundle size
  • Reduced extension package size from 8MB to ~145KB by excluding unnecessary assets
  • Updated documentation with clearer feature descriptions

Fixed

  • Improved README structure and screenshots placement

[Unreleased]

  • Initial release