Complete TVFVideoCapture Library Deployment Guide¶
When distributing applications built with the TVFVideoCapture library, you'll need to deploy several framework components to ensure proper functionality on end-user systems. This guide covers all deployment scenarios to help you create reliable installations.
Deployment Options Overview¶
You have two primary approaches for deploying the necessary components: automatic installers for simpler deployment or manual installation for more customized setups.
Automatic Silent Installers (Requires Admin Rights)¶
These pre-configured installers handle dependencies automatically and can be integrated into your application's installation process:
Essential Components¶
- Base Package (mandatory for all deployments)
- Delphi Version
- ActiveX Version
Optional Feature Components¶
- FFMPEG Package (required for file or IP camera sources)
-
MP4 Output Support
-
VLC Source Package (alternative option for file or IP camera sources)
- x86 Architecture
Manual Installation Process (Requires Admin Rights)¶
For more control over the deployment process, follow these detailed steps:
Step 1: Install Required Dependencies¶
- Deploy Visual C++ 2010 SP1 redistributables:
- x86 Architecture
- x64 Architecture
Step 2: Deploy Core Components¶
- Copy all Media Foundation Platform (MFP) DLLs from the
Redist\Filtersdirectory to your application folder - For ActiveX implementations: copy and register the OCX file using regsvr32.exe
Step 3: Register DirectShow Filters¶
Using regsvr32.exe, register these essential DirectShow filters:
VisioForge_Audio_Effects_4.axVisioForge_Dump.axVisioForge_RGB2YUV.axVisioForge_Screen_Capture.axVisioForge_Video_Effects_Pro.axVisioForge_Video_Mixer.axVisioForge_Video_Resize.axVisioForge_WavDest.axVisioForge_YUV2RGB.axVisioForge_FFMPEG_Source.ax
Important: Add the filter directory to the system PATH environment variable if your application executable resides in a different folder.
Advanced Component Installation¶
FFMPEG Integration¶
- Copy all files from
Redist\FFMPEGfolder to your deployment - Add the FFMPEG folder to the Windows system PATH variable
- Register all .ax files from the FFMPEG folder
VLC Integration¶
- Copy all files from the
Redist\VLCfolder - Register the included .ax file using regsvr32.exe
- Create an environment variable named
VLC_PLUGIN_PATHpointing to theVLC\pluginsdirectory
Audio Output Support (LAME)¶
- Copy
lame.axfrom theRedist\Formatsfolder - Register the
lame.axfile using regsvr32.exe
Container Format Support¶
- WebM Support: Install free codecs from xiph.org
- Matroska Support: Deploy
Haali Matroska Splitter
MP4 Output Configuration¶
Modern Encoder Setup¶
- Copy appropriate library files:
libmfxsw32.dll(for 32-bit deployments)libmfxsw64.dll(for 64-bit deployments)- Register required components:
VisioForge_H264_Encoder.axVisioForge_MP4_Muxer.axVisioForge_AAC_Encoder.axVisioForge_Video_Resize.ax
Legacy Encoder Setup (for older systems)¶
- Copy appropriate library files:
libmfxxp32.dll(for 32-bit deployments)libmfxxp64.dll(for 64-bit deployments)- Register required components:
VisioForge_H264_Encoder_XP.axVisioForge_MP4_Muxer_XP.axVisioForge_AAC_Encoder_XP.axVisioForge_Video_Resize.ax
Bulk Registration Utility¶
To simplify DirectShow filter registration, you can use the reg_special.exe utility from the framework setup. Place this executable in your filter directory and run it with administrator privileges to register all filters at once.
For additional code samples and implementation examples, visit our GitHub repository. If you encounter any difficulties with deployment, please contact technical support for personalized assistance.