make resliceRoiImage more flexible

Author: Remi-Gau

src/roi/resliceRoiImages.m

@@ -1,10 +1,28 @@
-% (C) Copyright 2021 CPP ROI developers
-
-function reslicedImages = resliceRoiImages(referenceImage, imagesToCheck)
+function [reslicedImages, matlabbatch] = resliceRoiImages(referenceImage, imagesToCheck, dryRun)
+  %
+  % Check if images are in the same orientation and reslice if necessarrry.
+  %
+  % USAGE::
+  %
+  %     reslicedImages = resliceRoiImages(referenceImage, imagesToCheck, dryRun)
+  %
+  % :param referenceImage:
+  % :type referenceImage: path
+  %
+  % :param imagesToCheck:
+  % :type imagesToCheck: path or cellstr
+  %
+  % :param dryRun: Only returns
+  % :type dryRun: logical
+  %
+  % (C) Copyright 2021 CPP ROI developers
 
   % TODO
   % - allow option to binarize output?
 
+  matlabbatch = {};
+  reslicedImages = '';
+
   % check if files are in the same space
   % if not we reslice the ROI to have the same resolution as the data image
   sts = checkRoiOrientation(referenceImage, imagesToCheck);
@@ -13,9 +31,11 @@
 
   else
 
-    matlabbatch = {};
     matlabbatch = setBatchReslice(matlabbatch, referenceImage, imagesToCheck);
-    spm_jobman('run', matlabbatch);
+
+    if ~dryRun
+      spm_jobman('run', matlabbatch);
+    end
 
     basename = spm_file(imagesToCheck, 'basename');
     reslicedImages = spm_file(imagesToCheck, 'basename', ...