【学Rust写CAD】22 双圆径向渐变的结构体(two_circle_radial_gradient.rs)

源码

//two_circle_radial_gradient.rs
//! 定义双圆径向渐变的结构体和相关功能

/// 表示一个双圆径向渐变的源
///
/// 该结构体描述了两个圆之间的渐变，支持矩阵变换和颜色查找表优化
#[derive(Debug, Clone, PartialEq)]
pub struct TwoCircleRadialGradientSource {
    /// 应用于渐变的变换矩阵（使用固定点表示优化性能）
    pub matrix: MatrixFixedPoint,
    
    /// 第一个圆的圆心x坐标
    pub c1x: f32,
    
    /// 第一个圆的圆心y坐标
    pub c1y: f32,
    
    /// 第一个圆的半径
    pub r1: f32,
    
    /// 第二个圆的圆心x坐标
    pub c2x: f32,
    
    /// 第二个圆的圆心y坐标
    pub c2y: f32,
    
    /// 第二个圆的半径
    pub r2: f32,
    
    /// 颜色查找表（256个预计算的颜色值）
    pub lut: [u32; 256],
}

代码分析

这是一个用于表示双圆径向渐变的Rust结构体。让我逐步解释每个字段的含义：

字段说明

1. matrix: MatrixFixedPoint

• 一个固定点矩阵，用于对渐变应用变换（如旋转、缩放、平移等）

• 固定点表示意味着使用整数或定点数表示，用于性能优化

2. c1x: f32, c1y: f32, r1: f32

• 第一个圆的参数：

  • c1x: 第一个圆的圆心x坐标

  • c1y: 第一个圆的圆心y坐标

  • r1: 第一个圆的半径

3. c2x: f32, c2y: f32, r2: f32

• 第二个圆的参数：

  • c2x: 第二个圆的圆心x坐标

  • c2y: 第二个圆的圆心y坐标

  • r2: 第二个圆的半径

4. lut: [u32; 256]

• 一个包含256个u32值的查找表(Lookup Table)

• 可能用于存储预计算的渐变颜色值，优化性能

• 256的长度表明可能使用8位索引来查找颜色值

功能推测

这个结构体可能用于描述一个在两个圆之间过渡的径向渐变效果：

• 渐变从第一个圆(c1)开始，到第二个圆(c2)结束

• 可能支持非同心圆的渐变（因为两个圆心可以不同）

• 支持不同半径的渐变

• 使用矩阵变换可以旋转、缩放或移动整个渐变

典型用途

这种渐变可能用于图形渲染中，例如：

• 创建特殊的光照效果

• 实现复杂的UI元素

• 生成自然的过渡效果

• pub关键字表示这个结构体是公开的，可以被其他模块使用。