<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-99AC84AE-C4C0-53AA-8984-51AE84EE7651" xml:lang="en"><title>Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<section><title>Purpose</title><p>The File Converter Framework converts data
from one format to another format. For example, HTML files can be converted
to Symbian word documents. </p> </section>
<section><title>Architecture</title><p>The File Converter Framework
architecture provides a framework for ECOM plug-ins, called converters, that
can convert data between different formats. When an application requests to
convert data from one format to another format, the framework checks the list
of available converters. If there is a converter that can do the conversion,
then the framework assigns the request to that converter. </p> <p>The following
diagram shows the File converter framework architecture. </p> <fig id="GUID-E4ECB2BD-53D8-53F7-B248-2D2EE5888F1E">
<image href="GUID-C8938826-52F7-5040-B59C-3C06DAEB6F03_d0e137877_href.jpg" placement="inline"/>
</fig> </section>
<section><title>API summary</title> <table id="GUID-82B5BE7F-1DE7-5FBA-9770-05D9B8A74E2F">
<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
<thead>
<row>
<entry>API</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry><p> <xref href="GUID-D7356C00-8DFE-33D5-937D-59A90CC0412E.dita"><apiname>CCnaConverter</apiname></xref>  </p> </entry>
<entry><p>A class that contains the properties of a converter. These are a
UID and the data types that the converter supports. </p> </entry>
</row>
<row>
<entry><p> <xref href="GUID-66797353-CD46-36C1-A719-4CF50A75250C.dita"><apiname>CConverterBase</apiname></xref>  </p> </entry>
<entry><p>A class that provides an interface to access the converters. </p> </entry>
</row>
<row>
<entry><p> <xref href="GUID-583F9530-59DD-3546-B2F9-94D130A3EDD1.dita"><apiname>CConverterBase2</apiname></xref>  </p> </entry>
<entry><p>A base class for converters. </p> </entry>
</row>
<row>
<entry><p> <xref href="GUID-6C51F1E2-7794-3830-9D52-CA98827C0156.dita"><apiname>CCnaConverterList</apiname></xref>  </p> </entry>
<entry><p>A class that provides a list of available converters. It allows
clients to search for and obtain converters for specific source and target
data types. </p> </entry>
</row>
<row>
<entry><p> <xref href="GUID-3C5F0946-1A4F-3ADA-A41A-BC408F9B9414.dita"><apiname>CCnaConvInfoFileReader2</apiname></xref>  </p> </entry>
<entry><p>A class that encapsulates a collection of converter properties, <xref href="GUID-D7356C00-8DFE-33D5-937D-59A90CC0412E.dita"><apiname>CCnaConverter</apiname></xref>,
read from a converter information <filepath>.rsc</filepath> file. </p> </entry>
</row>
<row>
<entry><p> <xref href="GUID-6AF2AE70-9FA4-3B06-B01F-86DE3581AE10.dita"><apiname>CMimeInfo</apiname></xref>  </p> </entry>
<entry><p>A class that contains the localized names for a data type. </p> </entry>
</row>
<row>
<entry><p> <xref href="GUID-AC297E11-FD37-3572-9612-042F68324F6E.dita"><apiname>MConverterUiObserver</apiname></xref>  </p> </entry>
<entry><p>An interface implemented by the client of a conversion operation
to observe conversion progress. </p> </entry>
</row>
</tbody>
</tgroup>
</table> </section>
<section><title>Typical uses</title> <p><b>Using a converter</b> </p> <p>File
Converter Framework provides APIs to list and search for converters. It also
provides an observer interface through which the progress and success or failure
of the conversion can be reported. For more information, see <xref href="GUID-C1C0E7DF-6519-5648-AE5E-6D149AF1A89A.dita">Using
a converter</xref>. </p> <p><b>Writing a converter</b> </p> <p>File Converter
Framework specifies a plug-in interface for converters. For more information,
see <xref href="GUID-46121F24-AB53-5B44-A082-EF13A72EB7FF.dita">Writing a Converter</xref>. </p> </section>
</conbody><related-links>
<link href="GUID-99ACBD00-2F61-5984-BE77-91D5EF547289.dita"><linktext>File Converter
Tutorials</linktext></link>
</related-links></concept>