<?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-46121F24-AB53-5B44-A082-EF13A72EB7FF" xml:lang="en"><title>Writing

a Converter</title><shortdesc>File Converter Framework specifies a plug-in interface for file

format converters. Clients can convert from one data type to another using

file format converters, for example, HTML files to Word documents. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

<section><title>Introduction</title> <p>The File Converter Framework provides

the following: </p> <ul>

<li id="GUID-75C46CFD-2B82-5500-AADA-E9E86CE8E894"><p>An abstract interface

which all converters must implement. </p> </li>

<li id="GUID-657490ED-CACA-5C43-BE75-5FBB954F2625"><p>APIs to list and search

for converters. </p> </li>

<li id="GUID-97761F64-2821-5845-86AD-1912B6E551F8"><p>APIs to determine the

MIME types supported by the available converters. </p> </li>

<li id="GUID-4D4812BA-9B84-5022-81B5-784F80FF5C75"><p>An observer interface

through which the progress and success or failure of the conversion can be

reported. </p> </li>

</ul> <p>Converters are implemented as <xref href="GUID-9E92EE30-F2E2-5F28-BB2A-391C09EC69D2.dita">ECom

plug-ins</xref>, each of which can implement one or more converters. Like

all binaries, the plug-ins are installed in the <filepath>\sys\bin\</filepath> directory.

Each plug-in must provide two resource files: one contains a <codeph>CONARC_RESOURCE_FILE</codeph> resource

to describe the converters implemented in the DLL, and the other is a registration

resource file required by the ECom framework. </p> <p>The following UML diagram

shows the key elements of the converter architecture, including an example

client and an example converter DLL that provides two converters, <codeph>myConverter1</codeph> and <codeph>myConverter2</codeph>. </p> <fig id="GUID-6E58825A-CBE2-52B8-B7BD-6D263A0751F4">

<title>              File Converter architecture            </title>

<image href="GUID-EF7F79E4-21B1-59E3-A063-ABD2C6426E7C_d0e134536_href.png" placement="inline"/>

</fig> </section>

<section><title>Procedure</title> <ol id="GUID-1E4BFC84-4F0F-5DB1-A6D5-617E23617AB4">

<li id="GUID-2132AE6E-DB10-53BE-B9F4-0E8F9C305BCA"><p><xref href="GUID-49C93C36-D86B-4EEE-A8AB-4279312DF4BC.dita">Write

an interface implementation for a converter</xref>. </p> </li>

<li id="GUID-B7BABC73-46D1-58EC-9251-2C4728017FB4"><p><xref href="GUID-008F9006-8548-443D-A7ED-4A8233E051C6.dita">Implement

the ECom framework code</xref>. </p> </li>

<li id="GUID-4A30B127-FC7A-5751-9F1A-3D8DE591B455"><p><xref href="GUID-436B6DFE-D279-44BF-B099-B2547D50610A.dita">Write

a resource file</xref>. </p> </li>

<li id="GUID-14F0D5B7-C909-5EF5-95DB-01E56CA5FFB0"><p><xref href="GUID-22F4D9EA-9912-466E-B729-7706BC17BDA1.dita">Write

a converter DLL project file</xref>. </p> </li>

</ol> </section>

</conbody><related-links>

<link href="GUID-99AC84AE-C4C0-53AA-8984-51AE84EE7651.dita"><linktext>File Converter

Framework Overview</linktext></link>