File Camera

The Zivid file camera allows users to test the output of the zivid camera without actually having a physical camera at hand. This feature uses a previously acquired point cloud. Using a file camera allows you to:

• View the point cloud in Zivid Studio or visualize it with the file camera visualization sample

• Adjust filters and color settings to inspect their impact on the point cloud and the 2D RGB image

• Work on your code without needing to have a camera connected at all times

• Test the Zivid API without having a physical camera

Warning

Changing the acquisition settings or the engine type is not recommended as these settings must be the same as the settings that were used to acquire the point cloud.

There are multiple file camera options to choose from. Each file camera demonstrates a use case within one of the main applications of the respective camera model. Hence, you may choose file camera based on either your preferred camera model or application. The available file cameras are shown below.

Zivid Two

Zivid Two M70 and Robot Guidance

Zivid Two L100 and Bin Picking

Zivid One+

Zivid One+ S and Inspection

Zivid One+ M and Piece Picking

Zivid One+ L and Depalletizing

How to access and use the Zivid File Camera

After downloading the Sample Data, you can access a file camera in two ways.

Zivid File Camera with Zivid Samples

The API allows you to connect to a file camera similar to a physical camera by referencing the path of the file camera. Once the file camera connection has been made, the usage is analogous.

C++

source

const auto fileCamera =
    userInput ? fileCameraPath : std::string(ZIVID_SAMPLE_DATA_DIR) + "/FileCameraZividTwoM70.zfc";

C#

source

fileCamera = Environment.GetFolderPath(Environment.SpecialFolder.CommonApplicationData) + "/Zivid/FileCameraZividTwoM70.zfc";

Python

source

default=get_sample_data_path() / "FileCameraZividTwoM70.zfc",

C++

source

auto camera = zivid.createFileCamera(fileCamera);

C#

source

var camera = zivid.CreateFileCamera(fileCamera);

Python

source

camera = app.create_file_camera(file_camera)

The filters and color settings can be adjusted before taking a capture.

Warning

The acquisition settings should be initialized like shown below. Take care to not change the acquisition settings or the engine.

C++

source

const auto settings =
    Zivid::Settings{ Zivid::Settings::Acquisitions{ Zivid::Settings::Acquisition{} },
                     Zivid::Settings::Processing::Filters::Smoothing::Gaussian::Enabled::yes,
                     Zivid::Settings::Processing::Filters::Smoothing::Gaussian::Sigma{ 1.5 },
                     Zivid::Settings::Processing::Filters::Reflection::Removal::Enabled::yes,
                     Zivid::Settings::Processing::Filters::Reflection::Removal::Experimental::Mode::global,
                     Zivid::Settings::Processing::Color::Balance::Red{ 1 },
                     Zivid::Settings::Processing::Color::Balance::Green{ 1 },
                     Zivid::Settings::Processing::Color::Balance::Blue{ 1 } };

C#

source

var settings = new Zivid.NET.Settings
{
    Acquisitions = { new Zivid.NET.Settings.Acquisition { } },
    Processing = { Filters = { Smoothing = { Gaussian = { Enabled = true, Sigma = 1.5 } },
                               Reflection = { Removal = { Enabled = true, Experimental = { Mode = ReflectionFilterModeOption.Global} } } },
                   Color = { Balance = { Red = 1.0, Green = 1.0, Blue = 1.0 } } }
};

Python

source

settings = zivid.Settings()
settings.acquisitions.append(zivid.Settings.Acquisition())
settings.processing.filters.smoothing.gaussian.enabled = True
settings.processing.filters.smoothing.gaussian.sigma = 1
settings.processing.filters.reflection.removal.enabled = True
settings.processing.filters.reflection.removal.experimental.mode = "global"
settings.processing.color.balance.red = 1.0
settings.processing.color.balance.green = 1.0
settings.processing.color.balance.blue = 1.0

Zivid File Camera with Zivid Studio

Launch Zivid Studio from terminal and access the file camera.

Windows

ZividStudio --file-camera=C:/ProgramData/Zivid/FileCameraZividTwoM70.zfc

Ubuntu

ZividStudio --file-camera=/usr/share/Zivid/data/FileCameraZividTwoM70.zfc

When Zivid Studio opens, select the manual settings option before capturing. You can then adjust filters and color settings to view their impact on the point cloud by capturing every time you have changes to apply.

Warning

Take care to not change the acquisition settings or the engine.

Tip

Turn on the reflection filter to remove floating points.

The video below shows how to access and use a file camera in Zivid Studio.

Version History

SDK	Changes
2.9.0	File cameras added for current camera models.