stephenseo/EN605.617.81.FA21_StephenSeo_DitheringProject
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
43 commits 1 branch 1 tag 144 KiB
C++ 98.9%
CMake 1.1%
Find a file
Stephen Seo 788ce5e490 Impl output to video, update program args 
Turns out output to video suffers from loss of quality problems when in
color (not grayscale). It may be better in some cases to just output
each frame as a png and combining them later with ffmpeg like how it is
mentioned here: https://trac.ffmpeg.org/wiki/Slideshow . Grayscale video
is noticably better, but both cases result in large video sizes, so care
may be needed if free disk-space is sparse.
2021-12-03 20:09:56 +09:00
doxygen WIP libpng image decoding 2021-11-11 22:17:00 +09:00
res Add another generated blue-noise image to res/ 2021-12-01 17:38:34 +09:00
src Impl output to video, update program args 2021-12-03 20:09:56 +09:00
.gitignore WIP libpng image decoding 2021-11-11 22:17:00 +09:00
.lvimrc WIP libpng image decoding 2021-11-11 22:17:00 +09:00
CMakeLists.txt Add arg parsing 2021-12-01 17:31:51 +09:00
Doxyfile WIP libpng image decoding 2021-11-11 22:17:00 +09:00
LICENSE Create LICENSE 2021-12-01 16:48:26 +09:00
README.md Update README.md 2021-12-01 17:41:49 +09:00

README.md

Dithering with OpenCL

Background

Project Proposal PDF

The proposal mentioned dithering live-input frames, but I ended up with just dithering single images or turning a video into dithered images.

The "develop" branch may have more up to date code.

Usage

A "blue-noise" image is integral to dithering images. A generated blue-noise image is provided in the "res/" directory. Run the program with "--help" to get info on how to use it.

PNG, PGM, and PPM image formats are supported.

For decoding video, any format that ffmpeg can read should work (though if things don't work, try using MP4 files).

WARNING: Video decoding is still a WIP. The video is currently decoded, but an output video being encoded hasn't been implemented yet. The current implementation writes each video frame to a PNG image in the current directory.

Other Notes

I plan on adding the MIT License to this project once the course (that this project was made for) is over.

I went ahead and applied the MIT License earlier than noted here.

Legal Stuff

This program uses FFmpeg which is licensed under the LGPL 2.1 license