A sprite detection package
Project description
Image Sprite Detection Module
What is it?
This is a Python module used for detection sprites from an image
Why use this module?
- Easy to use: You just need to pass an image an get the result
- Time saving: This module is already built so you don't need to spend time for it anymore!
Usage:
Create a SpriteSheet object using:
SpriteSheet(fd, background_color=None):
@fd: the name and path (a string) that references an image file in the local file system;
OR a pathlib.Path object that references an image file in the local file system ; a file object that MUST implement read(), seek(), and tell() methods, and be opened in binary mode;
OR a Image object.
@background_color: an integer if the mode is grayscale;
OR a tuple (red, green, blue) of integers if the mode is RGB;
OR a tuple (red, green, blue, alpha) of integers if the mode is RGBA. The alpha element is optional. If not defined, while the image mode is RGBA, the constructor considers the alpha element to be 255.
Class SpriteSheet provides following methods:
SpriteSheet.find_most_common_color(image):
Find most used color in an Image object
arg: image: MUST be an Image object
Return most used color in the image with the same format image's mode
SpriteSheet.object.create_sprite_labels_image():
Create a mask image of initial image, and add a bounding box around each sprite,
each sprite also have an unique random uniform color.
Return an Image object.
SpriteSheet.object.find_sprites():
Detect sprites inside the image
Return a 2D label map and a dict that stores:
key: sprite's label
value: its Sprite's object
arg: image: MUST be an Image object
Installation:
The project require Python 3.7+ to run
FOR USER:
In Terminal, use command:
pip3 install spriteutil_final
FOR DEVELOPMENT:
Clone or Downloads the project, using this command and then edit anything you want:
git clone https://github.com/intek-training-jsc/sprite-detection-longlamduc.git
A Simple Example
from spriteutil_final.spriteutil import SpriteSheet
spritesheet = SpriteSheet('islands.png')
sprites, label_map = spritesheet.find_sprites()
img_mask = spritesheet.create_sprite_labels_image()
img_mask.save('islands_label_mask.png')
img_mask_with_border = spritesheet.make_sprite_border_image()
img_mask.save('islands_label_mask_with_border.png')
Contact:
During the usage of the project, if you have any question, please contact me personally at INTEK HCM City or via my email: long.lam@f4.intek.edu.vn
Contributors:
Long LAM DUC from INTEK Institute, HCM City
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
Close
Hashes for spriteutil_longlamduc-1.0.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | ed35a92c25bc712e32543b6afa0c15f0702eb0d9f9ac769e251caa27ee79ec45 |
|
MD5 | 7108e2fbc7cfde25f63f58ad5173bf61 |
|
BLAKE2b-256 | c5a47a7299f85f6f0a5739d302e0b4fa4992c52bc49f9bca95818265c573b8c5 |
Close
Hashes for spriteutil_longlamduc-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 782ba97a023151c7c8e13411aac76eefea68711b36c9156d9c386380859beb05 |
|
MD5 | e28103090c9aba60b28232ed303bc209 |
|
BLAKE2b-256 | 4d329803536ac7cad583ba07ea3399b5b8647a6bafc7b18224419eb5f7748040 |