Carpetography

Extract pixel colors and map row-by-row patterns from images.

📑 Table of Contents

• Description
• Key Features
• Use Cases
• Quick Start
• Project Structure
• Contributors
• Contributing

📝 Description

Carpetography is a Python-based utility designed to inspect images and programmatically map out their color structures pixel by pixel. By translating visual image files into highly structured numeric data, the tool simplifies the process of digital pattern analysis for grid-based designs, textile manufacturing, or pixel-art generation.

✨ Key Features

• 🎨 RGB to Hex Conversion — Converts image pixel RGB tuples directly into standardized hex color codes for easier palette mapping.
• 📊 NumPy Array Parsing — Translates loaded images into multi-dimensional NumPy arrays to execute high-performance pixel calculations.
• 🪡 Sequential Pattern Mapping — Iterates through pixel coordinates row by row to track the precise positioning of unique colors throughout the image.
• 🖥️ Graphical Interface Integration — Features user interface capabilities via gui.py and packaged executable configurations with PyInstaller specs.

🎯 Use Cases

• Translating digital images and pixel art into sequential templates for knitting, weaving, or carpet fabrication.
• Extracting exact color palettes and layout patterns programmatically from reference image grids.
• Analyzing row-by-row color distribution metrics for digital pattern archiving and manufacturing prep.

⚡ Quick Start

# 1. Clone the repository
git clone https://github.com/amirali4602/Carpetography.git

# See the Development Setup section below

📁 Project Structure

.
├── 10px.png
├── 30x3.jpg
├── 30x3.png
├── 500.Font.Collection
│   └── BNazanin.ttf
├── Carpetography.py
├── base-color50.webp
├── db.json
├── gui.py
├── gui.spec
├── json_data.json
├── main.py
├── main.spec
├── orange.png
├── pil_text.png
├── pil_text_font.png
└── test.py

👥 Contributors

Thanks to everyone who has contributed to this project:

See the full list of contributors →

👥 Contributing

Contributions are welcome! Here's the standard flow:

1. Fork the repository
2. Clone your fork: git clone https://github.com/amirali4602/Carpetography.git
3. Branch: git checkout -b feature/your-feature
4. Commit: git commit -m 'feat: add some feature'
5. Push: git push origin feature/your-feature
6. Open a pull request

Please follow the existing code style and include tests for new behavior where applicable.

---

This README was generated with ❤️ by ReadmeBuddy