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

Jump to: navigation, search

Revision as of 05:49, 13 December 2011

文章信息

代码示例

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

文章

由 zhouhl 在 Zhouhl 创建

最后由 hamishwillee 在 13 Dec 2011 编辑

本文需要更新: 如果您发现这篇文章有用，请修复下面的问题，然后从文章中删除 {{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的所有源码以及例程都可以通过本文末尾所附链接下载。本例程大部分源码得益于Mobile Extensions for Qt for Symbian，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中这一问题会得到改善。

@@ Line 1: / Line 1: @@
+[[Category:Symbian]][[Category:Lang-Chinese]][[Category:Qt Mobility]][[Category:Camera]]
 {{ArticleMetaData
 |sourcecode=[[Media:testOfCameraApiOnN8(2).zip]] [[Media:testOfCameraApiOnN8(3).zip]]
@@ Line 22: / Line 23: @@
 |author=[[User:Zhouhl]]
 }}
+{{ArticleNeedsUpdate|language=Lang-Chinese|timestamp=20111213024922|user=[[User:Hamishwillee|&lt;br /&gt;----]]|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.}}
-[[Category:Qt]][[Category:Symbian]]
 == 概述 ==
 标准Qt API没有为我们提供操纵Symbian设备的相机的接口，包括现在的Qt Mobility 1.0.2也没有为我们提供相应的接口。Qt Mobility 1.1倒是包含了camera的部分，不过现在的Qt Mobility 1.1还只是一个Technology Preview版本。
@@ Line 249: / Line 250: @@
 ==相关链接==
 *[[Qt_开发|Qt 开发]]
-[[Category:Lang-Chinese]][[Category:Qt]]

Wiki

Wiki Resources

Main Platforms

Other

Natural Languages

Toolbox

Namespaces

Variants

Views

Actions

Contents