Struct ImageUtils 

pub struct ImageUtils;

跨平台图片处理工具函数集合。 从 core::image_processor 中提取的平台无关逻辑，不依赖任何 Windows API。

Implementations

impl ImageUtils

pub async fn convert_image_to_png( image_data: Vec<u8>, ) -> Result<Vec<u8>, ImageUtilsError>

将图片数据转换为 PNG 格式。 支持 SVG、BMP、JPEG、GIF、WebP 等格式自动检测并转换。 参数：image_data - 原始图片字节数据。 返回：PNG 格式字节数据，失败返回 ImageUtilsError。

pub fn to_webp(png_data: Vec<u8>) -> Result<Vec<u8>, ImageUtilsError>

将 PNG 图片数据编码为 WebP 格式（无损 VP8L）。 用 image crate 内置的纯 Rust 无损编码器（image-webp），不依赖 libwebp C 库。 参数：png_data - PNG 格式图片字节数据。 返回：WebP 格式字节数据，失败返回 ImageUtilsError。

pub fn to_data_url(data: &[u8]) -> String

将图片字节数据转换为 base64 data URL（MIME 由 image crate 的字节头嗅探决定）。 参数：data - 图片字节数据。 返回：data URL 字符串；空数据返回空字符串；无法识别格式时按 PNG 标注。

pub fn is_html_content(data: &[u8]) -> bool

判断数据是否像是 HTML 内容。 参数：data - 待检测的字节数据。 返回：true 表示是 HTML 内容。

pub async fn resize_image( data: Vec<u8>, max_width: u32, max_height: u32, ) -> Result<Vec<u8>, ImageUtilsError>

调整图片大小，如果超过指定尺寸则等比缩放。 参数：data - PNG 图片字节数据；max_width - 最大宽度；max_height - 最大高度。 返回：调整大小后的 PNG 字节数据，失败返回 ImageUtilsError。

pub fn trim_transparent_white_border( png_data: Vec<u8>, ) -> Result<Vec<u8>, ImageUtilsError>

从 PNG 图像数据中裁剪掉外围的白色或透明像素。 参数：png_data - PNG 格式图片字节数据（须为正方形）。 返回：裁剪后的 PNG 字节数据，失败返回 ImageUtilsError。

pub fn rgba_image_to_png( rgba_image: &RgbaImage, ) -> Result<Vec<u8>, ImageUtilsError>

将 RGBA 图像数据编码为 PNG 格式。 参数：rgba_image - RGBA 格式图像缓冲区。 返回：PNG 字节数据，失败返回 ImageUtilsError。

pub async fn get_dominant_color( image_data: Vec<u8>, ) -> Result<(u8, u8, u8), ImageUtilsError>

获取图片的主色调。 使用 K-Means 聚类算法分析图片中非透明像素的颜色分布。 参数：image_data - PNG 格式图片字节数据。 返回：(R, G, B) 主色调元组，失败返回 ImageUtilsError。