【学Rust写CAD】20 平铺模式结构体(spread.rs)

这个 Spread。rs文件定义了渐变超出定义区域时的扩展方式,通常用于处理渐变在边界之外的行为。

源码

rust 复制代码
//color/spread.rs
#[derive(Debug, Clone, Copy)]
pub struct Pad;  // 空结构体,表示 Pad 模式

#[derive(Debug, Clone, Copy)]
pub struct Reflect;  // 空结构体,表示 Reflect 模式

#[derive(Debug, Clone, Copy)]
pub struct Repeat;  // 空结构体,表示 Repeat 模式

trait Spread {
    fn apply(&self, x: i32) -> i32;
}

impl Spread for Pad {
    fn apply(&self, x: i32) -> i32 {
        if x > 255 {
            255
        } else if x < 0 {
            0
        } else {
            x
        }
    }
}

impl Spread for Repeat {
    fn apply(&self, x: i32) -> i32 {
        x & 255
    }
}

impl Spread for Reflect {
    fn apply(&self, x: i32) -> i32 {
        let sign = (x << 23) >> 31;
        (x ^ sign) & 255
    }
}

代码分析

这段代码定义了几种不同的颜色值处理模式,用于处理超出标准RGB范围(0-255)的数值。

主要组成部分

  1. 模式定义
    定义了三个空结构体,分别表示不同的处理模式:
rust 复制代码
pub struct Pad;     // Pad模式
pub struct Reflect; // Reflect模式
pub struct Repeat;  // Repeat模式

这些结构体都是空结构体(零大小类型),仅用作标记类型(tag types)来实现不同的行为。

  1. Spread trait
    定义了一个trait Spread,它有一个方法apply,接受一个i32参数并返回处理后的i32值:
rust 复制代码
trait Spread {
    fn apply(&self, x: i32) -> i32;
}
  1. 不同模式的实现
Pad模式
rust 复制代码
impl Spread for Pad {
    fn apply(&self, x: i32) -> i32 {
        if x > 255 {
            255
        } else if x < 0 {
            0
        } else {
            x
        }
    }
}
  • 将超出范围的值截断到边界

  • x > 255 → 返回255

  • x < 0 → 返回0

  • 否则返回原值

Repeat模式
rust 复制代码
impl Spread for Repeat {
    fn apply(&self, x: i32) -> i32 {
        x & 255
    }
}
  • 使用位运算实现模256的效果

  • 相当于x % 256,但效率更高

  • 例如:256 → 0, 257 → 1, -1 → 255

Reflect模式
rust 复制代码
impl Spread for Reflect {
    fn apply(&self, x: i32) -> i32 {
        let sign = (x << 23) >> 31;
        (x ^ sign) & 255
    }
}
  • 实现类似"反射"边界的效果

  • 当x超出范围时,会像镜子一样反射回来

  • 例如:256 → 255, 257 → 254, -1 → 0, -2 → 1

  • 使用位运算技巧高效实现:

    • sign计算x的符号位(0表示正,-1表示负)

    • x ^ sign相当于x取反(当x为负时)

    • 最后& 255确保在0-255范围内

使用场景

这段代码可能用于图像处理中,当颜色值计算超出标准范围时,提供不同的处理策略:

  • Pad: 简单截断,保持颜色在有效范围内

  • Repeat: 循环处理,适合某些纹理或模式重复的场景

  • Reflect: 镜像反射处理,可以创建更平滑的过渡效果

这些模式的选择会影响图像处理边缘效果或颜色溢出的处理方式。

相关推荐
xjz184219 小时前
Rust 用 `&&`、`||`、`!` 把条件组合起来
rust
不积跬步无以至千里mmbb261 天前
Rust三大核心:Trait Crate Mod详解
linux·rust
SomeOtherTime1 天前
第 2 讲:借用检查器(Borrow Checker)的数学本质——读写锁的编译期化、非词法生命周期(NLL)与重借用(Reborrowing)
rust
xjz18422 天前
Rust 的else:把「做不做」升级成「二选一」
rust
喵个咪2 天前
RushWind Admin — update_mask 写面:字段级白名单、显式清除与点路径合并
后端·rust
喵个咪2 天前
RushWind Admin — 多租户行级隔离与租户回收站:Viewer 三态、repo_shell! 与全域级联清除
后端·rust
喵个咪2 天前
RushWind CMS — 三服务拓扑:core 领域层、双 BFF 薄代理与一份契约的双面输出
后端·rust
不积跬步无以至千里mmbb262 天前
Rust内核开发核心入口解析
linux·rust
wflynn3 天前
GitHub 今日推荐|rust-anything:录制真实输入输出,渐进式重写热点函数到 Rust
rust·开源·github·cli·claude-code·agent-skills
风笙9784 天前
[Rust] String 与 &str 详解
rust