From: Stephen Seo <seo.disparate@gmail.com>
Date: Wed, 1 Dec 2021 07:31:56 +0000 (+0900)
Subject: Add some comments to video.h
X-Git-Url: https://git.seodisparate.com/stephenseo/static/gitweb.js?a=commitdiff_plain;h=fa7b5a110ad783cc1522ec65eb1ececb9ac91993;p=EN605.617.81.FA21_StephenSeo_DitheringProject

Add some comments to video.h
---

diff --git a/src/video.h b/src/video.h
index 77f2c93..9c907bc 100644
--- a/src/video.h
+++ b/src/video.h
@@ -13,6 +13,11 @@ constexpr unsigned int kReadBufPaddingSize = AV_INPUT_BUFFER_PADDING_SIZE;
 constexpr unsigned int kReadBufSizeWithPadding =
     kReadBufSize + kReadBufPaddingSize;
 
+/*!
+ * \brief Helper class that uses Image and OpenCLHandle to dither video frames.
+ *
+ * Note that libraries provided by ffmpeg are used to decode the video.
+ */
 class Video {
  public:
   explicit Video(const char *video_filename);
@@ -20,8 +25,15 @@ class Video {
 
   ~Video();
 
+  /// Same as DitherVideo(const std::string&, Image*, bool)
   bool DitherVideo(const char *output_filename, Image *blue_noise,
                    bool grayscale = false);
+
+  /*!
+   * \brief Dithers the frames in the input video.
+   *
+   * \return True on success.
+   */
   bool DitherVideo(const std::string &output_filename, Image *blue_noise,
                    bool grayscale = false);