utils : add VideoRecorder::close() API (to manually close recorder)

Author: ManifoldFR

CHANGELOG.md

@@ -11,6 +11,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - utils : avoid public inclusion of `libavutil/pixfmt` header for video recorder
 - core : `errors.h`: make terminate_with_message a template (with formatting arguments, etc)
+- utils: add VideoRecorder::close() API (to manually close recorder)
 
 ## [0.0.7] - 2025-05-17
 

src/candlewick/utils/VideoRecorder.cpp

@@ -36,21 +36,26 @@ namespace media {
     void writeFrame(const Uint8 *data, Uint32 payloadSize,
                     AVPixelFormat avPixelFormat);
 
-    ~VideoRecorderImpl() noexcept;
+    void close() noexcept;
+
+    ~VideoRecorderImpl() noexcept { this->close(); }
   };
 
-  VideoRecorderImpl::~VideoRecorderImpl() noexcept {
+  void VideoRecorderImpl::close() noexcept {
+    if (!formatContext)
+      return;
+
     av_write_trailer(formatContext);
-    if (codecContext)
-      avcodec_free_context(&codecContext);
-    if (formatContext->pb)
-      avio_closep(&formatContext->pb);
-    if (formatContext)
-      avformat_free_context(formatContext);
-    if (frame)
-      av_frame_free(&frame);
-    if (packet)
-      av_packet_free(&packet);
+
+    // close out stream
+    av_frame_free(&frame);
+    // av_frame_free(&tmpFrame);
+    av_packet_free(&packet);
+    avcodec_free_context(&codecContext);
+
+    avio_closep(&formatContext->pb);
+    avformat_free_context(formatContext);
+    formatContext = nullptr;
   }
 
   VideoRecorderImpl::VideoRecorderImpl(Uint32 width, Uint32 height,
@@ -226,6 +231,11 @@ namespace media {
     impl_->writeFrame(data, payloadSize, outputFormat);
   }
 
+  void VideoRecorder::close() noexcept {
+    if (impl_)
+      impl_->close();
+  }
+
   VideoRecorder::~VideoRecorder() = default;
 
 } // namespace media

src/candlewick/utils/VideoRecorder.h

@@ -41,6 +41,7 @@ namespace media {
     Uint32 frameCounter() const;
     void writeFrame(const Uint8 *data, Uint32 payloadSize,
                     SDL_GPUTextureFormat pixelFormat);
+    void close() noexcept;
     ~VideoRecorder();
   };