<!-- ##### SECTION Title ##### -->
gnome-fileconvert

<!-- ##### SECTION Short_Description ##### -->
File format conversion functions.

<!-- ##### SECTION Long_Description ##### -->
<para>
These routines provide conversion of information based on a source and
target mime type.  They return -1 on failure, or an opened file
descriptor with the data on success</para>

<para>
The rules for converting from one MIME type to another are
loaded from the <filename>$gnome-prefix/share/type-convert</filename>
directory. Any files in that directory whose extension is
<filename>.convert</filename> is loaded as well as the per-user
<filename>~/.gnome/type.convert</filename> file.</para>

    <para>The file format used to define a filter is very
    simple:</para>

      <example>
	<title>Sample MIME type file conversion definition</title>
	<programlisting>
image/gif image/x-portable-pixmap giftopnm
	</programlisting>
     </example>
    <para>
	This sample file conversion file defines a conversion rule
	from the image/gif MIME type to the image/x-portable-pixmap
	MIME type.  The program used for the conversion is
	<filename>giftopnm</filename>.  This program should do the
	specified MIME type conversion by reading its standard input
	and writing the results on the standard output.
    </para>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

<!-- ##### FUNCTION gnome_file_convert_fd ##### -->
<para>

</para>

@fd: 
@fromtype: 
@totype: 
@Returns: 


<!-- ##### FUNCTION gnome_file_convert ##### -->
<para>

</para>

@filename: 
@fromtype: 
@totype: 
@Returns: 


