|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <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> |
|
13 <p>This document introduces to the Image Processor library. </p> |
|
14 <section><title>Purpose</title> <p>Image Processor is specially developed |
|
15 for imaging on mobile devices. The main objective is to create powerful applications: </p> <ul> |
|
16 <li><p>Photo editors </p> </li> |
|
17 <li><p>Viewers </p> </li> |
|
18 <li><p>Cameras. </p> </li> |
|
19 </ul> </section> |
|
20 <section><title>Image Processor library details</title> <p>The DLL that provides |
|
21 the functionality and the library to which your code must link is identified |
|
22 below. </p> <table id="GUID-DE2B2BFA-39FE-4895-B75C-332D9CA3B1A5"> |
|
23 <tgroup cols="3"><colspec colname="col0"/><colspec colname="col1"/><colspec colname="col2"/> |
|
24 <thead> |
|
25 <row> |
|
26 <entry>DLL</entry> |
|
27 <entry>LIB</entry> |
|
28 <entry>Short Description</entry> |
|
29 </row> |
|
30 </thead> |
|
31 <tbody> |
|
32 <row> |
|
33 <entry><p> <filepath>imageprocessor.dll</filepath> </p> </entry> |
|
34 <entry><p> <filepath>imageprocessor.lib</filepath> </p> </entry> |
|
35 <entry><p>These files are used for implementing Image Processor operations. </p> </entry> |
|
36 </row> |
|
37 </tbody> |
|
38 </tgroup> |
|
39 </table> </section> |
|
40 <section><title>Architectural relationship</title> <p>Image Processor is designed |
|
41 with hardware constraints often associated with mobile devices in mind. The |
|
42 Image Processor framework minimizes both memory consumption and the CPU power |
|
43 required. </p> <p>The diagrammatic representation of the Image Processor library |
|
44 is as follows: </p> <fig id="GUID-BD94B563-020A-4E81-808A-6A5C04AF74B9"> |
|
45 <desc><p>The architectural relationship diagram for the Image Processor library </p> </desc> |
|
46 <image href="GUID-433698C1-C97D-5317-83C0-71A029E362E6_d0e309233_href.png" placement="inline"/> |
|
47 </fig> </section> |
|
48 <section><title>Image Processor</title> <p>Image Processor is a high-level |
|
49 library and framework. Image Processor encapsulates all the internal processing |
|
50 and basic functionality required to create applications. Basic functions include </p> <ul> |
|
51 <li><p>initiate image processing </p> </li> |
|
52 <li><p>decode images </p> </li> |
|
53 <li><p>zoom images </p> </li> |
|
54 <li><p>pan images </p> </li> |
|
55 <li><p>render images to screen or file. </p> </li> |
|
56 </ul> <p>The Image Processor library also allows some geometrical operations |
|
57 to the image: </p> <ul> |
|
58 <li><p>rotate or flip </p> </li> |
|
59 <li><p>crop. </p> </li> |
|
60 </ul> <p>Optionally, the Image Processor library supports </p> <ul> |
|
61 <li><p>effects </p> </li> |
|
62 <li><p>overlays. </p> </li> |
|
63 </ul> </section> |
|
64 <section><title>Image Processor Adaptation Plug-in</title><p>The Image Processor |
|
65 adaptation plug-in is an attachable component which implements the features |
|
66 of the Image Processor library. The Image Processor adaptation plug-ins are |
|
67 dependant on the Image Processor library, and will not function as standalone |
|
68 components. </p> <p> <b>Note: You must write your own Image Processor adaptation |
|
69 plug-in, because the Image Processor adaptation plug-in is not provided.</b> </p></section> |
|
70 <section><title>Key Image Processor Class</title> <p>The principal classes |
|
71 of the Image Processor library are as follows: </p> <ul> |
|
72 <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 |
|
73 convenient interface to process images. </p> </li> |
|
74 <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 |
|
75 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> |
|
76 </ul> </section> |
|
77 <section><title>Using Image Processor</title> <p>Image Processor is used for |
|
78 the following: </p> <ul> |
|
79 <li><p>To initialize and process an input image </p> </li> |
|
80 <li><p>To apply effects and filters to the image. </p> </li> |
|
81 <li><p>Overlay images onto an image. </p> </li> |
|
82 <li><p>To render a low resolution preview of the image for display on screen. </p> </li> |
|
83 <li><p>To render a high resolution compressed image to disk or memory. </p> </li> |
|
84 </ul> </section> |
|
85 </conbody></concept> |