readme.txt

Symbian UIQ的CameraTest.用于高端手机P800、P30、P31等。

TestCameraAppFixed.18.07.2003.zip README FILE
-------------------------------------------------------------------------------

This package contains a FIXED version of the TestCameraApp application and source code
as supplied by SonyEricsson in the ECAM2.ZIP package (the SonyEricsson p800 Camera API).

The original application is compeltely dysfunctional and ridden with bugs, so I collected
various fixes and improvement suggestions from Symbian-related forums into this package.

Since most developers seem to have difficulties with using this Camera API, I hope this
will help in overcoming the initial frustration. Please note that my intention was to
provide a set of MINIMAL changes to the original package so that it would work - I do 
NOT aim at producing a new demonstration package of the Camera API.

The changes I made are described in the list below. For more details, use the
WINDIFF application (available in e.g. Microsoft Visual Studio or the Internet ) 
or the 'grep' command against the original package.

1. Bitmap color depth

The original code uses full-color (24 bit bitmaps) but this does not work at all. The
API must be set to use 64K color depth.

2. The application UID

The UID value in MMP file appears to be different from the one use in the AIF resource
and the application header file (TestCameraApp.h).

3. Viewfinder drawing position

The original code draws the viewfinder outside application area and this is causing
all sorts of problems.

4. Clipping rectangle

Clipping functionality does not appear to work properly, so it is removed in this
package.

5. PKG file missing

I have added a PKG file so that you can actually create SIS files for easy transfer
to the P800.

6. Video capture is not functional

I have removed the dysfunctional option "Video Capture" from the menu.

7. "In Use" error when capturing images

The original application displays an "In Use" dialog every second time a picture is taken.
I have not been able to determined the precise cause of this, but I suspect it may have
to do something with the menu overlapping the viewfinder (window server invalidates the
drawing area), which results in the API returning an "In Use" error code. Moving the
viewfinder outside the menu area fixes the problem - in a real-world app the viewfinder 
would be stopped if a menu is displayed.

FINAL NOTES AND TIPS:

The TestCameraApp will not work properly on the emulator. On my P800, I also 
experience occasional TOTAL freezing of the camera driver/hardware so that only 
device restart works. For example, the viewfinder may suddenly become unavailable 
(even in the original P800 Cam app ) but capture works. I have not determined
whether this is due to the ECAM API, the particular P800 I happen to have 
or some other cause.

I am not affiliated with SonyEricsson. In case of any questions or further
improvement suggestions, please contact me at:

[e-mail]

-Pawel
-----------------------------------------------------------------------------