Struct ImageObject 

pub struct ImageObject {
    pub x: f64,
    pub y: f64,
    pub width: f64,
    pub height: f64,
    pub data: Vec<u8>,
    pub format: ImageFormat,
    pub res_name: Option<String>,
}

带位置和尺寸的图片对象。

Fields

x: f64

距左边缘的 X 位置（mm）。

y: f64

距顶部的 Y 位置（mm）。

width: f64

宽度（mm）。

height: f64

高度（mm）。

data: Vec<u8>

图片数据（原始字节）。

format: ImageFormat

图片格式。

res_name: Option<String>

原始资源路径（相对文档目录，如 "Res/qrcode.png"）。

读取 OFD 文件时保留，写入器优先使用该路径而非自动命名， 从而在 roundtrip 时保持图片资源名与原始文件一致。

Implementations

impl ImageObject

pub fn new( x: f64, y: f64, width: f64, height: f64, data: Vec<u8>, format: ImageFormat, ) -> Self

创建新的图片对象。

pub fn with_res_name(self, res_name: impl Into<String>) -> Self

设置原始资源路径（roundtrip 保留图片名时使用）。

pub fn jpeg(x: f64, y: f64, width: f64, height: f64, data: Vec<u8>) -> Self

创建 JPEG 图片对象。

pub fn png(x: f64, y: f64, width: f64, height: f64, data: Vec<u8>) -> Self

创建 PNG 图片对象。

pub fn from_file( x: f64, y: f64, width: f64, height: f64, path: impl AsRef<Path>, ) -> OfdResult<Self>

从文件路径创建图片对象，自动检测格式。

从以下信息检测格式：

• 文件扩展名（.jpg/.jpeg → Jpeg, .png → Png, .bmp → Bmp, .tiff/.tif → Tiff）
• 魔术字节（扩展名不明确时的回退方案）

错误

文件无法读取或格式不支持时返回错误。

Trait Implementations

impl Clone for ImageObject

fn clone(&self) -> ImageObject

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ImageObject

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

Formats the value using the given formatter.