不通过Qt Mobility操纵Symbian设备的相机

Jump to: navigation, search

Latest revision as of 04:23, 11 October 2012

文章信息

代码示例

源文件: Media:testOfCameraApiOnN8(2).zip Media:testOfCameraApiOnN8(3).zip

文章

由 zhouhl 在 05 Sep 2010 创建

最后由 hamishwillee 在 11 Oct 2012 编辑

本文需要更新: 如果您发现这篇文章有用，请修复下面的问题，然后从文章中删除 {{ArticleNeedsUpdate}} 模板，以消除此警告。

原因: hamishwillee
 (13 Dec 2011)
Article is out of date and requires either an update or to be deleted (specifically, I believe that the limitations presented are not present in the current version of Qt.

概述

标准Qt API没有为我们提供操纵Symbian设备的相机的接口，包括现在的Qt Mobility 1.0.2也没有为我们提供相应的接口。Qt Mobility 1.1倒是包含了camera的部分，不过现在的Qt Mobility 1.1还只是一个Technology Preview版本。

本文将通过另一种方式为大家提供一种Symbian设备上的Qt camera API，它不使用Qt Mobility，直接封装的是Symbian代码。此camera API的所有源码以及例程都可以通过本文末尾所附链接下载。本例程大部分源码得益于Archived:Mobile Extensions，S60 Platform: Camera Example v3.0，以及Liuxg的指导，在此一并表示感谢。

下面就具体为大家讲解如何使用这个camera API。

将API源码加入工程

首先，解压附件testOfCameraApiOnN8.zip 得到testOfCameraApiOnN8文件夹，将testOfCameraApiOnN8文件夹里的cameraX文件夹整体拷贝到当前Qt工程的根目录。
然后修改pro文件，将API源码添加进去：

SOURCES +=  cameraX\xqviewfinderwidget.cpp \
            cameraX\xqviewfinderwidget_p.cpp \
            cameraX\xqcamera.cpp \
            cameraX\xqcamera_p.cpp\
            cameraX\xqutils.cpp \
            cameraX\xqutils_p.cpp \
            cameraX\xqconversions.cpp
 
HEADERS +=  cameraX\xqviewfinderwidget.h \
            cameraX\xqviewfinderwidget_p.h \
            cameraX\xqcamera.h \
            cameraX\xqcamera_p.h \
            cameraX\xqutils.h \
            cameraX\xqutils_p.h \
            cameraX\xqconversions.h

接着继续修改pro文件，把API所用到的公共Symbian库文件添加进去：

    LIBS += -lfbscli\
        -lapmime \
        -lcommonui \
        -lplatformenv \
        -lcharconv

将API所依赖的CameraWrapper加入SDK和device

由于API中用到了并未加入公版SDK的Symbian库，所以我们需要手动加入，不过也很简单，我们可以让程序在编译的时候自动替我们加上。
首先将testOfCameraApiOnN8文件夹里的cameraengineWrapper文件夹整体拷贝到当前Qt工程的根目录。
然后先向SDK加入所依赖的头文件和库：

    BLD_INF_RULES.prj_exports += \                                                                                       
    	"cameraengineWrapper\InstallToSDK\epoc32\include\cameraengine.h                \epoc32\include\cameraengine.h"  \
    	"cameraengineWrapper\InstallToSDK\epoc32\include\cameraengineobserver.h        \epoc32\include\cameraengineobserver.h"  \    
    	"cameraengineWrapper\InstallToSDK\epoc32\release\armv5\lib\camerawrapper.dso             \epoc32\release\armv5\lib\camerawrapper.dso"  \  
    	"cameraengineWrapper\InstallToSDK\epoc32\release\armv5\lib\camerawrapper.lib             \epoc32\release\armv5\lib\camerawrapper.lib"  \  
    	"cameraengineWrapper\InstallToSDK\epoc32\release\armv5\lib\camerawrapper{000a0000}.dso   \epoc32\release\armv5\lib\camerawrapper{000a0000}.dso"  \  
    	"cameraengineWrapper\InstallToSDK\epoc32\release\armv5\lib\camerawrapper{000a0000}.lib   \epoc32\release\armv5\lib\camerawrapper{000a0000}.lib"  \  
    	"cameraengineWrapper\InstallToSDK\epoc32\release\armv5\urel\camerawrapper.dll            \epoc32\release\armv5\urel\camerawrapper.dll"  \  
    	"cameraengineWrapper\InstallToSDK\epoc32\release\armv5\urel\camerawrapper.dll.map        \epoc32\release\armv5\urel\camerawrapper.dll.map"  \  
    	"cameraengineWrapper\InstallToSDK\epoc32\release\winscw\udeb\CamAutoFocus.dll            \epoc32\release\winscw\udeb\CamAutoFocus.dll"  \  
    	"cameraengineWrapper\InstallToSDK\epoc32\release\winscw\udeb\camerawrapper.dll           \epoc32\release\winscw\udeb\camerawrapper.dll"  \  
    	"cameraengineWrapper\InstallToSDK\epoc32\release\winscw\udeb\camerawrapper.lib           \epoc32\release\winscw\udeb\camerawrapper.lib"  \

再将CameraWrapper一起打包入SIS：

cameraengineEmbeddedsis.pkg_postrules = "@\"cameraengineWrapper\InstallToDevice\camerawrapper.sisx\",(0x2001EC5F)"
DEPLOYMENT += cameraengineEmbeddedsis

最后将CameraWrapper库链接到我们自己的Qt工程：

    LIBS += -lcamerawrapper

在代码中使用camera API

好了，经过上述步骤，我们终于成功的做完了所有准备工作，下面就可以使用这个camera API了。
首先在需要使用camera的地方引入API头文件：

#include "xqcamera.h"

在需要显示camera所捕获图像的地方引入API头文件：

#include "xqviewfinderwidget.h"

接下来就可以创建一个XQCamera对象，以及对应的XQViewFinderWidget。XQViewFinderWidget是用于显示XQCamera所捕获的图像的一个QWidget。然后记得把创建的XQCamera对象赋给XQViewFinderWidget，使他们之间建立对应关系。

viewFinderWidget->setCamera(*m_camera);

可以通过XQViewFinderWidget来设置viewfinder的尺寸，viewfinder的尺寸和呈现在手机屏幕上的取景画面直接相关。例如我们可以设置：

viewFinderWidget->setViewfinderSize(QSize(128, 96));

打开相机，使用：

bool XQCamera::open(int index);

当camera被成功打开，并且可以使用的时候，XQCamera 会发送一个 cameraReady() 的signal 。
参数index表示要打开哪一个相机，比如N97上就有两个相机，默认是0。如果返回值为false，表明发生了错误，我们可以调用error()来获取具体是那种错误。

打开相机之后，我们需要等待 cameraReady()信号，如果camera没有ready，我们是没办法使用相机的。
当我们收到cameraReady()信号之后，我们就可以启动Viewfinder了，调用bool XQViewFinderWidget::start()，例如我们可以这样做：

connect(m_camera, SIGNAL(cameraReady()), viewFinderWidget, SLOT(start()));

bool XQViewFinderWidget::start()所做的是启动Viewfinder。

Viewfinder启动后的就会不间断将camera所捕获的图像传递给XQViewFinderWidget，并在UI界面上显示出来。

拍照，使用：

bool XQCamera::capture();

此函数令camera开始拍照，当图像拍好之后，XQCamera会发送一个captureCompleted()的 signal。
如果返回值为false，表明发生了错误，我们可以调用error()来获取具体是那种错误。

我们可以这样捕获 captureCompleted()信号：

connect(m_camera, SIGNAL(captureCompleted(QImage*)), this, SLOT(captured(QImage*)));

收到 captureCompleted()的信号之后，我们就可以进行自己的处理了，首先必须要做的是要停止viewfinder，然后通常是将拍摄的画面显示在屏幕上，例如：

void testOfCameraApiOnN8MainWindow::captured(QImage* snapImage)
{
    ui->viewFinderWidget->stop();
 
    m_image = QPixmap::fromImage(snapImage->copy()).toImage();
    m_camera->releaseImageBuffer();
    ui->viewFinderWidget->setImage(m_image);
 
    m_captureAction->setDisabled(true);
    m_changeCameraAction->setDisabled(true);
    m_focusAction->setDisabled(true);
    m_newPhotoAction->setEnabled(true);
    m_saveAction->setEnabled(true);
    ui->captureButton->setDisabled(true);
}

拍摄完之后，我们也许还想存一下照片，不用担心，本例程中同样包含了保存照片的例子代码，并且还额外提供了一个非常方便的用于打开文件的类XQUtils。好了，到此一个拍摄的过程就基本结束了，我们可以一直这么循环拍摄下去，直到用户退出程序。

一定要记得退出程序需要做的清理工作：

void XQCamera::close();

此函数释放程序对camera的占用，并power off相机。

可以改进的地方

需要注意的是在API的源码中，也就是在XQCameraPrivate中，使用了一个iCaptureSize(QSize(640, 480))，这里的size不同于viewfinder的size，这个size指的是所拍摄照片的尺寸。这个程序里面是写死的，我们可以进行更改，比如如果相机硬件支持更大尺寸的照片，我们可以设置的更大一些，比如：

XQCameraPrivate::XQCameraPrivate(XQCamera* qq) : q(qq), iCaptureSize(QSize(1280, 960))
{
}

另外取景的图片我们也是可以设置得更大一些，从而使得取景的画面更清晰一些，例如：

viewFinderWidget->setViewfinderSize(QSize(480, 360));

不过需要注意的是硬件必须要支持这么大尺寸，比如N8是没问题的，其他相机可以酌情更换其他尺寸。此外如果大家觉得这个API封装的不好，那么也可以自己进行改进，源码都提供给大家了。

测试设备

本代码已通过在N97、N8上的测试。
下面是程序在N97上运行时的截图：

下载源码和例子程序

把cameraWrapper作为embedded SIS加入工程的实现：

Media:testOfCameraApiOnN8(2).zip

直接使用cameraEngine源码的实现：

Media:testOfCameraApiOnN8(3).zip

注意事项

这里要特别提醒大家，如果目标设备是N8，那么就要特别注意选择一个恰当的时间做打开camera的操作。虽说Qt是跨平台的，但是针对特定的设备还是会有细微差别，这要取决于设备上所用的Qt版本。

在目前的Qt实现中，系统显示所涉及的东西（还有QPixmap等）都是全部存放在graphics memory中的，据测算一张1058 x 1058的图片完全解码后在graphics memory中会占用约4.3MB的空间。由于打开Camera之后ViewFinderWidget会不断收到相机发来的图片，进而ViewFinderWidget需要paint这些图片，这些要显示的图片都在graphics memory中进行处理，因此稍不注意，或者发生冲突graphics memory就会被耗尽，从而出现打不开Camera的表面现象。

我们的解决办法是：打开camera的操作要避开系统显示相关的操作。

比如我们不能在showEvent中直接m_camera->open(0)，但是我们可以在Widget show 完之后发一个消息进行打开Camera的操作，正如例子程序中所用的方法。或者大家可以这么做

QTimer::singleShot(1000, this, SLOT(openCamera()));

也就是说延迟一两秒之后再打开Camera，这样避免和系统的显示操作发生冲突。这样就基本可以解决问题了。

N8上用的是Qt 4.6.4，据称在将来发布的Qt 4.7.1中这一问题会得到改善。

Wiki

Wiki Resources

Main Platforms

Other

Natural Languages

Toolbox

Namespaces

Variants

Views

Actions

Contents