Struct MetadataFields 

#[non_exhaustive]
pub struct MetadataFields {
    pub icc: IccRetention,
    pub exif: ExifPolicy,
    pub xmp: Retention,
    pub cicp: Retention,
    pub hdr: Retention,
}

Per-field metadata retention for MetadataPolicy::Custom.

EXIF is encapsulated in ExifPolicy (pruned by category); the remaining fields use Retention (explicit Keep/Discard). This type is #[non_exhaustive] (new fields can be added without a breaking change), so downstream crates build from KEEP_ALL / DISCARD_ALL via the with_* builders rather than struct-update syntax. Drop only GPS, keep all else:

use zencodec::{MetadataFields, exif::{ExifPolicy, Retention}};
let fields = MetadataFields::KEEP_ALL
    .with_exif(ExifPolicy::KEEP_ALL.with_gps(Retention::Discard));

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

icc: IccRetention

ICC color profile.

exif: ExifPolicy

EXIF, pruned by category.

xmp: Retention

XMP, whole-segment. The XMP packet (RDF/XML) can carry GPS (exif:GPS*), edit history (photoshop:History, xmpMM:History), and C2PA provenance (xmpMM manifests), so the presets that strip privacy/bloat (Web) discard it wholesale while keeping EXIF rights.

Partial XMP (e.g. keep dc:rights/dc:creator, drop GPS + history + C2PA) is a planned future addition — it needs an RDF/XML parser, so it is deferred rather than half-done. It will arrive as a new MetadataFields field (this struct is #[non_exhaustive], so adding one is non-breaking); xmp will remain the whole-segment master switch.

cicp: Retention

CICP color signaling.

hdr: Retention

HDR ContentLightLevel + MasteringDisplay.

Implementations

impl MetadataFields

pub const KEEP_ALL: Self

Keep every field (ICC kept as-is, including a redundant sRGB).

pub const DISCARD_ALL: Self

Discard every field.

pub const fn with_icc(self, r: IccRetention) -> Self

Set ICC retention. (Builder — this type is #[non_exhaustive].)

pub const fn with_exif(self, p: ExifPolicy) -> Self

Set the EXIF retention policy.

pub const fn with_xmp(self, r: Retention) -> Self

Set XMP retention.

pub const fn with_cicp(self, r: Retention) -> Self

Set CICP retention.

pub const fn with_hdr(self, r: Retention) -> Self

Set HDR (light-level/mastering) retention.

Trait Implementations

impl Clone for MetadataFields

fn clone(&self) -> MetadataFields

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for MetadataFields

impl Debug for MetadataFields

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

Formats the value using the given formatter.

impl Eq for MetadataFields

impl PartialEq for MetadataFields

fn eq(&self, other: &MetadataFields) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for MetadataFields