Analyzing media

Analyzing media

Analyzing media Use the FxPlug analysis API to analyze frames of source media before rendering them.

Overview

Frame-by-frame analysis of video clips is commonly required for rendering tasks that occur in an FxPlug plug-in. For example, tracking of objects and stabilization of video both require a pre-render analysis of video frames before rendering.

FxPlug 4.1 introduces FxAnalysisAPI, which FxPlug plug-ins can use to analyze video frames from source media in Final Cut Pro X or Motion. FxAnalysisAPI uses the host app’s built-in analysis infrastructure so that your plug-in’s analysis can be performed in the background, and you can view the progress UI in the same location as the host’s own analysis processes. This provides a consistent user experience for both native effects and FxPlug plug-ins that require analysis.

The example plug-in FxBrightnessAnalysis demonstrates how to implement the analysis APIs for a filter that analyzes all frames and then adjusts the brightness of the frames to a consistent level.