Detect and recognize colors in images or video
Project description
ColorDetect
ColorDetect
Documentation |
Package
ColorDetect works to recognize and identify different colors in an image or video.
Installation
pip install ColorDetect
Basic Usage
Images
from colordetect import ColorDetect
user_image = ColorDetect(<path_to_image>)
# return dictionary of color count. Do anything with this
user_image.get_color_count()
# write color count
user_image.write_color_count()
# optionally, write any text to the image
user_image.write_text(text="any text")
# save the image after using either of the options (write_color_count/write_text) or both
user_image.save_image(<storage_path>,<image_name>)
Resultant image is stored in the string storage_path
of choice with the image_name
which will default to the current location and out.jpg respectively by default.
Videos
from colordetect import VideoColor,col_share
user_video = VideoColor(<path_to_video>)
# return dictionary of color count. Do anything with this result
user_video.get_video_frames(progress=True)
# to order this rather long result and get only a specific number look up the `col_share` module
You can also get colors at a specific time and extract the frame at that given time.
Project Documentation
For further project documentation, visit ColorDetect's page
Contributions
Contributions are welcome. Do remember to take a look at the project contribution guidelines
Tests
To run tests:
pytest
Pre-commit
Pre-commit hooks are used to automate linting
-
Install the git hook scripts
pre-commit install
-
(optional) Run against all the files
pre-commit run --all-files
The installed pre-commit hooks will automatically ensure use of a consistent code format and style whenever one commits changes using git. For full documentation, view the pre-commit docs.
Hall of Code
To the amazing human beings and developers that made this possible.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for ColorDetect-1.6.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | bb6a5de06a212c159c19ab4bbd06f03fd8667d0c227802a3bc10d10f975014f1 |
|
MD5 | 562c8b803f2829d8604e8d3f0dc1dd23 |
|
BLAKE2b-256 | 7a3b6a85d69e30c06d7e1514244d7e9cc8be19f07aa35f8f3f0ab9b526f90c1b |