#include <kis_splash_screen.h>

Inheritance diagram for KisSplashScreen:

Classes
struct	Source

Public Member Functions
void	displayLinks (bool show)

void	displayRecentFiles (bool show)

	KisSplashScreen (bool themed=false, QWidget *parent=0, Qt::WindowFlags f=Qt::WindowFlags())

void	repaint ()

void	setLoadingText (QString text)

void	show ()

Static Public Member Functions
static Source	getImageSource ()

Protected Member Functions
void	resizeEvent (QResizeEvent *event) override

Private Slots
void	linkClicked (const QString &link)

void	toggleShowAtStartup (bool toggle)

Private Member Functions
QString	colorString () const

void	updateSplashImage ()

void	updateText ()

Private Attributes
QLabel *	m_artCreditsLabel

QSvgWidget *	m_bannerSvg

QSvgWidget *	m_brandingSvg

bool	m_displayLinks { false }

QLabel *	m_loadingTextLabel

bool	m_themed

QTimer	m_timer

QString	m_versionHtml

Detailed Description

Definition at line 20 of file kis_splash_screen.h.

Constructor & Destructor Documentation

◆ KisSplashScreen()

KisSplashScreen::KisSplashScreen	(	bool	themed = false,
		QWidget *	parent = 0,
		Qt::WindowFlags	f = Qt::WindowFlags() )

explicit

Definition at line 44 of file kis_splash_screen.cpp.

    : QWidget(parent, Qt::SplashScreen | Qt::FramelessWindowHint | f)
      , m_themed(themed)
      , m_versionHtml(qApp->applicationVersion().toHtmlEscaped())
{
 
    setupUi(this);
#ifndef Q_OS_MACOS
    setWindowIcon(KisIconUtils::loadIcon("krita-branding"));
#endif
 
    m_loadingTextLabel = new QLabel(lblSplash);
    m_loadingTextLabel->setTextFormat(Qt::RichText);
    m_loadingTextLabel->setStyleSheet(QStringLiteral("QLabel { color: #fff; background-color: transparent; }"));
    m_loadingTextLabel->setAlignment(Qt::AlignRight | Qt::AlignTop);
    addDropShadow(m_loadingTextLabel);
 
    m_brandingSvg = new QSvgWidget(QStringLiteral(":/krita-branding.svgz"), lblSplash);
    m_bannerSvg = new QSvgWidget(QStringLiteral(":/splash/banner.svg"), lblSplash);
    addDropShadow(m_bannerSvg);
 
    m_artCreditsLabel = new QLabel(lblSplash);
    m_artCreditsLabel->setTextFormat(Qt::PlainText);
    m_artCreditsLabel->setStyleSheet(QStringLiteral("QLabel { color: #fff; background-color: transparent; font: 10pt; }"));
    m_artCreditsLabel->setAlignment(Qt::AlignRight | Qt::AlignBottom);
    addDropShadow(m_artCreditsLabel);
 
    updateSplashImage();
    setLoadingText(QString());
 
    bnClose->hide();
    connect(bnClose, SIGNAL(clicked()), this, SLOT(close()));
    chkShowAtStartup->hide();
    connect(chkShowAtStartup, SIGNAL(toggled(bool)), this, SLOT(toggleShowAtStartup(bool)));
 
    KConfigGroup cfg( KSharedConfig::openConfig(), "SplashScreen");
    bool hideSplash = cfg.readEntry("HideSplashAfterStartup", false);
    chkShowAtStartup->setChecked(hideSplash);
 
    connect(lblRecent, SIGNAL(linkActivated(QString)), SLOT(linkClicked(QString)));
    connect(&m_timer, SIGNAL(timeout()), SLOT(raise()));
 
    // hide these labels by default
    displayLinks(false);
    displayRecentFiles(false);
 
    m_timer.setSingleShot(true);
    m_timer.start(10);
}

References addDropShadow(), displayLinks(), displayRecentFiles(), linkClicked(), KisIconUtils::loadIcon(), m_artCreditsLabel, m_bannerSvg, m_brandingSvg, m_loadingTextLabel, m_timer, setLoadingText(), toggleShowAtStartup(), and updateSplashImage().

Member Function Documentation

◆ colorString()

QString KisSplashScreen::colorString ( ) const

private

Definition at line 300 of file kis_splash_screen.cpp.

{
    QString color = "#FFFFFF";
    if (m_themed && qApp->palette().window().color().value() > 100) {
        color = "#000000";
    }
 
    return color;
}

References m_themed.

◆ displayLinks()

void KisSplashScreen::displayLinks ( bool show )

