Prechádzať zdrojové kódy

Add docs for new video thumbnails configs & update changelog

DarthSim 5 rokov pred
rodič
commit
dbe1ffd14b
2 zmenil súbory, kde vykonal 11 pridanie a 0 odobranie
  1. 7 0
      CHANGELOG.md
  2. 4 0
      docs/configuration.md

+ 7 - 0
CHANGELOG.md

@@ -5,6 +5,13 @@
 - Ability to skip processing of some formats. See [Skip processing](https://docs.imgproxy.net/#/configuration?id=skip-processing).
 - (pro) [video_thumbnail_second](https://docs.imgproxy.net/#/generating_the_url_advanced?id=video-thumbnail-second) processing option.
 - (pro) [background_alpha](https://docs.imgproxy.net/#/generating_the_url_advanced?id=background-alpha) processing option.
+- (pro) `IMGPROXY_VIDEO_THUMBNAIL_PROBE_SIZE` and `IMGPROXY_VIDEO_THUMBNAIL_MAX_ANALYZE_DURATION` configs.
+
+### Changed
+- Speed up generation of video thumbnails with large timestamps.
+
+### Fix
+- Fix thumbnails generation of some videos.
 
 ## [2.14.1] - 2020-07-22
 ### Fix

+ 4 - 0
docs/configuration.md

@@ -144,6 +144,10 @@ imgproxy Pro can extract specific frames of videos to create thumbnails. The fea
 
 * `IMGPROXY_ENABLE_VIDEO_THUMBNAILS`: <img class="pro-badge" src="assets/pro.svg" alt="pro" /> then true, enables video thumbnails generation. Default: false;
 * `IMGPROXY_VIDEO_THUMBNAIL_SECOND`: <img class="pro-badge" src="assets/pro.svg" alt="pro" /> the timestamp of the frame in seconds that will be used for a thumbnail. Default: 1.
+* `IMGPROXY_VIDEO_THUMBNAIL_PROBE_SIZE`: <img class="pro-badge" src="assets/pro.svg" alt="pro" /> the maximum amount of bytes used to determine the format. Lower values can decrease memory usage but can produce inaccurate data or even lead to errors. Default: 5000000.
+* `IMGPROXY_VIDEO_THUMBNAIL_MAX_ANALYZE_DURATION`: <img class="pro-badge" src="assets/pro.svg" alt="pro" /> the maximum of milliseconds used to get the stream info. Low values can decrease memory usage but can produce inaccurate data or even lead to errors. When set to 0, the heuristic is used. Default: 0.
+
+**⚠️Warning:** Though using `IMGPROXY_VIDEO_THUMBNAIL_PROBE_SIZE` and `IMGPROXY_VIDEO_THUMBNAIL_MAX_ANALYZE_DURATION` can lower the memory footprint of video thumbnails generation, you should use them in production only when you know what are you doing.
 
 ## Watermark