<?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-C3A3D9CF-4826-4BEB-8778-ECD8E6B6463C" xml:lang="en"><title>Image Processor Overview</title><shortdesc>Introduction to topic for overview page or search</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>This document introduces to the Image Processor library. </p>
<section><title>Purpose</title> <p>Image Processor is specially developed
for imaging on mobile devices. The main objective is to create powerful applications: </p> <ul>
<li><p>Photo editors </p> </li>
<li><p>Viewers </p> </li>
<li><p>Cameras. </p> </li>
</ul> </section>
<section><title>Image Processor library details</title> <p>The DLL that provides
the functionality and the library to which your code must link is identified
below. </p> <table id="GUID-DE2B2BFA-39FE-4895-B75C-332D9CA3B1A5">
<tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/>
<thead>
<row>
<entry>DLL</entry>
<entry>LIB</entry>
<entry>Short Description</entry>
</row>
</thead>
<tbody>
<row>
<entry><p> <filepath>imageprocessor.dll</filepath>  </p> </entry>
<entry><p> <filepath>imageprocessor.lib</filepath>  </p> </entry>
<entry><p>These files are used for implementing Image Processor operations. </p> </entry>
</row>
</tbody>
</tgroup>
</table> </section>
<section><title>Architectural relationship</title> <p>Image Processor is designed
with hardware constraints often associated with mobile devices in mind. The
Image Processor framework minimizes both memory consumption and the CPU power
required. </p> <p>The diagrammatic representation of the Image Processor library
is as follows: </p> <fig id="GUID-BD94B563-020A-4E81-808A-6A5C04AF74B9">
<desc><p>The architectural relationship diagram for the Image Processor library </p> </desc>
<image href="GUID-433698C1-C97D-5317-83C0-71A029E362E6_d0e303218_href.png" placement="inline"/>
</fig> </section>
<section><title>Image Processor</title> <p>Image Processor is a high-level
library and framework. Image Processor encapsulates all the internal processing
and basic functionality required to create applications. Basic functions include </p> <ul>
<li><p>initiate image processing </p> </li>
<li><p>decode images </p> </li>
<li><p>zoom images </p> </li>
<li><p>pan images </p> </li>
<li><p>render images to screen or file. </p> </li>
</ul> <p>The Image Processor library also allows some geometrical operations
to the image: </p> <ul>
<li><p>rotate or flip </p> </li>
<li><p>crop. </p> </li>
</ul> <p>Optionally, the Image Processor library supports </p> <ul>
<li><p>effects </p> </li>
<li><p>overlays. </p> </li>
</ul> </section>
<section><title>Image Processor Adaptation Plug-in</title><p>The Image Processor
adaptation plug-in is an attachable component which implements the features
of the Image Processor library. The Image Processor adaptation plug-ins are
dependant on the Image Processor library, and will not function as standalone
components. </p> <p> <b>Note: You must write your own Image Processor adaptation
plug-in, because the Image Processor adaptation plug-in is not provided.</b> </p></section>
<section><title>Key Image Processor Class</title> <p>The principal classes
of the Image Processor library are as follows: </p> <ul>
<li><p> <xref href="GUID-9E5136D1-B8BE-3CE4-9A20-39D672E31EC7.dita#GUID-9E5136D1-B8BE-3CE4-9A20-39D672E31EC7/GUID-13E30312-DD05-3581-9A59-C3569A981657"><apiname>ImageProcessor::CImgProcessor</apiname></xref>, which provides a
convenient interface to process images. </p> </li>
<li><p> <xref href="GUID-9E5136D1-B8BE-3CE4-9A20-39D672E31EC7.dita#GUID-9E5136D1-B8BE-3CE4-9A20-39D672E31EC7/GUID-5DD1A7CA-B0F8-3769-9D53-4541BDC2C3FB"><apiname>ImageProcessor::TEffect</apiname></xref>, which is the parent class
of all effects, for example, <xref href="GUID-9E5136D1-B8BE-3CE4-9A20-39D672E31EC7.dita#GUID-9E5136D1-B8BE-3CE4-9A20-39D672E31EC7/GUID-6703666E-4B7E-3AD2-A03F-A6B7D2F8AD02"><apiname>ImageProcessor::TEffectAntique</apiname></xref>. </p> </li>
</ul> </section>
<section><title>Using Image Processor</title> <p>Image Processor is used for
the following: </p> <ul>
<li><p>To initialize and process an input image </p> </li>
<li><p>To apply effects and filters to the image. </p> </li>
<li><p>Overlay images onto an image. </p> </li>
<li><p>To render a low resolution preview of the image for display on screen. </p> </li>
<li><p>To render a high resolution compressed image to disk or memory. </p> </li>
</ul> </section>
</conbody></concept>