Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cansik/sharp-frame-extractor
Extracts sharp frames from a video.
https://github.com/cansik/sharp-frame-extractor
Last synced: about 3 hours ago
JSON representation
Extracts sharp frames from a video.
- Host: GitHub
- URL: https://github.com/cansik/sharp-frame-extractor
- Owner: cansik
- License: mit
- Created: 2020-10-03T16:35:44.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2021-11-15T11:48:22.000Z (almost 3 years ago)
- Last Synced: 2023-08-25T18:56:20.580Z (about 1 year ago)
- Language: Python
- Size: 94.7 KB
- Stars: 51
- Watchers: 6
- Forks: 7
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Sharp Frame Extractor
Extracts sharp frames from a video by using a time window to detect the sharpest frame.
The idea of the extractor is to provide a simple tool to extract sharp frames from videos to be used in photogrammetry and volumetric capturing.
The algorithm is currently based on the idea that the `standard deviation` represents a valid metric for how sharp a frame is. The value is calculated on an edge detection result which is by default created by a canny edge detection. The parameters for the canny edge detector are extracted per frame. To further enhance this detection, only the center of the frame is used (usually the focus of the scene).
Further ideas can be implemented, for example a sobel based method is already available.
### Example
*One hundred sharp frame extracted from an iPhone video.*
*The reconstruction of the one hundred frames compared with the original cherry tree.*
You can read more about this example project over at [behance](https://www.behance.net/gallery/118822685/Immersive-Memories).
### Prerequisites
To install the package use the following pip command:
```
pip install git+https://github.com/cansik/[email protected]
```
### Usage
Here you find an example command that extracts a frame every `300ms` into `./frames` folder:
```bash
sfextract --window 300 test.mov
```
It is also possible to extract a fix number of frames out of the video file. This example extracts `30` frames.
```bash
sfextract --frame-count 30 test.mov
```
#### Performance
The script tries to estimate the best CPU count to not overload the available RAM or the computer specifications. But it is possible to overwrite this estimation by the following flag:
```bash
# uses all available CPU
sfextract --frame-count 30 --force-cpu-count test.mov
```
#### Help
```
usage: sfextract [-h] [--method {canny,sobel}] [--window WINDOW]
[--frame-count FRAME_COUNT] [--all] [--crop CROP] [--min MIN]
[--output OUTPUT] [--format {jpg,png,bmp,gif,tif}]
[--cpu-count CPU_COUNT] [--force-cpu-count] [--preview]
[--debug]
video
Extracts sharp frames from a video by using a time window to detect the
sharpest frame.
positional arguments:
video Path to the video input file.
optional arguments:
-h, --help show this help message and exit
--method {canny,sobel}
Sharpness detection method (Default canny).
--window WINDOW Window in ms to slide over the video and detect
sharpest frame from.
--frame-count FRAME_COUNT
Amount of output frames. If the value is >0 the
extractor calculates the window size to match the
output frames.
--all Extracts all the frames of the video.
--crop CROP Crop to center factor for ROI sharpness detection.
--min MIN Minimum sharpness level which is dependent on the
detection method used.
--output OUTPUT Path where to store the frames.
--format {jpg,png,bmp,gif,tif}
Frame output format.
--cpu-count CPU_COUNT
How many CPU's are used for the extraction (by default
it is calculate by available RAM and frame count).
--force-cpu-count Forces to use exact CPU number.
--preview Only shows how many frames would be extracted.
--debug Shows debug frames and information.
```
### About
MIT License - Copyright (c) 2021 Florian Bruggisser