metadatamux

metadatamux — Write metadata (EXIF, IPTC and XMP) into a image stream

Synopsis

                    GstMetadataMux;

Object Hierarchy

  GObject
   +----GstObject
         +----GstElement
               +----GstBaseMetadata
                     +----GstMetadataMux

Implemented Interfaces

GstMetadataMux implements GstTagSetter.

Properties

  "exif"                     gboolean              : Read / Write
  "iptc"                     gboolean              : Read / Write
  "xmp"                      gboolean              : Read / Write
  "exif-byte-order"          MetaExifByteOrder     : Read / Write

Description

This element writes tags into metadata (EXIF, IPTC and XMP) chunks, and writes the chunks into image files (JPEG, PNG). Tags the are received as GST_EVENT_TAG event or set by the application using GstTagSetter interface.

Example launch line

gst-launch -v -m filesrc location=orig.jpeg ! metadatamux ! filesink
location=dest.jpeg

gst-launch -v -m filesrc location=orig.png ! metadatademux ! pngdec ! 
ffmpegcolorspace ! jpegenc ! metadatamux ! filesink location=dest.jpeg

How it works

If this element receives a GST_TAG_EXIF, GST_TAG_IPTC or GST_TAG_XMP which are whole chunk metadata tags, then this whole chunk will be modified by individual tags received and written to the file. Otherwise, a new chunk will be created from the scratch and then modified in same way.

Synopsis

Element Information

plugin metadata
author Edgard Lima <edgard.lima@indt.org.br>
class Muxer/Extracter/Metadata

Element Pads

name sink
direction sink
presence always
details image/jpeg, tags-extracted=(boolean)true
image/png, tags-extracted=(boolean)true
name src
direction source
presence always
details image/jpeg
image/png

Details

GstMetadataMux

typedef struct _GstMetadataMux GstMetadataMux;

The opaque GstMetadataMux data structure.

Property Details

The "exif" property

  "exif"                     gboolean              : Read / Write

Send EXIF metadata ?.

Default value: TRUE


The "iptc" property

  "iptc"                     gboolean              : Read / Write

Send IPTC metadata ?.

Default value: FALSE


The "xmp" property

  "xmp"                      gboolean              : Read / Write

Send XMP metadata ?.

Default value: FALSE


The "exif-byte-order" property

  "exif-byte-order"          MetaExifByteOrder     : Read / Write

Set byte-order for exif metadata writing.

Default value: Motorola byte-order

Since 0.10.11