forked from quickshell/quickshell
136 lines
3.8 KiB
C++
136 lines
3.8 KiB
C++
#pragma once
|
|
|
|
#include <qobject.h>
|
|
#include <qqmlengine.h>
|
|
#include <qqmlintegration.h>
|
|
#include <qqmllist.h>
|
|
#include <qquickitem.h>
|
|
#include <qregion.h>
|
|
#include <qtmetamacros.h>
|
|
#include <qtypes.h>
|
|
|
|
///! Shape of a Region.
|
|
/// See @@Region.shape.
|
|
namespace RegionShape { // NOLINT
|
|
Q_NAMESPACE;
|
|
QML_ELEMENT;
|
|
|
|
enum Enum {
|
|
Rect = 0,
|
|
Ellipse = 1,
|
|
};
|
|
Q_ENUM_NS(Enum);
|
|
|
|
} // namespace RegionShape
|
|
|
|
///! Intersection strategy for Regions.
|
|
/// See @@Region.intersection.
|
|
namespace Intersection { // NOLINT
|
|
Q_NAMESPACE;
|
|
QML_ELEMENT;
|
|
|
|
enum Enum {
|
|
/// Combine this region, leaving a union of this and the other region. (opposite of `Subtract`)
|
|
Combine = 0,
|
|
/// Subtract this region, cutting this region out of the other. (opposite of `Combine`)
|
|
Subtract = 1,
|
|
/// Create an intersection of this region and the other, leaving only
|
|
/// the area covered by both. (opposite of `Xor`)
|
|
Intersect = 2,
|
|
/// Create an intersection of this region and the other, leaving only
|
|
/// the area not covered by both. (opposite of `Intersect`)
|
|
Xor = 3,
|
|
};
|
|
Q_ENUM_NS(Enum);
|
|
|
|
} // namespace Intersection
|
|
|
|
///! A composable region used as a mask.
|
|
/// See @@QsWindow.mask.
|
|
class PendingRegion: public QObject {
|
|
Q_OBJECT;
|
|
/// Defaults to `Rect`.
|
|
Q_PROPERTY(RegionShape::Enum shape MEMBER mShape NOTIFY shapeChanged);
|
|
/// The way this region interacts with its parent region. Defaults to `Combine`.
|
|
Q_PROPERTY(Intersection::Enum intersection MEMBER mIntersection NOTIFY intersectionChanged);
|
|
|
|
/// The item that determines the geometry of the region.
|
|
/// `item` overrides @@x, @@y, @@width and @@height.
|
|
Q_PROPERTY(QQuickItem* item MEMBER mItem WRITE setItem NOTIFY itemChanged);
|
|
|
|
/// Defaults to 0. Does nothing if @@item is set.
|
|
Q_PROPERTY(qint32 x MEMBER mX NOTIFY xChanged);
|
|
/// Defaults to 0. Does nothing if @@item is set.
|
|
Q_PROPERTY(qint32 y MEMBER mY NOTIFY yChanged);
|
|
/// Defaults to 0. Does nothing if @@item is set.
|
|
Q_PROPERTY(qint32 width MEMBER mWidth NOTIFY widthChanged);
|
|
/// Defaults to 0. Does nothing if @@item is set.
|
|
Q_PROPERTY(qint32 height MEMBER mHeight NOTIFY heightChanged);
|
|
|
|
/// Regions to apply on top of this region.
|
|
///
|
|
/// Regions can be nested to create a more complex region.
|
|
/// For example this will create a square region with a cutout in the middle.
|
|
/// ```qml
|
|
/// Region {
|
|
/// width: 100; height: 100;
|
|
///
|
|
/// Region {
|
|
/// x: 50; y: 50;
|
|
/// width: 50; height: 50;
|
|
/// intersection: Intersection.Subtract
|
|
/// }
|
|
/// }
|
|
/// ```
|
|
Q_PROPERTY(QQmlListProperty<PendingRegion> regions READ regions);
|
|
Q_CLASSINFO("DefaultProperty", "regions");
|
|
QML_NAMED_ELEMENT(Region);
|
|
|
|
public:
|
|
explicit PendingRegion(QObject* parent = nullptr);
|
|
|
|
void setItem(QQuickItem* item);
|
|
|
|
QQmlListProperty<PendingRegion> regions();
|
|
|
|
[[nodiscard]] bool empty() const;
|
|
[[nodiscard]] QRegion build() const;
|
|
[[nodiscard]] QRegion applyTo(QRegion& region) const;
|
|
|
|
RegionShape::Enum mShape = RegionShape::Rect;
|
|
Intersection::Enum mIntersection = Intersection::Combine;
|
|
|
|
signals:
|
|
void shapeChanged();
|
|
void intersectionChanged();
|
|
void itemChanged();
|
|
void xChanged();
|
|
void yChanged();
|
|
void widthChanged();
|
|
void heightChanged();
|
|
void childrenChanged();
|
|
void changed();
|
|
|
|
private slots:
|
|
void onItemDestroyed();
|
|
void onChildDestroyed();
|
|
|
|
private:
|
|
static void regionsAppend(QQmlListProperty<PendingRegion>* prop, PendingRegion* region);
|
|
static PendingRegion* regionAt(QQmlListProperty<PendingRegion>* prop, qsizetype i);
|
|
static void regionsClear(QQmlListProperty<PendingRegion>* prop);
|
|
static qsizetype regionsCount(QQmlListProperty<PendingRegion>* prop);
|
|
static void regionsRemoveLast(QQmlListProperty<PendingRegion>* prop);
|
|
static void
|
|
regionsReplace(QQmlListProperty<PendingRegion>* prop, qsizetype i, PendingRegion* region);
|
|
|
|
QQuickItem* mItem = nullptr;
|
|
|
|
qint32 mX = 0;
|
|
qint32 mY = 0;
|
|
qint32 mWidth = 0;
|
|
qint32 mHeight = 0;
|
|
|
|
QList<PendingRegion*> mRegions;
|
|
};
|