crysplanar 1.5.1

A Python module for designing generative crystal art

CrysplanarArt 3D 💎

"3D crystals from 2D planes"

CrysplanarArt 3D is a Python module for designing stunning generative crystal art using simple and intuitive tools. Built on turtle and pygame, it gives complete creative freedom with minimal code.

---

🖼️ Gallery

The Four Elements

Galaxy Collision — Good vs Evil

Crystal Rod

Hexa Pattern

Generative Art

Other Designs

---

📦 Installation

pip install crysplanar

---

⚡ Quick Start

from crysplanar import crysplanar

cp = crysplanar()
cp.Board('My Art', 'black')
cp.ArtPencil(size=1, hidepencil=True)

cp.crystalmaker(
    sidesno=6,
    crystalno=24,
    crayon=['blue', 'red', 'green', 'yellow', 'cyan', 'magenta'],
    sidelen=100,
    spacing=10,
    x=list(range(25)),
    y=list(range(25))
)

---

🛠️ Tools

Tool	Description
Board	Setup the art canvas
ArtPencil	Configure the drawing pen
placer	Move ArtPencil to any position
crystalmaker	Generate crystal structures
drawshape	Draw basic geometric shapes
bgmusic	Add background music
picback	Set background image

---

💎 crystalmaker

The flagship tool of CrysplanarArt 2D.

cp.crystalmaker(sidesno, crystalno, crayon, sidelen, spacing, x, y)

Parameter	Description
sidesno	Number of sides of the crystal (3=triangle, 6=hexagon)
crystalno	Length of the crystal
crayon	List of colors for the crystal
sidelen	Length of each side in pixels
spacing	Spacing between crystal layers
x / y	Positional coordinate lists

Examples

# Fire Crystal 🔥
cp.crystalmaker(sidesno=3, crystalno=12,
                crayon=['red', 'gold', 'orange'],
                sidelen=100, spacing=10,
                x=list(range(12)),
                y=list(range(12)))

# Ice Crystal ❄️
cp.crystalmaker(sidesno=4, crystalno=24,
                crayon=['navy', 'royalblue', 'cyan'],
                sidelen=100, spacing=10,
                x=list(range(25)),
                y=list(range(25)))

# Rainbow Crystal 🌈
cp.crystalmaker(sidesno=6, crystalno=24,
                crayon=['blue','red','green','yellow','cyan','magenta'],
                sidelen=100, spacing=10,
                x=list(range(25)),
                y=list(range(25)))

---

🔷 drawshape

Draw basic geometric shapes anywhere on the canvas.

ds = crysplanar.drawshape()

ds.triangle(sidelen=100, rotate=False, fillcolor='red')
ds.square(sidelen=100, fillcolor='blue')
ds.rectangle(width=200, height=100, fillcolor='green')
ds.pentagon(sidelen=100, fillcolor='purple')
ds.round(radius=50, fillcolor='yellow', angle=360)
ds.polygon(sidesno=8, sidelen=100, fillcolor='cyan')

---

🎵 bgmusic

Add background music to your art canvas.

cp.bgmusic('music.mp3', repeat=True)

---

📋 Requirements

• Python 3.x
• turtle
• pygame
• ghostscript

pip install pygame

pip install ghostscript

---

📜 License

MIT License — free to use, modify and share with credit.

---

👨‍💻 Author

Made with 🧠 and 🐢 Born from a single line: circle(100, 190)