gexiv2-sys

gexiv2 的 Rust FFI 声明

此包提供 Rust FFI 声明，用于 gexiv2 库，该库是基于 GObject 的 Exiv2 封装器，它提供了对媒体文件中 Exif、XMP 和 IPTC 元数据的读写访问。

这里只提供 FFI 声明；要使用可用的 Rust 库，请考虑使用 rexiv2 包。

该项目被认为是“完成的”——也就是说，已经添加了所有计划的功能（嗯，几乎全部！），没有预期/计划的新开发工作。这并不意味着它被遗弃或不受支持：欢迎提交错误报告和拉取请求，并将予以处理。

文档

文档可在网上找到 在线，但由于这些只是 FFI 绑定，内容相对较少。

gexiv2 的 API 可能是一个有用的参考，以及 Exiv2 的 API 文档。

设置 & 依赖

鉴于它与gexiv2链接，并通过传递链接到Exiv2，gexiv2-sys显然依赖于它们。这些库不是与gexiv2-sys捆绑在一起的：您需要单独安装它们。

最低支持的 rustc 版本是 1.63。

有关如何开始使用gexiv2-sys的完整说明，包括如何安装先决依赖项，请参阅 SETUP 文件。

可选功能

raw-tag-access：如果您需要访问标签的原始字节数值，您可以通过启用此功能来获取 gexiv2_metadata_get_tag_raw 函数。请注意，此调用的返回值是 GLib GBytes 对象，您可以通过 GLib 的 g_bytes_unref_to_data 将其转换为数据指针。

此功能默认禁用，因为它引入了对 glib-sys 的新依赖，从而也对 GLib 系统库有依赖。

xmp-packet-access：如果您需要访问 XML 格式的 XMP 数据包，您可以通过启用此功能。它将添加 gexiv2_metadata_generate_xmp_packet 和 gexiv2_metadata_get_xmp_packet 调用。启用功能还会引入对 bitflags crate 的新依赖。

贡献 & 缺陷报告

欢迎通过 GitHub pull requests 或通过电子邮件将补丁发送到 felixc@felixcrux.com（PGP 密钥 8569B6311EE485F8）进行贡献。

通过贡献，您同意在与其他项目相同的许可条款下提供您的贡献。

缺陷报告和功能请求也可以通过 GitHub Issues 或电子邮件发送，并且非常受欢迎和感激。

有关更多信息，请参阅 CONTRIBUTING 文件。

版权 & 许可

Exiv2 和 gexiv2 库都是在 GNU 通用公共许可证（GPL）的条款下发布的，并且由于 gexiv2-sys 与它们链接，因此也根据 GPL 条款提供。具体而言

本程序是自由软件：您可以根据自由软件基金会发布的 GNU 通用公共许可证的条款重新分发和/或修改它，许可证版本为 3，或者（根据您的要求）任何后续版本。

本程序的分发是希望它将是有用的，但没有任何保证；甚至没有对适销性或特定用途适用性的暗示保证。有关详细信息，请参阅 GNU 通用公共许可证。

您应该已收到一份 GNU 通用公共许可证副本。如果没有，请参阅 https://gnu.ac.cn/licenses/。

请参阅 LICENSE 文件以获取完整的许可证副本。