function itemsToSnap = compareFigures(oldItems, newItems)

%COMPAREFIGURES	Compare figures to baseline.

%   COMPAREFIGURES lists the figures or systems that have changed.

% Copyright 1984-2017 The MathWorks, Inc.

% The publishing tools use this 

% OLDITEMS and NEWITEMS are structures returned by CAPTUREFIGURES or

% SNAPNOW>CAPTURESYSTEMS, which are assumed to have the following

% structure:

%

% x.id is a row vector of numeric handles, or names in a cell array 

% x.data(k) is data that describes x.id(k).

%

% If corresponding data is equal between new and old items, the figure or 

% system is assumed to be unchanged. 

% Set this global variable and PUBLISH displays debugging info.

global PUBLISHING_DEBUGGING_FLAG 

if isempty(PUBLISHING_DEBUGGING_FLAG) 

    debug = false; 

else

    debug = PUBLISHING_DEBUGGING_FLAG;

end 

% For compatibility with previous versions

if nargin == 1 

    newItems = internal.matlab.publish.captureFigures;

end

% Assume (for now), that old figures have no changes.

oldId = oldItems.id; 

newId = newItems.id; 

[unchanged, iNewToOld] = ismember(newId, oldId); 

if debug 

    debugDispNew(newItems, unchanged)

end

% Check old figures in detail.

for iNew = find(unchanged) 

    iOld = iNewToOld(iNew);

    unchanged(iNew) = isequaln( ...

        oldItems.data(iOld), newItems.data(iNew));

    if debug

        debugDispChanges(oldItems, iOld, newItems, iNew, unchanged)

    end

end

% Form list of those that have changed.

itemsToSnap = newItems.id(~unchanged); 

% If it is empty, this file probably created it.  Clean it up.

if isempty(PUBLISHING_DEBUGGING_FLAG) 

    clear global PUBLISHING_DEBUGGING_FLAG 

end 

end