Struct WordInput 

pub struct WordInput {
    pub text: String,
    pub weight: f32,
}

Fields

text: String

weight: f32

Implementations

impl WordInput

pub fn new(text: impl Into<String>, weight: f32) -> Self

Examples found in repository

examples/advanced.rs (line 6)

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/mask_shape.rs (line 13)

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 73)

fn generate_dense_chinese_data() -> Vec<WordInput> {
    let mut words = Vec::new();
    let mut rng = rand::rng();

    // 核心超大词，权重分布更均匀，突出重点词汇，同时避免权重集中
    let core_keywords = vec![
        "Rust编程",
        "高性能",
        "内存安全",
        "WebAssembly",
        "系统级",
        "无GC",
        "所有权",
        "生命周期",
        "借用检查",
        "并发模型",
    ];
    for w in &core_keywords {
        // 在85~100之间随机，增加大词的字体差异感
        words.push(WordInput::new(*w, rng.random_range(85.0..=100.0)));
    }

    // 重要相关概念，权重调整为55~80，增强视觉层次感
    let concepts = vec![
        "Cargo",
        "Crates.io",
        "Tokio",
        "Actix",
        "Serde",
        "Diesel",
        "Async/Await",
        "Trait",
        "Struct",
        "Enum",
        "Pattern Matching",
        "Zero-cost",
        "安全性",
        "跨平台",
        "嵌入式",
        "网络服务",
        "命令行工具",
        "错误处理",
        "Result",
        "Option",
    ];
    for w in &concepts {
        words.push(WordInput::new(*w, rng.random_range(55.0..=80.0)));
    }

    // 常用基础词汇，分三轮加入，权重均匀分布40~55，避免视觉“拥挤”
    let common = vec![
        "编译",
        "运行",
        "测试",
        "文档",
        "模块",
        "函数",
        "闭包",
        "迭代器",
        "集合",
        "字符串",
        "指针",
        "引用",
        "智能指针",
        "Box",
        "Rc",
        "Arc",
        "Mutex",
        "Channel",
        "Future",
        "Stream",
        "宏定义",
        "属性",
        "泛型",
        "Community",
        "Foundation",
        "Docs",
        "Book",
        "Examples",
        "Tutorial",
    ];
    for _ in 0..3 {
        for w in &common {
            words.push(WordInput::new(*w, rng.random_range(40.0..=55.0)));
        }
    }

    // 填充词汇，丰富词云细节，权重范围调整为20~35，减少过密感
    let fillers = vec![
        "代码", "逻辑", "数据", "接口", "实现", "调用", "返回", "参数", "类型", "变量", "常量",
        "静态", "动态", "链接", "库", "包", "依赖", "版本", "发布", "构建", "优化", "调试", "日志",
        "监控", "设计", "架构", "模式", "算法", "结构", "效率", "速度", "稳定", "扩展", "维护",
        "重构", "迁移", "学习", "曲线", "入门", "精通",
    ];
    for _ in 0..8 {
        // 略减少次数，控制填充词数量避免拥挤
        for w in &fillers {
            words.push(WordInput::new(*w, rng.random_range(20.0..=35.0)));
        }
    }

    words
}

Trait Implementations

impl Clone for WordInput

fn clone(&self) -> WordInput

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for WordInput

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.