go-xmp

module
v0.0.0-...-a3fba17 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Dec 4, 2024 License: Apache-2.0

README

go-xmp

Build Status GoDoc

go-xmp is a native Go SDK for the Extensible Metadata Platform (XMP) as defined by the Adobe XMP Specification Part 1, Part 2 and Part 3, a.k.a ISO 16684-1:2011(E).

Features

Included metadata models
  • XMP DublinCore (dc)
  • XMP Media Management (xmpMM)
  • XMP Dynamic Media (xmpDM)
  • XMP Rights (xmpRights)
  • XMP Jobs (xmpBJ)
  • XMP Paged Text (xmpTPg)
  • EXIF v2.3.1 (exif, exifEX)
  • Adobe Camera Raw (crs)
  • Creative Commons (cc)
  • DJI Drones (dji)
  • ID3 v2.2, v2.3, v2.4 (id3)
  • iXML audio recorder (ixml)
  • iTunes/MP4 (itunes)
  • ISO/MP4 (mp4)
  • Quicktime (qt)
  • PhotoMechanic (pm)
  • Tiff (tiff)
  • Riff (riff)
  • Photoshop (ps)
  • PDF (pdf)
Metadata models available under commercial license
  • ACES Image Metadata
  • AEScart
  • ARRI Camera Metadata
  • ASC CDL
  • EBU Broadcast WAV
  • Getty Images
  • IPTC Core 1.2, IPTC Extension 1.3, IPTC Video Metadata 1.0
  • Plus Licensing Metadata
  • SMPTE DPX Image Metadata
  • SMPTE MXF Metadata
  • OpenEXR Image Header Metadata
  • XMP Media Production SDK (Universal Metadata Container)

Documentation

Installation

Install go-xmp using the "go get" command:

go get github.com/honza/go-xmp

The Go distribution is go-xmp's only dependency.

Examples

Benchmarks

go test ./test/ -bench=. -benchmem

goos: darwin
goarch: amd64
pkg: github.com/honza/go-xmp/test
BenchmarkUnmarshalXMP_5kB-8       5000      321524 ns/op     58071 B/op     1056 allocs/op
BenchmarkMarshalXMP_5kB-8         5000      270981 ns/op     61384 B/op      758 allocs/op
BenchmarkMarshalJSON_5kB-8        5000      338354 ns/op     91855 B/op     1023 allocs/op
BenchmarkUnmarshalJSON_5kB-8      5000      382196 ns/op     60387 B/op     1022 allocs/op
BenchmarkUnmarshalXMP_85kB-8       300     5152080 ns/op    902794 B/op    17779 allocs/op
BenchmarkMarshalXMP_85kB-8         300     4292143 ns/op    966356 B/op    12209 allocs/op
BenchmarkMarshalJSON_85kB-8        300     5378268 ns/op   1453004 B/op    16535 allocs/op
BenchmarkUnmarshalJSON_85kB-8      200     5512114 ns/op    880161 B/op    14497 allocs/op

XMP Marshal Benchmark using premiere-cc.xmp, a rather large xmpDM file with history, xmpMM:Pantry etc.

  Compression Results 417        mean               min                  max
  -----------------------------------------------------------------------------
        Original sizes       4013 (100.0)        918 (100.0)      86940 (100.0)
             XMP sizes       3545 ( 90.4)        723 ( 52.3)      78325 (147.0)
        XMP Gzip sizes       1177 ( 32.0)        369 (  8.4)       8086 ( 61.3)
      XMP Snappy sizes       1195 ( 32.5)        387 (  8.4)       8104 ( 62.9)
            JSON sizes       2147 ( 52.8)        389 ( 31.6)      65127 ( 91.7)
       JSON Gzip sizes        889 ( 23.7)        209 (  6.9)       7714 ( 50.5)
     JSON Snappy sizes        907 ( 24.3)        227 (  7.0)       7732 ( 50.6)
  -----------------------------------------------------------------------------
        XML->XMP times          371.674µs           74.091µs         4.816883ms
       XMP->JSON times          234.785µs            36.91µs         4.517591ms
        XMP->XML times          259.084µs           20.004µs         4.505254ms
        XMP Gzip times          214.342µs          105.685µs         1.036886ms
      XMP Gunzip times           59.948µs           19.924µs          285.113µs
      XMP Snappy times           28.325µs            7.975µs          234.161µs
    XMP Unsnappy times           25.841µs            7.899µs          195.265µs
       JSON Gzip times          197.268µs            93.86µs          968.985µs
     JSON Gunzip times           53.622µs           17.655µs         2.913516ms
     JSON Snappy times           23.581µs            7.864µs          221.674µs
   JSON Unsnappy times           37.215µs            7.856µs          398.361µs