Definition at line 202 of file kis_splash_screen.cpp.

                                            {
 
    if (show) {
        QString color = colorString();
        QStringList lblLinksText;
        lblLinksText    << "<html>"
                        << "<head/>"
                        << "<body><table style=\"width:100%\" cellpadding=\"30\"><tr><td>"
                        << i18n("<p><span style=\" color:%1;\"><b>Using Krita</b></span></p>",color);
 
#ifdef Q_OS_MACOS
        // macOS store version should not contain external links containing donation buttons or forms
        if (!KisMacosEntitlements().sandbox()) {
#endif
 
            lblLinksText    << i18n("<p><a href=\"https://krita.org/support-us/\"><span style=\" text-decoration: underline; color:%1;\">Support Krita's Development!</span></a></p>",color)
                            << i18n("<p><a href=\"https://krita.org/\"><span style=\" text-decoration: underline; color:%1;\">Krita Website</span></a></p>",color);
#ifdef Q_OS_MACOS
        }
#endif
        lblLinksText    << i18n("<p><a href=\"https://docs.krita.org/en/user_manual/getting_started.html\"><span style=\" text-decoration: underline; color:%1;\">Getting Started</span></a></p>",color)
                        << i18n("<p><a href=\"https://docs.krita.org/\"><span style=\" text-decoration: underline; color:%1;\">Manual</span></a></p>",color)
                        << "</td><td>"
                        << i18n("<p><span style=\" color:%1;\"><b>Coding Krita</b></span></p>",color)
                        << i18n("<p><a href=\"https://krita-artists.org\"><span style=\" text-decoration: underline; color:%1;\">User Community</span></a></p>",color)
                        << i18n("<p><a href=\"https://invent.kde.org/graphics/krita\"><span style=\" text-decoration: underline; color:%1;\">Source Code</span></a></p>",color)
                        << i18n("<p><a href=\"https://api.kde.org/krita/html/classKrita.html\"><span style=\" text-decoration: underline; color:%1;\">Scripting API</span></a></p>",color)
                        << i18n("<p><a href=\"https://scripting.krita.org/lessons/introduction\"><span style=\" text-decoration: underline; color:%1;\">Scripting School</span></a></p>",color)
                        << "</td></tr></table></body>"
                        << "</html>";
 
 
        lblLinks->setTextFormat(Qt::RichText);
        lblLinks->setText(lblLinksText.join(""));
 
        filesLayout->setContentsMargins(10,10,10,10);
        actionControlsLayout->setContentsMargins(5,5,5,5);
 
    } else {
        // eliminating margins here allows for the splash screen image to take the entire area with nothing underneath
        filesLayout->setContentsMargins(0,0,0,0);
        actionControlsLayout->setContentsMargins(0,0,0,0);
    }
 
    lblLinks->setVisible(show);
 
    updateText();
 
    if (m_displayLinks != show) {
        m_displayLinks = show;
        updateSplashImage();
    }
}

References colorString(), m_displayLinks, show(), updateSplashImage(), and updateText().

◆ displayRecentFiles()

void KisSplashScreen::displayRecentFiles ( bool show )

Definition at line 257 of file kis_splash_screen.cpp.

                                                  {
    lblRecent->setVisible(show);
    line->setVisible(show);
}

References show().

◆ getImageSource()

KisSplashScreen::Source KisSplashScreen::getImageSource ( )

static

Definition at line 271 of file kis_splash_screen.cpp.

{
    QString artistCredit = i18nc("Normal splash artist name", "Tyson Tan");
    // Loading the ginormous 4K PNG splash image increases the startup time on
    // Android by several seconds and at the same time looks really bad when
    // scaled down to a dinky size. Instead of overengineering this into an
    // Enterprise Splash Screen Solution where we choose the image based on
    // screen size or something, we'll just use a HD JPEG instead. It's fine.
#ifdef Q_OS_ANDROID
    QString resourcePath = QStringLiteral(":/splash/hd.jpg");
#else
    QString resourcePath = QStringLiteral(":/splash/0.png");
    // TODO: Re-add the holiday splash...
#if 0
    QDate currentDate = QDate::currentDate();
    if (currentDate > QDate(currentDate.year(), 12, 4) ||
            currentDate < QDate(currentDate.year(), 1, 9)) {
        resourcePath = QStringLiteral(":/splash/1.png");
        artistCredit = QStringLiteral("???")};
    }
#endif
#endif
    if (!artistCredit.isEmpty()) {
        artistCredit = i18nc("splash image credit", "Artwork by: %1", artistCredit);
    }
    return Source{resourcePath, artistCredit};
}

◆ linkClicked

