Struct WriteBuilder

Source

pub struct WriteBuilder<'et> { /* private fields */ }

Expand description

写入构建器

Implementations§

Source §

impl<'et> WriteBuilder<'et>

Source

pub fn tag(self, tag: impl Into<String>, value: impl Into<String>) -> Self

设置标签值

Source

pub fn tag_id(self, tag: TagId, value: impl Into<String>) -> Self

设置标签值（使用 TagId）

Source

pub fn tags(self, tags: HashMap<impl Into<String>, impl Into<String>>) -> Self

设置多个标签

Source

pub fn tag_append( self, tag: impl Into<String>, value: impl Into<String>, ) -> Self

追加值到标签（-TAG+=VALUE）

使用 += 运算符将值追加到现有标签值后面。适用于列表类型的标签，如 Keywords 等。

§示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

// 追加关键词到现有列表
exiftool.write("photo.jpg")
    .tag_append("Keywords", "landscape")
    .overwrite_original(true)
    .execute()?;

Source

pub fn tag_remove( self, tag: impl Into<String>, value: impl Into<String>, ) -> Self

从标签中移除值（-TAG-=VALUE）

使用 -= 运算符从现有标签值中移除指定值。适用于列表类型的标签。

§示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

// 从关键词列表中移除某个关键词
exiftool.write("photo.jpg")
    .tag_remove("Keywords", "old-keyword")
    .overwrite_original(true)
    .execute()?;

Source

pub fn tag_prepend( self, tag: impl Into<String>, value: impl Into<String>, ) -> Self

前置值到标签（-TAG^=VALUE）

使用 ^= 运算符将值前置到现有标签值之前。适用于列表类型的标签。

§示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

// 在关键词列表前面插入关键词
exiftool.write("photo.jpg")
    .tag_prepend("Keywords", "important")
    .overwrite_original(true)
    .execute()?;

Source

pub fn tag_from_file( self, tag: impl Into<String>, file_path: impl Into<String>, ) -> Self

从文件读取值写入标签（-TAG<=FILE）

使用 <= 运算符从指定文件中读取数据作为标签值。常用于写入二进制数据（如缩略图、预览图）。

§示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

// 从文件读取缩略图写入
exiftool.write("photo.jpg")
    .tag_from_file("ThumbnailImage", "thumb.jpg")
    .overwrite_original(true)
    .execute()?;

Source

pub fn tag_append_from_file( self, tag: impl Into<String>, file_path: impl Into<String>, ) -> Self

追加从文件读取的值到标签（-TAG+<=FILE）

使用 +<= 运算符从指定文件中读取数据追加到现有标签值。

§示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

// 从文件追加数据到标签
exiftool.write("photo.jpg")
    .tag_append_from_file("Comment", "comment.txt")
    .overwrite_original(true)
    .execute()?;

Source

pub fn delete(self, tag: impl Into<String>) -> Self

删除标签

Source

pub fn delete_id(self, tag: TagId) -> Self

删除标签（使用 TagId）

Source

pub fn overwrite_original(self, yes: bool) -> Self

覆盖原始文件（不创建备份）

Source

pub fn backup(self, yes: bool) -> Self

创建备份

Source

pub fn output<P: AsRef<Path>>(self, path: P) -> Self

输出到不同文件

Source

pub fn condition(self, expr: impl Into<String>) -> Self

设置条件（仅在条件满足时写入）

Source

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

添加原始参数（高级用法）

Source

pub fn write_mode(self, mode: WriteMode) -> Self

设置写入模式

使用 -wm 选项设置写入/创建标签的模式

§模式

WriteMode::Write (w) - 写入标签（默认）
WriteMode::Create (c) - 仅创建标签（不修改现有标签）
WriteMode::WriteCreate (wc) - 写入或创建

§示例

use exiftool_rs_wrapper::{ExifTool, WriteMode};

let exiftool = ExifTool::new()?;

// 仅创建新标签，不修改现有标签
exiftool.write("photo.jpg")
    .tag("NewTag", "value")
    .write_mode(WriteMode::Create)
    .execute()?;

Source

pub fn password(self, passwd: impl Into<String>) -> Self

设置密码

使用 -password 选项处理受密码保护的文件

§安全性警告

密码将以纯文本形式传递给 ExifTool 进程。

§示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

// 写入受密码保护的 PDF
exiftool.write("protected.pdf")
    .tag("Title", "New Title")
    .password("secret123")
    .execute()?;

Source

pub fn separator(self, sep: impl Into<String>) -> Self

设置列表项分隔符

使用 -sep 选项设置列表项的分隔符字符串

Source

pub fn api_option( self, opt: impl Into<String>, value: Option<impl Into<String>>, ) -> Self

设置 API 选项

使用 -api 选项设置 ExifTool API 选项

Source

pub fn user_param( self, param: impl Into<String>, value: Option<impl Into<String>>, ) -> Self