Size matters when storing XMP in a database or sending documents over a network. Above is a quick comparison between common compression methods gzip and snappy regarding runtime and size for documents in the samples/ directory. What's also included is a comparison of the uncompressed documents in XMP/XML and XMP/JSON format. Original means the initial XMP document as stored in .xmp sidecar files. To be fair, some originals use padding, so the mean size distribution is larger than what go-xmp generated here because padding was turned off during write.

Contributing

See CONTRIBUTING.md.

License

go-xmp is available under the Apache License, Version 2.0.

Directories

Path Synopsis
cc
Package cc implements Creative Commons licensing metadata.
 Package cc implements Creative Commons licensing metadata.
crs
Package crs implements Adobe Camera Raw metadata as defined in chapter 3.3 of XMP Specification Part 2.
 Package crs implements Adobe Camera Raw metadata as defined in chapter 3.3 of XMP Specification Part 2.
dc
Package dc implements Dublin Core metadata as defined in XMP Specification Part 1.
 Package dc implements Dublin Core metadata as defined in XMP Specification Part 1.
digikam
dji
Package dji implements metadata models written by video cameras on DJI drones.
 Package dji implements metadata models written by video cameras on DJI drones.
exif
Package exif implements the Exif 2.3.1 metadata standard as defined in CIPA DC-008-2016.
 Package exif implements the Exif 2.3.1 metadata standard as defined in CIPA DC-008-2016.
id3
Package id3 implements the ID3v2.4 metadata standard for audio files.
 Package id3 implements the ID3v2.4 metadata standard for audio files.
itunes
Package itunes implements metadata models found in Apple iTunes audio and video files.
 Package itunes implements metadata models found in Apple iTunes audio and video files.
ixml
Package ixml implements the iXML audio chunk metadata standard for broadcast wave audio.
 Package ixml implements the iXML audio chunk metadata standard for broadcast wave audio.
mp4
Package mp4 implements metadata found in ISO/IEC 14496-14:2003 (3GPP/ISO MP4) files.
 Package mp4 implements metadata found in ISO/IEC 14496-14:2003 (3GPP/ISO MP4) files.
pdf
Package pdf implements metadata for PDF files as defined by XMP Specification Part 2.
 Package pdf implements metadata for PDF files as defined by XMP Specification Part 2.
pm
Package pm implements metadata written by Photomechanic software found in many professional images.
 Package pm implements metadata written by Photomechanic software found in many professional images.
ps
Package ps implements Adobe Photoshop metadata as defined by XMP Specification Part 2 Chapter 3.2.
 Package ps implements Adobe Photoshop metadata as defined by XMP Specification Part 2 Chapter 3.2.
qt
Package qt implements metadata found in Apple Quicktime (MOV) files.
 Package qt implements metadata found in Apple Quicktime (MOV) files.
riff
Package riff implements metadata for AVI and WAV files as defined by XMP Specification Part 3.
 Package riff implements metadata for AVI and WAV files as defined by XMP Specification Part 3.
tiff
Package tiff implements metadata for TIFF and JPEG image files as defined by XMP Specification Part 1.
 Package tiff implements metadata for TIFF and JPEG image files as defined by XMP Specification Part 1.
xmp_base
Package xmpbase implements the XMP namespace as defined by XMP Specification Part 2.
 Package xmpbase implements the XMP namespace as defined by XMP Specification Part 2.
xmp_bj
Package xmpbj implements the XMP Basic Job Ticket namespace as defined by XMP Specification Part 2.
 Package xmpbj implements the XMP Basic Job Ticket namespace as defined by XMP Specification Part 2.
xmp_dm
Package xmpdm implements the XMP Dynamic Media namespace as defined by XMP Specification Part 2.
 Package xmpdm implements the XMP Dynamic Media namespace as defined by XMP Specification Part 2.
xmp_mm
Package xmpmm implements the XMP Media Management namespace as defined by XMP Specification Part 2.
 Package xmpmm implements the XMP Media Management namespace as defined by XMP Specification Part 2.
xmp_rights
Package xmprights implements the XMP Rights management namespace as defined by XMP Specification Part 1.
 Package xmprights implements the XMP Rights management namespace as defined by XMP Specification Part 1.
xmp_tpg
Package xmptpg implements the XMP Paged Text namespace as defined by XMP Specification Part 2.
 Package xmptpg implements the XMP Paged Text namespace as defined by XMP Specification Part 2.
Package xmp implements the Extensible Metadata Platform (XMP) defined in ISO 16684-1:2011(E).
 Package xmp implements the Extensible Metadata Platform (XMP) defined in ISO 16684-1:2011(E).

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.