36 releases (6 stable)
new 1.2.0 | Mar 18, 2023 |
---|---|
1.0.2 | Feb 9, 2023 |
1.0.0 | Dec 19, 2022 |
0.7.6 | Nov 6, 2022 |
0.1.6 | Nov 26, 2020 |
#26 in Images
2,136 downloads per month
Used in 2 crates
(via c2pa)
9.5MB
112K
SLoC
XMP Toolkit bindings for Rust
Adobe's Extensible Metadata Platform (XMP) is a labeling technology that allows you to embed data about a file, known as metadata, into the file itself. More information on how partners and standards are using XMP is available at the XMP website.
Key features
This XMP Toolkit crate implements a subset of the XMP metadata standard. This toolkit allows a desktop or mobile application to:
- Parse XMP metadata found in many file formats.
- Inspect and modify the XMP data model.
- Embed and update XMP metadata in many file formats.
The XmpMeta
struct contains most of the API functions for these features and is the best place to get started in understanding this crate.
Contributions and feedback
We welcome contributions to this project. For information on contributing, providing feedback, and about ongoing work, see Contributing.
Requirements
The toolkit requires Rust version 1.60.0 or newer.
Crate features
chrono
- When enabled, adds conversions betweenXmpDateTime
andchrono::DateTime<FixedOffset>
. (Disabled by default.)
Supported platforms
The toolkit has been tested on the following operating systems:
-
Windows
- Only the MSVC build chain is supported on Windows. As discussed in #155, we would welcome a PR to enable GNU build chain support on Windows.
-
MacOS (Intel and Apple silicon)
-
Ubuntu Linux on x86 and ARM v8 (aarch64)
- On ARM, the minimum supported Rust version (MSRV) is 1.60.0.
C++ XMP Toolkit
This crate incorporates the June 2022 version of the C++ Adobe XMP Toolkit SDK.
When a newer version of the C++ XMP Toolkit is incorporated, a new minor (1.x.0) version of this crate will be released.
Upgrading from earlier versions
This API is considered to to be stable; in other words, no further breaking changes are anticipated. For instructions on how to upgrade from various 0.x versions to 1.x, see the Upgrading guide.
Minor, non-breaking additions to the API surface may be added as the few remaining APIs in the C++ XMP_Meta
, XMP_Files
, TXMPUtils
interfaces are exposed. Such changes will trigger minor (1.x.0) version increments when they happen.
Usage
Add this to your Cargo.toml
:
[dependencies]
xmp_toolkit = "1.2.0"
License
The xmp_toolkit
crate is distributed under the terms of both the MIT license and the Apache License (Version 2.0).
See LICENSE-APACHE and LICENSE-MIT.
Note that some components and dependent crates are licensed under different terms; please check the license terms for each crate and component for details.