mwindow.h

Go to the documentation of this file.

/***************************************************************************
**
** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation (directui@nokia.com)
**
** This file is part of libmeegotouch.
**
** If you have questions regarding the use of this file, please contact
** Nokia at directui@nokia.com.
**
** This library is free software; you can redistribute it and/or
** modify it 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.
**
****************************************************************************/

#ifndef MWINDOW_H
#define MWINDOW_H

#include "mexport.h"
#include "mnamespace.h"

#include <QGraphicsView>

class MWindowPrivate;
class MWidget;
class MOrientationChangeParameters;
class MScene;
class MSceneManager;
class MOnDisplayChangeEvent;

class M_CORE_EXPORT MWindow : public QGraphicsView
{

    Q_OBJECT
    Q_PROPERTY(bool orientationAngleLocked READ isOrientationAngleLocked WRITE setOrientationAngleLocked)
    Q_PROPERTY(bool orientationLocked READ isOrientationLocked WRITE setOrientationLocked)

    Q_PROPERTY(qreal globalAlpha READ globalAlpha WRITE setGlobalAlpha)

    Q_PROPERTY(qreal videoGlobalAlpha READ videoGlobalAlpha WRITE setVideoGlobalAlpha)

public:
    explicit MWindow(QWidget *parent = 0);

    explicit MWindow(MSceneManager *sceneManager,
                       QWidget *parent = 0);

    virtual ~MWindow();

    void setTranslucentBackground(bool enabled);

    void setGlobalAlpha(qreal level);

    qreal globalAlpha();

    void setVideoGlobalAlpha(qreal level);

    qreal videoGlobalAlpha();

    MScene *scene();

    void setSceneManager(MSceneManager *sceneManager);

    MSceneManager *sceneManager() const;

    MSceneManager *sceneManager();

    M::Orientation orientation() const;

    M::OrientationAngle orientationAngle() const;

    QSize visibleSceneSize(M::Orientation) const;

    QSize visibleSceneSize() const;

    bool isOrientationAngleLocked() const;

    void setOrientationAngleLocked(bool locked);

    bool isOrientationLocked() const;

    void setOrientationLocked(bool locked);

    bool isOnDisplay() const;

    bool isInSwitcher() const;

    void setCloseOnLazyShutdown(bool enable);

    bool closeOnLazyShutdown() const;

public Q_SLOTS:
    void setOrientationAngle(M::OrientationAngle angle);

    void setLandscapeOrientation();

    void setPortraitOrientation();

    void lockOrientationAngle();

    void unlockOrientationAngle();

    void lockOrientation();

    void unlockOrientation();

Q_SIGNALS:
    void orientationAngleChanged(M::OrientationAngle);

    void orientationChanged(M::Orientation);

    void orientationChangeFinished(M::Orientation);

    void displayEntered();

    void displayExited();

    void switcherEntered();

    void switcherExited();

protected:
    bool event(QEvent *event);
    virtual void paintEvent(QPaintEvent *event);

    virtual void onDisplayChangeEvent(MOnDisplayChangeEvent *event);

    virtual void enterDisplayEvent();

    virtual void exitDisplayEvent();

    explicit MWindow(MWindowPrivate &dd, QWidget *parent = 0);
    explicit MWindow(MWindowPrivate &dd, MScene *scene, QWidget *parent = 0);
    explicit MWindow(MWindowPrivate &dd, MSceneManager *sceneManager, QWidget *parent = 0);

    virtual void setVisible(bool visible);

    MWindowPrivate *const d_ptr;

private:
    Q_DISABLE_COPY(MWindow)
    Q_DECLARE_PRIVATE(MWindow)
    Q_PRIVATE_SLOT(d_func(), void _q_onPixmapRequestsFinished())
    Q_PRIVATE_SLOT(d_func(), void _q_enablePaintUpdates())
    Q_PRIVATE_SLOT(d_func(), void _q_exitDisplayStabilized())
#ifdef HAVE_GCONF
    Q_PRIVATE_SLOT(d_func(), void _q_updateMinimizedSoftwareSwitch())
#endif

    friend class MApplicationPrivate;
    friend class MSceneManagerPrivate;
#ifdef UNIT_TEST
    // to call orientationAngleChanged()
    friend class Ut_MWindow;
    friend class Ut_MSceneManager;
#endif
};

#endif