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
179 lines
4.7 KiB
C++
179 lines
4.7 KiB
C++
/********************************************************************
|
|
KWin - the KDE window manager
|
|
This file is part of the KDE project.
|
|
|
|
Copyright (C) 2013, 2016, 2017 Martin Gräßlin <mgraesslin@kde.org>
|
|
|
|
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_XKB_H
|
|
#define KWIN_XKB_H
|
|
#include "input.h"
|
|
|
|
#include <kwin_export.h>
|
|
|
|
#include <KSharedConfig>
|
|
|
|
#include <QLoggingCategory>
|
|
Q_DECLARE_LOGGING_CATEGORY(KWIN_XKB)
|
|
|
|
struct xkb_context;
|
|
struct xkb_keymap;
|
|
struct xkb_state;
|
|
struct xkb_compose_table;
|
|
struct xkb_compose_state;
|
|
typedef uint32_t xkb_mod_index_t;
|
|
typedef uint32_t xkb_led_index_t;
|
|
typedef uint32_t xkb_keysym_t;
|
|
typedef uint32_t xkb_layout_index_t;
|
|
|
|
namespace KWayland
|
|
{
|
|
namespace Server
|
|
{
|
|
class SeatInterface;
|
|
}
|
|
}
|
|
|
|
namespace KWin
|
|
{
|
|
|
|
class KWIN_EXPORT Xkb : public QObject
|
|
{
|
|
Q_OBJECT
|
|
public:
|
|
Xkb(QObject *parent = nullptr);
|
|
~Xkb() override;
|
|
void setConfig(KSharedConfigPtr config) {
|
|
m_config = config;
|
|
}
|
|
void setNumLockConfig(KSharedConfigPtr config) {
|
|
m_numLockConfig = config;
|
|
}
|
|
void reconfigure();
|
|
|
|
void installKeymap(int fd, uint32_t size);
|
|
void updateModifiers(uint32_t modsDepressed, uint32_t modsLatched, uint32_t modsLocked, uint32_t group);
|
|
void updateKey(uint32_t key, InputRedirection::KeyboardKeyState state);
|
|
xkb_keysym_t toKeysym(uint32_t key);
|
|
xkb_keysym_t currentKeysym() const {
|
|
return m_keysym;
|
|
}
|
|
QString toString(xkb_keysym_t keysym);
|
|
Qt::Key toQtKey(xkb_keysym_t keysym) const;
|
|
xkb_keysym_t fromQtKey(Qt::Key key, Qt::KeyboardModifiers mods) const;
|
|
xkb_keysym_t fromKeyEvent(QKeyEvent *event) const;
|
|
Qt::KeyboardModifiers modifiers() const;
|
|
Qt::KeyboardModifiers modifiersRelevantForGlobalShortcuts() const;
|
|
bool shouldKeyRepeat(quint32 key) const;
|
|
|
|
void switchToNextLayout();
|
|
void switchToPreviousLayout();
|
|
void switchToLayout(xkb_layout_index_t layout);
|
|
|
|
enum class LED {
|
|
NumLock = 1 << 0,
|
|
CapsLock = 1 << 1,
|
|
ScrollLock = 1 << 2
|
|
};
|
|
Q_DECLARE_FLAGS(LEDs, LED)
|
|
LEDs leds() const {
|
|
return m_leds;
|
|
}
|
|
|
|
xkb_keymap *keymap() const {
|
|
return m_keymap;
|
|
}
|
|
|
|
xkb_state *state() const {
|
|
return m_state;
|
|
}
|
|
|
|
quint32 currentLayout() const {
|
|
return m_currentLayout;
|
|
}
|
|
QString layoutName() const;
|
|
QMap<xkb_layout_index_t, QString> layoutNames() const;
|
|
quint32 numberOfLayouts() const;
|
|
|
|
/**
|
|
* Forwards the current modifier state to the Wayland seat
|
|
*/
|
|
void forwardModifiers();
|
|
|
|
void setSeat(KWayland::Server::SeatInterface *seat);
|
|
|
|
Q_SIGNALS:
|
|
void ledsChanged(const LEDs &leds);
|
|
|
|
private:
|
|
xkb_keymap *loadKeymapFromConfig();
|
|
xkb_keymap *loadDefaultKeymap();
|
|
void updateKeymap(xkb_keymap *keymap);
|
|
void createKeymapFile();
|
|
void updateModifiers();
|
|
void updateConsumedModifiers(uint32_t key);
|
|
QString layoutName(xkb_layout_index_t layout) const;
|
|
xkb_context *m_context;
|
|
xkb_keymap *m_keymap;
|
|
xkb_state *m_state;
|
|
xkb_mod_index_t m_shiftModifier;
|
|
xkb_mod_index_t m_capsModifier;
|
|
xkb_mod_index_t m_controlModifier;
|
|
xkb_mod_index_t m_altModifier;
|
|
xkb_mod_index_t m_metaModifier;
|
|
xkb_mod_index_t m_numModifier;
|
|
xkb_led_index_t m_numLock;
|
|
xkb_led_index_t m_capsLock;
|
|
xkb_led_index_t m_scrollLock;
|
|
Qt::KeyboardModifiers m_modifiers;
|
|
Qt::KeyboardModifiers m_consumedModifiers;
|
|
xkb_keysym_t m_keysym;
|
|
quint32 m_currentLayout = 0;
|
|
|
|
struct {
|
|
xkb_compose_table *table = nullptr;
|
|
xkb_compose_state *state = nullptr;
|
|
} m_compose;
|
|
LEDs m_leds;
|
|
KSharedConfigPtr m_config;
|
|
KSharedConfigPtr m_numLockConfig;
|
|
|
|
struct {
|
|
xkb_mod_index_t depressed = 0;
|
|
xkb_mod_index_t latched = 0;
|
|
xkb_mod_index_t locked = 0;
|
|
} m_modifierState;
|
|
|
|
enum class Ownership {
|
|
Server,
|
|
Client
|
|
};
|
|
Ownership m_ownership = Ownership::Server;
|
|
|
|
QPointer<KWayland::Server::SeatInterface> m_seat;
|
|
};
|
|
|
|
inline
|
|
Qt::KeyboardModifiers Xkb::modifiers() const
|
|
{
|
|
return m_modifiers;
|
|
}
|
|
|
|
}
|
|
|
|
Q_DECLARE_METATYPE(KWin::Xkb::LED)
|
|
Q_DECLARE_METATYPE(KWin::Xkb::LEDs)
|
|
|
|
#endif
|