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


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.

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.

Go to source


const auto fileCamera =
    userInput ? fileCameraPath : std::string(ZIVID_SAMPLE_DATA_DIR) + "/FileCameraZivid2M70.zfc";
Go to source


fileCamera = Environment.GetFolderPath(Environment.SpecialFolder.CommonApplicationData) + "/Zivid/FileCameraZivid2M70.zfc";
Go to source


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

Go to source


auto camera = zivid.createFileCamera(fileCamera);
Go to source


var camera = zivid.CreateFileCamera(fileCamera);
Go to source


camera = app.create_file_camera(file_camera)

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


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

Go to source


const auto settings = Zivid::Settings{ Zivid::Settings::Acquisitions{ Zivid::Settings::Acquisition{} },
                                       Zivid::Settings::Processing::Filters::Smoothing::Gaussian::Sigma{ 1.5 },
                                       Zivid::Settings::Processing::Color::Balance::Red{ 1 },
                                       Zivid::Settings::Processing::Color::Balance::Green{ 1 },
                                       Zivid::Settings::Processing::Color::Balance::Blue{ 1 } };
Go to 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, Mode = ReflectionFilterModeOption.Global} } },
                   Color = { Balance = { Red = 1.0, Green = 1.0, Blue = 1.0 } } }
Go to source


settings = zivid.Settings()
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.mode = "global" = 1.0 = 1.0 = 1.0

Zivid File Camera with Zivid Studio

Launch Zivid Studio from terminal and access the file camera.

ZividStudio --file-camera C:/ProgramData/Zivid/FileCameraZivid2M70.zfc
ZividStudio --file-camera /usr/share/Zivid/data/FileCameraZivid2M70.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.


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


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




File cameras added for current camera models.