plotSegments.m

function plotSegments(lineSegments, lineSpec, lineWidth)
%plotSegments  Plot 2D line segments with equal aspect ratio and margins.
%
%   plotSegments(lineSegments, lineSpec, lineWidth) takes a .NET list of 
%   LinFloat64Vector2D or Float64LineSegment2D objects
%
%   The function plots all line segments in the current figure.
%
%   Author: Ahmad H. Eid
%   Date:   2025-11-10
%   Version: 1.1

    %---------------------------%
    % Validate input arguments  %
    %---------------------------%
    if nargin < 3
        lineWidth = 1;
    end

    if nargin < 2
        lineSpec = 'b-';
    end

    if nargin < 1
        error('plotSegments:MissingInput', ...
              'Input argument "lineSegments" is required.');
    end

    %---------------------------------------%
    % Prepare data for vectorized plotting  %
    %---------------------------------------%
    % Create X and Y arrays with NaN separators
    [X, Y] = getXyForPlot(lineSegments);

    %---------------------------------------%
    % Plot all line segments efficiently    %
    %---------------------------------------%
    plot(X(:), Y(:), lineSpec, 'LineWidth', lineWidth);
end