684b4b635e
Summary: So far we were following a bit unique and rare doxygen comment style: /** * Contents of the comment. **/ Doxygen comments with this style look balanced and neat, but many people that contribute to KWin don't follow this style. Instead, they prefer more traditional doxygen comment style, i.e. /** * Contents of the comment. */ Reviewing such changes has been a bit frustrating for me (so selfish!) and for other contributors. This change switches doxygen comment style in KWin to a more traditional style. The main reason for doing this is to make code review process easier for new contributors as well us. Reviewers: #kwin, davidedmundson Reviewed By: #kwin, davidedmundson Subscribers: kwin Tags: #kwin Differential Revision: https://phabricator.kde.org/D22812
259 lines
7.6 KiB
C++
259 lines
7.6 KiB
C++
/********************************************************************
|
|
KWin - the KDE window manager
|
|
This file is part of the KDE project.
|
|
|
|
Copyright (C) 2013, 2016 Martin Gräßlin <mgraesslin@kde.org>
|
|
Copyright (C) 2018 Roman Gilg <subdiff@gmail.com>
|
|
Copyright (C) 2019 Vlad Zagorodniy <vladzzag@gmail.com>
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 2 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*********************************************************************/
|
|
#ifndef KWIN_POINTER_INPUT_H
|
|
#define KWIN_POINTER_INPUT_H
|
|
|
|
#include "input.h"
|
|
|
|
#include <QElapsedTimer>
|
|
#include <QObject>
|
|
#include <QPointer>
|
|
#include <QPointF>
|
|
|
|
class QWindow;
|
|
|
|
namespace KWayland
|
|
{
|
|
namespace Server
|
|
{
|
|
class SurfaceInterface;
|
|
}
|
|
}
|
|
|
|
namespace KWin
|
|
{
|
|
class CursorImage;
|
|
class InputRedirection;
|
|
class Toplevel;
|
|
class WaylandCursorTheme;
|
|
class CursorShape;
|
|
|
|
namespace Decoration
|
|
{
|
|
class DecoratedClientImpl;
|
|
}
|
|
|
|
namespace LibInput
|
|
{
|
|
class Device;
|
|
}
|
|
|
|
class KWIN_EXPORT PointerInputRedirection : public InputDeviceHandler
|
|
{
|
|
Q_OBJECT
|
|
public:
|
|
explicit PointerInputRedirection(InputRedirection *parent);
|
|
~PointerInputRedirection() override;
|
|
|
|
void init() override;
|
|
|
|
void updateAfterScreenChange();
|
|
bool supportsWarping() const;
|
|
void warp(const QPointF &pos);
|
|
|
|
QPointF pos() const {
|
|
return m_pos;
|
|
}
|
|
Qt::MouseButtons buttons() const {
|
|
return m_qtButtons;
|
|
}
|
|
bool areButtonsPressed() const;
|
|
|
|
QImage cursorImage() const;
|
|
QPoint cursorHotSpot() const;
|
|
void markCursorAsRendered();
|
|
void setEffectsOverrideCursor(Qt::CursorShape shape);
|
|
void removeEffectsOverrideCursor();
|
|
void setWindowSelectionCursor(const QByteArray &shape);
|
|
void removeWindowSelectionCursor();
|
|
|
|
void updatePointerConstraints();
|
|
|
|
void setEnableConstraints(bool set);
|
|
|
|
bool isConstrained() const {
|
|
return m_confined || m_locked;
|
|
}
|
|
|
|
bool focusUpdatesBlocked() override;
|
|
|
|
/**
|
|
* @internal
|
|
*/
|
|
void processMotion(const QPointF &pos, uint32_t time, LibInput::Device *device = nullptr);
|
|
/**
|
|
* @internal
|
|
*/
|
|
void processMotion(const QPointF &pos, const QSizeF &delta, const QSizeF &deltaNonAccelerated, uint32_t time, quint64 timeUsec, LibInput::Device *device);
|
|
/**
|
|
* @internal
|
|
*/
|
|
void processButton(uint32_t button, InputRedirection::PointerButtonState state, uint32_t time, LibInput::Device *device = nullptr);
|
|
/**
|
|
* @internal
|
|
*/
|
|
void processAxis(InputRedirection::PointerAxis axis, qreal delta, qint32 discreteDelta, InputRedirection::PointerAxisSource source, uint32_t time, LibInput::Device *device = nullptr);
|
|
/**
|
|
* @internal
|
|
*/
|
|
void processSwipeGestureBegin(int fingerCount, quint32 time, KWin::LibInput::Device *device = nullptr);
|
|
/**
|
|
* @internal
|
|
*/
|
|
void processSwipeGestureUpdate(const QSizeF &delta, quint32 time, KWin::LibInput::Device *device = nullptr);
|
|
/**
|
|
* @internal
|
|
*/
|
|
void processSwipeGestureEnd(quint32 time, KWin::LibInput::Device *device = nullptr);
|
|
/**
|
|
* @internal
|
|
*/
|
|
void processSwipeGestureCancelled(quint32 time, KWin::LibInput::Device *device = nullptr);
|
|
/**
|
|
* @internal
|
|
*/
|
|
void processPinchGestureBegin(int fingerCount, quint32 time, KWin::LibInput::Device *device = nullptr);
|
|
/**
|
|
* @internal
|
|
*/
|
|
void processPinchGestureUpdate(qreal scale, qreal angleDelta, const QSizeF &delta, quint32 time, KWin::LibInput::Device *device = nullptr);
|
|
/**
|
|
* @internal
|
|
*/
|
|
void processPinchGestureEnd(quint32 time, KWin::LibInput::Device *device = nullptr);
|
|
/**
|
|
* @internal
|
|
*/
|
|
void processPinchGestureCancelled(quint32 time, KWin::LibInput::Device *device = nullptr);
|
|
|
|
private:
|
|
void cleanupInternalWindow(QWindow *old, QWindow *now) override;
|
|
void cleanupDecoration(Decoration::DecoratedClientImpl *old, Decoration::DecoratedClientImpl *now) override;
|
|
|
|
void focusUpdate(Toplevel *focusOld, Toplevel *focusNow) override;
|
|
|
|
QPointF position() const override;
|
|
|
|
void updateOnStartMoveResize();
|
|
void updateToReset();
|
|
void updatePosition(const QPointF &pos);
|
|
void updateButton(uint32_t button, InputRedirection::PointerButtonState state);
|
|
void warpXcbOnSurfaceLeft(KWayland::Server::SurfaceInterface *surface);
|
|
QPointF applyPointerConfinement(const QPointF &pos) const;
|
|
void disconnectConfinedPointerRegionConnection();
|
|
void disconnectLockedPointerAboutToBeUnboundConnection();
|
|
void disconnectPointerConstraintsConnection();
|
|
void breakPointerConstraints(KWayland::Server::SurfaceInterface *surface);
|
|
CursorImage *m_cursor;
|
|
bool m_supportsWarping;
|
|
QPointF m_pos;
|
|
QHash<uint32_t, InputRedirection::PointerButtonState> m_buttons;
|
|
Qt::MouseButtons m_qtButtons;
|
|
QMetaObject::Connection m_focusGeometryConnection;
|
|
QMetaObject::Connection m_internalWindowConnection;
|
|
QMetaObject::Connection m_constraintsConnection;
|
|
QMetaObject::Connection m_constraintsActivatedConnection;
|
|
QMetaObject::Connection m_confinedPointerRegionConnection;
|
|
QMetaObject::Connection m_lockedPointerAboutToBeUnboundConnection;
|
|
QMetaObject::Connection m_decorationGeometryConnection;
|
|
bool m_confined = false;
|
|
bool m_locked = false;
|
|
bool m_enableConstraints = true;
|
|
};
|
|
|
|
class CursorImage : public QObject
|
|
{
|
|
Q_OBJECT
|
|
public:
|
|
explicit CursorImage(PointerInputRedirection *parent = nullptr);
|
|
~CursorImage() override;
|
|
|
|
void setEffectsOverrideCursor(Qt::CursorShape shape);
|
|
void removeEffectsOverrideCursor();
|
|
void setWindowSelectionCursor(const QByteArray &shape);
|
|
void removeWindowSelectionCursor();
|
|
|
|
QImage image() const;
|
|
QPoint hotSpot() const;
|
|
void markAsRendered();
|
|
|
|
Q_SIGNALS:
|
|
void changed();
|
|
|
|
private:
|
|
void reevaluteSource();
|
|
void update();
|
|
void updateServerCursor();
|
|
void updateDecoration();
|
|
void updateDecorationCursor();
|
|
void updateMoveResize();
|
|
void updateDrag();
|
|
void updateDragCursor();
|
|
void loadTheme();
|
|
struct Image {
|
|
QImage image;
|
|
QPoint hotSpot;
|
|
};
|
|
void loadThemeCursor(CursorShape shape, Image *image);
|
|
void loadThemeCursor(const QByteArray &shape, Image *image);
|
|
template <typename T>
|
|
void loadThemeCursor(const T &shape, QHash<T, Image> &cursors, Image *image);
|
|
|
|
enum class CursorSource {
|
|
LockScreen,
|
|
EffectsOverride,
|
|
MoveResize,
|
|
PointerSurface,
|
|
Decoration,
|
|
DragAndDrop,
|
|
Fallback,
|
|
WindowSelector
|
|
};
|
|
void setSource(CursorSource source);
|
|
|
|
PointerInputRedirection *m_pointer;
|
|
CursorSource m_currentSource = CursorSource::Fallback;
|
|
WaylandCursorTheme *m_cursorTheme = nullptr;
|
|
struct {
|
|
QMetaObject::Connection connection;
|
|
QImage image;
|
|
QPoint hotSpot;
|
|
} m_serverCursor;
|
|
|
|
Image m_effectsCursor;
|
|
Image m_decorationCursor;
|
|
QMetaObject::Connection m_decorationConnection;
|
|
Image m_fallbackCursor;
|
|
Image m_moveResizeCursor;
|
|
Image m_windowSelectionCursor;
|
|
QHash<CursorShape, Image> m_cursors;
|
|
QHash<QByteArray, Image> m_cursorsByName;
|
|
QElapsedTimer m_surfaceRenderedTimer;
|
|
struct {
|
|
Image cursor;
|
|
QMetaObject::Connection connection;
|
|
} m_drag;
|
|
};
|
|
|
|
}
|
|
|
|
#endif
|