rough 1.5

High-quality 'hand drawn' vector graphics. Python port of Rough.js.

Python port of Rough.js

Create useful graphics with a "hand drawn" visual style

You'll use rough-py to programmatically generate graphics for documentation or data visualization.

🖌️ Install

pip install rough

No other python packages or third-party dependencies needed. Optionally, you can pip install fonttools to enable embedding font outlines into your SVG output.

🖍️ Use

from rough import canvas, Options

c = canvas(600, 200)  # arbitrary units

# purple arc using an SVG-style path
swirl_path = "M 30 150 C 80 30, 220 30, 270 150 S 370 270, 420 150"
c.path(swirl_path, Options(stroke="#8a2be2", strokeWidth=4, roughness=2.5))

# transparent rectangle
c.rectangle(x=112, y=20, w=80, h=100, options=Options(fill="rgba(230, 250, 255, 0.3)"))

# arc in bright magenta
c.arc(360, 80, 80, 80, 0, 3.14, False, Options(stroke="#ff66cc", strokeWidth=3))

# circle with pink fill
c.circle(100, 80, 60, Options(fill="pink", fillStyle="solid", stroke="#444", strokeWidth=3))

# green filled polygon
points = [(150, 30), (270, 70), (250, 90), (210, 100)]
c.polygon(points, Options(stroke="teal", fill="#a3ffa3", fillStyle="hachure", strokeWidth=2, roughness=1))

# broad orange stroke
c.line(420, 20, 580, 100, Options(stroke="orange", strokeWidth=4, roughness=1.2))

# write to a SVG file
svg_data: str = c.as_svg(600, 150)
with open("/tmp/rough-example.svg", "w") as f:
    f.write(svg_data)

Use the full API

🚀 API Documentation

📚 Examples Gallery

🎨 Fill and Stroke Style Gallery

Still desperate? There are even more examples (1, 2, 3) in the tests/ directory.

Limitations

🚫 No JavaScript-style Interactivity

🚧 Will not roughen existing SVG files. For those too proud to accept that, review tests/test_roughen_svg.py which implements a functional but work-in-progress SVG file "roughener".

Questions or Issues?

🔍 See the FAQ page.

Freely use the Discussions tab above for general questions, or use the Issues tab to report a problem.

All glory to:

• Rough.js - https://github.com/rough-stuff/rough
• svgelements SVG Path parser - https://github.com/meerk40t/svgelements

Happy Roughening!