<?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_d0e504717_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>