v5run / DiceArt.io

Dice Art is a unique form of artistic expression that involves creating intricate designs or images using dice as the primary medium.

DiceArt.io

Table of Contents

1. About The Project
   • Built With
2. Functionality
   • Features
   • Python Procedure
3. Interface
4. Pseudocode
5. Installation
6. Contact

About The Project

Dice Art is a unique form of artistic expression that involves creating intricate designs or images using dice as the primary medium. By arranging and manipulating dice in various patterns, artists produce visually captivating pieces that not only showcase creative prowess but also highlight the intersection of gaming culture and visual arts, offering a fresh perspective on the role of randomness and chance in our society. In this project, a user is able to upload an image of their choice and have it visualized using only the six sides of a regular die through leveraging Python's imaging library (PIL) and Streamlit capabilities.

(back to top)

Built With

• 
• 

(back to top)

Functionality

Features

• Accepts images as any type of valid file (.jpeg, .png, .webp, etc.)
• User-friendly Interface (Streamlit functionalities)
• Interface utilizes visual effects such as progress bars, on-screen animations, and alerts.

Python Procedure

• Image Resizing -> Resize images so dice will fit evenly on the canvas.
• Creating a canvas -> Create a new canvas, scaled up to account for the size of the die, with image resizing accounted.
• Greyscaling -> Sectioning parts of the picture off of HEX-value brightness with the help of greyscaling.
• "Dicing" -> Implement dice in parts of the picture to represent certain brightness levels, with a one-sided die having the lowest brightness and 5 & 6 having the most.

Interface

• Minimalistic user-interface, requiring little-to-no effort to use, simply Drag & Drop!
• Interface will illustrate a loading bar, visual animations, and a success bar when finished.
• The output is a .png type which is available for download if needed.

Images of the DiceArt.io Interface!

(back to top)

Pseudocode

• The thought process behind this project can be found here, as well to note, each helper function in main.py has been documented to provide insight of purpose.

Installation

1. Clone the repository using the following

   git clone https://github.com/v5run/DiceArt.io.git

2. Install Python 3.12 and Streamlit. Run the following command in CMD to install Streamlit.

   pip install streamlit

3. Run the program in any text-editor/terminal using

   streamlit run main.py

4. Use the .io at your own free will.

(back to top)

Contact

Varun Pathak - @LinkedIn - [e-mail]

Project Link: https://github.com/v5run/DiceArt.io

(back to top)