Struct WordCloud 

pub struct WordCloud {
    pub width: u32,
    pub height: u32,
    pub background: String,
    pub words: Vec<PlacedWord>,
    /* private fields */
}

Fields

width: u32

height: u32

background: String

words: Vec<PlacedWord>

Implementations

impl WordCloud

pub fn to_svg(&self) -> String

Examples found in repository

examples/simple.rs (line 30)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let start = Instant::now();

    let words = vec![
        ("Rust", 100.0),
        ("Performance", 80.0),
        ("Safety", 70.0),
        ("Concurrency", 60.0),
        ("Fast", 50.0),
        ("Memory", 45.0),
        ("Efficient", 40.0),
        ("Reliable", 35.0),
        ("Community", 30.0),
        ("Cargo", 25.0),
        ("Crates", 20.0),
        ("Macro", 15.0),
    ];

    println!("Generating word cloud with {} words...", words.len());

    let wordcloud = generate(&words)?;

    let png_data = wordcloud.to_png(2.0)?;
    fs::write("output_simple.png", png_data)?;

    let svg_data = wordcloud.to_svg();
    fs::write("output_simple.svg", svg_data)?;

    println!("Done! Saved to output_simple.png and output_simple.svg");
    println!("Time elapsed: {:?}", start.elapsed());

    Ok(())
}

pub fn to_png(&self, scale: f32) -> Result<Vec<u8>, Error>

Examples found in repository

examples/advanced.rs (line 22)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let words = vec![
        WordInput::new("Custom", 90.0),
        WordInput::new("Colors", 80.0),
        WordInput::new("Seed", 70.0),
        WordInput::new("Fixed", 60.0),
        WordInput::new("Layout", 50.0),
    ];

    let wordcloud = WordCloudBuilder::new()
        .size(600, 400)
        .background("#1a1a1a")
        .colors(vec!["#FF0000", "#00FF00", "#0000FF", "#FFFF00", "#00FFFF"])
        .seed(42)
        .angles(vec![0.0])
        .font_size_range(20.0, 100.0)
        .build(&words)?;

    fs::write("output_advanced.png", wordcloud.to_png(1.0)?)?;
    println!("Generated advanced word cloud: output_advanced.png");

    Ok(())
}

examples/simple.rs (line 27)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let start = Instant::now();

    let words = vec![
        ("Rust", 100.0),
        ("Performance", 80.0),
        ("Safety", 70.0),
        ("Concurrency", 60.0),
        ("Fast", 50.0),
        ("Memory", 45.0),
        ("Efficient", 40.0),
        ("Reliable", 35.0),
        ("Community", 30.0),
        ("Cargo", 25.0),
        ("Crates", 20.0),
        ("Macro", 15.0),
    ];

    println!("Generating word cloud with {} words...", words.len());

    let wordcloud = generate(&words)?;

    let png_data = wordcloud.to_png(2.0)?;
    fs::write("output_simple.png", png_data)?;

    let svg_data = wordcloud.to_svg();
    fs::write("output_simple.svg", svg_data)?;

    println!("Done! Saved to output_simple.png and output_simple.svg");
    println!("Time elapsed: {:?}", start.elapsed());

    Ok(())
}

examples/mask_shape.rs (line 33)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let output_path = "output_mask_heart.png";

    let width = 800;
    let height = 800;

    println!("Generating words...");
    let mut words = Vec::new();
    for i in 0..300 {
        words.push(WordInput::new("Love", 100.0));
        words.push(WordInput::new("Rust", 80.0));
        words.push(WordInput::new("Heart", 60.0 + (i as f32 % 40.0)));
        words.push(WordInput::new("Mask", 40.0));
    }

    println!("Building word cloud...");

    let scheme = ColorScheme::Default;
    let wordcloud = WordCloudBuilder::new()
        .size(width, height)
        .mask_preset(MaskShape::Heart)
        .color_scheme(scheme)
        .background(scheme.background_color())
        .padding(2)
        .word_spacing(2.0)
        .font_size_range(12.0, 80.0)
        .build(&words)?;

    println!("Saving to {}...", output_path);
    fs::write(output_path, wordcloud.to_png(2.0)?)?;

    println!("Done! Check {}", output_path);
    Ok(())
}

examples/chinese_dense.rs (line 46)

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut words = generate_dense_chinese_data();
    println!("Generated {} Chinese words.", words.len());

    let start = Instant::now();

    let width = 1600;
    let height = 1100;

    println!("Building word cloud ({}x{})...", width, height);

    let count_len = words.len();
    let dynamic_max_font_size = if count_len < 20 {
        150.0
    } else if count_len < 50 {
        120.0
    } else {
        100.0
    };

    let max_weight = words.first().map(|w| w.weight).unwrap_or(100.0);
    for word in &mut words {
        if max_weight > 100.0 {
            word.weight = word.weight.sqrt() * 10.0;
        }
    }

    let scheme = ColorScheme::Default;
    let wordcloud = WordCloudBuilder::new()
        .size(width, height)
        .color_scheme(scheme)
        .background(scheme.background_color())
        .padding(2)
        .angles(vec![0.0, 90.0])
        .word_spacing(2.0)
        .font_size_range(14.0, dynamic_max_font_size)
        .seed(2025)
        .build(&words)?;

    let output_path = "output_chinese_dense.png";
    fs::write(output_path, wordcloud.to_png(2.0)?)?;

    println!("Success! Time elapsed: {:?}", start.elapsed());
    println!("Saved to {}", output_path);

    Ok(())
}