gsplash.h

Go to the documentation of this file.

#pragma once
 
// gemc
#include <gemc/gbase/gbase.h>
 
// Qt
#include <QtWidgets>
#include <QTimer>
 
#define GSPLASHENVIRONMENT    "GSPLASH"
#define NOSPLASHIMAGESELECTED "NOSPLASHIMAGESELECTED"
 
// exit codes: 190s
#define ERR_NOSPLASHENVFOUND  191

constexpr const char* GSPLASH_LOGGER = "gsplash";
constexpr const char* GSPLASH_TIME_OPTION = "splash_time";
constexpr const char* GSPLASH_SCALE_OPTION = "splash_scale";

namespace gsplash {

inline GOptions defineOptions() {
    GOptions goptions(GSPLASH_LOGGER);
    goptions.defineOption(GVariable(GSPLASH_TIME_OPTION, -1.0, "splash display time in seconds"),
                          "Minimum time in seconds to keep the splash image visible before closing it. "
                          "A negative value uses the application default.");
    goptions.defineOption(GVariable(GSPLASH_SCALE_OPTION, 0.5, "splash image scale factor"),
                          "Scale factor applied to the splash image before display. "
                          "Use 1.0 for the image's original size.");
    return goptions;
}
 
} // namespace gsplash
 

class GSplash : public GBase<GSplash> {
public:
    static std::unique_ptr<GSplash>
    create(const std::shared_ptr<GOptions>& gopts,
           const std::string&               imageName = "gemcArchitecture",
           double                           splashTime = -1.0);

    void message(const std::string& msg);

    void messageAfter(int delay, const std::string& msg);

    void finish(QWidget* callingWindow) const;
 
private:
    GSplash(const std::shared_ptr<GOptions>& gopts,
            const std::string&               imageName,
            double                           splashTime);

    std::unique_ptr<QSplashScreen> splash;
    double                         splash_time = 0.0;
 
};