Rename InputArrayRef/OutputArrayRef/InputOutputArrayRef to their final names (issue #1976 step 5, final cleanup part 3)

Mechanical rename now that the class-based InputArray/OutputArray/
InputOutputArray are gone and the names are free:
  InputArrayRef       -> InputArray
  OutputArrayRef      -> OutputArray
  InputOutputArrayRef -> InputOutputArray

Single-pass whole-word regex per name (no placeholder/2-pass needed,
unlike the earlier MatExprNode->MatExpr rename, since these three names
don't overlap as substrings of each other and the target names weren't
already in use). Renamed the defining file InputArrayRef.cs ->
InputArray.cs and the test file/class InputArrayRefTest(.cs) ->
InputArrayTest.

Also dropped the ArrayProxyKind.RawInputArray/RawOutputArray/
RawInputOutputArray migration-scaffold enum values and rewrote the
file-header comment in InputArray.cs: both were explicitly documented
as "removed once the type flip is complete", which it now is. Nothing
in the codebase ever constructed a proxy with those Kind values anymore
(they existed solely so externs could wrap a class-based
InputArray/OutputArray/InputOutputArray handle during the incremental
ArrayProxy ABI migration).

This completes issue #1976 step 5: InputArray/OutputArray/
InputOutputArray are now ref structs everywhere, matching their
original class-based public API names.

Author: shimat

src/OpenCvSharp/Cv2/Cv2_calib.FishEye.cs

@@ -34,8 +34,8 @@ public static class FishEye
         /// rotation vector, translation vector, and the skew.In the old interface different components of 
         /// the jacobian are returned via different output parameters.</param>
         public static void ProjectPoints(
-            InputArrayRef objectPoints, OutputArrayRef imagePoints, InputArrayRef rvec, InputArrayRef tvec,
-            InputArrayRef k, InputArrayRef d, double alpha = 0, OutputArrayRef jacobian = default)
+            InputArray objectPoints, OutputArray imagePoints, InputArray rvec, InputArray tvec,
+            InputArray k, InputArray d, double alpha = 0, OutputArray jacobian = default)
         {
             NativeMethods.HandleException(
                 NativeMethods.calib_fisheye_projectPoints2(
@@ -64,7 +64,7 @@ public static void ProjectPoints(
         /// <param name="d">Input vector of distortion coefficients</param>
         /// <param name="alpha">The skew coefficient.</param>
         public static void DistortPoints(
-            InputArrayRef undistorted, OutputArrayRef distorted, InputArrayRef k, InputArrayRef d, double alpha = 0)
+            InputArray undistorted, OutputArray distorted, InputArray k, InputArray d, double alpha = 0)
         {
             NativeMethods.HandleException(
                 NativeMethods.calib_fisheye_distortPoints(
@@ -89,7 +89,7 @@ public static void DistortPoints(
         /// <param name="d">Input vector of distortion coefficients.</param>
         /// <param name="alpha">The skew coefficient.</param>
         public static void DistortPoints(
-            InputArrayRef undistorted, OutputArrayRef distorted, InputArrayRef kundistorted, InputArrayRef k, InputArrayRef d, double alpha = 0)
+            InputArray undistorted, OutputArray distorted, InputArray kundistorted, InputArray k, InputArray d, double alpha = 0)
         {
             NativeMethods.HandleException(
                 NativeMethods.calib_fisheye_distortPoints2(
@@ -114,8 +114,8 @@ public static void DistortPoints(
         /// <param name="p">New camera matrix (3x3) or new projection matrix (3x4)</param>
         // ReSharper disable once MemberHidesStaticFromOuterClass
         public static void UndistortPoints(
-            InputArrayRef distorted, OutputArrayRef undistorted,
-            InputArrayRef k, InputArrayRef d, InputArrayRef r = default, InputArrayRef p = default)
+            InputArray distorted, OutputArray undistorted,
+            InputArray k, InputArray d, InputArray r = default, InputArray p = default)
         {
             NativeMethods.HandleException(
                 NativeMethods.calib_fisheye_undistortPoints(
@@ -142,8 +142,8 @@ public static void UndistortPoints(
         /// <param name="map1">The first output map.</param>
         /// <param name="map2">The second output map.</param>
         public static void InitUndistortRectifyMap(
-            InputArrayRef k, InputArrayRef d, InputArrayRef r, InputArrayRef p,
-            Size size, int m1type, OutputArrayRef map1, OutputArrayRef map2)
+            InputArray k, InputArray d, InputArray r, InputArray p,
+            Size size, int m1type, OutputArray map1, OutputArray map2)
         {
             NativeMethods.HandleException(
                 NativeMethods.calib_fisheye_initUndistortRectifyMap(
@@ -168,8 +168,8 @@ public static void InitUndistortRectifyMap(
         /// may additionally scale and shift the result by using a different matrix.</param>
         /// <param name="newSize"></param>
         public static void UndistortImage(
-            InputArrayRef distorted, OutputArrayRef undistorted,
-            InputArrayRef k, InputArrayRef d, InputArrayRef knew = default, Size newSize = default)
+            InputArray distorted, OutputArray undistorted,
+            InputArray k, InputArray d, InputArray knew = default, Size newSize = default)
         {
             NativeMethods.HandleException(
                 NativeMethods.calib_fisheye_undistortImage(
@@ -196,8 +196,8 @@ public static void UndistortImage(
         /// <param name="newSize"></param>
         /// <param name="fovScale">Divisor for new focal length.</param>
         public static void EstimateNewCameraMatrixForUndistortRectify(
-            InputArrayRef k, InputArrayRef d, Size imageSize, InputArrayRef r,
-            OutputArrayRef p, double balance = 0.0, Size newSize = default, double fovScale = 1.0)
+            InputArray k, InputArray d, Size imageSize, InputArray r,
+            OutputArray p, double balance = 0.0, Size newSize = default, double fovScale = 1.0)
         {
             NativeMethods.HandleException(
                 NativeMethods.calib_fisheye_estimateNewCameraMatrixForUndistortRectify(
@@ -230,7 +230,7 @@ public static void EstimateNewCameraMatrixForUndistortRectify(
         /// <returns></returns>
         public static double Calibrate(
             IEnumerable<Mat> objectPoints, IEnumerable<Mat> imagePoints,
-            Size imageSize, InputOutputArrayRef k, InputOutputArrayRef d,
+            Size imageSize, InputOutputArray k, InputOutputArray d,
             out IEnumerable<Mat> rvecs, out IEnumerable<Mat> tvecs,
             FishEyeCalibrationFlags flags = 0, TermCriteria? criteria = null)
         {
@@ -290,9 +290,9 @@ public static double Calibrate(
         /// length.Balance is in range of[0, 1].</param>
         /// <param name="fovScale">Divisor for new focal length.</param>
         public static void StereoRectify(
-            InputArrayRef k1, InputArrayRef d1, InputArrayRef k2, InputArrayRef d2, 
-            Size imageSize, InputArrayRef r, InputArrayRef tvec, OutputArrayRef r1, OutputArrayRef r2, 
-            OutputArrayRef p1, OutputArrayRef p2, OutputArrayRef q, FishEyeCalibrationFlags flags, Size newImageSize = default,
+            InputArray k1, InputArray d1, InputArray k2, InputArray d2, 
+            Size imageSize, InputArray r, InputArray tvec, OutputArray r1, OutputArray r2, 
+            OutputArray p1, OutputArray p2, OutputArray q, FishEyeCalibrationFlags flags, Size newImageSize = default,
             double balance = 0.0, double fovScale = 1.0)
         {
             NativeMethods.HandleException(
@@ -335,8 +335,8 @@ public static void StereoRectify(
         /// <returns></returns>
         public static double StereoCalibrate(
             IEnumerable<Mat> objectPoints, IEnumerable<Mat> imagePoints1, IEnumerable<Mat> imagePoints2,
-            InputOutputArrayRef k1, InputOutputArrayRef d1, InputOutputArrayRef k2, InputOutputArrayRef d2, Size imageSize,
-            OutputArrayRef r, OutputArrayRef t, FishEyeCalibrationFlags flags = FishEyeCalibrationFlags.FixIntrinsic,
+            InputOutputArray k1, InputOutputArray d1, InputOutputArray k2, InputOutputArray d2, Size imageSize,
+            OutputArray r, OutputArray t, FishEyeCalibrationFlags flags = FishEyeCalibrationFlags.FixIntrinsic,
             TermCriteria? criteria = null)
         {
             if (objectPoints is null)

src/OpenCvSharp/Cv2/Cv2_calib.cs

@@ -84,9 +84,9 @@ public static Mat InitCameraMatrix2D(
     /// <returns>The function returns true if all of the corners are found and they are placed in a certain order (row by row, left to right in every row). 
     /// Otherwise, if the function fails to find all the corners or reorder them, it returns false.</returns>
     public static bool FindChessboardCorners(
-        InputArrayRef image,
+        InputArray image,
         Size patternSize,
-        OutputArrayRef corners,
+        OutputArray corners,
         ChessboardFlags flags = ChessboardFlags.AdaptiveThresh | ChessboardFlags.NormalizeImage)
     {
         NativeMethods.HandleException(
@@ -106,7 +106,7 @@ public static bool FindChessboardCorners(
     /// <returns>The function returns true if all of the corners are found and they are placed in a certain order (row by row, left to right in every row). 
     /// Otherwise, if the function fails to find all the corners or reorder them, it returns false.</returns>
     public static bool FindChessboardCorners(
-        InputArrayRef image,
+        InputArray image,
         Size patternSize,
         out Point2f[] corners,
         ChessboardFlags flags = ChessboardFlags.AdaptiveThresh | ChessboardFlags.NormalizeImage)
@@ -130,9 +130,9 @@ public static bool FindChessboardCorners(
     /// <param name="blobDetector">feature detector that finds blobs like dark circles on light background.</param>
     /// <returns></returns>
     public static bool FindCirclesGrid(
-        InputArrayRef image,
+        InputArray image,
         Size patternSize,
-        OutputArrayRef centers,
+        OutputArray centers,
         FindCirclesGridFlags flags = FindCirclesGridFlags.SymmetricGrid,
         FeatureDetector? blobDetector = null)
     {
@@ -155,7 +155,7 @@ public static bool FindCirclesGrid(
     /// <param name="blobDetector">feature detector that finds blobs like dark circles on light background.</param>
     /// <returns></returns>
     public static bool FindCirclesGrid(
-        InputArrayRef image,
+        InputArray image,
         Size patternSize,
         out Point2f[] centers,
         FindCirclesGridFlags flags = FindCirclesGridFlags.SymmetricGrid,
@@ -199,8 +199,8 @@ public static double CalibrateCamera(
         IEnumerable<Mat> objectPoints,
         IEnumerable<Mat> imagePoints,
         Size imageSize,
-        InputOutputArrayRef cameraMatrix,
-        InputOutputArrayRef distCoeffs,
+        InputOutputArray cameraMatrix,
+        InputOutputArray distCoeffs,
         out Mat[] rvecs,
         out Mat[] tvecs,
         CalibrationFlags flags = CalibrationFlags.None,
@@ -330,10 +330,10 @@ public static double CalibrateCamera(
     public static double RegisterCameras(
         IEnumerable<Mat> objectPoints1, IEnumerable<Mat> objectPoints2,
         IEnumerable<Mat> imagePoints1, IEnumerable<Mat> imagePoints2,
-        InputArrayRef cameraMatrix1, InputArrayRef distCoeffs1, CameraModel cameraModel1,
-        InputArrayRef cameraMatrix2, InputArrayRef distCoeffs2, CameraModel cameraModel2,
-        InputOutputArrayRef r, InputOutputArrayRef t, OutputArrayRef e, OutputArrayRef f,
-        OutputArrayRef perViewErrors, int flags = 0, TermCriteria? criteria = null)
+        InputArray cameraMatrix1, InputArray distCoeffs1, CameraModel cameraModel1,
+        InputArray cameraMatrix2, InputArray distCoeffs2, CameraModel cameraModel2,
+        InputOutputArray r, InputOutputArray t, OutputArray e, OutputArray f,
+        OutputArray perViewErrors, int flags = 0, TermCriteria? criteria = null)
     {
         if (objectPoints1 is null)
             throw new ArgumentNullException(nameof(objectPoints1));
@@ -397,10 +397,10 @@ public static double CalibrateMultiview(
         IEnumerable<Mat> objPoints,
         IReadOnlyList<IReadOnlyList<Mat>> imagePoints,
         IEnumerable<Size> imageSize,
-        InputArrayRef detectionMask,
-        InputArrayRef models,
+        InputArray detectionMask,
+        InputArray models,
         out Mat[] ks, out Mat[] distortions, out Mat[] rs, out Mat[] ts,
-        InputArrayRef flagsForIntrinsics = default,
+        InputArray flagsForIntrinsics = default,
         int flags = 0,
         TermCriteria? criteria = null)
     {
@@ -478,10 +478,10 @@ public static double StereoCalibrate(
         IReadOnlyList<Mat> objectPoints,
         IReadOnlyList<Mat> imagePoints1,
         IReadOnlyList<Mat> imagePoints2,
-        InputOutputArrayRef cameraMatrix1, InputOutputArrayRef distCoeffs1,
-        InputOutputArrayRef cameraMatrix2, InputOutputArrayRef distCoeffs2,
-        Size imageSize, OutputArrayRef R,
-        OutputArrayRef T, OutputArrayRef E, OutputArrayRef F,
+        InputOutputArray cameraMatrix1, InputOutputArray distCoeffs1,
+        InputOutputArray cameraMatrix2, InputOutputArray distCoeffs2,
+        Size imageSize, OutputArray R,
+        OutputArray T, OutputArray E, OutputArray F,
         CalibrationFlags flags = CalibrationFlags.FixIntrinsic,
         TermCriteria? criteria = null)
     {
@@ -548,8 +548,8 @@ public static double StereoCalibrate(
         IEnumerable<IEnumerable<Point2f>> imagePoints2,
         double[,] cameraMatrix1, double[] distCoeffs1,
         double[,] cameraMatrix2, double[] distCoeffs2,
-        Size imageSize, OutputArrayRef R,
-        OutputArrayRef T, OutputArrayRef E, OutputArrayRef F,
+        Size imageSize, OutputArray R,
+        OutputArray T, OutputArray E, OutputArray F,
         CalibrationFlags flags = CalibrationFlags.FixIntrinsic,
         TermCriteria? criteria = null)
     {
@@ -637,8 +637,8 @@ public static void CalibrateHandEye(
         IEnumerable<Mat> t_gripper2base,
         IEnumerable<Mat> R_target2cam,
         IEnumerable<Mat> t_target2cam,
-        OutputArrayRef R_cam2gripper,
-        OutputArrayRef t_cam2gripper,
+        OutputArray R_cam2gripper,
+        OutputArray t_cam2gripper,
         HandEyeCalibrationMethod method = HandEyeCalibrationMethod.TSAI)
     {
         if (R_gripper2base is null)
@@ -719,10 +719,10 @@ public static void CalibrateRobotWorldHandEye(
         IEnumerable<Mat> t_world2cam,
         IEnumerable<Mat> R_base2gripper,
         IEnumerable<Mat> t_base2gripper,
-        OutputArrayRef R_base2world, 
-        OutputArrayRef t_base2world,
-        OutputArrayRef R_gripper2cam,
-        OutputArrayRef t_gripper2cam,
+        OutputArray R_base2world, 
+        OutputArray t_base2world,
+        OutputArray R_gripper2cam,
+        OutputArray t_gripper2cam,
         RobotWorldHandEyeCalibrationMethod method = RobotWorldHandEyeCalibrationMethod.SHAH)
     {
         if (R_world2cam is null)