From ebe6af733fcc3d1fe7da259d82a715b896834955 Mon Sep 17 00:00:00 2001
From: Utkarsh Verma <utkarsh.verma@hotmail.com>
Date: Sat, 30 Apr 2022 12:39:12 +0530
Subject: [PATCH] Update README.md

---
 README.md | 138 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 136 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 0224ac9..f7f0cdb 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,136 @@
-# video-frames
- Client side video frames extraction as base64 encoded images
+[travis-image]: https://img.shields.io/travis/feross/clipboard-copy/master.svg
+[travis-url]: https://travis-ci.org/feross/clipboard-copy
+[npm-image]: https://img.shields.io/npm/v/video-frames.svg
+[npm-url]: https://npmjs.org/package/video-frames
+[size-image]: https://img.shields.io/bundlephobia/minzip/video-frames@latest
+[size-url]: https://bundlephobia.com/result?p=video-frames@latest
+
+# video-frames [![travis][travis-image]][travis-url] [![npm][npm-image]][npm-url] [![size][size-image]][size-url]
+
+Client-side video frames extraction as base64 encoded images
+
+## Install
+```
+npm install video-frames
+```
+
+## Usage
+```js
+const videoFrames = require('video-frames');
+
+videoFrames({
+	// Big Buck Bunny (1080p 60fps)
+	url: 'http://distribution.bbb3d.renderfarming.net/video/mp4/bbb_sunflower_1080p_60fps_normal.mp4',
+	// Extract 10 evenly spaced (time-wise) frames
+	count: 10
+}).then((frames) => {
+	// frames is an array of objects
+	// [
+	//   {
+	//     offset: (timestamp in seconds)
+	//     image: (base64 encoded image)
+	//   },
+	//   ...
+	// ]
+});
+```
+
+## API
+
+### videoFrames(options)
+
+Returns a `Promise` for when all frames have been extracted. There are a few properties that can be set in `options`.
+
+#### options
+
+####  `url` (required)
+
+Default Value: *empty*
+
+The URL (self, remote, or blob) of the source video from which the frames are to be extracted. Since the [`video`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/video) element is used in the extraction process, the allowed formats are the ones that are playable in it. You can search for the supported formats on [caniuse.com/?search=video%20format](https://caniuse.com/?search=video%20format)
+
+####  `width`
+
+Default Value: `128`
+
+Width of the extracted frames in pixels.
+If no value for `width` is set, but a value for `height` is set, then the `width` will be calculated using the video dimensions.
+
+####  `height`
+
+Default Value: `auto`
+
+Height of the extracted frames in pixels.
+If not set, `height` is calculated automatically from the value of `width` using the video dimensions.
+
+####  `format`
+
+Default Value: `image/png`
+
+MIME type of the extracted frames.
+Since the [`canvas`](https://developer.mozilla.org/en-US/docs/Web/API/Canvas_API) element is used for drawing the frames and `toDataURL(format)` is used for reading them as base64 encoded images, the allowed MIME types are the ones that are supported by `toDataURL`.
+
+From [MDN](https://developer.mozilla.org/en-US/docs/Web/API/HTMLCanvasElement/toDataURL#parameters), 
+
+> **`toDataURL(type)`**
+> ...
+> **`type`**
+> A string indicating the image format. The default type is `image/png`; this image format will be also used if the specified type is not supported.
+
+So, if a type is not supported, it will fall back to `image/png`.
+
+####  `startTime`
+
+Default Value: `0`
+
+Start timestamp (in seconds) of the range from where the frames are to be extracted.
+It will be ignored if a valid value for `offsets` is set.
+
+####  `endTime`
+
+Default Value: *Video Duration*
+
+End timestamp (in seconds) of the range from where the frames are to be extracted.
+It will be ignored if a valid value for `offsets` is set.
+
+####  `count`
+
+Default Value: `1`
+
+Number of frames to be extracted from the range set by `startTime` and `endTime`.
+The frames are extracted from evenly spaced timestamps across the range.
+It will be ignored if a valid value for `offsets` is set.
+
+####  `offsets`
+
+Default Value: `[]`
+
+Array of timestamps (in seconds) to extract frames at.
+If a valid value for `offsets` is set, `startTime`, `endTime`, and `count` are **ignored**.
+
+####  `onLoad()`
+
+Default Value: `false`
+
+Function to be called when the source video has loaded and the extraction process has started.
+
+```js
+onLoad: () => { console.log('video loaded') }
+```
+
+####  `onProgress()`
+
+Default Value: `false`
+
+Function to be called on every successful frame extraction.
+```js
+onProgress: (framesExtracted) => { console.log(`${framesExtracted} frames extracted`) }
+```
+```js
+onProgress: (framesExtracted, totalFrames) => { console.log(`${framesExtracted} of ${totalFrames} frames extracted`) }
+```
+
+
+## License
+
+MIT © [Utkarsh Verma](https://github.com/n3r4zzurr0)
\ No newline at end of file