KisSplashScreen Class Reference

#include <kis_splash_screen.h>

Inheritance diagram for KisSplashScreen:

Classes
struct	Source

Public Member Functions
	KisSplashScreen (int height, QWidget *parent=0, Qt::WindowFlags f=Qt::WindowFlags(Qt::SplashScreen|Qt::FramelessWindowHint))
void	repaint ()
void	setLoadingText (QString text)
void	show ()

Static Public Member Functions
static Source	getImageSource ()

Private Member Functions
void	updateSplashImage (const int height)

Private Attributes
QLabel *	m_artCreditsLabel
QSvgWidget *	m_bannerSvg
QSvgWidget *	m_brandingSvg
bool	m_displayLinks { false }
QLabel *	m_lblSplash
QLabel *	m_loadingTextLabel
QTimer	m_timer
QString	m_versionHtml

Detailed Description

Definition at line 19 of file kis_splash_screen.h.

Constructor & Destructor Documentation

KisSplashScreen()

KisSplashScreen::KisSplashScreen ( int height, QWidget * parent = 0, Qt::WindowFlags f = Qt::WindowFlags(Qt::SplashScreen | Qt::FramelessWindowHint) )

explicit

Definition at line 42 of file kis_splash_screen.cpp.

    : QWidget(parent, f)
      , m_versionHtml(qApp->applicationVersion().toHtmlEscaped())
{
    setWindowTitle(i18n("Krita"));
#ifndef Q_OS_MACOS
    setWindowIcon(KisIconUtils::loadIcon("krita-branding"));
#endif
 
    setLayout(new QVBoxLayout());
    layout()->setContentsMargins(QMargins());
    m_lblSplash = new QLabel();
    m_lblSplash->setFrameShape(QFrame::NoFrame);
    layout()->addWidget(m_lblSplash);
 
    m_loadingTextLabel = new QLabel(m_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"), m_lblSplash);
    m_bannerSvg = new QSvgWidget(QStringLiteral(":/splash/banner.svg"), m_lblSplash);
    addDropShadow(m_bannerSvg);
 
    m_artCreditsLabel = new QLabel(m_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(height);
    setLoadingText(QString()); // the version string is set here too
 
    connect(&m_timer, SIGNAL(timeout()), SLOT(raise()));
 
    m_timer.setSingleShot(true);
    m_timer.start(10);
}

References addDropShadow(), KisIconUtils::loadIcon(), m_artCreditsLabel, m_bannerSvg, m_brandingSvg, m_lblSplash, m_loadingTextLabel, m_timer, setLoadingText(), and updateSplashImage().

Member Function Documentation

getImageSource()

KisSplashScreen::Source KisSplashScreen::getImageSource ( )

static

Definition at line 132 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};
}

repaint()

void KisSplashScreen::repaint

(

)

Definition at line 160 of file kis_splash_screen.cpp.

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

setLoadingText()

void KisSplashScreen::setLoadingText

(

QString

text

)

Definition at line 123 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 166 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();
        }
        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, and repaint().

updateSplashImage()

void KisSplashScreen::updateSplashImage ( const int height )

private

Definition at line 82 of file kis_splash_screen.cpp.

{
    const int bannerHeight = height * 0.16875;
    const int marginTop = height * 0.05;
    const int marginRight = height * 0.1;
 
    Source source = getImageSource();
    QPixmap img(source.resourcePath);
 
    if (img.isNull() || img.height() == 0) return;
 
    // Preserve aspect ratio of splash.
    const int width = height * img.width() / img.height();
 
    setFixedSize(width, height);
    m_lblSplash->setFixedSize(width, height);
 
    // Let scaledContents downscale to the fixedSize
    m_lblSplash->setScaledContents(true);
    m_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());
}

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

Member Data Documentation

m_artCreditsLabel

QLabel* KisSplashScreen::m_artCreditsLabel

private

Definition at line 50 of file kis_splash_screen.h.

m_bannerSvg

QSvgWidget* KisSplashScreen::m_bannerSvg

private

Definition at line 48 of file kis_splash_screen.h.

m_brandingSvg

QSvgWidget* KisSplashScreen::m_brandingSvg

private

Definition at line 47 of file kis_splash_screen.h.

m_displayLinks

bool KisSplashScreen::m_displayLinks { false }

private

Definition at line 45 of file kis_splash_screen.h.

{ false };

m_lblSplash

QLabel* KisSplashScreen::m_lblSplash

private

Definition at line 46 of file kis_splash_screen.h.

m_loadingTextLabel

QLabel* KisSplashScreen::m_loadingTextLabel

private

Definition at line 49 of file kis_splash_screen.h.

m_timer

QTimer KisSplashScreen::m_timer

private

Definition at line 44 of file kis_splash_screen.h.

m_versionHtml

QString KisSplashScreen::m_versionHtml

private

Definition at line 51 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