Skip to content

Filter install/uninstall

Package contents

Item Description
Install_and_Redist\Auto_install\ Datastead_MultipurposeEncoder.exe, the self-installer, which installs, registers and uninstalls the filter automatically
Install_and_Redist\Manual_install\x86\ the 32-bit filter (DatasteadMultiPurposeEncoder_x86.ax), ffmpegLGPL.exe, the FFmpeg DLLs, and the register / unregister scripts
Install_and_Redist\Manual_install\x64\ the same files for 64-bit (DatasteadMultiPurposeEncoder_x64.ax)
include\Cpp\, include\CSharp\, include\Delphi\ the CLSIDs, interface declarations and event codes
SampleCode\ the C# demo project, based on DirectShow.NET
Precompiled_Demo\ the same demo, compiled, to check the installation without building anything
License_Agreement.html the license terms

Note

Keep the content of each folder together. The filter looks for ffmpegLGPL.exe and for the FFmpeg DLLs in its own folder, so the .ax file, the transcoder and the DLLs must stay side by side.

A) Using the filter from the TVideoGrabber SDK (no installer, no registration)

TVideoGrabber can load the filter binaries directly from a folder, so neither the installer nor the registration is needed.

Copy the x86 and x64 folders of Install_and_Redist\Manual_install next to the application executable, so that both subfolders sit beside it:

c:\appfolder\application.exe
c:\appfolder\x86\
c:\appfolder\x64\

TVideoGrabber picks the folder matching the bitness of the running process. When the application targets only one platform, the content of the corresponding folder can be copied directly next to the executable instead.

B) Installing with the self-installer

The single .exe installer included in the package installs and registers automatically:

  • the x86 version of the filter on 32-bit versions of Windows,
  • both the x86 and the x64 versions on 64-bit versions of Windows.

Installing the package interactively

Double-click on the .exe installer, and accept each confirmation dialog.

Installing the package from the command line

Datastead_MultipurposeEncoder.exe /silent
Datastead_MultipurposeEncoder.exe /verysilent

/verysilent also hides the splash screen.

Uninstalling the package from the command line

"C:\Program Files\Datastead\MultipurposeEncoder\unins000.exe"

Uninstalling the package from Windows

Windows Settings -> Apps (or Control Panel -> Programs and Features), then uninstall the Datastead Multipurpose DirectShow Encoder.

C) Registering the filter manually

  1. copy the Install_and_Redist\Manual_install\x86 and/or ...\x64 folder to a permanent location,
  2. in that folder, run _REGISTER_FILTER.cmd (right-click, Run as administrator). The script registers every .ax file of its own folder with regsvr32.exe.

The equivalent, done by hand, is:

regsvr32.exe c:\filtersfolder\x86\DatasteadMultiPurposeEncoder_x86.ax
regsvr32.exe c:\filtersfolder\x64\DatasteadMultiPurposeEncoder_x64.ax

To remove the filter, run _UNREGISTER_FILTER.cmd from the same folder as administrator, or:

regsvr32.exe /u c:\filtersfolder\x86\DatasteadMultiPurposeEncoder_x86.ax
regsvr32.exe /u c:\filtersfolder\x64\DatasteadMultiPurposeEncoder_x64.ax

Note

The registration scripts must be run from the folder that contains the .ax file, and they refuse to run from a system folder. A third-party installer normally offers an option to COM-register a binary; it must be applied to the .ax files.

Which build should I install?

What matters is how the application is compiled, not which version of Windows the end user runs:

  • application compiled for x64 only (VS.NET target platform set to x64): distribute the x64 filter only; it requires a 64-bit version of Windows,
  • application compiled for x86 only (target platform set to x86): distribute the x86 filter only; it runs on both 32-bit and 64-bit versions of Windows,
  • application compiled for both x86 and x64 (target platform set to Any CPU): install the x86 filter on 32-bit versions of Windows, and both the x86 and the x64 filters on 64-bit versions of Windows.

The self-installer applies these rules automatically.

Checking the installation

  • with the precompiled demo: run Precompiled_Demo\DatasteadMultipurposeEncoder_CSharp_Demo.exe and start an encoding,
  • with GraphStudioNext or GraphEdit: Graph -> Insert Filters -> DirectShow Filters, and check that Datastead Encoder, Datastead Multipurpose Encoder and Datastead Multipurpose Encoder (From File) are listed. The bitness of the graph editor must match the bitness of the registered filter.

Note

ffmpegLGPL.exe, the LGPL build of FFmpeg invoked by the filter, is installed in the installation folder of the filter. The Multipurpose DirectShow Encoder does not install any GPL code.