releasenotes.txt

这是在Symbian平台上,显示BMP以外的图片.

S60 Platform: Image Converter Example v2.0
-----------------------------------------
   
This example demonstrates how to use the image conversion APIs available in
the S60 platform (Image Conversion Library, ICL). These APIs include important 
classes such as CBitmapRotator and CBitmapScaler to be used for rotating and scaling 
images, respectively. CImageEncoder and CImageDecoder classes are used to access image
encoders and decoders available in the ICL.

With this example an image can be opened either from the device memory or a memory card 
(if present). Once opened, the image can be rotated, scaled, and saved in the same or a 
different format (for example, a JPG image can be converted into a GIF image).

-------------------------------------------------------------------------------

PREREQUISITES

- Symbian OS key concepts

--------------------------------------------------------------------------------

IMPORTANT CLASSES

CImageConverterEngine	| The main engine class, handles image conversion operations (rotating, 
			| scaling, encoding, and decoding) by using ICL classes CBitmapRotator, 
			| CBitmapScaler, CImageEncoder, and CImageDecoder. The engine class is an 
			| active object, since image conversion operations are asynchronous by nature.

--------------------------------------------------------------------------------

KNOWN ISSUES

- Some S60 2nd and 3rd Edition devices might not handle the FILENULL (FN) option in the .pkg file 
correctly. That is why it is not used in this example. If you want to include the australia.bmp test 
image in the installation package, follow the instructions in ImageConverter.pkg and 
ImageConverter_s60_3rd_ed.pkg. For more information on the known issue related to FILENULL in 2nd 
Edition devices, see the Forum Nokia Technical Library at 
http://www.forum.nokia.com/Technical_Library/FNTL/FILENULL_(FN)_installation_option_does_not_work.htm.

- Opening a JPEG image in a 3rd Edition device/emulator may result in "Not enough memory" error (error 
code -4). This can be avoided by increasing the size of the heap memory. This known issue is explained 
in more detail in the Forum Nokia Technical Library at 
http://www.forum.nokia.com/Technical_Library/FNTL/Not_enough_memory_error_when_decoding_progressive_JPEGs.htm.

--------------------------------------------------------------------------------

RUNNING THE EXAMPLE

Launch the Image Converter application on your device.
A canvas displaying the application name will appear and the
application is ready for use.

The operations of the application are controlled using the actions 
found in the Options menu. The menu contains different commands 
depending on the state of the application.

At first only two commands are shown in the menu: Open and Exit. 
If a memory card is present on the device when the user selects Open, 
a dialog prompting to choose the memory to be used appears. If the memory 
card is not present, the device memory will be used by default.

If the device memory is selected, the contents of the folder C:\Nokia 
(in 2nd Edition) or C:\Data (in 3rd Edition) are shown. If the memory card 
is selected, the contents of its root folder are shown.

The user can now search for a suitable image to be opened by browsing through 
the directories on the selected memory. Once the image is open, its properties 
can be viewed by selecting Options -> Info.

The image can be rotated and scaled by pressing the following keys:

- Right-arrow key: rotate clockwise
- Left-arrow key: rotate anti-clockwise
- Up-arrow key: zoom in
- Down-arrow key: zoom out

The image can be saved by selecting Options -> Save As. This will trigger a list
of supported image formats to be shown to the user. Choose the preferred format by
selecting it from the list and pressing OK. If a memory card is present on the device,
a dialog prompting to select the target memory (device or memory card) is shown.

Once the target memory is selected, browse to a suitable directory and press Save.
Type in a file name of your choice and press OK. Note: the file extension will 
be appended automatically to the file name according to the selected image format. 
For example, if you chose the JPEG format and type in a file name "MyImage", the 
resulting file will be named "MyImage.JPEG".

--------------------------------------------------------------------------------

BUILD & INSTALLATION INSTRUCTIONS

MOBILE DEVICE (S60 3rd Edition)
------------------
    Go to /ImageConverterExample/group
    bldmake bldfiles
    abld build gcce urel
    Go to /ImageConverterExample/sis
    Edit the ImageConverter_s60_3rd_ed.pkg's paths to match those on your system.
    - If you want to include the australia.bmp test image in the installation package, remove the 
      semicolon (';') from the beginning of the last line in ImageConverter_s60_3rd_ed.pkg. If you
      do so, you will need to manually remove the image file from your device after uninstalling this 
      example application. For more information, refer to ImageConverter_s60_3rd_ed.pkg.

    makesis ImageConverter_s60_3rd_ed.pkg
    
    Sign the SIS package:
	Sign the sis file (find out more about signing the sis file and 
        developer certificate from www.symbiansigned.com):
        signsis ImageConverter_s60_3rd_ed.sis ImageConverter3rdEd.sis YourCertificate.cer 
           YourKey.key YourPassword

    Install the signed .sis file to an S60 3rd Edition device.
    - If you get a "Certificate error" during the installation of a self-signed 
      package, check that App.Manager -> Settings -> Software Installation is 
      set to "All". 

MOBILE DEVICE (S60 2nd Edition)
------------------
    Go to /ImageConverterExample/group
    bldmake bldfiles
    abld build thumb urel
    Go to /ImageConverterExample/sis
    Edit the ImageConverter.pkg's paths to match those on your system.
    - If you want to include the australia.bmp test image in the installation package, remove the 
      semicolon (';') from the beginning of the last line in ImageConverter.pkg. If you do so, you 
      will need to manually remove the image file from your device after uninstalling this example 
      application. For more information, refer to ImageConverter.pkg.

    makesis ImageConverter.pkg

    Install the .sis file to your device.

EMULATOR
------------------
    Go to /ImageConverterExample/group
    bldmake bldfiles
    abld build wins udeb
    Note: Ensure that the /ImageConverterExample/data/australia.bmp file
   	has been copied to /epoc32/winscw/c/Data/australia.bmp (in S60 3rd Edition) or 
	/epoc32/winscw/c/Nokia/australia.bmp (in S60 2nd Edition) in your SDK installation 
	directory. This image can be used as a test image when running the example 
	application.

    Start the emulator.

--------------------------------------------------------------------------------

COMPATIBILITY

S60 3rd Edition
S60 2nd Edition

TESTED WITH Nokia 6670, Nokia 6630, Nokia N90, Nokia E60, Nokia E61
Created / tested with Series 60 2nd Edition SDK for Symbian OS, Supporting Feature Pack 2, 
for C++, Supporting Metrowerks CodeWarrior and 
S60 3rd Edition SDK for Symbian OS, for C++, Supporting Metrowerks CodeWarrior

--------------------------------------------------------------------------------

VERSION HISTORY

2.0	Support for S60 3rd Edition added. Slight modifications to CImageConverterAppUi::HandleSaveAsL 
	so that the correct file extension will be added automatically when an image is being saved. 
	Furthermore, info messages are now shown to the user using CAknGlobalNote::ShowNoteL() instead 
	of CEikonEnv::InfoMsg().

1.0	First release.

--------------------------------------------------------------------------------
EVALUATE THIS RESOURCE

Please spare a moment to help us improve documentation quality and 
recognize the examples you find most valuable, by rating this resource at
http://www.forum.nokia.com/main/1%2C%2C90%2C00.html?surveyId=e79aecf5-8fef-4732-8918-fe0e0089d325/S60_Platform_Image_Converter_Example_v2_0_en.zip