SwisTrack/Components/InputCameraGigE

From Wikibooks, open books for an open world
Jump to navigation Jump to search

Description[edit | edit source]

This component grabs frames from a Basler Vision gigabit ethernet camera (scout or pilot series, or a compatible model) using the Basler Pylon driver (version 2.0). Note that this component is not part of the standard distribution of SwisTrack and requires compiling SwisTrack by yourself.

Input[edit | edit source]

A Pylon compliant GigE (Gigabit Ethernet) camera, such as the scout or pilot GigE cameras from Basler Vision.

Output[edit | edit source]

A grayscale or a color image.

Trigger Mechanism[edit | edit source]

If configured in software trigger mode, this component always accepts processing frames.

In all other trigger modes, the component vetoes execution until the next frame from the camera is ready.

Parameters[edit | edit source]

Camera[edit | edit source]

Choose the GigE camera you want to use to acquire images. The special entry "Any" takes any available camera (actually the camera that the driver lists as first camera).

Mode[edit | edit source]

Color or grayscale mode. Note that you anyway need to add an input conversion component.

Trigger mode[edit | edit source]

If you have an external trigger connected to your camera, select the trigger input line here. Acquisition will be triggered on the rising edge.

Timer uses the internal timer of the camera.

Software trigger sends the trigger signal over ethernet, which is not as precise as an external trigger or the internal timer. (In this configuration, the component does not act as a trigger.)

Timer[edit | edit source]

Sets the internal timer trigger of the camera. Note that this field is only used if Trigger mode is set to Timer.

Exposure time[edit | edit source]

Raw exposure time. This value is multiplied by the exposure time base of the camera to obtain the actual exposure time. Refer to the camera documentation for details.

Analog gain[edit | edit source]

Analog gain. Refer to the camera documentation for details.

Area of Interest (Offset and Size)[edit | edit source]

The image area to sample and transmit. Smaller areas will result in higher frame rates.

Input buffer size[edit | edit source]

The number of input buffers (in number of frames) to provide to the camera driver. The camera driver will fill these buffers in case the computer is temporarily busy with other tasks and not able read the frames at the speed they arrive. Recommended values are:

  • 1 - 4 for online processing (e.g. for live tracking of robots)
  • 8 - 16 for offline processing (e.g. recording for post-experiment analysis)