DirectShow¶

• DirectShow
  • Discontinued support
    • Architecture
    • Installing the XIMEA DirectShow Filter
    • Register XIMEA cameras for DirectShow
    • UnRegister XIMEA cameras from DirectShow
    • Supported DirectShow interfaces
      • IAMVideoControl
      • ICameraControl
      • IVideoProcAmp
    • Camera property page

Discontinued support¶

DirectShow interface to XIMEA cameras is no longer supported.
It was removed from XIMEA Windows Software Package starting 2017-03.

Architecture¶

The Microsoft DirectShow application programming interface (API) is a media-streaming architecture for Microsoft Windows.
Using DirectShow, applications can perform high-quality video and audio playback or capture.
All XIMEA cameras were supported by the XIMEA DirectShow filter XiVideoCapture.ax or XiVideoCaptureX64.ax for 64bit applications.

Installing the XIMEA DirectShow Filter¶

To add DirectShow support for XIMEA cameras please follow these steps:

1. Ensure that the operating system on PC is Microsoft Windows 7 or 8
2. Download and install the XIMEA API Software package Beta
3. During the Choose Components installation step make sure that the option xiDirectShow is checked and finish the installation process.
   
   
   
   

Register XIMEA cameras for DirectShow¶

After the cameras are connected or disconnected please run the
xiDirectShow_ReEnum.exe from the XIMEA\API\x86 folder (or XIMEA\API\x64 if 64 bit version is required.

Note: choose the platform according to the application software rather than the OS itself).
All connected XIMEA cameras will be enumerated for use with DirectShow applications.
If the currently logged user account does not have administrator privileges - please right click on it and select Run as Administrator.

UnRegister XIMEA cameras from DirectShow¶

To remove XIMEA cameras from DirectShow run the xiDirectShow_Remove.exe from the XIMEA\API\x86 folder (or XIMEA\API\x64 if 64 bit version is required)..

Supported DirectShow interfaces¶

IAMVideoControl¶

The IAMVideoControl interface enables the user to set the camera to hardware or software trigger mode.

ICameraControl¶

The ICameraControl interface provides the user control over the camera exposure.
It can be set manually or you can use the automatic exposure adjustment of XIMEA APIs.

IVideoProcAmp¶

The IVideoProcAmp interface allows to adjust of image sharpness, gamma, gain and white balance.
Gain and white balance parameters can be adjusted to work in automatic mode adjusted by algorithms from XIMEA APIs.

Camera property page¶

The custom XIMEA DirectShow property page provides access to camera parameters available in the XIMEA application programming interface.
Any change applied through the property dialog is immediately stored and applied afterward.
To remove stored values, press the Reset all to default values button.

Properties are grouped into several sections:

• Device info parameters: contains a basic description of the camera model, serial number and device type.
• Device acquisition settings: control basic camera properties, exposure, gain, image dimensions, triggering and control LEDs. Image dimensions can be adjusted only
  when the filter is in Stopped state, otherwise, they can not be edited from the property page.
• Color management settings: adjust white balance parameters, only available for color cameras.
• Automatic exposure/gain: use automatic exposure/gain functionality calculated by XIMEA APIs internal algorithms.
• Version info: information about versions of currently installed software (API and driver) and camera firmware.