Page Comparison

The basic properties of the acquired image can be configured through features in the Image Format category.

The Pixel Format “Pixel Format” feature is an enumeration allowing to specify the type of image data delivered to the application buffer. The available pixel formats differ among camera models. In general, they can be

- Monochrome, with various number of bits per pixel, eg. Mono 8 or Mono 12.

- Bayer encoded, with sensor-dependent Bayer formats, eg. Bayer GR 8 or  Bayer BG 8. In this case the application needs to decode the Bayer encoded image buffer to get a proper color image — SynView API provides functions for this.

- RGB color format, providing true RGB output, in this case the Bayer decoding is performed directly by the camera.

The camera will acquire full size image by default. The acquired image size can be reduced using the Width “Width and Height Height” features, which set the acquired image size in pixels. The field of view will be automatically centered within the full sensor image.

The luminance of the acquired image can be controlled either explicitly through exposure time and gain functions, or automatically through corresponding auto-functions.

The Exposure Time “Exposure Time” feature in Acquisition Control “Acquisition Control” category configures the length of the exposure in microseconds.

Analog gain to be applied on the sensor during acquired image digitization can be configured through corresponding features in Analog Control “Analog Control” category. Verify that the Gain Selector “Gain Selector” feature is set to Analog analog (some cameras models support also digital gain). Now the Gain gain feature controls the desired analog gain value in decibel.

Selected camera models support automatic gain and/or automatic exposure functions, when the camera keeps adjusting given parameter automatically, to maintain constant image luminance. The features will be displayed in the feature tree only if the camera supports them. To switch the auto function on, navigate to corresponding control feature, Automatic “Automatic Exposure in Acquisition Control Control” category or Automatic “Automatic Gain in Analog Control Control” category and switch them from Off “Off” to Continuous“Continuous”.

The camera starts by default in “free running” mode — acquiring continuous stream of image frames. On the other hand in the triggered mode, the acquisition of individual frames can be explicitly controlled by hardware or software triggers. The trigger related features are located in the Acquisition Control “Acquisition Control” category.

To switch the camera to triggered mode“Triggered mode”, open the Trigger Selector “Trigger Selector” subtree and set Trigger Mode “Trigger Mode” to On“On”. After starting the acquisition again, the camera will acquire images only when explicit trigger signal arrives.

The Trigger Source source enumeration allows to select where should the camera “listen for triggers”. You can select either Software or one of the camera's I/O lines. The assignment of the I/O lines to the connector pins is described in Section, Connector and cable description.

The software Software triggers can be issued during active acquisition in triggered mode, regardless whether the trigger source is set to Software or a physical I/O line. To apply the software trigger, select the Generate “Generate Software Trigger Trigger” feature and click the button in the tool bar.

The strobe can be configured using features in the Digital “Digital I/O Control Control” category, after switching the feature visibility level to “expert”. Select the desired output line, where the strobe pulses should be applied through Line Selector (the I/O line mapping to interface connector pins is described in Section, Connector and cable description). Switch the strobe on for the selected line by setting Line Source to Exposure Active“Exposure Active”. The camera will issue a strobe pulse aligned with the exposure for every acquired frame. The strobe output is available only in triggered mode. In case the camera has an integrated Strobe Ring, its Strobe can be controlled through the Strobe Control “Strobe Control” category. Select which Clusters to use with Strobe Enable. Strobe Duration sets the length of the Strobe Pulse.

Information about the camera. It is frequently necessary to query the basic information about the camera. The information is available through features in the Device Control category.

The most important features identifying the camera are Vendor Name and Model Name. The camera's serial number is stored as string in feature Device ID (available only in “expert” feature level). Finally, the “nick-name” used to identify the device is accessible (read/write) in DeviceUser ID.

The version of the firmware loaded on the camera is accessible as string in feature Device Firmware Version.