设置用户参数

使用 -userParam 选项设置用户参数

Source

pub fn ignore_minor_errors(self, yes: bool) -> Self

忽略次要错误

使用 -m 选项忽略次要错误和警告，继续处理其他文件。这在批量处理时很有用，可以避免单个文件错误导致整个操作失败。

§示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

// 批量写入时忽略次要错误
exiftool.write("photo.jpg")
    .tag("Copyright", "© 2026")
    .ignore_minor_errors(true)
    .execute()?;

Source

pub fn preserve_time(self, yes: bool) -> Self

保留文件修改时间

使用 -P 选项保留文件的原始修改时间。默认情况下，ExifTool 会更新文件的修改时间为当前时间。

§示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

// 写入元数据但保留原始修改时间
exiftool.write("photo.jpg")
    .tag("Copyright", "© 2026")
    .preserve_time(true)
    .execute()?;

Source

pub fn quiet(self, yes: bool) -> Self

静默模式

使用 -q 选项启用静默模式，减少输出信息。可以使用多次来增加静默程度。

§示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

// 静默模式下写入
exiftool.write("photo.jpg")
    .tag("Copyright", "© 2026")
    .quiet(true)
    .execute()?;

Source

pub fn zip_compression(self, yes: bool) -> Self

启用 ZIP 压缩

使用 -z 选项读写压缩的元数据信息。某些文件格式支持压缩元数据存储。

§示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

// 使用压缩写入元数据
exiftool.write("photo.jpg")
    .tag("Copyright", "© 2026")
    .zip_compression(true)
    .execute()?;

Source

pub fn fix_base(self, offset: Option<i64>) -> Self

修复 MakerNotes 偏移

使用 -F 选项修复 MakerNotes 的基准偏移。这在处理某些损坏或格式异常的图像文件时很有用。

§参数

offset - 可选的偏移量修正值（以字节为单位）

§示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

// 自动修复 MakerNotes 偏移
exiftool.write("photo.jpg")
    .tag("Copyright", "© 2026")
    .fix_base(None)
    .execute()?;

// 指定偏移量修复
exiftool.write("photo.jpg")
    .fix_base(Some(1024))
    .execute()?;

Source

pub fn fix_base_offset(self, offset: i64) -> Self

修复 MakerNotes 偏移（带指定偏移量）

使用 -FOFFSET 选项指定具体偏移量修复 MakerNotes。这是 fix_base(Some(offset)) 的便捷方法。

Source

pub fn global_time_shift(self, shift: impl Into<String>) -> Self

全局时间偏移

对应 ExifTool 的 -globalTimeShift 选项，对所有日期/时间标签应用统一的时间偏移。格式为 [+|-]Y:M:D H:M:S。

§示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

// 将所有时间标签向前偏移 1 小时
exiftool.write("photo.jpg")
    .global_time_shift("+0:0:0 1:0:0")
    .execute()?;

Source

pub fn offset(self, tag: impl Into<String>, offset: impl Into<String>) -> Self

日期/时间偏移

示例: .offset("DateTimeOriginal", "+1:0:0 0:0:0") 表示增加 1 天

Source

pub fn copy_from<P: AsRef<Path>>(self, source: P) -> Self

从文件复制标签

从源文件复制所有标签到目标文件

Source

pub fn copy_from_with_redirect<P: AsRef<Path>>( self, source: P, redirects: &[(&str, &str)], ) -> Self

从文件复制标签（带重定向映射）

使用 -tagsFromFile SRCFILE 配合 -DSTTAG<SRCTAG 重定向语法。可以指定源标签到目标标签的映射关系。

§参数

source - 源文件路径
redirects - 标签重定向列表，每项为 (目标标签, 源标签)。生成 -DSTTAG<SRCTAG 参数。

§示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

// 从源文件复制 Artist 到 Author，DateTimeOriginal 到 CreateDate
exiftool.write("target.jpg")
    .copy_from_with_redirect("source.jpg", &[
        ("Author", "Artist"),
        ("CreateDate", "DateTimeOriginal"),
    ])
    .overwrite_original(true)
    .execute()?;

Source

pub fn copy_from_with_append<P: AsRef<Path>>( self, source: P, redirects: &[(&str, &str)], ) -> Self

从文件复制标签（带追加重定向）

使用 -+DSTTAG<SRCTAG 追加方式复制标签。

§参数

source - 源文件路径
redirects - 标签重定向列表，每项为 (目标标签, 源标签)。生成 -+DSTTAG<SRCTAG 参数。

§示例

use exiftool_rs_wrapper::ExifTool;

let exiftool = ExifTool::new()?;

// 从源文件追加 Keywords
exiftool.write("target.jpg")
    .copy_from_with_append("source.jpg", &[
        ("Keywords", "Keywords"),
    ])
    .overwrite_original(true)
    .execute()?;