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

Available File Cameras

All file cameras are available through Sample Data. Each file camera demonstrates a use case within one of the main applications of the respective camera model. Choose a file camera based on your preferred camera model or application.

Zivid 2+R

MR60, Small Bin Picking

MR130, Piece Picking

LR110, Parcel and Big Bin Picking

Zivid 2+

M60, Small Bin Picking

M130, Bin Picking

L110, Parcel and Big Bin Picking

Zivid 2

M70, Robot Guidance

L100, Bin Picking

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

C++

source

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

C#

source

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

Python

source

default=get_sample_data_path() / "FileCameraZivid2PlusMR60.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. Do not change the acquisition settings or the engine.

C++

source

Zivid::Settings 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::Mode::global,
};
Zivid::Settings2D settings2D{ Zivid::Settings2D::Acquisitions{ Zivid::Settings2D::Acquisition{} },
                              Zivid::Settings2D::Processing::Color::Balance::Red{ 1 },
                              Zivid::Settings2D::Processing::Color::Balance::Green{ 1 },
                              Zivid::Settings2D::Processing::Color::Balance::Blue{ 1 } };

settings.color() = Zivid::Settings::Color{ settings2D };

C#

source

var settings2D = new Zivid.NET.Settings2D
{
    Acquisitions = { new Zivid.NET.Settings2D.Acquisition { } },
    Processing =
    {
        Color =
        {
            Balance = { Red = 1.0, Green = 1.0, Blue = 1.0 }
        }
    }
};
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}
            }
        }
    }
};
settings.Color = settings2D;

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.mode = "global"

settings_2d = zivid.Settings2D()
settings_2d.acquisitions.append(zivid.Settings2D.Acquisition())
settings_2d.processing.color.balance.blue = 1.0
settings_2d.processing.color.balance.green = 1.0
settings_2d.processing.color.balance.red = 1.0

settings.color = settings_2d

Zivid File Camera with Zivid Studio

The simplest way to open a file camera through Zivid Studio is by double-clicking on the ZFC file. Alternatively, you can also open it from Zivid Studio by:

• Click on File → Open

• Navigate to the location of your ZFC file

• Click Open

It is also possible to drag and drop a ZFC file into Zivid Studio.

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

Do not change the acquisition settings of your file camera.

Version History

SDK	Changes
2.14.0	Added support to open file camera by double-clicking on it or from Zivid Studio with File → Open.
2.9.0	File cameras added for current camera models.