Configure Filters

View on GitHub

VideoEditor SDK supports several configuration options for the FilterToolController allowing flexible adaptation to different needs and use cases. For a detailed explanation of how to configure different editor views, refer to this guide.

`showFilterIntensitySlider`#

By default, the editor will show the slider to change the intensity of the selected filter. In our example, the slider should not be shown since we only want a specific intensity to be applied.

`initialFilterIntensity`#

The default intensity of filters is set to 100% (1.0). In this example, we only want to have 50% (0.5) intensity. Since showFilterIntensitySlider is set to false, the filters will always be applied with a fixed intensity of 50%.


import UIKit
import VideoEditorSDK

class VideoFiltersConfigurationSwift: Example, VideoEditViewControllerDelegate {
  override func invokeExample() {
    // Create a `Video` from a URL to a video in the app bundle.
    let video = Video(url: Bundle.main.url(forResource: "Skater", withExtension: "mp4")!)

    // Create a `Configuration` object.
    let configuration = Configuration { builder in
      builder.configureFilterToolController { options in
        // By default the editor will show the slider to change the intensity
        // of the selected filter. In this example the slider should not be shown
        // since we only want a specific intensity to be applied.
        options.showFilterIntensitySlider = false

        // By default the initial filter intensity is set to 100% (1.0).
        // In this example we only want to have 50% (0.5). Since `showFilterIntensitySlider`
        // is set to `false`, the filters will always be applied with a fixed intensity of 50%.
        options.initialFilterIntensity = 0.5
      }
    }

    // Create and present the video editor. Make this class the delegate of it to handle export and cancelation.
    let videoEditViewController = VideoEditViewController(videoAsset: video, configuration: configuration)
    videoEditViewController.delegate = self
    videoEditViewController.modalPresentationStyle = .fullScreen
    presentingViewController?.present(videoEditViewController, animated: true, completion: nil)
  }

  // MARK: - VideoEditViewControllerDelegate

  func videoEditViewControllerShouldStart(_ videoEditViewController: VideoEditViewController, task: VideoEditorTask) -> Bool {
    // Implementing this method is optional. You can perform additional validation and interrupt the process by returning `false`.
    true
  }

  func videoEditViewControllerDidFinish(_ videoEditViewController: VideoEditViewController, result: VideoEditorResult) {
    // The user exported a new video successfully and the newly generated video is located at `result.output.url`. Dismissing the editor.
    presentingViewController?.dismiss(animated: true, completion: nil)
  }

  func videoEditViewControllerDidFail(_ videoEditViewController: VideoEditViewController, error: VideoEditorError) {
    // There was an error generating the video.
    print(error.localizedDescription)
    // Dismissing the editor.
    presentingViewController?.dismiss(animated: true, completion: nil)
  }

  func videoEditViewControllerDidCancel(_ videoEditViewController: VideoEditViewController) {
    // The user tapped on the cancel button within the editor. Dismissing the editor.
    presentingViewController?.dismiss(animated: true, completion: nil)
  }
}

Configure Filters

showFilterIntensitySlider#

initialFilterIntensity#

`showFilterIntensitySlider`#

`initialFilterIntensity`#