Add API function for texture burn-in

Author: kblaschke

src/api/include/projectM-4/render_opengl.h

@@ -48,6 +48,21 @@ PROJECTM_EXPORT void projectm_opengl_render_frame(projectm_handle instance);
  */
 PROJECTM_EXPORT void projectm_opengl_render_frame_fbo(projectm_handle instance, uint32_t framebuffer_object_id);
 
+/**
+ * @brief Burn-in the provided texture into the active preset(s) main texture.
+ *
+ * During transitions, the image is drawn onto both active presets.
+ *
+ * @param instance The projectM instance handle.
+ * @param texture The OpenGL texture ID to draw onto the current preset.
+ * @param left The left offset in screen coordinates.
+ * @param top The top offset in screen coordinates.
+ * @param width The width in screen coordinates. Negative values will flip the image horizontally.
+ * @param height The height in screen coordinates. Negative values will flip the image vertically.
+ * @since 4.2.0
+ */
+PROJECTM_EXPORT void projectm_opengl_burn_texture(projectm_handle instance, uint32_t texture, int left, int top, int width, int height);
+
 #ifdef __cplusplus
 } // extern "C"
 #endif

src/libprojectM/ProjectMCWrapper.cpp

@@ -180,6 +180,12 @@ void projectm_opengl_render_frame_fbo(projectm_handle instance, uint32_t framebu
     projectMInstance->RenderFrame(framebuffer_object_id);
 }
 
+void projectm_opengl_burn_texture(projectm_handle instance, uint32_t texture, int left, int top, int width, int height)
+{
+    auto projectMInstance = handle_to_instance(instance);
+    projectMInstance->BurnInTexture(texture, left, top, width, height);
+}
+
 void projectm_set_frame_time(projectm_handle instance, double seconds_since_first_frame)
 {
     auto projectMInstance = handle_to_instance(instance);