Samples: Automatic updates to public repository

Remember to do the following:
    1. Ensure that modified/deleted/new files are correct
    2. Make this commit message relevant for the changes
    3. Force push
    4. Delete branch after PR is merged

If this commit is an update from one SDK version to another,
make sure to create a release tag for previous version.

Author: csu-bot-zivid

README.md

@@ -177,7 +177,7 @@ from the camera can be used.
         CUDA device using OpenCV.
       - [CaptureAndConvertToDlpackTensorOnCuda] - Capture a 2D+3D frame
         with the Zivid SDK and build DLPack tensors directly from the
-        Zivid DeviceArrays on the CUDA device.
+        Zivid DeviceArrays on the CUDA
     - **Transform**
       - [TransformPointCloudFromMillimetersToMeters] - Transform point
         cloud data from millimeters to meters.

source/CMakeLists.txt

@@ -157,6 +157,7 @@ set(Clipp_DEPENDING
     CaptureViaGenICam
     CaptureWithSettingsFromYML
     CaptureWritePCLVis3D
+    Connect
     ConvertZDF
     GammaCorrection
     HandEyeCalibration

source/Camera/Basic/Connect/Connect.cpp

@@ -1,15 +1,43 @@
 /*
 Connect to a Zivid camera using the different available methods.
 
-Replace the IP address and serial number in the code with the ones of your camera.
+Replace the IP address, serial number and hostname in the code with the ones of your camera,
+or provide them with --serial, --ip and --hostname.
 */
 
 #include <Zivid/Zivid.h>
 
+#include <clipp.h>
+
 #include <iostream>
 
 namespace
 {
+    struct CameraIdentifiers
+    {
+        std::string serialNumber{ "2020C0DE" };
+        std::string ipAddress{ "172.28.60.5" };
+        std::string hostname{ "zivid-2020C0DE.local" };
+    };
+
+    CameraIdentifiers parseOptions(int argc, char **argv)
+    {
+        CameraIdentifiers identifiers;
+        auto cli =
+            (clipp::option("--serial")
+                 & clipp::value("serial number", identifiers.serialNumber).doc("Serial number of the camera"),
+             clipp::option("--ip") & clipp::value("ip address", identifiers.ipAddress).doc("IP address of the camera"),
+             clipp::option("--hostname")
+                 & clipp::value("hostname", identifiers.hostname).doc("Hostname of the camera"));
+
+        if(!clipp::parse(argc, argv, cli))
+        {
+            std::cout << clipp::usage_lines(cli, "Connect") << std::endl;
+            throw std::runtime_error{ "Invalid usage" };
+        }
+        return identifiers;
+    }
+
     void printDiscoveredCameras(Zivid::Application &zivid)
     {
         std::cout << "Discovered cameras:" << std::endl;
@@ -21,41 +49,39 @@ namespace
     }
 } // namespace
 
-int main()
+int main(int argc, char **argv)
 {
     try
     {
+        const auto identifiers = parseOptions(argc, argv);
+
         Zivid::Application zivid;
 
         printDiscoveredCameras(zivid);
 
-        std::cout << "The serial number, IP address and hostname below are placeholders. "
-                     "Replace them with the ones of your camera."
-                  << std::endl;
-
         {
             std::cout << "Connecting to the first available camera" << std::endl;
             auto camera = zivid.connectCamera();
             camera.disconnect();
         }
 
         {
-            std::cout << "Connecting to the camera with a specific serial number" << std::endl;
-            auto camera = zivid.connectCamera(Zivid::CameraInfo::SerialNumber{ "2020C0DE" });
+            std::cout << "Connecting to the camera with serial number " << identifiers.serialNumber << std::endl;
+            auto camera = zivid.connectCamera(Zivid::CameraInfo::SerialNumber{ identifiers.serialNumber });
             camera.disconnect();
         }
 
         {
-            std::cout << "Connecting to the camera at a specific IP address" << std::endl;
-            auto camera = zivid.connectCamera(Zivid::CameraAddress{ "172.28.60.5" });
+            std::cout << "Connecting to the camera at IP address " << identifiers.ipAddress << std::endl;
+            auto camera = zivid.connectCamera(Zivid::CameraAddress{ identifiers.ipAddress });
             camera.disconnect();
         }
 
         {
-            std::cout << "Connecting to the camera at a specific hostname" << std::endl;
+            std::cout << "Connecting to the camera at hostname " << identifiers.hostname << std::endl;
             // The default hostname format is "zivid-<serial-number>.local".
             // The hostname cannot be read or set through the SDK.
-            auto camera = zivid.connectCamera(Zivid::CameraAddress{ "zivid-2020C0DE.local" });
+            auto camera = zivid.connectCamera(Zivid::CameraAddress{ identifiers.hostname });
             camera.disconnect();
         }