diff options
Diffstat (limited to 'src/plugins/symbian/ecam/s60cameraviewfinderengine.h')
-rw-r--r-- | src/plugins/symbian/ecam/s60cameraviewfinderengine.h | 182 |
1 files changed, 182 insertions, 0 deletions
diff --git a/src/plugins/symbian/ecam/s60cameraviewfinderengine.h b/src/plugins/symbian/ecam/s60cameraviewfinderengine.h new file mode 100644 index 000000000..c5df760d9 --- /dev/null +++ b/src/plugins/symbian/ecam/s60cameraviewfinderengine.h @@ -0,0 +1,182 @@ +/**************************************************************************** +** +** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies). +** All rights reserved. +** Contact: Nokia Corporation (qt-info@nokia.com) +** +** This file is part of the Qt Mobility Components. +** +** $QT_BEGIN_LICENSE:LGPL$ +** No Commercial Usage +** This file contains pre-release code and may not be distributed. +** You may use this file in accordance with the terms and conditions +** contained in the Technology Preview License Agreement accompanying +** this package. +** +** GNU Lesser General Public License Usage +** Alternatively, this file may be used under the terms of the GNU Lesser +** General Public License version 2.1 as published by the Free Software +** Foundation and appearing in the file LICENSE.LGPL included in the +** packaging of this file. Please review the following information to +** ensure the GNU Lesser General Public License version 2.1 requirements +** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. +** +** In addition, as a special exception, Nokia gives you certain additional +** rights. These rights are described in the Nokia Qt LGPL Exception +** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. +** +** If you have questions regarding the use of this file, please contact +** Nokia at qt-info@nokia.com. +** +** +** +** +** +** +** +** +** $QT_END_LICENSE$ +** +****************************************************************************/ +#ifndef S60CAMERAVIEWFINDERENGINE_H +#define S60CAMERAVIEWFINDERENGINE_H + +#include <QtCore/qsize.h> +#include <QtGui/qpixmap.h> + +#include <qvideosurfaceformat.h> + +#include "s60cameraengineobserver.h" + +class CCameraEngine; +class S60CameraControl; +class QAbstractVideoSurface; + +// For DirectScreen ViewFinder +class RWsSession; +class CWsScreenDevice; +class RWindowBase; +class RWindow; +class QDesktopWidget; + +class S60VideoDisplay; + +/* + * Class implementing video output selection for the viewfinder and the handler of + * all common viewfinder operations. + */ +class S60CameraViewfinderEngine : public QObject, public MCameraViewfinderObserver +{ + Q_OBJECT + +public: // Enums + + /* + * Defines whether viewfinder output backend control is of type + * QVideoWidgetControl, QVideoRendererControl or QVideoWindowControl + */ + enum ViewfinderOutputType { + OutputTypeNotSet = 0, // No viewfinder output connected + OutputTypeVideoWidget, // Using QVideoWidget + OutputTypeRenderer, // (Using QGraphicsVideoItem with) QVideoRendererControl + OutputTypeVideoWindow // Using QGraphicsVideoItem with QVideoWindow + }; + +public: // Constructor & Destructor + + S60CameraViewfinderEngine(S60CameraControl *control, + CCameraEngine *engine, + QObject *parent = 0); + ~S60CameraViewfinderEngine(); + +public: // Methods + + // Setting Viewfinder Output + void setVideoWidgetControl(QObject *viewfinderOutput); + void setVideoRendererControl(QObject *viewfinderOutput); + void setVideoWindowControl(QObject *viewfinderOutput); + void releaseControl(ViewfinderOutputType type); + + // Controls + void startViewfinder(const bool internalStart = false); + void stopViewfinder(const bool internalStop = false); + + // Start using new CameraEngine + void setNewCameraEngine(CCameraEngine *engine); + +protected: // MCameraViewfinderObserver + + void MceoViewFinderFrameReady(CFbsBitmap& aFrame); + +private: // Internal operation + + void checkAndRotateCamera(); + +signals: + + void error(int error, const QString &errorString); + void viewFinderFrameReady(const CFbsBitmap &bitmap); + +private slots: + + void resetViewfinderSize(const QSize size); + void resetVideoWindowSize(); + void resetViewfinderDisplay(); + void viewFinderBitmapReady(const CFbsBitmap &bitmap); + void handleVisibilityChange(const bool isVisible); + void handleWindowChange(RWindow *handle); + void handleDesktopResize(int screen); + void handleContentAspectRatioChange(const QSize& newSize); + void rendererSurfaceSet(); + +private: // Enums + + /* + * Defines the internal state of the viewfinder. ViewFinder will only be + * started if output is connected to Camera and Camera is started (and + * ViewFinder widget is visible in case of QVideoWidget). + */ + enum ViewFinderState { + EVFNotConnectedNotStarted = 0, // 0 - No output connected, viewfinder is not started + EVFNotConnectedIsStarted, // 1 - No output connected, viewfinder is started + EVFIsConnectedNotStarted, // 2 - Output is connected, viewfinder is not started + EVFIsConnectedIsStartedNotVisible, // 3 - Output is connected, viewfinder is started but is not visible + EVFIsConnectedIsStartedIsVisible // 4 - Output is connected, viewfinder is started and is visible + }; + + /* + * The native type of ViewFinder. DirectScreen ViewFinder is used with + * QVideoWidget if support for it is available in the platform. For + * QGraphicsVideoItem Bitmap ViewFinder is always used. + */ + enum NativeViewFinderType { + EBitmapViewFinder = 0, + EDirectScreenViewFinder + }; + +private: // Data + + CCameraEngine *m_cameraEngine; + S60CameraControl *m_cameraControl; + QObject *m_viewfinderOutput; + S60VideoDisplay *m_viewfinderDisplay; + QAbstractVideoSurface *m_viewfinderSurface; // Used only by QVideoRendererControl + RWsSession &m_wsSession; + CWsScreenDevice &m_screenDevice; + RWindowBase *m_window; + QDesktopWidget *m_desktopWidget; + ViewFinderState m_vfState; + QSize m_viewfinderSize; + // Actual viewfinder size, which may differ from requested + // (m_viewfinderSize), if the size/aspect ratio was not supported. + QSize m_actualViewFinderSize; + qreal m_viewfinderAspectRatio; + ViewfinderOutputType m_viewfinderType; + NativeViewFinderType m_viewfinderNativeType; + QVideoSurfaceFormat m_surfaceFormat; // Used only by QVideoRendererControl + bool m_isViewFinderVisible; + bool m_uiLandscape; // For detecting UI rotation + int m_vfErrorsSignalled; +}; + +#endif // S60CAMERAVIEWFINDERENGINE_H |