C#

サンプルリスト

サンプルには、カメラ と アプリケーション という 2 つの主なカテゴリがあります。 カメラ カテゴリのサンプルは、カメラの使用方法のみに焦点を当てています。 アプリケーション カテゴリのサンプルは、3D 点群、2D 画像、カメラからのその他のデータなど、カメラによって生成された出力を使用します。これらのサンプルは、カメラからのデータがどのように使用されるかを示しています。

• Camera

  • Basic

    • Capture - Capture colored point cloud, save 2D image, save 3D ZDF, and export PLY, using the Zivid camera.

    • CaptureFromFileCamera - Capture point clouds, with color, with the Zivid file camera.

    • CaptureHDRCompleteSettings - Capture point clouds, with color, from the Zivid camera with fully configured settings.

    • CaptureWithSettingsFromYML - Capture images and point clouds, with and without color, from the Zivid camera with settings from YML file.

    • Connect - Connect to a Zivid camera using the different available methods.

    • CreateFileCameraFromZDFWithDiagnostics - Capture a frame with diagnostics enabled and create a file camera from it.

  • Advanced

    • CaptureAndPrintNormals - Capture Zivid point clouds, compute normals and print a subset.

    • CaptureHalconViaGenICam - Capture and save a point cloud, with colors, using GenICam interface and Halcon C++ SDK.

    • CaptureHalconViaZivid - Capture a point cloud, with colors, using Zivid SDK, transform it to a Halcon point cloud and save it using Halcon C++ SDK.

  • InfoUtilOther

    • CameraInfo - List connected cameras and print camera version and state information for each connected camera.

    • CameraUserData - Store user data on the Zivid camera.

    • CaptureWithDiagnostics - Capture a 2D+3D frame and a 2D frame from the Zivid camera with diagnostics enabled.

    • CheckHealth - Poll the camera health check from a separate thread while capturing in the main thread, printing the statuses and values every second.

    • FirmwareUpdater - Update firmware on the Zivid camera.

    • FrameInfo - Read frame info from the Zivid camera.

    • GetCameraIntrinsics - Read intrinsic parameters from the Zivid camera (OpenCV model) or estimate them from the point cloud.

    • MeasureSceneConditions - Measure ambient light conditions in the scene and output the measured flickering frequency of the ambient light if flickering is detected.

    • Warmup - Short example of a basic way to warm up the camera with specified time and capture cycle.

    • Network

      • AutomaticNetworkConfigurationForCameras - Automatically configure the IP addresses of connected cameras to match the network of the user's PC.

      • NetworkConfiguration - Uses Zivid API to change the IP address of the Zivid camera.

  • Maintenance

    • CorrectCameraInField - Correct the dimension trueness of a Zivid camera.

    • ResetCameraInField - Reset infield correction on a camera.

    • VerifyCameraInField - Check the dimension trueness of a Zivid camera.

    • VerifyCameraInFieldFromZDF - Check the dimension trueness of a Zivid camera from a ZDF file.

• Applications

  • Basic

    • Visualization

      • CaptureFromFileCameraVis3D - Capture point clouds, with color, with the Zivid file camera and visualize them.

      • CaptureVis3D - Capture point clouds, with color, from the Zivid camera, and visualize them.

      • ProjectImageStartAndStop - Start the Image Projection and Stop it.

    • FileFormats

      • ReadIterateZDF - Read point cloud data from a ZDF file, iterate through it, and extract individual points.

      • ZDF2PLY - Convert point cloud from a ZDF file to a PLY file.

  • Advanced

    • Downsample - Downsample point cloud from a ZDF file.

    • MaskPointCloud - Mask point cloud from a ZDF file using the Mask API and visualize it with Zivid.NET Visualizer.

    • Visualization

      • CaptureVis3DInLoop - Capture point clouds, with color, from the Zivid camera, and visualize them in a loop.

      • CaptureVis3DInLoopWithKeypressExit - Capture point clouds, with color, from the Zivid camera, and visualize them in a loop. Press 'q' to exit.

    • Transform

      • TransformPointCloudFromMillimetersToMeters - Transform point cloud data from millimeters to meters.

      • TransformPointCloudViaArucoMarker - Transform a point cloud from camera to ArUco marker coordinate frame by estimating the marker's pose from the point cloud.

      • TransformPointCloudViaCheckerboard - Transform a point cloud from camera to checkerboard (Zivid Calibration Board) coordinate frame by getting checkerboard pose from the API.

    • Roi

      • ROIBoxViaArucoMarker - Filter the point cloud based on a ROI box given relative to the ArUco marker on a Zivid Calibration Board.

      • ROIBoxViaCheckerboard - Filter the point cloud based on a ROI box given relative to the Zivid Calibration Board.

    • Stitching

      • StitchContinuouslyRotatingObject - Stitch point clouds from a continuously rotating object without pre-alignment using Local Point Cloud Registration and apply Voxel Downsample.

      • StitchUsingRobotMountedCamera - Stitch multiple point clouds captured with a robot mounted camera.

      • StitchViaLocalPointCloudRegistration - Stitch two point clouds using a transformation estimated by Local Point Cloud Registration and apply Voxel Downsample.

    • HandEyeCalibration

      • HandEyeCalibration - Perform Hand-Eye calibration.

      • PoseConversions - Convert to/from Transformation Matrix (Rotation Matrix + Translation Vector)

      • UtilizeHandEyeCalibration - Transform single data point or entire point cloud from camera to robot base reference frame using Hand-Eye calibration

    • MultiCamera

      • MultiCameraCalibration - Use captures of a calibration object to generate transformation matrices to a single coordinate frame.

    • Projector

      • ReadProjectAndCaptureImage - Read a 2D image from file and project it using the camera projector.

手順

1. Zivid ソフトウェアをインストールします

2. Zivid サンプル データをダウンロードする

キーボードの Win + R キーを押してコマンド プロンプトを起動し、次に cmd と入力して Enter を押します。

リポジトリのクローンを作成する場所に移動し、次のコマンドを実行します。

git clone https://github.com/zivid/zivid-csharp-samples

Visual Studio で ZividNETSamples.sln を開き、ビルドして実行します。これを行うかどうか不明な場合は、 Visual Studio を使用して C# サンプルをビルドする をご確認ください。

一部のサンプルは、外部ライブラリ、特に MathNet.Numerics と System.ValueTuple に依存しています。これらのライブラリは、サンプルをビルドする際に NuGet を通じて自動的にインストールされます。

• Windows 上の Visual Studio で C# の「Zivid Hello World」アプリケーションを作成する
• Visual Studio を使用して C# サンプルをビルドする