void KisSplashScreen::linkClicked ( const QString & link )

privateslot

Definition at line 355 of file kis_splash_screen.cpp.

{
    KisPart::instance()->openExistingFile(link);
    if (isWindow()) {
        close();
    }
}

References KisPart::instance(), and KisPart::openExistingFile().

◆ repaint()

void KisSplashScreen::repaint ( )

Definition at line 311 of file kis_splash_screen.cpp.

{
    QWidget::repaint();
    qApp->sendPostedEvents();
}

◆ resizeEvent()

void KisSplashScreen::resizeEvent ( QResizeEvent * event )

overrideprotected

Definition at line 154 of file kis_splash_screen.cpp.

{
    QWidget::resizeEvent(event);
    updateText();
}

References updateText().

◆ setLoadingText()

void KisSplashScreen::setLoadingText ( QString text )

Definition at line 262 of file kis_splash_screen.cpp.

{
    int larger = 12;
    int notAsLarge = larger - 1;
    QString htmlText = QStringLiteral("<span style='font: %3pt;'><span style='font: bold %4pt;'>%1</span><br><i>%2</i></span>")
            .arg(m_versionHtml, text.toHtmlEscaped(), QString::number(notAsLarge), QString::number(larger));
    m_loadingTextLabel->setText(htmlText);
}

References m_loadingTextLabel, and m_versionHtml.

◆ show()

void KisSplashScreen::show ( )

Definition at line 317 of file kis_splash_screen.cpp.

{
    if (!this->parentWidget()) {
        this->winId(); // Force creation of native window
        QWindow *windowHandle = this->windowHandle();
        QScreen *screen = windowHandle ? windowHandle->screen() : nullptr;
        if (windowHandle && !screen) {
            // At least on Windows, the window may be created on a non-primary
            // screen with a different scale factor. If we don't explicitly
            // move it to the primary screen, the position will be scaled with
            // the wrong factor and the splash will be offset.
            // XXX: In theory this branch should be unreachable, but leaving
            //      this here just in case.
            windowHandle->setScreen(QApplication::primaryScreen());
        }
        if (!screen) {
            screen = QApplication::primaryScreen();
        }
        // Reinitialize the splash image as the screen may have a different
        // devicePixelRatio.
        updateSplashImage();
        QRect r(QPoint(), size());
        move(screen->availableGeometry().center() - r.center());
    }
    if (isVisible()) {
        repaint();
    }
    m_timer.setSingleShot(true);
    m_timer.start(1);
    QWidget::show();
}

References m_timer, repaint(), and updateSplashImage().

◆ toggleShowAtStartup

void KisSplashScreen::toggleShowAtStartup ( bool toggle )

privateslot

Definition at line 349 of file kis_splash_screen.cpp.

{
    KConfigGroup cfg( KSharedConfig::openConfig(), "SplashScreen");
    cfg.writeEntry("HideSplashAfterStartup", toggle);
}

◆ updateSplashImage()

void KisSplashScreen::updateSplashImage ( )

private

Definition at line 94 of file kis_splash_screen.cpp.

{
    constexpr int SPLASH_HEIGHT_LOADING = 480;
    constexpr int SPLASH_HEIGHT_ABOUT = 320;
 
    int splashHeight;
    if (m_displayLinks) {
        splashHeight = SPLASH_HEIGHT_ABOUT;
    } else {
        splashHeight = SPLASH_HEIGHT_LOADING;
    }
    const int bannerHeight = splashHeight * 0.16875;
    const int marginTop = splashHeight * 0.05;
    const int marginRight = splashHeight * 0.1;
 
    Source source = getImageSource();
    QPixmap img(source.resourcePath);
 
    if (img.isNull() || img.height() == 0) return;
 
    // Preserve aspect ratio of splash.
    const int height = splashHeight;
    const int width = height * img.width() / img.height();
 
    setFixedWidth(width);
    setFixedHeight(height);
    lblSplash->setFixedWidth(width);
    lblSplash->setFixedHeight(height);
 
    // Get a downscaled pixmap of the splash.
    const int pixelWidth = width * devicePixelRatioF();
    const int pixelHeight = height * devicePixelRatioF();
    img = img.scaled(pixelWidth, pixelHeight, Qt::KeepAspectRatioByExpanding, Qt::SmoothTransformation);
    img.setDevicePixelRatio(devicePixelRatioF());
    lblSplash->setPixmap(img);
 
    // Align banner to top-left with margin.
    m_bannerSvg->setFixedHeight(bannerHeight);
    m_bannerSvg->setFixedWidth(bannerHeight * m_bannerSvg->sizeHint().width() / m_bannerSvg->sizeHint().height());
    m_bannerSvg->move(width - m_bannerSvg->width() - marginRight, marginTop);
 
    // Place logo to the left of banner.
    m_brandingSvg->setFixedSize(bannerHeight, bannerHeight);
    m_brandingSvg->move(m_bannerSvg->x() - m_brandingSvg->width(), marginTop);
 
    // Place loading text immediately below.
    m_loadingTextLabel->move(marginRight, m_brandingSvg->geometry().bottom());
    m_loadingTextLabel->setFixedWidth(m_bannerSvg->geometry().right() - marginRight);
 
    // Place credits text on bottom right with similar margins.
    m_artCreditsLabel->setText(source.artistCredit);
    m_artCreditsLabel->setFixedWidth(m_loadingTextLabel->width());
    m_artCreditsLabel->setFixedHeight(20);
    m_artCreditsLabel->move(m_loadingTextLabel->x(), height - marginTop - m_artCreditsLabel->height());
 
    if (m_displayLinks) {
        setFixedSize(sizeHint());
    }
}

