1.18 Use Cases 93
1.18.1.2 Using Video Stream Recording
With the FFmpeg libraries it is possible to record an mvIMPACT Acquire image stream into a compressed video
stream.
Since
2.39.0
1.18.1.2.1 Requirements Since the mvIMPACT Acquire API internally uses FFmpeg to record video streams,
the FFmpeg libraries need to be present on the target system as well. They can either be built OR installed into the
systems default library search path OR installed somewhere and afterwards an environment variable MVIMPACT←-
_ACQUIRE_FFMPEG_DIR can be defined that points to the folder containing the libraries.
Note
Please make sure that you fully understand the license coming with FFmpeg! Have a look at the corre-
sponding legal section inside any of the SDK manuals.
At least FFmpeg 4.x is needed. Older versions of the FFmpeg API are NOT compatible!
1.18.1.2.1.1 Windows
1. Go to https://ffmpeg.org/download.html and download the dynamic libraries of FFmpeg (ver-
sion >= 4.x) according to your operating system (e.g. 'ffmpeg-20200809-6e951d0-win64-shared.zip')
2. Extract the ∗.zip file under '${MVIMPACT_ACQUIRE_DIR}/Toolkits'.
3. Rename the file to 'ffmpeg-4.2.2-win64-shared'(64-bit)/'ffmpeg-4.2.2-win32-shared'(32-bit) OR set an environ-
ment variable e.g. 'MVIMPACT_ACQUIRE_FFMPEG_DIR' which points to the folder containing the libraries.
1.18.1.2.2 Recording in wxPropView In wxPropView, a video stream can be recorded by the 'Start', 'Pause'
and 'Stop' buttons at the top right tool-bar. They are however inactive when the video stream recording mode is
deactivated OR when the video stream is not correctly set up.
Figure 1: Video stream recording control buttons (inactive)
A video stream needs to be set up first to be able to get recorded. To do so:
1. Select the device to use and open it by clicking on the 'Use' button.
2. Navigate to the 'Capture' menu and click on the 'Video Stream Recording...' option to start a setup dialog.
MATRIX VISION GmbH