C#

Sample list

There are two main categories of samples: Camera and Applications. The samples in the Camera category focus only on how to use the camera. The samples in the Applications category use the output generated by the camera, such as the 3D point cloud, a 2D image or other data from the camera. These samples shows how the data from the camera can be used.

• 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 colored point cloud with the Zivid SDK, convert it to a HALCON point cloud and save it.

  • 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, printing statuses and values each 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 in the scene and report the flickering frequency when 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 using the marker’s estimated pose.

      • TransformPointCloudViaCheckerboard - Transform a point cloud from camera to checkerboard coordinate frame using the 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 using Local Point Cloud Registration, then 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 a data point or entire point cloud from camera to robot base frame using the Hand-Eye calibration matrix.

    • 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.

Instructions

1. Install Zivid Software

2. Download Zivid Sample Data

Launch the Command Prompt by pressing Win + R keys on the keyboard, then type cmd and press Enter.

Navigate to a location where you want to clone the repository, then run to following command:

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

Open ZividNETSamples.sln in Visual Studio, build it and run it. If you are uncertain about doing this, check out Build C# Samples using Visual Studio.

Some of the samples depend on external libraries, in particular MathNet.Numerics and System.ValueTuple. These libraries will be installed automatically through NuGet when building the sample.

• Build a C# “Zivid Hello World” Application in Visual Studio on Windows
• Build C# Samples using Visual Studio