References getImageSource(), m_artCreditsLabel, m_bannerSvg, m_brandingSvg, m_displayLinks, m_loadingTextLabel, and source().

◆ updateText()

void KisSplashScreen::updateText ( )

private

Definition at line 160 of file kis_splash_screen.cpp.

{
    QString color = colorString();
 
    KConfigGroup cfg2( KSharedConfig::openConfig(), "RecentFiles");
    int i = 1;
 
    QString recent = i18n("<html>"
                          "<head/>"
                          "<body>"
                          "<p><b><span style=\" color:%1;\">Recent Files</span></b></p>", color);
 
    QString path;
    QStringList recentfiles;
 
    QFontMetrics metrics(lblRecent->font());
 
    do {
        path = cfg2.readPathEntry(QString("File%1").arg(i), QString());
        if (!path.isEmpty()) {
            QString name = cfg2.readPathEntry(QString("Name%1").arg(i), QString());
            QUrl url(path);
            if (name.isEmpty()) {
                name = url.fileName();
            }
 
            name = metrics.elidedText(name, Qt::ElideMiddle, lblRecent->width());
 
            if (!url.isLocalFile() || QFile::exists(url.toLocalFile())) {
                recentfiles.insert(0, QString("<p><a href=\"%1\"><span style=\"color:%3;\">%2</span></a></p>").arg(path).arg(name).arg(color));
            }
        }
 
        i++;
    } while (!path.isEmpty() || i <= 8);
 
    recent += recentfiles.join("\n");
    recent += "</body>"
        "</html>";
    lblRecent->setText(recent);
}

References colorString().

Member Data Documentation

◆ m_artCreditsLabel

QLabel* KisSplashScreen::m_artCreditsLabel

private

Definition at line 62 of file kis_splash_screen.h.

◆ m_bannerSvg

QSvgWidget* KisSplashScreen::m_bannerSvg

private

Definition at line 60 of file kis_splash_screen.h.

◆ m_brandingSvg

QSvgWidget* KisSplashScreen::m_brandingSvg

private

Definition at line 59 of file kis_splash_screen.h.

◆ m_displayLinks

bool KisSplashScreen::m_displayLinks { false }

private

Definition at line 58 of file kis_splash_screen.h.

58{ false };

◆ m_loadingTextLabel

QLabel* KisSplashScreen::m_loadingTextLabel

private

Definition at line 61 of file kis_splash_screen.h.

◆ m_themed

bool KisSplashScreen::m_themed

private

Definition at line 57 of file kis_splash_screen.h.

◆ m_timer

QTimer KisSplashScreen::m_timer

private

Definition at line 56 of file kis_splash_screen.h.

◆ m_versionHtml

QString KisSplashScreen::m_versionHtml

private

Definition at line 63 of file kis_splash_screen.h.

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

libs/ui/kis_splash_screen.h
libs/ui/kis_splash_screen.cpp

Classes

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Slots

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ KisSplashScreen()

Member Function Documentation

◆ colorString()

◆ displayLinks()

◆ displayRecentFiles()

◆ getImageSource()

◆ linkClicked

◆ repaint()

◆ resizeEvent()

◆ setLoadingText()

◆ show()

◆ toggleShowAtStartup

◆ updateSplashImage()

◆ updateText()

Member Data Documentation

◆ m_artCreditsLabel

◆ m_bannerSvg

◆ m_brandingSvg

◆ m_displayLinks

◆ m_loadingTextLabel

◆ m_themed

◆ m_timer

◆ m_versionHtml