|
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-7594A012-166F-5F10-A3ED-256465B4623E-GENID-1-6-1-17-1-1-5-1-6-1-5-1-4-1" xml:lang="en"><title>ImageConv: |
|
13 Image Converter Library example code</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <section><title>Description</title> <p> <filepath>ImageConv</filepath> demonstrates |
|
15 the Image Converter Library API. It shows how to: </p> <ul> |
|
16 <li id="GUID-55E51EE6-7A9D-53BB-91A7-08A5E9F23287-GENID-1-6-1-17-1-1-5-1-6-1-5-1-4-1-2-1-3-1"><p>read standard graphics |
|
17 formats (such as <filepath>.bmp</filepath> or <filepath>.gif</filepath>) into <codeph>CFbsBitmap</codeph> objects, |
|
18 from where they can be manipulated and rendered to the screen </p> </li> |
|
19 <li id="GUID-B01F3820-4E04-5841-92FD-400F3B0095C4-GENID-1-6-1-17-1-1-5-1-6-1-5-1-4-1-2-1-3-2"><p>save <codeph>CFbsBitmap</codeph> objects |
|
20 as files, using a number of formats </p> </li> |
|
21 <li id="GUID-56B18DF3-2125-570E-8C33-7FA334821BC1-GENID-1-6-1-17-1-1-5-1-6-1-5-1-4-1-2-1-3-3"><p>rotate, flip, and zoom |
|
22 images </p> </li> |
|
23 </ul> <p>The Image Converter API is called by an engine class <codeph>CImageHandler</codeph>. |
|
24 The UI class, <codeph>CImageAppUi</codeph>, supplies a dialog that allows |
|
25 the user to choose a particular frame from a multi-frame image (such as an |
|
26 animated .gif), and a dialog that allows the user to save the current image |
|
27 in a particular format. </p> </section> |
|
28 <section><title>Download</title> <p>Click on the following link to download |
|
29 the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-dc5f26e3-7c69-43ef-b3f1-c62469891d0d.zip" scope="external"> ImageConv.zip file</xref></p><p>Click: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-dc5f26e3-7c69-43ef-b3f1-c62469891d0d.html" scope="peer">browse </xref>to view the example code. </p> </section> |
|
30 <section><title>Class summary</title><p> <xref href="GUID-683A1D42-2764-3EB7-BD19-9E12559199AB.dita"><apiname>CFbsBitmap </apiname></xref> <xref href="GUID-5D8DD5A8-1913-3B3F-A4D9-71C7834DA041.dita"><apiname>RImageTypeDescriptionArray </apiname></xref> <xref href="GUID-A1C5A447-6A11-35ED-BF4C-27525D775CC1.dita"><apiname>TFileSaveDialogOptions </apiname></xref> <xref href="GUID-0AEE5955-C530-35F1-A904-69183331B294.dita"><apiname>CWindowGc </apiname></xref> <xref href="GUID-7A6A6EFD-F0DB-3747-9418-A423A613250A.dita"><apiname> TFrameInfo </apiname></xref> <xref href="GUID-F87784F6-3736-30F0-8F4D-358E95553263.dita"><apiname>MImageHandlerCallback </apiname></xref> <xref href="GUID-E263C747-946F-35AA-9F1D-41833BD350FC.dita"><apiname>RFs </apiname></xref> <xref href="GUID-2008D827-A84A-3170-A8BD-86002BA37979.dita"><apiname>CBitmapScaler </apiname></xref> <xref href="GUID-D0835677-6790-3038-8893-83E7186F47E7.dita"><apiname> CBitmapRotator </apiname></xref> </p></section> |
|
31 <section><title>Build</title> <p>The source code for this example application |
|
32 can be found in the directory: </p> <p> <filepath>examples\MultiMedia\ImageConv\</filepath> </p> <p>It |
|
33 may be in the directory in which you installed the Symbian platform, or it |
|
34 may be in <filepath>src\common\developerlibrary\</filepath>. It includes the |
|
35 two project files needed for building: <filepath>bld.inf</filepath> and the <filepath>.mmp</filepath> file. </p> <p><xref href="GUID-3100800B-B2F7-50EF-BD4C-3C345ECCB2A5.dita">The Symbian build process</xref> describes |
|
36 how to build this application. For the emulator, an application called <filepath>ImageConv.exe</filepath> is |
|
37 created in <filepath>epoc32\release\winscw\<udeb or urel>\</filepath>. </p> </section> |
|
38 <section><title>Usage</title> <ol id="GUID-90CDEC0A-390D-5AD0-BBE6-D1F493B5743B-GENID-1-6-1-17-1-1-5-1-6-1-5-1-4-1-2-5-2"> |
|
39 <li id="GUID-EEA05011-4252-56CC-A26D-B271CF77876F-GENID-1-6-1-17-1-1-5-1-6-1-5-1-4-1-2-5-2-1"><p>Launch the emulator: </p> <p> <filepath>\epoc32\release\winscw\<urel |
|
40 or udeb>\EPOC.EXE</filepath>. </p> </li> |
|
41 <li id="GUID-3DFED3A0-2F2A-5F82-9AEE-6274E22B7C24-GENID-1-6-1-17-1-1-5-1-6-1-5-1-4-1-2-5-2-2"><p>Click on <systemoutput>IMAGECONV</systemoutput> to |
|
42 run the application. If using the <i>TechView</i> emulator, this will be in |
|
43 the <i>Extras</i> menu. </p> </li> |
|
44 <li id="GUID-DD60B267-1B5A-5DB0-988F-ABC812F90D09-GENID-1-6-1-17-1-1-5-1-6-1-5-1-4-1-2-5-2-3"><p>A collection of sample |
|
45 files of different formats is included. See the <filepath>readme.txt</filepath> in <filepath>ImageConv\samples\</filepath> for |
|
46 notes on the characteristics of each sample file. </p> </li> |
|
47 <li id="GUID-00E564F7-101B-5E70-A1F2-C19A46D9EBFE-GENID-1-6-1-17-1-1-5-1-6-1-5-1-4-1-2-5-2-4"><p>Commands are given to |
|
48 the example through its File and Image menus. The commands are: </p> <ul> |
|
49 <li id="GUID-BA1E30DD-2E07-5E7E-9A10-24FB0EFA8D29-GENID-1-6-1-17-1-1-5-1-6-1-5-1-4-1-2-5-2-4-2-1"><p> Open file: opens a |
|
50 graphics file and converts it into a displayable <codeph>CFbsBitmap</codeph> object </p> </li> |
|
51 <li id="GUID-C25672B9-A1F0-568B-9199-B84D9E6F67FD-GENID-1-6-1-17-1-1-5-1-6-1-5-1-4-1-2-5-2-4-2-2"><p> Save as: saves the |
|
52 current bitmap (<codeph>CFbsBitmap</codeph> object) in a selectable format </p> </li> |
|
53 <li id="GUID-3DD92262-C30D-5FCE-9EF0-4117DC9E4BBB-GENID-1-6-1-17-1-1-5-1-6-1-5-1-4-1-2-5-2-4-2-3"><p> Zoom in and Zoom out: |
|
54 zooms the current image </p> </li> |
|
55 <li id="GUID-007F9B35-D47D-569B-B995-ADAF8F3C265E-GENID-1-6-1-17-1-1-5-1-6-1-5-1-4-1-2-5-2-4-2-4"><p> Rotate clockwise and |
|
56 Rotate anti-clockwise: rotates the current image </p> </li> |
|
57 <li id="GUID-F5DD31E4-0FCB-514C-A93C-B0D00A403074-GENID-1-6-1-17-1-1-5-1-6-1-5-1-4-1-2-5-2-4-2-5"><p> Mirror produces a mirror |
|
58 image </p> </li> |
|
59 <li id="GUID-4A9C8D09-424C-57C5-A344-A3208ABFB0F4-GENID-1-6-1-17-1-1-5-1-6-1-5-1-4-1-2-5-2-4-2-6"><p> Flip turns the image |
|
60 upside-down </p> </li> |
|
61 <li id="GUID-1218EE55-E825-524F-9230-C8059CD18007-GENID-1-6-1-17-1-1-5-1-6-1-5-1-4-1-2-5-2-4-2-7"><p> Refresh: reloads the |
|
62 image from file </p> </li> |
|
63 <li id="GUID-C8F94BBB-E5A2-50F9-B521-1A042B7BB306-GENID-1-6-1-17-1-1-5-1-6-1-5-1-4-1-2-5-2-4-2-8"><p> Select frame: selects |
|
64 a frame from a multi-frame image </p> </li> |
|
65 </ul> </li> |
|
66 </ol> </section> |
|
67 </conbody></concept> |