【Raqote】 1.1.2 路径填充ShaderClipMaskBlitter结构体（blitter.rs）

2025/4/16 18:47:40 来源：https://blog.csdn.net/weixin_43219667/article/details/147124474 浏览: 次关键词：【Raqote】 1.1.2 路径填充ShaderClipMaskBlitter结构体（blitter.rs）

ShaderClipMaskBlitter 结构体实现了 Blitter trait，用于支持带裁剪遮罩（Clip Mask）的着色器渲染。它比之前的 ShaderMaskBlitter 更复杂，因为它不仅支持普通的遮罩（mask），还额外支持一个独立的裁剪遮罩（clip），从而实现更精细的像素混合控制。

结构体定义

pub struct ShaderClipMaskBlitter<'a> {pub x: i32,            // 目标区域的起始 x 坐标pub y: i32,            // 目标区域的起始 y 坐标pub shader: &'a dyn Shader, // 着色器引用，用于生成像素颜色pub tmp: Vec<u32>,     // 临时缓冲区，存储着色器生成的像素pub dest: &'a mut [u32], // 目标像素缓冲区（通常是帧缓冲区）pub dest_stride: i32,  // 目标缓冲区的行跨度（每行的像素数）pub clip: &'a [u8],    // 裁剪遮罩（定义哪些像素允许绘制）pub clip_stride: i32,  // 裁剪遮罩的行跨度
}

clip 是一个独立的遮罩缓冲区，决定哪些像素可以被绘制（类似于 Photoshop 的 “Layer Mask”）。
clip_stride 类似于 dest_stride，用于处理非连续内存布局的裁剪遮罩。

Blitter Trait 实现

impl<'a> Blitter for ShaderClipMaskBlitter<'a> {fn blit_span(&mut self, y: i32, x1: i32, x2: i32, mask: &[u8]) {// 计算目标缓冲区的当前行偏移let dest_row = (y - self.y) * self.dest_stride;// 计算裁剪遮罩的当前行偏移let clip_row = y * self.clip_stride;// 计算要处理的像素数量let count = (x2 - x1) as usize;// 使用着色器生成像素颜色，存储到 tmp 缓冲区self.shader.shade_span(x1, y, &mut self.tmp[..], count);// 遍历每个像素for i in 0..count {let mask = mask[i] as u32;  // 当前像素的遮罩值（控制混合程度）let clip = self.clip[(clip_row + x1) as usize + i] as u32; // 当前像素的裁剪遮罩值// 只有当 mask 和 clip 都不为 0 时才绘制if mask != 0 && clip != 0 {// 计算目标像素位置let dest_pos = (dest_row + x1 - self.x) as usize + i;// 使用 over_in_in 进行混合（考虑 mask 和 clip）self.dest[dest_pos] = over_in_in(self.tmp[i],                  // 新像素（来自着色器）self.dest[dest_pos],           // 原有像素mask,                          // 遮罩值（控制透明度）clip,                          // 裁剪遮罩值（控制是否允许绘制）);}}}
}

关键点解析

clip 的作用

它是一个额外的遮罩，决定哪些像素允许被修改（类似 “Layer Mask”）。
如果 clip 为 0，则该像素会被完全跳过，即使 mask 不为 0。

over_in_in 混合函数

这是一个自定义的混合函数,源码如下：

// Similar to over_in but includes an additional clip alpha value
#[inline]
pub fn over_in_in(src: u32, dst: u32, mask: u32, clip: u32) -> u32 {let src_alpha = alpha_to_alpha256(mask);let src_alpha = alpha_to_alpha256(alpha_mul_256(clip, src_alpha));let dst_alpha = alpha_mul_inv256(packed_alpha(src), src_alpha);let mask = 0xFF00FF;let src_rb = (src & mask) * src_alpha;let src_ag = ((src >> 8) & mask) * src_alpha;let dst_rb = (dst & mask) * dst_alpha;let dst_ag = ((dst >> 8) & mask) * dst_alpha;// we sum src and dst before reducing to 8 bit to avoid accumulating rounding errors(((src_rb + dst_rb) >> 8) & mask) | ((src_ag + dst_ag) & !mask)
}