Add movit.overlay_blend video filter

Author: ddennedy

src/modules/movit/CMakeLists.txt

@@ -11,6 +11,7 @@ add_library(mltmovit MODULE
   filter_movit_lift_gamma_gain.cpp
   filter_movit_mirror.cpp
   filter_movit_opacity.cpp
+  filter_movit_overlay_mode.cpp
   filter_movit_rect.cpp
   filter_movit_resample.cpp
   filter_movit_resize.cpp
@@ -64,6 +65,7 @@ install(FILES
   filter_movit_lift_gamma_gain.yml
   filter_movit_mirror.yml
   filter_movit_opacity.yml
+  filter_movit_overlay_mode.yml
   filter_movit_rect.yml
   filter_movit_resample.yml
   filter_movit_resize.yml

src/modules/movit/factory.c

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2013-2022 Dan Dennedy <dan@dennedy.org>
+ * Copyright (C) 2013-2026 Meltytech, LLC
  * factory.c -- the factory method interfaces
  *
  * This program is free software; you can redistribute it and/or modify
@@ -19,8 +19,8 @@
 
 #include "mltmovit_export.h"
 #include <framework/mlt.h>
-#include <limits.h>
 #include <string.h>
+
 extern mlt_consumer consumer_xgl_init(mlt_profile profile,
                                       mlt_service_type type,
                                       const char *id,
@@ -69,6 +69,10 @@ extern mlt_filter filter_movit_opacity_init(mlt_profile profile,
                                             mlt_service_type type,
                                             const char *id,
                                             char *arg);
+extern mlt_filter filter_movit_overlay_mode_init(mlt_profile profile,
+                                                 mlt_service_type type,
+                                                 const char *id,
+                                                 char *arg);
 extern mlt_filter filter_movit_rect_init(mlt_profile profile,
                                          mlt_service_type type,
                                          const char *id,
@@ -129,6 +133,7 @@ MLTMOVIT_EXPORT MLT_REPOSITORY
     MLT_REGISTER(mlt_service_filter_type, "movit.lift_gamma_gain", filter_lift_gamma_gain_init);
     MLT_REGISTER(mlt_service_filter_type, "movit.mirror", filter_movit_mirror_init);
     MLT_REGISTER(mlt_service_filter_type, "movit.opacity", filter_movit_opacity_init);
+    MLT_REGISTER(mlt_service_filter_type, "movit.overlay_mode", filter_movit_overlay_mode_init);
     MLT_REGISTER(mlt_service_filter_type, "movit.rect", filter_movit_rect_init);
     MLT_REGISTER(mlt_service_filter_type, "movit.resample", filter_movit_resample_init);
     MLT_REGISTER(mlt_service_filter_type, "movit.resize", filter_movit_resize_init);
@@ -172,6 +177,10 @@ MLTMOVIT_EXPORT MLT_REPOSITORY
                           "movit.opacity",
                           metadata,
                           "filter_movit_opacity.yml");
+    MLT_REGISTER_METADATA(mlt_service_filter_type,
+                          "movit.overlay_mode",
+                          metadata,
+                          "filter_movit_overlay_mode.yml");
     MLT_REGISTER_METADATA(mlt_service_filter_type, "movit.rect", metadata, "filter_movit_rect.yml");
     MLT_REGISTER_METADATA(mlt_service_filter_type,
                           "movit.resample",

src/modules/movit/filter_movit_overlay_mode.cpp

@@ -0,0 +1,42 @@
+/*
+ * filter_movit_overlay_mode.cpp
+ * Copyright (C) 2026 Meltytech, LLC
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+ */
+
+#include <framework/mlt.h>
+#include <stdlib.h>
+
+static mlt_frame process(mlt_filter filter, mlt_frame frame)
+{
+    mlt_properties_set(MLT_FRAME_PROPERTIES(frame),
+                       "movit.overlay.compositing",
+                       mlt_properties_get(MLT_FILTER_PROPERTIES(filter), "mode"));
+    return frame;
+}
+
+extern "C" mlt_filter filter_movit_overlay_mode_init(mlt_profile profile,
+                                                     mlt_service_type type,
+                                                     const char *id,
+                                                     char *arg)
+{
+    mlt_filter filter = mlt_filter_new();
+    if (filter) {
+        filter->process = process;
+        mlt_properties_set(MLT_FILTER_PROPERTIES(filter), "mode", arg ? arg : "0");
+    }
+    return filter;
+}

src/modules/movit/filter_movit_overlay_mode.yml

@@ -0,0 +1,23 @@
+schema_version: 7.0
+type: filter
+identifier: movit.overlay_mode
+title: Movit Overlay Mode
+version: 1
+copyright: Meltytech, LLC
+creator: Dan Dennedy
+license: GPLv2
+language: en
+tags:
+  - Video
+description: Change the blend mode used by the movit.overlay transition.
+
+parameters:
+  - identifier: mode
+    argument: yes
+    title: Blend mode
+    type: integer
+    description: >
+        This filter can be used to change the blend mode for a single clip
+        when using the movit.overlay transition to composite tracks.
+    default: 0
+    widget: combo