Skip to content

FAQ and troubleshooting

The device does not appear in the host application

  • the registration must be run as administrator (_REGISTER_FILTER.cmd, or the automatic installer),
  • the host application must be 64-bit: the package ships the x64 filter only, a 32-bit application does not see it,
  • check that the filter loads: all the DLLs of Install_Manually\x64 must have stayed next to the .ax (or be on the PATH), and the Visual C++ 2015-2022 x64 Redistributable must be installed. See Installation.

No cameras found

The GenTL producer was not located, or the camera is not reachable:

  • check that GENICAM_GENTL64_PATH, or the producer selected in the Device page, points to an existing 64-bit .cti, see GenTL producer (.cti),
  • check that the vendor transport runtime (e.g. Vimba X) is installed and that its own viewer sees the camera,
  • check that the camera is not already opened by another application: a GenICam camera is exclusive.

The picture is dark, or Brightness has no effect

On Allied Vision Alvium cameras, Brightness is the auto-exposure / auto-gain target: it only acts while Exposure auto or Gain auto is enabled. Enable auto first, then move Brightness. In manual mode, raise the exposure time or the gain instead. See Standard DirectShow controls.

A control is missing in the host dialog

The camera does not expose that feature, or exposes it as read-only. The available controls and their ranges come from the camera itself. The Features page (or IGenicamControl2::RefreshFeatureTree) shows the exact capabilities of the camera.

Changing the pixel format, the ROI or the binning has no effect

These settings are applied when the camera opens and are fixed for the session: stop the graph (preview or recording), change them, then start again. Only the exposure, the gain, the frame rate and the auto modes are changed on the fly. See Using the capture device.

The frame rate is lower than the value I set

The camera clamps AcquisitionFrameRate to what the exposure time, the ROI, the pixel format and the interface bandwidth allow; the Exposure page shows the camera-reported maximum next to the value (GetFloatRange("AcquisitionFrameRate", ...)). Reduce the exposure time or the ROI, or enable binning, to reach a higher rate.

Frames are dropped

GetStats tells the dropped and incomplete counters apart. Dropped frames mean the host does not consume the frames fast enough (the filter keeps the most recent ones); incomplete frames come from the transport (USB bandwidth, cable, hub). See Acquisition statistics.

A watermark is drawn over the video, or the Bayer output stops after 60 seconds

The filter is running in evaluation mode. In the licensed package, check that the license key is passed before the graph starts; without it, the licensed filter shows a "license key missing" overlay. The licensed version is available from our online store.

Can the filter be used without TVideoGrabber?

Yes: it is a standard DirectShow video capture device, usable from any DirectShow application (C++, DirectShow.NET, and so on), and from everyday applications such as OBS Studio, VLC, ffmpeg or AMCap. See the Interface reference for programmatic control.

Which cameras are supported?

Any camera with a GenICam / GenTL compliant producer: USB3 Vision, GigE Vision, and the other transports the vendor's .cti covers. The filter has been developed and validated with Allied Vision Alvium USB3 cameras through Vimba X; other vendors' producers follow the same standard.

Should I buy one license per end user?

No: the license is a royalty-free developer license. See https://www.datastead.com/purchase/, or ask contact@datastead.com.