KisQQuickWidget Class Reference

The KisQQuickWidget class. More...

#include <KisQQuickWidget.h>

Inheritance diagram for KisQQuickWidget:

Public Member Functions
void	connectMinimumHeightToRootObject ()
	connectMinimumHeightToRootObject By default we scale rootObject to widget, but in some situations we need the widget to have the minimum required height of the root object. This sets up a connection that links the minimum height to the root object implicitHeight.
void	connectMinimumWidthToRootObject ()
	connectMinimumWidthToRootObject Same as for connectMinimumHeightToRootObject, but then for width.
	KisQQuickWidget (QWidget *parent=nullptr)
	~KisQQuickWidget ()

Private Slots
void	setMinimumHeightFromRoot ()
void	setMinimumWidthFromRoot ()
void	updatePaletteFromConfig ()

Detailed Description

The KisQQuickWidget class.

The purpose of KisQQuickWidget is to tackle a number of configuration steps that need to be taken when using the QQuickWidget, amongst which the setup of the engine.

Definition at line 20 of file KisQQuickWidget.h.

Constructor & Destructor Documentation

KisQQuickWidget()

KisQQuickWidget::KisQQuickWidget

(

QWidget *

parent = nullptr

)

Our version of Qt has a special handling of the color space passed to the surface of the QQuickWidget. It will allow it to render correctly on a Rec2020PQ window.

WARNING: The following selector is only for KisQQuickWidget. Do not copy it to other engines.

Definition at line 22 of file KisQQuickWidget.cpp.

                                               : QQuickWidget(parent)
{
#if !defined(Q_OS_MACOS) || QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
    QSurfaceFormat format;
 
    {
        format.setRedBufferSize(8);
        format.setGreenBufferSize(8);
        format.setBlueBufferSize(8);
        format.setAlphaBufferSize(8);
        format.setColorSpace(KisSurfaceColorSpaceWrapper::makeSRGBColorSpace());
    }
 
    setFormat(format);
#endif
 
    engine()->rootContext()->setContextProperty("mainWindow", parent);
    engine()->rootContext()->setContextObject(new KLocalizedContext(parent));
 
    // Clear color is the 'default background color', which, in qwidget context is the window bg.
    setClearColor(palette().window().color());
    connect(KisConfigNotifier::instance(), SIGNAL(signalColorThemeChanged(QString)), this, SLOT(updatePaletteFromConfig()));
 
    // Default to fusion style unless the user forces another style
    const QString fusion = "Fusion";
    if (qEnvironmentVariableIsEmpty("QT_QUICK_CONTROLS_STYLE") && QQuickStyle::name() != fusion) {
         QQuickStyle::setStyle(fusion);
    }
 
    engine()->addImportPath(KoResourcePaths::getApplicationRoot() + "/lib/qml/");
    engine()->addImportPath(KoResourcePaths::getApplicationRoot() + "/lib64/qml/");
 
    engine()->addPluginPath(KoResourcePaths::getApplicationRoot() + "/lib/qml/");
    engine()->addPluginPath(KoResourcePaths::getApplicationRoot() + "/lib64/qml/");
 
    QQmlFileSelector* selector = new QQmlFileSelector(engine());
    QStringList extraSelectors;
    /*
     * This allows for Style specific components, which it'll load from
     * a "+StyleName" folder.
     */
    extraSelectors << QQuickStyle::name();
#if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
    extraSelectors << "qt6";
#elif QT_VERSION < QT_VERSION_CHECK(6, 0, 0)
    extraSelectors << "qt5";
#endif
    extraSelectors << "qquickwidget";
 
    selector->setExtraSelectors(extraSelectors);
 
 
    setResizeMode(QQuickWidget::SizeRootObjectToView);
}

References KoResourcePaths::getApplicationRoot(), KisConfigNotifier::instance(), KisSurfaceColorSpaceWrapper::makeSRGBColorSpace(), palette, and updatePaletteFromConfig().

~KisQQuickWidget()

KisQQuickWidget::~KisQQuickWidget

(

)

Prevent accessing destroyed objects in QML engine See:

• https://invent.kde.org/graphics/krita/-/commit/d8676f4e9cac1a8728e73fec3ff1df1763c713b7
• https://bugreports.qt.io/browse/QTBUG-81247

Definition at line 86 of file KisQQuickWidget.cpp.

{
    setParent(nullptr);
}

Member Function Documentation

connectMinimumHeightToRootObject()

void KisQQuickWidget::connectMinimumHeightToRootObject

(

)

connectMinimumHeightToRootObject By default we scale rootObject to widget, but in some situations we need the widget to have the minimum required height of the root object. This sets up a connection that links the minimum height to the root object implicitHeight.

Definition at line 95 of file KisQQuickWidget.cpp.

{
    if (rootObject()) {
        connect(rootObject(), SIGNAL(implicitHeightChanged()), this, SLOT(setMinimumHeightFromRoot()));
        setMinimumHeightFromRoot();
    }
}

References setMinimumHeightFromRoot().

connectMinimumWidthToRootObject()

void KisQQuickWidget::connectMinimumWidthToRootObject

(

)

connectMinimumWidthToRootObject Same as for connectMinimumHeightToRootObject, but then for width.

Definition at line 103 of file KisQQuickWidget.cpp.

{
    if (rootObject()) {
        connect(rootObject(), SIGNAL(implicitWidthChanged()), this, SLOT(setMinimumWidthFromRoot()));
        setMinimumWidthFromRoot();
    }
}

References setMinimumWidthFromRoot().

setMinimumHeightFromRoot

void KisQQuickWidget::setMinimumHeightFromRoot ( )

privateslot

Definition at line 116 of file KisQQuickWidget.cpp.

{
    if (rootObject()) {
        setMinimumHeight(rootObject()->implicitHeight());
    }
}

setMinimumWidthFromRoot

void KisQQuickWidget::setMinimumWidthFromRoot ( )

privateslot

Definition at line 123 of file KisQQuickWidget.cpp.

{
    if (rootObject()) {
        setMinimumWidth(rootObject()->implicitWidth());
    }
}

updatePaletteFromConfig

void KisQQuickWidget::updatePaletteFromConfig ( )

privateslot

Definition at line 111 of file KisQQuickWidget.cpp.

{
    setClearColor(palette().window().color());
}

References palette.

---

The documentation for this class was generated from the following files:

• qmlmodules/widgets/KisQQuickWidget.h
• qmlmodules/widgets/KisQQuickWidget.cpp