araea-wordcloud

A high-performance word cloud visualization library implemented in pure Rust. Supports mask shapes, SVG/PNG dual output, custom fonts, and color schemes.

Features

• ⚡ Pure Rust Implementation - Efficient collision detection using bit operations
• 🖼️ Multiple Output Formats - Export as vector graphics (SVG) or bitmap (PNG)
• 🎭 Mask Support - Built-in shapes and custom image masks
• 🎨 Highly Customizable - Custom fonts, colors, rotation angles, and spacing
• 📦 Ready to Use - Built-in Chinese font support

Installation

[dependencies]
araea-wordcloud = "0.1"

Quick Start

use araea_wordcloud::generate;
use std::fs;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let words = vec![
        ("Rust", 100.0),
        ("Fast", 80.0), 
        ("Safe", 60.0),
        ("WordCloud", 40.0),
    ];

    let wordcloud = generate(&words)?;
    fs::write("output.png", wordcloud.to_png(2.0)?)?;

    Ok(())
}

Advanced Usage

use araea_wordcloud::{WordCloudBuilder, WordInput, ColorScheme, MaskShape};

let words = vec![
    WordInput::new("Love", 100.0),
    WordInput::new("Rust", 80.0),
];

let wordcloud = WordCloudBuilder::new()
    .size(800, 800)
    .background("#FFFFFF")
    .color_scheme(ColorScheme::Default)
    .mask_preset(MaskShape::Heart)
    .font_size_range(20.0, 100.0)
    .angles(vec![0.0, 90.0])
    .build(&words)?;

Examples

Simple Word Cloud

Chinese Dense Word Cloud

Run the examples:

• cargo run --example simple - Basic usage
• cargo run --example mask_shape - Heart-shaped word cloud
• cargo run --example chinese_dense - High-density Chinese word cloud
• cargo run --example advanced - Custom colors and layout

Configuration Reference

Color Schemes

Preset Masks

Builder Options

Acknowledgments

Thanks to wordcloud.online for inspiration and reference. The word cloud rendering approach is inspired by this website, achieving efficient and visually appealing results.

License