<?xml version="1.0"?>
<page id="Gimp.Image.metadata_save_filter"
      type="topic"
      style="method"
      xmlns="http://projectmallard.org/1.0/"
      xmlns:api="http://projectmallard.org/experimental/api/"
      xmlns:ui="http://projectmallard.org/1.0/ui/">
  <info>
    <link xref="Gimp.Image" group="method" type="guide"/>
    <api:function>
      <api:returns>
        <api:type>Gimp.Metadata</api:type>
      </api:returns>
      <api:name>gimp_image_metadata_save_filter</api:name>
      <api:arg>
        <api:type>Gimp.Image</api:type>
        <api:name>self</api:name>
      </api:arg>
      <api:arg>
        <api:type>unicode</api:type>
        <api:name>mime_type</api:name>
      </api:arg>
      <api:arg>
        <api:type>Gimp.Metadata</api:type>
        <api:name>metadata</api:name>
      </api:arg>
      <api:arg>
        <api:type>Gimp.MetadataSaveFlags</api:type>
        <api:name>flags</api:name>
      </api:arg>
      <api:arg>
        <api:type>Gio.File</api:type>
        <api:name>file</api:name>
      </api:arg>
    </api:function>
  </info>
  <title>Gimp.Image.metadata_save_filter</title>
  <synopsis><code mime="text/x-python">
@accepts(Gimp.Image, unicode, Gimp.Metadata, Gimp.MetadataSaveFlags, Gio.File)
@returns(Gimp.Metadata)
def metadata_save_filter(self, mime_type, metadata, flags, file):
    # Python wrapper for gimp_image_metadata_save_filter()
  </code></synopsis>
  <p>Filters the <code>metadata</code> retrieved from the image with
<link xref="Gimp.Image.metadata_save_prepare"/>,
taking into account the passed <code>flags</code>.</p>  <p>Note that the <code>self</code> passed to this function might be different
from the image passed to <link xref="Gimp.Image.metadata_save_prepare"/>, due
to whatever file export conversion happened in the meantime</p>  <p>This is an alternative to gimp_image_metadata_save_finish when you
want to save metadata yourself and you need only filtering processing.</p>
  <p>Since 3.0</p>
<terms>
<item>
<title><code>self</code></title>
  <p>The actually saved image</p>
</item>
<item>
<title><code>mime_type</code></title>
  <p>The saved file's mime-type</p>
</item>
<item>
<title><code>metadata</code></title>
  <p>The metadata to export</p>
</item>
<item>
<title><code>flags</code></title>
  <p>Flags to specify what of the metadata to save</p>
</item>
<item>
<title><code>file</code></title>
  <p>The file <code>self</code> was saved to or NULL if file was not saved yet</p>
</item>
<item>
<title><code>Returns</code></title>
{formatter.format(node, node.retval.doc)}
</item>
</terms>

</page>
