https://github.com/nomadsdev/pixel-matrix-converter
PixelMatrix Converter is a simple tool that converts images to matrix data and back. It’s ideal for image manipulation and analysis, allowing easy conversion between visual and data formats
https://github.com/nomadsdev/pixel-matrix-converter
data-convert file-io image image-processing image-processing-python matrix matrix-multiplication python-matrix structure
Last synced: 4 months ago
JSON representation
PixelMatrix Converter is a simple tool that converts images to matrix data and back. It’s ideal for image manipulation and analysis, allowing easy conversion between visual and data formats
- Host: GitHub
- URL: https://github.com/nomadsdev/pixel-matrix-converter
- Owner: nomadsdev
- Created: 2024-09-18T01:20:18.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-09-18T01:22:24.000Z (9 months ago)
- Last Synced: 2025-01-02T04:28:49.548Z (6 months ago)
- Topics: data-convert, file-io, image, image-processing, image-processing-python, matrix, matrix-multiplication, python-matrix, structure
- Language: Python
- Homepage:
- Size: 1.06 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# PixelMatrix Converter
PixelMatrix Converter is a Python project that allows you to convert images to matrix files and vice versa. This tool is useful for handling image data in a matrix format and converting it back to visual images.
## Features
- **Convert Images to Matrix**: Converts images from supported formats (PNG, JPG, JPEG, BMP, TIFF) into matrix files containing pixel values.
- **Convert Matrix to Images**: Converts matrix files back into images using the pixel data.
## Installation
1. **Clone the Repository**:
```sh
git clone https://github.com/nomadsdev/pixel-matrix-converter.git
```
2. **Install Dependencies**:
Ensure you have Python installed. Install the required Python libraries using pip:
```sh
pip install pillow numpy
```
## Usage
1. **Convert Image to Matrix**:
- Place the images you want to convert in the `bin/images` directory.
- Run the script and choose option `1` to convert images to matrix format.
```sh
python main.py
```
2. **Convert Matrix to Image**:
- Ensure that the matrix files are in the `bin/output` directory.
- Run the script and choose option `2` to convert matrix files back to images.
```sh
python main.py
```
The restored images will be saved in the `bin/restored` directory.
## File Structure
- `bin/images/` - Directory to place images for conversion.
- `bin/output/` - Directory where matrix files will be saved.
- `bin/restored/` - Directory where restored images will be saved.
## Example
To convert an image to matrix format:
```sh
python main.py
```
Choose `1` and follow the instructions.
To convert a matrix file back to an image:
```sh
python main.py
```
Choose `2`, select the matrix file, and the image will be saved in the `bin/restored` directory.
## Support
For support or inquiries, please contact: [email protected]
## License
This project is licensed under the MIT License.